@xyo-network/xl1-rest-block-publisher 2.0.12

package/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -0,0 +1,120 @@
+[![logo][]](https://xyo.network)
+
+# @xyo-network/xl1-rest-block-publisher
+
+[![npm-badge][]][npm-link]
+[![license-badge][]][license-link]
+
+> Publishes a finalized XL1 chain as the static REST file layout that `RestBlockViewer` reads — pre-compressed, immutable, CDN-friendly.
+
+## 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 that layout from any source `BlockViewer`:
+
+```text
+/chain/head.json                  ← written last on every sync (must-revalidate)
+/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
+```
+
+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. Immutable 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'
+
+const client = new S3Client({
+  region: 'auto',
+  endpoint: `https://${accountId}.r2.cloudflarestorage.com`,
+  credentials: { accessKeyId, secretAccessKey },
+})
+
+const publisher = await RestBlockPublisher.create({ bucket: 'chain', client, source: blockViewer })
+const range = await publisher.sync() // publishes everything new, head last; null when up to date
+```
+
+`sync()` resumes from the published head pointer, so the same call serves both initial backfill and incremental tailing. Publishing is idempotent — deterministic keys, immutable content — 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.
+
+## Install
+
+Using npm:
+
+```sh
+npm i --save @xyo-network/xl1-rest-block-publisher
+```
+
+Using yarn:
+
+```sh
+yarn add @xyo-network/xl1-rest-block-publisher
+```
+
+Using pnpm:
+
+```sh
+pnpm add @xyo-network/xl1-rest-block-publisher
+```
+
+Using bun:
+
+```sh
+bun add @xyo-network/xl1-rest-block-publisher
+```
+
+> Node-only (uses `node:zlib`). Bring your own `@aws-sdk/client-s3` client.
+
+## What's Inside
+
+- **`RestBlockPublisher`** — `sync()` (cursor-resumed publish, head written last), `publishBlock`, `publishStep`/`publishStepsCompletedBy` (completed steps only), `publishHead`, `publishedHead`.
+- **`encodeBody`/`decodeBody`** — brotli/gzip/none body codecs used for storage and read-back.
+
+## Building Locally
+
+```sh
+xy build @xyo-network/xl1-rest-block-publisher
+xy test @xyo-network/xl1-rest-block-publisher
+xy lint @xyo-network/xl1-rest-block-publisher
+```
+
+## Maintainers
+
+<table>
+  <tr>
+    <td align="center" valign="top" width="120">
+      <a href="https://github.com/arietrouw">
+        <img src="https://github.com/arietrouw.png" width="80" height="80" alt="Arie Trouw" /><br />
+        <sub><b>Arie Trouw</b></sub>
+      </a>
+      <br />
+      <a href="https://arietrouw.com">arietrouw.com</a>
+    </td>
+    <td align="center" valign="top" width="120">
+      <a href="https://github.com/jonesmac">
+        <img src="https://github.com/jonesmac.png" width="80" height="80" alt="Matt Jones" /><br />
+        <sub><b>Matt Jones</b></sub>
+      </a>
+    </td>
+    <td align="center" valign="top" width="120">
+      <a href="https://github.com/JoelBCarter">
+        <img src="https://github.com/JoelBCarter.png" width="80" height="80" alt="Joel Carter" /><br />
+        <sub><b>Joel Carter</b></sub>
+      </a>
+    </td>
+  </tr>
+</table>
+
+## License
+
+See the [LICENSE](./LICENSE) file (LGPL-3.0-only).
+
+## Credits
+
+[Made with 🔥 and ❄️ by XYO Foundation](https://xyo.network)
+
+[npm-badge]: https://img.shields.io/npm/v/@xyo-network/xl1-rest-block-publisher.svg
+[npm-link]: https://www.npmjs.com/package/@xyo-network/xl1-rest-block-publisher
+[license-badge]: https://img.shields.io/npm/l/@xyo-network/xl1-rest-block-publisher.svg
+[license-link]: ./LICENSE
+[logo]: https://cdn.xy.company/img/brand/XYO_full_colored.png

package/dist/node/RestBlockPublisher.d.ts

@@ -0,0 +1,56 @@
+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';
+/** 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;
+    /** Optional key prefix, allowing the layout to live in a shared bucket. */
+    prefix?: string;
+    /** The viewer to publish from (only finalized chains should be published). */
+    source: BlockViewer;
+}
+/**
+ * Publishes a chain 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()` writes the head pointer last — readers never see a head that
+ * references files that do not exist yet — and uses the published head as its resume cursor.
+ */
+export declare class RestBlockPublisher extends AbstractCreatable<RestBlockPublisherParams> {
+    get bucket(): string;
+    get client(): S3Client;
+    get concurrency(): number;
+    get contentEncoding(): RestContentEncoding;
+    get prefix(): string;
+    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 the current source head to the mutable head pointer. */
+    publishHead(): Promise<SignedHydratedBlockWithHashMeta>;
+    /**
+     * 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>;
+    /** Reads the published head pointer back from the bucket, or undefined if absent. */
+    publishedHead(): Promise<SignedHydratedBlockWithHashMeta | undefined>;
+    /**
+     * Publishes everything from the published head (exclusive) to the source head (inclusive),
+     * then the completed steps in that range, then the head pointer last. Returns the published
+     * range, or null when already up to date.
+     */
+    sync(): Promise<XL1BlockRange | null>;
+    private putJson;
+}
+//# sourceMappingURL=RestBlockPublisher.d.ts.map

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

@@ -0,0 +1 @@
+{"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;AAWtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAGxD,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,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,MAAM,EAAE,WAAW,CAAA;CACpB;AAOD;;;;;;;GAOG;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,MAAM,IAAI,WAAW,CAExB;IAED,sFAAsF;IAChF,YAAY,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAYhG,qEAAqE;IAC/D,WAAW,IAAI,OAAO,CAAC,+BAA+B,CAAC;IAM7D;;;OAGG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtE,0EAA0E;IACpE,uBAAuB,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IASzE,qFAAqF;IAC/E,aAAa,IAAI,OAAO,CAAC,+BAA+B,GAAG,SAAS,CAAC;IAa3E;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;YAmB7B,OAAO;CAWtB"}

package/dist/node/encoding.d.ts

@@ -0,0 +1,16 @@
+/** Wire/storage encoding for published files. */
+export type RestContentEncoding = 'br' | 'gzip' | 'none';
+/** An encoded file body plus the HTTP Content-Encoding it should be served with. */
+export interface EncodedBody {
+    body: Uint8Array;
+    contentEncoding?: 'br' | 'gzip';
+}
+/**
+ * Encodes a JSON string for storage. Bodies are pre-compressed at write time and stored
+ * with the matching Content-Encoding so HTTP clients decompress transparently — keys keep
+ * their .json extension and Content-Type stays application/json.
+ */
+export declare function encodeBody(json: string, encoding: RestContentEncoding): EncodedBody;
+/** Decodes a stored body back to its JSON string using the object's Content-Encoding. */
+export declare function decodeBody(body: Uint8Array, contentEncoding?: string): string;
+//# sourceMappingURL=encoding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/encoding.ts"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;AAExD,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAA;IAChB,eAAe,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAChC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,WAAW,CAYnF;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAY7E"}

package/dist/node/index.d.ts

@@ -0,0 +1,3 @@
+export * from './encoding.ts';
+export * from './RestBlockPublisher.ts';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/node/index.mjs

@@ -0,0 +1,191 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+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--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+
+// src/encoding.ts
+import ZLIB from "node:zlib";
+function encodeBody(json, encoding) {
+  switch (encoding) {
+    case "br": {
+      return { body: ZLIB.brotliCompressSync(json), contentEncoding: "br" };
+    }
+    case "gzip": {
+      return { body: ZLIB.gzipSync(json), contentEncoding: "gzip" };
+    }
+    case "none": {
+      return { body: new TextEncoder().encode(json) };
+    }
+  }
+}
+function decodeBody(body, contentEncoding) {
+  switch (contentEncoding) {
+    case "br": {
+      return ZLIB.brotliDecompressSync(body).toString("utf8");
+    }
+    case "gzip": {
+      return ZLIB.gunzipSync(body).toString("utf8");
+    }
+    default: {
+      return new TextDecoder().decode(body);
+    }
+  }
+}
+
+// src/RestBlockPublisher.ts
+import { GetObjectCommand, PutObjectCommand } from "@aws-sdk/client-s3";
+import {
+  AbstractCreatable,
+  assertEx,
+  creatable,
+  isNull
+} from "@xylabs/sdk-js";
+import {
+  asSignedHydratedBlockWithHashMeta,
+  asXL1BlockNumber,
+  StepSizes
+} from "@xyo-network/xl1-protocol-lib";
+import { blocksMaxStep, BlocksStepSummarySchema } from "@xyo-network/xl1-protocol-sdk";
+import {
+  blockHashPath,
+  blockNumberPath,
+  blocksStepPath,
+  headPath,
+  payloadPath
+} from "@xyo-network/xl1-rest-block-viewer";
+import { Semaphore } from "async-mutex";
+var IMMUTABLE_CACHE_CONTROL = "public, max-age=31536000, immutable";
+var HEAD_CACHE_CONTROL = "public, max-age=0, must-revalidate";
+var RestBlockPublisher = class extends AbstractCreatable {
+  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 ?? "";
+  }
+  get source() {
+    return assertEx(this.params.source, () => "No source specified");
+  }
+  /** 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, 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), IMMUTABLE_CACHE_CONTROL);
+    }
+    return block;
+  }
+  /** Publishes the current source head to the mutable head pointer. */
+  async publishHead() {
+    const head = await this.source.currentBlock();
+    await this.putJson(headPath(), JSON.stringify(head), HEAD_CACHE_CONTROL);
+    return head;
+  }
+  /**
+   * 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), IMMUTABLE_CACHE_CONTROL);
+  }
+  /** 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);
+      }
+    }
+  }
+  /** Reads the published head pointer back from the bucket, or undefined if absent. */
+  async publishedHead() {
+    try {
+      const response = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: `${this.prefix}${headPath()}` }));
+      const body = await response.Body?.transformToByteArray();
+      if (body === void 0) return void 0;
+      const parsed = JSON.parse(decodeBody(body, response.ContentEncoding));
+      return asSignedHydratedBlockWithHashMeta(parsed, true);
+    } catch (error) {
+      if (isNotFoundError(error)) return void 0;
+      throw error;
+    }
+  }
+  /**
+   * Publishes everything from the published head (exclusive) to the source head (inclusive),
+   * then the completed steps in that range, then the head pointer last. Returns the published
+   * range, or null when already up to date.
+   */
+  async sync() {
+    const sourceHead = await this.source.currentBlock();
+    const published = await this.publishedHead();
+    const start = published === void 0 ? 0 : published[0].block + 1;
+    const end = sourceHead[0].block;
+    if (start > end) return null;
+    const semaphore = new Semaphore(this.concurrency);
+    const numbers = Array.from({ length: end - start + 1 }, (_, i) => asXL1BlockNumber(start + i, true));
+    await Promise.all(numbers.map((blockNumber) => semaphore.runExclusive(async () => {
+      assertEx(await this.publishBlock(blockNumber), () => `Block not found in source [${blockNumber}]`);
+    })));
+    for (const blockNumber of numbers) {
+      await this.publishStepsCompletedBy(blockNumber);
+    }
+    await this.publishHead();
+    return [asXL1BlockNumber(start, true), end];
+  }
+  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"
+    }));
+  }
+};
+RestBlockPublisher = __decorateClass([
+  creatable()
+], RestBlockPublisher);
+var isNotFoundError = (error) => {
+  if (typeof error !== "object" || error === null) return false;
+  const { name, $metadata } = error;
+  return name === "NoSuchKey" || name === "NotFound" || $metadata?.httpStatusCode === 404;
+};
+export {
+  RestBlockPublisher,
+  decodeBody,
+  encodeBody
+};
+//# sourceMappingURL=index.mjs.map

