@bedrock-rbx/ocale 0.1.0-beta.1 → 0.1.0-beta.2

package/dist/specs-Co6qYp_E.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs-Co6qYp_E.mjs","names":[],"sources":["../src/domains/cloud-v2/luau-execution-tasks/builders.ts","../src/domains/cloud-v2/luau-execution-tasks/operations.ts","../src/domains/cloud-v2/luau-execution-tasks/parsers.ts","../src/domains/cloud-v2/luau-execution-tasks/specs.ts"],"sourcesContent":["import type { HttpRequest } from \"../../../client/types.ts\";\nimport { ValidationError } from \"../../../errors/validation.ts\";\nimport type { Result } from \"../../../types.ts\";\nimport type { GetParameters, SubmitAtHeadParameters, SubmitAtVersionParameters } from \"./types.ts\";\n\ninterface SubmitBodyInput {\n\treadonly script: string;\n\treadonly timeoutSeconds?: number;\n}\n\nconst JSON_HEADERS: Readonly<Record<string, string>> = { \"content-type\": \"application/json\" };\n\n/**\n * Builds a `POST` request for the Open Cloud \"create Luau execution\n * session task\" endpoint, targeting the place's head version. Serializes\n * `timeoutSeconds` into the wire's duration string format (`\"<n>s\"`)\n * when supplied.\n *\n * @param parameters - Universe and place identifiers, the script body,\n *   and an optional `timeoutSeconds`.\n * @returns A pure {@link HttpRequest} describing the submit call.\n */\nexport function buildSubmitAtHeadRequest(parameters: SubmitAtHeadParameters): HttpRequest {\n\tconst { placeId, universeId } = parameters;\n\treturn {\n\t\tbody: buildSubmitBody(parameters),\n\t\theaders: JSON_HEADERS,\n\t\tmethod: \"POST\",\n\t\turl: `/cloud/v2/universes/${universeId}/places/${placeId}/luau-execution-session-tasks`,\n\t};\n}\n\n/**\n * Builds a `POST` request for the Open Cloud \"create Luau execution\n * session task\" endpoint, targeting a specific place version. Differs\n * from {@link buildSubmitAtHeadRequest} only in URL shape: the path\n * includes the `versions/{versionId}` segment so the script runs\n * against that exact place version instead of the live head.\n *\n * @param parameters - Universe, place, and version identifiers, the\n *   script body, and an optional `timeoutSeconds`.\n * @returns A pure {@link HttpRequest} describing the submit call.\n */\nexport function buildSubmitAtVersionRequest(parameters: SubmitAtVersionParameters): HttpRequest {\n\tconst { placeId, universeId, versionId } = parameters;\n\treturn {\n\t\tbody: buildSubmitBody(parameters),\n\t\theaders: JSON_HEADERS,\n\t\tmethod: \"POST\",\n\t\turl: `/cloud/v2/universes/${universeId}/places/${placeId}/versions/${versionId}/luau-execution-session-tasks`,\n\t};\n}\n\n/**\n * Builds a `GET` request for the Open Cloud \"read Luau execution session\n * task\" endpoint. The endpoint accepts only the maximal x-aep-resource\n * path shape (universe, place, version, session, task), so the supplied\n * ref must include `versionId` and `sessionId`; refs extracted from the\n * narrower path formats are rejected with a {@link ValidationError}.\n *\n * @param parameters - Task ref and optional view selector. When `view`\n *   is omitted, no `?view=` query is sent and the server applies its\n *   own default (`BASIC`).\n * @returns A success result wrapping the request, or a\n *   {@link ValidationError} when the ref is missing `versionId` or\n *   `sessionId`.\n */\nexport function buildGetRequest(parameters: GetParameters): Result<HttpRequest, ValidationError> {\n\tconst { ref, view } = parameters;\n\tconst { placeId, sessionId, taskId, universeId, versionId } = ref;\n\n\tif (versionId === undefined) {\n\t\treturn {\n\t\t\terr: new ValidationError(\"Task ref is missing versionId; cannot GET\", {\n\t\t\t\tcode: \"incomplete_ref\",\n\t\t\t}),\n\t\t\tsuccess: false,\n\t\t};\n\t}\n\n\tif (sessionId === undefined) {\n\t\treturn {\n\t\t\terr: new ValidationError(\"Task ref is missing sessionId; cannot GET\", {\n\t\t\t\tcode: \"incomplete_ref\",\n\t\t\t}),\n\t\t\tsuccess: false,\n\t\t};\n\t}\n\n\tconst base = `/cloud/v2/universes/${universeId}/places/${placeId}/versions/${versionId}/luau-execution-sessions/${sessionId}/tasks/${taskId}`;\n\tconst url = view === undefined ? base : `${base}?view=${view}`;\n\treturn { data: { method: \"GET\", url }, success: true };\n}\n\nfunction buildSubmitBody(parameters: SubmitBodyInput): Record<string, unknown> {\n\tconst { script, timeoutSeconds } = parameters;\n\treturn timeoutSeconds === undefined ? { script } : { script, timeout: `${timeoutSeconds}s` };\n}\n","import type { OperationLimit } from \"../../../internal/http/rate-limit-queue.ts\";\n\nconst SUBMIT_PER_MINUTE = 40;\nconst GET_PER_MINUTE = 200;\nconst SECONDS_PER_MINUTE = 60;\n\n/**\n * Per-second request ceiling for submitting a Luau execution task,\n * sourced from `x-roblox-rate-limits.perApiKeyOwner` on the\n * `Cloud_CreateLuauExecutionSessionTask__Using_Universes` operation\n * (40 requests per minute per API key owner). The two URL shapes\n * (head and version) share this queue because Roblox attributes both\n * to the same per-minute quota.\n */\nexport const SUBMIT_OPERATION_LIMIT: OperationLimit = Object.freeze({\n\tmaxPerSecond: SUBMIT_PER_MINUTE / SECONDS_PER_MINUTE,\n\toperationKey: \"luau-execution-tasks.submit\",\n});\n\n/**\n * Per-second request ceiling for fetching a Luau execution task,\n * sourced from `x-roblox-rate-limits.perApiKeyOwner` on the\n * `Cloud_GetLuauExecutionSessionTask` operation (200 requests per\n * minute per API key owner).\n */\nexport const GET_OPERATION_LIMIT: OperationLimit = Object.freeze({\n\tmaxPerSecond: GET_PER_MINUTE / SECONDS_PER_MINUTE,\n\toperationKey: \"luau-execution-tasks.get\",\n});\n\n/**\n * Scopes required to submit a Luau execution task, sourced from\n * `x-roblox-scopes` on the create operation in the vendored OpenAPI\n * schema. Surfaced via the `requiredScopes` field of the per-method\n * spec so a 401 or 403 ApiError is upgraded to a `PermissionError`\n * naming the missing scope.\n */\nexport const SUBMIT_REQUIRED_SCOPES: ReadonlyArray<string> = Object.freeze([\n\t\"universe.place.luau-execution-session:write\",\n]);\n\n/**\n * Scopes required to fetch a Luau execution task, sourced from\n * `x-roblox-scopes` on the get operation. The `:write` scope also\n * grants read in upstream auth, but we surface only `:read` here as\n * the minimum-privilege requirement for this method.\n */\nexport const GET_REQUIRED_SCOPES: ReadonlyArray<string> = Object.freeze([\n\t\"universe.place.luau-execution-session:read\",\n]);\n","import type { HttpResponse } from \"../../../client/types.ts\";\nimport { ApiError } from \"../../../errors/api-error.ts\";\nimport { isRecord } from \"../../../internal/utils/is-record.ts\";\nimport type { Result } from \"../../../types.ts\";\nimport type { LuauExecutionTask, LuauExecutionTaskRef } from \"./types.ts\";\nimport type {\n\tLuauExecutionTaskErrorWire,\n\tLuauExecutionTaskOutputWire,\n\tLuauExecutionTaskWire,\n} from \"./wire.ts\";\n\nconst MALFORMED_TASK_MESSAGE = \"Malformed luau-execution-session-task response\";\n\n// Matches any of the four x-aep-resource path formats for a luau\n// execution session task.\n//\n// Capture groups:\n// 1. universeId\n// 2. placeId\n// 3. versionId (when `/versions/{v}/` segment is present, else undefined)\n// 4. sessionId (when `/luau-execution-sessions/{s}/tasks/...` branch matched)\n// 5. taskId (when `/luau-execution-sessions/.../tasks/{t}` branch matched)\n// 6. taskId (when `/luau-execution-session-tasks/{t}` branch matched)\nconst PATH_PATTERN =\n\t/^universes\\/(\\d+)\\/places\\/(\\d+)(?:\\/versions\\/(\\d+))?(?:\\/luau-execution-sessions\\/([^/]+)\\/tasks\\/([^/]+)|\\/luau-execution-session-tasks\\/([^/]+))$/;\n\ninterface ParseVariantArgs {\n\treadonly body: LuauExecutionTaskWire;\n\treadonly ref: LuauExecutionTaskRef;\n\treadonly statusCode: number;\n\treadonly timeoutSeconds: number | undefined;\n}\n\n/**\n * Parses a successful Open Cloud `LuauExecutionSessionTask` response\n * body into the public {@link LuauExecutionTask} discriminated union.\n * Handles every supported task state (in-progress, COMPLETE, FAILED)\n * across all four x-aep-resource path shapes the server returns.\n *\n * @param response - The full {@link HttpResponse} from the Open Cloud\n *   API.\n * @returns A success result wrapping the parsed task, or an\n *   {@link ApiError} when the body or path do not match a supported\n *   shape.\n */\nexport function parseLuauExecutionTaskResponse(\n\tresponse: HttpResponse,\n): Result<LuauExecutionTask, ApiError> {\n\tconst { body, status: statusCode } = response;\n\tif (!isLuauExecutionTaskWire(body)) {\n\t\treturn malformed(statusCode);\n\t}\n\n\tconst ref = parseTaskRef(body.path);\n\tif (ref === undefined) {\n\t\treturn malformed(statusCode);\n\t}\n\n\tconst timeoutSeconds = parseTimeoutSeconds(body.timeout);\n\n\tif (body.state === \"COMPLETE\") {\n\t\treturn parseCompleteTask({ body, ref, statusCode, timeoutSeconds });\n\t}\n\n\tif (body.state === \"FAILED\") {\n\t\treturn parseFailedTask({ body, ref, statusCode, timeoutSeconds });\n\t}\n\n\treturn {\n\t\tdata: {\n\t\t\tcreatedAt: new Date(body.createTime),\n\t\t\tref,\n\t\t\tstate: body.state,\n\t\t\ttimeoutSeconds,\n\t\t\tupdatedAt: new Date(body.updateTime),\n\t\t\tuser: body.user,\n\t\t},\n\t\tsuccess: true,\n\t};\n}\n\nfunction isAcceptedWireState(\n\tstate: unknown,\n): state is \"CANCELLED\" | \"COMPLETE\" | \"FAILED\" | \"PROCESSING\" | \"QUEUED\" {\n\treturn (\n\t\tstate === \"QUEUED\" ||\n\t\tstate === \"PROCESSING\" ||\n\t\tstate === \"CANCELLED\" ||\n\t\tstate === \"COMPLETE\" ||\n\t\tstate === \"FAILED\"\n\t);\n}\n\nfunction isErrorWireCode(code: unknown): code is LuauExecutionTaskErrorWire[\"code\"] {\n\treturn (\n\t\tcode === \"SCRIPT_ERROR\" ||\n\t\tcode === \"DEADLINE_EXCEEDED\" ||\n\t\tcode === \"OUTPUT_SIZE_LIMIT_EXCEEDED\" ||\n\t\tcode === \"INTERNAL_ERROR\"\n\t);\n}\n\nfunction isErrorWire(value: unknown): value is LuauExecutionTaskErrorWire {\n\treturn (\n\t\tisRecord(value) && isErrorWireCode(value[\"code\"]) && typeof value[\"message\"] === \"string\"\n\t);\n}\n\nfunction isOptionalErrorWire(value: unknown): value is LuauExecutionTaskErrorWire | undefined {\n\treturn value === undefined || isErrorWire(value);\n}\n\nfunction isOutputWire(value: unknown): value is LuauExecutionTaskOutputWire {\n\treturn isRecord(value) && Array.isArray(value[\"results\"]);\n}\n\nfunction isOptionalOutputWire(value: unknown): value is LuauExecutionTaskOutputWire | undefined {\n\treturn value === undefined || isOutputWire(value);\n}\n\nfunction isLuauExecutionTaskWire(body: unknown): body is LuauExecutionTaskWire {\n\treturn (\n\t\tisRecord(body) &&\n\t\ttypeof body[\"path\"] === \"string\" &&\n\t\ttypeof body[\"createTime\"] === \"string\" &&\n\t\ttypeof body[\"updateTime\"] === \"string\" &&\n\t\tisAcceptedWireState(body[\"state\"]) &&\n\t\ttypeof body[\"user\"] === \"string\" &&\n\t\tisOptionalOutputWire(body[\"output\"]) &&\n\t\tisOptionalErrorWire(body[\"error\"]) &&\n\t\tisOptionalDurationWire(body[\"timeout\"])\n\t);\n}\n\nconst DURATION_PATTERN = /^(\\d+)s$/;\n\nfunction isOptionalDurationWire(value: unknown): value is string | undefined {\n\treturn value === undefined || (typeof value === \"string\" && DURATION_PATTERN.test(value));\n}\n\nfunction parseTimeoutSeconds(value: string | undefined): number | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\n\tconst match = DURATION_PATTERN.exec(value);\n\tconst seconds = match?.[1];\n\tif (seconds === undefined) {\n\t\treturn undefined;\n\t}\n\n\treturn Number.parseInt(seconds, 10);\n}\n\nfunction malformed(statusCode: number): Result<LuauExecutionTask, ApiError> {\n\treturn { err: new ApiError(MALFORMED_TASK_MESSAGE, { statusCode }), success: false };\n}\n\nfunction parseCompleteTask(args: ParseVariantArgs): Result<LuauExecutionTask, ApiError> {\n\tconst { body, ref, statusCode, timeoutSeconds } = args;\n\tif (body.output === undefined) {\n\t\treturn malformed(statusCode);\n\t}\n\n\treturn {\n\t\tdata: {\n\t\t\tcreatedAt: new Date(body.createTime),\n\t\t\toutput: { results: body.output.results },\n\t\t\tref,\n\t\t\tstate: \"COMPLETE\",\n\t\t\ttimeoutSeconds,\n\t\t\tupdatedAt: new Date(body.updateTime),\n\t\t\tuser: body.user,\n\t\t},\n\t\tsuccess: true,\n\t};\n}\n\nfunction parseFailedTask(args: ParseVariantArgs): Result<LuauExecutionTask, ApiError> {\n\tconst { body, ref, statusCode, timeoutSeconds } = args;\n\tif (body.error === undefined) {\n\t\treturn malformed(statusCode);\n\t}\n\n\treturn {\n\t\tdata: {\n\t\t\tcreatedAt: new Date(body.createTime),\n\t\t\terror: { code: body.error.code, message: body.error.message },\n\t\t\tref,\n\t\t\tstate: \"FAILED\",\n\t\t\ttimeoutSeconds,\n\t\t\tupdatedAt: new Date(body.updateTime),\n\t\t\tuser: body.user,\n\t\t},\n\t\tsuccess: true,\n\t};\n}\n\nfunction parseTaskRef(path: string): LuauExecutionTaskRef | undefined {\n\tconst match = PATH_PATTERN.exec(path);\n\tif (match === null) {\n\t\treturn undefined;\n\t}\n\n\tconst [, universeId, placeId, versionId, sessionId, sessionTaskId, plainTaskId] = match;\n\tconst taskId = sessionTaskId ?? plainTaskId;\n\tif (universeId === undefined || placeId === undefined || taskId === undefined) {\n\t\treturn undefined;\n\t}\n\n\treturn { placeId, sessionId, taskId, universeId, versionId };\n}\n","import {\n\tCREATE_METHOD_DEFAULTS,\n\tIDEMPOTENT_METHOD_DEFAULTS,\n} from \"../../../internal/http/retry.ts\";\nimport { okRequest, type ResourceMethodSpec } from \"../../../internal/resource-client.ts\";\nimport {\n\tbuildGetRequest,\n\tbuildSubmitAtHeadRequest,\n\tbuildSubmitAtVersionRequest,\n} from \"./builders.ts\";\nimport {\n\tGET_OPERATION_LIMIT,\n\tGET_REQUIRED_SCOPES,\n\tSUBMIT_OPERATION_LIMIT,\n\tSUBMIT_REQUIRED_SCOPES,\n} from \"./operations.ts\";\nimport { parseLuauExecutionTaskResponse } from \"./parsers.ts\";\nimport type {\n\tGetParameters,\n\tLuauExecutionTask,\n\tSubmitAtHeadParameters,\n\tSubmitAtVersionParameters,\n} from \"./types.ts\";\n\nfunction makeSpec<P>(\n\tspec: ResourceMethodSpec<P, LuauExecutionTask>,\n): ResourceMethodSpec<P, LuauExecutionTask> {\n\treturn Object.freeze(spec);\n}\n\n/**\n * Per-method dispatch spec for submitting a Luau execution task at a\n * place's head version. Frozen at module scope so both the top-level\n * `LuauExecutionClient` and the `luauExecution` Operation Group on\n * `PlacesClient` share the same instance reference.\n */\nexport const SUBMIT_HEAD_SPEC = makeSpec<SubmitAtHeadParameters>({\n\tbuildRequest: (parameters) => okRequest(buildSubmitAtHeadRequest(parameters)),\n\tmethodDefaults: CREATE_METHOD_DEFAULTS,\n\tmethodKind: \"create\",\n\toperationLimit: SUBMIT_OPERATION_LIMIT,\n\tparse: parseLuauExecutionTaskResponse,\n\trequiredScopes: SUBMIT_REQUIRED_SCOPES,\n});\n\n/**\n * Per-method dispatch spec for submitting a Luau execution task at a\n * specific place version. Shares the rate-limit queue and required\n * scope set with {@link SUBMIT_HEAD_SPEC} because Roblox attributes\n * both URL shapes to one per-minute quota.\n */\nexport const SUBMIT_VERSION_SPEC = makeSpec<SubmitAtVersionParameters>({\n\tbuildRequest: (parameters) => okRequest(buildSubmitAtVersionRequest(parameters)),\n\tmethodDefaults: CREATE_METHOD_DEFAULTS,\n\tmethodKind: \"create\",\n\toperationLimit: SUBMIT_OPERATION_LIMIT,\n\tparse: parseLuauExecutionTaskResponse,\n\trequiredScopes: SUBMIT_REQUIRED_SCOPES,\n});\n\n/**\n * Per-method dispatch spec for fetching a Luau execution task. Uses\n * idempotent retry semantics (429 and 5xx both retried) so reads\n * recover transparently from transient server errors.\n */\nexport const GET_SPEC = makeSpec<GetParameters>({\n\tbuildRequest: buildGetRequest,\n\tmethodDefaults: IDEMPOTENT_METHOD_DEFAULTS,\n\tmethodKind: \"idempotent\",\n\toperationLimit: GET_OPERATION_LIMIT,\n\tparse: parseLuauExecutionTaskResponse,\n\trequiredScopes: GET_REQUIRED_SCOPES,\n});\n"],"mappings":"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"}

