@wild-framework/database-drizzle 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wild Framework contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# @wild-framework/database-drizzle
+
+Drizzle ORM adapter for [Wild Framework](https://github.com/your-org/wild-framework)'s database package.
+
+## Install
+
+```bash
+pnpm add @wild-framework/database-drizzle
+```
+
+## Usage
+
+```ts
+import { Database } from "@wild-framework/database";
+import { DrizzleProvider, DrizzleDriver } from "@wild-framework/database-drizzle";
+
+DrizzleProvider.schema = { users };
+DrizzleProvider.filename = "app.db";
+
+app.register(ContainerProvider);
+app.register(DrizzleProvider);
+await app.boot();
+
+const db = app.resolve(Database);
+const rows = (db.driver as DrizzleDriver).db.select().from(users).all();
+```
+
+## License
+
+MIT

package/dist/drizzle-driver.d.ts

@@ -0,0 +1,33 @@
+import type { DatabaseDriver } from "@wild-framework/database";
+import { type BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
+/**
+ * Configuration for the Drizzle driver.
+ */
+export interface DrizzleConfig<TSchema extends Record<string, unknown>> {
+    /** SQLite file path or `:memory:`. */
+    filename: string;
+    /** Optional Drizzle schema object (tables). */
+    schema?: TSchema;
+}
+/**
+ * Drizzle ORM driver implementing `DatabaseDriver` from `@wild-framework/database`.
+ *
+ * Backed by better-sqlite3. The `db` getter returns the typed Drizzle
+ * instance for full ORM queries.
+ */
+export declare class DrizzleDriver<TSchema extends Record<string, unknown>> implements DatabaseDriver {
+    private config;
+    private sqlite;
+    private drizzleDb;
+    constructor(config: DrizzleConfig<TSchema>);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    isConnected(): boolean;
+    /**
+     * The typed Drizzle instance for queries.
+     *
+     * Throws if the driver is not connected.
+     */
+    get db(): BetterSQLite3Database<TSchema>;
+}
+//# sourceMappingURL=drizzle-driver.d.ts.map

package/dist/drizzle-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-driver.d.ts","sourceRoot":"","sources":["../src/drizzle-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAW,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGjF;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClE,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,YAAW,cAAc;IAI7E,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAA+C;gBAE5C,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC;IAE5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,IAAI,EAAE,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAKvC;CACJ"}

package/dist/drizzle-driver.js

@@ -0,0 +1,40 @@
+import { drizzle } from "drizzle-orm/better-sqlite3";
+import Database from "better-sqlite3";
+/**
+ * Drizzle ORM driver implementing `DatabaseDriver` from `@wild-framework/database`.
+ *
+ * Backed by better-sqlite3. The `db` getter returns the typed Drizzle
+ * instance for full ORM queries.
+ */
+export class DrizzleDriver {
+    config;
+    sqlite = null;
+    drizzleDb = null;
+    constructor(config) {
+        this.config = config;
+    }
+    async connect() {
+        this.sqlite = new Database(this.config.filename);
+        this.drizzleDb = drizzle(this.sqlite, { schema: this.config.schema });
+    }
+    async close() {
+        this.sqlite?.close();
+        this.sqlite = null;
+        this.drizzleDb = null;
+    }
+    isConnected() {
+        return this.drizzleDb !== null;
+    }
+    /**
+     * The typed Drizzle instance for queries.
+     *
+     * Throws if the driver is not connected.
+     */
+    get db() {
+        if (!this.drizzleDb) {
+            throw new Error("Database is not connected. Call connect() first.");
+        }
+        return this.drizzleDb;
+    }
+}
+//# sourceMappingURL=drizzle-driver.js.map

package/dist/drizzle-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-driver.js","sourceRoot":"","sources":["../src/drizzle-driver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAA8B,MAAM,4BAA4B,CAAC;AACjF,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAYtC;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAIF;IAHZ,MAAM,GAA6B,IAAI,CAAC;IACxC,SAAS,GAA0C,IAAI,CAAC;IAEhE,YAAoB,MAA8B;QAA9B,WAAM,GAAN,MAAM,CAAwB;IAAG,CAAC;IAEtD,KAAK,CAAC,OAAO;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,WAAW;QACP,OAAO,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,IAAI,EAAE;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { DrizzleDriver } from "./drizzle-driver.js";
+export type { DrizzleConfig } from "./drizzle-driver.js";
+export { DrizzleProvider } from "./provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { DrizzleDriver } from "./drizzle-driver.js";
+export { DrizzleProvider } from "./provider.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,23 @@
+import type { Provider, Application } from "@wild-framework/core";
+/**
+ * Registers a Drizzle-backed database with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * DrizzleProvider.schema = { users };
+ * DrizzleProvider.filename = "app.db";
+ * ```
+ *
+ * Connects on boot, closes on shutdown.
+ */
+export declare class DrizzleProvider implements Provider {
+    /** Drizzle schema object (tables). */
+    static schema: Record<string, unknown> | undefined;
+    /** SQLite file path. Defaults to in-memory. */
+    static filename: string;
+    register(app: Application): void;
+    boot(app: Application): Promise<void>;
+    shutdown(app: Application): Promise<void>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKlE;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC5C,sCAAsC;IACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,SAAc;IAE7B,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAc1B,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAIlD"}

package/dist/provider.js

@@ -0,0 +1,40 @@
+import { Container } from "@wild-framework/container";
+import { Database } from "@wild-framework/database";
+import { DrizzleDriver } from "./drizzle-driver.js";
+/**
+ * Registers a Drizzle-backed database with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * DrizzleProvider.schema = { users };
+ * DrizzleProvider.filename = "app.db";
+ * ```
+ *
+ * Connects on boot, closes on shutdown.
+ */
+export class DrizzleProvider {
+    /** Drizzle schema object (tables). */
+    static schema;
+    /** SQLite file path. Defaults to in-memory. */
+    static filename = ":memory:";
+    register(app) {
+        const container = app.resolve(Container);
+        const config = {
+            filename: DrizzleProvider.filename,
+            schema: DrizzleProvider.schema,
+        };
+        const driver = new DrizzleDriver(config);
+        const database = new Database(driver);
+        container.singleton(Database, () => database);
+    }
+    async boot(app) {
+        const database = app.resolve(Database);
+        await database.connect();
+    }
+    async shutdown(app) {
+        const database = app.resolve(Database);
+        await database.close();
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAe;IACxB,sCAAsC;IACtC,MAAM,CAAC,MAAM,CAAsC;IACnD,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC;IAE7B,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,MAAM,MAAM,GAA2C;YACnD,QAAQ,EAAE,eAAe,CAAC,QAAQ;YAClC,MAAM,EAAE,eAAe,CAAC,MAAM;SACjC,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEtC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAgB;QACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAW,QAAQ,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAgB;QAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAW,QAAQ,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@wild-framework/database-drizzle",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Sphah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KhandaSoftware/wild-framework.git"
+  },
+  "description": "Drizzle ORM adapter for Wild Framework's database package.",
+  "keywords": [
+    "wild",
+    "framework",
+    "drizzle",
+    "orm",
+    "sqlite"
+  ],
+  "dependencies": {
+    "drizzle-orm": "^0.38.0",
+    "better-sqlite3": "^11.0.0",
+    "@wild-framework/container": "0.1.0",
+    "@wild-framework/database": "0.1.0",
+    "@wild-framework/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}