@nextlyhq/adapter-drizzle 0.0.1

package/dist/types/index.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+// src/types/error.ts
+function isDatabaseError(error) {
+  return typeof error === "object" && error !== null && "kind" in error && typeof error.kind === "string";
+}
+function createDatabaseError(options) {
+  const error = new Error(options.message);
+  error.name = "DatabaseError";
+  error.kind = options.kind;
+  if (options.code !== void 0) error.code = options.code;
+  if (options.constraint !== void 0) error.constraint = options.constraint;
+  if (options.table !== void 0) error.table = options.table;
+  if (options.column !== void 0) error.column = options.column;
+  if (options.detail !== void 0) error.detail = options.detail;
+  if (options.hint !== void 0) error.hint = options.hint;
+  if (options.cause !== void 0) error.cause = options.cause;
+  return error;
+}
+
+exports.createDatabaseError = createDatabaseError;
+exports.isDatabaseError = isDatabaseError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -0,0 +1 @@
+{"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.d.cts

@@ -0,0 +1,210 @@
+import { a as SqlParam } from '../core-CVO7WYDj.cjs';
+export { J as JsonArray, b as JsonObject, c as JsonValue, S as SupportedDialect, T as TableResolver } from '../core-CVO7WYDj.cjs';
+export { D as DatabaseCapabilities, f as DeleteOptions, I as InsertOptions, J as JoinSpec, a as Migration, c as MigrationOptions, M as MigrationRecord, d as MigrationResult, b as MigrationStatus, O as OrderBySpec, P as PoolStats, S as SelectOptions, T as TransactionContext, h as TransactionIsolationLevel, e as TransactionOptions, U as UpdateOptions, g as UpsertOptions, W as WhereClause, i as WhereCondition, j as WhereOperator } from '../migration-BbO5meEV.cjs';
+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 DatabaseError, D as DatabaseErrorKind, b as DatabaseErrorOptions, c as createDatabaseError, i as isDatabaseError } from '../error-um1d_3Uo.cjs';
+
+/**
+ * Database adapter configuration type definitions.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Logger interface for adapter operations.
+ *
+ * @remarks
+ * Adapters use this interface to log queries, errors, and performance metrics.
+ *
+ * @public
+ */
+interface AdapterLogger {
+    /**
+     * Log a query execution.
+     *
+     * @param sql - SQL statement
+     * @param params - Query parameters
+     * @param durationMs - Query execution time in milliseconds
+     */
+    query?: (sql: string, params?: SqlParam[], durationMs?: number) => void;
+    /**
+     * Log an error.
+     *
+     * @param error - Error object
+     * @param context - Additional context about the error
+     */
+    error?: (error: Error, context?: Record<string, unknown>) => void;
+    /**
+     * Log a debug message.
+     *
+     * @param message - Debug message
+     * @param context - Additional context
+     */
+    debug?: (message: string, context?: Record<string, unknown>) => void;
+    /**
+     * Log a warning.
+     *
+     * @param message - Warning message
+     * @param context - Additional context
+     */
+    warn?: (message: string, context?: Record<string, unknown>) => void;
+    /**
+     * Log an info message.
+     *
+     * @param message - Info message
+     * @param context - Additional context
+     */
+    info?: (message: string, context?: Record<string, unknown>) => void;
+}
+/**
+ * Connection pool configuration.
+ *
+ * @remarks
+ * Controls connection pooling behavior. SQLite adapters ignore these
+ * settings as SQLite uses a single connection.
+ *
+ * @public
+ */
+interface PoolConfig {
+    /** Minimum number of connections in the pool */
+    min?: number;
+    /** Maximum number of connections in the pool */
+    max?: number;
+    /** Time (ms) before an idle connection is closed */
+    idleTimeoutMs?: number;
+    /** Time (ms) to wait for a connection before timing out */
+    connectionTimeoutMs?: number;
+    /** Time (ms) before considering an unused connection stale */
+    maxLifetimeMs?: number;
+}
+/**
+ * SSL/TLS configuration for database connections.
+ *
+ * @remarks
+ * Relevant for PostgreSQL and MySQL. SQLite doesn't use network connections.
+ *
+ * @public
+ */
+interface SslConfig {
+    /** Reject unauthorized certificates (default: true for production) */
+    rejectUnauthorized?: boolean;
+    /** Path to CA certificate file */
+    ca?: string;
+    /** Path to client certificate file */
+    cert?: string;
+    /** Path to client private key file */
+    key?: string;
+}
+/**
+ * Base adapter configuration.
+ *
+ * @remarks
+ * Common configuration options for all database adapters. Dialect-specific
+ * adapters may extend this interface with additional options.
+ *
+ * @public
+ */
+interface BaseAdapterConfig {
+    /**
+     * Database connection URL.
+     *
+     * @remarks
+     * Examples:
+     * - PostgreSQL: `postgres://user:pass@localhost:5432/dbname`
+     * - MySQL: `mysql://user:pass@localhost:3306/dbname`
+     * - SQLite: `file:./data/app.db` or `file::memory:`
+     */
+    url?: string;
+    /** Database host (alternative to URL) */
+    host?: string;
+    /** Database port (alternative to URL) */
+    port?: number;
+    /** Database name (alternative to URL) */
+    database?: string;
+    /** Database user (alternative to URL) */
+    user?: string;
+    /** Database password (alternative to URL) */
+    password?: string;
+    /** Connection pool configuration */
+    pool?: PoolConfig;
+    /** Logger instance for queries and errors */
+    logger?: AdapterLogger;
+    /** Schema name (PostgreSQL) */
+    schema?: string;
+    /** SSL/TLS configuration */
+    ssl?: SslConfig | boolean;
+    /**
+     * Default query timeout in milliseconds.
+     *
+     * @remarks
+     * Queries exceeding this limit will be aborted and throw a DatabaseError
+     * with kind 'timeout'. This prevents runaway queries from blocking the
+     * system indefinitely.
+     *
+     * Can be overridden per-transaction via TransactionOptions.timeoutMs.
+     *
+     * Set to 0 or undefined to disable timeout (not recommended for production).
+     *
+     * @default 15000 (15 seconds)
+     *
+     * @example
+     * ```typescript
+     * const adapter = createPostgresAdapter({
+     *   url: 'postgres://localhost/mydb',
+     *   queryTimeoutMs: 30000, // 30 seconds
+     * });
+     * ```
+     */
+    queryTimeoutMs?: number;
+    /** Additional connection options (driver-specific) */
+    options?: Record<string, unknown>;
+}
+/**
+ * PostgreSQL-specific adapter configuration.
+ *
+ * @public
+ */
+interface PostgresAdapterConfig extends BaseAdapterConfig {
+    /** Application name for connection tracking */
+    applicationName?: string;
+    /** Statement timeout in milliseconds */
+    statementTimeout?: number;
+    /** Query timeout in milliseconds */
+    queryTimeout?: number;
+    /** Enable prepared statements (default: true) */
+    preparedStatements?: boolean;
+}
+/**
+ * MySQL-specific adapter configuration.
+ *
+ * @public
+ */
+interface MySqlAdapterConfig extends BaseAdapterConfig {
+    /** Character set (default: utf8mb4) */
+    charset?: string;
+    /** Timezone (default: 'local') */
+    timezone?: string;
+    /** Enable multiple statements per query (default: false, security risk) */
+    multipleStatements?: boolean;
+    /** Date strings instead of Date objects (default: false) */
+    dateStrings?: boolean;
+}
+/**
+ * SQLite-specific adapter configuration.
+ *
+ * @public
+ */
+interface SqliteAdapterConfig extends BaseAdapterConfig {
+    /** Enable WAL mode (default: true) */
+    wal?: boolean;
+    /** Busy timeout in milliseconds (default: 5000) */
+    busyTimeout?: number;
+    /** Enable foreign keys (default: true) */
+    foreignKeys?: boolean;
+    /** Memory-only database (overrides url) */
+    memory?: boolean;
+    /** Read-only mode (default: false) */
+    readonly?: boolean;
+}
+
+export { type AdapterLogger, type BaseAdapterConfig, type MySqlAdapterConfig, type PoolConfig, type PostgresAdapterConfig, SqlParam, type SqliteAdapterConfig, type SslConfig };

