@struktoai/mirage-browser 0.0.5 → 0.0.7-alpha.1

package/dist/resource/r2/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/resource/r2/config.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,yCAAyC,CAAA;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAGvF,QAAA,MAAM,cAAc;;;;;;;;;iBAA2D,CAAA;AAE/E,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,cAAc,CAAC,CAAA;AAEtD,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAA;AAW/E,eAAO,MAAM,kBAAkB,0CAAyB,CAAA;AACxD,eAAO,MAAM,YAAY,oFAAmB,CAAA;AAC5C,eAAO,MAAM,cAAc,wCAAe,CAAA;AAC1C,eAAO,MAAM,iBAAiB,8CAAkB,CAAA"}

package/dist/resource/r2/config.js

@@ -0,0 +1,26 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { z } from '@struktoai/mirage-core/resource/secrets';
+import { browserAliasSchema, derivedEndpoint, makeBrowserS3Alias } from "../s3_alias.js";
+const R2ConfigSchema = browserAliasSchema({ accountId: z.string().optional() });
+const alias = makeBrowserS3Alias({
+    schema: R2ConfigSchema,
+    endpointFor: derivedEndpoint('accountId', (accountId) => `https://${accountId}.r2.cloudflarestorage.com`),
+    regionDefault: 'auto',
+});
+export const resolvedR2Endpoint = alias.resolvedEndpoint;
+export const r2ToS3Config = alias.toS3Config;
+export const redactR2Config = alias.redact;
+export const normalizeR2Config = alias.normalize;
+//# sourceMappingURL=config.js.map

package/dist/resource/r2/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/resource/r2/config.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,CAAC,EAAE,MAAM,yCAAyC,CAAA;AAE3D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExF,MAAM,cAAc,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;AAM/E,MAAM,KAAK,GAAG,kBAAkB,CAA6B;IAC3D,MAAM,EAAE,cAAc;IACtB,WAAW,EAAE,eAAe,CAC1B,WAAW,EACX,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,SAAS,2BAA2B,CAC/D;IACD,aAAa,EAAE,MAAM;CACtB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,gBAAgB,CAAA;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAA;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAA;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC,SAAS,CAAA"}

package/dist/resource/r2/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const R2_BROWSER_PROMPT = "{prefix}\n  Remote Cloudflare R2 bucket accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/resource/r2/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/resource/r2/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,iBAAiB,6UAI8C,CAAA"}

package/dist/resource/r2/prompt.js

@@ -0,0 +1,19 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+export const R2_BROWSER_PROMPT = `{prefix}
+  Remote Cloudflare R2 bucket accessed via presigned URLs (browser runtime).
+  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.
+  Listing operations require the presigner to sign LIST/COPY operations in
+  addition to GET/PUT/HEAD/DELETE — see S3BrowserPresignedUrlProvider docs.`;
+//# sourceMappingURL=prompt.js.map

package/dist/resource/r2/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/resource/r2/prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;4EAI2C,CAAA"}

package/dist/resource/r2/r2.d.ts

@@ -0,0 +1,8 @@
+import { S3AliasResource, type S3AliasResourceState } from '../s3_alias.ts';
+import { type R2Config, type R2ConfigRedacted } from './config.ts';
+export type R2ResourceState = S3AliasResourceState<R2ConfigRedacted>;
+export declare class R2Resource extends S3AliasResource<R2Config, R2ConfigRedacted> {
+    readonly prompt: string;
+    constructor(config: R2Config);
+}
+//# sourceMappingURL=r2.d.ts.map

package/dist/resource/r2/r2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.d.ts","sourceRoot":"","sources":["../../../src/resource/r2/r2.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EAAgC,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGhG,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC,gBAAgB,CAAC,CAAA;AAEpE,qBAAa,UAAW,SAAQ,eAAe,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACzE,SAAkB,MAAM,EAAE,MAAM,CAAoB;gBAExC,MAAM,EAAE,QAAQ;CAG7B"}

package/dist/resource/r2/r2.js

