@ariestools/aries-dapp-core 0.1.7 → 0.1.8

package/dist/node/DappActor.d.ts

@@ -1,26 +1,47 @@
 import { AbstractActor } from './actor/AbstractActor.ts';
 import type { ActorParams } from './actor/types.ts';
-import type { DappBucketStore } from './providers/DappBucketStore.ts';
+import type { DappObjectReader, DappObjectWriter } from './providers/capabilities.ts';
 import type { DappReducer } from './reducer/DappReducer.ts';
 export interface DappActorParams extends ActorParams {
     /** Delay before the first reduce pass. Defaults to 2000ms. */
     firstRunDelayMs?: number;
+    /**
+     * When set, after this many consecutive reduce failures the actor stops so a
+     * supervisor can restart the process.
+     */
+    maxConsecutiveFailures?: number;
+    /**
+     * When true (default), publish durable indexer status to the state store
+     * after each reduce pass (success or failure).
+     */
+    publishStatus?: boolean;
     reduceIntervalMs?: number;
     reducer: DappReducer;
 }
 /**
  * The stock dapp actor: resolves the three bucket stores from the shared
  * locator, then drives its reducer on an interval to keep `state` and `index`
- * derived from `data`. Multiple actors (each with its own reducer) can share
- * one locator; this is the default single-reducer instance the daemon boots.
+ * derived from authoritative input. Multiple actors (each with its own
+ * reducer) can share one locator; this is the default single-reducer instance
+ * the local daemon boots.
  */
 export declare class DappActor extends AbstractActor<DappActorParams> {
     static readonly dependencies: readonly ["DappDataStore", "DappStateStore", "DappIndexStore"];
-    protected _data: DappBucketStore;
-    protected _index: DappBucketStore;
-    protected _state: DappBucketStore;
+    protected _data: DappObjectReader;
+    protected _index: DappObjectWriter;
+    protected _state: DappObjectWriter;
+    private _consecutiveFailures;
+    private readonly _firstPass;
+    private _firstPassSettled;
+    /** Consecutive reduce failures since the last success. */
+    get consecutiveFailures(): number;
     createHandler(): Promise<void>;
-    protected startHandler(): Promise<void>;
+    readyHandler(): Promise<void>;
+    startHandler(): Promise<void>;
+    stopHandler(): Promise<void>;
+    private publishStatusFromProgress;
     private runReducePass;
+    private safePublishStatus;
+    private settleFirstPass;
 }
 //# sourceMappingURL=DappActor.d.ts.map