package/dist/storage.d.mts

@@ -0,0 +1,374 @@
+import { d as OpenCloudError, i as OpenCloudClientOptions, l as Result, n as HttpRequest, r as HttpResponse, s as RequestOptions } from "./types-Cp8w8uwA.mjs";
+
+//#region src/domains/cloud-v2/memory-store-queues/types.d.ts
+/**
+* Caller-supplied input for the `enqueue` method on `StorageClient.queues`.
+* Mirrors `Cloud_CreateMemoryStoreQueueItem` on the Open Cloud API.
+*/
+interface EnqueueQueueItemParameters {
+  /**
+  * Opaque queue payload. Round-trips as JSON, including nested `null`
+  * values inside objects and arrays. The top-level value cannot be
+  * `null`: the server rejects null payloads with a 400, so the type
+  * forbids it at compile time.
+  */
+  readonly data: Exclude<JSONValue, null>;
+  /**
+  * Optional priority. Higher values are dequeued first; equal priorities
+  * preserve insertion order. Omitted entries are inserted at the back of
+  * the queue.
+  */
+  readonly priority?: number;
+  /** Stringified queue identifier; the queue is auto-created on first use. */
+  readonly queueId: string;
+  /**
+  * Optional time-to-live in seconds. After this many seconds the item is
+  * automatically removed from the queue. Omitted entries inherit the
+  * server-default TTL.
+  */
+  readonly ttl?: number;
+  /** Stringified ID of the universe that owns the queue. */
+  readonly universeId: string;
+}
+/**
+* Parsed representation of a memory-store queue item, as returned by the
+* Open Cloud `Cloud_CreateMemoryStoreQueueItem` and (inside the array)
+* `Cloud_ReadMemoryStoreQueueItems` endpoints.
+*/
+interface QueueItem {
+  /** Server-generated item identifier, parsed from the wire `path`. */
+  readonly id: string;
+  /**
+  * Opaque queue payload. Nested `null` values inside the JSON shape are
+  * preserved verbatim; only the top level is constrained.
+  */
+  readonly data: Exclude<JSONValue, null>;
+  /** Timestamp at which the server removes the item from the queue. */
+  readonly expiresAt: Date;
+  /** Priority recorded on the item, or `undefined` when none was set. */
+  readonly priority: number | undefined;
+  /** Stringified queue identifier, parsed from the wire `path`. */
+  readonly queueId: string;
+  /** Stringified universe identifier, parsed from the wire `path`. */
+  readonly universeId: string;
+}
+/**
+* Caller-supplied input for the `dequeue` method on
+* `StorageClient.queues`. Mirrors `Cloud_ReadMemoryStoreQueueItems`.
+*/
+interface DequeueQueueItemsParameters {
+  /**
+  * If `true`, the server returns 404 when fewer than `count` items
+  * are available. Defaults to `false`, in which case the server
+  * returns whatever subset is currently at the front of the queue.
+  */
+  readonly allOrNothing?: boolean;
+  /**
+  * Number of items to read from the front of the queue. Defaults to
+  * `1`; values above `200` are clamped server-side.
+  */
+  readonly count?: number;
+  /**
+  * Number of seconds the dequeued items remain invisible to
+  * subsequent reads. Items not acknowledged via `discard` reappear
+  * once the window elapses. Defaults to `30` seconds server-side.
+  */
+  readonly invisibilityWindow?: number;
+  /** Stringified queue identifier. */
+  readonly queueId: string;
+  /** Stringified ID of the universe that owns the queue. */
+  readonly universeId: string;
+}
+/**
+* Parsed result of a successful `Cloud_ReadMemoryStoreQueueItems`
+* response. The `readId` value must be passed to a subsequent
+* `discard` call to acknowledge the items; otherwise the items reappear
+* once the invisibility window elapses.
+*/
+interface DequeueResult {
+  /** Items dequeued from the front of the queue, in dequeue order. */
+  readonly items: ReadonlyArray<QueueItem>;
+  /**
+  * Identifier of the dequeue operation. Pass this to `discard` to
+  * remove the items from the queue permanently.
+  */
+  readonly readId: string;
+}
+/**
+* Caller-supplied input for the `discard` method on
+* `StorageClient.queues`. Mirrors `Cloud_DiscardMemoryStoreQueueItems`.
+* Acknowledging a `readId` removes the dequeued batch from the queue
+* permanently; without `discard`, the items reappear once their
+* invisibility window elapses.
+*/
+interface DiscardQueueItemsParameters {
+  /** Stringified queue identifier. */
+  readonly queueId: string;
+  /** Identifier returned by a prior `dequeue` call. */
+  readonly readId: string;
+  /** Stringified ID of the universe that owns the queue. */
+  readonly universeId: string;
+}
+//#endregion
+//#region src/internal/http/rate-limit-queue.d.ts
+/**
+* Identifies and bounds a single Roblox Open Cloud operation for rate
+* limiting, e.g. `{ operationKey: "game-passes.create", maxPerSecond: 5 }`.
+*/
+interface OperationLimit {
+  /** Maximum sustained request rate in requests per second. */
+  readonly maxPerSecond: number;
+  /**
+  * Stable identifier for the operation (e.g. "game-passes.create"). Not
+  * consumed by the queue itself; callers use it to key per-operation
+  * queues in a registry (see GamePassesClient).
+  */
+  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
+* `ResourceClient.execute`. Each resource client declares one module-level
+* constant per public method; that constant binds the four resource-specific
+* values (request builder, response parser, retry-policy method kind,
+* operation-level rate limit) and flows through `execute` uniformly.
+*
+* @template P - The resource-specific parameter shape the builder
+*   accepts.
+* @template T - The resource-specific parsed success type the parser
+*   produces.
+*/
+interface ResourceMethodSpec<P, T> {
+  /**
+  * Builds the pure {@link HttpRequest} for a single call. Returns a
+  * {@link Result} so a builder can short-circuit with a local error
+  * (typically a {@link OpenCloudError} subclass such as `ValidationError`)
+  * before any HTTP, queue, or retry work happens. Builders that cannot
+  * fail wrap their return as `{ data: request, success: true }`.
+  */
+  readonly buildRequest: (parameters: P) => Result<HttpRequest, OpenCloudError>;
+  /** Method-level retry defaults merged into the resolved config. */
+  readonly methodDefaults: Partial<RetryResolvable>;
+  /**
+  * Method kind, controlling merge precedence: `"create"` lets method
+  * defaults win over client config so create safety cannot be relaxed
+  * silently; `"idempotent"` lets client config win over method defaults
+  * so consumers can loosen retry globally.
+  */
+  readonly methodKind: MethodKind;
+  /** Operation-level rate limit, keyed into the client's per-key queue map. */
+  readonly operationLimit: OperationLimit;
+  /**
+  * Converts the full {@link HttpResponse} into the resource-specific
+  * parsed shape. Takes the whole response (body, status, headers) so
+  * future parsers can read headers without widening the signature.
+  */
+  readonly parse: (response: HttpResponse) => Result<T, OpenCloudError>;
+  /**
+  * Open Cloud scopes the API key or OAuth token must carry for this
+  * method, sourced from the vendored OpenAPI schema's `x-roblox-scopes`.
+  * When set, a 401 or 403 ApiError from the upstream call is upgraded to
+  * a {@link PermissionError} carrying these scopes alongside
+  * {@link OperationLimit.operationKey}, so callers can name the missing
+  * scope instead of just the HTTP status. Optional so test specs and
+  * not-yet-wired resources can opt out.
+  */
+  readonly requiredScopes?: ReadonlyArray<string>;
+}
+/**
+* Single-argument bundle consumed by `ResourceClient.execute`: the per-method
+* spec, the resource-specific parameters, and optional per-request config
+* overrides.
+*
+* @template P - The resource-specific parameter shape the builder accepts.
+* @template T - The resource-specific parsed success type the parser produces.
+*/
+interface ExecuteCall<P, T> {
+  /** Optional per-request config overrides. */
+  readonly options?: RequestOptions | undefined;
+  /** Resource-specific request parameters. */
+  readonly parameters: P;
+  /** Per-method binding of builder, parser, method kind, and operation limit. */
+  readonly spec: ResourceMethodSpec<P, T>;
+}
+/**
+* Wraps an infallible request build as a {@link Result}-returning
+* `buildRequest` callback compatible with {@link ResourceMethodSpec}.
+* Use from a resource client whose builder cannot fail; resource clients
+* with local validation should construct the {@link Result} directly.
+*
+* @param request - The pre-built {@link HttpRequest}.
+* @returns A success Result wrapping the request.
+*/
+/**
+* Internal orchestrator shared by every Open Cloud resource client. Holds
+* the frozen client config, observability hooks, injected HTTP client and
+* sleep, and the per-effective-key rate-limit queue registry. Resource
+* classes compose one instance and dispatch every public method through
+* {@link ResourceClient.execute} with a per-method {@link ResourceMethodSpec}.
+* Not exported from any package subpath; reachable only via sibling
+* `src/resources/**` modules in this package.
+*/
+declare class ResourceClient {
+  #private;
+  /**
+  * Creates a new {@link ResourceClient}. Resolves the injected HTTP
+  * client and sleep (defaulting to fetch + `setTimeout`) and freezes the
+  * merged client config so subsequent calls cannot mutate it.
+  *
+  * @param options - Client-level configuration including the API key
+  *   and optional construction-time test seams.
+  */
+  constructor(options: OpenCloudClientOptions);
+  /**
+  * Dispatches a single resource-method call. Merges the frozen client
+  * config with the method's `methodDefaults` and the caller's optional
+  * per-request `options`, routes through the effective-apiKey rate-limit
+  * queue, runs the retry loop, and finally parses the response with the
+  * spec's parser.
+  *
+  * @param call - The per-method spec, resource-specific parameters, and
+  *   optional per-request overrides.
+  * @returns The parsed success payload or the {@link OpenCloudError} that
+  *   caused the request to fail. Never throws.
+  */
+  execute<P, T>(call: ExecuteCall<P, T>): Promise<Result<T, OpenCloudError>>;
+}
+//#endregion
+//#region src/resources/storage/queues-group.d.ts
+/**
+* Operation Group on `StorageClient` that exposes the memory-store
+* queue endpoints. Queues are FIFO collections of opaque JSON values
+* with optional priority and TTL; consumers enqueue items, dequeue
+* them in batches, and acknowledge processed batches with a read
+* identifier.
+*/
+declare class MemoryStoreQueuesGroup {
+  #private;
+  /**
+  * Wraps the shared {@link ResourceClient} so the Operation Group
+  * routes calls through the same retry, hooks, and rate-limit queues
+  * as the rest of the parent client.
+  *
+  * @param inner - The shared {@link ResourceClient} owned by the
+  *   parent client.
+  */
+  constructor(inner: ResourceClient);
+  /**
+  * Dequeues up to `count` items from the front of the queue. Items
+  * returned become invisible to subsequent reads for
+  * `invisibilityWindow` seconds (default 30 server-side); they
+  * reappear once the window elapses unless acknowledged via
+  * `discard` with the returned `readId`.
+  *
+  * On 5xx, dequeue does not retry: the server may have set
+  * invisibility on a batch before the response failed, so a retry
+  * would return a *different* batch and the first one is lost until
+  * the window expires. Callers that can detect duplicates externally
+  * may opt back into 5xx retry per call by passing `retryableStatuses`
+  * on `options`.
+  *
+  * @param parameters - Universe and queue identifiers, plus optional
+  *   `count`, `allOrNothing`, and `invisibilityWindow`.
+  * @param options - Optional per-request overrides.
+  * @returns A {@link Result} wrapping the parsed {@link DequeueResult}
+  *   or the {@link OpenCloudError} that caused the request to fail.
+  */
+  dequeue(parameters: DequeueQueueItemsParameters, options?: RequestOptions): Promise<Result<DequeueResult, OpenCloudError>>;
+  /**
+  * Acknowledges a dequeued batch of items, removing them from the
+  * queue permanently. Pass the `readId` returned from the prior
+  * `dequeue` call. Without `discard`, the items reappear once the
+  * invisibility window elapses.
+  *
+  * The call is idempotent: a second `discard` with the same `readId`
+  * is a no-op once the batch has been acknowledged. The retry policy
+  * therefore retries both 429 and 5xx.
+  *
+  * @param parameters - Universe and queue identifiers, plus the
+  *   `readId` returned from a prior dequeue.
+  * @param options - Optional per-request overrides.
+  * @returns A {@link Result} wrapping `undefined` on success (the
+  *   server returns an empty body) or the {@link OpenCloudError}
+  *   that caused the request to fail.
+  */
+  discard(parameters: DiscardQueueItemsParameters, options?: RequestOptions): Promise<Result<undefined, OpenCloudError>>;
+  /**
+  * Enqueues a single item onto a memory-store queue. The queue is
+  * auto-created on first use; the queue identifier is any string the
+  * caller picks. Items with higher `priority` values are dequeued
+  * first; equal priorities preserve insertion order. Items expire
+  * and are removed automatically after `ttl` seconds, or after a
+  * server-default lifetime when omitted.
+  *
+  * @param parameters - Universe and queue identifiers, the opaque
+  *   payload, and optional `priority` and `ttl`.
+  * @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 QueueItem} or
+  *   the {@link OpenCloudError} that caused the request to fail.
+  */
+  enqueue(parameters: EnqueueQueueItemParameters, options?: RequestOptions): Promise<Result<QueueItem, OpenCloudError>>;
+}
+//#endregion
+//#region src/resources/storage/client.d.ts
+/**
+* Public client for the Roblox Open Cloud `Data and memory stores`
+* Feature. Today it covers memory-store queues via the
+* {@link StorageClient.queues} Operation Group; future Operation
+* Groups for sorted maps and data stores slot in as siblings on the
+* same client.
+*
+* Every method returns a `Result` so callers handle failure
+* explicitly; no thrown error ever escapes the client.
+*
+* @example
+*
+* ```ts
+* import { StorageClient } from "@bedrock-rbx/ocale/storage";
+*
+* const client = new StorageClient({ apiKey: "your-key" });
+* expect(client).toBeInstanceOf(StorageClient);
+* ```
+*/
+declare class StorageClient {
+  /** Memory-store queue Operation Group. */
+  readonly queues: MemoryStoreQueuesGroup;
+  /**
+  * Creates a new {@link StorageClient}. 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);
+}
+//#endregion
+export { type DequeueQueueItemsParameters, type DequeueResult, type DiscardQueueItemsParameters, type EnqueueQueueItemParameters, type QueueItem, StorageClient };
+//# sourceMappingURL=storage.d.mts.map

package/dist/storage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.mts","names":[],"sources":["../src/domains/cloud-v2/memory-store-queues/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/client.ts"],"mappings":";;;;;;AAIA;UAAiB,0BAAA;;;;;;;WAOP,IAAA,EAAM,OAAA,CAAQ,SAAA;;;;;AAwBxB;WAlBU,QAAA;;WAEA,OAAA;;;;;;WAMA,GAAA;;WAEA,UAAA;AAAA;;;;;;UAQO,SAAA;EAsBjB;EAAA,SApBU,EAAA;;;;;WAKA,IAAA,EAAM,OAAA,CAAQ,SAAA;;WAEd,SAAA,EAAW,IAAA;;WAEX,QAAA;EAyCV;EAAA,SAvCU,OAAA;;WAEA,UAAA;AAAA;;;;;UAOO,2BAAA;EA+CjB;;;;;EAAA,SAzCU,YAAA;;;;;WAKA,KAAA;;AC7DV;;;;WDmEU,kBAAA;;WAEA,OAAA;;WAEA,UAAA;AAAA;;;;;;;UASO,aAAA;;WAEP,KAAA,EAAO,aAAA,CAAc,SAAA;;;;AE3C/B;WFgDU,MAAA;AAAA;;;;;;AGxDV;;UHkEiB,2BAAA;;WAEP,OAAA;;WAEA,MAAA;;WAEA,UAAA;AAAA;;;;AA1GV;;;UCGiB,cAAA;;WAEP,YAAA;;;;;;WAMA,YAAA;AAAA;;;;ADXV;;;;;;;UEOiB,eAAA;;WAEP,MAAA;;WAEA,OAAA;EFYA;EAAA,SEVA,UAAA;EFkBO;EAAA,SEhBP,iBAAA,EAAmB,aAAA;;WAEnB,UAAA,GAAa,OAAA;;WAEb,OAAA;AAAA;AFkCV;AAAA,KEXY,UAAA;;;;;;;;;;;;;;AFXZ;UGGiB,kBAAA;;;;;;;;WAQP,YAAA,GAAe,UAAA,EAAY,CAAA,KAAM,MAAA,CAAO,WAAA,EAAa,cAAA;;WAErD,cAAA,EAAgB,OAAA,CAAQ,eAAA;;;;;AHSlC;;WGFU,UAAA,EAAY,UAAA;EHEL;EAAA,SGAP,cAAA,EAAgB,cAAA;;;;;;WAMhB,KAAA,GAAQ,QAAA,EAAU,YAAA,KAAiB,MAAA,CAAO,CAAA,EAAG,cAAA;EHwBvD;;;;;;;;;EAAA,SGdU,cAAA,GAAiB,aAAA;AAAA;;;;;;;;;UAWjB,WAAA;EF7EO;EAAA,SE+EP,OAAA,GAAU,cAAA;EF/EH;EAAA,SEiFP,UAAA,EAAY,CAAA;;WAEZ,IAAA,EAAM,kBAAA,CAAmB,CAAA,EAAG,CAAA;AAAA;AD/EtC;;;;;;;;;;;;;AC2BA;;;;;cAgGa,cAAA;EAAA;;;;;;;;;EAeZ,WAAA,CAAY,OAAA,EAAS,sBAAA;;;;;;;;;;;;;EAyBrB,OAAA,MAAA,CAA2B,IAAA,EAAM,WAAA,CAAY,CAAA,EAAG,CAAA,IAAK,OAAA,CAAQ,MAAA,CAAO,CAAA,EAAG,cAAA;AAAA;;;;;;;;;;cChG3D,sBAAA;EAAA;;;AJ3Cb;;;;;;EIsDC,WAAA,CAAY,KAAA,EAAO,cAAA;EJ7CC;;;;;;;;;;;;AAarB;;;;;;;;EIwDC,OAAA,CACC,UAAA,EAAY,2BAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,aAAA,EAAe,cAAA;;;AJ7BlC;;;;;;;;;;AAiBA;;;;;EIiCC,OAAA,CACC,UAAA,EAAY,2BAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,YAAkB,cAAA;;;;;;;AHrI9B;;;;;;;;ACIA;EEoJC,OAAA,CACC,UAAA,EAAY,0BAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,SAAA,EAAW,cAAA;AAAA;;;;AJ9J9B;;;;;;;;;;;;;AA+BA;;;;;cKZa,aAAA;;WAEI,MAAA,EAAQ,sBAAA;;;;;;;EAQxB,WAAA,CAAY,OAAA,EAAS,sBAAA;AAAA"}