@nextlyhq/adapter-drizzle 0.0.2-alpha.68 → 0.0.2-alpha.69

package/dist/core-CVO7WYDj.d.cts

@@ -1,74 +0,0 @@
-/**
- * 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/core-CVO7WYDj.d.ts

@@ -1,74 +0,0 @@
-/**
- * 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-BrdknH2s.d.cts

@@ -1,122 +0,0 @@
-/**
- * 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;
-/**
- * Whether an error is the application's verdict rather than the database's
- * failure.
- *
- * Work running inside a transaction may throw to roll the write back — a
- * refused value, a permission denial — and such an error is not something the
- * driver produced. Classifying it as a database error replaces its code and its
- * payload with a generic one, so a caller that asked for a refusal is handed an
- * unexplained failure instead, and per-field validation detail is lost on the
- * way out.
- *
- * @param error - Error to check
- * @returns True if the error was raised by application code
- *
- * @public
- */
-declare function isApplicationError(error: unknown): boolean;
-/**
- * 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 d, isApplicationError as i };

package/dist/error-BrdknH2s.d.ts

@@ -1,122 +0,0 @@
-/**
- * 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;
-/**
- * Whether an error is the application's verdict rather than the database's
- * failure.
- *
- * Work running inside a transaction may throw to roll the write back — a
- * refused value, a permission denial — and such an error is not something the
- * driver produced. Classifying it as a database error replaces its code and its
- * payload with a generic one, so a caller that asked for a refusal is handed an
- * unexplained failure instead, and per-field validation detail is lost on the
- * way out.
- *
- * @param error - Error to check
- * @returns True if the error was raised by application code
- *
- * @public
- */
-declare function isApplicationError(error: unknown): boolean;
-/**
- * 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 d, isApplicationError as i };