package/dist/types/index.d.ts

@@ -0,0 +1,210 @@
+import { a as SqlParam } from '../core-CVO7WYDj.js';
+export { J as JsonArray, b as JsonObject, c as JsonValue, S as SupportedDialect, T as TableResolver } from '../core-CVO7WYDj.js';
+export { D as DatabaseCapabilities, f as DeleteOptions, I as InsertOptions, J as JoinSpec, a as Migration, c as MigrationOptions, M as MigrationRecord, d as MigrationResult, b as MigrationStatus, O as OrderBySpec, P as PoolStats, S as SelectOptions, T as TransactionContext, h as TransactionIsolationLevel, e as TransactionOptions, U as UpdateOptions, g as UpsertOptions, W as WhereClause, i as WhereCondition, j as WhereOperator } from '../migration-Qe70wDOC.js';
+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 DatabaseError, D as DatabaseErrorKind, b as DatabaseErrorOptions, c as createDatabaseError, i as isDatabaseError } from '../error-um1d_3Uo.js';
+
+/**
+ * Database adapter configuration type definitions.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Logger interface for adapter operations.
+ *
+ * @remarks
+ * Adapters use this interface to log queries, errors, and performance metrics.
+ *
+ * @public
+ */
+interface AdapterLogger {
+    /**
+     * Log a query execution.
+     *
+     * @param sql - SQL statement
+     * @param params - Query parameters
+     * @param durationMs - Query execution time in milliseconds
+     */
+    query?: (sql: string, params?: SqlParam[], durationMs?: number) => void;
+    /**
+     * Log an error.
+     *
+     * @param error - Error object
+     * @param context - Additional context about the error
+     */
+    error?: (error: Error, context?: Record<string, unknown>) => void;
+    /**
+     * Log a debug message.
+     *
+     * @param message - Debug message
+     * @param context - Additional context
+     */
+    debug?: (message: string, context?: Record<string, unknown>) => void;
+    /**
+     * Log a warning.
+     *
+     * @param message - Warning message
+     * @param context - Additional context
+     */
+    warn?: (message: string, context?: Record<string, unknown>) => void;
+    /**
+     * Log an info message.
+     *
+     * @param message - Info message
+     * @param context - Additional context
+     */
+    info?: (message: string, context?: Record<string, unknown>) => void;
+}
+/**
+ * Connection pool configuration.
+ *
+ * @remarks
+ * Controls connection pooling behavior. SQLite adapters ignore these
+ * settings as SQLite uses a single connection.
+ *
+ * @public
+ */
+interface PoolConfig {
+    /** Minimum number of connections in the pool */
+    min?: number;
+    /** Maximum number of connections in the pool */
+    max?: number;
+    /** Time (ms) before an idle connection is closed */
+    idleTimeoutMs?: number;
+    /** Time (ms) to wait for a connection before timing out */
+    connectionTimeoutMs?: number;
+    /** Time (ms) before considering an unused connection stale */
+    maxLifetimeMs?: number;
+}
+/**
+ * SSL/TLS configuration for database connections.
+ *
+ * @remarks
+ * Relevant for PostgreSQL and MySQL. SQLite doesn't use network connections.
+ *
+ * @public
+ */
+interface SslConfig {
+    /** Reject unauthorized certificates (default: true for production) */
+    rejectUnauthorized?: boolean;
+    /** Path to CA certificate file */
+    ca?: string;
+    /** Path to client certificate file */
+    cert?: string;
+    /** Path to client private key file */
+    key?: string;
+}
+/**
+ * Base adapter configuration.
+ *
+ * @remarks
+ * Common configuration options for all database adapters. Dialect-specific
+ * adapters may extend this interface with additional options.
+ *
+ * @public
+ */
+interface BaseAdapterConfig {
+    /**
+     * Database connection URL.
+     *
+     * @remarks
+     * Examples:
+     * - PostgreSQL: `postgres://user:pass@localhost:5432/dbname`
+     * - MySQL: `mysql://user:pass@localhost:3306/dbname`
+     * - SQLite: `file:./data/app.db` or `file::memory:`
+     */
+    url?: string;
+    /** Database host (alternative to URL) */
+    host?: string;
+    /** Database port (alternative to URL) */
+    port?: number;
+    /** Database name (alternative to URL) */
+    database?: string;
+    /** Database user (alternative to URL) */
+    user?: string;
+    /** Database password (alternative to URL) */
+    password?: string;
+    /** Connection pool configuration */
+    pool?: PoolConfig;
+    /** Logger instance for queries and errors */
+    logger?: AdapterLogger;
+    /** Schema name (PostgreSQL) */
+    schema?: string;
+    /** SSL/TLS configuration */
+    ssl?: SslConfig | boolean;
+    /**
+     * Default query timeout in milliseconds.
+     *
+     * @remarks
+     * Queries exceeding this limit will be aborted and throw a DatabaseError
+     * with kind 'timeout'. This prevents runaway queries from blocking the
+     * system indefinitely.
+     *
+     * Can be overridden per-transaction via TransactionOptions.timeoutMs.
+     *
+     * Set to 0 or undefined to disable timeout (not recommended for production).
+     *
+     * @default 15000 (15 seconds)
+     *
+     * @example
+     * ```typescript
+     * const adapter = createPostgresAdapter({
+     *   url: 'postgres://localhost/mydb',
+     *   queryTimeoutMs: 30000, // 30 seconds
+     * });
+     * ```
+     */
+    queryTimeoutMs?: number;
+    /** Additional connection options (driver-specific) */
+    options?: Record<string, unknown>;
+}
+/**
+ * PostgreSQL-specific adapter configuration.
+ *
+ * @public
+ */
+interface PostgresAdapterConfig extends BaseAdapterConfig {
+    /** Application name for connection tracking */
+    applicationName?: string;
+    /** Statement timeout in milliseconds */
+    statementTimeout?: number;
+    /** Query timeout in milliseconds */
+    queryTimeout?: number;
+    /** Enable prepared statements (default: true) */
+    preparedStatements?: boolean;
+}
+/**
+ * MySQL-specific adapter configuration.
+ *
+ * @public
+ */
+interface MySqlAdapterConfig extends BaseAdapterConfig {
+    /** Character set (default: utf8mb4) */
+    charset?: string;
+    /** Timezone (default: 'local') */
+    timezone?: string;
+    /** Enable multiple statements per query (default: false, security risk) */
+    multipleStatements?: boolean;
+    /** Date strings instead of Date objects (default: false) */
+    dateStrings?: boolean;
+}
+/**
+ * SQLite-specific adapter configuration.
+ *
+ * @public
+ */
+interface SqliteAdapterConfig extends BaseAdapterConfig {
+    /** Enable WAL mode (default: true) */
+    wal?: boolean;
+    /** Busy timeout in milliseconds (default: 5000) */
+    busyTimeout?: number;
+    /** Enable foreign keys (default: true) */
+    foreignKeys?: boolean;
+    /** Memory-only database (overrides url) */
+    memory?: boolean;
+    /** Read-only mode (default: false) */
+    readonly?: boolean;
+}
+
+export { type AdapterLogger, type BaseAdapterConfig, type MySqlAdapterConfig, type PoolConfig, type PostgresAdapterConfig, SqlParam, type SqliteAdapterConfig, type SslConfig };

