@xyo-network/xl1-rest-block-publisher 2.1.4 → 2.1.6

package/dist/node/AbstractS3Provider.d.ts

@@ -14,8 +14,18 @@ export interface S3ProviderParams extends CreatableProviderParams {
 }
 /** Finalized files never change once written. */
 export declare const IMMUTABLE_CACHE_CONTROL = "public, max-age=31536000, immutable";
-/** Chain state is rewritten as the chain advances. */
-export declare const MUTABLE_CACHE_CONTROL = "public, max-age=0, must-revalidate";
+/**
+ * The head pointer is rewritten as the chain advances. A small positive TTL plus
+ * stale-while-revalidate keeps origin load low at high RPS while staying fresh — better
+ * than `max-age=0` for a hot, frequently-read object. Used for the chain-state head and
+ * the index watermark.
+ */
+export declare const MUTABLE_CACHE_CONTROL = "public, max-age=5, stale-while-revalidate=30";
+/**
+ * Manifests are mostly-static layout descriptors that change only when the layout evolves;
+ * a short TTL lets a new layout propagate within minutes without per-request revalidation.
+ */
+export declare const MANIFEST_CACHE_CONTROL = "public, max-age=300";
 /**
  * Base for providers targeting S3-compatible storage. Bodies are pre-compressed at write
  * time and stored with the matching Content-Encoding plus application/json, so HTTP clients
@@ -29,6 +39,8 @@ export declare abstract class AbstractS3Provider<TParams extends S3ProviderParam
     get prefix(): string;
     /** Reads and decodes a stored JSON file, or undefined when the key does not exist. */
     protected getJson(path: string): Promise<unknown>;
+    /** True when the key exists, checked without fetching the body. */
+    protected hasJson(path: string): Promise<boolean>;
     protected putJson(path: string, json: string, cacheControl: string): Promise<void>;
 }
 //# sourceMappingURL=AbstractS3Provider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AbstractS3Provider.d.ts","sourceRoot":"","sources":["../../src/AbstractS3Provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAGlD,OAAO,KAAK,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AACxG,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAGxD,iFAAiF;AACjF,MAAM,WAAW,gBAAiB,SAAQ,uBAAuB;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,MAAM,EAAE,QAAQ,CAAA;IAChB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,mBAAmB,CAAA;IACrC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,iDAAiD;AACjD,eAAO,MAAM,uBAAuB,wCAAwC,CAAA;AAC5E,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,uCAAuC,CAAA;AAEzE;;;;;GAKG;AACH,8BAAsB,kBAAkB,CACtC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,UAAU,SAAS,0BAA0B,GAAG,0BAA0B,CAC1E,SAAQ,yBAAyB,CAAC,OAAO,EAAE,UAAU,CAAC;IACtD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,QAAQ,CAErB;IAED,IAAI,eAAe,IAAI,mBAAmB,CAEzC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sFAAsF;cACtE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;cAYvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWzF"}
