@plyaz/types 1.14.2 → 1.14.4

package/dist/api/utils/types.d.ts

@@ -87,25 +87,6 @@ export interface TimeUnit {
     value: number;
     label: string;
 }
-/**
- * ID generation options
- */
-export interface IdGenerationOptions {
-    /** Prefix for the ID */
-    prefix?: string;
-    /** Suffix for the ID */
-    suffix?: string;
-    /** Use timestamp-based ID instead of UUID */
-    useTimestamp?: boolean;
-    /** Separator for components */
-    separator?: string;
-    /** Include random component for timestamp IDs */
-    includeRandom?: boolean;
-    /** Radix for number conversion (2-36) */
-    radix?: number;
-    /** Length of random component */
-    randomLength?: number;
-}
 /**
  * Range mapping configuration
  */

package/dist/common/enums.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Namespaces for categorizing error exceptions classes in different packages
+ */
+export declare const PACKAGE_NAME_NAMESPACES: {
+    API: string;
+    AUTH: string;
+    NOTIFICATIONS: string;
+    DB: string;
+    PAYMENTS: string;
+    ERRORS: string;
+    LOGGER: string;
+    TYPES: string;
+    CONFIG: string;
+    UTILS: string;
+    EVENTS: string;
+    TRANSLATIONS: string;
+    UI: string;
+    TESTING: string;
+    CORE: string;
+    STORE: string;
+    WEB3: string;
+    MONITORING: string;
+    HOOKS: string;
+    COMMON: string;
+};

package/dist/common/index.cjs

@@ -1,4 +1,31 @@
 'use strict';
 
+// @plyaz package - Built with tsup
+
+// src/common/enums.ts
+var PACKAGE_NAME_NAMESPACES = {
+  API: "api",
+  AUTH: "auth",
+  NOTIFICATIONS: "notifications",
+  DB: "db",
+  PAYMENTS: "payments",
+  ERRORS: "errors",
+  LOGGER: "logger",
+  TYPES: "types",
+  CONFIG: "config",
+  UTILS: "utils",
+  EVENTS: "events",
+  TRANSLATIONS: "translations",
+  UI: "ui",
+  TESTING: "testing",
+  CORE: "core",
+  STORE: "store",
+  WEB3: "web3",
+  MONITORING: "monitoring",
+  HOOKS: "hooks",
+  COMMON: "common"
+};
+
+exports.PACKAGE_NAME_NAMESPACES = PACKAGE_NAME_NAMESPACES;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/common/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../src/common/enums.ts"],"names":[],"mappings":";;;;;AAGO,IAAM,uBAAA,GAA0B;AAAA,EACrC,GAAA,EAAK,KAAA;AAAA,EACL,IAAA,EAAM,MAAA;AAAA,EACN,aAAA,EAAe,eAAA;AAAA,EACf,EAAA,EAAI,IAAA;AAAA,EACJ,QAAA,EAAU,UAAA;AAAA,EACV,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,YAAA,EAAc,cAAA;AAAA,EACd,EAAA,EAAI,IAAA;AAAA,EACJ,OAAA,EAAS,SAAA;AAAA,EACT,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO,OAAA;AAAA,EACP,IAAA,EAAM,MAAA;AAAA,EACN,UAAA,EAAY,YAAA;AAAA,EACZ,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ;AACV","file":"index.cjs","sourcesContent":["/**\n * Namespaces for categorizing error exceptions classes in different packages\n */\nexport const PACKAGE_NAME_NAMESPACES = {\n  API: 'api',\n  AUTH: 'auth',\n  NOTIFICATIONS: 'notifications',\n  DB: 'db',\n  PAYMENTS: 'payments',\n  ERRORS: 'errors',\n  LOGGER: 'logger',\n  TYPES: 'types',\n  CONFIG: 'config',\n  UTILS: 'utils',\n  EVENTS: 'events',\n  TRANSLATIONS: 'translations',\n  UI: 'ui',\n  TESTING: 'testing',\n  CORE: 'core',\n  STORE: 'store',\n  WEB3: 'web3',\n  MONITORING: 'monitoring',\n  HOOKS: 'hooks',\n  COMMON: 'common',\n};\n"]}

package/dist/common/index.d.ts

@@ -1 +1,2 @@
 export type * from './types';
