durcno 1.0.0-alpha.17 → 1.0.0-alpha.18

package/dist/bin.cjs

@@ -10457,7 +10457,7 @@ async function status(options) {
 }
 
 // src/cli/index.ts
-program.version("1.0.0-alpha.16");
+program.version("1.0.0-alpha.17");
 var Options = {
   config: ["--config <path>", "Path to the config file"]
 };

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

@@ -1,5 +1,5 @@
 import { BasicTypes, Or } from "../types.mjs";
-import { AnyScalarSqlFn } from "../functions/index.mjs";
+import { AnyAggregateSqlFn, AnyScalarSqlFn, AnySqlFn } from "../functions/index.mjs";
 import { SelectQuery } from "../query-builders/select.mjs";
 import { AnyColumn } from "../table.mjs";
 import { Arg, IsArg } from "../query-builders/pre.mjs";
@@ -25,6 +25,16 @@ type AnyFilter = Filter<any, any>;
  */
 type FilterExpression<TScopeColumns extends AnyColumn, TPrepare extends boolean = false> = Filter<TScopeColumns, TPrepare extends true ? boolean : false> | Sql;
 type StdCondition = FilterExpression<AnyColumn>;
+/**
+ * A HAVING clause expression. Structurally identical to `FilterExpression` but
+ * signals intent — it is used in `.having()` rather than `.where()`.
+ *
+ * Note: TypeScript does not prevent aggregate `SqlFn` expressions from being
+ * passed to `.where()` at the type level (the `$Columns` phantom traces back to
+ * `AnyColumn` regardless of aggregate/scalar kind). PostgreSQL will reject such
+ * queries at runtime. This is a known limitation.
+ */
+type HavingExpression<TScopeColumns extends AnyColumn, TPrepare extends boolean = false> = FilterExpression<TScopeColumns, TPrepare>;
 type HasArg<T> = T extends {
   $HasArg: true;
 } ? true : false;
@@ -35,7 +45,7 @@ declare class ComparisonLeftIsColumn<TLeft extends AnyColumn, TOp extends string
   constructor(field: TLeft, op: TOp, right: TRight);
   toQuery(query: Query, ctx?: QueryContext): void;
 }
