@ductape/sdk 0.0.4-v51 → 0.0.4-v53

package/dist/database/types/trigger.interface.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Database Trigger Type Definitions
+ *
+ * Triggers are automated actions that execute in response to database events.
+ * They integrate with Ductape primitives: storage, actions, notifications,
+ * brokers, workflows, cache, quotas, fallbacks, and more.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConditionOperator = exports.TriggerActionType = exports.TriggerTiming = exports.TriggerEvent = void 0;
+// ==================== TRIGGER EVENTS ====================
+/**
+ * Events that can trigger actions
+ */
+var TriggerEvent;
+(function (TriggerEvent) {
+    /** Before a record is inserted */
+    TriggerEvent["BEFORE_INSERT"] = "beforeInsert";
+    /** After a record is inserted */
+    TriggerEvent["AFTER_INSERT"] = "afterInsert";
+    /** Before a record is updated */
+    TriggerEvent["BEFORE_UPDATE"] = "beforeUpdate";
+    /** After a record is updated */
+    TriggerEvent["AFTER_UPDATE"] = "afterUpdate";
+    /** Before a record is deleted */
+    TriggerEvent["BEFORE_DELETE"] = "beforeDelete";
+    /** After a record is deleted */
+    TriggerEvent["AFTER_DELETE"] = "afterDelete";
+    /** Before any write operation */
+    TriggerEvent["BEFORE_WRITE"] = "beforeWrite";
+    /** After any write operation */
+    TriggerEvent["AFTER_WRITE"] = "afterWrite";
+})(TriggerEvent || (exports.TriggerEvent = TriggerEvent = {}));
+/**
+ * Trigger execution timing
+ */
+var TriggerTiming;
+(function (TriggerTiming) {
+    /** Execute synchronously, block until complete */
+    TriggerTiming["SYNC"] = "sync";
+    /** Execute asynchronously, don't wait */
+    TriggerTiming["ASYNC"] = "async";
+    /** Queue for background processing */
+    TriggerTiming["QUEUED"] = "queued";
+})(TriggerTiming || (exports.TriggerTiming = TriggerTiming = {}));
+// ==================== TRIGGER ACTION TYPES ====================
+/**
+ * Types of actions a trigger can perform
+ */
+var TriggerActionType;
+(function (TriggerActionType) {
+    // Core Database
+    TriggerActionType["DATABASE_INSERT"] = "database.insert";
+    TriggerActionType["DATABASE_UPDATE"] = "database.update";
+    TriggerActionType["DATABASE_DELETE"] = "database.delete";
+    TriggerActionType["DATABASE_QUERY"] = "database.query";
+    // Storage
+    TriggerActionType["STORAGE_UPLOAD"] = "storage.upload";
+    TriggerActionType["STORAGE_DELETE"] = "storage.delete";
+    TriggerActionType["STORAGE_COPY"] = "storage.copy";
+    // Notifications
+    TriggerActionType["NOTIFICATION_EMAIL"] = "notification.email";
+    TriggerActionType["NOTIFICATION_SMS"] = "notification.sms";
+    TriggerActionType["NOTIFICATION_PUSH"] = "notification.push";
+    TriggerActionType["NOTIFICATION_CALLBACK"] = "notification.callback";
+    // Message Brokers
+    TriggerActionType["BROKER_PUBLISH"] = "broker.publish";
+    // Cache
+    TriggerActionType["CACHE_SET"] = "cache.set";
+    TriggerActionType["CACHE_INVALIDATE"] = "cache.invalidate";
+    TriggerActionType["CACHE_DELETE"] = "cache.delete";
+    // Workflows
+    TriggerActionType["WORKFLOW_EXECUTE"] = "workflow.execute";
+    TriggerActionType["WORKFLOW_DISPATCH"] = "workflow.dispatch";
+    // Actions (App Actions)
+    TriggerActionType["ACTION_EXECUTE"] = "action.execute";
+    // Agents
+    TriggerActionType["AGENT_RUN"] = "agent.run";
+    // Resilience
+    TriggerActionType["QUOTA_RUN"] = "quota.run";
+    TriggerActionType["FALLBACK_RUN"] = "fallback.run";
+    TriggerActionType["HEALTHCHECK_RUN"] = "healthcheck.run";
+    // Logging
+    TriggerActionType["LOG_CREATE"] = "log.create";
+    // Sessions
+    TriggerActionType["SESSION_REVOKE"] = "session.revoke";
+    // Vector Operations
+    TriggerActionType["VECTOR_UPSERT"] = "vector.upsert";
+    TriggerActionType["VECTOR_DELETE"] = "vector.delete";
+    // Custom
+    TriggerActionType["CUSTOM_FUNCTION"] = "custom.function";
+    TriggerActionType["CUSTOM_HTTP"] = "custom.http";
+})(TriggerActionType || (exports.TriggerActionType = TriggerActionType = {}));
+// ==================== TRIGGER CONDITIONS ====================
+/**
+ * Condition operators
+ */
+var ConditionOperator;
+(function (ConditionOperator) {
+    ConditionOperator["EQUALS"] = "eq";
+    ConditionOperator["NOT_EQUALS"] = "neq";
+    ConditionOperator["GREATER_THAN"] = "gt";
+    ConditionOperator["GREATER_THAN_OR_EQUALS"] = "gte";
+    ConditionOperator["LESS_THAN"] = "lt";
+    ConditionOperator["LESS_THAN_OR_EQUALS"] = "lte";
+    ConditionOperator["IN"] = "in";
+    ConditionOperator["NOT_IN"] = "notIn";
+    ConditionOperator["CONTAINS"] = "contains";
+    ConditionOperator["STARTS_WITH"] = "startsWith";
+    ConditionOperator["ENDS_WITH"] = "endsWith";
+    ConditionOperator["MATCHES"] = "matches";
+    ConditionOperator["IS_NULL"] = "isNull";
+    ConditionOperator["IS_NOT_NULL"] = "isNotNull";
+    ConditionOperator["IS_EMPTY"] = "isEmpty";
+    ConditionOperator["IS_NOT_EMPTY"] = "isNotEmpty";
+    ConditionOperator["CHANGED"] = "changed";
+    ConditionOperator["NOT_CHANGED"] = "notChanged";
+    ConditionOperator["CHANGED_TO"] = "changedTo";
+    ConditionOperator["CHANGED_FROM"] = "changedFrom";
+})(ConditionOperator || (exports.ConditionOperator = ConditionOperator = {}));
+//# sourceMappingURL=trigger.interface.js.map

