dpth 0.1.0 → 0.2.0

package/dist/adapter-sqlite.d.ts

@@ -0,0 +1,56 @@
+/**
+ * dpth.io SQLite Storage Adapter
+ *
+ * Persistent storage using SQLite via better-sqlite3.
+ * Provides ACID transactions, SQL queries, and disk persistence.
+ *
+ * Requires: npm install better-sqlite3
+ *
+ * Usage:
+ *   import { configure } from 'dpth/storage';
+ *   import { SQLiteAdapter } from 'dpth/adapter-sqlite';
+ *   configure({ adapter: new SQLiteAdapter('./dpth.db') });
+ */
+import type { StorageAdapter, QueryFilter } from './storage.js';
+export interface SQLiteAdapterOptions {
+    /** Path to database file (use ':memory:' for in-memory) */
+    path: string;
+    /** Enable WAL mode for better concurrent read performance (default: true) */
+    wal?: boolean;
+    /** Serialize values as JSON (default: true) */
+    json?: boolean;
+}
+export declare class SQLiteAdapter implements StorageAdapter {
+    private db;
+    private ready;
+    private stmtCache;
+    private opts;
+    constructor(pathOrOpts: string | SQLiteAdapterOptions);
+    private init;
+    private ensureReady;
+    private stmt;
+    private serialize;
+    private deserialize;
+    get(collection: string, key: string): Promise<unknown | undefined>;
+    put(collection: string, key: string, value: unknown): Promise<void>;
+    delete(collection: string, key: string): Promise<boolean>;
+    has(collection: string, key: string): Promise<boolean>;
+    query(filter: QueryFilter): Promise<unknown[]>;
+    keys(collection: string): Promise<string[]>;
+    count(collection: string): Promise<number>;
+    clear(collection?: string): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Run a batch of operations in a transaction (SQLite-specific)
+     */
+    transaction<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get database stats (SQLite-specific)
+     */
+    stats(): Promise<{
+        collections: Record<string, number>;
+        totalRows: number;
+        fileSizeBytes: number;
+    }>;
+}
+//# sourceMappingURL=adapter-sqlite.d.ts.map

package/dist/adapter-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-sqlite.d.ts","sourceRoot":"","sources":["../src/adapter-sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAsBhE,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,IAAI,CAAiC;gBAEjC,UAAU,EAAE,MAAM,GAAG,oBAAoB;YASvC,IAAI;YAwBJ,WAAW;IAIzB,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IAgBb,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAOlE,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOzD,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOtD,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA0D9C,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO3C,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO1C,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAMtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CAsB1G"}

package/dist/adapter-sqlite.js

