@saga-sync/producer 0.0.0 → 0.1.2

package/dist/chunk-builder/accumulator.d.ts

@@ -0,0 +1,29 @@
+import type { CanonicalEvent } from "../scraper/normalize.js";
+export type CompletedChunk = {
+    events: CanonicalEvent[];
+    from: bigint;
+    to: bigint;
+};
+export type Trailing = {
+    events: CanonicalEvent[];
+    fromBlock: bigint;
+};
+export declare class ChunkAccumulator {
+    private readonly sizeLimit;
+    private chunkFrom;
+    private accumulated;
+    private accumulatedBytes;
+    private pending;
+    private pendingBytes;
+    private pendingBlock;
+    constructor(sizeLimit: number, chunkFrom: bigint);
+    add(event: CanonicalEvent): CompletedChunk | null;
+    finish(): {
+        completed: CompletedChunk | null;
+        trailing: Trailing;
+    };
+    private wouldOverflow;
+    private commitPending;
+    private cut;
+}
+//# sourceMappingURL=accumulator.d.ts.map

package/dist/chunk-builder/accumulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accumulator.d.ts","sourceRoot":"","sources":["../../src/chunk-builder/accumulator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AACpF,MAAM,MAAM,QAAQ,GAAG;IAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAYvE,qBAAa,gBAAgB;IAQzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,SAAS;IARnB,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAuB;gBAGxB,SAAS,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM;IAG3B,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,GAAG,IAAI;IAoBjD,MAAM,IAAI;QAAE,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE;IAclE,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,GAAG;CAOZ"}

package/dist/chunk-builder/accumulator.js

@@ -0,0 +1,72 @@
+// Block-aligned chunk partitioning — pure, no I/O. Events are fed in
+// (blockNumber, logIndex) order; the accumulator buffers the in-progress block
+// separately and only commits it to the current chunk once the next block
+// arrives. That guarantees chunk boundaries always fall *between* blocks, so a
+// multi-event block can never be split across two chunks.
+//
+// `add` emits a completed chunk when feeding an event closed a block and the
+// accumulated bytes had crossed the size limit. `finish` flushes the last
+// in-progress block and hands back the trailing accumulator — the caller seals
+// it as a final chunk or carries it forward as a hot head.
+export class ChunkAccumulator {
+    sizeLimit;
+    chunkFrom;
+    accumulated = [];
+    accumulatedBytes = 0;
+    pending = [];
+    pendingBytes = 0;
+    pendingBlock = null;
+    constructor(sizeLimit, chunkFrom) {
+        this.sizeLimit = sizeLimit;
+        this.chunkFrom = chunkFrom;
+    }
+    add(event) {
+        const eventBlock = BigInt(event.blockNumber);
+        const lineBytes = Buffer.byteLength(JSON.stringify(event) + "\n", "utf8");
+        let completed = null;
+        if (this.pendingBlock !== null && eventBlock !== this.pendingBlock) {
+            // The pending block is finished — commit it to the current chunk,
+            // sealing first if doing so would overflow the size limit.
+            if (this.wouldOverflow()) {
+                completed = this.cut(this.pendingBlock);
+            }
+            this.commitPending();
+        }
+        this.pendingBlock = eventBlock;
+        this.pending.push(event);
+        this.pendingBytes += lineBytes;
+        return completed;
+    }
+    finish() {
+        let completed = null;
+        if (this.pending.length > 0 && this.pendingBlock !== null) {
+            if (this.wouldOverflow()) {
+                completed = this.cut(this.pendingBlock);
+            }
+            this.commitPending();
+        }
+        return {
+            completed,
+            trailing: { events: this.accumulated, fromBlock: this.chunkFrom },
+        };
+    }
+    wouldOverflow() {
+        return (this.accumulatedBytes + this.pendingBytes > this.sizeLimit &&
+            this.accumulated.length > 0);
+    }
+    commitPending() {
+        this.accumulated.push(...this.pending);
+        this.accumulatedBytes += this.pendingBytes;
+        this.pending = [];
+        this.pendingBytes = 0;
+    }
+    // Close the current chunk at `to` and start a fresh one.
+    cut(to) {
+        const chunk = { events: this.accumulated, from: this.chunkFrom, to };
+        this.chunkFrom = to;
+        this.accumulated = [];
+        this.accumulatedBytes = 0;
+        return chunk;
+    }
+}
+//# sourceMappingURL=accumulator.js.map

