@nextlyhq/adapter-drizzle 0.0.1

package/dist/schema/index.d.cts

@@ -0,0 +1,133 @@
+export { A as AlterTableOperation, a as AlterTableOptions, b as ColumnDefinition, C as CreateTableOptions, D as DropTableOptions, I as IndexDefinition, c as TableConstraint, T as TableDefinition } from '../schema-BDn8WfSL.cjs';
+export { a as SqlParam } from '../core-CVO7WYDj.cjs';
+
+/**
+ * Schema utilities for @nextly/adapter-drizzle
+ *
+ * @remarks
+ * This module re-exports schema-related types from the `/types` subpath
+ *
+ * ## Current Exports
+ *
+ * - **Schema Type Definitions:** {@link TableDefinition}, {@link ColumnDefinition}, {@link IndexDefinition}, {@link TableConstraint}
+ * - **Schema Operation Types:** {@link CreateTableOptions}, {@link DropTableOptions}, {@link AlterTableOptions}, {@link AlterTableOperation}
+ * - **Core Types:** {@link SqlParam}
+ *
+ * ## Coming in Phase 4
+ *
+ * - Schema builder utilities
+ * - Schema generator functions
+ * - Dialect-specific schema mapping
+ * - Unified schema definitions
+ *
+ * ## Usage Examples
+ *
+ * ### Defining a Table Schema
+ *
+ * ```typescript
+ * import type { TableDefinition } from "@nextly/adapter-drizzle/schema";
+ *
+ * const usersTable: TableDefinition = {
+ *   name: "users",
+ *   columns: [
+ *     { name: "id", type: "uuid", primaryKey: true },
+ *     { name: "email", type: "varchar(255)", unique: true },
+ *     { name: "name", type: "varchar(255)", nullable: true },
+ *     {
+ *       name: "created_at",
+ *       type: "timestamp",
+ *       default: { sql: "CURRENT_TIMESTAMP" },
+ *     },
+ *   ],
+ *   indexes: [
+ *     { name: "users_email_idx", columns: ["email"], unique: true },
+ *   ],
+ * };
+ * ```
+ *
+ * ### Creating a Table with Adapter
+ *
+ * ```typescript
+ * import type { DrizzleAdapter } from "@nextly/adapter-drizzle";
+ * import type { TableDefinition } from "@nextly/adapter-drizzle/schema";
+ *
+ * async function createUsersTable(adapter: DrizzleAdapter) {
+ *   const tableDefinition: TableDefinition = {
+ *     // ... table definition
+ *   };
+ *
+ *   await adapter.createTable(tableDefinition, { ifNotExists: true });
+ * }
+ * ```
+ *
+ * ### Altering a Table
+ *
+ * ```typescript
+ * import type {
+ *   AlterTableOperation,
+ *   ColumnDefinition,
+ * } from "@nextly/adapter-drizzle/schema";
+ *
+ * const operations: AlterTableOperation[] = [
+ *   {
+ *     kind: "add_column",
+ *     column: { name: "age", type: "int", nullable: true },
+ *   },
+ *   {
+ *     kind: "rename_column",
+ *     from: "name",
+ *     to: "full_name",
+ *   },
+ * ];
+ *
+ * await adapter.alterTable("users", operations);
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * Column definition for schema operations.
+ *
+ * @remarks
+ * Defines the structure of a database column in a database-agnostic way.
+ * Adapters translate these definitions to dialect-specific DDL.
+ *
+ * @example
+ * ```typescript
+ * const idColumn: ColumnDefinition = {
+ *   name: "id",
+ *   type: "uuid",
+ *   primaryKey: true,
+ * };
+ *
+ * const emailColumn: ColumnDefinition = {
+ *   name: "email",
+ *   type: "varchar(255)",
+ *   unique: true,
+ * };
+ * ```
+ *
+ * @public
+ */
+
+/**
+ * Schema utilities version.
+ *
+ * @remarks
+ * This version tracks the schema utilities module independently
+ * from the main adapter package version.
+ *
+ * @internal
+ */
+declare const SCHEMA_VERSION: "0.1.0";
+/**
+ * Indicates whether schema builder utilities are available.
+ *
+ * @remarks
+ * Currently `false` - schema builder utilities will be implemented
+ *
+ * @internal
+ */
+declare const SCHEMA_BUILDER_AVAILABLE: false;
+
+export { SCHEMA_BUILDER_AVAILABLE, SCHEMA_VERSION };

