pyric-admin 0.1.0-alpha.10

package/dist/storage/index.d.ts

@@ -0,0 +1,159 @@
+/**
+ * `pyric-admin/storage` — sandbox mirror for the Admin Storage shape.
+ *
+ * Mirrors the useful `firebase-admin/storage` shape for local and remote
+ * sandbox apps selected at {@link initializeApp} time. Dispatch reads the
+ * {@link ADMIN_APP_TARGET} brand on the `PyricAdminApp` handle.
+ *
+ *   - **Remote sandbox path** — a handle branded by `@pyric/cli`'
+ *     `connectRemoteSandbox()`/`remoteSandbox()` relays every data
+ *     operation over the bridge to the browser-hosted SharedWorker's
+ *     object store (admin lens pinned — rules bypass). Single bucket;
+ *     8 MiB per-op byte cap; `getSignedUrl` stays the local stub. See
+ *     the remote arm section below.
+ *
+ *   - **Sandbox path** — returns an in-process {@link Storage} backed
+ *     by an in-memory `Map<bucketName, Map<path, FileEntry>>`. State
+ *     lives on the {@link Sandbox} via a `WeakMap`, so `sandbox.reset()`
+ *     wipes it alongside Firestore / Auth state. Multi-bucket isolation
+ *     is real — buckets are independent maps.
+ *
+ *     Supported sandbox surface (the minimum a session-archive flow
+ *     needs):
+ *       - `storage.bucket(name?)` → {@link Bucket}-shaped handle
+ *       - `bucket.file(path)` → {@link File}-shaped handle
+ *       - `file.save(data, options?)` — `Buffer | string | Uint8Array`
+ *       - `file.download(options?)` → `[Buffer]`
+ *       - `file.delete()` — idempotent
+ *       - `file.exists()` → `[boolean]`
+ *       - `file.getSignedUrl(options)` → `['pyric-sandbox-storage://…']`
+ *
+ *     **Deferred in the sandbox backend** (throws `"not implemented in
+ *     pyric-admin/storage sandbox backend"`): streaming uploads
+ *     (`createWriteStream`), resumable uploads, signed cookies, IAM
+ *     policies, lifecycle rules, ACLs, copy/move, notifications.
+ */
+import { type PyricAdminApp } from '../app/index.js';
+/**
+ * `pyric-admin/storage`'s sandbox `Storage` handle. It exposes the subset
+ * documented in the module header.
+ *
+ * The shared `bucket(name?)` shape is the contract — consumers code
+ * against it without caring whether the local or remote sandbox is live.
+ */
+export interface Storage {
+    /**
+     * Get a {@link Bucket} handle. When `name` is omitted, returns the
+     * sandbox default bucket (`'pyric-default'`).
+     */
+    bucket(name?: string): Bucket;
+}
+/**
+ * A storage bucket handle implemented by both local and remote sandbox
+ * paths. Only the documented subset is supported.
+ */
+export interface Bucket {
+    /** Name of the bucket. Stable across `file()` lookups. */
+    readonly name: string;
+    /** Get a {@link File} handle for `path`. The file may or may not exist. */
+    file(path: string): File;
+}
+/**
+ * A file handle within a bucket. Method shapes mirror
+ * `@google-cloud/storage`'s `File` (return tuples for download / exists
+ * / getSignedUrl, etc.) so common consumer code retains the familiar shape.
+ *
+ * The sandbox backend implements the methods documented here. Any
+ * other `File` method from `@google-cloud/storage` (`createWriteStream`,
+ * `createReadStream`, `copy`, `move`, `setMetadata` beyond the basic
+ * `save` options, etc.) throws on the sandbox path — see module header.
+ */
+export interface File {
+    /** Name (path) of the file within its bucket. */
+    readonly name: string;
+    /** Bucket the file belongs to. Same handle the `file()` call came from. */
+    readonly bucket: Bucket;
+    /**
+     * Persist `data` at this file's path. Replaces any existing content
+     * (no append semantics). `options.metadata` is stored alongside the
+     * bytes and surfaces on later reads via the in-memory state — the
+     * sandbox doesn't expose a full `Metadata` API yet, but the payload
+     * round-trips so future expansion is non-breaking.
+     */
+    save(data: Buffer | string | Uint8Array, options?: SaveOptions): Promise<void>;
+    /**
+     * Read the file's bytes. Returns a `[Buffer]` tuple to mirror
+     * `@google-cloud/storage`'s `File.download` (which returns
+     * `[Buffer, ...]`). Throws if the file does not exist.
+     */
+    download(options?: DownloadOptions): Promise<[Buffer]>;
+    /**
+     * Remove the file from its bucket. Idempotent — deleting a missing
+     * file is a no-op (matches `@google-cloud/storage`'s
+     * `ignoreNotFound: true`, which is the only mode the sandbox models).
+     */
+    delete(): Promise<void>;
+    /** `[true]` if the file exists, `[false]` otherwise. Tuple shape mirrors `@google-cloud/storage`. */
+    exists(): Promise<[boolean]>;
+    /**
+     * Return a stub signed URL of the form
+     * `pyric-sandbox-storage://${path}?expires=${expires}`. The sandbox
+     * does NOT serve the URL — it's a deterministic placeholder so
+     * agent code that round-trips signed URLs (logs, fixtures, replay)
+     * sees a stable shape.
+     */
+    getSignedUrl(options: GetSignedUrlOptions): Promise<[string]>;
+}
+/** Options bag for {@link File.save}. Subset of `@google-cloud/storage`'s `SaveOptions`. */
+export interface SaveOptions {
+    /**
+     * Arbitrary metadata stored alongside the file. The sandbox stores
+     * it verbatim; consumers that need to round-trip `contentType`,
+     * `metadata.custom`, etc. get it back via internal admin tooling
+     * (not exposed on `File` itself yet).
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Content type hint stored on the sandbox entry.
+     * Convenience shortcut for `metadata.contentType`.
+     */
+    contentType?: string;
+    /**
+     * `resumable: false` is the only mode the sandbox models (single-
+     * shot writes). The sandbox throws when set to `true` since resumable
+     * uploads are deferred.
+     */
+    resumable?: boolean;
+}
+/** Options bag for {@link File.download}. Subset of `@google-cloud/storage`'s `DownloadOptions`. */
+export interface DownloadOptions {
+    /** The sandbox accepts but ignores `validation`. */
+    validation?: 'md5' | 'crc32c' | boolean;
+}
+/** Options bag for {@link File.getSignedUrl}. Mirrors `@google-cloud/storage`'s shape. */
+export interface GetSignedUrlOptions {
+    /** `'read' | 'write' | 'delete' | 'resumable'`. Sandbox stamps it into the URL only as a hint. */
+    action: 'read' | 'write' | 'delete' | 'resumable';
+    /**
+     * Expiration. Accepts ms-since-epoch (number), ISO date string, or
+     * `Date`. Sandbox normalizes to ms-since-epoch and embeds in the
+     * stub URL's `expires=` query.
+     */
+    expires: number | string | Date;
+}
+/**
+ * Input accepted by {@link getStorage}. The branded `PyricAdminApp` is
+ * the canonical shape; calling without an argument resolves the default
+ * app from the `pyric-admin/app` registry (mirroring
+ * `firebase-admin/storage`, where `getStorage()` resolves the default App),
+ * and throws the captured `app/no-app` error when nothing is initialized.
+ */
+export type StorageApp = PyricAdminApp;
+/**
+ * Get the {@link Storage} service for the given app.
+ *
+ * Returns a sandbox-backed `Storage` whose state
+ *   lives on the `Sandbox`. `sandbox.reset()` wipes it.
+ */
+export declare function getStorage(app?: StorageApp): Storage;
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AASH,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,iBAAiB,CAAC;AAKzB;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAI;IACnB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,qGAAqG;IACrG,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7B;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;CAC/D;AAED,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;CACzC;AAED,0FAA0F;AAC1F,MAAM,WAAW,mBAAmB;IAClC,kGAAkG;IAClG,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;IAClD;;;;OAIG;IACH,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAuBpD"}

