@ariestools/aries-dapp-core 0.1.7 → 0.1.8

package/dist/node/providers/errors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Thrown when a conditional put fails (object already exists under
+ * `ifNotExists`, or ETag mismatch under `ifMatch`).
+ */
+export declare class ConditionalWriteError extends Error {
+    readonly key: string;
+    readonly name = "ConditionalWriteError";
+    constructor(key: string, message?: string);
+}
+export declare function isConditionalWriteError(error: unknown): error is ConditionalWriteError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/node/providers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/providers/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,SAAkB,IAAI,2BAA0B;gBAEpC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAI1C;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAKtF"}

package/dist/node/providers/hashBytes.d.ts

@@ -0,0 +1,3 @@
+/** SHA-256 hex digest of a string or byte body. */
+export declare function hashBytes(body: string | Uint8Array): string;
+//# sourceMappingURL=hashBytes.d.ts.map

package/dist/node/providers/hashBytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashBytes.d.ts","sourceRoot":"","sources":["../../../src/providers/hashBytes.ts"],"names":[],"mappings":"AAEA,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAI3D"}

package/dist/node/providers/joinKey.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Join a role prefix with a relative object key into a physical S3 key.
+ * Empty prefix yields the relative key unchanged; empty relative yields the
+ * prefix without a trailing slash.
+ */
+export declare function joinKey(prefix: string, relativeKey: string): string;
+/** Strip a role prefix from a physical key, returning the relative key. */
+export declare function stripPrefix(prefix: string, physicalKey: string): string;
+/** Normalize an optional public base URL (no trailing slash). */
+export declare function normalizePublicBaseUrl(url: string | undefined): string | undefined;
+//# sourceMappingURL=joinKey.d.ts.map

package/dist/node/providers/joinKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"joinKey.d.ts","sourceRoot":"","sources":["../../../src/providers/joinKey.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGlF"}

package/dist/node/providers/memoryBucketStore.d.ts

@@ -0,0 +1,14 @@
+import type { DappBucketStore } from './capabilities.ts';
+import type { DappStoreRole } from './types.ts';
+export interface MemoryBucketStoreOptions {
+    bucket?: string;
+    prefix?: string;
+    publicBaseUrl?: string;
+    role: DappStoreRole;
+}
+/**
+ * In-memory {@link DappBucketStore} with real conditional put semantics for
+ * deterministic fence/race tests (s3rver conditionals are unreliable).
+ */
+export declare function createMemoryBucketStore(options: MemoryBucketStoreOptions): DappBucketStore;
+//# sourceMappingURL=memoryBucketStore.d.ts.map

package/dist/node/providers/memoryBucketStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryBucketStore.d.ts","sourceRoot":"","sources":["../../../src/providers/memoryBucketStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,YAAY,CAAA;AAWnB,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,aAAa,CAAA;CACpB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe,CA2I1F"}

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