package/dist/schema/index.d.ts

@@ -0,0 +1,133 @@
+export { A as AlterTableOperation, a as AlterTableOptions, b as ColumnDefinition, C as CreateTableOptions, D as DropTableOptions, I as IndexDefinition, c as TableConstraint, T as TableDefinition } from '../schema-BIQ0YQZ_.js';
+export { a as SqlParam } from '../core-CVO7WYDj.js';
+
+/**
+ * Schema utilities for @nextly/adapter-drizzle
+ *
+ * @remarks
+ * This module re-exports schema-related types from the `/types` subpath
+ *
+ * ## Current Exports
+ *
+ * - **Schema Type Definitions:** {@link TableDefinition}, {@link ColumnDefinition}, {@link IndexDefinition}, {@link TableConstraint}
+ * - **Schema Operation Types:** {@link CreateTableOptions}, {@link DropTableOptions}, {@link AlterTableOptions}, {@link AlterTableOperation}
+ * - **Core Types:** {@link SqlParam}
+ *
+ * ## Coming in Phase 4
+ *
+ * - Schema builder utilities
+ * - Schema generator functions
+ * - Dialect-specific schema mapping
+ * - Unified schema definitions
+ *
+ * ## Usage Examples
+ *
+ * ### Defining a Table Schema
+ *
+ * ```typescript
+ * import type { TableDefinition } from "@nextly/adapter-drizzle/schema";
+ *
+ * const usersTable: TableDefinition = {
+ *   name: "users",
+ *   columns: [
+ *     { name: "id", type: "uuid", primaryKey: true },
+ *     { name: "email", type: "varchar(255)", unique: true },
+ *     { name: "name", type: "varchar(255)", nullable: true },
+ *     {
+ *       name: "created_at",
+ *       type: "timestamp",
+ *       default: { sql: "CURRENT_TIMESTAMP" },
+ *     },
+ *   ],
+ *   indexes: [
+ *     { name: "users_email_idx", columns: ["email"], unique: true },
+ *   ],
+ * };
+ * ```
+ *
+ * ### Creating a Table with Adapter
+ *
+ * ```typescript
+ * import type { DrizzleAdapter } from "@nextly/adapter-drizzle";
+ * import type { TableDefinition } from "@nextly/adapter-drizzle/schema";
+ *
+ * async function createUsersTable(adapter: DrizzleAdapter) {
+ *   const tableDefinition: TableDefinition = {
+ *     // ... table definition
+ *   };
+ *
+ *   await adapter.createTable(tableDefinition, { ifNotExists: true });
+ * }
+ * ```
+ *
+ * ### Altering a Table
+ *
+ * ```typescript
+ * import type {
+ *   AlterTableOperation,
+ *   ColumnDefinition,
+ * } from "@nextly/adapter-drizzle/schema";
+ *
+ * const operations: AlterTableOperation[] = [
+ *   {
+ *     kind: "add_column",
+ *     column: { name: "age", type: "int", nullable: true },
+ *   },
+ *   {
+ *     kind: "rename_column",
+ *     from: "name",
+ *     to: "full_name",
+ *   },
+ * ];
+ *
+ * await adapter.alterTable("users", operations);
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * Column definition for schema operations.
+ *
+ * @remarks
+ * Defines the structure of a database column in a database-agnostic way.
+ * Adapters translate these definitions to dialect-specific DDL.
+ *
+ * @example
+ * ```typescript
+ * const idColumn: ColumnDefinition = {
+ *   name: "id",
+ *   type: "uuid",
+ *   primaryKey: true,
+ * };
+ *
+ * const emailColumn: ColumnDefinition = {
+ *   name: "email",
+ *   type: "varchar(255)",
+ *   unique: true,
+ * };
+ * ```
+ *
+ * @public
+ */
+
+/**
+ * Schema utilities version.
+ *
+ * @remarks
+ * This version tracks the schema utilities module independently
+ * from the main adapter package version.
+ *
+ * @internal
+ */
+declare const SCHEMA_VERSION: "0.1.0";
+/**
+ * Indicates whether schema builder utilities are available.
+ *
+ * @remarks
+ * Currently `false` - schema builder utilities will be implemented
+ *
+ * @internal
+ */
+declare const SCHEMA_BUILDER_AVAILABLE: false;
+
+export { SCHEMA_BUILDER_AVAILABLE, SCHEMA_VERSION };

