@bedrock-rbx/ocale 0.1.0-beta.1

package/dist/universes.mjs

@@ -0,0 +1,705 @@
+import { i as ApiError } from "./rate-limit-BBU_4xnZ.mjs";
+import { t as ValidationError } from "./validation-CTZzJhmd.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";
+//#region src/domains/cloud-v2/universes/builders.ts
+/**
+* Dodges `unicorn/no-null` while still emitting a literal `null` onto
+* the wire, which the Open Cloud `Cloud_UpdateUniverse` endpoint
+* requires to clear a nullable field (for example disabling private
+* servers or removing a social link).
+*/
+const NULL_SENTINEL = JSON.parse("null");
+/**
+* Builds a `GET` request for the Open Cloud "get universe" endpoint.
+*
+* @param parameters - The universe identifier.
+* @returns A success result wrapping the request; the builder cannot fail.
+*/
+function buildGetRequest(parameters) {
+	return okRequest({
+		method: "GET",
+		url: `/cloud/v2/universes/${parameters.universeId}`
+	});
+}
+/**
+* Builds a `PATCH` request for the Open Cloud "update universe"
+* endpoint. Derives the `updateMask` query string from the keys
+* present on `parameters` and emits a JSON body containing those same
+* fields, translating `undefined` values to JSON `null` so Roblox
+* clears the corresponding server-side value.
+*
+* @param parameters - The universe identifier plus the fields to update.
+* @returns A success result wrapping the request, or a
+*   {@link ValidationError} when no updatable fields were supplied.
+*/
+function buildUpdateRequest(parameters) {
+	const fieldKeys = extractUpdateFieldKeys(parameters);
+	if (fieldKeys.length === 0) return {
+		err: new ValidationError("Update must include at least one field", { code: "empty_update" }),
+		success: false
+	};
+	const body = {};
+	for (const key of fieldKeys) body[key] = bodyValueFor(parameters, key);
+	const updateMask = fieldKeys.join(",");
+	return {
+		data: {
+			body,
+			headers: { "content-type": "application/json" },
+			method: "PATCH",
+			url: `/cloud/v2/universes/${parameters.universeId}?updateMask=${updateMask}`
+		},
+		success: true
+	};
+}
+function extractUpdateFieldKeys(parameters) {
+	return Object.keys(parameters).filter((key) => key !== "universeId");
+}
+function bodyValueFor(parameters, key) {
+	const value = Reflect.get(parameters, key);
+	return value === void 0 ? NULL_SENTINEL : value;
+}
+//#endregion
+//#region src/domains/cloud-v2/universes/operations.ts
+const PER_MINUTE = 100;
+const SECONDS_PER_MINUTE = 60;
+/**
+* Per-second request ceiling for reading a universe, from the Open
+* Cloud OpenAPI schema (100 requests per minute per API key owner).
+*/
+const GET_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: PER_MINUTE / SECONDS_PER_MINUTE,
+	operationKey: "universes.get"
+});
+/**
+* Per-second request ceiling for updating a universe, from the Open
+* Cloud OpenAPI schema (100 requests per minute per API key owner).
+* Keyed independently from {@link GET_OPERATION_LIMIT} so reads and
+* updates do not share a queue; upstream quota accounting is not
+* documented as shared and the conservative default is fewer
+* cross-method contention surprises.
+*/
+const UPDATE_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: PER_MINUTE / SECONDS_PER_MINUTE,
+	operationKey: "universes.update"
+});
+/**
+* Scopes required to update a universe, sourced from `x-roblox-scopes`
+* on the `Cloud_UpdateUniverse` operation in the vendored OpenAPI schema.
+* `Cloud_GetUniverse` declares no scope, so the GET method intentionally
+* does not declare `requiredScopes` and a 401/403 there surfaces as a
+* generic ApiError.
+*/
+const UPDATE_REQUIRED_SCOPES = Object.freeze(["universe:write"]);
+//#endregion
+//#region src/domains/cloud-v2/universes/parsers.ts
+const VISIBILITY_MAP = {
+	PRIVATE: "private",
+	PUBLIC: "public",
+	VISIBILITY_UNSPECIFIED: "unspecified"
+};
+const AGE_RATING_MAP = {
+	AGE_RATING_9_PLUS: "9Plus",
+	AGE_RATING_13_PLUS: "13Plus",
+	AGE_RATING_17_PLUS: "17Plus",
+	AGE_RATING_ALL: "all",
+	AGE_RATING_UNSPECIFIED: "unspecified"
+};
+const MALFORMED_MESSAGE = "Malformed universe response";
+/**
+* Parses a successful Open Cloud `Universe` response body into the
+* public {@link Universe} shape.
+*
+* @param response - The full {@link HttpResponse} from the Open Cloud API.
+* @returns A success result wrapping the parsed {@link Universe}, or
+*   an {@link ApiError} when the body does not match the wire schema.
+*/
+function parseUniverseResponse(response) {
+	const { body, status: statusCode } = response;
+	if (!isUniverseWire(body)) return malformed(statusCode);
+	const ownerResult = resolveOwner(body);
+	if (!ownerResult.success) return malformed(statusCode);
+	const id = /^universes\/(\d+)$/.exec(body.path)?.[1];
+	if (id === void 0) return malformed(statusCode);
+	return {
+		data: toUniverse({
+			id,
+			body,
+			owner: ownerResult.data
+		}),
+		success: true
+	};
+}
+function malformed(statusCode) {
+	return {
+		err: new ApiError(MALFORMED_MESSAGE, { statusCode }),
+		success: false
+	};
+}
+function extractRootPlaceId(rootPlace) {
+	if (rootPlace === void 0) return;
+	return /\/places\/(\d+)$/.exec(rootPlace)?.[1];
+}
+function toSocialLink(wire) {
+	if (wire === void 0) return;
+	return {
+		title: wire.title,
+		uri: wire.uri
+	};
+}
+function toUniverse(args) {
+	const { id, body, owner } = args;
+	return {
+		id,
+		ageRating: AGE_RATING_MAP[body.ageRating],
+		consoleEnabled: body.consoleEnabled ?? false,
+		createdAt: new Date(body.createTime),
+		description: body.description,
+		desktopEnabled: body.desktopEnabled ?? false,
+		discordSocialLink: toSocialLink(body.discordSocialLink),
+		displayName: body.displayName,
+		facebookSocialLink: toSocialLink(body.facebookSocialLink),
+		guildedSocialLink: toSocialLink(body.guildedSocialLink),
+		mobileEnabled: body.mobileEnabled ?? false,
+		owner,
+		privateServerPriceRobux: body.privateServerPriceRobux ?? void 0,
+		robloxGroupSocialLink: toSocialLink(body.robloxGroupSocialLink),
+		rootPlaceId: extractRootPlaceId(body.rootPlace),
+		tabletEnabled: body.tabletEnabled ?? false,
+		twitchSocialLink: toSocialLink(body.twitchSocialLink),
+		twitterSocialLink: toSocialLink(body.twitterSocialLink),
+		updatedAt: new Date(body.updateTime),
+		visibility: VISIBILITY_MAP[body.visibility],
+		voiceChatEnabled: body.voiceChatEnabled ?? false,
+		vrEnabled: body.vrEnabled ?? false,
+		youtubeSocialLink: toSocialLink(body.youtubeSocialLink)
+	};
+}
+function isVisibilityWire(value) {
+	return value === "PRIVATE" || value === "PUBLIC" || value === "VISIBILITY_UNSPECIFIED";
+}
+function isAgeRatingWire(value) {
+	return value === "AGE_RATING_13_PLUS" || value === "AGE_RATING_17_PLUS" || value === "AGE_RATING_9_PLUS" || value === "AGE_RATING_ALL" || value === "AGE_RATING_UNSPECIFIED";
+}
+function hasValidRequiredFields(body) {
+	return typeof body["path"] === "string" && typeof body["createTime"] === "string" && typeof body["updateTime"] === "string" && typeof body["displayName"] === "string" && typeof body["description"] === "string" && isVisibilityWire(body["visibility"]) && isAgeRatingWire(body["ageRating"]);
+}
+function isSocialLinkWire(value) {
+	if (!isRecord(value)) return false;
+	return typeof value["title"] === "string" && typeof value["uri"] === "string";
+}
+function isOptionalSocialLink(value) {
+	return value === void 0 || value === null || isSocialLinkWire(value);
+}
+function isOptionalBoolean(value) {
+	return value === void 0 || value === null || typeof value === "boolean";
+}
+function hasValidOptionalFields(body) {
+	const priceField = body["privateServerPriceRobux"] ?? void 0;
+	if (priceField !== void 0 && typeof priceField !== "number") return false;
+	const rootPlace = body["rootPlace"] ?? void 0;
+	if (rootPlace !== void 0 && typeof rootPlace !== "string") return false;
+	return isOptionalBoolean(body["voiceChatEnabled"]) && isOptionalBoolean(body["desktopEnabled"]) && isOptionalBoolean(body["mobileEnabled"]) && isOptionalBoolean(body["tabletEnabled"]) && isOptionalBoolean(body["consoleEnabled"]) && isOptionalBoolean(body["vrEnabled"]) && isOptionalSocialLink(body["facebookSocialLink"]) && isOptionalSocialLink(body["twitterSocialLink"]) && isOptionalSocialLink(body["youtubeSocialLink"]) && isOptionalSocialLink(body["twitchSocialLink"]) && isOptionalSocialLink(body["discordSocialLink"]) && isOptionalSocialLink(body["robloxGroupSocialLink"]) && isOptionalSocialLink(body["guildedSocialLink"]);
+}
+function isUniverseWire(body) {
+	if (!isRecord(body)) return false;
+	return hasValidRequiredFields(body) && hasValidOptionalFields(body);
+}
+function extractOwnerId(resourcePath) {
+	return /^(?:users|groups)\/(\d+)$/.exec(resourcePath)?.[1];
+}
+function resolveOwner(body) {
+	if (typeof body.user === "string") {
+		const id = extractOwnerId(body.user);
+		if (id !== void 0) return {
+			data: {
+				id,
+				kind: "user"
+			},
+			success: true
+		};
+	}
+	if (typeof body.group === "string") {
+		const id = extractOwnerId(body.group);
+		if (id !== void 0) return {
+			data: {
+				id,
+				kind: "group"
+			},
+			success: true
+		};
+	}
+	return {
+		err: void 0,
+		success: false
+	};
+}
+//#endregion
+//#region src/domains/game-internationalization/game-icon/builders.ts
+/**
+* Builds a `POST` request for the localized "upload experience icon"
+* endpoint. A successful upload replaces any existing icon for the same
+* `(universeId, languageCode)` pair.
+*
+* @param parameters - Universe 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("request.files", toBlob(parameters.image));
+	return {
+		body,
+		method: "POST",
+		url: `/legacy-game-internationalization/v1/game-icon/games/${parameters.universeId}/language-codes/${parameters.languageCode}`
+	};
+}
+/**
+* Builds a `DELETE` request for the localized "delete experience icon"
+* endpoint. Removing the source-language icon is rejected server-side;
+* deleting the icon for a non-source language clears that translation.
+*
+* @param parameters - Universe and language identifiers of the icon to
+*   delete.
+* @returns A pure {@link HttpRequest} describing the delete call.
+*/
+function buildDeleteIconRequest(parameters) {
+	return {
+		method: "DELETE",
+		url: `/legacy-game-internationalization/v1/game-icon/games/${parameters.universeId}/language-codes/${parameters.languageCode}`
+	};
+}
+/**
+* Builds a `GET` request for the "list experience icons" endpoint. The
+* server returns one entry per locale that has an icon registered.
+*
+* @param parameters - Universe identifier whose icons to list.
+* @returns A pure {@link HttpRequest} describing the list call.
+*/
+function buildListIconsRequest(parameters) {
+	return {
+		method: "GET",
+		url: `/legacy-game-internationalization/v1/game-icon/games/${parameters.universeId}`
+	};
+}
+//#endregion
+//#region src/domains/game-internationalization/game-icon/operations.ts
+/**
+* Per-second request ceiling for every game-icon Operation bound on
+* `UniversesClient.icon`. 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 methods queue against the same operation
+* key.
+*/
+const ICON_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 100 / 60,
+	operationKey: "experience-icon"
+});
+/**
+* Scopes required for every game-icon operation, sourced from
+* `x-roblox-scopes` on the legacy `gameinternationalization` icon
+* endpoints in the vendored OpenAPI schema.
+*/
+const ICON_REQUIRED_SCOPES = Object.freeze(["legacy-universe:manage"]);
+//#endregion
+//#region src/domains/game-internationalization/game-icon/parsers.ts
+/**
+* Parses a successful icon-list response into a public array of
+* {@link ExperienceIcon} entries.
+*
+* @param response - The full {@link HttpResponse} from the Open Cloud API.
+* @returns A success result wrapping the converted icon list, or an
+*   `ApiError` when the body does not match the wire schema.
+*/
+function parseIconListResponse(response) {
+	const { body, status: statusCode } = response;
+	if (!isGameIconListWire(body)) return {
+		err: new ApiError("Malformed icon list response", { statusCode }),
+		success: false
+	};
+	return {
+		data: body.data.map(toExperienceIcon),
+		success: true
+	};
+}
+function isGameIconState(value) {
+	return value === "Approved" || value === "Error" || value === "PendingReview" || value === "Rejected" || value === "UnAvailable";
+}
+function isGetGameIconResponseWire(value) {
+	if (!isRecord(value)) return false;
+	return typeof value["imageId"] === "string" && typeof value["imageUrl"] === "string" && typeof value["languageCode"] === "string" && isGameIconState(value["state"]);
+}
+function isGameIconListWire(body) {
+	if (!isRecord(body)) return false;
+	const { data } = body;
+	if (!Array.isArray(data)) return false;
+	return data.every(isGetGameIconResponseWire);
+}
+function toExperienceIcon(wire) {
+	return {
+		imageId: wire.imageId,
+		imageUrl: wire.imageUrl,
+		languageCode: wire.languageCode,
+		state: wire.state
+	};
+}
+//#endregion
+//#region src/domains/game-internationalization/game-thumbnails/builders.ts
+/**
+* Builds a `POST` request for the localized "upload experience thumbnail"
+* endpoint. Each successful upload appends a new entry to the carousel.
+*
+* @param parameters - Universe and language identifiers plus the image
+*   bytes to upload.
+* @returns A pure {@link HttpRequest} describing the upload call.
+*/
+function buildUploadThumbnailRequest(parameters) {
+	const body = new FormData();
+	body.append("gameThumbnailRequest.files", toBlob(parameters.image));
+	return {
+		body,
+		method: "POST",
+		url: `/legacy-game-internationalization/v1/game-thumbnails/games/${parameters.universeId}/language-codes/${parameters.languageCode}/image`
+	};
+}
+/**
+* Builds a `DELETE` request for the "delete experience thumbnail" endpoint.
+*
+* @param parameters - Universe, language, and image identifiers of the
+*   thumbnail to delete.
+* @returns A pure {@link HttpRequest} describing the delete call.
+*/
+function buildDeleteThumbnailRequest(parameters) {
+	return {
+		method: "DELETE",
+		url: `/legacy-game-internationalization/v1/game-thumbnails/games/${parameters.universeId}/language-codes/${parameters.languageCode}/images/${parameters.imageId}`
+	};
+}
+/**
+* Builds a `POST` request for the "reorder experience thumbnails" endpoint.
+* Validates each supplied image ID at the wire boundary so a typo cannot
+* silently serialize as JSON `null` and corrupt the request.
+*
+* @param parameters - Universe, language, and the desired display order.
+* @returns A success result wrapping the request, or a
+*   {@link ValidationError} when `orderedImageIds` is empty or any ID is not
+*   a positive integer within the safe-integer range.
+*/
+function buildReorderThumbnailsRequest(parameters) {
+	const { languageCode, orderedImageIds, universeId } = parameters;
+	const idsResult = parseOrderedImageIds(orderedImageIds);
+	if (!idsResult.success) return idsResult;
+	return {
+		data: {
+			body: { mediaAssetIds: idsResult.data },
+			method: "POST",
+			url: `/legacy-game-internationalization/v1/game-thumbnails/games/${universeId}/language-codes/${languageCode}/images/order`
+		},
+		success: true
+	};
+}
+function parseImageId(value) {
+	if (!/^[1-9]\d*$/.test(value)) return;
+	const parsed = Number(value);
+	if (!Number.isSafeInteger(parsed)) return;
+	return parsed;
+}
+function appendParsedId(accumulator, id) {
+	if (!accumulator.success) return accumulator;
+	const parsed = parseImageId(id);
+	if (parsed === void 0) return {
+		err: new ValidationError(`orderedImageIds entry ${JSON.stringify(id)} is not a positive integer ID`, { code: "invalid_image_id" }),
+		success: false
+	};
+	return {
+		data: [...accumulator.data, parsed],
+		success: true
+	};
+}
+function parseOrderedImageIds(orderedImageIds) {
+	if (orderedImageIds.length === 0) return {
+		err: new ValidationError("orderedImageIds must contain at least one image ID", { code: "empty_image_ids" }),
+		success: false
+	};
+	return orderedImageIds.reduce(appendParsedId, {
+		data: [],
+		success: true
+	});
+}
+//#endregion
+//#region src/domains/game-internationalization/game-thumbnails/operations.ts
+/**
+* Per-second request ceiling for every game-thumbnails Operation bound on
+* `UniversesClient.thumbnails`. 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 methods queue against
+* the same operation key.
+*/
+const THUMBNAILS_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 100 / 60,
+	operationKey: "experience-thumbnails"
+});
+/**
+* Scopes required for every game-thumbnails operation, sourced from
+* `x-roblox-scopes` on the legacy `gameinternationalization` thumbnail
+* endpoints in the vendored OpenAPI schema.
+*/
+const THUMBNAILS_REQUIRED_SCOPES = Object.freeze(["legacy-universe:manage"]);
+//#endregion
+//#region src/domains/game-internationalization/game-thumbnails/parsers.ts
+/**
+* Parses a successful thumbnail-upload response into the public
+* {@link UploadedExperienceThumbnail} shape, returning a {@link Result}
+* so callers can handle malformed payloads without exceptions.
+*
+* @param response - The full {@link HttpResponse} from the Open Cloud API.
+* @returns A success result wrapping the converted upload, or an
+*   `ApiError` when the body does not match the wire schema.
+*/
+function parseThumbnailUploadResponse(response) {
+	const { body, status: statusCode } = response;
+	if (!isGameThumbnailUploadWire(body)) return {
+		err: new ApiError("Malformed thumbnail upload response", { statusCode }),
+		success: false
+	};
+	return {
+		data: { mediaAssetId: body.mediaAssetId },
+		success: true
+	};
+}
+function isGameThumbnailUploadWire(body) {
+	if (!isRecord(body)) return false;
+	return typeof body["mediaAssetId"] === "string";
+}
+//#endregion
+//#region src/resources/universes/client.ts
+const GET_SPEC = Object.freeze({
+	buildRequest: buildGetRequest,
+	methodDefaults: {},
+	methodKind: "idempotent",
+	operationLimit: GET_OPERATION_LIMIT,
+	parse: parseUniverseResponse
+});
+const UPDATE_SPEC = Object.freeze({
+	buildRequest: buildUpdateRequest,
+	methodDefaults: {},
+	methodKind: "idempotent",
+	operationLimit: UPDATE_OPERATION_LIMIT,
+	parse: parseUniverseResponse,
+	requiredScopes: UPDATE_REQUIRED_SCOPES
+});
+function buildIconUploadOkRequest(parameters) {
+	return okRequest(buildUploadIconRequest(parameters));
+}
+function buildIconDeleteOkRequest(parameters) {
+	return okRequest(buildDeleteIconRequest(parameters));
+}
+function buildIconListOkRequest(parameters) {
+	return okRequest(buildListIconsRequest(parameters));
+}
+const ICON_UPLOAD_SPEC = Object.freeze({
+	buildRequest: buildIconUploadOkRequest,
+	methodDefaults: CREATE_METHOD_DEFAULTS,
+	methodKind: "create",
+	operationLimit: ICON_OPERATION_LIMIT,
+	parse: parseEmptyResponse,
+	requiredScopes: ICON_REQUIRED_SCOPES
+});
+const ICON_DELETE_SPEC = Object.freeze({
+	buildRequest: buildIconDeleteOkRequest,
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: ICON_OPERATION_LIMIT,
+	parse: parseEmptyResponse,
+	requiredScopes: ICON_REQUIRED_SCOPES
+});
+const ICON_LIST_SPEC = Object.freeze({
+	buildRequest: buildIconListOkRequest,
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: ICON_OPERATION_LIMIT,
+	parse: parseIconListResponse,
+	requiredScopes: ICON_REQUIRED_SCOPES
+});
+function buildThumbnailUploadOkRequest(parameters) {
+	return okRequest(buildUploadThumbnailRequest(parameters));
+}
+function buildThumbnailDeleteOkRequest(parameters) {
+	return okRequest(buildDeleteThumbnailRequest(parameters));
+}
+const THUMBNAIL_UPLOAD_SPEC = Object.freeze({
+	buildRequest: buildThumbnailUploadOkRequest,
+	methodDefaults: CREATE_METHOD_DEFAULTS,
+	methodKind: "create",
+	operationLimit: THUMBNAILS_OPERATION_LIMIT,
+	parse: parseThumbnailUploadResponse,
+	requiredScopes: THUMBNAILS_REQUIRED_SCOPES
+});
+const THUMBNAIL_DELETE_SPEC = Object.freeze({
+	buildRequest: buildThumbnailDeleteOkRequest,
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: THUMBNAILS_OPERATION_LIMIT,
+	parse: parseEmptyResponse,
+	requiredScopes: THUMBNAILS_REQUIRED_SCOPES
+});
+const THUMBNAIL_REORDER_SPEC = Object.freeze({
+	buildRequest: buildReorderThumbnailsRequest,
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: THUMBNAILS_OPERATION_LIMIT,
+	parse: parseEmptyResponse,
+	requiredScopes: THUMBNAILS_REQUIRED_SCOPES
+});
+/**
+* Public client for the Roblox Open Cloud `Universe` resource. Wires
+* the request builders, the injected
+* {@link OpenCloudClientOptions.httpClient}, and the response parser
+* into a single ergonomic surface. Every method returns a
+* {@link Result} so callers handle failure explicitly; no thrown
+* {@link OpenCloudError} ever escapes the client.
+*
+* Partial updates use a Google-style `updateMask` query string derived
+* from the keys present on the update parameters. Setting a clearable
+* field (`privateServerPriceRobux` or any social link) to `undefined`
+* sends JSON `null` for that field so the server clears the
+* corresponding value.
+*
+* Localized experience-icon and experience-thumbnail Operations are
+* bound on the {@link UniversesClient.icon} and
+* {@link UniversesClient.thumbnails} Operation Groups so callers reach
+* for one client per universe.
+*
+* @example
+*
+* ```ts
+* import { UniversesClient } from "@bedrock-rbx/ocale/universes";
+*
+* const client = new UniversesClient({ apiKey: "your-key" });
+* expect(client).toBeInstanceOf(UniversesClient);
+* ```
+*/
+var UniversesClient = class {
+	#inner;
+	/**
+	* Operation Group exposing the localized experience-icon
+	* Operations (`upload`, `delete`, `list`) backed by the
+	* `legacy-game-internationalization` domain. Shares the parent
+	* client's HTTP, rate-limit, and retry plumbing.
+	*/
+	icon;
+	/**
+	* Operation Group exposing the localized experience-thumbnail
+	* Operations (`upload`, `delete`, `reorder`) backed by the
+	* `legacy-game-internationalization` domain. No list-thumbnails
+	* endpoint is bridged; consumers must track uploaded
+	* `mediaAssetId`s in their own state store to reconcile against
+	* the existing carousel. Shares the parent client's HTTP,
+	* rate-limit, and retry plumbing.
+	*/
+	thumbnails;
+	/**
+	* Creates a new {@link UniversesClient}. 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.icon = createIconHandle(this.#inner);
+		this.thumbnails = createThumbnailsHandle(this.#inner);
+	}
+	/**
+	* Fetches the current configuration of a universe.
+	*
+	* @param parameters - The universe identifier.
+	* @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 Universe}
+	*   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 a universe's configuration. The fields
+	* supplied on `parameters` (excluding `universeId`) are forwarded
+	* to the server via a Google-style `updateMask`; unmentioned
+	* fields are left untouched.
+	*
+	* @param parameters - The universe identifier and the fields to
+	*   update. At least one updatable field must be supplied.
+	* @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 Universe}
+	*   or the {@link OpenCloudError} that caused the request to fail.
+	*/
+	async update(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: UPDATE_SPEC
+		});
+	}
+};
+function createIconHandle(inner) {
+	return {
+		async delete(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: ICON_DELETE_SPEC
+			});
+		},
+		async list(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: ICON_LIST_SPEC
+			});
+		},
+		async upload(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: ICON_UPLOAD_SPEC
+			});
+		}
+	};
+}
+function createThumbnailsHandle(inner) {
+	return {
+		async delete(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: THUMBNAIL_DELETE_SPEC
+			});
+		},
+		async reorder(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: THUMBNAIL_REORDER_SPEC
+			});
+		},
+		async upload(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: THUMBNAIL_UPLOAD_SPEC
+			});
+		}
+	};
+}
+//#endregion
+export { UniversesClient };
+
+//# sourceMappingURL=universes.mjs.map