@nextlyhq/adapter-drizzle 0.0.1

package/dist/core-CVO7WYDj.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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;
+}
+
+export type { JsonArray as J, SupportedDialect as S, TableResolver as T, SqlParam as a, JsonObject as b, JsonValue as c };

package/dist/error-um1d_3Uo.d.cts

@@ -0,0 +1,105 @@
+/**
+ * Database error type definitions.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Database error classification.
+ *
+ * @remarks
+ * Categorizes database errors for consistent error handling across adapters.
+ * Each adapter translates database-specific error codes to these kinds.
+ *
+ * @public
+ */
+type DatabaseErrorKind = "connection" | "query" | "constraint" | "unique_violation" | "foreign_key_violation" | "check_violation" | "not_null_violation" | "deadlock" | "timeout" | "serialization_failure" | "unsupported_version" | "unknown";
+/**
+ * Enhanced database error interface.
+ *
+ * @remarks
+ * Extends the standard Error interface with database-specific context.
+ * Adapters should throw errors implementing this interface for consistent
+ * error handling.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await adapter.insert('users', { email: 'duplicate@example.com' });
+ * } catch (error) {
+ *   if (isDatabaseError(error) && error.kind === 'unique_violation') {
+ *     console.log(`Duplicate ${error.column} in ${error.table}`);
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+interface DatabaseError extends Error {
+    /** Error classification */
+    kind: DatabaseErrorKind;
+    /** Database-specific error code (e.g., "23505" for PostgreSQL unique violation) */
+    code?: string;
+    /** Constraint name that was violated (if applicable) */
+    constraint?: string;
+    /** Table name involved in the error */
+    table?: string;
+    /** Column name involved in the error */
+    column?: string;
+    /** Detailed error description from the database */
+    detail?: string;
+    /** Hint for resolving the error */
+    hint?: string;
+    /** Original error from the database driver */
+    cause?: Error;
+}
+/**
+ * Type guard for DatabaseError.
+ *
+ * @remarks
+ * Checks if an error is a DatabaseError with proper typing.
+ *
+ * @param error - Error to check
+ * @returns True if error is a DatabaseError
+ *
+ * @public
+ */
+declare function isDatabaseError(error: unknown): error is DatabaseError;
+/**
+ * Database error constructor options.
+ *
+ * @public
+ */
+interface DatabaseErrorOptions {
+    /** Error classification */
+    kind: DatabaseErrorKind;
+    /** Error message */
+    message: string;
+    /** Database-specific error code */
+    code?: string;
+    /** Constraint name */
+    constraint?: string;
+    /** Table name */
+    table?: string;
+    /** Column name */
+    column?: string;
+    /** Detailed description */
+    detail?: string;
+    /** Resolution hint */
+    hint?: string;
+    /** Original error */
+    cause?: Error;
+}
+/**
+ * Create a DatabaseError instance.
+ *
+ * @remarks
+ * Helper function to create properly structured DatabaseError objects.
+ *
+ * @param options - Error options
+ * @returns DatabaseError instance
+ *
+ * @public
+ */
+declare function createDatabaseError(options: DatabaseErrorOptions): DatabaseError;
+
+export { type DatabaseErrorKind as D, type DatabaseError as a, type DatabaseErrorOptions as b, createDatabaseError as c, isDatabaseError as i };

package/dist/error-um1d_3Uo.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Database error type definitions.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Database error classification.
+ *
+ * @remarks
+ * Categorizes database errors for consistent error handling across adapters.
+ * Each adapter translates database-specific error codes to these kinds.
+ *
+ * @public
+ */
+type DatabaseErrorKind = "connection" | "query" | "constraint" | "unique_violation" | "foreign_key_violation" | "check_violation" | "not_null_violation" | "deadlock" | "timeout" | "serialization_failure" | "unsupported_version" | "unknown";
+/**
+ * Enhanced database error interface.
+ *
+ * @remarks
+ * Extends the standard Error interface with database-specific context.
+ * Adapters should throw errors implementing this interface for consistent
+ * error handling.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await adapter.insert('users', { email: 'duplicate@example.com' });
+ * } catch (error) {
+ *   if (isDatabaseError(error) && error.kind === 'unique_violation') {
+ *     console.log(`Duplicate ${error.column} in ${error.table}`);
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+interface DatabaseError extends Error {
+    /** Error classification */
+    kind: DatabaseErrorKind;
+    /** Database-specific error code (e.g., "23505" for PostgreSQL unique violation) */
+    code?: string;
+    /** Constraint name that was violated (if applicable) */
+    constraint?: string;
+    /** Table name involved in the error */
+    table?: string;
+    /** Column name involved in the error */
+    column?: string;
+    /** Detailed error description from the database */
+    detail?: string;
+    /** Hint for resolving the error */
+    hint?: string;
+    /** Original error from the database driver */
+    cause?: Error;
+}
+/**
+ * Type guard for DatabaseError.
+ *
+ * @remarks
+ * Checks if an error is a DatabaseError with proper typing.
+ *
+ * @param error - Error to check
+ * @returns True if error is a DatabaseError
+ *
+ * @public
+ */
+declare function isDatabaseError(error: unknown): error is DatabaseError;
+/**
+ * Database error constructor options.
+ *
+ * @public
+ */
+interface DatabaseErrorOptions {
+    /** Error classification */
+    kind: DatabaseErrorKind;
+    /** Error message */
+    message: string;
+    /** Database-specific error code */
+    code?: string;
+    /** Constraint name */
+    constraint?: string;
+    /** Table name */
+    table?: string;
+    /** Column name */
+    column?: string;
+    /** Detailed description */
+    detail?: string;
+    /** Resolution hint */
+    hint?: string;
+    /** Original error */
+    cause?: Error;
+}
+/**
+ * Create a DatabaseError instance.
+ *
+ * @remarks
+ * Helper function to create properly structured DatabaseError objects.
+ *
+ * @param options - Error options
+ * @returns DatabaseError instance
+ *
+ * @public
+ */
+declare function createDatabaseError(options: DatabaseErrorOptions): DatabaseError;
+
+export { type DatabaseErrorKind as D, type DatabaseError as a, type DatabaseErrorOptions as b, createDatabaseError as c, isDatabaseError as i };