@plyaz/types 1.13.17 → 1.14.1

package/dist/auth/index.js

@@ -42,13 +42,17 @@ var AUTH_PROVIDER_TYPE = /* @__PURE__ */ ((AUTH_PROVIDER_TYPE2) => {
   AUTH_PROVIDER_TYPE2["InternalDb"] = "INTERNAL_DB";
   return AUTH_PROVIDER_TYPE2;
 })(AUTH_PROVIDER_TYPE || {});
-var loginCredentialsSchema = z.object({
-  // The user's email address. Must be a valid email format.
-  email: z.string().email("Invalid email format"),
-  // The user's password. No format constraints applied here.
-  password: z.string()
+var DEFAULT_PASSWORD = 8;
+var ContactUsFormSchema = z.object({
+  name: z.string({ error: "errors.form.missingField" }).min(1, "errors.form.nameMissing"),
+  email: z.email({ error: "errors.form.emailInvalid" })
+});
+var SignupFormSchema = z.object({
+  name: z.string({ error: "errors.form.missingField" }).min(1, "errors.form.nameMissing"),
+  email: z.email({ error: "errors.form.emailInvalid" }),
+  password: z.string({ error: "errors.form.missingField" }).min(DEFAULT_PASSWORD, "errors.form.passwordTooShort")
 });
 
-export { AUTH_PROVIDER, AUTH_PROVIDER_TYPE, USER_ROLE, USER_STATUS, loginCredentialsSchema };
+export { AUTH_PROVIDER, AUTH_PROVIDER_TYPE, ContactUsFormSchema, SignupFormSchema, USER_ROLE, USER_STATUS };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/auth/enums.ts","../../src/auth/schemas.ts"],"names":["AUTH_PROVIDER_TYPE"],"mappings":";;;;;AAYO,IAAM,SAAA,GAAY;AAAA;AAAA,EAEvB,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,UAAA,EAAY;AACd;AAcO,IAAM,WAAA,GAAc;AAAA;AAAA,EAEzB,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,QAAA,EAAU,UAAA;AAAA;AAAA,EAGV,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,SAAA,EAAW,WAAA;AAAA;AAAA,EAGX,MAAA,EAAQ;AACV;AAcO,IAAM,aAAA,GAAgB;AAAA;AAAA,EAE3B,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,MAAA,EAAQ;AACV;AAEO,IAAK,kBAAA,qBAAAA,mBAAAA,KAAL;AACL,EAAAA,oBAAA,eAAA,CAAA,GAAgB,gBAAA;AAChB,EAAAA,oBAAA,YAAA,CAAA,GAAa,aAAA;AAFH,EAAA,OAAAA,mBAAAA;AAAA,CAAA,EAAA,kBAAA,IAAA,EAAA;ACvEL,IAAM,sBAAA,GAAyB,EAAE,MAAA,CAAO;AAAA;AAAA,EAE7C,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,MAAM,sBAAsB,CAAA;AAAA;AAAA,EAG9C,QAAA,EAAU,EAAE,MAAA;AACd,CAAC","file":"index.js","sourcesContent":["/**\n * Enum representing the different roles a user can have within the system.\n * @description Roles are used to determine access levels, permissions, and user-specific experiences.\n *\n * @example\n * ```typescript\n * import { USER_ROLE } from '@plyaz/types';\n *\n * const userRole = USER_ROLE.Athlete; // 'athlete'\n * const isAdmin = userRole === USER_ROLE.Admin || userRole === USER_ROLE.SuperAdmin;\n * ```\n */\nexport const USER_ROLE = {\n  /** A user who is an athlete and participates in sports activities. */\n  Athlete: 'athlete',\n\n  /** A user who scouts and discovers talent. */\n  Scout: 'scout',\n\n  /** A user who acts as an agent representing athletes or clubs. */\n  Agent: 'agent',\n\n  /** A user representing a sports club or organization. */\n  Club: 'club',\n\n  /** A fan or supporter of athletes or clubs. */\n  Fan: 'fan',\n\n  /** A system administrator with access to management tools. */\n  Admin: 'admin',\n\n  /** A super admin with the highest level of access and control. */\n  SuperAdmin: 'super.admin',\n} as const;\n\n/**\n * Enum representing the current status of a user account.\n * @description Statuses are used to determine login availability, visibility, and user flow.\n *\n * @example\n * ```typescript\n * import { USER_STATUS } from '@plyaz/types';\n *\n * const isAccessible = status === USER_STATUS.Active;\n * const needsReview = status === USER_STATUS.Pending;\n * ```\n */\nexport const USER_STATUS = {\n  /** Active user with full access. */\n  Active: 'active',\n\n  /** Inactive user, typically not currently using the platform. */\n  Inactive: 'inactive',\n\n  /** User account is awaiting approval or completion of setup. */\n  Pending: 'pending',\n\n  /** User has been temporarily suspended due to policy violations or manual review. */\n  Suspended: 'suspended',\n\n  /** User has been permanently banned from the platform. */\n  Banned: 'banned',\n} as const;\n\n/**\n * Enum representing the supported authentication providers for user login.\n * @description Auth Providers allowed such as Email, Wallet, etc.\n *\n * @example\n * ```typescript\n * import { AUTH_PROVIDER } from '@plyaz/types';\n *\n * const provider = AUTH_PROVIDER.Wallet; // 'wallet'\n * const isWeb3Auth = provider === AUTH_PROVIDER.Wallet;\n * ```\n */\nexport const AUTH_PROVIDER = {\n  /** Authentication via email and password. */\n  Email: 'email',\n\n  /** Authentication via connected blockchain wallet. */\n  Wallet: 'wallet',\n} as const;\n\nexport enum AUTH_PROVIDER_TYPE {\n  ClerkSupabase = 'CLERK_SUPABASE',\n  InternalDb = 'INTERNAL_DB',\n}\n","import { z } from 'zod';\n\n/**\n * Zod schema for validating user login credentials.\n * @description Ensures the input object contains a valid email address and a password string.\n * @example\n * ```ts\n * LoginCredentialsSchema.parse({\n *   email: \"user@example.com\",\n *   password: \"\"\n * });\n * ```\n */\nexport const loginCredentialsSchema = z.object({\n  // The user's email address. Must be a valid email format.\n  email: z.string().email('Invalid email format'),\n\n  // The user's password. No format constraints applied here.\n  password: z.string(),\n});\n\n/**\n * Type inferred from {@link loginCredentialsSchema}.\n * @description Represents the shape of validated login credentials input.\n */\nexport type LoginCredentialsInput = z.infer<typeof loginCredentialsSchema>;\n"]}
+{"version":3,"sources":["../../src/auth/enums.ts","../../src/auth/schemas.ts"],"names":["AUTH_PROVIDER_TYPE"],"mappings":";;;;;AAYO,IAAM,SAAA,GAAY;AAAA;AAAA,EAEvB,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,UAAA,EAAY;AACd;AAcO,IAAM,WAAA,GAAc;AAAA;AAAA,EAEzB,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,QAAA,EAAU,UAAA;AAAA;AAAA,EAGV,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,SAAA,EAAW,WAAA;AAAA;AAAA,EAGX,MAAA,EAAQ;AACV;AAcO,IAAM,aAAA,GAAgB;AAAA;AAAA,EAE3B,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,MAAA,EAAQ;AACV;AAEO,IAAK,kBAAA,qBAAAA,mBAAAA,KAAL;AACL,EAAAA,oBAAA,eAAA,CAAA,GAAgB,gBAAA;AAChB,EAAAA,oBAAA,YAAA,CAAA,GAAa,aAAA;AAFH,EAAA,OAAAA,mBAAAA;AAAA,CAAA,EAAA,kBAAA,IAAA,EAAA;AC/EZ,IAAM,gBAAA,GAAmB,CAAA;AAMlB,IAAM,mBAAA,GAAsB,EAAE,MAAA,CAAO;AAAA,EAC1C,IAAA,EAAM,CAAA,CAAE,MAAA,CAAO,EAAE,KAAA,EAAO,4BAA4B,CAAA,CAAE,GAAA,CAAI,CAAA,EAAG,yBAAyB,CAAA;AAAA,EACtF,OAAO,CAAA,CAAE,KAAA,CAAM,EAAE,KAAA,EAAO,4BAA4B;AACtD,CAAC;AAWM,IAAM,gBAAA,GAAmB,EAAE,MAAA,CAAO;AAAA,EACvC,IAAA,EAAM,CAAA,CAAE,MAAA,CAAO,EAAE,KAAA,EAAO,4BAA4B,CAAA,CAAE,GAAA,CAAI,CAAA,EAAG,yBAAyB,CAAA;AAAA,EACtF,OAAO,CAAA,CAAE,KAAA,CAAM,EAAE,KAAA,EAAO,4BAA4B,CAAA;AAAA,EACpD,QAAA,EAAU,CAAA,CACP,MAAA,CAAO,EAAE,KAAA,EAAO,4BAA4B,CAAA,CAC5C,GAAA,CAAI,gBAAA,EAAkB,8BAA8B;AACzD,CAAC","file":"index.js","sourcesContent":["/**\n * Enum representing the different roles a user can have within the system.\n * @description Roles are used to determine access levels, permissions, and user-specific experiences.\n *\n * @example\n * ```typescript\n * import { USER_ROLE } from '@plyaz/types';\n *\n * const userRole = USER_ROLE.Athlete; // 'athlete'\n * const isAdmin = userRole === USER_ROLE.Admin || userRole === USER_ROLE.SuperAdmin;\n * ```\n */\nexport const USER_ROLE = {\n  /** A user who is an athlete and participates in sports activities. */\n  Athlete: 'athlete',\n\n  /** A user who scouts and discovers talent. */\n  Scout: 'scout',\n\n  /** A user who acts as an agent representing athletes or clubs. */\n  Agent: 'agent',\n\n  /** A user representing a sports club or organization. */\n  Club: 'club',\n\n  /** A fan or supporter of athletes or clubs. */\n  Fan: 'fan',\n\n  /** A system administrator with access to management tools. */\n  Admin: 'admin',\n\n  /** A super admin with the highest level of access and control. */\n  SuperAdmin: 'super.admin',\n} as const;\n\n/**\n * Enum representing the current status of a user account.\n * @description Statuses are used to determine login availability, visibility, and user flow.\n *\n * @example\n * ```typescript\n * import { USER_STATUS } from '@plyaz/types';\n *\n * const isAccessible = status === USER_STATUS.Active;\n * const needsReview = status === USER_STATUS.Pending;\n * ```\n */\nexport const USER_STATUS = {\n  /** Active user with full access. */\n  Active: 'active',\n\n  /** Inactive user, typically not currently using the platform. */\n  Inactive: 'inactive',\n\n  /** User account is awaiting approval or completion of setup. */\n  Pending: 'pending',\n\n  /** User has been temporarily suspended due to policy violations or manual review. */\n  Suspended: 'suspended',\n\n  /** User has been permanently banned from the platform. */\n  Banned: 'banned',\n} as const;\n\n/**\n * Enum representing the supported authentication providers for user login.\n * @description Auth Providers allowed such as Email, Wallet, etc.\n *\n * @example\n * ```typescript\n * import { AUTH_PROVIDER } from '@plyaz/types';\n *\n * const provider = AUTH_PROVIDER.Wallet; // 'wallet'\n * const isWeb3Auth = provider === AUTH_PROVIDER.Wallet;\n * ```\n */\nexport const AUTH_PROVIDER = {\n  /** Authentication via email and password. */\n  Email: 'email',\n\n  /** Authentication via connected blockchain wallet. */\n  Wallet: 'wallet',\n} as const;\n\nexport enum AUTH_PROVIDER_TYPE {\n  ClerkSupabase = 'CLERK_SUPABASE',\n  InternalDb = 'INTERNAL_DB',\n}\n","import { z } from 'zod';\n\n/**\n * Password minimum character length\n */\nconst DEFAULT_PASSWORD = 8;\n\n/**\n * Contact Us Form Schema\n * Validates contact form submissions\n */\nexport const ContactUsFormSchema = z.object({\n  name: z.string({ error: 'errors.form.missingField' }).min(1, 'errors.form.nameMissing'),\n  email: z.email({ error: 'errors.form.emailInvalid' }),\n});\n\n/**\n * Contact Us Form Type\n */\nexport type ContactUsForm = z.infer<typeof ContactUsFormSchema>;\n\n/**\n * Signup Form Schema\n * Validates user registration form submissions\n */\nexport const SignupFormSchema = z.object({\n  name: z.string({ error: 'errors.form.missingField' }).min(1, 'errors.form.nameMissing'),\n  email: z.email({ error: 'errors.form.emailInvalid' }),\n  password: z\n    .string({ error: 'errors.form.missingField' })\n    .min(DEFAULT_PASSWORD, 'errors.form.passwordTooShort'),\n});\n\n/**\n * Signup Form Type\n */\nexport type SignupForm = z.infer<typeof SignupFormSchema>;\n"]}

package/dist/auth/schemas.d.ts

@@ -1,27 +1,26 @@
 import { z } from 'zod';
 /**
- * Zod schema for validating user login credentials.
- * @description Ensures the input object contains a valid email address and a password string.
- * @example
- * ```ts
- * LoginCredentialsSchema.parse({
- *   email: "user@example.com",
- *   password: ""
- * });
- * ```
+ * Contact Us Form Schema
+ * Validates contact form submissions
  */
-export declare const loginCredentialsSchema: z.ZodObject<{
-    email: z.ZodString;
+export declare const ContactUsFormSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodEmail;
+}, z.core.$strip>;
+/**
+ * Contact Us Form Type
+ */
+export type ContactUsForm = z.infer<typeof ContactUsFormSchema>;
+/**
+ * Signup Form Schema
+ * Validates user registration form submissions
+ */
+export declare const SignupFormSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodEmail;
     password: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    email?: string;
-    password?: string;
-}, {
-    email?: string;
-    password?: string;
-}>;
+}, z.core.$strip>;
 /**
- * Type inferred from {@link loginCredentialsSchema}.
- * @description Represents the shape of validated login credentials input.
+ * Signup Form Type
  */
-export type LoginCredentialsInput = z.infer<typeof loginCredentialsSchema>;
+export type SignupForm = z.infer<typeof SignupFormSchema>;

package/dist/db/databaseEventsType.d.ts

@@ -0,0 +1,9 @@
+export declare enum DATABASE_EVENT_TYPE {
+    BeforeQuery = "beforeQuery",
+    AfterQuery = "afterQuery",
+    QueryError = "queryError",
+    BeforeTransaction = "beforeTransaction",
+    AfterTransaction = "afterTransaction",
+    TransactionRollback = "transactionRollback",
+    HealthChange = "healthChange"
+}

package/dist/db/eventEmitter.d.ts

@@ -65,4 +65,47 @@ export interface DatabaseEventEmitterType {
     emitHealthChange<TDetails extends object = object>(previousStatus: boolean, currentStatus: boolean, details?: TDetails): void;
     emitQueryError(options: EmitQueryErrorOptions): void;
 }
+export interface BeforeQueryEvent extends DatabaseEvent {
+    type: 'beforeQuery';
+    adapter: string;
+    table: string;
+    operation: DatabaseOperationType;
+    params?: Record<string, object>;
+    context?: ContextType;
+}
+export interface AfterQueryEvent extends DatabaseEvent {
+    type: 'afterQuery';
+    adapter: string;
+    table: string;
+    operation: DatabaseOperationType;
+    duration: number;
+    affectedRows?: number;
+}
+export interface QueryErrorEvent extends DatabaseEvent {
+    type: 'queryError';
+    adapter: string;
+    table: string;
+    operation: DatabaseOperationType;
+    error: Error;
+    params?: Record<string, object>;
+    context?: ContextType;
+}
+export interface BeforeTransactionEvent extends DatabaseEvent {
+    type: 'beforeTransaction';
+    adapter: string;
+    transactionId: string;
+    context?: ContextType;
+}
+export interface AfterTransactionEvent extends DatabaseEvent {
+    type: 'afterTransaction';
+    adapter: string;
+    transactionId: string;
+    duration: number;
+}
+export interface TransactionRollbackEvent extends DatabaseEvent {
+    type: 'transactionRollback';
+    adapter: string;
+    transactionId: string;
+    error?: Error;
+}
 export {};

package/dist/db/index.cjs

@@ -20,7 +20,20 @@ var REPLICA_STRATEGY = /* @__PURE__ */ ((REPLICA_STRATEGY2) => {
   return REPLICA_STRATEGY2;
 })(REPLICA_STRATEGY || {});
 
+// src/db/databaseEventsType.ts
+var DATABASE_EVENT_TYPE = /* @__PURE__ */ ((DATABASE_EVENT_TYPE2) => {
+  DATABASE_EVENT_TYPE2["BeforeQuery"] = "beforeQuery";
+  DATABASE_EVENT_TYPE2["AfterQuery"] = "afterQuery";
+  DATABASE_EVENT_TYPE2["QueryError"] = "queryError";
+  DATABASE_EVENT_TYPE2["BeforeTransaction"] = "beforeTransaction";
+  DATABASE_EVENT_TYPE2["AfterTransaction"] = "afterTransaction";
+  DATABASE_EVENT_TYPE2["TransactionRollback"] = "transactionRollback";
+  DATABASE_EVENT_TYPE2["HealthChange"] = "healthChange";
+  return DATABASE_EVENT_TYPE2;
+})(DATABASE_EVENT_TYPE || {});
+
 exports.ADAPTERS = ADAPTERS;
+exports.DATABASE_EVENT_TYPE = DATABASE_EVENT_TYPE;
 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/adapter.ts","../../src/db/replicaStrategy.ts"],"names":["ADAPTERS","REPLICA_STRATEGY"],"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","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"]}
+{"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}"]}

package/dist/db/index.d.ts

@@ -13,3 +13,4 @@ export type * from './shard';
 export type * from './audit.types';
 export type * from './backup.types';
 export type * from './replica.types';
+export * from './databaseEventsType';

package/dist/db/index.js

@@ -18,6 +18,18 @@ var REPLICA_STRATEGY = /* @__PURE__ */ ((REPLICA_STRATEGY2) => {
   return REPLICA_STRATEGY2;
 })(REPLICA_STRATEGY || {});
 
-export { ADAPTERS, REPLICA_STRATEGY };
+// src/db/databaseEventsType.ts
+var DATABASE_EVENT_TYPE = /* @__PURE__ */ ((DATABASE_EVENT_TYPE2) => {
+  DATABASE_EVENT_TYPE2["BeforeQuery"] = "beforeQuery";
+  DATABASE_EVENT_TYPE2["AfterQuery"] = "afterQuery";
+  DATABASE_EVENT_TYPE2["QueryError"] = "queryError";
+  DATABASE_EVENT_TYPE2["BeforeTransaction"] = "beforeTransaction";
+  DATABASE_EVENT_TYPE2["AfterTransaction"] = "afterTransaction";
+  DATABASE_EVENT_TYPE2["TransactionRollback"] = "transactionRollback";
+  DATABASE_EVENT_TYPE2["HealthChange"] = "healthChange";
+  return DATABASE_EVENT_TYPE2;
+})(DATABASE_EVENT_TYPE || {});
+
+export { ADAPTERS, DATABASE_EVENT_TYPE, REPLICA_STRATEGY };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/db/adapter.ts","../../src/db/replicaStrategy.ts"],"names":["ADAPTERS","REPLICA_STRATEGY"],"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","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"]}
+{"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}"]}

