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

package/README.md

@@ -5,26 +5,31 @@
 [![npm-badge][]][npm-link]
 [![license-badge][]][license-link]
 
-> Publishes a finalized XL1 chain's immutable files as the static REST file layout that `RestBlockViewer` reads — pre-compressed, immutable, CDN-friendly.
+> Publishes an XL1 chain as the static REST file layout the Rest viewers read — pre-compressed, CDN-friendly, one runner per concern.
 
 ## About
 
-Finalized blocks and completed steps never change, so the chain can be materialized once as static files on S3-compatible object storage (e.g. Cloudflare R2) and served forever over plain HTTP. `RestBlockPublisher` writes the finalized (immutable) part of that layout from any source `BlockViewer`:
+Finalized blocks and completed steps never change, so the chain can be materialized once as static files on S3-compatible object storage (e.g. Cloudflare R2) and served forever over plain HTTP. Three locator-configurable runners (implementing the `BlockPublishRunner`, `IndexPublishRunner`, and `ChainStatePublishRunner` interfaces from `@xyo-network/xl1-protocol-lib`) write that layout from any source `BlockViewer`:
+
+- **`S3BlockPublishRunner`** — finalized blocks and their payloads
+- **`S3IndexPublishRunner`** — completed steps' block summaries (the chain index)
+- **`S3ChainStatePublishRunner`** — the mutable chain state (the head pointer), targeting the chain-state bucket
 
 ```text
-/block/number/<n>.json            ← immutable
-/block/hash/<hash>.json           ← immutable, same content
-/blocks/step/<level>/<index>.json ← immutable, completed steps only
-/payload/<hash>.json              ← immutable
+/block/number/<n>.json            ← immutable (block runner)
+/block/hash/<hash>.json           ← immutable, same content (block runner)
+/blocks/step/<level>/<index>.json ← immutable, completed steps only (index runner)
+/payload/<hash>.json              ← immutable (block runner)
+/chain/head.json                  ← mutable, chain-state bucket (chain state runner)
 ```
 
-The mutable chain state (the head pointer, `/chain/head.json`) is **not** written by this publisher — it lives in a separate chain-state bucket and is written by the chain's finalizer (the `FinalizerActor` in xyo-chain) after the finalized files for that head exist, so readers never see a head that references missing files.
-
-Bodies are pre-compressed at write time (brotli by default, gzip or none configurable) and stored with the matching `Content-Encoding` plus `application/json`, so HTTP clients decompress transparently — keys keep their `.json` extension. Everything written gets `Cache-Control: public, max-age=31536000, immutable`.
+Bodies are pre-compressed at write time (brotli by default, gzip or none configurable) and stored with the matching `Content-Encoding` plus `application/json`, so HTTP clients decompress transparently — keys keep their `.json` extension. Finalized files get `Cache-Control: public, max-age=31536000, immutable`; the head pointer gets `must-revalidate`.
 
 ```ts
 import { S3Client } from '@aws-sdk/client-s3'
-import { RestBlockPublisher } from '@xyo-network/xl1-rest-block-publisher'
+import {
+  S3BlockPublishRunner, S3ChainStatePublishRunner, S3IndexPublishRunner,
+} from '@xyo-network/xl1-rest-block-publisher'
 
 const client = new S3Client({
   region: 'auto',
@@ -32,11 +37,18 @@ const client = new S3Client({
   credentials: { accessKeyId, secretAccessKey },
 })
 
-const publisher = await RestBlockPublisher.create({ bucket: 'chain', client, source: blockViewer })
-const range = await publisher.sync(from) // publishes [from, sourceHead]; null when up to date
+const blocks = await S3BlockPublishRunner.create({ bucket: 'finalized', client, context, source })
+const index = await S3IndexPublishRunner.create({ bucket: 'finalized', client, context, source })
+const chainState = await S3ChainStatePublishRunner.create({ bucket: 'chain-state', client, context, source })
+
+const range = await blocks.sync(from) // publishes [from, sourceHead]; null when up to date
+if (range) {
+  for (let n = range[0]; n <= range[1]; n++) await index.publishStepsCompletedBy(n)
+  await chainState.publishHead() // last, so readers never see a head referencing missing files
+}
 ```
 
