durcno 1.0.0-alpha.0 → 1.0.0-alpha.1

package/README.md

@@ -17,7 +17,7 @@
 
 ---
 
-## ✨ Features
+## Features
 
 - **🔗 Relation Mapping** — Intuitive `many`, `one`, and `fk` relations with full type inference.
 - **🦾 Robust Migrations** — Auto-generated, reversible, and squashable migrations for production applications.
@@ -25,7 +25,7 @@
 - **🔌 Multiple Drivers** — Support for `pg`, `postgres`, `bun`, and `pglite` drivers.
 - **🌍 PostGIS Support** — First-class geographic column types for spatial queries.
 
-## 📦 Setup
+## Setup
 
 ```bash
 npm install durcno
@@ -35,7 +35,7 @@ npm install durcno
 npx durcno init
 ```
 
-## 🚀 Getting Started
+## Getting Started
 
 Get started with Durcno by following our comprehensive documentation.
 
@@ -45,11 +45,11 @@ Get started with Durcno by following our comprehensive documentation.
 > Durcno is currently in the alpha stage.
 > Avoid using it in any critical or large project until it reaches beta. Expect bugs and breaking changes. However, your feedback is invaluable to help us shape the future of Durcno!
 
-## 🤝 Contributing
+## Contributing
 
 Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting PRs.
 
-## 📄 License
+## License
 
 Apache License 2.0 - see [LICENSE](LICENSE) for details.
 

package/dist/bin.cjs