package/dist/node/index.mjs.map

@@ -0,0 +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 { GetObjectCommand, 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 {\n  asSignedHydratedBlockWithHashMeta, asXL1BlockNumber, StepSizes,\n} 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, headPath, payloadPath,\n} from '@xyo-network/xl1-rest-block-viewer'\nimport { Semaphore } from 'async-mutex'\n\nimport type { RestContentEncoding } from './encoding.ts'\nimport { decodeBody, encodeBody } from './encoding.ts'\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  /** Optional key prefix, allowing the layout to live in a shared bucket. */\n  prefix?: string\n  /** The viewer to publish from (only finalized chains should be published). */\n  source: BlockViewer\n}\n\n/** Everything except the head pointer is immutable once written. */\nconst IMMUTABLE_CACHE_CONTROL = 'public, max-age=31536000, immutable'\n/** The head pointer is rewritten as the chain advances. */\nconst HEAD_CACHE_CONTROL = 'public, max-age=0, must-revalidate'\n\n/**\n * Publishes a chain as the static REST file layout that `RestBlockViewer` reads\n * (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()` writes the head pointer last \u2014 readers never see a head that\n * references files that do not exist yet \u2014 and uses the published head as its resume cursor.\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 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, 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 current source head to the mutable head pointer. */\n  async publishHead(): Promise<SignedHydratedBlockWithHashMeta> {\n    const head = await this.source.currentBlock()\n    await this.putJson(headPath(), JSON.stringify(head), HEAD_CACHE_CONTROL)\n    return head\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  }\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  /** Reads the published head pointer back from the bucket, or undefined if absent. */\n  async publishedHead(): Promise<SignedHydratedBlockWithHashMeta | undefined> {\n    try {\n      const response = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: `${this.prefix}${headPath()}` }))\n      const body = await response.Body?.transformToByteArray()\n      if (body === undefined) return undefined\n      const parsed: unknown = JSON.parse(decodeBody(body, response.ContentEncoding))\n      return asSignedHydratedBlockWithHashMeta(parsed, true)\n    } catch (error) {\n      if (isNotFoundError(error)) return undefined\n      throw error\n    }\n  }\n\n  /**\n   * Publishes everything from the published head (exclusive) to the source head (inclusive),\n   * then the completed steps in that range, then the head pointer last. Returns the published\n   * range, or null when already up to date.\n   */\n  async sync(): Promise<XL1BlockRange | null> {\n    const sourceHead = await this.source.currentBlock()\n    const published = await this.publishedHead()\n    const start = published === undefined ? 0 : published[0].block + 1\n    const end = sourceHead[0].block\n    if (start > end) return null\n\n    const semaphore = new Semaphore(this.concurrency)\n    const numbers = Array.from({ length: end - start + 1 }, (_, i) => asXL1BlockNumber(start + i, true))\n    await Promise.all(numbers.map(blockNumber => semaphore.runExclusive(async () => {\n      assertEx(await this.publishBlock(blockNumber), () => `Block not found in source [${blockNumber}]`)\n    })))\n    for (const blockNumber of numbers) {\n      await this.publishStepsCompletedBy(blockNumber)\n    }\n    await this.publishHead()\n    return [asXL1BlockNumber(start, true), end]\n  }\n\n  private 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"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -0,0 +1,113 @@
+{
+  "$schema": "http://json.schemastore.org/package.json",
+  "name": "@xyo-network/xl1-rest-block-publisher",
+  "version": "2.0.12",
+  "description": "XYO Layer One static REST chain layout publisher",
+  "homepage": "https://xylabs.com",
+  "bugs": {
+    "url": "https://github.com/XYOracleNetwork/xl1-protocol/issues",
+    "email": "support@xylabs.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XYOracleNetwork/xl1-protocol.git"
+  },
+  "license": "LGPL-3.0-only",
+  "author": {
+    "name": "XY Labs Development Team",
+    "email": "support@xylabs.com",
+    "url": "https://xylabs.com"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/node/index.d.ts",
+      "default": "./dist/node/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!**/*.bench.*",
+    "!**/*.spec.*",
+    "!**/*.test.*",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xyo-network/xl1-protocol-sdk": "~2.0.12",
+    "@xyo-network/xl1-protocol-lib": "~2.0.12",
+    "@xyo-network/xl1-rest-block-viewer": "~2.0.12"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-s3": "^3.700.0",
+    "@bitauth/libauth": "~3.0",
+    "@metamask/providers": "^22.1",
+    "@noble/post-quantum": "~0.6.1",
+    "@opentelemetry/api": "^1.9",
+    "@opentelemetry/sdk-trace-base": "^2.7",
+    "@scure/base": "~2.2",
+    "@scure/bip39": "~2.2",
+    "@xylabs/geo": "^6.0",
+    "@xylabs/sdk-js": "^6.0.10",
+    "@xylabs/threads": "~6.0",
+    "@xylabs/toolchain": "~8.1.19",
+    "@xylabs/tsconfig": "~8.1.19",
+    "@xyo-network/address": "^6.0",
+    "@xyo-network/sdk-js": "^6.0",
+    "@xyo-network/sdk-protocol-js": "~6.0",
+    "ajv": "^8.20",
+    "async-mutex": "^0.5.0",
+    "bn.js": "^5.2",
+    "buffer": "^6.0",
+    "cosmiconfig": "^9.0",
+    "debug": "~4.4",
+    "eslint": "^10.4.1",
+    "ethers": "^6.16",
+    "hash-wasm": "~4.12",
+    "idb": "^8.0",
+    "lru-cache": "^11.3",
+    "observable-fns": "~0.6",
+    "typescript": "~6.0.3",
+    "vite": "^6.0.0 || ^7.0.0 || ^8.0.0",
+    "vitest": "~4.1.8",
+    "webextension-polyfill": "^0.12",
+    "zod": "~4.4"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": "^3.700",
+    "@bitauth/libauth": "~3.0",
+    "@metamask/providers": "^22.1",
+    "@noble/post-quantum": "~0.6.1",
+    "@opentelemetry/api": "^1.9",
+    "@opentelemetry/sdk-trace-base": "^2.7",
+    "@scure/base": "~2.2",
+    "@scure/bip39": "~2.2",
+    "@xylabs/geo": "^6.0",
+    "@xylabs/sdk-js": "^6.0",
+    "@xylabs/threads": "~6.0",
+    "@xyo-network/address": "^6.0",
+    "@xyo-network/sdk-js": "^6.0",
+    "@xyo-network/sdk-protocol-js": "~6.0",
+    "ajv": "^8.20",
+    "async-mutex": "^0.5",
+    "bn.js": "^5.2",
+    "buffer": "^6.0",
+    "cosmiconfig": "^9.0",
+    "debug": "~4.4",
+    "ethers": "^6.16",
+    "hash-wasm": "~4.12",
+    "idb": "^8.0",
+    "lru-cache": "^11.3",
+    "observable-fns": "~0.6",
+    "webextension-polyfill": "^0.12",
+    "zod": "~4.4"
+  },
+  "engines": {
+    "node": ">=22.3"
+  },
+  "engineStrict": true,
+  "publishConfig": {
+    "access": "public"
+  }
+}