-declare class ComparisonLeftIsSqlFn<TLeft extends AnyScalarSqlFn, TOp extends string, TRight extends BasicTypes | AnyScalarSqlFn> extends Filter<TLeft["$Columns"] | (TRight extends AnyScalarSqlFn ? TRight["$Columns"] : never), HasArg<TLeft> extends true ? true : HasArg<TRight>> {
+declare class ComparisonLeftIsSqlFn<TLeft extends AnySqlFn, TOp extends string, TRight extends BasicTypes | AnySqlFn> extends Filter<TLeft["$Columns"] | (TRight extends AnyScalarSqlFn ? TRight["$Columns"] : never), HasArg<TLeft> extends true ? true : HasArg<TRight>> {
   readonly left: TLeft;
   readonly op: TOp;
   readonly right: TRight;
@@ -46,26 +56,38 @@ declare function eq<TLeft extends AnyColumn, TRight extends TLeft["ValType"]>(le
 declare function eq<TLeft extends AnyColumn, TRight extends Arg<TLeft["ValType"]> | AnyColumn | AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, "=", TRight>;
 declare function eq<TLeft extends AnyScalarSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "=", TRight>;
 declare function eq<TLeft extends AnyScalarSqlFn, TRight extends AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "=", TRight>;
+declare function eq<TLeft extends AnyAggregateSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "=", TRight>;
+declare function eq<TLeft extends AnyAggregateSqlFn, TRight extends AnyAggregateSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "=", TRight>;
 declare function ne<TLeft extends AnyColumn, TRight extends TLeft["ValType"]>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, "!=", TRight>;
 declare function ne<TLeft extends AnyColumn, TRight extends Arg<TLeft["ValType"]> | AnyColumn | AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, "!=", TRight>;
 declare function ne<TLeft extends AnyScalarSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "!=", TRight>;
 declare function ne<TLeft extends AnyScalarSqlFn, TRight extends AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "!=", TRight>;
+declare function ne<TLeft extends AnyAggregateSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "!=", TRight>;
+declare function ne<TLeft extends AnyAggregateSqlFn, TRight extends AnyAggregateSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "!=", TRight>;
 declare function gt<TLeft extends AnyColumn, TRight extends TLeft["ValType"]>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, ">", TRight>;
 declare function gt<TLeft extends AnyColumn, TRight extends Arg<TLeft["ValType"]> | AnyColumn | AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, ">", TRight>;
 declare function gt<TLeft extends AnyScalarSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, ">", TRight>;
 declare function gt<TLeft extends AnyScalarSqlFn, TRight extends AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, ">", TRight>;
+declare function gt<TLeft extends AnyAggregateSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, ">", TRight>;
+declare function gt<TLeft extends AnyAggregateSqlFn, TRight extends AnyAggregateSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, ">", TRight>;
 declare function gte<TLeft extends AnyColumn, TRight extends TLeft["ValType"]>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, ">=", TRight>;
 declare function gte<TLeft extends AnyColumn, TRight extends Arg<TLeft["ValType"]> | AnyColumn | AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, ">=", TRight>;
 declare function gte<TLeft extends AnyScalarSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, ">=", TRight>;
 declare function gte<TLeft extends AnyScalarSqlFn, TRight extends AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, ">=", TRight>;
+declare function gte<TLeft extends AnyAggregateSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, ">=", TRight>;
+declare function gte<TLeft extends AnyAggregateSqlFn, TRight extends AnyAggregateSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, ">=", TRight>;
 declare function lt<TLeft extends AnyColumn, TRight extends TLeft["ValType"]>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, "<", TRight>;
 declare function lt<TLeft extends AnyColumn, TRight extends Arg<TLeft["ValType"]> | AnyColumn | AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, "<", TRight>;
 declare function lt<TLeft extends AnyScalarSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "<", TRight>;
 declare function lt<TLeft extends AnyScalarSqlFn, TRight extends AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "<", TRight>;
+declare function lt<TLeft extends AnyAggregateSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "<", TRight>;
+declare function lt<TLeft extends AnyAggregateSqlFn, TRight extends AnyAggregateSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "<", TRight>;
 declare function lte<TLeft extends AnyColumn, TRight extends TLeft["ValType"]>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, "<=", TRight>;
 declare function lte<TLeft extends AnyColumn, TRight extends Arg<TLeft["ValType"]> | AnyColumn | AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsColumn<TLeft, "<=", TRight>;
 declare function lte<TLeft extends AnyScalarSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "<=", TRight>;
 declare function lte<TLeft extends AnyScalarSqlFn, TRight extends AnyScalarSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "<=", TRight>;
+declare function lte<TLeft extends AnyAggregateSqlFn, TRight extends BasicTypes>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "<=", TRight>;
+declare function lte<TLeft extends AnyAggregateSqlFn, TRight extends AnyAggregateSqlFn>(left: TLeft, right: TRight): ComparisonLeftIsSqlFn<TLeft, "<=", TRight>;
 declare class IsNullCondition<TCol extends AnyColumn> extends Filter<TCol, false> {
   readonly field: TCol;
   constructor(field: TCol);
@@ -78,7 +100,7 @@ declare class IsNotNullCondition<TCol extends AnyColumn> extends Filter<TCol, fa
   toQuery(query: Query, ctx?: QueryContext): void;
 }
 declare function isNotNull<TCol extends AnyColumn>(field: TCol): IsNotNullCondition<TCol>;
-type InSelectQuery<TArg extends boolean, TReturn> = SelectQuery<any, any, any, any, any, TArg, any, any, Record<string, TReturn>[]>;
+type InSelectQuery<TArg extends boolean, TReturn> = SelectQuery<any, any, any, any, any, TArg, any, any, any, any, Record<string, TReturn>[]>;
 declare class InCondition<TCol extends AnyColumn, TArg extends boolean> extends Filter<TCol, TArg> {
   readonly field: TCol;
   readonly values: TCol["ValType"][] | InSelectQuery<TArg, TCol["ValType"]>;
@@ -106,4 +128,4 @@ declare class OrCondition<TConditions extends (AnyFilter | Sql)[]> extends Filte
 }
 declare function or<TConditions extends (AnyFilter | Sql)[]>(...conditions: TConditions): OrCondition<TConditions>;
 //#endregion
-export { AnyFilter, Filter, FilterExpression, StdCondition, and, eq, gt, gte, isIn, isNotNull, isNull, lt, lte, ne, notIn, or };
+export { AnyFilter, Filter, FilterExpression, HavingExpression, StdCondition, and, eq, gt, gte, isIn, isNotNull, isNull, lt, lte, ne, notIn, or };

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

@@ -59,6 +59,7 @@ declare abstract class SqlFn<TColumn extends AnyColumn, THasArg extends boolean
 }
 type AnySqlFn = SqlFn<any, any, any, any, any>;
 type AnyScalarSqlFn = SqlFn<any, any, "scalar", any, any>;
+type AnyAggregateSqlFn = SqlFn<any, any, "aggregate", any, any>;
 /**
  * Extracts the table column(s) referenced by a scalar expression.
  * For a raw column, returns the column itself.
@@ -104,4 +105,4 @@ declare function uuidv4(): Sql;
  */
 declare function uuidv7(): Sql;
 //#endregion
-export { AnyScalarSqlFn, AnySqlFn, ExprColumns, HasArg, SqlFn, now, uuidv4, uuidv7 };
+export { AnyAggregateSqlFn, AnyScalarSqlFn, AnySqlFn, ExprColumns, HasArg, SqlFn, now, uuidv4, uuidv7 };

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

@@ -1,9 +1,9 @@
-import { CustomStatement, DDLStatement, DDLStatementType } from "./statement.mjs";
-import { CreateIndexBuilder, DropIndexStatement } from "./indexes.mjs";
-import { CreateSchemaStatement, DropSchemaStatement } from "./schema.mjs";
-import { CreateSequenceStatement, DropSequenceStatement, SequenceOptions } from "./sequence.mjs";
-import { AlterTableBuilder, ColumnOptions, CreateTableBuilder, DropTableStatement, RenameTableStatement } from "./table.mjs";
-import { AlterTypeBuilder, CreateTypeStatement, DropTypeStatement } from "./types.mjs";
+import { CustomStatement, DDLStatement, DDLStatementType, custom } from "./statement.mjs";
+import { CreateIndexBuilder, DropIndexStatement, createIndex, dropIndex } from "./indexes.mjs";
+import { CreateSchemaStatement, DropSchemaStatement, createSchema, dropSchema } from "./schema.mjs";
+import { CreateSequenceStatement, DropSequenceStatement, SequenceOptions, createSequence, dropSequence } from "./sequence.mjs";
+import { AlterTableBuilder, ColumnOptions, CreateTableBuilder, DropTableStatement, RenameTableStatement, alterTable, createTable, dropTable, renameTable } from "./table.mjs";
+import { AlterTypeBuilder, CreateTypeStatement, DropTypeStatement, alterType, createType, dropType } from "./types.mjs";
 
 //#region src/migration/ddl/index.d.ts
 /**
@@ -25,147 +25,20 @@ import { AlterTypeBuilder, CreateTypeStatement, DropTypeStatement } from "./type
  * ```
  */
 declare const ddl: {
-  /**
-   * Create a new schema.
-   *
-   * @param name - The schema name.
-   * @returns A {@link CreateSchemaStatement}.
-   */
-  createSchema(name: string): CreateSchemaStatement;
-  /**
-   * Drop a schema.
-   *
-   * @param name - The schema name.
-   * @returns A {@link DropSchemaStatement}.
-   */
-  dropSchema(name: string): DropSchemaStatement;
-  /**
-   * Create a new PostgreSQL type.
-   *
-   * Currently supports enum types only.
-   *
-   * @param schema - The schema the type belongs to.
-   * @param name - The type name.
-   * @param definition - The type definition. Currently only `{ asEnum: string[] }` is supported.
-   * @returns A {@link CreateTypeStatement}.
-   *
-   * @example
-   * ```typescript
-   * ddl.createType('public', 'user_type', { asEnum: ['admin', 'user'] });
-   * ```
-   */
-  createType(schema: string, name: string, definition: {
-    asEnum: string[];
-  }): CreateTypeStatement;
-  /**
-   * Drop an existing PostgreSQL type.
-   *
-   * @param schema - The schema the type belongs to.
-   * @param name - The type name.
-   * @returns A {@link DropTypeStatement}.
-   *
-   * @example
-   * ```typescript
-   * ddl.dropType('public', 'user_type');
-   * ```
-   */
-  dropType(schema: string, name: string): DropTypeStatement;
-  /**
-   * Alter an existing type. Returns a chainable {@link AlterTypeBuilder}.
-   *
-   * Currently supports enum value operations only.
-   *
-   * @param schema - The schema the type belongs to.
-   * @param name - The type name.
-   * @returns An {@link AlterTypeBuilder} for chaining `.addValue()`.
-   *
-   * @example
-   * ```typescript
-   * ddl.alterType('public', 'user_type')
-   *   .addValue('moderator', { after: 'admin' })
-   *   .addValue('guest');
-   * ```
-   */
-  alterType(schema: string, name: string): AlterTypeBuilder;
-  /**
-   * Create a new sequence.
-   *
-   * @param schema - The schema the sequence belongs to.
-   * @param name - The sequence name.
-   * @param options - Optional sequence configuration.
-   * @returns A {@link CreateSequenceStatement}.
-   */
-  createSequence(schema: string, name: string, options?: SequenceOptions): CreateSequenceStatement;
-  /**
-   * Drop a sequence.
-   *
-   * @param schema - The schema the sequence belongs to.
-   * @param name - The sequence name.
-   * @returns A {@link DropSequenceStatement}.
-   */
-  dropSequence(schema: string, name: string): DropSequenceStatement;
-  /**
-   * Create a new table. Returns a chainable {@link CreateTableBuilder}.
-   *
-   * @param schema - The schema to create the table in.
-   * @param name - The table name.
-   * @returns A {@link CreateTableBuilder} for chaining `.column()`, `.check()`, etc.
-   */
-  createTable(schema: string, name: string): CreateTableBuilder;
-  /**
-   * Drop a table.
-   *
-   * @param schema - The schema of the table.
-   * @param name - The table name.
-   * @returns A {@link DropTableStatement}.
-   */
-  dropTable(schema: string, name: string): DropTableStatement;
-  /**
-   * Rename a table.
-   *
-   * @param schema - The schema of the table.
-   * @param oldName - The current table name.
-   * @param newName - The new table name.
-   * @returns A {@link RenameTableStatement}.
-   */
-  renameTable(schema: string, oldName: string, newName: string): RenameTableStatement;
-  /**
-   * Alter an existing table. Returns a chainable {@link AlterTableBuilder}.
-   *
-   * @param schema - The schema of the table.
-   * @param name - The table name.
-   * @returns An {@link AlterTableBuilder} for chaining `.addColumn()`, `.dropColumn()`, etc.
-   */
-  alterTable(schema: string, name: string): AlterTableBuilder;
-  /**
-   * Create an index. Returns a chainable {@link CreateIndexBuilder}.
-   *
-   * @param name - The index name.
-   * @returns A {@link CreateIndexBuilder} for chaining `.on()`, `.using()`, `.unique()`.
-   *
-   * @example
-   * ```typescript
-   * ddl.createIndex('idx_users_email')
-   *   .on('public', 'users', ['email'])
-   *   .using('btree')
-   *   .unique();
-   * ```
-   */
-  createIndex(name: string): CreateIndexBuilder;
-  /**
-   * Drop an index.
-   *
-   * @param name - The index name.
-   * @returns A {@link DropIndexStatement}.
-   */
-  dropIndex(name: string): DropIndexStatement;
-  /**
-   * Create a custom SQL statement. Preserved during migration regeneration.
-   *
-   * @param sql - The raw SQL string.
-   * @returns A {@link CustomStatement}.
-   */
-  custom(sql: string): CustomStatement;
+  createSchema: typeof createSchema;
+  dropSchema: typeof dropSchema;
+  createType: typeof createType;
+  dropType: typeof dropType;
+  alterType: typeof alterType;
+  createSequence: typeof createSequence;
+  dropSequence: typeof dropSequence;
+  createTable: typeof createTable;
+  dropTable: typeof dropTable;
+  renameTable: typeof renameTable;
+  alterTable: typeof alterTable;
+  createIndex: typeof createIndex;
+  dropIndex: typeof dropIndex;
+  custom: typeof custom;
 };
 //#endregion
 export { ddl };

package/dist/src/migration/ddl/index.mjs

@@ -1,9 +1,9 @@
-import { CustomStatement } from "./statement.mjs";
-import { CreateIndexBuilder, DropIndexStatement } from "./indexes.mjs";
-import { CreateSchemaStatement, DropSchemaStatement } from "./schema.mjs";
-import { CreateSequenceStatement, DropSequenceStatement } from "./sequence.mjs";
-import { AlterTableBuilder, CreateTableBuilder, DropTableStatement, RenameTableStatement } from "./table.mjs";
-import { AlterTypeBuilder, CreateTypeStatement, DropTypeStatement } from "./types.mjs";
+import { custom } from "./statement.mjs";
+import { createIndex, dropIndex } from "./indexes.mjs";
+import { createSchema, dropSchema } from "./schema.mjs";
+import { createSequence, dropSequence } from "./sequence.mjs";
+import { alterTable, createTable, dropTable, renameTable } from "./table.mjs";
+import { alterType, createType, dropType } from "./types.mjs";
 //#region src/migration/ddl/index.ts
 /**
 * The main DDL builder entry point.
@@ -24,173 +24,20 @@ import { AlterTypeBuilder, CreateTypeStatement, DropTypeStatement } from "./type
 * ```
 */
 const ddl = {
-	/**
-	* Create a new schema.
-	*
-	* @param name - The schema name.
-	* @returns A {@link CreateSchemaStatement}.
-	*/
-	createSchema(name) {
-		return new CreateSchemaStatement(name);
-	},
-	/**
-	* Drop a schema.
-	*
-	* @param name - The schema name.
-	* @returns A {@link DropSchemaStatement}.
-	*/
-	dropSchema(name) {
-		return new DropSchemaStatement(name);
-	},
-	/**
-	* Create a new PostgreSQL type.
-	*
-	* Currently supports enum types only.
-	*
-	* @param schema - The schema the type belongs to.
-	* @param name - The type name.
-	* @param definition - The type definition. Currently only `{ asEnum: string[] }` is supported.
-	* @returns A {@link CreateTypeStatement}.
-	*
-	* @example
-	* ```typescript
-	* ddl.createType('public', 'user_type', { asEnum: ['admin', 'user'] });
-	* ```
-	*/
-	createType(schema, name, definition) {
-		return new CreateTypeStatement(schema, name, definition);
-	},
-	/**
-	* Drop an existing PostgreSQL type.
-	*
-	* @param schema - The schema the type belongs to.
-	* @param name - The type name.
-	* @returns A {@link DropTypeStatement}.
-	*
-	* @example
-	* ```typescript
-	* ddl.dropType('public', 'user_type');
-	* ```
-	*/
-	dropType(schema, name) {
-		return new DropTypeStatement(schema, name);
-	},
-	/**
-	* Alter an existing type. Returns a chainable {@link AlterTypeBuilder}.
-	*
-	* Currently supports enum value operations only.
-	*
-	* @param schema - The schema the type belongs to.
-	* @param name - The type name.
-	* @returns An {@link AlterTypeBuilder} for chaining `.addValue()`.
-	*
-	* @example
-	* ```typescript
-	* ddl.alterType('public', 'user_type')
-	*   .addValue('moderator', { after: 'admin' })
-	*   .addValue('guest');
-	* ```
-	*/
-	alterType(schema, name) {
-		return new AlterTypeBuilder(schema, name);
-	},
-	/**
-	* Create a new sequence.
-	*
-	* @param schema - The schema the sequence belongs to.
-	* @param name - The sequence name.
-	* @param options - Optional sequence configuration.
-	* @returns A {@link CreateSequenceStatement}.
-	*/
-	createSequence(schema, name, options) {
-		return new CreateSequenceStatement(schema, name, options);
-	},
-	/**
-	* Drop a sequence.
-	*
-	* @param schema - The schema the sequence belongs to.
-	* @param name - The sequence name.
-	* @returns A {@link DropSequenceStatement}.
-	*/
-	dropSequence(schema, name) {
-		return new DropSequenceStatement(schema, name);
-	},
-	/**
-	* Create a new table. Returns a chainable {@link CreateTableBuilder}.
-	*
-	* @param schema - The schema to create the table in.
-	* @param name - The table name.
-	* @returns A {@link CreateTableBuilder} for chaining `.column()`, `.check()`, etc.
-	*/
-	createTable(schema, name) {
-		return new CreateTableBuilder(schema, name);
-	},
-	/**
-	* Drop a table.
-	*
-	* @param schema - The schema of the table.
-	* @param name - The table name.
-	* @returns A {@link DropTableStatement}.
-	*/
-	dropTable(schema, name) {
-		return new DropTableStatement(schema, name);
-	},
-	/**
-	* Rename a table.
-	*
-	* @param schema - The schema of the table.
-	* @param oldName - The current table name.
-	* @param newName - The new table name.
-	* @returns A {@link RenameTableStatement}.
-	*/
-	renameTable(schema, oldName, newName) {
-		return new RenameTableStatement(schema, oldName, newName);
-	},
-	/**
-	* Alter an existing table. Returns a chainable {@link AlterTableBuilder}.
-	*
-	* @param schema - The schema of the table.
-	* @param name - The table name.
-	* @returns An {@link AlterTableBuilder} for chaining `.addColumn()`, `.dropColumn()`, etc.
-	*/
-	alterTable(schema, name) {
-		return new AlterTableBuilder(schema, name);
-	},
-	/**
-	* Create an index. Returns a chainable {@link CreateIndexBuilder}.
-	*
-	* @param name - The index name.
-	* @returns A {@link CreateIndexBuilder} for chaining `.on()`, `.using()`, `.unique()`.
-	*
-	* @example
-	* ```typescript
-	* ddl.createIndex('idx_users_email')
-	*   .on('public', 'users', ['email'])
-	*   .using('btree')
-	*   .unique();
-	* ```
-	*/
-	createIndex(name) {
-		return new CreateIndexBuilder(name);
-	},
-	/**
-	* Drop an index.
-	*
-	* @param name - The index name.
-	* @returns A {@link DropIndexStatement}.
-	*/
-	dropIndex(name) {
-		return new DropIndexStatement(name);
-	},
-	/**
-	* Create a custom SQL statement. Preserved during migration regeneration.
-	*
-	* @param sql - The raw SQL string.
-	* @returns A {@link CustomStatement}.
-	*/
-	custom(sql) {
-		return new CustomStatement(sql);
-	}
+	createSchema,
+	dropSchema,
+	createType,
+	dropType,
+	alterType,
+	createSequence,
+	dropSequence,
+	createTable,
+	dropTable,
+	renameTable,
+	alterTable,
+	createIndex,
+	dropIndex,
+	custom
 };
 //#endregion
 export { ddl };

package/dist/src/migration/ddl/indexes.d.mts

@@ -3,6 +3,21 @@ import { Snapshot } from "../snapshot.mjs";
 import { DDLStatement } from "./statement.mjs";
 
 //#region src/migration/ddl/indexes.d.ts
+/**
+ * Create an index. Returns a chainable {@link CreateIndexBuilder}.
+ *
+ * @param name - The index name.
+ * @returns A {@link CreateIndexBuilder} for chaining `.on()`, `.using()`, `.unique()`.
+ *
+ * @example
+ * ```typescript
+ * ddl.createIndex('idx_users_email')
+ *   .on('public', 'users', ['email'])
+ *   .using('btree')
+ *   .unique();
+ * ```
+ */
+declare function createIndex(name: string): CreateIndexBuilder;
 /**
  * Chainable builder that constructs a `CREATE INDEX` DDL statement.
  *
@@ -69,6 +84,13 @@ declare class CreateIndexBuilder extends DDLStatement {
   toSQL(): string;
   applyToSnapshot(snapshot: Snapshot): void;
 }
+/**
+ * Drop an index.
+ *
+ * @param name - The index name.
+ * @returns A {@link DropIndexStatement}.
+ */
+declare function dropIndex(name: string): DropIndexStatement;
 /**
  * DDL statement builder that drops an existing index.
  *
@@ -107,4 +129,4 @@ declare class DropIndexStatement extends DDLStatement {
   applyToSnapshot(snapshot: Snapshot): void;
 }
 //#endregion
-export { CreateIndexBuilder, DropIndexStatement };
+export { CreateIndexBuilder, DropIndexStatement, createIndex, dropIndex };

package/dist/src/migration/ddl/indexes.mjs

@@ -1,6 +1,23 @@
 import { DDLStatement } from "./statement.mjs";
 //#region src/migration/ddl/indexes.ts
 /**
+* Create an index. Returns a chainable {@link CreateIndexBuilder}.
+*
+* @param name - The index name.
+* @returns A {@link CreateIndexBuilder} for chaining `.on()`, `.using()`, `.unique()`.
+*
+* @example
+* ```typescript
+* ddl.createIndex('idx_users_email')
+*   .on('public', 'users', ['email'])
+*   .using('btree')
+*   .unique();
+* ```
+*/
+function createIndex(name) {
+	return new CreateIndexBuilder(name);
+}
+/**
 * Chainable builder that constructs a `CREATE INDEX` DDL statement.
 *
 * Use {@link ddl.createIndex} to obtain an instance, then chain `.on()`,
@@ -107,6 +124,15 @@ var CreateIndexBuilder = class extends DDLStatement {
 	}
 };
 /**
+* Drop an index.
+*
+* @param name - The index name.
+* @returns A {@link DropIndexStatement}.
+*/
+function dropIndex(name) {
+	return new DropIndexStatement(name);
+}
+/**
 * DDL statement builder that drops an existing index.
 *
 * Generates: `DROP INDEX [CONCURRENTLY] <name>;`
@@ -156,4 +182,4 @@ var DropIndexStatement = class extends DDLStatement {
 	}
 };
 //#endregion
-export { CreateIndexBuilder, DropIndexStatement };
+export { CreateIndexBuilder, DropIndexStatement, createIndex, dropIndex };

package/dist/src/migration/ddl/schema.d.mts

@@ -2,6 +2,13 @@ import { Snapshot } from "../snapshot.mjs";
 import { DDLStatement } from "./statement.mjs";
 
 //#region src/migration/ddl/schema.d.ts
+/**
+ * Create a new schema.
+ *
+ * @param name - The schema name.
+ * @returns A {@link CreateSchemaStatement}.
+ */
+declare function createSchema(name: string): CreateSchemaStatement;
 /**
  * DDL statement that creates a new PostgreSQL schema.
  *
@@ -27,6 +34,13 @@ declare class CreateSchemaStatement extends DDLStatement {
   /** Schemas are not tracked in snapshot, so this is a no-op. */
   applyToSnapshot(_snapshot: Snapshot): void;
 }
+/**
+ * Drop a schema.
+ *
+ * @param name - The schema name.
+ * @returns A {@link DropSchemaStatement}.
+ */
+declare function dropSchema(name: string): DropSchemaStatement;
 /**
  * DDL statement that drops an existing PostgreSQL schema.
  *
@@ -53,4 +67,4 @@ declare class DropSchemaStatement extends DDLStatement {
   applyToSnapshot(_snapshot: Snapshot): void;
 }
 //#endregion
-export { CreateSchemaStatement, DropSchemaStatement };
+export { CreateSchemaStatement, DropSchemaStatement, createSchema, dropSchema };

package/dist/src/migration/ddl/schema.mjs

@@ -1,6 +1,15 @@
 import { DDLStatement } from "./statement.mjs";
 //#region src/migration/ddl/schema.ts
 /**
+* Create a new schema.
+*
+* @param name - The schema name.
+* @returns A {@link CreateSchemaStatement}.
+*/
+function createSchema(name) {
+	return new CreateSchemaStatement(name);
+}
+/**
 * DDL statement that creates a new PostgreSQL schema.
 *
 * Generates: `CREATE SCHEMA <name>;`
@@ -30,6 +39,15 @@ var CreateSchemaStatement = class extends DDLStatement {
 	applyToSnapshot(_snapshot) {}
 };
 /**
+* Drop a schema.
+*
+* @param name - The schema name.
+* @returns A {@link DropSchemaStatement}.
+*/
+function dropSchema(name) {
+	return new DropSchemaStatement(name);
+}
+/**
 * DDL statement that drops an existing PostgreSQL schema.
 *
 * Generates: `DROP SCHEMA <name>;`
@@ -59,4 +77,4 @@ var DropSchemaStatement = class extends DDLStatement {
 	applyToSnapshot(_snapshot) {}
 };
 //#endregion
-export { CreateSchemaStatement, DropSchemaStatement };
+export { CreateSchemaStatement, DropSchemaStatement, createSchema, dropSchema };