package/dist/schema/index.mjs

@@ -0,0 +1,7 @@
+// src/schema/index.ts
+var SCHEMA_VERSION = "0.1.0";
+var SCHEMA_BUILDER_AVAILABLE = false;
+
+export { SCHEMA_BUILDER_AVAILABLE, SCHEMA_VERSION };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/schema/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/schema/index.ts"],"names":[],"mappings":";AAuRO,IAAM,cAAA,GAAiB;AAUvB,IAAM,wBAAA,GAA2B","file":"index.mjs","sourcesContent":["/**\n * Schema utilities for @nextly/adapter-drizzle\n *\n * @remarks\n * This module re-exports schema-related types from the `/types` subpath\n *\n * ## Current Exports\n *\n * - **Schema Type Definitions:** {@link TableDefinition}, {@link ColumnDefinition}, {@link IndexDefinition}, {@link TableConstraint}\n * - **Schema Operation Types:** {@link CreateTableOptions}, {@link DropTableOptions}, {@link AlterTableOptions}, {@link AlterTableOperation}\n * - **Core Types:** {@link SqlParam}\n *\n * ## Coming in Phase 4\n *\n * - Schema builder utilities\n * - Schema generator functions\n * - Dialect-specific schema mapping\n * - Unified schema definitions\n *\n * ## Usage Examples\n *\n * ### Defining a Table Schema\n *\n * ```typescript\n * import type { TableDefinition } from \"@nextly/adapter-drizzle/schema\";\n *\n * const usersTable: TableDefinition = {\n *   name: \"users\",\n *   columns: [\n *     { name: \"id\", type: \"uuid\", primaryKey: true },\n *     { name: \"email\", type: \"varchar(255)\", unique: true },\n *     { name: \"name\", type: \"varchar(255)\", nullable: true },\n *     {\n *       name: \"created_at\",\n *       type: \"timestamp\",\n *       default: { sql: \"CURRENT_TIMESTAMP\" },\n *     },\n *   ],\n *   indexes: [\n *     { name: \"users_email_idx\", columns: [\"email\"], unique: true },\n *   ],\n * };\n * ```\n *\n * ### Creating a Table with Adapter\n *\n * ```typescript\n * import type { DrizzleAdapter } from \"@nextly/adapter-drizzle\";\n * import type { TableDefinition } from \"@nextly/adapter-drizzle/schema\";\n *\n * async function createUsersTable(adapter: DrizzleAdapter) {\n *   const tableDefinition: TableDefinition = {\n *     // ... table definition\n *   };\n *\n *   await adapter.createTable(tableDefinition, { ifNotExists: true });\n * }\n * ```\n *\n * ### Altering a Table\n *\n * ```typescript\n * import type {\n *   AlterTableOperation,\n *   ColumnDefinition,\n * } from \"@nextly/adapter-drizzle/schema\";\n *\n * const operations: AlterTableOperation[] = [\n *   {\n *     kind: \"add_column\",\n *     column: { name: \"age\", type: \"int\", nullable: true },\n *   },\n *   {\n *     kind: \"rename_column\",\n *     from: \"name\",\n *     to: \"full_name\",\n *   },\n * ];\n *\n * await adapter.alterTable(\"users\", operations);\n * ```\n *\n * @packageDocumentation\n */\n\n// ============================================================\n// Schema Type Re-exports\n// ============================================================\n\n/**\n * Column definition for schema operations.\n *\n * @remarks\n * Defines the structure of a database column in a database-agnostic way.\n * Adapters translate these definitions to dialect-specific DDL.\n *\n * @example\n * ```typescript\n * const idColumn: ColumnDefinition = {\n *   name: \"id\",\n *   type: \"uuid\",\n *   primaryKey: true,\n * };\n *\n * const emailColumn: ColumnDefinition = {\n *   name: \"email\",\n *   type: \"varchar(255)\",\n *   unique: true,\n * };\n * ```\n *\n * @public\n */\nexport type { ColumnDefinition } from \"../types/schema\";\n\n/**\n * Index definition for schema operations.\n *\n * @remarks\n * Defines database indexes for performance optimization.\n *\n * @example\n * ```typescript\n * const emailIndex: IndexDefinition = {\n *   name: \"users_email_idx\",\n *   columns: [\"email\"],\n *   unique: true,\n * };\n * ```\n *\n * @public\n */\nexport type { IndexDefinition } from \"../types/schema\";\n\n/**\n * Table constraint definition.\n *\n * @example\n * ```typescript\n * const checkConstraint: TableConstraint = {\n *   name: \"check_age_positive\",\n *   type: \"check\",\n *   expression: \"age >= 0\",\n * };\n * ```\n *\n * @public\n */\nexport type { TableConstraint } from \"../types/schema\";\n\n/**\n * Complete table definition.\n *\n * @remarks\n * Defines the complete structure of a database table including columns,\n * indexes, and constraints.\n *\n * @example\n * ```typescript\n * const postsTable: TableDefinition = {\n *   name: \"posts\",\n *   columns: [\n *     { name: \"id\", type: \"uuid\", primaryKey: true },\n *     { name: \"title\", type: \"varchar(255)\" },\n *     { name: \"content\", type: \"text\" },\n *     { name: \"published\", type: \"boolean\", default: false },\n *   ],\n *   indexes: [\n *     { name: \"posts_title_idx\", columns: [\"title\"] },\n *   ],\n * };\n * ```\n *\n * @public\n */\nexport type { TableDefinition } from \"../types/schema\";\n\n/**\n * Options for table creation.\n *\n * @example\n * ```typescript\n * const options: CreateTableOptions = {\n *   ifNotExists: true,\n *   temporary: false,\n * };\n *\n * await adapter.createTable(tableDefinition, options);\n * ```\n *\n * @public\n */\nexport type { CreateTableOptions } from \"../types/schema\";\n\n/**\n * Options for table dropping.\n *\n * @example\n * ```typescript\n * const options: DropTableOptions = {\n *   ifExists: true,\n *   cascade: true,\n * };\n *\n * await adapter.dropTable(\"old_table\", options);\n * ```\n *\n * @public\n */\nexport type { DropTableOptions } from \"../types/schema\";\n\n/**\n * Options for table alteration.\n *\n * @public\n */\nexport type { AlterTableOptions } from \"../types/schema\";\n\n/**\n * Table alteration operations.\n *\n * @remarks\n * Defines the types of operations that can be performed when altering a table.\n *\n * @example\n * ```typescript\n * const operations: AlterTableOperation[] = [\n *   {\n *     kind: \"add_column\",\n *     column: { name: \"status\", type: \"varchar(20)\", default: \"draft\" },\n *   },\n *   {\n *     kind: \"drop_column\",\n *     columnName: \"old_field\",\n *   },\n *   {\n *     kind: \"add_constraint\",\n *     constraint: {\n *       name: \"check_status\",\n *       type: \"check\",\n *       expression: \"status IN ('draft', 'published')\",\n *     },\n *   },\n * ];\n *\n * await adapter.alterTable(\"posts\", operations);\n * ```\n *\n * @public\n */\nexport type { AlterTableOperation } from \"../types/schema\";\n\n// ============================================================\n// Core Type Re-exports\n// ============================================================\n\n/**\n * SQL parameter type (for use in column defaults, etc.).\n *\n * @remarks\n * Represents values that can be safely passed as SQL parameters.\n *\n * @public\n */\nexport type { SqlParam } from \"../types/core\";\n\n// ============================================================\n// Module Metadata\n// ============================================================\n\n/**\n * Schema utilities version.\n *\n * @remarks\n * This version tracks the schema utilities module independently\n * from the main adapter package version.\n *\n * @internal\n */\nexport const SCHEMA_VERSION = \"0.1.0\" as const;\n\n/**\n * Indicates whether schema builder utilities are available.\n *\n * @remarks\n * Currently `false` - schema builder utilities will be implemented\n *\n * @internal\n */\nexport const SCHEMA_BUILDER_AVAILABLE = false as const;\n"]}

