@plyaz/types 1.14.8 → 1.14.10

package/dist/db/dbConstant.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Encryption Extension Constants
+ *
+ * Centralized constants for encryption configuration to prevent
+ * hardcoded values and ensure consistency across the codebase.
+ */
+export declare const ENCRYPTION_DEFAULTS: {
+    /** Default encryption algorithm - AES-256-GCM provides authenticated encryption */
+    readonly ALGORITHM: "aes-256-gcm";
+    /** IV length for AES-256-GCM in bytes */
+    readonly IV_LENGTH: 16;
+    /** Expected parts in encrypted text format (iv:authTag:encrypted) */
+    readonly ENCRYPTED_PARTS_COUNT: 3;
+};
+/**
+ * Alert rule IDs
+ */
+export declare const ALERT_RULE_ID: {
+    readonly POOL_EXHAUSTION: "pool-exhaustion";
+    readonly SLOW_QUERY: "slow-query";
+    readonly REPLICA_LAG: "replica-lag";
+};

package/dist/db/index.cjs

@@ -62,13 +62,30 @@ var ADAPTER_TYPES = /* @__PURE__ */ ((ADAPTER_TYPES2) => {
   return ADAPTER_TYPES2;
 })(ADAPTER_TYPES || {});
 
+// src/db/dbConstant.ts
+var ENCRYPTION_DEFAULTS = {
+  /** Default encryption algorithm - AES-256-GCM provides authenticated encryption */
+  ALGORITHM: "aes-256-gcm",
+  /** IV length for AES-256-GCM in bytes */
+  IV_LENGTH: 16,
+  /** Expected parts in encrypted text format (iv:authTag:encrypted) */
+  ENCRYPTED_PARTS_COUNT: 3
+};
+var ALERT_RULE_ID = {
+  POOL_EXHAUSTION: "pool-exhaustion",
+  SLOW_QUERY: "slow-query",
+  REPLICA_LAG: "replica-lag"
+};
+
 exports.ADAPTERS = ADAPTERS;
 exports.ADAPTER_TYPES = ADAPTER_TYPES;
+exports.ALERT_RULE_ID = ALERT_RULE_ID;
 exports.ALERT_SEVERITY = ALERT_SEVERITY;
 exports.ALERT_SOURCE = ALERT_SOURCE;
 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.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"],"names":["ADAPTERS","DATABASE_EVENT_TYPE","REPLICA_STRATEGY","DB_POOL_EVENTS","ALERT_SEVERITY","ALERT_SOURCE","AUDIT_OPERATION","ADAPTER_TYPES"],"mappings":";;;;;AAiFO,IAAK,QAAA,qBAAAA,SAAAA,KAAL;AAEH,EAAAA,UAAA,UAAA,CAAA,GAAW,UAAA;AAGX,EAAAA,UAAA,SAAA,CAAA,GAAU,SAAA;AAGV,EAAAA,UAAA,UAAA,CAAA,GAAW,UAAA;AAGX,EAAAA,UAAA,KAAA,CAAA,GAAM,KAAA;AAXE,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA;AAiBL,IAAK,mBAAA,qBAAAC,oBAAAA,KAAL;AACH,EAAAA,qBAAA,aAAA,CAAA,GAAc,aAAA;AACd,EAAAA,qBAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,qBAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,qBAAA,mBAAA,CAAA,GAAoB,mBAAA;AACpB,EAAAA,qBAAA,kBAAA,CAAA,GAAmB,kBAAA;AACnB,EAAAA,qBAAA,qBAAA,CAAA,GAAsB,qBAAA;AACtB,EAAAA,qBAAA,cAAA,CAAA,GAAe,cAAA;AAPP,EAAA,OAAAA,oBAAAA;AAAA,CAAA,EAAA,mBAAA,IAAA,EAAA;AAaL,IAAK,gBAAA,qBAAAC,iBAAAA,KAAL;AAEH,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAEV,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAEV,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAEV,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AARF,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA;AAcL,IAAK,cAAA,qBAAAC,eAAAA,KAAL;AACL,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AAJC,EAAA,OAAAA,eAAAA;AAAA,CAAA,EAAA,cAAA,IAAA,EAAA;AAUL,IAAK,cAAA,qBAAAC,eAAAA,KAAL;AACL,EAAAA,gBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,gBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,gBAAA,MAAA,CAAA,GAAO,MAAA;AAJG,EAAA,OAAAA,eAAAA;AAAA,CAAA,EAAA,cAAA,IAAA,EAAA;AAUL,IAAK,YAAA,qBAAAC,aAAAA,KAAL;AACL,EAAAA,cAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,cAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,cAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,cAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,cAAA,QAAA,CAAA,GAAS,QAAA;AALC,EAAA,OAAAA,aAAAA;AAAA,CAAA,EAAA,YAAA,IAAA,EAAA;AAWL,IAAK,eAAA,qBAAAC,gBAAAA,KAAL;AACL,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AAHC,EAAA,OAAAA,gBAAAA;AAAA,CAAA,EAAA,eAAA,IAAA,EAAA;AASL,IAAK,aAAA,qBAAAC,cAAAA,KAAL;AACL,EAAAA,eAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,eAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,eAAA,KAAA,CAAA,GAAM,KAAA;AAHI,EAAA,OAAAA,cAAAA;AAAA,CAAA,EAAA,aAAA,IAAA,EAAA","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\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"]}