-`sync(from)` resumes from a caller-supplied cursor — typically the block after the last published head pointer, which the finalizer owns. Omitting `from` republishes from genesis, which is safe (idempotent — deterministic keys, immutable content) but slow, so re-running after a crash is always safe. The path builders come from [`@xyo-network/xl1-rest-block-viewer`](https://www.npmjs.com/package/@xyo-network/xl1-rest-block-viewer), so reader and writer share one layout contract.
+`sync(from)` resumes from a caller-supplied cursor — typically the block after the last published head pointer. Omitting `from` republishes from genesis, which is safe (idempotent — deterministic keys, immutable content) but slow, so re-running after a crash is always safe. The path builders come from [`@xyo-network/xl1-rest-block-viewer`](https://www.npmjs.com/package/@xyo-network/xl1-rest-block-viewer), so readers and writers share one layout contract.
 
 ## Install
 
@@ -68,7 +80,10 @@ bun add @xyo-network/xl1-rest-block-publisher
 
 ## What's Inside
 
-- **`RestBlockPublisher`** — `sync(from)` (cursor-resumed publish), `publishBlock`, `publishStep`/`publishStepsCompletedBy` (completed steps only).
+- **`S3BlockPublishRunner`** — `sync(from)` (cursor-resumed publish) and `publishBlock`; implements `BlockPublishRunner`.
+- **`S3IndexPublishRunner`** — `publishStep`/`publishStepsCompletedBy` (completed steps only); implements `IndexPublishRunner`.
+- **`S3ChainStatePublishRunner`** — `publishHead` with must-revalidate caching; implements `ChainStatePublishRunner`.
+- **`AbstractS3PublishRunner`** — shared S3 target params (bucket, client, prefix, encoding) for custom runners.
 - **`encodeBody`/`decodeBody`** — brotli/gzip/none body codecs used for storage and read-back.
 
 ## Building Locally

package/dist/node/AbstractS3Provider.d.ts

@@ -0,0 +1,34 @@
+import type { S3Client } from '@aws-sdk/client-s3';
+import type { CreatableProviderEventData, CreatableProviderParams } from '@xyo-network/xl1-protocol-sdk';
+import { AbstractCreatableProvider } from '@xyo-network/xl1-protocol-sdk';
+import type { RestContentEncoding } from './encoding.ts';
+/** Shared parameters for S3-backed providers: where and how files are stored. */
+export interface S3ProviderParams extends CreatableProviderParams {
+    bucket: string;
+    /** S3-compatible client pointed at the target endpoint (e.g. Cloudflare R2). */
+    client: S3Client;
+    /** Storage/wire encoding for published files. Defaults to 'br' (brotli). */
+    contentEncoding?: RestContentEncoding;
+    /** Optional key prefix, allowing the layout to live in a shared bucket. */
+    prefix?: string;
+}
+/** 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";
+/**
+ * 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
+ * decompress transparently — keys keep their `.json` extension. Reads decode the stored
+ * Content-Encoding back to JSON.
+ */
+export declare abstract class AbstractS3Provider<TParams extends S3ProviderParams = S3ProviderParams, TEventData extends CreatableProviderEventData = CreatableProviderEventData> extends AbstractCreatableProvider<TParams, TEventData> {
+    get bucket(): string;
+    get client(): S3Client;
+    get contentEncoding(): RestContentEncoding;
+    get prefix(): string;
+    /** Reads and decodes a stored JSON file, or undefined when the key does not exist. */
+    protected getJson(path: string): Promise<unknown>;
+    protected putJson(path: string, json: string, cacheControl: string): Promise<void>;
+}
+//# sourceMappingURL=AbstractS3Provider.d.ts.map

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

@@ -0,0 +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"}

package/dist/node/S3BlockPublishRunner.d.ts

@@ -0,0 +1,55 @@
+import type { BlockPublishRunner, BlockViewer, SignedHydratedBlockWithHashMeta, XL1BlockNumber, XL1BlockRange } from '@xyo-network/xl1-protocol-lib';
+import type { S3ProviderParams } from './AbstractS3Provider.ts';
+import { AbstractS3Provider } from './AbstractS3Provider.ts';
+/** A progress event emitted while publishing blocks. */
+export interface BlockPublishProgress {
+    blockNumber: XL1BlockNumber;
+    published: number;
+    total: number;
+}
+/** Parameters for S3BlockPublishRunner. */
+export interface S3BlockPublishRunnerParams extends S3ProviderParams {
+    /** Maximum concurrent block publishes during sync. */
+    concurrency?: number;
+    /**
+     * Called every `progressInterval` blocks (and at pass completion). When omitted, the same
+     * events are logged via the params logger so long backfills are observable out of the box.
+     */
+    onProgress?: (event: BlockPublishProgress) => void;
+    /** How many block publishes between progress reports during sync. */
+    progressInterval?: number;
+    /**
+     * The viewer to publish from (only finalized chains should be published). When omitted,
+     * resolved from the locator via BlockViewerMoniker.
+     */
+    source?: BlockViewer;
+}
+/**
+ * Publishes finalized blocks (and their payloads) as the static REST file layout that
+ * `RestBlockViewer` reads (see `paths.ts` in @xyo-network/xl1-rest-block-viewer).
+ *
+ * Publishing is idempotent: keys are deterministic and contents immutable, so re-publishing
+ * any range is safe. `sync(from)` resumes from a caller-supplied cursor (typically the block
+ * after the last published head); omitting it republishes from genesis, which is safe.
+ */
+export declare class S3BlockPublishRunner extends AbstractS3Provider<S3BlockPublishRunnerParams> implements BlockPublishRunner {
+    static readonly defaultMoniker: "BlockPublishRunner";
+    static readonly dependencies: "BlockViewer"[];
+    static readonly monikers: "BlockPublishRunner"[];
+    moniker: "BlockPublishRunner";
+    protected _source?: BlockViewer;
+    get concurrency(): number;
+    get progressInterval(): number;
+    get source(): BlockViewer;
+    createHandler(): Promise<void>;
+    /** Publishes one block at its by-number and by-hash paths, plus its payload files. */
+    publishBlock(blockNumber: XL1BlockNumber): Promise<SignedHydratedBlockWithHashMeta | null>;
+    /**
+     * Publishes every block from `from` (inclusive, default genesis) through the source head.
+     * Returns the published range, or null when already up to date.
+     */
+    sync(from?: XL1BlockNumber): Promise<XL1BlockRange | null>;
+    /** Emits a progress event to the onProgress callback, or logs it when no callback is set. */
+    private report;
+}
+//# sourceMappingURL=S3BlockPublishRunner.d.ts.map

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

@@ -0,0 +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"}

package/dist/node/S3ChainStatePublishRunner.d.ts

@@ -0,0 +1,31 @@
+import type { ChainStatePublishRunner, ChainStateViewerMethods, SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol-lib';
+import type { S3ProviderParams } from './AbstractS3Provider.ts';
+import { AbstractS3Provider } from './AbstractS3Provider.ts';
+/** Parameters for S3ChainStatePublishRunner. */
+export interface S3ChainStatePublishRunnerParams extends S3ProviderParams {
+    /**
+     * Where the current head is read from (any BlockViewer satisfies this). When omitted,
+     * resolved from the locator via BlockViewerMoniker.
+     */
+    source?: ChainStateViewerMethods;
+}
+/**
+ * Publishes the mutable chain state — the head pointer (`chain/head.json`) — that
+ * `RestChainStateViewer` reads. This is the one mutable file in the REST layout, so it is
+ * stored with must-revalidate caching and should target the chain-state bucket.
+ *
+ * Callers must publish the finalized files for a head before publishing the head itself,
+ * so readers never see a head that references missing files.
+ */
+export declare class S3ChainStatePublishRunner extends AbstractS3Provider<S3ChainStatePublishRunnerParams> implements ChainStatePublishRunner {
+    static readonly defaultMoniker: "ChainStatePublishRunner";
+    static readonly dependencies: "BlockViewer"[];
+    static readonly monikers: "ChainStatePublishRunner"[];
+    moniker: "ChainStatePublishRunner";
+    protected _source?: ChainStateViewerMethods;
+    get source(): ChainStateViewerMethods;
+    createHandler(): Promise<void>;
+    /** Publishes the source's current head to the mutable chain state pointer. */
+    publishHead(): Promise<SignedHydratedBlockWithHashMeta>;
+}
+//# sourceMappingURL=S3ChainStatePublishRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"S3ChainStatePublishRunner.d.ts","sourceRoot":"","sources":["../../src/S3ChainStatePublishRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,uBAAuB,EAAE,uBAAuB,EAAE,+BAA+B,EAClF,MAAM,+BAA+B,CAAA;AAKtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAyB,MAAM,yBAAyB,CAAA;AAEnF,gDAAgD;AAChD,MAAM,WAAW,+BAAgC,SAAQ,gBAAgB;IACvE;;;OAGG;IACH,MAAM,CAAC,EAAE,uBAAuB,CAAA;CACjC;AAED;;;;;;;GAOG;AACH,qBACa,yBAA0B,SAAQ,kBAAkB,CAAC,+BAA+B,CAAE,YAAW,uBAAuB;IACnI,MAAM,CAAC,QAAQ,CAAC,cAAc,4BAAiC;IAC/D,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAuB;IACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,8BAAmC;IAC3D,OAAO,4BAA2C;IAElD,SAAS,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAA;IAE3C,IAAI,MAAM,IAAI,uBAAuB,CAEpC;IAEc,aAAa;IAK5B,8EAA8E;IACxE,WAAW,IAAI,OAAO,CAAC,+BAA+B,CAAC;CAM9D"}

package/dist/node/S3ChainStateViewer.d.ts

@@ -0,0 +1,26 @@
+import type { Hash } from '@xylabs/sdk-js';
+import type { ChainStateViewer, SignedHydratedBlockWithHashMeta, XL1BlockNumber } from '@xyo-network/xl1-protocol-lib';
+import type { S3ProviderParams } from './AbstractS3Provider.ts';
+import { AbstractS3Provider } from './AbstractS3Provider.ts';
+/** Parameters for S3ChainStateViewer. */
+export interface S3ChainStateViewerParams extends S3ProviderParams {
+}
+/**
+ * A ChainStateViewer over the chain-state bucket, reading the published head pointer back
+ * through the S3 API (authenticated, not the public HTTP layout — see RestChainStateViewer
+ * for anonymous reads). This is how publishers learn their resume cursor: the head pointer
+ * is only written after the finalized files it references exist.
+ */
+export declare class S3ChainStateViewer extends AbstractS3Provider<S3ChainStateViewerParams, ChainStateViewer['eventData']> implements ChainStateViewer {
+    static readonly defaultMoniker: "ChainStateViewer";
+    static readonly dependencies: never[];
+    static readonly monikers: "ChainStateViewer"[];
+    moniker: "ChainStateViewer";
+    /** The published head; throws when no head pointer has been published yet. */
+    currentBlock(): Promise<SignedHydratedBlockWithHashMeta>;
+    currentBlockHash(): Promise<Hash>;
+    currentBlockNumber(): Promise<XL1BlockNumber>;
+    /** The published head, or undefined when no head pointer has been published yet. */
+    tryCurrentBlock(): Promise<SignedHydratedBlockWithHashMeta | undefined>;
+}
+//# sourceMappingURL=S3ChainStateViewer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"S3ChainStateViewer.d.ts","sourceRoot":"","sources":["../../src/S3ChainStateViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,KAAK,EACV,gBAAgB,EAAE,+BAA+B,EAAE,cAAc,EAClE,MAAM,+BAA+B,CAAA;AAKtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAE5D,yCAAyC;AACzC,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;CAAG;AAErE;;;;;GAKG;AACH,qBACa,kBAAmB,SAAQ,kBAAkB,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAChH,YAAW,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,cAAc,qBAA0B;IACxD,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAK;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,uBAA4B;IACpD,OAAO,qBAAoC;IAE3C,8EAA8E;IACxE,YAAY,IAAI,OAAO,CAAC,+BAA+B,CAAC;IAOxD,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC;IAInD,oFAAoF;IAC9E,eAAe,IAAI,OAAO,CAAC,+BAA+B,GAAG,SAAS,CAAC;CAI9E"}

package/dist/node/S3IndexPublishRunner.d.ts

@@ -0,0 +1,33 @@
+import type { BlockViewer, IndexPublishRunner, 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,
+     * 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.
+ */
+export declare class S3IndexPublishRunner extends AbstractS3Provider<S3IndexPublishRunnerParams> implements IndexPublishRunner {
+    static readonly defaultMoniker: "IndexPublishRunner";
+    static readonly dependencies: "BlockViewer"[];
+    static readonly monikers: "IndexPublishRunner"[];
+    moniker: "IndexPublishRunner";
+    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>;
+}
+//# sourceMappingURL=S3IndexPublishRunner.d.ts.map

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

@@ -0,0 +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"}

package/dist/node/index.d.ts

@@ -1,3 +1,7 @@
+export * from './AbstractS3Provider.ts';
 export * from './encoding.ts';
-export * from './RestBlockPublisher.ts';
+export * from './S3BlockPublishRunner.ts';
+export * from './S3ChainStatePublishRunner.ts';
+export * from './S3ChainStateViewer.ts';
+export * from './S3IndexPublishRunner.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,2BAA2B,CAAA;AACzC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA"}

package/dist/node/index.mjs

@@ -1,5 +1,6 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -8,6 +9,12 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (kind && result) __defProp(target, key, result);
   return result;
 };
+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 { assertEx } from "@xylabs/sdk-js";
+import { AbstractCreatableProvider } from "@xyo-network/xl1-protocol-sdk";
 
 // src/encoding.ts
 import ZLIB from "node:zlib";
@@ -38,100 +45,97 @@ function decodeBody(body, contentEncoding) {
   }
 }
 
-// src/RestBlockPublisher.ts
-import { PutObjectCommand } from "@aws-sdk/client-s3";
-import {
-  AbstractCreatable,
-  assertEx,
-  creatable,
-  isNull
-} from "@xylabs/sdk-js";
-import { asXL1BlockNumber, StepSizes } from "@xyo-network/xl1-protocol-lib";
-import { blocksMaxStep, BlocksStepSummarySchema } from "@xyo-network/xl1-protocol-sdk";
-import {
-  blockHashPath,
-  blockNumberPath,
-  blocksStepPath,
-  payloadPath
-} from "@xyo-network/xl1-rest-block-viewer";
-import { Semaphore } from "async-mutex";
+// src/AbstractS3Provider.ts
 var IMMUTABLE_CACHE_CONTROL = "public, max-age=31536000, immutable";
-var RestBlockPublisher = class extends AbstractCreatable {
+var MUTABLE_CACHE_CONTROL = "public, max-age=0, must-revalidate";
+var AbstractS3Provider = class extends AbstractCreatableProvider {
   get bucket() {
     return assertEx(this.params.bucket, () => "No bucket specified");
   }
   get client() {
     return assertEx(this.params.client, () => "No client specified");
   }
-  get concurrency() {
-    return this.params.concurrency ?? 8;
-  }
   get contentEncoding() {
     return this.params.contentEncoding ?? "br";
   }
   get prefix() {
     return this.params.prefix ?? "";
   }
+  /** Reads and decodes a stored JSON file, or undefined when the key does not exist. */
+  async getJson(path) {
+    try {
+      const response = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: `${this.prefix}${path}` }));
+      const body = await response.Body?.transformToByteArray();
+      if (body === void 0) return void 0;
+      return JSON.parse(decodeBody(body, response.ContentEncoding));
+    } catch (error) {
+      if (isNotFoundError(error)) return void 0;
+      throw error;
+    }
+  }
+  async putJson(path, json, cacheControl) {
+    const { body, contentEncoding } = encodeBody(json, this.contentEncoding);
+    await this.client.send(new PutObjectCommand({
+      Bucket: this.bucket,
+      Key: `${this.prefix}${path}`,
+      Body: body,
+      CacheControl: cacheControl,
+      ContentEncoding: contentEncoding,
+      ContentType: "application/json"
+    }));
+  }
+};
+var isNotFoundError = (error) => {
+  if (typeof error !== "object" || error === null) return false;
+  const { name, $metadata } = error;
+  return name === "NoSuchKey" || name === "NotFound" || $metadata?.httpStatusCode === 404;
+};
+
+// src/S3BlockPublishRunner.ts
+import { assertEx as assertEx2, isNull } from "@xylabs/sdk-js";
+import {
+  asXL1BlockNumber,
+  BlockPublishRunnerMoniker,
+  BlockViewerMoniker
+} from "@xyo-network/xl1-protocol-lib";
+import { creatableProvider } from "@xyo-network/xl1-protocol-sdk";
+import {
+  blockHashPath,
+  blockNumberPath,
+  payloadPath
+} from "@xyo-network/xl1-rest-block-viewer";
+import { Semaphore } from "async-mutex";
+var S3BlockPublishRunner = class extends AbstractS3Provider {
+  moniker = S3BlockPublishRunner.defaultMoniker;
+  _source;
+  get concurrency() {
+    return this.params.concurrency ?? 8;
+  }
   get progressInterval() {
     return this.params.progressInterval ?? 100;
   }
   get source() {
-    return assertEx(this.params.source, () => "No source specified");
+    return assertEx2(this._source, () => "No source specified");
+  }
+  async createHandler() {
+    await super.createHandler();
+    this._source = this.params.source ?? await this.locator.getInstance(BlockViewerMoniker);
   }
   /** 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);
     if (isNull(block)) return null;
     const json = JSON.stringify(block);
-    await this.putJson(blockNumberPath(block[0].block), json);
-    await this.putJson(blockHashPath(block[0]._hash), json);
+    await this.putJson(blockNumberPath(block[0].block), json, IMMUTABLE_CACHE_CONTROL);
+    await this.putJson(blockHashPath(block[0]._hash), json, IMMUTABLE_CACHE_CONTROL);
     for (const payload of block[1]) {
-      await this.putJson(payloadPath(payload._hash), JSON.stringify(payload));
+      await this.putJson(payloadPath(payload._hash), JSON.stringify(payload), IMMUTABLE_CACHE_CONTROL);
     }
     return block;
   }
   /**
-   * 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];
-    assertEx(stepLevel <= blocksMaxStep, () => `publishStep does not support step levels above ${blocksMaxStep} (requested ${stepLevel})`);
-    const lastBlockNumber = (stepIndex + 1) * size - 1;
-    const headNumber = await this.source.currentBlockNumber();
-    assertEx(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: assertEx(blocks.at(-1), () => `No blocks for step ${stepLevel}/${stepIndex}`)[0]._hash,
-      stepSize: size,
-      blocks
-    };
-    await this.putJson(blocksStepPath(stepLevel, stepIndex), JSON.stringify(summary));
-    this.report({
-      stepIndex,
-      stepLevel,
-      type: "step"
-    });
-  }
-  /** Publishes every step (at every level) completed by the given block. */
-  async publishStepsCompletedBy(blockNumber) {
-    for (let stepLevel = 0; stepLevel <= blocksMaxStep; stepLevel++) {
-      const size = StepSizes[stepLevel];
-      if ((blockNumber + 1) % size === 0) {
-        await this.publishStep(stepLevel, (blockNumber + 1) / size - 1);
-      }
-    }
-  }
-  /**
-   * Publishes everything from `from` (inclusive, default genesis) to the source head
-   * (inclusive), then the completed steps in that range. Returns the published range, or
-   * null when already up to date.
-   *
-   * The caller supplies the resume cursor — typically the block after the last published
-   * head pointer, which is written by the finalizer rather than this publisher. Omitting
-   * `from` republishes from genesis, which is safe (idempotent) but slow.
+   * Publishes every block from `from` (inclusive, default genesis) through the source head.
+   * Returns the published range, or null when already up to date.
    */
   async sync(from = asXL1BlockNumber(0, true)) {
     const sourceHead = await this.source.currentBlock();
@@ -142,33 +146,18 @@ var RestBlockPublisher = class extends AbstractCreatable {
     const total = numbers.length;
     let publishedCount = 0;
     await Promise.all(numbers.map((blockNumber) => semaphore.runExclusive(async () => {
-      assertEx(await this.publishBlock(blockNumber), () => `Block not found in source [${blockNumber}]`);
+      assertEx2(await this.publishBlock(blockNumber), () => `Block not found in source [${blockNumber}]`);
       publishedCount += 1;
       if (publishedCount % this.progressInterval === 0 || publishedCount === total) {
         this.report({
           blockNumber,
           published: publishedCount,
-          total,
-          type: "block"
+          total
         });
       }
     })));
-    for (const blockNumber of numbers) {
-      await this.publishStepsCompletedBy(blockNumber);
-    }
     return [from, end];
   }
-  async putJson(path, json) {
-    const { body, contentEncoding } = encodeBody(json, this.contentEncoding);
-    await this.client.send(new PutObjectCommand({
-      Bucket: this.bucket,
-      Key: `${this.prefix}${path}`,
-      Body: body,
-      CacheControl: IMMUTABLE_CACHE_CONTROL,
-      ContentEncoding: contentEncoding,
-      ContentType: "application/json"
-    }));
-  }
   /** Emits a progress event to the onProgress callback, or logs it when no callback is set. */
   report(event) {
     const onProgress = this.params.onProgress;
@@ -176,23 +165,144 @@ var RestBlockPublisher = class extends AbstractCreatable {
       onProgress(event);
       return;
     }
-    switch (event.type) {
-      case "block": {
-        this.logger?.info(`RestBlockPublisher: published block ${event.blockNumber} (${event.published}/${event.total})`);
-        break;
-      }
-      case "step": {
-        this.logger?.info(`RestBlockPublisher: published step ${event.stepLevel}/${event.stepIndex}`);
-        break;
+    this.logger?.info(`S3BlockPublishRunner: published block ${event.blockNumber} (${event.published}/${event.total})`);
+  }
+};
+__publicField(S3BlockPublishRunner, "defaultMoniker", BlockPublishRunnerMoniker);
+__publicField(S3BlockPublishRunner, "dependencies", [BlockViewerMoniker]);
+__publicField(S3BlockPublishRunner, "monikers", [BlockPublishRunnerMoniker]);
+S3BlockPublishRunner = __decorateClass([
+  creatableProvider()
+], S3BlockPublishRunner);
+
+// src/S3ChainStatePublishRunner.ts
+import { assertEx as assertEx3 } from "@xylabs/sdk-js";
+import { BlockViewerMoniker as BlockViewerMoniker2, ChainStatePublishRunnerMoniker } from "@xyo-network/xl1-protocol-lib";
+import { creatableProvider as creatableProvider2 } from "@xyo-network/xl1-protocol-sdk";
+import { headPath } from "@xyo-network/xl1-rest-block-viewer";
+var S3ChainStatePublishRunner = class extends AbstractS3Provider {
+  moniker = S3ChainStatePublishRunner.defaultMoniker;
+  _source;
+  get source() {
+    return assertEx3(this._source, () => "No source specified");
+  }
+  async createHandler() {
+    await super.createHandler();
+    this._source = this.params.source ?? await this.locator.getInstance(BlockViewerMoniker2);
+  }
+  /** Publishes the source's current head to the mutable chain state pointer. */
+  async publishHead() {
+    const head = await this.source.currentBlock();
+    await this.putJson(headPath(), JSON.stringify(head), MUTABLE_CACHE_CONTROL);
+    this.logger?.info(`S3ChainStatePublishRunner: published head ${head[0].block}`);
+    return head;
+  }
+};
+__publicField(S3ChainStatePublishRunner, "defaultMoniker", ChainStatePublishRunnerMoniker);
+__publicField(S3ChainStatePublishRunner, "dependencies", [BlockViewerMoniker2]);
+__publicField(S3ChainStatePublishRunner, "monikers", [ChainStatePublishRunnerMoniker]);
+S3ChainStatePublishRunner = __decorateClass([
+  creatableProvider2()
+], S3ChainStatePublishRunner);
+
+// src/S3ChainStateViewer.ts
+import { assertEx as assertEx4 } from "@xylabs/sdk-js";
+import { asSignedHydratedBlockWithHashMeta, ChainStateViewerMoniker } from "@xyo-network/xl1-protocol-lib";
+import { creatableProvider as creatableProvider3 } from "@xyo-network/xl1-protocol-sdk";
+import { headPath as headPath2 } from "@xyo-network/xl1-rest-block-viewer";
+var S3ChainStateViewer = class extends AbstractS3Provider {
+  moniker = S3ChainStateViewer.defaultMoniker;
+  /** The published head; throws when no head pointer has been published yet. */
+  async currentBlock() {
+    return await this.spanAsync("currentBlock", async () => {
+      const parsed = assertEx4(await this.getJson(headPath2()), () => "Head not found");
+      return asSignedHydratedBlockWithHashMeta(parsed, true);
+    }, this.context);
+  }
+  async currentBlockHash() {
+    return (await this.currentBlock())[0]._hash;
+  }
+  async currentBlockNumber() {
+    return (await this.currentBlock())[0].block;
+  }
+  /** The published head, or undefined when no head pointer has been published yet. */
+  async tryCurrentBlock() {
+    const parsed = await this.getJson(headPath2());
+    return parsed === void 0 ? void 0 : asSignedHydratedBlockWithHashMeta(parsed, true);
+  }
+};
+__publicField(S3ChainStateViewer, "defaultMoniker", ChainStateViewerMoniker);
+__publicField(S3ChainStateViewer, "dependencies", []);
+__publicField(S3ChainStateViewer, "monikers", [ChainStateViewerMoniker]);
+S3ChainStateViewer = __decorateClass([
+  creatableProvider3()
+], S3ChainStateViewer);
+
+// src/S3IndexPublishRunner.ts
+import { assertEx as assertEx5 } from "@xylabs/sdk-js";
+import {
+  BlocksStepSummarySchema,
+  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";
+var S3IndexPublishRunner = class extends AbstractS3Provider {
+  moniker = S3IndexPublishRunner.defaultMoniker;
+  _source;
+  get source() {
+    return assertEx5(this._source, () => "No source specified");
+  }
+  async createHandler() {
+    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
+    };
+    await this.putJson(blocksStepPath(stepLevel, stepIndex), JSON.stringify(summary), IMMUTABLE_CACHE_CONTROL);
+    this.logger?.info(`S3IndexPublishRunner: published step ${stepLevel}/${stepIndex}`);
+  }
+  /** Publishes every step (at every level) completed by the given block. */
+  async publishStepsCompletedBy(blockNumber) {
+    for (let stepLevel = 0; stepLevel <= blocksMaxStep; stepLevel++) {
+      const size = StepSizes[stepLevel];
+      if ((blockNumber + 1) % size === 0) {
+        await this.publishStep(stepLevel, (blockNumber + 1) / size - 1);
       }
     }
   }
 };
-RestBlockPublisher = __decorateClass([
-  creatable()
-], RestBlockPublisher);
+__publicField(S3IndexPublishRunner, "defaultMoniker", IndexPublishRunnerMoniker);
+__publicField(S3IndexPublishRunner, "dependencies", [BlockViewerMoniker3]);
+__publicField(S3IndexPublishRunner, "monikers", [IndexPublishRunnerMoniker]);
+S3IndexPublishRunner = __decorateClass([
+  creatableProvider4()
+], S3IndexPublishRunner);
 export {
-  RestBlockPublisher,
+  AbstractS3Provider,
+  IMMUTABLE_CACHE_CONTROL,
+  MUTABLE_CACHE_CONTROL,
+  S3BlockPublishRunner,
+  S3ChainStatePublishRunner,
+  S3ChainStateViewer,
+  S3IndexPublishRunner,
   decodeBody,
   encodeBody
 };

package/dist/node/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/encoding.ts", "../../src/RestBlockPublisher.ts"],
-  "sourcesContent": ["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 type { S3Client } from '@aws-sdk/client-s3'\nimport { PutObjectCommand } from '@aws-sdk/client-s3'\nimport type { CreatableParams } from '@xylabs/sdk-js'\nimport {\n  AbstractCreatable, assertEx, creatable, isNull,\n} from '@xylabs/sdk-js'\nimport type {\n  BlockViewer, SignedHydratedBlockWithHashMeta, XL1BlockNumber, XL1BlockRange,\n} from '@xyo-network/xl1-protocol-lib'\nimport { asXL1BlockNumber, StepSizes } from '@xyo-network/xl1-protocol-lib'\nimport type { BlocksStepSummary } from '@xyo-network/xl1-protocol-sdk'\nimport { blocksMaxStep, BlocksStepSummarySchema } from '@xyo-network/xl1-protocol-sdk'\nimport {\n  blockHashPath, blockNumberPath, blocksStepPath, payloadPath,\n} from '@xyo-network/xl1-rest-block-viewer'\nimport { Semaphore } from 'async-mutex'\n\nimport type { RestContentEncoding } from './encoding.ts'\nimport { encodeBody } from './encoding.ts'\n\n/** A progress event emitted while publishing. */\nexport type RestPublishEvent\n  = | { blockNumber: XL1BlockNumber; published: number; total: number; type: 'block' }\n    | { stepIndex: number; stepLevel: number; type: 'step' }\n\n/** Parameters for RestBlockPublisher. */\nexport interface RestBlockPublisherParams extends CreatableParams {\n  bucket: string\n  /** S3-compatible client pointed at the target endpoint (e.g. Cloudflare R2). */\n  client: S3Client\n  /** Maximum concurrent block publishes during sync. */\n  concurrency?: number\n  /** Storage/wire encoding for published files. Defaults to 'br' (brotli). */\n  contentEncoding?: RestContentEncoding\n  /**\n   * Called as publishing progresses: every `progressInterval` blocks (and at pass completion)\n   * and per step file. When omitted, the same events are logged via the params logger so\n   * long backfills are observable out of the box.\n   */\n  onProgress?: (event: RestPublishEvent) => void\n  /** Optional key prefix, allowing the layout to live in a shared bucket. */\n  prefix?: string\n  /** How many block publishes between progress reports during sync. */\n  progressInterval?: number\n  /** The viewer to publish from (only finalized chains should be published). */\n  source: BlockViewer\n}\n\n/** Everything this publisher writes is immutable once written. */\nconst IMMUTABLE_CACHE_CONTROL = 'public, max-age=31536000, immutable'\n\n/**\n * Publishes a chain's immutable files as the static REST file layout that `RestBlockViewer`\n * reads (see `paths.ts` in @xyo-network/xl1-rest-block-viewer).\n *\n * The mutable chain state (the head pointer, `chain/head.json`) is NOT written here \u2014 it\n * lives in a separate chain-state bucket and is written by the chain's finalizer after the\n * finalized files for that head exist, so readers never see a head that references missing\n * files.\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@creatable()\nexport class RestBlockPublisher extends AbstractCreatable<RestBlockPublisherParams> {\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 concurrency(): number {\n    return this.params.concurrency ?? 8\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  get progressInterval(): number {\n    return this.params.progressInterval ?? 100\n  }\n\n  get source(): BlockViewer {\n    return assertEx(this.params.source, () => 'No source specified')\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)\n    await this.putJson(blockHashPath(block[0]._hash), json)\n    for (const payload of block[1]) {\n      await this.putJson(payloadPath(payload._hash), JSON.stringify(payload))\n    }\n    return block\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))\n    this.report({\n      stepIndex, stepLevel, type: 'step',\n    })\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  /**\n   * Publishes everything from `from` (inclusive, default genesis) to the source head\n   * (inclusive), then the completed steps in that range. Returns the published range, or\n   * null when already up to date.\n   *\n   * The caller supplies the resume cursor \u2014 typically the block after the last published\n   * head pointer, which is written by the finalizer rather than this publisher. Omitting\n   * `from` republishes from genesis, which is safe (idempotent) but slow.\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, type: 'block',\n        })\n      }\n    })))\n    for (const blockNumber of numbers) {\n      await this.publishStepsCompletedBy(blockNumber)\n    }\n    return [from, end]\n  }\n\n  private async putJson(path: string, json: 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: IMMUTABLE_CACHE_CONTROL,\n      ContentEncoding: contentEncoding,\n      ContentType: 'application/json',\n    }))\n  }\n\n  /** Emits a progress event to the onProgress callback, or logs it when no callback is set. */\n  private report(event: RestPublishEvent): void {\n    const onProgress = this.params.onProgress\n    if (onProgress) {\n      onProgress(event)\n      return\n    }\n    switch (event.type) {\n      case 'block': {\n        this.logger?.info(`RestBlockPublisher: published block ${event.blockNumber} (${event.published}/${event.total})`)\n        break\n      }\n      case 'step': {\n        this.logger?.info(`RestBlockPublisher: published step ${event.stepLevel}/${event.stepIndex}`)\n        break\n      }\n    }\n  }\n}\n"],
-  "mappings": "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",
-  "names": []
+  "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"]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-rest-block-publisher",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "description": "XYO Layer One static REST chain layout publisher",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -35,12 +35,12 @@
     "README.md"
   ],
   "dependencies": {
-    "@xyo-network/xl1-protocol-lib": "~2.1.2",
-    "@xyo-network/xl1-protocol-sdk": "~2.1.2",
-    "@xyo-network/xl1-rest-block-viewer": "~2.1.2"
+    "@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"
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "^3.1065.0",
+    "@aws-sdk/client-s3": "^3.1066.0",
     "@bitauth/libauth": "~3.0.0",
     "@metamask/providers": "^22.1.1",
     "@noble/post-quantum": "~0.6.1",
@@ -48,18 +48,16 @@
     "@opentelemetry/sdk-trace-base": "^2.7.1",
     "@scure/base": "~2.2.0",
     "@scure/bip39": "~2.2.0",
-    "@xylabs/geo": "^6.1.0",
-    "@xylabs/sdk-js": "^6.1.0",
-    "@xylabs/threads": "~6.1",
+    "@xylabs/geo": "^6.1.1",
+    "@xylabs/sdk-js": "^6.1.1",
+    "@xylabs/threads": "^6.1.1",
     "@xylabs/toolchain": "~8.1.20",
     "@xylabs/tsconfig": "~8.1.20",
-    "@xyo-network/address": "^6.0.9",
-    "@xyo-network/sdk-js": "^6.0.4",
-    "@xyo-network/sdk-protocol-js": "~6.0.9",
+    "@xyo-network/address": "^6.1.0",
+    "@xyo-network/sdk-js": "^6.1.0",
+    "@xyo-network/sdk-protocol-js": "~6.1",
     "ajv": "^8.20.0",
     "async-mutex": "^0.5.0",
-    "bn.js": "^5.2.3",
-    "buffer": "^6.0.3",
     "cosmiconfig": "^9.0.2",
     "debug": "~4.4.3",
     "eslint": "^10.4.1",
@@ -88,11 +86,9 @@
     "@xylabs/threads": "^6.1",
     "@xyo-network/address": "^6.0",
     "@xyo-network/sdk-js": "^6.0",
-    "@xyo-network/sdk-protocol-js": "~6.0",
+    "@xyo-network/sdk-protocol-js": "~6.1",
     "ajv": "^8.20",
     "async-mutex": "^0.5",
-    "bn.js": "^5.2",
-    "buffer": "^6.0",
     "cosmiconfig": "^9.0",
     "debug": "~4.4",
     "ethers": "^6.16",

package/dist/node/RestBlockPublisher.d.ts

@@ -1,83 +0,0 @@
-import type { S3Client } from '@aws-sdk/client-s3';
-import type { CreatableParams } from '@xylabs/sdk-js';
-import { AbstractCreatable } from '@xylabs/sdk-js';
-import type { BlockViewer, SignedHydratedBlockWithHashMeta, XL1BlockNumber, XL1BlockRange } from '@xyo-network/xl1-protocol-lib';
-import type { RestContentEncoding } from './encoding.ts';
-/** A progress event emitted while publishing. */
-export type RestPublishEvent = {
-    blockNumber: XL1BlockNumber;
-    published: number;
-    total: number;
-    type: 'block';
-} | {
-    stepIndex: number;
-    stepLevel: number;
-    type: 'step';
-};
-/** Parameters for RestBlockPublisher. */
-export interface RestBlockPublisherParams extends CreatableParams {
-    bucket: string;
-    /** S3-compatible client pointed at the target endpoint (e.g. Cloudflare R2). */
-    client: S3Client;
-    /** Maximum concurrent block publishes during sync. */
-    concurrency?: number;
-    /** Storage/wire encoding for published files. Defaults to 'br' (brotli). */
-    contentEncoding?: RestContentEncoding;
-    /**
-     * Called as publishing progresses: every `progressInterval` blocks (and at pass completion)
-     * and per step file. When omitted, the same events are logged via the params logger so
-     * long backfills are observable out of the box.
-     */
-    onProgress?: (event: RestPublishEvent) => void;
-    /** Optional key prefix, allowing the layout to live in a shared bucket. */
-    prefix?: string;
-    /** How many block publishes between progress reports during sync. */
-    progressInterval?: number;
-    /** The viewer to publish from (only finalized chains should be published). */
-    source: BlockViewer;
-}
-/**
- * Publishes a chain's immutable files as the static REST file layout that `RestBlockViewer`
- * reads (see `paths.ts` in @xyo-network/xl1-rest-block-viewer).
- *
- * The mutable chain state (the head pointer, `chain/head.json`) is NOT written here — it
- * lives in a separate chain-state bucket and is written by the chain's finalizer after the
- * finalized files for that head exist, so readers never see a head that references missing
- * files.
- *
- * Publishing is idempotent: keys are deterministic and contents immutable, so re-publishing
- * any range is safe. `sync(from)` resumes from a caller-supplied cursor (typically the block
- * after the last published head); omitting it republishes from genesis, which is safe.
- */
-export declare class RestBlockPublisher extends AbstractCreatable<RestBlockPublisherParams> {
-    get bucket(): string;
-    get client(): S3Client;
-    get concurrency(): number;
-    get contentEncoding(): RestContentEncoding;
-    get prefix(): string;
-    get progressInterval(): number;
-    get source(): BlockViewer;
-    /** Publishes one block at its by-number and by-hash paths, plus its payload files. */
-    publishBlock(blockNumber: XL1BlockNumber): Promise<SignedHydratedBlockWithHashMeta | null>;
-    /**
-     * 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>;
-    /**
-     * Publishes everything from `from` (inclusive, default genesis) to the source head
-     * (inclusive), then the completed steps in that range. Returns the published range, or
-     * null when already up to date.
-     *
-     * The caller supplies the resume cursor — typically the block after the last published
-     * head pointer, which is written by the finalizer rather than this publisher. Omitting
-     * `from` republishes from genesis, which is safe (idempotent) but slow.
-     */
-    sync(from?: XL1BlockNumber): Promise<XL1BlockRange | null>;
-    private putJson;
-    /** Emits a progress event to the onProgress callback, or logs it when no callback is set. */
-    private report;
-}
-//# sourceMappingURL=RestBlockPublisher.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"RestBlockPublisher.d.ts","sourceRoot":"","sources":["../../src/RestBlockPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EACL,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,WAAW,EAAE,+BAA+B,EAAE,cAAc,EAAE,aAAa,EAC5E,MAAM,+BAA+B,CAAA;AAStC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAGxD,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GACtB;IAAE,WAAW,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAChF;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5D,yCAAyC;AACzC,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,MAAM,EAAE,QAAQ,CAAA;IAChB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,mBAAmB,CAAA;IACrC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC9C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,8EAA8E;IAC9E,MAAM,EAAE,WAAW,CAAA;CACpB;AAKD;;;;;;;;;;;;GAYG;AACH,qBACa,kBAAmB,SAAQ,iBAAiB,CAAC,wBAAwB,CAAC;IACjF,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,QAAQ,CAErB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,eAAe,IAAI,mBAAmB,CAEzC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,sFAAsF;IAChF,YAAY,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAYhG;;;OAGG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBtE,0EAA0E;IACpE,uBAAuB,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IASzE;;;;;;;;OAQG;IACG,IAAI,CAAC,IAAI,GAAE,cAA0C,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;YAwB7E,OAAO;IAYrB,6FAA6F;IAC7F,OAAO,CAAC,MAAM;CAiBf"}