package/dist/schema-BDn8WfSL.d.cts

@@ -0,0 +1,200 @@
+import { a as SqlParam } from './core-CVO7WYDj.cjs';
+
+/**
+ * Database schema type definitions.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Column definition for schema operations.
+ *
+ * @remarks
+ * Defines the structure of a database column in a database-agnostic way.
+ * Adapters translate these definitions to dialect-specific DDL.
+ *
+ * @public
+ */
+interface ColumnDefinition {
+    /** Column name */
+    name: string;
+    /**
+     * Column data type.
+     *
+     * @remarks
+     * Common types across databases:
+     * - Text: varchar(n), text, char(n)
+     * - Numbers: int, bigint, decimal, numeric
+     * - Boolean: boolean
+     * - Date/Time: timestamp, date, time
+     * - JSON: json, jsonb (PostgreSQL)
+     * - UUID: uuid (PostgreSQL), char(36) (MySQL/SQLite)
+     *
+     * Adapters handle dialect-specific type mapping.
+     */
+    type: string;
+    /** Allow NULL values (default: true) */
+    nullable?: boolean;
+    /** Primary key column */
+    primaryKey?: boolean;
+    /** Unique constraint */
+    unique?: boolean;
+    /** Default value (literal or SQL expression) */
+    default?: SqlParam | {
+        sql: string;
+    };
+    /** Foreign key reference */
+    references?: {
+        /** Referenced table name */
+        table: string;
+        /** Referenced column name */
+        column: string;
+        /** Action on DELETE */
+        onDelete?: "no action" | "restrict" | "cascade" | "set null" | "set default";
+        /** Action on UPDATE */
+        onUpdate?: "no action" | "restrict" | "cascade" | "set null" | "set default";
+    };
+    /** Check constraint expression */
+    check?: string;
+    /** Generated column definition (computed column) */
+    generated?: {
+        /** SQL expression to generate the value */
+        as: string;
+        /** Store the value (true) or compute on-the-fly (false) */
+        stored?: boolean;
+    };
+}
+/**
+ * Index definition for schema operations.
+ *
+ * @remarks
+ * Defines database indexes for performance optimization.
+ *
+ * @public
+ */
+interface IndexDefinition {
+    /** Index name */
+    name: string;
+    /** Columns included in the index */
+    columns: string[];
+    /** Unique index (enforces uniqueness) */
+    unique?: boolean;
+    /** Partial index condition (WHERE clause) */
+    where?: string;
+    /** Index type (database-specific) */
+    using?: "btree" | "hash" | "gin" | "gist" | "brin";
+}
+/**
+ * Table constraint definition.
+ *
+ * @public
+ */
+interface TableConstraint {
+    /** Constraint name */
+    name: string;
+    /** Constraint type */
+    type: "unique" | "check" | "foreign_key" | "primary_key";
+    /** Columns involved in the constraint */
+    columns?: string[];
+    /** Check constraint expression */
+    expression?: string;
+    /** Foreign key reference (for foreign_key type) */
+    references?: {
+        /** Referenced table name */
+        table: string;
+        /** Referenced columns */
+        columns: string[];
+        /** Action on DELETE */
+        onDelete?: "no action" | "restrict" | "cascade" | "set null" | "set default";
+        /** Action on UPDATE */
+        onUpdate?: "no action" | "restrict" | "cascade" | "set null" | "set default";
+    };
+}
+/**
+ * Complete table definition.
+ *
+ * @remarks
+ * Defines the complete structure of a database table including columns,
+ * indexes, and constraints.
+ *
+ * @public
+ */
+interface TableDefinition {
+    /** Table name */
+    name: string;
+    /** Column definitions */
+    columns: ColumnDefinition[];
+    /** Composite primary key (if not defined at column level) */
+    primaryKey?: string[];
+    /** Index definitions */
+    indexes?: IndexDefinition[];
+    /** Table-level constraints */
+    constraints?: TableConstraint[];
+    /** Table comment/description */
+    comment?: string;
+}
+/**
+ * Options for table creation.
+ *
+ * @public
+ */
+interface CreateTableOptions {
+    /** Don't throw error if table exists */
+    ifNotExists?: boolean;
+    /** Temporary table (session-scoped) */
+    temporary?: boolean;
+}
+/**
+ * Options for table dropping.
+ *
+ * @public
+ */
+interface DropTableOptions {
+    /** Don't throw error if table doesn't exist */
+    ifExists?: boolean;
+    /** Drop dependent objects (CASCADE) */
+    cascade?: boolean;
+    /** Restrict drop if dependencies exist (default) */
+    restrict?: boolean;
+}
+/**
+ * Options for table alteration.
+ *
+ * @public
+ */
+interface AlterTableOptions {
+    /** Validation mode for constraints */
+    validate?: boolean;
+}
+/**
+ * Table alteration operations.
+ *
+ * @remarks
+ * Defines the types of operations that can be performed when altering a table.
+ *
+ * @public
+ */
+type AlterTableOperation = {
+    kind: "add_column";
+    column: ColumnDefinition;
+} | {
+    kind: "drop_column";
+    columnName: string;
+    cascade?: boolean;
+} | {
+    kind: "rename_column";
+    from: string;
+    to: string;
+} | {
+    kind: "modify_column";
+    column: ColumnDefinition;
+} | {
+    kind: "add_constraint";
+    constraint: TableConstraint;
+} | {
+    kind: "drop_constraint";
+    constraintName: string;
+    cascade?: boolean;
+};
+
+export type { AlterTableOperation as A, CreateTableOptions as C, DropTableOptions as D, IndexDefinition as I, TableDefinition as T, AlterTableOptions as a, ColumnDefinition as b, TableConstraint as c };

