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

package/dist/schema-BDn8WfSL.d.cts

@@ -1,200 +0,0 @@
-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

@@ -1,200 +0,0 @@
-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 };

package/dist/types/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/types/error.ts"],"names":[],"mappings":";;;AAuFO,SAAS,gBAAgB,KAAA,EAAwC;AACtE,EAAA,OACE,OAAO,UAAU,QAAA,IACjB,KAAA,KAAU,QACV,MAAA,IAAU,KAAA,IACV,OAAQ,KAAA,CAAwB,IAAA,KAAS,QAAA;AAE7C;AA+CO,SAAS,oBACd,OAAA,EACe;AACf,EAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA;AACvC,EAAA,KAAA,CAAM,IAAA,GAAO,eAAA;AACb,EAAA,KAAA,CAAM,OAAO,OAAA,CAAQ,IAAA;AAErB,EAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,MAAA,EAAW,KAAA,CAAM,OAAO,OAAA,CAAQ,IAAA;AACrD,EAAA,IAAI,OAAA,CAAQ,UAAA,KAAe,MAAA,EAAW,KAAA,CAAM,aAAa,OAAA,CAAQ,UAAA;AACjE,EAAA,IAAI,OAAA,CAAQ,KAAA,KAAU,MAAA,EAAW,KAAA,CAAM,QAAQ,OAAA,CAAQ,KAAA;AACvD,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,MAAA,EAAW,KAAA,CAAM,SAAS,OAAA,CAAQ,MAAA;AACzD,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,MAAA,EAAW,KAAA,CAAM,SAAS,OAAA,CAAQ,MAAA;AACzD,EAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,MAAA,EAAW,KAAA,CAAM,OAAO,OAAA,CAAQ,IAAA;AACrD,EAAA,IAAI,OAAA,CAAQ,KAAA,KAAU,MAAA,EAAW,KAAA,CAAM,QAAQ,OAAA,CAAQ,KAAA;AAEvD,EAAA,OAAO,KAAA;AACT","file":"index.cjs","sourcesContent":["/**\n * Database error type definitions.\n *\n * @packageDocumentation\n */\n\n/**\n * Database error classification.\n *\n * @remarks\n * Categorizes database errors for consistent error handling across adapters.\n * Each adapter translates database-specific error codes to these kinds.\n *\n * @public\n */\nexport type DatabaseErrorKind =\n  | \"connection\" // Connection/network errors\n  | \"query\" // Syntax or execution errors\n  | \"constraint\" // Generic constraint violation\n  | \"unique_violation\" // Unique constraint violation\n  | \"foreign_key_violation\" // Foreign key constraint violation\n  | \"check_violation\" // Check constraint violation\n  | \"not_null_violation\" // NOT NULL constraint violation\n  | \"deadlock\" // Transaction deadlock\n  | \"timeout\" // Query or connection timeout\n  | \"serialization_failure\" // Serializable transaction conflict\n  | \"unsupported_version\" // F17: DB version below minimum or unparseable at connect\n  | \"unknown\"; // Unclassified error\n\n/**\n * Enhanced database error interface.\n *\n * @remarks\n * Extends the standard Error interface with database-specific context.\n * Adapters should throw errors implementing this interface for consistent\n * error handling.\n *\n * @example\n * ```typescript\n * try {\n *   await adapter.insert('users', { email: 'duplicate@example.com' });\n * } catch (error) {\n *   if (isDatabaseError(error) && error.kind === 'unique_violation') {\n *     console.log(`Duplicate ${error.column} in ${error.table}`);\n *   }\n * }\n * ```\n *\n * @public\n */\nexport interface DatabaseError extends Error {\n  /** Error classification */\n  kind: DatabaseErrorKind;\n\n  /** Database-specific error code (e.g., \"23505\" for PostgreSQL unique violation) */\n  code?: string;\n\n  /** Constraint name that was violated (if applicable) */\n  constraint?: string;\n\n  /** Table name involved in the error */\n  table?: string;\n\n  /** Column name involved in the error */\n  column?: string;\n\n  /** Detailed error description from the database */\n  detail?: string;\n\n  /** Hint for resolving the error */\n  hint?: string;\n\n  /** Original error from the database driver */\n  cause?: Error;\n}\n\n/**\n * Type guard for DatabaseError.\n *\n * @remarks\n * Checks if an error is a DatabaseError with proper typing.\n *\n * @param error - Error to check\n * @returns True if error is a DatabaseError\n *\n * @public\n */\nexport function isDatabaseError(error: unknown): error is DatabaseError {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"kind\" in error &&\n    typeof (error as DatabaseError).kind === \"string\"\n  );\n}\n\n/**\n * Database error constructor options.\n *\n * @public\n */\nexport interface DatabaseErrorOptions {\n  /** Error classification */\n  kind: DatabaseErrorKind;\n\n  /** Error message */\n  message: string;\n\n  /** Database-specific error code */\n  code?: string;\n\n  /** Constraint name */\n  constraint?: string;\n\n  /** Table name */\n  table?: string;\n\n  /** Column name */\n  column?: string;\n\n  /** Detailed description */\n  detail?: string;\n\n  /** Resolution hint */\n  hint?: string;\n\n  /** Original error */\n  cause?: Error;\n}\n\n/**\n * Create a DatabaseError instance.\n *\n * @remarks\n * Helper function to create properly structured DatabaseError objects.\n *\n * @param options - Error options\n * @returns DatabaseError instance\n *\n * @public\n */\nexport function createDatabaseError(\n  options: DatabaseErrorOptions\n): DatabaseError {\n  const error = new Error(options.message) as DatabaseError;\n  error.name = \"DatabaseError\";\n  error.kind = options.kind;\n\n  if (options.code !== undefined) error.code = options.code;\n  if (options.constraint !== undefined) error.constraint = options.constraint;\n  if (options.table !== undefined) error.table = options.table;\n  if (options.column !== undefined) error.column = options.column;\n  if (options.detail !== undefined) error.detail = options.detail;\n  if (options.hint !== undefined) error.hint = options.hint;\n  if (options.cause !== undefined) error.cause = options.cause;\n\n  return error;\n}\n"]}

