@bedrock-rbx/ocale 0.1.0-beta.9 → 0.1.1

package/dist/testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.mjs","names":[],"sources":["../tests/helpers/badges.ts","../tests/helpers/developer-products.ts","../tests/helpers/fake-http-client.ts","../tests/helpers/fake-send.ts","../tests/helpers/fake-sleep.ts","../tests/helpers/game-icon.ts","../tests/helpers/game-passes.ts","../tests/helpers/game-thumbnails.ts","../tests/helpers/luau-execution-task-binary-inputs.ts","../tests/helpers/luau-execution-task-logs.ts","../tests/helpers/luau-execution-tasks.ts","../tests/helpers/memory-store-queues.ts","../tests/helpers/places.ts","../tests/helpers/universes.ts"],"sourcesContent":["import type { BadgeResponseV2Wire } from \"#src/domains/badges/badges/wire\";\n\n/**\n * Builds a minimally-valid {@link BadgeResponseV2Wire} body. Pass an\n * `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant; useful for parser and integration tests that\n * only care about one field at a time.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validBadgeBody(overrides: Partial<BadgeResponseV2Wire> = {}): BadgeResponseV2Wire {\n\treturn {\n\t\tid: 12_345,\n\t\tname: \"First Goal\",\n\t\tawarder: { id: 222, name: \"Lobby\", type: 1 },\n\t\tcreated: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"Awarded on first login.\",\n\t\tdisplayDescription: \"Awarded on first login.\",\n\t\tdisplayIconImageId: 67_890,\n\t\tdisplayName: \"First Goal\",\n\t\tenabled: true,\n\t\ticonImageId: 67_890,\n\t\tstatistics: { awardedCount: 100, pastDayAwardedCount: 5, winRatePercentage: 42.5 },\n\t\tupdated: \"2024-03-20T14:45:00.000Z\",\n\t\t...overrides,\n\t};\n}\n","import type { DeveloperProductConfigV2 } from \"#src/domains/developer-products/products/wire\";\n\n/**\n * Builds a minimally-valid {@link DeveloperProductConfigV2} wire body. Pass\n * an `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant; useful for parser and integration tests that\n * only care about one field at a time.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validDeveloperProductBody(\n\toverrides: Partial<DeveloperProductConfigV2> = {},\n): DeveloperProductConfigV2 {\n\treturn {\n\t\tname: \"Gem Pack\",\n\t\tcreatedTimestamp: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"A premium gem pack\",\n\t\ticonImageAssetId: 67_890,\n\t\tisForSale: true,\n\t\tisImmutable: false,\n\t\tpriceInformation: { defaultPriceInRobux: 100, enabledFeatures: [] },\n\t\tproductId: 12_345,\n\t\tstorePageEnabled: true,\n\t\tuniverseId: 999,\n\t\tupdatedTimestamp: \"2024-03-20T14:45:00.000Z\",\n\t\t...overrides,\n\t};\n}\n","import { ApiError } from \"#src/errors/api-error\";\nimport type { OpenCloudError } from \"#src/errors/base\";\nimport { NetworkError } from \"#src/errors/network-error\";\nimport { RateLimitError } from \"#src/errors/rate-limit\";\nimport type {\n\tHttpClient,\n\tHttpRequest,\n\tHttpResponse,\n\tRequestConfig,\n} from \"#src/internal/http/types\";\nimport type { Result } from \"#src/types\";\n\n/**\n * A request captured by {@link FakeHttpClient} for later assertion.\n */\nexport interface CapturedRequest {\n\t/** The per-request config passed alongside the request. */\n\treadonly config: RequestConfig;\n\t/** The request passed to {@link HttpClient.request}. */\n\treadonly request: HttpRequest;\n}\n\n/**\n * A fluent fake for the {@link HttpClient} boundary. Mocks are queued in\n * FIFO order and consumed by each `request()` call. Records every\n * request and config for later assertion. Throws\n * {@link FakeHttpClientError} if the queue is empty when `request()` is\n * called — surfaces missing mocks as test setup bugs instead of silently\n * repeating the last response.\n */\nexport interface FakeHttpClient extends HttpClient {\n\t/** Queues an {@link ApiError} with the given status code and optional message/code. */\n\tmockApiError(options: { code?: string; message?: string; statusCode: number }): this;\n\t/** Queues an error Result with the given error instance. */\n\tmockError(error: OpenCloudError): this;\n\t/** Queues a {@link NetworkError}. Preserves `cause` when provided. */\n\tmockNetworkError(options?: { cause?: unknown; message?: string }): this;\n\t/** Queues a {@link RateLimitError} with the given retry hint. */\n\tmockRateLimit(options: { message?: string; retryAfterSeconds: number }): this;\n\t/** Queues a successful {@link HttpResponse}. Body defaults to `{}`; headers default to `{}`. */\n\tmockResponse(options: {\n\t\tbody?: unknown;\n\t\theaders?: Readonly<Record<string, string>>;\n\t\tstatus: number;\n\t}): this;\n\t/** Number of queued mocks that have not yet been consumed. */\n\treadonly pendingMocks: number;\n\t/** Chronological log of every `(request, config)` pair the fake received. */\n\treadonly requests: ReadonlyArray<CapturedRequest>;\n}\n\ntype ErrorResult = Result<HttpResponse, OpenCloudError> & { success: false };\n\ninterface FakeState {\n\treadonly captured: Array<CapturedRequest>;\n\tconsumed: number;\n\treadonly queue: Array<Result<HttpResponse, OpenCloudError>>;\n}\n\n/**\n * Thrown when {@link FakeHttpClient.request} is called but no mock has\n * been queued. The message names the method, url, and consumed count to\n * aid debugging of missing `.mockResponse`/`.mockError` setup.\n */\nexport class FakeHttpClientError extends Error {\n\tpublic override readonly name: string = \"FakeHttpClientError\";\n}\n\n/**\n * Creates a fluent {@link FakeHttpClient} that sits at the\n * {@link HttpClient} seam. Use for integration tests where you need to\n * assert per-request config (apiKey, baseUrl) flows through to HTTP.\n *\n * @returns A fresh fake with an empty mock queue.\n */\nexport function createFakeHttpClient(): FakeHttpClient {\n\tconst state: FakeState = { captured: [], consumed: 0, queue: [] };\n\tfunction enqueue(result: Result<HttpResponse, OpenCloudError>): FakeHttpClient {\n\t\tstate.queue.push(result);\n\t\treturn fake;\n\t}\n\n\tconst fake: FakeHttpClient = {\n\t\tmockApiError: (options) => enqueue(errorResult(buildApiError(options))),\n\t\tmockError: (error) => enqueue(errorResult(error)),\n\t\tmockNetworkError: (options) => enqueue(errorResult(buildNetworkError(options))),\n\t\tmockRateLimit: (options) => enqueue(errorResult(buildRateLimitError(options))),\n\t\tmockResponse: (options) => enqueue(successResult(options)),\n\t\tget pendingMocks() {\n\t\t\treturn state.queue.length;\n\t\t},\n\t\trequest: async (request, config) => handleRequest({ config, request, state }),\n\t\tget requests() {\n\t\t\treturn state.captured;\n\t\t},\n\t};\n\n\treturn fake;\n}\n\nfunction consumeNextMock(\n\tstate: FakeState,\n\trequest: HttpRequest,\n): Result<HttpResponse, OpenCloudError> {\n\tconst next = state.queue.shift();\n\tif (next === undefined) {\n\t\tthrow new FakeHttpClientError(\n\t\t\t`FakeHttpClient: no mock queued for ${request.method} ${request.url} (consumed ${String(state.consumed)}, pending 0)`,\n\t\t);\n\t}\n\n\tstate.consumed += 1;\n\treturn next;\n}\n\nasync function handleRequest(options: {\n\treadonly config: RequestConfig;\n\treadonly request: HttpRequest;\n\treadonly state: FakeState;\n}): Promise<Result<HttpResponse, OpenCloudError>> {\n\tconst { config, request, state } = options;\n\tstate.captured.push({ config, request });\n\treturn consumeNextMock(state, request);\n}\n\nfunction successResult(options: {\n\tbody?: unknown;\n\theaders?: Readonly<Record<string, string>>;\n\tstatus: number;\n}): Result<HttpResponse, OpenCloudError> {\n\treturn {\n\t\tdata: {\n\t\t\tbody: options.body ?? {},\n\t\t\theaders: options.headers ?? {},\n\t\t\tstatus: options.status,\n\t\t},\n\t\tsuccess: true,\n\t};\n}\n\nfunction errorResult(err: OpenCloudError): ErrorResult {\n\treturn { err, success: false };\n}\n\nfunction buildApiError(options: { code?: string; message?: string; statusCode: number }): ApiError {\n\tconst message = options.message ?? \"API error\";\n\tif (options.code === undefined) {\n\t\treturn new ApiError(message, { statusCode: options.statusCode });\n\t}\n\n\treturn new ApiError(message, { code: options.code, statusCode: options.statusCode });\n}\n\nfunction buildNetworkError(\n\toptions: undefined | { cause?: unknown; message?: string },\n): NetworkError {\n\tconst message = options?.message ?? \"Network error\";\n\tif (options?.cause === undefined) {\n\t\treturn new NetworkError(message);\n\t}\n\n\treturn new NetworkError(message, { cause: options.cause });\n}\n\nfunction buildRateLimitError(options: {\n\tmessage?: string;\n\tretryAfterSeconds: number;\n}): RateLimitError {\n\treturn new RateLimitError(options.message ?? \"Rate limited\", {\n\t\tretryAfterSeconds: options.retryAfterSeconds,\n\t});\n}\n","import type { OpenCloudError } from \"#src/errors/base\";\nimport type { HttpRequest, HttpResponse } from \"#src/internal/http/types\";\nimport type { Result } from \"#src/types\";\n\n/**\n * The `send` callback shape consumed by `executeWithRetry`. A plain\n * transport function — no `RequestConfig`, no queueing, no retries.\n */\nexport type SendFunc = (request: HttpRequest) => Promise<Result<HttpResponse, OpenCloudError>>;\n\n/**\n * A scripted fake for the `send` callback. Replays responses in order\n * and records every request it receives.\n */\nexport interface FakeSend {\n\t/** Chronological log of every request the fake received. */\n\treadonly requests: ReadonlyArray<HttpRequest>;\n\t/** The scripted send callback. */\n\treadonly send: SendFunc;\n}\n\n/**\n * Creates a scripted fake for the `send` callback. Each call returns the\n * next queued response; exhausting the queue throws, which surfaces test\n * setup mistakes instead of silently repeating the last response.\n *\n * @param options - The scripted responses to replay, in order.\n * @returns A `send` callback plus a `requests` log.\n * @rejects {Error} When a call is made after all scripted responses are consumed.\n */\nexport function createFakeSend(options: {\n\treadonly responses: ReadonlyArray<Result<HttpResponse, OpenCloudError>>;\n}): FakeSend {\n\tconst requests: Array<HttpRequest> = [];\n\tlet index = 0;\n\n\tasync function send(request: HttpRequest): Promise<Result<HttpResponse, OpenCloudError>> {\n\t\trequests.push(request);\n\t\tconst response = options.responses[index];\n\t\tindex += 1;\n\n\t\tif (response === undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t`createFakeSend exhausted: ${String(index)} calls made, only ${String(options.responses.length)} responses scripted`,\n\t\t\t);\n\t\t}\n\n\t\treturn response;\n\t}\n\n\treturn { requests, send };\n}\n","import type { SleepFunc } from \"#src/internal/utils/sleep\";\n\n/**\n * A directly-callable sleep double that records its wait arguments without\n * delaying. Assignable to {@link SleepFunc}.\n */\nexport interface FakeSleep extends SleepFunc {\n\t/** Chronological log of every `ms` value the fake was called with. */\n\treadonly waits: ReadonlyArray<number>;\n}\n\n/**\n * Creates a {@link FakeSleep} that resolves immediately and records every\n * `ms` value it was called with.\n *\n * @returns A callable sleep function with a `waits` log attached.\n */\nexport function createFakeSleep(): FakeSleep {\n\tconst waits: Array<number> = [];\n\n\tasync function sleep(ms: number): Promise<void> {\n\t\twaits.push(ms);\n\t}\n\n\tconst fake: FakeSleep = Object.assign(sleep, {\n\t\tget waits(): ReadonlyArray<number> {\n\t\t\treturn waits;\n\t\t},\n\t});\n\n\treturn fake;\n}\n","import type {\n\tGameIconListWire,\n\tGetGameIconResponseWire,\n} from \"#src/domains/game-internationalization/game-icon/wire\";\n\n/**\n * Builds a minimally-valid {@link GetGameIconResponseWire} entry. Pass an\n * `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant.\n *\n * @param overrides - Fields to override on the default entry.\n * @returns A valid localized-icon entry with the overrides applied.\n */\nexport function validLocalizedIcon(\n\toverrides: Partial<GetGameIconResponseWire> = {},\n): GetGameIconResponseWire {\n\treturn {\n\t\timageId: \"12345\",\n\t\timageUrl: \"https://t1.rbxcdn.com/icon/12345\",\n\t\tlanguageCode: \"en_us\",\n\t\tstate: \"Approved\",\n\t\t...overrides,\n\t};\n}\n\n/**\n * Builds a minimally-valid {@link GameIconListWire} body containing a single\n * default localized icon.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validIconListBody(overrides: Partial<GameIconListWire> = {}): GameIconListWire {\n\treturn {\n\t\tdata: [validLocalizedIcon()],\n\t\t...overrides,\n\t};\n}\n","import type { GamePassConfigV2 } from \"#src/domains/game-passes/game-passes/wire\";\n\n/**\n * Test-only wire shape for the list response. Mirrors the OpenAPI\n * schema, which marks `nextPageToken` as required and nullable, so\n * fixtures can carry the literal JSON `null` the API sends on the last\n * page without leaking `null` into the production wire type (which\n * exposes a post-normalization view of `string | undefined`).\n */\ninterface ListGamePassesWireBody {\n\treadonly gamePasses: ReadonlyArray<GamePassConfigV2>;\n\n\treadonly nextPageToken: null | string;\n}\n\n/**\n * Builds a minimally-valid {@link GamePassConfigV2} wire body. Pass an\n * `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant — useful for parser and integration tests that\n * only care about one field at a time.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validGamePassBody(overrides: Partial<GamePassConfigV2> = {}): GamePassConfigV2 {\n\treturn {\n\t\tname: \"Epic Pass\",\n\t\tcreatedTimestamp: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"Unlocks epic stuff\",\n\t\tgamePassId: 12_345,\n\t\ticonAssetId: 67_890,\n\t\tisForSale: true,\n\t\tpriceInformation: { defaultPriceInRobux: 100, enabledFeatures: [] },\n\t\tupdatedTimestamp: \"2024-03-20T14:45:00.000Z\",\n\t\t...overrides,\n\t};\n}\n\n/**\n * Builds a minimally-valid wire body for the \"list game passes\" endpoint.\n * By default the page contains one game pass and `nextPageToken` is the\n * literal JSON `null` the API sends on the last page; `overrides` let\n * parser and integration tests tweak the items array or the cursor\n * without rebuilding the whole shape.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied. `nextPageToken`\n *   defaults to the wire's literal `null`, which the response parser\n *   normalizes to `undefined` at the boundary.\n */\nexport function validListGamePassesBody(\n\toverrides: Partial<ListGamePassesWireBody> = {},\n): ListGamePassesWireBody {\n\treturn {\n\t\tgamePasses: [validGamePassBody()],\n\t\t// eslint-disable-next-line unicorn/no-null -- API sends null on the last page; parser normalizes to undefined.\n\t\tnextPageToken: null,\n\t\t...overrides,\n\t};\n}\n","import type { GameThumbnailUploadWire } from \"#src/domains/game-internationalization/game-thumbnails/wire\";\n\n/**\n * Builds a minimally-valid {@link GameThumbnailUploadWire} body. Pass an\n * `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant; useful for parser and integration tests that\n * only care about one field at a time.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validThumbnailUploadBody(\n\toverrides: Partial<GameThumbnailUploadWire> = {},\n): GameThumbnailUploadWire {\n\treturn { mediaAssetId: \"67890\", ...overrides };\n}\n","import type { LuauExecutionTaskBinaryInputWire } from \"#src/domains/cloud-v2/luau-execution-task-binary-inputs/wire\";\n\n/**\n * Builds a minimally-valid {@link LuauExecutionTaskBinaryInputWire} body\n * for tests. Pass an `overrides` object to tweak fields without re-stating\n * the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validBinaryInputBody(\n\toverrides: Partial<LuauExecutionTaskBinaryInputWire> = {},\n): LuauExecutionTaskBinaryInputWire {\n\treturn {\n\t\tpath: \"universes/123/luau-execution-session-task-binary-inputs/abc\",\n\t\tuploadUri: \"https://storage.example.com/upload?token=xyz\",\n\t\t...overrides,\n\t};\n}\n","import type { ListLogsResponseWire } from \"#src/domains/cloud-v2/luau-execution-task-logs/wire\";\n\n/**\n * Builds a minimally-valid {@link ListLogsResponseWire} body containing\n * one chunk with one structured message. Pass an `overrides` object to\n * tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validLogPageBody(\n\toverrides: Partial<ListLogsResponseWire> = {},\n): ListLogsResponseWire {\n\treturn {\n\t\tluauExecutionSessionTaskLogs: [\n\t\t\t{\n\t\t\t\tstructuredMessages: [\n\t\t\t\t\t{\n\t\t\t\t\t\tcreateTime: \"2026-01-01T00:00:00Z\",\n\t\t\t\t\t\tmessage: \"Hello from Luau\",\n\t\t\t\t\t\tmessageType: \"OUTPUT\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t\t...overrides,\n\t};\n}\n","import type { LuauExecutionTaskWire } from \"#src/domains/cloud-v2/luau-execution-tasks/wire\";\n\n/**\n * Builds a minimally-valid {@link LuauExecutionTaskWire} body for an\n * in-progress task. Pass an `overrides` object to tweak fields without\n * re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validInProgressTaskBody(\n\toverrides: Partial<LuauExecutionTaskWire> = {},\n): LuauExecutionTaskWire {\n\treturn {\n\t\tcreateTime: \"2026-01-01T00:00:00Z\",\n\t\tpath: \"universes/123/places/456/luau-execution-session-tasks/task-1\",\n\t\tstate: \"QUEUED\",\n\t\tupdateTime: \"2026-01-01T00:00:30Z\",\n\t\tuser: \"user-1\",\n\t\t...overrides,\n\t};\n}\n","import type {\n\tMemoryStoreQueueItemWire,\n\tReadQueueItemsResponseWire,\n} from \"#src/domains/cloud-v2/memory-store-queues/wire\";\n\n/**\n * Builds a minimally-valid {@link MemoryStoreQueueItemWire} body. Pass\n * an `overrides` object to tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validQueueItemBody(\n\toverrides: Partial<MemoryStoreQueueItemWire> = {},\n): MemoryStoreQueueItemWire {\n\treturn {\n\t\tdata: \"hello\",\n\t\texpireTime: \"2026-06-21T15:08:58.4806559Z\",\n\t\tpath: \"cloud/v2/universes/123/memory-store/queues/test-queue/items/abc123\",\n\t\tpriority: 1,\n\t\t...overrides,\n\t};\n}\n\n/**\n * Builds a minimally-valid {@link ReadQueueItemsResponseWire} body\n * carrying a single default queue item. Pass an `overrides` object to\n * change the read identifier or supply a different items array.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid dequeue response body with the overrides applied.\n */\nexport function validDequeueBody(\n\toverrides: Partial<ReadQueueItemsResponseWire> = {},\n): ReadQueueItemsResponseWire {\n\treturn {\n\t\tid: \"1a354bd5b8fe457f8e51232f8dbfe6d0\",\n\t\tqueueItems: [validQueueItemBody()],\n\t\t...overrides,\n\t};\n}\n","import type { PlaceWire } from \"#src/domains/cloud-v2/places/wire\";\nimport { RBXL_SIGNATURE, RBXLX_SIGNATURE } from \"#src/domains/universes/places/signatures\";\nimport type { PlaceVersionWire } from \"#src/domains/universes/places/wire\";\n\n/**\n * Returns a fresh, minimal `.rbxl`-formatted body whose magic bytes\n * match {@link RBXL_SIGNATURE}. Useful when integration tests don't\n * care about the file's contents past the signature.\n *\n * @returns A 14-byte rbxl body matching the binary signature.\n */\nexport function rbxlBody(): Uint8Array<ArrayBuffer> {\n\treturn new Uint8Array(RBXL_SIGNATURE);\n}\n\n/**\n * Returns a fresh, minimal `.rbxlx`-formatted body whose magic bytes\n * match {@link RBXLX_SIGNATURE}. Useful when integration tests don't\n * care about the file's contents past the signature.\n *\n * @returns An 8-byte rbxlx body matching the XML signature.\n */\nexport function rbxlxBody(): Uint8Array<ArrayBuffer> {\n\treturn new Uint8Array(RBXLX_SIGNATURE);\n}\n\n/**\n * Builds a minimally-valid {@link PlaceVersionWire} body. Pass an\n * `overrides` object to tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validPublishResponseBody(\n\toverrides: Partial<PlaceVersionWire> = {},\n): PlaceVersionWire {\n\treturn {\n\t\tversionNumber: 1,\n\t\t...overrides,\n\t};\n}\n\n/**\n * Builds a minimally-valid {@link PlaceWire} body. Pass an `overrides`\n * object to tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validPlaceBody(overrides: Partial<PlaceWire> = {}): PlaceWire {\n\treturn {\n\t\tcreateTime: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"A sample place.\",\n\t\tdisplayName: \"Test Place\",\n\t\tpath: \"universes/123/places/456\",\n\t\troot: true,\n\t\tserverSize: 30,\n\t\tuniverseRuntimeCreation: false,\n\t\tupdateTime: \"2024-11-02T17:08:21.500Z\",\n\t\t...overrides,\n\t};\n}\n","import type { UniverseWire } from \"#src/domains/cloud-v2/universes/wire\";\n\n/**\n * Builds a minimally-valid {@link UniverseWire} body. Pass an\n * `overrides` object to tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validUniverseBody(overrides: Partial<UniverseWire> = {}): UniverseWire {\n\treturn {\n\t\tageRating: \"AGE_RATING_13_PLUS\",\n\t\tconsoleEnabled: false,\n\t\tcreateTime: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"A sample universe for tests.\",\n\t\tdesktopEnabled: true,\n\t\tdisplayName: \"Test Universe\",\n\t\tmobileEnabled: true,\n\t\tpath: \"universes/12345\",\n\t\trootPlace: \"universes/12345/places/98765\",\n\t\ttabletEnabled: true,\n\t\tupdateTime: \"2024-11-02T17:08:21.500Z\",\n\t\tuser: \"users/7777\",\n\t\tvisibility: \"PUBLIC\",\n\t\tvoiceChatEnabled: false,\n\t\tvrEnabled: false,\n\t\t...overrides,\n\t};\n}\n"],"mappings":"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"}
+{"version":3,"file":"testing.mjs","names":[],"sources":["../tests/helpers/badges.ts","../tests/helpers/developer-products.ts","../tests/helpers/fake-http-client.ts","../tests/helpers/fake-send.ts","../tests/helpers/fake-sleep.ts","../tests/helpers/game-icon.ts","../tests/helpers/game-passes.ts","../tests/helpers/game-thumbnails.ts","../tests/helpers/luau-execution-task-binary-inputs.ts","../tests/helpers/luau-execution-task-logs.ts","../tests/helpers/luau-execution-tasks.ts","../tests/helpers/memory-store-queues.ts","../tests/helpers/places.ts","../tests/helpers/universes.ts"],"sourcesContent":["import type { BadgeResponseV2Wire } from \"#src/domains/badges/badges/wire\";\n\n/**\n * Builds a minimally-valid {@link BadgeResponseV2Wire} body. Pass an\n * `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant; useful for parser and integration tests that\n * only care about one field at a time.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validBadgeBody(overrides: Partial<BadgeResponseV2Wire> = {}): BadgeResponseV2Wire {\n\treturn {\n\t\tid: 12_345,\n\t\tname: \"First Goal\",\n\t\tawarder: { id: 222, name: \"Lobby\", type: 1 },\n\t\tcreated: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"Awarded on first login.\",\n\t\tdisplayDescription: \"Awarded on first login.\",\n\t\tdisplayIconImageId: 67_890,\n\t\tdisplayName: \"First Goal\",\n\t\tenabled: true,\n\t\ticonImageId: 67_890,\n\t\tstatistics: { awardedCount: 100, pastDayAwardedCount: 5, winRatePercentage: 42.5 },\n\t\tupdated: \"2024-03-20T14:45:00.000Z\",\n\t\t...overrides,\n\t};\n}\n","import type { DeveloperProductConfigV2 } from \"#src/domains/developer-products/products/wire\";\n\n/**\n * Builds a minimally-valid {@link DeveloperProductConfigV2} wire body. Pass\n * an `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant; useful for parser and integration tests that\n * only care about one field at a time.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validDeveloperProductBody(\n\toverrides: Partial<DeveloperProductConfigV2> = {},\n): DeveloperProductConfigV2 {\n\treturn {\n\t\tname: \"Gem Pack\",\n\t\tcreatedTimestamp: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"A premium gem pack\",\n\t\ticonImageAssetId: 67_890,\n\t\tisForSale: true,\n\t\tisImmutable: false,\n\t\tpriceInformation: { defaultPriceInRobux: 100, enabledFeatures: [] },\n\t\tproductId: 12_345,\n\t\tstorePageEnabled: true,\n\t\tuniverseId: 999,\n\t\tupdatedTimestamp: \"2024-03-20T14:45:00.000Z\",\n\t\t...overrides,\n\t};\n}\n","import { ApiError } from \"#src/errors/api-error\";\nimport type { OpenCloudError } from \"#src/errors/base\";\nimport { NetworkError } from \"#src/errors/network-error\";\nimport { RateLimitError } from \"#src/errors/rate-limit\";\nimport type {\n\tHttpClient,\n\tHttpRequest,\n\tHttpResponse,\n\tRequestConfig,\n} from \"#src/internal/http/types\";\nimport type { Result } from \"#src/types\";\n\n/**\n * A request captured by {@link FakeHttpClient} for later assertion.\n */\nexport interface CapturedRequest {\n\t/** The per-request config passed alongside the request. */\n\treadonly config: RequestConfig;\n\t/** The request passed to {@link HttpClient.request}. */\n\treadonly request: HttpRequest;\n}\n\n/**\n * A fluent fake for the {@link HttpClient} boundary. Mocks are queued in\n * FIFO order and consumed by each `request()` call. Records every\n * request and config for later assertion. Throws\n * {@link FakeHttpClientError} if the queue is empty when `request()` is\n * called — surfaces missing mocks as test setup bugs instead of silently\n * repeating the last response.\n */\nexport interface FakeHttpClient extends HttpClient {\n\t/** Queues an {@link ApiError} with the given status code and optional message/code. */\n\tmockApiError(options: { code?: string; message?: string; statusCode: number }): this;\n\t/** Queues an error Result with the given error instance. */\n\tmockError(error: OpenCloudError): this;\n\t/** Queues a {@link NetworkError}. Preserves `cause` when provided. */\n\tmockNetworkError(options?: { cause?: unknown; message?: string }): this;\n\t/** Queues a {@link RateLimitError} with the given retry hint. */\n\tmockRateLimit(options: { message?: string; retryAfterSeconds: number }): this;\n\t/** Queues a successful {@link HttpResponse}. Body defaults to `{}`; headers default to `{}`. */\n\tmockResponse(options: {\n\t\tbody?: unknown;\n\t\theaders?: Readonly<Record<string, string>>;\n\t\tstatus: number;\n\t}): this;\n\t/** Number of queued mocks that have not yet been consumed. */\n\treadonly pendingMocks: number;\n\t/** Chronological log of every `(request, config)` pair the fake received. */\n\treadonly requests: ReadonlyArray<CapturedRequest>;\n}\n\ntype ErrorResult = Result<HttpResponse, OpenCloudError> & { success: false };\n\ninterface FakeState {\n\treadonly captured: Array<CapturedRequest>;\n\tconsumed: number;\n\treadonly queue: Array<Result<HttpResponse, OpenCloudError>>;\n}\n\n/**\n * Thrown when {@link FakeHttpClient.request} is called but no mock has\n * been queued. The message names the method, url, and consumed count to\n * aid debugging of missing `.mockResponse`/`.mockError` setup.\n */\nexport class FakeHttpClientError extends Error {\n\tpublic override readonly name: string = \"FakeHttpClientError\";\n}\n\n/**\n * Creates a fluent {@link FakeHttpClient} that sits at the\n * {@link HttpClient} seam. Use for integration tests where you need to\n * assert per-request config (apiKey, baseUrl) flows through to HTTP.\n *\n * @returns A fresh fake with an empty mock queue.\n */\nexport function createFakeHttpClient(): FakeHttpClient {\n\tconst state: FakeState = { captured: [], consumed: 0, queue: [] };\n\tfunction enqueue(result: Result<HttpResponse, OpenCloudError>): FakeHttpClient {\n\t\tstate.queue.push(result);\n\t\treturn fake;\n\t}\n\n\tconst fake: FakeHttpClient = {\n\t\tmockApiError: (options) => enqueue(errorResult(buildApiError(options))),\n\t\tmockError: (error) => enqueue(errorResult(error)),\n\t\tmockNetworkError: (options) => enqueue(errorResult(buildNetworkError(options))),\n\t\tmockRateLimit: (options) => enqueue(errorResult(buildRateLimitError(options))),\n\t\tmockResponse: (options) => enqueue(successResult(options)),\n\t\tget pendingMocks() {\n\t\t\treturn state.queue.length;\n\t\t},\n\t\trequest: async (request, config) => handleRequest({ config, request, state }),\n\t\tget requests() {\n\t\t\treturn state.captured;\n\t\t},\n\t};\n\n\treturn fake;\n}\n\nfunction consumeNextMock(\n\tstate: FakeState,\n\trequest: HttpRequest,\n): Result<HttpResponse, OpenCloudError> {\n\tconst next = state.queue.shift();\n\tif (next === undefined) {\n\t\tthrow new FakeHttpClientError(\n\t\t\t`FakeHttpClient: no mock queued for ${request.method} ${request.url} (consumed ${String(state.consumed)}, pending 0)`,\n\t\t);\n\t}\n\n\tstate.consumed += 1;\n\treturn next;\n}\n\nasync function handleRequest(options: {\n\treadonly config: RequestConfig;\n\treadonly request: HttpRequest;\n\treadonly state: FakeState;\n}): Promise<Result<HttpResponse, OpenCloudError>> {\n\tconst { config, request, state } = options;\n\tstate.captured.push({ config, request });\n\treturn consumeNextMock(state, request);\n}\n\nfunction successResult(options: {\n\tbody?: unknown;\n\theaders?: Readonly<Record<string, string>>;\n\tstatus: number;\n}): Result<HttpResponse, OpenCloudError> {\n\treturn {\n\t\tdata: {\n\t\t\tbody: options.body ?? {},\n\t\t\theaders: options.headers ?? {},\n\t\t\tstatus: options.status,\n\t\t},\n\t\tsuccess: true,\n\t};\n}\n\nfunction errorResult(err: OpenCloudError): ErrorResult {\n\treturn { err, success: false };\n}\n\nfunction buildApiError(options: { code?: string; message?: string; statusCode: number }): ApiError {\n\tconst message = options.message ?? \"API error\";\n\tif (options.code === undefined) {\n\t\treturn new ApiError(message, { statusCode: options.statusCode });\n\t}\n\n\treturn new ApiError(message, { code: options.code, statusCode: options.statusCode });\n}\n\nfunction buildNetworkError(\n\toptions: undefined | { cause?: unknown; message?: string },\n): NetworkError {\n\tconst message = options?.message ?? \"Network error\";\n\tif (options?.cause === undefined) {\n\t\treturn new NetworkError(message);\n\t}\n\n\treturn new NetworkError(message, { cause: options.cause });\n}\n\nfunction buildRateLimitError(options: {\n\tmessage?: string;\n\tretryAfterSeconds: number;\n}): RateLimitError {\n\treturn new RateLimitError(options.message ?? \"Rate limited\", {\n\t\tretryAfterSeconds: options.retryAfterSeconds,\n\t});\n}\n","import type { OpenCloudError } from \"#src/errors/base\";\nimport type { HttpRequest, HttpResponse } from \"#src/internal/http/types\";\nimport type { Result } from \"#src/types\";\n\n/**\n * The `send` callback shape consumed by `executeWithRetry`. A plain\n * transport function — no `RequestConfig`, no queueing, no retries.\n */\nexport type SendFunc = (request: HttpRequest) => Promise<Result<HttpResponse, OpenCloudError>>;\n\n/**\n * A scripted fake for the `send` callback. Replays responses in order\n * and records every request it receives.\n */\nexport interface FakeSend {\n\t/** Chronological log of every request the fake received. */\n\treadonly requests: ReadonlyArray<HttpRequest>;\n\t/** The scripted send callback. */\n\treadonly send: SendFunc;\n}\n\n/**\n * Creates a scripted fake for the `send` callback. Each call returns the\n * next queued response; exhausting the queue throws, which surfaces test\n * setup mistakes instead of silently repeating the last response.\n *\n * @param options - The scripted responses to replay, in order.\n * @returns A `send` callback plus a `requests` log.\n * @rejects {Error} When a call is made after all scripted responses are consumed.\n */\nexport function createFakeSend(options: {\n\treadonly responses: ReadonlyArray<Result<HttpResponse, OpenCloudError>>;\n}): FakeSend {\n\tconst requests: Array<HttpRequest> = [];\n\tlet index = 0;\n\n\tasync function send(request: HttpRequest): Promise<Result<HttpResponse, OpenCloudError>> {\n\t\trequests.push(request);\n\t\tconst response = options.responses[index];\n\t\tindex += 1;\n\n\t\tif (response === undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t`createFakeSend exhausted: ${String(index)} calls made, only ${String(options.responses.length)} responses scripted`,\n\t\t\t);\n\t\t}\n\n\t\treturn response;\n\t}\n\n\treturn { requests, send };\n}\n","import type { SleepFunc } from \"#src/internal/utils/sleep\";\n\n/**\n * A directly-callable sleep double that records its wait arguments without\n * delaying. Assignable to {@link SleepFunc}.\n */\nexport interface FakeSleep extends SleepFunc {\n\t/** Chronological log of every `ms` value the fake was called with. */\n\treadonly waits: ReadonlyArray<number>;\n}\n\n/**\n * Creates a {@link FakeSleep} that resolves immediately and records every\n * `ms` value it was called with.\n *\n * @returns A callable sleep function with a `waits` log attached.\n */\nexport function createFakeSleep(): FakeSleep {\n\tconst waits: Array<number> = [];\n\n\tasync function sleep(ms: number): Promise<void> {\n\t\twaits.push(ms);\n\t}\n\n\tconst fake: FakeSleep = Object.assign(sleep, {\n\t\tget waits(): ReadonlyArray<number> {\n\t\t\treturn waits;\n\t\t},\n\t});\n\n\treturn fake;\n}\n","import type {\n\tGameIconListWire,\n\tGetGameIconResponseWire,\n} from \"#src/domains/game-internationalization/game-icon/wire\";\n\n/**\n * Builds a minimally-valid {@link GetGameIconResponseWire} entry. Pass an\n * `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant.\n *\n * @param overrides - Fields to override on the default entry.\n * @returns A valid localized-icon entry with the overrides applied.\n */\nexport function validLocalizedIcon(\n\toverrides: Partial<GetGameIconResponseWire> = {},\n): GetGameIconResponseWire {\n\treturn {\n\t\timageId: \"12345\",\n\t\timageUrl: \"https://t1.rbxcdn.com/icon/12345\",\n\t\tlanguageCode: \"en_us\",\n\t\tstate: \"Approved\",\n\t\t...overrides,\n\t};\n}\n\n/**\n * Builds a minimally-valid {@link GameIconListWire} body containing a single\n * default localized icon.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validIconListBody(overrides: Partial<GameIconListWire> = {}): GameIconListWire {\n\treturn {\n\t\tdata: [validLocalizedIcon()],\n\t\t...overrides,\n\t};\n}\n","import type { GamePassConfigV2 } from \"#src/domains/game-passes/game-passes/wire\";\n\n/**\n * Test-only wire shape for the list response. Mirrors the OpenAPI\n * schema, which marks `nextPageToken` as required and nullable, so\n * fixtures can carry the literal JSON `null` the API sends on the last\n * page without leaking `null` into the production wire type (which\n * exposes a post-normalization view of `string | undefined`).\n */\ninterface ListGamePassesWireBody {\n\treadonly gamePasses: ReadonlyArray<GamePassConfigV2>;\n\n\treadonly nextPageToken: null | string;\n}\n\n/**\n * Builds a minimally-valid {@link GamePassConfigV2} wire body. Pass an\n * `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant — useful for parser and integration tests that\n * only care about one field at a time.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validGamePassBody(overrides: Partial<GamePassConfigV2> = {}): GamePassConfigV2 {\n\treturn {\n\t\tname: \"Epic Pass\",\n\t\tcreatedTimestamp: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"Unlocks epic stuff\",\n\t\tgamePassId: 12_345,\n\t\ticonAssetId: 67_890,\n\t\tisForSale: true,\n\t\tpriceInformation: { defaultPriceInRobux: 100, enabledFeatures: [] },\n\t\tupdatedTimestamp: \"2024-03-20T14:45:00.000Z\",\n\t\t...overrides,\n\t};\n}\n\n/**\n * Builds a minimally-valid wire body for the \"list game passes\" endpoint.\n * By default the page contains one game pass and `nextPageToken` is the\n * literal JSON `null` the API sends on the last page; `overrides` let\n * parser and integration tests tweak the items array or the cursor\n * without rebuilding the whole shape.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied. `nextPageToken`\n *   defaults to the wire's literal `null`, which the response parser\n *   normalizes to `undefined` at the boundary.\n */\nexport function validListGamePassesBody(\n\toverrides: Partial<ListGamePassesWireBody> = {},\n): ListGamePassesWireBody {\n\treturn {\n\t\tgamePasses: [validGamePassBody()],\n\t\t// eslint-disable-next-line unicorn/no-null -- API sends null on the last page; parser normalizes to undefined.\n\t\tnextPageToken: null,\n\t\t...overrides,\n\t};\n}\n","import type { GameThumbnailUploadWire } from \"#src/domains/game-internationalization/game-thumbnails/wire\";\n\n/**\n * Builds a minimally-valid {@link GameThumbnailUploadWire} body. Pass an\n * `overrides` object to tweak individual fields while keeping everything\n * else schema-compliant; useful for parser and integration tests that\n * only care about one field at a time.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validThumbnailUploadBody(\n\toverrides: Partial<GameThumbnailUploadWire> = {},\n): GameThumbnailUploadWire {\n\treturn { mediaAssetId: \"67890\", ...overrides };\n}\n","import type { LuauExecutionTaskBinaryInputWire } from \"#src/domains/cloud-v2/luau-execution-task-binary-inputs/wire\";\n\n/**\n * Builds a minimally-valid {@link LuauExecutionTaskBinaryInputWire} body\n * for tests. Pass an `overrides` object to tweak fields without re-stating\n * the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validBinaryInputBody(\n\toverrides: Partial<LuauExecutionTaskBinaryInputWire> = {},\n): LuauExecutionTaskBinaryInputWire {\n\treturn {\n\t\tpath: \"universes/123/luau-execution-session-task-binary-inputs/abc\",\n\t\tuploadUri: \"https://storage.example.com/upload?token=xyz\",\n\t\t...overrides,\n\t};\n}\n","import type { ListLogsResponseWire } from \"#src/domains/cloud-v2/luau-execution-task-logs/wire\";\n\n/**\n * Builds a minimally-valid {@link ListLogsResponseWire} body containing\n * one chunk with one structured message. Pass an `overrides` object to\n * tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validLogPageBody(\n\toverrides: Partial<ListLogsResponseWire> = {},\n): ListLogsResponseWire {\n\treturn {\n\t\tluauExecutionSessionTaskLogs: [\n\t\t\t{\n\t\t\t\tstructuredMessages: [\n\t\t\t\t\t{\n\t\t\t\t\t\tcreateTime: \"2026-01-01T00:00:00Z\",\n\t\t\t\t\t\tmessage: \"Hello from Luau\",\n\t\t\t\t\t\tmessageType: \"OUTPUT\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t\t...overrides,\n\t};\n}\n","import type { LuauExecutionTaskWire } from \"#src/domains/cloud-v2/luau-execution-tasks/wire\";\n\n/**\n * Builds a minimally-valid {@link LuauExecutionTaskWire} body for an\n * in-progress task. Pass an `overrides` object to tweak fields without\n * re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validInProgressTaskBody(\n\toverrides: Partial<LuauExecutionTaskWire> = {},\n): LuauExecutionTaskWire {\n\treturn {\n\t\tcreateTime: \"2026-01-01T00:00:00Z\",\n\t\tpath: \"universes/123/places/456/luau-execution-session-tasks/task-1\",\n\t\tstate: \"QUEUED\",\n\t\tupdateTime: \"2026-01-01T00:00:30Z\",\n\t\tuser: \"user-1\",\n\t\t...overrides,\n\t};\n}\n","import type {\n\tMemoryStoreQueueItemWire,\n\tReadQueueItemsResponseWire,\n} from \"#src/domains/cloud-v2/memory-store-queues/wire\";\n\n/**\n * Builds a minimally-valid {@link MemoryStoreQueueItemWire} body. Pass\n * an `overrides` object to tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validQueueItemBody(\n\toverrides: Partial<MemoryStoreQueueItemWire> = {},\n): MemoryStoreQueueItemWire {\n\treturn {\n\t\tdata: \"hello\",\n\t\texpireTime: \"2026-06-21T15:08:58.4806559Z\",\n\t\tpath: \"cloud/v2/universes/123/memory-store/queues/test-queue/items/abc123\",\n\t\tpriority: 1,\n\t\t...overrides,\n\t};\n}\n\n/**\n * Builds a minimally-valid {@link ReadQueueItemsResponseWire} body\n * carrying a single default queue item. Pass an `overrides` object to\n * change the read identifier or supply a different items array.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid dequeue response body with the overrides applied.\n */\nexport function validDequeueBody(\n\toverrides: Partial<ReadQueueItemsResponseWire> = {},\n): ReadQueueItemsResponseWire {\n\treturn {\n\t\tid: \"1a354bd5b8fe457f8e51232f8dbfe6d0\",\n\t\tqueueItems: [validQueueItemBody()],\n\t\t...overrides,\n\t};\n}\n","import type { PlaceWire } from \"#src/domains/cloud-v2/places/wire\";\nimport { RBXL_SIGNATURE, RBXLX_SIGNATURE } from \"#src/domains/universes/places/signatures\";\nimport type { PlaceVersionWire } from \"#src/domains/universes/places/wire\";\n\n/**\n * Returns a fresh, minimal `.rbxl`-formatted body whose magic bytes\n * match {@link RBXL_SIGNATURE}. Useful when integration tests don't\n * care about the file's contents past the signature.\n *\n * @returns A 14-byte rbxl body matching the binary signature.\n */\nexport function rbxlBody(): Uint8Array<ArrayBuffer> {\n\treturn new Uint8Array(RBXL_SIGNATURE);\n}\n\n/**\n * Returns a fresh, minimal `.rbxlx`-formatted body whose magic bytes\n * match {@link RBXLX_SIGNATURE}. Useful when integration tests don't\n * care about the file's contents past the signature.\n *\n * @returns An 8-byte rbxlx body matching the XML signature.\n */\nexport function rbxlxBody(): Uint8Array<ArrayBuffer> {\n\treturn new Uint8Array(RBXLX_SIGNATURE);\n}\n\n/**\n * Builds a minimally-valid {@link PlaceVersionWire} body. Pass an\n * `overrides` object to tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validPublishResponseBody(\n\toverrides: Partial<PlaceVersionWire> = {},\n): PlaceVersionWire {\n\treturn {\n\t\tversionNumber: 1,\n\t\t...overrides,\n\t};\n}\n\n/**\n * Builds a minimally-valid {@link PlaceWire} body. Pass an `overrides`\n * object to tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validPlaceBody(overrides: Partial<PlaceWire> = {}): PlaceWire {\n\treturn {\n\t\tcreateTime: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"A sample place.\",\n\t\tdisplayName: \"Test Place\",\n\t\tpath: \"universes/123/places/456\",\n\t\troot: true,\n\t\tserverSize: 30,\n\t\tuniverseRuntimeCreation: false,\n\t\tupdateTime: \"2024-11-02T17:08:21.500Z\",\n\t\t...overrides,\n\t};\n}\n","import type { UniverseWire } from \"#src/domains/cloud-v2/universes/wire\";\n\n/**\n * Builds a minimally-valid {@link UniverseWire} body. Pass an\n * `overrides` object to tweak fields without re-stating the defaults.\n *\n * @param overrides - Fields to override on the default body.\n * @returns A valid wire body with the overrides applied.\n */\nexport function validUniverseBody(overrides: Partial<UniverseWire> = {}): UniverseWire {\n\treturn {\n\t\tageRating: \"AGE_RATING_13_PLUS\",\n\t\tconsoleEnabled: false,\n\t\tcreateTime: \"2024-01-15T10:30:00.000Z\",\n\t\tdescription: \"A sample universe for tests.\",\n\t\tdesktopEnabled: true,\n\t\tdisplayName: \"Test Universe\",\n\t\tmobileEnabled: true,\n\t\tpath: \"universes/12345\",\n\t\trootPlace: \"universes/12345/places/98765\",\n\t\ttabletEnabled: true,\n\t\tupdateTime: \"2024-11-02T17:08:21.500Z\",\n\t\tuser: \"users/7777\",\n\t\tvisibility: \"PUBLIC\",\n\t\tvoiceChatEnabled: false,\n\t\tvrEnabled: false,\n\t\t...overrides,\n\t};\n}\n"],"mappings":"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"}

