@hardkas/toolkit 0.11.1-alpha

package/dist/snapshot/backends/MemorySnapshotBackend.js

@@ -0,0 +1,55 @@
+import crypto from "crypto";
+import { snapshotReplacer, snapshotReviver } from "../serialization.js";
+export class MemorySnapshotBackend {
+    snapshots = new Map();
+    async save(id, name, state) {
+        const stateHashes = {};
+        const participants = Object.keys(state);
+        for (const [pId, pState] of Object.entries(state)) {
+            stateHashes[pId] = crypto.createHash("sha256").update(JSON.stringify(pState, snapshotReplacer)).digest("hex");
+        }
+        const manifest = {
+            schema: "hardkas.snapshot.v1",
+            snapshotId: id,
+            name,
+            createdAt: Date.now(),
+            backend: "memory",
+            participants,
+            stateHashes,
+            claims: {
+                containsFullStateInline: true,
+                restorableLocalState: true,
+                networkStateCaptured: false
+            }
+        };
+        // Deep copy state to ensure isolation
+        const deepCopiedState = JSON.parse(JSON.stringify(state, snapshotReplacer), snapshotReviver);
+        this.snapshots.set(id, { manifest, state: deepCopiedState });
+        return manifest;
+    }
+    async load(id) {
+        const entry = this.snapshots.get(id);
+        if (!entry) {
+            throw new Error(`Snapshot ${id} not found in memory backend`);
+        }
+        // Return a deep copy to prevent mutation of the snapshot itself
+        return {
+            manifest: JSON.parse(JSON.stringify(entry.manifest)),
+            state: JSON.parse(JSON.stringify(entry.state, snapshotReplacer), snapshotReviver)
+        };
+    }
+    async list() {
+        return Array.from(this.snapshots.values()).map(s => s.manifest);
+    }
+    async delete(id) {
+        this.snapshots.delete(id);
+    }
+    async branch(baseId, newId, newName) {
+        const entry = this.snapshots.get(baseId);
+        if (!entry)
+            throw new Error(`Base snapshot ${baseId} not found`);
+        const newState = JSON.parse(JSON.stringify(entry.state, snapshotReplacer), snapshotReviver);
+        return this.save(newId, newName, newState);
+    }
+}
+//# sourceMappingURL=MemorySnapshotBackend.js.map

package/dist/snapshot/backends/MemorySnapshotBackend.js.map

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

package/dist/snapshot/index.d.ts

