@bedrock-rbx/ocale 0.1.0-beta.1

package/dist/developer-products.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"developer-products.mjs","names":["buildUpdateRequest","buildUpdateRequest","buildLocaleNameDescRequest","#inner"],"sources":["../src/domains/developer-products/products/builders.ts","../src/domains/developer-products/products/operations.ts","../src/domains/developer-products/products/parsers.ts","../src/domains/game-internationalization/developer-product-icon/builders.ts","../src/domains/game-internationalization/developer-product-name-description/builders.ts","../src/domains/game-internationalization/developer-product-name-description/operations.ts","../src/resources/developer-products/client.ts"],"sourcesContent":["import type { HttpRequest } from \"../../../internal/http/types.ts\";\nimport { toBlob } from \"../../../internal/utils/to-blob.ts\";\nimport type {\n\tCreateDeveloperProductParameters,\n\tGetDeveloperProductParameters,\n\tUpdateDeveloperProductParameters,\n} from \"./types.ts\";\n\n/**\n * Builds a `GET` request for the Open Cloud \"read developer product\"\n * endpoint.\n *\n * @param parameters - Universe and product identifiers to interpolate into\n *   the URL.\n * @returns A pure {@link HttpRequest} describing the read call.\n */\nexport function buildGetRequest(parameters: GetDeveloperProductParameters): HttpRequest {\n\treturn {\n\t\tmethod: \"GET\",\n\t\turl: `/developer-products/v2/universes/${parameters.universeId}/developer-products/${parameters.productId}/creator`,\n\t};\n}\n\n/**\n * Builds a `POST` request for the Open Cloud \"create developer product\"\n * endpoint.\n *\n * @param parameters - Fields describing the new developer product; optional\n *   values omitted here are left off the multipart payload entirely.\n * @returns A pure {@link HttpRequest} describing the create call.\n */\nexport function buildCreateRequest(parameters: CreateDeveloperProductParameters): HttpRequest {\n\tconst body = new FormData();\n\tbody.append(\"name\", parameters.name);\n\tif (parameters.description !== undefined) {\n\t\tbody.append(\"description\", parameters.description);\n\t}\n\n\tif (parameters.isForSale !== undefined) {\n\t\tbody.append(\"isForSale\", String(parameters.isForSale));\n\t}\n\n\tif (parameters.price !== undefined) {\n\t\tbody.append(\"price\", String(parameters.price));\n\t}\n\n\tif (parameters.isRegionalPricingEnabled !== undefined) {\n\t\tbody.append(\"isRegionalPricingEnabled\", String(parameters.isRegionalPricingEnabled));\n\t}\n\n\tif (parameters.imageFile !== undefined) {\n\t\tbody.append(\"imageFile\", toBlob(parameters.imageFile));\n\t}\n\n\treturn {\n\t\tbody,\n\t\tmethod: \"POST\",\n\t\turl: `/developer-products/v2/universes/${parameters.universeId}/developer-products`,\n\t};\n}\n\n/**\n * Builds a `PATCH` request for the Open Cloud \"update developer product\"\n * endpoint. Every field on `parameters` except the identifiers is optional;\n * omitted fields are not appended to the multipart body so the server leaves\n * them unchanged.\n *\n * @param parameters - Identifiers plus fields to update.\n * @returns A pure {@link HttpRequest} describing the update call.\n */\nexport function buildUpdateRequest(parameters: UpdateDeveloperProductParameters): HttpRequest {\n\tconst body = new FormData();\n\tif (parameters.name !== undefined) {\n\t\tbody.append(\"name\", parameters.name);\n\t}\n\n\tif (parameters.description !== undefined) {\n\t\tbody.append(\"description\", parameters.description);\n\t}\n\n\tif (parameters.isForSale !== undefined) {\n\t\tbody.append(\"isForSale\", String(parameters.isForSale));\n\t}\n\n\tif (parameters.price !== undefined) {\n\t\tbody.append(\"price\", String(parameters.price));\n\t}\n\n\tif (parameters.isRegionalPricingEnabled !== undefined) {\n\t\tbody.append(\"isRegionalPricingEnabled\", String(parameters.isRegionalPricingEnabled));\n\t}\n\n\tif (parameters.storePageEnabled !== undefined) {\n\t\tbody.append(\"storePageEnabled\", String(parameters.storePageEnabled));\n\t}\n\n\tif (parameters.imageFile !== undefined) {\n\t\tbody.append(\"imageFile\", toBlob(parameters.imageFile));\n\t}\n\n\treturn {\n\t\tbody,\n\t\tmethod: \"PATCH\",\n\t\turl: `/developer-products/v2/universes/${parameters.universeId}/developer-products/${parameters.productId}`,\n\t};\n}\n","import type { OperationLimit } from \"../../../internal/http/rate-limit-queue.ts\";\n\n/**\n * Per-second request ceiling for reading a single developer product, from\n * the Open Cloud OpenAPI schema.\n */\nexport const GET_OPERATION_LIMIT: OperationLimit = Object.freeze({\n\tmaxPerSecond: 10,\n\toperationKey: \"developer-products.get\",\n});\n\n/**\n * Per-second request ceiling for creating a developer product, from the\n * Open Cloud OpenAPI schema.\n */\nexport const CREATE_OPERATION_LIMIT: OperationLimit = Object.freeze({\n\tmaxPerSecond: 3,\n\toperationKey: \"developer-products.create\",\n});\n\n/**\n * Per-second request ceiling for updating a developer product, from the\n * Open Cloud OpenAPI schema. Keyed independently from\n * {@link CREATE_OPERATION_LIMIT} so create and update do not share a queue,\n * since Roblox does not document the per-minute quota as shared between\n * the POST and PATCH endpoints.\n */\nexport const UPDATE_OPERATION_LIMIT: OperationLimit = Object.freeze({\n\tmaxPerSecond: 3,\n\toperationKey: \"developer-products.update\",\n});\n\n/**\n * Scopes the API key or OAuth token must carry to read a developer product,\n * sourced from `x-roblox-scopes` on the `DeveloperProducts_GetDeveloperProductConfigV2`\n * operation in the vendored OpenAPI schema.\n */\nexport const GET_REQUIRED_SCOPES: ReadonlyArray<string> = Object.freeze([\"developer-product:read\"]);\n\n/**\n * Scopes the API key or OAuth token must carry to create or update a developer\n * product, sourced from `x-roblox-scopes` on the\n * `DeveloperProducts_CreateDeveloperProductV2` and\n * `DeveloperProducts_UpdateDeveloperProductV2` operations in the vendored\n * OpenAPI schema.\n */\nexport const WRITE_REQUIRED_SCOPES: ReadonlyArray<string> = Object.freeze([\n\t\"developer-product:write\",\n]);\n","import type { HttpResponse } from \"../../../client/types.ts\";\nimport { ApiError } from \"../../../errors/api-error.ts\";\nimport {\n\tcopyPriceInformation,\n\tisPriceInformationLike,\n} from \"../../../internal/price-information.ts\";\nimport { isRecord } from \"../../../internal/utils/is-record.ts\";\nimport type { Result } from \"../../../types.ts\";\nimport type { DeveloperProduct } from \"./types.ts\";\nimport type { DeveloperProductConfigV2, DeveloperProductPricingFeatureWire } from \"./wire.ts\";\n\n/**\n * Parses a successful Developer Products API response into the public\n * `DeveloperProduct` shape, returning a `Result` so callers can handle\n * malformed payloads without exceptions.\n *\n * @param response - The full {@link HttpResponse} from the Open Cloud API.\n *   The status code is included on the returned `ApiError` when validation\n *   fails; the headers are available for future parsers that need them.\n * @returns A success result wrapping the converted `DeveloperProduct`, or\n *   an `ApiError` when the body does not match the wire schema.\n */\nexport function parseDeveloperProductResponse(\n\tresponse: HttpResponse,\n): Result<DeveloperProduct, ApiError> {\n\tconst { body, status: statusCode } = response;\n\n\tif (!isDeveloperProductConfigV2(body)) {\n\t\treturn {\n\t\t\terr: new ApiError(\"Malformed developer product response\", { statusCode }),\n\t\t\tsuccess: false,\n\t\t};\n\t}\n\n\tconst priceWire = body.priceInformation ?? undefined;\n\tconst iconAssetId = body.iconImageAssetId ?? undefined;\n\n\treturn {\n\t\tdata: {\n\t\t\tid: String(body.productId),\n\t\t\tname: body.name,\n\t\t\tcreatedAt: new Date(body.createdTimestamp),\n\t\t\tdescription: body.description,\n\t\t\ticonImageAssetId: iconAssetId === undefined ? undefined : String(iconAssetId),\n\t\t\tisForSale: body.isForSale,\n\t\t\tisImmutable: body.isImmutable,\n\t\t\tprice: priceWire === undefined ? undefined : copyPriceInformation(priceWire),\n\t\t\tstorePageEnabled: body.storePageEnabled,\n\t\t\tuniverseId: String(body.universeId),\n\t\t\tupdatedAt: new Date(body.updatedTimestamp),\n\t\t},\n\t\tsuccess: true,\n\t};\n}\n\nfunction hasRequiredPrimitiveFields(body: Record<string, unknown>): boolean {\n\treturn (\n\t\ttypeof body[\"productId\"] === \"number\" &&\n\t\t// Roblox never assigns asset ID 0; a zero productId signals a\n\t\t// malformed response, not a legitimate product.\n\t\tbody[\"productId\"] !== 0 &&\n\t\ttypeof body[\"universeId\"] === \"number\" &&\n\t\ttypeof body[\"name\"] === \"string\" &&\n\t\ttypeof body[\"description\"] === \"string\" &&\n\t\ttypeof body[\"isForSale\"] === \"boolean\" &&\n\t\ttypeof body[\"isImmutable\"] === \"boolean\" &&\n\t\ttypeof body[\"storePageEnabled\"] === \"boolean\" &&\n\t\ttypeof body[\"createdTimestamp\"] === \"string\" &&\n\t\ttypeof body[\"updatedTimestamp\"] === \"string\"\n\t);\n}\n\nfunction isPricingFeatureWire(value: unknown): value is DeveloperProductPricingFeatureWire {\n\treturn (\n\t\tvalue === \"Invalid\" ||\n\t\tvalue === \"PriceOptimization\" ||\n\t\tvalue === \"RegionalPricing\" ||\n\t\tvalue === \"UserFixedPrice\"\n\t);\n}\n\nfunction isDeveloperProductConfigV2(body: unknown): body is DeveloperProductConfigV2 {\n\tif (!isRecord(body)) {\n\t\treturn false;\n\t}\n\n\tif (!hasRequiredPrimitiveFields(body)) {\n\t\treturn false;\n\t}\n\n\tconst iconImageAssetId = body[\"iconImageAssetId\"] ?? undefined;\n\tif (iconImageAssetId !== undefined && typeof iconImageAssetId !== \"number\") {\n\t\treturn false;\n\t}\n\n\tconst price = body[\"priceInformation\"] ?? undefined;\n\tif (price !== undefined && !isPriceInformationLike(price, isPricingFeatureWire)) {\n\t\treturn false;\n\t}\n\n\treturn true;\n}\n","import type { HttpRequest } from \"../../../internal/http/types.ts\";\nimport { toBlob } from \"../../../internal/utils/to-blob.ts\";\nimport type { UploadDeveloperProductIconParameters } from \"./types.ts\";\n\n/**\n * Builds a `POST` request for the localized \"upload developer-product icon\"\n * endpoint. A successful upload replaces any existing icon for the same\n * `(productId, languageCode)` pair.\n *\n * @param parameters - Product and language identifiers plus the image bytes\n *   to upload.\n * @returns A pure {@link HttpRequest} describing the upload call.\n */\nexport function buildUploadIconRequest(\n\tparameters: UploadDeveloperProductIconParameters,\n): HttpRequest {\n\tconst body = new FormData();\n\tbody.append(\"Files\", toBlob(parameters.image));\n\n\treturn {\n\t\tbody,\n\t\tmethod: \"POST\",\n\t\turl: `/legacy-game-internationalization/v1/developer-products/${parameters.productId}/icons/language-codes/${parameters.languageCode}`,\n\t};\n}\n","import type { HttpRequest } from \"../../../internal/http/types.ts\";\nimport type { UpdateDeveloperProductNameDescriptionParameters } from \"./types.ts\";\n\n/**\n * Builds a `PATCH` request for the localized \"update developer-product\n * name/description\" endpoint. Either `name`, `description`, or both may be\n * supplied; omitted fields are not included in the JSON body so the server\n * leaves the existing value for that locale untouched.\n *\n * @param parameters - Product and language identifiers plus the optional\n *   replacement values.\n * @returns A pure {@link HttpRequest} describing the update call.\n */\nexport function buildUpdateRequest(\n\tparameters: UpdateDeveloperProductNameDescriptionParameters,\n): HttpRequest {\n\tconst body: Record<string, string> = {};\n\tif (parameters.name !== undefined) {\n\t\tbody[\"name\"] = parameters.name;\n\t}\n\n\tif (parameters.description !== undefined) {\n\t\tbody[\"description\"] = parameters.description;\n\t}\n\n\treturn {\n\t\tbody,\n\t\tmethod: \"PATCH\",\n\t\turl: `/legacy-game-internationalization/v1/developer-products/${parameters.productId}/name-description/language-codes/${parameters.languageCode}`,\n\t};\n}\n","import type { OperationLimit } from \"../../../internal/http/rate-limit-queue.ts\";\n\n/**\n * Per-second request ceiling for every developer-product localization\n * Operation. The legacy `gameinternationalization` service caps each API key\n * at 100 requests per minute *shared across the entire service* (see the\n * `x-roblox-rate-limits` extension on every operation in the vendored Open\n * Cloud spec), so all developer-product localization methods queue against\n * the same operation key.\n */\nexport const LOCALIZATION_OPERATION_LIMIT: OperationLimit = Object.freeze({\n\tmaxPerSecond: 100 / 60,\n\toperationKey: \"developer-product-localization\",\n});\n\n/**\n * Scopes required for every developer-product localization operation, sourced\n * from `x-roblox-scopes` on the legacy `gameinternationalization`\n * developer-product endpoints in the vendored OpenAPI schema.\n */\nexport const LOCALIZATION_REQUIRED_SCOPES: ReadonlyArray<string> = Object.freeze([\n\t\"legacy-developer-product:manage\",\n]);\n","import type { OpenCloudClientOptions, RequestOptions } from \"../../client/types.ts\";\nimport {\n\tbuildCreateRequest,\n\tbuildGetRequest,\n\tbuildUpdateRequest,\n} from \"../../domains/developer-products/products/builders.ts\";\nimport {\n\tCREATE_OPERATION_LIMIT,\n\tGET_OPERATION_LIMIT,\n\tGET_REQUIRED_SCOPES,\n\tUPDATE_OPERATION_LIMIT,\n\tWRITE_REQUIRED_SCOPES,\n} from \"../../domains/developer-products/products/operations.ts\";\nimport { parseDeveloperProductResponse } from \"../../domains/developer-products/products/parsers.ts\";\nimport type {\n\tCreateDeveloperProductParameters,\n\tDeveloperProduct,\n\tGetDeveloperProductParameters,\n\tUpdateDeveloperProductParameters,\n} from \"../../domains/developer-products/products/types.ts\";\nimport { buildUploadIconRequest } from \"../../domains/game-internationalization/developer-product-icon/builders.ts\";\nimport type { UploadDeveloperProductIconParameters } from \"../../domains/game-internationalization/developer-product-icon/types.ts\";\nimport { buildUpdateRequest as buildLocaleNameDescRequest } from \"../../domains/game-internationalization/developer-product-name-description/builders.ts\";\nimport {\n\tLOCALIZATION_OPERATION_LIMIT,\n\tLOCALIZATION_REQUIRED_SCOPES,\n} from \"../../domains/game-internationalization/developer-product-name-description/operations.ts\";\nimport type { UpdateDeveloperProductNameDescriptionParameters } from \"../../domains/game-internationalization/developer-product-name-description/types.ts\";\nimport type { OpenCloudError } from \"../../errors/base.ts\";\nimport { CREATE_METHOD_DEFAULTS, IDEMPOTENT_METHOD_DEFAULTS } from \"../../internal/http/retry.ts\";\nimport {\n\tokRequest,\n\tparseEmptyResponse,\n\tResourceClient,\n\ttype ResourceMethodSpec,\n} from \"../../internal/resource-client.ts\";\nimport type { Result } from \"../../types.ts\";\n\nfunction makeSpec<P, R = DeveloperProduct>(\n\tspec: ResourceMethodSpec<P, R>,\n): ResourceMethodSpec<P, R> {\n\treturn Object.freeze(spec);\n}\n\nconst CREATE_SPEC = makeSpec<CreateDeveloperProductParameters>({\n\tbuildRequest: (parameters) => okRequest(buildCreateRequest(parameters)),\n\tmethodDefaults: CREATE_METHOD_DEFAULTS,\n\tmethodKind: \"create\",\n\toperationLimit: CREATE_OPERATION_LIMIT,\n\tparse: parseDeveloperProductResponse,\n\trequiredScopes: WRITE_REQUIRED_SCOPES,\n});\n\nconst GET_SPEC = makeSpec<GetDeveloperProductParameters>({\n\tbuildRequest: (parameters) => okRequest(buildGetRequest(parameters)),\n\tmethodDefaults: IDEMPOTENT_METHOD_DEFAULTS,\n\tmethodKind: \"idempotent\",\n\toperationLimit: GET_OPERATION_LIMIT,\n\tparse: parseDeveloperProductResponse,\n\trequiredScopes: GET_REQUIRED_SCOPES,\n});\n\nconst UPDATE_SPEC = makeSpec<UpdateDeveloperProductParameters, undefined>({\n\tbuildRequest: (parameters) => okRequest(buildUpdateRequest(parameters)),\n\tmethodDefaults: IDEMPOTENT_METHOD_DEFAULTS,\n\tmethodKind: \"idempotent\",\n\toperationLimit: UPDATE_OPERATION_LIMIT,\n\tparse: parseEmptyResponse,\n\trequiredScopes: WRITE_REQUIRED_SCOPES,\n});\n\nconst UPDATE_NAME_DESCRIPTION_SPEC = makeSpec<\n\tUpdateDeveloperProductNameDescriptionParameters,\n\tundefined\n>({\n\tbuildRequest: (parameters) => okRequest(buildLocaleNameDescRequest(parameters)),\n\tmethodDefaults: IDEMPOTENT_METHOD_DEFAULTS,\n\tmethodKind: \"idempotent\",\n\toperationLimit: LOCALIZATION_OPERATION_LIMIT,\n\tparse: parseEmptyResponse,\n\trequiredScopes: LOCALIZATION_REQUIRED_SCOPES,\n});\n\nconst UPLOAD_ICON_SPEC = makeSpec<UploadDeveloperProductIconParameters, undefined>({\n\tbuildRequest: (parameters) => okRequest(buildUploadIconRequest(parameters)),\n\tmethodDefaults: CREATE_METHOD_DEFAULTS,\n\tmethodKind: \"create\",\n\toperationLimit: LOCALIZATION_OPERATION_LIMIT,\n\tparse: parseEmptyResponse,\n\trequiredScopes: LOCALIZATION_REQUIRED_SCOPES,\n});\n\ninterface DeveloperProductLocalizationHandle {\n\t/**\n\t * Updates the per-locale display name and/or description registered against\n\t * a developer product. Either `name`, `description`, or both may be\n\t * supplied; omitted fields are not forwarded so the server leaves the\n\t * existing value for that locale untouched. Mirrors the upstream `200 OK`\n\t * echo body as `undefined` data.\n\t *\n\t * @param parameters - Product and language identifiers plus the optional\n\t *   replacement values.\n\t * @param options - Optional per-request overrides.\n\t * @returns A success {@link Result} with no payload, or the\n\t *   {@link OpenCloudError} that caused the request to fail.\n\t */\n\tupdateNameDescription: (\n\t\tparameters: UpdateDeveloperProductNameDescriptionParameters,\n\t\toptions?: RequestOptions,\n\t) => Promise<Result<undefined, OpenCloudError>>;\n\t/**\n\t * Uploads or replaces the per-locale icon for a developer product. A\n\t * subsequent upload for the same `(productId, languageCode)` pair replaces\n\t * the existing icon for that locale. Does not retry on 5xx so a duplicate\n\t * upload cannot be created if the server fails mid-write.\n\t *\n\t * @param parameters - Product and language identifiers plus the image\n\t *   bytes to upload.\n\t * @param options - Optional per-request overrides.\n\t * @returns A success {@link Result} with no payload, or the\n\t *   {@link OpenCloudError} that caused the request to fail.\n\t */\n\tuploadIcon: (\n\t\tparameters: UploadDeveloperProductIconParameters,\n\t\toptions?: RequestOptions,\n\t) => Promise<Result<undefined, OpenCloudError>>;\n}\n\n/**\n * Public client for the Roblox Open Cloud Developer Products API.\n *\n * Wires request builders, the injected {@link OpenCloudClientOptions.httpClient}, and response\n * parsers into a single ergonomic surface. Every method returns a\n * {@link Result} so callers handle failure explicitly; no thrown\n * `OpenCloudError` ever escapes the client.\n *\n * ```ts\n * import { DeveloperProductsClient } from \"@bedrock-rbx/ocale/developer-products\";\n *\n * const client = new DeveloperProductsClient({ apiKey: process.env.ROBLOX_API_KEY! });\n *\n * const result = await client.get({\n *     universeId: \"1234567890\",\n *     productId: \"9876543210\",\n * });\n *\n * if (result.success) {\n *     console.log(`${result.data.name} (${result.data.id})`);\n * } else {\n *     console.error(result.err.message);\n * }\n * ```\n */\nexport class DeveloperProductsClient {\n\treadonly #inner: ResourceClient;\n\n\t/**\n\t * Operation Group exposing per-locale localization Operations\n\t * (`updateNameDescription`, `uploadIcon`) backed by the\n\t * `legacy-game-internationalization` domain. Source-language values\n\t * remain on {@link DeveloperProductsClient.update}; methods on this\n\t * group set per-locale overlays on top. Shares the parent client's\n\t * HTTP, rate-limit, and retry plumbing.\n\t */\n\tpublic readonly localization: DeveloperProductLocalizationHandle;\n\n\t/**\n\t * Creates a new {@link DeveloperProductsClient}. Configuration is frozen\n\t * on construction; per-request overrides are accepted on each method.\n\t *\n\t * @param options - Client-level configuration including the API key.\n\t */\n\tconstructor(options: OpenCloudClientOptions) {\n\t\tthis.#inner = new ResourceClient(options);\n\t\tthis.localization = createLocalizationHandle(this.#inner);\n\t}\n\n\t/**\n\t * Creates a new developer product under the supplied universe.\n\t *\n\t * @param parameters - Creation fields including the universe and product name.\n\t * @param options - Optional per-request overrides.\n\t * @returns A {@link Result} wrapping the parsed {@link DeveloperProduct} or\n\t *   the {@link OpenCloudError} that caused the request to fail.\n\t */\n\tpublic async create(\n\t\tparameters: CreateDeveloperProductParameters,\n\t\toptions?: RequestOptions,\n\t): Promise<Result<DeveloperProduct, OpenCloudError>> {\n\t\treturn this.#inner.execute({ options, parameters, spec: CREATE_SPEC });\n\t}\n\n\t/**\n\t * Reads a single developer product by ID.\n\t *\n\t * @param parameters - Universe and product identifiers.\n\t * @param options - Optional per-request overrides (e.g. A different\n\t *   {@link OpenCloudClientOptions.apiKey} for this call only).\n\t * @returns A {@link Result} wrapping the parsed {@link DeveloperProduct} or\n\t *   the {@link OpenCloudError} that caused the request to fail.\n\t */\n\tpublic async get(\n\t\tparameters: GetDeveloperProductParameters,\n\t\toptions?: RequestOptions,\n\t): Promise<Result<DeveloperProduct, OpenCloudError>> {\n\t\treturn this.#inner.execute({ options, parameters, spec: GET_SPEC });\n\t}\n\n\t/**\n\t * Partially updates an existing developer product. Mirrors the upstream\n\t * `204 No Content` response: a successful update yields `undefined` data.\n\t * Callers that need the post-update state (for example to observe a\n\t * server-derived `updatedTimestamp`) chain {@link DeveloperProductsClient.get}\n\t * themselves so the GET only fires when actually needed.\n\t *\n\t * @param parameters - The universe and product identifiers and the\n\t *   fields to update. Only fields explicitly provided are forwarded.\n\t * @param options - Optional per-request overrides.\n\t * @returns A success {@link Result} with no payload, or the\n\t *   {@link OpenCloudError} that caused the request to fail.\n\t */\n\tpublic async update(\n\t\tparameters: UpdateDeveloperProductParameters,\n\t\toptions?: RequestOptions,\n\t): Promise<Result<undefined, OpenCloudError>> {\n\t\treturn this.#inner.execute({ options, parameters, spec: UPDATE_SPEC });\n\t}\n}\n\nfunction createLocalizationHandle(inner: ResourceClient): DeveloperProductLocalizationHandle {\n\treturn {\n\t\tasync updateNameDescription(parameters, options) {\n\t\t\treturn inner.execute({ options, parameters, spec: UPDATE_NAME_DESCRIPTION_SPEC });\n\t\t},\n\t\tasync uploadIcon(parameters, options) {\n\t\t\treturn inner.execute({ options, parameters, spec: UPLOAD_ICON_SPEC });\n\t\t},\n\t};\n}\n"],"mappings":"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"}