@@ -0,0 +1,234 @@
+/**
+ * dpth.io SQLite Storage Adapter
+ *
+ * Persistent storage using SQLite via better-sqlite3.
+ * Provides ACID transactions, SQL queries, and disk persistence.
+ *
+ * Requires: npm install better-sqlite3
+ *
+ * Usage:
+ *   import { configure } from 'dpth/storage';
+ *   import { SQLiteAdapter } from 'dpth/adapter-sqlite';
+ *   configure({ adapter: new SQLiteAdapter('./dpth.db') });
+ */
+// Dynamic import to avoid hard dependency — no type import needed
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let Database;
+async function loadSqlite() {
+    if (Database)
+        return Database;
+    try {
+        // Dynamic import — only fails if better-sqlite3 not installed
+        const mod = await Function('return import("better-sqlite3")')();
+        Database = mod.default || mod;
+        return Database;
+    }
+    catch {
+        throw new Error('better-sqlite3 is required for SQLiteAdapter. Install it:\n' +
+            '  npm install better-sqlite3\n' +
+            '  npm install -D @types/better-sqlite3');
+    }
+}
+export class SQLiteAdapter {
+    db;
+    ready;
+    stmtCache = new Map();
+    opts;
+    constructor(pathOrOpts) {
+        const opts = typeof pathOrOpts === 'string'
+            ? { path: pathOrOpts, wal: true, json: true }
+            : { wal: true, json: true, ...pathOrOpts };
+        this.opts = opts;
+        this.ready = this.init();
+    }
+    async init() {
+        const Sqlite = await loadSqlite();
+        this.db = new Sqlite(this.opts.path);
+        if (this.opts.wal) {
+            this.db.pragma('journal_mode = WAL');
+        }
+        this.db.pragma('foreign_keys = ON');
+        // Create the universal key-value table with collection support
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS dpth_store (
+        collection TEXT NOT NULL,
+        key TEXT NOT NULL,
+        value TEXT NOT NULL,
+        created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+        updated_at INTEGER NOT NULL DEFAULT (unixepoch()),
+        PRIMARY KEY (collection, key)
+      );
+      CREATE INDEX IF NOT EXISTS idx_dpth_collection ON dpth_store(collection);
+      CREATE INDEX IF NOT EXISTS idx_dpth_updated ON dpth_store(collection, updated_at);
+    `);
+    }
+    async ensureReady() {
+        await this.ready;
+    }
+    stmt(sql) {
+        let s = this.stmtCache.get(sql);
+        if (!s) {
+            s = this.db.prepare(sql);
+            this.stmtCache.set(sql, s);
+        }
+        return s;
+    }
+    serialize(value) {
+        return this.opts.json ? JSON.stringify(value) : String(value);
+    }
+    deserialize(raw) {
+        if (!this.opts.json)
+            return raw;
+        try {
+            return JSON.parse(raw, (key, value) => {
+                // Revive Date objects
+                if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value)) {
+                    const d = new Date(value);
+                    if (!isNaN(d.getTime()))
+                        return d;
+                }
+                return value;
+            });
+        }
+        catch {
+            return raw;
+        }
+    }
+    async get(collection, key) {
+        await this.ensureReady();
+        const row = this.stmt('SELECT value FROM dpth_store WHERE collection = ? AND key = ?')
+            .get(collection, key);
+        return row ? this.deserialize(row.value) : undefined;
+    }
+    async put(collection, key, value) {
+        await this.ensureReady();
+        const serialized = this.serialize(value);
+        this.stmt(`
+      INSERT INTO dpth_store (collection, key, value, updated_at)
+      VALUES (?, ?, ?, unixepoch())
+      ON CONFLICT(collection, key)
+      DO UPDATE SET value = excluded.value, updated_at = unixepoch()
+    `).run(collection, key, serialized);
+    }
+    async delete(collection, key) {
+        await this.ensureReady();
+        const result = this.stmt('DELETE FROM dpth_store WHERE collection = ? AND key = ?')
+            .run(collection, key);
+        return result.changes > 0;
+    }
+    async has(collection, key) {
+        await this.ensureReady();
+        const row = this.stmt('SELECT 1 FROM dpth_store WHERE collection = ? AND key = ?')
+            .get(collection, key);
+        return !!row;
+    }
+    async query(filter) {
+        await this.ensureReady();
+        // Get all items in collection, then filter in JS
+        // (JSON values can't be efficiently queried in SQL without json_extract)
+        const rows = this.stmt('SELECT value FROM dpth_store WHERE collection = ?')
+            .all(filter.collection);
+        let results = rows.map(r => this.deserialize(r.value));
+        // Apply where filters
+        if (filter.where) {
+            for (const [field, value] of Object.entries(filter.where)) {
+                results = results.filter(item => {
+                    const obj = item;
+                    return obj[field] === value;
+                });
+            }
+        }
+        // Apply comparison filters
+        if (filter.compare) {
+            for (const cmp of filter.compare) {
+                results = results.filter(item => {
+                    const obj = item;
+                    const fieldVal = obj[cmp.field];
+                    switch (cmp.op) {
+                        case 'gt': return fieldVal > cmp.value;
+                        case 'gte': return fieldVal >= cmp.value;
+                        case 'lt': return fieldVal < cmp.value;
+                        case 'lte': return fieldVal <= cmp.value;
+                        case 'ne': return fieldVal !== cmp.value;
+                        case 'in': return cmp.value.includes(fieldVal);
+                        case 'contains': return typeof fieldVal === 'string' && fieldVal.includes(cmp.value);
+                        default: return true;
+                    }
+                });
+            }
+        }
+        // Apply ordering
+        if (filter.orderBy) {
+            const { field, direction } = filter.orderBy;
+            results.sort((a, b) => {
+                const aVal = a[field];
+                const bVal = b[field];
+                if (aVal === bVal)
+                    return 0;
+                const cmp = aVal < bVal ? -1 : 1;
+                return direction === 'asc' ? cmp : -cmp;
+            });
+        }
+        // Apply pagination
+        if (filter.offset)
+            results = results.slice(filter.offset);
+        if (filter.limit)
+            results = results.slice(0, filter.limit);
+        return results;
+    }
+    async keys(collection) {
+        await this.ensureReady();
+        const rows = this.stmt('SELECT key FROM dpth_store WHERE collection = ?')
+            .all(collection);
+        return rows.map(r => r.key);
+    }
+    async count(collection) {
+        await this.ensureReady();
+        const row = this.stmt('SELECT COUNT(*) as cnt FROM dpth_store WHERE collection = ?')
+            .get(collection);
+        return row.cnt;
+    }
+    async clear(collection) {
+        await this.ensureReady();
+        if (collection) {
+            this.stmt('DELETE FROM dpth_store WHERE collection = ?').run(collection);
+        }
+        else {
+            this.db.exec('DELETE FROM dpth_store');
+        }
+    }
+    async close() {
+        await this.ensureReady();
+        this.stmtCache.clear();
+        this.db.close();
+    }
+    /**
+     * Run a batch of operations in a transaction (SQLite-specific)
+     */
+    async transaction(fn) {
+        await this.ensureReady();
+        const tx = this.db.transaction(() => fn());
+        return tx();
+    }
+    /**
+     * Get database stats (SQLite-specific)
+     */
+    async stats() {
+        await this.ensureReady();
+        const rows = this.stmt('SELECT collection, COUNT(*) as cnt FROM dpth_store GROUP BY collection').all();
+        const collections = {};
+        let total = 0;
+        for (const row of rows) {
+            collections[row.collection] = row.cnt;
+            total += row.cnt;
+        }
+        const pageCount = this.db.pragma('page_count', { simple: true });
+        const pageSize = this.db.pragma('page_size', { simple: true });
+        return {
+            collections,
+            totalRows: total,
+            fileSizeBytes: pageCount * pageSize,
+        };
+    }
+}
+//# sourceMappingURL=adapter-sqlite.js.map

package/dist/adapter-sqlite.js.map

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

package/dist/adapter-vector.d.ts

@@ -0,0 +1,59 @@
+/**
+ * dpth.io Vector Storage Adapter
+ *
+ * Adds semantic search capabilities on top of any base adapter.
+ * Uses cosine similarity for nearest-neighbor search.
+ *
+ * Two implementations:
+ * 1. MemoryVectorAdapter — in-memory, zero deps, good for prototyping
+ * 2. (future) SqliteVecAdapter — persistent vectors via sqlite-vec
+ *
+ * Usage:
+ *   import { configure } from 'dpth/storage';
+ *   import { MemoryVectorAdapter } from 'dpth/adapter-vector';
+ *   configure({ adapter: new MemoryVectorAdapter() });
+ */
+import type { StorageAdapter, VectorAdapter, VectorResult, QueryFilter } from './storage.js';
+import { MemoryAdapter } from './storage.js';
+/**
+ * In-memory vector adapter with brute-force cosine similarity search.
+ * Good for up to ~100K vectors. For larger scale, use SqliteVecAdapter.
+ */
+export declare class MemoryVectorAdapter extends MemoryAdapter implements VectorAdapter {
+    private vectors;
+    private getVectorCollection;
+    putVector(collection: string, key: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    searchVector(collection: string, vector: number[], topK: number, minScore?: number): Promise<VectorResult[]>;
+    dimensions(collection: string): Promise<number | undefined>;
+    clear(collection?: string): Promise<void>;
+}
+/**
+ * Wraps any base StorageAdapter and adds vector search on top.
+ * Vectors stored in memory, base data stored via the underlying adapter.
+ *
+ * Useful pattern: wrap a SQLiteAdapter to get persistence + vectors
+ *
+ * @example
+ * import { SQLiteAdapter } from 'dpth/adapter-sqlite';
+ * import { VectorOverlay } from 'dpth/adapter-vector';
+ * const adapter = new VectorOverlay(new SQLiteAdapter('./data.db'));
+ */
+export declare class VectorOverlay implements VectorAdapter {
+    private base;
+    private vectors;
+    constructor(base: StorageAdapter);
+    private getVectorCollection;
+    putVector(collection: string, key: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    searchVector(collection: string, vector: number[], topK: number, minScore?: number): Promise<VectorResult[]>;
+    dimensions(collection: string): Promise<number | undefined>;
+    get(collection: string, key: string): Promise<unknown>;
+    put(collection: string, key: string, value: unknown): Promise<void>;
+    delete(collection: string, key: string): Promise<boolean>;
+    has(collection: string, key: string): Promise<boolean>;
+    query(filter: QueryFilter): Promise<unknown[]>;
+    keys(collection: string): Promise<string[]>;
+    count(collection: string): Promise<number>;
+    clear(collection?: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=adapter-vector.d.ts.map

package/dist/adapter-vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-vector.d.ts","sourceRoot":"","sources":["../src/adapter-vector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAU7C;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,aAAc,YAAW,aAAa;IAC7E,OAAO,CAAC,OAAO,CAAoC;IAEnD,OAAO,CAAC,mBAAmB;IASrB,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAiBV,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC;IAepB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAM3D,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQhD;AAuBD;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,YAAW,aAAa;IAGrC,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,OAAO,CAAoC;gBAE/B,IAAI,EAAE,cAAc;IAExC,OAAO,CAAC,mBAAmB;IAWrB,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAeV,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC;IAepB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQjE,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IACnC,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IACnD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IACtC,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IACnC,KAAK,CAAC,MAAM,EAAE,WAAW;IACzB,IAAI,CAAC,UAAU,EAAE,MAAM;IACvB,KAAK,CAAC,UAAU,EAAE,MAAM;IAElB,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/adapter-vector.js

@@ -0,0 +1,168 @@
+/**
+ * dpth.io Vector Storage Adapter
+ *
+ * Adds semantic search capabilities on top of any base adapter.
+ * Uses cosine similarity for nearest-neighbor search.
+ *
+ * Two implementations:
+ * 1. MemoryVectorAdapter — in-memory, zero deps, good for prototyping
+ * 2. (future) SqliteVecAdapter — persistent vectors via sqlite-vec
+ *
+ * Usage:
+ *   import { configure } from 'dpth/storage';
+ *   import { MemoryVectorAdapter } from 'dpth/adapter-vector';
+ *   configure({ adapter: new MemoryVectorAdapter() });
+ */
+import { MemoryAdapter } from './storage.js';
+/**
+ * In-memory vector adapter with brute-force cosine similarity search.
+ * Good for up to ~100K vectors. For larger scale, use SqliteVecAdapter.
+ */
+export class MemoryVectorAdapter extends MemoryAdapter {
+    vectors = new Map(); // collection → entries
+    getVectorCollection(collection) {
+        let col = this.vectors.get(collection);
+        if (!col) {
+            col = [];
+            this.vectors.set(collection, col);
+        }
+        return col;
+    }
+    async putVector(collection, key, vector, metadata) {
+        const col = this.getVectorCollection(collection);
+        // Update existing or add new
+        const existing = col.findIndex(e => e.key === key);
+        const entry = { key, vector, metadata: metadata || {} };
+        if (existing >= 0) {
+            col[existing] = entry;
+        }
+        else {
+            col.push(entry);
+        }
+        // Also store metadata in the base KV store for query support
+        await this.put(collection, key, { ...metadata, _hasVector: true });
+    }
+    async searchVector(collection, vector, topK, minScore = 0) {
+        const col = this.getVectorCollection(collection);
+        const scored = [];
+        for (const entry of col) {
+            const score = cosineSimilarity(vector, entry.vector);
+            if (score >= minScore) {
+                scored.push({ key: entry.key, score, metadata: entry.metadata });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, topK);
+    }
+    async dimensions(collection) {
+        const col = this.vectors.get(collection);
+        if (!col || col.length === 0)
+            return undefined;
+        return col[0].vector.length;
+    }
+    async clear(collection) {
+        await super.clear(collection);
+        if (collection) {
+            this.vectors.delete(collection);
+        }
+        else {
+            this.vectors.clear();
+        }
+    }
+}
+// ─── Cosine Similarity ───────────────────────────────
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+// ─── Wrapper Adapter ─────────────────────────────────
+/**
+ * Wraps any base StorageAdapter and adds vector search on top.
+ * Vectors stored in memory, base data stored via the underlying adapter.
+ *
+ * Useful pattern: wrap a SQLiteAdapter to get persistence + vectors
+ *
+ * @example
+ * import { SQLiteAdapter } from 'dpth/adapter-sqlite';
+ * import { VectorOverlay } from 'dpth/adapter-vector';
+ * const adapter = new VectorOverlay(new SQLiteAdapter('./data.db'));
+ */
+export class VectorOverlay {
+    base;
+    vectors = new Map();
+    constructor(base) {
+        this.base = base;
+    }
+    getVectorCollection(collection) {
+        let col = this.vectors.get(collection);
+        if (!col) {
+            col = [];
+            this.vectors.set(collection, col);
+        }
+        return col;
+    }
+    // ── Vector operations ──
+    async putVector(collection, key, vector, metadata) {
+        const col = this.getVectorCollection(collection);
+        const existing = col.findIndex(e => e.key === key);
+        const entry = { key, vector, metadata: metadata || {} };
+        if (existing >= 0) {
+            col[existing] = entry;
+        }
+        else {
+            col.push(entry);
+        }
+        // Store metadata in base adapter
+        await this.base.put(collection, key, { ...metadata, _hasVector: true });
+    }
+    async searchVector(collection, vector, topK, minScore = 0) {
+        const col = this.getVectorCollection(collection);
+        const scored = [];
+        for (const entry of col) {
+            const score = cosineSimilarity(vector, entry.vector);
+            if (score >= minScore) {
+                scored.push({ key: entry.key, score, metadata: entry.metadata });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, topK);
+    }
+    async dimensions(collection) {
+        const col = this.vectors.get(collection);
+        if (!col || col.length === 0)
+            return undefined;
+        return col[0].vector.length;
+    }
+    // ── Delegate base operations ──
+    get(collection, key) { return this.base.get(collection, key); }
+    put(collection, key, value) { return this.base.put(collection, key, value); }
+    delete(collection, key) { return this.base.delete(collection, key); }
+    has(collection, key) { return this.base.has(collection, key); }
+    query(filter) { return this.base.query(filter); }
+    keys(collection) { return this.base.keys(collection); }
+    count(collection) { return this.base.count(collection); }
+    async clear(collection) {
+        await this.base.clear(collection);
+        if (collection) {
+            this.vectors.delete(collection);
+        }
+        else {
+            this.vectors.clear();
+        }
+    }
+    async close() {
+        this.vectors.clear();
+        await this.base.close();
+    }
+}
+//# sourceMappingURL=adapter-vector.js.map

package/dist/adapter-vector.js.map

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

package/dist/index.d.ts

@@ -13,6 +13,7 @@
  * - Fallback: Centralized inference when no agents available
  */
 export * from './types.js';
+export * from './storage.js';
 export * from './entity.js';
 export * from './correlation.js';
 export * from './temporal.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -13,6 +13,7 @@
  * - Fallback: Centralized inference when no agents available
  */
 export * from './types.js';
+export * from './storage.js';
 export * from './entity.js';
 export * from './correlation.js';
 export * from './temporal.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,107 @@
+/**
+ * dpth.io Storage Adapter System
+ *
+ * Pluggable storage backends. dpth works in-memory by default,
+ * add SQLite for persistence, add vectors for semantic search.
+ *
+ * Usage:
+ *   import { configure, MemoryAdapter } from 'dpth/storage';
+ *   configure({ adapter: new MemoryAdapter() }); // default
+ *
+ *   import { SQLiteAdapter } from 'dpth/storage';
+ *   configure({ adapter: new SQLiteAdapter('./data.db') });
+ */
+export interface QueryFilter {
+    /** Collection/table to query */
+    collection: string;
+    /** Field equality filters */
+    where?: Record<string, unknown>;
+    /** Field comparison filters */
+    compare?: Array<{
+        field: string;
+        op: 'gt' | 'gte' | 'lt' | 'lte' | 'ne' | 'in' | 'contains';
+        value: unknown;
+    }>;
+    /** Sort by field */
+    orderBy?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+export interface StorageAdapter {
+    /** Get a value by collection and key */
+    get(collection: string, key: string): Promise<unknown | undefined>;
+    /** Store a value by collection and key */
+    put(collection: string, key: string, value: unknown): Promise<void>;
+    /** Delete a value by collection and key */
+    delete(collection: string, key: string): Promise<boolean>;
+    /** Check if a key exists in a collection */
+    has(collection: string, key: string): Promise<boolean>;
+    /** Query a collection with filters */
+    query(filter: QueryFilter): Promise<unknown[]>;
+    /** Get all keys in a collection */
+    keys(collection: string): Promise<string[]>;
+    /** Get count of items in a collection */
+    count(collection: string): Promise<number>;
+    /** Clear a collection (or all collections if no name given) */
+    clear(collection?: string): Promise<void>;
+    /** Close the adapter (cleanup connections, flush writes) */
+    close(): Promise<void>;
+}
+/** Vector search capabilities (extends base adapter) */
+export interface VectorAdapter extends StorageAdapter {
+    /** Store a vector with metadata */
+    putVector(collection: string, key: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    /** Search by vector similarity */
+    searchVector(collection: string, vector: number[], topK: number, minScore?: number): Promise<VectorResult[]>;
+    /** Get vector dimensions for a collection */
+    dimensions(collection: string): Promise<number | undefined>;
+}
+export interface VectorResult {
+    key: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class MemoryAdapter implements StorageAdapter {
+    private store;
+    private getCollection;
+    get(collection: string, key: string): Promise<unknown | undefined>;
+    put(collection: string, key: string, value: unknown): Promise<void>;
+    delete(collection: string, key: string): Promise<boolean>;
+    has(collection: string, key: string): Promise<boolean>;
+    query(filter: QueryFilter): Promise<unknown[]>;
+    keys(collection: string): Promise<string[]>;
+    count(collection: string): Promise<number>;
+    clear(collection?: string): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Configure dpth with a storage adapter.
+ * Call before using any dpth modules.
+ *
+ * @example
+ * import { configure, MemoryAdapter } from 'dpth/storage';
+ * configure({ adapter: new MemoryAdapter() }); // default
+ *
+ * @example
+ * import { configure } from 'dpth/storage';
+ * import { SQLiteAdapter } from 'dpth/adapter-sqlite';
+ * configure({ adapter: new SQLiteAdapter('./data.db') });
+ */
+export declare function configure(options: {
+    adapter: StorageAdapter;
+}): void;
+/**
+ * Get the current storage adapter.
+ * Used internally by dpth modules.
+ */
+export declare function getAdapter(): StorageAdapter;
+/**
+ * Reset to default memory adapter (mainly for testing)
+ */
+export declare function resetAdapter(): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -0,0 +1,136 @@
+/**
+ * dpth.io Storage Adapter System
+ *
+ * Pluggable storage backends. dpth works in-memory by default,
+ * add SQLite for persistence, add vectors for semantic search.
+ *
+ * Usage:
+ *   import { configure, MemoryAdapter } from 'dpth/storage';
+ *   configure({ adapter: new MemoryAdapter() }); // default
+ *
+ *   import { SQLiteAdapter } from 'dpth/storage';
+ *   configure({ adapter: new SQLiteAdapter('./data.db') });
+ */
+// ─── Memory Adapter (default) ────────────────────────
+export class MemoryAdapter {
+    store = new Map();
+    getCollection(name) {
+        let col = this.store.get(name);
+        if (!col) {
+            col = new Map();
+            this.store.set(name, col);
+        }
+        return col;
+    }
+    async get(collection, key) {
+        return this.getCollection(collection).get(key);
+    }
+    async put(collection, key, value) {
+        this.getCollection(collection).set(key, value);
+    }
+    async delete(collection, key) {
+        return this.getCollection(collection).delete(key);
+    }
+    async has(collection, key) {
+        return this.getCollection(collection).has(key);
+    }
+    async query(filter) {
+        const col = this.getCollection(filter.collection);
+        let results = Array.from(col.values());
+        // Apply where filters
+        if (filter.where) {
+            for (const [field, value] of Object.entries(filter.where)) {
+                results = results.filter(item => {
+                    const obj = item;
+                    return obj[field] === value;
+                });
+            }
+        }
+        // Apply comparison filters
+        if (filter.compare) {
+            for (const cmp of filter.compare) {
+                results = results.filter(item => {
+                    const obj = item;
+                    const fieldVal = obj[cmp.field];
+                    switch (cmp.op) {
+                        case 'gt': return fieldVal > cmp.value;
+                        case 'gte': return fieldVal >= cmp.value;
+                        case 'lt': return fieldVal < cmp.value;
+                        case 'lte': return fieldVal <= cmp.value;
+                        case 'ne': return fieldVal !== cmp.value;
+                        case 'in': return cmp.value.includes(fieldVal);
+                        case 'contains': return typeof fieldVal === 'string' && fieldVal.includes(cmp.value);
+                        default: return true;
+                    }
+                });
+            }
+        }
+        // Apply ordering
+        if (filter.orderBy) {
+            const { field, direction } = filter.orderBy;
+            results.sort((a, b) => {
+                const aVal = a[field];
+                const bVal = b[field];
+                if (aVal === bVal)
+                    return 0;
+                const cmp = aVal < bVal ? -1 : 1;
+                return direction === 'asc' ? cmp : -cmp;
+            });
+        }
+        // Apply pagination
+        if (filter.offset)
+            results = results.slice(filter.offset);
+        if (filter.limit)
+            results = results.slice(0, filter.limit);
+        return results;
+    }
+    async keys(collection) {
+        return Array.from(this.getCollection(collection).keys());
+    }
+    async count(collection) {
+        return this.getCollection(collection).size;
+    }
+    async clear(collection) {
+        if (collection) {
+            this.store.delete(collection);
+        }
+        else {
+            this.store.clear();
+        }
+    }
+    async close() {
+        // No-op for memory adapter
+    }
+}
+// ─── Global Configuration ────────────────────────────
+let globalAdapter = new MemoryAdapter();
+/**
+ * Configure dpth with a storage adapter.
+ * Call before using any dpth modules.
+ *
+ * @example
+ * import { configure, MemoryAdapter } from 'dpth/storage';
+ * configure({ adapter: new MemoryAdapter() }); // default
+ *
+ * @example
+ * import { configure } from 'dpth/storage';
+ * import { SQLiteAdapter } from 'dpth/adapter-sqlite';
+ * configure({ adapter: new SQLiteAdapter('./data.db') });
+ */
+export function configure(options) {
+    globalAdapter = options.adapter;
+}
+/**
+ * Get the current storage adapter.
+ * Used internally by dpth modules.
+ */
+export function getAdapter() {
+    return globalAdapter;
+}
+/**
+ * Reset to default memory adapter (mainly for testing)
+ */
+export function resetAdapter() {
+    globalAdapter = new MemoryAdapter();
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dpth",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The distributed intelligence layer — decentralized AI inference, data intelligence, and agent coordination.",
   "type": "module",
   "main": "dist/index.js",
@@ -41,6 +41,18 @@
     "./federation": {
       "import": "./dist/federation.js",
       "types": "./dist/federation.d.ts"
+    },
+    "./storage": {
+      "import": "./dist/storage.js",
+      "types": "./dist/storage.d.ts"
+    },
+    "./adapter-sqlite": {
+      "import": "./dist/adapter-sqlite.js",
+      "types": "./dist/adapter-sqlite.d.ts"
+    },
+    "./adapter-vector": {
+      "import": "./dist/adapter-vector.js",
+      "types": "./dist/adapter-vector.d.ts"
     }
   },
   "files": [
@@ -52,7 +64,7 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "lint": "eslint src/",
-    "test": "tsx test/smoke.ts && tsx test/integration.ts",
+    "test": "tsx test/smoke.ts && tsx test/integration.ts && tsx test/api.ts && tsx test/adapters.ts",
     "prepublishOnly": "npm run build && npm test"
   },
   "keywords": [
@@ -80,6 +92,14 @@
   "engines": {
     "node": ">=18"
   },
+  "peerDependencies": {
+    "better-sqlite3": ">=11.0.0"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
   "sideEffects": false,
   "devDependencies": {
     "@types/node": "^25.2.0",