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

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

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

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

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

package/dist/universes.d.mts

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

package/dist/universes.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"universes.d.mts","names":[],"sources":["../src/domains/cloud-v2/universes/types.ts","../src/domains/game-internationalization/game-icon/types.ts","../src/domains/game-internationalization/game-thumbnails/types.ts","../src/resources/universes/client.ts"],"mappings":"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"}
+{"version":3,"file":"universes.d.mts","names":[],"sources":["../src/domains/cloud-v2/universes/types.ts","../src/domains/game-internationalization/game-icon/types.ts","../src/domains/game-internationalization/game-thumbnails/types.ts","../src/resources/universes/client.ts"],"mappings":";;;;;;;;;;UAKiB,qBAAA;EAAA;EAAA,SAEP,UAAA;AAAA;AAAA;AAQV;;;;AARU,UAQO,UAAA;EAYjB;EAAA,SAVU,KAAA;;WAEA,GAAA;AAAA;AAqBV;;;;;AAAA,KAbY,kBAAA;;;;;;;;;;;;UAaK,wBAAA;;WAEP,cAAA;;WAEA,cAAA;;WAEA,iBAAA,GAAoB,UAAA;;WAEpB,kBAAA,GAAqB,UAAA;;WAErB,iBAAA,GAAoB,UAAA;;WAEpB,aAAA;;WAEA,uBAAA;;WAEA,qBAAA,GAAwB,UAAA;EAcJ;EAAA,SAZpB,aAAA;EAoBV;EAAA,SAlBU,gBAAA,GAAmB,UAAA;;WAEnB,iBAAA,GAAoB,UAAA;EAuBpB;EAAA,SArBA,UAAA;EA6BE;EAAA,SA3BF,gBAAA;EA2BE;EAAA,SAzBF,SAAA;EAgCV;EAAA,SA9BU,iBAAA,GAAoB,UAAA;AAAA;;;;;;UAQb,aAAA;;;;;WAKP,EAAA;;WAEA,IAAA;AAAA;;;;;;KAQE,iBAAA;;;;;;UAOK,QAAA;;WAEP,EAAA;;WAEA,SAAA,EAAW,iBAAA;;WAEX,cAAA;;WAEA,SAAA,EAAW,IAAA;;WAEX,WAAA;;WAEA,cAAA;;WAEA,iBAAA,EAAmB,UAAA;;WAEnB,WAAA;;WAEA,kBAAA,EAAoB,UAAA;;WAEpB,iBAAA,EAAmB,UAAA;;WAEnB,aAAA;;WAEA,KAAA,EAAO,aAAA;EAsBY;EAAA,SApBnB,uBAAA;;WAEA,qBAAA,EAAuB,UAAA;ECtHjC;EAAA,SDwHU,WAAA;;WAEA,aAAA;;WAEA,gBAAA,EAAkB,UAAA;;WAElB,iBAAA,EAAmB,UAAA;;WAEnB,SAAA,EAAW,IAAA;ECpHJ;EAAA,SDsHP,UAAA,EAAY,kBAAA;EC5GL;EAAA,SD8GP,gBAAA;;WAEA,SAAA;;WAEA,iBAAA,EAAmB,UAAA;AAAA;;;;;AA7I7B;;;UCKiB,cAAA;EDHP;EAAA,SCKA,OAAA;EDGO;EAAA,SCDP,QAAA;EDCO;AAIP;AAQV;;;EAZiB,SCKP,YAAA;EDOE;EAAA,SCLF,KAAA,EAAO,aAAA;AAAA;;;;;;;;UAUA,8BAAA;EDsCa;EAAA,SCpCpB,KAAA,EAAO,IAAA,GAAO,UAAA;;;;;;WAMd,YAAA,EAAc,kBAAA,GAAqB,YAAA;;WAEnC,UAAA;AAAA;;;;;;;UASO,8BAAA;;;;;;WAMP,YAAA,EAAc,kBAAA,GAAqB,YAAA;EDaf;EAAA,SCXpB,UAAA;AAAA;;;;AD0BA;AAQV;UC1BiB,6BAAA;;WAEP,UAAA;AAAA;;;;;;;ADhEV;UEEiB,2BAAA;;WAEP,YAAA;AAAA;AFMV;;;;AAIU;AAQV;;AAZA,UEIiB,mCAAA;EFQL;EAAA,SENF,KAAA,EAAO,IAAA,GAAO,UAAA;EFmBxB;;;;;EAAA,SEbU,YAAA,EAAc,kBAAA,GAAqB,YAAA;;WAEnC,UAAA;AAAA;;;;;;UAQO,mCAAA;;WAEP,OAAA;;;;;;WAMA,YAAA,EAAc,kBAAA,GAAqB,YAAA;;WAEnC,UAAA;AAAA;;;;;;;UASO,qCAAA;;;AFca;AAQ9B;;WEhBU,YAAA,EAAc,kBAAA,GAAqB,YAAA;EFgB5B;EAAA,SEdP,eAAA,EAAiB,aAAA;EF6B3B;EAAA,SE3BU,UAAA;AAAA;;;UCqGA,kBAAA;;;AHhKA;AAQV;;;;AAIU;AAQV;;;;EGyJC,MAAA,GACC,UAAA,EAAY,8BAAA,EACZ,OAAA,GAAU,cAAA,KACN,OAAA,CAAQ,MAAA,YAAkB,cAAA;EH/IhC;;;;;;;;;;EG0JC,IAAA,GACC,UAAA,EAAY,6BAAA,EACZ,OAAA,GAAU,cAAA,KACN,OAAA,CAAQ,MAAA,CAAO,aAAA,CAAc,cAAA,GAAiB,cAAA;EH/HtB;;;;;;;;;;;;;;;EG+I7B,MAAA,GACC,UAAA,EAAY,8BAAA,EACZ,OAAA,GAAU,cAAA,KACN,OAAA,CAAQ,MAAA,YAAkB,cAAA;AAAA;AAAA,UAGtB,wBAAA;;;;;;;AHrJoB;AAQ9B;;;EGwJC,MAAA,GACC,UAAA,EAAY,mCAAA,EACZ,OAAA,GAAU,cAAA,KACN,OAAA,CAAQ,MAAA,YAAkB,cAAA;EHpJtB;AAQV;;;;AAAY;AAOZ;;;;;;EGkJC,OAAA,GACC,UAAA,EAAY,qCAAA,EACZ,OAAA,GAAU,cAAA,KACN,OAAA,CAAQ,MAAA,YAAkB,cAAA;;;;;;;;;;;;;;;;;EAiB/B,MAAA,GACC,UAAA,EAAY,mCAAA,EACZ,OAAA,GAAU,cAAA,KACN,OAAA,CAAQ,MAAA,CAAO,2BAAA,EAA6B,cAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AH3HrB;;cG4JhB,eAAA;EAAA;EFpSb;;;;;;EAAA,SE6SiB,IAAA,EAAM,kBAAA;;;;AFjSN;AAUjB;;;;;WEiSiB,UAAA,EAAY,wBAAA;;;;;;;;EAS5B,WAAA,CAAY,OAAA,EAAS,sBAAA;;;;AFhSZ;AASV;;;;;EEsSC,GAAA,CACC,UAAA,EAAY,qBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,QAAA,EAAU,cAAA;;;;AFjSnB;AAQV;;;;AAEU;;;;AC9DV;ECsWC,MAAA,CACC,UAAA,EAAY,wBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,QAAA,EAAU,cAAA;AAAA"}

package/dist/universes.mjs

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