@naulon/sdk 0.1.0

package/dist/cli/init.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+/**
+ * `naulon init` — the interactive setup wizard (the CLI shell around `buildInitPlan`).
+ *
+ *   naulon init                 # prompt for everything, sensible defaults in brackets
+ *   naulon init --yes           # non-interactive: flags + defaults, nothing asked (CI)
+ *   naulon init --mode gateway --origin https://mysite.com --wallet 0x… --yes
+ *
+ * It writes two files the gate boots from — `.env` and a starter `credits.json` — and
+ * refuses to clobber either unless you pass `--force` (the `prisma init` rule). All the
+ * value logic lives in `../init/plan.ts`; this file is only prompts + I/O.
+ */
+import * as readline from "node:readline/promises";
+import { existsSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { WALLET_RE } from "../contract/wallet.js";
+import { buildInitPlan, initAnswersSchema, INIT_DEFAULTS } from "../init/plan.js";
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+const DIAMOND = "◆";
+const FLAG_MAP = {
+    "--origin": "originUrl",
+    "--price": "priceUsdc",
+    "--citation-multiplier": "citationMultiplier",
+    "--mode": "paymentMode",
+    "--network": "settlementNetwork",
+    "--port": "tollgatePort",
+    "--prefixes": "articlePrefixes",
+    "--credits": "creditsPath",
+    "--wallet": "defaultWallet",
+    "--slug": "starterSlug",
+    "--title": "starterTitle",
+    "--author-id": "starterAuthorId",
+};
+export function parseInitFlags(argv) {
+    const f = { yes: false, force: false, dir: process.cwd(), help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--yes" || a === "-y")
+            f.yes = true;
+        else if (a === "--force" || a === "-f")
+            f.force = true;
+        else if (a === "--help" || a === "-h")
+            f.help = true;
+        else if (a === "--dir")
+            f.dir = argv[++i] ?? f.dir;
+        else if (a) {
+            const key = FLAG_MAP[a];
+            if (key)
+                f[key] = argv[++i];
+        }
+    }
+    return f;
+}
+const USAGE = `usage: naulon init [--yes] [--force] [--dir <path>]
+             [--origin <url>] [--price <n>] [--citation-multiplier <n>]
+             [--mode mock|gateway] [--network arcTestnet|baseSepolia|base]
+             [--port <n>] [--prefixes <csv>] [--credits <path>]
+             [--wallet 0x…] [--slug <s>] [--title <t>] [--author-id <id>]`;
+function makeReader() {
+    const rl = readline.createInterface({ input: process.stdin });
+    const it = rl[Symbol.asyncIterator]();
+    return {
+        async next() {
+            const { value, done } = await it.next();
+            return done ? null : value;
+        },
+        close() {
+            rl.close();
+        },
+    };
+}
+/** One prompt: shows the default in brackets, re-asks until the input validates. */
+async function ask(reader, label, def, validate) {
+    for (;;) {
+        process.stdout.write(`  ${DIAMOND} ${label} ${DIM}(${def})${RESET} `);
+        const line = await reader.next();
+        if (line === null)
+            return def; // input ended → accept the default, don't hang
+        const value = line.trim() === "" ? def : line.trim();
+        const err = validate?.(value) ?? null;
+        if (!err)
+            return value;
+        console.log(`    ${DIM}↳ ${err}${RESET}`);
+    }
+}
+const vUrl = (v) => {
+    try {
+        new URL(v);
+        return null;
+    }
+    catch {
+        return "enter a valid URL, e.g. https://mysite.com";
+    }
+};
+const vPositive = (v) => (Number(v) > 0 ? null : "enter a number greater than 0");
+const vPort = (v) => (Number.isInteger(Number(v)) && Number(v) > 0 ? null : "enter a whole port number");
+const vMode = (v) => (v === "mock" || v === "gateway" ? null : "enter 'mock' or 'gateway'");
+const vNetwork = (v) => ["arcTestnet", "baseSepolia", "base"].includes(v) ? null : "arcTestnet | baseSepolia | base";
+const vWallet = (v) => (v === "" || WALLET_RE.test(v) ? null : "a 0x-prefixed 40-hex address, or blank");
+const vNonEmpty = (v) => (v.trim() === "" ? "cannot be blank" : null);
+/** Gather answers from flags + defaults, only prompting for what's missing (unless --yes). */
+async function gather(f, reader) {
+    const d = INIT_DEFAULTS;
+    if (f.yes) {
+        const mode = (f.paymentMode ?? d.paymentMode);
+        return initAnswersSchema.parse({
+            originUrl: f.originUrl ?? d.originUrl,
+            priceUsdc: Number(f.priceUsdc ?? d.priceUsdc),
+            citationMultiplier: Number(f.citationMultiplier ?? d.citationMultiplier),
+            paymentMode: mode,
+            settlementNetwork: f.settlementNetwork ?? d.settlementNetwork,
+            tollgatePort: Number(f.tollgatePort ?? d.tollgatePort),
+            articlePrefixes: f.articlePrefixes ?? d.articlePrefixes,
+            creditsPath: f.creditsPath ?? d.creditsPath,
+            starterSlug: f.starterSlug ?? d.starterSlug,
+            starterTitle: f.starterTitle ?? d.starterTitle,
+            starterAuthorId: f.starterAuthorId ?? d.starterAuthorId,
+            defaultWallet: f.defaultWallet && f.defaultWallet !== "" ? f.defaultWallet : undefined,
+        });
+    }
+    console.log(`\n${BOLD}naulon init${RESET} ${DIM}— set up your gate. Enter accepts the default.${RESET}\n`);
+    const originUrl = await ask(reader, "Your site's origin URL", f.originUrl ?? d.originUrl, vUrl);
+    const priceUsdc = await ask(reader, "Read price (USDC)", f.priceUsdc ?? String(d.priceUsdc), vPositive);
+    const citationMultiplier = await ask(reader, "Citation multiplier (× a read)", f.citationMultiplier ?? String(d.citationMultiplier), vPositive);
+    const articlePrefixes = await ask(reader, "Gateable path prefixes (csv)", f.articlePrefixes ?? d.articlePrefixes, vNonEmpty);
+    const tollgatePort = await ask(reader, "Tollgate port", f.tollgatePort ?? String(d.tollgatePort), vPort);
+    const paymentMode = await ask(reader, "Settlement mode", f.paymentMode ?? d.paymentMode, vMode);
+    const settlementNetwork = paymentMode === "gateway"
+        ? await ask(reader, "Settlement network", f.settlementNetwork ?? d.settlementNetwork, vNetwork)
+        : d.settlementNetwork;
+    const defaultWallet = await ask(reader, "Default author wallet (blank = placeholder)", f.defaultWallet ?? "", vWallet);
+    const starterSlug = await ask(reader, "Starter article slug", f.starterSlug ?? d.starterSlug, vNonEmpty);
+    const starterTitle = await ask(reader, "Starter article title", f.starterTitle ?? d.starterTitle, vNonEmpty);
+    return initAnswersSchema.parse({
+        originUrl,
+        priceUsdc: Number(priceUsdc),
+        citationMultiplier: Number(citationMultiplier),
+        paymentMode,
+        settlementNetwork,
+        tollgatePort: Number(tollgatePort),
+        articlePrefixes,
+        creditsPath: f.creditsPath ?? d.creditsPath,
+        starterSlug,
+        starterTitle,
+        starterAuthorId: f.starterAuthorId ?? d.starterAuthorId,
+        defaultWallet: defaultWallet === "" ? undefined : defaultWallet,
+    });
+}
+export async function initMain(argv) {
+    const f = parseInitFlags(argv);
+    if (f.help) {
+        console.log(USAGE);
+        return 0;
+    }
+    // One reader for the whole interactive flow (answers + overwrite confirms). --yes uses none.
+    const reader = f.yes ? null : makeReader();
+    const written = [];
+    const skipped = [];
+    try {
+        let answers;
+        try {
+            answers = await gather(f, reader ?? { next: async () => null, close: () => { } });
+        }
+        catch (e) {
+            console.error(`✗ ${e instanceof Error ? e.message : String(e)}`);
+            return 2;
+        }
+        const plan = buildInitPlan(answers);
+        const dir = resolve(f.dir);
+        const files = [plan.env, plan.credits];
+        // Refuse to clobber. Interactive → confirm per file; --yes → skip unless --force.
+        for (const file of files) {
+            const abs = join(dir, file.path);
+            if (existsSync(abs) && !f.force) {
+                let overwrite = false;
+                if (reader) {
+                    process.stdout.write(`  ⚠ ${file.path} exists — overwrite? ${DIM}[y/N]${RESET} `);
+                    const a = (await reader.next())?.trim().toLowerCase() ?? "";
+                    overwrite = a === "y" || a === "yes";
+                }
+                if (!overwrite) {
+                    skipped.push(file.path);
+                    continue;
+                }
+            }
+            await writeFile(abs, file.contents, "utf8");
+            written.push(file.path);
+        }
+        printOutcome(written, skipped, plan);
+    }
+    finally {
+        reader?.close();
+    }
+    return 0;
+}
+function printOutcome(written, skipped, plan) {
+    console.log("");
+    for (const p of written)
+        console.log(`  ✓ wrote ${p}`);
+    for (const p of skipped)
+        console.log(`  ${DIM}• kept ${p} (exists — pass --force to overwrite)${RESET}`);
+    for (const w of plan.warnings)
+        console.log(`  ⚠ ${w}`);
+    if (written.length > 0) {
+        console.log(`\n  ${BOLD}Next:${RESET}`);
+        for (const s of plan.nextSteps)
+            console.log(`    → ${s}`);
+    }
+}
+// Run only when invoked directly as the bin, not when imported (by a test or the dispatcher).
+if (process.argv[1] && /init\.(ts|js)$/.test(process.argv[1])) {
+    void initMain(process.argv.slice(2)).then((c) => process.exit(c));
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/naulon.d.ts

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

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

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

package/dist/cli/naulon.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * `naulon` — the setup CLI entry point. Dispatches to a subcommand.
+ *
+ *   naulon init        set up a gate (writes .env + a starter credits.json)
+ *   naulon check       conformance-check a credits endpoint (was `naulon-kit check`)
+ *
+ * Kept as one thin dispatcher so `naulon-kit check …` (the historical bin) still works
+ * unchanged — both bins point here.
+ */
+import { checkMain } from "./check.js";
+import { initMain } from "./init.js";
+import { doctorMain } from "./doctor.js";
+import { crawlMain } from "./crawl.js";
+const HELP = `naulon — the citation-toll setup CLI
+
+usage: naulon <command> [options]
+
+commands:
+  init     set up a gate: writes .env + a starter credits.json  (--yes for non-interactive)
+  crawl    draft credits.json from your own origin (WordPress/RSS/sitemap)  (--dry-run)
+  doctor   health-check your own gate (env + credits + live human/agent probe)
+  check    conformance-check a publisher's /credits endpoint     (baseUrl --slug <s>)
+
+run \`naulon <command> --help\` for command options.`;
+async function main() {
+    const [cmd, ...rest] = process.argv.slice(2);
+    switch (cmd) {
+        case "init":
+            return initMain(rest);
+        case "crawl":
+            return crawlMain(rest);
+        case "doctor":
+            return doctorMain(rest);
+        case "check":
+            return checkMain(rest);
+        case undefined:
+        case "help":
+        case "--help":
+        case "-h":
+            console.log(HELP);
+            return 0;
+        default:
+            console.error(`unknown command: ${cmd}\n`);
+            console.error(HELP);
+            return 2;
+    }
+}
+void main().then((c) => process.exit(c));
+//# sourceMappingURL=naulon.js.map

package/dist/cli/naulon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naulon.js","sourceRoot":"","sources":["../../src/cli/naulon.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,IAAI,GAAG;;;;;;;;;;qDAUwC,CAAC;AAEtD,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7C,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpB,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/contract/credits.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The credits graph — the `/credits/:slug` response shape and its validator.
+ *
+ * `wallet` ultimately comes from whatever a publisher's credits source returns
+ * (an HTTP API, a static file, a DB). If that response is malformed or hostile,
+ * payments could route to the wrong wallet or crash the gate mid-flow. So every
+ * credits object crossing into the system is parsed through `creditsSchema` first:
+ * structure is checked, and crucially every leaf `wallet` must be a well-formed
+ * 0x address before it can ever become a `payTo`.
+ *
+ * A contributor is either a leaf (has a `wallet`) or a composite (has non-empty
+ * `members` that re-split recursively) — never both, never neither.
+ */
+import { z } from "zod";
+import { type WalletAddress } from "./wallet.ts";
+/**
+ * The credits graph node for one article. Co-authors may themselves be composites
+ * (e.g. a collective that splits again), hence the recursive shape resolved by the
+ * gate's attribution layer.
+ */
+export interface ArticleCredits {
+    slug: string;
+    title: string;
+    /** Direct contributors. Weights are relative; they get normalized to shares. */
+    contributors: Contributor[];
+}
+export interface Contributor {
+    authorId: string;
+    /** Relative weight of this contributor among siblings (default 1). */
+    weight?: number;
+    /** A leaf author resolves to a wallet... */
+    wallet?: WalletAddress;
+    /** ...or a composite re-splits among its own members (recursive). */
+    members?: Contributor[];
+}
+export declare const creditsSchema: z.ZodObject<{
+    slug: z.ZodString;
+    title: z.ZodString;
+    contributors: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strict>;
+/**
+ * Parse + validate one credits object. Throws a descriptive error on anything
+ * malformed. `context` (e.g. the slug or source URL) is woven into the message
+ * so a bad upstream response is traceable.
+ */
+export declare function parseCredits(raw: unknown, context?: string): ArticleCredits;
+/**
+ * A validating builder for publishers producing a credits payload. Runs the same
+ * schema as the consume side, so a publisher cannot emit a malformed object that
+ * the gate would later reject — the error surfaces at construction instead.
+ */
+export declare function buildCredits(input: unknown): ArticleCredits;
+//# sourceMappingURL=credits.d.ts.map

package/dist/contract/credits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["../../src/contract/credits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,qEAAqE;IACrE,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CACzB;AAkBD,eAAO,MAAM,aAAa;;;;kBAMf,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,SAAY,GAAG,cAAc,CAS9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAE3D"}

package/dist/contract/credits.js

@@ -0,0 +1,56 @@
+/**
+ * The credits graph — the `/credits/:slug` response shape and its validator.
+ *
+ * `wallet` ultimately comes from whatever a publisher's credits source returns
+ * (an HTTP API, a static file, a DB). If that response is malformed or hostile,
+ * payments could route to the wrong wallet or crash the gate mid-flow. So every
+ * credits object crossing into the system is parsed through `creditsSchema` first:
+ * structure is checked, and crucially every leaf `wallet` must be a well-formed
+ * 0x address before it can ever become a `payTo`.
+ *
+ * A contributor is either a leaf (has a `wallet`) or a composite (has non-empty
+ * `members` that re-split recursively) — never both, never neither.
+ */
+import { z } from "zod";
+import { walletSchema } from "./wallet.js";
+// Recursive: a composite's members are themselves contributors.
+const contributorSchema = z.lazy(() => z
+    .object({
+    authorId: z.string().min(1),
+    weight: z.number().positive().optional(),
+    wallet: walletSchema.optional(),
+    members: z.array(contributorSchema).min(1).optional(),
+})
+    .strict()
+    .refine((c) => (c.wallet === undefined) !== (c.members === undefined), "a contributor must have exactly one of `wallet` (leaf) or `members` (composite)"));
+export const creditsSchema = z
+    .object({
+    slug: z.string().min(1),
+    title: z.string().min(1),
+    contributors: z.array(contributorSchema).min(1),
+})
+    .strict();
+/**
+ * Parse + validate one credits object. Throws a descriptive error on anything
+ * malformed. `context` (e.g. the slug or source URL) is woven into the message
+ * so a bad upstream response is traceable.
+ */
+export function parseCredits(raw, context = "credits") {
+    const result = creditsSchema.safeParse(raw);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`)
+            .join("\n");
+        throw new Error(`invalid ${context}:\n${issues}`);
+    }
+    return result.data;
+}
+/**
+ * A validating builder for publishers producing a credits payload. Runs the same
+ * schema as the consume side, so a publisher cannot emit a malformed object that
+ * the gate would later reject — the error surfaces at construction instead.
+ */
+export function buildCredits(input) {
+    return parseCredits(input, "buildCredits");
+}
+//# sourceMappingURL=credits.js.map

package/dist/contract/credits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.js","sourceRoot":"","sources":["../../src/contract/credits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAwB/D,gEAAgE;AAChE,MAAM,iBAAiB,GAAuB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACxD,CAAC;KACE,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,EAC7D,iFAAiF,CAClF,CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAChD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,OAAO,GAAG,SAAS;IAC5D,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,MAAM,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC,IAAsB,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,YAAY,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAC7C,CAAC"}

package/dist/contract/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./wallet.ts";
+export * from "./credits.ts";
+export * from "./settlement.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/contract/index.js

@@ -0,0 +1,4 @@
+export * from "./wallet.js";
+export * from "./credits.js";
+export * from "./settlement.js";
+//# sourceMappingURL=index.js.map

package/dist/contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/contract/settlement.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The settlement wire contract — the body naulon POSTs to a publisher's earnings
+ * receiver after a paid read settles on-chain (`POST /api/credits/settlement`).
+ *
+ * The PRODUCER side (`signSettlement` + the gate's `buildSettlementBody`) and the
+ * VERIFY side (`verifySettlement`) both speak this shape; before this package the
+ * verify-side schema existed nowhere as shared code — it was hand-rolled in the
+ * reference publisher. `settlementBodySchema` is that mirror, written once.
+ */
+import { z } from "zod";
+import { type WalletAddress } from "./wallet.ts";
+/**
+ * The contract major version. Advertise it so an agent/publisher can see which
+ * contract a gate speaks; bump it (and the package major) on a breaking change.
+ * Within a major, only additive-optional fields may be introduced.
+ */
+export declare const CONTRACT_VERSION = 1;
+/** One author's recorded cut of a settled event, in integer micro-USDC. */
+export interface SettlementSplit {
+    authorId: string;
+    wallet: WalletAddress;
+    /** Integer micro-USDC as a string. Σ splits[].amount === grossAmount. */
+    amount: string;
+    /** Relative share as integer permille (decorative; `amount` is the truth). */
+    weight: number;
+    /** Exactly one split carries this — the wallet the on-chain leg paid. */
+    primary?: true;
+}
+/** The exact JSON body a settlement receiver expects. */
+export interface SettlementBody {
+    eventId: string;
+    slug: string;
+    txHash: string;
+    chainId: number;
+    currency: "USDC";
+    grossAmount: string;
+    paidTo: WalletAddress;
+    payer: WalletAddress | null;
+    settledAt: string;
+    splits: SettlementSplit[];
+}
+export declare const settlementSplitSchema: z.ZodObject<{
+    authorId: z.ZodString;
+    wallet: z.ZodString;
+    amount: z.ZodString;
+    weight: z.ZodNumber;
+    primary: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strict>;
+export declare const settlementBodySchema: z.ZodObject<{
+    eventId: z.ZodString;
+    slug: z.ZodString;
+    txHash: z.ZodString;
+    chainId: z.ZodNumber;
+    currency: z.ZodLiteral<"USDC">;
+    grossAmount: z.ZodString;
+    paidTo: z.ZodString;
+    payer: z.ZodNullable<z.ZodString>;
+    settledAt: z.ZodString;
+    splits: z.ZodArray<z.ZodObject<{
+        authorId: z.ZodString;
+        wallet: z.ZodString;
+        amount: z.ZodString;
+        weight: z.ZodNumber;
+        primary: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+//# sourceMappingURL=settlement.d.ts.map

package/dist/contract/settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.d.ts","sourceRoot":"","sources":["../../src/contract/settlement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,eAAO,MAAM,qBAAqB;;;;;;kBAQvB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;kBAwB7B,CAAC"}

package/dist/contract/settlement.js

@@ -0,0 +1,52 @@
+/**
+ * The settlement wire contract — the body naulon POSTs to a publisher's earnings
+ * receiver after a paid read settles on-chain (`POST /api/credits/settlement`).
+ *
+ * The PRODUCER side (`signSettlement` + the gate's `buildSettlementBody`) and the
+ * VERIFY side (`verifySettlement`) both speak this shape; before this package the
+ * verify-side schema existed nowhere as shared code — it was hand-rolled in the
+ * reference publisher. `settlementBodySchema` is that mirror, written once.
+ */
+import { z } from "zod";
+import { walletSchema } from "./wallet.js";
+/**
+ * The contract major version. Advertise it so an agent/publisher can see which
+ * contract a gate speaks; bump it (and the package major) on a breaking change.
+ * Within a major, only additive-optional fields may be introduced.
+ */
+export const CONTRACT_VERSION = 1;
+export const settlementSplitSchema = z
+    .object({
+    authorId: z.string().min(1),
+    wallet: walletSchema,
+    amount: z.string().regex(/^\d+$/, "amount must be integer micro-USDC"),
+    weight: z.number().int().nonnegative(),
+    primary: z.literal(true).optional(),
+})
+    .strict();
+export const settlementBodySchema = z
+    .object({
+    eventId: z.string().min(1),
+    slug: z.string().min(1),
+    txHash: z.string(),
+    chainId: z.number().int(),
+    currency: z.literal("USDC"),
+    grossAmount: z.string().regex(/^\d+$/, "grossAmount must be integer micro-USDC"),
+    paidTo: walletSchema,
+    payer: walletSchema.nullable(),
+    settledAt: z.string(),
+    splits: z.array(settlementSplitSchema).min(1),
+})
+    .strict()
+    .superRefine((b, ctx) => {
+    // Money invariant: Σ splits.amount === grossAmount (dust-free).
+    const sum = b.splits.reduce((acc, s) => acc + BigInt(s.amount), 0n);
+    if (sum !== BigInt(b.grossAmount)) {
+        ctx.addIssue({ code: "custom", message: "splits must conserve grossAmount" });
+    }
+    // Exactly one split is the on-chain recipient.
+    if (b.splits.filter((s) => s.primary).length !== 1) {
+        ctx.addIssue({ code: "custom", message: "exactly one split must be primary" });
+    }
+});
+//# sourceMappingURL=settlement.js.map

package/dist/contract/settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.js","sourceRoot":"","sources":["../../src/contract/settlement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AA4BlC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,mCAAmC,CAAC;IACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,wCAAwC,CAAC;IAChF,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9C,CAAC;KACD,MAAM,EAAE;KACR,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;IACtB,gEAAgE;IAChE,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,IAAI,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,+CAA+C;IAC/C,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/contract/wallet.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The wallet address primitive — the single home for the `0x…40-hex` regex that
+ * was previously hand-copied four times across the gate, the publisher, and the
+ * settlement receiver.
+ *
+ * Two faces of the same rule:
+ *  - `walletSchema` validates a PLAIN string (publisher-friendly; what crosses the
+ *    wire and what the credits/settlement schemas compose).
+ *  - the branded `WalletAddress` + `walletAddress()` constructor give internal code
+ *    type-safety against mixing an arbitrary string with a validated address.
+ */
+import { z } from "zod";
+/** The one regex. An EVM/Arc address: `0x` + 40 hex digits. */
+export declare const WALLET_RE: RegExp;
+/** An on-chain wallet address (Arc / EVM-style 0x...). Branded to avoid mixups. */
+export type WalletAddress = string & {
+    readonly __brand: "WalletAddress";
+};
+/** Zod validator over a plain string — composes into the credits + settlement schemas. */
+export declare const walletSchema: z.ZodString;
+/** Validate + brand. Throws on a malformed address so a bad value can never become a `payTo`. */
+export declare function walletAddress(value: string): WalletAddress;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/contract/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/contract/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+DAA+D;AAC/D,eAAO,MAAM,SAAS,QAAwB,CAAC;AAE/C,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAE3E,0FAA0F;AAC1F,eAAO,MAAM,YAAY,aAEyC,CAAC;AAEnE,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAK1D"}

package/dist/contract/wallet.js

@@ -0,0 +1,26 @@
+/**
+ * The wallet address primitive — the single home for the `0x…40-hex` regex that
+ * was previously hand-copied four times across the gate, the publisher, and the
+ * settlement receiver.
+ *
+ * Two faces of the same rule:
+ *  - `walletSchema` validates a PLAIN string (publisher-friendly; what crosses the
+ *    wire and what the credits/settlement schemas compose).
+ *  - the branded `WalletAddress` + `walletAddress()` constructor give internal code
+ *    type-safety against mixing an arbitrary string with a validated address.
+ */
+import { z } from "zod";
+/** The one regex. An EVM/Arc address: `0x` + 40 hex digits. */
+export const WALLET_RE = /^0x[0-9a-fA-F]{40}$/;
+/** Zod validator over a plain string — composes into the credits + settlement schemas. */
+export const walletSchema = z
+    .string()
+    .regex(WALLET_RE, "wallet must be a 0x-prefixed 40-hex address");
+/** Validate + brand. Throws on a malformed address so a bad value can never become a `payTo`. */
+export function walletAddress(value) {
+    if (!WALLET_RE.test(value)) {
+        throw new Error(`invalid wallet address: ${value}`);
+    }
+    return value;
+}
+//# sourceMappingURL=wallet.js.map

package/dist/contract/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/contract/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+DAA+D;AAC/D,MAAM,CAAC,MAAM,SAAS,GAAG,qBAAqB,CAAC;AAK/C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,EAAE;KACR,KAAK,CAAC,SAAS,EAAE,6CAA6C,CAAC,CAAC;AAEnE,iGAAiG;AACjG,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC"}

package/dist/crawl/adapters/rss.d.ts

@@ -0,0 +1,12 @@
+/**
+ * crawl/adapters/rss.ts — the always-available RSS/Atom feed adapter.
+ *
+ * The lowest-rank fallback: nearly every CMS exposes an RSS 2.0 or Atom feed. It yields
+ * title, URL, author (`<author>`/`<dc:creator>` for RSS, `<author><name>` for Atom), and
+ * publish date — enough for the catalog plane. Authors are feed STRINGS only (the map key);
+ * never a wallet. All fetches go through the guarded fetcher, so even a derived feed URL can
+ * only ever hit the proven origin host.
+ */
+import type { SourceAdapter } from "../types.ts";
+export declare const rssAdapter: SourceAdapter;
+//# sourceMappingURL=rss.d.ts.map

package/dist/crawl/adapters/rss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rss.d.ts","sourceRoot":"","sources":["../../../src/crawl/adapters/rss.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAuD,aAAa,EAAE,MAAM,aAAa,CAAC;AA4GtG,eAAO,MAAM,UAAU,EAAE,aAUxB,CAAC"}