package/dist/node/DappActor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DappActor.d.ts","sourceRoot":"","sources":["../../src/DappActor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAIrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,WAAW,CAAA;CACrB;AAKD;;;;;GAKG;AACH,qBACa,SAAU,SAAQ,aAAa,CAAC,eAAe,CAAC;IAC3D,MAAM,CAAC,QAAQ,CAAC,YAAY,iEAIlB;IAEV,SAAS,CAAC,KAAK,EAAG,eAAe,CAAA;IACjC,SAAS,CAAC,MAAM,EAAG,eAAe,CAAA;IAClC,SAAS,CAAC,MAAM,EAAG,eAAe,CAAA;IAEnB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;cAOpB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAUxC,aAAa;CAQ5B"}
+{"version":3,"file":"DappActor.d.ts","sourceRoot":"","sources":["../../src/DappActor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AASrF,OAAO,KAAK,EAAsB,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE/E,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,WAAW,CAAA;CACrB;AAmCD;;;;;;GAMG;AACH,qBACa,SAAU,SAAQ,aAAa,CAAC,eAAe,CAAC;IAC3D,MAAM,CAAC,QAAQ,CAAC,YAAY,iEAIlB;IAEV,SAAS,CAAC,KAAK,EAAG,gBAAgB,CAAA;IAClC,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAA;IACnC,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAA;IAEnC,OAAO,CAAC,oBAAoB,CAAI;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,iBAAiB,CAAQ;IAEjC,0DAA0D;IAC1D,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAEc,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;YAK7B,yBAAyB;YAkBzB,aAAa;YAsCb,iBAAiB;IAW/B,OAAO,CAAC,eAAe;CAMxB"}

package/dist/node/actor/AbstractActor.d.ts

@@ -17,6 +17,7 @@ import type { ActorParams, DappContext, DappProviderLocator, ReadyState } from '
 export declare abstract class AbstractActor<TParams extends ActorParams = ActorParams> extends AbstractCreatable<TParams> {
     protected readonly _intervals: Map<string, NodeJS.Timeout>;
     protected readonly _timeouts: Map<string, NodeJS.Timeout>;
+    private _abortController;
     private _idLogger?;
     private readonly _inFlight;
     private readonly _readyDeferred;
@@ -27,22 +28,26 @@ export declare abstract class AbstractActor<TParams extends ActorParams = ActorP
     get readyState(): ReadyState;
     protected get context(): DappContext;
     protected get locator(): DappProviderLocator;
+    /** Abort signal cancelled when the actor stops (or is replaced on restart). */
+    protected get signal(): AbortSignal;
     static paramsHandler<T extends CreatableInstance>(params?: Partial<T['params']>): Promise<T['params']>;
+    /** Override to prove the actor can do useful work. Default: no-op. */
+    readyHandler(): Promise<void>;
     /**
-     * Register a recurring task. The interval only fires while the actor is
-     * `started`, and a run is skipped if the previous one is still in flight, so
-     * a slow pass can never stack on top of itself. Must be called from
-     * `startHandler` (guards on `starting` status), mirroring the xl1 actor.
+     * Register a recurring task. The first invocation fires after `dueTimeMs`
+     * (the documented first-run delay); subsequent invocations fire every
+     * `periodMs` while the actor is `started`. A run is skipped if the previous
+     * one is still in flight, so a slow pass can never stack on top of itself.
+     * Must be called from `startHandler` (guards on `starting` status).
      */
     registerTimer(timerName: string, callback: () => Promise<void>, dueTimeMs: number, periodMs: number): void;
     /**
-     * Run the warm-pass once. Not driven automatically here (no orchestrator);
-     * a caller invokes it after `start()` if it wants `whenReady()` to resolve.
+     * Run the warm-pass once. The standard boot path invokes this after
+     * `start()` so readiness either resolves or rejects.
      */
     runReadyHandler(): Promise<void>;
+    startHandler(): Promise<void>;
     stopHandler(): Promise<void>;
     whenReady(): Promise<void>;
-    /** Override to prove the actor can do useful work. Default: no-op. */
-    protected readyHandler(): Promise<void>;
 }
 //# sourceMappingURL=AbstractActor.d.ts.map

package/dist/node/actor/AbstractActor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractActor.d.ts","sourceRoot":"","sources":["../../../src/actor/AbstractActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EACL,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EACV,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAC1D,MAAM,YAAY,CAAA;AAoBnB;;;;;;;;;;;;GAYG;AACH,8BAAsB,aAAa,CAAC,OAAO,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,iBAAiB,CAAC,OAAO,CAAC;IAC/G,SAAS,CAAC,QAAQ,CAAC,UAAU,8BAAoC;IACjE,SAAS,CAAC,QAAQ,CAAC,SAAS,8BAAoC;IAEhE,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,WAAW,CAAC,CAAO;IAC3B,OAAO,CAAC,WAAW,CAAwB;IAE3C,IAAa,MAAM,IAAI,MAAM,CAM5B;IAED,IAAI,UAAU,IAAI,KAAK,GAAG,SAAS,CAElC;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,SAAS,KAAK,OAAO,IAAI,WAAW,CAEnC;IAED,SAAS,KAAK,OAAO,IAAI,mBAAmB,CAE3C;WAEqB,aAAa,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAOrH;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAmC1G;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAevB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,sEAAsE;cACtD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9C"}
+{"version":3,"file":"AbstractActor.d.ts","sourceRoot":"","sources":["../../../src/actor/AbstractActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EACL,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EACV,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAC1D,MAAM,YAAY,CAAA;AAyBnB;;;;;;;;;;;;GAYG;AACH,8BAAsB,aAAa,CAAC,OAAO,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,iBAAiB,CAAC,OAAO,CAAC;IAC/G,SAAS,CAAC,QAAQ,CAAC,UAAU,8BAAoC;IACjE,SAAS,CAAC,QAAQ,CAAC,SAAS,8BAAoC;IAEhE,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,WAAW,CAAC,CAAO;IAC3B,OAAO,CAAC,WAAW,CAAwB;IAE3C,IAAa,MAAM,IAAI,MAAM,CAM5B;IAED,IAAI,UAAU,IAAI,KAAK,GAAG,SAAS,CAElC;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,SAAS,KAAK,OAAO,IAAI,WAAW,CAEnC;IAED,SAAS,KAAK,OAAO,IAAI,mBAAmB,CAE3C;IAED,+EAA+E;IAC/E,SAAS,KAAK,MAAM,IAAI,WAAW,CAElC;WAEqB,aAAa,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAOrH,sEAAsE;IAChE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;;;;;OAMG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAuC1G;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAevB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBrC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAGjC"}

package/dist/node/actor/types.d.ts

@@ -18,6 +18,8 @@ export interface DappContext {
  */
 export interface DappProviderLocator {
     readonly context: DappContext;
+    /** Release owned resources (e.g. an S3 client constructed by the locator). */
+    destroy(): void;
     getInstance<T>(moniker: DappMoniker): Promise<T>;
     has(moniker: DappMoniker): boolean;
     register(moniker: DappMoniker, instance: unknown): void;
@@ -26,5 +28,10 @@ export interface DappProviderLocator {
 /** Base params every dapp actor takes: the shared, process-wide locator. */
 export interface ActorParams extends CreatableParams {
     locator: DappProviderLocator;
+    /**
+     * Max time to wait for in-flight timer work on stop after aborting the
+     * signal. When omitted, stop waits until in-flight work settles.
+     */
+    shutdownTimeoutMs?: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/node/actor/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actor/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE9D,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAChD,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;IACvD,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;CAChE;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,OAAO,EAAE,mBAAmB,CAAA;CAC7B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actor/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE9D,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,8EAA8E;IAC9E,OAAO,IAAI,IAAI,CAAA;IACf,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAChD,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;IACvD,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;CAChE;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,OAAO,EAAE,mBAAmB,CAAA;IAC5B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B"}

package/dist/node/bin/dappServer.d.ts

@@ -1,9 +1,13 @@
 #!/usr/bin/env node
 /**
- * Composed dapp daemon: boots the S3-compatible storage server (from
- * `@ariestools/aries-dapp-serve`) and, in the same process, a shared
- * process-wide locator plus the DappActor(s) that derive `state`/`index` from
- * `data` on an interval. Spawned by `aries dapp up`.
+ * **Local development only.** Composed dapp daemon: boots the embedded
+ * S3-compatible storage server (from `@ariestools/aries-dapp-serve`) and, in
+ * the same process, a shared process-wide locator plus a `noopReducer`
+ * DappActor. Spawned by `aries dapp up`.
+ *
+ * Production indexers must not use this binary. Compose `dapp-core` from a
+ * project-owned entrypoint with real store bindings, an injected S3/R2 client,
+ * and a real reducer — see the package README.
  */
 export {};
 //# sourceMappingURL=dappServer.d.ts.map

package/dist/node/bin/dappServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dappServer.d.ts","sourceRoot":"","sources":["../../../src/bin/dappServer.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}
+{"version":3,"file":"dappServer.d.ts","sourceRoot":"","sources":["../../../src/bin/dappServer.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/node/boot/bootDappActors.d.ts

@@ -2,13 +2,24 @@ import type { DappProviderLocator } from '../actor/types.ts';
 import { DappActor } from '../DappActor.ts';
 import type { DappReducer } from '../reducer/DappReducer.ts';
 export interface DappActorSpec {
+    firstRunDelayMs?: number;
+    maxConsecutiveFailures?: number;
     name: string;
+    publishStatus?: boolean;
     reduceIntervalMs?: number;
     reducer: DappReducer;
+    /**
+     * When true (default), run readiness after start so boot completes only when
+     * the first reduce pass succeeds (or fails under the failure policy).
+     */
+    runReady?: boolean;
+    shutdownTimeoutMs?: number;
 }
 /**
  * Creates and starts one {@link DappActor} per spec, all sharing the single
- * process-wide locator. Returns them so the caller can stop them on shutdown.
+ * process-wide locator. On partial failure, actors already started are stopped
+ * before the error is rethrown. Returns them so the caller can stop them on
+ * shutdown.
  */
 export declare function bootDappActors(locator: DappProviderLocator, specs: readonly DappActorSpec[]): Promise<DappActor[]>;
 //# sourceMappingURL=bootDappActors.d.ts.map

package/dist/node/boot/bootDappActors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootDappActors.d.ts","sourceRoot":"","sources":["../../../src/boot/bootDappActors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,WAAW,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,OAAO,CAAC,SAAS,EAAE,CAAC,CActB"}
+{"version":3,"file":"bootDappActors.d.ts","sourceRoot":"","sources":["../../../src/boot/bootDappActors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,OAAO,CAAC,SAAS,EAAE,CAAC,CAiCtB"}

package/dist/node/consumer/api.d.ts

@@ -0,0 +1,56 @@
+import type { GenerationManifest, HeadManifest, IndexerStatus } from '../publication/types.ts';
+import { hashBytesAsync } from './hash.ts';
+import { parseGenerationManifest, parseHead, parseIndexerStatus, parseMapRoot, parseMapShard } from './parse.ts';
+export type FetchLike = (input: string, init?: {
+    method?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+}>;
+export interface PublicBases {
+    index?: string;
+    state: string;
+}
+export interface VerifyPublishedViewResult {
+    head: HeadManifest;
+    layout: 'full' | 'incremental-cas';
+    manifest?: GenerationManifest;
+    rootShards?: Record<string, string>;
+    source?: GenerationManifest['source'];
+    status?: IndexerStatus;
+}
+export interface ResolveObjectResult {
+    body: Uint8Array;
+    contentType?: string;
+    hash: string;
+    logicalKey: string;
+    publicUrl: string;
+}
+export declare function shardIdForKey(logicalKey: string, hexChars?: number): string;
+export { hashBytesAsync, parseGenerationManifest, parseHead, parseIndexerStatus, parseMapRoot, parseMapShard, };
+/**
+ * Fetch head (+ optional status), verify manifest/root integrity, optional
+ * signature check. Does not download the full object set.
+ */
+export declare function verifyPublishedView(options: {
+    bases: PublicBases;
+    fetch: FetchLike;
+    includeStatus?: boolean;
+    verifySignature?: (canonical: Uint8Array, signature: string) => boolean | Promise<boolean>;
+}): Promise<VerifyPublishedViewResult>;
+/**
+ * Resolve and verify a single logical object under the current head without
+ * downloading a full-generation object list (incremental: root+shard+cas).
+ */
+export declare function resolveObject(options: {
+    bases: PublicBases;
+    fetch: FetchLike;
+    head?: HeadManifest;
+    logicalKey: string;
+    role?: 'state' | 'index';
+    shardHexChars?: number;
+}): Promise<ResolveObjectResult>;
+//# sourceMappingURL=api.d.ts.map

package/dist/node/consumer/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/consumer/api.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAChD,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EACL,uBAAuB,EACvB,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC;IAC7E,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;IACnC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACxB,CAAC,CAAA;AAEF,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAA;IAClC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IACrC,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAoBD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,SAA0B,GAAG,MAAM,CAE5F;AAED,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,CAAA;AAkCD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,SAAS,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC3F,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA2CrC;AA6CD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,SAAS,CAAA;IAChB,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqC/B"}

package/dist/node/consumer/hash.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Browser-neutral SHA-256 via Web Crypto (`crypto.subtle`).
+ * Available in modern browsers and Node ≥18 without Node crypto modules.
+ */
+export declare function hashBytesAsync(body: string | Uint8Array): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/node/consumer/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/consumer/hash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAO/E"}

package/dist/node/consumer/parse.d.ts

@@ -0,0 +1,18 @@
+import { MAP_ROOT_SCHEMA, MAP_SHARD_SCHEMA } from '../publication/constants.ts';
+import type { GenerationManifest, HeadManifest, IndexerStatus } from '../publication/types.ts';
+export declare function parseHead(json: unknown): HeadManifest;
+export declare function parseGenerationManifest(json: unknown): GenerationManifest;
+export declare function parseIndexerStatus(json: unknown): IndexerStatus;
+export declare function parseMapRoot(json: unknown): {
+    schema: typeof MAP_ROOT_SCHEMA;
+    shards: Record<string, string>;
+};
+export declare function parseMapShard(json: unknown): {
+    entries: Record<string, {
+        contentType?: string;
+        hash: string;
+        size: number;
+    }>;
+    schema: typeof MAP_SHARD_SCHEMA;
+};
+//# sourceMappingURL=parse.d.ts.map

package/dist/node/consumer/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/consumer/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,eAAe,EACf,gBAAgB,EACjB,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EACV,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAChD,MAAM,yBAAyB,CAAA;AAiBhC,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAsBrD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CASzE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAM/D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG;IAC3C,MAAM,EAAE,OAAO,eAAe,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B,CAYA;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7E,MAAM,EAAE,OAAO,gBAAgB,CAAA;CAChC,CASA"}

package/dist/node/consumer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Browser-neutral public surface for verifying and resolving published dapp
+ * views. Must not import Node built-ins or the AWS SDK.
+ */
+export type { FetchLike, PublicBases, ResolveObjectResult, VerifyPublishedViewResult, } from './consumer/api.ts';
+export { hashBytesAsync, parseGenerationManifest, parseHead, parseIndexerStatus, parseMapRoot, parseMapShard, resolveObject, shardIdForKey, verifyPublishedView, } from './consumer/api.ts';
+export { canonicalHeadBytes } from './publication/canonicalHead.ts';
+export { CACHE_CONTROL_IMMUTABLE, CACHE_CONTROL_REVALIDATE, CAS_PREFIX, DEFAULT_SHARD_HEX_CHARS, GENERATION_MANIFEST_SCHEMA, GENERATIONS_PREFIX, HEAD_KEY, HEAD_MANIFEST_SCHEMA, INDEXER_STATUS_SCHEMA, MAP_ROOT_SCHEMA, MAP_ROOTS_PREFIX, MAP_SHARD_SCHEMA, MAP_SHARDS_PREFIX, PINS_KEY, PINS_SCHEMA, RECEIPT_SCHEMA, RECEIPTS_PREFIX, STATUS_KEY, } from './publication/constants.ts';
+//# sourceMappingURL=consumer.d.ts.map

package/dist/node/consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../src/consumer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACV,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,yBAAyB,GACvE,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,cAAc,EAAE,uBAAuB,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EACnG,aAAa,EAAE,aAAa,EAAE,mBAAmB,GAClD,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,UAAU,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,4BAA4B,CAAA"}

package/dist/node/consumer.mjs

@@ -0,0 +1,330 @@
+// src/publication/canonicalHead.ts
+function canonicalHeadBytes(head) {
+  const payload = {
+    schema: head.schema,
+    generation: head.generation,
+    manifestKey: head.manifestKey,
+    manifestHash: head.manifestHash,
+    publishedAt: head.publishedAt
+  };
+  if (head.previousGeneration !== void 0) {
+    payload.previousGeneration = head.previousGeneration;
+  }
+  if (head.revision !== void 0) payload.revision = head.revision;
+  if (head.trust !== void 0) payload.trust = head.trust;
+  if (head.layout !== void 0) payload.layout = head.layout;
+  const ordered = {};
+  for (const key of [
+    "schema",
+    "generation",
+    "manifestKey",
+    "manifestHash",
+    "publishedAt",
+    "previousGeneration",
+    "revision",
+    "trust",
+    "layout"
+  ]) {
+    if (key in payload) ordered[key] = payload[key];
+  }
+  return new TextEncoder().encode(`${JSON.stringify(ordered)}
+`);
+}
+
+// src/publication/constants.ts
+var HEAD_KEY = "head.json";
+var STATUS_KEY = "status.json";
+var PINS_KEY = "pins.json";
+var GENERATIONS_PREFIX = "generations";
+var CAS_PREFIX = "cas/sha256";
+var MAP_ROOTS_PREFIX = "map/roots";
+var MAP_SHARDS_PREFIX = "map/shards";
+var RECEIPTS_PREFIX = "receipts";
+var CACHE_CONTROL_IMMUTABLE = "public, max-age=31536000, immutable";
+var CACHE_CONTROL_REVALIDATE = "public, max-age=0, must-revalidate";
+var GENERATION_MANIFEST_SCHEMA = "network.aries.dapp.generation.manifest";
+var HEAD_MANIFEST_SCHEMA = "network.aries.dapp.head";
+var INDEXER_STATUS_SCHEMA = "network.aries.dapp.indexer.status";
+var PINS_SCHEMA = "network.aries.dapp.pins";
+var MAP_ROOT_SCHEMA = "network.aries.dapp.map.root";
+var MAP_SHARD_SCHEMA = "network.aries.dapp.map.shard";
+var RECEIPT_SCHEMA = "network.aries.dapp.generation.receipt";
+var DEFAULT_SHARD_HEX_CHARS = 2;
+
+// src/publication/shard.ts
+function shardIdForKey(logicalKey, hexChars = DEFAULT_SHARD_HEX_CHARS) {
+  let h = 2166136261;
+  for (let i = 0; i < logicalKey.length; i++) {
+    h ^= logicalKey.codePointAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return (h >>> 0).toString(16).padStart(8, "0").slice(0, hexChars);
+}
+
+// src/consumer/hash.ts
+function bytesOf(body) {
+  return typeof body === "string" ? new TextEncoder().encode(body) : body;
+}
+function toHex(bytes) {
+  let out = "";
+  for (const b of bytes) out += b.toString(16).padStart(2, "0");
+  return out;
+}
+function requireSubtle() {
+  const subtle = globalThis.crypto?.subtle;
+  if (subtle === void 0) {
+    throw new Error("Web Crypto subtle API is required for consumer hashing");
+  }
+  return subtle;
+}
+async function hashBytesAsync(body) {
+  const data = bytesOf(body);
+  const digest = await requireSubtle().digest(
+    "SHA-256",
+    data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength)
+  );
+  return toHex(new Uint8Array(digest));
+}
+
+// src/consumer/parse.ts
+function asRecord(value, label) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`Invalid ${label}: expected object`);
+  }
+  return value;
+}
+function requireString(obj, key, label) {
+  const v = obj[key];
+  if (typeof v !== "string" || v.length === 0) {
+    throw new Error(`Invalid ${label}: missing string "${key}"`);
+  }
+  return v;
+}
+function parseHead(json) {
+  const obj = asRecord(json, "head");
+  if (obj.schema !== HEAD_MANIFEST_SCHEMA) {
+    throw new Error(`Invalid head schema: ${String(obj.schema)}`);
+  }
+  return {
+    schema: HEAD_MANIFEST_SCHEMA,
+    generation: requireString(obj, "generation", "head"),
+    manifestKey: requireString(obj, "manifestKey", "head"),
+    manifestHash: requireString(obj, "manifestHash", "head"),
+    publishedAt: requireString(obj, "publishedAt", "head"),
+    ...typeof obj.previousGeneration === "string" && { previousGeneration: obj.previousGeneration },
+    ...typeof obj.revision === "number" && { revision: obj.revision },
+    ...obj.trust === "trusted-origin" || obj.trust === "signed" ? { trust: obj.trust } : {},
+    ...typeof obj.signature === "string" && { signature: obj.signature },
+    ...obj.layout === "full" || obj.layout === "incremental-cas" ? { layout: obj.layout } : {}
+  };
+}
+function parseGenerationManifest(json) {
+  const obj = asRecord(json, "manifest");
+  if (obj.schema !== GENERATION_MANIFEST_SCHEMA) {
+    throw new Error(`Invalid generation manifest schema: ${String(obj.schema)}`);
+  }
+  if (!Array.isArray(obj.objects)) {
+    throw new TypeError("Invalid generation manifest: objects must be an array");
+  }
+  return obj;
+}
+function parseIndexerStatus(json) {
+  const obj = asRecord(json, "status");
+  if (obj.schema !== INDEXER_STATUS_SCHEMA) {
+    throw new Error(`Invalid status schema: ${String(obj.schema)}`);
+  }
+  return obj;
+}
+function parseMapRoot(json) {
+  const obj = asRecord(json, "map root");
+  if (obj.schema !== MAP_ROOT_SCHEMA) {
+    throw new Error(`Invalid map root schema: ${String(obj.schema)}`);
+  }
+  if (obj.shards === null || typeof obj.shards !== "object") {
+    throw new Error("Invalid map root: shards must be an object");
+  }
+  return obj;
+}
+function parseMapShard(json) {
+  const obj = asRecord(json, "map shard");
+  if (obj.schema !== MAP_SHARD_SCHEMA) {
+    throw new Error(`Invalid map shard schema: ${String(obj.schema)}`);
+  }
+  return obj;
+}
+
+// src/consumer/api.ts
+function joinUrl(base, key) {
+  const b = base.replace(/\/+$/, "");
+  const k = key.replace(/^\/+/, "");
+  return `${b}/${k}`;
+}
+async function fetchJson(fetchImpl, url) {
+  const res = await fetchImpl(url);
+  if (!res.ok) throw new Error(`GET ${url} failed: ${res.status}`);
+  return await res.json();
+}
+async function fetchBytes(fetchImpl, url) {
+  const res = await fetchImpl(url);
+  if (!res.ok) throw new Error(`GET ${url} failed: ${res.status}`);
+  return new Uint8Array(await res.arrayBuffer());
+}
+function shardIdForKey2(logicalKey, hexChars = DEFAULT_SHARD_HEX_CHARS) {
+  return shardIdForKey(logicalKey, hexChars);
+}
+async function loadFullManifest(fetchImpl, bases, head) {
+  const manifestUrl = joinUrl(bases.state, head.manifestKey);
+  const manifestBytes = await fetchBytes(fetchImpl, manifestUrl);
+  const actual = await hashBytesAsync(manifestBytes);
+  if (actual !== head.manifestHash) {
+    throw new Error(`Manifest hash mismatch: head=${head.manifestHash} actual=${actual}`);
+  }
+  const manifest = parseGenerationManifest(JSON.parse(new TextDecoder().decode(manifestBytes)));
+  if (manifest.generation !== head.generation) {
+    throw new Error("Manifest generation does not match head");
+  }
+  return manifest;
+}
+async function loadRootShards(fetchImpl, bases, head) {
+  const rootUrl = joinUrl(bases.state, head.manifestKey);
+  const rootBytes = await fetchBytes(fetchImpl, rootUrl);
+  const actual = await hashBytesAsync(rootBytes);
+  if (actual !== head.manifestHash) {
+    throw new Error(`Root hash mismatch: head=${head.manifestHash} actual=${actual}`);
+  }
+  return parseMapRoot(JSON.parse(new TextDecoder().decode(rootBytes))).shards;
+}
+async function verifyPublishedView(options) {
+  const headUrl = joinUrl(options.bases.state, HEAD_KEY);
+  const head = parseHead(await fetchJson(options.fetch, headUrl));
+  if (head.trust === "signed") {
+    if (options.verifySignature === void 0) {
+      throw new Error("Signed head requires verifySignature callback");
+    }
+    if (head.signature === void 0) throw new Error("Signed head missing signature");
+    const ok = await options.verifySignature(canonicalHeadBytes(head), head.signature);
+    if (!ok) throw new Error("Head signature verification failed");
+  }
+  const layout = head.layout === "incremental-cas" ? "incremental-cas" : "full";
+  let manifest;
+  let rootShards;
+  let source;
+  if (layout === "full") {
+    manifest = await loadFullManifest(options.fetch, options.bases, head);
+    source = manifest.source;
+  } else {
+    rootShards = await loadRootShards(options.fetch, options.bases, head);
+  }
+  let status;
+  if (options.includeStatus === true) {
+    try {
+      status = parseIndexerStatus(
+        await fetchJson(options.fetch, joinUrl(options.bases.state, STATUS_KEY))
+      );
+    } catch {
+    }
+  }
+  return {
+    head,
+    layout,
+    ...manifest !== void 0 && { manifest },
+    ...rootShards !== void 0 && { rootShards },
+    ...source !== void 0 && { source },
+    ...status !== void 0 && { status }
+  };
+}
+async function resolveIncrementalObject(options) {
+  const base = options.role === "index" ? options.bases.index ?? options.bases.state : options.bases.state;
+  const rootBytes = await fetchBytes(
+    options.fetch,
+    joinUrl(options.bases.state, options.head.manifestKey)
+  );
+  if (await hashBytesAsync(rootBytes) !== options.head.manifestHash) {
+    throw new Error("Map root hash mismatch");
+  }
+  const root = parseMapRoot(JSON.parse(new TextDecoder().decode(rootBytes)));
+  const sid = shardIdForKey2(options.logicalKey, options.shardHexChars);
+  const shardHash = root.shards[sid];
+  if (shardHash === void 0) throw new Error(`No shard for key "${options.logicalKey}"`);
+  const shardKey = `${MAP_SHARDS_PREFIX}/${shardHash}.json`;
+  const shardBytes = await fetchBytes(options.fetch, joinUrl(options.bases.state, shardKey));
+  if (await hashBytesAsync(shardBytes) !== shardHash) throw new Error("Shard hash mismatch");
+  const shard = parseMapShard(JSON.parse(new TextDecoder().decode(shardBytes)));
+  const entry = shard.entries[options.logicalKey];
+  if (entry === void 0) throw new Error(`Key not found: ${options.logicalKey}`);
+  const casKey = `${CAS_PREFIX}/${entry.hash}`;
+  const publicUrl = joinUrl(base, casKey);
+  const body = await fetchBytes(options.fetch, publicUrl);
+  if (await hashBytesAsync(body) !== entry.hash) {
+    throw new Error(`Object hash mismatch for ${options.logicalKey}`);
+  }
+  return {
+    body,
+    hash: entry.hash,
+    logicalKey: options.logicalKey,
+    publicUrl,
+    ...entry.contentType !== void 0 && { contentType: entry.contentType }
+  };
+}
+async function resolveObject(options) {
+  const role = options.role ?? "index";
+  const head = options.head ?? parseHead(await fetchJson(options.fetch, joinUrl(options.bases.state, HEAD_KEY)));
+  const logicalKey = options.logicalKey.replaceAll(/^\/+/g, "");
+  if (head.layout === "incremental-cas") {
+    return await resolveIncrementalObject({
+      bases: options.bases,
+      fetch: options.fetch,
+      head,
+      logicalKey,
+      role,
+      ...options.shardHexChars !== void 0 && { shardHexChars: options.shardHexChars }
+    });
+  }
+  const manifest = await loadFullManifest(options.fetch, options.bases, head);
+  const ref = manifest.objects.find((o) => o.role === role && (o.key === logicalKey || o.key.endsWith(`/${logicalKey}`) || o.key === `${GENERATIONS_PREFIX}/${head.generation}/${logicalKey}`));
+  if (ref === void 0) throw new Error(`Key not found in full manifest: ${logicalKey}`);
+  const objectBase = ref.role === "index" ? options.bases.index ?? options.bases.state : options.bases.state;
+  const publicUrl = ref.publicUrl ?? joinUrl(objectBase, ref.key);
+  const body = await fetchBytes(options.fetch, publicUrl);
+  if (await hashBytesAsync(body) !== ref.hash) {
+    throw new Error(`Object hash mismatch for ${logicalKey}`);
+  }
+  return {
+    body,
+    hash: ref.hash,
+    logicalKey,
+    publicUrl,
+    ...ref.contentType !== void 0 && { contentType: ref.contentType }
+  };
+}
+export {
+  CACHE_CONTROL_IMMUTABLE,
+  CACHE_CONTROL_REVALIDATE,
+  CAS_PREFIX,
+  DEFAULT_SHARD_HEX_CHARS,
+  GENERATIONS_PREFIX,
+  GENERATION_MANIFEST_SCHEMA,
+  HEAD_KEY,
+  HEAD_MANIFEST_SCHEMA,
+  INDEXER_STATUS_SCHEMA,
+  MAP_ROOTS_PREFIX,
+  MAP_ROOT_SCHEMA,
+  MAP_SHARDS_PREFIX,
+  MAP_SHARD_SCHEMA,
+  PINS_KEY,
+  PINS_SCHEMA,
+  RECEIPTS_PREFIX,
+  RECEIPT_SCHEMA,
+  STATUS_KEY,
+  canonicalHeadBytes,
+  hashBytesAsync,
+  parseGenerationManifest,
+  parseHead,
+  parseIndexerStatus,
+  parseMapRoot,
+  parseMapShard,
+  resolveObject,
+  shardIdForKey2 as shardIdForKey,
+  verifyPublishedView
+};
+//# sourceMappingURL=consumer.mjs.map