@saga-sync/client 0.0.0 → 0.1.2

package/dist/cli.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { Client } from "./client.js";
+type Range = {
+    fromBlock?: bigint;
+    toBlock?: bigint;
+};
+export declare function cmdProtocols(client: Client, opts: {
+    json: boolean;
+}): Promise<string>;
+export declare function cmdInfo(client: Client, id: string, opts: {
+    json: boolean;
+} & Range): Promise<string>;
+export declare function cmdHead(client: Client, id: string, opts: {
+    json: boolean;
+    sinceBlock?: bigint;
+}): Promise<{
+    text: string;
+    stale: boolean;
+}>;
+export declare function cmdChunks(client: Client, id: string, opts: {
+    json: boolean;
+    hot: boolean;
+} & Range): Promise<string>;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAyDrC,KAAK,KAAK,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAKtD,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B3F;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,GAC9B,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CA6B3C;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,GAC5C,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/dist/cli.js

@@ -0,0 +1,280 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { realpathSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { HttpStore } from "@saga-sync/core";
+import { DiskStore } from "@saga-sync/core/node";
+import { Client } from "./client.js";
+import { selectSealedChunks, selectHotHead } from "./manifest.js";
+import { humanBytes, table } from "./format.js";
+const DEFAULT_CONCURRENCY = 4;
+// Minimal 0x-hex of a non-negative bigint/number — replaces viem's numberToHex so
+// the client carries no viem dependency. Block numbers and sizes are non-negative.
+function numberToHex(value) {
+    return `0x${value.toString(16)}`;
+}
+const USAGE = `state-client — inspect + download a protocol's published state
+
+Usage:
+  state-client <command> <manifest-url> [<protocol-id>] [options]
+
+Commands:
+  protocols <manifest-url>                list every protocol + summary   (alias: ls)
+  info      <manifest-url> <protocol-id>  detailed summary for one protocol
+  head      <manifest-url> <protocol-id>  latest covered block / freshness (alias: latest)
+  chunks    <manifest-url> <protocol-id>  list this protocol's chunks
+  stream    <manifest-url> <protocol-id>  download + verify + emit NDJSON
+
+The manifest is read from <manifest-url>/index.json. The query commands
+(protocols/info/head/chunks) fetch only the manifest — no chunk downloads.
+
+Options:
+  --json                 machine-readable output instead of human tables
+  --from-block <hex>     info/chunks/stream: lower bound of the block range
+  --to-block <hex>       info/chunks/stream: upper bound (exclusive)
+  --since-block <hex>    head: exit 3 if no block beyond this is covered
+  --hot                  chunks: include the mutable hot head
+  --cache-dir <path>     stream: local cache of verified sealed chunks
+  --concurrency <n>      stream: parallel chunk fetches, default ${DEFAULT_CONCURRENCY}
+  --public-key <hex>     require + verify the manifest's Ed25519 signature
+  --help                 show this message
+
+Exit codes: 0 ok · 1 usage/fetch/not-found · 3 head --since-block found nothing newer
+`;
+function fail(msg) {
+    process.stderr.write(`state-client: ${msg}\n`);
+    process.exit(1);
+}
+function hexOrNull(b) {
+    return b === null ? null : numberToHex(b);
+}
+// Sum the compressed `size` of a chunk list plus an optional hot head.
+function sumSize(chunks, hot) {
+    let total = chunks.reduce((s, c) => s + BigInt(c.size), 0n);
+    if (hot)
+        total += BigInt(hot.size);
+    return total;
+}
+// --- command handlers: each fetches the manifest and returns rendered output,
+//     so they are unit-testable against an in-memory Store without a process. ---
+export async function cmdProtocols(client, opts) {
+    const manifest = await client.fetchManifest();
+    const rows = manifest.protocolIds().map((id) => {
+        const sealed = manifest.sealedChunks(id);
+        const hot = manifest.hotHead(id);
+        return {
+            protocolId: id,
+            sealedChunks: sealed.length,
+            fromBlock: hexOrNull(manifest.firstCoveredBlock(id)),
+            lastCoveredBlock: hexOrNull(manifest.lastCoveredBlock(id)),
+            hotHead: hot !== undefined,
+            totalSize: numberToHex(sumSize(sealed, hot)),
+        };
+    });
+    if (opts.json)
+        return JSON.stringify(rows, null, 2);
+    if (rows.length === 0)
+        return "(no protocols in manifest)";
+    return table(["PROTOCOL", "CHUNKS", "RANGE", "HOT", "SIZE"], rows.map((r) => [
+        r.protocolId,
+        String(r.sealedChunks),
+        `${r.fromBlock ?? "-"} → ${r.lastCoveredBlock ?? "-"}`,
+        r.hotHead ? "yes" : "no",
+        humanBytes(BigInt(r.totalSize)),
+    ]));
+}
+export async function cmdInfo(client, id, opts) {
+    const manifest = await client.fetchManifest();
+    if (!manifest.protocolIds().includes(id))
+        throw new Error(`unknown protocol "${id}"`);
+    const sealed = manifest.sealedChunks(id);
+    const hot = manifest.hotHead(id);
+    const range = { fromBlock: opts.fromBlock, toBlock: opts.toBlock };
+    const scopedSize = sumSize(selectSealedChunks(sealed, range), selectHotHead(hot, range));
+    const gaps = manifest.gaps(id);
+    const first = manifest.firstCoveredBlock(id);
+    const last = manifest.lastCoveredBlock(id);
+    if (opts.json) {
+        return JSON.stringify({
+            protocolId: id,
+            manifestVersion: manifest.version(),
+            updatedAt: manifest.updatedAt() ?? null,
+            fromBlock: hexOrNull(first),
+            lastCoveredBlock: hexOrNull(last),
+            sealedChunks: sealed.length,
+            hotHead: hot ? { fromBlock: hot.fromBlock, toBlock: hot.toBlock, size: hot.size } : null,
+            totalCompressedSize: numberToHex(scopedSize),
+            gaps,
+        }, null, 2);
+    }
+    const ranged = opts.fromBlock !== undefined || opts.toBlock !== undefined;
+    return [
+        `protocol:        ${id}`,
+        `manifest:        v${manifest.version()}${manifest.updatedAt() ? `, updated ${manifest.updatedAt()}` : ""}`,
+        `block range:     ${hexOrNull(first) ?? "-"} → ${hexOrNull(last) ?? "-"}`,
+        `sealed chunks:   ${sealed.length}`,
+        `hot head:        ${hot ? `${hot.fromBlock} → ${hot.toBlock} (${humanBytes(BigInt(hot.size))})` : "none"}`,
+        `download size:   ${humanBytes(scopedSize)}${ranged ? " (for requested range)" : ""}`,
+        `contiguity:      ${gaps.length === 0
+            ? "gapless"
+            : `${gaps.length} gap(s): ${gaps.map((g) => `[${g.from},${g.to})`).join(", ")}`}`,
+    ].join("\n");
+}
+export async function cmdHead(client, id, opts) {
+    const manifest = await client.fetchManifest();
+    if (!manifest.protocolIds().includes(id))
+        throw new Error(`unknown protocol "${id}"`);
+    const last = manifest.lastCoveredBlock(id);
+    const hot = manifest.hotHead(id);
+    const stale = opts.sinceBlock !== undefined && (last === null || last <= opts.sinceBlock);
+    if (opts.json) {
+        const text = JSON.stringify({
+            lastCoveredBlock: hexOrNull(last),
+            hotHead: hot ? { fromBlock: hot.fromBlock, toBlock: hot.toBlock } : null,
+        }, null, 2);
+        return { text, stale };
+    }
+    const lines = [`last covered block: ${hexOrNull(last) ?? "-"}`];
+    if (hot)
+        lines.push(`hot head:           ${hot.fromBlock} → ${hot.toBlock}`);
+    if (opts.sinceBlock !== undefined) {
+        lines.push(stale
+            ? `no new data since ${numberToHex(opts.sinceBlock)}`
+            : `new data beyond ${numberToHex(opts.sinceBlock)}`);
+    }
+    return { text: lines.join("\n"), stale };
+}
+export async function cmdChunks(client, id, opts) {
+    const manifest = await client.fetchManifest();
+    if (!manifest.protocolIds().includes(id))
+        throw new Error(`unknown protocol "${id}"`);
+    const range = { fromBlock: opts.fromBlock, toBlock: opts.toBlock };
+    const list = [...selectSealedChunks(manifest.sealedChunks(id), range)];
+    if (opts.hot) {
+        const h = selectHotHead(manifest.hotHead(id), range);
+        if (h)
+            list.push(h);
+    }
+    if (opts.json)
+        return JSON.stringify(list, null, 2);
+    if (list.length === 0)
+        return "(no chunks in range)";
+    return table(["RANGE", "SIZE", "FILE", "DIGEST"], list.map((c) => [
+        `[${c.fromBlock},${c.toBlock})`,
+        humanBytes(BigInt(c.size)),
+        c.file,
+        c.digest.data,
+    ]));
+}
+async function runStream(manifestUrl, id, opts) {
+    const source = new HttpStore(manifestUrl);
+    const cache = opts.cacheDir ? new DiskStore(opts.cacheDir) : undefined;
+    const client = new Client({
+        source,
+        cache,
+        concurrency: opts.concurrency,
+        publicKey: opts.publicKey,
+    });
+    let count = 0;
+    for await (const event of client.streamEvents(id, {
+        fromBlock: opts.fromBlock,
+        toBlock: opts.toBlock,
+    })) {
+        process.stdout.write(JSON.stringify(event) + "\n");
+        count++;
+    }
+    const range = opts.fromBlock !== undefined || opts.toBlock !== undefined
+        ? ` in [${opts.fromBlock !== undefined ? numberToHex(opts.fromBlock) : "*"},` +
+            `${opts.toBlock !== undefined ? numberToHex(opts.toBlock) : "*"})`
+        : "";
+    process.stderr.write(`state-client: ${count} event(s) for ${id}${range}` +
+        (opts.cacheDir ? ` (cache=${opts.cacheDir})` : "") +
+        `\n`);
+}
+async function main() {
+    const { values, positionals } = parseArgs({
+        allowPositionals: true,
+        options: {
+            json: { type: "boolean", default: false },
+            help: { type: "boolean", default: false },
+            "cache-dir": { type: "string" },
+            "from-block": { type: "string" },
+            "to-block": { type: "string" },
+            "since-block": { type: "string" },
+            hot: { type: "boolean", default: false },
+            concurrency: { type: "string" },
+            "public-key": { type: "string" },
+        },
+    });
+    if (values.help || positionals.length === 0) {
+        process.stdout.write(USAGE);
+        return;
+    }
+    const [command, manifestUrl] = positionals;
+    if (!manifestUrl)
+        fail(`missing <manifest-url>\n\n${USAGE}`);
+    const json = values.json;
+    const range = {
+        fromBlock: values["from-block"] ? BigInt(values["from-block"]) : undefined,
+        toBlock: values["to-block"] ? BigInt(values["to-block"]) : undefined,
+    };
+    const needId = () => {
+        const id = positionals[2];
+        if (!id)
+            fail(`missing <protocol-id> for "${command}"\n\n${USAGE}`);
+        return id;
+    };
+    const publicKey = values["public-key"];
+    const queryClient = () => new Client({ source: new HttpStore(manifestUrl), publicKey });
+    switch (command) {
+        case "protocols":
+        case "ls":
+            process.stdout.write((await cmdProtocols(queryClient(), { json })) + "\n");
+            return;
+        case "info":
+            process.stdout.write((await cmdInfo(queryClient(), needId(), { json, ...range })) + "\n");
+            return;
+        case "head":
+        case "latest": {
+            const sinceBlock = values["since-block"] ? BigInt(values["since-block"]) : undefined;
+            const res = await cmdHead(queryClient(), needId(), { json, sinceBlock });
+            process.stdout.write(res.text + "\n");
+            if (res.stale)
+                process.exit(3);
+            return;
+        }
+        case "chunks":
+            process.stdout.write((await cmdChunks(queryClient(), needId(), { json, hot: values.hot, ...range })) + "\n");
+            return;
+        case "stream": {
+            const concurrency = values.concurrency ? Number(values.concurrency) : DEFAULT_CONCURRENCY;
+            if (!Number.isInteger(concurrency) || concurrency < 1) {
+                fail(`--concurrency must be a positive integer; got ${values.concurrency}`);
+            }
+            await runStream(manifestUrl, needId(), {
+                cacheDir: values["cache-dir"] ? resolve(values["cache-dir"]) : undefined,
+                concurrency,
+                publicKey,
+                ...range,
+            });
+            return;
+        }
+        default:
+            fail(`unknown command "${command}"\n\n${USAGE}`);
+    }
+}
+function isMainModule() {
+    try {
+        return realpathSync(process.argv[1] ?? "") === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isMainModule()) {
+    main().catch((err) => {
+        fail(err instanceof Error ? err.message : String(err));
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,30 @@
+import type { CanonicalEvent } from "@saga-sync/core";
+import type { Store } from "@saga-sync/core";
+import type { ChunkMeta } from "@saga-sync/core";
+import { Manifest } from "@saga-sync/core";
+export type ClientOptions = {
+    source: Store;
+    cache?: Store;
+    concurrency?: number;
+    publicKey?: string;
+};
+export type StreamOptions = {
+    fromBlock?: bigint;
+    toBlock?: bigint;
+};
+export declare class Client {
+    private readonly source;
+    private readonly cache;
+    private readonly concurrency;
+    private readonly publicKey;
+    constructor(opts: ClientOptions);
+    fetchManifest(key?: string): Promise<Manifest>;
+    fetchChunk(meta: ChunkMeta, opts?: {
+        hot?: boolean;
+    }): Promise<CanonicalEvent[]>;
+    listProtocols(prefix?: string): Promise<string[]>;
+    streamEvents(protocolId: string, opts?: StreamOptions): AsyncGenerator<CanonicalEvent, void, void>;
+    private fetchSealed;
+    private fetchSealedOrdered;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI3C,MAAM,MAAM,aAAa,GAAG;IAG1B,MAAM,EAAE,KAAK,CAAC;IAKd,KAAK,CAAC,EAAE,KAAK,CAAC;IAGd,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAOF,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAEnC,IAAI,EAAE,aAAa;IAY/B,aAAa,CAAC,GAAG,GAAE,MAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAO5D,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAS9E,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQhD,YAAY,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,aAAkB,GACvB,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC;YAkB/B,WAAW;YAiBV,kBAAkB;CAclC"}

package/dist/client.js

@@ -0,0 +1,100 @@
+import { decodeAndVerify, fetchChunkFrom, ChunkNotFoundError } from "./fetch.js";
+import { loadManifest, selectSealedChunks, selectHotHead } from "./manifest.js";
+const DEFAULT_CONCURRENCY = 4;
+// The consumer's entry point. Holds a (source, optional cache) pair and offers
+// three layers: raw manifest, single chunk, and a merged streamEvents iterator
+// across sealed chunks + the hot head.
+export class Client {
+    source;
+    cache;
+    concurrency;
+    publicKey;
+    constructor(opts) {
+        this.source = opts.source;
+        this.cache = opts.cache;
+        this.concurrency = opts.concurrency ?? DEFAULT_CONCURRENCY;
+        this.publicKey = opts.publicKey;
+        if (!Number.isInteger(this.concurrency) || this.concurrency < 1) {
+            throw new Error(`concurrency must be a positive integer; got ${opts.concurrency}`);
+        }
+    }
+    // Layer 1: fetch and parse the manifest (verifying its signature when a public
+    // key was configured).
+    fetchManifest(key = "index.json") {
+        return loadManifest(this.source, key, { publicKey: this.publicKey });
+    }
+    // Layer 2: fetch one chunk by its manifest entry. Goes through the cache
+    // path (for sealed chunks) so callers get the same efficiency as
+    // streamEvents.
+    fetchChunk(meta, opts = {}) {
+        return opts.hot ? fetchChunkFrom(this.source, meta) : this.fetchSealed(meta);
+    }
+    // Layer 1.5: discover the protocol streams a manifest publishes. Streams are
+    // granular per-pool (e.g. "tornado-cash-1-eth-0.1", "tornado-cash-1-dai-100"),
+    // so passing the family prefix "tornado-cash-1" returns every denomination's
+    // id — the enumeration a consumer needs before it can pick or fan out over
+    // streamEvents. Omit `prefix` to list everything; result is sorted.
+    async listProtocols(prefix) {
+        const ids = (await this.fetchManifest()).protocolIds();
+        return (prefix === undefined ? ids : ids.filter((id) => matchesFamily(id, prefix))).sort();
+    }
+    // Layer 3: merged event stream for a protocol. Yields events in block order
+    // across all sealed chunks in the optional [fromBlock, toBlock) window,
+    // then the hot head (re-fetched every call, never cached).
+    async *streamEvents(protocolId, opts = {}) {
+        const manifest = await this.fetchManifest();
+        const sealed = selectSealedChunks(manifest.sealedChunks(protocolId), opts);
+        const hot = selectHotHead(manifest.hotHead(protocolId), opts);
+        for await (const events of this.fetchSealedOrdered(sealed)) {
+            for (const event of events)
+                yield event;
+        }
+        if (hot) {
+            const events = await fetchChunkFrom(this.source, hot);
+            for (const event of events)
+                yield event;
+        }
+    }
+    // Cache-aware sealed fetch: check cache → on miss, fetch from source, verify,
+    // populate cache. Verification runs on both paths so every byte the
+    // application sees was just verified.
+    async fetchSealed(meta) {
+        if (this.cache) {
+            const cached = await this.cache.get(meta.file);
+            if (cached)
+                return await decodeAndVerify(cached, meta);
+        }
+        const compressed = await this.source.get(meta.file);
+        if (!compressed)
+            throw new ChunkNotFoundError(meta);
+        const events = await decodeAndVerify(compressed, meta);
+        if (this.cache)
+            await this.cache.put(meta.file, compressed);
+        return events;
+    }
+    // Sliding window — keep up to `concurrency` sealed-chunk fetches in flight;
+    // yield them strictly in submission order so consumers see events in
+    // block-range order regardless of which fetch finished first. Per-chunk
+    // peak memory is one decompressed chunk (~10 MiB); across chunks it is
+    // bounded by `concurrency`.
+    async *fetchSealedOrdered(metas) {
+        const queue = [];
+        let next = 0;
+        while (next < metas.length && queue.length < this.concurrency) {
+            queue.push(this.fetchSealed(metas[next++]));
+        }
+        while (queue.length > 0) {
+            const events = await queue.shift();
+            if (next < metas.length)
+                queue.push(this.fetchSealed(metas[next++]));
+            yield events;
+        }
+    }
+}
+// A protocol id belongs to a family if it equals the prefix or extends it by a
+// "-" segment, so "tornado-cash-1" matches "tornado-cash-1-eth-0.1" but not an
+// unrelated id that merely starts with the same characters.
+function matchesFamily(id, prefix) {
+    return id === prefix || id.startsWith(`${prefix}-`);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/fetch.d.ts

@@ -0,0 +1,10 @@
+import type { CanonicalEvent } from "@saga-sync/core";
+import type { Store } from "@saga-sync/core";
+import type { ChunkMeta } from "@saga-sync/core";
+export declare class ChunkNotFoundError extends Error {
+    readonly meta: ChunkMeta;
+    constructor(meta: ChunkMeta);
+}
+export declare function decodeAndVerify(compressed: Uint8Array, meta: ChunkMeta): Promise<CanonicalEvent[]>;
+export declare function fetchChunkFrom(store: Store, meta: ChunkMeta): Promise<CanonicalEvent[]>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBACb,IAAI,EAAE,SAAS;CAK5B;AAiBD,wBAAsB,eAAe,CACnC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,SAAS,GACd,OAAO,CAAC,cAAc,EAAE,CAAC,CAc3B;AAKD,wBAAsB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAI7F"}

package/dist/fetch.js

@@ -0,0 +1,51 @@
+import { verifyDigest, verifyChunkEvents } from "./verify.js";
+// Thrown when a chunk file referenced by the manifest is absent from the
+// store. Distinct from DigestMismatchError so callers can tell "missing"
+// from "wrong" — typically actionable differently (publisher gap vs. tampering).
+export class ChunkNotFoundError extends Error {
+    meta;
+    constructor(meta) {
+        super(`chunk file not found: ${meta.file}`);
+        this.name = "ChunkNotFoundError";
+        this.meta = meta;
+    }
+}
+// Gzip decompression via the web-standard DecompressionStream, so the consumer
+// read path runs in a browser as well as Node (both ship it). Async, unlike
+// node:zlib's gunzipSync — the only behavioral change of the browser refactor.
+async function gunzip(data) {
+    const stream = new Blob([data]).stream().pipeThrough(new DecompressionStream("gzip"));
+    return new Uint8Array(await new Response(stream).arrayBuffer());
+}
+const utf8 = new TextDecoder();
+// Decode a chunk file's compressed bytes: gunzip → verify digest → parse JSONL →
+// verify canonical form. Digest verification happens before parsing so a tampered
+// chunk never reaches the caller; the canonical-form check (range + ordering, SPEC
+// §3.3) then catches a correctly-digested chunk the producer built non-canonically.
+// Async because gzip decompression is a streaming Web API.
+export async function decodeAndVerify(compressed, meta) {
+    // Defensive: a zero-byte file is not produced by the pipeline (an empty
+    // events list still gzips to ~20 bytes), but if encountered, hand empty
+    // bytes to verify rather than letting gunzip throw.
+    const uncompressed = compressed.length === 0 ? new Uint8Array(0) : await gunzip(compressed);
+    verifyDigest(meta, uncompressed);
+    if (uncompressed.length === 0)
+        return [];
+    const events = utf8
+        .decode(uncompressed)
+        .split("\n")
+        .filter((line) => line.length > 0)
+        .map((line) => JSON.parse(line));
+    verifyChunkEvents(meta, events);
+    return events;
+}
+// Fetch a chunk from `store`, verify, return its events. Throws
+// ChunkNotFoundError if the store has no such object, DigestMismatchError if
+// the bytes do not match the manifest.
+export async function fetchChunkFrom(store, meta) {
+    const compressed = await store.get(meta.file);
+    if (!compressed)
+        throw new ChunkNotFoundError(meta);
+    return decodeAndVerify(compressed, meta);
+}
+//# sourceMappingURL=fetch.js.map

package/dist/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE9D,yEAAyE;AACzE,yEAAyE;AACzE,iFAAiF;AACjF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAY;IACzB,YAAY,IAAe;QACzB,KAAK,CAAC,yBAAyB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAC/E,KAAK,UAAU,MAAM,CAAC,IAAgB;IACpC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IACtF,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAE/B,iFAAiF;AACjF,kFAAkF;AAClF,mFAAmF;AACnF,oFAAoF;AACpF,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAsB,EACtB,IAAe;IAEf,wEAAwE;IACxE,wEAAwE;IACxE,oDAAoD;IACpD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5F,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACjC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI;SAChB,MAAM,CAAC,YAAY,CAAC;SACpB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC,CAAC;IACrD,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gEAAgE;AAChE,6EAA6E;AAC7E,uCAAuC;AACvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAY,EAAE,IAAe;IAChE,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,3 @@
+export declare function humanBytes(n: bigint): string;
+export declare function table(headers: string[], rows: string[][]): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAS5C;AAKD,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAQjE"}

package/dist/format.js

@@ -0,0 +1,22 @@
+// Human-readable byte size from a raw count. Binary units (KiB/MiB) to match how
+// chunk sizes are reasoned about elsewhere. Exact byte counts stay in --json.
+export function humanBytes(n) {
+    const units = ["B", "KiB", "MiB", "GiB", "TiB"];
+    let v = Number(n);
+    let u = 0;
+    while (v >= 1024 && u < units.length - 1) {
+        v /= 1024;
+        u++;
+    }
+    return u === 0 ? `${v} B` : `${v.toFixed(1)} ${units[u]}`;
+}
+// Minimal fixed-width text table: a header row, a dashed rule, then the rows.
+// Columns are sized to their widest cell. No dependency, no alignment beyond
+// left-pad. `rows` may be empty (header + rule only).
+export function table(headers, rows) {
+    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)));
+    const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ");
+    const rule = widths.map((w) => "-".repeat(w)).join("  ");
+    return [fmt(headers), rule, ...rows.map(fmt)].join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,CAAC,IAAI,IAAI,CAAC;QACV,CAAC,EAAE,CAAC;IACN,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,8EAA8E;AAC9E,6EAA6E;AAC7E,sDAAsD;AACtD,MAAM,UAAU,KAAK,CAAC,OAAiB,EAAE,IAAgB;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAClC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAC5D,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,KAAe,EAAU,EAAE,CACtC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { Client } from "./client.js";
+export type { ClientOptions, StreamOptions } from "./client.js";
+export { HttpStore } from "@saga-sync/core";
+export type { Store } from "@saga-sync/core";
+export { decodeAndVerify, fetchChunkFrom, ChunkNotFoundError } from "./fetch.js";
+export { verifyDigest, DigestMismatchError } from "./verify.js";
+export { loadManifest } from "./manifest.js";
+export type { ChunkMeta, ManifestData, LoadManifestOptions } from "./manifest.js";
+export { verifyManifestSignature, ManifestSignatureError } from "@saga-sync/core";
+export type { CanonicalEvent } from "@saga-sync/core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAElF,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// @saga-sync/client — browser-safe library entry point. Everything reachable
+// from here uses only web-standard APIs (fetch, DecompressionStream,
+// TextDecoder, Uint8Array, @noble) and no node: built-ins — so a bundler can
+// pull it into a browser app with no polyfills. The CLI and DiskStore are
+// intentionally NOT re-exported here (Node-only); import them from their own
+// modules. HttpStore, the manifest schema, and signature verification come from
+// @saga-sync/core.
+export { Client } from "./client.js";
+export { HttpStore } from "@saga-sync/core";
+// Read helpers and the errors a consumer handles.
+export { decodeAndVerify, fetchChunkFrom, ChunkNotFoundError } from "./fetch.js";
+export { verifyDigest, DigestMismatchError } from "./verify.js";
+export { loadManifest } from "./manifest.js";
+// Manifest signature verification (Ed25519) — consumers pin a public key.
+export { verifyManifestSignature, ManifestSignatureError } from "@saga-sync/core";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,qEAAqE;AACrE,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,gFAAgF;AAChF,mBAAmB;AAEnB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,kDAAkD;AAClD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,0EAA0E;AAC1E,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,17 @@
+import type { Store } from "@saga-sync/core";
+import { Manifest as PublisherManifest } from "@saga-sync/core";
+import type { ChunkMeta } from "@saga-sync/core";
+export type { ChunkMeta, ManifestData } from "@saga-sync/core";
+export type LoadManifestOptions = {
+    publicKey?: string;
+};
+export declare function loadManifest(store: Store, key?: string, opts?: LoadManifestOptions): Promise<PublisherManifest>;
+export declare function selectSealedChunks(chunks: ChunkMeta[], filter?: {
+    fromBlock?: bigint;
+    toBlock?: bigint;
+}): ChunkMeta[];
+export declare function selectHotHead(hot: ChunkMeta | undefined, filter?: {
+    fromBlock?: bigint;
+    toBlock?: bigint;
+}): ChunkMeta | undefined;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG;IAIhC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAMF,wBAAsB,YAAY,CAChC,KAAK,EAAE,KAAK,EACZ,GAAG,GAAE,MAAqB,EAC1B,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAa5B;AAMD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,SAAS,EAAE,CAUb;AAGD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,SAAS,GAAG,SAAS,EAC1B,MAAM,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,SAAS,GAAG,SAAS,CASvB"}

package/dist/manifest.js

@@ -0,0 +1,51 @@
+import { Manifest as PublisherManifest } from "@saga-sync/core";
+import { ManifestSignatureError, verifyManifestSignature } from "@saga-sync/core";
+// Load and parse the manifest from a store. Throws if the manifest is absent
+// (the publisher has not run yet, or the URL is wrong) or malformed. If a
+// publicKey is supplied, the signature is verified first — over the raw bytes,
+// before any of them are trusted.
+export async function loadManifest(store, key = "index.json", opts = {}) {
+    const raw = await store.get(key);
+    if (!raw)
+        throw new Error(`manifest not found at key "${key}"`);
+    if (opts.publicKey) {
+        const sig = await store.get(`${key}.sig`);
+        if (!sig) {
+            throw new ManifestSignatureError(`manifest signature "${key}.sig" not found, but a public key was configured`);
+        }
+        verifyManifestSignature(raw, new TextDecoder().decode(sig).trim(), opts.publicKey);
+    }
+    return PublisherManifest.fromRaw(store, key, raw);
+}
+// Pure helper: filter a protocol's sealed chunks down to those overlapping
+// the requested half-open [fromBlock, toBlock) window. Skip is by chunk range
+// only — straddling chunks yield all their events (the caller does any per-
+// event filtering).
+export function selectSealedChunks(chunks, filter = {}) {
+    const from = filter.fromBlock;
+    const to = filter.toBlock;
+    return chunks.filter((c) => {
+        const cFrom = BigInt(c.fromBlock);
+        const cTo = BigInt(c.toBlock);
+        if (from !== undefined && cTo <= from)
+            return false; // chunk ends at or before window
+        if (to !== undefined && cFrom >= to)
+            return false; // chunk starts at or after window
+        return true;
+    });
+}
+// Pure helper: include the hot head only if it overlaps the window.
+export function selectHotHead(hot, filter = {}) {
+    if (!hot)
+        return undefined;
+    const from = filter.fromBlock;
+    const to = filter.toBlock;
+    const hFrom = BigInt(hot.fromBlock);
+    const hTo = BigInt(hot.toBlock);
+    if (from !== undefined && hTo <= from)
+        return undefined;
+    if (to !== undefined && hFrom >= to)
+        return undefined;
+    return hot;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAclF,6EAA6E;AAC7E,0EAA0E;AAC1E,+EAA+E;AAC/E,kCAAkC;AAClC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAY,EACZ,MAAc,YAAY,EAC1B,OAA4B,EAAE;IAE9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,GAAG,CAAC,CAAC;IAChE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,sBAAsB,CAC9B,uBAAuB,GAAG,kDAAkD,CAC7E,CAAC;QACJ,CAAC;QACD,uBAAuB,CAAC,GAAG,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,2EAA2E;AAC3E,8EAA8E;AAC9E,4EAA4E;AAC5E,oBAAoB;AACpB,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,SAAmD,EAAE;IAErD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC,CAAC,iCAAiC;QACtF,IAAI,EAAE,KAAK,SAAS,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC,CAAC,kCAAkC;QACrF,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,aAAa,CAC3B,GAA0B,EAC1B,SAAmD,EAAE;IAErD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACxD,IAAI,EAAE,KAAK,SAAS,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACtD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/verify.d.ts

@@ -0,0 +1,15 @@
+import type { ChunkMeta } from "@saga-sync/core";
+import type { CanonicalEvent } from "@saga-sync/core";
+export declare class DigestMismatchError extends Error {
+    readonly meta: ChunkMeta;
+    readonly expected: string;
+    readonly actual: string;
+    constructor(meta: ChunkMeta, expected: string, actual: string);
+}
+export declare function verifyDigest(meta: ChunkMeta, uncompressed: Uint8Array): void;
+export declare class CanonicalFormError extends Error {
+    readonly meta: ChunkMeta;
+    constructor(meta: ChunkMeta, detail: string);
+}
+export declare function verifyChunkEvents(meta: ChunkMeta, events: CanonicalEvent[]): void;
+//# sourceMappingURL=verify.d.ts.map

package/dist/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAItD,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAS9D;AAKD,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,GAAG,IAAI,CAS5E;AAYD,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBACb,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;CAK5C;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAyBjF"}

package/dist/verify.js

@@ -0,0 +1,70 @@
+import { sha256Hex } from "@saga-sync/core";
+// Thrown when a chunk's recomputed digest does not match the manifest. Carries
+// both digests so the caller can log them; both are lower-case 0x-prefixed.
+export class DigestMismatchError extends Error {
+    meta;
+    expected;
+    actual;
+    constructor(meta, expected, actual) {
+        super(`digest mismatch for ${meta.file}: expected ${expected}, got ${actual}`);
+        this.name = "DigestMismatchError";
+        this.meta = meta;
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+// Recompute the sha256 of the chunk's uncompressed JSONL bytes and compare to
+// the manifest entry. Mandatory on every fetched chunk (cache hits included) —
+// the whole point of the system is verifiable distribution.
+export function verifyDigest(meta, uncompressed) {
+    if (meta.digest.type !== "sha256") {
+        throw new Error(`unsupported digest type ${meta.digest.type} for ${meta.file}`);
+    }
+    const expected = normalize(meta.digest.data);
+    const actual = sha256Hex(uncompressed);
+    if (expected !== actual) {
+        throw new DigestMismatchError(meta, expected, actual);
+    }
+}
+function normalize(hex) {
+    const s = hex.toLowerCase();
+    return s.startsWith("0x") ? s : `0x${s}`;
+}
+// Thrown when a chunk's events violate the canonical form (SPEC §3.3) the digest
+// cannot catch on its own: out-of-range blocks, or a non-ascending order. The
+// digest proves the bytes match the manifest; this proves the manifest author
+// honored the ordering + range contract (defense against a buggy, even if
+// trusted, producer).
+export class CanonicalFormError extends Error {
+    meta;
+    constructor(meta, detail) {
+        super(`chunk ${meta.file} violates canonical form: ${detail}`);
+        this.name = "CanonicalFormError";
+        this.meta = meta;
+    }
+}
+// Validate the two §3.3 properties the digest does not *semantically* enforce:
+//   1. every event's blockNumber is within the chunk's [fromBlock, toBlock) range
+//   2. events are strictly ascending by (blockNumber, logIndex)
+// Empty chunks pass trivially. Mandatory on every chunk, like the digest.
+export function verifyChunkEvents(meta, events) {
+    const from = BigInt(meta.fromBlock);
+    const to = BigInt(meta.toBlock);
+    let prevBlock = -1n;
+    let prevLog = -1n;
+    let first = true;
+    for (const e of events) {
+        const block = BigInt(e.blockNumber);
+        const log = BigInt(e.logIndex);
+        if (block < from || block >= to) {
+            throw new CanonicalFormError(meta, `event at block ${e.blockNumber} is outside [${meta.fromBlock},${meta.toBlock})`);
+        }
+        if (!first && (block < prevBlock || (block === prevBlock && log <= prevLog))) {
+            throw new CanonicalFormError(meta, `events not strictly ascending by (blockNumber, logIndex) at block ${e.blockNumber}, logIndex ${e.logIndex}`);
+        }
+        prevBlock = block;
+        prevLog = log;
+        first = false;
+    }
+}
+//# sourceMappingURL=verify.js.map

package/dist/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,24 +1,38 @@
 {
   "name": "@saga-sync/client",
-  "version": "0.0.0",
-  "description": "",
-  "main": "index.js",
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "devEngines": {
-    "packageManager": {
-      "name": "pnpm",
-      "version": "^11.3.0",
-      "onFail": "download"
-    }
+  "version": "0.1.2",
+  "description": "Consumer library + CLI for saga-sync: fetch, verify, and stream published privacy-protocol state",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fatlabsxyz/saga-sync.git",
+    "directory": "packages/client"
   },
-  "type": "module",
+  "homepage": "https://github.com/fatlabsxyz/saga-sync/tree/master/packages/client#readme",
+  "bugs": "https://github.com/fatlabsxyz/saga-sync/issues",
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org"
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "state-client": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@saga-sync/core": "0.1.2"
+  },
+  "devDependencies": {
+    "@saga-sync/producer": "0.1.2"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc -b"
   }
 }