@wild-framework/database-postgres 0.0.0-stage → 0.2.2

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/ddl.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate `CREATE TABLE IF NOT EXISTS` statements from a Drizzle schema
+ * object for PostgreSQL.
+ *
+ * Auto-incrementing ids use Drizzle's `serial`/`bigserial` types — their
+ * `getSQLType()` already returns `serial`/`bigserial`, so no extra keyword
+ * is needed. Covers scalar types, NOT NULL, PRIMARY KEY, UNIQUE, and literal
+ * DEFAULTs.
+ */
+export declare function generatePostgresDdl(schema: Record<string, unknown>): string[];
+//# sourceMappingURL=ddl.d.ts.map

package/dist/ddl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.d.ts","sourceRoot":"","sources":["../src/ddl.ts"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAwB7E"}

package/dist/ddl.js

@@ -0,0 +1,61 @@
+import { getTableConfig } from "drizzle-orm/pg-core";
+/**
+ * Generate `CREATE TABLE IF NOT EXISTS` statements from a Drizzle schema
+ * object for PostgreSQL.
+ *
+ * Auto-incrementing ids use Drizzle's `serial`/`bigserial` types — their
+ * `getSQLType()` already returns `serial`/`bigserial`, so no extra keyword
+ * is needed. Covers scalar types, NOT NULL, PRIMARY KEY, UNIQUE, and literal
+ * DEFAULTs.
+ */
+export function generatePostgresDdl(schema) {
+    const statements = [];
+    for (const table of Object.values(schema)) {
+        if (!table || typeof table !== "object")
+            continue;
+        let config;
+        try {
+            config = getTableConfig(table);
+        }
+        catch {
+            continue; // not a table (view, relation, …)
+        }
+        const columns = config.columns;
+        if (columns.length === 0)
+            continue;
+        const lines = columns.map((column) => `  ${columnSql(column)}`);
+        statements.push(`CREATE TABLE IF NOT EXISTS "${config.name}" (\n${lines.join(",\n")}\n);`);
+    }
+    return statements;
+}
+/** Render a single column definition for PostgreSQL. */
+function columnSql(column) {
+    const parts = [`"${column.name}"`, column.getSQLType?.() ?? "text"];
+    if (column.primary)
+        parts.push("PRIMARY KEY");
+    if (column.notNull)
+        parts.push("NOT NULL");
+    if (column.isUnique)
+        parts.push("UNIQUE");
+    const def = literalDefault(column);
+    if (def !== undefined)
+        parts.push(`DEFAULT ${def}`);
+    return parts.join(" ");
+}
+/** Render a literal default; function/SQL-expression defaults are left out. */
+function literalDefault(column) {
+    if (!column.hasDefault)
+        return undefined;
+    const value = column.default;
+    if (value === null)
+        return "NULL";
+    if (typeof value === "number")
+        return String(value);
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    if (typeof value === "string")
+        return `'${value.replace(/'/g, "''")}'`;
+    // Non-literal (SQL expression, function, …) — leave to migrations.
+    return undefined;
+}
+//# sourceMappingURL=ddl.js.map

package/dist/ddl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.js","sourceRoot":"","sources":["../src/ddl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAiBrD;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IAC/D,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAElD,IAAI,MAA+C,CAAC;QACpD,IAAI,CAAC;YACD,MAAM,GAAG,cAAc,CAAC,KAA6C,CAGpE,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACL,SAAS,CAAC,kCAAkC;QAChD,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEnC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChE,UAAU,CAAC,IAAI,CAAC,+BAA+B,MAAM,CAAC,IAAI,QAAQ,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,wDAAwD;AACxD,SAAS,SAAS,CAAC,MAAkB;IACjC,MAAM,KAAK,GAAa,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,MAAM,CAAC,CAAC;IAE9E,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;IAEpD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,+EAA+E;AAC/E,SAAS,cAAc,CAAC,MAAkB;IACtC,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;IAC7B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IAEvE,mEAAmE;IACnE,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/driver.d.ts

