@bedrock-rbx/ocale 0.1.0-beta.13 → 0.1.0-beta.15

package/dist/retry-BzX29aw_.mjs

@@ -0,0 +1,333 @@
+import { n as NetworkError, r as ApiError, t as RateLimitError } from "./rate-limit-nY4BF079.mjs";
+//#region src/errors/permission-error.ts
+/**
+* Thrown when the Roblox Open Cloud API returns a 401 or 403 for an operation
+* whose required scopes are known. Subclass of {@link ApiError} carrying the
+* scope strings the caller's credential is missing plus the operation key, so
+* a CLI consumer can tell the user exactly which scope to grant on their API
+* key.
+*
+* @example
+*
+* ```ts
+* import { PermissionError } from "@bedrock-rbx/ocale";
+*
+* const error = new PermissionError("HTTP 403", {
+*     operationKey: "developer-products.create",
+*     requiredScopes: ["creator-store-product:write"],
+*     statusCode: 403,
+* });
+*
+* expect(error).toBeInstanceOf(PermissionError);
+* expect(error.requiredScopes).toStrictEqual(["creator-store-product:write"]);
+* expect(error.operationKey).toBe("developer-products.create");
+* ```
+*/
+var PermissionError = class extends ApiError {
+	name = "PermissionError";
+	operationKey;
+	requiredScopes;
+	/**
+	* Creates a new PermissionError.
+	*
+	* @param message - Human-readable error description.
+	* @param options - Error options including status code, the operation key,
+	*   and the scopes the caller's credential must carry.
+	*/
+	constructor(message, options) {
+		super(message, options);
+		this.operationKey = options.operationKey;
+		this.requiredScopes = options.requiredScopes;
+	}
+};
+//#endregion
+//#region src/internal/utils/find-error-code.ts
+/**
+* Maximum cause-chain depth walked by {@link findErrorCode}. Caps pathological
+* self-referential or deeply nested chains; transport failures surface as
+* `NetworkError → TypeError("fetch failed") → OS Error{code}`, so three
+* levels is the expected shape and five leaves headroom.
+*/
+const MAX_DEPTH = 5;
+/**
+* Walks an error's `cause` chain and returns the first node-style string
+* `code` it finds (for example `"ECONNRESET"`, `"ETIMEDOUT"`). Native `fetch`
+* surfaces a transport reset as a `NetworkError` wrapping a
+* `TypeError("fetch failed")` whose own cause carries the OS-level `code`, so
+* the code lives several links down the chain.
+*
+* @example
+*
+* ```ts
+* import { findErrorCode } from "./find-error-code";
+*
+* const root = Object.assign(new Error("read ECONNRESET"), { code: "ECONNRESET" });
+* const outer = new Error("Network request failed", {
+*     cause: new TypeError("fetch failed", { cause: root }),
+* });
+*
+* expect(findErrorCode(outer)).toBe("ECONNRESET");
+* ```
+*
+* @param error - The error to inspect; typically a `NetworkError`.
+* @returns The first string `code` in the chain, or `undefined` if none.
+*/
+function findErrorCode(error) {
+	let current = error;
+	for (let depth = 0; depth < MAX_DEPTH && current instanceof Error; depth += 1) {
+		const code = readCode(current);
+		if (code !== void 0) return code;
+		current = current.cause;
+	}
+}
+function readCode(error) {
+	const code = Reflect.get(error, "code");
+	return typeof code === "string" ? code : void 0;
+}
+//#endregion
+//#region src/internal/http/retry.ts
+/**
+* Transient transport error codes that are safe to retry for idempotent
+* operations. Connection resets, timeouts, and DNS hiccups are recoverable on
+* a retry; a self-aborted request timeout carries no `code` and so is excluded
+* by construction.
+*/
+const TRANSIENT_TRANSPORT_CODES = Object.freeze([
+	"ECONNRESET",
+	"ECONNREFUSED",
+	"ETIMEDOUT",
+	"EPIPE",
+	"ENETUNREACH",
+	"EHOSTDOWN",
+	"EAI_AGAIN",
+	"UND_ERR_SOCKET"
+]);
+/**
+* Default retry policy for idempotent operations (read, list, update,
+* delete). Safe to retry on rate limits, transient server errors, and
+* transient transport failures.
+*/
+const IDEMPOTENT_METHOD_DEFAULTS = Object.freeze({
+	retryableStatuses: Object.freeze([
+		429,
+		500,
+		502,
+		503,
+		504
+	]),
+	retryableTransportCodes: TRANSIENT_TRANSPORT_CODES
+});
+/**
+* Default retry policy for create operations. Retries rate limits only (no
+* 5xx and no transport-error retries) to prevent duplicate resources, since
+* Roblox Open Cloud has no idempotency-key support. Consumers who can tolerate
+* a duplicate opt in per request.
+*/
+const CREATE_METHOD_DEFAULTS = Object.freeze({
+	retryableStatuses: Object.freeze([429]),
+	retryableTransportCodes: Object.freeze([])
+});
+/**
+* Default exponential backoff: 1s → 2s → 4s → 8s → 16s → 30s (capped).
+*
+* @example
+*
+* ```ts
+* import { defaultRetryDelay } from "./retry";
+*
+* expect(defaultRetryDelay(0)).toBe(1000);
+* expect(defaultRetryDelay(4)).toBe(16_000);
+* expect(defaultRetryDelay(10)).toBe(30_000);
+* ```
+*
+* @param attempt - Zero-indexed retry attempt number.
+* @returns Wait duration in milliseconds.
+*/
+function defaultRetryDelay(attempt) {
+	return Math.min(1e3 * 2 ** attempt, 3e4);
+}
+/**
+* Computes how long to wait before the next retry. Prefers the server's
+* suggested delay when the error is a {@link RateLimitError} with a positive
+* `retryAfterSeconds`; otherwise falls through to `retryDelay(attempt)`.
+*
+* @example
+*
+* ```ts
+* import { RateLimitError } from "../../errors/rate-limit.ts";
+* import { computeRetryWaitMs, defaultRetryDelay } from "./retry";
+*
+* const error = new RateLimitError("slow down", { retryAfterSeconds: 3 });
+*
+* expect(computeRetryWaitMs(error, { attempt: 0, retryDelay: defaultRetryDelay })).toBe(
+*     3000,
+* );
+* ```
+*
+* @example
+*
+* ```ts
+* import { ApiError } from "../../errors/api-error.ts";
+* import { computeRetryWaitMs, defaultRetryDelay } from "./retry";
+*
+* const error = new ApiError("server error", { statusCode: 503 });
+*
+* expect(computeRetryWaitMs(error, { attempt: 2, retryDelay: defaultRetryDelay })).toBe(
+*     4000,
+* );
+* ```
+*
+* @param error - The error returned by the failing request.
+* @param options - Retry attempt index and fallback delay function.
+* @returns Wait duration in milliseconds before the next attempt.
+*/
+function computeRetryWaitMs(error, options) {
+	if (error instanceof RateLimitError && error.retryAfterSeconds > 0) return error.retryAfterSeconds * 1e3;
+	return options.retryDelay(options.attempt);
+}
+/**
+* Decides whether a failed request is eligible for retry. {@link RateLimitError}
+* (checked against 429) and {@link ApiError} (checked against its `statusCode`)
+* are retryable when their status is in `retryableStatuses`. A
+* {@link NetworkError} is retryable when its transport code
+* ({@link findErrorCode}) is in `retryableTransportCodes`. This is how
+* transient connection resets recover. All other failures return `false`.
+*
+* @example
+*
+* ```ts
+* import { RateLimitError } from "../../errors/rate-limit.ts";
+* import { shouldRetry } from "./retry";
+*
+* const error = new RateLimitError("", { retryAfterSeconds: 1 });
+*
+* expect(shouldRetry(error, { retryableStatuses: [429], retryableTransportCodes: [] })).toBe(
+*     true,
+* );
+* ```
+*
+* @example
+*
+* ```ts
+* import { NetworkError } from "../../errors/network-error.ts";
+* import { shouldRetry } from "./retry";
+*
+* const reset = Object.assign(new Error("read ECONNRESET"), { code: "ECONNRESET" });
+* const error = new NetworkError("Network request failed", { cause: reset });
+*
+* expect(
+*     shouldRetry(error, { retryableStatuses: [], retryableTransportCodes: ["ECONNRESET"] }),
+* ).toBe(true);
+* ```
+*
+* @param error - The error returned by the failing request.
+* @param config - Object carrying the retry-eligible status and transport-code lists.
+* @returns `true` if the error should be retried, `false` otherwise.
+*/
+function shouldRetry(error, config) {
+	if (error instanceof RateLimitError) return config.retryableStatuses.includes(429);
+	if (error instanceof ApiError) return config.retryableStatuses.includes(error.statusCode);
+	if (error instanceof NetworkError) {
+		const code = findErrorCode(error);
+		return code !== void 0 && config.retryableTransportCodes.includes(code);
+	}
+	return false;
+}
+/**
+* Resolves the effective config for a single request by shallow-merging the
+* client config, method defaults, and per-request options. Precedence depends
+* on `methodKind`:
+*
+* - `"create"`: method defaults override client config, so client-level
+*   settings cannot silently relax create-method safety. Only explicit
+*   per-request `requestOptions` can.
+* - `"idempotent"`: client config overrides method defaults, so consumers
+*   can loosen or tighten retry policy globally. `requestOptions` still wins
+*   when provided.
+*
+* Array-valued fields like `retryableStatuses` are *replaced*, not extended.
+*
+* @template T - Concrete `RetryResolvable` subtype being merged.
+*
+* @example
+*
+* ```ts
+* import {
+*     CREATE_METHOD_DEFAULTS,
+*     defaultRetryDelay,
+*     mergeConfig,
+*     type RetryResolvable,
+* } from "./retry";
+*
+* const clientConfig: RetryResolvable = {
+*     apiKey: "k",
+*     baseUrl: "https://apis.roblox.com",
+*     maxRetries: 3,
+*     retryableStatuses: [429, 500],
+*     retryableTransportCodes: [],
+*     retryDelay: defaultRetryDelay,
+*     timeout: 30_000,
+* };
+*
+* const merged = mergeConfig(clientConfig, {
+*     methodDefaults: CREATE_METHOD_DEFAULTS,
+*     methodKind: "create",
+* });
+*
+* expect(merged.retryableStatuses).toStrictEqual([429]);
+* ```
+*
+* @example
+*
+* ```ts
+* import {
+*     defaultRetryDelay,
+*     IDEMPOTENT_METHOD_DEFAULTS,
+*     mergeConfig,
+*     type RetryResolvable,
+* } from "./retry";
+*
+* const clientConfig: RetryResolvable = {
+*     apiKey: "k",
+*     baseUrl: "https://apis.roblox.com",
+*     maxRetries: 3,
+*     retryableStatuses: [429],
+*     retryableTransportCodes: [],
+*     retryDelay: defaultRetryDelay,
+*     timeout: 30_000,
+* };
+*
+* const merged = mergeConfig(clientConfig, {
+*     methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+*     methodKind: "idempotent",
+*     requestOptions: { timeout: 10_000 },
+* });
+*
+* expect(merged.retryableStatuses).toStrictEqual([429]);
+* expect(merged.timeout).toBe(10_000);
+* ```
+*
+* @param clientConfig - Config frozen at client construction.
+* @param options - Method defaults, method kind, and optional per-request overrides.
+* @returns A new merged config object. Inputs are not mutated.
+*/
+function mergeConfig(clientConfig, options) {
+	const { methodDefaults, methodKind, requestOptions } = options;
+	switch (methodKind) {
+		case "create": return {
+			...clientConfig,
+			...methodDefaults,
+			...requestOptions
+		};
+		case "idempotent": return {
+			...methodDefaults,
+			...clientConfig,
+			...requestOptions
+		};
+		default: throw new Error(`Unexpected methodKind: ${String(methodKind)}`);
+	}
+}
+//#endregion
+export { defaultRetryDelay as a, findErrorCode as c, computeRetryWaitMs as i, PermissionError as l, IDEMPOTENT_METHOD_DEFAULTS as n, mergeConfig as o, TRANSIENT_TRANSPORT_CODES as r, shouldRetry as s, CREATE_METHOD_DEFAULTS as t };
+
+//# sourceMappingURL=retry-BzX29aw_.mjs.map