@@ -0,0 +1,99 @@
+import type { S3Client, S3ClientConfig as AwsS3ClientConfig } from '@aws-sdk/client-s3';
+/** Logical store roles in a dapp backend. */
+export declare const DAPP_STORE_ROLES: readonly ["data", "state", "index"];
+export type DappStoreRole = typeof DAPP_STORE_ROLES[number];
+/**
+ * Physical binding for one logical role. A role maps to an arbitrary bucket
+ * name and optional key prefix so projects can use either three independent
+ * buckets or one shared bucket with three prefixes.
+ */
+export interface DappStoreBinding {
+    /** Physical S3/R2 bucket name. */
+    bucket: string;
+    /**
+     * Optional key prefix inside the bucket (no leading slash). Trailing slashes
+     * are normalized. Example: `my-dapp/state`.
+     */
+    prefix?: string;
+    /**
+     * Optional public CDN / anonymous-read base URL for this role
+     * (e.g. `https://cdn.example.com/state`). Distinct from the private S3 API
+     * endpoint used for writes.
+     */
+    publicBaseUrl?: string;
+}
+/** Object metadata returned by stat/get and accepted on put. */
+export interface ObjectMeta {
+    cacheControl?: string;
+    contentEncoding?: string;
+    contentLength?: number;
+    contentType?: string;
+    etag?: string;
+    lastModified?: Date;
+    /** User metadata (S3 `x-amz-meta-*`); keys are lower-cased by providers. */
+    metadata?: Record<string, string>;
+}
+export interface PutObjectOptions {
+    cacheControl?: string;
+    contentEncoding?: string;
+    contentType?: string;
+    /**
+     * Only write when the object's current ETag matches. Supported when the
+     * provider honors conditional PutObject; otherwise the write is unconditional.
+     */
+    ifMatch?: string;
+    /**
+     * Only create when the key does not exist (`If-None-Match: *`). Supported
+     * when the provider honors conditional PutObject.
+     */
+    ifNotExists?: boolean;
+    metadata?: Record<string, string>;
+}
+export interface PutObjectResult {
+    etag?: string;
+}
+export interface GetObjectResult {
+    body: Uint8Array;
+    meta: ObjectMeta;
+}
+export interface ListPageOptions {
+    continuationToken?: string;
+    maxKeys?: number;
+    /** Relative prefix under the role binding (not the full physical key). */
+    prefix?: string;
+}
+export interface ListPage {
+    continuationToken?: string;
+    isTruncated: boolean;
+    /** Relative keys (binding prefix stripped). */
+    keys: string[];
+}
+/**
+ * Shared S3 client configuration for production stores. Prefer injecting a
+ * single {@link S3Client} (or a credential provider) rather than letting
+ * dapp-core own secrets. Credentials must never be logged or embedded in
+ * published configuration.
+ */
+export interface S3ClientConfig {
+    /**
+     * Pre-built client shared across all role stores. When set, endpoint/region/
+     * credentials/forcePathStyle are ignored for client construction.
+     */
+    client?: S3Client;
+    credentials?: AwsS3ClientConfig['credentials'];
+    /** Private S3-compatible API origin, e.g. `https://<account>.r2.cloudflarestorage.com`. */
+    endpoint?: string;
+    forcePathStyle?: boolean;
+    /**
+     * When true (default if the client was constructed here), locator/store
+     * `destroy()` releases the client. Injected clients default to false.
+     */
+    ownClient?: boolean;
+    region?: string;
+}
+export interface DappStoreBindings {
+    data: DappStoreBinding;
+    index: DappStoreBinding;
+    state: DappStoreBinding;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEvF,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,qCAAsC,CAAA;AACnE,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAA;AAE3D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,IAAI,CAAA;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,WAAW,EAAE,OAAO,CAAA;IACpB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,WAAW,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAA;IAC9C,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,CAAA;IACtB,KAAK,EAAE,gBAAgB,CAAA;IACvB,KAAK,EAAE,gBAAgB,CAAA;CACxB"}

package/dist/node/publication/canonicalHead.d.ts

@@ -0,0 +1,7 @@
+import type { HeadManifest } from './types.ts';
+/**
+ * Canonical UTF-8 JSON bytes for head signing/verification. Excludes
+ * `signature` and uses a fixed field order so Node and browser agree.
+ */
+export declare function canonicalHeadBytes(head: HeadManifest): Uint8Array;
+//# sourceMappingURL=canonicalHead.d.ts.map

package/dist/node/publication/canonicalHead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalHead.d.ts","sourceRoot":"","sources":["../../../src/publication/canonicalHead.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CA8BjE"}

package/dist/node/publication/commitHead.d.ts

@@ -0,0 +1,9 @@
+import type { DappObjectWriter } from '../providers/capabilities.ts';
+import type { PublicationConflict, PublicationSafety } from './safety.ts';
+import type { HeadManifest } from './types.ts';
+export declare function commitHead(state: DappObjectWriter, head: HeadManifest, safety: PublicationSafety, fenced: boolean, expectedHeadEtag: string | undefined): Promise<{
+    etag?: string;
+} | {
+    conflict: PublicationConflict;
+}>;
+//# sourceMappingURL=commitHead.d.ts.map

package/dist/node/publication/commitHead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitHead.d.ts","sourceRoot":"","sources":["../../../src/publication/commitHead.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAGpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,wBAAsB,UAAU,CAC9B,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,OAAO,EACf,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC,CA0BhE"}

package/dist/node/publication/constants.d.ts

@@ -0,0 +1,27 @@
+/** Well-known relative keys published by the coherent generation protocol. */
+export declare const HEAD_KEY = "head.json";
+export declare const STATUS_KEY = "status.json";
+export declare const PINS_KEY = "pins.json";
+export declare const GENERATIONS_PREFIX = "generations";
+/** Content-addressed object bodies (incremental layout). */
+export declare const CAS_PREFIX = "cas/sha256";
+/** Sharded logical map roots (incremental layout). */
+export declare const MAP_ROOTS_PREFIX = "map/roots";
+/** Sharded logical map shards (incremental layout). */
+export declare const MAP_SHARDS_PREFIX = "map/shards";
+/** Small generation receipts for incremental layout. */
+export declare const RECEIPTS_PREFIX = "receipts";
+/** CDN caching: immutable generation objects and manifests. */
+export declare const CACHE_CONTROL_IMMUTABLE = "public, max-age=31536000, immutable";
+/** CDN caching: mutable head and status objects that must revalidate. */
+export declare const CACHE_CONTROL_REVALIDATE = "public, max-age=0, must-revalidate";
+export declare const GENERATION_MANIFEST_SCHEMA: "network.aries.dapp.generation.manifest";
+export declare const HEAD_MANIFEST_SCHEMA: "network.aries.dapp.head";
+export declare const INDEXER_STATUS_SCHEMA: "network.aries.dapp.indexer.status";
+export declare const PINS_SCHEMA: "network.aries.dapp.pins";
+export declare const MAP_ROOT_SCHEMA: "network.aries.dapp.map.root";
+export declare const MAP_SHARD_SCHEMA: "network.aries.dapp.map.shard";
+export declare const RECEIPT_SCHEMA: "network.aries.dapp.generation.receipt";
+/** Default shard width: first 2 hex chars of sha256(logicalKey) → 256 shards. */
+export declare const DEFAULT_SHARD_HEX_CHARS = 2;
+//# sourceMappingURL=constants.d.ts.map

package/dist/node/publication/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/publication/constants.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,cAAc,CAAA;AACnC,eAAO,MAAM,UAAU,gBAAgB,CAAA;AACvC,eAAO,MAAM,QAAQ,cAAc,CAAA;AACnC,eAAO,MAAM,kBAAkB,gBAAgB,CAAA;AAC/C,4DAA4D;AAC5D,eAAO,MAAM,UAAU,eAAe,CAAA;AACtC,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,cAAc,CAAA;AAC3C,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,eAAe,CAAA;AAC7C,wDAAwD;AACxD,eAAO,MAAM,eAAe,aAAa,CAAA;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,wCAAwC,CAAA;AAC5E,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,uCAAuC,CAAA;AAE5E,eAAO,MAAM,0BAA0B,EAAG,wCAAiD,CAAA;AAC3F,eAAO,MAAM,oBAAoB,EAAG,yBAAkC,CAAA;AACtE,eAAO,MAAM,qBAAqB,EAAG,mCAA4C,CAAA;AACjF,eAAO,MAAM,WAAW,EAAG,yBAAkC,CAAA;AAC7D,eAAO,MAAM,eAAe,EAAG,6BAAsC,CAAA;AACrE,eAAO,MAAM,gBAAgB,EAAG,8BAAuC,CAAA;AACvE,eAAO,MAAM,cAAc,EAAG,uCAAgD,CAAA;AAE9E,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,IAAI,CAAA"}

package/dist/node/publication/gc.d.ts

@@ -0,0 +1,42 @@
+import type { DappObjectWriter } from '../providers/capabilities.ts';
+export type RetentionPolicy = {
+    mode: 'forever';
+} | {
+    cdnGraceMs: number;
+    mode: 'bounded';
+    /** Minimum number of recent full/incremental generations to keep beyond active. */
+    retainGenerations: number;
+};
+export interface GcKeyRef {
+    key: string;
+    reason?: string;
+    role: 'state' | 'index';
+}
+export interface GcPlan {
+    deleteKeys: GcKeyRef[];
+    policy: RetentionPolicy;
+    retainKeys: GcKeyRef[];
+}
+export interface GcRunResult {
+    deleted: GcKeyRef[];
+    dryRun: boolean;
+    skipped: GcKeyRef[];
+}
+/**
+ * Plan garbage collection of derived state/index objects. Never touches the
+ * data role. Protects active head, pins, and an optional in-flight generation.
+ */
+export declare function planGarbageCollection(options: {
+    inFlightGeneration?: string;
+    index?: DappObjectWriter;
+    policy: RetentionPolicy;
+    state: DappObjectWriter;
+}): Promise<GcPlan>;
+/** Execute a GC plan. `dryRun: true` (default) only reports; false deletes. */
+export declare function runGarbageCollection(plan: GcPlan, stores: {
+    index?: DappObjectWriter;
+    state: DappObjectWriter;
+}, opts?: {
+    dryRun?: boolean;
+}): Promise<GcRunResult>;
+//# sourceMappingURL=gc.d.ts.map

package/dist/node/publication/gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.d.ts","sourceRoot":"","sources":["../../../src/publication/gc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAcpE,MAAM,MAAM,eAAe,GACrB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IACA,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,SAAS,CAAA;IACf,mFAAmF;IACnF,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAEL,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,QAAQ,EAAE,CAAA;IACtB,MAAM,EAAE,eAAe,CAAA;IACvB,UAAU,EAAE,QAAQ,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,QAAQ,EAAE,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,QAAQ,EAAE,CAAA;CACpB;AAsFD;;;GAGG;AAEH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,gBAAgB,CAAA;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoGlB;AAED,+EAA+E;AAC/E,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IACN,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,KAAK,EAAE,gBAAgB,CAAA;CACxB,EACD,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,WAAW,CAAC,CAyBtB"}

package/dist/node/publication/incremental.d.ts

@@ -0,0 +1,83 @@
+import type { DappObjectWriter } from '../providers/capabilities.ts';
+import { MAP_ROOT_SCHEMA, MAP_SHARD_SCHEMA, RECEIPT_SCHEMA } from './constants.ts';
+import type { PublicationSafety, PublicationTrust } from './safety.ts';
+import type { HeadManifest, PublishObjectInput } from './types.ts';
+export interface MapRoot {
+    schema: typeof MAP_ROOT_SCHEMA;
+    /** shardId → shard content hash */
+    shards: Record<string, string>;
+}
+export interface MapShard {
+    entries: Record<string, {
+        contentType?: string;
+        hash: string;
+        size: number;
+    }>;
+    schema: typeof MAP_SHARD_SCHEMA;
+}
+export interface GenerationReceipt {
+    changedCount: number;
+    generation: string;
+    previousGeneration?: string;
+    publishedAt: string;
+    reducer: {
+        name: string;
+        version?: string;
+    };
+    rootHash: string;
+    rootKey: string;
+    schema: typeof RECEIPT_SCHEMA;
+    source?: {
+        completedPosition?: string;
+        cursor?: string;
+        floor?: string;
+        observedHead?: string;
+    };
+}
+export interface PublishIncrementalInput {
+    assertSafety?: boolean;
+    deletedKeys?: readonly string[];
+    expectedHeadEtag?: string;
+    generation?: string;
+    index: DappObjectWriter;
+    /** Logical key changes for the index role (primary high-cardinality surface). */
+    indexChanges?: readonly PublishObjectInput[];
+    previousGeneration?: string;
+    reducer: {
+        name: string;
+        version?: string;
+    };
+    revision?: number;
+    safety: PublicationSafety;
+    shardHexChars?: number;
+    signal?: AbortSignal;
+    source?: GenerationReceipt['source'];
+    state: DappObjectWriter;
+    /** Optional small state-role changes (still CAS + sharded). */
+    stateChanges?: readonly PublishObjectInput[];
+    trust?: PublicationTrust;
+}
+export type PublishIncrementalResult = {
+    generation: string;
+    head: HeadManifest;
+    headEtag?: string;
+    ok: true;
+    receipt: GenerationReceipt;
+    root: MapRoot;
+    rootHash: string;
+    writes: number;
+} | {
+    conflict: {
+        kind: string;
+        message: string;
+    };
+    ok: false;
+};
+export { shardIdForKey } from './shard.ts';
+/**
+ * Incremental high-cardinality publication: write only changed objects to CAS,
+ * update touched shards + root, then fenced head-last commit. Unchanged logical
+ * keys keep stable `cas/sha256/<hash>` URLs.
+ */
+export declare function publishIncremental(input: PublishIncrementalInput): Promise<PublishIncrementalResult>;
+//# sourceMappingURL=incremental.d.ts.map

package/dist/node/publication/incremental.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental.d.ts","sourceRoot":"","sources":["../../../src/publication/incremental.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAIpE,OAAO,EAOL,eAAe,EAEf,gBAAgB,EAEhB,cAAc,EAEf,MAAM,gBAAgB,CAAA;AAGvB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAElE,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,OAAO,eAAe,CAAA;IAC9B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QACtB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACb,CAAC,CAAA;IACF,MAAM,EAAE,OAAO,gBAAgB,CAAA;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,OAAO,cAAc,CAAA;IAC7B,MAAM,CAAC,EAAE;QACP,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,gBAAgB,CAAA;IACvB,iFAAiF;IACjF,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,iBAAiB,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACpC,KAAK,EAAE,gBAAgB,CAAA;IACvB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC5C,KAAK,CAAC,EAAE,gBAAgB,CAAA;CACzB;AAED,MAAM,MAAM,wBAAwB,GAC9B;IACF,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,iBAAiB,CAAA;IAC1B,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,GACC;IACA,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,EAAE,EAAE,KAAK,CAAA;CACV,CAAA;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAiD1C;;;;GAIG;AAEH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CA8KnC"}

package/dist/node/publication/publishGeneration.d.ts

@@ -0,0 +1,18 @@
+import type { DappObjectWriter } from '../providers/capabilities.ts';
+import type { GenerationManifest, HeadManifest, PublishGenerationInput, PublishGenerationResult } from './types.ts';
+/**
+ * Publish state and index as one coherent immutable generation, then atomically
+ * expose that generation by writing the validated head last under the selected
+ * fencing mode.
+ */
+export declare function publishGeneration(input: PublishGenerationInput): Promise<PublishGenerationResult>;
+/**
+ * Load and validate the current head, then the generation manifest (full layout)
+ * or map root (incremental-cas). Verifies the pointed-to object hash.
+ */
+export declare function readPublishedHead(state: DappObjectWriter): Promise<{
+    head: HeadManifest;
+    headEtag?: string;
+    manifest?: GenerationManifest;
+} | undefined>;
+//# sourceMappingURL=publishGeneration.d.ts.map

package/dist/node/publication/publishGeneration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishGeneration.d.ts","sourceRoot":"","sources":["../../../src/publication/publishGeneration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAYpE,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AAuGnB;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAmDlC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC;IACT,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC9B,GAAG,SAAS,CAAC,CAyCb"}

package/dist/node/publication/putCreateOnly.d.ts

@@ -0,0 +1,11 @@
+import type { DappObjectWriter } from '../providers/capabilities.ts';
+import type { PutObjectOptions, PutObjectResult } from '../providers/types.ts';
+/**
+ * Create-only put for immutable generation objects. If the key already exists
+ * with identical bytes, treats the write as an idempotent success. If bytes
+ * differ, throws without overwriting published content.
+ */
+export declare function putCreateOnly(store: DappObjectWriter, key: string, body: string | Uint8Array, options?: Omit<PutObjectOptions, 'ifNotExists' | 'ifMatch'>): Promise<PutObjectResult & {
+    hash: string;
+}>;
+//# sourceMappingURL=putCreateOnly.d.ts.map

package/dist/node/publication/putCreateOnly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"putCreateOnly.d.ts","sourceRoot":"","sources":["../../../src/publication/putCreateOnly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAGpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAc9E;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,SAAS,CAAC,GAC1D,OAAO,CAAC,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B7C"}

package/dist/node/publication/releases.d.ts

@@ -0,0 +1,49 @@
+import type { DappObjectWriter } from '../providers/capabilities.ts';
+import { HEAD_KEY, PINS_KEY, PINS_SCHEMA } from './constants.ts';
+import type { PublicationSafety } from './safety.ts';
+import type { HeadManifest } from './types.ts';
+export interface ReleasePin {
+    generation: string;
+    pinnedAt: string;
+    reason?: string;
+}
+export interface PinsDocument {
+    pins: ReleasePin[];
+    schema: typeof PINS_SCHEMA;
+    updatedAt: string;
+}
+export interface ReleaseSummary {
+    generation: string;
+    kind: 'full' | 'incremental' | 'unknown';
+    manifestKey?: string;
+    receiptKey?: string;
+}
+/** List committed full generations and incremental receipts under the state role. */
+export declare function listReleases(state: DappObjectWriter): Promise<ReleaseSummary[]>;
+/** Pin a generation so retention/GC will not delete it. */
+export declare function pinRelease(state: DappObjectWriter, generation: string, opts?: {
+    reason?: string;
+}): Promise<PinsDocument>;
+/** Remove a pin. Does not change head. */
+export declare function unpinRelease(state: DappObjectWriter, generation: string): Promise<PinsDocument>;
+export declare function listPins(state: DappObjectWriter): Promise<readonly ReleasePin[]>;
+export interface RollbackHeadInput {
+    expectedHeadEtag?: string;
+    /** When true, skip capability checks for unfenced/dev stores. */
+    safety: PublicationSafety;
+    targetGeneration: string;
+}
+/**
+ * Conditionally set head to a prior complete generation without rewriting
+ * immutable generation objects. Head remains publication authority.
+ */
+export declare function rollbackHead(state: DappObjectWriter, input: RollbackHeadInput): Promise<{
+    head: HeadManifest;
+    headEtag?: string;
+    ok: true;
+} | {
+    message: string;
+    ok: false;
+}>;
+export { HEAD_KEY, PINS_KEY };
+//# sourceMappingURL=releases.d.ts.map

package/dist/node/publication/releases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../../src/publication/releases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAIpE,OAAO,EAGL,QAAQ,EAER,QAAQ,EACR,WAAW,EAEZ,MAAM,gBAAgB,CAAA;AAEvB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,MAAM,EAAE,OAAO,WAAW,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AA2CD,qFAAqF;AACrF,wBAAsB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAwBrF;AAED,2DAA2D;AAC3D,wBAAsB,UAAU,CAC9B,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,YAAY,CAAC,CAiBvB;AAED,0CAA0C;AAC1C,wBAAsB,YAAY,CAChC,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CASvB;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAEtF;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iEAAiE;IACjE,MAAM,EAAE,iBAAiB,CAAA;IACzB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC,CAoE/F;AAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA"}

package/dist/node/publication/safety.d.ts

@@ -0,0 +1,55 @@
+import type { DappObjectWriter } from '../providers/capabilities.ts';
+/**
+ * How publication fences concurrent writers.
+ *
+ * - `conditional-head` — production CAS via If-Match / If-None-Match on head
+ * - `lease` — injected fencing token for providers without reliable head CAS
+ * - `unfenced` — **development only** (local s3rver); never use in production
+ */
+export type PublicationSafety = {
+    mode: 'conditional-head';
+} | {
+    lease: PublicationLease;
+    mode: 'lease';
+} | {
+    mode: 'unfenced';
+};
+export interface PublicationLease {
+    acquire(opts: {
+        key: string;
+        signal?: AbortSignal;
+        ttlMs: number;
+    }): Promise<LeaseHandle>;
+}
+export interface LeaseHandle {
+    readonly token: string;
+    release(): Promise<void>;
+}
+export type PublicationConflictKind = 'head-cas' | 'lease' | 'immutable-collision' | 'aborted';
+export interface PublicationConflict {
+    key?: string;
+    kind: PublicationConflictKind;
+    message: string;
+}
+export type PublicationTrust = {
+    mode: 'trusted-origin';
+} | {
+    mode: 'signed';
+    sign: (canonicalBytes: Uint8Array) => Promise<string> | string;
+};
+export interface PublicationCapabilities {
+    conditionalCreate: boolean;
+    conditionalUpdate: boolean;
+}
+/**
+ * Probe whether the store honors create-only and if-match updates. Production
+ * publication should fail closed when the selected safety mode needs a
+ * capability the provider lacks.
+ */
+export declare function probePublicationCapabilities(store: DappObjectWriter): Promise<PublicationCapabilities>;
+/**
+ * Assert the selected safety mode is supported. Throws when production would
+ * otherwise silently degrade to unconditional puts.
+ */
+export declare function assertPublicationSafety(store: DappObjectWriter, safety: PublicationSafety, capabilities?: PublicationCapabilities): Promise<PublicationCapabilities>;
+//# sourceMappingURL=safety.d.ts.map

package/dist/node/publication/safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../../src/publication/safety.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAGpE;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACvB;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAC5B;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,IAAI,EAAE;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,MAAM,CAAC,EAAE,WAAW,CAAA;QACpB,KAAK,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,MAAM,uBAAuB,GAC7B,UAAU,GACV,OAAO,GACP,qBAAqB,GACrB,SAAS,CAAA;AAEf,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,uBAAuB,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IACA,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,CAAC,cAAc,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;CAC/D,CAAA;AAEL,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,OAAO,CAAA;IAC1B,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAID;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,uBAAuB,CAAC,CA2ClC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,iBAAiB,EACzB,YAAY,CAAC,EAAE,uBAAuB,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAiBlC"}

package/dist/node/publication/shard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shard routing id for a logical key. FNV-1a 32-bit, hex-padded — used only to
+ * partition the logical map (not for content integrity). Must match between
+ * writer and browser consumer (no crypto required).
+ */
+export declare function shardIdForKey(logicalKey: string, hexChars?: number): string;
+//# sourceMappingURL=shard.d.ts.map

package/dist/node/publication/shard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shard.d.ts","sourceRoot":"","sources":["../../../src/publication/shard.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,SAA0B,GAAG,MAAM,CAO5F"}

package/dist/node/publication/status.d.ts

@@ -0,0 +1,27 @@
+import type { DappBucketStore } from '../providers/DappBucketStore.ts';
+import type { IndexerStatus } from './types.ts';
+export interface WriteIndexerStatusInput {
+    consecutiveFailures: number;
+    cursor?: string;
+    floor?: string;
+    generation?: string;
+    generationRoot?: string;
+    /** Override the status object key (default `status.json`). */
+    key?: string;
+    lastCompletedPosition?: string;
+    lastError?: string;
+    lastErrorAt?: string;
+    lastSuccessAt?: string;
+    observedSourceHead?: string;
+}
+/**
+ * Read the durable indexer status object from a state (or status) store.
+ * Returns undefined when no status has been published yet.
+ */
+export declare function readIndexerStatus(store: DappBucketStore, key?: string): Promise<IndexerStatus | undefined>;
+/**
+ * Publish a machine-readable status object with revalidate CDN caching.
+ * Status never carries credentials or private application material.
+ */
+export declare function writeIndexerStatus(store: DappBucketStore, input: WriteIndexerStatusInput): Promise<IndexerStatus>;
+//# sourceMappingURL=status.d.ts.map

package/dist/node/publication/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/publication/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAItE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,eAAe,EACtB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAYpC;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAuBxB"}

package/dist/node/publication/statusPatch.d.ts

@@ -0,0 +1,10 @@
+import type { DappReduceProgress } from '../reducer/DappReducer.ts';
+import type { WriteIndexerStatusInput } from './status.ts';
+import type { IndexerStatus } from './types.ts';
+/** Carry forward durable progress fields from a prior status object. */
+export declare function priorProgressFields(prior: IndexerStatus | undefined): Pick<WriteIndexerStatusInput, 'cursor' | 'floor' | 'generation' | 'generationRoot' | 'lastCompletedPosition' | 'observedSourceHead' | 'lastSuccessAt'>;
+/** Build success status fields from reduce progress, falling back to prior. */
+export declare function successStatusFields(progress: DappReduceProgress | undefined, prior: IndexerStatus | undefined, now: string): WriteIndexerStatusInput;
+/** Build failure status fields while preserving prior checkpoint progress. */
+export declare function failureStatusFields(prior: IndexerStatus | undefined, consecutiveFailures: number, error: Error, now: string): WriteIndexerStatusInput;
+//# sourceMappingURL=statusPatch.d.ts.map

package/dist/node/publication/statusPatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusPatch.d.ts","sourceRoot":"","sources":["../../../src/publication/statusPatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAuB/C,wEAAwE;AACxE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,IAAI,CACL,uBAAuB,EACvB,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,gBAAgB,GAAG,uBAAuB,GAAG,oBAAoB,GAAG,eAAe,CACxH,CAMA;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,GACV,uBAAuB,CAezB;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,mBAAmB,EAAE,MAAM,EAC3B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,GACV,uBAAuB,CAOzB"}