package/dist/chunk-builder/accumulator.js.map

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

package/dist/chunk-builder/archive.d.ts

@@ -0,0 +1,18 @@
+import type { CanonicalEvent } from "../scraper/normalize.js";
+import type { Store } from "@saga-sync/core";
+import type { ChunkMeta } from "@saga-sync/core";
+export type Range = {
+    from: bigint;
+    to: bigint;
+};
+export declare function buildJsonl(events: CanonicalEvent[]): Buffer;
+export declare class ChunkArchive {
+    private readonly store;
+    constructor(store: Store);
+    seal(protocolId: string, events: CanonicalEvent[], range: Range): Promise<ChunkMeta>;
+    writeHotHead(protocolId: string, events: CanonicalEvent[], range: Range): Promise<ChunkMeta>;
+    private write;
+    readEvents(meta: ChunkMeta): Promise<CanonicalEvent[]>;
+    delete(meta: ChunkMeta): Promise<void>;
+}
+//# sourceMappingURL=archive.d.ts.map

package/dist/chunk-builder/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/chunk-builder/archive.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAKjD,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAG3D;AAUD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAGzC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;IAKpF,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;YAI9E,KAAK;IA4Bb,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAWtD,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/chunk-builder/archive.js

@@ -0,0 +1,68 @@
+import { gzipSync, gunzipSync } from "node:zlib";
+import { numberToHex } from "viem";
+import { sha256Hex } from "@saga-sync/core";
+// Build the JSONL bytes for a chunk: one CanonicalEvent per line, trailing
+// newline. Empty events list produces zero bytes so an empty chunk file is
+// genuinely empty rather than a single blank line.
+export function buildJsonl(events) {
+    if (events.length === 0)
+        return Buffer.alloc(0);
+    return Buffer.from(events.map((e) => JSON.stringify(e)).join("\n") + "\n", "utf8");
+}
+// Encodes/decodes chunk files over a Store. A chunk's digest is the sha256 of
+// the *uncompressed* JSONL bytes — clients verify integrity after decompressing
+// without trusting the gzip wrapper. Sealed and hot files are byte-identical for
+// the same events; only the filename suffix differs (`.jsonl.gz` vs
+// `.hot.jsonl.gz`), a hint that a hot file is the protocol's mutable tail.
+//
+// Dry-run is handled at the Store layer (DryRunStore no-ops writes), so this
+// class needs no dry-run awareness.
+export class ChunkArchive {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    // Seal an immutable chunk.
+    seal(protocolId, events, range) {
+        return this.write(protocolId, events, range, false);
+    }
+    // Write the protocol's mutable hot head.
+    writeHotHead(protocolId, events, range) {
+        return this.write(protocolId, events, range, true);
+    }
+    async write(protocolId, events, range, hot) {
+        const uncompressed = buildJsonl(events);
+        const digest = sha256Hex(uncompressed);
+        const compressed = gzipSync(uncompressed);
+        const fromHex = numberToHex(range.from);
+        const toHex = numberToHex(range.to);
+        const file = `${protocolId}-[${fromHex},${toHex})${hot ? ".hot.jsonl.gz" : ".jsonl.gz"}`;
+        await this.store.put(file, compressed);
+        return {
+            fromBlock: fromHex,
+            toBlock: toHex,
+            file,
+            size: numberToHex(compressed.length),
+            digest: { type: "sha256", data: digest },
+        };
+    }
+    // Inverse of write(): fetch a chunk file and parse its JSONL back into events.
+    // Used to load a previous hot head into the accumulator (and by the future
+    // client library to materialize chunk contents).
+    async readEvents(meta) {
+        const compressed = await this.store.get(meta.file);
+        if (!compressed || compressed.length === 0)
+            return [];
+        const uncompressed = gunzipSync(compressed).toString("utf8");
+        if (uncompressed.length === 0)
+            return [];
+        return uncompressed
+            .split("\n")
+            .filter((line) => line.length > 0)
+            .map((line) => JSON.parse(line));
+    }
+    async delete(meta) {
+        await this.store.delete(meta.file);
+    }
+}
+//# sourceMappingURL=archive.js.map