package/dist/database/types/trigger.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.interface.js","sourceRoot":"","sources":["../../../src/database/types/trigger.interface.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,2DAA2D;AAE3D;;GAEG;AACH,IAAY,YAiBX;AAjBD,WAAY,YAAY;IACtB,kCAAkC;IAClC,8CAA8B,CAAA;IAC9B,iCAAiC;IACjC,4CAA4B,CAAA;IAC5B,iCAAiC;IACjC,8CAA8B,CAAA;IAC9B,gCAAgC;IAChC,4CAA4B,CAAA;IAC5B,iCAAiC;IACjC,8CAA8B,CAAA;IAC9B,gCAAgC;IAChC,4CAA4B,CAAA;IAC5B,iCAAiC;IACjC,4CAA4B,CAAA;IAC5B,gCAAgC;IAChC,0CAA0B,CAAA;AAC5B,CAAC,EAjBW,YAAY,4BAAZ,YAAY,QAiBvB;AAED;;GAEG;AACH,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,kDAAkD;IAClD,8BAAa,CAAA;IACb,yCAAyC;IACzC,gCAAe,CAAA;IACf,sCAAsC;IACtC,kCAAiB,CAAA;AACnB,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB;AAED,iEAAiE;AAEjE;;GAEG;AACH,IAAY,iBAsDX;AAtDD,WAAY,iBAAiB;IAC3B,gBAAgB;IAChB,wDAAmC,CAAA;IACnC,wDAAmC,CAAA;IACnC,wDAAmC,CAAA;IACnC,sDAAiC,CAAA;IAEjC,UAAU;IACV,sDAAiC,CAAA;IACjC,sDAAiC,CAAA;IACjC,kDAA6B,CAAA;IAE7B,gBAAgB;IAChB,8DAAyC,CAAA;IACzC,0DAAqC,CAAA;IACrC,4DAAuC,CAAA;IACvC,oEAA+C,CAAA;IAE/C,kBAAkB;IAClB,sDAAiC,CAAA;IAEjC,QAAQ;IACR,4CAAuB,CAAA;IACvB,0DAAqC,CAAA;IACrC,kDAA6B,CAAA;IAE7B,YAAY;IACZ,0DAAqC,CAAA;IACrC,4DAAuC,CAAA;IAEvC,wBAAwB;IACxB,sDAAiC,CAAA;IAEjC,SAAS;IACT,4CAAuB,CAAA;IAEvB,aAAa;IACb,4CAAuB,CAAA;IACvB,kDAA6B,CAAA;IAC7B,wDAAmC,CAAA;IAEnC,UAAU;IACV,8CAAyB,CAAA;IAEzB,WAAW;IACX,sDAAiC,CAAA;IAEjC,oBAAoB;IACpB,oDAA+B,CAAA;IAC/B,oDAA+B,CAAA;IAE/B,SAAS;IACT,wDAAmC,CAAA;IACnC,gDAA2B,CAAA;AAC7B,CAAC,EAtDW,iBAAiB,iCAAjB,iBAAiB,QAsD5B;AAyQD,+DAA+D;AAE/D;;GAEG;AACH,IAAY,iBAqBX;AArBD,WAAY,iBAAiB;IAC3B,kCAAa,CAAA;IACb,uCAAkB,CAAA;IAClB,wCAAmB,CAAA;IACnB,mDAA8B,CAAA;IAC9B,qCAAgB,CAAA;IAChB,gDAA2B,CAAA;IAC3B,8BAAS,CAAA;IACT,qCAAgB,CAAA;IAChB,0CAAqB,CAAA;IACrB,+CAA0B,CAAA;IAC1B,2CAAsB,CAAA;IACtB,wCAAmB,CAAA;IACnB,uCAAkB,CAAA;IAClB,8CAAyB,CAAA;IACzB,yCAAoB,CAAA;IACpB,gDAA2B,CAAA;IAC3B,wCAAmB,CAAA;IACnB,+CAA0B,CAAA;IAC1B,6CAAwB,CAAA;IACxB,iDAA4B,CAAA;AAC9B,CAAC,EArBW,iBAAiB,iCAAjB,iBAAiB,QAqB5B"}

