@zauso-ai/capstan-db 0.1.4 → 0.3.0

package/dist/vector-store-sqlite.js

@@ -0,0 +1,203 @@
+// ---------------------------------------------------------------------------
+// SqliteVectorStore — SQLite-backed vector search with JSON array storage
+// ---------------------------------------------------------------------------
+//
+// Vectors are persisted as JSON arrays in a `capstan_vectors` table.  On
+// search, all matching rows are loaded into memory and scored with the same
+// cosine-distance function used by the in-memory store.  This gives durable
+// storage without requiring pgvector, at the cost of O(n) scan time.
+//
+// Suitable for moderate datasets where PostgreSQL is overkill but persistence
+// across restarts is desired.
+// ---------------------------------------------------------------------------
+import { cosineDistance } from "./search.js";
+/** Simple whitespace tokeniser with lower-casing and deduplication. */
+function tokenize(text) {
+    return [
+        ...new Set(text
+            .toLowerCase()
+            .split(/\W+/)
+            .filter((t) => t.length > 0)),
+    ];
+}
+function keywordOverlap(queryTerms, text) {
+    if (queryTerms.length === 0)
+        return 0;
+    const docTokens = new Set(tokenize(text));
+    let hits = 0;
+    for (const term of queryTerms) {
+        if (docTokens.has(term))
+            hits++;
+    }
+    return hits / queryTerms.length;
+}
+function matchesFilter(metadata, filter) {
+    for (const [key, value] of Object.entries(filter)) {
+        const actual = metadata[key];
+        if (Array.isArray(value)) {
+            if (!value.includes(actual))
+                return false;
+        }
+        else if (actual !== value) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * SQLite vector store.
+ *
+ * Stores vectors as JSON text columns and loads them into memory for
+ * brute-force cosine search.  The trade-off is durability with a simple
+ * dependency chain — no native extensions beyond `better-sqlite3`.
+ */
+export class SqliteVectorStore {
+    _db;
+    _table;
+    _dimensions;
+    _initialised = false;
+    constructor(config) {
+        if (!config.connection) {
+            throw new Error("SqliteVectorStore requires a `connection` (better-sqlite3 Database instance).");
+        }
+        this._db = config.connection;
+        this._table = config.tableName ?? "capstan_vectors";
+        this._dimensions = config.dimensions;
+    }
+    // -------------------------------------------------------------------------
+    // Schema bootstrap
+    // -------------------------------------------------------------------------
+    /** @internal */
+    _ensureSchema() {
+        if (this._initialised)
+            return;
+        this._db.exec(`
+      CREATE TABLE IF NOT EXISTS "${this._esc(this._table)}" (
+        id       TEXT PRIMARY KEY,
+        embedding TEXT NOT NULL,
+        content   TEXT NOT NULL DEFAULT '',
+        metadata  TEXT NOT NULL DEFAULT '{}'
+      )
+    `);
+        this._initialised = true;
+    }
+    // -------------------------------------------------------------------------
+    // VectorStore implementation
+    // -------------------------------------------------------------------------
+    async upsert(id, vector, metadata) {
+        this._validateDimensions(vector);
+        this._ensureSchema();
+        const text = typeof metadata?.["text"] === "string" ? metadata["text"] : "";
+        const metaJson = JSON.stringify(metadata ?? {});
+        this._db
+            .prepare(`INSERT INTO "${this._esc(this._table)}" (id, embedding, content, metadata)
+         VALUES (?, ?, ?, ?)
+         ON CONFLICT(id) DO UPDATE
+           SET embedding = excluded.embedding,
+               content   = excluded.content,
+               metadata  = excluded.metadata`)
+            .run(id, JSON.stringify(vector), text, metaJson);
+    }
+    async upsertBatch(items) {
+        if (items.length === 0)
+            return;
+        for (const item of items)
+            this._validateDimensions(item.vector);
+        this._ensureSchema();
+        const stmt = this._db.prepare(`INSERT INTO "${this._esc(this._table)}" (id, embedding, content, metadata)
+       VALUES (?, ?, ?, ?)
+       ON CONFLICT(id) DO UPDATE
+         SET embedding = excluded.embedding,
+             content   = excluded.content,
+             metadata  = excluded.metadata`);
+        for (const item of items) {
+            const text = typeof item.metadata?.["text"] === "string" ? item.metadata["text"] : "";
+            const metaJson = JSON.stringify(item.metadata ?? {});
+            stmt.run(item.id, JSON.stringify(item.vector), text, metaJson);
+        }
+    }
+    async search(query, k, filter) {
+        if (query.length === 0)
+            return [];
+        this._ensureSchema();
+        const rows = this._loadAll();
+        const results = [];
+        for (const row of rows) {
+            if (filter && !matchesFilter(row.metadata, filter))
+                continue;
+            if (row.vector.length !== query.length)
+                continue;
+            const score = 1 - cosineDistance(query, row.vector);
+            results.push({ id: row.id, score, metadata: row.metadata });
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, Math.max(0, k));
+    }
+    async hybridSearch(query, queryVector, k, opts) {
+        const vectorWeight = opts?.vectorWeight ?? 0.7;
+        const keywordWeight = opts?.keywordWeight ?? 0.3;
+        const queryTerms = tokenize(query);
+        if (queryTerms.length === 0 && queryVector.length === 0)
+            return [];
+        this._ensureSchema();
+        const rows = this._loadAll();
+        const results = [];
+        for (const row of rows) {
+            if (opts?.filter && !matchesFilter(row.metadata, opts.filter))
+                continue;
+            const vectorScore = queryVector.length > 0 && row.vector.length === queryVector.length
+                ? 1 - cosineDistance(queryVector, row.vector)
+                : 0;
+            const kwScore = keywordOverlap(queryTerms, row.content);
+            results.push({
+                id: row.id,
+                score: vectorWeight * vectorScore + keywordWeight * kwScore,
+                metadata: row.metadata,
+            });
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, Math.max(0, k));
+    }
+    async remove(id) {
+        this._ensureSchema();
+        const result = this._db
+            .prepare(`DELETE FROM "${this._esc(this._table)}" WHERE id = ?`)
+            .run(id);
+        return result.changes > 0;
+    }
+    async count() {
+        this._ensureSchema();
+        const row = this._db
+            .prepare(`SELECT COUNT(*) AS count FROM "${this._esc(this._table)}"`)
+            .get();
+        return Number(row?.["count"] ?? 0);
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    _validateDimensions(vector) {
+        if (vector.length === 0) {
+            throw new Error("Cannot store a zero-length vector.");
+        }
+        if (this._dimensions !== undefined && vector.length !== this._dimensions) {
+            throw new Error(`Dimension mismatch: expected ${this._dimensions}, got ${vector.length}.`);
+        }
+    }
+    /** Load all stored rows, parsing JSON columns. */
+    _loadAll() {
+        const rawRows = this._db
+            .prepare(`SELECT id, embedding, content, metadata FROM "${this._esc(this._table)}"`)
+            .all();
+        return rawRows.map((row) => ({
+            id: String(row["id"]),
+            vector: JSON.parse(String(row["embedding"])),
+            content: String(row["content"] ?? ""),
+            metadata: JSON.parse(String(row["metadata"] ?? "{}")),
+        }));
+    }
+    /** Escape a SQL identifier (double-quote style). */
+    _esc(identifier) {
+        return identifier.replace(/"/g, '""');
+    }
+}
+//# sourceMappingURL=vector-store-sqlite.js.map

package/dist/vector-store-sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-sqlite.js","sourceRoot":"","sources":["../../../.claude/worktrees/agent-a1ae6f0b/packages/db/src/vector-store-sqlite.ts"],"names":[],"mappings":"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"}

package/dist/vector-store.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Filter condition for vector search.  Each key is a metadata field name and
+ * the value is either a literal (exact match) or an array of allowed values.
+ */
+export type VectorFilter = Record<string, unknown>;
+/** A single result returned from a vector search operation. */
+export interface VectorSearchResult {
+    /** Identifier of the stored vector. */
+    id: string;
+    /** Similarity score in [0, 1] where 1 is identical. */
+    score: number;
+    /** Metadata that was stored alongside the vector. */
+    metadata?: Record<string, unknown>;
+}
+/** Options for hybrid (keyword + vector) search. */
+export interface VectorHybridSearchOptions {
+    /** Weight for the keyword component (0-1). @default 0.3 */
+    keywordWeight?: number;
+    /** Weight for the vector component (0-1). @default 0.7 */
+    vectorWeight?: number;
+    /** Optional metadata filter applied before scoring. */
+    filter?: VectorFilter;
+}
+/**
+ * Pluggable vector storage and similarity search backend.
+ *
+ * Implementations range from a simple in-memory map (development) through
+ * SQLite-backed persistence up to full pgvector-powered ANN search.
+ */
+export interface VectorStore {
+    /** Insert or update a vector with its ID and optional metadata. */
+    upsert(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    /** Batch upsert for efficiency. */
+    upsertBatch(items: ReadonlyArray<{
+        id: string;
+        vector: number[];
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    /** Find k nearest neighbours by vector similarity. */
+    search(query: number[], k: number, filter?: VectorFilter): Promise<VectorSearchResult[]>;
+    /**
+     * Hybrid search combining vector similarity with keyword text matching.
+     *
+     * The `query` string is used for keyword scoring while `queryVector` drives
+     * the vector similarity component.
+     */
+    hybridSearch(query: string, queryVector: number[], k: number, opts?: VectorHybridSearchOptions): Promise<VectorSearchResult[]>;
+    /** Remove a vector by ID.  Returns `true` if the entry existed. */
+    remove(id: string): Promise<boolean>;
+    /** Return the number of stored vectors. */
+    count(): Promise<number>;
+}
+/** Configuration accepted by the {@link createVectorStore} factory. */
+export interface VectorStoreConfig {
+    /** Backend provider to use. */
+    provider: "memory" | "pgvector" | "sqlite";
+    /**
+     * Number of dimensions each vector contains.  Required for pgvector so that
+     * the column can be sized correctly; optional for memory and SQLite stores.
+     */
+    dimensions?: number;
+    /**
+     * Name of the database table used for persistence.
+     * @default "capstan_vectors"
+     */
+    tableName?: string;
+    /**
+     * A raw query function used by the pgvector and SQLite adapters.
+     *
+     * For pgvector this should be a function that accepts a parameterised SQL
+     * string with `$1`, `$2`, etc. placeholders and returns an array of row
+     * objects.
+     *
+     * For SQLite this should be a synchronous `better-sqlite3` `Database`
+     * instance (it will be accessed via `.prepare().all()` / `.run()`).
+     */
+    connection?: unknown;
+}
+//# sourceMappingURL=vector-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../../.claude/worktrees/agent-a1ae6f0b/packages/db/src/vector-store.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,oDAAoD;AACpD,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExF,mCAAmC;IACnC,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvH,sDAAsD;IACtD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEzF;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAE/H,mEAAmE;IACnE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC,2CAA2C;IAC3C,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAE3C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/vector-store.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// VectorStore — adapter interface for pluggable vector search backends
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=vector-store.js.map

package/dist/vector-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.js","sourceRoot":"","sources":["../../../.claude/worktrees/agent-a1ae6f0b/packages/db/src/vector-store.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E"}

package/dist/write.d.ts

@@ -0,0 +1,15 @@
+import type { EmbeddingConfig } from "./embedding.js";
+import type { ModelDefinition } from "./types.js";
+export interface PrepareWriteOptions {
+    now?: Date;
+    embeddings?: Array<EmbeddingConfig & {
+        modelName?: string;
+    }> | (EmbeddingConfig & {
+        modelName?: string;
+    });
+}
+type RecordInput = Record<string, unknown>;
+export declare function prepareCreateData(model: ModelDefinition, input: RecordInput, options?: PrepareWriteOptions): Promise<RecordInput>;
+export declare function prepareUpdateData(model: ModelDefinition, input: RecordInput, options?: PrepareWriteOptions): Promise<RecordInput>;
+export {};
+//# sourceMappingURL=write.d.ts.map

package/dist/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../src/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,KAAK,CAAC,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,CAAC,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3G;AAED,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4L3C,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAEtB"}

package/dist/write.js

@@ -0,0 +1,156 @@
+import { cloneDefaultValue } from "./naming.js";
+function assertKnownFields(model, input) {
+    for (const key of Object.keys(input)) {
+        if (!(key in model.fields)) {
+            throw new Error(`Unknown field "${key}" for model "${model.name}".`);
+        }
+    }
+}
+function validateFieldValue(model, fieldName, field, value) {
+    if (value === undefined)
+        return;
+    if (value === null) {
+        if (field.required || field.updatedAt || field.autoId) {
+            throw new Error(`Field "${model.name}.${fieldName}" cannot be null.`);
+        }
+        return;
+    }
+    switch (field.type) {
+        case "string":
+        case "text":
+            if (typeof value !== "string") {
+                throw new Error(`Field "${model.name}.${fieldName}" must be a string.`);
+            }
+            if (field.min !== undefined && value.length < field.min) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be at least ${field.min} characters.`);
+            }
+            if (field.max !== undefined && value.length > field.max) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be at most ${field.max} characters.`);
+            }
+            break;
+        case "date":
+            if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be a YYYY-MM-DD string.`);
+            }
+            break;
+        case "datetime":
+            if (typeof value !== "string" || Number.isNaN(Date.parse(value))) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be a valid datetime string.`);
+            }
+            break;
+        case "integer":
+            if (typeof value !== "number" || !Number.isInteger(value)) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be an integer.`);
+            }
+            if (field.min !== undefined && value < field.min) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be at least ${field.min}.`);
+            }
+            if (field.max !== undefined && value > field.max) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be at most ${field.max}.`);
+            }
+            break;
+        case "number":
+            if (typeof value !== "number" || Number.isNaN(value)) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be a number.`);
+            }
+            if (field.min !== undefined && value < field.min) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be at least ${field.min}.`);
+            }
+            if (field.max !== undefined && value > field.max) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be at most ${field.max}.`);
+            }
+            break;
+        case "boolean":
+            if (typeof value !== "boolean") {
+                throw new Error(`Field "${model.name}.${fieldName}" must be a boolean.`);
+            }
+            break;
+        case "vector":
+            if (!Array.isArray(value) || value.some((entry) => typeof entry !== "number" || Number.isNaN(entry))) {
+                throw new Error(`Field "${model.name}.${fieldName}" must be a numeric vector.`);
+            }
+            if (field.dimensions !== undefined && value.length !== field.dimensions) {
+                throw new Error(`Field "${model.name}.${fieldName}" must contain exactly ${field.dimensions} dimensions.`);
+            }
+            break;
+        case "json":
+            break;
+    }
+    if (field.enum && !field.enum.includes(value)) {
+        throw new Error(`Field "${model.name}.${fieldName}" must be one of: ${field.enum.join(", ")}.`);
+    }
+}
+function validateRequiredFields(model, payload) {
+    for (const [fieldName, field] of Object.entries(model.fields)) {
+        if ((field.required || field.updatedAt || field.autoId) && payload[fieldName] === undefined) {
+            throw new Error(`Missing required field "${model.name}.${fieldName}".`);
+        }
+    }
+}
+function nowValue(field, now) {
+    switch (field.type) {
+        case "date":
+            return now.toISOString().slice(0, 10);
+        case "datetime":
+            return now.toISOString();
+        default:
+            return now.toISOString();
+    }
+}
+function embeddingConfigsForModel(model, embeddings) {
+    const list = embeddings === undefined ? [] : Array.isArray(embeddings) ? embeddings : [embeddings];
+    return list.filter((config) => config.modelName === undefined || config.modelName === model.name);
+}
+async function applyEmbeddings(model, payload, embeddings) {
+    for (const config of embeddingConfigsForModel(model, embeddings)) {
+        const sourceValue = payload[config.sourceField];
+        if (sourceValue === undefined || sourceValue === null)
+            continue;
+        if (typeof sourceValue !== "string") {
+            throw new Error(`Embedding source field "${config.sourceField}" on model "${model.name}" must resolve to a string.`);
+        }
+        const vectors = await config.adapter.embed([sourceValue]);
+        const vector = vectors[0];
+        if (!vector) {
+            throw new Error(`Embedding adapter for model "${model.name}" returned no embedding for "${config.sourceField}".`);
+        }
+        const vectorField = model.fields[config.vectorField];
+        if (vectorField?.dimensions !== undefined && vector.length !== vectorField.dimensions) {
+            throw new Error(`Embedding dimensions mismatch for "${model.name}.${config.vectorField}": expected ${vectorField.dimensions}, received ${vector.length}.`);
+        }
+        payload[config.vectorField] = vector;
+    }
+}
+async function prepareWrite(mode, model, input, options) {
+    const now = options?.now ?? new Date();
+    const payload = { ...input };
+    assertKnownFields(model, payload);
+    for (const [fieldName, field] of Object.entries(model.fields)) {
+        if (mode === "create") {
+            if (field.autoId && payload[fieldName] === undefined) {
+                payload[fieldName] = globalThis.crypto.randomUUID();
+            }
+            if (payload[fieldName] === undefined && field.default !== undefined) {
+                payload[fieldName] = field.default === "now" ? nowValue(field, now) : cloneDefaultValue(field.default);
+            }
+        }
+        if (field.updatedAt) {
+            payload[fieldName] = nowValue(field, now);
+        }
+    }
+    await applyEmbeddings(model, payload, options?.embeddings);
+    if (mode === "create") {
+        validateRequiredFields(model, payload);
+    }
+    for (const [fieldName, field] of Object.entries(model.fields)) {
+        validateFieldValue(model, fieldName, field, payload[fieldName]);
+    }
+    return payload;
+}
+export async function prepareCreateData(model, input, options) {
+    return prepareWrite("create", model, input, options);
+}
+export async function prepareUpdateData(model, input, options) {
+    return prepareWrite("update", model, input, options);
+}
+//# sourceMappingURL=write.js.map

package/dist/write.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zauso-ai/capstan-db",
-  "version": "0.1.4",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,11 +12,15 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist"
   },
   "peerDependencies": {
-    "drizzle-orm": "^0.44.0",
-    "better-sqlite3": "^11.0.0"
+    "drizzle-orm": ">=0.44.0",
+    "better-sqlite3": ">=9.0.0",
+    "@libsql/client": ">=0.15.0",
+    "pg": "^8.0.0",
+    "mysql2": "^3.0.0"
   },
   "peerDependenciesMeta": {
     "drizzle-orm": {
@@ -24,6 +28,15 @@
     },
     "better-sqlite3": {
       "optional": true
+    },
+    "@libsql/client": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
     }
   },
   "description": "Database layer for Capstan — Drizzle ORM, defineModel, auto CRUD generation",