package/dist/retry-BzX29aw_.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-BzX29aw_.mjs","names":[],"sources":["../src/errors/permission-error.ts","../src/internal/utils/find-error-code.ts","../src/internal/http/retry.ts"],"sourcesContent":["import { ApiError, type ApiErrorOptions } from \"./api-error.ts\";\n\n/**\n * Options for constructing a {@link PermissionError}.\n */\nexport interface PermissionErrorOptions extends ApiErrorOptions {\n\t/**\n\t * Stable identifier of the Open Cloud operation that returned the\n\t * permission failure (matches `OperationLimit.operationKey`, e.g.\n\t * `\"developer-products.create\"`).\n\t */\n\toperationKey: string;\n\t/**\n\t * Scope strings the API key or OAuth token must carry for the failing\n\t * operation, sourced from the vendored OpenAPI schema's `x-roblox-scopes`\n\t * for that operationId.\n\t */\n\trequiredScopes: ReadonlyArray<string>;\n}\n\n/**\n * Thrown when the Roblox Open Cloud API returns a 401 or 403 for an operation\n * whose required scopes are known. Subclass of {@link ApiError} carrying the\n * scope strings the caller's credential is missing plus the operation key, so\n * a CLI consumer can tell the user exactly which scope to grant on their API\n * key.\n *\n * @example\n *\n * ```ts\n * import { PermissionError } from \"@bedrock-rbx/ocale\";\n *\n * const error = new PermissionError(\"HTTP 403\", {\n *     operationKey: \"developer-products.create\",\n *     requiredScopes: [\"creator-store-product:write\"],\n *     statusCode: 403,\n * });\n *\n * expect(error).toBeInstanceOf(PermissionError);\n * expect(error.requiredScopes).toStrictEqual([\"creator-store-product:write\"]);\n * expect(error.operationKey).toBe(\"developer-products.create\");\n * ```\n */\nexport class PermissionError extends ApiError {\n\tpublic override readonly name: string = \"PermissionError\";\n\tpublic readonly operationKey: string;\n\tpublic readonly requiredScopes: ReadonlyArray<string>;\n\n\t/**\n\t * Creates a new PermissionError.\n\t *\n\t * @param message - Human-readable error description.\n\t * @param options - Error options including status code, the operation key,\n\t *   and the scopes the caller's credential must carry.\n\t */\n\tconstructor(message: string, options: PermissionErrorOptions) {\n\t\tsuper(message, options);\n\t\tthis.operationKey = options.operationKey;\n\t\tthis.requiredScopes = options.requiredScopes;\n\t}\n}\n","/**\n * Maximum cause-chain depth walked by {@link findErrorCode}. Caps pathological\n * self-referential or deeply nested chains; transport failures surface as\n * `NetworkError → TypeError(\"fetch failed\") → OS Error{code}`, so three\n * levels is the expected shape and five leaves headroom.\n */\nconst MAX_DEPTH = 5;\n\n/**\n * Walks an error's `cause` chain and returns the first node-style string\n * `code` it finds (for example `\"ECONNRESET\"`, `\"ETIMEDOUT\"`). Native `fetch`\n * surfaces a transport reset as a `NetworkError` wrapping a\n * `TypeError(\"fetch failed\")` whose own cause carries the OS-level `code`, so\n * the code lives several links down the chain.\n *\n * @example\n *\n * ```ts\n * import { findErrorCode } from \"./find-error-code\";\n *\n * const root = Object.assign(new Error(\"read ECONNRESET\"), { code: \"ECONNRESET\" });\n * const outer = new Error(\"Network request failed\", {\n *     cause: new TypeError(\"fetch failed\", { cause: root }),\n * });\n *\n * expect(findErrorCode(outer)).toBe(\"ECONNRESET\");\n * ```\n *\n * @param error - The error to inspect; typically a `NetworkError`.\n * @returns The first string `code` in the chain, or `undefined` if none.\n */\nexport function findErrorCode(error: unknown): string | undefined {\n\tlet current: unknown = error;\n\tfor (let depth = 0; depth < MAX_DEPTH && current instanceof Error; depth += 1) {\n\t\tconst code = readCode(current);\n\t\tif (code !== undefined) {\n\t\t\treturn code;\n\t\t}\n\n\t\tcurrent = current.cause;\n\t}\n\n\treturn undefined;\n}\n\nfunction readCode(error: Error): string | undefined {\n\tconst code = Reflect.get(error, \"code\");\n\treturn typeof code === \"string\" ? code : undefined;\n}\n","import { ApiError } from \"../../errors/api-error.ts\";\nimport { NetworkError } from \"../../errors/network-error.ts\";\nimport { RateLimitError } from \"../../errors/rate-limit.ts\";\nimport { findErrorCode } from \"../utils/find-error-code.ts\";\n\n/**\n * Fully-resolved retry config shape that {@link mergeConfig} and\n * {@link shouldRetry} operate on. Fields are required because this represents\n * the post-defaulting, internal view; callers should supply every field (or\n * resolve them via a test factory / client constructor). The partial,\n * user-facing type lives on client construction options; method defaults and\n * per-request overrides use `Partial<RetryResolvable>`.\n */\nexport interface RetryResolvable {\n\t/** Roblox Open Cloud API key. */\n\treadonly apiKey: string;\n\t/** Base URL for the Open Cloud API. */\n\treadonly baseUrl: string;\n\t/** Maximum retry attempts before giving up. */\n\treadonly maxRetries: number;\n\t/** Status codes that are eligible for retry. */\n\treadonly retryableStatuses: ReadonlyArray<number>;\n\t/**\n\t * Node-style transport error codes ({@link findErrorCode}) eligible for\n\t * retry when surfaced as a {@link NetworkError}. Empty for create\n\t * operations by default; consumers opt a create in via a per-request\n\t * override.\n\t */\n\treadonly retryableTransportCodes: ReadonlyArray<string>;\n\t/** Fallback delay function when no server hint is available. */\n\treadonly retryDelay: (attempt: number) => number;\n\t/** Per-request timeout in milliseconds. */\n\treadonly timeout: number;\n}\n\n/**\n * Transient transport error codes that are safe to retry for idempotent\n * operations. Connection resets, timeouts, and DNS hiccups are recoverable on\n * a retry; a self-aborted request timeout carries no `code` and so is excluded\n * by construction.\n */\nexport const TRANSIENT_TRANSPORT_CODES: ReadonlyArray<string> = Object.freeze([\n\t\"ECONNRESET\",\n\t\"ECONNREFUSED\",\n\t\"ETIMEDOUT\",\n\t\"EPIPE\",\n\t\"ENETUNREACH\",\n\t\"EHOSTDOWN\",\n\t\"EAI_AGAIN\",\n\t\"UND_ERR_SOCKET\",\n]);\n\n/** Method-level retry defaults, keyed by {@link MethodKind}. */\ntype MethodDefaults = Readonly<\n\tPick<RetryResolvable, \"retryableStatuses\" | \"retryableTransportCodes\">\n>;\n\n/**\n * Default retry policy for idempotent operations (read, list, update,\n * delete). Safe to retry on rate limits, transient server errors, and\n * transient transport failures.\n */\nexport const IDEMPOTENT_METHOD_DEFAULTS: MethodDefaults = Object.freeze({\n\tretryableStatuses: Object.freeze([429, 500, 502, 503, 504] as const),\n\tretryableTransportCodes: TRANSIENT_TRANSPORT_CODES,\n});\n\n/**\n * Default retry policy for create operations. Retries rate limits only (no\n * 5xx and no transport-error retries) to prevent duplicate resources, since\n * Roblox Open Cloud has no idempotency-key support. Consumers who can tolerate\n * a duplicate opt in per request.\n */\nexport const CREATE_METHOD_DEFAULTS: MethodDefaults = Object.freeze({\n\tretryableStatuses: Object.freeze([429] as const),\n\tretryableTransportCodes: Object.freeze([] as const),\n});\n\n/** Kind of HTTP method the merge is being performed for. */\nexport type MethodKind = \"create\" | \"idempotent\";\n\n/**\n * Options for {@link mergeConfig}.\n *\n * @template T - Concrete `RetryResolvable` subtype being merged.\n */\ninterface MergeConfigOptions<T> {\n\t/** Method-level defaults (e.g. {@link CREATE_METHOD_DEFAULTS}). */\n\treadonly methodDefaults: Partial<T>;\n\t/** Whether the method is a create or idempotent operation. */\n\treadonly methodKind: MethodKind;\n\t/** Optional per-request overrides; always win when provided. */\n\treadonly requestOptions?: Partial<T>;\n}\n\n/**\n * Options for {@link computeRetryWaitMs}.\n */\ninterface ComputeRetryWaitMsOptions {\n\t/** Zero-indexed retry attempt number. */\n\treadonly attempt: number;\n\t/** Fallback delay function when no server hint is available. */\n\treadonly retryDelay: (attempt: number) => number;\n}\n\n/**\n * Default exponential backoff: 1s → 2s → 4s → 8s → 16s → 30s (capped).\n *\n * @example\n *\n * ```ts\n * import { defaultRetryDelay } from \"./retry\";\n *\n * expect(defaultRetryDelay(0)).toBe(1000);\n * expect(defaultRetryDelay(4)).toBe(16_000);\n * expect(defaultRetryDelay(10)).toBe(30_000);\n * ```\n *\n * @param attempt - Zero-indexed retry attempt number.\n * @returns Wait duration in milliseconds.\n */\nexport function defaultRetryDelay(attempt: number): number {\n\treturn Math.min(1000 * 2 ** attempt, 30_000);\n}\n\n/**\n * Computes how long to wait before the next retry. Prefers the server's\n * suggested delay when the error is a {@link RateLimitError} with a positive\n * `retryAfterSeconds`; otherwise falls through to `retryDelay(attempt)`.\n *\n * @example\n *\n * ```ts\n * import { RateLimitError } from \"../../errors/rate-limit.ts\";\n * import { computeRetryWaitMs, defaultRetryDelay } from \"./retry\";\n *\n * const error = new RateLimitError(\"slow down\", { retryAfterSeconds: 3 });\n *\n * expect(computeRetryWaitMs(error, { attempt: 0, retryDelay: defaultRetryDelay })).toBe(\n *     3000,\n * );\n * ```\n *\n * @example\n *\n * ```ts\n * import { ApiError } from \"../../errors/api-error.ts\";\n * import { computeRetryWaitMs, defaultRetryDelay } from \"./retry\";\n *\n * const error = new ApiError(\"server error\", { statusCode: 503 });\n *\n * expect(computeRetryWaitMs(error, { attempt: 2, retryDelay: defaultRetryDelay })).toBe(\n *     4000,\n * );\n * ```\n *\n * @param error - The error returned by the failing request.\n * @param options - Retry attempt index and fallback delay function.\n * @returns Wait duration in milliseconds before the next attempt.\n */\nexport function computeRetryWaitMs(\n\terror: ApiError | NetworkError | RateLimitError,\n\toptions: ComputeRetryWaitMsOptions,\n): number {\n\tif (error instanceof RateLimitError && error.retryAfterSeconds > 0) {\n\t\treturn error.retryAfterSeconds * 1000;\n\t}\n\n\treturn options.retryDelay(options.attempt);\n}\n\n/**\n * Decides whether a failed request is eligible for retry. {@link RateLimitError}\n * (checked against 429) and {@link ApiError} (checked against its `statusCode`)\n * are retryable when their status is in `retryableStatuses`. A\n * {@link NetworkError} is retryable when its transport code\n * ({@link findErrorCode}) is in `retryableTransportCodes`. This is how\n * transient connection resets recover. All other failures return `false`.\n *\n * @example\n *\n * ```ts\n * import { RateLimitError } from \"../../errors/rate-limit.ts\";\n * import { shouldRetry } from \"./retry\";\n *\n * const error = new RateLimitError(\"\", { retryAfterSeconds: 1 });\n *\n * expect(shouldRetry(error, { retryableStatuses: [429], retryableTransportCodes: [] })).toBe(\n *     true,\n * );\n * ```\n *\n * @example\n *\n * ```ts\n * import { NetworkError } from \"../../errors/network-error.ts\";\n * import { shouldRetry } from \"./retry\";\n *\n * const reset = Object.assign(new Error(\"read ECONNRESET\"), { code: \"ECONNRESET\" });\n * const error = new NetworkError(\"Network request failed\", { cause: reset });\n *\n * expect(\n *     shouldRetry(error, { retryableStatuses: [], retryableTransportCodes: [\"ECONNRESET\"] }),\n * ).toBe(true);\n * ```\n *\n * @param error - The error returned by the failing request.\n * @param config - Object carrying the retry-eligible status and transport-code lists.\n * @returns `true` if the error should be retried, `false` otherwise.\n */\nexport function shouldRetry(\n\terror: unknown,\n\tconfig: {\n\t\treadonly retryableStatuses: ReadonlyArray<number>;\n\t\treadonly retryableTransportCodes: ReadonlyArray<string>;\n\t},\n): error is ApiError | NetworkError | RateLimitError {\n\tif (error instanceof RateLimitError) {\n\t\treturn config.retryableStatuses.includes(429);\n\t}\n\n\tif (error instanceof ApiError) {\n\t\treturn config.retryableStatuses.includes(error.statusCode);\n\t}\n\n\tif (error instanceof NetworkError) {\n\t\tconst code = findErrorCode(error);\n\t\treturn code !== undefined && config.retryableTransportCodes.includes(code);\n\t}\n\n\treturn false;\n}\n\n/**\n * Resolves the effective config for a single request by shallow-merging the\n * client config, method defaults, and per-request options. Precedence depends\n * on `methodKind`:\n *\n * - `\"create\"`: method defaults override client config, so client-level\n *   settings cannot silently relax create-method safety. Only explicit\n *   per-request `requestOptions` can.\n * - `\"idempotent\"`: client config overrides method defaults, so consumers\n *   can loosen or tighten retry policy globally. `requestOptions` still wins\n *   when provided.\n *\n * Array-valued fields like `retryableStatuses` are *replaced*, not extended.\n *\n * @template T - Concrete `RetryResolvable` subtype being merged.\n *\n * @example\n *\n * ```ts\n * import {\n *     CREATE_METHOD_DEFAULTS,\n *     defaultRetryDelay,\n *     mergeConfig,\n *     type RetryResolvable,\n * } from \"./retry\";\n *\n * const clientConfig: RetryResolvable = {\n *     apiKey: \"k\",\n *     baseUrl: \"https://apis.roblox.com\",\n *     maxRetries: 3,\n *     retryableStatuses: [429, 500],\n *     retryableTransportCodes: [],\n *     retryDelay: defaultRetryDelay,\n *     timeout: 30_000,\n * };\n *\n * const merged = mergeConfig(clientConfig, {\n *     methodDefaults: CREATE_METHOD_DEFAULTS,\n *     methodKind: \"create\",\n * });\n *\n * expect(merged.retryableStatuses).toStrictEqual([429]);\n * ```\n *\n * @example\n *\n * ```ts\n * import {\n *     defaultRetryDelay,\n *     IDEMPOTENT_METHOD_DEFAULTS,\n *     mergeConfig,\n *     type RetryResolvable,\n * } from \"./retry\";\n *\n * const clientConfig: RetryResolvable = {\n *     apiKey: \"k\",\n *     baseUrl: \"https://apis.roblox.com\",\n *     maxRetries: 3,\n *     retryableStatuses: [429],\n *     retryableTransportCodes: [],\n *     retryDelay: defaultRetryDelay,\n *     timeout: 30_000,\n * };\n *\n * const merged = mergeConfig(clientConfig, {\n *     methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,\n *     methodKind: \"idempotent\",\n *     requestOptions: { timeout: 10_000 },\n * });\n *\n * expect(merged.retryableStatuses).toStrictEqual([429]);\n * expect(merged.timeout).toBe(10_000);\n * ```\n *\n * @param clientConfig - Config frozen at client construction.\n * @param options - Method defaults, method kind, and optional per-request overrides.\n * @returns A new merged config object. Inputs are not mutated.\n */\nexport function mergeConfig<T extends RetryResolvable>(\n\tclientConfig: T,\n\toptions: MergeConfigOptions<T>,\n): T {\n\tconst { methodDefaults, methodKind, requestOptions } = options;\n\n\tswitch (methodKind) {\n\t\tcase \"create\": {\n\t\t\treturn { ...clientConfig, ...methodDefaults, ...requestOptions };\n\t\t}\n\t\tcase \"idempotent\": {\n\t\t\treturn { ...methodDefaults, ...clientConfig, ...requestOptions };\n\t\t}\n\t\tdefault: {\n\t\t\tconst exhaustive: never = methodKind;\n\t\t\tthrow new Error(`Unexpected methodKind: ${String(exhaustive)}`);\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,IAAa,kBAAb,cAAqC,SAAS;CAC7C,OAAwC;CACxC;CACA;;;;;;;;CASA,YAAY,SAAiB,SAAiC;AAC7D,QAAM,SAAS,QAAQ;AACvB,OAAK,eAAe,QAAQ;AAC5B,OAAK,iBAAiB,QAAQ;;;;;;;;;;;ACpDhC,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;AAyBlB,SAAgB,cAAc,OAAoC;CACjE,IAAI,UAAmB;AACvB,MAAK,IAAI,QAAQ,GAAG,QAAQ,aAAa,mBAAmB,OAAO,SAAS,GAAG;EAC9E,MAAM,OAAO,SAAS,QAAQ;AAC9B,MAAI,SAAS,KAAA,EACZ,QAAO;AAGR,YAAU,QAAQ;;;AAMpB,SAAS,SAAS,OAAkC;CACnD,MAAM,OAAO,QAAQ,IAAI,OAAO,OAAO;AACvC,QAAO,OAAO,SAAS,WAAW,OAAO,KAAA;;;;;;;;;;ACN1C,MAAa,4BAAmD,OAAO,OAAO;CAC7E;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAC;;;;;;AAYF,MAAa,6BAA6C,OAAO,OAAO;CACvE,mBAAmB,OAAO,OAAO;EAAC;EAAK;EAAK;EAAK;EAAK;EAAI,CAAU;CACpE,yBAAyB;CACzB,CAAC;;;;;;;AAQF,MAAa,yBAAyC,OAAO,OAAO;CACnE,mBAAmB,OAAO,OAAO,CAAC,IAAI,CAAU;CAChD,yBAAyB,OAAO,OAAO,EAAE,CAAU;CACnD,CAAC;;;;;;;;;;;;;;;;;AA6CF,SAAgB,kBAAkB,SAAyB;AAC1D,QAAO,KAAK,IAAI,MAAO,KAAK,SAAS,IAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsC7C,SAAgB,mBACf,OACA,SACS;AACT,KAAI,iBAAiB,kBAAkB,MAAM,oBAAoB,EAChE,QAAO,MAAM,oBAAoB;AAGlC,QAAO,QAAQ,WAAW,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0C3C,SAAgB,YACf,OACA,QAIoD;AACpD,KAAI,iBAAiB,eACpB,QAAO,OAAO,kBAAkB,SAAS,IAAI;AAG9C,KAAI,iBAAiB,SACpB,QAAO,OAAO,kBAAkB,SAAS,MAAM,WAAW;AAG3D,KAAI,iBAAiB,cAAc;EAClC,MAAM,OAAO,cAAc,MAAM;AACjC,SAAO,SAAS,KAAA,KAAa,OAAO,wBAAwB,SAAS,KAAK;;AAG3E,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiFR,SAAgB,YACf,cACA,SACI;CACJ,MAAM,EAAE,gBAAgB,YAAY,mBAAmB;AAEvD,SAAQ,YAAR;EACC,KAAK,SACJ,QAAO;GAAE,GAAG;GAAc,GAAG;GAAgB,GAAG;GAAgB;EAEjE,KAAK,aACJ,QAAO;GAAE,GAAG;GAAgB,GAAG;GAAc,GAAG;GAAgB;EAEjE,QAEC,OAAM,IAAI,MAAM,0BAA0B,OADhB,WACkC,GAAG"}