package/dist/chunk-builder/archive.js.map

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

package/dist/chunk-builder/cli.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import type { CanonicalEvent } from "../scraper/normalize.js";
+import { ChunkArchive } from "./archive.js";
+import { Manifest } from "@saga-sync/core";
+import type { ChunkMeta } from "@saga-sync/core";
+export type ProcessArgs = {
+    protocolId: string;
+    fromBlock: bigint;
+    toBlock: bigint;
+    sizeLimit: number;
+    archive: ChunkArchive;
+    manifest: Manifest;
+    seed?: {
+        events: CanonicalEvent[];
+        chunkFrom: bigint;
+    };
+    trailingMode?: "seal" | "suspend";
+};
+export type ProcessResult = {
+    sealed: ChunkMeta[];
+    trailing?: {
+        events: CanonicalEvent[];
+        fromBlock: bigint;
+        toBlock: bigint;
+    };
+};
+export declare function processStream(lines: AsyncIterable<string>, args: ProcessArgs): Promise<ProcessResult>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/chunk-builder/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/chunk-builder/cli.ts"],"names":[],"mappings":";AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAuEjD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IAKnB,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAGvD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E,CAAC;AAMF,wBAAsB,aAAa,CACjC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CA+DxB"}

package/dist/chunk-builder/cli.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { createInterface } from "node:readline";
+import { numberToHex } from "viem";
+import { createStore, parseStoreTarget } from "../storage/index.js";
+import { ChunkArchive } from "./archive.js";
+import { ChunkAccumulator } from "./accumulator.js";
+import { Manifest } from "@saga-sync/core";
+import { signerFromEnv } from "@saga-sync/core";
+const DEFAULT_SIZE_LIMIT = 10 * 1024 * 1024; // 10 MiB
+const USAGE = `chunk-builder — partition scraper NDJSON into immutable .jsonl.gz chunks
+
+Usage:
+  chunk-builder --protocol-id <id> --from-block <hex> --to-block <hex> --output-dir <path> [options]
+
+Required:
+  --protocol-id <id>     manifest key + filename prefix
+  --from-block <hex>     inclusive start of the scanned range
+  --to-block <hex>       exclusive end of the scanned range
+  --output-dir <path>    where to write chunks + index.json (created if missing)
+
+Options:
+  --size-limit <n>       max uncompressed bytes per chunk, default ${DEFAULT_SIZE_LIMIT} (10 MiB)
+  --dry-run              compute chunk metadata but do not write files or manifest
+  --help                 show this message
+`;
+function fail(msg) {
+    process.stderr.write(`chunk-builder: ${msg}\n`);
+    process.exit(1);
+}
+function parseCliArgs() {
+    const { values } = parseArgs({
+        options: {
+            "protocol-id": { type: "string" },
+            "from-block": { type: "string" },
+            "to-block": { type: "string" },
+            "output-dir": { type: "string" },
+            "size-limit": { type: "string" },
+            "dry-run": { type: "boolean", default: false },
+            help: { type: "boolean", default: false },
+        },
+    });
+    if (values.help) {
+        process.stdout.write(USAGE);
+        process.exit(0);
+    }
+    const need = (name) => {
+        const v = values[name];
+        if (!v)
+            fail(`missing required --${name}\n\n${USAGE}`);
+        return v;
+    };
+    const fromBlock = BigInt(need("from-block"));
+    const toBlock = BigInt(need("to-block"));
+    if (fromBlock >= toBlock) {
+        fail(`--from-block (${numberToHex(fromBlock)}) must be < --to-block (${numberToHex(toBlock)})`);
+    }
+    const sizeLimit = values["size-limit"] ? Number(values["size-limit"]) : DEFAULT_SIZE_LIMIT;
+    if (!Number.isFinite(sizeLimit) || sizeLimit <= 0) {
+        fail(`--size-limit must be a positive integer; got ${values["size-limit"]}`);
+    }
+    return {
+        protocolId: need("protocol-id"),
+        fromBlock,
+        toBlock,
+        output: need("output-dir"), // raw — may be a local dir or a gs:// target
+        sizeLimit,
+        dryRun: values["dry-run"] ?? false,
+    };
+}
+// Reads CanonicalEvent NDJSON, partitions it into chunks via ChunkAccumulator,
+// and seals each completed chunk through ChunkArchive + Manifest. The trailing
+// accumulator is either sealed (seal mode) or returned (suspend mode — the
+// hot-head carry-over path).
+export async function processStream(lines, args) {
+    const sealed = [];
+    const chunkFrom = args.seed?.chunkFrom ?? args.fromBlock;
+    const accumulator = new ChunkAccumulator(args.sizeLimit, chunkFrom);
+    const sealCompleted = async (c) => {
+        const meta = await args.archive.seal(args.protocolId, c.events, { from: c.from, to: c.to });
+        await args.manifest.appendChunk(args.protocolId, meta);
+        sealed.push(meta);
+    };
+    // Seed events (from a prior hot head) lead the stream and skip the range check.
+    if (args.seed) {
+        for (const event of args.seed.events) {
+            const completed = accumulator.add(event);
+            if (completed)
+                await sealCompleted(completed);
+        }
+    }
+    for await (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (line === "")
+            continue;
+        let event;
+        try {
+            event = JSON.parse(line);
+        }
+        catch (err) {
+            throw new Error(`malformed NDJSON line: ${err.message}`);
+        }
+        if (typeof event.blockNumber !== "string") {
+            throw new Error(`event missing blockNumber: ${line.slice(0, 120)}`);
+        }
+        const eventBlock = BigInt(event.blockNumber);
+        if (eventBlock < args.fromBlock || eventBlock >= args.toBlock) {
+            throw new Error(`event at block ${event.blockNumber} outside scanned range ` +
+                `[${numberToHex(args.fromBlock)}, ${numberToHex(args.toBlock)})`);
+        }
+        const completed = accumulator.add(event);
+        if (completed)
+            await sealCompleted(completed);
+    }
+    const { completed, trailing } = accumulator.finish();
+    if (completed)
+        await sealCompleted(completed);
+    if ((args.trailingMode ?? "seal") === "seal") {
+        // Seal the trailing accumulator as a final chunk up to args.toBlock — even
+        // with zero events, so the manifest asserts full range coverage.
+        const meta = await args.archive.seal(args.protocolId, trailing.events, {
+            from: trailing.fromBlock,
+            to: args.toBlock,
+        });
+        await args.manifest.appendChunk(args.protocolId, meta);
+        sealed.push(meta);
+        return { sealed };
+    }
+    return {
+        sealed,
+        trailing: { events: trailing.events, fromBlock: trailing.fromBlock, toBlock: args.toBlock },
+    };
+}
+async function main() {
+    const args = parseCliArgs();
+    const store = createStore({ ...parseStoreTarget(args.output), dryRun: args.dryRun });
+    const archive = new ChunkArchive(store);
+    const manifest = await Manifest.load(store, undefined, { signer: signerFromEnv() });
+    const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
+    const { sealed } = await processStream(rl, {
+        protocolId: args.protocolId,
+        fromBlock: args.fromBlock,
+        toBlock: args.toBlock,
+        sizeLimit: args.sizeLimit,
+        archive,
+        manifest,
+    });
+    process.stderr.write(`chunk-builder: ${sealed.length} chunk(s) for ${args.protocolId} ` +
+        `[${numberToHex(args.fromBlock)}, ${numberToHex(args.toBlock)})` +
+        (args.dryRun ? " (dry-run: no files or manifest written)\n" : "\n"));
+}
+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/chunk-builder/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { ChunkArchive, buildJsonl } from "./chunk-builder/archive.js";
+export type { Range } from "./chunk-builder/archive.js";
+//# 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":"AAIA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// @saga-sync/producer — producer-side API. Day-to-day use is via the CLIs
+// (scraper, chunk-builder, orchestrator); this entry exposes the pieces other
+// packages compose against — e.g. the client's integration tests build fixtures
+// with ChunkArchive, exactly as a real publisher would.
+export { ChunkArchive, buildJsonl } from "./chunk-builder/archive.js";
+//# 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,0EAA0E;AAC1E,8EAA8E;AAC9E,gFAAgF;AAChF,wDAAwD;AACxD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/keygen.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=keygen.d.ts.map

