pyric 0.1.0-alpha.21 → 0.1.0-alpha.24

package/dist/storage/service.js

@@ -21,9 +21,8 @@
 import { SandboxContextImpl } from 'pyric/sandbox';
 import { bindOperationContext, provenanceForOperationContext, resolveOperationContext, } from 'pyric/sandbox/internal';
 import { openStorageBackend, storageDbName } from './persistence.js';
-import { parseStorageRules } from './sandbox/rules.js';
-import { resolveModulesBrowser } from '../rules/modules/resolver-browser.js';
-import { createStorageRulesResolution, } from './rules-resolution.js';
+import { StorageService } from './sandbox/running-service.js';
+import { compileStorageRules, } from './rules-resolution.js';
 /**
  * Default sandbox bucket identifier. v1 has a single implicit
  * bucket; the field is recorded on every uploaded metadata record
@@ -38,26 +37,41 @@ export const TARGET_SYMBOL = Symbol('pyric/storage/target');
 export function storageAuth(target) {
     return target.currentAuth?.() ?? target.context.auth;
 }
-/**
- * Internal sandbox service — owns the IDB connection + parsed rules.
- * Only constructed inside the sandbox `getStorageSandbox` path.
- */
-export class StorageService {
-    backend;
-    rules;
-    crossServiceIam;
-    constructor(backend, rules = null, crossServiceIam = 'granted') {
-        this.backend = backend;
-        this.rules = rules;
-        this.crossServiceIam = crossServiceIam;
-    }
-}
+export { StorageService } from './sandbox/running-service.js';
 /** One open storage service, with its opening configuration, per `Sandbox`. */
 const OPEN_SERVICES = new WeakMap();