package/dist/retry-CXnj3gXI.d.mts

@@ -0,0 +1,163 @@
+import { d as OpenCloudError } from "./types-rzs1NB-j.mjs";
+
+//#region src/errors/api-error.d.ts
+/**
+* Options for constructing an {@link ApiError}.
+*/
+interface ApiErrorOptions extends ErrorOptions {
+  /** Optional machine-readable error code from the API. */
+  code?: string | undefined;
+  /** Parsed response body, when present. */
+  details?: JSONValue | undefined;
+  /** HTTP status code from the API response. */
+  statusCode: number;
+}
+/**
+* Thrown when the Roblox Open Cloud API returns a non-2xx response
+* that is not a rate limit (429).
+*
+* @example
+*
+* ```ts
+* import { ApiError } from "@bedrock-rbx/ocale";
+*
+* const error = new ApiError("HTTP 404: Pass not found (code NotFound)", {
+*     code: "NotFound",
+*     details: { errorCode: "NotFound", message: "Pass not found" },
+*     statusCode: 404,
+* });
+*
+* expect(error).toBeInstanceOf(ApiError);
+* expect(error.statusCode).toBe(404);
+* expect(error.code).toBe("NotFound");
+* expect(error.details).toEqual({
+*     errorCode: "NotFound",
+*     message: "Pass not found",
+* });
+* ```
+*/
+declare class ApiError extends OpenCloudError {
+  readonly code: string | undefined;
+  readonly details: JSONValue | undefined;
+  override readonly name: string;
+  readonly statusCode: number;
+  /**
+  * Creates a new ApiError.
+  *
+  * @param message - Human-readable error description.
+  * @param options - Error options including status code, optional error
+  *   code, and the parsed response body when present.
+  */
+  constructor(message: string, options: ApiErrorOptions);
+}
+//#endregion
+//#region src/errors/network-error.d.ts
+/**
+* Options for constructing a {@link NetworkError}.
+*/
+interface NetworkErrorOptions extends ErrorOptions {
+  /** HTTP method of the request that failed. */
+  method?: string | undefined;
+  /** Fully-qualified URL of the request that failed. */
+  url?: string | undefined;
+}
+/**
+* Thrown when a network-level failure prevents the request from reaching
+* the Roblox Open Cloud API (e.g., DNS resolution failure, connection reset).
+* The `method` and `url` name the failing call so a transport failure that
+* survives every retry can be diagnosed; the underlying transport error is
+* carried on `cause`.
+*/
+declare class NetworkError extends OpenCloudError {
+  readonly method: string | undefined;
+  override readonly name: string;
+  readonly url: string | undefined;
+  /**
+  * Creates a new NetworkError.
+  *
+  * @param message - Human-readable error description.
+  * @param options - Error options including the optional `cause` and the
+  *   `method` / `url` of the request that failed.
+  */
+  constructor(message: string, options?: NetworkErrorOptions);
+}
+//#endregion
+//#region src/errors/rate-limit.d.ts
+/**
+* Options for constructing a {@link RateLimitError}.
+*/
+interface RateLimitErrorOptions extends ErrorOptions {
+  /** Seconds to wait before retrying the request. */
+  retryAfterSeconds: number;
+}
+/**
+* Thrown when the Roblox Open Cloud API returns a 429 Too Many Requests response.
+* Contains the server-suggested retry delay.
+*
+* @example
+*
+* ```ts
+* import { RateLimitError } from "@bedrock-rbx/ocale";
+*
+* const error = new RateLimitError("Too many requests", {
+*     retryAfterSeconds: 30,
+* });
+*
+* expect(error).toBeInstanceOf(RateLimitError);
+* expect(error.retryAfterSeconds).toBe(30);
+* ```
+*/
+declare class RateLimitError extends OpenCloudError {
+  override readonly name = "RateLimitError";
+  readonly retryAfterSeconds: number;
+  /**
+  * Creates a new RateLimitError.
+  *
+  * @param message - Human-readable error description.
+  * @param options - Error options including the retry delay.
+  */
+  constructor(message: string, options: RateLimitErrorOptions);
+}
+//#endregion
+//#region src/internal/http/retry.d.ts
+/**
+* Fully-resolved retry config shape that {@link mergeConfig} and
+* {@link shouldRetry} operate on. Fields are required because this represents
+* the post-defaulting, internal view; callers should supply every field (or
+* resolve them via a test factory / client constructor). The partial,
+* user-facing type lives on client construction options; method defaults and
+* per-request overrides use `Partial<RetryResolvable>`.
+*/
+interface RetryResolvable {
+  /** Roblox Open Cloud API key. */
+  readonly apiKey: string;
+  /** Base URL for the Open Cloud API. */
+  readonly baseUrl: string;
+  /** Maximum retry attempts before giving up. */
+  readonly maxRetries: number;
+  /** Status codes that are eligible for retry. */
+  readonly retryableStatuses: ReadonlyArray<number>;
+  /**
+  * Node-style transport error codes ({@link findErrorCode}) eligible for
+  * retry when surfaced as a {@link NetworkError}. Empty for create
+  * operations by default; consumers opt a create in via a per-request
+  * override.
+  */
+  readonly retryableTransportCodes: ReadonlyArray<string>;
+  /** Fallback delay function when no server hint is available. */
+  readonly retryDelay: (attempt: number) => number;
+  /** Per-request timeout in milliseconds. */
+  readonly timeout: number;
+}
+/**
+* Transient transport error codes that are safe to retry for idempotent
+* operations. Connection resets, timeouts, and DNS hiccups are recoverable on
+* a retry; a self-aborted request timeout carries no `code` and so is excluded
+* by construction.
+*/
+declare const TRANSIENT_TRANSPORT_CODES: ReadonlyArray<string>;
+/** Kind of HTTP method the merge is being performed for. */
+type MethodKind = "create" | "idempotent";
+//#endregion
+export { RateLimitErrorOptions as a, ApiError as c, RateLimitError as i, ApiErrorOptions as l, RetryResolvable as n, NetworkError as o, TRANSIENT_TRANSPORT_CODES as r, NetworkErrorOptions as s, MethodKind as t };
+//# sourceMappingURL=retry-CXnj3gXI.d.mts.map