+export * from './enums';

package/dist/common/index.js

@@ -1,3 +1,29 @@
+// @plyaz package - Built with tsup
 
+// src/common/enums.ts
+var PACKAGE_NAME_NAMESPACES = {
+  API: "api",
+  AUTH: "auth",
+  NOTIFICATIONS: "notifications",
+  DB: "db",
+  PAYMENTS: "payments",
+  ERRORS: "errors",
+  LOGGER: "logger",
+  TYPES: "types",
+  CONFIG: "config",
+  UTILS: "utils",
+  EVENTS: "events",
+  TRANSLATIONS: "translations",
+  UI: "ui",
+  TESTING: "testing",
+  CORE: "core",
+  STORE: "store",
+  WEB3: "web3",
+  MONITORING: "monitoring",
+  HOOKS: "hooks",
+  COMMON: "common"
+};
+
+export { PACKAGE_NAME_NAMESPACES };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/common/enums.ts"],"names":[],"mappings":";;;AAGO,IAAM,uBAAA,GAA0B;AAAA,EACrC,GAAA,EAAK,KAAA;AAAA,EACL,IAAA,EAAM,MAAA;AAAA,EACN,aAAA,EAAe,eAAA;AAAA,EACf,EAAA,EAAI,IAAA;AAAA,EACJ,QAAA,EAAU,UAAA;AAAA,EACV,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,YAAA,EAAc,cAAA;AAAA,EACd,EAAA,EAAI,IAAA;AAAA,EACJ,OAAA,EAAS,SAAA;AAAA,EACT,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO,OAAA;AAAA,EACP,IAAA,EAAM,MAAA;AAAA,EACN,UAAA,EAAY,YAAA;AAAA,EACZ,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ;AACV","file":"index.js","sourcesContent":["/**\n * Namespaces for categorizing error exceptions classes in different packages\n */\nexport const PACKAGE_NAME_NAMESPACES = {\n  API: 'api',\n  AUTH: 'auth',\n  NOTIFICATIONS: 'notifications',\n  DB: 'db',\n  PAYMENTS: 'payments',\n  ERRORS: 'errors',\n  LOGGER: 'logger',\n  TYPES: 'types',\n  CONFIG: 'config',\n  UTILS: 'utils',\n  EVENTS: 'events',\n  TRANSLATIONS: 'translations',\n  UI: 'ui',\n  TESTING: 'testing',\n  CORE: 'core',\n  STORE: 'store',\n  WEB3: 'web3',\n  MONITORING: 'monitoring',\n  HOOKS: 'hooks',\n  COMMON: 'common',\n};\n"]}

package/dist/db/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/db/adapter.ts","../../src/db/replicaStrategy.ts","../../src/db/databaseEventsType.ts"],"names":["ADAPTERS","REPLICA_STRATEGY","DATABASE_EVENT_TYPE"],"mappings":";;;;;AAiFO,IAAK,QAAA,qBAAAA,SAAAA,KAAL;AAEL,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;AAXI,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA;;;AC9EL,IAAK,gBAAA,qBAAAC,iBAAAA,KAAL;AAEL,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;AARA,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA;;;ACFL,IAAK,mBAAA,qBAAAC,oBAAAA,KAAL;AACL,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;AAPL,EAAA,OAAAA,oBAAAA;AAAA,CAAA,EAAA,mBAAA,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 * 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","// 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}"]}
+{"version":3,"sources":["../../src/db/adapter.ts","../../src/db/replicaStrategy.ts","../../src/db/databaseEventsType.ts"],"names":["ADAPTERS","REPLICA_STRATEGY","DATABASE_EVENT_TYPE"],"mappings":";;;;;AAiFO,IAAK,QAAA,qBAAAA,SAAAA,KAAL;AAEL,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;AAXI,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA;;;AC9EL,IAAK,gBAAA,qBAAAC,iBAAAA,KAAL;AAEL,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;AARA,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA;;;ACFL,IAAK,mBAAA,qBAAAC,oBAAAA,KAAL;AACL,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;AAPL,EAAA,OAAAA,oBAAAA;AAAA,CAAA,EAAA,mBAAA,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 * 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","// 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"]}