package/dist/schema-BIQ0YQZ_.d.ts

@@ -0,0 +1,200 @@
+import { a as SqlParam } from './core-CVO7WYDj.js';
+
+/**
+ * Database schema type definitions.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Column definition for schema operations.
+ *
+ * @remarks
+ * Defines the structure of a database column in a database-agnostic way.
+ * Adapters translate these definitions to dialect-specific DDL.
+ *
+ * @public
+ */
+interface ColumnDefinition {
+    /** Column name */
+    name: string;
+    /**
+     * Column data type.
+     *
+     * @remarks
+     * Common types across databases:
+     * - Text: varchar(n), text, char(n)
+     * - Numbers: int, bigint, decimal, numeric
+     * - Boolean: boolean
+     * - Date/Time: timestamp, date, time
+     * - JSON: json, jsonb (PostgreSQL)
+     * - UUID: uuid (PostgreSQL), char(36) (MySQL/SQLite)
+     *
+     * Adapters handle dialect-specific type mapping.
+     */
+    type: string;
+    /** Allow NULL values (default: true) */
+    nullable?: boolean;
+    /** Primary key column */
+    primaryKey?: boolean;
+    /** Unique constraint */
+    unique?: boolean;
+    /** Default value (literal or SQL expression) */
+    default?: SqlParam | {
+        sql: string;
+    };
+    /** Foreign key reference */
+    references?: {
+        /** Referenced table name */
+        table: string;
+        /** Referenced column name */
+        column: string;
+        /** Action on DELETE */
+        onDelete?: "no action" | "restrict" | "cascade" | "set null" | "set default";
+        /** Action on UPDATE */
+        onUpdate?: "no action" | "restrict" | "cascade" | "set null" | "set default";
+    };
+    /** Check constraint expression */
+    check?: string;
+    /** Generated column definition (computed column) */
+    generated?: {
+        /** SQL expression to generate the value */
+        as: string;
+        /** Store the value (true) or compute on-the-fly (false) */
+        stored?: boolean;
+    };
+}
+/**
+ * Index definition for schema operations.
+ *
+ * @remarks
+ * Defines database indexes for performance optimization.
+ *
+ * @public
+ */
+interface IndexDefinition {
+    /** Index name */
+    name: string;
+    /** Columns included in the index */
+    columns: string[];
+    /** Unique index (enforces uniqueness) */
+    unique?: boolean;
+    /** Partial index condition (WHERE clause) */
+    where?: string;
+    /** Index type (database-specific) */
+    using?: "btree" | "hash" | "gin" | "gist" | "brin";
+}
+/**
+ * Table constraint definition.
+ *
+ * @public
+ */
+interface TableConstraint {
+    /** Constraint name */
+    name: string;
+    /** Constraint type */
+    type: "unique" | "check" | "foreign_key" | "primary_key";
+    /** Columns involved in the constraint */
+    columns?: string[];
+    /** Check constraint expression */
+    expression?: string;
+    /** Foreign key reference (for foreign_key type) */
+    references?: {
+        /** Referenced table name */
+        table: string;
+        /** Referenced columns */
+        columns: string[];
+        /** Action on DELETE */
+        onDelete?: "no action" | "restrict" | "cascade" | "set null" | "set default";
+        /** Action on UPDATE */
+        onUpdate?: "no action" | "restrict" | "cascade" | "set null" | "set default";
+    };
+}
+/**
+ * Complete table definition.
+ *
+ * @remarks
+ * Defines the complete structure of a database table including columns,
+ * indexes, and constraints.
+ *
+ * @public
+ */
+interface TableDefinition {
+    /** Table name */
+    name: string;
+    /** Column definitions */
+    columns: ColumnDefinition[];
+    /** Composite primary key (if not defined at column level) */
+    primaryKey?: string[];
+    /** Index definitions */
+    indexes?: IndexDefinition[];
+    /** Table-level constraints */
+    constraints?: TableConstraint[];
+    /** Table comment/description */
+    comment?: string;
+}
+/**
+ * Options for table creation.
+ *
+ * @public
+ */
+interface CreateTableOptions {
+    /** Don't throw error if table exists */
+    ifNotExists?: boolean;
+    /** Temporary table (session-scoped) */
+    temporary?: boolean;
+}
+/**
+ * Options for table dropping.
+ *
+ * @public
+ */
+interface DropTableOptions {
+    /** Don't throw error if table doesn't exist */
+    ifExists?: boolean;
+    /** Drop dependent objects (CASCADE) */
+    cascade?: boolean;
+    /** Restrict drop if dependencies exist (default) */
+    restrict?: boolean;
+}
+/**
+ * Options for table alteration.
+ *
+ * @public
+ */
+interface AlterTableOptions {
+    /** Validation mode for constraints */
+    validate?: boolean;
+}
+/**
+ * Table alteration operations.
+ *
+ * @remarks
+ * Defines the types of operations that can be performed when altering a table.
+ *
+ * @public
+ */
+type AlterTableOperation = {
+    kind: "add_column";
+    column: ColumnDefinition;
+} | {
+    kind: "drop_column";
+    columnName: string;
+    cascade?: boolean;
+} | {
+    kind: "rename_column";
+    from: string;
+    to: string;
+} | {
+    kind: "modify_column";
+    column: ColumnDefinition;
+} | {
+    kind: "add_constraint";
+    constraint: TableConstraint;
+} | {
+    kind: "drop_constraint";
+    constraintName: string;
+    cascade?: boolean;
+};
+
+export type { AlterTableOperation as A, CreateTableOptions as C, DropTableOptions as D, IndexDefinition as I, TableDefinition as T, AlterTableOptions as a, ColumnDefinition as b, TableConstraint as c };