package/dist/retry-CXnj3gXI.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-CXnj3gXI.d.mts","names":[],"sources":["../src/errors/api-error.ts","../src/errors/network-error.ts","../src/errors/rate-limit.ts","../src/internal/http/retry.ts"],"mappings":";;;;;AAKA;UAAiB,eAAA,SAAwB,YAAA;;EAExC,IAAA;;EAEA,OAAA,GAAU,SAAA;;EAEV,UAAA;AAAA;;;AA2BD;;;;;;;;;;;;;;;;;;;;;;cAAa,QAAA,SAAiB,cAAA;EAAA,SACb,IAAA;EAAA,SACA,OAAA,EAAS,SAAA;EAAA,kBACA,IAAA;EAAA,SACT,UAAA;;;;;;ACvBjB;;EDgCC,WAAA,CAAY,OAAA,UAAiB,OAAA,EAAS,eAAA;AAAA;;;;;AA9CvC;UCAiB,mBAAA,SAA4B,YAAA;;EAE5C,MAAA;;EAEA,GAAA;AAAA;;;;;AD6BD;;;cCnBa,YAAA,SAAqB,cAAA;EAAA,SACjB,MAAA;EAAA,kBACS,IAAA;EAAA,SACT,GAAA;EDgBa;;;;;;;ECP7B,WAAA,CAAY,OAAA,UAAiB,OAAA,GAAU,mBAAA;AAAA;;;;;AD1BxC;UEAiB,qBAAA,SAA8B,YAAA;;EAE9C,iBAAA;AAAA;;;;;;;AF+BD;;;;;;;;;;;cEXa,cAAA,SAAuB,cAAA;EAAA,kBACV,IAAA;EAAA,SACT,iBAAA;;;;;;;EAQhB,WAAA,CAAY,OAAA,UAAiB,OAAA,EAAS,qBAAA;AAAA;;;AFhCvC;;;;;;;;AAAA,UGQiB,eAAA;;WAEP,MAAA;EHuBV;EAAA,SGrBU,OAAA;;WAEA,UAAA;;WAEA,iBAAA,EAAmB,aAAA;;;;;;;WAOnB,uBAAA,EAAyB,aAAA;;WAEzB,UAAA,GAAa,OAAA;;WAEb,OAAA;AAAA;;;;;;AF3BV;cEoCa,yBAAA,EAA2B,aAAA;;KAsC5B,UAAA"}