package/dist/game-passes.d.mts

@@ -0,0 +1,210 @@
+import { c as Page, d as OpenCloudError, i as OpenCloudClientOptions, l as Result, s as RequestOptions } from "./types-YCTsM8Qd.mjs";
+
+//#region src/domains/game-passes/game-passes/types.d.ts
+/**
+* Pricing feature flags that can be enabled on a game pass. Values
+* mirror the Open Cloud `GamePasses.PricingFeature` enum.
+*/
+type GamePassPricingFeature = "Invalid" | "PriceOptimization" | "RegionalPricing" | "UserFixedPrice";
+/**
+* Public shape of a game pass's pricing configuration.
+*/
+interface GamePassPrice {
+  /** Default Robux price; `undefined` when no default price is configured. */
+  readonly defaultPriceInRobux: number | undefined;
+  /** Pricing feature flags currently enabled on this game pass. */
+  readonly enabledFeatures: ReadonlyArray<GamePassPricingFeature>;
+}
+/**
+* A Roblox game pass as exposed to SDK consumers. Fields use DX-friendly
+* names and types (stringified IDs, `Date` timestamps) rather than the
+* raw wire representation.
+*/
+interface GamePass {
+  /** Stringified game pass ID. The API returns an int64; always use this. */
+  readonly id: string;
+  /** Display name of the game pass. */
+  readonly name: string;
+  /** ISO timestamp at which the game pass was created, as a `Date`. */
+  readonly createdAt: Date;
+  /** Consumer-facing description shown on the store listing. */
+  readonly description: string;
+  /** Icon asset ID as a string; `undefined` when no icon is uploaded. */
+  readonly iconAssetId: string | undefined;
+  /** Whether the game pass is currently purchasable. */
+  readonly isForSale: boolean;
+  /** Pricing configuration; `undefined` when pricing is not yet set. */
+  readonly price: GamePassPrice | undefined;
+  /** ISO timestamp of the most recent update, as a `Date`. */
+  readonly updatedAt: Date;
+}
+/**
+* Parameters for creating a new game pass under a universe.
+*/
+interface CreateGamePassParameters {
+  /** Display name of the new game pass. */
+  readonly name: string;
+  /** Optional consumer-facing description shown on the store listing. */
+  readonly description?: string;
+  /** Optional icon image uploaded with the new game pass. */
+  readonly imageFile?: Blob | Uint8Array;
+  /** Whether the game pass should be purchasable immediately. */
+  readonly isForSale?: boolean;
+  /** Whether regional pricing should be enabled at creation time. */
+  readonly isRegionalPricingEnabled?: boolean;
+  /** Optional default price in Robux at creation time. */
+  readonly price?: number;
+  /** Stringified ID of the universe that owns the game pass. */
+  readonly universeId: string;
+}
+/**
+* Parameters for reading a single game pass by ID.
+*/
+interface GetGamePassParameters {
+  /** Stringified ID of the game pass to retrieve. */
+  readonly gamePassId: string;
+  /** Stringified ID of the universe that owns the game pass. */
+  readonly universeId: string;
+}
+/**
+* Parameters for listing the game passes registered against a universe.
+* Pagination is cursor-based: omit `pageToken` to fetch the first page,
+* then thread the previous response's `nextPageToken` back in until it
+* is `undefined`.
+*/
+interface ListGamePassesParameters {
+  /** Optional page size; the server defaults to 50 when omitted. */
+  readonly pageSize?: number;
+  /** Optional cursor returned by a previous page; omit for the first page. */
+  readonly pageToken?: string;
+  /** Stringified ID of the universe whose game passes to list. */
+  readonly universeId: string;
+}
+/**
+* Parameters for partially updating an existing game pass. Every field
+* except the identifiers is optional; omitted fields are not included
+* in the multipart body so the server leaves their current values
+* untouched.
+*/
+interface UpdateGamePassParameters {
+  /** Optional new display name for the game pass. */
+  readonly name?: string;
+  /** Optional new consumer-facing description shown on the store listing. */
+  readonly description?: string;
+  /** Stringified ID of the game pass to update. */
+  readonly gamePassId: string;
+  /** Optional replacement icon image. */
+  readonly imageFile?: Blob | Uint8Array;
+  /** Optional new value for whether the game pass is purchasable. */
+  readonly isForSale?: boolean;
+  /** Optional new value for whether regional pricing is enabled. */
+  readonly isRegionalPricingEnabled?: boolean;
+  /** Optional new default price in Robux. */
+  readonly price?: number;
+  /** Stringified ID of the universe that owns the game pass. */
+  readonly universeId: string;
+}
+//#endregion
+//#region src/resources/game-passes/client.d.ts
+/**
+* Public client for the Roblox Open Cloud Game Passes API.
+*
+* Wires request builders, the injected {@link OpenCloudClientOptions.httpClient}, and response
+* parsers into a single ergonomic surface. Every method returns a
+* {@link Result} so callers handle failure explicitly; no thrown
+* `OpenCloudError` ever escapes the client.
+*
+* ```ts
+* import { GamePassesClient } from "@bedrock-rbx/ocale/game-passes";
+*
+* const client = new GamePassesClient({ apiKey: process.env.ROBLOX_API_KEY! });
+*
+* const result = await client.get({
+*     universeId: "1234567890",
+*     gamePassId: "9876543210",
+* });
+*
+* if (result.success) {
+*     console.log(`${result.data.name} (${result.data.id})`);
+* } else {
+*     console.error(result.err.message);
+* }
+* ```
+*
+* Listing is cursor-paginated; drive the loop on `nextPageToken`:
+*
+* ```ts
+* let pageToken: string | undefined;
+* do {
+*     const page = await client.list({ universeId: "1234567890", pageToken });
+*     if (!page.success) {
+*         console.error(page.err.message);
+*         break;
+*     }
+*
+*     for (const pass of page.data.items) {
+*         console.log(`${pass.name} (${pass.id})`);
+*     }
+*
+*     pageToken = page.data.nextPageToken;
+* } while (pageToken !== undefined);
+* ```
+*/
+declare class GamePassesClient {
+  #private;
+  /**
+  * Creates a new {@link GamePassesClient}. Configuration is frozen on
+  * construction; per-request overrides are accepted on each method.
+  *
+  * @param options - Client-level configuration including the API key.
+  */
+  constructor(options: OpenCloudClientOptions);
+  /**
+  * Creates a new game pass under the supplied universe.
+  *
+  * @param parameters - Creation fields including the universe and pass name.
+  * @param options - Optional per-request overrides.
+  * @returns A {@link Result} wrapping the parsed {@link GamePass} or the
+  *   {@link OpenCloudError} that caused the request to fail.
+  */
+  create(parameters: CreateGamePassParameters, options?: RequestOptions): Promise<Result<GamePass, OpenCloudError>>;
+  /**
+  * Reads a single game pass by ID.
+  *
+  * @param parameters - Universe and game pass identifiers.
+  * @param options - Optional per-request overrides (e.g. A different
+  *   {@link OpenCloudClientOptions.apiKey} for this call only).
+  * @returns A {@link Result} wrapping the parsed {@link GamePass} or the
+  *   {@link OpenCloudError} that caused the request to fail.
+  */
+  get(parameters: GetGamePassParameters, options?: RequestOptions): Promise<Result<GamePass, OpenCloudError>>;
+  /**
+  * Lists one page of game passes for the supplied universe. Pagination is
+  * cursor-based: omit `pageToken` for the first page, then thread the
+  * previous response's `nextPageToken` back in until it is `undefined`.
+  *
+  * @param parameters - Universe identifier and optional page cursors.
+  * @param options - Optional per-request overrides.
+  * @returns A {@link Result} wrapping a {@link Page} of {@link GamePass},
+  *   or the {@link OpenCloudError} that caused the request to fail.
+  */
+  list(parameters: ListGamePassesParameters, options?: RequestOptions): Promise<Result<Page<GamePass>, OpenCloudError>>;
+  /**
+  * Partially updates an existing game pass. Mirrors the upstream
+  * `204 No Content` response: a successful update yields `undefined`
+  * data. Callers that need the post-update state (for example to
+  * observe a server-derived `updatedAt`) chain
+  * {@link GamePassesClient.get} themselves so the GET only fires when
+  * actually needed.
+  *
+  * @param parameters - The universe and game pass identifiers and the
+  *   fields to update. Only fields explicitly provided are forwarded.
+  * @param options - Optional per-request overrides.
+  * @returns A success {@link Result} with no payload, or the
+  *   {@link OpenCloudError} that caused the request to fail.
+  */
+  update(parameters: UpdateGamePassParameters, options?: RequestOptions): Promise<Result<undefined, OpenCloudError>>;
+}
+//#endregion
+export { type CreateGamePassParameters, type GamePass, type GamePassPrice, type GamePassPricingFeature, GamePassesClient, type GetGamePassParameters, type ListGamePassesParameters, type UpdateGamePassParameters };
+//# sourceMappingURL=game-passes.d.mts.map

