@zauso-ai/capstan-db 0.1.4 → 0.3.0

package/dist/client.d.ts

@@ -1,29 +1,42 @@
+import type { DatabaseRuntime } from "./runtime.js";
 import type { DatabaseConfig } from "./types.js";
-export interface DatabaseInstance {
-    /** The Drizzle ORM database instance. */
-    db: unknown;
-    /** Close the underlying database connection. */
-    close: () => void;
+export interface DatabaseInstance extends DatabaseRuntime {
 }
 /**
- * Create a Drizzle database instance backed by better-sqlite3.
+ * Create a Drizzle database instance backed by better-sqlite3 (SQLite),
+ * node-postgres (PostgreSQL), or mysql2 (MySQL).
  *
- * Both `better-sqlite3` and `drizzle-orm` are optional peer dependencies. They
- * are loaded lazily so that `@zauso-ai/capstan-db` can be installed even when
- * native compilation of `better-sqlite3` fails. The actual database features
- * will not work until the peer dependencies are installed.
+ * All driver dependencies are optional peer dependencies and are loaded lazily
+ * so that `@zauso-ai/capstan-db` can be installed even when native compilation
+ * of `better-sqlite3` fails or `pg`/`mysql2` are not needed. The actual
+ * database features will not work until the appropriate peer dependencies are
+ * installed.
  *
- * @param config - Database configuration. Currently only `sqlite` provider is
- *   supported. The `url` field should be a file path (or `:memory:` for an
- *   in-memory database).
+ * @param config - Database configuration.
+ *   - `provider: "sqlite"` — `url` should be a file path (or `:memory:`).
+ *   - `provider: "postgres"` — `url` should be a PostgreSQL connection string
+ *     (e.g. `postgres://user:pass@host:5432/db`).
+ *   - `provider: "mysql"` — `url` should be a MySQL connection string
+ *     (e.g. `mysql://user:pass@host:3306/db`).
  *
- * @throws If `better-sqlite3` or `drizzle-orm` are not installed, throws an
- *   error with installation instructions.
+ * @throws If the required driver or `drizzle-orm` adapter is not installed,
+ *   throws an error with installation instructions.
  *
  * @example
+ *   // SQLite
  *   const { db, close } = createDatabase({ provider: "sqlite", url: "./data.db" });
- *   // ... use db ...
- *   close();
+ *
+ *   // PostgreSQL
+ *   const { db, close } = createDatabase({
+ *     provider: "postgres",
+ *     url: "postgres://user:pass@localhost:5432/mydb",
+ *   });
+ *
+ *   // MySQL
+ *   const { db, close } = createDatabase({
+ *     provider: "mysql",
+ *     url: "mysql://user:pass@localhost:3306/mydb",
+ *   });
  */
-export declare function createDatabase(config: DatabaseConfig): DatabaseInstance;
+export declare function createDatabase(config: DatabaseConfig): Promise<DatabaseInstance>;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,gDAAgD;IAChD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CA6CvE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAwC,MAAM,cAAc,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASjD,MAAM,WAAW,gBAAiB,SAAQ,eAAe;CAAG;AAM5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBtF"}

package/dist/client.js

@@ -1,33 +1,74 @@
-import { createRequire } from "node:module";
-const require = createRequire(import.meta.url);
+import { createDatabaseRuntime } from "./runtime.js";
+// Helper to dynamically import optional peer dependencies without TypeScript
+// trying to resolve them at compile time (they may not be installed).
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function importPeer(specifier) {
+    return import(specifier);
+}
+function normalizeParams(params) {
+    return params ?? [];
+}
 /**
- * Create a Drizzle database instance backed by better-sqlite3.
+ * Create a Drizzle database instance backed by better-sqlite3 (SQLite),
+ * node-postgres (PostgreSQL), or mysql2 (MySQL).
  *
- * Both `better-sqlite3` and `drizzle-orm` are optional peer dependencies. They
- * are loaded lazily so that `@zauso-ai/capstan-db` can be installed even when
- * native compilation of `better-sqlite3` fails. The actual database features
- * will not work until the peer dependencies are installed.
+ * All driver dependencies are optional peer dependencies and are loaded lazily
+ * so that `@zauso-ai/capstan-db` can be installed even when native compilation
+ * of `better-sqlite3` fails or `pg`/`mysql2` are not needed. The actual
+ * database features will not work until the appropriate peer dependencies are
+ * installed.
  *
- * @param config - Database configuration. Currently only `sqlite` provider is
- *   supported. The `url` field should be a file path (or `:memory:` for an
- *   in-memory database).
+ * @param config - Database configuration.
+ *   - `provider: "sqlite"` — `url` should be a file path (or `:memory:`).
+ *   - `provider: "postgres"` — `url` should be a PostgreSQL connection string
+ *     (e.g. `postgres://user:pass@host:5432/db`).
+ *   - `provider: "mysql"` — `url` should be a MySQL connection string
+ *     (e.g. `mysql://user:pass@host:3306/db`).
  *
- * @throws If `better-sqlite3` or `drizzle-orm` are not installed, throws an
- *   error with installation instructions.
+ * @throws If the required driver or `drizzle-orm` adapter is not installed,
+ *   throws an error with installation instructions.
  *
  * @example
+ *   // SQLite
  *   const { db, close } = createDatabase({ provider: "sqlite", url: "./data.db" });
- *   // ... use db ...
- *   close();
+ *
+ *   // PostgreSQL
+ *   const { db, close } = createDatabase({
+ *     provider: "postgres",
+ *     url: "postgres://user:pass@localhost:5432/mydb",
+ *   });
+ *
+ *   // MySQL
+ *   const { db, close } = createDatabase({
+ *     provider: "mysql",
+ *     url: "mysql://user:pass@localhost:3306/mydb",
+ *   });
  */
-export function createDatabase(config) {
-    if (config.provider !== "sqlite") {
-        throw new Error(`@zauso-ai/capstan-db: Unsupported database provider "${config.provider}". Only "sqlite" is currently supported.`);
+export async function createDatabase(config) {
+    switch (config.provider) {
+        case "sqlite":
+            return createSqliteDatabase(config.url);
+        case "postgres":
+            return createPostgresDatabase(config.url);
+        case "mysql":
+            return createMysqlDatabase(config.url);
+        case "libsql":
+            return createLibsqlDatabase(config.url);
+        default: {
+            const _exhaustive = config.provider;
+            throw new Error(`@zauso-ai/capstan-db: Unsupported database provider "${String(_exhaustive)}".`);
+        }
     }
+}
+// ---------------------------------------------------------------------------
+// SQLite (better-sqlite3)
+// ---------------------------------------------------------------------------
+async function createSqliteDatabase(url) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     let BetterSqlite3;
     try {
-        BetterSqlite3 = require("better-sqlite3");
+        const mod = await importPeer("better-sqlite3");
+        BetterSqlite3 = mod.default ?? mod;
     }
     catch {
         throw new Error(`@zauso-ai/capstan-db: "better-sqlite3" is required for SQLite support but is not installed.\n` +
@@ -38,22 +79,257 @@ export function createDatabase(config) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     let drizzle;
     try {
-        const drizzleModule = require("drizzle-orm/better-sqlite3");
+        const drizzleModule = await importPeer("drizzle-orm/better-sqlite3");
         drizzle = drizzleModule.drizzle;
     }
     catch {
         throw new Error(`@zauso-ai/capstan-db: "drizzle-orm" is required for database support but is not installed.\n` +
             `Install it with: npm install drizzle-orm`);
     }
-    const sqlite = new BetterSqlite3(config.url);
+    const sqlite = new BetterSqlite3(url);
     // Enable WAL mode for better concurrent read performance.
     sqlite.pragma("journal_mode = WAL");
     const db = drizzle({ client: sqlite });
-    return {
-        db,
-        close() {
-            sqlite.close();
+    const adapter = {
+        provider: "sqlite",
+        async query(sql, params) {
+            const statement = sqlite.prepare(sql);
+            return statement.all(...normalizeParams(params));
+        },
+        async execute(sql, params) {
+            const statement = sqlite.prepare(sql);
+            const normalized = sql.trim().toUpperCase();
+            if (normalized.startsWith("SELECT") || normalized.includes(" RETURNING ")) {
+                const rows = statement.all(...normalizeParams(params));
+                return { affectedRows: rows.length, rows };
+            }
+            const result = statement.run(...normalizeParams(params));
+            return { affectedRows: Number(result.changes ?? 0) };
+        },
+        async transaction(fn) {
+            sqlite.exec("BEGIN");
+            try {
+                const result = await fn(adapter);
+                sqlite.exec("COMMIT");
+                return result;
+            }
+            catch (error) {
+                sqlite.exec("ROLLBACK");
+                throw error;
+            }
+        },
+    };
+    return createDatabaseRuntime(db, "sqlite", () => sqlite.close(), adapter);
+}
+// ---------------------------------------------------------------------------
+// PostgreSQL (node-postgres / pg)
+// ---------------------------------------------------------------------------
+async function createPostgresDatabase(url) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let Pool;
+    try {
+        const pgModule = await importPeer("pg");
+        Pool = pgModule.Pool ?? pgModule.default?.Pool;
+    }
+    catch {
+        throw new Error(`@zauso-ai/capstan-db: "pg" (node-postgres) is required for PostgreSQL support but is not installed.\n` +
+            `Install it with: npm install pg`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let drizzle;
+    try {
+        const drizzleModule = await importPeer("drizzle-orm/node-postgres");
+        drizzle = drizzleModule.drizzle;
+    }
+    catch {
+        throw new Error(`@zauso-ai/capstan-db: "drizzle-orm/node-postgres" adapter is required for PostgreSQL support but is not installed.\n` +
+            `Install it with: npm install drizzle-orm`);
+    }
+    const pool = new Pool({ connectionString: url });
+    const db = drizzle({ client: pool });
+    const rootAdapter = {
+        provider: "postgres",
+        async query(sql, params) {
+            const result = await pool.query(sql, normalizeParams(params));
+            return result.rows;
+        },
+        async execute(sql, params) {
+            const result = await pool.query(sql, normalizeParams(params));
+            return {
+                affectedRows: result.rowCount ?? result.rows.length,
+                rows: result.rows,
+            };
+        },
+        async transaction(fn) {
+            const client = await pool.connect();
+            const adapter = {
+                provider: "postgres",
+                async query(statement, params) {
+                    const result = await client.query(statement, normalizeParams(params));
+                    return result.rows;
+                },
+                async execute(statement, params) {
+                    const result = await client.query(statement, normalizeParams(params));
+                    return {
+                        affectedRows: result.rowCount ?? result.rows.length,
+                        rows: result.rows,
+                    };
+                },
+                async transaction(innerFn) {
+                    return innerFn(adapter);
+                },
+            };
+            await client.query("BEGIN");
+            try {
+                const result = await fn(adapter);
+                await client.query("COMMIT");
+                return result;
+            }
+            catch (error) {
+                await client.query("ROLLBACK");
+                throw error;
+            }
+            finally {
+                client.release();
+            }
+        },
+    };
+    return createDatabaseRuntime(db, "postgres", () => pool.end(), rootAdapter);
+}
+// ---------------------------------------------------------------------------
+// MySQL (mysql2)
+// ---------------------------------------------------------------------------
+async function createMysqlDatabase(url) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let createPool;
+    try {
+        const mysql2 = await importPeer("mysql2/promise");
+        createPool = mysql2.createPool ?? mysql2.default?.createPool;
+    }
+    catch {
+        throw new Error(`@zauso-ai/capstan-db: "mysql2" is required for MySQL support but is not installed.\n` +
+            `Install it with: npm install mysql2`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let drizzle;
+    try {
+        const drizzleModule = await importPeer("drizzle-orm/mysql2");
+        drizzle = drizzleModule.drizzle;
+    }
+    catch {
+        throw new Error(`@zauso-ai/capstan-db: "drizzle-orm/mysql2" adapter is required for MySQL support but is not installed.\n` +
+            `Install it with: npm install drizzle-orm`);
+    }
+    const pool = createPool({ uri: url });
+    const db = drizzle({ client: pool });
+    function normalizeMysqlRows(result) {
+        return Array.isArray(result) ? result : [];
+    }
+    const rootAdapter = {
+        provider: "mysql",
+        async query(sql, params) {
+            const [rows] = await pool.query(sql, normalizeParams(params));
+            return normalizeMysqlRows(rows);
+        },
+        async execute(sql, params) {
+            const [result] = await pool.query(sql, normalizeParams(params));
+            if (Array.isArray(result)) {
+                return { affectedRows: result.length, rows: result };
+            }
+            const payload = result;
+            return { affectedRows: payload.affectedRows ?? 0 };
+        },
+        async transaction(fn) {
+            const connection = await pool.getConnection();
+            const adapter = {
+                provider: "mysql",
+                async query(statement, params) {
+                    const [rows] = await connection.query(statement, normalizeParams(params));
+                    return normalizeMysqlRows(rows);
+                },
+                async execute(statement, params) {
+                    const [result] = await connection.query(statement, normalizeParams(params));
+                    if (Array.isArray(result)) {
+                        return { affectedRows: result.length, rows: result };
+                    }
+                    const payload = result;
+                    return { affectedRows: payload.affectedRows ?? 0 };
+                },
+                async transaction(innerFn) {
+                    return innerFn(adapter);
+                },
+            };
+            await connection.beginTransaction();
+            try {
+                const result = await fn(adapter);
+                await connection.commit();
+                return result;
+            }
+            catch (error) {
+                await connection.rollback();
+                throw error;
+            }
+            finally {
+                connection.release();
+            }
+        },
+    };
+    return createDatabaseRuntime(db, "mysql", () => {
+        void pool.end();
+    }, rootAdapter);
+}
+// ---------------------------------------------------------------------------
+// libSQL / Turso (@libsql/client)
+// ---------------------------------------------------------------------------
+async function createLibsqlDatabase(url) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let createClient;
+    try {
+        const libsqlModule = await importPeer("@libsql/client");
+        createClient = libsqlModule.createClient ?? libsqlModule.default?.createClient;
+    }
+    catch {
+        throw new Error(`@zauso-ai/capstan-db: "@libsql/client" is required for libSQL/Turso support but is not installed.\n` +
+            `Install it with: npm install @libsql/client`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let drizzle;
+    try {
+        const drizzleModule = await importPeer("drizzle-orm/libsql");
+        drizzle = drizzleModule.drizzle;
+    }
+    catch {
+        throw new Error(`@zauso-ai/capstan-db: "drizzle-orm/libsql" adapter is required for libSQL/Turso support but is not installed.\n` +
+            `Install it with: npm install drizzle-orm`);
+    }
+    const client = createClient({ url });
+    const db = drizzle({ client });
+    const adapter = {
+        provider: "libsql",
+        async query(sql, params) {
+            const result = await client.execute({ sql, args: normalizeParams(params) });
+            return result.rows;
+        },
+        async execute(sql, params) {
+            const result = await client.execute({ sql, args: normalizeParams(params) });
+            return {
+                affectedRows: Number(result.rowsAffected ?? result.rows.length ?? 0),
+                rows: result.rows,
+            };
+        },
+        async transaction(fn) {
+            await client.execute("BEGIN");
+            try {
+                const result = await fn(adapter);
+                await client.execute("COMMIT");
+                return result;
+            }
+            catch (error) {
+                await client.execute("ROLLBACK");
+                throw error;
+            }
         },
     };
+    return createDatabaseRuntime(db, "libsql", () => client.close(), adapter);
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAS/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,wDAAwD,MAAM,CAAC,QAAQ,0CAA0C,CAClH,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,IAAI,aAAkB,CAAC;IACvB,IAAI,CAAC;QACH,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,+FAA+F;YAC/F,+CAA+C;YAC/C,6DAA6D;YAC7D,qDAAqD,CACtD,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,IAAI,OAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;QAC5D,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,8FAA8F;YAC9F,0CAA0C,CAC3C,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAE7C,0DAA0D;IAC1D,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEpC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEvC,OAAO;QACL,EAAE;QACF,KAAK;YACH,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/crud.d.ts

@@ -1,9 +1,21 @@
+import type { DatabaseRuntime, FindManyOptions, ModelRepository } from "./runtime.js";
+import type { PrepareWriteOptions } from "./write.js";
 import type { ModelDefinition } from "./types.js";
 export interface CrudRouteFiles {
     /** File path relative to app/routes/, e.g. "tickets/index.api.ts" */
     path: string;
     content: string;
 }
+export interface CrudQueryOptions extends FindManyOptions {
+}
+export interface CrudRuntime<M extends ModelDefinition = ModelDefinition> {
+    repository: ModelRepository<M>;
+    list: (options?: CrudQueryOptions) => Promise<Array<Record<string, unknown>>>;
+    get: (id: unknown, options?: Omit<CrudQueryOptions, "where" | "limit" | "offset">) => Promise<Record<string, unknown> | null>;
+    create: (input: Record<string, unknown>, options?: PrepareWriteOptions) => Promise<Record<string, unknown>>;
+    update: (id: unknown, input: Record<string, unknown>, options?: PrepareWriteOptions) => Promise<Record<string, unknown> | null>;
+    remove: (id: unknown) => Promise<boolean>;
+}
 /**
  * Naive English pluraliser — sufficient for model-name pluralisation.
  *
@@ -24,4 +36,6 @@ export declare function pluralize(word: string): string;
  *  2. `<plural>/[id].api.ts`   — GET (by id) + PUT (update) + DELETE
  */
 export declare function generateCrudRoutes(model: ModelDefinition): CrudRouteFiles[];
+export declare function createCrudRepository<M extends ModelDefinition>(database: DatabaseRuntime, model: M | string): ModelRepository<M>;
+export declare function createCrudRuntime<M extends ModelDefinition>(database: DatabaseRuntime, model: M | string): CrudRuntime<M>;
 //# sourceMappingURL=crud.d.ts.map

package/dist/crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../src/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AAMnE,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0B9C;AAiHD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,EAAE,CAsG3E"}
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../src/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AAOnE,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;CAAG;AAE5D,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe;IACtE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9E,GAAG,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9H,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5G,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAChI,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAMD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAsHD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,EAAE,CAgH3E;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAC5D,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,CAAC,GAAG,MAAM,GAChB,eAAe,CAAC,CAAC,CAAC,CAEpB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,eAAe,EACzD,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,CAAC,GAAG,MAAM,GAChB,WAAW,CAAC,CAAC,CAAC,CAUhB"}

package/dist/crud.js

@@ -1,3 +1,4 @@
+import { autoFieldNames, findPrimaryKeyField, pluralizeModelName } from "./naming.js";
 // ---------------------------------------------------------------------------
 // Pluralisation helper
 // ---------------------------------------------------------------------------
@@ -10,24 +11,7 @@
  *   bus     -> buses
  */
 export function pluralize(word) {
-    if (word.length === 0)
-        return word;
-    const lower = word.toLowerCase();
-    // Words ending in consonant + y → ies
-    if (lower.endsWith("y") &&
-        lower.length > 1 &&
-        !"aeiou".includes(lower[lower.length - 2])) {
-        return word.slice(0, -1) + "ies";
-    }
-    // Words ending in s, sh, ch, x, z → es
-    if (lower.endsWith("s") ||
-        lower.endsWith("sh") ||
-        lower.endsWith("ch") ||
-        lower.endsWith("x") ||
-        lower.endsWith("z")) {
-        return word + "es";
-    }
-    return word + "s";
+    return pluralizeModelName(word);
 }
 // ---------------------------------------------------------------------------
 // Field → Zod mapping
@@ -62,6 +46,11 @@ function fieldToZod(field) {
             case "json":
                 base = "z.unknown()";
                 break;
+            case "vector":
+                base = field.dimensions !== undefined
+                    ? `z.array(z.number()).length(${field.dimensions})`
+                    : "z.array(z.number())";
+                break;
             default:
                 base = "z.unknown()";
         }
@@ -134,25 +123,25 @@ function buildZodObject(fields, options) {
  *  2. `<plural>/[id].api.ts`   — GET (by id) + PUT (update) + DELETE
  */
 export function generateCrudRoutes(model) {
-    const plural = pluralize(model.name.toLowerCase());
+    const plural = pluralize(model.name);
     const resourceName = model.name;
-    // Determine which fields are auto-generated (id, updatedAt).
-    const autoFields = new Set();
-    for (const [name, field] of Object.entries(model.fields)) {
-        if (field.autoId)
-            autoFields.add(name);
-        if (field.updatedAt)
-            autoFields.add(name);
-    }
+    const serializedModel = JSON.stringify(model, null, 2);
+    const primaryKeyField = findPrimaryKeyField(model) ?? "id";
+    const autoFields = autoFieldNames(model);
     // ----- index.api.ts (list + create) -----
     const createSchema = buildZodObject(model.fields, { exclude: autoFields });
+    const tableName = plural;
     const indexContent = `// Auto-generated CRUD routes for ${resourceName}
 // This file was generated by @zauso-ai/capstan-db generateCrudRoutes().
 
 import { defineAPI } from "@zauso-ai/capstan-core";
+import { prepareCreateData } from "@zauso-ai/capstan-db";
 import { z } from "zod";
+import { db } from "../../db.js";
+import { ${tableName} } from "../../db/schema.js";
 
 export const meta = { resource: "${resourceName}" };
+const model = ${serializedModel};
 
 const CreateInput = ${createSchema};
 
@@ -161,8 +150,8 @@ export const GET = defineAPI({
   resource: "${resourceName}",
   description: "List all ${plural}",
   handler: async ({ ctx }) => {
-    // TODO: replace with actual database query
-    return { data: [], total: 0 };
+    const items = await db.select().from(${tableName});
+    return { data: items, total: items.length };
   },
 });
 
@@ -173,8 +162,9 @@ export const POST = defineAPI({
   policy: "requireAuth",
   input: CreateInput,
   handler: async ({ input, ctx }) => {
-    // TODO: replace with actual database insert
-    return { data: { id: "TODO", ...input }, created: true };
+    const values = await prepareCreateData(model, input) as typeof ${tableName}.$inferInsert;
+    const result = await db.insert(${tableName}).values(values).returning();
+    return { data: result[0], created: true };
   },
 });
 `;
@@ -187,9 +177,14 @@ export const POST = defineAPI({
 // This file was generated by @zauso-ai/capstan-db generateCrudRoutes().
 
 import { defineAPI } from "@zauso-ai/capstan-core";
+import { prepareUpdateData } from "@zauso-ai/capstan-db";
 import { z } from "zod";
+import { eq } from "drizzle-orm";
+import { db } from "../../db.js";
+import { ${tableName} } from "../../db/schema.js";
 
 export const meta = { resource: "${resourceName}" };
+const model = ${serializedModel};
 
 const UpdateInput = ${updateSchema};
 
@@ -197,9 +192,9 @@ export const GET = defineAPI({
   capability: "read",
   resource: "${resourceName}",
   description: "Get a ${resourceName} by id",
-  handler: async ({ input, ctx }) => {
-    // TODO: replace with actual database lookup
-    return { data: null };
+  handler: async ({ input, ctx, params }) => {
+    const items = await db.select().from(${tableName}).where(eq(${tableName}.${primaryKeyField}, params.id));
+    return { data: items[0] ?? null };
   },
 });
 
@@ -209,9 +204,10 @@ export const PUT = defineAPI({
   description: "Update a ${resourceName}",
   policy: "requireAuth",
   input: UpdateInput,
-  handler: async ({ input, ctx }) => {
-    // TODO: replace with actual database update
-    return { data: { id: "TODO", ...input }, updated: true };
+  handler: async ({ input, ctx, params }) => {
+    const values = await prepareUpdateData(model, input) as Partial<typeof ${tableName}.$inferInsert>;
+    const result = await db.update(${tableName}).set(values).where(eq(${tableName}.${primaryKeyField}, params.id)).returning();
+    return { data: result[0], updated: true };
   },
 });
 
@@ -220,8 +216,8 @@ export const DELETE = defineAPI({
   resource: "${resourceName}",
   description: "Delete a ${resourceName}",
   policy: "requireAuth",
-  handler: async ({ ctx }) => {
-    // TODO: replace with actual database delete
+  handler: async ({ ctx, params }) => {
+    await db.delete(${tableName}).where(eq(${tableName}.${primaryKeyField}, params.id));
     return { deleted: true };
   },
 });
@@ -231,4 +227,18 @@ export const DELETE = defineAPI({
         { path: `${plural}/[id].api.ts`, content: idContent },
     ];
 }
+export function createCrudRepository(database, model) {
+    return database.model(model);
+}
+export function createCrudRuntime(database, model) {
+    const repository = createCrudRepository(database, model);
+    return {
+        repository,
+        list: (options) => repository.findMany(options),
+        get: (id, options) => repository.findById(id, options),
+        create: (input, options) => repository.create(input, options),
+        update: (id, input, options) => repository.update(id, input, options),
+        remove: (id) => repository.delete(id),
+    };
+}
 //# sourceMappingURL=crud.js.map