package/dist/storage.d.mts

@@ -1,4 +1,5 @@
-import { d as OpenCloudError, i as OpenCloudClientOptions, l as Result, n as HttpRequest, r as HttpResponse, s as RequestOptions, u as SleepFunc } from "./types-CwtZT1ek.mjs";
+import { d as OpenCloudError, i as OpenCloudClientOptions, l as Result, n as HttpRequest, r as HttpResponse, s as RequestOptions, u as SleepFunc } from "./types-rzs1NB-j.mjs";
+import { n as RetryResolvable, t as MethodKind } from "./retry-CXnj3gXI.mjs";
 
 //#region src/domains/cloud-v2/memory-store-queues/types.d.ts
 /**
@@ -308,32 +309,6 @@ interface OperationLimit {
   readonly operationKey: string;
 }
 //#endregion
-//#region src/internal/http/retry.d.ts
-/**
-* Fully-resolved retry config shape that {@link mergeConfig} and
-* {@link shouldRetry} operate on. Fields are required because this represents
-* the post-defaulting, internal view — callers should supply every field (or
-* resolve them via a test factory / client constructor). The partial,
-* user-facing type lives on client construction options; method defaults and
-* per-request overrides use `Partial<RetryResolvable>`.
-*/
-interface RetryResolvable {
-  /** Roblox Open Cloud API key. */
-  readonly apiKey: string;
-  /** Base URL for the Open Cloud API. */
-  readonly baseUrl: string;
-  /** Maximum retry attempts before giving up. */
-  readonly maxRetries: number;
-  /** Status codes that are eligible for retry. */
-  readonly retryableStatuses: ReadonlyArray<number>;
-  /** Fallback delay function when no server hint is available. */
-  readonly retryDelay: (attempt: number) => number;
-  /** Per-request timeout in milliseconds. */
-  readonly timeout: number;
-}
-/** Kind of HTTP method the merge is being performed for. */
-type MethodKind = "create" | "idempotent";
-//#endregion
 //#region src/internal/resource-client.d.ts
 /**
 * Describes a single resource method's shape for dispatch through

package/dist/storage.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.mts","names":[],"sources":["../src/domains/cloud-v2/memory-store-queues/types.ts","../src/domains/cloud-v2/memory-store-sorted-maps/types.ts","../src/internal/http/rate-limit-queue.ts","../src/internal/http/retry.ts","../src/internal/resource-client.ts","../src/resources/storage/queues-group.ts","../src/resources/storage/sorted-maps-group.ts","../src/resources/storage/client.ts"],"mappings":"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"}
+{"version":3,"file":"storage.d.mts","names":[],"sources":["../src/domains/cloud-v2/memory-store-queues/types.ts","../src/domains/cloud-v2/memory-store-sorted-maps/types.ts","../src/internal/http/rate-limit-queue.ts","../src/internal/resource-client.ts","../src/resources/storage/queues-group.ts","../src/resources/storage/sorted-maps-group.ts","../src/resources/storage/client.ts"],"mappings":"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"}

package/dist/storage.mjs

@@ -1,5 +1,6 @@
-import { r as ApiError } from "./rate-limit-D1q2Js-z.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-nY4BF079.mjs";
+import { n as IDEMPOTENT_METHOD_DEFAULTS, t as CREATE_METHOD_DEFAULTS } from "./retry-BzX29aw_.mjs";
+import { a as isDateTimeString, i as isRecord, n as okRequest, r as parseEmptyResponse, t as ResourceClient } from "./resource-client-CG9-BG81.mjs";
 //#region src/domains/cloud-v2/memory-store-queues/builders.ts
 /**
 * Builds a `POST` request for the Open Cloud