package/dist/{to-blob-B27VhoRp.mjs → to-blob-RPqMBuft.mjs}

@@ -15,4 +15,4 @@ function toBlob(value) {
 //#endregion
 export { toBlob as t };
 
-//# sourceMappingURL=to-blob-B27VhoRp.mjs.map
+//# sourceMappingURL=to-blob-RPqMBuft.mjs.map

package/dist/{to-blob-B27VhoRp.mjs.map → to-blob-RPqMBuft.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"to-blob-B27VhoRp.mjs","names":[],"sources":["../src/internal/utils/to-blob.ts"],"sourcesContent":["/**\n * Wraps a binary value as a {@link Blob}, copying `Uint8Array` input into a\n * fresh `Blob` so the originating buffer cannot be mutated between request\n * build and send. `Blob` input is returned as-is so MIME-type metadata is\n * preserved.\n *\n * @param value - Binary data to convert.\n * @returns The supplied `Blob`, or a new `Blob` wrapping a defensive copy.\n */\nexport function toBlob(value: Blob | Uint8Array): Blob {\n\tif (value instanceof Blob) {\n\t\treturn value;\n\t}\n\n\treturn new Blob([new Uint8Array(value)]);\n}\n"],"mappings":";;;;;;;;;;AASA,SAAgB,OAAO,OAAgC;AACtD,KAAI,iBAAiB,KACpB,QAAO;AAGR,QAAO,IAAI,KAAK,CAAC,IAAI,WAAW,MAAM,CAAC,CAAC"}
+{"version":3,"file":"to-blob-RPqMBuft.mjs","names":[],"sources":["../src/internal/utils/to-blob.ts"],"sourcesContent":["/**\n * Wraps a binary value as a {@link Blob}, copying `Uint8Array` input into a\n * fresh `Blob` so the originating buffer cannot be mutated between request\n * build and send. `Blob` input is returned as-is so MIME-type metadata is\n * preserved.\n *\n * @param value - Binary data to convert.\n * @returns The supplied `Blob`, or a new `Blob` wrapping a defensive copy.\n */\nexport function toBlob(value: Blob | Uint8Array): Blob {\n\tif (value instanceof Blob) {\n\t\treturn value;\n\t}\n\n\treturn new Blob([new Uint8Array(value)]);\n}\n"],"mappings":";;;;;;;;;;AASA,SAAgB,OAAO,OAAgC;CACtD,IAAI,iBAAiB,MACpB,OAAO;CAGR,OAAO,IAAI,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,CAAC;AACxC"}

package/dist/{types-CwtZT1ek.d.mts → types-CRiJg5EQ.d.mts}

@@ -4,13 +4,19 @@
 *
 * All specific error types (RateLimitError, ApiError, NetworkError)
 * extend this class, enabling `instanceof OpenCloudError` checks.
+*
+* @since 0.1.0
 */
 declare class OpenCloudError extends Error {
   override readonly name: string;
 }
 //#endregion
 //#region src/internal/utils/sleep.d.ts
-/** Injectable sleep function signature for testing. */
+/**
+* Injectable sleep function signature for testing.
+*
+* @since 0.1.0
+*/
 type SleepFunc = (ms: number) => Promise<void>;
 //#endregion
 //#region src/types.d.ts
@@ -20,6 +26,8 @@ type SleepFunc = (ms: number) => Promise<void>;
 * Every SDK client method returns `Promise<Result<T, OpenCloudError>>`.
 * Errors are never thrown; they are returned as `{ err, success: false }`.
 *
+* @since 0.1.0
+*
 * @template T - The success value type.
 * @template E - The error type (defaults to `Error`).
 *
@@ -65,6 +73,8 @@ type Result<T, E = Error> = {
 * `null`-vs-absent variants to `undefined` so callers only ever see one
 * shape.
 *
+* @since 0.1.0
+*
 * @template T - The public item type for the listed resource.
 *
 * @example
@@ -91,6 +101,8 @@ interface Page<T> {
 //#region src/client/types.d.ts
 /**
 * A normalized HTTP request to send to the Roblox Open Cloud API.
+*
+* @since 0.1.0
 */
 interface HttpRequest {
   /** The request body. */
@@ -108,6 +120,8 @@ interface HttpRequest {
 }
 /**
 * A normalized HTTP response from the Roblox Open Cloud API.
+*
+* @since 0.1.0
 */
 interface HttpResponse {
   /**
@@ -123,6 +137,8 @@ interface HttpResponse {
 }
 /**
 * Per-request configuration passed to {@link HttpClient.request}.
+*
+* @since 0.1.0
 */
 interface RequestConfig {
   /** The Roblox Open Cloud API key. */
@@ -135,6 +151,8 @@ interface RequestConfig {
 /**
 * HTTP transport abstraction. Implementations classify every response into
 * a typed {@link Result}.
+*
+* @since 0.1.0
 */
 interface HttpClient {
   /** Sends an HTTP request and classifies the response. */
@@ -143,6 +161,8 @@ interface HttpClient {
 /**
 * Client-level observability hooks. All hooks are notification-only and
 * fire-and-forget; they cannot alter retry behaviour.
+*
+* @since 0.1.0
 */
 interface OpenCloudHooks {
   /** Fired before the SDK sleeps for a computed retry or rate-limit wait. */
@@ -155,6 +175,8 @@ interface OpenCloudHooks {
 /**
 * Options accepted by every resource client constructor. Cross-cutting
 * configuration that applies to all requests made through the client instance.
+*
+* @since 0.1.0
 */
 interface OpenCloudClientOptions {
   /** The Roblox Open Cloud API key used as the default for every request. */
@@ -179,6 +201,16 @@ interface OpenCloudClientOptions {
   * method (e.g. `create` only retries `429`).
   */
   readonly retryableStatuses?: ReadonlyArray<number>;
+  /**
+  * Node-style transport error codes eligible for retry when a request fails
+  * with a `NetworkError` (e.g. `["ECONNRESET", "ETIMEDOUT"]`).
+  * Defaults to the idempotent-method transient set. Create methods default
+  * to none and cannot be relaxed by a client-level value. Pass the exported
+  * `TRANSIENT_TRANSPORT_CODES` set (or your own subset) on a single call's
+  * {@link RequestOptions} to opt a create into transport retries when a
+  * duplicate resource is acceptable.
+  */
+  readonly retryableTransportCodes?: ReadonlyArray<string>;
   /** Fallback delay function used when no server hint is available. */
   readonly retryDelay?: (attempt: number) => number;
   /**
@@ -188,15 +220,25 @@ interface OpenCloudClientOptions {
   * use the default `setTimeout`-backed sleep.
   */
   readonly sleep?: SleepFunc;
-  /** Per-request timeout in milliseconds. Defaults to `30_000`. */
+  /**
+  * Default per-request timeout in milliseconds for JSON-bound methods,
+  * defaulting to `30_000`. Upload methods (those whose request body is
+  * `FormData` or `Uint8Array`, such as place publishes and icon uploads)
+  * have no default deadline and ignore this option: upload latency is
+  * bandwidth-bound, and the SDK cannot size a wall-clock budget without
+  * knowing payload size and link quality. Set a deadline on any single
+  * call, upload or otherwise, with `options.timeout`.
+  */
   readonly timeout?: number;
 }
 /**
 * Per-request override shape. Any subset of the overridable client options
 * may be supplied for a single request; omitted fields fall through to the
 * client-level defaults.
+*
+* @since 0.1.0
 */
-type RequestOptions = Partial<Pick<OpenCloudClientOptions, "apiKey" | "baseUrl" | "maxRetries" | "retryableStatuses" | "retryDelay" | "timeout">>;
+type RequestOptions = Partial<Pick<OpenCloudClientOptions, "apiKey" | "baseUrl" | "maxRetries" | "retryableStatuses" | "retryableTransportCodes" | "retryDelay" | "timeout">>;
 /**
 * Supported request body types.
 *
@@ -211,4 +253,4 @@ type RequestOptions = Partial<Pick<OpenCloudClientOptions, "apiKey" | "baseUrl"
 type HttpRequestBody = FormData | Record<string, unknown> | Uint8Array<ArrayBuffer> | undefined;
 //#endregion
 export { OpenCloudHooks as a, Page as c, OpenCloudError as d, OpenCloudClientOptions as i, Result as l, HttpRequest as n, RequestConfig as o, HttpResponse as r, RequestOptions as s, HttpClient as t, SleepFunc as u };
-//# sourceMappingURL=types-CwtZT1ek.d.mts.map
+//# sourceMappingURL=types-CRiJg5EQ.d.mts.map

package/dist/types-CRiJg5EQ.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CRiJg5EQ.d.mts","names":[],"sources":["../src/errors/base.ts","../src/internal/utils/sleep.ts","../src/types.ts","../src/client/types.ts"],"mappings":";;AAQA;;;;AAC0B;;;cADb,cAAA,SAAuB,KAAA;EAAA,kBACV,IAAA;AAAA;;;;AAD1B;;;;KCHY,SAAA,IAAa,EAAA,aAAe,OAAA;;;;ADGxC;;;;AAC0B;;;;ACJ1B;;;;AAAwC;;;;AC+BxC;;;;;;;;;;;;;;;;;;AAA0E;KAA9D,MAAA,QAAc,KAAA;EAAW,IAAA,EAAM,CAAA;EAAG,OAAA;AAAA;EAAoB,GAAA,EAAK,CAAA;EAAG,OAAA;AAAA;AAkChE;;;;AC3DV;;;;;;;;;;;;;;;;AAYU;AAQV;;;;;;;ADuCU,UAJO,IAAA;;WAEP,KAAA,EAAO,aAAA,CAAc,CAAA;EC3BrB;EAAA,SD6BA,aAAA;AAAA;;;;AF7DgB;;;;UGET,WAAA;EFNL;EAAA,SEQF,IAAA,GAAO,eAAA;EFRuB;AAAA;;;;EAAA,SEc9B,OAAA,GAAU,QAAA,CAAS,MAAA;EDiBjB;EAAA,SCfF,MAAA;;WAEA,GAAA;AAAA;;;;;;UAQO,YAAA;;;;;;WAMP,IAAA;EDDgE;EAAA,SCGhE,OAAA,EAAS,QAAA,CAAS,MAAA;ED2BX;EAAA,SCzBP,MAAA;AAAA;;;;;;UAQO,aAAA;EDqBP;EAAA,SCnBA,MAAA;;WAEA,OAAA;EA1CV;EAAA,SA4CU,OAAA;AAAA;;;;;;;UASO,UAAA;;EAEhB,OAAA,CACC,OAAA,EAAS,WAAA,EACT,MAAA,EAAQ,aAAA,GACN,OAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,cAAA;AAAA;;;;AA9CvB;AAQV;;UA+CiB,cAAA;EAvCE;EAAA,SAyCT,WAAA,IAAe,MAAA;;WAEf,SAAA,IAAa,OAAA,EAAS,WAAA;;WAEtB,OAAA,IAAW,OAAA,UAAiB,KAAA,EAAO,cAAA;AAAA;AA3CnC;AAQV;;;;;AARU,UAoDO,sBAAA;;WAEP,MAAA;EAxCA;EAAA,SA0CA,OAAA;EAjCO;EAAA,SAmCP,KAAA,GAAQ,cAAA;;;;;;;;WAQR,UAAA,GAAa,UAAA;;WAEb,UAAA;;;;;;WAMA,iBAAA,GAAoB,aAAA;;;AA9CG;AASjC;;;;;;WA+CU,uBAAA,GAA0B,aAAA;;WAE1B,UAAA,IAAc,OAAA;;;;;;AA3CqB;WAkDnC,KAAA,GAAQ,SAAA;EAzCD;;;;;;;;;EAAA,SAmDP,OAAA;AAAA;;;;;;;;KAUE,cAAA,GAAiB,OAAA,CAC5B,IAAA,CACC,sBAAA;;;;;;;;AAZQ;AAUV;;;KAwBK,eAAA,GAAkB,QAAA,GAAW,MAAA,oBAA0B,UAAA,CAAW,WAAA"}

package/dist/universes.d.mts

@@ -1,10 +1,12 @@
-import { d as OpenCloudError, i as OpenCloudClientOptions, l as Result, s as RequestOptions } from "./types-CwtZT1ek.mjs";
-import { i as RobloxLocale, r as RobloxLanguageCode } from "./data.generated-Cb6g6asv.mjs";
-import { n as GameIconState } from "./wire-CeL6W_V7.mjs";
+import { d as OpenCloudError, i as OpenCloudClientOptions, l as Result, s as RequestOptions } from "./types-CRiJg5EQ.mjs";
+import { i as RobloxLocale, r as RobloxLanguageCode } from "./data.generated-B2ceLfSn.mjs";
+import { n as GameIconState } from "./wire-D3K-a-UP.mjs";
 
 //#region src/domains/cloud-v2/universes/types.d.ts
 /**
 * Caller-supplied input for the `get` method on `UniversesClient`.
+*
+* @since 0.1.0
 */
 interface GetUniverseParameters {
   /** Stringified ID of the universe to fetch. */
@@ -12,6 +14,8 @@ interface GetUniverseParameters {
 }
 /**
 * A social link that may be associated with a universe.
+*
+* @since 0.1.0
 */
 interface SocialLink {
   /** Display title of the link. */
@@ -19,7 +23,11 @@ interface SocialLink {
   /** Destination URI. */
   readonly uri: string;
 }
-/** Public visibility classification. */
+/**
+* Public visibility classification.
+*
+* @since 0.1.0
+*/
 type UniverseVisibility = "private" | "public" | "unspecified";
 /**
 * Caller-supplied input for the `update` method on `UniversesClient`.
@@ -29,6 +37,8 @@ type UniverseVisibility = "private" | "public" | "unspecified";
 * Setting a key to `undefined` clears the corresponding server-side
 * value (applicable to `privateServerPriceRobux` and each optional
 * social link).
+*
+* @since 0.1.0
 */
 interface UpdateUniverseParameters {
   /** Whether console players can join. */
@@ -64,6 +74,8 @@ interface UpdateUniverseParameters {
 }
 /**
 * Discriminated-union representation of a universe's owner.
+*
+* @since 0.1.0
 */
 interface UniverseOwner {
   /**
@@ -74,10 +86,16 @@ interface UniverseOwner {
   /** Whether the owner is a user or a group. */
   readonly kind: "group" | "user";
 }
-/** Public age-rating classification. */
+/**
+* Public age-rating classification.
+*
+* @since 0.1.0
+*/
 type UniverseAgeRating = "9Plus" | "13Plus" | "17Plus" | "all" | "unspecified";
 /**
 * Parsed representation of a Roblox universe's configuration.
+*
+* @since 0.1.0
 */
 interface Universe {
   /** Stringified universe ID, extracted from the wire `path`. */
@@ -131,6 +149,8 @@ interface Universe {
 //#region src/domains/game-internationalization/game-icon/types.d.ts
 /**
 * A localized icon entry returned by listing icons for an experience.
+*
+* @since 0.1.0
 */
 interface ExperienceIcon {
   /** Stringified ID of the uploaded icon image. */
@@ -150,6 +170,8 @@ interface ExperienceIcon {
 * Parameters for uploading or replacing a localized experience icon. A
 * subsequent upload for the same `(universeId, languageCode)` pair replaces
 * the existing icon for that locale.
+*
+* @since 0.1.0
 */
 interface UploadExperienceIconParameters {
   /** Image bytes to upload. PNG and JPEG are accepted by the server. */
@@ -166,6 +188,8 @@ interface UploadExperienceIconParameters {
 /**
 * Parameters for deleting the localized icon registered against a universe
 * for a given language.
+*
+* @since 0.1.0
 */
 interface DeleteExperienceIconParameters {
   /**
@@ -179,6 +203,8 @@ interface DeleteExperienceIconParameters {
 }
 /**
 * Parameters for listing every localized icon registered against a universe.
+*
+* @since 0.1.0
 */
 interface ListExperienceIconsParameters {
   /** Stringified ID of the universe whose icons are being listed. */
@@ -188,6 +214,8 @@ interface ListExperienceIconsParameters {
 //#region src/domains/game-internationalization/game-thumbnails/types.d.ts
 /**
 * Result of uploading a localized experience thumbnail.
+*
+* @since 0.1.0
 */
 interface UploadedExperienceThumbnail {
   /** Stringified media asset ID of the uploaded thumbnail. */
@@ -197,6 +225,8 @@ interface UploadedExperienceThumbnail {
 * Parameters for uploading a new localized experience thumbnail. Each upload
 * appends a new entry to the carousel; reorder via {@link ReorderExperienceThumbnailsParameters}
 * after multiple uploads to set the display order.
+*
+* @since 0.1.0
 */
 interface UploadExperienceThumbnailParameters {
   /** Image bytes to upload. PNG and JPEG are accepted by the server. */
@@ -212,6 +242,8 @@ interface UploadExperienceThumbnailParameters {
 }
 /**
 * Parameters for deleting a single thumbnail by media asset ID.
+*
+* @since 0.1.0
 */
 interface DeleteExperienceThumbnailParameters {
   /** Stringified media asset ID of the thumbnail to delete. */
@@ -228,6 +260,8 @@ interface DeleteExperienceThumbnailParameters {
 /**
 * Parameters for reordering the localized thumbnail carousel. The supplied
 * `orderedImageIds` describes the new display order from first to last.
+*
+* @since 0.1.0
 */
 interface ReorderExperienceThumbnailsParameters {
   /**
@@ -273,6 +307,9 @@ interface UniverseIconHandle {
   * subsequent upload for the same `(universeId, languageCode)` pair
   * replaces the existing icon for that locale.
   *
+  * No default request timeout applies to this upload; pass `options.timeout`
+  * to set a per-call deadline.
+  *
   * @param parameters - Universe and language identifiers plus the image
   *   bytes to upload.
   * @param options - Optional per-request overrides (e.g. A different
@@ -312,6 +349,9 @@ interface UniverseThumbnailsHandle {
   * {@link UniverseThumbnailsHandle.reorder} after multiple uploads to
   * set the display order.
   *
+  * No default request timeout applies to this upload; pass `options.timeout`
+  * to set a per-call deadline.
+  *
   * @param parameters - Universe and language identifiers plus the image
   *   bytes to upload.
   * @param options - Optional per-request overrides (e.g. A different
@@ -341,6 +381,8 @@ interface UniverseThumbnailsHandle {
 * {@link UniversesClient.thumbnails} Operation Groups so callers reach
 * for one client per universe.
 *
+* @since 0.1.0
+*
 * @example
 *
 * ```ts

package/dist/universes.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"universes.d.mts","names":[],"sources":["../src/domains/cloud-v2/universes/types.ts","../src/domains/game-internationalization/game-icon/types.ts","../src/domains/game-internationalization/game-thumbnails/types.ts","../src/resources/universes/client.ts"],"mappings":"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"}
+{"version":3,"file":"universes.d.mts","names":[],"sources":["../src/domains/cloud-v2/universes/types.ts","../src/domains/game-internationalization/game-icon/types.ts","../src/domains/game-internationalization/game-thumbnails/types.ts","../src/resources/universes/client.ts"],"mappings":"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"}

package/dist/universes.mjs

@@ -1,7 +1,8 @@
-import { r as ApiError } from "./rate-limit-D1q2Js-z.mjs";
-import { t as ValidationError } from "./validation-DkL5KQqz.mjs";
-import { t as toBlob } from "./to-blob-B27VhoRp.mjs";
-import { a as IDEMPOTENT_METHOD_DEFAULTS, c as isDateTimeString, i as CREATE_METHOD_DEFAULTS, n as okRequest, r as parseEmptyResponse, s as isRecord, t as ResourceClient } from "./resource-client-D6Efj9fU.mjs";
+import { r as ApiError } from "./rate-limit-Dh2leqaB.mjs";
+import { n as IDEMPOTENT_METHOD_DEFAULTS, t as CREATE_METHOD_DEFAULTS } from "./retry-BvZRZDXs.mjs";
+import { t as ValidationError } from "./validation-xJZRa8tX.mjs";
+import { t as toBlob } from "./to-blob-RPqMBuft.mjs";
+import { a as isDateTimeString, i as isRecord, n as okRequest, r as parseEmptyResponse, t as ResourceClient } from "./resource-client-CIAkS2xQ.mjs";
 //#region src/domains/cloud-v2/universes/builders.ts
 /**
 * Dodges `unicorn/no-null` while still emitting a literal `null` onto
@@ -106,6 +107,9 @@ const AGE_RATING_MAP = {
 	AGE_RATING_UNSPECIFIED: "unspecified"
 };
 const MALFORMED_MESSAGE = "Malformed universe response";
+const UNIVERSE_PATH_PATTERN = /^universes\/(\d+)$/;
+const ROOT_PLACE_PATH_PATTERN = /\/places\/(\d+)$/;
+const OWNER_PATH_PATTERN = /^(?:users|groups)\/(\d+)$/;
 /**
 * Parses a successful Open Cloud `Universe` response body into the
 * public {@link Universe} shape.
@@ -116,11 +120,11 @@ const MALFORMED_MESSAGE = "Malformed universe response";
 */
 function parseUniverseResponse(response) {
 	const { body, status: statusCode } = response;
-	if (!isUniverseWire(body)) return malformed(statusCode);
+	if (!isUniverseWire(body)) return malformed(statusCode, body);
 	const ownerResult = resolveOwner(body);
-	if (!ownerResult.success) return malformed(statusCode);
-	const id = /^universes\/(\d+)$/.exec(body.path)?.[1];
-	if (id === void 0) return malformed(statusCode);
+	if (!ownerResult.success) return malformed(statusCode, body);
+	const id = UNIVERSE_PATH_PATTERN.exec(body.path)?.[1];
+	if (id === void 0) return malformed(statusCode, body);
 	return {
 		data: toUniverse({
 			id,
@@ -130,15 +134,18 @@ function parseUniverseResponse(response) {
 		success: true
 	};
 }
-function malformed(statusCode) {
+function malformed(statusCode, body) {
 	return {
-		err: new ApiError(MALFORMED_MESSAGE, { statusCode }),
+		err: new ApiError(MALFORMED_MESSAGE, {
+			details: body,
+			statusCode
+		}),
 		success: false
 	};
 }
 function extractRootPlaceId(rootPlace) {
 	if (rootPlace === void 0) return;
-	return /\/places\/(\d+)$/.exec(rootPlace)?.[1];
+	return ROOT_PLACE_PATH_PATTERN.exec(rootPlace)?.[1];
 }
 function toSocialLink(wire) {
 	if (wire === void 0) return;
@@ -206,7 +213,7 @@ function isUniverseWire(body) {
 	return hasValidRequiredFields(body) && hasValidOptionalFields(body);
 }
 function extractOwnerId(resourcePath) {
-	return /^(?:users|groups)\/(\d+)$/.exec(resourcePath)?.[1];
+	return OWNER_PATH_PATTERN.exec(resourcePath)?.[1];
 }
 function resolveOwner(body) {
 	if (typeof body.user === "string") {
@@ -315,7 +322,10 @@ const ICON_REQUIRED_SCOPES = Object.freeze(["legacy-universe:manage"]);
 function parseIconListResponse(response) {
 	const { body, status: statusCode } = response;
 	if (!isGameIconListWire(body)) return {
-		err: new ApiError("Malformed icon list response", { statusCode }),
+		err: new ApiError("Malformed icon list response", {
+			details: body,
+			statusCode
+		}),
 		success: false
 	};
 	return {
@@ -346,6 +356,7 @@ function toExperienceIcon(wire) {
 }
 //#endregion
 //#region src/domains/game-internationalization/game-thumbnails/builders.ts
+const POSITIVE_INTEGER_PATTERN = /^[1-9]\d*$/;
 /**
 * Builds a `POST` request for the localized "upload experience thumbnail"
 * endpoint. Each successful upload appends a new entry to the carousel.
@@ -400,7 +411,7 @@ function buildReorderThumbnailsRequest(parameters) {
 	};
 }
 function parseImageId(value) {
-	if (!/^[1-9]\d*$/.test(value)) return;
+	if (!POSITIVE_INTEGER_PATTERN.test(value)) return;
 	const parsed = Number(value);
 	if (!Number.isSafeInteger(parsed)) return;
 	return parsed;
@@ -461,7 +472,10 @@ const THUMBNAILS_REQUIRED_SCOPES = Object.freeze(["legacy-universe:manage"]);
 function parseThumbnailUploadResponse(response) {
 	const { body, status: statusCode } = response;
 	if (!isGameThumbnailUploadWire(body)) return {
-		err: new ApiError("Malformed thumbnail upload response", { statusCode }),
+		err: new ApiError("Malformed thumbnail upload response", {
+			details: body,
+			statusCode
+		}),
 		success: false
 	};
 	return {
@@ -572,6 +586,8 @@ const THUMBNAIL_REORDER_SPEC = Object.freeze({
 * {@link UniversesClient.thumbnails} Operation Groups so callers reach
 * for one client per universe.
 *
+* @since 0.1.0
+*
 * @example
 *
 * ```ts