codequill 0.8.1-beta.0

package/dist/services/snapshotIndex.js

@@ -0,0 +1,401 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { ensureDir, fileExists } from "./fs.js";
+export function defaultSnapshotIndexPaths() {
+    const codequillDir = '.codequill';
+    const snapshotsDir = path.join(codequillDir, 'snapshots');
+    return {
+        codequillDir,
+        snapshotsDir,
+        indexFile: path.join(snapshotsDir, 'index.json'),
+    };
+}
+function nowSec() {
+    return Math.floor(Date.now() / 1000);
+}
+function safeNum(n, fallback = 0) {
+    const v = typeof n === 'number' && Number.isFinite(n) ? n : fallback;
+    return v;
+}
+/**
+ * Atomic JSON write:
+ * - write tmp in same directory
+ * - rename over target
+ */
+async function writeJsonAtomic(filePath, obj) {
+    const dir = path.dirname(filePath);
+    await ensureDir(dir);
+    const tmp = `${filePath}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(obj, null, 2), 'utf8');
+    await fs.rename(tmp, filePath);
+}
+function sortNewestFirst(a, b) {
+    const ap = safeNum(a.published?.published_at, 0);
+    const bp = safeNum(b.published?.published_at, 0);
+    // Prefer published timestamp if exists; else fall back to manifest timestamp.
+    const at = ap > 0 ? ap : safeNum(a.timestamp, 0);
+    const bt = bp > 0 ? bp : safeNum(b.timestamp, 0);
+    if (bt !== at)
+        return bt - at;
+    // stable tie-breakers
+    const ar = String(a.merkle_root);
+    const br = String(b.merkle_root);
+    if (ar !== br)
+        return ar.localeCompare(br);
+    const af = String(a.file ?? '');
+    const bf = String(b.file ?? '');
+    return af.localeCompare(bf);
+}
+function computeLatest(idx) {
+    // latest.local: newest item that has a local file (local or pulled)
+    const localCandidate = idx.items
+        .filter((it) => it.file && (it.kind === 'local' || it.kind === 'pulled'))
+        .sort(sortNewestFirst)[0];
+    // latest.published: newest item that has published meta (could be remote-only)
+    const pubCandidate = idx.items
+        .filter((it) => !!it.published)
+        .sort(sortNewestFirst)[0];
+    idx.latest = {
+        local: localCandidate?.merkle_root ?? null,
+        published: pubCandidate?.merkle_root ?? null,
+    };
+}
+async function readJsonFileSafe(filePathAbs) {
+    try {
+        const raw = await fs.readFile(filePathAbs, 'utf8');
+        if (!raw)
+            return null;
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export class SnapshotIndex {
+    repoRoot;
+    repoName;
+    paths;
+    idx = null;
+    constructor(args) {
+        this.repoRoot = path.resolve(args.repoRoot);
+        this.repoName = args.repoName;
+        this.paths = args.paths ?? defaultSnapshotIndexPaths();
+    }
+    abs(rel) {
+        return path.join(this.repoRoot, rel);
+    }
+    get indexFileAbs() {
+        return this.abs(this.paths.indexFile);
+    }
+    get snapshotsDirAbs() {
+        return this.abs(this.paths.snapshotsDir);
+    }
+    /**
+     * Load index if present & valid; otherwise rebuild from disk.
+     * Always ensures .codequill/snapshots exists.
+     */
+    async load() {
+        await ensureDir(this.snapshotsDirAbs);
+        const file = this.indexFileAbs;
+        if (!(await fileExists(file))) {
+            // no index -> rebuild
+            this.idx = await this.rebuildFromDisk();
+            await this.save();
+            return this.idx;
+        }
+        const parsed = await readJsonFileSafe(file);
+        if (!parsed || parsed.version !== 'codequill-index:v1' || !Array.isArray(parsed.items) || typeof parsed.repo_name !== 'string') {
+            this.idx = await this.rebuildFromDisk();
+            await this.save();
+            return this.idx;
+        }
+        // Accept it, but still self-heal repo name & missing files quickly.
+        const idx = parsed;
+        idx.repo_name = this.repoName;
+        idx.updated_at = nowSec();
+        // Drop items pointing to missing files (they can come back on rebuild/pull)
+        idx.items = await this.filterMissingFiles(idx.items);
+        // Normalize roots + recompute latest/sort
+        idx.items = this.normalizeItems(idx.items);
+        idx.items.sort(sortNewestFirst);
+        computeLatest(idx);
+        this.idx = idx;
+        await this.save();
+        return idx;
+    }
+    get() {
+        if (!this.idx)
+            throw new Error('SnapshotIndex not loaded. Call await index.load() first.');
+        return this.idx;
+    }
+    async save() {
+        const idx = this.get();
+        idx.updated_at = nowSec();
+        idx.items = this.normalizeItems(idx.items);
+        idx.items.sort(sortNewestFirst);
+        computeLatest(idx);
+        await writeJsonAtomic(this.indexFileAbs, idx);
+    }
+    /**
+     * Hard rebuild from disk (snapshot folder is the source of truth).
+     * This is safe to call anytime (index deleted/corrupt, etc).
+     */
+    async rebuildFromDisk() {
+        await ensureDir(this.snapshotsDirAbs);
+        let entries = [];
+        try {
+            entries = await fs.readdir(this.snapshotsDirAbs);
+        }
+        catch {
+            entries = [];
+        }
+        const jsonFiles = entries
+            .filter((f) => f.toLowerCase().endsWith('.json'))
+            .filter((f) => f.toLowerCase() !== 'index.json');
+        const byRoot = new Map();
+        for (const fname of jsonFiles) {
+            const fileAbs = path.join(this.snapshotsDirAbs, fname);
+            const obj = await readJsonFileSafe(fileAbs);
+            if (!obj || typeof obj !== 'object')
+                continue;
+            const commit = String(obj.commit ?? '').trim();
+            const rootRaw = String(obj.merkle_root ?? '').trim();
+            const ts = safeNum(obj.timestamp, 0);
+            if (!rootRaw || !commit)
+                continue;
+            const relFile = path.join(this.paths.snapshotsDir, fname).split(path.sep).join('/');
+            const kind = fname.toLowerCase().startsWith('published-') ? 'pulled' : 'local';
+            const next = {
+                merkle_root: rootRaw,
+                commit,
+                timestamp: ts,
+                file: relFile,
+                kind,
+                published: null,
+            };
+            const existing = byRoot.get(rootRaw);
+            if (!existing) {
+                byRoot.set(rootRaw, next);
+                continue;
+            }
+            // ✅ Dedup rule: prefer LOCAL over PULLED, otherwise prefer newer timestamp
+            const existingScore = (existing.kind === 'local' ? 10 : 0) + safeNum(existing.timestamp, 0);
+            const nextScore = (next.kind === 'local' ? 10 : 0) + safeNum(next.timestamp, 0);
+            if (nextScore > existingScore) {
+                // keep published meta if it was already attached on the existing entry
+                byRoot.set(rootRaw, { ...next, published: existing.published ?? null });
+            }
+        }
+        const items = Array.from(byRoot.values());
+        const idx = {
+            version: 'codequill-index:v1',
+            repo_name: this.repoName,
+            updated_at: nowSec(),
+            items,
+            latest: { local: null, published: null },
+        };
+        idx.items = this.normalizeItems(idx.items);
+        idx.items.sort(sortNewestFirst);
+        computeLatest(idx);
+        this.idx = idx;
+        return idx;
+    }
+    /**
+     * Optional: enrich index with backend "published" list.
+     * - Matches by merkle_root (primary)
+     * - If a published snapshot exists but no local file exists, we add a remote-only item
+     *   so `log --on-chain` can still show it.
+     */
+    enrichFromBackend(published) {
+        const idx = this.get();
+        const byRoot = new Map();
+        for (const p of published) {
+            const r = p.merkle_root;
+            if (r)
+                byRoot.set(r, p);
+        }
+        // Attach to existing items
+        for (const it of idx.items) {
+            const p = byRoot.get(it.merkle_root);
+            if (!p)
+                continue;
+            it.published = {
+                snapshot_id: p.snapshot_id,
+                published_at: safeNum(p.published_at, 0),
+                tx_hash: p.tx_hash,
+                chain_id: p.chain_id,
+                manifest_cid: p.manifest_cid,
+                wallet_address: p.wallet_address,
+            };
+            // If file exists locally but was marked remote earlier, fix kind.
+            if (it.file && it.kind === 'remote') {
+                it.kind = it.file.toLowerCase().includes('published-') ? 'pulled' : 'local';
+            }
+        }
+        // Add remote-only items for published snapshots not present locally
+        const localRoots = new Set(idx.items.map((x) => x.merkle_root).filter(Boolean));
+        for (const p of published) {
+            const r = p.merkle_root;
+            if (!r || localRoots.has(r))
+                continue;
+            idx.items.push({
+                merkle_root: r,
+                commit: String(p.commit_hash ?? '').trim(),
+                timestamp: 0,
+                file: null,
+                kind: 'remote',
+                published: {
+                    snapshot_id: p.snapshot_id,
+                    published_at: safeNum(p.published_at, 0),
+                    tx_hash: p.tx_hash,
+                    chain_id: p.chain_id,
+                    manifest_cid: p.manifest_cid,
+                    wallet_address: p.wallet_address,
+                },
+            });
+        }
+        idx.items = this.normalizeItems(idx.items);
+        idx.items.sort(sortNewestFirst);
+        computeLatest(idx);
+    }
+    /**
+     * Convenience: after you write a manifest file (snapshot/pull),
+     * call this to upsert the disk item without scanning the whole folder.
+     * (Still safe even if you forget; rebuildFromDisk will fix.)
+     */
+    upsertFromManifestFile(args) {
+        const idx = this.get();
+        const commit = String(args.manifest?.commit ?? '').trim();
+        const root = String(args.manifest?.merkle_root ?? '').trim();
+        const ts = safeNum(args.manifest?.timestamp, 0);
+        if (!commit || !root)
+            return;
+        const kind = args.kind ?? 'local';
+        const file = String(args.manifestFileRel ?? '').split(path.sep).join('/');
+        // ✅ Uniqueness by file path
+        const existingIdx = idx.items.findIndex((it) => {
+            if (!it.file)
+                return false;
+            const f = String(it.file).split(path.sep).join('/');
+            return f === file;
+        });
+        if (existingIdx >= 0) {
+            const existing = idx.items[existingIdx];
+            // 🚫 If that indexed file is already published, do NOT replace it
+            if (existing.published) {
+                throw new Error(`Refusing to overwrite a published snapshot in the index.\n` +
+                    `File: ${file}\n` +
+                    `Published snapshot_id: ${existing.published.snapshot_id}\n` +
+                    `Tip: create a new snapshot for a different commit, or publish a different manifest file.`);
+            }
+            // Replace/update the existing local entry for that file
+            idx.items[existingIdx] = {
+                ...existing,
+                merkle_root: root,
+                commit,
+                timestamp: ts,
+                file,
+                kind,
+                published: null, // stays unpublished
+            };
+        }
+        else {
+            idx.items.push({
+                merkle_root: root,
+                commit,
+                timestamp: ts,
+                file,
+                kind,
+                published: null,
+            });
+        }
+        idx.items = this.normalizeItems(idx.items);
+        idx.items.sort(sortNewestFirst);
+        computeLatest(idx);
+    }
+    /**
+     * Convenience: after publish succeeds, attach published meta by merkle_root.
+     */
+    attachPublishedByRoot(args) {
+        const idx = this.get();
+        const r = args.merkle_root;
+        if (!r)
+            return;
+        const item = idx.items.find((x) => x.merkle_root === r);
+        if (item) {
+            item.published = args.meta;
+        }
+        else {
+            // If we don't have the manifest locally, still record as remote-only
+            idx.items.push({
+                merkle_root: r,
+                commit: '',
+                timestamp: 0,
+                file: null,
+                kind: 'remote',
+                published: args.meta,
+            });
+        }
+        idx.items = this.normalizeItems(idx.items);
+        idx.items.sort(sortNewestFirst);
+        computeLatest(idx);
+    }
+    /**
+     * Helper for status/log: list items (already sorted after load/save).
+     */
+    list() {
+        return this.get().items;
+    }
+    /**
+     * Quick accessors
+     */
+    latestLocalRoot() {
+        return this.get().latest.local ?? null;
+    }
+    latestPublishedRoot() {
+        return this.get().latest.published ?? null;
+    }
+    // ------------------------
+    // internal helpers
+    // ------------------------
+    normalizeItems(items) {
+        return items
+            .map((it) => {
+            const mr = it.merkle_root;
+            return {
+                ...it,
+                merkle_root: mr || (String(it.merkle_root ?? '')) || String(it.merkle_root ?? '').trim().toLowerCase(),
+                commit: String(it.commit ?? '').trim(),
+                timestamp: safeNum(it.timestamp, 0),
+                file: it.file ? String(it.file) : null,
+                kind: it.kind ?? (it.file ? 'local' : 'remote'),
+                published: it.published
+                    ? {
+                        snapshot_id: String(it.published.snapshot_id),
+                        published_at: safeNum(it.published.published_at, 0),
+                        tx_hash: it.published.tx_hash ? String(it.published.tx_hash) : undefined,
+                        chain_id: typeof it.published.chain_id === 'number' ? it.published.chain_id : undefined,
+                        manifest_cid: it.published.manifest_cid ? String(it.published.manifest_cid) : undefined,
+                        wallet_address: it.published.wallet_address ? String(it.published.wallet_address) : undefined,
+                    }
+                    : null,
+            };
+        })
+            .filter((it) => !!it.merkle_root); // require root
+    }
+    async filterMissingFiles(items) {
+        const out = [];
+        for (const it of items) {
+            if (!it.file) {
+                out.push(it);
+                continue;
+            }
+            const absP = this.abs(it.file);
+            if (await fileExists(absP))
+                out.push(it);
+            // if file missing, drop it; rebuild/pull can restore
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=snapshotIndex.js.map

package/dist/services/snapshotIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotIndex.js","sourceRoot":"","sources":["../../src/services/snapshotIndex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,SAAS,EAAE,UAAU,EAAC,MAAM,SAAS,CAAC;AAqC9C,MAAM,UAAU,yBAAyB;IACrC,MAAM,YAAY,GAAG,YAAY,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IAC1D,OAAO;QACH,YAAY;QACZ,YAAY;QACZ,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC;KACnD,CAAC;AACN,CAAC;AAqBD,SAAS,MAAM;IACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,OAAO,CAAC,CAAM,EAAE,QAAQ,GAAG,CAAC;IACjC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrE,OAAO,CAAC,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAQ;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACrB,MAAM,GAAG,GAAG,GAAG,QAAQ,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,eAAe,CAAC,CAAoB,EAAE,CAAoB;IAC/D,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAEjD,8EAA8E;IAC9E,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAEjD,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAE9B,sBAAsB;IACtB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACjC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IAE3C,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,aAAa,CAAC,GAAoB;IACvC,oEAAoE;IACpE,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK;SAC3B,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;SACxE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9B,+EAA+E;IAC/E,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK;SACzB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC;SAC9B,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9B,GAAG,CAAC,MAAM,GAAG;QACT,KAAK,EAAE,cAAc,EAAE,WAAW,IAAI,IAAI;QAC1C,SAAS,EAAE,YAAY,EAAE,WAAW,IAAI,IAAI;KAC/C,CAAC;AACN,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IAC/C,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,MAAM,OAAO,aAAa;IACb,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,KAAK,CAAqB;IAE3B,GAAG,GAA2B,IAAI,CAAC;IAE3C,YAAY,IAAwE;QAChF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,yBAAyB,EAAE,CAAC;IAC3D,CAAC;IAED,GAAG,CAAC,GAAW;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACN,MAAM,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAEtC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;QAC/B,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC5B,sBAAsB;YACtB,IAAI,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,GAAG,CAAC;QACpB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,oBAAoB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC7H,IAAI,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,GAAG,CAAC;QACpB,CAAC;QAED,oEAAoE;QACpE,MAAM,GAAG,GAAoB,MAAM,CAAC;QACpC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,GAAG,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;QAE1B,4EAA4E;QAC5E,GAAG,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAErD,0CAA0C;QAC1C,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChC,aAAa,CAAC,GAAG,CAAC,CAAC;QAEnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC;IACf,CAAC;IAED,GAAG;QACC,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,GAAG,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;QAC1B,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChC,aAAa,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe;QACjB,MAAM,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAEtC,IAAI,OAAO,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC;YACD,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,GAAG,EAAE,CAAC;QACjB,CAAC;QAED,MAAM,SAAS,GAAG,OAAO;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAChD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,CAAC;QAErD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;QAEpD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;YACvD,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,SAAS;YAE9C,MAAM,MAAM,GAAG,MAAM,CAAE,GAAuB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACpE,MAAM,OAAO,GAAG,MAAM,CAAE,GAAuB,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1E,MAAM,EAAE,GAAG,OAAO,CAAE,GAAuB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAE1D,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;gBAAE,SAAS;YAElC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpF,MAAM,IAAI,GACN,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YAEtE,MAAM,IAAI,GAAsB;gBAC5B,WAAW,EAAE,OAAO;gBACpB,MAAM;gBACN,SAAS,EAAE,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,IAAI;gBACJ,SAAS,EAAE,IAAI;aAClB,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAErC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1B,SAAS;YACb,CAAC;YAED,2EAA2E;YAC3E,MAAM,aAAa,GACf,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAC1E,MAAM,SAAS,GACX,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAElE,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;gBAC5B,uEAAuE;gBACvE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;YAC5E,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAE1C,MAAM,GAAG,GAAoB;YACzB,OAAO,EAAE,oBAAoB;YAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,UAAU,EAAE,MAAM,EAAE;YACpB,KAAK;YACL,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;SAC3C,CAAC;QAEF,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChC,aAAa,CAAC,GAAG,CAAC,CAAC;QAEnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,OAAO,GAAG,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,SAA6C;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4C,CAAC;QACnE,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;YACxB,IAAI,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC;QAED,2BAA2B;QAC3B,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;YACrC,IAAI,CAAC,CAAC;gBAAE,SAAS;YAEjB,EAAE,CAAC,SAAS,GAAG;gBACX,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,cAAc,EAAE,CAAC,CAAC,cAAc;aACnC,CAAC;YAEF,kEAAkE;YAClE,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAClC,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YAChF,CAAC;QACL,CAAC;QAED,oEAAoE;QACpE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAChF,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;YACxB,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAEtC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBACX,WAAW,EAAE,CAAC;gBACd,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;gBAC1C,SAAS,EAAE,CAAC;gBACZ,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE;oBACP,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;oBACxC,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,YAAY,EAAE,CAAC,CAAC,YAAY;oBAC5B,cAAc,EAAE,CAAC,CAAC,cAAc;iBACnC;aACJ,CAAC,CAAC;QACP,CAAC;QAED,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChC,aAAa,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,sBAAsB,CAAC,IAItB;QACG,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7D,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAEhD,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;YAAE,OAAO;QAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE1E,4BAA4B;QAC5B,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE;YAC3C,IAAI,CAAC,EAAE,CAAC,IAAI;gBAAE,OAAO,KAAK,CAAC;YAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpD,OAAO,CAAC,KAAK,IAAI,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAExC,kEAAkE;YAClE,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACX,4DAA4D;oBAC5D,SAAS,IAAI,IAAI;oBACjB,0BAA0B,QAAQ,CAAC,SAAS,CAAC,WAAW,IAAI;oBAC5D,0FAA0F,CAC7F,CAAC;YACN,CAAC;YAED,wDAAwD;YACxD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG;gBACrB,GAAG,QAAQ;gBACX,WAAW,EAAE,IAAI;gBACjB,MAAM;gBACN,SAAS,EAAE,EAAE;gBACb,IAAI;gBACJ,IAAI;gBACJ,SAAS,EAAE,IAAI,EAAE,oBAAoB;aACxC,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBACX,WAAW,EAAE,IAAI;gBACjB,MAAM;gBACN,SAAS,EAAE,EAAE;gBACb,IAAI;gBACJ,IAAI;gBACJ,SAAS,EAAE,IAAI;aAClB,CAAC,CAAC;QACP,CAAC;QAED,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChC,aAAa,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,IAAkD;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC3B,IAAI,CAAC,CAAC;YAAE,OAAO;QAEf,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC;QACxD,IAAI,IAAI,EAAE,CAAC;YACP,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;QAC/B,CAAC;aAAM,CAAC;YACJ,qEAAqE;YACrE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBACX,WAAW,EAAE,CAAC;gBACd,MAAM,EAAE,EAAE;gBACV,SAAS,EAAE,CAAC;gBACZ,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,IAAI,CAAC,IAAI;aACvB,CAAC,CAAC;QACP,CAAC;QAED,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChC,aAAa,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI;QACA,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,eAAe;QACX,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,mBAAmB;QACf,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;IAC/C,CAAC;IAED,2BAA2B;IAC3B,mBAAmB;IACnB,2BAA2B;IAEnB,cAAc,CAAC,KAA0B;QAC7C,OAAO,KAAK;aACP,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACR,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC;YAC1B,OAAO;gBACH,GAAG,EAAE;gBACL,WAAW,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;gBACtG,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;gBACtC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;gBACnC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;gBACtC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC/C,SAAS,EAAE,EAAE,CAAC,SAAS;oBACnB,CAAC,CAAC;wBACE,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC;wBAC7C,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;wBACnD,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;wBACxE,QAAQ,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;wBACvF,YAAY,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;wBACvF,cAAc,EAAE,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;qBAChG;oBACD,CAAC,CAAC,IAAI;aACb,CAAC;QACN,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe;IAC1D,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,KAA0B;QACvD,MAAM,GAAG,GAAwB,EAAE,CAAC;QACpC,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;gBACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACb,SAAS;YACb,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzC,qDAAqD;QACzD,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;CACJ"}

package/dist/services/txWaiter.js

@@ -0,0 +1,84 @@
+import { spinner, colors } from './ui.js';
+import { apiClient } from './apiClient.js';
+import { ApiError } from './errors.js';
+/**
+ * Wait for a tx to be confirmed (or fail), using backend polling (seamless for npm CLI).
+ * Backend endpoint expected:
+ *   GET /v1/cli/tx/:txHash?chain_id=137
+ */
+export async function waitForTxConfirmation(opts) {
+    const confirmationsTarget = Math.max(1, Number(opts.confirmations ?? 1));
+    const pollIntervalMs = Math.max(500, Number(opts.pollIntervalMs ?? 3000));
+    const timeoutMs = Math.max(10_000, Number(opts.timeoutMs ?? 5 * 60_000));
+    const endpointBase = (opts.endpointBase ?? '/v1/cli/tx').replace(/\/+$/, '');
+    const txHash = String(opts.txHash);
+    const s = spinner(`Waiting for confirmation (${confirmationsTarget}+ conf)…`, opts.silent);
+    const started = Date.now();
+    let last = null;
+    const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+    try {
+        while (true) {
+            const elapsed = Date.now() - started;
+            if (elapsed > timeoutMs) {
+                s.fail(colors.warn('Timed out waiting for confirmation.'));
+                const hint = last?.explorer_url ? `\nExplorer: ${last.explorer_url}` : '';
+                throw new Error(`Timeout waiting for tx ${txHash}.${hint}`);
+            }
+            let res;
+            try {
+                res = await apiClient.get(`${endpointBase}/${txHash}`);
+                last = res;
+            }
+            catch (e) {
+                // If backend endpoint not implemented yet, make this error helpful
+                if (e instanceof ApiError) {
+                    s.fail(colors.error('Failed to check tx status.'));
+                    const extra = [
+                        `Status:      ${e.status}`,
+                        e.requestId ? `Request ID:  ${e.requestId}` : null,
+                        e.method && e.url ? `Endpoint:   ${e.method} ${e.url}` : null,
+                        '',
+                        'Hint: backend needs a tx status endpoint:',
+                        `  GET ${endpointBase}/:txHash?chain_id=<id>`,
+                    ].filter(Boolean).join('\n');
+                    throw new Error(`${e.message}\n${extra}`);
+                }
+                s.fail(colors.error('Failed to check tx status.'));
+                throw e;
+            }
+            if (res.status === 'failed') {
+                s.fail(colors.error('Transaction failed.'));
+                const reason = res.reason ? `\nReason: ${res.reason}` : '';
+                const hint = res.explorer_url ? `\nExplorer: ${res.explorer_url}` : '';
+                throw new Error(`Tx failed: ${txHash}.${reason}${hint}`);
+            }
+            if (res.status === 'confirmed') {
+                const confNow = Number(res.confirmations ?? confirmationsTarget);
+                if (confNow >= confirmationsTarget) {
+                    const blockTxt = res.block_number ? `block ${res.block_number}` : 'confirmed';
+                    s.succeed(colors.success(`Confirmed (${blockTxt})`));
+                    return res;
+                }
+                s.text = `Waiting for confirmation (${confNow}/${confirmationsTarget})…`;
+            }
+            else {
+                // pending
+                const confNow = Number(res.confirmations ?? 0);
+                s.text = confNow > 0
+                    ? `Waiting for confirmation (${confNow}/${confirmationsTarget})…`
+                    : `Waiting for transaction to be mined…`;
+            }
+            const waitMs = Math.max(500, Number(res.next_poll_ms ?? pollIntervalMs));
+            await sleep(waitMs);
+        }
+    }
+    catch (e) {
+        // ensure spinner stops
+        try {
+            s.stop();
+        }
+        catch { }
+        throw e;
+    }
+}
+//# sourceMappingURL=txWaiter.js.map

package/dist/services/txWaiter.js.map

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

package/dist/services/ui.js

@@ -0,0 +1,98 @@
+import kleur from 'kleur';
+import ora from 'ora';
+import { spawn } from 'node:child_process';
+export const colors = {
+    success: (s) => kleur.green(s),
+    error: (s) => kleur.red(s),
+    warn: (s) => kleur.yellow(s),
+    info: (s) => kleur.cyan(s),
+    bold: (s) => kleur.bold(s),
+    dim: (s) => kleur.dim(s),
+};
+export function spinner(text, silent) {
+    const s = ora({ text, spinner: 'dots' });
+    if (silent) {
+        // @ts-ignore
+        s.start = () => s;
+        // @ts-ignore
+        s.stop = () => s;
+        // @ts-ignore
+        s.succeed = () => s;
+        // @ts-ignore
+        s.fail = () => s;
+        // @ts-ignore
+        s.stopAndPersist = () => s;
+    }
+    else {
+        s.start();
+    }
+    return s;
+}
+export function shortAddr(a) {
+    const x = String(a || '').trim();
+    if (!x)
+        return '—';
+    if (x.length <= 18)
+        return x;
+    return `${x.slice(0, 6)}...${x.slice(-4)}`;
+}
+export function shortHash(hash, length = 12) {
+    const s = String(hash ?? '');
+    return s.length > length ? s.slice(0, length) : s;
+}
+export function shortCommit(commit, length = 12) {
+    const s = String(commit ?? '').trim();
+    return s.length > 12 ? s.slice(0, 12) : s;
+}
+export function fmtTime(ts) {
+    if (!ts || !Number.isFinite(ts))
+        return '—';
+    try {
+        return new Date(ts * 1000).toISOString().replace('T', ' ').replace('.000Z', ' UTC');
+    }
+    catch {
+        return '—';
+    }
+}
+export function relativeTime(ts) {
+    const now = Math.floor(Date.now() / 1000);
+    const diff = Math.max(0, now - ts);
+    const min = Math.floor(diff / 60);
+    const hr = Math.floor(diff / 3600);
+    const day = Math.floor(diff / 86400);
+    const wk = Math.floor(diff / 604800);
+    if (diff < 60)
+        return 'just now';
+    if (min < 60)
+        return `${min} min ago`;
+    if (hr < 48)
+        return `${hr} hour${hr === 1 ? '' : 's'} ago`;
+    if (day < 14)
+        return `${day} day${day === 1 ? '' : 's'} ago`;
+    return `${wk} week${wk === 1 ? '' : 's'} ago`;
+}
+export function tryOpenBrowser(url) {
+    const platform = process.platform;
+    let cmd;
+    let args = [];
+    if (platform === 'darwin') {
+        cmd = 'open';
+        args = [url];
+    }
+    else if (platform === 'win32') {
+        cmd = 'cmd';
+        args = ['/c', 'start', '""', url];
+    }
+    else {
+        cmd = 'xdg-open';
+        args = [url];
+    }
+    try {
+        const child = spawn(cmd, args, { stdio: 'ignore', detached: true });
+        child.unref();
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=ui.js.map

package/dist/services/ui.js.map

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

package/dist/services/utilities.js

@@ -0,0 +1,45 @@
+import { isExpired, loadTokens } from "./authStore.js";
+import { colors } from "./ui.js";
+import { getConfigFilePath } from "./config.js";
+import { randomBytes } from "node:crypto";
+import { createRequire } from "node:module";
+export function assertAuthenticated() {
+    const tokens = loadTokens();
+    if (!tokens) {
+        console.error(colors.error('Not logged in. Run `codequill login` first.'));
+        console.error(colors.dim(`No tokens found at: ${getConfigFilePath()}`));
+        process.exitCode = 1;
+        return false;
+    }
+    if (isExpired(tokens) && !tokens.refresh_token) {
+        console.error(colors.error('Session expired. Run `codequill login` to re-authenticate.'));
+        console.error(colors.dim(`Token file: ${getConfigFilePath()}`));
+        process.exitCode = 1;
+        return false;
+    }
+    return true;
+}
+export function getCliVersion() {
+    // ESM-safe way to read package.json
+    try {
+        const require = createRequire(import.meta.url);
+        const pkg = require('../../package.json');
+        return String(pkg?.version ?? 'unknown');
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export function randomSaltHex32() {
+    return randomBytes(32).toString('hex');
+}
+export function chainName(chainId) {
+    if (!chainId || !Number.isFinite(chainId))
+        return null;
+    if (chainId === 11155111)
+        return 'Sepolia Testnet';
+    if (chainId === 1)
+        return 'Ethereum Mainnet';
+    return `chain ${chainId}`;
+}
+//# sourceMappingURL=utilities.js.map