package/dist/database/types/write.interface.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Write operation type definitions (Insert, Update, Delete, Upsert)
+ */
+import { ConflictAction } from './enums';
+import { IWhereClause } from './query.interface';
+import { ITransaction } from './transaction.interface';
+import { IPreSaveOperation, IPreSaveConfig } from './presave.interface';
+/**
+ * Options for insert operations
+ */
+export interface IInsertOptions {
+    /** Table or collection name */
+    table: string;
+    /** Record(s) to insert - single object or array */
+    data: Record<string, any> | Record<string, any>[];
+    /** Return inserted records */
+    returning?: boolean;
+    /** Columns to return (if returning is true) */
+    returningColumns?: string[];
+    /** Conflict handling configuration */
+    onConflict?: IOnConflictOptions;
+    /** Environment (if not using connection context) */
+    env?: string;
+    /** Product tag */
+    product?: string;
+    /** Database tag */
+    database?: string;
+    /** Transaction to use */
+    transaction?: ITransaction;
+    /**
+     * Pre-save operations to apply before inserting
+     * Operations like encryption, hashing, validation, transformation
+     */
+    preSave?: IPreSaveOperation[];
+    /**
+     * Pre-save processor configuration
+     */
+    preSaveConfig?: IPreSaveConfig;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** Cache tag for result caching */
+    cache?: string;
+}
+/**
+ * Conflict handling options for insert
+ */
+export interface IOnConflictOptions {
+    /** Columns to detect conflict on */
+    columns: string[];
+    /** Action to take on conflict */
+    action: ConflictAction | 'update' | 'ignore';
+    /** Columns to update on conflict (if action is 'update') */
+    update?: string[];
+}
+/**
+ * Result of an insert operation
+ */
+export interface IInsertResult<T> {
+    /** Inserted records (if returning: true) */
+    data: T[];
+    /** Number of inserted records */
+    count: number;
+    /** IDs of inserted records */
+    insertedIds: any[];
+}
+/**
+ * Options for update operations
+ */
+export interface IUpdateOptions {
+    /** Table or collection name */
+    table: string;
+    /** Fields to update */
+    data: Record<string, any | IUpdateOperator>;
+    /** Filter conditions - records to update */
+    where: IWhereClause;
+    /** Return updated records */
+    returning?: boolean;
+    /** Columns to return (if returning is true) */
+    returningColumns?: string[];
+    /** Environment (if not using connection context) */
+    env?: string;
+    /** Product tag */
+    product?: string;
+    /** Database tag */
+    database?: string;
+    /** Transaction to use */
+    transaction?: ITransaction;
+    /**
+     * Pre-save operations to apply before updating
+     * Operations like encryption, hashing, validation, transformation
+     */
+    preSave?: IPreSaveOperation[];
+    /**
+     * Pre-save processor configuration
+     */
+    preSaveConfig?: IPreSaveConfig;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** Cache tag for result caching */
+    cache?: string;
+}
+/**
+ * Update operators for special update operations
+ * Uses uppercase naming convention for consistency with query operators ($EQ, $GT, etc.)
+ */
+export interface IUpdateOperator {
+    /** Increment value */
+    $INC?: number;
+    /** Decrement value */
+    $DEC?: number;
+    /** Set value (explicit set) */
+    $SET?: any;
+    /** Unset/remove field */
+    $UNSET?: boolean;
+    /** Multiply value */
+    $MUL?: number;
+    /** Set minimum (only update if new value is less than current) */
+    $MIN?: any;
+    /** Set maximum (only update if new value is greater than current) */
+    $MAX?: any;
+    /** Add to array */
+    $PUSH?: any;
+    /** Remove from array */
+    $PULL?: any;
+    /** Add unique to array (only adds if value doesn't exist) */
+    $ADDTOSET?: any;
+}
+/**
+ * Result of an update operation
+ */
+export interface IUpdateResult<T> {
+    /** Updated records (if returning: true) */
+    data: T[];
+    /** Number of updated records */
+    count: number;
+}
+/**
+ * Options for delete operations
+ */
+export interface IDeleteOptions {
+    /** Table or collection name */
+    table: string;
+    /** Filter conditions - records to delete */
+    where: IWhereClause;
+    /** Return deleted records */
+    returning?: boolean;
+    /** Columns to return (if returning is true) */
+    returningColumns?: string[];
+    /** Environment (if not using connection context) */
+    env?: string;
+    /** Product tag */
+    product?: string;
+    /** Database tag */
+    database?: string;
+    /** Transaction to use */
+    transaction?: ITransaction;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** Cache tag for result caching */
+    cache?: string;
+}
+/**
+ * Result of a delete operation
+ */
+export interface IDeleteResult {
+    /** Number of deleted records */
+    count: number;
+    /** Deleted records (if returning: true) */
+    data?: any[];
+}
+/**
+ * Options for upsert (insert or update) operations
+ */
+export interface IUpsertOptions {
+    /** Table or collection name */
+    table: string;
+    /** Record to insert/update */
+    data: Record<string, any>;
+    /** Columns to detect conflict on (unique keys) */
+    conflictKeys: string[];
+    /** Columns to update on conflict (if not specified, updates all non-conflict columns) */
+    updateColumns?: string[];
+    /** Return affected record */
+    returning?: boolean;
+    /** Environment (if not using connection context) */
+    env?: string;
+    /** Product tag */
+    product?: string;
+    /** Database tag */
+    database?: string;
+    /** Transaction to use */
+    transaction?: ITransaction;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** Cache tag for result caching */
+    cache?: string;
+}
+/**
+ * Result of an upsert operation
+ */
+export interface IUpsertResult<T> {
+    /** Affected records */
+    data: T[];
+    /** Number of affected records */
+    count: number;
+    /** Whether the operation was an insert or update */
+    operation: 'inserted' | 'updated';
+}

