@nextlyhq/adapter-drizzle 0.0.2-alpha.7 → 0.0.2-alpha.71

package/dist/schema/index.cjs

@@ -1,10 +1,25 @@
-'use strict';
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 // src/schema/index.ts
-var SCHEMA_VERSION = "0.1.0";
-var SCHEMA_BUILDER_AVAILABLE = false;
-
+/**
+* Schema utilities version.
+*
+* @remarks
+* This version tracks the schema utilities module independently
+* from the main adapter package version.
+*
+* @internal
+*/
+const SCHEMA_VERSION = "0.1.0";
+/**
+* Indicates whether schema builder utilities are available.
+*
+* @remarks
+* Currently `false` - schema builder utilities will be implemented
+*
+* @internal
+*/
+const SCHEMA_BUILDER_AVAILABLE = false;
 exports.SCHEMA_BUILDER_AVAILABLE = SCHEMA_BUILDER_AVAILABLE;
 exports.SCHEMA_VERSION = SCHEMA_VERSION;
-//# sourceMappingURL=index.cjs.map
+
 //# sourceMappingURL=index.cjs.map

package/dist/schema/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/schema/index.ts"],"names":[],"mappings":";;;AAuRO,IAAM,cAAA,GAAiB;AAUvB,IAAM,wBAAA,GAA2B","file":"index.cjs","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"]}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/schema/index.ts"],"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"],"mappings":";;;;;;;;;;;AAuRA,MAAa,iBAAiB;;;;;;;;;AAU9B,MAAa,2BAA2B"}

package/dist/schema/index.d.cts

@@ -1,115 +1,4 @@
-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
- */
-
+import { a as DropTableOptions, c as TableDefinition, f as SqlParam, i as CreateTableOptions, n as AlterTableOptions, o as IndexDefinition, r as ColumnDefinition, s as TableConstraint, t as AlterTableOperation } from "../schema-Bkkr3JMC.cjs";
 /**
  * Schema utilities version.
  *
@@ -119,7 +8,7 @@ export { a as SqlParam } from '../core-CVO7WYDj.cjs';
  *
  * @internal
  */
-declare const SCHEMA_VERSION: "0.1.0";
+export declare const SCHEMA_VERSION: "0.1.0";
 /**
  * Indicates whether schema builder utilities are available.
  *
@@ -128,6 +17,6 @@ declare const SCHEMA_VERSION: "0.1.0";
  *
  * @internal
  */
-declare const SCHEMA_BUILDER_AVAILABLE: false;
-
-export { SCHEMA_BUILDER_AVAILABLE, SCHEMA_VERSION };
+export declare const SCHEMA_BUILDER_AVAILABLE: false;
+export type { AlterTableOperation, AlterTableOptions, ColumnDefinition, CreateTableOptions, DropTableOptions, IndexDefinition, SqlParam, TableConstraint, TableDefinition };
+//# sourceMappingURL=index.d.cts.map

package/dist/schema/index.d.ts

@@ -1,115 +1,4 @@
-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
- */
-
+import { a as DropTableOptions, c as TableDefinition, f as SqlParam, i as CreateTableOptions, n as AlterTableOptions, o as IndexDefinition, r as ColumnDefinition, s as TableConstraint, t as AlterTableOperation } from "../schema-Bkkr3JMC.js";
 /**
  * Schema utilities version.
  *
@@ -119,7 +8,7 @@ export { a as SqlParam } from '../core-CVO7WYDj.js';
  *
  * @internal
  */
-declare const SCHEMA_VERSION: "0.1.0";
+export declare const SCHEMA_VERSION: "0.1.0";
 /**
  * Indicates whether schema builder utilities are available.
  *
@@ -128,6 +17,6 @@ declare const SCHEMA_VERSION: "0.1.0";
  *
  * @internal
  */
