@bedrock-rbx/ocale 0.1.0-beta.1

package/dist/developer-products.d.mts

@@ -0,0 +1,245 @@
+import { d as OpenCloudError, i as OpenCloudClientOptions, l as Result, s as RequestOptions } from "./types-YCTsM8Qd.mjs";
+
+//#region src/domains/developer-products/products/types.d.ts
+/**
+* Pricing feature flags that can be enabled on a developer product. Values
+* mirror the Open Cloud `DeveloperProducts.PricingFeature` enum.
+*/
+type DeveloperProductPricingFeature = "Invalid" | "PriceOptimization" | "RegionalPricing" | "UserFixedPrice";
+/**
+* Public shape of a developer product's pricing configuration.
+*/
+interface DeveloperProductPrice {
+  /** Default Robux price; `undefined` when no default price is configured. */
+  readonly defaultPriceInRobux: number | undefined;
+  /** Pricing feature flags currently enabled on this developer product. */
+  readonly enabledFeatures: ReadonlyArray<DeveloperProductPricingFeature>;
+}
+/**
+* A Roblox developer product as exposed to SDK consumers. Fields use
+* DX-friendly names and types (stringified IDs, `Date` timestamps) rather
+* than the raw wire representation.
+*/
+interface DeveloperProduct {
+  /** Stringified developer product ID. The API returns an int64; always use this. */
+  readonly id: string;
+  /** Display name of the developer product. */
+  readonly name: string;
+  /** ISO timestamp at which the developer product was created, as a `Date`. */
+  readonly createdAt: Date;
+  /** Consumer-facing description shown on the storefront. */
+  readonly description: string;
+  /** Icon image asset ID as a string; `undefined` when no icon is uploaded. */
+  readonly iconImageAssetId: string | undefined;
+  /** Whether the developer product is currently purchasable. */
+  readonly isForSale: boolean;
+  /** Whether the developer product is locked from configuration changes. */
+  readonly isImmutable: boolean;
+  /** Pricing configuration; `undefined` when pricing is not yet set. */
+  readonly price: DeveloperProductPrice | undefined;
+  /** Whether the developer product appears on the external store page. */
+  readonly storePageEnabled: boolean;
+  /** Stringified ID of the universe that owns the developer product. */
+  readonly universeId: string;
+  /** ISO timestamp of the most recent update, as a `Date`. */
+  readonly updatedAt: Date;
+}
+/**
+* Parameters for creating a new developer product under a universe.
+*/
+interface CreateDeveloperProductParameters {
+  /** Display name of the new developer product. */
+  readonly name: string;
+  /** Optional consumer-facing description shown on the storefront. */
+  readonly description?: string;
+  /** Optional icon image uploaded with the new developer product. */
+  readonly imageFile?: Blob | Uint8Array;
+  /** Whether the developer product 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 developer product. */
+  readonly universeId: string;
+}
+/**
+* Parameters for reading a single developer product by ID.
+*/
+interface GetDeveloperProductParameters {
+  /** Stringified ID of the developer product to retrieve. */
+  readonly productId: string;
+  /** Stringified ID of the universe that owns the developer product. */
+  readonly universeId: string;
+}
+/**
+* Parameters for partially updating an existing developer product. Every
+* field except the identifiers is optional; omitted fields are not included
+* in the multipart PATCH body so the server leaves their current values
+* untouched.
+*/
+interface UpdateDeveloperProductParameters {
+  /** Optional new display name. */
+  readonly name?: string;
+  /** Optional new consumer-facing description. */
+  readonly description?: string;
+  /** Optional replacement icon image upload. */
+  readonly imageFile?: Blob | Uint8Array;
+  /** Optional flag toggling whether the product is purchasable. */
+  readonly isForSale?: boolean;
+  /** Optional flag toggling regional pricing. */
+  readonly isRegionalPricingEnabled?: boolean;
+  /** Optional new default price in Robux. */
+  readonly price?: number;
+  /** Stringified ID of the developer product to update. */
+  readonly productId: string;
+  /** Optional flag toggling visibility on the external store page. */
+  readonly storePageEnabled?: boolean;
+  /** Stringified ID of the universe that owns the developer product. */
+  readonly universeId: string;
+}
+//#endregion
+//#region src/domains/game-internationalization/developer-product-icon/types.d.ts
+/**
+* Parameters for uploading or replacing the per-locale icon registered
+* against a developer product. A subsequent upload for the same
+* `(productId, languageCode)` pair replaces the existing icon for that
+* locale.
+*/
+interface UploadDeveloperProductIconParameters {
+  /** Image bytes to upload. PNG and JPEG are accepted by the server. */
+  readonly image: Blob | Uint8Array;
+  /** BCP-47 language code the icon is being uploaded for (e.g. `fr-fr`). */
+  readonly languageCode: string;
+  /** Stringified ID of the developer product whose icon is being uploaded. */
+  readonly productId: string;
+}
+//#endregion
+//#region src/domains/game-internationalization/developer-product-name-description/types.d.ts
+/**
+* Parameters for updating the per-locale name and/or description registered
+* against a developer product. Both `name` and `description` are optional;
+* fields omitted from the call are not included in the JSON body so the
+* server leaves the existing value for that locale untouched.
+*/
+interface UpdateDeveloperProductNameDescriptionParameters {
+  /** Replacement display name for the supplied locale. */
+  readonly name?: string;
+  /** Replacement description for the supplied locale. */
+  readonly description?: string;
+  /** BCP-47 language code being updated (e.g. `fr-fr`). */
+  readonly languageCode: string;
+  /** Stringified ID of the developer product whose localization is being updated. */
+  readonly productId: string;
+}
+//#endregion
+//#region src/resources/developer-products/client.d.ts
+interface DeveloperProductLocalizationHandle {
+  /**
+  * Updates the per-locale display name and/or description registered against
+  * a developer product. Either `name`, `description`, or both may be
+  * supplied; omitted fields are not forwarded so the server leaves the
+  * existing value for that locale untouched. Mirrors the upstream `200 OK`
+  * echo body as `undefined` data.
+  *
+  * @param parameters - Product and language identifiers plus the optional
+  *   replacement values.
+  * @param options - Optional per-request overrides.
+  * @returns A success {@link Result} with no payload, or the
+  *   {@link OpenCloudError} that caused the request to fail.
+  */
+  updateNameDescription: (parameters: UpdateDeveloperProductNameDescriptionParameters, options?: RequestOptions) => Promise<Result<undefined, OpenCloudError>>;
+  /**
+  * Uploads or replaces the per-locale icon for a developer product. A
+  * subsequent upload for the same `(productId, languageCode)` pair replaces
+  * the existing icon for that locale. Does not retry on 5xx so a duplicate
+  * upload cannot be created if the server fails mid-write.
+  *
+  * @param parameters - Product and language identifiers plus the image
+  *   bytes to upload.
+  * @param options - Optional per-request overrides.
+  * @returns A success {@link Result} with no payload, or the
+  *   {@link OpenCloudError} that caused the request to fail.
+  */
+  uploadIcon: (parameters: UploadDeveloperProductIconParameters, options?: RequestOptions) => Promise<Result<undefined, OpenCloudError>>;
+}
+/**
+* Public client for the Roblox Open Cloud Developer Products 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 { DeveloperProductsClient } from "@bedrock-rbx/ocale/developer-products";
+*
+* const client = new DeveloperProductsClient({ apiKey: process.env.ROBLOX_API_KEY! });
+*
+* const result = await client.get({
+*     universeId: "1234567890",
+*     productId: "9876543210",
+* });
+*
+* if (result.success) {
+*     console.log(`${result.data.name} (${result.data.id})`);
+* } else {
+*     console.error(result.err.message);
+* }
+* ```
+*/
+declare class DeveloperProductsClient {
+  #private;
+  /**
+  * Operation Group exposing per-locale localization Operations
+  * (`updateNameDescription`, `uploadIcon`) backed by the
+  * `legacy-game-internationalization` domain. Source-language values
+  * remain on {@link DeveloperProductsClient.update}; methods on this
+  * group set per-locale overlays on top. Shares the parent client's
+  * HTTP, rate-limit, and retry plumbing.
+  */
+  readonly localization: DeveloperProductLocalizationHandle;
+  /**
+  * Creates a new {@link DeveloperProductsClient}. 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 developer product under the supplied universe.
+  *
+  * @param parameters - Creation fields including the universe and product name.
+  * @param options - Optional per-request overrides.
+  * @returns A {@link Result} wrapping the parsed {@link DeveloperProduct} or
+  *   the {@link OpenCloudError} that caused the request to fail.
+  */
+  create(parameters: CreateDeveloperProductParameters, options?: RequestOptions): Promise<Result<DeveloperProduct, OpenCloudError>>;
+  /**
+  * Reads a single developer product by ID.
+  *
+  * @param parameters - Universe and product 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 DeveloperProduct} or
+  *   the {@link OpenCloudError} that caused the request to fail.
+  */
+  get(parameters: GetDeveloperProductParameters, options?: RequestOptions): Promise<Result<DeveloperProduct, OpenCloudError>>;
+  /**
+  * Partially updates an existing developer product. 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 `updatedTimestamp`) chain {@link DeveloperProductsClient.get}
+  * themselves so the GET only fires when actually needed.
+  *
+  * @param parameters - The universe and product 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: UpdateDeveloperProductParameters, options?: RequestOptions): Promise<Result<undefined, OpenCloudError>>;
+}
+//#endregion
+export { type CreateDeveloperProductParameters, type DeveloperProduct, type DeveloperProductPrice, type DeveloperProductPricingFeature, DeveloperProductsClient, type GetDeveloperProductParameters, type UpdateDeveloperProductNameDescriptionParameters, type UpdateDeveloperProductParameters, type UploadDeveloperProductIconParameters };
+//# sourceMappingURL=developer-products.d.mts.map

package/dist/developer-products.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"developer-products.d.mts","names":[],"sources":["../src/domains/developer-products/products/types.ts","../src/domains/game-internationalization/developer-product-icon/types.ts","../src/domains/game-internationalization/developer-product-name-description/types.ts","../src/resources/developer-products/client.ts"],"mappings":";;;;;;AAIA;KAAY,8BAAA;;;;UASK,qBAAA;EAAA;EAAA,SAEP,mBAAA;EAEiB;EAAA,SAAjB,eAAA,EAAiB,aAAA,CAAc,8BAAA;AAAA;;;;;AAQzC;UAAiB,gBAAA;;WAEP,EAAA;;WAEA,IAAA;;WAEA,SAAA,EAAW,IAAA;;WAEX,WAAA;;WAEA,gBAAA;;WAEA,SAAA;;WAEA,WAAA;;WAEA,KAAA,EAAO,qBAAA;;WAEP,gBAAA;;WAEA,UAAA;;WAEA,SAAA,EAAW,IAAA;AAAA;;;;UAMJ,gCAAA;;WAEP,IAAA;;WAEA,WAAA;;WAEA,SAAA,GAAY,IAAA,GAAO,UAAA;;WAEnB,SAAA;;WAEA,wBAAA;EAUV;EAAA,SARU,KAAA;;WAEA,UAAA;AAAA;AAmBV;;;AAAA,UAbiB,6BAAA;;WAEP,SAAA;;WAEA,UAAA;AAAA;;;;;;;UASO,gCAAA;EAkBP;EAAA,SAhBA,IAAA;;WAEA,WAAA;ECpFV;EAAA,SDsFU,SAAA,GAAY,IAAA,GAAO,UAAA;;WAEnB,SAAA;;WAEA,wBAAA;;WAEA,KAAA;;WAEA,SAAA;ECxFA;EAAA,SD0FA,gBAAA;;WAEA,UAAA;AAAA;;;;;;AApGV;;;UCEiB,oCAAA;EDFL;EAAA,SCIF,KAAA,EAAO,IAAA,GAAO,UAAA;EDKP;EAAA,SCHP,YAAA;EDOiB;EAAA,SCLjB,SAAA;AAAA;;;;;;ADRV;;;UEEiB,+CAAA;EFFL;EAAA,SEIF,IAAA;EFKO;EAAA,SEHP,WAAA;EFOiB;EAAA,SELjB,YAAA;;WAEA,SAAA;AAAA;;;UC8EA,kCAAA;EHxFE;AASZ;;;;;;;;;;AAYA;;EGiFC,qBAAA,GACC,UAAA,EAAY,+CAAA,EACZ,OAAA,GAAU,cAAA,KACN,OAAA,CAAQ,MAAA,YAAkB,cAAA;;;;;;;;;;;;;EAa/B,UAAA,GACC,UAAA,EAAY,oCAAA,EACZ,OAAA,GAAU,cAAA,KACN,OAAA,CAAQ,MAAA,YAAkB,cAAA;AAAA;;;;;;;;AHxEhC;;;;;;;;;;;;;;;AAoBA;;;cGgFa,uBAAA;EAAA;EHnEb;;;;;;;;EAAA,SG8EiB,YAAA,EAAc,kCAAA;;;;;;;EAQ9B,WAAA,CAAY,OAAA,EAAS,sBAAA;EHpEZ;;;;AClGV;;;;EEmLC,MAAA,CACC,UAAA,EAAY,gCAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,gBAAA,EAAkB,cAAA;;;;;;;;;;EAapC,GAAA,CACC,UAAA,EAAY,6BAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,gBAAA,EAAkB,cAAA;EDtMpB;;;;;;;;;;;;AC8BW;EAyL3B,MAAA,CACC,UAAA,EAAY,gCAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,YAAkB,cAAA;AAAA"}

package/dist/developer-products.mjs

@@ -0,0 +1,388 @@
+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/developer-products/products/builders.ts
+/**
+* Builds a `GET` request for the Open Cloud "read developer product"
+* endpoint.
+*
+* @param parameters - Universe and product identifiers to interpolate into
+*   the URL.
+* @returns A pure {@link HttpRequest} describing the read call.
+*/
+function buildGetRequest(parameters) {
+	return {
+		method: "GET",
+		url: `/developer-products/v2/universes/${parameters.universeId}/developer-products/${parameters.productId}/creator`
+	};
+}
+/**
+* Builds a `POST` request for the Open Cloud "create developer product"
+* endpoint.
+*
+* @param parameters - Fields describing the new developer product; 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: `/developer-products/v2/universes/${parameters.universeId}/developer-products`
+	};
+}
+/**
+* Builds a `PATCH` request for the Open Cloud "update developer product"
+* endpoint. Every field on `parameters` except the identifiers is optional;
+* omitted fields are not appended to the multipart body so the server leaves
+* them unchanged.
+*
+* @param parameters - Identifiers plus fields to update.
+* @returns A pure {@link HttpRequest} describing the update call.
+*/
+function buildUpdateRequest$1(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.storePageEnabled !== void 0) body.append("storePageEnabled", String(parameters.storePageEnabled));
+	if (parameters.imageFile !== void 0) body.append("imageFile", toBlob(parameters.imageFile));
+	return {
+		body,
+		method: "PATCH",
+		url: `/developer-products/v2/universes/${parameters.universeId}/developer-products/${parameters.productId}`
+	};
+}
+//#endregion
+//#region src/domains/developer-products/products/operations.ts
+/**
+* Per-second request ceiling for reading a single developer product, from
+* the Open Cloud OpenAPI schema.
+*/
+const GET_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 10,
+	operationKey: "developer-products.get"
+});
+/**
+* Per-second request ceiling for creating a developer product, from the
+* Open Cloud OpenAPI schema.
+*/
+const CREATE_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 3,
+	operationKey: "developer-products.create"
+});
+/**
+* Per-second request ceiling for updating a developer product, from the
+* Open Cloud OpenAPI schema. Keyed independently from
+* {@link CREATE_OPERATION_LIMIT} so create and update do not share a queue,
+* since Roblox does not document the per-minute quota as shared between
+* the POST and PATCH endpoints.
+*/
+const UPDATE_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 3,
+	operationKey: "developer-products.update"
+});
+/**
+* Scopes the API key or OAuth token must carry to read a developer product,
+* sourced from `x-roblox-scopes` on the `DeveloperProducts_GetDeveloperProductConfigV2`
+* operation in the vendored OpenAPI schema.
+*/
+const GET_REQUIRED_SCOPES = Object.freeze(["developer-product:read"]);
+/**
+* Scopes the API key or OAuth token must carry to create or update a developer
+* product, sourced from `x-roblox-scopes` on the
+* `DeveloperProducts_CreateDeveloperProductV2` and
+* `DeveloperProducts_UpdateDeveloperProductV2` operations in the vendored
+* OpenAPI schema.
+*/
+const WRITE_REQUIRED_SCOPES = Object.freeze(["developer-product:write"]);
+//#endregion
+//#region src/domains/developer-products/products/parsers.ts
+/**
+* Parses a successful Developer Products API response into the public
+* `DeveloperProduct` 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 `DeveloperProduct`, or
+*   an `ApiError` when the body does not match the wire schema.
+*/
+function parseDeveloperProductResponse(response) {
+	const { body, status: statusCode } = response;
+	if (!isDeveloperProductConfigV2(body)) return {
+		err: new ApiError("Malformed developer product response", { statusCode }),
+		success: false
+	};
+	const priceWire = body.priceInformation ?? void 0;
+	const iconAssetId = body.iconImageAssetId ?? void 0;
+	return {
+		data: {
+			id: String(body.productId),
+			name: body.name,
+			createdAt: new Date(body.createdTimestamp),
+			description: body.description,
+			iconImageAssetId: iconAssetId === void 0 ? void 0 : String(iconAssetId),
+			isForSale: body.isForSale,
+			isImmutable: body.isImmutable,
+			price: priceWire === void 0 ? void 0 : copyPriceInformation(priceWire),
+			storePageEnabled: body.storePageEnabled,
+			universeId: String(body.universeId),
+			updatedAt: new Date(body.updatedTimestamp)
+		},
+		success: true
+	};
+}
+function hasRequiredPrimitiveFields(body) {
+	return typeof body["productId"] === "number" && body["productId"] !== 0 && typeof body["universeId"] === "number" && typeof body["name"] === "string" && typeof body["description"] === "string" && typeof body["isForSale"] === "boolean" && typeof body["isImmutable"] === "boolean" && typeof body["storePageEnabled"] === "boolean" && typeof body["createdTimestamp"] === "string" && typeof body["updatedTimestamp"] === "string";
+}
+function isPricingFeatureWire(value) {
+	return value === "Invalid" || value === "PriceOptimization" || value === "RegionalPricing" || value === "UserFixedPrice";
+}
+function isDeveloperProductConfigV2(body) {
+	if (!isRecord(body)) return false;
+	if (!hasRequiredPrimitiveFields(body)) return false;
+	const iconImageAssetId = body["iconImageAssetId"] ?? void 0;
+	if (iconImageAssetId !== void 0 && typeof iconImageAssetId !== "number") return false;
+	const price = body["priceInformation"] ?? void 0;
+	if (price !== void 0 && !isPriceInformationLike(price, isPricingFeatureWire)) return false;
+	return true;
+}
+//#endregion
+//#region src/domains/game-internationalization/developer-product-icon/builders.ts
+/**
+* Builds a `POST` request for the localized "upload developer-product icon"
+* endpoint. A successful upload replaces any existing icon for the same
+* `(productId, languageCode)` pair.
+*
+* @param parameters - Product and language identifiers plus the image bytes
+*   to upload.
+* @returns A pure {@link HttpRequest} describing the upload call.
+*/
+function buildUploadIconRequest(parameters) {
+	const body = new FormData();
+	body.append("Files", toBlob(parameters.image));
+	return {
+		body,
+		method: "POST",
+		url: `/legacy-game-internationalization/v1/developer-products/${parameters.productId}/icons/language-codes/${parameters.languageCode}`
+	};
+}
+//#endregion
+//#region src/domains/game-internationalization/developer-product-name-description/builders.ts
+/**
+* Builds a `PATCH` request for the localized "update developer-product
+* name/description" endpoint. Either `name`, `description`, or both may be
+* supplied; omitted fields are not included in the JSON body so the server
+* leaves the existing value for that locale untouched.
+*
+* @param parameters - Product and language identifiers plus the optional
+*   replacement values.
+* @returns A pure {@link HttpRequest} describing the update call.
+*/
+function buildUpdateRequest(parameters) {
+	const body = {};
+	if (parameters.name !== void 0) body["name"] = parameters.name;
+	if (parameters.description !== void 0) body["description"] = parameters.description;
+	return {
+		body,
+		method: "PATCH",
+		url: `/legacy-game-internationalization/v1/developer-products/${parameters.productId}/name-description/language-codes/${parameters.languageCode}`
+	};
+}
+//#endregion
+//#region src/domains/game-internationalization/developer-product-name-description/operations.ts
+/**
+* Per-second request ceiling for every developer-product localization
+* Operation. The legacy `gameinternationalization` service caps each API key
+* at 100 requests per minute *shared across the entire service* (see the
+* `x-roblox-rate-limits` extension on every operation in the vendored Open
+* Cloud spec), so all developer-product localization methods queue against
+* the same operation key.
+*/
+const LOCALIZATION_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 100 / 60,
+	operationKey: "developer-product-localization"
+});
+/**
+* Scopes required for every developer-product localization operation, sourced
+* from `x-roblox-scopes` on the legacy `gameinternationalization`
+* developer-product endpoints in the vendored OpenAPI schema.
+*/
+const LOCALIZATION_REQUIRED_SCOPES = Object.freeze(["legacy-developer-product:manage"]);
+//#endregion
+//#region src/resources/developer-products/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: parseDeveloperProductResponse,
+	requiredScopes: WRITE_REQUIRED_SCOPES
+});
+const GET_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildGetRequest(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: GET_OPERATION_LIMIT,
+	parse: parseDeveloperProductResponse,
+	requiredScopes: GET_REQUIRED_SCOPES
+});
+const UPDATE_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildUpdateRequest$1(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: UPDATE_OPERATION_LIMIT,
+	parse: parseEmptyResponse,
+	requiredScopes: WRITE_REQUIRED_SCOPES
+});
+const UPDATE_NAME_DESCRIPTION_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildUpdateRequest(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: LOCALIZATION_OPERATION_LIMIT,
+	parse: parseEmptyResponse,
+	requiredScopes: LOCALIZATION_REQUIRED_SCOPES
+});
+const UPLOAD_ICON_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildUploadIconRequest(parameters)),
+	methodDefaults: CREATE_METHOD_DEFAULTS,
+	methodKind: "create",
+	operationLimit: LOCALIZATION_OPERATION_LIMIT,
+	parse: parseEmptyResponse,
+	requiredScopes: LOCALIZATION_REQUIRED_SCOPES
+});
+/**
+* Public client for the Roblox Open Cloud Developer Products 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 { DeveloperProductsClient } from "@bedrock-rbx/ocale/developer-products";
+*
+* const client = new DeveloperProductsClient({ apiKey: process.env.ROBLOX_API_KEY! });
+*
+* const result = await client.get({
+*     universeId: "1234567890",
+*     productId: "9876543210",
+* });
+*
+* if (result.success) {
+*     console.log(`${result.data.name} (${result.data.id})`);
+* } else {
+*     console.error(result.err.message);
+* }
+* ```
+*/
+var DeveloperProductsClient = class {
+	#inner;
+	/**
+	* Operation Group exposing per-locale localization Operations
+	* (`updateNameDescription`, `uploadIcon`) backed by the
+	* `legacy-game-internationalization` domain. Source-language values
+	* remain on {@link DeveloperProductsClient.update}; methods on this
+	* group set per-locale overlays on top. Shares the parent client's
+	* HTTP, rate-limit, and retry plumbing.
+	*/
+	localization;
+	/**
+	* Creates a new {@link DeveloperProductsClient}. 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);
+		this.localization = createLocalizationHandle(this.#inner);
+	}
+	/**
+	* Creates a new developer product under the supplied universe.
+	*
+	* @param parameters - Creation fields including the universe and product name.
+	* @param options - Optional per-request overrides.
+	* @returns A {@link Result} wrapping the parsed {@link DeveloperProduct} 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 developer product by ID.
+	*
+	* @param parameters - Universe and product 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 DeveloperProduct} or
+	*   the {@link OpenCloudError} that caused the request to fail.
+	*/
+	async get(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: GET_SPEC
+		});
+	}
+	/**
+	* Partially updates an existing developer product. 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 `updatedTimestamp`) chain {@link DeveloperProductsClient.get}
+	* themselves so the GET only fires when actually needed.
+	*
+	* @param parameters - The universe and product 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
+		});
+	}
+};
+function createLocalizationHandle(inner) {
+	return {
+		async updateNameDescription(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: UPDATE_NAME_DESCRIPTION_SPEC
+			});
+		},
+		async uploadIcon(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: UPLOAD_ICON_SPEC
+			});
+		}
+	};
+}
+//#endregion
+export { DeveloperProductsClient };
+
+//# sourceMappingURL=developer-products.mjs.map