package/dist/errors/types.d.ts

@@ -306,7 +306,7 @@ export interface PackageErrorLike extends Error {
     /** Convert error to string representation */
     toString(): string;
     /** Get user-friendly message for display to end users */
-    getUserMessage(): string;
+    getUserMessage(locale?: string): string;
 }
 export type AsyncMiddleware<TReturn = void> = (req: Request, res: Response, next: NextFunction) => Promise<TReturn>;
 export type MiddlewareWrapper = <TReturn>(fn: AsyncMiddleware<TReturn>) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
@@ -531,9 +531,10 @@ export interface ApiPackageErrorOptions<TEndpoints = unknown, TClient = ApiClien
     metadata?: Record<string, string | number | boolean | null>;
 }
 /**
- * Configuration for ApiPackageError class
+ * Generic configuration for package error classes
+ * Used by all @plyaz packages (api, notifications, errors, etc.)
  */
-export interface ApiPackageErrorConfig {
+export interface PackageErrorConfig {
     /** Package namespace for event emission */
     namespace?: string;
     /** Event factory for scoped events */
@@ -697,3 +698,41 @@ export type StatusCodeValue = number | InternalStatusCodeValue;
 export interface I18nContext {
     [key: string]: string | number | boolean | null | undefined;
 }
+/**
+ * ===== Sanitization Configuration =====
+ */
+/**
+ * Configuration for value sanitization in error messages
+ * Used to prevent injection attacks when interpolating values into error messages
+ *
+ * @example
+ * ```typescript
+ * const config: SanitizeConfig = {
+ *   maxLength: 500,
+ *   stripHtml: true,
+ *   escapeNewlines: true
+ * };
+ * ```
+ */
+export interface SanitizeConfig {
+    /**
+     * Maximum length for interpolated string values
+     * @default 1000
+     */
+    maxLength?: number;
+    /**
+     * Whether to strip all HTML tags
+     * @default true
+     */
+    stripHtml?: boolean;
+    /**
+     * Whether to escape newlines to prevent log injection
+     * @default true
+     */
+    escapeNewlines?: boolean;
+    /**
+     * Whether to limit object/array string representation
+     * @default true
+     */
+    limitComplexTypes?: boolean;
+}