@zauso-ai/capstan-db 0.1.2 → 0.1.4

package/dist/client.d.ts

@@ -1,18 +1,25 @@
-import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
 import type { DatabaseConfig } from "./types.js";
 export interface DatabaseInstance {
     /** The Drizzle ORM database instance. */
-    db: BetterSQLite3Database;
+    db: unknown;
     /** Close the underlying database connection. */
     close: () => void;
 }
 /**
  * Create a Drizzle database instance backed by better-sqlite3.
  *
+ * 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.
+ *
  * @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).
  *
+ * @throws If `better-sqlite3` or `drizzle-orm` are not installed, throws an
+ *   error with installation instructions.
+ *
  * @example
  *   const { db, close } = createDatabase({ provider: "sqlite", url: "./data.db" });
  *   // ... use db ...

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,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,EAAE,EAAE,qBAAqB,CAAC;IAC1B,gDAAgD;IAChD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAoBvE"}
+{"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"}

package/dist/client.js

@@ -1,12 +1,20 @@
-import { drizzle } from "drizzle-orm/better-sqlite3";
-import Database from "better-sqlite3";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
 /**
  * Create a Drizzle database instance backed by better-sqlite3.
  *
+ * 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.
+ *
  * @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).
  *
+ * @throws If `better-sqlite3` or `drizzle-orm` are not installed, throws an
+ *   error with installation instructions.
+ *
  * @example
  *   const { db, close } = createDatabase({ provider: "sqlite", url: "./data.db" });
  *   // ... use db ...
@@ -16,7 +24,28 @@ 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.`);
     }
-    const sqlite = new Database(config.url);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let BetterSqlite3;
+    try {
+        BetterSqlite3 = require("better-sqlite3");
+    }
+    catch {
+        throw new Error(`@zauso-ai/capstan-db: "better-sqlite3" is required for SQLite support but is not installed.\n` +
+            `Install it with: npm install better-sqlite3\n` +
+            `Note: this package requires native compilation (node-gyp). ` +
+            `Make sure you have a C++ build toolchain installed.`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let drizzle;
+    try {
+        const drizzleModule = require("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);
     // Enable WAL mode for better concurrent read performance.
     sqlite.pragma("journal_mode = WAL");
     const db = drizzle({ client: sqlite });

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAUtC;;;;;;;;;;;GAWG;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,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAExC,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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zauso-ai/capstan-db",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,10 +14,18 @@
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
-  "dependencies": {
+  "peerDependencies": {
     "drizzle-orm": "^0.44.0",
     "better-sqlite3": "^11.0.0"
   },
+  "peerDependenciesMeta": {
+    "drizzle-orm": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
   "description": "Database layer for Capstan — Drizzle ORM, defineModel, auto CRUD generation",
   "files": [
     "dist"