+{"version":3,"file":"AbstractS3Provider.d.ts","sourceRoot":"","sources":["../../src/AbstractS3Provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAKlD,OAAO,KAAK,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AACxG,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAGxD,iFAAiF;AACjF,MAAM,WAAW,gBAAiB,SAAQ,uBAAuB;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,MAAM,EAAE,QAAQ,CAAA;IAChB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,mBAAmB,CAAA;IACrC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,iDAAiD;AACjD,eAAO,MAAM,uBAAuB,wCAAwC,CAAA;AAC5E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,iDAAiD,CAAA;AACnF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,wBAAwB,CAAA;AAE3D;;;;;GAKG;AACH,8BAAsB,kBAAkB,CACtC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,UAAU,SAAS,0BAA0B,GAAG,0BAA0B,CAC1E,SAAQ,yBAAyB,CAAC,OAAO,EAAE,UAAU,CAAC;IACtD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,QAAQ,CAErB;IAED,IAAI,eAAe,IAAI,mBAAmB,CAEzC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sFAAsF;cACtE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYvD,mEAAmE;cACnD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;cAUvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWzF"}

package/dist/node/S3BlockPublishRunner.d.ts

@@ -42,8 +42,28 @@ export declare class S3BlockPublishRunner extends AbstractS3Provider<S3BlockPubl
     get progressInterval(): number;
     get source(): BlockViewer;
     createHandler(): Promise<void>;
+    /**
+     * Finds where a catch-up sync should start: walks backwards from the source head probing
+     * by-number paths (in batches of `concurrency`) until it finds an already published block,
+     * never probing below `floor`, and returns the block after it.
+     *
+     * This is what makes resuming cheap after a bucket was primed externally (an importer
+     * CLI) or after publishing was toggled off and on: already published blocks above a
+     * stale or missing head pointer are skipped instead of republished.
+     *
+     * Scope: only the topmost contiguous gap is healed. The walk stops at the first published
+     * block, so holes below it are not probed — deep verification belongs to an importer or
+     * audit tool. The walk also trusts that whoever published a block also published its
+     * payloads and step files. As a fast path, a missing genesis block with `floor` at
+     * genesis is treated as an empty bucket (full backfill) without walking the whole range.
+     */
+    findCatchUpStart(floor?: XL1BlockNumber): Promise<XL1BlockNumber>;
+    /** True when the block is already published at its by-number path. */
+    hasBlock(blockNumber: XL1BlockNumber): Promise<boolean>;
     /** Publishes one block at its by-number and by-hash paths, plus its payload files. */
     publishBlock(blockNumber: XL1BlockNumber): Promise<SignedHydratedBlockWithHashMeta | null>;
+    /** Publishes the finalized layout descriptor (idempotent; refreshed on each sync). */
+    publishManifest(): Promise<void>;
     /**
      * Publishes every block from `from` (inclusive, default genesis) through the source head.
      * Returns the published range, or null when already up to date.

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

@@ -1 +1 @@
-{"version":3,"file":"S3BlockPublishRunner.d.ts","sourceRoot":"","sources":["../../src/S3BlockPublishRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAAE,WAAW,EAAE,+BAA+B,EAAE,cAAc,EAAE,aAAa,EAChG,MAAM,+BAA+B,CAAA;AAUtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAA2B,MAAM,yBAAyB,CAAA;AAErF,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,cAAc,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,2CAA2C;AAC3C,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAClD,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;GAOG;AACH,qBACa,oBAAqB,SAAQ,kBAAkB,CAAC,0BAA0B,CAAE,YAAW,kBAAkB;IACpH,MAAM,CAAC,QAAQ,CAAC,cAAc,uBAA4B;IAC1D,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAuB;IACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,yBAA8B;IACtD,OAAO,uBAAsC;IAE7C,SAAS,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;IAE/B,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,MAAM,IAAI,WAAW,CAExB;IAEc,aAAa;IAK5B,sFAAsF;IAChF,YAAY,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAYhG;;;OAGG;IACG,IAAI,CAAC,IAAI,GAAE,cAA0C,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAqB3F,6FAA6F;IAC7F,OAAO,CAAC,MAAM;CAQf"}
+{"version":3,"file":"S3BlockPublishRunner.d.ts","sourceRoot":"","sources":["../../src/S3BlockPublishRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAAE,WAAW,EAAE,+BAA+B,EAAE,cAAc,EAAE,aAAa,EAChG,MAAM,+BAA+B,CAAA;AAWtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EACL,kBAAkB,EACnB,MAAM,yBAAyB,CAAA;AAEhC,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,cAAc,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,2CAA2C;AAC3C,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAClD,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;GAOG;AACH,qBACa,oBAAqB,SAAQ,kBAAkB,CAAC,0BAA0B,CAAE,YAAW,kBAAkB;IACpH,MAAM,CAAC,QAAQ,CAAC,cAAc,uBAA4B;IAC1D,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAuB;IACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,yBAA8B;IACtD,OAAO,uBAAsC;IAE7C,SAAS,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;IAE/B,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,MAAM,IAAI,WAAW,CAExB;IAEc,aAAa;IAK5B;;;;;;;;;;;;;;OAcG;IACG,gBAAgB,CAAC,KAAK,GAAE,cAA0C,GAAG,OAAO,CAAC,cAAc,CAAC;IAiBlG,sEAAsE;IAChE,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D,sFAAsF;IAChF,YAAY,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAYhG,sFAAsF;IAChF,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtC;;;OAGG;IACG,IAAI,CAAC,IAAI,GAAE,cAA0C,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsB3F,6FAA6F;IAC7F,OAAO,CAAC,MAAM;CAQf"}

package/dist/node/S3IndexPublishRunner.d.ts

@@ -1,18 +1,21 @@
-import type { BlockViewer, IndexPublishRunner, XL1BlockNumber } from '@xyo-network/xl1-protocol-lib';
+import type { BlockViewer, IndexPublishRunner, IndexSummaryFamily, IndexWatermark, XL1BlockNumber } from '@xyo-network/xl1-protocol-lib';
 import type { S3ProviderParams } from './AbstractS3Provider.ts';
 import { AbstractS3Provider } from './AbstractS3Provider.ts';
 /** Parameters for S3IndexPublishRunner. */
 export interface S3IndexPublishRunnerParams extends S3ProviderParams {
     /**
-     * The viewer to publish from (only finalized chains should be published). When omitted,
+     * The viewer to build the index from (only finalized chains should be indexed). When omitted,
      * resolved from the locator via BlockViewerMoniker.
      */
     source?: BlockViewer;
 }
 /**
- * Publishes completed steps' block summaries (the chain index) as the static REST file
- * layout that `RestIndexViewer` reads. Step files are immutable: only complete steps are
- * ever published, and a completed step's blocks never change.
+ * Publishes the multi-family chain index (blocks, balances, schemas, transfers) as the static
+ * REST file layout that `RestIndexViewer` reads. Frames are immutable: only complete frames are
+ * ever published, and a completed frame never changes. The runner reads blocks from its source
+ * viewer (MongoDB, or the finalized/chain-state buckets via CDN) and writes summaries to the
+ * index bucket; the head watermark and manifest are written last so a reader never sees a
+ * watermark pointing past the frames that back it.
  */
 export declare class S3IndexPublishRunner extends AbstractS3Provider<S3IndexPublishRunnerParams> implements IndexPublishRunner {
     static readonly defaultMoniker: "IndexPublishRunner";
@@ -22,12 +25,17 @@ export declare class S3IndexPublishRunner extends AbstractS3Provider<S3IndexPubl
     protected _source?: BlockViewer;
     get source(): BlockViewer;
     createHandler(): Promise<void>;
-    /**
-     * Publishes one completed step's blocks as a BlocksStepSummary file (blocks oldest-first).
-     * Asserts the step is complete — partial tail steps are never published.
-     */
-    publishStep(stepLevel: number, stepIndex: number): Promise<void>;
-    /** Publishes every step (at every level) completed by the given block. */
-    publishStepsCompletedBy(blockNumber: XL1BlockNumber): Promise<void>;
+    /** Builds every family's frames completed up to the ceiling, then writes the manifest and watermark. */
+    publishCompletedFramesUpTo(ceiling: XL1BlockNumber): Promise<IndexWatermark>;
+    /** Publishes one completed frame for a family (and any missing sub-frames it depends on). */
+    publishFrame(family: IndexSummaryFamily, stepLevel: number, stepIndex: number): Promise<void>;
+    /** Dispatches a single frame to its family builder, writing it (and missing sub-frames) to the bucket. */
+    private buildFamilyFrame;
+    /** Builds a family's frames in (previous, ceiling] across every level; returns total completed frames. */
+    private publishFamily;
+    private readWatermark;
+    private summaryMap;
+    private writeHead;
+    private writeManifest;
 }
 //# sourceMappingURL=S3IndexPublishRunner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"S3IndexPublishRunner.d.ts","sourceRoot":"","sources":["../../src/S3IndexPublishRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACS,WAAW,EAAE,kBAAkB,EAAE,cAAc,EACnE,MAAM,+BAA+B,CAAA;AAOtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAA2B,MAAM,yBAAyB,CAAA;AAErF,2CAA2C;AAC3C,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;GAIG;AACH,qBACa,oBAAqB,SAAQ,kBAAkB,CAAC,0BAA0B,CAAE,YAAW,kBAAkB;IACpH,MAAM,CAAC,QAAQ,CAAC,cAAc,uBAA4B;IAC1D,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAuB;IACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,yBAA8B;IACtD,OAAO,uBAAsC;IAE7C,SAAS,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;IAE/B,IAAI,MAAM,IAAI,WAAW,CAExB;IAEc,aAAa;IAK5B;;;OAGG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtE,0EAA0E;IACpE,uBAAuB,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ1E"}
+{"version":3,"file":"S3IndexPublishRunner.d.ts","sourceRoot":"","sources":["../../src/S3IndexPublishRunner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACA,WAAW,EAAkB,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAC7F,cAAc,EACf,MAAM,+BAA+B,CAAA;AAkBtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EACL,kBAAkB,EACnB,MAAM,yBAAyB,CAAA;AAsGhC,2CAA2C;AAC3C,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAClE;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;GAOG;AACH,qBACa,oBAAqB,SAAQ,kBAAkB,CAAC,0BAA0B,CAAE,YAAW,kBAAkB;IACpH,MAAM,CAAC,QAAQ,CAAC,cAAc,uBAA4B;IAC1D,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAuB;IACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,yBAA8B;IACtD,OAAO,uBAAsC;IAE7C,SAAS,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;IAE/B,IAAI,MAAM,IAAI,WAAW,CAExB;IAEc,aAAa;IAK5B,wGAAwG;IAClG,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAoBlF,6FAA6F;IACvF,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnG,0GAA0G;YAC5F,gBAAgB;IAsB9B,0GAA0G;YAC5F,aAAa;YAwBb,aAAa;IAK3B,OAAO,CAAC,UAAU;YASJ,SAAS;YAYT,aAAa;CAa5B"}

package/dist/node/index.mjs

@@ -12,7 +12,11 @@ var __decorateClass = (decorators, target, key, kind) => {
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/AbstractS3Provider.ts
-import { GetObjectCommand, PutObjectCommand } from "@aws-sdk/client-s3";
+import {
+  GetObjectCommand,
+  HeadObjectCommand,
+  PutObjectCommand
+} from "@aws-sdk/client-s3";
 import { assertEx } from "@xylabs/sdk-js";
 import { AbstractCreatableProvider } from "@xyo-network/xl1-protocol-sdk";
 
@@ -47,7 +51,8 @@ function decodeBody(body, contentEncoding) {
 
 // src/AbstractS3Provider.ts
 var IMMUTABLE_CACHE_CONTROL = "public, max-age=31536000, immutable";
-var MUTABLE_CACHE_CONTROL = "public, max-age=0, must-revalidate";
+var MUTABLE_CACHE_CONTROL = "public, max-age=5, stale-while-revalidate=30";
+var MANIFEST_CACHE_CONTROL = "public, max-age=300";
 var AbstractS3Provider = class extends AbstractCreatableProvider {
   get bucket() {
     return assertEx(this.params.bucket, () => "No bucket specified");
@@ -73,6 +78,16 @@ var AbstractS3Provider = class extends AbstractCreatableProvider {
       throw error;
     }
   }
+  /** True when the key exists, checked without fetching the body. */
+  async hasJson(path) {
+    try {
+      await this.client.send(new HeadObjectCommand({ Bucket: this.bucket, Key: `${this.prefix}${path}` }));
+      return true;
+    } catch (error) {
+      if (isNotFoundError(error)) return false;
+      throw error;
+    }
+  }
   async putJson(path, json, cacheControl) {
     const { body, contentEncoding } = encodeBody(json, this.contentEncoding);
     await this.client.send(new PutObjectCommand({
@@ -102,6 +117,9 @@ import { creatableProvider } from "@xyo-network/xl1-protocol-sdk";
 import {
   blockHashPath,
   blockNumberPath,
+  CHAIN_LAYOUT_VERSION,
+  ChainManifestSchema,
+  manifestPath,
   payloadPath
 } from "@xyo-network/xl1-rest-block-viewer";
 import { Semaphore } from "async-mutex";
@@ -121,6 +139,41 @@ var S3BlockPublishRunner = class extends AbstractS3Provider {
     await super.createHandler();
     this._source = this.params.source ?? await this.locator.getInstance(BlockViewerMoniker);
   }
+  /**
+   * Finds where a catch-up sync should start: walks backwards from the source head probing
+   * by-number paths (in batches of `concurrency`) until it finds an already published block,
+   * never probing below `floor`, and returns the block after it.
+   *
+   * This is what makes resuming cheap after a bucket was primed externally (an importer
+   * CLI) or after publishing was toggled off and on: already published blocks above a
+   * stale or missing head pointer are skipped instead of republished.
+   *
+   * Scope: only the topmost contiguous gap is healed. The walk stops at the first published
+   * block, so holes below it are not probed — deep verification belongs to an importer or
+   * audit tool. The walk also trusts that whoever published a block also published its
+   * payloads and step files. As a fast path, a missing genesis block with `floor` at
+   * genesis is treated as an empty bucket (full backfill) without walking the whole range.
+   */
+  async findCatchUpStart(floor = asXL1BlockNumber(0, true)) {
+    const sourceHead = await this.source.currentBlock();
+    const end = sourceHead[0].block;
+    if (floor > end) return floor;
+    if (floor === 0 && !await this.hasBlock(asXL1BlockNumber(0, true))) return floor;
+    for (let high = end; high >= floor; high -= this.concurrency) {
+      const low = Math.max(floor, high - this.concurrency + 1);
+      const present = await Promise.all(
+        Array.from({ length: high - low + 1 }, (_, i) => this.hasBlock(asXL1BlockNumber(low + i, true)))
+      );
+      for (let blockNumber = high; blockNumber >= low; blockNumber--) {
+        if (present[blockNumber - low]) return asXL1BlockNumber(blockNumber + 1, true);
+      }
+    }
+    return floor;
+  }
+  /** True when the block is already published at its by-number path. */
+  async hasBlock(blockNumber) {
+    return await this.hasJson(blockNumberPath(blockNumber));
+  }
   /** Publishes one block at its by-number and by-hash paths, plus its payload files. */
   async publishBlock(blockNumber) {
     const block = await this.source.blockByNumber(blockNumber);
@@ -133,6 +186,23 @@ var S3BlockPublishRunner = class extends AbstractS3Provider {
     }
     return block;
   }
+  /** Publishes the finalized layout descriptor (idempotent; refreshed on each sync). */
+  async publishManifest() {
+    const manifest = {
+      earliestBlock: 0,
+      encoding: this.contentEncoding,
+      // literal templates: a self-describing mirror of the path builders in xl1-rest-block-viewer
+      paths: {
+        blockByHash: "block/hash/{hash}.json",
+        blockByNumber: "block/number/{block}.json",
+        head: "chain/head.json",
+        payload: "payload/{hash}.json"
+      },
+      schema: ChainManifestSchema,
+      version: CHAIN_LAYOUT_VERSION
+    };
+    await this.putJson(manifestPath(), JSON.stringify(manifest), MANIFEST_CACHE_CONTROL);
+  }
   /**
    * Publishes every block from `from` (inclusive, default genesis) through the source head.
    * Returns the published range, or null when already up to date.
@@ -141,6 +211,7 @@ var S3BlockPublishRunner = class extends AbstractS3Provider {
     const sourceHead = await this.source.currentBlock();
     const end = sourceHead[0].block;
     if (from > end) return null;
+    await this.publishManifest();
     const semaphore = new Semaphore(this.concurrency);
     const numbers = Array.from({ length: end - from + 1 }, (_, i) => asXL1BlockNumber(from + i, true));
     const total = numbers.length;
@@ -241,13 +312,93 @@ S3ChainStateViewer = __decorateClass([
 // src/S3IndexPublishRunner.ts
 import { assertEx as assertEx5 } from "@xylabs/sdk-js";
 import {
-  BlocksStepSummarySchema,
+  asXL1BlockNumber as asXL1BlockNumber2,
+  asXL1BlockRange,
   BlockViewerMoniker as BlockViewerMoniker3,
   IndexPublishRunnerMoniker,
   StepSizes
 } from "@xyo-network/xl1-protocol-lib";
-import { blocksMaxStep, creatableProvider as creatableProvider4 } from "@xyo-network/xl1-protocol-sdk";
-import { blocksStepPath } from "@xyo-network/xl1-rest-block-viewer";
+import {
+  balancesMaxStep,
+  balancesStepSummaryFromRange,
+  blocksMaxStep,
+  blocksStepSummaryFromRange,
+  creatableProvider as creatableProvider4,
+  schemasMaxStep,
+  schemasStepSummaryFromRange,
+  transfersMaxStep,
+  transfersStepSummaryFromRange
+} from "@xyo-network/xl1-protocol-sdk";
+import {
+  INDEX_LAYOUT_VERSION,
+  indexHeadPath,
+  IndexHeadSchema,
+  indexManifestPath,
+  IndexManifestSchema,
+  indexSummaryPath
+} from "@xyo-network/xl1-rest-block-viewer";
+import { Semaphore as Semaphore2 } from "async-mutex";
+var S3IndexSummaryMap = class {
+  family;
+  numberCache = /* @__PURE__ */ new Map();
+  read;
+  source;
+  write;
+  constructor(family, source, read, write) {
+    this.family = family;
+    this.source = source;
+    this.read = read;
+    this.write = write;
+  }
+  clear() {
+    this.numberCache.clear();
+  }
+  delete(_id) {
+    return false;
+  }
+  async get(id) {
+    const path = await this.pathForKey(id);
+    if (path === void 0) return void 0;
+    const found = await this.read(path);
+    return found === void 0 ? void 0 : found;
+  }
+  async getMany(ids) {
+    const found = await Promise.all(ids.map((id) => this.get(id)));
+    return found.flatMap((value) => value === void 0 ? [] : [value]);
+  }
+  async has(id) {
+    return await this.get(id) !== void 0;
+  }
+  async set(id, data) {
+    const path = await this.pathForFrame(data.hash, data.stepSize) ?? await this.pathForKey(id);
+    if (path === void 0) return;
+    await this.write(path, JSON.stringify(data));
+  }
+  async setMany(entries) {
+    await Promise.all(entries.map(([id, data]) => this.set(id, data)));
+  }
+  async pathForFrame(hash, stepSize) {
+    const stepLevel = StepSizes.indexOf(asXL1BlockNumber2(stepSize, true));
+    if (stepLevel === -1) return void 0;
+    const blockNumber = await this.resolveBlockNumber(hash);
+    if (blockNumber === void 0) return void 0;
+    const stepIndex = (blockNumber + 1) / stepSize - 1;
+    return Number.isInteger(stepIndex) && stepIndex >= 0 ? indexSummaryPath(this.family, stepLevel, stepIndex) : void 0;
+  }
+  async pathForKey(key) {
+    const [hash, sizeText] = key.split("|");
+    return await this.pathForFrame(hash, Number(sizeText));
+  }
+  async resolveBlockNumber(hash) {
+    const cached = this.numberCache.get(hash);
+    if (cached !== void 0) return cached;
+    const block = await this.source.blockByHash(hash);
+    if (!block) return void 0;
+    const blockNumber = block[0].block;
+    this.numberCache.set(hash, blockNumber);
+    return blockNumber;
+  }
+};
 var S3IndexPublishRunner = class extends AbstractS3Provider {
   moniker = S3IndexPublishRunner.defaultMoniker;
   _source;
@@ -258,35 +409,112 @@ var S3IndexPublishRunner = class extends AbstractS3Provider {
     await super.createHandler();
     this._source = this.params.source ?? await this.locator.getInstance(BlockViewerMoniker3);
   }
-  /**
-   * Publishes one completed step's blocks as a BlocksStepSummary file (blocks oldest-first).
-   * Asserts the step is complete — partial tail steps are never published.
-   */
-  async publishStep(stepLevel, stepIndex) {
-    const size = StepSizes[stepLevel];
-    assertEx5(stepLevel <= blocksMaxStep, () => `publishStep does not support step levels above ${blocksMaxStep} (requested ${stepLevel})`);
-    const lastBlockNumber = (stepIndex + 1) * size - 1;
-    const headNumber = await this.source.currentBlockNumber();
-    assertEx5(lastBlockNumber <= headNumber, () => `Step ${stepLevel}/${stepIndex} is not complete (head ${headNumber})`);
-    const newestFirst = await this.source.blocksByStep(stepLevel, stepIndex);
-    const blocks = newestFirst.toReversed();
-    const summary = {
-      schema: BlocksStepSummarySchema,
-      hash: assertEx5(blocks.at(-1), () => `No blocks for step ${stepLevel}/${stepIndex}`)[0]._hash,
-      stepSize: size,
-      blocks
+  /** Builds every family's frames completed up to the ceiling, then writes the manifest and watermark. */
+  async publishCompletedFramesUpTo(ceiling) {
+    const head = await this.source.currentBlockNumber();
+    assertEx5(ceiling <= head, () => `Ceiling ${ceiling} exceeds source head ${head}`);
+    const previous = (await this.readWatermark())?.block ?? -1;
+    const families = {
+      balances: await this.publishFamily("balances", balancesMaxStep, balancesStepSummaryFromRange, previous, ceiling),
+      blocks: await this.publishFamily("blocks", blocksMaxStep, blocksStepSummaryFromRange, previous, ceiling),
+      schemas: await this.publishFamily("schemas", schemasMaxStep, schemasStepSummaryFromRange, previous, ceiling),
+      transfers: await this.publishFamily("transfers", transfersMaxStep, transfersStepSummaryFromRange, previous, ceiling)
+    };
+    const ceilingBlock = assertEx5(await this.source.blockByNumber(ceiling), () => `Block not found for ceiling ${ceiling}`);
+    const watermark = {
+      block: ceiling,
+      hash: ceilingBlock[0]._hash,
+      families
     };
-    await this.putJson(blocksStepPath(stepLevel, stepIndex), JSON.stringify(summary), IMMUTABLE_CACHE_CONTROL);
-    this.logger?.info(`S3IndexPublishRunner: published step ${stepLevel}/${stepIndex}`);
+    await this.writeManifest();
+    await this.writeHead(watermark);
+    this.logger?.info(`S3IndexPublishRunner: index complete through block ${ceiling}`);
+    return watermark;
   }
-  /** Publishes every step (at every level) completed by the given block. */
-  async publishStepsCompletedBy(blockNumber) {
-    for (let stepLevel = 0; stepLevel <= blocksMaxStep; stepLevel++) {
+  /** Publishes one completed frame for a family (and any missing sub-frames it depends on). */
+  async publishFrame(family, stepLevel, stepIndex) {
+    const size = StepSizes[stepLevel];
+    const lastBlock = (stepIndex + 1) * size - 1;
+    const head = await this.source.currentBlockNumber();
+    assertEx5(lastBlock <= head, () => `Frame ${family} ${stepLevel}/${stepIndex} is not complete (head ${head})`);
+    const range = asXL1BlockRange([stepIndex * size, lastBlock], true);
+    await this.buildFamilyFrame(family, range);
+    this.logger?.info(`S3IndexPublishRunner: published frame ${family} ${stepLevel}/${stepIndex}`);
+  }
+  /** Dispatches a single frame to its family builder, writing it (and missing sub-frames) to the bucket. */
+  async buildFamilyFrame(family, range) {
+    const semaphores = StepSizes.map(() => new Semaphore2(20));
+    switch (family) {
+      case "balances": {
+        await balancesStepSummaryFromRange(this.context, semaphores, this.source, this.summaryMap("balances"), range);
+        break;
+      }
+      case "blocks": {
+        await blocksStepSummaryFromRange(this.context, semaphores, this.source, this.summaryMap("blocks"), range);
+        break;
+      }
+      case "schemas": {
+        await schemasStepSummaryFromRange(this.context, semaphores, this.source, this.summaryMap("schemas"), range);
+        break;
+      }
+      case "transfers": {
+        await transfersStepSummaryFromRange(this.context, semaphores, this.source, this.summaryMap("transfers"), range);
+        break;
+      }
+    }
+  }
+  /** Builds a family's frames in (previous, ceiling] across every level; returns total completed frames. */
+  async publishFamily(family, maxStep, build, previous, ceiling) {
+    const map = this.summaryMap(family);
+    const semaphores = StepSizes.map(() => new Semaphore2(20));
+    let completed = 0;
+    for (let stepLevel = 0; stepLevel <= maxStep; stepLevel++) {
       const size = StepSizes[stepLevel];
-      if ((blockNumber + 1) % size === 0) {
-        await this.publishStep(stepLevel, (blockNumber + 1) / size - 1);
+      const fromIndex = Math.floor((previous + 1) / size);
+      const toIndex = Math.floor((ceiling + 1) / size);
+      completed += toIndex;
+      for (let stepIndex = fromIndex; stepIndex < toIndex; stepIndex++) {
+        const start = stepIndex * size;
+        await build(this.context, semaphores, this.source, map, asXL1BlockRange([start, start + size - 1], true));
       }
     }
+    return completed;
+  }
+  async readWatermark() {
+    const found = await this.getJson(indexHeadPath());
+    return found === void 0 ? void 0 : found;
+  }
+  summaryMap(family) {
+    return new S3IndexSummaryMap(
+      family,
+      this.source,
+      (path) => this.getJson(path),
+      (path, json) => this.putJson(path, json, IMMUTABLE_CACHE_CONTROL)
+    );
+  }
+  async writeHead(watermark) {
+    const head = {
+      schema: IndexHeadSchema,
+      version: INDEX_LAYOUT_VERSION,
+      block: watermark.block,
+      hash: watermark.hash,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      families: watermark.families
+    };
+    await this.putJson(indexHeadPath(), JSON.stringify(head), MUTABLE_CACHE_CONTROL);
+  }
+  async writeManifest() {
+    const manifest = {
+      schema: IndexManifestSchema,
+      version: INDEX_LAYOUT_VERSION,
+      families: {
+        balances: { maxStep: balancesMaxStep, path: "balances/{level}/{index}.json" },
+        blocks: { maxStep: blocksMaxStep, path: "blocks/{level}/{index}.json" },
+        schemas: { maxStep: schemasMaxStep, path: "schemas/{level}/{index}.json" },
+        transfers: { maxStep: transfersMaxStep, path: "transfers/{level}/{index}.json" }
+      }
+    };
+    await this.putJson(indexManifestPath(), JSON.stringify(manifest), MANIFEST_CACHE_CONTROL);
   }
 };
 __publicField(S3IndexPublishRunner, "defaultMoniker", IndexPublishRunnerMoniker);
@@ -298,6 +526,7 @@ S3IndexPublishRunner = __decorateClass([
 export {
   AbstractS3Provider,
   IMMUTABLE_CACHE_CONTROL,
+  MANIFEST_CACHE_CONTROL,
   MUTABLE_CACHE_CONTROL,
   S3BlockPublishRunner,
   S3ChainStatePublishRunner,

package/dist/node/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/AbstractS3Provider.ts", "../../src/encoding.ts", "../../src/S3BlockPublishRunner.ts", "../../src/S3ChainStatePublishRunner.ts", "../../src/S3ChainStateViewer.ts", "../../src/S3IndexPublishRunner.ts"],
-  "sourcesContent": ["import type { S3Client } from '@aws-sdk/client-s3'\nimport { GetObjectCommand, PutObjectCommand } from '@aws-sdk/client-s3'\nimport { assertEx } from '@xylabs/sdk-js'\nimport type { CreatableProviderEventData, CreatableProviderParams } from '@xyo-network/xl1-protocol-sdk'\nimport { AbstractCreatableProvider } from '@xyo-network/xl1-protocol-sdk'\n\nimport type { RestContentEncoding } from './encoding.ts'\nimport { decodeBody, encodeBody } from './encoding.ts'\n\n/** Shared parameters for S3-backed providers: where and how files are stored. */\nexport interface S3ProviderParams extends CreatableProviderParams {\n  bucket: string\n  /** S3-compatible client pointed at the target endpoint (e.g. Cloudflare R2). */\n  client: S3Client\n  /** Storage/wire encoding for published files. Defaults to 'br' (brotli). */\n  contentEncoding?: RestContentEncoding\n  /** Optional key prefix, allowing the layout to live in a shared bucket. */\n  prefix?: string\n}\n\n/** Finalized files never change once written. */\nexport const IMMUTABLE_CACHE_CONTROL = 'public, max-age=31536000, immutable'\n/** Chain state is rewritten as the chain advances. */\nexport const MUTABLE_CACHE_CONTROL = 'public, max-age=0, must-revalidate'\n\n/**\n * Base for providers targeting S3-compatible storage. Bodies are pre-compressed at write\n * time and stored with the matching Content-Encoding plus application/json, so HTTP clients\n * decompress transparently \u2014 keys keep their `.json` extension. Reads decode the stored\n * Content-Encoding back to JSON.\n */\nexport abstract class AbstractS3Provider<\n  TParams extends S3ProviderParams = S3ProviderParams,\n  TEventData extends CreatableProviderEventData = CreatableProviderEventData,\n> extends AbstractCreatableProvider<TParams, TEventData> {\n  get bucket(): string {\n    return assertEx(this.params.bucket, () => 'No bucket specified')\n  }\n\n  get client(): S3Client {\n    return assertEx(this.params.client, () => 'No client specified')\n  }\n\n  get contentEncoding(): RestContentEncoding {\n    return this.params.contentEncoding ?? 'br'\n  }\n\n  get prefix(): string {\n    return this.params.prefix ?? ''\n  }\n\n  /** Reads and decodes a stored JSON file, or undefined when the key does not exist. */\n  protected async getJson(path: string): Promise<unknown> {\n    try {\n      const response = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: `${this.prefix}${path}` }))\n      const body = await response.Body?.transformToByteArray()\n      if (body === undefined) return undefined\n      return JSON.parse(decodeBody(body, response.ContentEncoding)) as unknown\n    } catch (error) {\n      if (isNotFoundError(error)) return undefined\n      throw error\n    }\n  }\n\n  protected async putJson(path: string, json: string, cacheControl: string): Promise<void> {\n    const { body, contentEncoding } = encodeBody(json, this.contentEncoding)\n    await this.client.send(new PutObjectCommand({\n      Bucket: this.bucket,\n      Key: `${this.prefix}${path}`,\n      Body: body,\n      CacheControl: cacheControl,\n      ContentEncoding: contentEncoding,\n      ContentType: 'application/json',\n    }))\n  }\n}\n\nconst isNotFoundError = (error: unknown): boolean => {\n  if (typeof error !== 'object' || error === null) return false\n  const { name, $metadata } = error as { $metadata?: { httpStatusCode?: number }; name?: string }\n  return name === 'NoSuchKey' || name === 'NotFound' || $metadata?.httpStatusCode === 404\n}\n", "import ZLIB from 'node:zlib'\n\n/** Wire/storage encoding for published files. */\nexport type RestContentEncoding = 'br' | 'gzip' | 'none'\n\n/** An encoded file body plus the HTTP Content-Encoding it should be served with. */\nexport interface EncodedBody {\n  body: Uint8Array\n  contentEncoding?: 'br' | 'gzip'\n}\n\n/**\n * Encodes a JSON string for storage. Bodies are pre-compressed at write time and stored\n * with the matching Content-Encoding so HTTP clients decompress transparently \u2014 keys keep\n * their .json extension and Content-Type stays application/json.\n */\nexport function encodeBody(json: string, encoding: RestContentEncoding): EncodedBody {\n  switch (encoding) {\n    case 'br': {\n      return { body: ZLIB.brotliCompressSync(json), contentEncoding: 'br' }\n    }\n    case 'gzip': {\n      return { body: ZLIB.gzipSync(json), contentEncoding: 'gzip' }\n    }\n    case 'none': {\n      return { body: new TextEncoder().encode(json) }\n    }\n  }\n}\n\n/** Decodes a stored body back to its JSON string using the object's Content-Encoding. */\nexport function decodeBody(body: Uint8Array, contentEncoding?: string): string {\n  switch (contentEncoding) {\n    case 'br': {\n      return ZLIB.brotliDecompressSync(body).toString('utf8')\n    }\n    case 'gzip': {\n      return ZLIB.gunzipSync(body).toString('utf8')\n    }\n    default: {\n      return new TextDecoder().decode(body)\n    }\n  }\n}\n", "import { assertEx, isNull } from '@xylabs/sdk-js'\nimport type {\n  BlockPublishRunner, BlockViewer, SignedHydratedBlockWithHashMeta, XL1BlockNumber, XL1BlockRange,\n} from '@xyo-network/xl1-protocol-lib'\nimport {\n  asXL1BlockNumber, BlockPublishRunnerMoniker, BlockViewerMoniker,\n} from '@xyo-network/xl1-protocol-lib'\nimport { creatableProvider } from '@xyo-network/xl1-protocol-sdk'\nimport {\n  blockHashPath, blockNumberPath, payloadPath,\n} from '@xyo-network/xl1-rest-block-viewer'\nimport { Semaphore } from 'async-mutex'\n\nimport type { S3ProviderParams } from './AbstractS3Provider.ts'\nimport { AbstractS3Provider, IMMUTABLE_CACHE_CONTROL } from './AbstractS3Provider.ts'\n\n/** A progress event emitted while publishing blocks. */\nexport interface BlockPublishProgress {\n  blockNumber: XL1BlockNumber\n  published: number\n  total: number\n}\n\n/** Parameters for S3BlockPublishRunner. */\nexport interface S3BlockPublishRunnerParams extends S3ProviderParams {\n  /** Maximum concurrent block publishes during sync. */\n  concurrency?: number\n  /**\n   * Called every `progressInterval` blocks (and at pass completion). When omitted, the same\n   * events are logged via the params logger so long backfills are observable out of the box.\n   */\n  onProgress?: (event: BlockPublishProgress) => void\n  /** How many block publishes between progress reports during sync. */\n  progressInterval?: number\n  /**\n   * The viewer to publish from (only finalized chains should be published). When omitted,\n   * resolved from the locator via BlockViewerMoniker.\n   */\n  source?: BlockViewer\n}\n\n/**\n * Publishes finalized blocks (and their payloads) as the static REST file layout that\n * `RestBlockViewer` reads (see `paths.ts` in @xyo-network/xl1-rest-block-viewer).\n *\n * Publishing is idempotent: keys are deterministic and contents immutable, so re-publishing\n * any range is safe. `sync(from)` resumes from a caller-supplied cursor (typically the block\n * after the last published head); omitting it republishes from genesis, which is safe.\n */\n@creatableProvider()\nexport class S3BlockPublishRunner extends AbstractS3Provider<S3BlockPublishRunnerParams> implements BlockPublishRunner {\n  static readonly defaultMoniker = BlockPublishRunnerMoniker\n  static readonly dependencies = [BlockViewerMoniker]\n  static readonly monikers = [BlockPublishRunnerMoniker]\n  moniker = S3BlockPublishRunner.defaultMoniker\n\n  protected _source?: BlockViewer\n\n  get concurrency(): number {\n    return this.params.concurrency ?? 8\n  }\n\n  get progressInterval(): number {\n    return this.params.progressInterval ?? 100\n  }\n\n  get source(): BlockViewer {\n    return assertEx(this._source, () => 'No source specified')\n  }\n\n  override async createHandler() {\n    await super.createHandler()\n    this._source = this.params.source ?? await this.locator.getInstance(BlockViewerMoniker)\n  }\n\n  /** Publishes one block at its by-number and by-hash paths, plus its payload files. */\n  async publishBlock(blockNumber: XL1BlockNumber): Promise<SignedHydratedBlockWithHashMeta | null> {\n    const block = await this.source.blockByNumber(blockNumber)\n    if (isNull(block)) return null\n    const json = JSON.stringify(block)\n    await this.putJson(blockNumberPath(block[0].block), json, IMMUTABLE_CACHE_CONTROL)\n    await this.putJson(blockHashPath(block[0]._hash), json, IMMUTABLE_CACHE_CONTROL)\n    for (const payload of block[1]) {\n      await this.putJson(payloadPath(payload._hash), JSON.stringify(payload), IMMUTABLE_CACHE_CONTROL)\n    }\n    return block\n  }\n\n  /**\n   * Publishes every block from `from` (inclusive, default genesis) through the source head.\n   * Returns the published range, or null when already up to date.\n   */\n  async sync(from: XL1BlockNumber = asXL1BlockNumber(0, true)): Promise<XL1BlockRange | null> {\n    const sourceHead = await this.source.currentBlock()\n    const end = sourceHead[0].block\n    if (from > end) return null\n\n    const semaphore = new Semaphore(this.concurrency)\n    const numbers = Array.from({ length: end - from + 1 }, (_, i) => asXL1BlockNumber(from + i, true))\n    const total = numbers.length\n    let publishedCount = 0\n    await Promise.all(numbers.map(blockNumber => semaphore.runExclusive(async () => {\n      assertEx(await this.publishBlock(blockNumber), () => `Block not found in source [${blockNumber}]`)\n      publishedCount += 1\n      if (publishedCount % this.progressInterval === 0 || publishedCount === total) {\n        this.report({\n          blockNumber, published: publishedCount, total,\n        })\n      }\n    })))\n    return [from, end]\n  }\n\n  /** Emits a progress event to the onProgress callback, or logs it when no callback is set. */\n  private report(event: BlockPublishProgress): void {\n    const onProgress = this.params.onProgress\n    if (onProgress) {\n      onProgress(event)\n      return\n    }\n    this.logger?.info(`S3BlockPublishRunner: published block ${event.blockNumber} (${event.published}/${event.total})`)\n  }\n}\n", "import { assertEx } from '@xylabs/sdk-js'\nimport type {\n  BlockViewer,\n  ChainStatePublishRunner, ChainStateViewerMethods, SignedHydratedBlockWithHashMeta,\n} from '@xyo-network/xl1-protocol-lib'\nimport { BlockViewerMoniker, ChainStatePublishRunnerMoniker } from '@xyo-network/xl1-protocol-lib'\nimport { creatableProvider } from '@xyo-network/xl1-protocol-sdk'\nimport { headPath } from '@xyo-network/xl1-rest-block-viewer'\n\nimport type { S3ProviderParams } from './AbstractS3Provider.ts'\nimport { AbstractS3Provider, MUTABLE_CACHE_CONTROL } from './AbstractS3Provider.ts'\n\n/** Parameters for S3ChainStatePublishRunner. */\nexport interface S3ChainStatePublishRunnerParams extends S3ProviderParams {\n  /**\n   * Where the current head is read from (any BlockViewer satisfies this). When omitted,\n   * resolved from the locator via BlockViewerMoniker.\n   */\n  source?: ChainStateViewerMethods\n}\n\n/**\n * Publishes the mutable chain state \u2014 the head pointer (`chain/head.json`) \u2014 that\n * `RestChainStateViewer` reads. This is the one mutable file in the REST layout, so it is\n * stored with must-revalidate caching and should target the chain-state bucket.\n *\n * Callers must publish the finalized files for a head before publishing the head itself,\n * so readers never see a head that references missing files.\n */\n@creatableProvider()\nexport class S3ChainStatePublishRunner extends AbstractS3Provider<S3ChainStatePublishRunnerParams> implements ChainStatePublishRunner {\n  static readonly defaultMoniker = ChainStatePublishRunnerMoniker\n  static readonly dependencies = [BlockViewerMoniker]\n  static readonly monikers = [ChainStatePublishRunnerMoniker]\n  moniker = S3ChainStatePublishRunner.defaultMoniker\n\n  protected _source?: ChainStateViewerMethods\n\n  get source(): ChainStateViewerMethods {\n    return assertEx(this._source, () => 'No source specified')\n  }\n\n  override async createHandler() {\n    await super.createHandler()\n    this._source = this.params.source ?? await this.locator.getInstance<BlockViewer>(BlockViewerMoniker)\n  }\n\n  /** Publishes the source's current head to the mutable chain state pointer. */\n  async publishHead(): Promise<SignedHydratedBlockWithHashMeta> {\n    const head = await this.source.currentBlock()\n    await this.putJson(headPath(), JSON.stringify(head), MUTABLE_CACHE_CONTROL)\n    this.logger?.info(`S3ChainStatePublishRunner: published head ${head[0].block}`)\n    return head\n  }\n}\n", "import type { Hash } from '@xylabs/sdk-js'\nimport { assertEx } from '@xylabs/sdk-js'\nimport type {\n  ChainStateViewer, SignedHydratedBlockWithHashMeta, XL1BlockNumber,\n} from '@xyo-network/xl1-protocol-lib'\nimport { asSignedHydratedBlockWithHashMeta, ChainStateViewerMoniker } from '@xyo-network/xl1-protocol-lib'\nimport { creatableProvider } from '@xyo-network/xl1-protocol-sdk'\nimport { headPath } from '@xyo-network/xl1-rest-block-viewer'\n\nimport type { S3ProviderParams } from './AbstractS3Provider.ts'\nimport { AbstractS3Provider } from './AbstractS3Provider.ts'\n\n/** Parameters for S3ChainStateViewer. */\nexport interface S3ChainStateViewerParams extends S3ProviderParams {}\n\n/**\n * A ChainStateViewer over the chain-state bucket, reading the published head pointer back\n * through the S3 API (authenticated, not the public HTTP layout \u2014 see RestChainStateViewer\n * for anonymous reads). This is how publishers learn their resume cursor: the head pointer\n * is only written after the finalized files it references exist.\n */\n@creatableProvider()\nexport class S3ChainStateViewer extends AbstractS3Provider<S3ChainStateViewerParams, ChainStateViewer['eventData']>\n  implements ChainStateViewer {\n  static readonly defaultMoniker = ChainStateViewerMoniker\n  static readonly dependencies = []\n  static readonly monikers = [ChainStateViewerMoniker]\n  moniker = S3ChainStateViewer.defaultMoniker\n\n  /** The published head; throws when no head pointer has been published yet. */\n  async currentBlock(): Promise<SignedHydratedBlockWithHashMeta> {\n    return await this.spanAsync('currentBlock', async () => {\n      const parsed = assertEx(await this.getJson(headPath()), () => 'Head not found')\n      return asSignedHydratedBlockWithHashMeta(parsed, true)\n    }, this.context)\n  }\n\n  async currentBlockHash(): Promise<Hash> {\n    return (await this.currentBlock())[0]._hash\n  }\n\n  async currentBlockNumber(): Promise<XL1BlockNumber> {\n    return (await this.currentBlock())[0].block\n  }\n\n  /** The published head, or undefined when no head pointer has been published yet. */\n  async tryCurrentBlock(): Promise<SignedHydratedBlockWithHashMeta | undefined> {\n    const parsed = await this.getJson(headPath())\n    return parsed === undefined ? undefined : asSignedHydratedBlockWithHashMeta(parsed, true)\n  }\n}\n", "import { assertEx } from '@xylabs/sdk-js'\nimport type {\n  BlocksStepSummary, BlockViewer, IndexPublishRunner, XL1BlockNumber,\n} from '@xyo-network/xl1-protocol-lib'\nimport {\n  BlocksStepSummarySchema, BlockViewerMoniker, IndexPublishRunnerMoniker, StepSizes,\n} from '@xyo-network/xl1-protocol-lib'\nimport { blocksMaxStep, creatableProvider } from '@xyo-network/xl1-protocol-sdk'\nimport { blocksStepPath } from '@xyo-network/xl1-rest-block-viewer'\n\nimport type { S3ProviderParams } from './AbstractS3Provider.ts'\nimport { AbstractS3Provider, IMMUTABLE_CACHE_CONTROL } from './AbstractS3Provider.ts'\n\n/** Parameters for S3IndexPublishRunner. */\nexport interface S3IndexPublishRunnerParams extends S3ProviderParams {\n  /**\n   * The viewer to publish from (only finalized chains should be published). When omitted,\n   * resolved from the locator via BlockViewerMoniker.\n   */\n  source?: BlockViewer\n}\n\n/**\n * Publishes completed steps' block summaries (the chain index) as the static REST file\n * layout that `RestIndexViewer` reads. Step files are immutable: only complete steps are\n * ever published, and a completed step's blocks never change.\n */\n@creatableProvider()\nexport class S3IndexPublishRunner extends AbstractS3Provider<S3IndexPublishRunnerParams> implements IndexPublishRunner {\n  static readonly defaultMoniker = IndexPublishRunnerMoniker\n  static readonly dependencies = [BlockViewerMoniker]\n  static readonly monikers = [IndexPublishRunnerMoniker]\n  moniker = S3IndexPublishRunner.defaultMoniker\n\n  protected _source?: BlockViewer\n\n  get source(): BlockViewer {\n    return assertEx(this._source, () => 'No source specified')\n  }\n\n  override async createHandler() {\n    await super.createHandler()\n    this._source = this.params.source ?? await this.locator.getInstance(BlockViewerMoniker)\n  }\n\n  /**\n   * Publishes one completed step's blocks as a BlocksStepSummary file (blocks oldest-first).\n   * Asserts the step is complete \u2014 partial tail steps are never published.\n   */\n  async publishStep(stepLevel: number, stepIndex: number): Promise<void> {\n    const size = StepSizes[stepLevel]\n    assertEx(stepLevel <= blocksMaxStep, () => `publishStep does not support step levels above ${blocksMaxStep} (requested ${stepLevel})`)\n    const lastBlockNumber = (stepIndex + 1) * size - 1\n    const headNumber = await this.source.currentBlockNumber()\n    assertEx(lastBlockNumber <= headNumber, () => `Step ${stepLevel}/${stepIndex} is not complete (head ${headNumber})`)\n    const newestFirst = await this.source.blocksByStep(stepLevel, stepIndex)\n    const blocks = newestFirst.toReversed()\n    const summary: BlocksStepSummary = {\n      schema: BlocksStepSummarySchema,\n      hash: assertEx(blocks.at(-1), () => `No blocks for step ${stepLevel}/${stepIndex}`)[0]._hash,\n      stepSize: size,\n      blocks,\n    }\n    await this.putJson(blocksStepPath(stepLevel, stepIndex), JSON.stringify(summary), IMMUTABLE_CACHE_CONTROL)\n    this.logger?.info(`S3IndexPublishRunner: published step ${stepLevel}/${stepIndex}`)\n  }\n\n  /** Publishes every step (at every level) completed by the given block. */\n  async publishStepsCompletedBy(blockNumber: XL1BlockNumber): Promise<void> {\n    for (let stepLevel = 0; stepLevel <= blocksMaxStep; stepLevel++) {\n      const size = StepSizes[stepLevel]\n      if ((blockNumber + 1) % size === 0) {\n        await this.publishStep(stepLevel, (blockNumber + 1) / size - 1)\n      }\n    }\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["assertEx", "assertEx", "assertEx", "BlockViewerMoniker", "creatableProvider", "assertEx", "BlockViewerMoniker", "creatableProvider", "assertEx", "creatableProvider", "headPath", "assertEx", "headPath", "creatableProvider", "assertEx", "BlockViewerMoniker", "creatableProvider", "assertEx", "BlockViewerMoniker", "creatableProvider"]
+  "sourcesContent": ["import type { S3Client } from '@aws-sdk/client-s3'\nimport {\n  GetObjectCommand, HeadObjectCommand, PutObjectCommand,\n} from '@aws-sdk/client-s3'\nimport { assertEx } from '@xylabs/sdk-js'\nimport type { CreatableProviderEventData, CreatableProviderParams } from '@xyo-network/xl1-protocol-sdk'\nimport { AbstractCreatableProvider } from '@xyo-network/xl1-protocol-sdk'\n\nimport type { RestContentEncoding } from './encoding.ts'\nimport { decodeBody, encodeBody } from './encoding.ts'\n\n/** Shared parameters for S3-backed providers: where and how files are stored. */\nexport interface S3ProviderParams extends CreatableProviderParams {\n  bucket: string\n  /** S3-compatible client pointed at the target endpoint (e.g. Cloudflare R2). */\n  client: S3Client\n  /** Storage/wire encoding for published files. Defaults to 'br' (brotli). */\n  contentEncoding?: RestContentEncoding\n  /** Optional key prefix, allowing the layout to live in a shared bucket. */\n  prefix?: string\n}\n\n/** Finalized files never change once written. */\nexport const IMMUTABLE_CACHE_CONTROL = 'public, max-age=31536000, immutable'\n/**\n * The head pointer is rewritten as the chain advances. A small positive TTL plus\n * stale-while-revalidate keeps origin load low at high RPS while staying fresh \u2014 better\n * than `max-age=0` for a hot, frequently-read object. Used for the chain-state head and\n * the index watermark.\n */\nexport const MUTABLE_CACHE_CONTROL = 'public, max-age=5, stale-while-revalidate=30'\n/**\n * Manifests are mostly-static layout descriptors that change only when the layout evolves;\n * a short TTL lets a new layout propagate within minutes without per-request revalidation.\n */\nexport const MANIFEST_CACHE_CONTROL = 'public, max-age=300'\n\n/**\n * Base for providers targeting S3-compatible storage. Bodies are pre-compressed at write\n * time and stored with the matching Content-Encoding plus application/json, so HTTP clients\n * decompress transparently \u2014 keys keep their `.json` extension. Reads decode the stored\n * Content-Encoding back to JSON.\n */\nexport abstract class AbstractS3Provider<\n  TParams extends S3ProviderParams = S3ProviderParams,\n  TEventData extends CreatableProviderEventData = CreatableProviderEventData,\n> extends AbstractCreatableProvider<TParams, TEventData> {\n  get bucket(): string {\n    return assertEx(this.params.bucket, () => 'No bucket specified')\n  }\n\n  get client(): S3Client {\n    return assertEx(this.params.client, () => 'No client specified')\n  }\n\n  get contentEncoding(): RestContentEncoding {\n    return this.params.contentEncoding ?? 'br'\n  }\n\n  get prefix(): string {\n    return this.params.prefix ?? ''\n  }\n\n  /** Reads and decodes a stored JSON file, or undefined when the key does not exist. */\n  protected async getJson(path: string): Promise<unknown> {\n    try {\n      const response = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: `${this.prefix}${path}` }))\n      const body = await response.Body?.transformToByteArray()\n      if (body === undefined) return undefined\n      return JSON.parse(decodeBody(body, response.ContentEncoding)) as unknown\n    } catch (error) {\n      if (isNotFoundError(error)) return undefined\n      throw error\n    }\n  }\n\n  /** True when the key exists, checked without fetching the body. */\n  protected async hasJson(path: string): Promise<boolean> {\n    try {\n      await this.client.send(new HeadObjectCommand({ Bucket: this.bucket, Key: `${this.prefix}${path}` }))\n      return true\n    } catch (error) {\n      if (isNotFoundError(error)) return false\n      throw error\n    }\n  }\n\n  protected async putJson(path: string, json: string, cacheControl: string): Promise<void> {\n    const { body, contentEncoding } = encodeBody(json, this.contentEncoding)\n    await this.client.send(new PutObjectCommand({\n      Bucket: this.bucket,\n      Key: `${this.prefix}${path}`,\n      Body: body,\n      CacheControl: cacheControl,\n      ContentEncoding: contentEncoding,\n      ContentType: 'application/json',\n    }))\n  }\n}\n\nconst isNotFoundError = (error: unknown): boolean => {\n  if (typeof error !== 'object' || error === null) return false\n  const { name, $metadata } = error as { $metadata?: { httpStatusCode?: number }; name?: string }\n  return name === 'NoSuchKey' || name === 'NotFound' || $metadata?.httpStatusCode === 404\n}\n", "import ZLIB from 'node:zlib'\n\n/** Wire/storage encoding for published files. */\nexport type RestContentEncoding = 'br' | 'gzip' | 'none'\n\n/** An encoded file body plus the HTTP Content-Encoding it should be served with. */\nexport interface EncodedBody {\n  body: Uint8Array\n  contentEncoding?: 'br' | 'gzip'\n}\n\n/**\n * Encodes a JSON string for storage. Bodies are pre-compressed at write time and stored\n * with the matching Content-Encoding so HTTP clients decompress transparently \u2014 keys keep\n * their .json extension and Content-Type stays application/json.\n */\nexport function encodeBody(json: string, encoding: RestContentEncoding): EncodedBody {\n  switch (encoding) {\n    case 'br': {\n      return { body: ZLIB.brotliCompressSync(json), contentEncoding: 'br' }\n    }\n    case 'gzip': {\n      return { body: ZLIB.gzipSync(json), contentEncoding: 'gzip' }\n    }\n    case 'none': {\n      return { body: new TextEncoder().encode(json) }\n    }\n  }\n}\n\n/** Decodes a stored body back to its JSON string using the object's Content-Encoding. */\nexport function decodeBody(body: Uint8Array, contentEncoding?: string): string {\n  switch (contentEncoding) {\n    case 'br': {\n      return ZLIB.brotliDecompressSync(body).toString('utf8')\n    }\n    case 'gzip': {\n      return ZLIB.gunzipSync(body).toString('utf8')\n    }\n    default: {\n      return new TextDecoder().decode(body)\n    }\n  }\n}\n", "import { assertEx, isNull } from '@xylabs/sdk-js'\nimport type {\n  BlockPublishRunner, BlockViewer, SignedHydratedBlockWithHashMeta, XL1BlockNumber, XL1BlockRange,\n} from '@xyo-network/xl1-protocol-lib'\nimport {\n  asXL1BlockNumber, BlockPublishRunnerMoniker, BlockViewerMoniker,\n} from '@xyo-network/xl1-protocol-lib'\nimport { creatableProvider } from '@xyo-network/xl1-protocol-sdk'\nimport type { ChainManifest } from '@xyo-network/xl1-rest-block-viewer'\nimport {\n  blockHashPath, blockNumberPath, CHAIN_LAYOUT_VERSION, ChainManifestSchema, manifestPath, payloadPath,\n} from '@xyo-network/xl1-rest-block-viewer'\nimport { Semaphore } from 'async-mutex'\n\nimport type { S3ProviderParams } from './AbstractS3Provider.ts'\nimport {\n  AbstractS3Provider, IMMUTABLE_CACHE_CONTROL, MANIFEST_CACHE_CONTROL,\n} from './AbstractS3Provider.ts'\n\n/** A progress event emitted while publishing blocks. */\nexport interface BlockPublishProgress {\n  blockNumber: XL1BlockNumber\n  published: number\n  total: number\n}\n\n/** Parameters for S3BlockPublishRunner. */\nexport interface S3BlockPublishRunnerParams extends S3ProviderParams {\n  /** Maximum concurrent block publishes during sync. */\n  concurrency?: number\n  /**\n   * Called every `progressInterval` blocks (and at pass completion). When omitted, the same\n   * events are logged via the params logger so long backfills are observable out of the box.\n   */\n  onProgress?: (event: BlockPublishProgress) => void\n  /** How many block publishes between progress reports during sync. */\n  progressInterval?: number\n  /**\n   * The viewer to publish from (only finalized chains should be published). When omitted,\n   * resolved from the locator via BlockViewerMoniker.\n   */\n  source?: BlockViewer\n}\n\n/**\n * Publishes finalized blocks (and their payloads) as the static REST file layout that\n * `RestBlockViewer` reads (see `paths.ts` in @xyo-network/xl1-rest-block-viewer).\n *\n * Publishing is idempotent: keys are deterministic and contents immutable, so re-publishing\n * any range is safe. `sync(from)` resumes from a caller-supplied cursor (typically the block\n * after the last published head); omitting it republishes from genesis, which is safe.\n */\n@creatableProvider()\nexport class S3BlockPublishRunner extends AbstractS3Provider<S3BlockPublishRunnerParams> implements BlockPublishRunner {\n  static readonly defaultMoniker = BlockPublishRunnerMoniker\n  static readonly dependencies = [BlockViewerMoniker]\n  static readonly monikers = [BlockPublishRunnerMoniker]\n  moniker = S3BlockPublishRunner.defaultMoniker\n\n  protected _source?: BlockViewer\n\n  get concurrency(): number {\n    return this.params.concurrency ?? 8\n  }\n\n  get progressInterval(): number {\n    return this.params.progressInterval ?? 100\n  }\n\n  get source(): BlockViewer {\n    return assertEx(this._source, () => 'No source specified')\n  }\n\n  override async createHandler() {\n    await super.createHandler()\n    this._source = this.params.source ?? await this.locator.getInstance(BlockViewerMoniker)\n  }\n\n  /**\n   * Finds where a catch-up sync should start: walks backwards from the source head probing\n   * by-number paths (in batches of `concurrency`) until it finds an already published block,\n   * never probing below `floor`, and returns the block after it.\n   *\n   * This is what makes resuming cheap after a bucket was primed externally (an importer\n   * CLI) or after publishing was toggled off and on: already published blocks above a\n   * stale or missing head pointer are skipped instead of republished.\n   *\n   * Scope: only the topmost contiguous gap is healed. The walk stops at the first published\n   * block, so holes below it are not probed \u2014 deep verification belongs to an importer or\n   * audit tool. The walk also trusts that whoever published a block also published its\n   * payloads and step files. As a fast path, a missing genesis block with `floor` at\n   * genesis is treated as an empty bucket (full backfill) without walking the whole range.\n   */\n  async findCatchUpStart(floor: XL1BlockNumber = asXL1BlockNumber(0, true)): Promise<XL1BlockNumber> {\n    const sourceHead = await this.source.currentBlock()\n    const end = sourceHead[0].block\n    if (floor > end) return floor\n    if (floor === 0 && !(await this.hasBlock(asXL1BlockNumber(0, true)))) return floor\n    for (let high: number = end; high >= floor; high -= this.concurrency) {\n      const low = Math.max(floor, high - this.concurrency + 1)\n      const present = await Promise.all(\n        Array.from({ length: high - low + 1 }, (_, i) => this.hasBlock(asXL1BlockNumber(low + i, true))),\n      )\n      for (let blockNumber = high; blockNumber >= low; blockNumber--) {\n        if (present[blockNumber - low]) return asXL1BlockNumber(blockNumber + 1, true)\n      }\n    }\n    return floor\n  }\n\n  /** True when the block is already published at its by-number path. */\n  async hasBlock(blockNumber: XL1BlockNumber): Promise<boolean> {\n    return await this.hasJson(blockNumberPath(blockNumber))\n  }\n\n  /** Publishes one block at its by-number and by-hash paths, plus its payload files. */\n  async publishBlock(blockNumber: XL1BlockNumber): Promise<SignedHydratedBlockWithHashMeta | null> {\n    const block = await this.source.blockByNumber(blockNumber)\n    if (isNull(block)) return null\n    const json = JSON.stringify(block)\n    await this.putJson(blockNumberPath(block[0].block), json, IMMUTABLE_CACHE_CONTROL)\n    await this.putJson(blockHashPath(block[0]._hash), json, IMMUTABLE_CACHE_CONTROL)\n    for (const payload of block[1]) {\n      await this.putJson(payloadPath(payload._hash), JSON.stringify(payload), IMMUTABLE_CACHE_CONTROL)\n    }\n    return block\n  }\n\n  /** Publishes the finalized layout descriptor (idempotent; refreshed on each sync). */\n  async publishManifest(): Promise<void> {\n    const manifest: ChainManifest = {\n      earliestBlock: 0,\n      encoding: this.contentEncoding,\n      // literal templates: a self-describing mirror of the path builders in xl1-rest-block-viewer\n      paths: {\n        blockByHash: 'block/hash/{hash}.json',\n        blockByNumber: 'block/number/{block}.json',\n        head: 'chain/head.json',\n        payload: 'payload/{hash}.json',\n      },\n      schema: ChainManifestSchema,\n      version: CHAIN_LAYOUT_VERSION,\n    }\n    await this.putJson(manifestPath(), JSON.stringify(manifest), MANIFEST_CACHE_CONTROL)\n  }\n\n  /**\n   * Publishes every block from `from` (inclusive, default genesis) through the source head.\n   * Returns the published range, or null when already up to date.\n   */\n  async sync(from: XL1BlockNumber = asXL1BlockNumber(0, true)): Promise<XL1BlockRange | null> {\n    const sourceHead = await this.source.currentBlock()\n    const end = sourceHead[0].block\n    if (from > end) return null\n    await this.publishManifest()\n\n    const semaphore = new Semaphore(this.concurrency)\n    const numbers = Array.from({ length: end - from + 1 }, (_, i) => asXL1BlockNumber(from + i, true))\n    const total = numbers.length\n    let publishedCount = 0\n    await Promise.all(numbers.map(blockNumber => semaphore.runExclusive(async () => {\n      assertEx(await this.publishBlock(blockNumber), () => `Block not found in source [${blockNumber}]`)\n      publishedCount += 1\n      if (publishedCount % this.progressInterval === 0 || publishedCount === total) {\n        this.report({\n          blockNumber, published: publishedCount, total,\n        })\n      }\n    })))\n    return [from, end]\n  }\n\n  /** Emits a progress event to the onProgress callback, or logs it when no callback is set. */\n  private report(event: BlockPublishProgress): void {\n    const onProgress = this.params.onProgress\n    if (onProgress) {\n      onProgress(event)\n      return\n    }\n    this.logger?.info(`S3BlockPublishRunner: published block ${event.blockNumber} (${event.published}/${event.total})`)\n  }\n}\n", "import { assertEx } from '@xylabs/sdk-js'\nimport type {\n  BlockViewer,\n  ChainStatePublishRunner, ChainStateViewerMethods, SignedHydratedBlockWithHashMeta,\n} from '@xyo-network/xl1-protocol-lib'\nimport { BlockViewerMoniker, ChainStatePublishRunnerMoniker } from '@xyo-network/xl1-protocol-lib'\nimport { creatableProvider } from '@xyo-network/xl1-protocol-sdk'\nimport { headPath } from '@xyo-network/xl1-rest-block-viewer'\n\nimport type { S3ProviderParams } from './AbstractS3Provider.ts'\nimport { AbstractS3Provider, MUTABLE_CACHE_CONTROL } from './AbstractS3Provider.ts'\n\n/** Parameters for S3ChainStatePublishRunner. */\nexport interface S3ChainStatePublishRunnerParams extends S3ProviderParams {\n  /**\n   * Where the current head is read from (any BlockViewer satisfies this). When omitted,\n   * resolved from the locator via BlockViewerMoniker.\n   */\n  source?: ChainStateViewerMethods\n}\n\n/**\n * Publishes the mutable chain state \u2014 the head pointer (`chain/head.json`) \u2014 that\n * `RestChainStateViewer` reads. This is the one mutable file in the REST layout, so it is\n * stored with must-revalidate caching and should target the chain-state bucket.\n *\n * Callers must publish the finalized files for a head before publishing the head itself,\n * so readers never see a head that references missing files.\n */\n@creatableProvider()\nexport class S3ChainStatePublishRunner extends AbstractS3Provider<S3ChainStatePublishRunnerParams> implements ChainStatePublishRunner {\n  static readonly defaultMoniker = ChainStatePublishRunnerMoniker\n  static readonly dependencies = [BlockViewerMoniker]\n  static readonly monikers = [ChainStatePublishRunnerMoniker]\n  moniker = S3ChainStatePublishRunner.defaultMoniker\n\n  protected _source?: ChainStateViewerMethods\n\n  get source(): ChainStateViewerMethods {\n    return assertEx(this._source, () => 'No source specified')\n  }\n\n  override async createHandler() {\n    await super.createHandler()\n    this._source = this.params.source ?? await this.locator.getInstance<BlockViewer>(BlockViewerMoniker)\n  }\n\n  /** Publishes the source's current head to the mutable chain state pointer. */\n  async publishHead(): Promise<SignedHydratedBlockWithHashMeta> {\n    const head = await this.source.currentBlock()\n    await this.putJson(headPath(), JSON.stringify(head), MUTABLE_CACHE_CONTROL)\n    this.logger?.info(`S3ChainStatePublishRunner: published head ${head[0].block}`)\n    return head\n  }\n}\n", "import type { Hash } from '@xylabs/sdk-js'\nimport { assertEx } from '@xylabs/sdk-js'\nimport type {\n  ChainStateViewer, SignedHydratedBlockWithHashMeta, XL1BlockNumber,\n} from '@xyo-network/xl1-protocol-lib'\nimport { asSignedHydratedBlockWithHashMeta, ChainStateViewerMoniker } from '@xyo-network/xl1-protocol-lib'\nimport { creatableProvider } from '@xyo-network/xl1-protocol-sdk'\nimport { headPath } from '@xyo-network/xl1-rest-block-viewer'\n\nimport type { S3ProviderParams } from './AbstractS3Provider.ts'\nimport { AbstractS3Provider } from './AbstractS3Provider.ts'\n\n/** Parameters for S3ChainStateViewer. */\nexport interface S3ChainStateViewerParams extends S3ProviderParams {}\n\n/**\n * A ChainStateViewer over the chain-state bucket, reading the published head pointer back\n * through the S3 API (authenticated, not the public HTTP layout \u2014 see RestChainStateViewer\n * for anonymous reads). This is how publishers learn their resume cursor: the head pointer\n * is only written after the finalized files it references exist.\n */\n@creatableProvider()\nexport class S3ChainStateViewer extends AbstractS3Provider<S3ChainStateViewerParams, ChainStateViewer['eventData']>\n  implements ChainStateViewer {\n  static readonly defaultMoniker = ChainStateViewerMoniker\n  static readonly dependencies = []\n  static readonly monikers = [ChainStateViewerMoniker]\n  moniker = S3ChainStateViewer.defaultMoniker\n\n  /** The published head; throws when no head pointer has been published yet. */\n  async currentBlock(): Promise<SignedHydratedBlockWithHashMeta> {\n    return await this.spanAsync('currentBlock', async () => {\n      const parsed = assertEx(await this.getJson(headPath()), () => 'Head not found')\n      return asSignedHydratedBlockWithHashMeta(parsed, true)\n    }, this.context)\n  }\n\n  async currentBlockHash(): Promise<Hash> {\n    return (await this.currentBlock())[0]._hash\n  }\n\n  async currentBlockNumber(): Promise<XL1BlockNumber> {\n    return (await this.currentBlock())[0].block\n  }\n\n  /** The published head, or undefined when no head pointer has been published yet. */\n  async tryCurrentBlock(): Promise<SignedHydratedBlockWithHashMeta | undefined> {\n    const parsed = await this.getJson(headPath())\n    return parsed === undefined ? undefined : asSignedHydratedBlockWithHashMeta(parsed, true)\n  }\n}\n", "import type { Hash } from '@xylabs/sdk-js'\nimport { assertEx } from '@xylabs/sdk-js'\nimport type {\n  AsyncMap, BlockViewer, CachingContext, IndexPublishRunner, IndexSummaryFamily, IndexWatermark, MapType,\n  XL1BlockNumber, XL1BlockRange,\n} from '@xyo-network/xl1-protocol-lib'\nimport {\n  asXL1BlockNumber, asXL1BlockRange, BlockViewerMoniker, IndexPublishRunnerMoniker, StepSizes,\n} from '@xyo-network/xl1-protocol-lib'\nimport {\n  balancesMaxStep, balancesStepSummaryFromRange,\n  blocksMaxStep, blocksStepSummaryFromRange,\n  creatableProvider,\n  schemasMaxStep, schemasStepSummaryFromRange,\n  transfersMaxStep, transfersStepSummaryFromRange,\n} from '@xyo-network/xl1-protocol-sdk'\nimport type { IndexHead, IndexManifest } from '@xyo-network/xl1-rest-block-viewer'\nimport {\n  INDEX_LAYOUT_VERSION,\n  indexHeadPath, IndexHeadSchema, indexManifestPath, IndexManifestSchema, indexSummaryPath,\n} from '@xyo-network/xl1-rest-block-viewer'\nimport { Semaphore } from 'async-mutex'\n\nimport type { S3ProviderParams } from './AbstractS3Provider.ts'\nimport {\n  AbstractS3Provider, IMMUTABLE_CACHE_CONTROL, MANIFEST_CACHE_CONTROL, MUTABLE_CACHE_CONTROL,\n} from './AbstractS3Provider.ts'\n\n/** The minimum shape the summary map needs to place a frame: its head hash and frame size. */\ninterface FramePlacement {\n  hash: Hash\n  stepSize: number\n}\n\n/** The signature shared by every `*StepSummaryFromRange` builder. */\ntype SummaryBuilder<T extends FramePlacement> = (\n  context: CachingContext,\n  semaphores: Semaphore[],\n  blockViewer: BlockViewer,\n  summaryMap: MapType<string, T>,\n  range: XL1BlockRange,\n) => Promise<T>\n\n/**\n * A summary map backed by the index bucket. The builders cache completed frames here keyed by\n * `${frameHeadHash}|${frameSize}`; this map turns that key into the frame's `indexSummaryPath`\n * (resolving the head hash to a block number via the source viewer) so `get` reads the published\n * frame and `set` writes it \u2014 making the bucket itself the builders' frame cache, which gives\n * skip-if-present resume and cascading sub-frame writes for free.\n */\nclass S3IndexSummaryMap<T extends FramePlacement> implements AsyncMap<string, T> {\n  private readonly family: IndexSummaryFamily\n  private readonly numberCache = new Map<Hash, number>()\n  private readonly read: (path: string) => Promise<unknown>\n  private readonly source: BlockViewer\n  private readonly write: (path: string, json: string) => Promise<void>\n\n  constructor(\n    family: IndexSummaryFamily,\n    source: BlockViewer,\n    read: (path: string) => Promise<unknown>,\n    write: (path: string, json: string) => Promise<void>,\n  ) {\n    this.family = family\n    this.source = source\n    this.read = read\n    this.write = write\n  }\n\n  clear(): void {\n    this.numberCache.clear()\n  }\n\n  delete(_id: string): boolean {\n    return false\n  }\n\n  async get(id: string): Promise<T | undefined> {\n    const path = await this.pathForKey(id)\n    if (path === undefined) return undefined\n    const found = await this.read(path)\n    return found === undefined ? undefined : (found as T)\n  }\n\n  async getMany(ids: string[]): Promise<T[]> {\n    const found = await Promise.all(ids.map(id => this.get(id)))\n    return found.flatMap(value => (value === undefined ? [] : [value]))\n  }\n\n  async has(id: string): Promise<boolean> {\n    return (await this.get(id)) !== undefined\n  }\n\n  async set(id: string, data: T): Promise<void> {\n    const path = (await this.pathForFrame(data.hash, data.stepSize)) ?? (await this.pathForKey(id))\n    if (path === undefined) return\n    await this.write(path, JSON.stringify(data))\n  }\n\n  async setMany(entries: [string, T][]): Promise<void> {\n    await Promise.all(entries.map(([id, data]) => this.set(id, data)))\n  }\n\n  private async pathForFrame(hash: Hash, stepSize: number): Promise<string | undefined> {\n    const stepLevel = StepSizes.indexOf(asXL1BlockNumber(stepSize, true))\n    if (stepLevel === -1) return undefined\n    const blockNumber = await this.resolveBlockNumber(hash)\n    if (blockNumber === undefined) return undefined\n    const stepIndex = (blockNumber + 1) / stepSize - 1\n    return Number.isInteger(stepIndex) && stepIndex >= 0 ? indexSummaryPath(this.family, stepLevel, stepIndex) : undefined\n  }\n\n  private async pathForKey(key: string): Promise<string | undefined> {\n    const [hash, sizeText] = key.split('|')\n    return await this.pathForFrame(hash as Hash, Number(sizeText))\n  }\n\n  private async resolveBlockNumber(hash: Hash): Promise<number | undefined> {\n    const cached = this.numberCache.get(hash)\n    if (cached !== undefined) return cached\n    const block = await this.source.blockByHash(hash)\n    if (!block) return undefined\n    const blockNumber = block[0].block\n    this.numberCache.set(hash, blockNumber)\n    return blockNumber\n  }\n}\n\n/** Parameters for S3IndexPublishRunner. */\nexport interface S3IndexPublishRunnerParams extends S3ProviderParams {\n  /**\n   * The viewer to build the index from (only finalized chains should be indexed). When omitted,\n   * resolved from the locator via BlockViewerMoniker.\n   */\n  source?: BlockViewer\n}\n\n/**\n * Publishes the multi-family chain index (blocks, balances, schemas, transfers) as the static\n * REST file layout that `RestIndexViewer` reads. Frames are immutable: only complete frames are\n * ever published, and a completed frame never changes. The runner reads blocks from its source\n * viewer (MongoDB, or the finalized/chain-state buckets via CDN) and writes summaries to the\n * index bucket; the head watermark and manifest are written last so a reader never sees a\n * watermark pointing past the frames that back it.\n */\n@creatableProvider()\nexport class S3IndexPublishRunner extends AbstractS3Provider<S3IndexPublishRunnerParams> implements IndexPublishRunner {\n  static readonly defaultMoniker = IndexPublishRunnerMoniker\n  static readonly dependencies = [BlockViewerMoniker]\n  static readonly monikers = [IndexPublishRunnerMoniker]\n  moniker = S3IndexPublishRunner.defaultMoniker\n\n  protected _source?: BlockViewer\n\n  get source(): BlockViewer {\n    return assertEx(this._source, () => 'No source specified')\n  }\n\n  override async createHandler() {\n    await super.createHandler()\n    this._source = this.params.source ?? await this.locator.getInstance(BlockViewerMoniker)\n  }\n\n  /** Builds every family's frames completed up to the ceiling, then writes the manifest and watermark. */\n  async publishCompletedFramesUpTo(ceiling: XL1BlockNumber): Promise<IndexWatermark> {\n    const head = await this.source.currentBlockNumber()\n    assertEx(ceiling <= head, () => `Ceiling ${ceiling} exceeds source head ${head}`)\n    const previous = (await this.readWatermark())?.block ?? -1\n    const families: Record<IndexSummaryFamily, number> = {\n      balances: await this.publishFamily('balances', balancesMaxStep, balancesStepSummaryFromRange, previous, ceiling),\n      blocks: await this.publishFamily('blocks', blocksMaxStep, blocksStepSummaryFromRange, previous, ceiling),\n      schemas: await this.publishFamily('schemas', schemasMaxStep, schemasStepSummaryFromRange, previous, ceiling),\n      transfers: await this.publishFamily('transfers', transfersMaxStep, transfersStepSummaryFromRange, previous, ceiling),\n    }\n    const ceilingBlock = assertEx(await this.source.blockByNumber(ceiling), () => `Block not found for ceiling ${ceiling}`)\n    const watermark: IndexWatermark = {\n      block: ceiling, hash: ceilingBlock[0]._hash, families,\n    }\n    await this.writeManifest()\n    await this.writeHead(watermark)\n    this.logger?.info(`S3IndexPublishRunner: index complete through block ${ceiling}`)\n    return watermark\n  }\n\n  /** Publishes one completed frame for a family (and any missing sub-frames it depends on). */\n  async publishFrame(family: IndexSummaryFamily, stepLevel: number, stepIndex: number): Promise<void> {\n    const size = StepSizes[stepLevel]\n    const lastBlock = (stepIndex + 1) * size - 1\n    const head = await this.source.currentBlockNumber()\n    assertEx(lastBlock <= head, () => `Frame ${family} ${stepLevel}/${stepIndex} is not complete (head ${head})`)\n    const range = asXL1BlockRange([stepIndex * size, lastBlock], true)\n    await this.buildFamilyFrame(family, range)\n    this.logger?.info(`S3IndexPublishRunner: published frame ${family} ${stepLevel}/${stepIndex}`)\n  }\n\n  /** Dispatches a single frame to its family builder, writing it (and missing sub-frames) to the bucket. */\n  private async buildFamilyFrame(family: IndexSummaryFamily, range: XL1BlockRange): Promise<void> {\n    const semaphores = StepSizes.map(() => new Semaphore(20))\n    switch (family) {\n      case 'balances': {\n        await balancesStepSummaryFromRange(this.context, semaphores, this.source, this.summaryMap('balances'), range)\n        break\n      }\n      case 'blocks': {\n        await blocksStepSummaryFromRange(this.context, semaphores, this.source, this.summaryMap('blocks'), range)\n        break\n      }\n      case 'schemas': {\n        await schemasStepSummaryFromRange(this.context, semaphores, this.source, this.summaryMap('schemas'), range)\n        break\n      }\n      case 'transfers': {\n        await transfersStepSummaryFromRange(this.context, semaphores, this.source, this.summaryMap('transfers'), range)\n        break\n      }\n    }\n  }\n\n  /** Builds a family's frames in (previous, ceiling] across every level; returns total completed frames. */\n  private async publishFamily<T extends FramePlacement>(\n    family: IndexSummaryFamily,\n    maxStep: number,\n    build: SummaryBuilder<T>,\n    previous: number,\n    ceiling: number,\n  ): Promise<number> {\n    const map = this.summaryMap<T>(family)\n    const semaphores = StepSizes.map(() => new Semaphore(20))\n    let completed = 0\n    // Bottom-up so a level's sub-frames exist (in the bucket) before the level above is built.\n    for (let stepLevel = 0; stepLevel <= maxStep; stepLevel++) {\n      const size = StepSizes[stepLevel]\n      const fromIndex = Math.floor((previous + 1) / size)\n      const toIndex = Math.floor((ceiling + 1) / size)\n      completed += toIndex\n      for (let stepIndex = fromIndex; stepIndex < toIndex; stepIndex++) {\n        const start = stepIndex * size\n        await build(this.context, semaphores, this.source, map, asXL1BlockRange([start, start + size - 1], true))\n      }\n    }\n    return completed\n  }\n\n  private async readWatermark(): Promise<IndexHead | undefined> {\n    const found = await this.getJson(indexHeadPath())\n    return found === undefined ? undefined : (found as IndexHead)\n  }\n\n  private summaryMap<T extends FramePlacement>(family: IndexSummaryFamily): S3IndexSummaryMap<T> {\n    return new S3IndexSummaryMap<T>(\n      family,\n      this.source,\n      path => this.getJson(path),\n      (path, json) => this.putJson(path, json, IMMUTABLE_CACHE_CONTROL),\n    )\n  }\n\n  private async writeHead(watermark: IndexWatermark): Promise<void> {\n    const head: IndexHead = {\n      schema: IndexHeadSchema,\n      version: INDEX_LAYOUT_VERSION,\n      block: watermark.block,\n      hash: watermark.hash,\n      updatedAt: new Date().toISOString(),\n      families: watermark.families,\n    }\n    await this.putJson(indexHeadPath(), JSON.stringify(head), MUTABLE_CACHE_CONTROL)\n  }\n\n  private async writeManifest(): Promise<void> {\n    const manifest: IndexManifest = {\n      schema: IndexManifestSchema,\n      version: INDEX_LAYOUT_VERSION,\n      families: {\n        balances: { maxStep: balancesMaxStep, path: 'balances/{level}/{index}.json' },\n        blocks: { maxStep: blocksMaxStep, path: 'blocks/{level}/{index}.json' },\n        schemas: { maxStep: schemasMaxStep, path: 'schemas/{level}/{index}.json' },\n        transfers: { maxStep: transfersMaxStep, path: 'transfers/{level}/{index}.json' },\n      },\n    }\n    await this.putJson(indexManifestPath(), JSON.stringify(manifest), MANIFEST_CACHE_CONTROL)\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["assertEx", "assertEx", "assertEx", "BlockViewerMoniker", "creatableProvider", "assertEx", "BlockViewerMoniker", "creatableProvider", "assertEx", "creatableProvider", "headPath", "assertEx", "headPath", "creatableProvider", "assertEx", "asXL1BlockNumber", "BlockViewerMoniker", "creatableProvider", "Semaphore", "asXL1BlockNumber", "assertEx", "BlockViewerMoniker", "Semaphore", "creatableProvider"]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-rest-block-publisher",
-  "version": "2.1.4",
+  "version": "2.1.6",
   "description": "XYO Layer One static REST chain layout publisher",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -35,17 +35,17 @@
     "README.md"
   ],
   "dependencies": {
-    "@xyo-network/xl1-protocol-lib": "~2.1.4",
-    "@xyo-network/xl1-protocol-sdk": "~2.1.4",
-    "@xyo-network/xl1-rest-block-viewer": "~2.1.4"
+    "@xyo-network/xl1-protocol-sdk": "~2.1.6",
+    "@xyo-network/xl1-rest-block-viewer": "~2.1.6",
+    "@xyo-network/xl1-protocol-lib": "~2.1.6"
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "^3.1066.0",
+    "@aws-sdk/client-s3": "^3.1067.0",
     "@bitauth/libauth": "~3.0.0",
     "@metamask/providers": "^22.1.1",
     "@noble/post-quantum": "~0.6.1",
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/sdk-trace-base": "^2.7.1",
+    "@opentelemetry/sdk-trace-base": "^2.8.0",
     "@scure/base": "~2.2.0",
     "@scure/bip39": "~2.2.0",
     "@xylabs/geo": "^6.1.1",
@@ -53,9 +53,9 @@
     "@xylabs/threads": "^6.1.1",
     "@xylabs/toolchain": "~8.1.20",
     "@xylabs/tsconfig": "~8.1.20",
-    "@xyo-network/address": "^6.1.0",
+    "@xyo-network/address": "^6.1.1",
     "@xyo-network/sdk-js": "^6.1.0",
-    "@xyo-network/sdk-protocol-js": "~6.1",
+    "@xyo-network/sdk-protocol-js": "~6.1.1",
     "ajv": "^8.20.0",
     "async-mutex": "^0.5.0",
     "cosmiconfig": "^9.0.2",