@claw-network/core 0.1.0

package/dist/storage/level.js

@@ -0,0 +1,57 @@
+import { Level } from 'level';
+function toUint8Array(value) {
+    if (value instanceof Uint8Array) {
+        if (Buffer.isBuffer(value)) {
+            return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+        }
+        return value;
+    }
+    return new Uint8Array(value);
+}
+export class LevelStore {
+    db;
+    constructor(options) {
+        this.db = new Level(options.path, { valueEncoding: 'view' });
+    }
+    async get(key) {
+        try {
+            const value = await this.db.get(key);
+            if (value === undefined || value === null) {
+                return undefined;
+            }
+            return toUint8Array(value);
+        }
+        catch (error) {
+            if (error.code === 'LEVEL_NOT_FOUND') {
+                return undefined;
+            }
+            throw error;
+        }
+    }
+    async put(key, value) {
+        await this.db.put(key, value);
+    }
+    async del(key) {
+        await this.db.del(key);
+    }
+    async *iterator(prefix = '') {
+        const hasPrefix = prefix.length > 0;
+        const options = hasPrefix
+            ? {
+                gte: prefix,
+                lt: `${prefix}\xff`,
+            }
+            : {};
+        const iterator = this.db.iterator(options);
+        for await (const [key, value] of iterator) {
+            if (value === undefined || value === null) {
+                continue;
+            }
+            yield { key, value: toUint8Array(value) };
+        }
+    }
+    async close() {
+        await this.db.close();
+    }
+}
+//# sourceMappingURL=level.js.map

package/dist/storage/level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.js","sourceRoot":"","sources":["../../src/storage/level.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAO9B,SAAS,YAAY,CAAC,KAAwC;IAC5D,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,OAAO,UAAU;IACJ,EAAE,CAA4B;IAE/C,YAAY,OAA0B;QACpC,IAAI,CAAC,EAAE,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO,YAAY,CAAC,KAA0C,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA2B,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC5D,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAiB;QACtC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE;QACzB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,SAAS;YACvB,CAAC,CAAC;gBACE,GAAG,EAAE,MAAM;gBACX,EAAE,EAAE,GAAG,MAAM,MAAM;aACpB;YACH,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,SAAS;YACX,CAAC;YACD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,KAA0C,CAAC,EAAE,CAAC;QACjF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/storage/memory.d.ts