package/dist/database/types/write.interface.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Write operation type definitions (Insert, Update, Delete, Upsert)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=write.interface.js.map

package/dist/database/types/write.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.interface.js","sourceRoot":"","sources":["../../../src/database/types/write.interface.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/database/utils/database-error.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Database Error class for typed error handling
+ */
+import { DatabaseErrorType } from '../types/enums';
+/**
+ * Custom error class for database operations
+ * Provides typed error handling with specific error types
+ */
+export declare class DatabaseError extends Error {
+    /** Error type for categorization */
+    readonly type: DatabaseErrorType;
+    /** Original error if wrapping another error */
+    readonly originalError?: Error;
+    /** Error code (database-specific) */
+    readonly code?: string;
+    /** Additional error details */
+    readonly details?: Record<string, any>;
+    constructor(message: string, type?: DatabaseErrorType, originalError?: Error, details?: Record<string, any>);
+    /**
+     * Check if error is of a specific type
+     */
+    isType(type: DatabaseErrorType): boolean;
+    /**
+     * Check if error is a connection error
+     */
+    isConnectionError(): boolean;
+    /**
+     * Check if error is a query error
+     */
+    isQueryError(): boolean;
+    /**
+     * Check if error is a unique violation
+     */
+    isUniqueViolation(): boolean;
+    /**
+     * Check if error is a foreign key violation
+     */
+    isForeignKeyViolation(): boolean;
+    /**
+     * Check if error is a not null violation
+     */
+    isNotNullViolation(): boolean;
+    /**
+     * Check if error is a validation error
+     */
+    isValidationError(): boolean;
+    /**
+     * Check if error is a not found error
+     */
+    isNotFound(): boolean;
+    /**
+     * Convert to JSON for logging
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Create a connection error
+     */
+    static connectionError(message: string, originalError?: Error): DatabaseError;
+    /**
+     * Create a query error
+     */
+    static queryError(message: string, originalError?: Error): DatabaseError;
+    /**
+     * Create a unique violation error
+     */
+    static uniqueViolation(message: string, originalError?: Error): DatabaseError;
+    /**
+     * Create a foreign key violation error
+     */
+    static foreignKeyViolation(message: string, originalError?: Error): DatabaseError;
+    /**
+     * Create a not found error
+     */
+    static notFound(message: string): DatabaseError;
+    /**
+     * Create a validation error
+     */
+    static validationError(message: string, details?: Record<string, any>): DatabaseError;
+    /**
+     * Create a transaction error
+     */
+    static transactionError(message: string, originalError?: Error): DatabaseError;
+    /**
+     * Create a schema error
+     */
+    static schemaError(message: string, originalError?: Error): DatabaseError;
+    /**
+     * Create a migration error
+     */
+    static migrationError(message: string, originalError?: Error): DatabaseError;
+    /**
+     * Create an error from a database-specific error
+     * Maps common database error codes to DatabaseErrorType
+     */
+    static fromDatabaseError(error: any, databaseType: string): DatabaseError;
+}

