@bedrock-rbx/ocale 0.1.0-beta.2 → 0.1.0-beta.20

package/dist/testing.d.mts

@@ -0,0 +1,727 @@
+import { d as OpenCloudError, l as Result, n as HttpRequest, o as RequestConfig, r as HttpResponse, t as HttpClient, u as SleepFunc } from "./types-CRiJg5EQ.mjs";
+import { r as GetGameIconResponseWire, t as GameIconListWire } from "./wire-D3K-a-UP.mjs";
+
+//#region src/domains/badges/badges/wire.d.ts
+/**
+* Wire shape of
+* `Roblox.Web.Responses.RelatedEntityTypeResponse_Roblox.Platform.Badges.BadgeAwarderType_`.
+*/
+interface BadgeAwarderWire {
+  /** Int64 awarder ID. */
+  readonly id: number;
+  /** Display name of the awarding entity. */
+  readonly name: string;
+  /** Numeric awarder kind. `1` is `Place`. */
+  readonly type: BadgeAwarderTypeWire;
+}
+/**
+* Wire shape of `Roblox.Web.Responses.Badges.BadgeAwardStatisticsResponse`.
+*/
+interface BadgeStatisticsWire {
+  /** Int64 lifetime awarded count. */
+  readonly awardedCount: number;
+  /** Int64 awarded count over the past day. */
+  readonly pastDayAwardedCount: number;
+  /** Double win-rate percentage in the range `[0, 100]`. */
+  readonly winRatePercentage: number;
+}
+/**
+* Wire shape of `Roblox.Web.Responses.Badges.BadgeResponseV2`: the response
+* body returned by the legacy badges create endpoint.
+*/
+interface BadgeResponseV2Wire {
+  /** Int64 badge ID, serialized as a JSON number. */
+  readonly id: number;
+  /** Display name of the badge. */
+  readonly name: string;
+  /** Awarding entity block. */
+  readonly awarder: BadgeAwarderWire;
+  /** ISO timestamp at which the badge was created (`date-time`). */
+  readonly created: string;
+  /** Source-language description. */
+  readonly description: string;
+  /** Resolved description for the requesting locale. */
+  readonly displayDescription: string;
+  /** Int64 resolved icon image asset ID; `0` signals no icon for this locale. */
+  readonly displayIconImageId: number;
+  /** Resolved name for the requesting locale. */
+  readonly displayName: string;
+  /** Whether the badge is currently active. Disabled badges cannot be awarded. */
+  readonly enabled: boolean;
+  /** Int64 source-language icon image asset ID; `0` signals no icon. */
+  readonly iconImageId: number;
+  /** Award statistics block. */
+  readonly statistics: BadgeStatisticsWire;
+  /** ISO timestamp of the most recent update (`date-time`). */
+  readonly updated: string;
+}
+/**
+* Wire shape of `Roblox.Platform.Badges.BadgeAwarderType`.
+*/
+type BadgeAwarderTypeWire = 1;
+//#endregion
+//#region tests/helpers/badges.d.ts
+/**
+* Builds a minimally-valid {@link BadgeResponseV2Wire} body. Pass an
+* `overrides` object to tweak individual fields while keeping everything
+* else schema-compliant; useful for parser and integration tests that
+* only care about one field at a time.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validBadgeBody(overrides?: Partial<BadgeResponseV2Wire>): BadgeResponseV2Wire;
+//#endregion
+//#region src/internal/price-information.d.ts
+/**
+* Wire shape shared by every Roblox commerce resource that carries a
+* `priceInformation` block (game passes, developer products, ...). Resources
+* vary in the literal set their `enabledFeatures` may contain, so the feature
+* type is left as a parameter `F`.
+*
+* @template F - The string-literal union for this resource's pricing-feature flags.
+*/
+interface PriceInformationLike<F extends string> {
+  /** Default Robux price; `undefined` when the schema returns null. */
+  readonly defaultPriceInRobux: number | undefined;
+  /** Enabled pricing feature flags, in the order returned by the API. */
+  readonly enabledFeatures: ReadonlyArray<F>;
+}
+//#endregion
+//#region src/domains/developer-products/products/wire.d.ts
+/**
+* Wire-level pricing feature flag, mirroring `DeveloperProducts.PricingFeature`.
+*/
+type DeveloperProductPricingFeatureWire = "Invalid" | "PriceOptimization" | "RegionalPricing" | "UserFixedPrice";
+/**
+* Wire shape of `DeveloperProductConfigV2`: the response body returned by
+* the developer-products read and create endpoints.
+*/
+interface DeveloperProductConfigV2 {
+  /** Display name of the developer product. */
+  readonly name: string;
+  /** ISO timestamp at which the developer product was created (`date-time`). */
+  readonly createdTimestamp: string;
+  /** Consumer-facing description shown on the storefront. */
+  readonly description: string;
+  /** Int64 icon image asset ID; `undefined` when no icon is uploaded. */
+  readonly iconImageAssetId: number | undefined;
+  /** Whether the developer product is currently purchasable. */
+  readonly isForSale: boolean;
+  /** Whether the developer product is locked from configuration changes. */
+  readonly isImmutable: boolean;
+  /** Pricing block; `undefined` when the schema returns null. */
+  readonly priceInformation: DeveloperProductPriceInformationWire | undefined;
+  /** Int64 developer product ID, serialized as a JSON number. */
+  readonly productId: number;
+  /** Whether the developer product appears on the external store page. */
+  readonly storePageEnabled: boolean;
+  /** Int64 universe ID that owns the developer product. */
+  readonly universeId: number;
+  /** ISO timestamp of the most recent update (`date-time`). */
+  readonly updatedTimestamp: string;
+}
+/**
+* Wire shape of `DeveloperProducts.PriceInformationStruct`.
+*/
+type DeveloperProductPriceInformationWire = PriceInformationLike<DeveloperProductPricingFeatureWire>;
+//#endregion
+//#region tests/helpers/developer-products.d.ts
+/**
+* Builds a minimally-valid {@link DeveloperProductConfigV2} wire body. Pass
+* an `overrides` object to tweak individual fields while keeping everything
+* else schema-compliant; useful for parser and integration tests that
+* only care about one field at a time.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validDeveloperProductBody(overrides?: Partial<DeveloperProductConfigV2>): DeveloperProductConfigV2;
+//#endregion
+//#region tests/helpers/fake-http-client.d.ts
+/**
+* A request captured by {@link FakeHttpClient} for later assertion.
+*/
+interface CapturedRequest {
+  /** The per-request config passed alongside the request. */
+  readonly config: RequestConfig;
+  /** The request passed to {@link HttpClient.request}. */
+  readonly request: HttpRequest;
+}
+/**
+* A fluent fake for the {@link HttpClient} boundary. Mocks are queued in
+* FIFO order and consumed by each `request()` call. Records every
+* request and config for later assertion. Throws
+* {@link FakeHttpClientError} if the queue is empty when `request()` is
+* called — surfaces missing mocks as test setup bugs instead of silently
+* repeating the last response.
+*/
+interface FakeHttpClient extends HttpClient {
+  /** Queues an {@link ApiError} with the given status code and optional message/code. */
+  mockApiError(options: {
+    code?: string;
+    message?: string;
+    statusCode: number;
+  }): this;
+  /** Queues an error Result with the given error instance. */
+  mockError(error: OpenCloudError): this;
+  /** Queues a {@link NetworkError}. Preserves `cause` when provided. */
+  mockNetworkError(options?: {
+    cause?: unknown;
+    message?: string;
+  }): this;
+  /** Queues a {@link RateLimitError} with the given retry hint. */
+  mockRateLimit(options: {
+    message?: string;
+    retryAfterSeconds: number;
+  }): this;
+  /** Queues a successful {@link HttpResponse}. Body defaults to `{}`; headers default to `{}`. */
+  mockResponse(options: {
+    body?: unknown;
+    headers?: Readonly<Record<string, string>>;
+    status: number;
+  }): this;
+  /** Number of queued mocks that have not yet been consumed. */
+  readonly pendingMocks: number;
+  /** Chronological log of every `(request, config)` pair the fake received. */
+  readonly requests: ReadonlyArray<CapturedRequest>;
+}
+/**
+* Thrown when {@link FakeHttpClient.request} is called but no mock has
+* been queued. The message names the method, url, and consumed count to
+* aid debugging of missing `.mockResponse`/`.mockError` setup.
+*/
+declare class FakeHttpClientError extends Error {
+  override readonly name: string;
+}
+/**
+* Creates a fluent {@link FakeHttpClient} that sits at the
+* {@link HttpClient} seam. Use for integration tests where you need to
+* assert per-request config (apiKey, baseUrl) flows through to HTTP.
+*
+* @returns A fresh fake with an empty mock queue.
+*/
+declare function createFakeHttpClient(): FakeHttpClient;
+//#endregion
+//#region tests/helpers/fake-send.d.ts
+/**
+* The `send` callback shape consumed by `executeWithRetry`. A plain
+* transport function — no `RequestConfig`, no queueing, no retries.
+*/
+type SendFunc = (request: HttpRequest) => Promise<Result<HttpResponse, OpenCloudError>>;
+/**
+* A scripted fake for the `send` callback. Replays responses in order
+* and records every request it receives.
+*/
+interface FakeSend {
+  /** Chronological log of every request the fake received. */
+  readonly requests: ReadonlyArray<HttpRequest>;
+  /** The scripted send callback. */
+  readonly send: SendFunc;
+}
+/**
+* Creates a scripted fake for the `send` callback. Each call returns the
+* next queued response; exhausting the queue throws, which surfaces test
+* setup mistakes instead of silently repeating the last response.
+*
+* @param options - The scripted responses to replay, in order.
+* @returns A `send` callback plus a `requests` log.
+* @rejects {Error} When a call is made after all scripted responses are consumed.
+*/
+declare function createFakeSend(options: {
+  readonly responses: ReadonlyArray<Result<HttpResponse, OpenCloudError>>;
+}): FakeSend;
+//#endregion
+//#region tests/helpers/fake-sleep.d.ts
+/**
+* A directly-callable sleep double that records its wait arguments without
+* delaying. Assignable to {@link SleepFunc}.
+*/
+interface FakeSleep extends SleepFunc {
+  /** Chronological log of every `ms` value the fake was called with. */
+  readonly waits: ReadonlyArray<number>;
+}
+/**
+* Creates a {@link FakeSleep} that resolves immediately and records every
+* `ms` value it was called with.
+*
+* @returns A callable sleep function with a `waits` log attached.
+*/
+declare function createFakeSleep(): FakeSleep;
+//#endregion
+//#region tests/helpers/game-icon.d.ts
+/**
+* Builds a minimally-valid {@link GetGameIconResponseWire} entry. Pass an
+* `overrides` object to tweak individual fields while keeping everything
+* else schema-compliant.
+*
+* @param overrides - Fields to override on the default entry.
+* @returns A valid localized-icon entry with the overrides applied.
+*/
+declare function validLocalizedIcon(overrides?: Partial<GetGameIconResponseWire>): GetGameIconResponseWire;
+/**
+* Builds a minimally-valid {@link GameIconListWire} body containing a single
+* default localized icon.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validIconListBody(overrides?: Partial<GameIconListWire>): GameIconListWire;
+//#endregion
+//#region src/domains/game-passes/game-passes/wire.d.ts
+/**
+* Wire-level pricing feature flag, mirroring `GamePasses.PricingFeature`.
+*/
+type PricingFeatureWire = "Invalid" | "PriceOptimization" | "RegionalPricing" | "UserFixedPrice";
+/**
+* Wire shape of `GamePassConfigV2` — the response body returned by the
+* Game Passes read endpoint.
+*/
+interface GamePassConfigV2 {
+  /** Display name of the game pass. */
+  readonly name: string;
+  /** ISO timestamp at which the game pass was created (`date-time`). */
+  readonly createdTimestamp: string;
+  /** Consumer-facing description. */
+  readonly description: string;
+  /** Int64 game pass ID, serialized as a JSON number. */
+  readonly gamePassId: number;
+  /** Int64 icon asset ID; `0` signals the pass has no icon uploaded. */
+  readonly iconAssetId: number;
+  /** Whether the game pass is currently purchasable. */
+  readonly isForSale: boolean;
+  /** Pricing block; `undefined` when the schema returns null. */
+  readonly priceInformation: PriceInformationStructWire | undefined;
+  /** ISO timestamp of the most recent update (`date-time`). */
+  readonly updatedTimestamp: string;
+}
+/**
+* Wire shape of `GamePasses.PriceInformationStruct`.
+*/
+type PriceInformationStructWire = PriceInformationLike<PricingFeatureWire>;
+//#endregion
+//#region tests/helpers/game-passes.d.ts
+/**
+* Builds a minimally-valid {@link GamePassConfigV2} wire body. Pass an
+* `overrides` object to tweak individual fields while keeping everything
+* else schema-compliant — useful for parser and integration tests that
+* only care about one field at a time.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validGamePassBody(overrides?: Partial<GamePassConfigV2>): GamePassConfigV2;
+//#endregion
+//#region src/domains/game-internationalization/game-thumbnails/wire.d.ts
+/**
+* Wire shape of `POST /v1/game-thumbnails/games/{gameId}/language-codes/{languageCode}/image`,
+* mirroring `Roblox.GameInternationalization.Api.Models.Response.UploadImageForGameThumbnailResponse`.
+*/
+interface GameThumbnailUploadWire {
+  /** Stringified ID of the freshly uploaded thumbnail. */
+  readonly mediaAssetId: string;
+}
+//#endregion
+//#region tests/helpers/game-thumbnails.d.ts
+/**
+* Builds a minimally-valid {@link GameThumbnailUploadWire} body. Pass an
+* `overrides` object to tweak individual fields while keeping everything
+* else schema-compliant; useful for parser and integration tests that
+* only care about one field at a time.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validThumbnailUploadBody(overrides?: Partial<GameThumbnailUploadWire>): GameThumbnailUploadWire;
+//#endregion
+//#region src/domains/cloud-v2/luau-execution-task-binary-inputs/wire.d.ts
+/** Wire shape of the binary-input create response body. */
+interface LuauExecutionTaskBinaryInputWire {
+  /** Resource path the server assigned to this binary input slot. */
+  readonly path: string;
+  /** Byte size echoed back from the request. */
+  readonly size?: number | undefined;
+  /** Presigned PUT URI the caller uses to upload the binary data. */
+  readonly uploadUri: string;
+}
+//#endregion
+//#region tests/helpers/luau-execution-task-binary-inputs.d.ts
+/**
+* Builds a minimally-valid {@link LuauExecutionTaskBinaryInputWire} body
+* for tests. Pass an `overrides` object to tweak fields without re-stating
+* the defaults.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validBinaryInputBody(overrides?: Partial<LuauExecutionTaskBinaryInputWire>): LuauExecutionTaskBinaryInputWire;
+//#endregion
+//#region src/domains/cloud-v2/luau-execution-task-logs/wire.d.ts
+/**
+* Wire shape of a single structured log message within a
+* {@link LogChunkWire}. The `MESSAGE_TYPE_UNSPECIFIED` sentinel is
+* deliberately excluded; the parser's type guard rejects it at the
+* wire boundary so it never surfaces here.
+*/
+interface LogMessageWire {
+  /** ISO timestamp when the log message was produced. */
+  readonly createTime: string;
+  /** Human-readable log message text. */
+  readonly message: string;
+  /** Wire enum value for the message type. */
+  readonly messageType: "ERROR" | "INFO" | "OUTPUT" | "WARNING";
+}
+/**
+* Wire shape of a single log chunk returned by the Open Cloud
+* list-logs endpoint. The `structuredMessages` array is populated
+* when `view=STRUCTURED` is requested (which is always the case in
+* this SDK). Other wire fields (`path`, FLAT-mode `messages`) exist
+* on the schema but are not modelled here because they are not
+* surfaced on the public `LogPage` type.
+*/
+interface LogChunkWire {
+  /**
+  * Structured log messages in this chunk. Optional on the wire;
+  * absent when the chunk has no messages.
+  */
+  readonly structuredMessages?: ReadonlyArray<LogMessageWire> | undefined;
+}
+/**
+* Wire shape of the list-luau-execution-task-logs response body. Both
+* fields are optional per the OpenAPI spec
+* (`ListLuauExecutionSessionTaskLogsResponse` has no `required` array);
+* the parser also accepts JSON `null` on either field at the wire
+* boundary and normalizes it to `undefined` / `[]`.
+*/
+interface ListLogsResponseWire {
+  /**
+  * Array of log chunks. Omitted or JSON `null` on an empty page; the
+  * parser normalizes both to an empty array.
+  */
+  readonly luauExecutionSessionTaskLogs?: ReadonlyArray<LogChunkWire> | undefined;
+  /**
+  * Opaque continuation token for the next page. Absent or JSON
+  * `null` when this is the last page; the parser normalizes both to
+  * `undefined`.
+  */
+  readonly nextPageToken?: string | undefined;
+}
+//#endregion
+//#region tests/helpers/luau-execution-task-logs.d.ts
+/**
+* Builds a minimally-valid {@link ListLogsResponseWire} body containing
+* one chunk with one structured message. Pass an `overrides` object to
+* tweak fields without re-stating the defaults.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validLogPageBody(overrides?: Partial<ListLogsResponseWire>): ListLogsResponseWire;
+//#endregion
+//#region src/domains/cloud-v2/luau-execution-tasks/wire.d.ts
+/**
+* Wire error payload for `FAILED` tasks. Carries the categorical
+* `code` plus a human-readable `message`. The wire enum value
+* `ERROR_CODE_UNSPECIFIED` is excluded here so a malformed sentinel
+* response is rejected at validation time.
+*/
+interface LuauExecutionTaskErrorWire {
+  /** Categorical error code; `ERROR_CODE_UNSPECIFIED` is not represented. */
+  readonly code: "DEADLINE_EXCEEDED" | "INTERNAL_ERROR" | "OUTPUT_SIZE_LIMIT_EXCEEDED" | "SCRIPT_ERROR";
+  /** Human-readable error message. */
+  readonly message: string;
+}
+/**
+* Wire output payload for `COMPLETE` tasks. Each entry of `results` is
+* a Roblox-protobuf `Value` whose JSON projection is null, boolean,
+* number, string, JSON array, or JSON object.
+*/
+interface LuauExecutionTaskOutputWire {
+  /** JSON projection of the script's `return` values, in order. */
+  readonly results: ReadonlyArray<JSONValue>;
+}
+/**
+* Wire shape of the `LuauExecutionSessionTask` response body, narrowed
+* to the fields the current parser slice accepts. View-controlled
+* fields (`script`, `timeout`) are folded in by later slices when
+* they're observed.
+*/
+interface LuauExecutionTaskWire {
+  /**
+  * Resource path of the binary input attached to this task, when
+  * one was supplied at submit time.
+  */
+  readonly binaryInput?: string | undefined;
+  /**
+  * Pre-signed URI from which the binary output blob can be
+  * downloaded. Present only after a `COMPLETE` task whose
+  * `enableBinaryOutput` was `true`.
+  */
+  readonly binaryOutputUri?: string | undefined;
+  /** ISO timestamp when the task was created; omitted from the create-task POST response. */
+  readonly createTime?: string | undefined;
+  /** When `true`, the server writes output to a binary blob. */
+  readonly enableBinaryOutput?: boolean | undefined;
+  /**
+  * Wire error payload. Present only for tasks in the `FAILED`
+  * state; absent for in-progress and `COMPLETE` states.
+  */
+  readonly error?: LuauExecutionTaskErrorWire | undefined;
+  /**
+  * Wire output payload. Present only for tasks in the `COMPLETE`
+  * state; absent for in-progress and `FAILED` states.
+  */
+  readonly output?: LuauExecutionTaskOutputWire | undefined;
+  /** Resource path; one of the four x-aep-resource path formats. */
+  readonly path: string;
+  /**
+  * Wire enum value, narrowed to the supported task states. The
+  * server-side `STATE_UNSPECIFIED` sentinel is excluded so the
+  * validator rejects it.
+  */
+  readonly state: "CANCELLED" | "COMPLETE" | "FAILED" | "PROCESSING" | "QUEUED";
+  /**
+  * Server-side duration string in `"<n>s"` form. Optional; when
+  * absent, the server applies its 5-minute default.
+  */
+  readonly timeout?: string | undefined;
+  /** ISO timestamp of the most recent state change; omitted from the create-task POST response. */
+  readonly updateTime?: string | undefined;
+  /** Identifier of the user that owns the API key used to create this task. */
+  readonly user: string;
+}
+//#endregion
+//#region tests/helpers/luau-execution-tasks.d.ts
+/**
+* Builds a minimally-valid {@link LuauExecutionTaskWire} body for an
+* in-progress task. Pass an `overrides` object to tweak fields without
+* re-stating the defaults.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validInProgressTaskBody(overrides?: Partial<LuauExecutionTaskWire>): LuauExecutionTaskWire;
+//#endregion
+//#region src/domains/cloud-v2/memory-store-queues/wire.d.ts
+/**
+* Wire shape of a `MemoryStoreQueueItem` resource: the response body
+* returned by `Cloud_CreateMemoryStoreQueueItem` and the array entry
+* inside `Cloud_ReadMemoryStoreQueueItems`. The server emits `path`,
+* `data`, `expireTime`, and an optional `priority`. Top-level `data`
+* is required server-side (the server returns 400 when absent or
+* `null`); nested `null` inside `data` is preserved on round-trip.
+*/
+interface MemoryStoreQueueItemWire {
+  /** The opaque queue payload. Always non-null at the top level. */
+  readonly data: Exclude<JSONValue, null>;
+  /** ISO 8601 timestamp at which the item is removed from the queue. */
+  readonly expireTime: string;
+  /** Resource path: `cloud/v2/universes/{u}/memory-store/queues/{q}/items/{i}`. */
+  readonly path: string;
+  /** Optional priority; higher values are dequeued first. */
+  readonly priority?: number | undefined;
+}
+/**
+* Wire shape of the `Cloud_ReadMemoryStoreQueueItems` response. The
+* server emits the items array under `queueItems` (vendored schema
+* names it `items`) and the read identifier under `id` (schema names
+* it `readId`); both deviations are corrected by `apply-schema-patches`,
+* so the wire interface here matches the patched schema.
+*
+* `queueItems` is optional per the OpenAPI spec
+* (`ReadMemoryStoreQueueItemsResponse` has no `required` array); empty
+* queues come back with the field omitted or JSON `null`. `id` is also
+* spec-optional but the server always returns it for a 200 dequeue (it
+* is the `:discard` token), so the parser requires it.
+*/
+interface ReadQueueItemsResponseWire {
+  /** Identifier of the read operation, passed back to `:discard`. */
+  readonly id: string;
+  /**
+  * Items at the front of the queue, in dequeue order. Omitted or
+  * JSON `null` on an empty queue; the parser normalizes both to an
+  * empty array.
+  */
+  readonly queueItems?: ReadonlyArray<MemoryStoreQueueItemWire> | undefined;
+}
+//#endregion
+//#region tests/helpers/memory-store-queues.d.ts
+/**
+* Builds a minimally-valid {@link MemoryStoreQueueItemWire} body. Pass
+* an `overrides` object to tweak fields without re-stating the defaults.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validQueueItemBody(overrides?: Partial<MemoryStoreQueueItemWire>): MemoryStoreQueueItemWire;
+/**
+* Builds a minimally-valid {@link ReadQueueItemsResponseWire} body
+* carrying a single default queue item. Pass an `overrides` object to
+* change the read identifier or supply a different items array.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid dequeue response body with the overrides applied.
+*/
+declare function validDequeueBody(overrides?: Partial<ReadQueueItemsResponseWire>): ReadQueueItemsResponseWire;
+//#endregion
+//#region src/domains/cloud-v2/places/wire.d.ts
+/**
+* Wire shape of the `Place` resource -- the response body returned by
+* `Cloud_GetPlace` and `Cloud_UpdatePlace`. Genuinely optional fields
+* are `T | undefined` so callers can simulate absence under
+* `exactOptionalPropertyTypes`. The parser normalizes JSON `null`
+* values to `undefined` at validation time so consumers only ever
+* observe `undefined`.
+*/
+interface PlaceWire {
+  /** ISO timestamp when the place was created (`date-time`). */
+  readonly createTime: string;
+  /** Long-form description of the place. */
+  readonly description: string;
+  /** Human-facing name of the place. */
+  readonly displayName: string;
+  /** Resource path, e.g. `"universes/{uid}/places/{pid}"`. */
+  readonly path: string;
+  /** Whether this place is the universe's root place. */
+  readonly root?: boolean | undefined;
+  /** Maximum number of allowed users in a single server. */
+  readonly serverSize?: number | undefined;
+  /** Whether the place was created in-experience via `AssetService::CreatePlaceAsync()`. */
+  readonly universeRuntimeCreation?: boolean | undefined;
+  /** ISO timestamp of the most recent update (`date-time`). */
+  readonly updateTime: string;
+}
+//#endregion
+//#region src/domains/universes/places/wire.d.ts
+/**
+* Wire shape of the publish-version success response body.
+*/
+interface PlaceVersionWire {
+  /** Auto-incrementing version number assigned by Roblox. */
+  readonly versionNumber: number;
+}
+//#endregion
+//#region tests/helpers/places.d.ts
+/**
+* Returns a fresh, minimal `.rbxl`-formatted body whose magic bytes
+* match {@link RBXL_SIGNATURE}. Useful when integration tests don't
+* care about the file's contents past the signature.
+*
+* @returns A 14-byte rbxl body matching the binary signature.
+*/
+declare function rbxlBody(): Uint8Array<ArrayBuffer>;
+/**
+* Returns a fresh, minimal `.rbxlx`-formatted body whose magic bytes
+* match {@link RBXLX_SIGNATURE}. Useful when integration tests don't
+* care about the file's contents past the signature.
+*
+* @returns An 8-byte rbxlx body matching the XML signature.
+*/
+declare function rbxlxBody(): Uint8Array<ArrayBuffer>;
+/**
+* Builds a minimally-valid {@link PlaceVersionWire} body. Pass an
+* `overrides` object to tweak fields without re-stating the defaults.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validPublishResponseBody(overrides?: Partial<PlaceVersionWire>): PlaceVersionWire;
+/**
+* Builds a minimally-valid {@link PlaceWire} body. Pass an `overrides`
+* object to tweak fields without re-stating the defaults.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validPlaceBody(overrides?: Partial<PlaceWire>): PlaceWire;
+//#endregion
+//#region src/domains/cloud-v2/universes/wire.d.ts
+/**
+* Wire-level visibility enum, mirroring the `visibility` field of the
+* `Universe` schema.
+*/
+type VisibilityWire = "PRIVATE" | "PUBLIC" | "VISIBILITY_UNSPECIFIED";
+/**
+* Wire-level age-rating enum, mirroring the `ageRating` field of the
+* `Universe` schema.
+*/
+type AgeRatingWire = "AGE_RATING_9_PLUS" | "AGE_RATING_13_PLUS" | "AGE_RATING_17_PLUS" | "AGE_RATING_ALL" | "AGE_RATING_UNSPECIFIED";
+/**
+* Wire shape of `Universe_SocialLink`.
+*/
+interface SocialLinkWire {
+  /** Display title for the link. */
+  readonly title: string;
+  /** Destination URI. */
+  readonly uri: string;
+}
+/**
+* Wire shape of the `Universe` resource -- the response body returned
+* by both `Cloud_GetUniverse` and `Cloud_UpdateUniverse`. Genuinely
+* optional fields are `T | undefined` (rather than `T`) so callers
+* can simulate absence by setting a field to `undefined` under
+* `exactOptionalPropertyTypes`.
+*/
+interface UniverseWire {
+  /** Age-rating classification. */
+  readonly ageRating: AgeRatingWire;
+  /** Whether console players can join. */
+  readonly consoleEnabled?: boolean | undefined;
+  /** ISO timestamp when the universe was created (`date-time`). */
+  readonly createTime: string;
+  /** Description, derived from the root place's description. */
+  readonly description: string;
+  /** Whether desktop players can join. */
+  readonly desktopEnabled?: boolean | undefined;
+  /** Discord social link block. */
+  readonly discordSocialLink?: SocialLinkWire | undefined;
+  /** Display name, derived from the root place's name. */
+  readonly displayName: string;
+  /** Facebook social link block. */
+  readonly facebookSocialLink?: SocialLinkWire | undefined;
+  /** Group-owner resource path when the universe is group-owned. */
+  readonly group?: string | undefined;
+  /** Guilded social link block. */
+  readonly guildedSocialLink?: SocialLinkWire | undefined;
+  /** Whether mobile players can join. */
+  readonly mobileEnabled?: boolean | undefined;
+  /** Resource path, e.g. `"universes/{id}"`. */
+  readonly path: string;
+  /** Private server price in Robux; absent when private servers are disabled. */
+  readonly privateServerPriceRobux?: number | undefined;
+  /** Roblox Group social link block. */
+  readonly robloxGroupSocialLink?: SocialLinkWire | undefined;
+  /** Root place resource path, e.g. `"universes/{id}/places/{pid}"`. */
+  readonly rootPlace?: string | undefined;
+  /** Whether tablet players can join. */
+  readonly tabletEnabled?: boolean | undefined;
+  /** Twitch social link block. */
+  readonly twitchSocialLink?: SocialLinkWire | undefined;
+  /** Twitter social link block. */
+  readonly twitterSocialLink?: SocialLinkWire | undefined;
+  /** ISO timestamp of the most recent update (`date-time`). */
+  readonly updateTime: string;
+  /** User-owner resource path when the universe is user-owned. */
+  readonly user?: string | undefined;
+  /** Current visibility of the universe. */
+  readonly visibility: VisibilityWire;
+  /** Whether voice chat is enabled. */
+  readonly voiceChatEnabled?: boolean | undefined;
+  /** Whether VR players can join. */
+  readonly vrEnabled?: boolean | undefined;
+  /** Youtube social link block. */
+  readonly youtubeSocialLink?: SocialLinkWire | undefined;
+}
+//#endregion
+//#region tests/helpers/universes.d.ts
+/**
+* Builds a minimally-valid {@link UniverseWire} body. Pass an
+* `overrides` object to tweak fields without re-stating the defaults.
+*
+* @param overrides - Fields to override on the default body.
+* @returns A valid wire body with the overrides applied.
+*/
+declare function validUniverseBody(overrides?: Partial<UniverseWire>): UniverseWire;
+//#endregion
+export { type CapturedRequest, type FakeHttpClient, FakeHttpClientError, type FakeSend, type FakeSleep, type SendFunc, createFakeHttpClient, createFakeSend, createFakeSleep, rbxlBody, rbxlxBody, validBadgeBody, validBinaryInputBody, validDequeueBody, validDeveloperProductBody, validGamePassBody, validIconListBody, validInProgressTaskBody, validLocalizedIcon, validLogPageBody, validPlaceBody, validPublishResponseBody, validQueueItemBody, validThumbnailUploadBody, validUniverseBody };
+//# sourceMappingURL=testing.d.mts.map