package/dist/game-passes.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-passes.d.mts","names":[],"sources":["../src/domains/game-passes/game-passes/types.ts","../src/resources/game-passes/client.ts"],"mappings":";;;;;;AAIA;KAAY,sBAAA;;;;UASK,aAAA;EAAA;EAAA,SAEP,mBAAA;EAEiB;EAAA,SAAjB,eAAA,EAAiB,aAAA,CAAc,sBAAA;AAAA;;;;;AAQzC;UAAiB,QAAA;;WAEP,EAAA;;WAEA,IAAA;;WAEA,SAAA,EAAW,IAAA;;WAEX,WAAA;;WAEA,WAAA;;WAEA,SAAA;;WAEA,KAAA,EAAO,aAAA;;WAEP,SAAA,EAAW,IAAA;AAAA;;;AAMrB;UAAiB,wBAAA;;WAEP,IAAA;;WAEA,WAAA;;WAEA,SAAA,GAAY,IAAA,GAAO,UAAA;;WAEnB,SAAA;;WAEA,wBAAA;;WAEA,KAAA;EAEA;EAAA,SAAA,UAAA;AAAA;;;;UAMO,qBAAA;EAaA;EAAA,SAXP,UAAA;EAWO;EAAA,SATP,UAAA;AAAA;;;;AAwBV;;;UAfiB,wBAAA;;WAEP,QAAA;;WAEA,SAAA;;WAEA,UAAA;AAAA;;;;;;;UASO,wBAAA;;WAEP,IAAA;ECyBG;EAAA,SDvBH,WAAA;;WAEA,UAAA;;WAEA,SAAA,GAAY,IAAA,GAAO,UAAA;;WAEnB,SAAA;;WAEA,wBAAA;;WAEA,KAAA;;WAEA,UAAA;AAAA;;;;;;;AAlGV;;;;;;;;;;AAYA;;;;;;;;;;;;;;;;;;;;;AAsBA;;;;;;;;;cC2Ea,gBAAA;EAAA;;;;;ADvDb;;ECgEC,WAAA,CAAY,OAAA,EAAS,sBAAA;EDhEL;;AAajB;;;;;;EC+DC,MAAA,CACC,UAAA,EAAY,wBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,QAAA,EAAU,cAAA;;;ADnD7B;;;;;;;ECgEC,GAAA,CACC,UAAA,EAAY,qBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,QAAA,EAAU,cAAA;;;;;;;;;;;EAc5B,IAAA,CACC,UAAA,EAAY,wBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,IAAA,CAAK,QAAA,GAAW,cAAA;EAzDnC;;;;;;;;;;;;;;EA2EC,MAAA,CACC,UAAA,EAAY,wBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,YAAkB,cAAA;AAAA"}