@@ -0,0 +1,12 @@
+import { KVStore } from './kv.js';
+export declare class MemoryStore implements KVStore {
+    private store;
+    get(key: string): Promise<Uint8Array | undefined>;
+    put(key: string, value: Uint8Array): Promise<void>;
+    del(key: string): Promise<void>;
+    iterator(prefix?: string): AsyncIterable<{
+        key: string;
+        value: Uint8Array;
+    }>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/storage/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qBAAa,WAAY,YAAW,OAAO;IACzC,OAAO,CAAC,KAAK,CAAiC;IAExC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9B,QAAQ,CAAC,MAAM,SAAK,GAAG,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;CAOhF"}

package/dist/storage/memory.js

@@ -0,0 +1,20 @@
+export class MemoryStore {
+    store = new Map();
+    async get(key) {
+        return this.store.get(key);
+    }
+    async put(key, value) {
+        this.store.set(key, value);
+    }
+    async del(key) {
+        this.store.delete(key);
+    }
+    async *iterator(prefix = '') {
+        for (const [key, value] of this.store.entries()) {
+            if (!prefix || key.startsWith(prefix)) {
+                yield { key, value };
+            }
+        }
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/storage/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACd,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE9C,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAiB;QACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE;QACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/storage/migrations.d.ts

@@ -0,0 +1,11 @@
+import { KVStore } from './kv.js';
+export declare const META_SCHEMA_VERSION_KEY = "meta:version";
+export declare const DEFAULT_SCHEMA_VERSION = 1;
+export interface StorageMigration {
+    version: number;
+    up: (store: KVStore) => Promise<void>;
+}
+export declare function getSchemaVersion(store: KVStore): Promise<number | null>;
+export declare function setSchemaVersion(store: KVStore, version: number): Promise<void>;
+export declare function ensureSchemaVersion(store: KVStore, targetVersion?: number, migrations?: StorageMigration[]): Promise<number>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/storage/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AACtD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAWD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG7E;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,aAAa,GAAE,MAA+B,EAC9C,UAAU,GAAE,gBAAgB,EAAO,GAClC,OAAO,CAAC,MAAM,CAAC,CA+BjB"}

package/dist/storage/migrations.js

@@ -0,0 +1,47 @@
+import { bytesToUtf8, utf8ToBytes } from '../utils/bytes.js';
+export const META_SCHEMA_VERSION_KEY = 'meta:version';
+export const DEFAULT_SCHEMA_VERSION = 1;
+function encodeNumber(value) {
+    return utf8ToBytes(JSON.stringify(value));
+}
+function decodeNumber(value) {
+    if (!value)
+        return null;
+    return JSON.parse(bytesToUtf8(value));
+}
+export async function getSchemaVersion(store) {
+    const raw = await store.get(META_SCHEMA_VERSION_KEY);
+    return decodeNumber(raw);
+}
+export async function setSchemaVersion(store, version) {
+    await store.put(META_SCHEMA_VERSION_KEY, encodeNumber(version));
+}
+export async function ensureSchemaVersion(store, targetVersion = DEFAULT_SCHEMA_VERSION, migrations = []) {
+    const current = (await getSchemaVersion(store)) ?? 0;
+    if (current > targetVersion) {
+        throw new Error(`Refuse downgrade schema from ${current} to ${targetVersion}`);
+    }
+    const ordered = [...migrations].sort((a, b) => a.version - b.version);
+    let latest = current;
+    for (const migration of ordered) {
+        if (migration.version <= latest) {
+            continue;
+        }
+        if (migration.version > targetVersion) {
+            break;
+        }
+        await migration.up(store);
+        await setSchemaVersion(store, migration.version);
+        latest = migration.version;
+    }
+    if (latest === 0 && targetVersion === DEFAULT_SCHEMA_VERSION && ordered.length === 0) {
+        await setSchemaVersion(store, targetVersion);
+        return targetVersion;
+    }
+    if (latest < targetVersion && ordered.length === 0) {
+        await setSchemaVersion(store, targetVersion);
+        return targetVersion;
+    }
+    return (await getSchemaVersion(store)) ?? latest;
+}
+//# sourceMappingURL=migrations.js.map

package/dist/storage/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAOxC,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,YAAY,CAAC,KAAkB;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAW,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAc;IACnD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAc,EAAE,OAAe;IACpE,MAAM,KAAK,CAAC,GAAG,CAAC,uBAAuB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAc,EACd,gBAAwB,sBAAsB,EAC9C,aAAiC,EAAE;IAEnC,MAAM,OAAO,GAAG,CAAC,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,OAAO,GAAG,aAAa,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,OAAO,aAAa,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,MAAM,GAAG,OAAO,CAAC;IACrB,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,SAAS,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;YAChC,SAAS;QACX,CAAC;QACD,IAAI,SAAS,CAAC,OAAO,GAAG,aAAa,EAAE,CAAC;YACtC,MAAM;QACR,CAAC;QACD,MAAM,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM,KAAK,CAAC,IAAI,aAAa,KAAK,sBAAsB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrF,MAAM,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC7C,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,MAAM,GAAG,aAAa,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC7C,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC;AACnD,CAAC"}

package/dist/storage/paths.d.ts

@@ -0,0 +1,14 @@
+export interface StoragePaths {
+    root: string;
+    data: string;
+    logs: string;
+    keys: string;
+    snapshots: string;
+    eventsDb: string;
+    stateDb: string;
+    configFile: string;
+}
+export declare function defaultStorageRoot(): string;
+export declare function resolveStoragePaths(root?: string): StoragePaths;
+export declare function ensureStorageDirs(paths: StoragePaths): Promise<void>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/storage/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/storage/paths.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,MAA6B,GAAG,YAAY,CAgBrF;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1E"}

package/dist/storage/paths.js

@@ -0,0 +1,30 @@
+import { mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+export function defaultStorageRoot() {
+    return process.env.CLAWNET_HOME ?? resolve(homedir(), '.clawnet');
+}
+export function resolveStoragePaths(root = defaultStorageRoot()) {
+    const data = resolve(root, 'data');
+    const logs = resolve(root, 'logs');
+    const keys = resolve(root, 'keys');
+    const snapshots = resolve(data, 'snapshots');
+    return {
+        root,
+        data,
+        logs,
+        keys,
+        snapshots,
+        eventsDb: resolve(data, 'events.db'),
+        stateDb: resolve(data, 'state.db'),
+        configFile: resolve(root, 'config.yaml'),
+    };
+}
+export async function ensureStorageDirs(paths) {
+    await mkdir(paths.root, { recursive: true });
+    await mkdir(paths.data, { recursive: true });
+    await mkdir(paths.logs, { recursive: true });
+    await mkdir(paths.keys, { recursive: true });
+    await mkdir(paths.snapshots, { recursive: true });
+}
+//# sourceMappingURL=paths.js.map

package/dist/storage/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/storage/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe,kBAAkB,EAAE;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAE7C,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,SAAS;QACT,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC;QACpC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC;QAClC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAmB;IACzD,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/storage/snapshot-scheduler.d.ts

@@ -0,0 +1,16 @@
+import { EventStore } from './event-store.js';
+import { SnapshotStore } from './snapshots.js';
+export interface SnapshotSchedulePolicy {
+    maxEvents: number;
+    maxAgeMs: number;
+}
+export declare const DEFAULT_SNAPSHOT_POLICY: SnapshotSchedulePolicy;
+export declare class SnapshotScheduler {
+    private readonly eventStore;
+    private readonly snapshotStore;
+    private readonly policy;
+    private readonly startedAt;
+    constructor(eventStore: EventStore, snapshotStore: SnapshotStore, policy?: SnapshotSchedulePolicy);
+    shouldSnapshot(now?: number): Promise<boolean>;
+}
+//# sourceMappingURL=snapshot-scheduler.d.ts.map

package/dist/storage/snapshot-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-scheduler.d.ts","sourceRoot":"","sources":["../../src/storage/snapshot-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,uBAAuB,EAAE,sBAGrC,CAAC;AAEF,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,aAAa,EAC5B,MAAM,GAAE,sBAAgD;IAKrE,cAAc,CAAC,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CA8BjE"}

package/dist/storage/snapshot-scheduler.js

@@ -0,0 +1,43 @@
+export const DEFAULT_SNAPSHOT_POLICY = {
+    maxEvents: 10_000,
+    maxAgeMs: 60 * 60 * 1000,
+};
+export class SnapshotScheduler {
+    eventStore;
+    snapshotStore;
+    policy;
+    startedAt;
+    constructor(eventStore, snapshotStore, policy = DEFAULT_SNAPSHOT_POLICY) {
+        this.eventStore = eventStore;
+        this.snapshotStore = snapshotStore;
+        this.policy = policy;
+        this.startedAt = Date.now();
+    }
+    async shouldSnapshot(now = Date.now()) {
+        const logLength = await this.eventStore.getLogLength();
+        if (logLength <= 0) {
+            return false;
+        }
+        const latestSnapshot = await this.snapshotStore.loadLatestSnapshot();
+        if (!latestSnapshot) {
+            const ageMs = now - this.startedAt;
+            return logLength >= this.policy.maxEvents || ageMs >= this.policy.maxAgeMs;
+        }
+        const seq = await this.eventStore.getEventSeq(latestSnapshot.at);
+        if (seq !== null) {
+            const eventsSince = logLength - (seq + 1);
+            if (eventsSince >= this.policy.maxEvents) {
+                return true;
+            }
+        }
+        const meta = await this.snapshotStore.loadLatestSnapshotMeta();
+        if (meta?.createdAt) {
+            const ageMs = now - Date.parse(meta.createdAt);
+            if (ageMs >= this.policy.maxAgeMs) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=snapshot-scheduler.js.map

package/dist/storage/snapshot-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-scheduler.js","sourceRoot":"","sources":["../../src/storage/snapshot-scheduler.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,uBAAuB,GAA2B;IAC7D,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;CACzB,CAAC;AAEF,MAAM,OAAO,iBAAiB;IAIT;IACA;IACA;IALF,SAAS,CAAS;IAEnC,YACmB,UAAsB,EACtB,aAA4B,EAC5B,SAAiC,uBAAuB;QAFxD,eAAU,GAAV,UAAU,CAAY;QACtB,kBAAa,GAAb,aAAa,CAAe;QAC5B,WAAM,GAAN,MAAM,CAAkD;QAEzE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;QAC3C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;QACvD,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,CAAC;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YACnC,OAAO,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC7E,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACjE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,WAAW,GAAG,SAAS,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YAC1C,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACzC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,sBAAsB,EAAE,CAAC;QAC/D,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/storage/snapshots.d.ts

@@ -0,0 +1,53 @@
+import { StoragePaths } from './paths.js';
+export interface SnapshotSignature {
+    peer: string;
+    sig: string;
+}
+export interface SnapshotRecord {
+    v: number;
+    at: string;
+    prev: string | null;
+    state: Record<string, unknown>;
+    hash: string;
+    signatures: SnapshotSignature[];
+}
+export declare const SNAPSHOT_DOMAIN_PREFIX = "clawnet:snapshot:v1:";
+export declare function snapshotBody(snapshot: SnapshotRecord): {
+    v: number;
+    at: string;
+    prev: string | null;
+    state: Record<string, unknown>;
+};
+export declare function snapshotHashHex(snapshot: SnapshotRecord): string;
+export declare function snapshotSigningBytesFromHash(hash: string): Uint8Array;
+export declare function snapshotSigningBytes(snapshot: SnapshotRecord): Uint8Array;
+export declare function verifySnapshotHash(snapshot: SnapshotRecord): boolean;
+export declare function signSnapshot(snapshot: SnapshotRecord, peerId: string, privateKey: Uint8Array): Promise<SnapshotRecord>;
+export declare function verifySnapshotSignatures(snapshot: SnapshotRecord, resolvePeerPublicKey: (peerId: string) => Promise<Uint8Array | null>, options?: {
+    minSignatures?: number;
+}): Promise<{
+    ok: boolean;
+    validPeers: string[];
+}>;
+export declare class SnapshotStore {
+    private readonly dir;
+    private readonly latestFile;
+    private readonly latestMetaFile;
+    constructor(paths: StoragePaths);
+    saveSnapshot(snapshot: SnapshotRecord): Promise<void>;
+    loadSnapshot(hash: string): Promise<SnapshotRecord | null>;
+    loadSnapshotBytes(hash: string): Promise<Uint8Array | null>;
+    loadLatestSnapshot(): Promise<SnapshotRecord | null>;
+    loadLatestSnapshotBytes(): Promise<{
+        hash: string;
+        bytes: Uint8Array;
+    } | null>;
+    loadLatestSnapshotMeta(): Promise<{
+        hash: string;
+        createdAt: string;
+    } | null>;
+    private snapshotPath;
+    private readLatestHash;
+    private findLatestSnapshotFile;
+}
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/storage/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/storage/snapshots.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG;IACtD,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAOA;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAGhE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAErE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,UAAU,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAEpE;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,cAAc,CAAC,CASzB;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,cAAc,EACxB,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,EACpE,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoBhD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,KAAK,EAAE,YAAY;IAMzB,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAY1D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAU3D,kBAAkB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAYpD,uBAAuB,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;IAoB9E,sBAAsB,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAwBnF,OAAO,CAAC,YAAY;YAIN,cAAc;YAUd,sBAAsB;CAqBrC"}

package/dist/storage/snapshots.js

@@ -0,0 +1,192 @@
+import { mkdir, readdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { canonicalizeBytes } from '../crypto/jcs.js';
+import { sha256Hex } from '../crypto/hash.js';
+import { signBase58, verifyBase58 } from '../crypto/ed25519.js';
+import { concatBytes, utf8ToBytes, bytesToUtf8 } from '../utils/bytes.js';
+export const SNAPSHOT_DOMAIN_PREFIX = 'clawnet:snapshot:v1:';
+export function snapshotBody(snapshot) {
+    return {
+        v: snapshot.v,
+        at: snapshot.at,
+        prev: snapshot.prev,
+        state: snapshot.state,
+    };
+}
+export function snapshotHashHex(snapshot) {
+    const canonical = canonicalizeBytes(snapshotBody(snapshot));
+    return sha256Hex(canonical);
+}
+export function snapshotSigningBytesFromHash(hash) {
+    return concatBytes(utf8ToBytes(SNAPSHOT_DOMAIN_PREFIX), utf8ToBytes(hash));
+}
+export function snapshotSigningBytes(snapshot) {
+    return snapshotSigningBytesFromHash(snapshotHashHex(snapshot));
+}
+export function verifySnapshotHash(snapshot) {
+    return snapshot.hash === snapshotHashHex(snapshot);
+}
+export async function signSnapshot(snapshot, peerId, privateKey) {
+    const hash = snapshotHashHex(snapshot);
+    const sig = await signBase58(snapshotSigningBytesFromHash(hash), privateKey);
+    const signatures = [...(snapshot.signatures ?? []), { peer: peerId, sig }];
+    return {
+        ...snapshot,
+        hash,
+        signatures,
+    };
+}
+export async function verifySnapshotSignatures(snapshot, resolvePeerPublicKey, options = {}) {
+    const minSignatures = options.minSignatures ?? 1;
+    const signingBytes = snapshotSigningBytesFromHash(snapshot.hash);
+    const seen = new Set();
+    const validPeers = [];
+    for (const entry of snapshot.signatures ?? []) {
+        if (!entry?.peer || !entry?.sig || seen.has(entry.peer)) {
+            continue;
+        }
+        const publicKey = await resolvePeerPublicKey(entry.peer);
+        if (!publicKey) {
+            continue;
+        }
+        const ok = await verifyBase58(entry.sig, signingBytes, publicKey);
+        if (ok) {
+            seen.add(entry.peer);
+            validPeers.push(entry.peer);
+        }
+    }
+    return { ok: validPeers.length >= minSignatures, validPeers };
+}
+export class SnapshotStore {
+    dir;
+    latestFile;
+    latestMetaFile;
+    constructor(paths) {
+        this.dir = paths.snapshots;
+        this.latestFile = join(this.dir, 'latest');
+        this.latestMetaFile = join(this.dir, 'latest.meta.json');
+    }
+    async saveSnapshot(snapshot) {
+        await mkdir(this.dir, { recursive: true });
+        const path = this.snapshotPath(snapshot.hash);
+        await writeFile(path, JSON.stringify(snapshot), 'utf8');
+        await writeFile(this.latestFile, snapshot.hash, 'utf8');
+        const meta = {
+            hash: snapshot.hash,
+            createdAt: new Date().toISOString(),
+        };
+        await writeFile(this.latestMetaFile, JSON.stringify(meta), 'utf8');
+    }
+    async loadSnapshot(hash) {
+        const bytes = await this.loadSnapshotBytes(hash);
+        if (!bytes) {
+            return null;
+        }
+        try {
+            return JSON.parse(bytesToUtf8(bytes));
+        }
+        catch {
+            return null;
+        }
+    }
+    async loadSnapshotBytes(hash) {
+        try {
+            const path = this.snapshotPath(hash);
+            const buffer = await readFile(path);
+            return new Uint8Array(buffer);
+        }
+        catch {
+            return null;
+        }
+    }
+    async loadLatestSnapshot() {
+        const latest = await this.loadLatestSnapshotBytes();
+        if (!latest) {
+            return null;
+        }
+        try {
+            return JSON.parse(bytesToUtf8(latest.bytes));
+        }
+        catch {
+            return null;
+        }
+    }
+    async loadLatestSnapshotBytes() {
+        const hash = await this.readLatestHash();
+        if (hash) {
+            const bytes = await this.loadSnapshotBytes(hash);
+            if (bytes) {
+                return { hash, bytes };
+            }
+        }
+        const fallback = await this.findLatestSnapshotFile();
+        if (!fallback) {
+            return null;
+        }
+        const bytes = await this.loadSnapshotBytes(fallback);
+        if (!bytes) {
+            return null;
+        }
+        return { hash: fallback, bytes };
+    }
+    async loadLatestSnapshotMeta() {
+        try {
+            const raw = await readFile(this.latestMetaFile, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed.hash && parsed.createdAt) {
+                return { hash: parsed.hash, createdAt: parsed.createdAt };
+            }
+        }
+        catch {
+            // ignore
+        }
+        const latest = await this.findLatestSnapshotFile();
+        if (!latest) {
+            return null;
+        }
+        try {
+            const path = this.snapshotPath(latest);
+            const stats = await stat(path);
+            return { hash: latest, createdAt: new Date(stats.mtimeMs).toISOString() };
+        }
+        catch {
+            return null;
+        }
+    }
+    snapshotPath(hash) {
+        return join(this.dir, `${hash}.json`);
+    }
+    async readLatestHash() {
+        try {
+            const buffer = await readFile(this.latestFile);
+            const value = bytesToUtf8(new Uint8Array(buffer)).trim();
+            return value.length ? value : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async findLatestSnapshotFile() {
+        try {
+            const entries = await readdir(this.dir);
+            let latestHash = null;
+            let latestMtime = 0;
+            for (const entry of entries) {
+                if (!entry.endsWith('.json')) {
+                    continue;
+                }
+                const path = join(this.dir, entry);
+                const stats = await stat(path);
+                if (stats.mtimeMs > latestMtime) {
+                    latestMtime = stats.mtimeMs;
+                    latestHash = entry.slice(0, -'.json'.length);
+                }
+            }
+            return latestHash;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/storage/snapshots.js.map

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

package/dist/storage/state-store.d.ts

@@ -0,0 +1,14 @@
+import { KVStore } from './kv.js';
+export interface ModuleStateRecord<T = unknown> {
+    at: string | null;
+    state: T;
+}
+export declare class StateStore {
+    private readonly store;
+    constructor(store: KVStore);
+    getModuleState<T = unknown>(module: string): Promise<ModuleStateRecord<T> | null>;
+    setModuleState<T = unknown>(module: string, state: T, at: string | null): Promise<void>;
+    deleteModuleState(module: string): Promise<void>;
+    listModules(): Promise<string[]>;
+}
+//# sourceMappingURL=state-store.d.ts.map

package/dist/storage/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/storage/state-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,CAAC,CAAC;CACV;AAWD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,OAAO;IAErC,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAQjF,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,MAAM,GAAG,IAAI,GAChB,OAAO,CAAC,IAAI,CAAC;IAKV,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAOvC"}

package/dist/storage/state-store.js

@@ -0,0 +1,38 @@
+import { bytesToUtf8, utf8ToBytes } from '../utils/bytes.js';
+const PREFIX_STATE = 'st:';
+function encodeJson(value) {
+    return utf8ToBytes(JSON.stringify(value));
+}
+function decodeJson(value, fallback) {
+    if (!value)
+        return fallback;
+    return JSON.parse(bytesToUtf8(value));
+}
+export class StateStore {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async getModuleState(module) {
+        const value = await this.store.get(`${PREFIX_STATE}${module}`);
+        if (!value) {
+            return null;
+        }
+        return decodeJson(value, null);
+    }
+    async setModuleState(module, state, at) {
+        const record = { at, state };
+        await this.store.put(`${PREFIX_STATE}${module}`, encodeJson(record));
+    }
+    async deleteModuleState(module) {
+        await this.store.del(`${PREFIX_STATE}${module}`);
+    }
+    async listModules() {
+        const modules = [];
+        for await (const { key } of this.store.iterator(PREFIX_STATE)) {
+            modules.push(key.slice(PREFIX_STATE.length));
+        }
+        return modules;
+    }
+}
+//# sourceMappingURL=state-store.js.map

package/dist/storage/state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../../src/storage/state-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG7D,MAAM,YAAY,GAAG,KAAK,CAAC;AAO3B,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAI,KAA6B,EAAE,QAAW;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAM,CAAC;AAC7C,CAAC;AAED,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,KAAc;QAAd,UAAK,GAAL,KAAK,CAAS;IAAG,CAAC;IAE/C,KAAK,CAAC,cAAc,CAAc,MAAc;QAC9C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,YAAY,GAAG,MAAM,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,UAAU,CAAC,KAAK,EAAE,IAAmC,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,MAAc,EACd,KAAQ,EACR,EAAiB;QAEjB,MAAM,MAAM,GAAyB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACnD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,YAAY,GAAG,MAAM,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,MAAc;QACpC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,YAAY,GAAG,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/utils/PromiseWithResolvers.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PromiseWithResolvers.d.ts.map

package/dist/utils/PromiseWithResolvers.d.ts.map

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