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

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/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"}
+{"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,6 +1,6 @@
-import { i as ApiError } from "./rate-limit-CKfuhxT1.mjs";
-import { t as isDateTimeString } from "./is-date-time-string-Cuf1TaSC.mjs";
-import { a as IDEMPOTENT_METHOD_DEFAULTS, i as CREATE_METHOD_DEFAULTS, n as okRequest, o as isRecord, r as parseEmptyResponse, t as ResourceClient } from "./resource-client-Wi4Mwqy5.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 { a as isDateTimeString, i as isRecord, n as okRequest, r as parseEmptyResponse, t as ResourceClient } from "./resource-client-lE7Tg3BK.mjs";
 //#region src/domains/cloud-v2/memory-store-queues/builders.ts
 /**
 * Builds a `POST` request for the Open Cloud
@@ -73,7 +73,7 @@ function buildDiscardRequest(parameters) {
 //#endregion
 //#region src/domains/cloud-v2/memory-store-queues/operations.ts
 const ENQUEUE_PER_MINUTE = 1e6;
-const SECONDS_PER_MINUTE = 60;
+const SECONDS_PER_MINUTE$1 = 60;
 /**
 * Per-second request ceiling for enqueueing a memory-store queue item,
 * from the Open Cloud OpenAPI schema (1,000,000 requests per minute per
@@ -83,7 +83,7 @@ const SECONDS_PER_MINUTE = 60;
 * is fewer cross-method contention surprises.
 */
 const ENQUEUE_OPERATION_LIMIT = Object.freeze({
-	maxPerSecond: ENQUEUE_PER_MINUTE / SECONDS_PER_MINUTE,
+	maxPerSecond: ENQUEUE_PER_MINUTE / SECONDS_PER_MINUTE$1,
 	operationKey: "memory-store-queues.enqueue"
 });
 /**
@@ -98,7 +98,7 @@ const ENQUEUE_REQUIRED_SCOPES = Object.freeze(["memory-store.queue:add"]);
 * per API key owner). Keyed independently from enqueue and discard.
 */
 const DEQUEUE_OPERATION_LIMIT = Object.freeze({
-	maxPerSecond: 1e6 / SECONDS_PER_MINUTE,
+	maxPerSecond: 1e6 / SECONDS_PER_MINUTE$1,
 	operationKey: "memory-store-queues.dequeue"
 });
 /**
@@ -114,7 +114,7 @@ const DEQUEUE_REQUIRED_SCOPES = Object.freeze(["memory-store.queue:dequeue"]);
 * dequeue.
 */
 const DISCARD_OPERATION_LIMIT = Object.freeze({
-	maxPerSecond: 1e6 / SECONDS_PER_MINUTE,
+	maxPerSecond: 1e6 / SECONDS_PER_MINUTE$1,
 	operationKey: "memory-store-queues.discard"
 });
 /**
@@ -125,7 +125,7 @@ const DISCARD_OPERATION_LIMIT = Object.freeze({
 const DISCARD_REQUIRED_SCOPES = Object.freeze(["memory-store.queue:discard"]);
 //#endregion
 //#region src/domains/cloud-v2/memory-store-queues/parsers.ts
-const PATH_PATTERN = /^cloud\/v2\/universes\/(\d+)\/memory-store\/queues\/([^/]+)\/items\/([^/]+)$/;
+const PATH_PATTERN$1 = /^cloud\/v2\/universes\/(\d+)\/memory-store\/queues\/([^/]+)\/items\/([^/]+)$/;
 const MALFORMED_QUEUE_ITEM_MESSAGE = "Malformed memory-store queue item response";
 const MALFORMED_DEQUEUE_MESSAGE = "Malformed memory-store dequeue response";
 /**
@@ -160,8 +160,9 @@ function parseDequeueResponse(response) {
 	const { body, status: statusCode } = response;
 	if (!isRecord(body)) return malformedDequeue(statusCode);
 	const { id, queueItems } = body;
-	if (typeof id !== "string" || !Array.isArray(queueItems)) return malformedDequeue(statusCode);
-	const items = queueItems.map(wireBodyToQueueItem);
+	if (typeof id !== "string") return malformedDequeue(statusCode);
+	if (queueItems !== void 0 && queueItems !== null && !Array.isArray(queueItems)) return malformedDequeue(statusCode);
+	const items = (queueItems ?? []).map(wireBodyToQueueItem);
 	if (!items.every(isQueueItem)) return malformedDequeue(statusCode);
 	return {
 		data: {
@@ -178,7 +179,7 @@ function isQueueItemWire(body) {
 }
 function wireBodyToQueueItem(body) {
 	if (!isQueueItemWire(body)) return;
-	const match = PATH_PATTERN.exec(body.path);
+	const match = PATH_PATTERN$1.exec(body.path);
 	const universeId = match?.[1];
 	const queueId = match?.[2];
 	const id = match?.[3];
@@ -209,10 +210,10 @@ function malformedDequeue(statusCode) {
 }
 //#endregion
 //#region src/resources/storage/queues-group.ts
-function makeSpec(spec) {
+function makeSpec$1(spec) {
 	return Object.freeze(spec);
 }
-const ENQUEUE_SPEC = makeSpec({
+const ENQUEUE_SPEC = makeSpec$1({
 	buildRequest: (parameters) => okRequest(buildEnqueueRequest(parameters)),
 	methodDefaults: CREATE_METHOD_DEFAULTS,
 	methodKind: "create",
@@ -220,7 +221,7 @@ const ENQUEUE_SPEC = makeSpec({
 	parse: parseQueueItemResponse,
 	requiredScopes: ENQUEUE_REQUIRED_SCOPES
 });
-const DEQUEUE_SPEC = makeSpec({
+const DEQUEUE_SPEC = makeSpec$1({
 	buildRequest: (parameters) => okRequest(buildDequeueRequest(parameters)),
 	methodDefaults: CREATE_METHOD_DEFAULTS,
 	methodKind: "create",
@@ -228,7 +229,7 @@ const DEQUEUE_SPEC = makeSpec({
 	parse: parseDequeueResponse,
 	requiredScopes: DEQUEUE_REQUIRED_SCOPES
 });
-const DISCARD_SPEC = makeSpec({
+const DISCARD_SPEC = makeSpec$1({
 	buildRequest: (parameters) => okRequest(buildDiscardRequest(parameters)),
 	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
 	methodKind: "idempotent",
@@ -331,17 +332,501 @@ var MemoryStoreQueuesGroup = class {
 	}
 };
 //#endregion
+//#region src/domains/cloud-v2/memory-store-sorted-maps/builders.ts
+/**
+* Builds a `POST` request for the Open Cloud
+* `Cloud_CreateMemoryStoreSortedMapItem` endpoint. The caller-supplied
+* `itemId` travels as the `id` query parameter (URL-encoded by
+* `URLSearchParams`); the body carries `value`, the optional `ttl`
+* (serialized as a Google protobuf `Duration` string in seconds), and
+* one of `stringSortKey`/`numericSortKey` projected from the
+* {@link SortKey} discriminated union.
+*
+* @param parameters - Universe, sorted-map, item identifiers, the
+*   value to store, and optional `sortKey` and `ttl`.
+* @returns A pure {@link HttpRequest} describing the create call.
+*/
+function buildCreateRequest(parameters) {
+	const { itemId, mapId, sortKey, ttl, universeId, value } = parameters;
+	const body = { value };
+	if (ttl !== void 0) body["ttl"] = `${ttl}s`;
+	applySortKeyToBody(body, sortKey);
+	const query = new URLSearchParams({ id: itemId });
+	return {
+		body,
+		headers: { "content-type": "application/json" },
+		method: "POST",
+		url: `/cloud/v2/universes/${encodeURIComponent(universeId)}/memory-store/sorted-maps/${encodeURIComponent(mapId)}/items?${query.toString()}`
+	};
+}
+/**
+* Builds a `DELETE` request for the Open Cloud
+* `Cloud_DeleteMemoryStoreSortedMapItem` endpoint. Every path segment
+* (universe, sorted-map, item identifiers) is URL-encoded so callers
+* can pass values containing reserved characters without manual
+* escaping.
+*
+* @param parameters - Universe, sorted-map, and item identifiers.
+* @returns A pure {@link HttpRequest} describing the delete call.
+*/
+function buildDeleteRequest(parameters) {
+	const { itemId, mapId, universeId } = parameters;
+	return {
+		method: "DELETE",
+		url: `/cloud/v2/universes/${encodeURIComponent(universeId)}/memory-store/sorted-maps/${encodeURIComponent(mapId)}/items/${encodeURIComponent(itemId)}`
+	};
+}
+/**
+* Builds a `GET` request for the Open Cloud
+* `Cloud_GetMemoryStoreSortedMapItem` endpoint. Every path segment
+* (universe, sorted-map, item identifiers) is URL-encoded so callers
+* can pass values containing reserved characters without manual
+* escaping.
+*
+* @param parameters - Universe, sorted-map, and item identifiers.
+* @returns A pure {@link HttpRequest} describing the get call.
+*/
+function buildGetRequest(parameters) {
+	const { itemId, mapId, universeId } = parameters;
+	return {
+		method: "GET",
+		url: `/cloud/v2/universes/${encodeURIComponent(universeId)}/memory-store/sorted-maps/${encodeURIComponent(mapId)}/items/${encodeURIComponent(itemId)}`
+	};
+}
+/**
+* Builds a `GET` request for the Open Cloud
+* `Cloud_ListMemoryStoreSortedMapItems` endpoint. Optional `filter`,
+* `maxPageSize`, `orderBy`, and `pageToken` parameters travel as query
+* string parameters and are omitted when unset.
+*
+* @param parameters - Universe and sorted-map identifiers, plus
+*   optional pagination and filter parameters.
+* @returns A pure {@link HttpRequest} describing the list call.
+*/
+function buildListRequest(parameters) {
+	const { filter, mapId, maxPageSize, orderBy, pageToken, universeId } = parameters;
+	const query = new URLSearchParams();
+	if (maxPageSize !== void 0) query.append("maxPageSize", String(maxPageSize));
+	if (pageToken !== void 0) query.append("pageToken", pageToken);
+	if (orderBy !== void 0) query.append("orderBy", orderBy);
+	if (filter !== void 0) query.append("filter", filter);
+	const base = `/cloud/v2/universes/${encodeURIComponent(universeId)}/memory-store/sorted-maps/${encodeURIComponent(mapId)}/items`;
+	const queryString = query.toString();
+	return {
+		method: "GET",
+		url: queryString === "" ? base : `${base}?${queryString}`
+	};
+}
+/**
+* Builds a `PATCH` request for the Open Cloud
+* `Cloud_UpdateMemoryStoreSortedMapItem` endpoint. Body fields are
+* conditionally included so a partial update sends only the changed
+* fields; the optional `allowMissing` query string drives
+* upsert-on-missing behaviour server-side.
+*
+* @param parameters - Universe, sorted-map, and item identifiers,
+*   plus any subset of `value`, `ttl`, `sortKey`, and `allowMissing`.
+* @returns A pure {@link HttpRequest} describing the update call.
+*/
+function buildUpdateRequest(parameters) {
+	const { allowMissing: shouldAllowMissing, itemId, mapId, universeId } = parameters;
+	const base = `/cloud/v2/universes/${encodeURIComponent(universeId)}/memory-store/sorted-maps/${encodeURIComponent(mapId)}/items/${encodeURIComponent(itemId)}`;
+	const query = new URLSearchParams();
+	if (shouldAllowMissing !== void 0) query.append("allowMissing", String(shouldAllowMissing));
+	const queryString = query.toString();
+	return {
+		body: buildUpdateBody(parameters),
+		headers: { "content-type": "application/json" },
+		method: "PATCH",
+		url: queryString === "" ? base : `${base}?${queryString}`
+	};
+}
+function applySortKeyToBody(body, sortKey) {
+	if (sortKey === void 0) return;
+	if (sortKey.kind === "string") {
+		body["stringSortKey"] = sortKey.value;
+		return;
+	}
+	body["numericSortKey"] = sortKey.value;
+}
+function buildUpdateBody(parameters) {
+	const { sortKey, ttl, value } = parameters;
+	const body = {};
+	if (value !== void 0) body["value"] = value;
+	if (ttl !== void 0) body["ttl"] = `${ttl}s`;
+	applySortKeyToBody(body, sortKey);
+	return body;
+}
+//#endregion
+//#region src/domains/cloud-v2/memory-store-sorted-maps/operations.ts
+const CREATE_PER_MINUTE = 1e6;
+const SECONDS_PER_MINUTE = 60;
+const WRITE_SCOPE = "memory-store.sorted-map:write";
+/**
+* Per-second request ceiling for creating a memory-store sorted-map
+* item, from the Open Cloud OpenAPI schema (1,000,000 requests per
+* minute per API key owner). Keyed independently from the get, update,
+* delete, and list operations so the five do not share a queue.
+*/
+const CREATE_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: CREATE_PER_MINUTE / SECONDS_PER_MINUTE,
+	operationKey: "memory-store-sorted-maps.create"
+});
+/**
+* Scopes required to create a memory-store sorted-map item, sourced
+* from `x-roblox-scopes` on the `Cloud_CreateMemoryStoreSortedMapItem`
+* operation in the vendored OpenAPI schema.
+*/
+const CREATE_REQUIRED_SCOPES = Object.freeze([WRITE_SCOPE]);
+/**
+* Per-second request ceiling for deleting a memory-store sorted-map
+* item, from the Open Cloud OpenAPI schema (1,000,000 requests per
+* minute per API key owner).
+*/
+const DELETE_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 1e6 / SECONDS_PER_MINUTE,
+	operationKey: "memory-store-sorted-maps.delete"
+});
+/**
+* Scopes required to delete a memory-store sorted-map item, sourced
+* from `x-roblox-scopes` on the `Cloud_DeleteMemoryStoreSortedMapItem`
+* operation in the vendored OpenAPI schema.
+*/
+const DELETE_REQUIRED_SCOPES = Object.freeze([WRITE_SCOPE]);
+/**
+* Per-second request ceiling for reading a memory-store sorted-map
+* item, from the Open Cloud OpenAPI schema (1,000,000 requests per
+* minute per API key owner).
+*/
+const GET_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 1e6 / SECONDS_PER_MINUTE,
+	operationKey: "memory-store-sorted-maps.get"
+});
+/**
+* Scopes required to read a memory-store sorted-map item, sourced from
+* `x-roblox-scopes` on the `Cloud_GetMemoryStoreSortedMapItem`
+* operation in the vendored OpenAPI schema.
+*/
+const GET_REQUIRED_SCOPES = Object.freeze(["memory-store.sorted-map:read"]);
+/**
+* Per-second request ceiling for listing memory-store sorted-map
+* items, from the Open Cloud OpenAPI schema (1,000,000 requests per
+* minute per API key owner).
+*/
+const LIST_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 1e6 / SECONDS_PER_MINUTE,
+	operationKey: "memory-store-sorted-maps.list"
+});
+/**
+* Scopes required to list memory-store sorted-map items, sourced from
+* `x-roblox-scopes` on the `Cloud_ListMemoryStoreSortedMapItems`
+* operation in the vendored OpenAPI schema.
+*/
+const LIST_REQUIRED_SCOPES = Object.freeze(["memory-store.sorted-map:read"]);
+/**
+* Per-second request ceiling for updating a memory-store sorted-map
+* item, from the Open Cloud OpenAPI schema (1,000,000 requests per
+* minute per API key owner).
+*/
+const UPDATE_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 1e6 / SECONDS_PER_MINUTE,
+	operationKey: "memory-store-sorted-maps.update"
+});
+/**
+* Scopes required to update a memory-store sorted-map item, sourced
+* from `x-roblox-scopes` on the `Cloud_UpdateMemoryStoreSortedMapItem`
+* operation in the vendored OpenAPI schema.
+*/
+const UPDATE_REQUIRED_SCOPES = Object.freeze([WRITE_SCOPE]);
+//#endregion
+//#region src/domains/cloud-v2/memory-store-sorted-maps/parsers.ts
+const PATH_PATTERN = /^cloud\/v2\/universes\/(\d+)\/memory-stores?\/sorted-maps\/([^/]+)\/items\/([^/]+)$/;
+const MALFORMED_MESSAGE = "Malformed memory-store sorted-map item response";
+const MALFORMED_LIST_MESSAGE = "Malformed memory-store sorted-map list response";
+/**
+* Parses a successful memory-store sorted-map item response body (the
+* happy path for create, get, and update) into the public
+* {@link SortedMapItem} shape.
+*
+* @param response - The full {@link HttpResponse} from the Open Cloud API.
+* @returns A success result wrapping the parsed {@link SortedMapItem},
+*   or an {@link ApiError} when the body does not match the wire schema.
+*/
+function parseSortedMapItemResponse(response) {
+	const item = wireBodyToSortedMapItem(response.body);
+	if (item === void 0) return malformedSortedMapItem(response.status);
+	return {
+		data: item,
+		success: true
+	};
+}
+/**
+* Parses a successful `Cloud_ListMemoryStoreSortedMapItems` response
+* body into the public {@link ListSortedMapItemsResult} shape. Each
+* item in the `items` array is validated through the same
+* path-and-shape checks as {@link parseSortedMapItemResponse}; a
+* malformed entry rejects the whole response.
+*
+* @param response - The full {@link HttpResponse} from the Open Cloud API.
+* @returns A success result wrapping the parsed
+*   {@link ListSortedMapItemsResult}, or an {@link ApiError} when the
+*   response shape is wrong.
+*/
+function parseListResponse(response) {
+	const { body, status: statusCode } = response;
+	if (!isRecord(body)) return malformedList(statusCode);
+	const { items: rawItemsField, nextPageToken } = body;
+	if (rawItemsField !== void 0 && rawItemsField !== null && !Array.isArray(rawItemsField)) return malformedList(statusCode);
+	const normalizedToken = nextPageToken ?? void 0;
+	if (normalizedToken !== void 0 && typeof normalizedToken !== "string") return malformedList(statusCode);
+	const items = (rawItemsField ?? []).map(wireBodyToSortedMapItem);
+	if (!items.every(isSortedMapItem)) return malformedList(statusCode);
+	return {
+		data: {
+			items,
+			nextPageToken: normalizedToken
+		},
+		success: true
+	};
+}
+function isSortedMapItemWire(body) {
+	if (!isRecord(body)) return false;
+	const { id, etag, expireTime, numericSortKey, path, stringSortKey, value } = body;
+	return typeof path === "string" && typeof etag === "string" && typeof id === "string" && isDateTimeString(expireTime) && value !== void 0 && (stringSortKey === void 0 || stringSortKey === null || typeof stringSortKey === "string") && (numericSortKey === void 0 || numericSortKey === null || typeof numericSortKey === "number");
+}
+function extractSortKey(body) {
+	const hasStringKey = typeof body.stringSortKey === "string";
+	const hasNumericKey = typeof body.numericSortKey === "number";
+	if (hasStringKey && hasNumericKey) return "conflict";
+	if (hasStringKey) return {
+		kind: "string",
+		value: body.stringSortKey
+	};
+	if (hasNumericKey) return {
+		kind: "numeric",
+		value: body.numericSortKey
+	};
+}
+function wireBodyToSortedMapItem(body) {
+	if (!isSortedMapItemWire(body)) return;
+	const match = PATH_PATTERN.exec(body.path);
+	const universeId = match?.[1];
+	const mapId = match?.[2];
+	if (universeId === void 0 || mapId === void 0) return;
+	const sortKey = extractSortKey(body);
+	if (sortKey === "conflict") return;
+	return {
+		id: body.id,
+		etag: body.etag,
+		expiresAt: new Date(body.expireTime),
+		mapId,
+		sortKey,
+		universeId,
+		value: body.value
+	};
+}
+function malformedSortedMapItem(statusCode) {
+	return {
+		err: new ApiError(MALFORMED_MESSAGE, { statusCode }),
+		success: false
+	};
+}
+function isSortedMapItem(item) {
+	return item !== void 0;
+}
+function malformedList(statusCode) {
+	return {
+		err: new ApiError(MALFORMED_LIST_MESSAGE, { statusCode }),
+		success: false
+	};
+}
+//#endregion
+//#region src/resources/storage/sorted-maps-group.ts
+function makeSpec(spec) {
+	return Object.freeze(spec);
+}
+const CREATE_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildCreateRequest(parameters)),
+	methodDefaults: CREATE_METHOD_DEFAULTS,
+	methodKind: "create",
+	operationLimit: CREATE_OPERATION_LIMIT,
+	parse: parseSortedMapItemResponse,
+	requiredScopes: CREATE_REQUIRED_SCOPES
+});
+const DELETE_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildDeleteRequest(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: DELETE_OPERATION_LIMIT,
+	parse: parseEmptyResponse,
+	requiredScopes: DELETE_REQUIRED_SCOPES
+});
+const GET_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildGetRequest(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: GET_OPERATION_LIMIT,
+	parse: parseSortedMapItemResponse,
+	requiredScopes: GET_REQUIRED_SCOPES
+});
+const LIST_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildListRequest(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: LIST_OPERATION_LIMIT,
+	parse: parseListResponse,
+	requiredScopes: LIST_REQUIRED_SCOPES
+});
+const UPDATE_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildUpdateRequest(parameters)),
+	methodDefaults: IDEMPOTENT_METHOD_DEFAULTS,
+	methodKind: "idempotent",
+	operationLimit: UPDATE_OPERATION_LIMIT,
+	parse: parseSortedMapItemResponse,
+	requiredScopes: UPDATE_REQUIRED_SCOPES
+});
+/**
+* Operation Group on `StorageClient` that exposes the memory-store
+* sorted-map endpoints. Sorted maps are ordered collections of
+* (id, value, sortKey) triples; consumers create, read, update, list,
+* and delete items keyed by a caller-supplied identifier and ordered
+* by an optional string or numeric sort key.
+*/
+var MemoryStoreSortedMapsGroup = class {
+	#inner;
+	/**
+	* 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) {
+		this.#inner = inner;
+	}
+	/**
+	* Creates a single item in a sorted map. The sorted map is
+	* auto-created on first use; the map identifier is any string the
+	* caller picks. Items are keyed by `itemId` (case-sensitive) and
+	* ordered by an optional `sortKey`. Items expire and are removed
+	* automatically after `ttl` seconds, or after a server-default
+	* lifetime when omitted.
+	*
+	* On 5xx, create does not retry: Roblox Open Cloud has no
+	* idempotency-key support, so a retry of a transient failure risks
+	* producing a duplicate item.
+	*
+	* @param parameters - Universe, sorted-map, item identifiers, the
+	*   value to store, and optional `sortKey` 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 SortedMapItem}
+	*   or the {@link OpenCloudError} that caused the request to fail.
+	*/
+	async create(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: CREATE_SPEC
+		});
+	}
+	/**
+	* Removes a single item from a sorted map. The call is idempotent:
+	* a second `delete` against the same item is a no-op once the
+	* server has dropped the row. The retry policy retries both 429
+	* and 5xx.
+	*
+	* @param parameters - Universe, sorted-map, and item identifiers.
+	* @param options - Optional per-request overrides.
+	* @returns A {@link Result} wrapping `undefined` on success or the
+	*   {@link OpenCloudError} that caused the request to fail.
+	*/
+	async delete(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: DELETE_SPEC
+		});
+	}
+	/**
+	* Reads a single item from a sorted map. Returns the parsed
+	* {@link SortedMapItem} with the server-recorded `etag` for use in
+	* subsequent conditional updates (once the SDK begins emitting
+	* `If-Match`; see the package README).
+	*
+	* @param parameters - Universe, sorted-map, and item identifiers.
+	* @param options - Optional per-request overrides.
+	* @returns A {@link Result} wrapping the parsed {@link SortedMapItem}
+	*   or the {@link OpenCloudError} that caused the request to fail.
+	*/
+	async get(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: GET_SPEC
+		});
+	}
+	/**
+	* Lists items in a sorted map. The server caps `maxPageSize` at
+	* `100` and defaults it to `1` when omitted, so callers explicitly
+	* pass `maxPageSize` to retrieve more than a single item per page.
+	* The `filter` parameter accepts a CEL expression on `id` and
+	* `sortKey` (operators `<`, `>`, `&&` only).
+	*
+	* @param parameters - Universe and sorted-map identifiers, plus
+	*   optional pagination and filter parameters.
+	* @param options - Optional per-request overrides.
+	* @returns A {@link Result} wrapping the parsed
+	*   {@link ListSortedMapItemsResult} or the {@link OpenCloudError}
+	*   that caused the request to fail.
+	*/
+	async list(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: LIST_SPEC
+		});
+	}
+	/**
+	* Updates a sorted-map item under PATCH semantics: omitted body
+	* fields are left unchanged on the server, supplied fields replace
+	* their existing values. Passing `allowMissing: true` creates the
+	* item when no row exists instead of returning 404.
+	*
+	* Retries 5xx because PATCH with the same body produces the same
+	* server state.
+	*
+	* @param parameters - Universe, sorted-map, and item identifiers,
+	*   plus any subset of `value`, `ttl`, `sortKey`, and
+	*   `allowMissing`.
+	* @param options - Optional per-request overrides.
+	* @returns A {@link Result} wrapping the parsed {@link SortedMapItem}
+	*   or the {@link OpenCloudError} that caused the request to fail.
+	*/
+	async update(parameters, options) {
+		return this.#inner.execute({
+			options,
+			parameters,
+			spec: UPDATE_SPEC
+		});
+	}
+};
+//#endregion
 //#region src/resources/storage/client.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.
+* {@link StorageClient.queues} Operation Group and memory-store sorted
+* maps via the {@link StorageClient.sortedMaps} Operation Group; a
+* future data-stores Operation Group slots in as a sibling on the same
+* client.
 *
 * Every method returns a `Result` so callers handle failure
 * explicitly; no thrown error ever escapes the client.
 *
+* @since 0.1.0
+*
 * @example
 *
 * ```ts
@@ -354,6 +839,8 @@ var MemoryStoreQueuesGroup = class {
 var StorageClient = class {
 	/** Memory-store queue Operation Group. */
 	queues;
+	/** Memory-store sorted-map Operation Group. */
+	sortedMaps;
 	/**
 	* Creates a new {@link StorageClient}. Configuration is frozen on
 	* construction; per-request overrides are accepted on each method.
@@ -363,6 +850,7 @@ var StorageClient = class {
 	constructor(options) {
 		const inner = new ResourceClient(options);
 		this.queues = new MemoryStoreQueuesGroup(inner);
+		this.sortedMaps = new MemoryStoreSortedMapsGroup(inner);
 	}
 };
 //#endregion