@@ -0,0 +1,19 @@
+import { SnapshotManifest, SnapshotParticipant } from "./types.js";
+export interface SnapshotToolkitOptions {
+    backend?: "memory" | "filesystem";
+    dir?: string;
+}
+export declare class SnapshotToolkit {
+    private backend;
+    private participants;
+    private constructor();
+    static open(options?: SnapshotToolkitOptions): SnapshotToolkit;
+    register(id: string, participant: SnapshotParticipant): void;
+    create(name: string): Promise<SnapshotManifest>;
+    restore(id: string): Promise<void>;
+    branch(baseId: string, newName: string): Promise<SnapshotManifest>;
+    diff(idA: string, idB: string): Promise<Record<string, any>>;
+    compare(idA: string, idB: string): Promise<boolean>;
+    list(): Promise<SnapshotManifest[]>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,gBAAgB,EAAE,mBAAmB,EAAiB,MAAM,YAAY,CAAC;AAKnG,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;IACxB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,YAAY,CAA0C;IAE9D,OAAO;WAQO,IAAI,CAAC,OAAO,GAAE,sBAA8C,GAAG,eAAe;IAIrF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAItD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY/C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BlC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKlE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAmB5D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKnD,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAGnD"}

package/dist/snapshot/index.js

@@ -0,0 +1,84 @@
+import { MemorySnapshotBackend } from "./backends/MemorySnapshotBackend.js";
+import { FsSnapshotBackend } from "./backends/FsSnapshotBackend.js";
+import crypto from "crypto";
+export class SnapshotToolkit {
+    backend;
+    participants = new Map();
+    constructor(options) {
+        if (options.backend === "filesystem") {
+            this.backend = new FsSnapshotBackend(options.dir);
+        }
+        else {
+            this.backend = new MemorySnapshotBackend();
+        }
+    }
+    static open(options = { backend: "memory" }) {
+        return new SnapshotToolkit(options);
+    }
+    register(id, participant) {
+        this.participants.set(id, participant);
+    }
+    async create(name) {
+        const id = crypto.randomUUID();
+        const state = {};
+        // Snapshot all participants
+        for (const [pId, participant] of this.participants.entries()) {
+            state[pId] = await participant.snapshot();
+        }
+        return this.backend.save(id, name, state);
+    }
+    async restore(id) {
+        const { state } = await this.backend.load(id);
+        // 1. load state & restore (but don't reload yet in case something fails)
+        for (const [pId, pState] of Object.entries(state)) {
+            const participant = this.participants.get(pId);
+            if (!participant) {
+                throw new Error(`Cannot restore state for participant '${pId}' because it is not registered`);
+            }
+            try {
+                await participant.restore(pState);
+            }
+            catch (err) {
+                throw new Error(`Failed to restore participant '${pId}': ${err.message}`);
+            }
+        }
+        // 2. reload all
+        for (const [pId, _] of Object.entries(state)) {
+            const participant = this.participants.get(pId);
+            try {
+                await participant.reload();
+            }
+            catch (err) {
+                throw new Error(`Failed to reload participant '${pId}' after restoration: ${err.message}`);
+            }
+        }
+    }
+    async branch(baseId, newName) {
+        const newId = crypto.randomUUID();
+        return this.backend.branch(baseId, newId, newName);
+    }
+    async diff(idA, idB) {
+        const [a, b] = await Promise.all([this.backend.load(idA), this.backend.load(idB)]);
+        const differences = {};
+        const allParticipants = new Set([...a.manifest.participants, ...b.manifest.participants]);
+        for (const pId of allParticipants) {
+            const hashA = a.manifest.stateHashes[pId];
+            const hashB = b.manifest.stateHashes[pId];
+            if (hashA !== hashB) {
+                differences[pId] = {
+                    a: a.state[pId] || null,
+                    b: b.state[pId] || null
+                };
+            }
+        }
+        return differences;
+    }
+    async compare(idA, idB) {
+        const diff = await this.diff(idA, idB);
+        return Object.keys(diff).length === 0;
+    }
+    async list() {
+        return this.backend.list();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/snapshot/index.js.map

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

package/dist/snapshot/serialization.d.ts

@@ -0,0 +1,18 @@
+import { SnapshotState } from "./types.js";
+/**
+ * Custom JSON Replacer to safely serialize BigInt values.
+ */
+export declare function snapshotReplacer(key: string, value: any): any;
+/**
+ * Custom JSON Reviver to safely deserialize BigInt values.
+ */
+export declare function snapshotReviver(key: string, value: any): any;
+/**
+ * Serializes a SnapshotState map to a string safely supporting BigInt.
+ */
+export declare function serializeState(state: Record<string, SnapshotState>): string;
+/**
+ * Deserializes a SnapshotState map from a string safely supporting BigInt.
+ */
+export declare function deserializeState(data: string): Record<string, SnapshotState>;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/snapshot/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/snapshot/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAK7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAK5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAE5E"}

package/dist/snapshot/serialization.js

@@ -0,0 +1,31 @@
+/**
+ * Custom JSON Replacer to safely serialize BigInt values.
+ */
+export function snapshotReplacer(key, value) {
+    if (typeof value === "bigint") {
+        return { $bigint: value.toString() };
+    }
+    return value;
+}
+/**
+ * Custom JSON Reviver to safely deserialize BigInt values.
+ */
+export function snapshotReviver(key, value) {
+    if (value !== null && typeof value === "object" && typeof value.$bigint === "string") {
+        return BigInt(value.$bigint);
+    }
+    return value;
+}
+/**
+ * Serializes a SnapshotState map to a string safely supporting BigInt.
+ */
+export function serializeState(state) {
+    return JSON.stringify(state, snapshotReplacer, 2);
+}
+/**
+ * Deserializes a SnapshotState map from a string safely supporting BigInt.
+ */
+export function deserializeState(data) {
+    return JSON.parse(data, snapshotReviver);
+}
+//# sourceMappingURL=serialization.js.map

package/dist/snapshot/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/snapshot/serialization.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,KAAU;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,KAAU;IACnD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnF,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAoC;IAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;AAC7C,CAAC"}

package/dist/snapshot/types.d.ts

@@ -0,0 +1,44 @@
+export interface SnapshotState {
+    [key: string]: any;
+}
+export interface SnapshotParticipant {
+    /**
+     * Extracts the current internal state of the toolkit/store
+     */
+    snapshot(): Promise<SnapshotState>;
+    /**
+     * Restores the internal state from the provided snapshot state
+     */
+    restore(state: SnapshotState): Promise<void>;
+    /**
+     * Reloads any caches, queues, or in-memory representations
+     * based on the newly restored state
+     */
+    reload(): Promise<void>;
+}
+export interface SnapshotManifest {
+    schema: "hardkas.snapshot.v1";
+    snapshotId: string;
+    name: string;
+    createdAt: number;
+    backend: "memory" | "filesystem";
+    path?: string;
+    participants: string[];
+    stateHashes: Record<string, string>;
+    claims: {
+        containsFullStateInline: boolean;
+        restorableLocalState: boolean;
+        networkStateCaptured: boolean;
+    };
+}
+export interface SnapshotBackend {
+    save(id: string, name: string, state: Record<string, SnapshotState>): Promise<SnapshotManifest>;
+    load(id: string): Promise<{
+        manifest: SnapshotManifest;
+        state: Record<string, SnapshotState>;
+    }>;
+    list(): Promise<SnapshotManifest[]>;
+    delete(id: string): Promise<void>;
+    branch(baseId: string, newId: string, newName: string): Promise<SnapshotManifest>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/snapshot/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/snapshot/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,QAAQ,GAAG,YAAY,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE;QACJ,uBAAuB,EAAE,OAAO,CAAC;QACjC,oBAAoB,EAAE,OAAO,CAAC;QAC9B,oBAAoB,EAAE,OAAO,CAAC;KACjC,CAAC;CACL;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;KAAE,CAAC,CAAC;IAChG,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACrF"}

package/dist/snapshot/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/snapshot/types.js.map

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

package/dist/stores/invoice-store.d.ts

@@ -0,0 +1,26 @@
+export interface InvoiceRecord {
+    id: string;
+    merchantId: string;
+    amount: bigint;
+    currency: string;
+    status: 'pending' | 'paid' | 'cancelled';
+    uri: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class InvoiceStoreJson {
+    private store;
+    constructor(options: {
+        filePath: string;
+    });
+    save(invoice: InvoiceRecord): void;
+    get(id: string): InvoiceRecord | undefined;
+    list(): InvoiceRecord[];
+    listByMerchant(merchantId: string): InvoiceRecord[];
+    listPaid(): InvoiceRecord[];
+    stats(merchantId?: string): {
+        totalInvoices: number;
+        paidInvoices: number;
+    };
+}
+//# sourceMappingURL=invoice-store.d.ts.map

package/dist/stores/invoice-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-store.d.ts","sourceRoot":"","sources":["../../src/stores/invoice-store.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,gBAAgB;IACzB,OAAO,CAAC,KAAK,CAAiC;gBAElC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;IAIlC,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKlC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,IAAI,IAAI,aAAa,EAAE;IAIvB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE;IAInD,QAAQ,IAAI,aAAa,EAAE;IAI3B,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM;;;;CAWnC"}

package/dist/stores/invoice-store.js

@@ -0,0 +1,34 @@
+import { DomainStoreJson } from '@hardkas/query-store';
+export class InvoiceStoreJson {
+    store;
+    constructor(options) {
+        this.store = new DomainStoreJson(options);
+    }
+    save(invoice) {
+        invoice.updatedAt = new Date().toISOString();
+        this.store.save(invoice.id, invoice);
+    }
+    get(id) {
+        return this.store.get(id);
+    }
+    list() {
+        return this.store.list();
+    }
+    listByMerchant(merchantId) {
+        return this.store.list().filter(i => i.merchantId === merchantId);
+    }
+    listPaid() {
+        return this.store.list().filter(i => i.status === 'paid');
+    }
+    stats(merchantId) {
+        let invoices = this.store.list();
+        if (merchantId) {
+            invoices = invoices.filter(i => i.merchantId === merchantId);
+        }
+        return {
+            totalInvoices: invoices.length,
+            paidInvoices: invoices.filter(i => i.status === 'paid').length
+        };
+    }
+}
+//# sourceMappingURL=invoice-store.js.map

package/dist/stores/invoice-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-store.js","sourceRoot":"","sources":["../../src/stores/invoice-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAavD,MAAM,OAAO,gBAAgB;IACjB,KAAK,CAAiC;IAE9C,YAAY,OAA6B;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,eAAe,CAAgB,OAAO,CAAC,CAAC;IAC7D,CAAC;IAEM,IAAI,CAAC,OAAsB;QAC9B,OAAO,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAEM,GAAG,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAEM,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAEM,cAAc,CAAC,UAAkB;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACtE,CAAC;IAEM,QAAQ;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC9D,CAAC;IAEM,KAAK,CAAC,UAAmB;QAC5B,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,UAAU,EAAE,CAAC;YACb,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACH,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;SACjE,CAAC;IACN,CAAC;CACJ"}

package/dist/stores/utxo-control-store.d.ts

@@ -0,0 +1,23 @@
+export interface UtxoControlState {
+    frozen: Record<string, {
+        reason?: string | undefined;
+        timestamp: number;
+    }>;
+    labels: Record<string, string>;
+    notes: Record<string, string>;
+}
+export declare class UtxoControlStore {
+    private filePath;
+    private state;
+    constructor(filePath: string);
+    private load;
+    private save;
+    getState(): UtxoControlState;
+    freeze(utxoId: string, reason?: string): void;
+    unfreeze(utxoId: string): void;
+    setLabel(utxoId: string, label: string): void;
+    getLabel(utxoId: string): string | undefined;
+    setNote(utxoId: string, note: string): void;
+    getNote(utxoId: string): string | undefined;
+}
+//# sourceMappingURL=utxo-control-store.d.ts.map

package/dist/stores/utxo-control-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utxo-control-store.d.ts","sourceRoot":"","sources":["../../src/stores/utxo-control-store.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAmB;gBAEpB,QAAQ,EAAE,MAAM;IAK5B,OAAO,CAAC,IAAI;IAgBZ,OAAO,CAAC,IAAI;IAYL,QAAQ,IAAI,gBAAgB;IAI5B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAK7C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK9B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGnD"}

package/dist/stores/utxo-control-store.js

@@ -0,0 +1,64 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export class UtxoControlStore {
+    filePath;
+    state;
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.state = this.load();
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.filePath)) {
+                const data = fs.readFileSync(this.filePath, 'utf-8');
+                return JSON.parse(data);
+            }
+        }
+        catch (e) {
+            // Ignore read errors, initialize default
+        }
+        return {
+            frozen: {},
+            labels: {},
+            notes: {}
+        };
+    }
+    save() {
+        try {
+            const dir = path.dirname(this.filePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(this.filePath, JSON.stringify(this.state, null, 2), 'utf-8');
+        }
+        catch (e) {
+            console.warn(`Failed to save UTXO control state to ${this.filePath}`, e);
+        }
+    }
+    getState() {
+        return JSON.parse(JSON.stringify(this.state)); // Deep copy
+    }
+    freeze(utxoId, reason) {
+        this.state.frozen[utxoId] = { reason, timestamp: Date.now() };
+        this.save();
+    }
+    unfreeze(utxoId) {
+        delete this.state.frozen[utxoId];
+        this.save();
+    }
+    setLabel(utxoId, label) {
+        this.state.labels[utxoId] = label;
+        this.save();
+    }
+    getLabel(utxoId) {
+        return this.state.labels[utxoId];
+    }
+    setNote(utxoId, note) {
+        this.state.notes[utxoId] = note;
+        this.save();
+    }
+    getNote(utxoId) {
+        return this.state.notes[utxoId];
+    }
+}
+//# sourceMappingURL=utxo-control-store.js.map

package/dist/stores/utxo-control-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utxo-control-store.js","sourceRoot":"","sources":["../../src/stores/utxo-control-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAQlC,MAAM,OAAO,gBAAgB;IACnB,QAAQ,CAAS;IACjB,KAAK,CAAmB;IAEhC,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAEO,IAAI;QACV,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACrD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,yCAAyC;QAC3C,CAAC;QACD,OAAO;YACL,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAEO,IAAI;QACV,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,CAAC;YACD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,wCAAwC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY;IAC7D,CAAC;IAEM,MAAM,CAAC,MAAc,EAAE,MAAe;QAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC9D,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,QAAQ,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,QAAQ,CAAC,MAAc,EAAE,KAAa;QAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,QAAQ,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAEM,OAAO,CAAC,MAAc,EAAE,IAAY;QACzC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/utxos.d.ts

@@ -0,0 +1,128 @@
+import { Utxo } from "@hardkas/query";
+export interface UtxoStatistics {
+    totalUtxos: number;
+    availableUtxos: number;
+    frozenUtxos: number;
+    totalValue: bigint;
+    availableValue: bigint;
+    frozenValue: bigint;
+    averageValue: bigint;
+    largest: bigint;
+    smallest: bigint;
+    includeFrozen: boolean;
+}
+export interface DustAnalysis {
+    dustUtxos: Utxo[];
+    normalUtxos: Utxo[];
+    totalDustValue: bigint;
+    dustPercentage: number;
+}
+export type Recommendation = "consolidate" | "mergeDust" | "splitLarge" | "none";
+export interface WalletAnalysis {
+    utxoCount: number;
+    fragmentationScore: number;
+    dustCount: number;
+    totalValue: bigint;
+    recommendedActions: Recommendation[];
+}
+export interface ConsolidationPlan {
+    strategy: string;
+    inputs: Utxo[];
+    outputs: any[];
+    estimatedFee: bigint;
+    estimatedSavings: bigint;
+    warnings: string[];
+}
+export interface SplitPlan extends ConsolidationPlan {
+    strategy: "split";
+}
+export interface MergePlan extends ConsolidationPlan {
+    strategy: "merge";
+}
+export interface SweepPlan extends ConsolidationPlan {
+    strategy: "sweep";
+}
+import { UtxoControlStore, UtxoControlState } from './stores/utxo-control-store.js';
+export interface UtxoListOpts {
+    includeFrozen?: boolean | undefined;
+}
+export declare class WalletUtxoApi {
+    private readonly fetchUtxos;
+    private readonly address;
+    private readonly estimateFee;
+    private readonly store;
+    constructor(fetchUtxos: () => Promise<Utxo[]>, address: () => Promise<string>, estimateFee: (inputs: number, outputs: number) => Promise<bigint>, store: UtxoControlStore);
+    /**
+     * List UTXOs currently available in the wallet.
+     * Frozen UTXOs are excluded by default unless includeFrozen: true.
+     */
+    list(opts?: UtxoListOpts): Promise<Utxo[]>;
+    /**
+     * Return basic statistics about the UTXO set.
+     */
+    statistics(opts?: UtxoListOpts): Promise<UtxoStatistics>;
+    /**
+     * Classify UTXOs into dust and normal based on a threshold.
+     * Default threshold: 10 KAS (1_000_000_000 sompi).
+     */
+    analyzeDust(opts?: {
+        thresholdSompi?: bigint;
+        includeFrozen?: boolean | undefined;
+    }): Promise<DustAnalysis>;
+    /**
+     * High-level diagnostic analysis of the wallet's UTXO health.
+     */
+    analyze(opts?: UtxoListOpts): Promise<WalletAnalysis>;
+    /**
+     * Plan a UTXO management operation without executing it.
+     */
+    plan(opts: {
+        strategy: "consolidation" | "split" | "sweep";
+        includeFrozen?: boolean | undefined;
+    }): Promise<ConsolidationPlan>;
+    /**
+     * Convenience alias for planning a consolidation.
+     */
+    consolidate(opts?: {
+        includeFrozen?: boolean | undefined;
+    }): Promise<ConsolidationPlan>;
+    private _assertNotFrozen;
+    /**
+     * Plans the splitting of a specific large UTXO.
+     * Supports symmetric splits (intoCount) OR asymmetric splits (outputs).
+     */
+    splitPlan(opts: {
+        utxoId: string;
+        intoCount?: number;
+        outputs?: {
+            amountSompi: bigint;
+        }[];
+        includeFrozen?: boolean | undefined;
+    }): Promise<SplitPlan>;
+    /**
+     * Plans the explicit merging of specific UTXOs.
+     */
+    mergePlan(opts: {
+        utxoIds: string[];
+        includeFrozen?: boolean | undefined;
+    }): Promise<MergePlan>;
+    /**
+     * Plans sweeping the entire wallet to a single destination address.
+     */
+    sweepPlan(opts: {
+        destinationAddress: string;
+        includeFrozen?: boolean | undefined;
+    }): Promise<SweepPlan>;
+    controlState(): Promise<UtxoControlState>;
+    freeze(utxoId: string, reason?: string): Promise<void>;
+    unfreeze(utxoId: string): Promise<void>;
+    labels: {
+        set: (utxoId: string, label: string) => Promise<void>;
+        get: (utxoId: string) => Promise<string | undefined>;
+    };
+    notes: {
+        set: (utxoId: string, note: string) => Promise<void>;
+        get: (utxoId: string) => Promise<string | undefined>;
+    };
+}
+//# sourceMappingURL=utxos.d.ts.map

package/dist/utxos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utxos.d.ts","sourceRoot":"","sources":["../src/utxos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,IAAI,EAAE,CAAC;IAClB,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,cAAc,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,EAAE,CAAC;IACf,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEpF,MAAM,WAAW,YAAY;IAAG,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE;AAErE,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAHL,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,EACjC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAC9B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EACjE,KAAK,EAAE,gBAAgB;IAG1C;;;OAGG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAShD;;OAEG;IACG,UAAU,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAwD9D;;;OAGG;IACG,WAAW,CAAC,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IA0BjH;;OAEG;IACG,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAkC3D;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,GAAG,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4CpI;;OAEG;IACG,WAAW,CAAC,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI7F,OAAO,CAAC,gBAAgB;IAMxB;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACpC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACrC,GAAG,OAAO,CAAC,SAAS,CAAC;IAoEtB;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE;QACpB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACrC,GAAG,OAAO,CAAC,SAAS,CAAC;IAyCtB;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACrC,GAAG,OAAO,CAAC,SAAS,CAAC;IA2BhB,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAIzC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,MAAM;sBACS,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;sBAGrC,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;MAGxD;IAEK,KAAK;sBACU,MAAM,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;sBAGpC,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;MAGxD;CACH"}