-declare const SCHEMA_BUILDER_AVAILABLE: false;
-
-export { SCHEMA_BUILDER_AVAILABLE, SCHEMA_VERSION };
+export declare const SCHEMA_BUILDER_AVAILABLE: false;
+export type { AlterTableOperation, AlterTableOptions, ColumnDefinition, CreateTableOptions, DropTableOptions, IndexDefinition, SqlParam, TableConstraint, TableDefinition };
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.mjs

@@ -1,7 +1,23 @@
 // src/schema/index.ts
-var SCHEMA_VERSION = "0.1.0";
-var SCHEMA_BUILDER_AVAILABLE = false;
-
+/**
+* Schema utilities version.
+*
+* @remarks
+* This version tracks the schema utilities module independently
+* from the main adapter package version.
+*
+* @internal
+*/
+const SCHEMA_VERSION = "0.1.0";
+/**
+* Indicates whether schema builder utilities are available.
+*
+* @remarks
+* Currently `false` - schema builder utilities will be implemented
+*
+* @internal
+*/
+const SCHEMA_BUILDER_AVAILABLE = false;
 export { SCHEMA_BUILDER_AVAILABLE, SCHEMA_VERSION };
-//# sourceMappingURL=index.mjs.map
+
 //# sourceMappingURL=index.mjs.map

package/dist/schema/index.mjs.map

@@ -1 +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"]}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/schema/index.ts"],"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"],"mappings":";;;;;;;;;;AAuRA,MAAa,iBAAiB;;;;;;;;;AAU9B,MAAa,2BAA2B"}

package/dist/schema-Bkkr3JMC.d.cts

@@ -0,0 +1,264 @@
+/**
+ * Core type definitions for the Nextly database adapter system.
+ *
+ * These types are the foundation for all database operations and are designed
+ * to be database-agnostic while supporting dialect-specific features.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Supported database dialects.
+ *
+ * @remarks
+ * These are the database systems that Nextly officially supports through
+ * dedicated adapter packages.
+ *
+ * @public
+ */
+type SupportedDialect = "postgresql" | "mysql" | "sqlite";
+/**
+ * SQL parameter types that are safe to use across all database dialects.
+ *
+ * @remarks
+ * - `undefined` is included for optional parameters
+ * - `Date` objects will be converted to appropriate format per dialect
+ * - `null` represents SQL NULL
+ *
+ * @public
+ */
+type SqlParam = string | number | boolean | Date | null | undefined;
+/**
+ * JSON value types that can be stored in JSON/JSONB columns.
+ *
+ * @remarks
+ * Represents the valid JSON value types as defined by the JSON specification.
+ * This is a recursive type to support nested objects and arrays.
+ *
+ * @public
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+/**
+ * JSON object type for structured data.
+ *
+ * @remarks
+ * Useful for typed JSON column data where the structure is known.
+ *
+ * @public
+ */
+type JsonObject = {
+  [key: string]: JsonValue;
+};
+/**
+ * JSON array type.
+ *
+ * @public
+ */
+type JsonArray = JsonValue[];
+/**
+ * Interface for resolving table names to Drizzle table objects.
+ *
+ * @remarks
+ * When a TableResolver is set on the adapter via `setTableResolver()`,
+ * CRUD methods will use Drizzle's query API instead of raw SQL string building.
+ * The nextly SchemaRegistry implements this interface.
+ *
+ * @public
+ */
+interface TableResolver {
+  /** Look up a Drizzle table object by table name. Returns null if not found. */
+  getTable(tableName: string): unknown;
+}
+/**
+ * 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 { DropTableOptions as a, TableDefinition as c, JsonValue as d, SqlParam as f, CreateTableOptions as i, JsonArray as l, TableResolver as m, AlterTableOptions as n, IndexDefinition as o, SupportedDialect as p, ColumnDefinition as r, TableConstraint as s, AlterTableOperation as t, JsonObject as u };
+//# sourceMappingURL=schema-Bkkr3JMC.d.cts.map