@zauso-ai/capstan-db 1.0.0-beta.7 → 1.0.0-beta.8

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": "1.0.0-beta.7",
+  "version": "1.0.0-beta.8",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,6 +18,7 @@
   "peerDependencies": {
     "drizzle-orm": ">=0.44.0",
     "better-sqlite3": ">=9.0.0",
+    "@libsql/client": ">=0.15.0",
     "pg": "^8.0.0",
     "mysql2": "^3.0.0"
   },
@@ -28,6 +29,9 @@
     "better-sqlite3": {
       "optional": true
     },
+    "@libsql/client": {
+      "optional": true
+    },
     "pg": {
       "optional": true
     },