package/dist/game-passes.mjs

@@ -0,0 +1,397 @@
+import { i as ApiError } from "./rate-limit-BBU_4xnZ.mjs";
+import { t as toBlob } from "./to-blob-1BtHsDGK.mjs";
+import { a as IDEMPOTENT_METHOD_DEFAULTS, i as CREATE_METHOD_DEFAULTS, n as okRequest, o as isRecord, r as parseEmptyResponse, t as ResourceClient } from "./resource-client-CaS_j3yg.mjs";
+import { n as isPriceInformationLike, t as copyPriceInformation } from "./price-information-CmpscMc4.mjs";
+//#region src/domains/game-passes/game-passes/builders.ts
+/**
+* Builds a `GET` request for the Open Cloud "read game pass" endpoint.
+*
+* @param parameters - Universe and game pass identifiers to interpolate into
+*   the URL.
+* @returns A pure {@link HttpRequest} describing the read call.
+*/
+function buildGetRequest(parameters) {
+	return {
+		method: "GET",
+		url: `/game-passes/v1/universes/${parameters.universeId}/game-passes/${parameters.gamePassId}/creator`
+	};
+}
+/**
+* Builds a `GET` request for the Open Cloud "list game passes" endpoint.
+* Optional `pageSize` and `pageToken` are appended to the query string only
+* when defined so the server applies its own defaults for omitted fields.
+*
+* @param parameters - Universe identifier plus optional pagination cursors.
+* @returns A pure {@link HttpRequest} describing the list call.
+*/
+function buildListRequest(parameters) {
+	const query = new URLSearchParams();
+	if (parameters.pageSize !== void 0) query.append("pageSize", String(parameters.pageSize));
+	if (parameters.pageToken !== void 0) query.append("pageToken", parameters.pageToken);
+	const queryString = query.toString();
+	const base = `/game-passes/v1/universes/${parameters.universeId}/game-passes/creator`;
+	return {
+		method: "GET",
+		url: queryString === "" ? base : `${base}?${queryString}`
+	};
+}
+/**
+* Builds a `POST` request for the Open Cloud "create game pass" endpoint.
+*
+* @param parameters - Fields describing the new game pass; optional values
+*   omitted here are left off the multipart payload entirely.
+* @returns A pure {@link HttpRequest} describing the create call.
+*/
+function buildCreateRequest(parameters) {
+	const body = new FormData();
+	body.append("name", parameters.name);
+	if (parameters.description !== void 0) body.append("description", parameters.description);
+	if (parameters.isForSale !== void 0) body.append("isForSale", String(parameters.isForSale));
+	if (parameters.price !== void 0) body.append("price", String(parameters.price));
+	if (parameters.isRegionalPricingEnabled !== void 0) body.append("isRegionalPricingEnabled", String(parameters.isRegionalPricingEnabled));
+	if (parameters.imageFile !== void 0) body.append("imageFile", toBlob(parameters.imageFile));
+	return {
+		body,
+		method: "POST",
+		url: `/game-passes/v1/universes/${parameters.universeId}/game-passes`
+	};
+}
+/**
+* Builds a `PATCH` request for the Open Cloud "update game pass" endpoint.
+* Every field on `parameters` except the identifiers is optional;
+* omitted fields are not appended to the multipart body so the server
+* leaves their current values unchanged.
+*
+* The public parameter `imageFile` is mapped to the wire's `file`
+* multipart field name, matching the OpenAPI schema for this endpoint
+* (the create endpoint uses `imageFile`, but the update endpoint uses
+* `file`). Public consumers stay with one ergonomic name across both
+* methods.
+*
+* @param parameters - Identifiers plus fields to update.
+* @returns A pure {@link HttpRequest} describing the update call.
+*/
+function buildUpdateRequest(parameters) {
+	const body = new FormData();
+	if (parameters.name !== void 0) body.append("name", parameters.name);
+	if (parameters.description !== void 0) body.append("description", parameters.description);
+	if (parameters.isForSale !== void 0) body.append("isForSale", String(parameters.isForSale));
+	if (parameters.price !== void 0) body.append("price", String(parameters.price));
+	if (parameters.isRegionalPricingEnabled !== void 0) body.append("isRegionalPricingEnabled", String(parameters.isRegionalPricingEnabled));
+	if (parameters.imageFile !== void 0) body.append("file", toBlob(parameters.imageFile));
+	return {
+		body,
+		method: "PATCH",
+		url: `/game-passes/v1/universes/${parameters.universeId}/game-passes/${parameters.gamePassId}`
+	};
+}
+//#endregion
+//#region src/domains/game-passes/game-passes/operations.ts
+/**
+* Per-second request ceiling for reading a single game pass, from the
+* Open Cloud OpenAPI schema.
+*/
+const GET_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 10,
+	operationKey: "game-passes.get"
+});
+/**
+* Per-second request ceiling for creating a game pass, from the Open
+* Cloud OpenAPI schema.
+*/
+const CREATE_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 5,
+	operationKey: "game-passes.create"
+});
+/**
+* Per-second request ceiling for updating a game pass, from the Open
+* Cloud OpenAPI schema. Keyed independently from
+* {@link CREATE_OPERATION_LIMIT} so create and update do not share a
+* queue, since the schema does not document the per-second quota as
+* shared between the POST and PATCH endpoints.
+*/
+const UPDATE_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 5,
+	operationKey: "game-passes.update"
+});
+/**
+* Per-second request ceiling for listing game passes for a universe,
+* from the Open Cloud OpenAPI schema.
+*/
+const LIST_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 10,
+	operationKey: "game-passes.list"
+});
+/**
+* Scopes required to read a game pass, sourced from `x-roblox-scopes`
+* on the `GamePasses_GetGamePassConfig` operation in the vendored
+* OpenAPI schema.
+*/
+const GET_REQUIRED_SCOPES = Object.freeze(["game-pass:read"]);
+/**
+* Scopes required to create a game pass, sourced from `x-roblox-scopes`
+* on the `GamePasses_CreateGamePass` operation in the vendored OpenAPI
+* schema.
+*/
+const CREATE_REQUIRED_SCOPES = Object.freeze(["game-pass:write"]);
+/**
+* Scopes required to update a game pass, sourced from `x-roblox-scopes`
+* on the `GamePasses_UpdateGamePass` operation in the vendored OpenAPI
+* schema.
+*/
+const UPDATE_REQUIRED_SCOPES = Object.freeze(["game-pass:write"]);
+/**
+* Scopes required to list game passes for a universe, sourced from
+* `x-roblox-scopes` on the `GamePasses_ListGamePassConfigsByUniverse`
+* operation in the vendored OpenAPI schema.
+*/
+const LIST_REQUIRED_SCOPES = Object.freeze(["game-pass:read"]);
+//#endregion
+//#region src/domains/game-passes/game-passes/parsers.ts
+/**
+* Parses a successful Game Pass API response into the public `GamePass`
+* shape, returning a `Result` so callers can handle malformed payloads
+* without exceptions.
+*
+* @param response - The full {@link HttpResponse} from the Open Cloud API.
+*   The status code is included on the returned `ApiError` when validation
+*   fails; the headers are available for future parsers that need them.
+* @returns A success result wrapping the converted `GamePass`, or an
+*   `ApiError` when the body does not match the wire schema.
+*/
+function parseGamePassResponse(response) {
+	const { body, status: statusCode } = response;
+	if (!isGamePassConfigV2(body)) return {
+		err: new ApiError("Malformed game pass response", { statusCode }),
+		success: false
+	};
+	return {
+		data: toGamePass(body),
+		success: true
+	};
+}
+/**
+* Parses a successful "list game passes" response into a public
+* {@link Page} of {@link GamePass}, returning a `Result` so callers can
+* handle malformed payloads without exceptions. JSON `null` or a missing
+* `nextPageToken` is normalized to `undefined`.
+*
+* @param response - The full {@link HttpResponse} from the Open Cloud API.
+* @returns A success result wrapping the converted page, or an
+*   `ApiError` when the body does not match the wire schema.
+*/
+function parseGamePassesListResponse(response) {
+	const { body, status: statusCode } = response;
+	if (!isListResponseWire(body)) return {
+		err: new ApiError("Malformed game passes list response", { statusCode }),
+		success: false
+	};
+	return {
+		data: {
+			items: body.gamePasses.map(toGamePass),
+			nextPageToken: body.nextPageToken ?? void 0
+		},
+		success: true
+	};
+}
+function toGamePass(wire) {
+	const priceWire = wire.priceInformation ?? void 0;
+	return {
+		id: String(wire.gamePassId),
+		name: wire.name,
+		createdAt: new Date(wire.createdTimestamp),
+		description: wire.description,
+		iconAssetId: wire.iconAssetId === 0 ? void 0 : String(wire.iconAssetId),
+		isForSale: wire.isForSale,
+		price: priceWire === void 0 ? void 0 : copyPriceInformation(priceWire),
+		updatedAt: new Date(wire.updatedTimestamp)
+	};
+}
+function hasRequiredPrimitiveFields(body) {
+	return typeof body["gamePassId"] === "number" && typeof body["name"] === "string" && typeof body["description"] === "string" && typeof body["isForSale"] === "boolean" && typeof body["iconAssetId"] === "number" && typeof body["createdTimestamp"] === "string" && typeof body["updatedTimestamp"] === "string";
+}
+function isPricingFeatureWire(value) {
+	return value === "Invalid" || value === "PriceOptimization" || value === "RegionalPricing" || value === "UserFixedPrice";
+}
+function isGamePassConfigV2(body) {
+	if (!isRecord(body)) return false;
+	if (!hasRequiredPrimitiveFields(body)) return false;
+	const price = body["priceInformation"] ?? void 0;
+	if (price !== void 0 && !isPriceInformationLike(price, isPricingFeatureWire)) return false;
+	return true;
+}
+function isListResponseWire(body) {
+	if (!isRecord(body)) return false;
+	const { gamePasses } = body;
+	if (!Array.isArray(gamePasses)) return false;
+	for (const item of gamePasses) if (!isGamePassConfigV2(item)) return false;
+	const nextPageToken = body["nextPageToken"] ?? void 0;
+	if (nextPageToken !== void 0 && typeof nextPageToken !== "string") return false;
+	return true;
+}
+//#endregion
+//#region src/resources/game-passes/client.ts
+function makeSpec(spec) {
+	return Object.freeze(spec);
+}
+const CREATE_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildCreateRequest(parameters)),
+	methodDefaults: CREATE_METHOD_DEFAULTS,
+	methodKind: "create",
+	operationLimit: CREATE_OPERATION_LIMIT,
+	parse: parseGamePassResponse,
+	requiredScopes: CREATE_REQUIRED_SCOPES
+});
+const GET_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildGetRequest(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: GET_OPERATION_LIMIT,
+	parse: parseGamePassResponse,
+	requiredScopes: GET_REQUIRED_SCOPES
+});
+const UPDATE_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildUpdateRequest(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: UPDATE_OPERATION_LIMIT,
+	parse: parseEmptyResponse,
+	requiredScopes: UPDATE_REQUIRED_SCOPES
+});
+const LIST_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildListRequest(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: LIST_OPERATION_LIMIT,
+	parse: parseGamePassesListResponse,
+	requiredScopes: LIST_REQUIRED_SCOPES
+});
+/**
+* Public client for the Roblox Open Cloud Game Passes API.
+*
+* Wires request builders, the injected {@link OpenCloudClientOptions.httpClient}, and response
+* parsers into a single ergonomic surface. Every method returns a
+* {@link Result} so callers handle failure explicitly; no thrown
+* `OpenCloudError` ever escapes the client.
+*
+* ```ts
+* import { GamePassesClient } from "@bedrock-rbx/ocale/game-passes";
+*
+* const client = new GamePassesClient({ apiKey: process.env.ROBLOX_API_KEY! });
+*
+* const result = await client.get({
+*     universeId: "1234567890",
+*     gamePassId: "9876543210",
+* });
+*
+* if (result.success) {
+*     console.log(`${result.data.name} (${result.data.id})`);
+* } else {
+*     console.error(result.err.message);
+* }
+* ```
+*
+* Listing is cursor-paginated; drive the loop on `nextPageToken`:
+*
+* ```ts
+* let pageToken: string | undefined;
+* do {
+*     const page = await client.list({ universeId: "1234567890", pageToken });
+*     if (!page.success) {
+*         console.error(page.err.message);
+*         break;
+*     }
+*
+*     for (const pass of page.data.items) {
+*         console.log(`${pass.name} (${pass.id})`);
+*     }
+*
+*     pageToken = page.data.nextPageToken;
+* } while (pageToken !== undefined);
+* ```
+*/
+var GamePassesClient = class {
+	#inner;
+	/**
+	* Creates a new {@link GamePassesClient}. Configuration is frozen on
+	* construction; per-request overrides are accepted on each method.
+	*
+	* @param options - Client-level configuration including the API key.
+	*/
+	constructor(options) {
+		this.#inner = new ResourceClient(options);
+	}
+	/**
+	* Creates a new game pass under the supplied universe.
+	*
+	* @param parameters - Creation fields including the universe and pass name.
+	* @param options - Optional per-request overrides.
+	* @returns A {@link Result} wrapping the parsed {@link GamePass} or the
+	*   {@link OpenCloudError} that caused the request to fail.
+	*/
+	async create(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: CREATE_SPEC
+		});
+	}
+	/**
+	* Reads a single game pass by ID.
+	*
+	* @param parameters - Universe and game pass identifiers.
+	* @param options - Optional per-request overrides (e.g. A different
+	*   {@link OpenCloudClientOptions.apiKey} for this call only).
+	* @returns A {@link Result} wrapping the parsed {@link GamePass} or the
+	*   {@link OpenCloudError} that caused the request to fail.
+	*/
+	async get(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: GET_SPEC
+		});
+	}
+	/**
+	* Lists one page of game passes for the supplied universe. Pagination is
+	* cursor-based: omit `pageToken` for the first page, then thread the
+	* previous response's `nextPageToken` back in until it is `undefined`.
+	*
+	* @param parameters - Universe identifier and optional page cursors.
+	* @param options - Optional per-request overrides.
+	* @returns A {@link Result} wrapping a {@link Page} of {@link GamePass},
+	*   or the {@link OpenCloudError} that caused the request to fail.
+	*/
+	async list(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: LIST_SPEC
+		});
+	}
+	/**
+	* Partially updates an existing game pass. Mirrors the upstream
+	* `204 No Content` response: a successful update yields `undefined`
+	* data. Callers that need the post-update state (for example to
+	* observe a server-derived `updatedAt`) chain
+	* {@link GamePassesClient.get} themselves so the GET only fires when
+	* actually needed.
+	*
+	* @param parameters - The universe and game pass identifiers and the
+	*   fields to update. Only fields explicitly provided are forwarded.
+	* @param options - Optional per-request overrides.
+	* @returns A success {@link Result} with no payload, or the
+	*   {@link OpenCloudError} that caused the request to fail.
+	*/
+	async update(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: UPDATE_SPEC
+		});
+	}
+};
+//#endregion
+export { GamePassesClient };
+
+//# sourceMappingURL=game-passes.mjs.map