package/dist/db/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/db/adapter.ts","../../src/db/replicaStrategy.ts","../../src/db/databaseEventsType.ts"],"names":["ADAPTERS","REPLICA_STRATEGY","DATABASE_EVENT_TYPE"],"mappings":";;;AAiFO,IAAK,QAAA,qBAAAA,SAAAA,KAAL;AAEL,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;AAXI,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA;;;AC9EL,IAAK,gBAAA,qBAAAC,iBAAAA,KAAL;AAEL,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;AARA,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA;;;ACFL,IAAK,mBAAA,qBAAAC,oBAAAA,KAAL;AACL,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;AAPL,EAAA,OAAAA,oBAAAA;AAAA,CAAA,EAAA,mBAAA,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 * 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","// 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}"]}
+{"version":3,"sources":["../../src/db/adapter.ts","../../src/db/replicaStrategy.ts","../../src/db/databaseEventsType.ts"],"names":["ADAPTERS","REPLICA_STRATEGY","DATABASE_EVENT_TYPE"],"mappings":";;;AAiFO,IAAK,QAAA,qBAAAA,SAAAA,KAAL;AAEL,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;AAXI,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA;;;AC9EL,IAAK,gBAAA,qBAAAC,iBAAAA,KAAL;AAEL,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;AARA,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA;;;ACFL,IAAK,mBAAA,qBAAAC,oBAAAA,KAAL;AACL,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;AAPL,EAAA,OAAAA,oBAAAA;AAAA,CAAA,EAAA,mBAAA,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 * 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","// 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"]}

package/dist/errors/enums.d.ts

@@ -299,3 +299,31 @@ export declare const COMMON_STORAGE_TYPES: {
     readonly REDIS: "redis";
     readonly DATABASE: "database";
 };
+/**
+ * Namespaces for categorizing error exceptions classes in different packages and category based exceptions
+ */
+export declare const ERROR_EXCEPTIONS_NAMESPACES: {
+    BASE: string;
+    API: string;
+    AUTH: string;
+    NOTIFICATIONS: string;
+    DB: string;
+    VALIDATION: string;
+    GENERIC: string;
+    PAYMENTS: string;
+    ERRORS: string;
+    LOGGER: string;
+    TYPES: string;
+    CONFIG: string;
+    UTILS: string;
+    EVENTS: string;
+    TRANSLATIONS: string;
+    UI: string;
+    TESTING: string;
+    CORE: string;
+    STORE: string;
+    WEB3: string;
+    MONITORING: string;
+    HOOKS: string;
+    COMMON: string;
+};

package/dist/errors/index.cjs

@@ -220,6 +220,31 @@ var COMMON_STORAGE_TYPES = {
   REDIS: "redis",
   DATABASE: "database"
 };
+var ERROR_EXCEPTIONS_NAMESPACES = {
+  BASE: "base",
+  API: "api",
+  AUTH: "auth",
+  NOTIFICATIONS: "notifications",
+  DB: "db",
+  VALIDATION: "validation",
+  GENERIC: "generic",
+  PAYMENTS: "payments",
+  ERRORS: "errors",
+  LOGGER: "logger",
+  TYPES: "types",
+  CONFIG: "config",
+  UTILS: "utils",
+  EVENTS: "events",
+  TRANSLATIONS: "translations",
+  UI: "ui",
+  TESTING: "testing",
+  CORE: "core",
+  STORE: "store",
+  WEB3: "web3",
+  MONITORING: "monitoring",
+  HOOKS: "hooks",
+  COMMON: "common"
+};
 
 // src/http/constants.ts
 var HTTP_STATUS = {
@@ -1424,6 +1449,7 @@ exports.ERROR_CATEGORY = ERROR_CATEGORY;
 exports.ERROR_CATEGORY_TO_EMITTER_KEY = ERROR_CATEGORY_TO_EMITTER_KEY;
 exports.ERROR_CODES = ERROR_CODES;
 exports.ERROR_DEFINITIONS = ERROR_DEFINITIONS;
+exports.ERROR_EXCEPTIONS_NAMESPACES = ERROR_EXCEPTIONS_NAMESPACES;
 exports.ERROR_SEVERITY = ERROR_SEVERITY;
 exports.ERROR_TYPE = ERROR_TYPE;
 exports.INTERNAL_STATUS_CODES = INTERNAL_STATUS_CODES;