@@ -8962,13 +8962,20 @@ async function runDownMigration(migrationDirName, isFirstMigration, migrationsDi
     const statements = migrationModule.statements;
     const options = migrationModule.options ?? {};
     const useTransaction = options.transaction ?? true;
+    const execution = options.execution ?? "joined";
     if (useTransaction) {
       await client.query("BEGIN;");
     }
     try {
       if (statements.length > 0) {
-        const sql = `${statements.map((st) => st.toSQL()).join(";\n")};`;
-        await client.query(sql);
+        if (execution === "sequential") {
+          for (const st of statements) {
+            await client.query(st.toSQL());
+          }
+        } else {
+          const sql = `${statements.map((st) => st.toSQL()).join("\n")}`;
+          await client.query(sql);
+        }
       }
       if (useTransaction) {
         await client.query("COMMIT;");
@@ -12733,11 +12740,11 @@ var CONNECTOR_PACKAGES = {
   bun: []
   // Built-in
 };
-var CONNECTOR_CLASS_NAMES = {
-  pg: "PgConnector",
-  postgres: "PostgresConnector",
-  bun: "BunConnector",
-  pglite: "PgLiteConnector"
+var CONNECTOR_FUNCTION_NAMES = {
+  pg: "pg",
+  postgres: "postgres",
+  bun: "bun",
+  pglite: "pglite"
 };
 var LOADER_PACKAGES = {
   node: ["dotenv"],
@@ -12757,15 +12764,15 @@ var pm = (() => {
 })();
 function generateConfigFile(config2) {
   const { connector, connectionUrl, schemaPath, migrationsDir } = config2;
-  const className = CONNECTOR_CLASS_NAMES[connector];
+  const funcName = CONNECTOR_FUNCTION_NAMES[connector];
   const urlValue = connectionUrl === "" ? "process.env.DATABASE_URL!" : `"${connectionUrl}"`;
   const envLoader = connectionUrl === "" ? runtime === "bun" ? "" : runtime === "deno" ? `import "@std/dotenv/load";
 ` : `import "dotenv/config";
 ` : "";
   return `${envLoader}import { defineConfig } from "durcno";
-import { ${className} } from "durcno/connectors/${connector}";
+import { ${funcName} } from "durcno/connectors/${connector}";
 
-export default defineConfig(${className}, {
+export default defineConfig(${funcName}(), {
   schema: "${schemaPath}",
   out: "${migrationsDir}",
   dbCredentials: {
@@ -12789,10 +12796,10 @@ export const Users = table("public", "users", {
 `;
 }
 function generateIndexFile(schemaPath) {
-  const schemaImport = schemaPath.replace(/\.ts$/, "").replace(/^db\//, "./");
+  const schemaImport = schemaPath.replace(/^db\//, "./");
   return `import { database } from "durcno";
 import * as schema from "${schemaImport}";
-import setup from "../durcno.config";
+import setup from "../durcno.config.ts";
 
 export const db = database(schema, setup);
 `;
@@ -13052,13 +13059,20 @@ async function runUpMigration(migrationDirName, migrationsDir, client, setup) {
   const statements = migrationModule.statements;
   const options = migrationModule.options ?? {};
   const useTransaction = options.transaction ?? true;
+  const execution = options.execution ?? "joined";
   if (useTransaction) {
     await client.query("BEGIN;");
   }
   try {
     if (statements.length > 0) {
-      const sql = `${statements.map((st) => st.toSQL()).join(";\n")};`;
-      await client.query(sql);
+      if (execution === "sequential") {
+        for (const st of statements) {
+          await client.query(st.toSQL());
+        }
+      } else {
+        const sql = `${statements.map((st) => st.toSQL()).join("\n")}`;
+        await client.query(sql);
+      }
     }
     if (useTransaction) {
       await client.query("COMMIT;");

package/dist/src/connectors/bun.d.mts

@@ -14,5 +14,7 @@ declare class BunConnector extends Connector {
   getClient(): BunClient;
   getPool(): BunPool;
 }
+/** Creates a Bun SQL connector instance. */
+declare function bun(): BunConnector;
 //#endregion
-export { BunConnector };
+export { BunConnector, bun };

package/dist/src/connectors/bun.mjs

@@ -18,6 +18,10 @@ var BunConnector = class extends Connector {
 		return new BunPool(this.url, this.config.pool);
 	}
 };
+/** Creates a Bun SQL connector instance. */
+function bun() {
+	return new BunConnector();
+}
 /**
 * Single-connection client wrapper for Bun's SQL API.
 *
@@ -94,4 +98,4 @@ var BunPoolClient = class extends $Client {
 	}
 };
 //#endregion
-export { BunConnector };
+export { BunConnector, bun };

package/dist/src/connectors/common.d.mts

@@ -16,7 +16,8 @@ declare abstract class Connector {
   config: Config;
   /** The PostgreSQL connection URL derived from the configuration. */
   url: string;
-  constructor(config: Config);
+  /** Injects the configuration and derives the connection URL. Called by `defineConfig`. */
+  _init(config: Config): void;
   /**
    * Creates a single-connection client.
    *

package/dist/src/connectors/common.mjs

@@ -15,7 +15,8 @@ var Connector = class {
 	config;
 	/** The PostgreSQL connection URL derived from the configuration. */
 	url;
-	constructor(config) {
+	/** Injects the configuration and derives the connection URL. Called by `defineConfig`. */
+	_init(config) {
 		this.config = config;
 		this.url = getUrlFromDbCredentials(config.dbCredentials);
 	}

package/dist/src/connectors/pg.d.mts

@@ -14,5 +14,7 @@ declare class PgConnector extends Connector {
   getClient(): PgClient;
   getPool(): PgPool;
 }
+/** Creates a pg (node-postgres) connector instance. */
+declare function pg(): PgConnector;
 //#endregion
-export { PgConnector };
+export { PgConnector, pg };

package/dist/src/connectors/pg.mjs

@@ -18,6 +18,10 @@ var PgConnector = class extends Connector {
 		return new PgPool(this.url, this.config.pool);
 	}
 };
+/** Creates a pg (node-postgres) connector instance. */
+function pg() {
+	return new PgConnector();
+}
 /**
 * Single-connection client wrapper for the `pg` library.
 *
@@ -100,4 +104,4 @@ var PgPoolClient = class extends $Client {
 	}
 };
 //#endregion
-export { PgConnector };
+export { PgConnector, pg };

package/dist/src/connectors/pglite.d.mts

@@ -1,4 +1,5 @@
 import { Connector } from "./common.mjs";
+import { PGliteOptions } from "@electric-sql/pglite";
 
 //#region src/connectors/pglite.d.ts
 /**
@@ -12,8 +13,12 @@ import { Connector } from "./common.mjs";
  * @see https://www.npmjs.com/package/@electric-sql/pglite
  */
 declare class PgLiteConnector extends Connector {
+  #private;
+  constructor(options?: PGliteOptions);
   getClient(): PgLiteClient;
   getPool(): PgLitePool;
 }
+/** Creates a PgLite connector instance, optionally accepting PGlite options (e.g., extensions). */
+declare function pglite(options?: PGliteOptions): PgLiteConnector;
 //#endregion
-export { PgLiteConnector };
+export { PgLiteConnector, pglite };

package/dist/src/connectors/pglite.mjs

@@ -12,13 +12,22 @@ import { PGlite } from "@electric-sql/pglite";
 * @see https://www.npmjs.com/package/@electric-sql/pglite
 */
 var PgLiteConnector = class extends Connector {
+	#options;
+	constructor(options) {
+		super();
+		this.#options = options;
+	}
 	getClient() {
-		return new PgLiteClient(this.url);
+		return new PgLiteClient(this.url, this.#options);
 	}
 	getPool() {
-		return new PgLitePool(this.url, this.config.pool);
+		return new PgLitePool(this.url, this.config.pool, this.#options);
 	}
 };
+/** Creates a PgLite connector instance, optionally accepting PGlite options (e.g., extensions). */
+function pglite(options) {
+	return new PgLiteConnector(options);
+}
 /**
 * Single-instance client wrapper for PGlite.
 *
@@ -29,9 +38,9 @@ var PgLiteConnector = class extends Connector {
 */
 var PgLiteClient = class extends $Client {
 	#client;
-	constructor(connectionString) {
+	constructor(connectionString, options) {
 		super();
-		this.#client = new PGlite(connectionString);
+		this.#client = new PGlite(connectionString, options);
 		this.query = this.#client.query.bind(this.#client);
 	}
 	async connect() {}
@@ -53,9 +62,9 @@ var PgLiteClient = class extends $Client {
 */
 var PgLitePool = class extends $Pool {
 	#pool;
-	constructor(connectionString, pool) {
+	constructor(connectionString, pool, options) {
 		super();
-		this.#pool = new PGlite(connectionString);
+		this.#pool = new PGlite(connectionString, options);
 		this.query = this.#pool.query.bind(this.#pool);
 	}
 	async connect() {}
@@ -91,4 +100,4 @@ var PgLitePoolClient = class extends $Client {
 	async close() {}
 };
 //#endregion
-export { PgLiteConnector };
+export { PgLiteConnector, pglite };

package/dist/src/connectors/postgres.d.mts

@@ -14,5 +14,7 @@ declare class PostgresConnector extends Connector {
   getClient(): PostgresClient;
   getPool(): PostgresPool;
 }
+/** Creates a postgres.js connector instance. */
+declare function postgres(): PostgresConnector;
 //#endregion
-export { PostgresConnector };
+export { PostgresConnector, postgres };

package/dist/src/connectors/postgres.mjs

@@ -1,5 +1,5 @@
 import { $Client, $Pool, Connector } from "./common.mjs";
-import postgres from "postgres";
+import postgresLib from "postgres";
 //#region src/connectors/postgres.ts
 /**
 * Connector implementation for the `postgres` (postgres.js) library.
@@ -18,6 +18,10 @@ var PostgresConnector = class extends Connector {
 		return new PostgresPool(this.url, this.config.pool);
 	}
 };
+/** Creates a postgres.js connector instance. */
+function postgres() {
+	return new PostgresConnector();
+}
 /**
 * Single-connection client wrapper for postgres.js.
 *
@@ -30,7 +34,7 @@ var PostgresClient = class extends $Client {
 	#sql;
 	constructor(connectionString) {
 		super();
-		this.#sql = postgres(connectionString, { max: 1 });
+		this.#sql = postgresLib(connectionString, { max: 1 });
 		this.query = this.#sql.unsafe.bind(this.#sql);
 	}
 	async connect() {}
@@ -53,7 +57,7 @@ var PostgresPool = class extends $Pool {
 	#sql;
 	constructor(connectionString, pool) {
 		super();
-		this.#sql = postgres(connectionString, { max: pool?.max ?? 10 });
+		this.#sql = postgresLib(connectionString, { max: pool?.max ?? 10 });
 		this.query = this.#sql.unsafe.bind(this.#sql);
 	}
 	async connect() {}
@@ -90,4 +94,4 @@ var PostgresPoolClient = class extends $Client {
 	}
 };
 //#endregion
-export { PostgresConnector };
+export { PostgresConnector, postgres };

package/dist/src/db.d.mts

@@ -28,7 +28,6 @@ declare class Base<TTName extends string, TTables extends Record<TTName, TableWi
     tables: TTables;
     allRelations: TAllRelations;
     config: Config;
-    dbUrl: string;
     pre: TPrepare;
   };
   constructor(tables: TTables, allRelations: TAllRelations, executor: QueryExecutor | null, connector: Connector, prepare: TPrepare);

package/dist/src/db.mjs

@@ -1,5 +1,4 @@
 import { is } from "./entity.mjs";
-import { getUrlFromDbCredentials } from "./cli/helpers.mjs";
 import { AggregateQuery } from "./query-builders/aggregates.mjs";
 import { CountQuery } from "./query-builders/count.mjs";
 import { DeleteQuery } from "./query-builders/delete.mjs";
@@ -33,7 +32,6 @@ var Base = class {
 			tables,
 			allRelations,
 			config: connector.config,
-			dbUrl: getUrlFromDbCredentials(connector.config.dbCredentials),
 			pre: prepare
 		};
 	}

package/dist/src/index.d.mts

@@ -61,18 +61,18 @@ type DurcnoSetup<T extends Connector = Connector> = {
  * Define a Durcno configuration.
  *
  * This is the recommended way to create your `durcno.config.ts` file.
- * Pass the connector class for your database driver and the configuration options.
+ * Pass a connector instance for your database driver and the configuration options.
  *
- * @param Connector - The connector class to use (e.g., `PgConnector`, `PostgresConnector`, `BunConnector`, `PgLiteConnector`).
+ * @param connector - The connector instance to use (e.g., `pg()`, `postgres()`, `bun()`, `pglite()`).
  * @param config - The database configuration including connection credentials and pool settings.
  * @returns A setup object containing the connector instance and the config options.
  *
  * @example
  * ```typescript
  * import { defineConfig } from "durcno";
- * import { PgConnector } from "durcno/connectors/pg";
+ * import { pg } from "durcno/connectors/pg";
  *
- * export default defineConfig(PgConnector, {
+ * export default defineConfig(pg(), {
  *   schema: "db/schema.ts",
  *   out: "migrations",
  *   dbCredentials: {
@@ -81,7 +81,7 @@ type DurcnoSetup<T extends Connector = Connector> = {
  * });
  * ```
  */
-declare function defineConfig<T extends Connector>(ConnectorClass: new (config: Config) => T, config: Config): DurcnoSetup<T>;
+declare function defineConfig<T extends Connector>(connector: T, config: Config): DurcnoSetup<T>;
 type Config = {
   /**
    * The relative path to the database schema file.

package/dist/src/index.mjs

@@ -48,18 +48,18 @@ const $ = {
 * Define a Durcno configuration.
 *
 * This is the recommended way to create your `durcno.config.ts` file.
-* Pass the connector class for your database driver and the configuration options.
+* Pass a connector instance for your database driver and the configuration options.
 *
-* @param Connector - The connector class to use (e.g., `PgConnector`, `PostgresConnector`, `BunConnector`, `PgLiteConnector`).
+* @param connector - The connector instance to use (e.g., `pg()`, `postgres()`, `bun()`, `pglite()`).
 * @param config - The database configuration including connection credentials and pool settings.
 * @returns A setup object containing the connector instance and the config options.
 *
 * @example
 * ```typescript
 * import { defineConfig } from "durcno";
-* import { PgConnector } from "durcno/connectors/pg";
+* import { pg } from "durcno/connectors/pg";
 *
-* export default defineConfig(PgConnector, {
+* export default defineConfig(pg(), {
 *   schema: "db/schema.ts",
 *   out: "migrations",
 *   dbCredentials: {
@@ -68,9 +68,10 @@ const $ = {
 * });
 * ```
 */
-function defineConfig(ConnectorClass, config) {
+function defineConfig(connector, config) {
+	connector._init(config);
 	return {
-		connector: new ConnectorClass(config),
+		connector,
 		config
 	};
 }

package/dist/src/migration/index.d.mts

@@ -10,6 +10,8 @@ import { ddl } from "./ddl.mjs";
 interface MigrationOptions {
   /** Whether to wrap statements in BEGIN...COMMIT (default: true) */
   transaction?: boolean;
+  /** How to execute statements: 'joined' runs all as a single query, 'sequential' runs one at a time (default: 'joined') */
+  execution?: "joined" | "sequential";
 }
 //#endregion
 export { CustomStatement, DDLStatement, MIGRATION_NAME_REGEX, MigrationOptions, type Snapshot, type SnapshotColumn, type SnapshotColumnRef, type SnapshotEnum, type SnapshotSequence, type SnapshotTable, type SnapshotTableCheck, type SnapshotTableIndex, type SnapshotTablePrimaryKey, type SnapshotTableUnique, createEmptySnapshot, ddl, snapshot };

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "durcno",
-  "version": "1.0.0-alpha.0",
+  "version": "1.0.0-alpha.1",
   "description": "A PostgreSQL Query Builder and Migration Manager for TypeScript, from the future.",
   "license": "Apache-2.0",
   "homepage": "https://durcno.dev",
   "keywords": [
     "durcno",
     "query",
+    "query-builder",
     "sql",
     "ts",
     "typescript",
@@ -27,7 +28,7 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=25.8.0"
+    "node": ">=24.14.0"
   },
   "files": [
     "dist"