@wild-framework/database-auto 0.2.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/dist/classify.d.ts

@@ -0,0 +1,11 @@
+/** Which concrete driver a `DATABASE_URL` maps to. */
+export type DatabaseScheme = "postgres" | "mysql" | "sqlite";
+/**
+ * Classify a connection URL by scheme.
+ *
+ *   postgres://… / postgresql://…  → "postgres"
+ *   mysql://…                      → "mysql"
+ *   anything else / undefined      → "sqlite"
+ */
+export declare function classifyDatabaseUrl(url: string | undefined): DatabaseScheme;
+//# sourceMappingURL=classify.d.ts.map

package/dist/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../src/classify.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAK3E"}

package/dist/classify.js

@@ -0,0 +1,17 @@
+/**
+ * Classify a connection URL by scheme.
+ *
+ *   postgres://… / postgresql://…  → "postgres"
+ *   mysql://…                      → "mysql"
+ *   anything else / undefined      → "sqlite"
+ */
+export function classifyDatabaseUrl(url) {
+    if (!url)
+        return "sqlite";
+    if (url.startsWith("postgres://") || url.startsWith("postgresql://"))
+        return "postgres";
+    if (url.startsWith("mysql://"))
+        return "mysql";
+    return "sqlite";
+}
+//# sourceMappingURL=classify.js.map