package/dist/database/utils/database-error.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Database Error class for typed error handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseError = void 0;
+const enums_1 = require("../types/enums");
+/**
+ * Custom error class for database operations
+ * Provides typed error handling with specific error types
+ */
+class DatabaseError extends Error {
+    constructor(message, type = enums_1.DatabaseErrorType.UNKNOWN_ERROR, originalError, details) {
+        super(message);
+        this.name = 'DatabaseError';
+        this.type = type;
+        this.originalError = originalError;
+        this.details = details;
+        // Extract code from original error if available
+        if (originalError && 'code' in originalError) {
+            this.code = originalError.code;
+        }
+        // Capture stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DatabaseError);
+        }
+    }
+    /**
+     * Check if error is of a specific type
+     */
+    isType(type) {
+        return this.type === type;
+    }
+    /**
+     * Check if error is a connection error
+     */
+    isConnectionError() {
+        return this.type === enums_1.DatabaseErrorType.CONNECTION_ERROR;
+    }
+    /**
+     * Check if error is a query error
+     */
+    isQueryError() {
+        return this.type === enums_1.DatabaseErrorType.QUERY_ERROR;
+    }
+    /**
+     * Check if error is a unique violation
+     */
+    isUniqueViolation() {
+        return this.type === enums_1.DatabaseErrorType.UNIQUE_VIOLATION;
+    }
+    /**
+     * Check if error is a foreign key violation
+     */
+    isForeignKeyViolation() {
+        return this.type === enums_1.DatabaseErrorType.FOREIGN_KEY_VIOLATION;
+    }
+    /**
+     * Check if error is a not null violation
+     */
+    isNotNullViolation() {
+        return this.type === enums_1.DatabaseErrorType.NOT_NULL_VIOLATION;
+    }
+    /**
+     * Check if error is a validation error
+     */
+    isValidationError() {
+        return this.type === enums_1.DatabaseErrorType.VALIDATION_ERROR;
+    }
+    /**
+     * Check if error is a not found error
+     */
+    isNotFound() {
+        return this.type === enums_1.DatabaseErrorType.NOT_FOUND;
+    }
+    /**
+     * Convert to JSON for logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            type: this.type,
+            code: this.code,
+            details: this.details,
+            stack: this.stack,
+            originalError: this.originalError
+                ? {
+                    name: this.originalError.name,
+                    message: this.originalError.message,
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Create a connection error
+     */
+    static connectionError(message, originalError) {
+        return new DatabaseError(message, enums_1.DatabaseErrorType.CONNECTION_ERROR, originalError);
+    }
+    /**
+     * Create a query error
+     */
+    static queryError(message, originalError) {
+        return new DatabaseError(message, enums_1.DatabaseErrorType.QUERY_ERROR, originalError);
+    }
+    /**
+     * Create a unique violation error
+     */
+    static uniqueViolation(message, originalError) {
+        return new DatabaseError(message, enums_1.DatabaseErrorType.UNIQUE_VIOLATION, originalError);
+    }
+    /**
+     * Create a foreign key violation error
+     */
+    static foreignKeyViolation(message, originalError) {
+        return new DatabaseError(message, enums_1.DatabaseErrorType.FOREIGN_KEY_VIOLATION, originalError);
+    }
+    /**
+     * Create a not found error
+     */
+    static notFound(message) {
+        return new DatabaseError(message, enums_1.DatabaseErrorType.NOT_FOUND);
+    }
+    /**
+     * Create a validation error
+     */
+    static validationError(message, details) {
+        return new DatabaseError(message, enums_1.DatabaseErrorType.VALIDATION_ERROR, undefined, details);
+    }
+    /**
+     * Create a transaction error
+     */
+    static transactionError(message, originalError) {
+        return new DatabaseError(message, enums_1.DatabaseErrorType.TRANSACTION_ERROR, originalError);
+    }
+    /**
+     * Create a schema error
+     */
+    static schemaError(message, originalError) {
+        return new DatabaseError(message, enums_1.DatabaseErrorType.SCHEMA_ERROR, originalError);
+    }
+    /**
+     * Create a migration error
+     */
+    static migrationError(message, originalError) {
+        return new DatabaseError(message, enums_1.DatabaseErrorType.MIGRATION_ERROR, originalError);
+    }
+    /**
+     * Create an error from a database-specific error
+     * Maps common database error codes to DatabaseErrorType
+     */
+    static fromDatabaseError(error, databaseType) {
+        const message = error.message || 'Unknown database error';
+        const code = error.code;
+        // Map PostgreSQL error codes
+        if (databaseType === 'postgresql') {
+            switch (code) {
+                case '23505': // unique_violation
+                    return DatabaseError.uniqueViolation(message, error);
+                case '23503': // foreign_key_violation
+                    return DatabaseError.foreignKeyViolation(message, error);
+                case '23502': // not_null_violation
+                    return new DatabaseError(message, enums_1.DatabaseErrorType.NOT_NULL_VIOLATION, error);
+                case '23514': // check_violation
+                    return new DatabaseError(message, enums_1.DatabaseErrorType.CHECK_VIOLATION, error);
+                case '08000': // connection_exception
+                case '08003': // connection_does_not_exist
+                case '08006': // connection_failure
+                    return DatabaseError.connectionError(message, error);
+                case '42P01': // undefined_table
+                case '42703': // undefined_column
+                    return DatabaseError.schemaError(message, error);
+                case '28000': // invalid_authorization_specification
+                case '28P01': // invalid_password
+                    return new DatabaseError(message, enums_1.DatabaseErrorType.AUTHENTICATION_ERROR, error);
+                default:
+                    return DatabaseError.queryError(message, error);
+            }
+        }
+        // Map MySQL error codes
+        if (databaseType === 'mysql' || databaseType === 'mariadb') {
+            switch (code) {
+                case 'ER_DUP_ENTRY':
+                case 1062:
+                    return DatabaseError.uniqueViolation(message, error);
+                case 'ER_ROW_IS_REFERENCED':
+                case 'ER_NO_REFERENCED_ROW':
+                case 1451:
+                case 1452:
+                    return DatabaseError.foreignKeyViolation(message, error);
+                case 'ER_BAD_NULL_ERROR':
+                case 1048:
+                    return new DatabaseError(message, enums_1.DatabaseErrorType.NOT_NULL_VIOLATION, error);
+                case 'ER_ACCESS_DENIED_ERROR':
+                case 1045:
+                    return new DatabaseError(message, enums_1.DatabaseErrorType.AUTHENTICATION_ERROR, error);
+                case 'ER_NO_SUCH_TABLE':
+                case 1146:
+                    return DatabaseError.schemaError(message, error);
+                default:
+                    return DatabaseError.queryError(message, error);
+            }
+        }
+        // Map MongoDB error codes
+        if (databaseType === 'mongodb') {
+            switch (code) {
+                case 11000: // duplicate key
+                    return DatabaseError.uniqueViolation(message, error);
+                case 18: // authentication failed
+                    return new DatabaseError(message, enums_1.DatabaseErrorType.AUTHENTICATION_ERROR, error);
+                default:
+                    return DatabaseError.queryError(message, error);
+            }
+        }
+        // Default mapping
+        return DatabaseError.queryError(message, error);
+    }
+}
+exports.DatabaseError = DatabaseError;
+//# sourceMappingURL=database-error.js.map

package/dist/database/utils/database-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-error.js","sourceRoot":"","sources":["../../../src/database/utils/database-error.ts"],"names":[],"mappings":"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"}

package/dist/database/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utils Module
+ *
+ * Exports utility classes and functions.
+ */
+export { DatabaseError } from './database-error';