package/dist/types/index.mjs

@@ -0,0 +1,21 @@
+// src/types/error.ts
+function isDatabaseError(error) {
+  return typeof error === "object" && error !== null && "kind" in error && typeof error.kind === "string";
+}
+function createDatabaseError(options) {
+  const error = new Error(options.message);
+  error.name = "DatabaseError";
+  error.kind = options.kind;
+  if (options.code !== void 0) error.code = options.code;
+  if (options.constraint !== void 0) error.constraint = options.constraint;
+  if (options.table !== void 0) error.table = options.table;
+  if (options.column !== void 0) error.column = options.column;
+  if (options.detail !== void 0) error.detail = options.detail;
+  if (options.hint !== void 0) error.hint = options.hint;
+  if (options.cause !== void 0) error.cause = options.cause;
+  return error;
+}
+
+export { createDatabaseError, isDatabaseError };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/types/index.mjs.map

@@ -0,0 +1 @@
+{"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"]}

package/dist/version-check.cjs

@@ -0,0 +1,154 @@
+'use strict';
+
+// src/version-check.ts
+var NEXTLY_MIN_DB_VERSIONS = {
+  postgresql: { major: 15, minor: 0 },
+  mysql: { major: 8, minor: 0 },
+  sqlite: { major: 3, minor: 38 }
+};
+var UnsupportedDialectVersionError = class extends Error {
+  kind = "unsupported_version";
+  dialect;
+  detectedVersion;
+  requiredVersion;
+  cause;
+  constructor(args) {
+    super(args.message);
+    this.name = "UnsupportedDialectVersionError";
+    this.dialect = args.dialect;
+    this.detectedVersion = args.detectedVersion;
+    this.requiredVersion = args.requiredVersion;
+    this.cause = args.cause;
+  }
+};
+var DOCS_URL = "https://nextlyhq.com/docs/database/support";
+var VARIANT_TOKENS = [
+  "mariadb",
+  "tidb",
+  "aurora",
+  "planetscale",
+  "vitess"
+];
+var POSTGRES_REGEX = /^PostgreSQL (\d+)\.(\d+)/;
+var MYSQL_REGEX = /^(\d+)\.(\d+)\.(\d+)/;
+var SQLITE_REGEX = /^(\d+)\.(\d+)\.(\d+)/;
+function parsePostgres(raw) {
+  const match = POSTGRES_REGEX.exec(raw);
+  if (!match) return null;
+  return { major: Number(match[1]), minor: Number(match[2]) };
+}
+function parseMySQL(raw) {
+  const match = MYSQL_REGEX.exec(raw);
+  if (!match) return null;
+  return { major: Number(match[1]), minor: Number(match[2]) };
+}
+function parseSQLite(raw) {
+  const match = SQLITE_REGEX.exec(raw);
+  if (!match) return null;
+  return { major: Number(match[1]), minor: Number(match[2]) };
+}
+function detectVariant(raw) {
+  const lower = raw.toLowerCase();
+  for (const token of VARIANT_TOKENS) {
+    if (lower.includes(token)) return token;
+  }
+  return null;
+}
+function meetsMinimum(detected, required) {
+  if (detected.major > required.major) return true;
+  if (detected.major < required.major) return false;
+  return detected.minor >= required.minor;
+}
+async function checkDialectVersion(client, dialect, options) {
+  const required = NEXTLY_MIN_DB_VERSIONS[dialect];
+  const requiredStr = `${required.major}.${required.minor}+`;
+  let raw;
+  if (dialect === "sqlite") {
+    raw = await querySqliteVersion(client);
+  } else if (dialect === "postgresql") {
+    raw = await queryPostgresVersion(client);
+  } else {
+    raw = await queryMysqlVersion(client);
+  }
+  const variant = dialect === "mysql" ? detectVariant(raw) : null;
+  if (variant) {
+    const warning = `Detected ${variant} ('${raw}'). Nextly is regression-tested against real MySQL 8.0+ only; this MySQL-compatible variant is not officially supported in v1 but most operations should work. See ${DOCS_URL}.`;
+    if (options?.onWarning) options.onWarning(warning);
+    return;
+  }
+  let parsed;
+  if (dialect === "postgresql") parsed = parsePostgres(raw);
+  else if (dialect === "mysql") parsed = parseMySQL(raw);
+  else parsed = parseSQLite(raw);
+  if (!parsed) {
+    throw new UnsupportedDialectVersionError({
+      dialect,
+      detectedVersion: raw,
+      requiredVersion: requiredStr,
+      message: `Could not parse ${dialect} version from '${raw}'. Nextly requires ${dialect} ${requiredStr}. If you are on a known MySQL-compatible variant we did not detect, please file an issue. See ${DOCS_URL}.`
+    });
+  }
+  if (!meetsMinimum(parsed, required)) {
+    const labels = {
+      postgresql: "PostgreSQL",
+      mysql: "MySQL",
+      sqlite: "SQLite"
+    };
+    throw new UnsupportedDialectVersionError({
+      dialect,
+      detectedVersion: `${parsed.major}.${parsed.minor}`,
+      requiredVersion: requiredStr,
+      message: `${labels[dialect]} ${requiredStr} required; detected ${parsed.major}.${parsed.minor}. See ${DOCS_URL}.`
+    });
+  }
+}
+async function queryPostgresVersion(client) {
+  if (!client.query) {
+    throw new Error("PostgreSQL client missing query() method");
+  }
+  const result = await client.query("SELECT version()");
+  const row = result.rows?.[0];
+  const version = row?.version;
+  if (typeof version !== "string") {
+    throw new Error(
+      `Unexpected response shape from SELECT version(): ${JSON.stringify(result)}`
+    );
+  }
+  return version;
+}
+async function queryMysqlVersion(client) {
+  if (!client.query) {
+    throw new Error("MySQL client missing query() method");
+  }
+  const result = await client.query("SELECT VERSION() AS version");
+  const row = result?.[0]?.[0];
+  const version = row?.version;
+  if (typeof version !== "string") {
+    throw new Error(
+      `Unexpected response shape from SELECT VERSION(): ${JSON.stringify(result)}`
+    );
+  }
+  return version;
+}
+function querySqliteVersion(client) {
+  if (!client.prepare) {
+    return Promise.reject(new Error("SQLite client missing prepare() method"));
+  }
+  const stmt = client.prepare("SELECT sqlite_version() AS version");
+  const row = stmt.get();
+  const version = row?.version;
+  if (typeof version !== "string") {
+    return Promise.reject(
+      new Error(
+        `Unexpected response shape from SELECT sqlite_version(): ${JSON.stringify(row)}`
+      )
+    );
+  }
+  return Promise.resolve(version);
+}
+
+exports.NEXTLY_MIN_DB_VERSIONS = NEXTLY_MIN_DB_VERSIONS;
+exports.UnsupportedDialectVersionError = UnsupportedDialectVersionError;
+exports.checkDialectVersion = checkDialectVersion;
+//# sourceMappingURL=version-check.cjs.map
+//# sourceMappingURL=version-check.cjs.map