@plyaz/types 1.18.0 → 1.18.2

package/dist/db/dbEnums.d.ts

@@ -87,7 +87,9 @@ export declare enum ADAPTERS {
     /** Supabase adapter (PostgreSQL backend with REST + Realtime APIs) */
     SUPABASE = "supabase",
     /** Raw SQL adapter (direct database queries without ORM) */
-    SQL = "sql"
+    SQL = "sql",
+    /** Mock adapter (in-memory database for testing) */
+    MOCK = "mock"
 }
 export declare enum DATABASE_EVENT_TYPE {
     BeforeQuery = "beforeQuery",
@@ -143,9 +145,34 @@ export declare enum ALERT_SOURCE {
  * Audit operation types
  */
 export declare enum AUDIT_OPERATION {
-    CREATE = "CREATE",
-    UPDATE = "UPDATE",
-    DELETE = "DELETE"
+    Create = "CREATE",
+    Update = "UPDATE",
+    Delete = "DELETE",
+    CreateFailed = "CREATE_FAILED",
+    UpdateFailed = "UPDATE_FAILED",
+    DeleteFailed = "DELETE_FAILED"
+}
+/**
+ * Extension source identifiers for audit logging
+ * Used to track which extension caused an operation failure
+ */
+export declare enum EXTENSION_SOURCE {
+    /** Base database adapter (Drizzle, Supabase, SQL, Mock) */
+    DatabaseAdapter = "DatabaseAdapter",
+    /** Encryption extension - field-level encryption */
+    Encryption = "EncryptionExtension",
+    /** Soft delete extension - logical deletion */
+    SoftDelete = "SoftDeleteExtension",
+    /** Caching extension - query result caching */
+    Caching = "CachingExtension",
+    /** Audit extension - operation logging */
+    Audit = "AuditExtension",
+    /** Read replica extension - read/write splitting */
+    ReadReplica = "ReadReplicaExtension",
+    /** Multi-write extension - write replication */
+    MultiWrite = "MultiWriteExtension",
+    /** Unknown source */
+    Unknown = "Unknown"
 }
 /**
  * Database Adapter Types - Enum for adapter selection
@@ -153,5 +180,6 @@ export declare enum AUDIT_OPERATION {
 export declare enum ADAPTER_TYPES {
     DRIZZLE = "drizzle",
     SUPABASE = "supabase",
-    SQL = "sql"
+    SQL = "sql",
+    MOCK = "mock"
 }

package/dist/db/extensions.types.d.ts

@@ -0,0 +1,35 @@
+import type { DatabaseAdapterType } from './databaseAdapter';
+/**
+ * Configuration for multi-read extension
+ * Enables reading from multiple replica databases with load balancing
+ */
+export interface MultiReadConfig {
+    /** Enable multi-read extension */
+    enabled: boolean;
+    /** Read replica adapters */
+    adapters: DatabaseAdapterType[];
+    /** Load balancing strategy */
+    strategy?: 'round-robin' | 'random' | 'fastest' | 'least-conn';
+    /** Fallback to primary on replica failure */
+    fallbackToPrimary?: boolean;
+    /** Health check interval in milliseconds */
+    healthCheckInterval?: number;
+    /** Max failures before marking replica unhealthy */
+    maxFailures?: number;
+}
+/**
+ * Configuration for multi-write extension
+ * Enables writing to multiple databases for redundancy/replication
+ */
+export interface MultiWriteConfig {
+    /** Enable multi-write extension */
+    enabled: boolean;
+    /** Secondary adapters to replicate writes to */
+    adapters: DatabaseAdapterType[];
+    /** Write mode: 'best-effort' (async, non-blocking) or 'strict' (sync, all must succeed) */
+    mode?: 'best-effort' | 'strict';
+    /** Behavior on secondary failure: 'log' (silent), 'warn' (console.warn), 'throw' (error) */
+    onSecondaryFailure?: 'log' | 'warn' | 'throw';
+    /** Timeout for secondary writes in milliseconds */
+    timeout?: number;
+}

package/dist/db/features-config.types.d.ts

@@ -88,7 +88,7 @@ export interface SoftDeleteConfig {
 export interface DBEncryptionConfig {
     /** Whether encryption is enabled */
     enabled: boolean;
-    /** Base64 encoded encryption key */
+    /** Base64 encoded encryption key - must be 32 bytes for AES-256 */
     key: string;
     /** Fields to encrypt per table */
     fields: Record<string, string[]>;
@@ -103,14 +103,20 @@ export interface DBEncryptionConfig {
 export interface AuditConfig {
     /** Whether audit logging is enabled */
     enabled: boolean;
-    /** Number of days to retain audit logs (default: 90) */
+    /** Number of days to retain audit logs (default: 180 for GDPR/SOX compliance) */
     retentionDays?: number;
     /** Fields to exclude from audit logs */
     excludeFields?: string[];
     /** Tables to exclude from audit logging */
     excludeTables?: string[];
+    /** Database schema for audit tables (default: 'audit') */
+    schema?: string;
+    /** Use daily partitioned tables (audit_log_yyyy_mm_dd format) (default: true) */
+    usePartitionedTables?: boolean;
     /** Custom audit event handler */
     onAuditAfterWrite?: (event: AuditEvent) => void | Promise<void>;
+    /** Encrypted fields config from encryption extension (for audit metadata) */
+    encryptedFields?: Record<string, string[]>;
 }
 /**
  * Configuration for automatic timestamps
@@ -204,21 +210,35 @@ export interface DrizzleConfig {
     url?: string;
     poolSize?: number;
     ssl?: boolean;
+    /** Default schema for all tables (e.g., 'test', 'public') */
+    schema?: string;
+    /** Table ID column mappings for auto-detection */
+    tableIdColumns?: Record<string, string>;
 }
 export interface SupabaseConfig {
     supabaseUrl: string;
     supabaseAnonKey: string;
     supabaseServiceKey?: string;
     schema?: string;
+    /** Table ID column mappings for auto-detection */
+    tableIdColumns?: Record<string, string>;
 }
 export interface SqlConfig {
     connectionString?: string;
     url?: string;
     dialect?: 'postgresql' | 'mysql' | 'sqlite';
+    /** Default schema for all tables (e.g., 'test', 'public') */
+    schema?: string;
+    /** Table ID column mappings for auto-detection */
+    tableIdColumns?: Record<string, string>;
 }
 export interface MockConfig {
     logging?: boolean;
     initialData?: Record<string, Record<string, string | number | boolean | Date>[]>;
+    /** Default schema for all tables */
+    schema?: string;
+    /** Table ID column mappings for auto-detection */
+    tableIdColumns?: Record<string, string>;
 }
 /**
  * Union type for adapter configurations
@@ -238,12 +258,18 @@ export interface OperationConfig {
     cache?: Partial<DBCacheConfig>;
     /** Force specific adapter usage */
     forceAdapter?: 'primary' | 'replica';
+    /** Use a specific named adapter for this operation (from DbService.adapters config) */
+    adapter?: string;
     /** Include soft-deleted records in results */
     includeSoftDeleted?: boolean;
     /** Override query timeout for this operation */
     timeout?: number;
     /** Override timestamp settings for this operation */
     timestamps?: Partial<TimestampsConfig>;
+    /** Override ID column name for this operation (default: 'id') */
+    idColumn?: string;
+    /** Override database schema for this operation */
+    schema?: string;
 }
 /**
  * Complete database service configuration

package/dist/db/health.types.d.ts

@@ -0,0 +1,16 @@
+import type { DatabaseAdapterType } from './databaseAdapter';
+/**
+ * Configuration for HealthManager with auto-failover support
+ */
+export interface HealthManagerConfig {
+    /** Primary adapter */
+    primary: DatabaseAdapterType;
+    /** Backup adapters for failover */
+    backups?: DatabaseAdapterType[];
+    /** Health check interval in milliseconds */
+    healthCheckInterval?: number;
+    /** Number of consecutive failures before failover */
+    failoverThreshold?: number;
+    /** Enable automatic failover */
+    autoFailover?: boolean;
+}

package/dist/db/index.cjs

@@ -8,6 +8,7 @@ var ADAPTERS = /* @__PURE__ */ ((ADAPTERS2) => {
   ADAPTERS2["DRIZZLE"] = "drizzle";
   ADAPTERS2["SUPABASE"] = "supabase";
   ADAPTERS2["SQL"] = "sql";
+  ADAPTERS2["MOCK"] = "mock";
   return ADAPTERS2;
 })(ADAPTERS || {});
 var DATABASE_EVENT_TYPE = /* @__PURE__ */ ((DATABASE_EVENT_TYPE2) => {
@@ -50,15 +51,30 @@ var ALERT_SOURCE = /* @__PURE__ */ ((ALERT_SOURCE2) => {
   return ALERT_SOURCE2;
 })(ALERT_SOURCE || {});
 var AUDIT_OPERATION = /* @__PURE__ */ ((AUDIT_OPERATION2) => {
-  AUDIT_OPERATION2["CREATE"] = "CREATE";
-  AUDIT_OPERATION2["UPDATE"] = "UPDATE";
-  AUDIT_OPERATION2["DELETE"] = "DELETE";
+  AUDIT_OPERATION2["Create"] = "CREATE";
+  AUDIT_OPERATION2["Update"] = "UPDATE";
+  AUDIT_OPERATION2["Delete"] = "DELETE";
+  AUDIT_OPERATION2["CreateFailed"] = "CREATE_FAILED";
+  AUDIT_OPERATION2["UpdateFailed"] = "UPDATE_FAILED";
+  AUDIT_OPERATION2["DeleteFailed"] = "DELETE_FAILED";
   return AUDIT_OPERATION2;
 })(AUDIT_OPERATION || {});
+var EXTENSION_SOURCE = /* @__PURE__ */ ((EXTENSION_SOURCE2) => {
+  EXTENSION_SOURCE2["DatabaseAdapter"] = "DatabaseAdapter";
+  EXTENSION_SOURCE2["Encryption"] = "EncryptionExtension";
+  EXTENSION_SOURCE2["SoftDelete"] = "SoftDeleteExtension";
+  EXTENSION_SOURCE2["Caching"] = "CachingExtension";
+  EXTENSION_SOURCE2["Audit"] = "AuditExtension";
+  EXTENSION_SOURCE2["ReadReplica"] = "ReadReplicaExtension";
+  EXTENSION_SOURCE2["MultiWrite"] = "MultiWriteExtension";
+  EXTENSION_SOURCE2["Unknown"] = "Unknown";
+  return EXTENSION_SOURCE2;
+})(EXTENSION_SOURCE || {});
 var ADAPTER_TYPES = /* @__PURE__ */ ((ADAPTER_TYPES2) => {
   ADAPTER_TYPES2["DRIZZLE"] = "drizzle";
   ADAPTER_TYPES2["SUPABASE"] = "supabase";
   ADAPTER_TYPES2["SQL"] = "sql";
+  ADAPTER_TYPES2["MOCK"] = "mock";
   return ADAPTER_TYPES2;
 })(ADAPTER_TYPES || {});
 
@@ -88,6 +104,7 @@ exports.AUDIT_OPERATION = AUDIT_OPERATION;
 exports.DATABASE_EVENT_TYPE = DATABASE_EVENT_TYPE;
 exports.DB_POOL_EVENTS = DB_POOL_EVENTS;
 exports.ENCRYPTION_DEFAULTS = ENCRYPTION_DEFAULTS;
+exports.EXTENSION_SOURCE = EXTENSION_SOURCE;
 exports.REPLICA_STRATEGY = REPLICA_STRATEGY;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/db/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/db/dbEnums.ts","../../src/db/dbConstant.ts"],"names":["ADAPTERS","DATABASE_EVENT_TYPE","REPLICA_STRATEGY","DB_POOL_EVENTS","ALERT_SEVERITY","ALERT_SOURCE","AUDIT_OPERATION","ADAPTER_TYPES"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @fileoverview Database adapter type definitions\n *\n * Defines the enumeration of supported database adapter types used throughout\n * the database package. This enum provides type-safe identification of different\n * database integrations and is used in configuration, factory methods, and\n * adapter selection logic.\n *\n * **Application Flow Context:**\n * ```\n * Configuration → ADAPTERS Enum → AdapterFactory → Concrete Adapter\n *      ↓             ↓              ↓               ↓\n * User Config  → Type Safety   → Adapter Creation → Database Connection\n * ```\n *\n * **Adapter Types:**\n * - **DRIZZLE**: Type-safe ORM with excellent TypeScript support\n * - **SUPABASE**: Hosted PostgreSQL with real-time capabilities\n * - **SQL**: Raw SQL execution for maximum control\n * - **DATABASE**: Generic fallback adapter\n *\n * @example\n * ```typescript\n * // Adapter selection in configuration\n * const config = {\n *   adapter: ADAPTERS.DRIZZLE,\n *   connectionString: process.env.DATABASE_URL\n * };\n *\n * // Type-safe adapter factory usage\n * const adapter = AdapterFactory.create(ADAPTERS.SUPABASE, supabaseConfig);\n *\n * // Switch statement with exhaustive checking\n * switch (config.adapter) {\n *   case ADAPTERS.DRIZZLE:\n *     // Handle Drizzle-specific logic\n *     break;\n *   case ADAPTERS.SUPABASE:\n *     // Handle Supabase-specific logic\n *     break;\n *   case ADAPTERS.SQL:\n *     // Handle SQL-specific logic\n *     break;\n *   default:\n *     // TypeScript ensures all cases are handled\n *     throw new Error(`Unsupported adapter: ${config.adapter}`);\n * }\n * ```\n *\n */\n/**\n * @enum ADAPTERS\n * @description\n * Enumeration of supported database adapter types.\n *\n * This enum provides type-safe identification of different database integrations\n * and is used throughout the package for configuration, factory methods, and\n * adapter selection. Each adapter type represents a different approach to\n * database connectivity and operations.\n *\n * **Adapter Characteristics:**\n * - **DATABASE**: Generic fallback, minimal functionality\n * - **DRIZZLE**: Full ORM with type safety and query building\n * - **SUPABASE**: Hosted solution with real-time and auth features\n * - **SQL**: Raw SQL for performance-critical applications\n *\n * @example\n * ```typescript\n * // Configuration with adapter selection\n * const configs = {\n *   development: { adapter: ADAPTERS.DRIZZLE },\n *   production: { adapter: ADAPTERS.SUPABASE },\n *   performance: { adapter: ADAPTERS.SQL }\n * };\n *\n * // Type-safe adapter validation\n * function validateAdapter(adapter: ADAPTERS): boolean {\n *   return Object.values(ADAPTERS).includes(adapter);\n * }\n * ```\n */\nexport enum ADAPTERS {\n  /** Generic database adapter (default when no specific integration is set) */\n  DATABASE = 'database',\n\n  /** Drizzle ORM adapter (PostgreSQL, MySQL, SQLite, etc.) */\n  DRIZZLE = 'drizzle',\n\n  /** Supabase adapter (PostgreSQL backend with REST + Realtime APIs) */\n  SUPABASE = 'supabase',\n\n  /** Raw SQL adapter (direct database queries without ORM) */\n  SQL = 'sql',\n}\n\n// Event type enum\nexport enum DATABASE_EVENT_TYPE {\n  BeforeQuery = 'beforeQuery',\n  AfterQuery = 'afterQuery',\n  QueryError = 'queryError',\n  BeforeTransaction = 'beforeTransaction',\n  AfterTransaction = 'afterTransaction',\n  TransactionRollback = 'transactionRollback',\n  HealthChange = 'healthChange',\n}\n\n/**\n * Strategy options for replica selection.\n */\nexport enum REPLICA_STRATEGY {\n  /** Always use primary database */\n  PRIMARY = 'primary',\n  /** Use any available replica */\n  REPLICA = 'replica',\n  /** Use geographically closest replica */\n  CLOSEST = 'closest',\n  /** Use fastest responding replica */\n  FASTEST = 'fastest',\n}\n\n/**\n * Enum for pool event types.\n */\nexport enum DB_POOL_EVENTS {\n  CONNECT = 'connect',\n  ACQUIRE = 'acquire',\n  RELEASE = 'release',\n  REMOVE = 'remove',\n}\n\n/**\n * Alert severity levels\n */\nexport enum ALERT_SEVERITY {\n  CRITICAL = 'critical',\n  ERROR = 'error',\n  WARNING = 'warning',\n  INFO = 'info',\n}\n\n/**\n * Alert source types\n */\nexport enum ALERT_SOURCE {\n  DATABASE = 'database',\n  POOL = 'pool',\n  REPLICA = 'replica',\n  CACHE = 'cache',\n  BACKUP = 'backup',\n}\n\n/**\n * Audit operation types\n */\nexport enum AUDIT_OPERATION {\n  CREATE = 'CREATE',\n  UPDATE = 'UPDATE',\n  DELETE = 'DELETE',\n}\n\n/**\n * Database Adapter Types - Enum for adapter selection\n */\nexport enum ADAPTER_TYPES {\n  DRIZZLE = 'drizzle',\n  SUPABASE = 'supabase',\n  SQL = 'sql',\n}\n","/**\n * Encryption Extension Constants\n *\n * Centralized constants for encryption configuration to prevent\n * hardcoded values and ensure consistency across the codebase.\n */\n\nexport const ENCRYPTION_DEFAULTS = {\n  /** Default encryption algorithm - AES-256-GCM provides authenticated encryption */\n  ALGORITHM: 'aes-256-gcm' as const,\n\n  /** IV length for AES-256-GCM in bytes */\n  IV_LENGTH: 16,\n\n  /** Expected parts in encrypted text format (iv:authTag:encrypted) */\n  ENCRYPTED_PARTS_COUNT: 3,\n\n  /** Default encryption key for testing (32 bytes for AES-256) */\n  DEFAULT_KEY: 'abcdefghijklmnopqrstuvwxyz123456',\n} as const;\n\n/**\n * Alert rule IDs\n */\nexport const ALERT_RULE_ID = {\n  POOL_EXHAUSTION: 'pool-exhaustion',\n  SLOW_QUERY: 'slow-query',\n  REPLICA_LAG: 'replica-lag',\n} as const;\n"]}
+{"version":3,"sources":["../../src/db/dbEnums.ts","../../src/db/dbConstant.ts"],"names":["ADAPTERS","DATABASE_EVENT_TYPE","REPLICA_STRATEGY","DB_POOL_EVENTS","ALERT_SEVERITY","ALERT_SOURCE","AUDIT_OPERATION","EXTENSION_SOURCE","ADAPTER_TYPES"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @fileoverview Database adapter type definitions\n *\n * Defines the enumeration of supported database adapter types used throughout\n * the database package. This enum provides type-safe identification of different\n * database integrations and is used in configuration, factory methods, and\n * adapter selection logic.\n *\n * **Application Flow Context:**\n * ```\n * Configuration → ADAPTERS Enum → AdapterFactory → Concrete Adapter\n *      ↓             ↓              ↓               ↓\n * User Config  → Type Safety   → Adapter Creation → Database Connection\n * ```\n *\n * **Adapter Types:**\n * - **DRIZZLE**: Type-safe ORM with excellent TypeScript support\n * - **SUPABASE**: Hosted PostgreSQL with real-time capabilities\n * - **SQL**: Raw SQL execution for maximum control\n * - **DATABASE**: Generic fallback adapter\n *\n * @example\n * ```typescript\n * // Adapter selection in configuration\n * const config = {\n *   adapter: ADAPTERS.DRIZZLE,\n *   connectionString: process.env.DATABASE_URL\n * };\n *\n * // Type-safe adapter factory usage\n * const adapter = AdapterFactory.create(ADAPTERS.SUPABASE, supabaseConfig);\n *\n * // Switch statement with exhaustive checking\n * switch (config.adapter) {\n *   case ADAPTERS.DRIZZLE:\n *     // Handle Drizzle-specific logic\n *     break;\n *   case ADAPTERS.SUPABASE:\n *     // Handle Supabase-specific logic\n *     break;\n *   case ADAPTERS.SQL:\n *     // Handle SQL-specific logic\n *     break;\n *   default:\n *     // TypeScript ensures all cases are handled\n *     throw new Error(`Unsupported adapter: ${config.adapter}`);\n * }\n * ```\n *\n */\n/**\n * @enum ADAPTERS\n * @description\n * Enumeration of supported database adapter types.\n *\n * This enum provides type-safe identification of different database integrations\n * and is used throughout the package for configuration, factory methods, and\n * adapter selection. Each adapter type represents a different approach to\n * database connectivity and operations.\n *\n * **Adapter Characteristics:**\n * - **DATABASE**: Generic fallback, minimal functionality\n * - **DRIZZLE**: Full ORM with type safety and query building\n * - **SUPABASE**: Hosted solution with real-time and auth features\n * - **SQL**: Raw SQL for performance-critical applications\n *\n * @example\n * ```typescript\n * // Configuration with adapter selection\n * const configs = {\n *   development: { adapter: ADAPTERS.DRIZZLE },\n *   production: { adapter: ADAPTERS.SUPABASE },\n *   performance: { adapter: ADAPTERS.SQL }\n * };\n *\n * // Type-safe adapter validation\n * function validateAdapter(adapter: ADAPTERS): boolean {\n *   return Object.values(ADAPTERS).includes(adapter);\n * }\n * ```\n */\nexport enum ADAPTERS {\n  /** Generic database adapter (default when no specific integration is set) */\n  DATABASE = 'database',\n\n  /** Drizzle ORM adapter (PostgreSQL, MySQL, SQLite, etc.) */\n  DRIZZLE = 'drizzle',\n\n  /** Supabase adapter (PostgreSQL backend with REST + Realtime APIs) */\n  SUPABASE = 'supabase',\n\n  /** Raw SQL adapter (direct database queries without ORM) */\n  SQL = 'sql',\n\n  /** Mock adapter (in-memory database for testing) */\n  MOCK = 'mock',\n}\n\n// Event type enum\nexport enum DATABASE_EVENT_TYPE {\n  BeforeQuery = 'beforeQuery',\n  AfterQuery = 'afterQuery',\n  QueryError = 'queryError',\n  BeforeTransaction = 'beforeTransaction',\n  AfterTransaction = 'afterTransaction',\n  TransactionRollback = 'transactionRollback',\n  HealthChange = 'healthChange',\n}\n\n/**\n * Strategy options for replica selection.\n */\nexport enum REPLICA_STRATEGY {\n  /** Always use primary database */\n  PRIMARY = 'primary',\n  /** Use any available replica */\n  REPLICA = 'replica',\n  /** Use geographically closest replica */\n  CLOSEST = 'closest',\n  /** Use fastest responding replica */\n  FASTEST = 'fastest',\n}\n\n/**\n * Enum for pool event types.\n */\nexport enum DB_POOL_EVENTS {\n  CONNECT = 'connect',\n  ACQUIRE = 'acquire',\n  RELEASE = 'release',\n  REMOVE = 'remove',\n}\n\n/**\n * Alert severity levels\n */\nexport enum ALERT_SEVERITY {\n  CRITICAL = 'critical',\n  ERROR = 'error',\n  WARNING = 'warning',\n  INFO = 'info',\n}\n\n/**\n * Alert source types\n */\nexport enum ALERT_SOURCE {\n  DATABASE = 'database',\n  POOL = 'pool',\n  REPLICA = 'replica',\n  CACHE = 'cache',\n  BACKUP = 'backup',\n}\n\n/**\n * Audit operation types\n */\nexport enum AUDIT_OPERATION {\n  Create = 'CREATE',\n  Update = 'UPDATE',\n  Delete = 'DELETE',\n  CreateFailed = 'CREATE_FAILED',\n  UpdateFailed = 'UPDATE_FAILED',\n  DeleteFailed = 'DELETE_FAILED',\n}\n\n/**\n * Extension source identifiers for audit logging\n * Used to track which extension caused an operation failure\n */\nexport enum EXTENSION_SOURCE {\n  /** Base database adapter (Drizzle, Supabase, SQL, Mock) */\n  DatabaseAdapter = 'DatabaseAdapter',\n  /** Encryption extension - field-level encryption */\n  Encryption = 'EncryptionExtension',\n  /** Soft delete extension - logical deletion */\n  SoftDelete = 'SoftDeleteExtension',\n  /** Caching extension - query result caching */\n  Caching = 'CachingExtension',\n  /** Audit extension - operation logging */\n  Audit = 'AuditExtension',\n  /** Read replica extension - read/write splitting */\n  ReadReplica = 'ReadReplicaExtension',\n  /** Multi-write extension - write replication */\n  MultiWrite = 'MultiWriteExtension',\n  /** Unknown source */\n  Unknown = 'Unknown',\n}\n\n/**\n * Database Adapter Types - Enum for adapter selection\n */\nexport enum ADAPTER_TYPES {\n  DRIZZLE = 'drizzle',\n  SUPABASE = 'supabase',\n  SQL = 'sql',\n  MOCK = 'mock',\n}\n","/**\n * Encryption Extension Constants\n *\n * Centralized constants for encryption configuration to prevent\n * hardcoded values and ensure consistency across the codebase.\n */\n\nexport const ENCRYPTION_DEFAULTS = {\n  /** Default encryption algorithm - AES-256-GCM provides authenticated encryption */\n  ALGORITHM: 'aes-256-gcm' as const,\n\n  /** IV length for AES-256-GCM in bytes */\n  IV_LENGTH: 16,\n\n  /** Expected parts in encrypted text format (iv:authTag:encrypted) */\n  ENCRYPTED_PARTS_COUNT: 3,\n\n  /** Default encryption key for testing (32 bytes for AES-256) */\n  DEFAULT_KEY: 'abcdefghijklmnopqrstuvwxyz123456',\n} as const;\n\n/**\n * Alert rule IDs\n */\nexport const ALERT_RULE_ID = {\n  POOL_EXHAUSTION: 'pool-exhaustion',\n  SLOW_QUERY: 'slow-query',\n  REPLICA_LAG: 'replica-lag',\n} as const;\n"]}

package/dist/db/index.d.ts

@@ -13,3 +13,8 @@ export type * from './backup.types';
 export type * from './replica.types';
 export * from './dbEnums';
 export * from './dbConstant';
+export type * from './extensions.types';
+export type * from './migrations.types';
+export type * from './seeds.types';
+export type * from './health.types';
+export type * from './tenant.types';

package/dist/db/index.js

@@ -6,6 +6,7 @@ var ADAPTERS = /* @__PURE__ */ ((ADAPTERS2) => {
   ADAPTERS2["DRIZZLE"] = "drizzle";
   ADAPTERS2["SUPABASE"] = "supabase";
   ADAPTERS2["SQL"] = "sql";
+  ADAPTERS2["MOCK"] = "mock";
   return ADAPTERS2;
 })(ADAPTERS || {});
 var DATABASE_EVENT_TYPE = /* @__PURE__ */ ((DATABASE_EVENT_TYPE2) => {
@@ -48,15 +49,30 @@ var ALERT_SOURCE = /* @__PURE__ */ ((ALERT_SOURCE2) => {
   return ALERT_SOURCE2;
 })(ALERT_SOURCE || {});
 var AUDIT_OPERATION = /* @__PURE__ */ ((AUDIT_OPERATION2) => {
-  AUDIT_OPERATION2["CREATE"] = "CREATE";
-  AUDIT_OPERATION2["UPDATE"] = "UPDATE";
-  AUDIT_OPERATION2["DELETE"] = "DELETE";
+  AUDIT_OPERATION2["Create"] = "CREATE";
+  AUDIT_OPERATION2["Update"] = "UPDATE";
+  AUDIT_OPERATION2["Delete"] = "DELETE";
+  AUDIT_OPERATION2["CreateFailed"] = "CREATE_FAILED";
+  AUDIT_OPERATION2["UpdateFailed"] = "UPDATE_FAILED";
+  AUDIT_OPERATION2["DeleteFailed"] = "DELETE_FAILED";
   return AUDIT_OPERATION2;
 })(AUDIT_OPERATION || {});
+var EXTENSION_SOURCE = /* @__PURE__ */ ((EXTENSION_SOURCE2) => {
+  EXTENSION_SOURCE2["DatabaseAdapter"] = "DatabaseAdapter";
+  EXTENSION_SOURCE2["Encryption"] = "EncryptionExtension";
+  EXTENSION_SOURCE2["SoftDelete"] = "SoftDeleteExtension";
+  EXTENSION_SOURCE2["Caching"] = "CachingExtension";
+  EXTENSION_SOURCE2["Audit"] = "AuditExtension";
+  EXTENSION_SOURCE2["ReadReplica"] = "ReadReplicaExtension";
+  EXTENSION_SOURCE2["MultiWrite"] = "MultiWriteExtension";
+  EXTENSION_SOURCE2["Unknown"] = "Unknown";
+  return EXTENSION_SOURCE2;
+})(EXTENSION_SOURCE || {});
 var ADAPTER_TYPES = /* @__PURE__ */ ((ADAPTER_TYPES2) => {
   ADAPTER_TYPES2["DRIZZLE"] = "drizzle";
   ADAPTER_TYPES2["SUPABASE"] = "supabase";
   ADAPTER_TYPES2["SQL"] = "sql";
+  ADAPTER_TYPES2["MOCK"] = "mock";
   return ADAPTER_TYPES2;
 })(ADAPTER_TYPES || {});
 
@@ -77,6 +93,6 @@ var ALERT_RULE_ID = {
   REPLICA_LAG: "replica-lag"
 };
 
-export { ADAPTERS, ADAPTER_TYPES, ALERT_RULE_ID, ALERT_SEVERITY, ALERT_SOURCE, AUDIT_OPERATION, DATABASE_EVENT_TYPE, DB_POOL_EVENTS, ENCRYPTION_DEFAULTS, REPLICA_STRATEGY };
+export { ADAPTERS, ADAPTER_TYPES, ALERT_RULE_ID, ALERT_SEVERITY, ALERT_SOURCE, AUDIT_OPERATION, DATABASE_EVENT_TYPE, DB_POOL_EVENTS, ENCRYPTION_DEFAULTS, EXTENSION_SOURCE, REPLICA_STRATEGY };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/db/dbEnums.ts","../../src/db/dbConstant.ts"],"names":["ADAPTERS","DATABASE_EVENT_TYPE","REPLICA_STRATEGY","DB_POOL_EVENTS","ALERT_SEVERITY","ALERT_SOURCE","AUDIT_OPERATION","ADAPTER_TYPES"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @fileoverview Database adapter type definitions\n *\n * Defines the enumeration of supported database adapter types used throughout\n * the database package. This enum provides type-safe identification of different\n * database integrations and is used in configuration, factory methods, and\n * adapter selection logic.\n *\n * **Application Flow Context:**\n * ```\n * Configuration → ADAPTERS Enum → AdapterFactory → Concrete Adapter\n *      ↓             ↓              ↓               ↓\n * User Config  → Type Safety   → Adapter Creation → Database Connection\n * ```\n *\n * **Adapter Types:**\n * - **DRIZZLE**: Type-safe ORM with excellent TypeScript support\n * - **SUPABASE**: Hosted PostgreSQL with real-time capabilities\n * - **SQL**: Raw SQL execution for maximum control\n * - **DATABASE**: Generic fallback adapter\n *\n * @example\n * ```typescript\n * // Adapter selection in configuration\n * const config = {\n *   adapter: ADAPTERS.DRIZZLE,\n *   connectionString: process.env.DATABASE_URL\n * };\n *\n * // Type-safe adapter factory usage\n * const adapter = AdapterFactory.create(ADAPTERS.SUPABASE, supabaseConfig);\n *\n * // Switch statement with exhaustive checking\n * switch (config.adapter) {\n *   case ADAPTERS.DRIZZLE:\n *     // Handle Drizzle-specific logic\n *     break;\n *   case ADAPTERS.SUPABASE:\n *     // Handle Supabase-specific logic\n *     break;\n *   case ADAPTERS.SQL:\n *     // Handle SQL-specific logic\n *     break;\n *   default:\n *     // TypeScript ensures all cases are handled\n *     throw new Error(`Unsupported adapter: ${config.adapter}`);\n * }\n * ```\n *\n */\n/**\n * @enum ADAPTERS\n * @description\n * Enumeration of supported database adapter types.\n *\n * This enum provides type-safe identification of different database integrations\n * and is used throughout the package for configuration, factory methods, and\n * adapter selection. Each adapter type represents a different approach to\n * database connectivity and operations.\n *\n * **Adapter Characteristics:**\n * - **DATABASE**: Generic fallback, minimal functionality\n * - **DRIZZLE**: Full ORM with type safety and query building\n * - **SUPABASE**: Hosted solution with real-time and auth features\n * - **SQL**: Raw SQL for performance-critical applications\n *\n * @example\n * ```typescript\n * // Configuration with adapter selection\n * const configs = {\n *   development: { adapter: ADAPTERS.DRIZZLE },\n *   production: { adapter: ADAPTERS.SUPABASE },\n *   performance: { adapter: ADAPTERS.SQL }\n * };\n *\n * // Type-safe adapter validation\n * function validateAdapter(adapter: ADAPTERS): boolean {\n *   return Object.values(ADAPTERS).includes(adapter);\n * }\n * ```\n */\nexport enum ADAPTERS {\n  /** Generic database adapter (default when no specific integration is set) */\n  DATABASE = 'database',\n\n  /** Drizzle ORM adapter (PostgreSQL, MySQL, SQLite, etc.) */\n  DRIZZLE = 'drizzle',\n\n  /** Supabase adapter (PostgreSQL backend with REST + Realtime APIs) */\n  SUPABASE = 'supabase',\n\n  /** Raw SQL adapter (direct database queries without ORM) */\n  SQL = 'sql',\n}\n\n// Event type enum\nexport enum DATABASE_EVENT_TYPE {\n  BeforeQuery = 'beforeQuery',\n  AfterQuery = 'afterQuery',\n  QueryError = 'queryError',\n  BeforeTransaction = 'beforeTransaction',\n  AfterTransaction = 'afterTransaction',\n  TransactionRollback = 'transactionRollback',\n  HealthChange = 'healthChange',\n}\n\n/**\n * Strategy options for replica selection.\n */\nexport enum REPLICA_STRATEGY {\n  /** Always use primary database */\n  PRIMARY = 'primary',\n  /** Use any available replica */\n  REPLICA = 'replica',\n  /** Use geographically closest replica */\n  CLOSEST = 'closest',\n  /** Use fastest responding replica */\n  FASTEST = 'fastest',\n}\n\n/**\n * Enum for pool event types.\n */\nexport enum DB_POOL_EVENTS {\n  CONNECT = 'connect',\n  ACQUIRE = 'acquire',\n  RELEASE = 'release',\n  REMOVE = 'remove',\n}\n\n/**\n * Alert severity levels\n */\nexport enum ALERT_SEVERITY {\n  CRITICAL = 'critical',\n  ERROR = 'error',\n  WARNING = 'warning',\n  INFO = 'info',\n}\n\n/**\n * Alert source types\n */\nexport enum ALERT_SOURCE {\n  DATABASE = 'database',\n  POOL = 'pool',\n  REPLICA = 'replica',\n  CACHE = 'cache',\n  BACKUP = 'backup',\n}\n\n/**\n * Audit operation types\n */\nexport enum AUDIT_OPERATION {\n  CREATE = 'CREATE',\n  UPDATE = 'UPDATE',\n  DELETE = 'DELETE',\n}\n\n/**\n * Database Adapter Types - Enum for adapter selection\n */\nexport enum ADAPTER_TYPES {\n  DRIZZLE = 'drizzle',\n  SUPABASE = 'supabase',\n  SQL = 'sql',\n}\n","/**\n * Encryption Extension Constants\n *\n * Centralized constants for encryption configuration to prevent\n * hardcoded values and ensure consistency across the codebase.\n */\n\nexport const ENCRYPTION_DEFAULTS = {\n  /** Default encryption algorithm - AES-256-GCM provides authenticated encryption */\n  ALGORITHM: 'aes-256-gcm' as const,\n\n  /** IV length for AES-256-GCM in bytes */\n  IV_LENGTH: 16,\n\n  /** Expected parts in encrypted text format (iv:authTag:encrypted) */\n  ENCRYPTED_PARTS_COUNT: 3,\n\n  /** Default encryption key for testing (32 bytes for AES-256) */\n  DEFAULT_KEY: 'abcdefghijklmnopqrstuvwxyz123456',\n} as const;\n\n/**\n * Alert rule IDs\n */\nexport const ALERT_RULE_ID = {\n  POOL_EXHAUSTION: 'pool-exhaustion',\n  SLOW_QUERY: 'slow-query',\n  REPLICA_LAG: 'replica-lag',\n} as const;\n"]}
+{"version":3,"sources":["../../src/db/dbEnums.ts","../../src/db/dbConstant.ts"],"names":["ADAPTERS","DATABASE_EVENT_TYPE","REPLICA_STRATEGY","DB_POOL_EVENTS","ALERT_SEVERITY","ALERT_SOURCE","AUDIT_OPERATION","EXTENSION_SOURCE","ADAPTER_TYPES"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @fileoverview Database adapter type definitions\n *\n * Defines the enumeration of supported database adapter types used throughout\n * the database package. This enum provides type-safe identification of different\n * database integrations and is used in configuration, factory methods, and\n * adapter selection logic.\n *\n * **Application Flow Context:**\n * ```\n * Configuration → ADAPTERS Enum → AdapterFactory → Concrete Adapter\n *      ↓             ↓              ↓               ↓\n * User Config  → Type Safety   → Adapter Creation → Database Connection\n * ```\n *\n * **Adapter Types:**\n * - **DRIZZLE**: Type-safe ORM with excellent TypeScript support\n * - **SUPABASE**: Hosted PostgreSQL with real-time capabilities\n * - **SQL**: Raw SQL execution for maximum control\n * - **DATABASE**: Generic fallback adapter\n *\n * @example\n * ```typescript\n * // Adapter selection in configuration\n * const config = {\n *   adapter: ADAPTERS.DRIZZLE,\n *   connectionString: process.env.DATABASE_URL\n * };\n *\n * // Type-safe adapter factory usage\n * const adapter = AdapterFactory.create(ADAPTERS.SUPABASE, supabaseConfig);\n *\n * // Switch statement with exhaustive checking\n * switch (config.adapter) {\n *   case ADAPTERS.DRIZZLE:\n *     // Handle Drizzle-specific logic\n *     break;\n *   case ADAPTERS.SUPABASE:\n *     // Handle Supabase-specific logic\n *     break;\n *   case ADAPTERS.SQL:\n *     // Handle SQL-specific logic\n *     break;\n *   default:\n *     // TypeScript ensures all cases are handled\n *     throw new Error(`Unsupported adapter: ${config.adapter}`);\n * }\n * ```\n *\n */\n/**\n * @enum ADAPTERS\n * @description\n * Enumeration of supported database adapter types.\n *\n * This enum provides type-safe identification of different database integrations\n * and is used throughout the package for configuration, factory methods, and\n * adapter selection. Each adapter type represents a different approach to\n * database connectivity and operations.\n *\n * **Adapter Characteristics:**\n * - **DATABASE**: Generic fallback, minimal functionality\n * - **DRIZZLE**: Full ORM with type safety and query building\n * - **SUPABASE**: Hosted solution with real-time and auth features\n * - **SQL**: Raw SQL for performance-critical applications\n *\n * @example\n * ```typescript\n * // Configuration with adapter selection\n * const configs = {\n *   development: { adapter: ADAPTERS.DRIZZLE },\n *   production: { adapter: ADAPTERS.SUPABASE },\n *   performance: { adapter: ADAPTERS.SQL }\n * };\n *\n * // Type-safe adapter validation\n * function validateAdapter(adapter: ADAPTERS): boolean {\n *   return Object.values(ADAPTERS).includes(adapter);\n * }\n * ```\n */\nexport enum ADAPTERS {\n  /** Generic database adapter (default when no specific integration is set) */\n  DATABASE = 'database',\n\n  /** Drizzle ORM adapter (PostgreSQL, MySQL, SQLite, etc.) */\n  DRIZZLE = 'drizzle',\n\n  /** Supabase adapter (PostgreSQL backend with REST + Realtime APIs) */\n  SUPABASE = 'supabase',\n\n  /** Raw SQL adapter (direct database queries without ORM) */\n  SQL = 'sql',\n\n  /** Mock adapter (in-memory database for testing) */\n  MOCK = 'mock',\n}\n\n// Event type enum\nexport enum DATABASE_EVENT_TYPE {\n  BeforeQuery = 'beforeQuery',\n  AfterQuery = 'afterQuery',\n  QueryError = 'queryError',\n  BeforeTransaction = 'beforeTransaction',\n  AfterTransaction = 'afterTransaction',\n  TransactionRollback = 'transactionRollback',\n  HealthChange = 'healthChange',\n}\n\n/**\n * Strategy options for replica selection.\n */\nexport enum REPLICA_STRATEGY {\n  /** Always use primary database */\n  PRIMARY = 'primary',\n  /** Use any available replica */\n  REPLICA = 'replica',\n  /** Use geographically closest replica */\n  CLOSEST = 'closest',\n  /** Use fastest responding replica */\n  FASTEST = 'fastest',\n}\n\n/**\n * Enum for pool event types.\n */\nexport enum DB_POOL_EVENTS {\n  CONNECT = 'connect',\n  ACQUIRE = 'acquire',\n  RELEASE = 'release',\n  REMOVE = 'remove',\n}\n\n/**\n * Alert severity levels\n */\nexport enum ALERT_SEVERITY {\n  CRITICAL = 'critical',\n  ERROR = 'error',\n  WARNING = 'warning',\n  INFO = 'info',\n}\n\n/**\n * Alert source types\n */\nexport enum ALERT_SOURCE {\n  DATABASE = 'database',\n  POOL = 'pool',\n  REPLICA = 'replica',\n  CACHE = 'cache',\n  BACKUP = 'backup',\n}\n\n/**\n * Audit operation types\n */\nexport enum AUDIT_OPERATION {\n  Create = 'CREATE',\n  Update = 'UPDATE',\n  Delete = 'DELETE',\n  CreateFailed = 'CREATE_FAILED',\n  UpdateFailed = 'UPDATE_FAILED',\n  DeleteFailed = 'DELETE_FAILED',\n}\n\n/**\n * Extension source identifiers for audit logging\n * Used to track which extension caused an operation failure\n */\nexport enum EXTENSION_SOURCE {\n  /** Base database adapter (Drizzle, Supabase, SQL, Mock) */\n  DatabaseAdapter = 'DatabaseAdapter',\n  /** Encryption extension - field-level encryption */\n  Encryption = 'EncryptionExtension',\n  /** Soft delete extension - logical deletion */\n  SoftDelete = 'SoftDeleteExtension',\n  /** Caching extension - query result caching */\n  Caching = 'CachingExtension',\n  /** Audit extension - operation logging */\n  Audit = 'AuditExtension',\n  /** Read replica extension - read/write splitting */\n  ReadReplica = 'ReadReplicaExtension',\n  /** Multi-write extension - write replication */\n  MultiWrite = 'MultiWriteExtension',\n  /** Unknown source */\n  Unknown = 'Unknown',\n}\n\n/**\n * Database Adapter Types - Enum for adapter selection\n */\nexport enum ADAPTER_TYPES {\n  DRIZZLE = 'drizzle',\n  SUPABASE = 'supabase',\n  SQL = 'sql',\n  MOCK = 'mock',\n}\n","/**\n * Encryption Extension Constants\n *\n * Centralized constants for encryption configuration to prevent\n * hardcoded values and ensure consistency across the codebase.\n */\n\nexport const ENCRYPTION_DEFAULTS = {\n  /** Default encryption algorithm - AES-256-GCM provides authenticated encryption */\n  ALGORITHM: 'aes-256-gcm' as const,\n\n  /** IV length for AES-256-GCM in bytes */\n  IV_LENGTH: 16,\n\n  /** Expected parts in encrypted text format (iv:authTag:encrypted) */\n  ENCRYPTED_PARTS_COUNT: 3,\n\n  /** Default encryption key for testing (32 bytes for AES-256) */\n  DEFAULT_KEY: 'abcdefghijklmnopqrstuvwxyz123456',\n} as const;\n\n/**\n * Alert rule IDs\n */\nexport const ALERT_RULE_ID = {\n  POOL_EXHAUSTION: 'pool-exhaustion',\n  SLOW_QUERY: 'slow-query',\n  REPLICA_LAG: 'replica-lag',\n} as const;\n"]}

package/dist/db/migrations.types.d.ts

@@ -0,0 +1,60 @@
+import type { DatabaseAdapterType } from './databaseAdapter';
+/**
+ * Migration definition
+ */
+export interface Migration {
+    /** Migration version (timestamp or number) */
+    version: string;
+    /** Migration name */
+    name: string;
+    /** Migration up function */
+    up: (adapter: DatabaseAdapterType) => Promise<void>;
+    /** Migration down function (rollback) */
+    down: (adapter: DatabaseAdapterType) => Promise<void>;
+}
+/**
+ * Parsed migration file metadata
+ */
+export interface MigrationFile {
+    /** Full file path */
+    filePath: string;
+    /** Migration version extracted from filename */
+    version: string;
+    /** Migration name extracted from filename */
+    name: string;
+}
+/**
+ * Migration record stored in database
+ */
+export interface MigrationRecord {
+    /** Migration version */
+    version: string;
+    /** Migration name */
+    name: string;
+    /** When migration was applied */
+    applied_at: string;
+    /** Execution time in milliseconds */
+    execution_time: number;
+}
+/**
+ * Configuration for MigrationManager
+ */
+export interface MigrationManagerConfig {
+    /** Database adapter */
+    adapter: DatabaseAdapterType;
+    /** Path to migrations directory (default: './migrations') */
+    migrationsPath?: string;
+    /** Table name for migration history (default: 'schema_migrations') */
+    tableName?: string;
+    /** Database schema to use (for multi-tenant support) */
+    schema?: string;
+}
+/**
+ * Migration status response
+ */
+export interface MigrationStatus {
+    /** Migrations that have been applied */
+    applied: MigrationRecord[];
+    /** Migrations that are pending */
+    pending: string[];
+}

package/dist/db/seeds.types.d.ts

@@ -0,0 +1,49 @@
+import type { DatabaseAdapterType } from './databaseAdapter';
+/**
+ * Seed definition
+ */
+export interface Seed {
+    /** Seed name */
+    name: string;
+    /** Seed execution function */
+    run: (adapter: DatabaseAdapterType) => Promise<void>;
+    /** Optional cleanup function */
+    cleanup?: (adapter: DatabaseAdapterType) => Promise<void>;
+}
+/**
+ * Parsed seed file metadata
+ */
+export interface SeedFile {
+    /** Full file path */
+    filePath: string;
+    /** Seed order (extracted from filename) */
+    order: number;
+    /** Seed name (extracted from filename) */
+    name: string;
+}
+/**
+ * Seed record stored in database
+ */
+export interface SeedRecord {
+    /** Seed name */
+    name: string;
+    /** When seed was run */
+    run_at: string;
+    /** Execution time in milliseconds */
+    execution_time: number;
+}
+/**
+ * Configuration for SeedManager
+ */
+export interface SeedManagerConfig {
+    /** Database adapter */
+    adapter: DatabaseAdapterType;
+    /** Path to seeds directory (default: './seeds') */
+    seedsPath?: string;
+    /** Table name for seed history (default: 'seed_history') */
+    tableName?: string;
+    /** Skip seeds that have already been run */
+    skipExisting?: boolean;
+    /** Database schema to use (for multi-tenant support) */
+    schema?: string;
+}

package/dist/db/tenant.types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tenant context for multi-tenancy support
+ */
+export interface TenantContextType {
+    /** Tenant identifier */
+    id: string;
+}
+/**
+ * Context for tenant validation operations
+ */
+export interface TenantValidationContext {
+    /** Tenant identifier to validate */
+    id: string;
+}

package/dist/errors/codes.d.ts

@@ -13,6 +13,9 @@ import type { ErrorDefinitions } from './types';
  * Combined error codes from all @plyaz packages
  */
 export declare const ERROR_CODES: {
+    readonly NOT_IMPLEMENTED: "not.implemented";
+    readonly PROVIDER_NOT_IMPLEMENTED: "provider.not.implemented";
+    readonly FEATURE_NOT_SUPPORTED: "feature.not.supported";
     readonly CLIENT_INITIALIZATION_FAILED: "CLIENT_INITIALIZATION_FAILED";
     readonly CLIENT_INVALID_CONFIG: "CLIENT_INVALID_CONFIG";
     readonly CLIENT_MISSING_BASE_URL: "CLIENT_MISSING_BASE_URL";
@@ -359,12 +362,14 @@ export declare const ERROR_CODES: {
     readonly DB_INVALID_IN_OPERATOR: "db.invalid_in_operator";
     readonly DB_INVALID_COUNT: "db.invalid_count";
     readonly DB_CONNECTION_FAILED: "db.connection_failed";
+    readonly DB_CONNECTION_ERROR: "db.connection_error";
     readonly DB_TIMEOUT: "db.timeout";
     readonly DB_CONSTRAINT_VIOLATION: "db.constraint_violation";
     readonly DB_DEADLOCK: "db.deadlock";
     readonly DB_DUPLICATE_ENTRY: "db.duplicate_entry";
     readonly DB_ENTITY_NOT_FOUND: "db.entity_not_found";
     readonly DB_MIGRATION_FAILED: "db.migration_failed";
+    readonly DB_MULTI_WRITE_FAILED: "db.multi_write_failed";
     readonly DB_UNKNOWN_ERROR: "db.unknown_error";
     readonly PAYMENT_TIMEOUT: "payment.timeout";
     readonly PAYMENT_NETWORK_ERROR: "payment.network.error";
@@ -1014,12 +1019,15 @@ export declare const DATABASE_ERROR_CODES: {
     readonly INVALID_IN_OPERATOR: "db.invalid_in_operator";
     readonly INVALID_COUNT: "db.invalid_count";
     readonly CONNECTION_FAILED: "db.connection_failed";
+    readonly CONNECTION_ERROR: "db.connection_error";
     readonly CONSTRAINT_VIOLATION: "db.constraint_violation";
     readonly TIMEOUT: "db.timeout";
     readonly DEADLOCK: "db.deadlock";
     readonly ENTITY_NOT_FOUND: "db.entity_not_found";
     readonly DUPLICATE_ENTRY: "db.duplicate_entry";
     readonly MIGRATION_FAILED: "db.migration_failed";
+    readonly MULTI_WRITE_FAILED: "db.multi_write_failed";
+    readonly NOT_FOUND: "db.record_not_found";
     readonly UNKNOWN_ERROR: "db.unknown_error";
 };
 export type ApiErrorCodeValue = (typeof API_ERROR_CODES)[keyof typeof API_ERROR_CODES] | `HTTP_${number}`;

package/dist/errors/enums.d.ts

@@ -127,6 +127,8 @@ export declare const ERROR_CATEGORY: {
     readonly Plugin: "plugin";
     /** Quota or storage limit error (e.g., exceeded storage quota). */
     readonly Quota: "quota";
+    /** Database-related error (e.g., query failure, connection error). */
+    readonly Database: "database";
     /** Unknown or unclassified error. */
     readonly Unknown: "unknown";
 };
@@ -219,6 +221,7 @@ export declare const ERROR_CATEGORY_TO_EMITTER_KEY: {
     readonly "file.operation": "fileOperation";
     readonly plugin: "plugin";
     readonly quota: "quota";
+    readonly database: "database";
     readonly unknown: "unknown";
 };
 /**