@plyaz/types 1.6.0 → 1.7.1

package/dist/features/feature-flag/types.d.ts

@@ -6,68 +6,36 @@
  * @fileoverview Feature flags domain type definitions
  * @version 1.0.0
  */
+import type { UnknownRecord, UnknownArray, Arrayable, Promisable, SetOptional } from 'type-fest';
 import type * as React from 'react';
+import type { Describable, Timestamped, WithMetadata, Loadable, Authored, WithTags, WithEnvironment, Identifiable, Named, WithLogging, WithApiKey, Initializable, Refreshable, WithOperation, Enabled, WithError, KeyValuePair, WithUserId, WithCountry, Versioned, WithPlatform, WithPriority, ValidationResult } from '../../common/types';
 /**
  * Possible values that a feature flag can hold.
  * Supports primitive types and JSON objects for complex configurations.
  */
-export type FeatureFlagValue = boolean | string | number | Record<string, unknown>;
+export type FeatureFlagValue = boolean | string | number | UnknownRecord;
 /**
  * Core feature flag definition interface.
  * Represents a complete feature flag with all its metadata and configuration.
  */
-export interface FeatureFlag<FeatureFlagKey extends string> {
-    /** The unique identifier for this flag */
-    key: FeatureFlagKey;
-    /** Human-readable name for the flag */
-    name: string;
-    /** Detailed description of what this flag controls */
-    description: string;
-    /** Whether this flag is currently active */
-    isEnabled: boolean;
-    /** The value returned when this flag is evaluated */
-    value: FeatureFlagValue;
+export interface FeatureFlag<FeatureFlagKey extends string> extends Describable, Timestamped, WithMetadata, Authored, Named, WithTags, WithEnvironment, Enabled, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
     /** The data type of the flag value */
-    type: 'boolean' | 'string' | 'number' | 'json';
-    /** Which environment(s) this flag applies to */
-    environment: 'development' | 'staging' | 'production' | 'all';
+    type: FlagType;
     /** Percentage of users who should receive this flag (0-100) */
     rolloutPercentage?: number;
-    /** Timestamp when this flag was created */
-    createdAt: Date;
-    /** Timestamp when this flag was last updated */
-    updatedAt: Date;
-    /** Email or ID of the user who created this flag */
-    createdBy: string;
-    /** Email or ID of the user who last updated this flag */
-    updatedBy: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-    /** Tags for categorization */
-    tags?: string[];
 }
 /**
  * Feature flag rule for advanced targeting and conditional logic.
  */
-export interface FeatureFlagRule<FeatureFlagKey extends string> {
-    /** Unique identifier for this rule */
-    id: string;
+export interface FeatureFlagRule<FeatureFlagKey extends string> extends Identifiable, Named, WithPriority<number>, WithMetadata, Enabled {
     /** The feature flag this rule applies to */
     flagKey: FeatureFlagKey;
-    /** Human-readable name for this rule */
-    name: string;
     /** Array of conditions that must all be met for this rule to apply */
     conditions: FeatureFlagCondition[];
     /** The value to return if this rule matches */
     value: FeatureFlagValue;
     /** Percentage of matching users who should receive this value (0-100) */
     rolloutPercentage?: number;
-    /** Priority for rule evaluation (higher numbers = higher priority) */
-    priority: number;
-    /** Whether this rule is currently active */
-    isEnabled: boolean;
-    /** Rule metadata */
-    metadata?: Record<string, unknown>;
 }
 /**
  * Individual condition for feature flag rule evaluation.
@@ -78,39 +46,27 @@ export interface FeatureFlagCondition {
     /** The comparison operator to use */
     operator: 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'in' | 'not_in' | 'greater_than' | 'less_than';
     /** The value(s) to compare against */
-    value: string | number | string[] | number[];
+    value: Arrayable<string | number>;
 }
 /**
  * Context information used for feature flag evaluation.
  */