@@ -0,0 +1,49 @@
+import type { DatabaseDriver, SqlExecutor, Row } from "@wild-framework/database";
+import { type NodePgDatabase } from "drizzle-orm/node-postgres";
+import pg from "pg";
+/**
+ * Configuration for the PostgreSQL driver.
+ */
+export interface PostgresConfig<TSchema extends Record<string, unknown>> {
+    /** PostgreSQL connection string (e.g. `postgres://user:pass@host:5432/db`). */
+    connectionString?: string;
+    /** A pre-built pool — for advanced use or tests. */
+    pool?: pg.Pool;
+    /** Optional Drizzle schema object (tables). */
+    schema?: TSchema;
+    /**
+     * Create tables from the schema at connect time (dev-friendly).
+     * Set false to rely on migrations.
+     * Defaults to true.
+     */
+    autoCreate?: boolean;
+}
+/**
+ * PostgreSQL driver implementing `DatabaseDriver` and `SqlExecutor`.
+ *
+ * Backed by `pg` + Drizzle (`drizzle-orm/node-postgres`). The `db` getter
+ * returns the typed Drizzle instance for ORM queries; `exec`/`all` expose
+ * raw SQL for migrations.
+ */
+export declare class PostgresDriver<TSchema extends Record<string, unknown>> implements DatabaseDriver, SqlExecutor {
+    private config;
+    private pool;
+    private drizzleDb;
+    private connected;
+    constructor(config: PostgresConfig<TSchema>);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    isConnected(): boolean;
+    /** Run one or more `;`-separated SQL statements. */
+    exec(sql: string): Promise<void>;
+    /** Run a query and return its rows. */
+    all<T = Row>(sql: string): Promise<T[]>;
+    private requirePool;
+    /**
+     * The typed Drizzle instance for queries.
+     *
+     * Throws if the driver is not connected.
+     */
+    get db(): NodePgDatabase<TSchema>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC;IACf,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,cAAc,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC/D,YAAW,cAAc,EAAE,WAAW;IAM1B,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,SAAS,CAAS;gBAEN,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC;IAE7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,WAAW,IAAI,OAAO;IAQtB,oDAAoD;IAC9C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,uCAAuC;IACjC,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAK7C,OAAO,CAAC,WAAW;IAOnB;;;;OAIG;IACH,IAAI,EAAE,IAAI,cAAc,CAAC,OAAO,CAAC,CAKhC;CACJ"}

package/dist/driver.js

@@ -0,0 +1,75 @@
+import { splitSqlStatements } from "@wild-framework/database";
+import { drizzle } from "drizzle-orm/node-postgres";
+import pg from "pg";
+import { generatePostgresDdl } from "./ddl.js";
+/**
+ * PostgreSQL driver implementing `DatabaseDriver` and `SqlExecutor`.
+ *
+ * Backed by `pg` + Drizzle (`drizzle-orm/node-postgres`). The `db` getter
+ * returns the typed Drizzle instance for ORM queries; `exec`/`all` expose
+ * raw SQL for migrations.
+ */
+export class PostgresDriver {
+    config;
+    pool = null;
+    drizzleDb = null;
+    connected = false;
+    constructor(config) {
+        this.config = config;
+    }
+    async connect() {
+        this.pool = this.config.pool ?? new pg.Pool({ connectionString: this.config.connectionString });
+        this.drizzleDb = drizzle(this.pool, { schema: this.config.schema });
+        if (this.config.autoCreate !== false && this.config.schema) {
+            for (const statement of generatePostgresDdl(this.config.schema)) {
+                await this.exec(statement);
+            }
+        }
+        this.connected = true;
+    }
+    async close() {
+        // Only end pools we created — an injected pool is the caller's.
+        if (this.pool && !this.config.pool) {
+            await this.pool.end();
+        }
+        this.pool = null;
+        this.drizzleDb = null;
+        this.connected = false;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    // -------------------------------------------------------------------
+    // SqlExecutor — raw SQL for migrations and ad-hoc statements
+    // -------------------------------------------------------------------
+    /** Run one or more `;`-separated SQL statements. */
+    async exec(sql) {
+        const pool = this.requirePool();
+        for (const statement of splitSqlStatements(sql)) {
+            await pool.query(statement);
+        }
+    }
+    /** Run a query and return its rows. */
+    async all(sql) {
+        const result = await this.requirePool().query(sql);
+        return result.rows;
+    }
+    requirePool() {
+        if (!this.pool) {
+            throw new Error("Database is not connected. Call connect() first.");
+        }
+        return this.pool;
+    }
+    /**
+     * 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=driver.js.map

package/dist/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAuB,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAoB/C;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IAOH;IAJZ,IAAI,GAAmB,IAAI,CAAC;IAC5B,SAAS,GAAmC,IAAI,CAAC;IACjD,SAAS,GAAG,KAAK,CAAC;IAE1B,YAAoB,MAA+B;QAA/B,WAAM,GAAN,MAAM,CAAyB;IAAG,CAAC;IAEvD,KAAK,CAAC,OAAO;QACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAChG,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAEpE,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACzD,KAAK,MAAM,SAAS,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,KAAK;QACP,gEAAgE;QAChE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,WAAW;QACP,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,sEAAsE;IACtE,6DAA6D;IAC7D,sEAAsE;IAEtE,oDAAoD;IACpD,KAAK,CAAC,IAAI,CAAC,GAAW;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,KAAK,MAAM,SAAS,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,GAAG,CAAU,GAAW;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC,IAAW,CAAC;IAC9B,CAAC;IAEO,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,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,5 @@
+export { PostgresDriver } from "./driver.js";
+export type { PostgresConfig } from "./driver.js";
+export { PostgresProvider } from "./provider.js";
+export { generatePostgresDdl } from "./ddl.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,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { PostgresDriver } from "./driver.js";
+export { PostgresProvider } from "./provider.js";
+export { generatePostgresDdl } from "./ddl.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,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,30 @@
+import type { Provider, Application } from "@wild-framework/core";
+import { type Migration } from "@wild-framework/database";
+/**
+ * Registers a PostgreSQL-backed database with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * PostgresProvider.connectionString = process.env.DATABASE_URL!;
+ * PostgresProvider.schema = { users };
+ * PostgresProvider.migrations = loadMigrations("./migrations");
+ * ```
+ *
+ * Connects on boot, creates tables from the schema, applies pending
+ * migrations, and closes on shutdown.
+ */
+export declare class PostgresProvider implements Provider {
+    /** PostgreSQL connection string. */
+    static connectionString: string | undefined;
+    /** Drizzle schema object (tables). */
+    static schema: Record<string, unknown> | undefined;
+    /** Create tables from the schema at boot. Defaults to true. */
+    static autoCreate: boolean;
+    /** Migrations to apply (in order) after connecting. */
+    static migrations: Migration[];
+    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,EAA6B,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrF;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAC7C,oCAAoC;IACpC,MAAM,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,sCAAsC;IACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,+DAA+D;IAC/D,MAAM,CAAC,UAAU,UAAQ;IACzB,uDAAuD;IACvD,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,CAAM;IAEpC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAa1B,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,53 @@
+import { Container } from "@wild-framework/container";
+import { Database, MigrationRunner } from "@wild-framework/database";
+import { PostgresDriver } from "./driver.js";
+/**
+ * Registers a PostgreSQL-backed database with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * PostgresProvider.connectionString = process.env.DATABASE_URL!;
+ * PostgresProvider.schema = { users };
+ * PostgresProvider.migrations = loadMigrations("./migrations");
+ * ```
+ *
+ * Connects on boot, creates tables from the schema, applies pending
+ * migrations, and closes on shutdown.
+ */
+export class PostgresProvider {
+    /** PostgreSQL connection string. */
+    static connectionString;
+    /** Drizzle schema object (tables). */
+    static schema;
+    /** Create tables from the schema at boot. Defaults to true. */
+    static autoCreate = true;
+    /** Migrations to apply (in order) after connecting. */
+    static migrations = [];
+    register(app) {
+        const container = app.resolve(Container);
+        const driver = new PostgresDriver({
+            connectionString: PostgresProvider.connectionString,
+            schema: PostgresProvider.schema,
+            autoCreate: PostgresProvider.autoCreate,
+        });
+        const database = new Database(driver);
+        container.singleton(Database, () => database);
+    }
+    async boot(app) {
+        const database = app.resolve(Database);
+        await database.connect();
+        if (PostgresProvider.migrations.length > 0) {
+            const driver = database.driver;
+            const applied = await new MigrationRunner(driver).migrate(PostgresProvider.migrations);
+            if (applied.length > 0) {
+                console.log(`[postgres] 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,EAAE,QAAQ,EAAE,eAAe,EAAkB,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,gBAAgB;IACzB,oCAAoC;IACpC,MAAM,CAAC,gBAAgB,CAAqB;IAC5C,sCAAsC;IACtC,MAAM,CAAC,MAAM,CAAsC;IACnD,+DAA+D;IAC/D,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,uDAAuD;IACvD,MAAM,CAAC,UAAU,GAAgB,EAAE,CAAC;IAEpC,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YAC9B,gBAAgB,EAAE,gBAAgB,CAAC,gBAAgB;YACnD,MAAM,EAAE,gBAAgB,CAAC,MAAM;YAC/B,UAAU,EAAE,gBAAgB,CAAC,UAAU;SAC1C,CAAC,CAAC;QACH,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;QAEzB,IAAI,gBAAgB,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAiD,CAAC;YAC1E,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

@@ -1,6 +1,49 @@
 {
   "name": "@wild-framework/database-postgres",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.2",
+  "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": "PostgreSQL driver for Wild Framework's database package (Drizzle + node-postgres).",
+  "keywords": [
+    "wild",
+    "framework",
+    "drizzle",
+    "postgres",
+    "postgresql",
+    "pg"
+  ],
+  "dependencies": {
+    "drizzle-orm": "^0.38.0",
+    "pg": "^8.13.0",
+    "@wild-framework/core": "0.2.2",
+    "@wild-framework/container": "0.2.2",
+    "@wild-framework/database": "0.2.2"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.