package/dist/types/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/types/error.ts"],"names":[],"mappings":";AAuFO,SAAS,gBAAgB,KAAA,EAAwC;AACtE,EAAA,OACE,OAAO,UAAU,QAAA,IACjB,KAAA,KAAU,QACV,MAAA,IAAU,KAAA,IACV,OAAQ,KAAA,CAAwB,IAAA,KAAS,QAAA;AAE7C;AA+CO,SAAS,oBACd,OAAA,EACe;AACf,EAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA;AACvC,EAAA,KAAA,CAAM,IAAA,GAAO,eAAA;AACb,EAAA,KAAA,CAAM,OAAO,OAAA,CAAQ,IAAA;AAErB,EAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,MAAA,EAAW,KAAA,CAAM,OAAO,OAAA,CAAQ,IAAA;AACrD,EAAA,IAAI,OAAA,CAAQ,UAAA,KAAe,MAAA,EAAW,KAAA,CAAM,aAAa,OAAA,CAAQ,UAAA;AACjE,EAAA,IAAI,OAAA,CAAQ,KAAA,KAAU,MAAA,EAAW,KAAA,CAAM,QAAQ,OAAA,CAAQ,KAAA;AACvD,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,MAAA,EAAW,KAAA,CAAM,SAAS,OAAA,CAAQ,MAAA;AACzD,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,MAAA,EAAW,KAAA,CAAM,SAAS,OAAA,CAAQ,MAAA;AACzD,EAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,MAAA,EAAW,KAAA,CAAM,OAAO,OAAA,CAAQ,IAAA;AACrD,EAAA,IAAI,OAAA,CAAQ,KAAA,KAAU,MAAA,EAAW,KAAA,CAAM,QAAQ,OAAA,CAAQ,KAAA;AAEvD,EAAA,OAAO,KAAA;AACT","file":"index.mjs","sourcesContent":["/**\n * Database error type definitions.\n *\n * @packageDocumentation\n */\n\n/**\n * Database error classification.\n *\n * @remarks\n * Categorizes database errors for consistent error handling across adapters.\n * Each adapter translates database-specific error codes to these kinds.\n *\n * @public\n */\nexport type DatabaseErrorKind =\n  | \"connection\" // Connection/network errors\n  | \"query\" // Syntax or execution errors\n  | \"constraint\" // Generic constraint violation\n  | \"unique_violation\" // Unique constraint violation\n  | \"foreign_key_violation\" // Foreign key constraint violation\n  | \"check_violation\" // Check constraint violation\n  | \"not_null_violation\" // NOT NULL constraint violation\n  | \"deadlock\" // Transaction deadlock\n  | \"timeout\" // Query or connection timeout\n  | \"serialization_failure\" // Serializable transaction conflict\n  | \"unsupported_version\" // F17: DB version below minimum or unparseable at connect\n  | \"unknown\"; // Unclassified error\n\n/**\n * Enhanced database error interface.\n *\n * @remarks\n * Extends the standard Error interface with database-specific context.\n * Adapters should throw errors implementing this interface for consistent\n * error handling.\n *\n * @example\n * ```typescript\n * try {\n *   await adapter.insert('users', { email: 'duplicate@example.com' });\n * } catch (error) {\n *   if (isDatabaseError(error) && error.kind === 'unique_violation') {\n *     console.log(`Duplicate ${error.column} in ${error.table}`);\n *   }\n * }\n * ```\n *\n * @public\n */\nexport interface DatabaseError extends Error {\n  /** Error classification */\n  kind: DatabaseErrorKind;\n\n  /** Database-specific error code (e.g., \"23505\" for PostgreSQL unique violation) */\n  code?: string;\n\n  /** Constraint name that was violated (if applicable) */\n  constraint?: string;\n\n  /** Table name involved in the error */\n  table?: string;\n\n  /** Column name involved in the error */\n  column?: string;\n\n  /** Detailed error description from the database */\n  detail?: string;\n\n  /** Hint for resolving the error */\n  hint?: string;\n\n  /** Original error from the database driver */\n  cause?: Error;\n}\n\n/**\n * Type guard for DatabaseError.\n *\n * @remarks\n * Checks if an error is a DatabaseError with proper typing.\n *\n * @param error - Error to check\n * @returns True if error is a DatabaseError\n *\n * @public\n */\nexport function isDatabaseError(error: unknown): error is DatabaseError {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"kind\" in error &&\n    typeof (error as DatabaseError).kind === \"string\"\n  );\n}\n\n/**\n * Database error constructor options.\n *\n * @public\n */\nexport interface DatabaseErrorOptions {\n  /** Error classification */\n  kind: DatabaseErrorKind;\n\n  /** Error message */\n  message: string;\n\n  /** Database-specific error code */\n  code?: string;\n\n  /** Constraint name */\n  constraint?: string;\n\n  /** Table name */\n  table?: string;\n\n  /** Column name */\n  column?: string;\n\n  /** Detailed description */\n  detail?: string;\n\n  /** Resolution hint */\n  hint?: string;\n\n  /** Original error */\n  cause?: Error;\n}\n\n/**\n * Create a DatabaseError instance.\n *\n * @remarks\n * Helper function to create properly structured DatabaseError objects.\n *\n * @param options - Error options\n * @returns DatabaseError instance\n *\n * @public\n */\nexport function createDatabaseError(\n  options: DatabaseErrorOptions\n): DatabaseError {\n  const error = new Error(options.message) as DatabaseError;\n  error.name = \"DatabaseError\";\n  error.kind = options.kind;\n\n  if (options.code !== undefined) error.code = options.code;\n  if (options.constraint !== undefined) error.constraint = options.constraint;\n  if (options.table !== undefined) error.table = options.table;\n  if (options.column !== undefined) error.column = options.column;\n  if (options.detail !== undefined) error.detail = options.detail;\n  if (options.hint !== undefined) error.hint = options.hint;\n  if (options.cause !== undefined) error.cause = options.cause;\n\n  return error;\n}\n"]}