package/dist/storage/index.js

@@ -0,0 +1,413 @@
+/**
+ * `pyric-admin/storage` — sandbox mirror for the Admin Storage shape.
+ *
+ * Mirrors the useful `firebase-admin/storage` shape for local and remote
+ * sandbox apps selected at {@link initializeApp} time. Dispatch reads the
+ * {@link ADMIN_APP_TARGET} brand on the `PyricAdminApp` handle.
+ *
+ *   - **Remote sandbox path** — a handle branded by `@pyric/cli`'
+ *     `connectRemoteSandbox()`/`remoteSandbox()` relays every data
+ *     operation over the bridge to the browser-hosted SharedWorker's
+ *     object store (admin lens pinned — rules bypass). Single bucket;
+ *     8 MiB per-op byte cap; `getSignedUrl` stays the local stub. See
+ *     the remote arm section below.
+ *
+ *   - **Sandbox path** — returns an in-process {@link Storage} backed
+ *     by an in-memory `Map<bucketName, Map<path, FileEntry>>`. State
+ *     lives on the {@link Sandbox} via a `WeakMap`, so `sandbox.reset()`
+ *     wipes it alongside Firestore / Auth state. Multi-bucket isolation
+ *     is real — buckets are independent maps.
+ *
+ *     Supported sandbox surface (the minimum a session-archive flow
+ *     needs):
+ *       - `storage.bucket(name?)` → {@link Bucket}-shaped handle
+ *       - `bucket.file(path)` → {@link File}-shaped handle
+ *       - `file.save(data, options?)` — `Buffer | string | Uint8Array`
+ *       - `file.download(options?)` → `[Buffer]`
+ *       - `file.delete()` — idempotent
+ *       - `file.exists()` → `[boolean]`
+ *       - `file.getSignedUrl(options)` → `['pyric-sandbox-storage://…']`
+ *
+ *     **Deferred in the sandbox backend** (throws `"not implemented in
+ *     pyric-admin/storage sandbox backend"`): streaming uploads
+ *     (`createWriteStream`), resumable uploads, signed cookies, IAM
+ *     policies, lifecycle rules, ACLs, copy/move, notifications.
+ */
+import { isRemoteSandbox, } from 'pyric/sandbox';
+import { ADMIN_APP_TARGET, getApp, } from '../app/index.js';
+import { assertAdminAppActive } from '../app/lifecycle.js';
+/**
+ * Get the {@link Storage} service for the given app.
+ *
+ * Returns a sandbox-backed `Storage` whose state
+ *   lives on the `Sandbox`. `sandbox.reset()` wipes it.
+ */
+export function getStorage(app) {
+    // No-arg call resolves the default app; nothing initialized → captured
+    // `app/no-app` FirebaseAppError (see pyric-admin/app getApp).
+    const resolved = app === undefined ? getApp() : app;
+    assertAdminAppActive(resolved);
+    if (resolved[ADMIN_APP_TARGET] === 'sandbox') {
+        // Remote brand checked BEFORE the local arm (same dispatch order as
+        // auth/database): the local arm's WeakMap state + `onEvent` reset hook
+        // must never touch a remote handle — local state keyed off a remote
+        // handle would be a private server-side store the browser never sees,
+        // and `onEvent` throws on remote handles by design.
+        if (isRemoteSandbox(resolved.sandbox)) {
+            return getRemoteStorage(resolved.sandbox);
+        }
+        return getSandboxStorage(resolved);
+    }
+    // Defensive: the union is closed at the type level. A runtime value
+    // that lands here means a caller forged a handle without going
+    // through `initializeApp`.
+    throw new TypeError('pyric-admin/storage: getStorage expected a PyricAdminApp from `initializeApp`; ' +
+        'received a value with no recognized ADMIN_APP_TARGET brand.');
+}
+// ─── Sandbox path ───────────────────────────────────────────────────────
+/**
+ * Default sandbox bucket name. Matches the `pyric-default` used by the
+ * `pyric/storage` modular sandbox so consumers that switch between
+ * surfaces don't see an unexpected bucket name change.
+ */
+const DEFAULT_SANDBOX_BUCKET = 'pyric-default';
+/**
+ * State + reset-handler registry keyed on `Sandbox` so a single
+ * Sandbox shares its storage across every `getStorage` call. The
+ * `WeakMap` lets a discarded `Sandbox` (and its state) be GC'd
+ * naturally.
+ */
+const SANDBOX_STATE = new WeakMap();
+/**
+ * Reset-subscription bookkeeping. We subscribe to `sandbox.onEvent`
+ * once per Sandbox and re-create the bucket map on
+ * `session_boundary` events with `phase: 'reset'`. Without this,
+ * `sandbox.reset()` would wipe Firestore but leave storage untouched —
+ * a leak the sandbox model deliberately avoids.
+ */
+const RESET_HOOKED = new WeakSet();
+function ensureBucketMap(sandbox) {
+    let map = SANDBOX_STATE.get(sandbox);
+    if (!map) {
+        map = new Map();
+        SANDBOX_STATE.set(sandbox, map);
+    }
+    if (!RESET_HOOKED.has(sandbox)) {
+        RESET_HOOKED.add(sandbox);
+        sandbox.onEvent((event) => {
+            if (event.kind === 'session_boundary' && event.phase === 'reset') {
+                // Replace the map in place so existing Storage / Bucket / File
+                // handles keep working but observe an empty state.
+                const existing = SANDBOX_STATE.get(sandbox);
+                if (existing)
+                    existing.clear();
+            }
+        });
+    }
+    return map;
+}
+function getSandboxStorage(app) {
+    const sandbox = app.sandbox;
+    const buckets = ensureBucketMap(sandbox);
+    return new SandboxStorage(buckets);
+}
+/**
+ * Sandbox `Storage` implementation. Holds a reference to the per-
+ * sandbox bucket map; each `bucket()` call returns a fresh `Bucket`
+ * handle bound to the same underlying map, mirroring how
+ * `@google-cloud/storage` returns lightweight per-call handles.
+ */
+class SandboxStorage {
+    buckets;
+    constructor(buckets) {
+        this.buckets = buckets;
+    }
+    bucket(name) {
+        const bucketName = name ?? DEFAULT_SANDBOX_BUCKET;
+        let files = this.buckets.get(bucketName);
+        if (!files) {
+            files = new Map();
+            this.buckets.set(bucketName, files);
+        }
+        return new SandboxBucket(bucketName, files);
+    }
+}
+class SandboxBucket {
+    name;
+    files;
+    constructor(name, files) {
+        this.name = name;
+        this.files = files;
+    }
+    file(path) {
+        return new SandboxFile(path, this, this.files);
+    }
+}
+class SandboxFile {
+    name;
+    bucket;
+    files;
+    constructor(name, bucket, files) {
+        this.name = name;
+        this.bucket = bucket;
+        this.files = files;
+    }
+    async save(data, options = {}) {
+        if (options.resumable === true) {
+            throw new Error('not implemented in pyric-admin/storage sandbox backend: resumable uploads');
+        }
+        const bytes = toBytes(data);
+        const metadata = options.metadata ?? {};
+        const entry = {
+            data: bytes,
+            metadata,
+            ...(options.contentType !== undefined ? { contentType: options.contentType } : {}),
+        };
+        this.files.set(this.name, entry);
+    }
+    async download(_options = {}) {
+        const entry = this.files.get(this.name);
+        if (!entry) {
+            // Mirror the gcs/firebase-admin error message shape so consumer
+            // catch-blocks that string-match `No such object` keep working.
+            throw new Error(`No such object: ${this.bucket.name}/${this.name}`);
+        }
+        return [Buffer.from(entry.data)];
+    }
+    async delete() {
+        this.files.delete(this.name);
+    }
+    async exists() {
+        return [this.files.has(this.name)];
+    }
+    async getSignedUrl(options) {
+        return [stubSignedUrl(this.bucket.name, this.name, options)];
+    }
+    // ─── Deferred surface (declared so TS callers see a clear error) ────
+    /** @deprecated Streaming writes are deferred — see module header. */
+    createWriteStream() {
+        throw new Error('not implemented in pyric-admin/storage sandbox backend: createWriteStream');
+    }
+    /** @deprecated Streaming reads are deferred — see module header. */
+    createReadStream() {
+        throw new Error('not implemented in pyric-admin/storage sandbox backend: createReadStream');
+    }
+}
+// ─── Remote sandbox arm (remote sandbox, slice 2) ───────────────────────
+//
+// The app's `Sandbox` is a Node-side handle onto the browser-hosted
+// SharedWorker sandbox. Every data operation relays over the handle's
+// worker channel with `actAs: { mode: 'admin' }` pinned — firebase-admin's
+// rules-bypass semantics against the ONE object store the app + Studio +
+// agents share (the host resolves the lens to `pyric/storage/internal`'s
+// admin plane). There is deliberately NO local state here: a `WeakMap`
+// bucket map keyed off a remote handle would be private server-side data
+// the browser never sees, and the local arm's `onEvent` reset hook throws
+// on remote handles by design.
+//
+// Divergences from the local arm, all LOUD:
+//   - single bucket: the worker's `pyric/storage` store is single-bucket
+//     ("the data store is shared" — bucket names only round-trip in
+//     metadata), so `bucket('non-default')` throws instead of silently
+//     merging buckets. The default bucket name matches the local arm.
+//   - byte payloads are capped at 8 MiB per op (whole-object buffering
+//     over four relay hops; streaming stays unsupported on both sandbox arms).
+// `getSignedUrl` does NOT relay: it stays the byte-identical local stub.
+/** firebase-admin's rules-bypass lens, pinned on every relayed operation. */
+const STORAGE_REMOTE_ADMIN_LENS = { mode: 'admin' };
+/**
+ * Raw per-op byte cap for relayed storage payloads. MUST mirror
+ * `@pyric/cli`' `MAX_STORAGE_OP_BYTES` (serve/worker/protocol.ts) — the
+ * worker host enforces the same cap on its end. Inlined (like the RTDB
+ * push-id generator) because `pyric-admin` deliberately does not depend on
+ * `@pyric/cli`.
+ */
+const MAX_REMOTE_STORAGE_OP_BYTES = 8 * 1024 * 1024;
+/** One remote `Storage` per remote handle (handles only — never data). */
+const remoteStorageBySandbox = new WeakMap();
+function getRemoteStorage(sandbox) {
+    let storage = remoteStorageBySandbox.get(sandbox);
+    if (!storage) {
+        storage = new RemoteStorage(sandbox.channel);
+        remoteStorageBySandbox.set(sandbox, storage);
+    }
+    return storage;
+}
+class RemoteStorage {
+    channel;
+    constructor(channel) {
+        this.channel = channel;
+    }
+    bucket(name) {
+        // The worker's object store is single-bucket. A non-default name can't
+        // be faithfully relayed — throw loudly instead of silently merging
+        // buckets (the local arm has REAL multi-bucket isolation; this is the
+        // sharpest local/remote divergence, so it must be explicit).
+        if (name !== undefined && name !== DEFAULT_SANDBOX_BUCKET) {
+            throw new Error(`pyric-admin/storage: the remote (browser) sandbox has a single bucket — ` +
+                `bucket('${name}') cannot be isolated. Use bucket() (the default ` +
+                `'${DEFAULT_SANDBOX_BUCKET}' bucket) instead.`);
+        }
+        return new RemoteBucket(DEFAULT_SANDBOX_BUCKET, this.channel);
+    }
+}
+class RemoteBucket {
+    name;
+    channel;
+    constructor(name, channel) {
+        this.name = name;
+        this.channel = channel;
+    }
+    file(path) {
+        return new RemoteFile(path, this, this.channel);
+    }
+}
+class RemoteFile {
+    name;
+    bucket;
+    channel;
+    constructor(name, bucket, channel) {
+        this.name = name;
+        this.bucket = bucket;
+        this.channel = channel;
+    }
+    async save(data, options = {}) {
+        if (options.resumable === true) {
+            throw new Error('not implemented in pyric-admin/storage remote sandbox backend: resumable uploads');
+        }
+        const bytes = toBytes(data);
+        if (bytes.byteLength > MAX_REMOTE_STORAGE_OP_BYTES) {
+            throw payloadTooLarge(bytes.byteLength, `save() payload for '${this.name}'`);
+        }
+        await this.channel.op({
+            method: 'storage.putBytes',
+            path: this.name,
+            dataB64: Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString('base64'),
+            ...(options.contentType !== undefined ? { contentType: options.contentType } : {}),
+            ...(options.metadata !== undefined ? { metadata: options.metadata } : {}),
+            actAs: STORAGE_REMOTE_ADMIN_LENS,
+        });
+    }
+    async download(_options = {}) {
+        let wire;
+        try {
+            wire = (await this.channel.op({
+                method: 'storage.getBytes',
+                path: this.name,
+                actAs: STORAGE_REMOTE_ADMIN_LENS,
+            }));
+        }
+        catch (err) {
+            if (isObjectNotFound(err)) {
+                // Mirror the gcs/firebase-admin (and local arm) message shape so
+                // consumer catch-blocks that string-match `No such object` work
+                // identically across arms.
+                throw new Error(`No such object: ${this.bucket.name}/${this.name}`);
+            }
+            throw err;
+        }
+        return [Buffer.from(wire.dataB64, 'base64')];
+    }
+    async delete() {
+        try {
+            await this.channel.op({
+                method: 'storage.deleteObject',
+                path: this.name,
+                actAs: STORAGE_REMOTE_ADMIN_LENS,
+            });
+        }
+        catch (err) {
+            // The worker store's delete is already idempotent, but swallow a
+            // not-found defensively so the local arm's idempotent-delete contract
+            // holds even if `pyric/storage` adopts stricter delete semantics later.
+            if (isObjectNotFound(err))
+                return;
+            throw err;
+        }
+    }
+    async exists() {
+        try {
+            await this.channel.op({
+                method: 'storage.getMetadata',
+                path: this.name,
+                actAs: STORAGE_REMOTE_ADMIN_LENS,
+            });
+            return [true];
+        }
+        catch (err) {
+            if (isObjectNotFound(err))
+                return [false];
+            throw err;
+        }
+    }
+    /** Local stub — byte-identical to the local arm's (no data needed, so it
+     *  never relays). The sandbox does NOT serve the URL. */
+    async getSignedUrl(options) {
+        return [stubSignedUrl(this.bucket.name, this.name, options)];
+    }
+    // ─── Deferred surface (remediating throws, remote-flavored) ─────────
+    createWriteStream() {
+        throw new Error('not implemented in pyric-admin/storage remote sandbox backend: createWriteStream — ' +
+            'streams cannot span the bridge relay; use file.save(buffer) (≤ 8 MiB) instead.');
+    }
+    createReadStream() {
+        throw new Error('not implemented in pyric-admin/storage remote sandbox backend: createReadStream — ' +
+            'streams cannot span the bridge relay; use file.download() (≤ 8 MiB) instead.');
+    }
+}
+/** Is this relayed error the worker's `storage/object-not-found`? */
+function isObjectNotFound(err) {
+    return err?.code === 'storage/object-not-found';
+}
+/** Over-cap rejection (code `payload-too-large`) — mirrors the worker host's
+ *  message shape and names the streaming gap. */
+function payloadTooLarge(sizeBytes, what) {
+    const err = new Error(`pyric-admin/storage: ${what} is ${sizeBytes} bytes — over the ` +
+        `${MAX_REMOTE_STORAGE_OP_BYTES / (1024 * 1024)} MiB remote storage op cap. ` +
+        'Streaming/resumable transfers are not supported on the sandbox backend; ' +
+        'split the object or keep it under the cap.');
+    err.code = 'payload-too-large';
+    return err;
+}
+// ─── Helpers ────────────────────────────────────────────────────────────
+/**
+ * The deterministic sandbox signed-URL stub, shared by the local and remote
+ * arms so their output is byte-identical (the URL is never served — it's a
+ * stable placeholder for logs/fixtures/replay).
+ */
+function stubSignedUrl(bucketName, path, options) {
+    const expiresMs = normalizeExpires(options.expires);
+    return `pyric-sandbox-storage://${bucketName}/${path}?expires=${expiresMs}&action=${options.action}`;
+}
+/**
+ * Normalize `Buffer | string | Uint8Array` into a fresh `Uint8Array`.
+ * We copy on ingest so callers can mutate their input buffer without
+ * corrupting stored state — mirrors how `firebase-admin/storage` /
+ * `@google-cloud/storage` treat `save` inputs.
+ */
+function toBytes(data) {
+    if (typeof data === 'string') {
+        return new TextEncoder().encode(data);
+    }
+    // Both Buffer (Node) and Uint8Array land here — copy into a new
+    // Uint8Array so the stored bytes are independent of the caller's
+    // reference. `slice()` produces a copy in both cases.
+    return new Uint8Array(data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength));
+}
+/**
+ * Normalize the `expires` field into ms-since-epoch. Mirrors the
+ * accepted shapes from `@google-cloud/storage`'s `GetSignedUrlOptions`.
+ * The sandbox doesn't enforce expiration — the value is only embedded
+ * in the stub URL so consumers can round-trip it.
+ */
+function normalizeExpires(expires) {
+    if (typeof expires === 'number')
+        return expires;
+    if (expires instanceof Date)
+        return expires.getTime();
+    // String form — accept anything `Date` parses. Bogus input becomes
+    // `NaN`, which is still embeddable in the URL; we don't enforce
+    // strictness because the value only feeds the deterministic sandbox stub.
+    return new Date(expires).getTime();
+}
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "pyric-admin",
+  "version": "0.1.0-alpha.10",
+  "license": "Apache-2.0",
+  "homepage": "https://pyric.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davideast/pyric.git",
+    "directory": "packages/pyric-admin"
+  },
+  "bugs": {
+    "url": "https://github.com/davideast/pyric/issues"
+  },
+  "description": "Firebase Admin-shaped adapters for the Pyric development sandbox.",
+  "type": "module",
+  "exports": {
+    "./app": {
+      "types": "./dist/app/index.d.ts",
+      "import": "./dist/app/index.js"
+    },
+    "./firestore": {
+      "types": "./dist/firestore/index.d.ts",
+      "import": "./dist/firestore/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js"
+    },
+    "./database": {
+      "types": "./dist/database/index.d.ts",
+      "import": "./dist/database/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/storage/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test",
+    "typecheck": "bun x tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "pyric": "^0.1.0-alpha.10"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "firebase-admin": "^13.0.0",
+    "typescript": "^5.7.0",
+    "fake-indexeddb": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}