-/** One sandbox `FirebaseStorage` handle per `SandboxContext`. */
+const HOST_BACKENDS = new WeakMap();
+/** Hosts install their durable backend before any Storage service is created. */
+export function installStorageBackend(sandbox, backend) {
+    const alreadyOpened = OPEN_SERVICES.has(sandbox) || HOST_BACKENDS.has(sandbox);
+    if (alreadyOpened)
+        throw new Error('Storage backend must be installed once, before Storage initializes.');
+    HOST_BACKENDS.set(sandbox, backend);
+}
+/** One scoped `StorageService` per (Sandbox, bucket). */
+const SCOPED_SERVICES = new WeakMap();
+function getOrCreateScopedService(sandbox, bucket, rootServicePromise) {
+    let bucketMap = SCOPED_SERVICES.get(sandbox);
+    if (!bucketMap) {
+        bucketMap = new Map();
+        SCOPED_SERVICES.set(sandbox, bucketMap);
+    }
+    let existing = bucketMap.get(bucket);
+    if (!existing) {
+        existing = rootServicePromise.then((rootService) => {
+            const backend = rootService.backend.scoped
+                ? rootService.backend.scoped(bucket)
+                : rootService.backend;
+            return new StorageService(backend, rootService.rules, rootService.crossServiceIam);
+        });
+        bucketMap.set(bucket, existing);
+    }
+    return existing;
+}
+/** Sandbox `FirebaseStorage` handles cached per `(SandboxContext, bucket)`. */
 const SANDBOX_HANDLES = new WeakMap();
 /**
- * One anonymous handle per bare `Sandbox`. `Sandbox.withAuth(null)`
+ * Anonymous handles cached per `(Sandbox, bucket)`. `Sandbox.withAuth(null)`
  * mints a FRESH `SandboxContext` on every call, so the per-context
  * cache above would miss for the bare-`Sandbox` convenience path —
  * `getStorageSandbox(sandbox)` twice returned two different handles
@@ -85,6 +99,85 @@ function rejectDifferingLateConfig(option, descriptor, supplied, openedWith, cal
         'call per Sandbox, so this value would be silently discarded. Configure it on the first ' +
         'storage call for this sandbox.');
 }
+/**
+ * Install a new ruleset into a sandbox's storage service, replacing whatever
+ * it is enforcing.
+ *
+ * This is the deliberate counterpart to the late-config guard in
+ * {@link ensureService}. That guard exists because a `rules` option passed to
+ * a FACTORY after the service is open would be silently discarded, and a
+ * caller asking for a handle has not asked to change the ruleset. Here the
+ * caller has asked for exactly that and nothing is discarded: the source is
+ * compiled first, so a source that does not parse throws and leaves the
+ * ruleset in force untouched, and the factory guard is unchanged, so the
+ * served-app path still refuses a late differing option.
+ *
+ * The new ruleset reaches the root service and every per-bucket scoped
+ * service, because each holds its own reference to the parsed rules.
+ */
+export async function replaceStorageRules(sandbox, source) {
+    const compiled = compileStorageRules(source);
+    const open = OPEN_SERVICES.get(sandbox);
+    if (open === undefined) {
+        await ensureService(sandbox, { rules: source }, 'replaceStorageRules');
+        return;
+    }
+    OPEN_SERVICES.set(sandbox, {
+        service: open.service,
+        rulesSource: source,
+        rulesResolution: compiled.resolution,
+        crossServiceIam: open.crossServiceIam,
+    });
+    const root = await open.service;
+    root.rules = compiled.rules;
+    for (const scopedPromise of SCOPED_SERVICES.get(sandbox)?.values() ?? []) {
+        const scoped = await scopedPromise;
+        scoped.rules = compiled.rules;
+    }
+}
+/**
+ * The cross-service IAM posture a sandbox's storage service is running under.
+ *
+ * A sandbox whose storage service has never been opened reports the default a
+ * first open would take, so a reader gets the mode that is in force rather
+ * than an absence it has to interpret.
+ */
+export function getStorageCrossServiceIam(sandbox) {
+    return OPEN_SERVICES.get(sandbox)?.crossServiceIam ?? 'granted';
+}
+/**
+ * Move a sandbox's storage service between the granted and denied
+ * cross-service IAM states, replacing whatever it is enforcing.
+ *
+ * This is the deliberate counterpart to the late-config guard in
+ * {@link ensureService}, on the same argument that gives
+ * {@link replaceStorageRules} its exception: a `crossServiceIam` option passed
+ * to a FACTORY after the service is open would be silently discarded, and a
+ * caller asking for a handle has not asked to change the project's IAM
+ * posture. Here the caller has asked for exactly that.
+ *
+ * The new mode reaches the root service and every per-bucket scoped service,
+ * because each holds its own reference to it.
+ */
+export async function replaceCrossServiceIam(sandbox, mode) {
+    const open = OPEN_SERVICES.get(sandbox);
+    if (open === undefined) {
+        await ensureService(sandbox, { crossServiceIam: mode }, 'replaceCrossServiceIam');
+        return;
+    }
+    OPEN_SERVICES.set(sandbox, {
+        service: open.service,
+        rulesSource: open.rulesSource,
+        rulesResolution: open.rulesResolution,
+        crossServiceIam: mode,
+    });
+    const root = await open.service;
+    root.crossServiceIam = mode;
+    for (const scopedPromise of SCOPED_SERVICES.get(sandbox)?.values() ?? []) {
+        const scoped = await scopedPromise;
+        scoped.crossServiceIam = mode;
+    }
+}
 /**
  * Get (or open) the ONE per-sandbox `StorageService`. Loud on the
  * silent-rules-wipe hazard: when the service is already open and the
@@ -94,36 +187,33 @@ function rejectDifferingLateConfig(option, descriptor, supplied, openedWith, cal
  */
 function ensureService(sandbox, options, caller) {
     const existing = OPEN_SERVICES.get(sandbox);
-    if (existing) {
+    const alreadyOpen = existing !== undefined;
+    if (alreadyOpen) {
         rejectDifferingLateConfig('rules', 'rules source', options.rules, existing.rulesSource, caller);
         rejectDifferingLateConfig('crossServiceIam', 'crossServiceIam mode', options.crossServiceIam, existing.crossServiceIam, caller);
         return existing.service;
     }
     let rules = null;
     let resolution = null;
-    if (options.rules) {
-        let source = options.rules;
-        let modules = [];
-        let bundledModules = [];
-        let moduleEvidenceIds = [];
-        rules = parseStorageRules(source);
-        if (rules._version === '2+modules') {
-            const resolved = resolveModulesBrowser(source);
-            if (!resolved.success) {
-                throw new SyntaxError(`Storage rules module resolution failed (${resolved.error.code}): ${resolved.error.message}`);
-            }
-            source = resolved.data.resolved;
-            modules = resolved.data.modules;
-            bundledModules = resolved.data.bundledModules;
-            moduleEvidenceIds = resolved.data.evidenceIds;
-            rules = parseStorageRules(source);
-        }
-        resolution = createStorageRulesResolution(source, modules, bundledModules, moduleEvidenceIds, rules);
+    const rulesSource = options.rules;
+    const hasRules = typeof rulesSource === 'string' && rulesSource.length > 0;
+    if (hasRules) {
+        const compiled = compileStorageRules(rulesSource);
+        rules = compiled.rules;
+        resolution = compiled.resolution;
     }
     // Explicit dbName wins; otherwise scope the default by project identity so
     // two projects on one origin never share a storage database (issue #359).
     const crossServiceIam = options.crossServiceIam ?? 'granted';
-    const servicePromise = openStorageBackend(options.dbName ?? storageDbName(options.projectId)).then((backend) => new StorageService(backend, rules, crossServiceIam));
+    const injectedBackend = HOST_BACKENDS.get(sandbox);
+    let backendPromise;
+    const hasInjectedBackend = injectedBackend !== undefined;
+    if (hasInjectedBackend)
+        backendPromise = Promise.resolve(injectedBackend);
+    else {
+        backendPromise = openStorageBackend(options.dbName ?? storageDbName(options.projectId), options.bucket ?? DEFAULT_BUCKET);
+    }
+    const servicePromise = backendPromise.then((backend) => new StorageService(backend, rules, crossServiceIam));
     OPEN_SERVICES.set(sandbox, {
         service: servicePromise,
         rulesSource: options.rules ?? null,
@@ -166,22 +256,20 @@ export function getStorageSandbox(target, options = {}) {
     // Open (or fetch) the ONE per-sandbox service FIRST — before any handle
     // cache fast-path — so a late, differing `rules` option throws instead of
     // being silently discarded (see ensureService).
-    const servicePromise = ensureService(sandbox, options, 'getStorageSandbox');
+    const rootServicePromise = ensureService(sandbox, options, 'getStorageSandbox');
+    const bucket = options.bucket ?? DEFAULT_BUCKET;
     // Fast path: a repeat bare-`Sandbox` call returns the cached
-    // anonymous handle (the per-context cache below can't catch it
-    // because `withAuth(null)` mints a fresh context each time). Like
-    // the per-context path, bucket/dbName options are honored only on
-    // the FIRST call per Sandbox.
+    // anonymous handle for the requested bucket.
     if (fromBareSandbox) {
-        const cachedBare = BARE_SANDBOX_HANDLES.get(sandbox);
+        const cachedBare = BARE_SANDBOX_HANDLES.get(sandbox)?.get(bucket);
         if (cachedBare)
             return cachedBare;
     }
     const ctx = isContext(target) ? target : target.withAuth(null);
-    const bucket = options.bucket ?? DEFAULT_BUCKET;
-    const cached = SANDBOX_HANDLES.get(ctx);
+    const cached = SANDBOX_HANDLES.get(ctx)?.get(bucket);
     if (cached)
         return cached;
+    const servicePromise = getOrCreateScopedService(sandbox, bucket, rootServicePromise);
     const sandboxTarget = {
         kind: 'sandbox',
         sandbox,
@@ -191,9 +279,20 @@ export function getStorageSandbox(target, options = {}) {
         servicePromise,
     };
     const handle = Object.freeze({ [TARGET_SYMBOL]: sandboxTarget });
-    SANDBOX_HANDLES.set(ctx, handle);
-    if (fromBareSandbox)
-        BARE_SANDBOX_HANDLES.set(sandbox, handle);
+    let ctxMap = SANDBOX_HANDLES.get(ctx);
+    if (!ctxMap) {
+        ctxMap = new Map();
+        SANDBOX_HANDLES.set(ctx, ctxMap);
+    }
+    ctxMap.set(bucket, handle);
+    if (fromBareSandbox) {
+        let bareMap = BARE_SANDBOX_HANDLES.get(sandbox);
+        if (!bareMap) {
+            bareMap = new Map();
+            BARE_SANDBOX_HANDLES.set(sandbox, bareMap);
+        }
+        bareMap.set(bucket, handle);
+    }
     return handle;
 }
 /** Admin handles are cached by bound context so Studio, agent, and
@@ -219,9 +318,10 @@ export function getAdminStorageSandbox(target, options = {}) {
     const fromBareSandbox = !isContext(target);
     const sandbox = isContext(target) ? target.sandbox : target;
     // Service first (late differing `rules` must throw, even on a cache hit).
-    const servicePromise = ensureService(sandbox, options, 'getAdminStorageSandbox');
+    const rootServicePromise = ensureService(sandbox, options, 'getAdminStorageSandbox');
+    const bucket = options.bucket ?? DEFAULT_BUCKET;
     if (fromBareSandbox) {
-        const cachedBare = BARE_ADMIN_HANDLES.get(sandbox);
+        const cachedBare = BARE_ADMIN_HANDLES.get(sandbox)?.get(bucket);
         if (cachedBare)
             return cachedBare;
     }
@@ -235,21 +335,33 @@ export function getAdminStorageSandbox(target, options = {}) {
                 ? {}
                 : { planId: baseContext.operationContext.planId }),
         });
-    const cached = ADMIN_CONTEXT_HANDLES.get(baseContext);
+    const cached = ADMIN_CONTEXT_HANDLES.get(baseContext)?.get(bucket);
     if (cached)
         return cached;
+    const servicePromise = getOrCreateScopedService(sandbox, bucket, rootServicePromise);
     const sandboxTarget = {
         kind: 'sandbox',
         sandbox,
         context,
-        bucket: options.bucket ?? DEFAULT_BUCKET,
+        bucket,
         servicePromise,
         admin: true,
     };
     const handle = Object.freeze({ [TARGET_SYMBOL]: sandboxTarget });
-    ADMIN_CONTEXT_HANDLES.set(baseContext, handle);
-    if (fromBareSandbox)
-        BARE_ADMIN_HANDLES.set(sandbox, handle);
+    let ctxMap = ADMIN_CONTEXT_HANDLES.get(baseContext);
+    if (!ctxMap) {
+        ctxMap = new Map();
+        ADMIN_CONTEXT_HANDLES.set(baseContext, ctxMap);
+    }
+    ctxMap.set(bucket, handle);
+    if (fromBareSandbox) {
+        let bareMap = BARE_ADMIN_HANDLES.get(sandbox);
+        if (!bareMap) {
+            bareMap = new Map();
+            BARE_ADMIN_HANDLES.set(sandbox, bareMap);
+        }
+        bareMap.set(bucket, handle);
+    }
     return handle;
 }
 /** Merge a host override with the immutable provenance bound to a Storage

package/dist/storage/service.js.map

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

package/dist/storage/string-format.d.ts

@@ -0,0 +1,9 @@
+/** Encodings accepted by Firebase Storage string uploads. */
+export declare const StringFormat: {
+    readonly RAW: "raw";
+    readonly BASE64: "base64";
+    readonly BASE64URL: "base64url";
+    readonly DATA_URL: "data_url";
+};
+export type StringFormat = (typeof StringFormat)[keyof typeof StringFormat];
+//# sourceMappingURL=string-format.d.ts.map

package/dist/storage/string-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-format.d.ts","sourceRoot":"","sources":["../../src/storage/string-format.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist/storage/string-format.js

@@ -0,0 +1,8 @@
+/** Encodings accepted by Firebase Storage string uploads. */
+export const StringFormat = {
+    RAW: "raw",
+    BASE64: "base64",
+    BASE64URL: "base64url",
+    DATA_URL: "data_url",
+};
+//# sourceMappingURL=string-format.js.map

package/dist/storage/string-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-format.js","sourceRoot":"","sources":["../../src/storage/string-format.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;CACZ,CAAC"}

package/dist/storage/upload.d.ts

@@ -3,7 +3,8 @@ import { type SettableMetadata, type UploadResult } from './metadata.js';
 import type { StoredMetadata } from './persistence.js';
 import type { StorageReference } from './reference.js';
 /** `uploadString` format selector. */
-export type StringFormat = 'raw' | 'base64' | 'data_url';
+import type { StringFormat } from './string-format.js';
+export type { StringFormat } from './string-format.js';
 /**
  * Upload bytes to the reference's `fullPath`. Replaces any existing
  * object at the path. Returns the populated `FullMetadata` and the

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

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/storage/upload.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,EACrC,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,YAAY,CAAC,CAkDvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,YAAoB,EAC5B,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,YAAY,CAAC,CAOvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvC,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,cAAc,CA0BjB;AA+BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,GACnB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA8CzD;AAUD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAElE"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/storage/upload.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,sCAAsC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,EACrC,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,YAAY,CAAC,CAsDvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,YAAoB,EAC5B,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,YAAY,CAAC,CAOvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvC,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,cAAc,CA0BjB;AA+BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,GACnB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA8CzD;AAUD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAElE"}

package/dist/storage/upload.js

@@ -23,7 +23,7 @@
  *     payload's intrinsic type (`Blob.type`, data-url prefix) →
  *     `application/octet-stream`. Matches the JS SDK.
  */
-import { emitSandboxEvent, makeServiceMutationEvent } from 'pyric/sandbox/internal';
+import { emitSandboxEvent, getClock, makeServiceMutationEvent } from 'pyric/sandbox/internal';
 import { getStorageService, storageAuth, storageOperationProvenance, targetOf } from './service.js';
 import { enforceRules } from './enforce.js';
 import { resourceFromStored, requestResourceFor } from './sandbox/rules-resources.js';
@@ -50,7 +50,10 @@ export async function uploadBytes(ref, data, metadata, provenance) {
     const target = targetOf(ref.storage);
     const operationProvenance = storageOperationProvenance(target, provenance);
     const blob = toBlob(data, metadata?.contentType);
-    const stored = buildStoredMetadata({ ref, blob, settable: metadata });
+    // Server-set object times come from the sandbox clock, so `timeCreated` and
+    // `updated` agree with the `request.time` the rules see for this same upload.
+    const uploadedAt = getClock(target.sandbox).date();
+    const stored = buildStoredMetadata({ ref, blob, settable: metadata, now: uploadedAt });
     const service = await getStorageService(ref.storage);
     const existing = await service.backend.getMetadata(ref.fullPath);
     enforceRules(service, {
@@ -74,6 +77,7 @@ export async function uploadBytes(ref, data, metadata, provenance) {
     // the emit path must not fail the upload the caller just completed.
     try {
         emitSandboxEvent(target.sandbox, makeServiceMutationEvent({
+            at: getClock(target.sandbox).now(),
             service: 'storage',
             op: 'object_put',
             path: ref.fullPath,

package/dist/storage/upload.js.map

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

package/dist/storage/url.d.ts

@@ -0,0 +1,18 @@
+/** The bucket and object path a Storage URL names. */
+export interface StorageLocation {
+    readonly bucket: string;
+    readonly path: string;
+}
+/** Whether `ref()` reads `value` as a URL rather than as an object path. */
+export declare function isStorageUrl(value: string): boolean;
+/** The bucket and object path `url` names; throws `storage/invalid-url` when it names none. */
+export declare function parseStorageUrl(url: string): StorageLocation;
+/**
+ * The object path a `ref()` string argument names, before normalization.
+ * `fromStorage` is whether `ref()` was given a Storage instance rather than a
+ * reference: only a Storage instance takes a URL, as in production. The sandbox
+ * serves one bucket, so a URL's bucket does not change which store the
+ * reference reads.
+ */
+export declare function refPathOf(value: string | undefined, fromStorage: boolean): string;
+//# sourceMappingURL=url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/storage/url.ts"],"names":[],"mappings":"AAuBA,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAuCD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAc5D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,CAUjF"}

package/dist/storage/url.js

@@ -0,0 +1,84 @@
+/**
+ * The strings `ref()` reads as URLs, and the object each one names.
+ *
+ * `ref(storage, url)` accepts the URL forms production's `firebase/storage`
+ * parses, with the same patterns:
+ *
+ * - `gs://<bucket>/<path>`, whose path is taken as written;
+ * - `http(s)://firebasestorage.googleapis.com/v<n>/b/<bucket>/o/<path>`, the
+ *   download URL form, whose path is percent-decoded and whose query is ignored;
+ * - `http(s)://storage.googleapis.com/<bucket>/<path>` and
+ *   `storage.cloud.google.com`, percent-decoded the same way.
+ *
+ * It also accepts the download URL the Node host issues,
+ * `<origin>/__pyric/storage/v0/b/<bucket>/o/<path>`, on any origin. Production
+ * never issues that form and throws `storage/invalid-url` for it.
+ *
+ * A `data:` URI is a download URL in process and on a SharedWorker host. It
+ * carries an object's bytes, not its location, so `ref()` throws
+ * `storage/invalid-url` for one. Production has no such URL and reads the
+ * string as an object path.
+ */
+import { StorageError } from './errors.js';
+const BUCKET = '([A-Za-z0-9.\\-_]+)';
+/** A `ref()` string is a URL when it starts with a scheme and `://`, as production decides. */
+const SCHEME_URL = /^[A-Za-z]+:\/\//;
+/** `data:[<media type>][;base64],<data>` */
+const DATA_URI = /^data:[^,]*,/i;
+const asWritten = (value) => value;
+const URL_FORMS = [
+    { pattern: new RegExp(`^gs://${BUCKET}(?:/(.*))?$`, 'i'), path: asWritten },
+    {
+        pattern: new RegExp(`^https?://firebasestorage\\.googleapis\\.com/v[A-Za-z0-9_]+/b/${BUCKET}/o(?:/([^?#]*).*)?$`, 'i'),
+        path: decodeURIComponent,
+    },
+    {
+        pattern: new RegExp(`^https?://(?:storage\\.googleapis\\.com|storage\\.cloud\\.google\\.com)/${BUCKET}/([^?#]*)`, 'i'),
+        path: decodeURIComponent,
+    },
+    {
+        pattern: new RegExp(`^https?://[^/?#]+/__pyric/storage/v0/b/${BUCKET}/o/([^?#]+)`),
+        path: decodeURIComponent,
+    },
+];
+function invalidUrl(url, detail) {
+    return new StorageError('invalid-url', `Invalid URL '${url}'. ${detail}`);
+}
+/** Whether `ref()` reads `value` as a URL rather than as an object path. */
+export function isStorageUrl(value) {
+    return SCHEME_URL.test(value) || DATA_URI.test(value);
+}
+/** The bucket and object path `url` names; throws `storage/invalid-url` when it names none. */
+export function parseStorageUrl(url) {
+    const isDataUri = DATA_URI.test(url);
+    if (isDataUri) {
+        throw invalidUrl(url.length > 64 ? `${url.slice(0, 64)}...` : url, 'A data: URI carries an object\'s bytes, not its location. Reference the object by its path or its gs:// URL.');
+    }
+    for (const form of URL_FORMS) {
+        const captured = form.pattern.exec(url);
+        if (captured === null)
+            continue;
+        return { bucket: captured[1], path: form.path(captured[2] ?? '') };
+    }
+    throw invalidUrl(url, 'Expected a gs:// URL or a Storage download URL.');
+}
+/**
+ * The object path a `ref()` string argument names, before normalization.
+ * `fromStorage` is whether `ref()` was given a Storage instance rather than a
+ * reference: only a Storage instance takes a URL, as in production. The sandbox
+ * serves one bucket, so a URL's bucket does not change which store the
+ * reference reads.
+ */
+export function refPathOf(value, fromStorage) {
+    const given = value ?? '';
+    const isUrl = isStorageUrl(given);
+    if (!isUrl)
+        return given;
+    const isDataUri = DATA_URI.test(given);
+    const urlOnReference = !fromStorage && !isDataUri;
+    if (urlOnReference) {
+        throw new StorageError('invalid-argument', 'To use ref(service, url), the first argument must be a Storage instance.');
+    }
+    return parseStorageUrl(given).path;
+}
+//# sourceMappingURL=url.js.map

package/dist/storage/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/storage/url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,MAAM,MAAM,GAAG,qBAAqB,CAAC;AAErC,+FAA+F;AAC/F,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAErC,4CAA4C;AAC5C,MAAM,QAAQ,GAAG,eAAe,CAAC;AASjC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC;AAEnD,MAAM,SAAS,GAAuB;IACpC,EAAE,OAAO,EAAE,IAAI,MAAM,CAAC,SAAS,MAAM,aAAa,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3E;QACE,OAAO,EAAE,IAAI,MAAM,CAAC,iEAAiE,MAAM,qBAAqB,EAAE,GAAG,CAAC;QACtH,IAAI,EAAE,kBAAkB;KACzB;IACD;QACE,OAAO,EAAE,IAAI,MAAM,CAAC,2EAA2E,MAAM,WAAW,EAAE,GAAG,CAAC;QACtH,IAAI,EAAE,kBAAkB;KACzB;IACD;QACE,OAAO,EAAE,IAAI,MAAM,CAAC,0CAA0C,MAAM,aAAa,CAAC;QAClF,IAAI,EAAE,kBAAkB;KACzB;CACF,CAAC;AAEF,SAAS,UAAU,CAAC,GAAW,EAAE,MAAc;IAC7C,OAAO,IAAI,YAAY,CAAC,aAAa,EAAE,gBAAgB,GAAG,MAAM,MAAM,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,UAAU,CACd,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAChD,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,QAAQ,KAAK,IAAI;YAAE,SAAS;QAChC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,MAAM,UAAU,CAAC,GAAG,EAAE,iDAAiD,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAyB,EAAE,WAAoB;IACvE,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,cAAc,GAAG,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC;IAClD,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,0EAA0E,CAAC,CAAC;IACzH,CAAC;IACD,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pyric",
-  "version": "0.1.0-alpha.21",
+  "version": "0.1.0-alpha.24",
   "license": "Apache-2.0",
   "homepage": "https://pyric.dev",
   "repository": {
@@ -62,6 +62,10 @@
       "types": "./dist/auth/index.d.ts",
       "import": "./dist/auth/index.js"
     },
+    "./auth/internal": {
+      "types": "./dist/auth/internal.d.ts",
+      "import": "./dist/auth/internal.js"
+    },
     "./ai": {
       "types": "./dist/ai/index.d.ts",
       "import": "./dist/ai/index.js"
@@ -126,6 +130,18 @@
       "types": "./dist/sandbox/index.d.ts",
       "import": "./dist/sandbox/index.js"
     },
+    "./sandbox/branches/store": {
+      "types": "./dist/sandbox/branches/store.d.ts",
+      "import": "./dist/sandbox/branches/store.js"
+    },
+    "./sandbox/checkpoints": {
+      "types": "./dist/sandbox/checkpoints/index.d.ts",
+      "import": "./dist/sandbox/checkpoints/index.js"
+    },
+    "./sandbox/checkpoints/directory": {
+      "types": "./dist/sandbox/checkpoints/directory-backend.d.ts",
+      "import": "./dist/sandbox/checkpoints/directory-backend.js"
+    },
     "./sandbox/firestore": {
       "types": "./dist/firestore/sandbox-controls.d.ts",
       "import": "./dist/firestore/sandbox-controls.js"