+{"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\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} 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

@@ -12,3 +12,4 @@ export type * from './audit.types';
 export type * from './backup.types';
 export type * from './replica.types';
 export * from './dbEnums';
+export * from './dbConstant';

package/dist/db/index.js

@@ -60,6 +60,21 @@ var ADAPTER_TYPES = /* @__PURE__ */ ((ADAPTER_TYPES2) => {
   return ADAPTER_TYPES2;
 })(ADAPTER_TYPES || {});
 
-export { ADAPTERS, ADAPTER_TYPES, ALERT_SEVERITY, ALERT_SOURCE, AUDIT_OPERATION, DATABASE_EVENT_TYPE, DB_POOL_EVENTS, REPLICA_STRATEGY };
+// src/db/dbConstant.ts
+var ENCRYPTION_DEFAULTS = {
+  /** Default encryption algorithm - AES-256-GCM provides authenticated encryption */
+  ALGORITHM: "aes-256-gcm",
+  /** IV length for AES-256-GCM in bytes */
+  IV_LENGTH: 16,
+  /** Expected parts in encrypted text format (iv:authTag:encrypted) */
+  ENCRYPTED_PARTS_COUNT: 3
+};
+var ALERT_RULE_ID = {
+  POOL_EXHAUSTION: "pool-exhaustion",
+  SLOW_QUERY: "slow-query",
+  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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/db/dbEnums.ts"],"names":["ADAPTERS","DATABASE_EVENT_TYPE","REPLICA_STRATEGY","DB_POOL_EVENTS","ALERT_SEVERITY","ALERT_SOURCE","AUDIT_OPERATION","ADAPTER_TYPES"],"mappings":";;;AAiFO,IAAK,QAAA,qBAAAA,SAAAA,KAAL;AAEH,EAAAA,UAAA,UAAA,CAAA,GAAW,UAAA;AAGX,EAAAA,UAAA,SAAA,CAAA,GAAU,SAAA;AAGV,EAAAA,UAAA,UAAA,CAAA,GAAW,UAAA;AAGX,EAAAA,UAAA,KAAA,CAAA,GAAM,KAAA;AAXE,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA;AAiBL,IAAK,mBAAA,qBAAAC,oBAAAA,KAAL;AACH,EAAAA,qBAAA,aAAA,CAAA,GAAc,aAAA;AACd,EAAAA,qBAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,qBAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,qBAAA,mBAAA,CAAA,GAAoB,mBAAA;AACpB,EAAAA,qBAAA,kBAAA,CAAA,GAAmB,kBAAA;AACnB,EAAAA,qBAAA,qBAAA,CAAA,GAAsB,qBAAA;AACtB,EAAAA,qBAAA,cAAA,CAAA,GAAe,cAAA;AAPP,EAAA,OAAAA,oBAAAA;AAAA,CAAA,EAAA,mBAAA,IAAA,EAAA;AAaL,IAAK,gBAAA,qBAAAC,iBAAAA,KAAL;AAEH,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAEV,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAEV,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAEV,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AARF,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA;AAcL,IAAK,cAAA,qBAAAC,eAAAA,KAAL;AACL,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,gBAAA,QAAA,CAAA,GAAS,QAAA;AAJC,EAAA,OAAAA,eAAAA;AAAA,CAAA,EAAA,cAAA,IAAA,EAAA;AAUL,IAAK,cAAA,qBAAAC,eAAAA,KAAL;AACL,EAAAA,gBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,gBAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,gBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,gBAAA,MAAA,CAAA,GAAO,MAAA;AAJG,EAAA,OAAAA,eAAAA;AAAA,CAAA,EAAA,cAAA,IAAA,EAAA;AAUL,IAAK,YAAA,qBAAAC,aAAAA,KAAL;AACL,EAAAA,cAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,cAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,cAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,cAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,cAAA,QAAA,CAAA,GAAS,QAAA;AALC,EAAA,OAAAA,aAAAA;AAAA,CAAA,EAAA,YAAA,IAAA,EAAA;AAWL,IAAK,eAAA,qBAAAC,gBAAAA,KAAL;AACL,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,iBAAA,QAAA,CAAA,GAAS,QAAA;AAHC,EAAA,OAAAA,gBAAAA;AAAA,CAAA,EAAA,eAAA,IAAA,EAAA;AASL,IAAK,aAAA,qBAAAC,cAAAA,KAAL;AACL,EAAAA,eAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,eAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,eAAA,KAAA,CAAA,GAAM,KAAA;AAHI,EAAA,OAAAA,cAAAA;AAAA,CAAA,EAAA,aAAA,IAAA,EAAA","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\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"]}
+{"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\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} 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/errors/codes.d.ts

@@ -185,6 +185,73 @@ export declare const ERROR_CODES: {
     readonly DB_INVALID_BETWEEN_OPERATOR: "DB_INVALID_BETWEEN_OPERATOR";
     readonly DB_INVALID_IN_OPERATOR: "DB_INVALID_IN_OPERATOR";
     readonly DB_INVALID_COUNT: "DB_INVALID_COUNT";
+    readonly PAYMENT_REFUND_FAILED: "payment.refund.failed";
+    readonly PAYMENT_REFUND_NOT_FOUND: "payment.refund.not.found";
+    readonly PAYMENT_REFUND_ALREADY_PROCESSED: "payment.refund.already.processed";
+    readonly PAYMENT_REFUND_AMOUNT_INVALID: "payment.refund.amount.invalid";
+    readonly PAYMENT_REFUND_VALIDATION_FAILED: "payment.refund.validation.failed";
+    readonly PAYMENT_REFUND_TIMEOUT: "payment.refund.timeout";
+    readonly PAYMENT_PROVIDER_ERROR: "payment.provider.error";
+    readonly PAYMENT_PROVIDER_UNAVAILABLE: "payment.provider.unavailable";
+    readonly PAYMENT_PROVIDER_CONFIGURATION_INVALID: "payment.provider.configuration.invalid";
+    readonly PAYMENT_PROVIDER_RESPONSE_INVALID: "payment.provider.response.invalid";
+    readonly PAYMENT_PROVIDER_TIMEOUT: "payment.provider.timeout";
+    readonly PAYMENT_PROVIDER_AUTH_FAILED: "payment.provider.auth.failed";
+    readonly PAYMENT_COMPLIANCE_VIOLATION: "payment.compliance.violation";
+    readonly PAYMENT_COMPLIANCE_CHECK_FAILED: "payment.compliance.check.failed";
+    readonly PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: "payment.compliance.limit.exceeded";
+    readonly PAYMENT_COMPLIANCE_POLICY_MISSING: "payment.compliance.policy.missing";
+    readonly PAYMENT_PROCESSING_FAILED: "payment.processing.failed";
+    readonly PAYMENT_PROCESSING_TIMEOUT: "payment.processing.timeout";
+    readonly PAYMENT_PROCESSING_GATEWAY_ERROR: "payment.processing.gateway.error";
+    readonly PAYMENT_PROCESSING_DUPLICATE: "payment.processing.duplicate";
+    readonly PAYMENT_PROCESSING_UNEXPECTED_STATE: "payment.processing.unexpected.state";
+    readonly PAYMENT_SECURITY_VIOLATION: "payment.security.violation";
+    readonly PAYMENT_SECURITY_SIGNATURE_INVALID: "payment.security.signature.invalid";
+    readonly PAYMENT_SECURITY_ENCRYPTION_FAILED: "payment.security.encryption.failed";
+    readonly PAYMENT_SECURITY_FRAUD_DETECTED: "payment.security.fraud.detected";
+    readonly PAYMENT_SECURITY_TOKEN_INVALID: "payment.security.token.invalid";
+    readonly PAYMENT_VALIDATION_FAILED: "payment.validation.failed";
+    readonly PAYMENT_VALIDATION_AMOUNT_INVALID: "payment.validation.amount.invalid";
+    readonly PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: "payment.validation.currency.unsupported";
+    readonly PAYMENT_VALIDATION_METADATA_INVALID: "payment.validation.metadata.invalid";
+    readonly PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: "payment.validation.field.required";
+    readonly PAYMENT_WEBHOOK_SIGNATURE_INVALID: "payment.webhook.signature.invalid";
+    readonly PAYMENT_WEBHOOK_PROCESSING_FAILED: "payment.webhook.processing.failed";
+    readonly PAYMENT_WEBHOOK_VALIDATION_FAILED: "payment.webhook.validation.failed";
+    readonly PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: "payment.webhook.event.type.unsupported";
+    readonly PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: "payment.webhook.handler.not.found";
+    readonly PAYMENT_ADAPTER_INIT_FAILED: "payment.adapter.init.failed";
+    readonly PAYMENT_ADAPTER_SHUTDOWN_ERROR: "payment.adapter.shutdown.error";
+    readonly PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: "payment.adapter.hmac.computation.failed";
+    readonly PAYMENT_ADAPTER_MISSING_PROVIDER: "payment.adapter.missing.provider";
+    readonly PAYMENT_ADAPTER_MISSING_ENVIRONMENT: "payment.adapter.missing.environment";
+    readonly PAYMENT_ADAPTER_MISSING_CREDENTIALS: "payment.adapter.missing.credentials";
+    readonly PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: "payment.adapter.missing.webhook.url";
+    readonly PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: "payment.adapter.missing.unregister.endpoint";
+    readonly PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: "payment.adapter.unsupported.operation";
+    readonly PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: "payment.adapter.response.mapping.failed";
+    readonly PAYMENT_IDEMPOTENCY_VIOLATION: "payment.idempotency.violation";
+    readonly PAYMENT_IDEMPOTENCY_KEY_MISSING: "payment.idempotency.key.missing";
+    readonly PAYMENT_IDEMPOTENCY_STORE_ERROR: "payment.idempotency.store.error";
+    readonly PAYMENT_ROUTING_FAILED: "payment.routing.failed";
+    readonly PAYMENT_ROUTING_CONFIGURATION_INVALID: "payment.routing.configuration.invalid";
+    readonly PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: "payment.routing.provider.unavailable";
+    readonly PAYMENT_ROUTING_RETRY_EXCEEDED: "payment.routing.retry.exceeded";
+    readonly PAYMENT_SYSTEM_NOT_INITIALIZED: "payment.system.not.initialized";
+    readonly PAYMENT_CONTEXT_OPERATION_FAILED: "payment.context.operation.failed";
+    readonly PAYMENT_INTERNAL_ERROR: "payment.internal.error";
+    readonly PAYMENT_UNKNOWN_ERROR: "payment.unknown.error";
+    /**
+     * Thrown when an event could not be emitted due to internal state or creation errors.
+     * Typically non-retryable, indicates a logic or validation fault.
+     */
+    readonly PAYMENT_EVENT_EMIT_FAILED: "PAYMENT_EVENT_EMIT_FAILED";
+    readonly PAYMENT_EVENT_INVALID_TYPE: "PAYMENT_EVENT_INVALID_TYPE";
+    readonly PAYMENT_EVENT_CREATION_FAILED: "PAYMENT_EVENT_CREATION_FAILED";
+    readonly PAYMENT_EVENT_HANDLER_TIMEOUT: "PAYMENT_EVENT_HANDLER_TIMEOUT";
+    readonly PAYMENT_EVENT_HANDLER_INVALID_RESULT: "PAYMENT_EVENT_HANDLER_INVALID_RESULT";
+    readonly PAYMENT_EVENT_LIFECYCLE_FAILURE: "PAYMENT_EVENT_LIFECYCLE_FAILURE";
 };
 /**
  * Type for all error code values
@@ -305,8 +372,82 @@ export declare const NOTIFICATION_ERROR_CODES: {
     readonly UNKNOWN_ERROR: "notification.unknown.error";
     readonly INITIALIZATION_FAILED: "notification.initialization.failed";
 };
+/**
+ * PAYMENT-specific error codes
+ * Subset of ERROR_CODES for @plyaz/payments package
+ */
+export declare const PAYMENT_ERROR_CODES: {
+    readonly PAYMENT_REFUND_FAILED: "payment.refund.failed";
+    readonly PAYMENT_REFUND_NOT_FOUND: "payment.refund.not.found";
+    readonly PAYMENT_REFUND_ALREADY_PROCESSED: "payment.refund.already.processed";
+    readonly PAYMENT_REFUND_AMOUNT_INVALID: "payment.refund.amount.invalid";
+    readonly PAYMENT_REFUND_VALIDATION_FAILED: "payment.refund.validation.failed";
+    readonly PAYMENT_REFUND_TIMEOUT: "payment.refund.timeout";
+    readonly PAYMENT_PROVIDER_ERROR: "payment.provider.error";
+    readonly PAYMENT_PROVIDER_UNAVAILABLE: "payment.provider.unavailable";
+    readonly PAYMENT_PROVIDER_CONFIGURATION_INVALID: "payment.provider.configuration.invalid";
+    readonly PAYMENT_PROVIDER_RESPONSE_INVALID: "payment.provider.response.invalid";
+    readonly PAYMENT_PROVIDER_TIMEOUT: "payment.provider.timeout";
+    readonly PAYMENT_PROVIDER_AUTH_FAILED: "payment.provider.auth.failed";
+    readonly PAYMENT_COMPLIANCE_VIOLATION: "payment.compliance.violation";
+    readonly PAYMENT_COMPLIANCE_CHECK_FAILED: "payment.compliance.check.failed";
+    readonly PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: "payment.compliance.limit.exceeded";
+    readonly PAYMENT_COMPLIANCE_POLICY_MISSING: "payment.compliance.policy.missing";
+    readonly PAYMENT_PROCESSING_FAILED: "payment.processing.failed";
+    readonly PAYMENT_PROCESSING_TIMEOUT: "payment.processing.timeout";
+    readonly PAYMENT_PROCESSING_GATEWAY_ERROR: "payment.processing.gateway.error";
+    readonly PAYMENT_PROCESSING_DUPLICATE: "payment.processing.duplicate";
+    readonly PAYMENT_PROCESSING_UNEXPECTED_STATE: "payment.processing.unexpected.state";
+    readonly PAYMENT_SECURITY_VIOLATION: "payment.security.violation";
+    readonly PAYMENT_SECURITY_SIGNATURE_INVALID: "payment.security.signature.invalid";
+    readonly PAYMENT_SECURITY_ENCRYPTION_FAILED: "payment.security.encryption.failed";
+    readonly PAYMENT_SECURITY_FRAUD_DETECTED: "payment.security.fraud.detected";
+    readonly PAYMENT_SECURITY_TOKEN_INVALID: "payment.security.token.invalid";
+    readonly PAYMENT_VALIDATION_FAILED: "payment.validation.failed";
+    readonly PAYMENT_VALIDATION_AMOUNT_INVALID: "payment.validation.amount.invalid";
+    readonly PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: "payment.validation.currency.unsupported";
+    readonly PAYMENT_VALIDATION_METADATA_INVALID: "payment.validation.metadata.invalid";
+    readonly PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: "payment.validation.field.required";
+    readonly PAYMENT_WEBHOOK_SIGNATURE_INVALID: "payment.webhook.signature.invalid";
+    readonly PAYMENT_WEBHOOK_PROCESSING_FAILED: "payment.webhook.processing.failed";
+    readonly PAYMENT_WEBHOOK_VALIDATION_FAILED: "payment.webhook.validation.failed";
+    readonly PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: "payment.webhook.event.type.unsupported";
+    readonly PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: "payment.webhook.handler.not.found";
+    readonly PAYMENT_ADAPTER_INIT_FAILED: "payment.adapter.init.failed";
+    readonly PAYMENT_ADAPTER_SHUTDOWN_ERROR: "payment.adapter.shutdown.error";
+    readonly PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: "payment.adapter.hmac.computation.failed";
+    readonly PAYMENT_ADAPTER_MISSING_PROVIDER: "payment.adapter.missing.provider";
+    readonly PAYMENT_ADAPTER_MISSING_ENVIRONMENT: "payment.adapter.missing.environment";
+    readonly PAYMENT_ADAPTER_MISSING_CREDENTIALS: "payment.adapter.missing.credentials";
+    readonly PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: "payment.adapter.missing.webhook.url";
+    readonly PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: "payment.adapter.missing.unregister.endpoint";
+    readonly PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: "payment.adapter.unsupported.operation";
+    readonly PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: "payment.adapter.response.mapping.failed";
+    readonly PAYMENT_IDEMPOTENCY_VIOLATION: "payment.idempotency.violation";
+    readonly PAYMENT_IDEMPOTENCY_KEY_MISSING: "payment.idempotency.key.missing";
+    readonly PAYMENT_IDEMPOTENCY_STORE_ERROR: "payment.idempotency.store.error";
+    readonly PAYMENT_ROUTING_FAILED: "payment.routing.failed";
+    readonly PAYMENT_ROUTING_CONFIGURATION_INVALID: "payment.routing.configuration.invalid";
+    readonly PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: "payment.routing.provider.unavailable";
+    readonly PAYMENT_ROUTING_RETRY_EXCEEDED: "payment.routing.retry.exceeded";
+    readonly PAYMENT_SYSTEM_NOT_INITIALIZED: "payment.system.not.initialized";
+    readonly PAYMENT_CONTEXT_OPERATION_FAILED: "payment.context.operation.failed";
+    readonly PAYMENT_INTERNAL_ERROR: "payment.internal.error";
+    readonly PAYMENT_UNKNOWN_ERROR: "payment.unknown.error";
+    /**
+     * Thrown when an event could not be emitted due to internal state or creation errors.
+     * Typically non-retryable, indicates a logic or validation fault.
+     */
+    readonly PAYMENT_EVENT_EMIT_FAILED: "PAYMENT_EVENT_EMIT_FAILED";
+    readonly PAYMENT_EVENT_INVALID_TYPE: "PAYMENT_EVENT_INVALID_TYPE";
+    readonly PAYMENT_EVENT_CREATION_FAILED: "PAYMENT_EVENT_CREATION_FAILED";
+    readonly PAYMENT_EVENT_HANDLER_TIMEOUT: "PAYMENT_EVENT_HANDLER_TIMEOUT";
+    readonly PAYMENT_EVENT_HANDLER_INVALID_RESULT: "PAYMENT_EVENT_HANDLER_INVALID_RESULT";
+    readonly PAYMENT_EVENT_LIFECYCLE_FAILURE: "PAYMENT_EVENT_LIFECYCLE_FAILURE";
+};
 export type ApiErrorCodeValue = (typeof API_ERROR_CODES)[keyof typeof API_ERROR_CODES] | `HTTP_${number}`;
 export type NotificationErrorCodeValue = (typeof NOTIFICATION_ERROR_CODES)[keyof typeof NOTIFICATION_ERROR_CODES];
+export type PaymentErrorCodeValue = (typeof PAYMENT_ERROR_CODES)[keyof typeof PAYMENT_ERROR_CODES];
 /**
  * Unified ERROR_DEFINITIONS
  * Single source of truth for ALL error definitions across all @plyaz packages

package/dist/errors/enums.d.ts

@@ -107,6 +107,20 @@ export declare const ERROR_CATEGORY: {
     readonly Template: "template";
     /** Configuration-related error (e.g., invalid or missing configuration). */
     readonly Configuration: "configuration";
+    /** Payment processing-related error (e.g., capture or settlement failure). */
+    readonly Processing: "processing";
+    /** Fraud detection or prevention failure. */
+    readonly Fraud: "fraud";
+    /** Compliance-related error (e.g., AML/KYC validation failure). */
+    readonly Compliance: "compliance";
+    /** Limits or quota-related error (e.g., exceeded transaction limit). */
+    readonly Limits: "limits";
+    /** System-level error (unexpected internal issue). */
+    readonly System: "system";
+    /** Refund-related error (e.g., duplicate or failed refund). */
+    readonly Refund: "refund";
+    /** Security-related error (e.g., encryption or signature failure). */
+    readonly Security: "security";
     /** Unknown or unclassified error. */
     readonly Unknown: "unknown";
 };
@@ -189,6 +203,13 @@ export declare const ERROR_CATEGORY_TO_EMITTER_KEY: {
     readonly webhook: "webhook";
     readonly template: "template";
     readonly configuration: "configuration";
+    readonly processing: "processing";
+    readonly fraud: "fraud";
+    readonly compliance: "compliance";
+    readonly limits: "limits";
+    readonly system: "system";
+    readonly refund: "refund";
+    readonly security: "security";
     readonly unknown: "unknown";
 };
 /**