-export interface FeatureFlagContext {
-    /** Unique identifier for the user */
-    userId?: string;
+export interface FeatureFlagContext extends SetOptional<WithUserId, 'userId'>, WithCountry, Versioned, WithEnvironment, WithPlatform {
     /** User's email address */
     userEmail?: string;
     /** User's role or permission level */
     userRole?: string;
-    /** User's country code (ISO 3166-1 alpha-2) */
-    country?: string;
-    /** Platform the user is accessing from */
-    platform?: 'web' | 'mobile' | 'desktop';
-    /** Application version */
-    version?: string;
     /** Custom context data for advanced targeting */
-    custom?: Record<string, unknown>;
-    /** Current environment */
-    environment: 'development' | 'staging' | 'production';
+    custom?: UnknownRecord;
 }
 /**
  * Result of a feature flag evaluation.
  */
-export interface FeatureFlagEvaluation<FeatureFlagKey extends string> {
+export interface FeatureFlagEvaluation<FeatureFlagKey extends string> extends Enabled {
     /** The feature flag key that was evaluated */
     flagKey: FeatureFlagKey;
     /** The resolved value for this flag */
     value: FeatureFlagValue;
-    /** Whether the flag is considered enabled (truthy value) */
-    isEnabled: boolean;
     /** Explanation of how this value was determined */
     reason: 'default' | 'rule_match' | 'rollout' | 'override' | 'disabled';
     /** Source of the evaluation result */
@@ -123,7 +79,7 @@ export interface FeatureFlagEvaluation<FeatureFlagKey extends string> {
 /**
  * Configuration options for the feature flag system.
  */
-export interface FeatureFlagConfig<FeatureFlagKey extends string> {
+export interface FeatureFlagConfig<FeatureFlagKey extends string> extends SetOptional<WithLogging, 'isLoggingEnabled'>, WithApiKey {
     /** The storage provider to use for flag data */
     provider: 'database' | 'redis' | 'memory' | 'api' | 'file';
     /** Whether to enable caching of flag evaluations */
@@ -134,23 +90,19 @@ export interface FeatureFlagConfig<FeatureFlagKey extends string> {
     refreshInterval: number;
     /** Whether to fall back to default values on errors */
     shouldFallbackToDefaults: boolean;
-    /** Whether to enable debug logging */
-    isLoggingEnabled: boolean;
     /** API endpoint URL (required if provider is 'api') */
     apiEndpoint?: string;
-    /** API authentication key (required if provider is 'api') */
-    apiKey?: string;
     /** Database configuration (required if provider is 'database') */
     databaseConfig?: {
         connectionString: string;
         tableName: string;
-        options?: Record<string, unknown>;
+        options?: UnknownRecord;
     };
     /** Redis configuration (required if provider is 'redis') */
     redisConfig?: {
         url: string;
         keyPrefix: string;
-        options?: Record<string, unknown>;
+        options?: UnknownRecord;
     };
     /** File configuration (required if provider is 'file') */
     fileConfig?: {
@@ -180,28 +132,16 @@ export interface UseFeatureFlagOptions {
 /**
  * Internal state for feature flag evaluation in React hooks.
  */
-export interface FeatureFlagState<FeatureFlagKey extends string, T extends FeatureFlagValue = FeatureFlagValue> {
+export interface FeatureFlagState<FeatureFlagKey extends string, T extends FeatureFlagValue = FeatureFlagValue> extends Loadable {
     value: T;
-    isLoading: boolean;
-    error: Error | null;
     evaluation: FeatureFlagEvaluation<FeatureFlagKey> | null;
 }
 /**
  * Context value interface for React feature flag provider.
  */
-export interface FeatureFlagContextValue<FeatureFlagKey extends string> {
+export interface FeatureFlagContextValue<FeatureFlagKey extends string> extends Loadable, Initializable, Refreshable {
     /** The feature flag provider instance */
     provider: FeatureFlagProvider<FeatureFlagKey>;
-    /** Whether the provider is initialized */
-    isInitialized: boolean;
-    /** Whether the provider is currently loading */
-    isLoading: boolean;
-    /** Any error that occurred during initialization */
-    error: Error | null;
-    /** When the provider was last updated */
-    lastUpdated: Date | null;
-    /** Manual refresh function */
-    refresh: () => Promise<void>;
 }
 /**
  * Props for the React FeatureFlagProvider component.
@@ -232,27 +172,20 @@ export interface FeatureFlagProviderProps<FeatureFlagKey extends string, Feature
 /**
  * Backend Request DTO for flag creation.
  */
-export interface CreateFlagRequest<FeatureFlagKey extends string> {
-    key: FeatureFlagKey;
-    name: string;
-    description?: string;
-    value: FeatureFlagValue;
-    isEnabled?: boolean;
-    environment?: 'all' | 'development' | 'staging' | 'production';
+export interface CreateFlagRequest<FeatureFlagKey extends string> extends WithEnvironment, SetOptional<Enabled, 'isEnabled'>, SetOptional<Describable, 'description'>, Named, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
     rolloutPercentage?: number;
 }
 /**
  * Backend Provider health status information.
  */
-export interface ProviderHealthStatus {
-    isInitialized: boolean;
+export interface ProviderHealthStatus extends Initializable {
     provider: string;
     isCacheEnabled: boolean;
 }
 /**
  * Main interface for feature flag providers.
  */
-export interface FeatureFlagProvider<FeatureFlagKey extends string> {
+export interface FeatureFlagProvider<FeatureFlagKey extends string> extends Refreshable {
     /** Initializes the provider by loading initial data */
     initialize(): Promise<void>;
     /** Evaluates a feature flag and returns full evaluation details */
@@ -263,8 +196,6 @@ export interface FeatureFlagProvider<FeatureFlagKey extends string> {
     isEnabled(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<boolean>;
     /** Gets the value of a feature flag with optional type casting */
     getValue<T = FeatureFlagValue>(key: FeatureFlagKey, context?: FeatureFlagContext): Promise<T>;
-    /** Refreshes the flag data from the underlying storage */
-    refresh(): Promise<void>;
     /** Subscribes to flag changes and updates */
     subscribe(callback: () => void): () => void;
     /** Sets an override for a specific flag key */
@@ -308,15 +239,9 @@ export type FeatureFlagOverrides<FeatureFlagKey extends string = string> = Parti
 /**
  * Hook-like interface for reactive feature flag usage.
  */
-export type FeatureFlagHook<T = boolean> = {
+export type FeatureFlagHook<T = boolean> = Loadable & WithError & Refreshable & {
     /** The current value of the flag */
     value: T;
-    /** Whether the flag is currently being loaded */
-    isLoading: boolean;
-    /** Any error that occurred during flag evaluation */
-    error: Error | null;
-    /** Function to manually refresh the flag value */
-    refresh: () => Promise<void>;
 };
 /**
  * Helper functions for managing feature flags.
@@ -329,7 +254,7 @@ export interface FeatureFlagHelpers<FeatureFlagKey extends string = string> {
     getMultipleFlags: (keys: FeatureFlagKey[], context?: FeatureFlagContext) => Promise<Record<FeatureFlagKey, FeatureFlagValue>>;
     isAnyEnabled: (keys: FeatureFlagKey[], context?: FeatureFlagContext) => Promise<boolean>;
     isAllEnabled: (keys: FeatureFlagKey[], context?: FeatureFlagContext) => Promise<boolean>;
-    whenEnabled: <T>(key: FeatureFlagKey, callback: () => T | Promise<T>, fallback?: () => T | Promise<T>, context?: FeatureFlagContext) => Promise<T | undefined>;
+    whenEnabled: <T>(key: FeatureFlagKey, callback: () => Promisable<T>, fallback?: () => Promisable<T>, context?: FeatureFlagContext) => Promise<T | undefined>;
 }
 /**
  * Response structure for fetching feature flag data.
@@ -367,32 +292,18 @@ export interface ErrorHandlingTestInput {
 /**
  * Input for flag evaluation test cases
  */
-export interface FlagEvaluationTestInput<FeatureFlagKey extends string> {
+export interface FlagEvaluationTestInput<FeatureFlagKey extends string> extends Enabled {
     /** The flag key to evaluate */
     flagKey: FeatureFlagKey;
     /** Optional evaluation context */
     context?: FeatureFlagContext;
     /** Mock value to return */
     mockValue: boolean;
-    /** Whether the flag is enabled */
-    isEnabled: boolean;
 }
 /**
  * Input for flag creation test cases
  */
-export interface FlagCreationTestInput<FeatureFlagKey extends string> {
-    /** Unique key for the flag */
-    key: FeatureFlagKey;
-    /** Human-readable name */
-    name: string;
-    /** Optional description */
-    description?: string;
-    /** Flag value */
-    value: FeatureFlagValue;
-    /** Whether the flag is enabled */
-    isEnabled?: boolean;
-    /** Target environment */
-    environment?: 'all' | 'development' | 'production' | 'staging';
+export interface FlagCreationTestInput<FeatureFlagKey extends string> extends WithEnvironment, Enabled, Describable, Named, KeyValuePair<FeatureFlagKey, FeatureFlagValue> {
     /** Rollout percentage (0-100) */
     rolloutPercentage?: number;
 }
@@ -403,7 +314,7 @@ export interface FlagUpdateTestInput<FeatureFlagKey extends string> {
     /** Key of the flag to update */
     flagKey: FeatureFlagKey;
     /** Update data object */
-    updateData: Record<string, unknown>;
+    updateData: UnknownRecord;
 }
 /**
  * Input for override test cases
@@ -468,15 +379,13 @@ export interface EnvironmentFilterTestInput {
 /**
  * Input for timestamp behavior test cases
  */
-export interface TimestampTestInput {
-    /** Operation type */
-    operation: 'create' | 'update';
+export interface TimestampTestInput extends WithOperation<'create' | 'update'> {
     /** Description of expected timestamp behavior */
     expectedTimestampBehavior: string;
 }
 export interface ModuleConfigurationTestInput {
-    config: Record<string, unknown>;
-    expectedConfig: Record<string, unknown>;
+    config: UnknownRecord;
+    expectedConfig: UnknownRecord;
 }
 /**
  * Input for provider type test cases.
@@ -509,9 +418,7 @@ export interface ProviderTypeTestInput {
  * };
  * ```
  */
-export interface FlagOperationTestInput<FeatureFlagKey extends string> {
-    /** Type of operation to perform */
-    operation: 'create' | 'update' | 'delete' | 'evaluate';
+export interface FlagOperationTestInput<FeatureFlagKey extends string> extends WithOperation<'create' | 'update' | 'delete' | 'evaluate'>, Partial<Identifiable>, Partial<WithMetadata> {
     /** Key of the flag to operate on */
     flagKey: FeatureFlagKey;
     /** Data for create/update operations */
@@ -535,11 +442,9 @@ export interface FlagOperationTestInput<FeatureFlagKey extends string> {
  * };
  * ```
  */
-export interface PermissionTestInput {
+export interface PermissionTestInput extends WithOperation {
     /** User role to test */
     role: string;
-    /** Operation being performed */
-    operation: string;
     /** Resource being accessed */
     resource: string;
     /** Expected permission result */
@@ -560,9 +465,7 @@ export interface PermissionTestInput {
  * };
  * ```
  */
-export interface CacheOperationTestInput<FeatureFlagKey extends string> {
-    /** Cache operation to perform */
-    operation: 'set' | 'get' | 'refresh' | 'clear';
+export interface CacheOperationTestInput<FeatureFlagKey extends string> extends WithOperation<'set' | 'get' | 'refresh' | 'clear'> {
     /** Flag key for operations (optional for 'clear') */
     flagKey?: FeatureFlagKey;
     /** Description of expected cache behavior */
@@ -593,7 +496,7 @@ export interface RuleEvaluationTestInput<FeatureFlagKey extends string> {
     /** Array of rules with conditions and values */
     rules: Array<{
         /** Conditions that must be met */
-        conditions: Record<string, unknown>;
+        conditions: UnknownRecord;
         /** Value to return if conditions match */
         value: FeatureFlagValue;
     }>;
@@ -622,16 +525,14 @@ export interface RuleEvaluationTestInput<FeatureFlagKey extends string> {
  */
 export interface BatchOperationTestInput<FeatureFlagKey extends string> {
     /** Array of operations to execute in batch */
-    operations: Array<{
-        /** Type of operation */
-        type: 'create' | 'update' | 'delete';
+    operations: Array<WithOperation<'create' | 'update' | 'delete'> & {
         /** Flag key to operate on */
         flagKey: FeatureFlagKey;
         /** Operation data (for create/update) */
         data?: unknown;
     }>;
     /** Expected results for each operation */
-    expectedResults: unknown[];
+    expectedResults: UnknownArray;
 }
 /**
  * Input for validation test cases.
@@ -647,15 +548,13 @@ export interface BatchOperationTestInput<FeatureFlagKey extends string> {
  * };
  * ```
  */
-export interface ValidationTestInput {
+export interface ValidationTestInput extends Pick<ValidationResult, 'isValid'> {
     /** Input value to validate */
     input: unknown;
     /** Field name being validated */
     field: string;
     /** Expected error message if validation fails */
     expectedError?: string;
-    /** Whether the input should be valid */
-    isValid: boolean;
 }
 /**
  * Input for dynamic module configuration test cases.
@@ -673,7 +572,7 @@ export interface ValidationTestInput {
  */
 export interface DynamicModuleTestInput {
     /** Module configuration object */
-    config: Record<string, unknown>;
+    config: UnknownRecord;
     /** Expected providers to be registered */
     expectedProviders?: string[];
     /** Expected modules to be imported */
@@ -702,7 +601,7 @@ export interface AsyncModuleConfigTestInput {
     /** Services to inject into factory */
     inject?: string[];
     /** Factory function for configuration */
-    useFactory?: (...args: unknown[]) => Record<string, unknown>;
+    useFactory?: (...args: unknown[]) => UnknownRecord;
     /** Expected modules in result */
     expectedImports?: string[];
     /** Expected providers in result */
@@ -722,9 +621,7 @@ export interface AsyncModuleConfigTestInput {
  * };
  * ```
  */
-export interface RepositoryOperationTestInput {
-    /** Repository operation to test */
-    operation: 'create' | 'update' | 'delete' | 'find';
+export interface RepositoryOperationTestInput extends WithOperation<'create' | 'update' | 'delete' | 'find'> {
     /** Data for the operation */
     data?: unknown;
     /** Expected operation result */
@@ -752,27 +649,11 @@ export interface RepositoryOperationTestInput {
  * };
  * ```
  */
-export interface FlagDefaults {
-    /** Flag name */
-    name: string;
-    /** Flag description */
-    description: string;
-    /** Whether flag is enabled */
-    isEnabled: boolean;
+export interface FlagDefaults extends Named, Describable, Enabled, WithEnvironment, Timestamped<Date, Date>, Authored {
     /** Default value */
     value: FeatureFlagValue;
     /** Flag type */
     type: FlagType;
-    /** Environment */
-    environment: 'development' | 'staging' | 'production' | 'all';
-    /** Created date */
-    createdAt: Date;
-    /** Updated date */
-    updatedAt: Date;
-    /** Created by */
-    createdBy: string;
-    /** Updated by */
-    updatedBy: string;
 }
 /**
  * Supported types for feature flag values.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/auth/enums.ts","../src/errors/enums.ts","../src/events/enums.ts","../src/web3/enums.ts"],"names":[],"mappings":";;;AAYO,IAAM,SAAY,GAAA;AAAA;AAAA,EAEvB,OAAS,EAAA,SAAA;AAAA;AAAA,EAGT,KAAO,EAAA,OAAA;AAAA;AAAA,EAGP,KAAO,EAAA,OAAA;AAAA;AAAA,EAGP,IAAM,EAAA,MAAA;AAAA;AAAA,EAGN,GAAK,EAAA,KAAA;AAAA;AAAA,EAGL,KAAO,EAAA,OAAA;AAAA;AAAA,EAGP,UAAY,EAAA;AACd;AAcO,IAAM,WAAc,GAAA;AAAA;AAAA,EAEzB,MAAQ,EAAA,QAAA;AAAA;AAAA,EAGR,QAAU,EAAA,UAAA;AAAA;AAAA,EAGV,OAAS,EAAA,SAAA;AAAA;AAAA,EAGT,SAAW,EAAA,WAAA;AAAA;AAAA,EAGX,MAAQ,EAAA;AACV;AAcO,IAAM,aAAgB,GAAA;AAAA;AAAA,EAE3B,KAAO,EAAA,OAAA;AAAA;AAAA,EAGP,MAAQ,EAAA;AACV;;;AClEO,IAAM,UAAa,GAAA;AAAA;AAAA,EAExB,eAAiB,EAAA,kBAAA;AAAA;AAAA,EAGjB,qBAAuB,EAAA,yBAAA;AAAA;AAAA,EAGvB,aAAe,EAAA,uBAAA;AAAA;AAAA,EAGf,kBAAoB,EAAA,4BAAA;AAAA;AAAA,EAGpB,YAAc,EAAA,gBAAA;AAAA;AAAA,EAGd,iBAAmB,EAAA;AACrB;AAcO,IAAM,cAAiB,GAAA;AAAA;AAAA,EAE5B,GAAK,EAAA,KAAA;AAAA;AAAA,EAGL,MAAQ,EAAA,QAAA;AAAA;AAAA,EAGR,IAAM,EAAA,MAAA;AAAA;AAAA,EAGN,QAAU,EAAA;AACZ;AAcO,IAAM,cAAiB,GAAA;AAAA;AAAA,EAE5B,MAAQ,EAAA,QAAA;AAAA;AAAA,EAGR,MAAQ,EAAA,QAAA;AAAA;AAAA,EAGR,OAAS,EAAA,SAAA;AAAA;AAAA,EAGT,UAAY,EAAA,YAAA;AAAA;AAAA,EAGZ,UAAY,EAAA;AACd;;;AC9EO,IAAM,UAAa,GAAA;AAAA;AAAA,EAExB,OAAS,EAAA;AACX;AAaO,IAAM,cAAiB,GAAA;AAAA;AAAA,EAE5B,GAAK,EAAA,KAAA;AAAA;AAAA,EAEL,MAAQ,EAAA,QAAA;AAAA;AAAA,EAER,IAAM,EAAA,MAAA;AAAA;AAAA,EAEN,QAAU,EAAA;AACZ;AAkBO,IAAM,YAAe,GAAA;AAAA;AAAA,EAE1B,OAAS,EAAA,SAAA;AAAA;AAAA,EAET,UAAY,EAAA,YAAA;AAAA;AAAA,EAEZ,SAAW,EAAA,WAAA;AAAA;AAAA,EAEX,MAAQ,EAAA,QAAA;AAAA;AAAA,EAER,QAAU,EAAA;AACZ;;;ACpDO,IAAM,QAAW,GAAA;AAAA;AAAA,EAEtB,eAAiB,EAAA,CAAA;AAAA;AAAA,EAGjB,eAAiB,EAAA,QAAA;AAAA;AAAA,EAGjB,QAAU,EAAA,EAAA;AAAA;AAAA,EAGV,eAAiB,EAAA,QAAA;AAAA;AAAA,EAGjB,QAAU,EAAA,KAAA;AAAA;AAAA,EAGV,eAAiB,EAAA,MAAA;AAAA;AAAA,EAGjB,OAAS,EAAA,GAAA;AAAA;AAAA,EAGT,WAAa,EAAA,KAAA;AAAA;AAAA,EAGb,IAAM,EAAA,IAAA;AAAA;AAAA,EAGN,WAAa,EAAA;AACf","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","/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n","/**\n * Enum representing the types of events in the application.\n * Uses dot notation for event naming convention.\n *\n * @example\n * ```typescript\n * import { EVENT_TYPE } from '@plyaz/types';\n *\n * const eventType = EVENT_TYPE.AppInit; // 'app.init'\n * ```\n */\nexport const EVENT_TYPE = {\n  /** Application initialization event. */\n  AppInit: 'app.init',\n} as const;\n\n/**\n * Const representing the priority levels for events.\n * Used to determine processing order and resource allocation.\n *\n * @example\n * ```typescript\n * import { EVENT_PRIORITY } from '@plyaz/types';\n *\n * const priority = EVENT_PRIORITY.High; // 'high'\n * ```\n */\nexport const EVENT_PRIORITY = {\n  /** Low priority event. */\n  Low: 'low',\n  /** Normal priority event. */\n  Normal: 'normal',\n  /** High priority event. */\n  High: 'high',\n  /** Critical priority event. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Const representing the status of an event.\n * Tracks the lifecycle of event processing from creation to completion.\n *\n * @example\n * ```typescript\n * import { EVENT_STATUS } from '@plyaz/types';\n *\n * const status = EVENT_STATUS.Processing; // 'processing'\n *\n * // Typical event lifecycle:\n * // Pending -> Processing -> Completed\n * // or\n * // Pending -> Processing -> Failed -> Retrying -> Processing -> Completed\n * ```\n */\nexport const EVENT_STATUS = {\n  /** Event is pending and has not started processing. */\n  Pending: 'pending',\n  /** Event is currently being processed. */\n  Processing: 'processing',\n  /** Event has been completed successfully. */\n  Completed: 'completed',\n  /** Event processing failed. */\n  Failed: 'failed',\n  /** Event is being retried after a failure. */\n  Retrying: 'retrying',\n} as const;\n","/**\n * Enum representing supported EVM-compatible blockchain networks by their numeric chain IDs.\n * @description These IDs are used to identify the specific network when interacting with wallets or smart contracts.\n * @see https://chainlist.org for reference chain IDs\n *\n * @example\n * ```typescript\n * import { CHAIN_ID } from '@plyaz/types';\n *\n * const chainId = CHAIN_ID.EthereumMainnet; // 1\n * const isTestnet = chainId === CHAIN_ID.EthereumSepolia || chainId === CHAIN_ID.PolygonAmoy;\n * ```\n */\nexport const CHAIN_ID = {\n  /** Ethereum Mainnet (Chain ID: 1). */\n  EthereumMainnet: 1,\n\n  /** Ethereum Sepolia Testnet (Chain ID: 11155111). */\n  EthereumSepolia: 11_155_111,\n\n  /** Optimism Mainnet (Chain ID: 10). */\n  Optimism: 10,\n\n  /** Optimism Sepolia Testnet (Chain ID: 11155420). */\n  OptimismSepolia: 11_155_420,\n\n  /** Arbitrum One Mainnet (Chain ID: 42161). */\n  Arbitrum: 42_161,\n\n  /** Arbitrum Sepolia Testnet (Chain ID: 421614). */\n  ArbitrumSepolia: 421_614,\n\n  /** Polygon Mainnet (Chain ID: 137). */\n  Polygon: 137,\n\n  /** Polygon Amoy Testnet (Chain ID: 80002). */\n  PolygonAmoy: 80_002,\n\n  /** Base Mainnet (Chain ID: 8453). */\n  Base: 8_453,\n\n  /** Base Sepolia Testnet (Chain ID: 84532). */\n  BaseSepolia: 84_532,\n} as const;\n"]}
+{"version":3,"sources":["../src/auth/enums.ts","../src/errors/enums.ts","../src/events/enums.ts","../src/web3/enums.ts"],"names":[],"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;;;AClEO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,eAAA,EAAiB,kBAAA;AAAA;AAAA,EAGjB,qBAAA,EAAuB,yBAAA;AAAA;AAAA,EAGvB,aAAA,EAAe,uBAAA;AAAA;AAAA,EAGf,kBAAA,EAAoB,4BAAA;AAAA;AAAA,EAGpB,YAAA,EAAc,gBAAA;AAAA;AAAA,EAGd,iBAAA,EAAmB;AACrB;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,QAAA,EAAU;AACZ;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,UAAA,EAAY,YAAA;AAAA;AAAA,EAGZ,UAAA,EAAY;AACd;;;AC9EO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,OAAA,EAAS;AACX;AAaO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAEL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAER,IAAA,EAAM,MAAA;AAAA;AAAA,EAEN,QAAA,EAAU;AACZ;AAkBO,IAAM,YAAA,GAAe;AAAA;AAAA,EAE1B,OAAA,EAAS,SAAA;AAAA;AAAA,EAET,UAAA,EAAY,YAAA;AAAA;AAAA,EAEZ,SAAA,EAAW,WAAA;AAAA;AAAA,EAEX,MAAA,EAAQ,QAAA;AAAA;AAAA,EAER,QAAA,EAAU;AACZ;;;ACpDO,IAAM,QAAA,GAAW;AAAA;AAAA,EAEtB,eAAA,EAAiB,CAAA;AAAA;AAAA,EAGjB,eAAA,EAAiB,QAAA;AAAA;AAAA,EAGjB,QAAA,EAAU,EAAA;AAAA;AAAA,EAGV,eAAA,EAAiB,QAAA;AAAA;AAAA,EAGjB,QAAA,EAAU,KAAA;AAAA;AAAA,EAGV,eAAA,EAAiB,MAAA;AAAA;AAAA,EAGjB,OAAA,EAAS,GAAA;AAAA;AAAA,EAGT,WAAA,EAAa,KAAA;AAAA;AAAA,EAGb,IAAA,EAAM,IAAA;AAAA;AAAA,EAGN,WAAA,EAAa;AACf","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","/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n","/**\n * Enum representing the types of events in the application.\n * Uses dot notation for event naming convention.\n *\n * @example\n * ```typescript\n * import { EVENT_TYPE } from '@plyaz/types';\n *\n * const eventType = EVENT_TYPE.AppInit; // 'app.init'\n * ```\n */\nexport const EVENT_TYPE = {\n  /** Application initialization event. */\n  AppInit: 'app.init',\n} as const;\n\n/**\n * Const representing the priority levels for events.\n * Used to determine processing order and resource allocation.\n *\n * @example\n * ```typescript\n * import { EVENT_PRIORITY } from '@plyaz/types';\n *\n * const priority = EVENT_PRIORITY.High; // 'high'\n * ```\n */\nexport const EVENT_PRIORITY = {\n  /** Low priority event. */\n  Low: 'low',\n  /** Normal priority event. */\n  Normal: 'normal',\n  /** High priority event. */\n  High: 'high',\n  /** Critical priority event. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Const representing the status of an event.\n * Tracks the lifecycle of event processing from creation to completion.\n *\n * @example\n * ```typescript\n * import { EVENT_STATUS } from '@plyaz/types';\n *\n * const status = EVENT_STATUS.Processing; // 'processing'\n *\n * // Typical event lifecycle:\n * // Pending -> Processing -> Completed\n * // or\n * // Pending -> Processing -> Failed -> Retrying -> Processing -> Completed\n * ```\n */\nexport const EVENT_STATUS = {\n  /** Event is pending and has not started processing. */\n  Pending: 'pending',\n  /** Event is currently being processed. */\n  Processing: 'processing',\n  /** Event has been completed successfully. */\n  Completed: 'completed',\n  /** Event processing failed. */\n  Failed: 'failed',\n  /** Event is being retried after a failure. */\n  Retrying: 'retrying',\n} as const;\n","/**\n * Enum representing supported EVM-compatible blockchain networks by their numeric chain IDs.\n * @description These IDs are used to identify the specific network when interacting with wallets or smart contracts.\n * @see https://chainlist.org for reference chain IDs\n *\n * @example\n * ```typescript\n * import { CHAIN_ID } from '@plyaz/types';\n *\n * const chainId = CHAIN_ID.EthereumMainnet; // 1\n * const isTestnet = chainId === CHAIN_ID.EthereumSepolia || chainId === CHAIN_ID.PolygonAmoy;\n * ```\n */\nexport const CHAIN_ID = {\n  /** Ethereum Mainnet (Chain ID: 1). */\n  EthereumMainnet: 1,\n\n  /** Ethereum Sepolia Testnet (Chain ID: 11155111). */\n  EthereumSepolia: 11_155_111,\n\n  /** Optimism Mainnet (Chain ID: 10). */\n  Optimism: 10,\n\n  /** Optimism Sepolia Testnet (Chain ID: 11155420). */\n  OptimismSepolia: 11_155_420,\n\n  /** Arbitrum One Mainnet (Chain ID: 42161). */\n  Arbitrum: 42_161,\n\n  /** Arbitrum Sepolia Testnet (Chain ID: 421614). */\n  ArbitrumSepolia: 421_614,\n\n  /** Polygon Mainnet (Chain ID: 137). */\n  Polygon: 137,\n\n  /** Polygon Amoy Testnet (Chain ID: 80002). */\n  PolygonAmoy: 80_002,\n\n  /** Base Mainnet (Chain ID: 8453). */\n  Base: 8_453,\n\n  /** Base Sepolia Testnet (Chain ID: 84532). */\n  BaseSepolia: 84_532,\n} as const;\n"]}

package/dist/testing/common/assertions/types.d.ts

@@ -3,6 +3,8 @@
  *
  * Type definitions for assertion utilities.
  */
+import type { UnknownRecord, UnknownArray, Promisable } from 'type-fest';
+import type { WithStatusCode, WithMessage, WithTimestamp, WithCorrelationId, WithMetadata, Named, WithRequestId, WithStatus } from '../../../common/types';
 /**
  * Pattern for matching HTTP errors with status code and message.
  * Used in testing to assert specific error responses.
@@ -15,9 +17,7 @@
  * };
  * ```
  */
-export interface ErrorPattern {
-    /** HTTP status code to match */
-    status: number;
+export interface ErrorPattern extends WithStatusCode, WithStatus {
     /** Regular expression to match against error message */
     message: RegExp;
 }
@@ -33,9 +33,7 @@ export interface ErrorPattern {
  * };
  * ```
  */
-export interface ValidationErrorPattern {
-    /** HTTP status code (typically 400 for validation errors) */
-    status: number;
+export interface ValidationErrorPattern extends WithStatusCode {
     /** Array of field names that failed validation */
     validation: string[];
 }
@@ -63,13 +61,11 @@ export interface ErrorStats {
  * Entry in an error timeline tracking when errors occurred.
  * Used for debugging error patterns over time.
  */
-export interface ErrorTimelineEntry {
-    /** Unix timestamp when the error occurred */
-    timestamp: number;
+export interface ErrorTimelineEntry extends WithTimestamp<number> {
     /** The error that occurred */
     error: Error;
     /** Additional context data at the time of error */
-    context?: Record<string, unknown>;
+    context?: UnknownRecord;
 }
 /**
  * Expected error pattern for validation.
@@ -95,7 +91,7 @@ export interface ExpectedError {
  */
 export interface ValidationResponse {
     /** Array of validation error messages */
-    message?: unknown[];
+    message?: UnknownArray;
 }
 /**
  * Result type for hooks that return a value.
@@ -143,19 +139,15 @@ export interface ErrorRecoveryResult {
  * Entry for correlating errors with additional context.
  * Used in error tracking and debugging systems.
  */
-export interface ErrorCorrelationEntry {
-    /** The error being tracked */
+export interface ErrorCorrelationEntry extends Partial<WithMetadata<UnknownRecord>> {
+    /** The original error that triggered recovery */
     error: Error;
-    /** Additional metadata for correlation */
-    metadata?: Record<string, unknown>;
 }
 /**
  * Definition of an error test scenario.
  * Used to parameterize error testing across multiple cases.
  */
-export interface ErrorTestScenario {
-    /** Descriptive name for the test scenario */
-    name: string;
+export interface ErrorTestScenario extends Named {
     /** Function that should trigger the error */
     fn: () => unknown | Promise<unknown>;
     /** Expected error or error pattern */
@@ -211,7 +203,7 @@ export interface ErrorPropagationTestResult<T> {
  */
 export interface ErrorCircuitBreaker<T> {
     /** Execute function with circuit breaker protection */
-    execute: (fn: () => T | Promise<T>) => Promise<T>;
+    execute: (fn: () => Promisable<T>) => Promisable<T>;
     /** Get current circuit state */
     getState: () => 'closed' | 'open' | 'half-open';
     /** Get error statistics */
@@ -225,7 +217,7 @@ export interface ErrorCircuitBreaker<T> {
  */
 export interface ErrorCorrelator {
     /** Create correlation ID for an error */
-    correlate: (error: Error, metadata?: Record<string, unknown>) => string;
+    correlate: (error: Error, metadata?: UnknownRecord) => string;
     /** Get all errors with same correlation ID */
     getRelated: (correlationId: string) => Array<ErrorCorrelationEntry>;
     /** Get chain of errors leading to this one */
@@ -237,7 +229,7 @@ export interface ErrorCorrelator {
  */
 export interface ErrorMetrics {
     /** Record an error occurrence */
-    record: (error: Error, context?: Record<string, unknown>) => void;
+    record: (error: Error, context?: UnknownRecord) => void;
     /** Get aggregated error metrics */
     getMetrics: () => {
         /** Total error count */
@@ -272,10 +264,7 @@ export interface ErrorDeduplicator {
  * Simple error interface with message property.
  * Used for type guards and error handling.
  */
-export interface ErrorWithMessage {
-    /** Error message */
-    message: string;
-}
+export type ErrorWithMessage = WithMessage;
 /**
  * Error interface that includes HTTP response data.
  * Common in API error handling scenarios.
@@ -300,9 +289,7 @@ export interface ValidationMessage {
  * Expected HTTP exception pattern for testing.
  * Used to assert specific HTTP error responses.
  */
-export interface ExpectedHttpException {
-    /** Expected HTTP status code */
-    status?: number;
+export interface ExpectedHttpException extends Partial<WithStatusCode>, WithStatus {
     /** Expected error message or pattern */
     message?: string | RegExp;
     /** Expected response body */
@@ -332,17 +319,11 @@ export interface ErrorPropagationInjection {
  * Context data for enriching errors with additional information.
  * Helps with debugging and error tracking.
  */
-export interface ErrorEnrichmentContext {
+export interface ErrorEnrichmentContext extends Partial<WithTimestamp<number>>, Partial<WithCorrelationId>, Partial<WithMetadata<UnknownRecord>>, Partial<WithRequestId> {
     /** Operation being performed when error occurred */
     operation?: string;
     /** User identifier associated with error */
     user?: string;
-    /** Timestamp of error occurrence */
-    timestamp?: number;
-    /** Request ID for tracing */
-    requestId?: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
 }
 /**
  * Configuration options for error deduplication.