package/dist/keygen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keygen.d.ts","sourceRoot":"","sources":["../src/keygen.ts"],"names":[],"mappings":""}

package/dist/keygen.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { generateKeyPair } from "@saga-sync/core";
+// Print a fresh Ed25519 manifest-signing keypair. The secret goes to the
+// producer (MANIFEST_SIGNING_KEY env / Secret Manager); the public key is what
+// consumers pin via --public-key (and, later, what a registry contract serves).
+const { secretKey, publicKey } = generateKeyPair();
+process.stdout.write(`# Ed25519 manifest-signing keypair — keep the secret secret\n` +
+    `MANIFEST_SIGNING_KEY=${secretKey}\n` +
+    `PUBLIC_KEY=${publicKey}\n`);
+//# sourceMappingURL=keygen.js.map

package/dist/keygen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keygen.js","sourceRoot":"","sources":["../src/keygen.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,yEAAyE;AACzE,+EAA+E;AAC/E,gFAAgF;AAChF,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,CAAC;AACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+DAA+D;IAC7D,wBAAwB,SAAS,IAAI;IACrC,cAAc,SAAS,IAAI,CAC9B,CAAC"}

package/dist/orchestrator/cli.d.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import type { PublicClient } from "viem";
+import type { ScraperTarget } from "../scraper/config.js";
+import { Manifest } from "@saga-sync/core";
+import type { ChunkMeta } from "@saga-sync/core";
+import { ChunkArchive } from "../chunk-builder/archive.js";
+declare function parseCliArgs(): {
+    configPath: string;
+    rpc: string;
+    output: string;
+    lockDir: string | undefined;
+    protocolId: string | undefined;
+    batchSize: bigint;
+    confirmations: bigint;
+    window: number;
+    sizeLimit: number;
+    dryRun: boolean;
+};
+export declare function acquireLock(path: string): boolean;
+declare function processProtocol(args: {
+    client: PublicClient;
+    protocolId: string;
+    protocol: ScraperTarget;
+    archive: ChunkArchive;
+    manifest: Manifest;
+    tip: bigint;
+    batchSize: bigint;
+    window: number;
+    sizeLimit: number;
+}): Promise<{
+    ranBatches: number;
+    sealedChunks: number;
+    finalHotHead: ChunkMeta | null;
+}>;
+declare function main(): Promise<void>;
+export { main, parseCliArgs, processProtocol };
+//# sourceMappingURL=cli.d.ts.map

package/dist/orchestrator/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/orchestrator/cli.ts"],"names":[],"mappings":";AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAGzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAsC3D,iBAAS,YAAY;;;;;;;;;;;EA2CpB;AAKD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA2DjD;AAID,iBAAe,eAAe,CAAC,IAAI,EAAE;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,CAAC,CA6FxF;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkGnC;AAgBD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC"}