@@ -0,0 +1,24 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { ResourceName } from '@struktoai/mirage-core/types';
+import { S3AliasResource } from "../s3_alias.js";
+import { r2ToS3Config, redactR2Config } from "./config.js";
+import { R2_BROWSER_PROMPT } from "./prompt.js";
+export class R2Resource extends S3AliasResource {
+    prompt = R2_BROWSER_PROMPT;
+    constructor(config) {
+        super(ResourceName.R2, config, r2ToS3Config(config), redactR2Config);
+    }
+}
+//# sourceMappingURL=r2.js.map

package/dist/resource/r2/r2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.js","sourceRoot":"","sources":["../../../src/resource/r2/r2.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,eAAe,EAA6B,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAwC,MAAM,aAAa,CAAA;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAI/C,MAAM,OAAO,UAAW,SAAQ,eAA2C;IACvD,MAAM,GAAW,iBAAiB,CAAA;IAEpD,YAAY,MAAgB;QAC1B,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAA;IACtE,CAAC;CACF"}

package/dist/resource/redis/redis.d.ts

@@ -0,0 +1,17 @@
+import { RedisResourceBase } from '@struktoai/mirage-core/resource/redis/redis';
+import { UpstashRedisStore, type UpstashRedisStoreOptions } from './store.ts';
+export type { RedisResourceState } from '@struktoai/mirage-core/resource/redis/redis';
+export type RedisResourceOptions = UpstashRedisStoreOptions;
+/**
+ * The browser redis mount: the shared resource over Upstash's REST api.
+ *
+ * A page cannot open a socket, so the store speaks HTTP to Upstash, or to
+ * serverless-redis-http in front of any redis. It takes the redis url the
+ * node and python mounts take, and the keyspace is the one they use, so one
+ * configuration and one database serve all three.
+ */
+export declare class RedisResource extends RedisResourceBase {
+    readonly store: UpstashRedisStore;
+    constructor(options: RedisResourceOptions);
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/resource/redis/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/resource/redis/redis.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAE7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAA;AAErF,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,CAAA;AAE3D;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,iBAAiB;IAClD,SAAiB,KAAK,EAAE,iBAAiB,CAAA;gBAE7B,OAAO,EAAE,oBAAoB;CAG1C"}

package/dist/resource/redis/redis.js

@@ -0,0 +1,29 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { RedisResourceBase } from '@struktoai/mirage-core/resource/redis/redis';
+import { UpstashRedisStore } from "./store.js";
+/**
+ * The browser redis mount: the shared resource over Upstash's REST api.
+ *
+ * A page cannot open a socket, so the store speaks HTTP to Upstash, or to
+ * serverless-redis-http in front of any redis. It takes the redis url the
+ * node and python mounts take, and the keyspace is the one they use, so one
+ * configuration and one database serve all three.
+ */
+export class RedisResource extends RedisResourceBase {
+    constructor(options) {
+        super(new UpstashRedisStore(options));
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/resource/redis/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../../src/resource/redis/redis.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAiC,MAAM,YAAY,CAAA;AAM7E;;;;;;;GAOG;AACH,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAGlD,YAAY,OAA6B;QACvC,KAAK,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAA;IACvC,CAAC;CACF"}

package/dist/resource/redis/store.d.ts

@@ -0,0 +1,75 @@
+import type { RedisRestore, RedisStoreLike } from '@struktoai/mirage-core/resource/redis/store';
+export interface UpstashRedisStoreOptions {
+    /**
+     * The redis url the Upstash console prints,
+     * `rediss://default:<token>@<name>.upstash.io:6379`, which is the url the
+     * node and python mounts take; or the REST url, `https://<name>.upstash.io`,
+     * with `token` beside it.
+     */
+    url: string;
+    /**
+     * The REST token. Required with a REST url; a redis url carries it as its
+     * password. Read-only tokens cannot SCAN, which readdir needs.
+     */
+    token?: string;
+    keyPrefix?: string;
+    fetchImpl?: typeof fetch;
+    maxRequestBytes?: number;
+}
+/**
+ * The redis keyspace over Upstash's REST API, so a browser page can mount
+ * redis with no socket. Anything that answers that API serves: Upstash
+ * itself, or serverless-redis-http in front of any redis. It is configured
+ * with the same redis url as the node and python mounts (see `restTarget`).
+ *
+ * Bytes need care, because a JSON command array carries UTF-8 strings and
+ * nothing else. Writes therefore use the path form, `POST /set/<key>` with
+ * the raw body as the last argument, and reads ask for `Upstash-Encoding:
+ * base64`, which encodes every bulk string in the reply. Both keep the stored
+ * value byte-identical to what the node and python stores write, so one
+ * database serves all three runtimes. The one thing the path form cannot
+ * carry is an empty body, which the server reads as a missing argument, so an
+ * empty file is written through the JSON form instead.
+ */
+export declare class UpstashRedisStore implements RedisStoreLike {
+    readonly url: string;
+    readonly keyPrefix: string;
+    private readonly token;
+    private readonly fetchImpl;
+    private readonly maxRequestBytes;
+    constructor(options: UpstashRedisStoreOptions);
+    fk(path: string): string;
+    dk(): string;
+    mk(path: string): string;
+    ak(path: string): string;
+    private request;
+    private command;
+    private pipeline;
+    private raw;
+    private integer;
+    private scan;
+    open(): Promise<void>;
+    getFile(path: string): Promise<Uint8Array | null>;
+    getFileRange(path: string, offset: number, size: number | null): Promise<Uint8Array | null>;
+    setFile(path: string, data: Uint8Array): Promise<void>;
+    delFile(path: string): Promise<void>;
+    hasFile(path: string): Promise<boolean>;
+    listFiles(prefix?: string): Promise<string[]>;
+    fileLen(path: string): Promise<number>;
+    hasDir(path: string): Promise<boolean>;
+    addDir(path: string): Promise<void>;
+    removeDir(path: string): Promise<void>;
+    listDirs(): Promise<Set<string>>;
+    getModified(path: string): Promise<string | null>;
+    setModified(path: string, ts: string): Promise<void>;
+    delModified(path: string): Promise<void>;
+    getAttrs(path: string): Promise<Record<string, string>>;
+    setAttrs(path: string, fields: Record<string, string>): Promise<void>;
+    delAttrs(path: string): Promise<void>;
+    listAttrs(): Promise<Record<string, Record<string, string>>>;
+    listModified(): Promise<Record<string, string>>;
+    restore(state: RedisRestore): Promise<void>;
+    clear(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/resource/redis/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/resource/redis/store.ts"],"names":[],"mappings":"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"}

package/dist/resource/redis/store.js

@@ -0,0 +1,381 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { decodeBase64 } from '@struktoai/mirage-core/utils/base64';
+import { escapeGlob } from '@struktoai/mirage-core/core/redis/utils';
+import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
+import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
+// Upstash caps one REST request at 10 MB on every plan, so a file above this
+// goes out as one SET followed by APPENDs, each under the cap with headroom,
+// and a DEL or a pipeline is packed to the same budget by serialized size,
+// with KEY_BATCH keys as a ceiling on top for a reply that has to fit too.
+const DEFAULT_MAX_REQUEST_BYTES = 8 * 1024 * 1024;
+const SCAN_COUNT = 1000;
+const KEY_BATCH = 500;
+const UTF8 = new TextEncoder();
+/**
+ * Where the requests go and what they carry. Upstash hands out one secret
+ * that is both the database password and the REST token, so the redis url
+ * the node and python mounts take names the REST listener too: `https://`
+ * on the same host, with the password as the bearer token. A REST url needs
+ * `token` beside it, which is the form a serverless-redis-http front takes,
+ * since its token is its own setting and not a redis password. No message
+ * echoes the url, because a redis url carries the secret.
+ */
+function restTarget(options) {
+    if (typeof options.url !== 'string' || options.url === '') {
+        throw new Error('redis: url is required, the redis url or the REST url from the Upstash console');
+    }
+    let parsed;
+    try {
+        parsed = new URL(options.url);
+    }
+    catch {
+        throw new Error('redis: url must be a redis:// or rediss:// url, or an https:// REST url');
+    }
+    if (parsed.protocol === 'redis:' || parsed.protocol === 'rediss:') {
+        const token = parsed.password === '' ? (options.token ?? '') : decodeURIComponent(parsed.password);
+        if (token === '') {
+            throw new Error('redis: a redis url needs its password, which the Upstash console prints as the token; ' +
+                'put it in the url or pass it as token');
+        }
+        return { base: `https://${parsed.hostname}`, token };
+    }
+    if (parsed.protocol === 'https:' || parsed.protocol === 'http:') {
+        if (typeof options.token !== 'string' || options.token === '') {
+            throw new Error('redis: token is required, the database REST token from the Upstash console');
+        }
+        return { base: rstripSlash(options.url), token: options.token };
+    }
+    throw new Error('redis: url must be a redis:// or rediss:// url, or an https:// REST url');
+}
+function unwrap(payload) {
+    if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) {
+        throw new Error('upstash: reply is not an object');
+    }
+    const error = payload.error;
+    if (typeof error === 'string')
+        throw new Error(`upstash: ${error}`);
+    return payload.result ?? null;
+}
+function expectString(value, command) {
+    if (typeof value !== 'string')
+        throw new Error(`upstash: ${command} did not answer a string`);
+    return value;
+}
+function expectStrings(value, command) {
+    if (!Array.isArray(value))
+        throw new Error(`upstash: ${command} did not answer an array`);
+    return value.map((item) => expectString(item, command));
+}
+/**
+ * Splits `items` into runs whose JSON array stays within `limit` UTF-8 bytes
+ * and KEY_BATCH entries. An item that alone outgrows the limit still goes out,
+ * on its own, so the server is the one to refuse it rather than a silent drop.
+ */
+function packJson(items, limit) {
+    const runs = [];
+    let run = [];
+    let bytes = 2;
+    for (const item of items) {
+        const size = UTF8.encode(JSON.stringify(item)).byteLength + 1;
+        if (run.length > 0 && (run.length >= KEY_BATCH || bytes + size > limit)) {
+            runs.push(run);
+            run = [];
+            bytes = 2;
+        }
+        run.push(item);
+        bytes += size;
+    }
+    if (run.length > 0)
+        runs.push(run);
+    return runs;
+}
+function pairsToRecord(flat) {
+    const out = {};
+    for (let i = 0; i + 1 < flat.length; i += 2) {
+        out[flat[i] ?? ''] = flat[i + 1] ?? '';
+    }
+    return out;
+}
+/**
+ * The redis keyspace over Upstash's REST API, so a browser page can mount
+ * redis with no socket. Anything that answers that API serves: Upstash
+ * itself, or serverless-redis-http in front of any redis. It is configured
+ * with the same redis url as the node and python mounts (see `restTarget`).
+ *
+ * Bytes need care, because a JSON command array carries UTF-8 strings and
+ * nothing else. Writes therefore use the path form, `POST /set/<key>` with
+ * the raw body as the last argument, and reads ask for `Upstash-Encoding:
+ * base64`, which encodes every bulk string in the reply. Both keep the stored
+ * value byte-identical to what the node and python stores write, so one
+ * database serves all three runtimes. The one thing the path form cannot
+ * carry is an empty body, which the server reads as a missing argument, so an
+ * empty file is written through the JSON form instead.
+ */
+export class UpstashRedisStore {
+    url;
+    keyPrefix;
+    token;
+    fetchImpl;
+    maxRequestBytes;
+    constructor(options) {
+        const target = restTarget(options);
+        this.url = target.base;
+        this.token = target.token;
+        this.keyPrefix = options.keyPrefix ?? 'mirage:fs:';
+        this.fetchImpl = options.fetchImpl ?? fetch.bind(globalThis);
+        const limit = options.maxRequestBytes ?? DEFAULT_MAX_REQUEST_BYTES;
+        if (!Number.isInteger(limit) || limit <= 0) {
+            throw new Error('redis: maxRequestBytes must be a positive integer');
+        }
+        this.maxRequestBytes = limit;
+    }
+    fk(path) {
+        return `${this.keyPrefix}file:${path}`;
+    }
+    dk() {
+        return `${this.keyPrefix}dir`;
+    }
+    mk(path) {
+        return `${this.keyPrefix}modified:${path}`;
+    }
+    ak(path) {
+        return `${this.keyPrefix}attrs:${path}`;
+    }
+    async request(path, body, contentType, base64) {
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            'Content-Type': contentType,
+        };
+        if (base64)
+            headers['Upstash-Encoding'] = 'base64';
+        let response;
+        try {
+            response = await this.fetchImpl(`${this.url}${path}`, { method: 'POST', headers, body });
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new Error(`upstash: cannot reach ${this.url} (${reason}); a page needs a REST listener at this ` +
+                'host, Upstash itself or serverless-redis-http in front of the redis');
+        }
+        const text = await response.text();
+        let payload;
+        try {
+            payload = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`upstash: HTTP ${String(response.status)} with a non-JSON body`);
+        }
+        if (!response.ok) {
+            const message = payload !== null &&
+                typeof payload === 'object' &&
+                !Array.isArray(payload) &&
+                typeof payload.error === 'string'
+                ? payload.error
+                : text;
+            throw new Error(`upstash: HTTP ${String(response.status)}: ${message}`);
+        }
+        return payload;
+    }
+    async command(args, base64 = false) {
+        return unwrap(await this.request('', JSON.stringify(args), 'application/json', base64));
+    }
+    async pipeline(commands, base64 = false) {
+        const replies = [];
+        for (const run of packJson(commands, this.maxRequestBytes)) {
+            const payload = await this.request('/pipeline', JSON.stringify(run), 'application/json', base64);
+            if (!Array.isArray(payload))
+                throw new Error('upstash: pipeline did not answer an array');
+            for (const item of payload)
+                replies.push(unwrap(item));
+        }
+        return replies;
+    }
+    async raw(command, key, data) {
+        unwrap(await this.request(`/${command}/${encodeURIComponent(key)}`, data, 'application/octet-stream', false));
+    }
+    async integer(args) {
+        const reply = await this.command(args);
+        if (typeof reply !== 'number') {
+            throw new Error(`upstash: ${String(args[0])} did not answer an integer`);
+        }
+        return reply;
+    }
+    async scan(pattern) {
+        const keys = [];
+        let cursor = '0';
+        do {
+            const reply = await this.command(['SCAN', cursor, 'MATCH', pattern, 'COUNT', SCAN_COUNT]);
+            if (!Array.isArray(reply) || reply.length !== 2) {
+                throw new Error('upstash: SCAN did not answer a cursor and a page');
+            }
+            cursor = expectString(reply[0] ?? null, 'SCAN');
+            for (const key of expectStrings(reply[1] ?? null, 'SCAN'))
+                keys.push(key);
+        } while (cursor !== '0');
+        return keys;
+    }
+    async open() {
+        await this.command(['SADD', this.dk(), '/']);
+    }
+    async getFile(path) {
+        const reply = await this.command(['GET', this.fk(path)], true);
+        if (reply === null)
+            return null;
+        return decodeBase64(expectString(reply, 'GET'));
+    }
+    async getFileRange(path, offset, size) {
+        const key = this.fk(path);
+        // GETRANGE 0 -1 means the whole value, not an empty window.
+        if (size === 0)
+            return (await this.integer(['EXISTS', key])) === 0 ? null : new Uint8Array(0);
+        const end = size === null ? -1 : offset + size - 1;
+        const [exists, raw] = await this.pipeline([
+            ['EXISTS', key],
+            ['GETRANGE', key, offset, end],
+        ], true);
+        if (exists === 0)
+            return null;
+        return decodeBase64(expectString(raw ?? null, 'GETRANGE'));
+    }
+    async setFile(path, data) {
+        const key = this.fk(path);
+        if (data.byteLength === 0) {
+            await this.command(['SET', key, '']);
+            return;
+        }
+        const limit = this.maxRequestBytes;
+        if (data.byteLength <= limit) {
+            await this.raw('set', key, data);
+            return;
+        }
+        // A chunked write lands on a staging key and is renamed in only once every
+        // chunk arrived, so a failed chunk never leaves a truncated file behind and
+        // two writers of one path never interleave: the mount keeps the single-SET
+        // semantics of the node and python stores.
+        const staging = `${this.keyPrefix}tmp:${path}:${crypto.randomUUID()}`;
+        try {
+            await this.raw('set', staging, data.subarray(0, limit));
+            for (let offset = limit; offset < data.byteLength; offset += limit) {
+                await this.raw('append', staging, data.subarray(offset, offset + limit));
+            }
+            await this.command(['RENAME', staging, key]);
+        }
+        catch (err) {
+            await this.command(['DEL', staging]);
+            throw err;
+        }
+    }
+    async delFile(path) {
+        await this.command(['DEL', this.fk(path)]);
+    }
+    async hasFile(path) {
+        return (await this.integer(['EXISTS', this.fk(path)])) > 0;
+    }
+    async listFiles(prefix = '') {
+        const head = `${this.keyPrefix}file:`;
+        const keys = await this.scan(`${escapeGlob(`${head}${prefix}`)}*`);
+        return keys.map((key) => key.slice(head.length)).sort(compareCodePoints);
+    }
+    fileLen(path) {
+        return this.integer(['STRLEN', this.fk(path)]);
+    }
+    async hasDir(path) {
+        return (await this.integer(['SISMEMBER', this.dk(), path])) === 1;
+    }
+    async addDir(path) {
+        await this.command(['SADD', this.dk(), path]);
+    }
+    async removeDir(path) {
+        await this.command(['SREM', this.dk(), path]);
+    }
+    async listDirs() {
+        return new Set(expectStrings(await this.command(['SMEMBERS', this.dk()]), 'SMEMBERS'));
+    }
+    async getModified(path) {
+        const reply = await this.command(['GET', this.mk(path)]);
+        return reply === null ? null : expectString(reply, 'GET');
+    }
+    async setModified(path, ts) {
+        await this.command(['SET', this.mk(path), ts]);
+    }
+    async delModified(path) {
+        await this.command(['DEL', this.mk(path)]);
+    }
+    async getAttrs(path) {
+        return pairsToRecord(expectStrings(await this.command(['HGETALL', this.ak(path)]), 'HGETALL'));
+    }
+    async setAttrs(path, fields) {
+        const flat = Object.entries(fields).flat();
+        if (flat.length === 0)
+            return;
+        await this.command(['HSET', this.ak(path), ...flat]);
+    }
+    async delAttrs(path) {
+        await this.command(['DEL', this.ak(path)]);
+    }
+    async listAttrs() {
+        const head = `${this.keyPrefix}attrs:`;
+        const keys = await this.scan(`${escapeGlob(head)}*`);
+        const replies = await this.pipeline(keys.map((key) => ['HGETALL', key]));
+        const out = {};
+        keys.forEach((key, i) => {
+            out[key.slice(head.length)] = pairsToRecord(expectStrings(replies[i] ?? null, 'HGETALL'));
+        });
+        return out;
+    }
+    async listModified() {
+        const head = `${this.keyPrefix}modified:`;
+        const keys = await this.scan(`${escapeGlob(head)}*`);
+        const replies = await this.pipeline(keys.map((key) => ['GET', key]));
+        const out = {};
+        keys.forEach((key, i) => {
+            const reply = replies[i] ?? null;
+            if (reply !== null)
+                out[key.slice(head.length)] = expectString(reply, 'GET');
+        });
+        return out;
+    }
+    async restore(state) {
+        for (const [path, data] of Object.entries(state.files)) {
+            await this.setFile(path, data);
+        }
+        const commands = [];
+        for (const dir of state.dirs)
+            commands.push(['SADD', this.dk(), dir]);
+        for (const [path, fields] of Object.entries(state.attrs)) {
+            const flat = Object.entries(fields).flat();
+            if (flat.length > 0)
+                commands.push(['HSET', this.ak(path), ...flat]);
+        }
+        for (const [path, ts] of Object.entries(state.modified)) {
+            commands.push(['SET', this.mk(path), ts]);
+        }
+        await this.pipeline(commands);
+    }
+    async clear() {
+        const p = escapeGlob(this.keyPrefix);
+        for (const pattern of [`${p}file:*`, `${p}tmp:*`, `${p}modified:*`, `${p}attrs:*`]) {
+            const keys = await this.scan(pattern);
+            for (const run of packJson(keys, this.maxRequestBytes - '"DEL",'.length)) {
+                await this.command(['DEL', ...run]);
+            }
+        }
+        await this.command(['DEL', this.dk()]);
+    }
+    close() {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=store.js.map