package/dist/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../src/classify.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAuB;IACvD,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,UAAU,CAAC;IACxF,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { DatabaseProvider } from "./provider.js";
+export { classifyDatabaseUrl } from "./classify.js";
+export type { DatabaseScheme } from "./classify.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,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { DatabaseProvider } from "./provider.js";
+export { classifyDatabaseUrl } from "./classify.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,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,41 @@
+import type { Provider, Application } from "@wild-framework/core";
+import { type Migration } from "@wild-framework/database";
+/**
+ * Unified, env-driven database provider.
+ *
+ * Selects a concrete driver from the `DATABASE_URL` scheme and binds a
+ * `Database` into the container. This is the "one provider to rule them all"
+ * — register it and set `DATABASE_URL` to swap backends without touching
+ * app code.
+ *
+ *   DATABASE_URL=postgres://…   → PostgresDriver
+ *   DATABASE_URL=mysql://…      → MysqlDriver
+ *   (unset)                     → DrizzleDriver (SQLite, `DB_FILE` or filename)
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * DatabaseProvider.schema = schema;              // dialect-appropriate tables
+ * DatabaseProvider.migrations = loadMigrations("./migrations");
+ * ```
+ *
+ * IMPORTANT: Drizzle schemas are dialect-specific (`sqliteTable` vs `pgTable`
+ * vs `mysqlTable`). Pass a schema written in the dialect you intend to run.
+ *
+ * The three explicit providers (`DrizzleProvider`, `PostgresProvider`,
+ * `MysqlProvider`) remain available when you want to be explicit.
+ */
+export declare class DatabaseProvider implements Provider {
+    /** Drizzle schema object (tables) for the target dialect. */
+    static schema: Record<string, unknown> | undefined;
+    /** Migrations to apply after connecting. */
+    static migrations: Migration[];
+    /** SQLite file path (used when DATABASE_URL is unset). Defaults to "shop.db". */
+    static filename: string;
+    /** Create tables from the schema at boot. Defaults to true. */
+    static autoCreate: boolean;
+    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;AAElE,OAAO,EAGH,KAAK,SAAS,EAEjB,MAAM,0BAA0B,CAAC;AAMlC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAC7C,6DAA6D;IAC7D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,4CAA4C;IAC5C,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,CAAM;IACpC,iFAAiF;IACjF,MAAM,CAAC,QAAQ,SAAa;IAC5B,+DAA+D;IAC/D,MAAM,CAAC,UAAU,UAAQ;IAEzB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IA4B1B,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAarC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAIlD"}

package/dist/provider.js

@@ -0,0 +1,81 @@
+import { Container } from "@wild-framework/container";
+import { Database, MigrationRunner, } from "@wild-framework/database";
+import { DrizzleDriver } from "@wild-framework/database-drizzle";
+import { PostgresDriver } from "@wild-framework/database-postgres";
+import { MysqlDriver } from "@wild-framework/database-mysql";
+import { classifyDatabaseUrl } from "./classify.js";
+/**
+ * Unified, env-driven database provider.
+ *
+ * Selects a concrete driver from the `DATABASE_URL` scheme and binds a
+ * `Database` into the container. This is the "one provider to rule them all"
+ * — register it and set `DATABASE_URL` to swap backends without touching
+ * app code.
+ *
+ *   DATABASE_URL=postgres://…   → PostgresDriver
+ *   DATABASE_URL=mysql://…      → MysqlDriver
+ *   (unset)                     → DrizzleDriver (SQLite, `DB_FILE` or filename)
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * DatabaseProvider.schema = schema;              // dialect-appropriate tables
+ * DatabaseProvider.migrations = loadMigrations("./migrations");
+ * ```
+ *
+ * IMPORTANT: Drizzle schemas are dialect-specific (`sqliteTable` vs `pgTable`
+ * vs `mysqlTable`). Pass a schema written in the dialect you intend to run.
+ *
+ * The three explicit providers (`DrizzleProvider`, `PostgresProvider`,
+ * `MysqlProvider`) remain available when you want to be explicit.
+ */
+export class DatabaseProvider {
+    /** Drizzle schema object (tables) for the target dialect. */
+    static schema;
+    /** Migrations to apply after connecting. */
+    static migrations = [];
+    /** SQLite file path (used when DATABASE_URL is unset). Defaults to "shop.db". */
+    static filename = "shop.db";
+    /** Create tables from the schema at boot. Defaults to true. */
+    static autoCreate = true;
+    register(app) {
+        const container = app.resolve(Container);
+        const url = process.env.DATABASE_URL;
+        const scheme = classifyDatabaseUrl(url);
+        const driver = scheme === "postgres"
+            ? new PostgresDriver({
+                connectionString: url,
+                schema: DatabaseProvider.schema,
+                autoCreate: DatabaseProvider.autoCreate,
+            })
+            : scheme === "mysql"
+                ? new MysqlDriver({
+                    uri: url,
+                    schema: DatabaseProvider.schema,
+                    autoCreate: DatabaseProvider.autoCreate,
+                })
+                : new DrizzleDriver({
+                    filename: process.env.DB_FILE ?? DatabaseProvider.filename,
+                    schema: DatabaseProvider.schema,
+                    autoCreate: DatabaseProvider.autoCreate,
+                });
+        const database = new Database(driver);
+        container.singleton(Database, () => database);
+    }
+    async boot(app) {
+        const database = app.resolve(Database);
+        await database.connect();
+        if (DatabaseProvider.migrations.length > 0) {
+            const driver = database.driver;
+            const applied = await new MigrationRunner(driver).migrate(DatabaseProvider.migrations);
+            if (applied.length > 0) {
+                console.log(`[database] applied ${applied.length} migration(s): ${applied.join(", ")}`);
+            }
+        }
+    }
+    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,EACH,QAAQ,EACR,eAAe,GAGlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,gBAAgB;IACzB,6DAA6D;IAC7D,MAAM,CAAC,MAAM,CAAsC;IACnD,4CAA4C;IAC5C,MAAM,CAAC,UAAU,GAAgB,EAAE,CAAC;IACpC,iFAAiF;IACjF,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC5B,+DAA+D;IAC/D,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IAEzB,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACrC,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAExC,MAAM,MAAM,GACR,MAAM,KAAK,UAAU;YACjB,CAAC,CAAC,IAAI,cAAc,CAAC;gBACf,gBAAgB,EAAE,GAAG;gBACrB,MAAM,EAAE,gBAAgB,CAAC,MAAM;gBAC/B,UAAU,EAAE,gBAAgB,CAAC,UAAU;aAC1C,CAAC;YACJ,CAAC,CAAC,MAAM,KAAK,OAAO;gBAClB,CAAC,CAAC,IAAI,WAAW,CAAC;oBACZ,GAAG,EAAE,GAAG;oBACR,MAAM,EAAE,gBAAgB,CAAC,MAAM;oBAC/B,UAAU,EAAE,gBAAgB,CAAC,UAAU;iBAC1C,CAAC;gBACJ,CAAC,CAAC,IAAI,aAAa,CAAC;oBACd,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,gBAAgB,CAAC,QAAQ;oBAC1D,MAAM,EAAE,gBAAgB,CAAC,MAAM;oBAC/B,UAAU,EAAE,gBAAgB,CAAC,UAAU;iBAC1C,CAAC,CAAC;QAEf,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,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;QAEzB,IAAI,gBAAgB,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAgC,CAAC;YACzD,MAAM,OAAO,GAAG,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YACvF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,CAAC,MAAM,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5F,CAAC;QACL,CAAC;IACL,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,52 @@
+{
+  "name": "@wild-framework/database-auto",
+  "version": "0.2.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": "Env-driven database provider — auto-selects SQLite, Postgres, or MySQL from DATABASE_URL.",
+  "keywords": [
+    "wild",
+    "framework",
+    "database",
+    "drizzle",
+    "sqlite",
+    "postgres",
+    "mysql",
+    "auto"
+  ],
+  "dependencies": {
+    "@wild-framework/container": "0.2.0",
+    "@wild-framework/database-postgres": "0.2.0",
+    "@wild-framework/database-mysql": "0.2.0",
+    "@wild-framework/database": "0.2.0",
+    "@wild-framework/database-drizzle": "0.2.0",
+    "@wild-framework/core": "0.2.0"
+  },
+  "devDependencies": {
+    "drizzle-orm": "^0.38.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}