@openweave/weave-provider 0.8.0 → 0.8.1

package/dist/cjs/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @openweave/weave-provider
+ *
+ * Storage-agnostic persistence contract for OpenWeave.
+ *
+ * Quick start:
+ * ```ts
+ * import { resolveProvider } from "@openweave/weave-provider";
+ *
+ * const provider = await resolveProvider<MyRecord>();
+ * await provider.set("ns:my-key", { hello: "world" });
+ * const record = await provider.get("ns:my-key");
+ * await provider.close();
+ * ```
+ */
+export type { IWeaveProvider, ProviderFactory } from "./types.js";
+export { WEAVE_PROVIDER_ENV, WEAVE_DATA_DIR_ENV, DEFAULT_DATA_DIR, ProviderClosedError, UnknownProviderError, } from "./types.js";
+export { MemoryProvider } from "./memory-provider.js";
+export { JsonProvider } from "./json-provider.js";
+export { ProviderRegistry, resolveProvider } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * @openweave/weave-provider
+ *
+ * Storage-agnostic persistence contract for OpenWeave.
+ *
+ * Quick start:
+ * ```ts
+ * import { resolveProvider } from "@openweave/weave-provider";
+ *
+ * const provider = await resolveProvider<MyRecord>();
+ * await provider.set("ns:my-key", { hello: "world" });
+ * const record = await provider.get("ns:my-key");
+ * await provider.close();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveProvider = exports.ProviderRegistry = exports.JsonProvider = exports.MemoryProvider = exports.UnknownProviderError = exports.ProviderClosedError = exports.DEFAULT_DATA_DIR = exports.WEAVE_DATA_DIR_ENV = exports.WEAVE_PROVIDER_ENV = void 0;
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "WEAVE_PROVIDER_ENV", { enumerable: true, get: function () { return types_js_1.WEAVE_PROVIDER_ENV; } });
+Object.defineProperty(exports, "WEAVE_DATA_DIR_ENV", { enumerable: true, get: function () { return types_js_1.WEAVE_DATA_DIR_ENV; } });
+Object.defineProperty(exports, "DEFAULT_DATA_DIR", { enumerable: true, get: function () { return types_js_1.DEFAULT_DATA_DIR; } });
+Object.defineProperty(exports, "ProviderClosedError", { enumerable: true, get: function () { return types_js_1.ProviderClosedError; } });
+Object.defineProperty(exports, "UnknownProviderError", { enumerable: true, get: function () { return types_js_1.UnknownProviderError; } });
+// Built-in implementations
+var memory_provider_js_1 = require("./memory-provider.js");
+Object.defineProperty(exports, "MemoryProvider", { enumerable: true, get: function () { return memory_provider_js_1.MemoryProvider; } });
+var json_provider_js_1 = require("./json-provider.js");
+Object.defineProperty(exports, "JsonProvider", { enumerable: true, get: function () { return json_provider_js_1.JsonProvider; } });
+// Registry + convenience resolver
+var registry_js_1 = require("./registry.js");
+Object.defineProperty(exports, "ProviderRegistry", { enumerable: true, get: function () { return registry_js_1.ProviderRegistry; } });
+Object.defineProperty(exports, "resolveProvider", { enumerable: true, get: function () { return registry_js_1.resolveProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAIH,uCAMoB;AALlB,8GAAA,kBAAkB,OAAA;AAClB,8GAAA,kBAAkB,OAAA;AAClB,4GAAA,gBAAgB,OAAA;AAChB,+GAAA,mBAAmB,OAAA;AACnB,gHAAA,oBAAoB,OAAA;AAGtB,2BAA2B;AAC3B,2DAAsD;AAA7C,oHAAA,cAAc,OAAA;AACvB,uDAAkD;AAAzC,gHAAA,YAAY,OAAA;AAErB,kCAAkC;AAClC,6CAAkE;AAAzD,+GAAA,gBAAgB,OAAA;AAAE,8GAAA,eAAe,OAAA"}

package/dist/cjs/json-provider.d.ts

@@ -0,0 +1,47 @@
+import { IWeaveProvider } from "./types.js";
+/**
+ * JsonProvider
+ *
+ * File-system implementation of IWeaveProvider that stores each record as an
+ * individual JSON file inside a configurable data directory.
+ *
+ * Key → file-path mapping:
+ *   key = "graph:my-session"  →  <dataDir>/graph__my-session.json
+ *
+ * Colons in keys are replaced with double-underscores and any characters that
+ * are not safe for all major file systems are percent-encoded, so the mapping
+ * is always reversible.
+ *
+ * Backward-compatible with the original weave-graph PersistenceManager:
+ *   graph:<chatId>  →  weave-data/<chatId>.json   (no namespace prefix)
+ * That legacy layout is preserved for existing data directories.
+ */
+export declare class JsonProvider<T = unknown> implements IWeaveProvider<T> {
+    private dataDir;
+    private closed;
+    constructor(dataDir?: string);
+    close(): Promise<void>;
+    get(key: string): Promise<T | null>;
+    set(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string): Promise<string[]>;
+    clear(prefix?: string): Promise<void>;
+    /**
+     * Convert a logical key into an absolute file path.
+     *
+     * Rules (applied in order):
+     *   1. Replace ":" with "__" (namespace separator)
+     *   2. Replace "/" with "--" (path separator used in ids)
+     *   3. Append ".json"
+     */
+    private keyToPath;
+    /**
+     * Reverse of keyToPath — converts a filename back into a logical key.
+     */
+    private pathToKey;
+    private ensureDataDir;
+    private assertOpen;
+    /** Expose dataDir for testing / diagnostics. */
+    get directory(): string;
+}
+//# sourceMappingURL=json-provider.d.ts.map

package/dist/cjs/json-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-provider.d.ts","sourceRoot":"","sources":["../../src/json-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAyC,MAAM,YAAY,CAAC;AAEnF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,MAAyB;IAQxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAYnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBxC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,SAAS;YAgBH,aAAa;IAI3B,OAAO,CAAC,UAAU;IAIlB,gDAAgD;IAChD,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}

package/dist/cjs/json-provider.js

@@ -0,0 +1,173 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonProvider = void 0;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const types_js_1 = require("./types.js");
+/**
+ * JsonProvider
+ *
+ * File-system implementation of IWeaveProvider that stores each record as an
+ * individual JSON file inside a configurable data directory.
+ *
+ * Key → file-path mapping:
+ *   key = "graph:my-session"  →  <dataDir>/graph__my-session.json
+ *
+ * Colons in keys are replaced with double-underscores and any characters that
+ * are not safe for all major file systems are percent-encoded, so the mapping
+ * is always reversible.
+ *
+ * Backward-compatible with the original weave-graph PersistenceManager:
+ *   graph:<chatId>  →  weave-data/<chatId>.json   (no namespace prefix)
+ * That legacy layout is preserved for existing data directories.
+ */
+class JsonProvider {
+    dataDir;
+    closed = false;
+    constructor(dataDir = types_js_1.DEFAULT_DATA_DIR) {
+        this.dataDir = dataDir;
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    async close() {
+        this.closed = true;
+    }
+    // -------------------------------------------------------------------------
+    // Core operations
+    // -------------------------------------------------------------------------
+    async get(key) {
+        this.assertOpen();
+        const filePath = this.keyToPath(key);
+        try {
+            const content = await fs_1.promises.readFile(filePath, "utf-8");
+            return JSON.parse(content);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return null;
+            throw err;
+        }
+    }
+    async set(key, value) {
+        this.assertOpen();
+        await this.ensureDataDir();
+        const filePath = this.keyToPath(key);
+        await fs_1.promises.writeFile(filePath, JSON.stringify(value, null, 2), "utf-8");
+    }
+    async delete(key) {
+        this.assertOpen();
+        const filePath = this.keyToPath(key);
+        try {
+            await fs_1.promises.unlink(filePath);
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+            // key didn't exist — honour "no-op" contract
+        }
+    }
+    async list(prefix) {
+        this.assertOpen();
+        await this.ensureDataDir();
+        let entries;
+        try {
+            entries = await fs_1.promises.readdir(this.dataDir);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return [];
+            throw err;
+        }
+        const keys = entries
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => this.pathToKey(f));
+        if (!prefix)
+            return keys;
+        return keys.filter((k) => k.startsWith(prefix));
+    }
+    async clear(prefix) {
+        this.assertOpen();
+        const keys = await this.list(prefix);
+        await Promise.all(keys.map((k) => this.delete(k)));
+    }
+    // -------------------------------------------------------------------------
+    // Key ↔ filename helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Convert a logical key into an absolute file path.
+     *
+     * Rules (applied in order):
+     *   1. Replace ":" with "__" (namespace separator)
+     *   2. Replace "/" with "--" (path separator used in ids)
+     *   3. Append ".json"
+     */
+    keyToPath(key) {
+        const sanitized = key
+            .replace(/:/g, "__")
+            .replace(/\//g, "--")
+            .replace(/[^a-zA-Z0-9_\-\.]/g, (c) => `~${c.codePointAt(0)?.toString(16)}~`);
+        return path.join(this.dataDir, `${sanitized}.json`);
+    }
+    /**
+     * Reverse of keyToPath — converts a filename back into a logical key.
+     */
+    pathToKey(filename) {
+        const base = filename.endsWith(".json")
+            ? filename.slice(0, -5)
+            : filename;
+        return base
+            .replace(/~([0-9a-f]+)~/g, (_, hex) => String.fromCodePoint(parseInt(hex, 16)))
+            .replace(/--/g, "/")
+            .replace(/__/g, ":");
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    async ensureDataDir() {
+        await fs_1.promises.mkdir(this.dataDir, { recursive: true });
+    }
+    assertOpen() {
+        if (this.closed)
+            throw new types_js_1.ProviderClosedError("JsonProvider");
+    }
+    /** Expose dataDir for testing / diagnostics. */
+    get directory() {
+        return this.dataDir;
+    }
+}
+exports.JsonProvider = JsonProvider;
+//# sourceMappingURL=json-provider.js.map

package/dist/cjs/json-provider.js.map

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

package/dist/cjs/memory-provider.d.ts

@@ -0,0 +1,28 @@
+import { IWeaveProvider } from "./types.js";
+/**
+ * MemoryProvider
+ *
+ * An in-memory implementation of IWeaveProvider backed by a plain `Map`.
+ * Zero-latency reads/writes, no I/O, no external dependencies.
+ *
+ * Ideal for:
+ *  - Unit tests (fast, isolated, no temp-file cleanup needed)
+ *  - Ephemeral sessions where persistence across restarts is not required
+ *  - Streaming pipelines that only need within-process memory
+ */
+export declare class MemoryProvider<T = unknown> implements IWeaveProvider<T> {
+    private store;
+    private closed;
+    close(): Promise<void>;
+    get(key: string): Promise<T | null>;
+    set(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string): Promise<string[]>;
+    clear(prefix?: string): Promise<void>;
+    /** Current number of stored records. */
+    get size(): number;
+    /** Whether the provider has been closed. */
+    get isClosed(): boolean;
+    private assertOpen;
+}
+//# sourceMappingURL=memory-provider.d.ts.map

package/dist/cjs/memory-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-provider.d.ts","sourceRoot":"","sources":["../../src/memory-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,MAAM,CAAS;IAMjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOxC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3C,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD,OAAO,CAAC,UAAU;CAGnB"}

package/dist/cjs/memory-provider.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryProvider = void 0;
+const types_js_1 = require("./types.js");
+/**
+ * MemoryProvider
+ *
+ * An in-memory implementation of IWeaveProvider backed by a plain `Map`.
+ * Zero-latency reads/writes, no I/O, no external dependencies.
+ *
+ * Ideal for:
+ *  - Unit tests (fast, isolated, no temp-file cleanup needed)
+ *  - Ephemeral sessions where persistence across restarts is not required
+ *  - Streaming pipelines that only need within-process memory
+ */
+class MemoryProvider {
+    store = new Map();
+    closed = false;
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    async close() {
+        this.closed = true;
+        this.store.clear();
+    }
+    // -------------------------------------------------------------------------
+    // Core operations
+    // -------------------------------------------------------------------------
+    async get(key) {
+        this.assertOpen();
+        return this.store.get(key) ?? null;
+    }
+    async set(key, value) {
+        this.assertOpen();
+        this.store.set(key, value);
+    }
+    async delete(key) {
+        this.assertOpen();
+        this.store.delete(key);
+    }
+    async list(prefix) {
+        this.assertOpen();
+        const keys = [...this.store.keys()];
+        if (!prefix)
+            return keys;
+        return keys.filter((k) => k.startsWith(prefix));
+    }
+    async clear(prefix) {
+        this.assertOpen();
+        if (!prefix) {
+            this.store.clear();
+            return;
+        }
+        for (const key of this.store.keys()) {
+            if (key.startsWith(prefix)) {
+                this.store.delete(key);
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Utility — exposed for testing introspection
+    // -------------------------------------------------------------------------
+    /** Current number of stored records. */
+    get size() {
+        return this.store.size;
+    }
+    /** Whether the provider has been closed. */
+    get isClosed() {
+        return this.closed;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    assertOpen() {
+        if (this.closed)
+            throw new types_js_1.ProviderClosedError("MemoryProvider");
+    }
+}
+exports.MemoryProvider = MemoryProvider;
+//# sourceMappingURL=memory-provider.js.map

package/dist/cjs/memory-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-provider.js","sourceRoot":"","sources":["../../src/memory-provider.ts"],"names":[],"mappings":";;;AAAA,yCAAiE;AAEjE;;;;;;;;;;GAUG;AACH,MAAa,cAAc;IACjB,KAAK,GAAG,IAAI,GAAG,EAAa,CAAC;IAC7B,MAAM,GAAG,KAAK,CAAC;IAEvB,4EAA4E;IAC5E,YAAY;IACZ,4EAA4E;IAE5E,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAQ;QAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAe;QACxB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAe;QACzB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,8CAA8C;IAC9C,4EAA4E;IAE5E,wCAAwC;IACxC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,4CAA4C;IAC5C,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAEpE,UAAU;QAChB,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,8BAAmB,CAAC,gBAAgB,CAAC,CAAC;IACnE,CAAC;CACF;AAzED,wCAyEC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/registry.d.ts

@@ -0,0 +1,56 @@
+import { IWeaveProvider, ProviderFactory } from "./types.js";
+/**
+ * ProviderRegistry
+ *
+ * Central factory and registration hub for IWeaveProvider implementations.
+ *
+ * Built-in providers:
+ *   "json"   → JsonProvider  (default)
+ *   "memory" → MemoryProvider
+ *
+ * Third-party providers (weave-provider-sqlite, weave-provider-mongodb …) can
+ * register themselves at startup via `ProviderRegistry.register()`.
+ *
+ * Runtime resolution order:
+ *   1. `WEAVE_PROVIDER` environment variable (e.g. `WEAVE_PROVIDER=memory`)
+ *   2. Falls back to `"json"` when the env var is absent or empty
+ */
+export declare class ProviderRegistry {
+    private static factories;
+    /**
+     * Register a new provider factory under a named key.
+     * The key is normalised to lower-case before storing.
+     *
+     * @example
+     * // In weave-provider-sqlite:
+     * ProviderRegistry.register("sqlite", async () => new SqliteProvider(...));
+     */
+    static register<T = unknown>(name: string, factory: ProviderFactory<T>): void;
+    /**
+     * Resolve and instantiate a provider.
+     *
+     * @param type Explicit provider type string. When omitted, reads
+     *             `process.env.WEAVE_PROVIDER`.  Defaults to `"json"`.
+     *
+     * @throws {UnknownProviderError} if the type is not registered.
+     */
+    static resolve<T = unknown>(type?: string): Promise<IWeaveProvider<T>>;
+    /**
+     * Returns the list of currently registered provider names.
+     * Useful for diagnostics and help text.
+     */
+    static available(): string[];
+    /**
+     * Remove a registered provider (mainly for test isolation).
+     */
+    static unregister(name: string): void;
+}
+/**
+ * Convenience function — resolve the default (or env-configured) provider.
+ *
+ * @example
+ * const provider = await resolveProvider<GraphSnapshot>();
+ * await provider.set("graph:my-session", snapshot);
+ */
+export declare function resolveProvider<T = unknown>(type?: string): Promise<IWeaveProvider<T>>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/cjs/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EAKhB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAA+C;IAYvE;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAI7E;;;;;;;OAOG;WACU,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAW5E;;;OAGG;IACH,MAAM,CAAC,SAAS,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGtC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAE5B"}

package/dist/cjs/registry.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRegistry = void 0;
+exports.resolveProvider = resolveProvider;
+const types_js_1 = require("./types.js");
+const json_provider_js_1 = require("./json-provider.js");
+const memory_provider_js_1 = require("./memory-provider.js");
+/**
+ * ProviderRegistry
+ *
+ * Central factory and registration hub for IWeaveProvider implementations.
+ *
+ * Built-in providers:
+ *   "json"   → JsonProvider  (default)
+ *   "memory" → MemoryProvider
+ *
+ * Third-party providers (weave-provider-sqlite, weave-provider-mongodb …) can
+ * register themselves at startup via `ProviderRegistry.register()`.
+ *
+ * Runtime resolution order:
+ *   1. `WEAVE_PROVIDER` environment variable (e.g. `WEAVE_PROVIDER=memory`)
+ *   2. Falls back to `"json"` when the env var is absent or empty
+ */
+class ProviderRegistry {
+    static factories = new Map();
+    static {
+        // Register built-in providers
+        ProviderRegistry.register("json", async () => {
+            const dataDir = process.env[types_js_1.WEAVE_DATA_DIR_ENV] ?? types_js_1.DEFAULT_DATA_DIR;
+            return new json_provider_js_1.JsonProvider(dataDir);
+        });
+        ProviderRegistry.register("memory", async () => new memory_provider_js_1.MemoryProvider());
+    }
+    /**
+     * Register a new provider factory under a named key.
+     * The key is normalised to lower-case before storing.
+     *
+     * @example
+     * // In weave-provider-sqlite:
+     * ProviderRegistry.register("sqlite", async () => new SqliteProvider(...));
+     */
+    static register(name, factory) {
+        ProviderRegistry.factories.set(name.toLowerCase(), factory);
+    }
+    /**
+     * Resolve and instantiate a provider.
+     *
+     * @param type Explicit provider type string. When omitted, reads
+     *             `process.env.WEAVE_PROVIDER`.  Defaults to `"json"`.
+     *
+     * @throws {UnknownProviderError} if the type is not registered.
+     */
+    static async resolve(type) {
+        const raw = (type ?? process.env[types_js_1.WEAVE_PROVIDER_ENV] ?? "json")
+            .trim()
+            .toLowerCase();
+        const factory = ProviderRegistry.factories.get(raw);
+        if (!factory)
+            throw new types_js_1.UnknownProviderError(raw);
+        return factory();
+    }
+    /**
+     * Returns the list of currently registered provider names.
+     * Useful for diagnostics and help text.
+     */
+    static available() {
+        return [...ProviderRegistry.factories.keys()].sort();
+    }
+    /**
+     * Remove a registered provider (mainly for test isolation).
+     */
+    static unregister(name) {
+        ProviderRegistry.factories.delete(name.toLowerCase());
+    }
+}
+exports.ProviderRegistry = ProviderRegistry;
+/**
+ * Convenience function — resolve the default (or env-configured) provider.
+ *
+ * @example
+ * const provider = await resolveProvider<GraphSnapshot>();
+ * await provider.set("graph:my-session", snapshot);
+ */
+async function resolveProvider(type) {
+    return ProviderRegistry.resolve(type);
+}
+//# sourceMappingURL=registry.js.map

package/dist/cjs/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":";;;AA8FA,0CAIC;AAlGD,yCAOoB;AACpB,yDAAkD;AAClD,6DAAsD;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,MAAa,gBAAgB;IACnB,MAAM,CAAC,SAAS,GAAG,IAAI,GAAG,EAAoC,CAAC;IAEvE;QACE,8BAA8B;QAC9B,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,6BAAkB,CAAC,IAAI,2BAAgB,CAAC;YACpE,OAAO,IAAI,+BAAY,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,mCAAc,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAc,IAAY,EAAE,OAA2B;QACpE,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAmC,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAc,IAAa;QAC7C,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,6BAAkB,CAAC,IAAI,MAAM,CAAC;aAC5D,IAAI,EAAE;aACN,WAAW,EAAE,CAAC;QAEjB,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,+BAAoB,CAAC,GAAG,CAAC,CAAC;QAElD,OAAO,OAAO,EAAgC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAS;QACd,OAAO,CAAC,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAY;QAC5B,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,CAAC;;AAzDH,4CA0DC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,eAAe,CACnC,IAAa;IAEb,OAAO,gBAAgB,CAAC,OAAO,CAAI,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/cjs/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * weave-provider — Core type definitions
+ *
+ * IWeaveProvider<T> is the single storage contract that all provider
+ * implementations must satisfy. It follows a simple key-value model with
+ * optional namespace prefixes so that different subsystems (graph, sessions,
+ * vectors, paths) can share a single provider instance without colliding.
+ */
+/**
+ * Storage-agnostic key-value provider used by WeaveGraph, SessionLifecycle,
+ * VectorStore and WeavePath for all persistence needs.
+ *
+ * @typeParam T The value type stored under each key. In practice this will be
+ *              a serialisable plain object (JSON-compatible).
+ */
+export interface IWeaveProvider<T = unknown> {
+    /**
+     * Retrieve a single record by its full key.
+     * Returns `null` if the key does not exist.
+     */
+    get(key: string): Promise<T | null>;
+    /**
+     * Persist a record under the given key, overwriting any previous value.
+     */
+    set(key: string, value: T): Promise<void>;
+    /**
+     * Remove the record associated with the given key.
+     * A no-op if the key does not exist (must NOT throw).
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * List all keys that start with the given prefix.
+     * If prefix is omitted, return every key in the store.
+     *
+     * @param prefix Optional key prefix filter (e.g. `"graph:"`, `"session:"`).
+     */
+    list(prefix?: string): Promise<string[]>;
+    /**
+     * Delete all records whose keys start with the given prefix.
+     * If prefix is omitted, the entire store is wiped.
+     *
+     * @param prefix Optional key prefix filter.
+     */
+    clear(prefix?: string): Promise<void>;
+    /**
+     * Release any resources held by this provider (file handles, DB connections
+     * etc.). After `close()` is called the provider must not accept further
+     * operations.
+     */
+    close(): Promise<void>;
+}
+/**
+ * A zero-argument async factory that resolves to a ready-to-use provider.
+ * Used by the registry when building providers from a connection string.
+ */
+export type ProviderFactory<T = unknown> = () => Promise<IWeaveProvider<T>>;
+/**
+ * Environment variable that controls which provider the registry resolves.
+ *
+ * Accepted values (case-insensitive):
+ *   - `"json"` (default)        → JsonProvider
+ *   - `"memory"`                → MemoryProvider
+ *   - `"sqlite"` / a file path  → weave-provider-sqlite (separate package)
+ *   - `"mongodb"` / a URI       → weave-provider-mongodb (separate package)
+ *   - `"postgres"` / a URI      → weave-provider-postgres (separate package)
+ *   - `"mysql"` / a URI         → weave-provider-mysql (separate package)
+ */
+export declare const WEAVE_PROVIDER_ENV = "WEAVE_PROVIDER";
+/**
+ * Environment variable that controls the root data directory used by the
+ * JsonProvider (and, conventionally, any file-based provider).
+ */
+export declare const WEAVE_DATA_DIR_ENV = "WEAVE_DATA_DIR";
+/**
+ * Default data directory value when WEAVE_DATA_DIR is not set.
+ */
+export declare const DEFAULT_DATA_DIR = "./weave-data";
+/**
+ * Thrown when a provider operation is invoked after `close()` has been called.
+ */
+export declare class ProviderClosedError extends Error {
+    constructor(providerName: string);
+}
+/**
+ * Thrown when the registry cannot resolve a provider from the current
+ * environment configuration.
+ */
+export declare class UnknownProviderError extends Error {
+    constructor(value: string);
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAM5E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAM/C;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,YAAY,EAAE,MAAM;CAIjC;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,KAAK,EAAE,MAAM;CAQ1B"}

package/dist/cjs/types.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * weave-provider — Core type definitions
+ *
+ * IWeaveProvider<T> is the single storage contract that all provider
+ * implementations must satisfy. It follows a simple key-value model with
+ * optional namespace prefixes so that different subsystems (graph, sessions,
+ * vectors, paths) can share a single provider instance without colliding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnknownProviderError = exports.ProviderClosedError = exports.DEFAULT_DATA_DIR = exports.WEAVE_DATA_DIR_ENV = exports.WEAVE_PROVIDER_ENV = void 0;
+// ---------------------------------------------------------------------------
+// Registry configuration
+// ---------------------------------------------------------------------------
+/**
+ * Environment variable that controls which provider the registry resolves.
+ *
+ * Accepted values (case-insensitive):
+ *   - `"json"` (default)        → JsonProvider
+ *   - `"memory"`                → MemoryProvider
+ *   - `"sqlite"` / a file path  → weave-provider-sqlite (separate package)
+ *   - `"mongodb"` / a URI       → weave-provider-mongodb (separate package)
+ *   - `"postgres"` / a URI      → weave-provider-postgres (separate package)
+ *   - `"mysql"` / a URI         → weave-provider-mysql (separate package)
+ */
+exports.WEAVE_PROVIDER_ENV = "WEAVE_PROVIDER";
+/**
+ * Environment variable that controls the root data directory used by the
+ * JsonProvider (and, conventionally, any file-based provider).
+ */
+exports.WEAVE_DATA_DIR_ENV = "WEAVE_DATA_DIR";
+/**
+ * Default data directory value when WEAVE_DATA_DIR is not set.
+ */
+exports.DEFAULT_DATA_DIR = "./weave-data";
+// ---------------------------------------------------------------------------
+// Error types
+// ---------------------------------------------------------------------------
+/**
+ * Thrown when a provider operation is invoked after `close()` has been called.
+ */
+class ProviderClosedError extends Error {
+    constructor(providerName) {
+        super(`[${providerName}] provider has been closed and is no longer usable`);
+        this.name = "ProviderClosedError";
+    }
+}
+exports.ProviderClosedError = ProviderClosedError;
+/**
+ * Thrown when the registry cannot resolve a provider from the current
+ * environment configuration.
+ */
+class UnknownProviderError extends Error {
+    constructor(value) {
+        super(`[weave-provider] Unknown provider type "${value}". ` +
+            `Set ${exports.WEAVE_PROVIDER_ENV}=json|memory or install the corresponding ` +
+            `weave-provider-* package.`);
+        this.name = "UnknownProviderError";
+    }
+}
+exports.UnknownProviderError = UnknownProviderError;
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAiEH,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACU,QAAA,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD;;;GAGG;AACU,QAAA,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD;;GAEG;AACU,QAAA,gBAAgB,GAAG,cAAc,CAAC;AAE/C,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;GAEG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,YAAoB;QAC9B,KAAK,CAAC,IAAI,YAAY,oDAAoD,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED;;;GAGG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,KAAa;QACvB,KAAK,CACH,2CAA2C,KAAK,KAAK;YACnD,OAAO,0BAAkB,4CAA4C;YACrE,2BAA2B,CAC9B,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AATD,oDASC"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@openweave/weave-provider",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Storage-agnostic persistence contract for OpenWeave — IWeaveProvider<T> interface + built-in implementations",
   "private": false,
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.js",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
@@ -13,6 +14,7 @@
   ],
   "exports": {
     ".": {
+      "require": "./dist/cjs/index.js",
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     }
@@ -30,7 +32,7 @@
   },
   "dependencies": {},
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', '{\\\"type\\\":\\\"commonjs\\\"}')\"",
     "dev": "tsc --watch",
     "test": "vitest",
     "lint": "eslint src --max-warnings 0",