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

package/dist/storage/enforce.js

@@ -38,7 +38,7 @@
  * throws `StorageError` exactly as before — the error contract to
  * app code is unchanged.
  */
-import { emitSandboxEvent, makeSandboxOperationEvent } from 'pyric/sandbox/internal';
+import { emitSandboxEvent, getClock, makeSandboxOperationEvent } from 'pyric/sandbox/internal';
 import { storageOperationProvenance, } from './service.js';
 import { evaluateStorageRules } from './sandbox/rules-evaluator.js';
 import { RuleEvalError } from './sandbox/rules-evaluation-error.js';
@@ -63,7 +63,11 @@ export function enforceRules(service, input, target, provenance) {
         throw unauthorized(input.request.method, input.request.path, ' — No Storage rules configured; default deny.');
     }
     const evaluationInput = target ? withCanonicalRulesPath(input, target.bucket) : input;
-    const result = evaluateStorageRules(service.rules, evaluationInput, undefined, firestoreLookupFor(target, service.crossServiceIam));
+    // `request.time` is the sandbox's clock when the caller has a sandbox handle,
+    // so a `request.time < timestamp.date(...)` rule flips with it. A pure
+    // evaluation with no target keeps the evaluator's own wall-clock default.
+    const requestTime = target ? getClock(target.sandbox).date() : undefined;
+    const result = evaluateStorageRules(service.rules, evaluationInput, requestTime, firestoreLookupFor(target, service.crossServiceIam));
     if (!result.allowed) {
         emitOperation(target, input, 'deny', result.reasons, 'user', true, boundProvenance);
         const detail = result.reasons.length > 0 ? ` — ${result.reasons.join('; ')}` : '';
@@ -97,6 +101,7 @@ function emitOperation(target, input, result, reasons, origin, evaluated, proven
         return;
     try {
         emitSandboxEvent(target.sandbox, makeSandboxOperationEvent({
+            at: getClock(target.sandbox).now(),
             service: 'storage',
             method: input.request.method,
             path: input.request.path,
@@ -141,9 +146,22 @@ function emitOperation(target, input, result, reasons, origin, evaluated, proven
 function firestoreLookupFor(target, crossServiceIam) {
     if (!target)
         return undefined;
+    return storageFirestoreLookup(target.sandbox, crossServiceIam);
+}
+/**
+ * The lookup one sandbox's Storage rules read `firestore.get()/exists()` from,
+ * under one IAM posture.
+ *
+ * Enforcement is not the only reader of it. A rules simulation asks the same
+ * question of the same ruleset without issuing the operation, and a simulation
+ * that built its own lookup, or none, would answer a cross-service rule
+ * differently from the operation it is meant to predict. So the construction
+ * lives here, once, and both paths call it.
+ */
+export function storageFirestoreLookup(sandbox, crossServiceIam) {
     if (crossServiceIam === 'denied')
         return crossServiceIamDeniedLookup();
-    const admin = target.sandbox.admin;
+    const admin = sandbox.admin;
     return {
         get: (path) => admin.getDocument(path),
         exists: (path) => admin.getDocument(path) !== null,

package/dist/storage/enforce.js.map

@@ -1 +1 @@
-{"version":3,"file":"enforce.js","sourceRoot":"","sources":["../../src/storage/enforce.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"enforce.js","sourceRoot":"","sources":["../../src/storage/enforce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAE/F,OAAO,EACL,0BAA0B,GAI3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,UAAU,YAAY,CAC1B,OAAuB,EACvB,KAAsB,EACtB,MAAe,EACf,UAA4B;IAE5B,MAAM,eAAe,GAAG,MAAM,EAAE,IAAI,KAAK,SAAS;QAChD,CAAC,CAAC,0BAA0B,CAAC,MAAM,EAAE,UAAU,CAAC;QAChD,CAAC,CAAC,UAAU,CAAC;IACf,qEAAqE;IACrE,2EAA2E;IAC3E,yEAAyE;IACzE,yEAAyE;IACzE,kEAAkE;IAClE,sEAAsE;IACtE,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACxD,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QAC3F,OAAO;IACT,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC/D,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QAC9E,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAC;IAChH,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtF,8EAA8E;IAC9E,uEAAuE;IACvE,0EAA0E;IAC1E,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,MAAM,MAAM,GAAG,oBAAoB,CACjC,OAAO,CAAC,KAAK,EACb,eAAe,EACf,WAAW,EACX,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CACpD,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;IACD,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;AACvF,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,KAAsB,EAAE,MAAc;IACpE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE;YACP,GAAG,KAAK,CAAC,OAAO;YAChB,IAAI,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,MAAM,UAAU,EAAE;SAC1E;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CACpB,MAA0B,EAC1B,KAAsB,EACtB,MAA2C,EAC3C,OAA6B,EAC7B,MAAwB,EACxB,SAAkB,EAClB,UAAuC;IAEvC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC;QACH,gBAAgB,CACd,MAAM,CAAC,OAAO,EACd,yBAAyB,CAAC;YACxB,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE;YAClC,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;YAC5B,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;YACxB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;YACxB,MAAM;YACN,MAAM;YACN,OAAO;YACP,gBAAgB,EAAE,MAAM,KAAK,OAAO;gBAClC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE;gBACvC,CAAC,CAAC,SAAS;oBACT,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE;oBACtE,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE;YACnD,KAAK,EAAE,SAAS;gBACd,CAAC,CAAC;oBACE,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;iBACvE;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,EACF,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,CACtC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,kBAAkB,CACzB,MAA0B,EAC1B,eAAgC;IAEhC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAgB,EAChB,eAAgC;IAEhC,IAAI,eAAe,KAAK,QAAQ;QAAE,OAAO,2BAA2B,EAAE,CAAC;IACvE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAmC;QACxE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI;KACnD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,IAAI,GAAG,CAAC,MAAwB,EAAS,EAAE;QAC/C,MAAM,IAAI,aAAa,CACrB,aAAa,MAAM,+DAA+D;YAChF,uGAAuG,CAC1G,CAAC;IACJ,CAAC,CAAC;IACF,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC7B,CAAC;AACJ,CAAC"}

package/dist/storage/errors.d.ts

@@ -20,11 +20,35 @@
  * while the message wording stays sandbox-flavored. The
  * `storage/<code>` prefix is what consumer code branches on.
  */
-/**
- * The unprefixed storage error codes the sandbox can raise. Mirrors
- * the subset of `StorageErrorCode` used by currently implemented operations.
- */
-export type StorageErrorCode = 'unknown' | 'object-not-found' | 'quota-exceeded' | 'unauthenticated' | 'unauthorized' | 'invalid-root-operation' | 'invalid-format' | 'invalid-argument' | 'canceled';
+/** Unprefixed Firebase Storage error codes. */
+export declare const StorageErrorCode: {
+    readonly UNKNOWN: "unknown";
+    readonly OBJECT_NOT_FOUND: "object-not-found";
+    readonly BUCKET_NOT_FOUND: "bucket-not-found";
+    readonly PROJECT_NOT_FOUND: "project-not-found";
+    readonly QUOTA_EXCEEDED: "quota-exceeded";
+    readonly UNAUTHENTICATED: "unauthenticated";
+    readonly UNAUTHORIZED: "unauthorized";
+    readonly UNAUTHORIZED_APP: "unauthorized-app";
+    readonly RETRY_LIMIT_EXCEEDED: "retry-limit-exceeded";
+    readonly INVALID_CHECKSUM: "invalid-checksum";
+    readonly CANCELED: "canceled";
+    readonly INVALID_EVENT_NAME: "invalid-event-name";
+    readonly INVALID_URL: "invalid-url";
+    readonly INVALID_DEFAULT_BUCKET: "invalid-default-bucket";
+    readonly NO_DEFAULT_BUCKET: "no-default-bucket";
+    readonly CANNOT_SLICE_BLOB: "cannot-slice-blob";
+    readonly SERVER_FILE_WRONG_SIZE: "server-file-wrong-size";
+    readonly NO_DOWNLOAD_URL: "no-download-url";
+    readonly INVALID_ARGUMENT: "invalid-argument";
+    readonly INVALID_ARGUMENT_COUNT: "invalid-argument-count";
+    readonly APP_DELETED: "app-deleted";
+    readonly INVALID_ROOT_OPERATION: "invalid-root-operation";
+    readonly INVALID_FORMAT: "invalid-format";
+    readonly INTERNAL_ERROR: "internal-error";
+    readonly UNSUPPORTED_ENVIRONMENT: "unsupported-environment";
+};
+export type StorageErrorCode = (typeof StorageErrorCode)[keyof typeof StorageErrorCode];
 /** Prefix an unprefixed code with `storage/` — matches upstream. */
 export declare function prependCode(code: StorageErrorCode): `storage/${StorageErrorCode}`;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/storage/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,kBAAkB,GAClB,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,wBAAwB,GACxB,gBAAgB,GAChB,kBAAkB,GAClB,UAAU,CAAC;AAEf,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,gBAAgB,EAAE,CAEjF;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,WAAW,gBAAgB,EAAE,CAAC;gBAEjC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;CAWpD;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEzD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAKvF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAOnF;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAK7D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAE3E;AAED,wBAAgB,cAAc,IAAI,YAAY,CAE7C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/storage/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAExF,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,gBAAgB,EAAE,CAEjF;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,WAAW,gBAAgB,EAAE,CAAC;gBAEjC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;CAWpD;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEzD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAKvF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAOnF;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAK7D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAE3E;AAED,wBAAgB,cAAc,IAAI,YAAY,CAE7C"}

package/dist/storage/errors.js

@@ -20,6 +20,34 @@
  * while the message wording stays sandbox-flavored. The
  * `storage/<code>` prefix is what consumer code branches on.
  */
+/** Unprefixed Firebase Storage error codes. */
+export const StorageErrorCode = {
+    UNKNOWN: "unknown",
+    OBJECT_NOT_FOUND: "object-not-found",
+    BUCKET_NOT_FOUND: "bucket-not-found",
+    PROJECT_NOT_FOUND: "project-not-found",
+    QUOTA_EXCEEDED: "quota-exceeded",
+    UNAUTHENTICATED: "unauthenticated",
+    UNAUTHORIZED: "unauthorized",
+    UNAUTHORIZED_APP: "unauthorized-app",
+    RETRY_LIMIT_EXCEEDED: "retry-limit-exceeded",
+    INVALID_CHECKSUM: "invalid-checksum",
+    CANCELED: "canceled",
+    INVALID_EVENT_NAME: "invalid-event-name",
+    INVALID_URL: "invalid-url",
+    INVALID_DEFAULT_BUCKET: "invalid-default-bucket",
+    NO_DEFAULT_BUCKET: "no-default-bucket",
+    CANNOT_SLICE_BLOB: "cannot-slice-blob",
+    SERVER_FILE_WRONG_SIZE: "server-file-wrong-size",
+    NO_DOWNLOAD_URL: "no-download-url",
+    INVALID_ARGUMENT: "invalid-argument",
+    INVALID_ARGUMENT_COUNT: "invalid-argument-count",
+    APP_DELETED: "app-deleted",
+    INVALID_ROOT_OPERATION: "invalid-root-operation",
+    INVALID_FORMAT: "invalid-format",
+    INTERNAL_ERROR: "internal-error",
+    UNSUPPORTED_ENVIRONMENT: "unsupported-environment",
+};
 /** Prefix an unprefixed code with `storage/` — matches upstream. */
 export function prependCode(code) {
     return `storage/${code}`;

package/dist/storage/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/storage/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAiBH,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,IAAsB;IAChD,OAAO,WAAW,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,sDAAsD;IAC7C,IAAI,CAAgC;IAE7C,YAAY,IAAsB,EAAE,OAAe;QACjD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,gEAAgE;QAChE,4BAA4B;QAC5B,KAAK,CAAC,GAAG,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrB,+DAA+D;QAC/D,uDAAuD;QACvD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF;AAED,uEAAuE;AAEvE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,YAAY,CAAC,kBAAkB,EAAE,iBAAiB,IAAI,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY,EAAE,MAAc;IACvE,OAAO,IAAI,YAAY,CACrB,cAAc,EACd,GAAG,MAAM,KAAK,IAAI,oBAAoB,MAAM,GAAG,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY,EAAE,GAAW;IACnE,mEAAmE;IACnE,gEAAgE;IAChE,OAAO,IAAI,YAAY,CACrB,gBAAgB,EAChB,cAAc,IAAI,QAAQ,IAAI,wCAAwC,GAAG,GAAG,CAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,OAAO,IAAI,YAAY,CACrB,wBAAwB,EACxB,GAAG,EAAE,wCAAwC,CAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAe;IAC3D,OAAO,IAAI,YAAY,CAAC,gBAAgB,EAAE,iCAAiC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,YAAY,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;AAC5E,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/storage/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,SAAS;IAClB,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,gBAAgB,EAAE,kBAAkB;IACpC,oBAAoB,EAAE,sBAAsB;IAC5C,gBAAgB,EAAE,kBAAkB;IACpC,QAAQ,EAAE,UAAU;IACpB,kBAAkB,EAAE,oBAAoB;IACxC,WAAW,EAAE,aAAa;IAC1B,sBAAsB,EAAE,wBAAwB;IAChD,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,sBAAsB,EAAE,wBAAwB;IAChD,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,sBAAsB,EAAE,wBAAwB;IAChD,WAAW,EAAE,aAAa;IAC1B,sBAAsB,EAAE,wBAAwB;IAChD,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,uBAAuB,EAAE,yBAAyB;CAC1C,CAAC;AAGX,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,IAAsB;IAChD,OAAO,WAAW,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,sDAAsD;IAC7C,IAAI,CAAgC;IAE7C,YAAY,IAAsB,EAAE,OAAe;QACjD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,gEAAgE;QAChE,4BAA4B;QAC5B,KAAK,CAAC,GAAG,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrB,+DAA+D;QAC/D,uDAAuD;QACvD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF;AAED,uEAAuE;AAEvE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,YAAY,CAAC,kBAAkB,EAAE,iBAAiB,IAAI,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY,EAAE,MAAc;IACvE,OAAO,IAAI,YAAY,CACrB,cAAc,EACd,GAAG,MAAM,KAAK,IAAI,oBAAoB,MAAM,GAAG,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY,EAAE,GAAW;IACnE,mEAAmE;IACnE,gEAAgE;IAChE,OAAO,IAAI,YAAY,CACrB,gBAAgB,EAChB,cAAc,IAAI,QAAQ,IAAI,wCAAwC,GAAG,GAAG,CAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,OAAO,IAAI,YAAY,CACrB,wBAAwB,EACxB,GAAG,EAAE,wCAAwC,CAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAe;IAC3D,OAAO,IAAI,YAAY,CAAC,gBAAgB,EAAE,iCAAiC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,YAAY,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/storage/events.d.ts

@@ -0,0 +1,12 @@
+export declare const STORAGE_EVENT_RECORD: {
+    readonly service: "storage";
+    readonly operations: readonly ["object_put", "object_delete", "metadata_update"];
+    readonly target: {
+        readonly name: "fullPath";
+        readonly description: "The object's full path within the bucket, e.g. avatars/alice.png.";
+        readonly always: true;
+    };
+};
+/** Every operation the storage surface emits. */
+export type StorageEventOperation = (typeof STORAGE_EVENT_RECORD)['operations'][number];
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/storage/events.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,oBAAoB;;;;;;;;CAQM,CAAC;AAExC,iDAAiD;AACjD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/storage/events.js

@@ -0,0 +1,10 @@
+export const STORAGE_EVENT_RECORD = {
+    service: 'storage',
+    operations: ['object_put', 'object_delete', 'metadata_update'],
+    target: {
+        name: 'fullPath',
+        description: "The object's full path within the bucket, e.g. avatars/alice.png.",
+        always: true,
+    },
+};
+//# sourceMappingURL=events.js.map

package/dist/storage/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/storage/events.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,iBAAiB,CAAC;IAC9D,MAAM,EAAE;QACN,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,mEAAmE;QAChF,MAAM,EAAE,IAAI;KACb;CACoC,CAAC"}

package/dist/storage/index.d.ts

@@ -24,17 +24,17 @@ export { getStorageSandbox, TARGET_SYMBOL } from './service.js';
 export type { CrossServiceIam, FirebaseStorage, StorageOptions, Target, SandboxTarget } from './service.js';
 export { getStorage, connectStorageEmulator } from './instances.js';
 export { StorageError } from './errors.js';
-export type { StorageErrorCode } from './errors.js';
+export { StorageErrorCode } from './errors.js';
 export { ref } from './reference.js';
 export type { StorageReference } from './reference.js';
-export { uploadBytes, uploadString } from './upload.js';
-export type { StringFormat } from './upload.js';
-export { uploadBytesResumable } from './resumable.js';
+export { uploadBytes, uploadString } from './observed.js';
+export { StringFormat } from './string-format.js';
+export { uploadBytesResumable } from './observed.js';
 export type { UploadTask, UploadTaskSnapshot, TaskState, TaskEvent } from './resumable.js';
-export { getBytes, getBlob, getDownloadURL, deleteObject } from './download.js';
-export { getMetadata, updateMetadata } from './metadata.js';
+export { getBytes, getBlob, getDownloadURL, deleteObject } from './observed.js';
+export { getMetadata, updateMetadata } from './observed.js';
 export type { SettableMetadata, FullMetadata, UploadResult } from './metadata.js';
-export { listAll } from './list.js';
+export { listAll } from './observed.js';
 export type { ListResult } from './list.js';
 export { parseStorageRules, evaluateStorageRules } from './rules.js';
 export type { StorageRules, StorageMethod, StorageVerb, StorageRequestMethod, StorageGrantVerb, StorageAuth, StorageRequest, StorageResource, EvaluationInput, EvaluationResult, FirestoreLookup, } from './rules.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5G,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAOpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5G,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAOpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/storage/index.js

@@ -23,12 +23,14 @@
 export { getStorageSandbox, TARGET_SYMBOL } from './service.js';
 export { getStorage, connectStorageEmulator } from './instances.js';
 export { StorageError } from './errors.js';
+export { StorageErrorCode } from './errors.js';
 export { ref } from './reference.js';
-export { uploadBytes, uploadString } from './upload.js';
-export { uploadBytesResumable } from './resumable.js';
-export { getBytes, getBlob, getDownloadURL, deleteObject } from './download.js';
-export { getMetadata, updateMetadata } from './metadata.js';
-export { listAll } from './list.js';
+export { uploadBytes, uploadString } from './observed.js';
+export { StringFormat } from './string-format.js';
+export { uploadBytesResumable } from './observed.js';
+export { getBytes, getBlob, getDownloadURL, deleteObject } from './observed.js';
+export { getMetadata, updateMetadata } from './observed.js';
+export { listAll } from './observed.js';
 export { parseStorageRules, evaluateStorageRules } from './rules.js';
 // ─── Admin / control-plane surface ───────────────────────────────────
 // Firebase Storage provisioning + status. The pure-fetch `api.ts`

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAGrC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAerE,wEAAwE;AACxE,kEAAkE;AAClE,+DAA+D;AAC/D,wCAAwC;AAExC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AASxB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAGrC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG5D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAerE,wEAAwE;AACxE,kEAAkE;AAClE,+DAA+D;AAC/D,wCAAwC;AAExC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AASxB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/storage/internal.d.ts

@@ -14,7 +14,16 @@
  * modular surface — mirroring how `pyric/sandbox/internal` carries
  * the sandbox's host-only seams.
  */
-export { bindStorageOperationContext, getAdminStorageSandbox, getStorageRulesResolution, } from './service.js';
+export { bindStorageOperationContext, getAdminStorageSandbox, getStorageService, storageAuth, storageOperationProvenance, targetOf, installStorageBackend, getStorageCrossServiceIam, getStorageRulesResolution, replaceCrossServiceIam, replaceStorageRules, } from './service.js';
+export { enforceRules, storageFirestoreLookup } from './enforce.js';
+export { requestResourceFor, resourceFromStored } from './sandbox/rules-resources.js';
+export { patchObjectMetadata, toFullMetadata, type AdminMetadataPatch } from './metadata.js';
 export { decodeString, defaultRawContentType, } from './upload.js';
+export { arrayBufferToBase64, base64ToBytes } from './base64.js';
+export { isStorageUrl, parseStorageUrl, refPathOf, type StorageLocation } from './url.js';
 export type { StorageRulesResolution } from './rules-resolution.js';
+export { snapshotStorageState, restoreStorageState, resetStorageState, referenceStorageState, restoreStorageReferences, type StorageStateRecord, type StorageReferenceRecord, } from './sandbox/persistence-state.js';
+export type { StorageBackend, StoredMetadata } from './persistence.js';
+export { fetchFromByteRoute, uploadOverByteRoute, type RemoteByteRoute, type RemoteReadRequest, type RemoteUploadRequest } from './remote-bytes.js';
+export { observeStorageOperation, storageTaskProgress, storageTaskResult } from '../sandbox/internal/storage-activity.js';
 //# sourceMappingURL=internal.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/storage/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/storage/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,iBAAiB,EACjB,WAAW,EACX,0BAA0B,EAC1B,QAAQ,EACR,qBAAqB,EACrB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EACL,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1F,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EACL,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,wBAAwB,EAC7G,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,GACrD,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEpJ,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/storage/internal.js

@@ -14,6 +14,14 @@
  * modular surface — mirroring how `pyric/sandbox/internal` carries
  * the sandbox's host-only seams.
  */
-export { bindStorageOperationContext, getAdminStorageSandbox, getStorageRulesResolution, } from './service.js';
+export { bindStorageOperationContext, getAdminStorageSandbox, getStorageService, storageAuth, storageOperationProvenance, targetOf, installStorageBackend, getStorageCrossServiceIam, getStorageRulesResolution, replaceCrossServiceIam, replaceStorageRules, } from './service.js';
+export { enforceRules, storageFirestoreLookup } from './enforce.js';
+export { requestResourceFor, resourceFromStored } from './sandbox/rules-resources.js';
+export { patchObjectMetadata, toFullMetadata } from './metadata.js';
 export { decodeString, defaultRawContentType, } from './upload.js';
+export { arrayBufferToBase64, base64ToBytes } from './base64.js';
+export { isStorageUrl, parseStorageUrl, refPathOf } from './url.js';
+export { snapshotStorageState, restoreStorageState, resetStorageState, referenceStorageState, restoreStorageReferences, } from './sandbox/persistence-state.js';
+export { fetchFromByteRoute, uploadOverByteRoute } from './remote-bytes.js';
+export { observeStorageOperation, storageTaskProgress, storageTaskResult } from '../sandbox/internal/storage-activity.js';
 //# sourceMappingURL=internal.js.map

package/dist/storage/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/storage/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/storage/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,iBAAiB,EACjB,WAAW,EACX,0BAA0B,EAC1B,QAAQ,EACR,qBAAqB,EACrB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAA2B,MAAM,eAAe,CAAC;AAC7F,OAAO,EACL,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAwB,MAAM,UAAU,CAAC;AAE1F,OAAO,EACL,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,wBAAwB,GAE9G,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAA0E,MAAM,mBAAmB,CAAC;AAEpJ,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/storage/metadata.d.ts

@@ -89,4 +89,23 @@ export declare function getMetadata(ref: StorageReference): Promise<FullMetadata
  * ambient-provenance window — see the note on `uploadBytes`.
  */
 export declare function updateMetadata(ref: StorageReference, patch: SettableMetadata, provenance?: EventProvenance): Promise<FullMetadata>;
+/**
+ * What the admin plane changes in one metadata write, as firebase-admin's
+ * `File.setMetadata` does.
+ */
+export interface AdminMetadataPatch {
+    /** Settable fields to replace. Custom metadata is merged through `customMetadata`. */
+    settable?: Omit<SettableMetadata, 'customMetadata'>;
+    /** Custom keys to set; `null` removes a key. Keys not named stay. */
+    customMetadata?: {
+        [key: string]: string | null;
+    };
+    /** The object's download tokens, or `null` to remove them, which revokes their URLs. */
+    downloadTokens?: string | null;
+}
+/**
+ * Merge `patch` into an object's metadata in one write. Rules apply as for
+ * `updateMetadata`; the admin plane's handle bypasses them.
+ */
+export declare function patchObjectMetadata(ref: StorageReference, patch: AdminMetadataPatch, provenance?: EventProvenance): Promise<FullMetadata>;
 //# sourceMappingURL=metadata.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/storage/metadata.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAEnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,gBAAgB,EACvB,GAAG,GAAE,IAAiB,GACrB,cAAc,CAchB;AAED,yDAAyD;AACzD,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1C;AAID;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkB9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,gBAAgB,EACvB,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,YAAY,CAAC,CAmDvB"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/storage/metadata.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAEnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,gBAAgB,EACvB,GAAG,GAAE,IAAiB,GACrB,cAAc,CAchB;AAED,yDAAyD;AACzD,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1C;AAID;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkB9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,gBAAgB,EACvB,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,QAAQ,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;IACpD,qEAAqE;IACrE,cAAc,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClD,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,kBAAkB,EACzB,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,YAAY,CAAC,CAiBvB"}

package/dist/storage/metadata.js

@@ -8,14 +8,15 @@
  *
  * The shapes mirror `firebase/storage`'s `FullMetadata` and
  * `SettableMetadata` (survey Section 5) so consumer code typechecks
- * against either implementation. Two intentional differences:
+ * against either implementation. One intentional difference, and one field
+ * that depends on the host:
  *
  * - `ref` is omitted from `FullMetadata`. The JS SDK populates it
  *   lazily; we don't need that machinery for the v1 scope.
- * - `downloadTokens` is omitted. Sandbox `getDownloadURL` returns a page-local
- *   object URL, so it has no Firebase download token to expose.
+ * - `downloadTokens` is kept when a host that serves bytes over HTTP mints
+ *   one; elsewhere `getDownloadURL` returns a `data:` URI and none exists.
  */
-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';
@@ -108,40 +109,70 @@ export async function getMetadata(ref) {
  * ambient-provenance window — see the note on `uploadBytes`.
  */
 export async function updateMetadata(ref, patch, provenance) {
-    guardNonRoot(ref, 'updateMetadata');
+    return rewriteMetadata(ref, 'updateMetadata', (existing, now) => applyMetadataPatch(existing, patch, now), provenance);
+}
+/**
+ * Merge `patch` into an object's metadata in one write. Rules apply as for
+ * `updateMetadata`; the admin plane's handle bypasses them.
+ */
+export async function patchObjectMetadata(ref, patch, provenance) {
+    return rewriteMetadata(ref, 'setMetadata', (existing, now) => {
+        const next = applyMetadataPatch(existing, patch.settable ?? {}, now);
+        const custom = { ...(existing.customMetadata ?? {}) };
+        for (const [key, value] of Object.entries(patch.customMetadata ?? {})) {
+            if (value === null)
+                delete custom[key];
+            else
+                custom[key] = value;
+        }
+        const hasCustom = Object.keys(custom).length > 0;
+        if (hasCustom)
+            next.customMetadata = custom;
+        else
+            delete next.customMetadata;
+        // `null` removes the tokens, which revokes their URLs.
+        const tokens = patch.downloadTokens;
+        if (tokens === null)
+            delete next.downloadTokens;
+        else if (tokens !== undefined)
+            next.downloadTokens = tokens;
+        return next;
+    }, provenance);
+}
+/**
+ * Replace an object's metadata with `change(existing)`: `update` rules see the
+ * changed view, the backend writes it, and one `metadata_update` event records
+ * it. Throws `storage/object-not-found` when the object is absent.
+ */
+async function rewriteMetadata(ref, operation, change, provenance) {
+    guardNonRoot(ref, operation);
     const target = targetOf(ref.storage);
     const operationProvenance = storageOperationProvenance(target, provenance);
     const service = await getStorageService(ref.storage);
     const existing = await service.backend.getMetadata(ref.fullPath);
+    const next = existing ? change(existing, getClock(target.sandbox).date()) : undefined;
     enforceRules(service, {
         request: {
             auth: storageAuth(target),
-            // updateMetadata always targets an existing object (it throws
+            // The operation always targets an existing object (it throws
             // object-not-found below when absent), so the verb is `update`.
             method: 'update',
             path: ref.fullPath,
-            // The patched view drives `request.resource` for size /
-            // contentType / metadata rule checks. Custom metadata is
-            // REPLACED wholesale on a patch (see `applyMetadataPatch`), so
-            // the about-to-write `request.resource.metadata` is the patch's
-            // custom metadata when supplied, else the existing value.
-            resource: existing
-                ? requestResourceFor({
-                    size: existing.size,
-                    contentType: patch.contentType ?? existing.contentType,
-                    customMetadata: patch.customMetadata ?? existing.customMetadata,
-                })
+            // The changed view drives `request.resource` for size / contentType /
+            // metadata rule checks.
+            resource: next
+                ? requestResourceFor({ size: next.size, contentType: next.contentType, customMetadata: next.customMetadata })
                 : undefined,
         },
         resource: resourceFromStored(existing),
     }, target, operationProvenance);
-    if (!existing) {
+    if (!existing || !next) {
         throw objectNotFound(ref.fullPath);
     }
-    const next = applyMetadataPatch(existing, patch);
     await service.backend.putMetadata(ref.fullPath, next);
     try {
         emitSandboxEvent(target.sandbox, makeServiceMutationEvent({
+            at: getClock(target.sandbox).now(),
             service: 'storage',
             op: 'metadata_update',
             path: ref.fullPath,

package/dist/storage/metadata.js.map

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

package/dist/storage/observed.d.ts

@@ -0,0 +1,16 @@
+import { uploadBytes as rawuploadBytes, uploadString as rawuploadString } from './upload.js';
+export declare const uploadBytes: typeof rawuploadBytes;
+export declare const uploadString: typeof rawuploadString;
+import { uploadBytesResumable as rawuploadBytesResumable } from './resumable.js';
+export declare const uploadBytesResumable: typeof rawuploadBytesResumable;
+import { getBytes as rawgetBytes, getBlob as rawgetBlob, getDownloadURL as rawgetDownloadURL, deleteObject as rawdeleteObject } from './download.js';
+export declare const getBytes: typeof rawgetBytes;
+export declare const getBlob: typeof rawgetBlob;
+export declare const getDownloadURL: typeof rawgetDownloadURL;
+export declare const deleteObject: typeof rawdeleteObject;
+import { getMetadata as rawgetMetadata, updateMetadata as rawupdateMetadata } from './metadata.js';
+export declare const getMetadata: typeof rawgetMetadata;
+export declare const updateMetadata: typeof rawupdateMetadata;
+import { listAll as rawlistAll } from './list.js';
+export declare const listAll: typeof rawlistAll;
+//# sourceMappingURL=observed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observed.d.ts","sourceRoot":"","sources":["../../src/storage/observed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,IAAI,cAAc,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7F,eAAO,MAAM,WAAW,EAAE,OAAO,cAAuE,CAAC;AACzG,eAAO,MAAM,YAAY,EAAE,OAAO,eAA0E,CAAC;AAC7G,OAAO,EAAE,oBAAoB,IAAI,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACjF,eAAO,MAAM,oBAAoB,EAAE,OAAO,uBAAkG,CAAC;AAC7I,OAAO,EAAE,QAAQ,IAAI,WAAW,EAAE,OAAO,IAAI,UAAU,EAAE,cAAc,IAAI,iBAAiB,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,eAAe,CAAC;AACrJ,eAAO,MAAM,QAAQ,EAAE,OAAO,WAA8D,CAAC;AAC7F,eAAO,MAAM,OAAO,EAAE,OAAO,UAA2D,CAAC;AACzF,eAAO,MAAM,cAAc,EAAE,OAAO,iBAAgF,CAAC;AACrH,eAAO,MAAM,YAAY,EAAE,OAAO,eAA0E,CAAC;AAC7G,OAAO,EAAE,WAAW,IAAI,cAAc,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACnG,eAAO,MAAM,WAAW,EAAE,OAAO,cAAuE,CAAC;AACzG,eAAO,MAAM,cAAc,EAAE,OAAO,iBAAgF,CAAC;AACrH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAClD,eAAO,MAAM,OAAO,EAAE,OAAO,UAA2D,CAAC"}

package/dist/storage/observed.js

@@ -0,0 +1,17 @@
+import { observeStorageOperation } from '../sandbox/internal/storage-activity.js';
+import { uploadBytes as rawuploadBytes, uploadString as rawuploadString } from './upload.js';
+export const uploadBytes = observeStorageOperation('uploadBytes', rawuploadBytes);
+export const uploadString = observeStorageOperation('uploadString', rawuploadString);
+import { uploadBytesResumable as rawuploadBytesResumable } from './resumable.js';
+export const uploadBytesResumable = observeStorageOperation('uploadBytesResumable', rawuploadBytesResumable);
+import { getBytes as rawgetBytes, getBlob as rawgetBlob, getDownloadURL as rawgetDownloadURL, deleteObject as rawdeleteObject } from './download.js';
+export const getBytes = observeStorageOperation('getBytes', rawgetBytes);
+export const getBlob = observeStorageOperation('getBlob', rawgetBlob);
+export const getDownloadURL = observeStorageOperation('getDownloadURL', rawgetDownloadURL);
+export const deleteObject = observeStorageOperation('deleteObject', rawdeleteObject);
+import { getMetadata as rawgetMetadata, updateMetadata as rawupdateMetadata } from './metadata.js';
+export const getMetadata = observeStorageOperation('getMetadata', rawgetMetadata);
+export const updateMetadata = observeStorageOperation('updateMetadata', rawupdateMetadata);
+import { listAll as rawlistAll } from './list.js';
+export const listAll = observeStorageOperation('listAll', rawlistAll);
+//# sourceMappingURL=observed.js.map

package/dist/storage/observed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed.js","sourceRoot":"","sources":["../../src/storage/observed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,WAAW,IAAI,cAAc,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7F,MAAM,CAAC,MAAM,WAAW,GAA0B,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;AACzG,MAAM,CAAC,MAAM,YAAY,GAA2B,uBAAuB,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;AAC7G,OAAO,EAAE,oBAAoB,IAAI,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAmC,uBAAuB,CAAC,sBAAsB,EAAE,uBAAuB,CAAC,CAAC;AAC7I,OAAO,EAAE,QAAQ,IAAI,WAAW,EAAE,OAAO,IAAI,UAAU,EAAE,cAAc,IAAI,iBAAiB,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,eAAe,CAAC;AACrJ,MAAM,CAAC,MAAM,QAAQ,GAAuB,uBAAuB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAC7F,MAAM,CAAC,MAAM,OAAO,GAAsB,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACzF,MAAM,CAAC,MAAM,cAAc,GAA6B,uBAAuB,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AACrH,MAAM,CAAC,MAAM,YAAY,GAA2B,uBAAuB,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;AAC7G,OAAO,EAAE,WAAW,IAAI,cAAc,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACnG,MAAM,CAAC,MAAM,WAAW,GAA0B,uBAAuB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;AACzG,MAAM,CAAC,MAAM,cAAc,GAA6B,uBAAuB,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AACrH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAClD,MAAM,CAAC,MAAM,OAAO,GAAsB,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC"}