support for 202507 endpoints (#37)

* [auth][api] accept the 20250424.01 client Version check now answers "current" for a set of builds rather than one: SUPPORTED_GAME_VERSIONS carries 20230414 and 20250424.01. GAME_VERSION is unchanged and still what the server reports for itself (presence, rn.ver). Adds GET /api/versioncheck/islandedversions, always [] — we never island a build off into its own matchmaking pool. The 2025 build POSTs /cachedlogin/forplatformid/:platform/:id with a deviceId/platformAuth/time form body where the 2023 build GETs it, so that route now takes both methods. The body is accepted and ignored for now. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * [2025] unstable * 20250718.0 * correct one this time * stubs * more stubs * more stubs * [lists] add worker * [ai] route stubs * [api] player photo setting * [econ] add roomEconConfig route * [infra] update worker generators * [worker] add cards/moderation/platformnotification workers * [lists] updates to some endpoints * [clubs] stub out announcement endpoint, for now * [econ] stub out season endpoints for now * [chat] apps/chat stub out party endpoint not sure the shape yet * [api] stub out statsig and lockeditems * [doc] new services * [lists] stub the bulk endpoint * [datacollection] add placeholder service until we can kill it * [api] set gifting to lvl5 * update lock * [cdn] enable cache * [match] matchmake v2 * [lists] stub some lists * [ai] stubs * [rooms] new subroom save endpoint * [econ] add bulk purchase endpoint * [discovery] update featured creator to 1 for fun * [api] add photo settings flag * [chat] fixup chat permissions (sorta) * [auth] restrictions endpoint * [rooms] contributed endpoint * [api] fix outfit endpoint * [discovery] attempt to fix store * [chat] privacy endpoints * [api] cheered images * [rooms] add xp endpoint (disbaled) * [rooms] add xp endpoint (disabled) * update images-db for cheers * [rooms] add autocomplete endpoint * [cdn/img] increase cache ttl for statics * [api] bulk route for images * [accounts] add banner image * [api] add misc missing endpoints * [discovery] remove AI tab * [platformnotifications] stub some endpoints * [lists] add some more lists * [rooms] additional endpoints * [chat] stub a few privacy endpoints * [econ] stub some endpoints * misc db fixes * [api] tweak shape for images v6 * [rooms] dont show trending RROs --------- Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
2026-09-10 07:31:27 -07:00 · 2026-08-18 23:07:24 -04:00
parent 66c09806f9
commit 34171417e3
162 changed files with 114930 additions and 469 deletions
@@ -99,6 +99,15 @@ export const BalanceEntry = z.object({
 	Balance: z.int(),
 })

+/**
+ * `GET /econ/roomEconConfig/:roomId` — a room's economy configuration. Only the
+ * shop's sorting-tabs toggle is configurable, and nothing stores it yet.
+ */
+export const RoomEconConfig = z.object({
+	RoomId: z.int().describe('Echoed back from the path'),
+	EnableSortingTabs: z.boolean().describe('Always false — no per-room config is stored'),
+})
+
 /** `GET /econ/customAvatarItems/v1/owned` — paginated owned custom items. */
 export const CustomAvatarItemsResponse = z.object({
 	Results: JsonArray,
@@ -130,6 +139,56 @@ export const SubscriptionDto = z.object({
 	ModifiedAt: z.string(),
 })

+/**
+ * One item as `GET /api/avatar/v4/items` serves it — camelCase, unlike the PascalCase
+ * records the sibling item endpoints hand back. `avatarItemId` is 0 and `tagList` empty
+ * for every item we have: neither the default catalog nor a storefront gift-drop carries
+ * them.
+ */
+export const AvatarItemV4Dto = z.object({
+	avatarItemId: z.int(),
+	avatarItemDesc: z.string().describe('The comma-delimited item descriptor, commas and all'),
+	friendlyName: z.string(),
+	tooltip: z.string(),
+	tagList: z.string(),
+	avatarItemType: z.int(),
+	rarity: z.int(),
+	isBaseAvatarItem: z.boolean(),
+})
+
+/**
+ * `POST /api/checklist/v1|v2/complete` JSON body — which checklist row was finished.
+ * The client posts just `{ "ItemIndex": 1 }`; `Id` is the fallback key read when
+ * `ItemIndex` is absent or 0.
+ */
+export const CompleteChecklistRequest = z.object({
+	ItemIndex: z.int().describe('The row’s index — what the client actually sends'),
+	Id: z.int().optional().describe('Fallback row id, read when ItemIndex is absent or 0'),
+})
+
+/**
+ * `POST /api/checklist/v1|v2/complete` — the balance-update envelope, the same shape
+ * buyItem answers with. `Balance` is the CHANGE applied, so a stubbed (ungranted)
+ * completion reports 0. `UpdateResponse` 303 is the checklist-reward context.
+ */
+export const ChecklistCompleteResponse = z.object({
+	BalanceUpdates: z.array(z.object({ UpdateResponse: z.int(), Data: z.array(JsonObject) })),
+	Balance: z.int().describe('The change applied — 0 while completion is stubbed'),
+	CurrencyType: z.int(),
+	BalanceType: z.int().describe('-2 = account-wide'),
+})
+
+/**
+ * One row of the new-user checklist (`GET /api/checklist/v1|v2/current`). `Objective` is
+ * an `ObjectiveType` ordinal the client matches its own progress events against.
+ */
+export const ChecklistEntry = z.object({
+	Order: z.int().describe('Position in the list, from 0'),
+	Objective: z.int().describe('ObjectiveType ordinal, e.g. 38 = SaveOutfitSlot'),
+	Count: z.int().describe('How many times the objective must happen'),
+	CreditAmount: z.int().describe('Tokens awarded on completion'),
+})
+
 /**
 * `POST /api/CampusCard/v1/UpdateAndGetSubscription` — the caller's subscription, or `{}`
 * when they have none (which is everyone without the `developer` role). `{}` rather than a
@@ -145,6 +204,55 @@ export const SubscriptionResponse = z.union([
 	z.object({}).describe('`{}` — no subscription'),
 ])

+/**
+ * `GET /api/CampusCard/v1/SignUpBonus` — the Rec Room Plus sign-up bonus. Fixed values,
+ * not per-account: `RRPlusSignUpBonusId` names the bonus that is running and the two
+ * prices are the token window the free items are drawn from.
+ */
+export const RRPlusSignUpBonus = z.object({
+	RRPlusSignUpBonusId: z.int().describe('Which sign-up bonus is running'),
+	MinFreeItemsPrice: z.int().describe('Lowest token price a free item may have'),
+	MaxFreeItemsPrice: z.int().describe('Highest token price a free item may have'),
+})
+
+/**
+ * `GET /api/influencerpartnerprogram/influencers` — the ids of every influencer in the
+ * partner program, which the client uses to badge them wherever they appear. An object
+ * around the list, not a bare array.
+ */
+export const InfluencerIdsResponse = z.object({
+	InfluencerIds: z
+		.array(z.int())
+		.describe('Account ids in the partner program. Empty — no programme runs here'),
+})
+
+/**
+ * `GET /api/incentivizedreferrals/progress` — how far the caller has got with the
+ * refer-a-friend rewards: how many referrals have been verified, and which rewards they
+ * have taken from that track.
+ *
+ * A `{ success, value }` envelope with the payload nested — not the flat bodies the balance
+ * routes answer with. Nothing here runs a referral programme, so the count is 0 and the
+ * reward list is empty: a player who has referred nobody, which is everybody.
+ */
+export const ReferralProgressResponse = z.object({
+	success: z.boolean(),
+	value: z.object({
+		ReferralsVerifiedCount: z.int().describe('Referrals that have been verified. Always 0'),
+		PlayerReferralRewards: z
+			.array(z.unknown())
+			.describe('Rewards claimed off the referral track. Always empty'),
+	}),
+})
+
+/**
+ * `GET /api/makerai/checkfreetrialeligibility` — a BARE JSON boolean (`false`), not an
+ * envelope and not a `{ value }` wrapper. The whole body is the answer.
+ */
+export const MakerAiFreeTrialEligibilityResponse = z
+	.boolean()
+	.describe('Whether the caller can start a Maker AI free trial; always false')
+
 /** `POST /api/challenge/v2/updateProgress` — the identifying fields echoed back. */
 export const ChallengeProgressResponse = z.object({
 	ChallengeMapId: z.int(),
@@ -184,6 +292,73 @@ export const BuyItemResponse = z.object({
 	BalanceType: z.int().describe('-2 = account-wide'),
 })

+/**
+ * How a bulk-purchase line names its item. A discriminated id: the client buys both
+ * catalog items (a storefront `PurchasableItemId`, under `NumberId`, `Type` 0) and
+ * guid-keyed ones (UGC / custom avatar items). Only the numeric form resolves here —
+ * nothing sells guid-keyed items yet, so a `Guid` id fails its line.
+ */
+export const ItemPurchaseMethodId = z.object({
+	Type: z.int().describe('0 = NumberId. Anything else names a guid-keyed item we can’t sell'),
+	NumberId: z.int().nullable().optional().describe('The storefront PurchasableItemId'),
+	Guid: z.string().nullable().optional().describe('The guid-keyed item id; always null here'),
+})
+
+/**
+ * `POST /api/items/bulkpurchase` — the whole bag's result.
+ *
+ * NOT buyItem's envelope. The wrapper is `{ Success, Error, error_id, Value }` — `error_id`
+ * lowercase because the client renames that one member, the other three PascalCase — and
+ * `Value` is a BalanceUpdateResponse: the RESULTING `{ Balance, CurrencyType, Platform }`
+ * (buyItem reports the change instead) plus one `BalanceUpdates` entry per REQUESTED item.
+ * `Value` is null whenever nothing was bought; the client's validator only cascades into a
+ * non-null one, so that parses.
+ *
+ * Per-line reporting is each entry's `UpdateResponse`. `AllowPartialSuccess` is what lets
+ * some of them come back non-OK while `Success` stays true.
+ */
+export const BulkPurchaseResponse = z.object({
+	Success: z.boolean().describe('False only when the bag bought nothing at all'),
+	Error: z.string().nullable().describe('Why nothing was bought; null on success'),
+	error_id: z.string().nullable().describe('Always null — no error-id catalog here'),
+	Value: z
+		.object({
+			Balance: z.int().describe('The RESULTING total in the bucket below, NOT buyItem’s change'),
+			CurrencyType: z.int(),
+			Platform: z
+				.int()
+				.describe(
+					'The balance bucket — the client’s `BalanceType` under a [DataMember] rename. -2, ' +
+						'account-wide: the reference server said 4 (RecNetPurchased) because it kept a ' +
+						'wallet per store; this one keeps a single bucket, and the client SUMS its buckets'
+				),
+			BalanceUpdates: z
+				.array(
+					z.object({
+						UpdateResponse: z
+							.int()
+							.describe(
+								'This line’s outcome: 0 OK, 1 TooManyRequests, 2 NotEnoughCredit, ' +
+									'3 AlreadyOwned, 4 NoItemAvailable, 5 CouponNotApplicable, ' +
+									'6 RequestedPriceDoesNotMatch, 7 RequestedAmountNotAllowed, ' +
+									'8 PlayerNotEligible, 9 RequestCannotBeRefunded, 10 PlayerNotApproved'
+							),
+						Data: z.object({
+							GiftPackage: JsonObject.nullable().describe(
+								'The box created for this line (20 keys). Null on a line that didn’t sell, ' +
+									'and under `BypassGiftPackages` — the item is granted either way'
+							),
+							PurchasableItemId: z.int().nullable().describe('The catalog item this line named'),
+							CustomAvatarItem: z.null().describe('The UGC counterpart; never sold here'),
+						}),
+					})
+				)
+				.describe('One entry per REQUESTED item, in request order — failures included'),
+		})
+		.nullable()
+		.describe('Null when nothing was bought'),
+})
+
 /**
 * `GET /api/storefronts/v2/buyInvention` — the purchase result. Two envelopes side by
 * side: the balance update (shaped like buyItem's, except `Balance` is the RESULTING
@@ -216,21 +391,66 @@ export const ErrorResponse = z.object({ error: z.string() })

 // ---- Request schemas -------------------------------------------------------

+/**
+ * The `Gift` block both purchase bodies carry — present when buying an item for another
+ * player. The caller is still the one debited.
+ */
+export const GiftBlock = z
+	.object({
+		ToPlayerId: z.int().optional(),
+		Anonymous: z.boolean().optional(),
+		Message: z.string().optional(),
+		GiftContext: z.int().optional(),
+	})
+	.describe('Present when buying for another player; the caller still pays')
+
 /** `POST /api/storefronts/v2/buyItem` JSON body. */
 export const BuyItemRequest = z.object({
 	StorefrontType: z.int().describe('Which storefront catalog (sf{N}.json)'),
 	PurchasableItemId: z.int(),
 	CurrencyType: z.int().describe('Must be a spendable account currency'),
 	RequestedPrice: z.int().describe('The price the client rendered; a mismatch is 409'),
-	Gift: z
-		.object({
-			ToPlayerId: z.int().optional(),
-			Anonymous: z.boolean().optional(),
-			Message: z.string().optional(),
-			GiftContext: z.int().optional(),
-		})
+	Gift: GiftBlock.optional(),
+})
+
+/**
+ * `POST /api/items/bulkpurchase` JSON body — the shopping bag, checked out in one call.
+ * `StorefrontType` and `CurrencyType` are the bag's, not per line: every line is bought
+ * from one catalog with one currency.
+ */
+export const BulkPurchaseRequest = z.object({
+	PurchaseItemRequests: z
+		.array(
+			z.object({
+				ItemPurchaseMethodId,
+				RequestedPrice: z
+					.int()
+					.describe('The UNIT price the client rendered; a mismatch fails the line'),
+				Gift: GiftBlock.nullable().optional(),
+				CouponConsumablePlayerMappingId: z
+					.int()
+					.nullable()
+					.optional()
+					.describe('Unsupported — nothing issues coupons, so a non-null one fails the line'),
+				DuplicateItemCount: z.int().optional().describe('Copies of this item; defaults to 1'),
+			})
+		)
+		.describe('One line per item in the bag; at most Econ.BulkPurchaseCap (200) copies in total'),
+	StorefrontType: z.int().describe('Which storefront catalog (sf{N}.json) every line comes from'),
+	CurrencyType: z.int().describe('Must be a spendable account currency'),
+	BypassGiftPackages: z
+		.boolean()
 		.optional()
-		.describe('Present when buying for another player; the caller still pays'),
+		.describe('Grant the items without wrapping them in gift boxes'),
+	AllowPartialSuccess: z
+		.boolean()
+		.optional()
+		.describe('Buy the lines that work and report the rest; false is all-or-nothing'),
+	ShoppingBagId: z
+		.union([z.string(), z.int()])
+		.nullable()
+		.optional()
+		.describe('The client’s bag id, echoed back untouched'),
 })

 /** `POST /api/consumables/v1/consume` JSON body. */