@plyaz/types 1.22.0 → 1.22.2

package/dist/errors/middleware.d.ts

@@ -7,12 +7,29 @@
 import type { Request, Response } from 'express';
 import type { SerializedError, ErrorStoreActions } from './store';
 import type { ErrorEventFactory, ErrorResponse } from './types';
+/**
+ * Source identifier for error tracking.
+ * Used to identify where an error originated from.
+ */
+export type ErrorSource = 'express' | 'nestjs' | 'nodejs' | 'nextjs' | 'http' | 'api' | 'global' | string;
+/**
+ * Logger interface for error handlers.
+ * Compatible with @plyaz/logger PackageLogger and standard loggers.
+ */
+export interface ErrorHandlerLogger {
+    error(message: string, meta?: Record<string, unknown>, ...details: unknown[]): void;
+    warn?(message: string, meta?: Record<string, unknown>, ...details: unknown[]): void;
+    info?(message: string, meta?: Record<string, unknown>, ...details: unknown[]): void;
+    debug?(message: string, meta?: Record<string, unknown>, ...details: unknown[]): void;
+}
 /**
  * Configuration for HTTP error handler middleware.
- * Used by Express and NestJS error handlers.
+ * Used by Express, NestJS, and other Node.js backend error handlers.
  */
 export interface HttpErrorHandlerConfig {
-    /** Global error handler instance (optional - for tracking) */
+    /** Source identifier for errors (e.g., 'express', 'nestjs', 'nextjs') */
+    source?: ErrorSource;
+    /** Global error handler instance (optional - for tracking). If not provided, uses global handler. */
     errorHandler?: GlobalErrorHandler;
     /** Include stack traces in response (default: false) */
     includeStack?: boolean;
@@ -20,8 +37,10 @@ export interface HttpErrorHandlerConfig {
     formatError?: (error: SerializedError, req: Request) => ErrorResponse;
     /** Callback when error is handled */
     onError?: (error: SerializedError, req: Request, res: Response) => void;
-    /** Log errors to console (default: true) */
-    logErrors?: boolean;
+    /** Log errors (default: true). Set false to disable, or provide a logger instance */
+    logErrors?: boolean | ErrorHandlerLogger;
+    /** Callback before clearing errors - use for monitoring (Grafana, Sentry, Datadog) */
+    beforeClear?: (errors: SerializedError[]) => void | Promise<void>;
 }
 /**
  * Configuration for the global error handler.

package/dist/examples/types.d.ts

@@ -9,7 +9,6 @@ import type { CreateExampleSchema, UpdateExampleSchema, PatchExampleSchema, Quer
 import type { CoreEntityCreatedPayload, CoreEntityUpdatedPayload, CoreEntityDeletedPayload, CoreValidationFailedPayload } from '../core/events';
 import type { CoreBaseFrontendStore, CoreBaseFrontendServiceConfig } from '../core/frontend';
 import type { CoreServiceInitConfig } from '../core/init';
-import type { CoreBaseDomainServiceConfig } from '../core/domain';
 /**
  * Create request DTO (POST body)
  */
@@ -118,17 +117,14 @@ export interface ExampleFrontendStore extends CoreBaseFrontendStore<ExampleFront
     items: ExampleEntity[];
     selectedId: string | null;
     isLoading: boolean;
-    error: Error | null;
     setData(data: ExampleFrontendStoreData): void;
     updateData?(data: Partial<ExampleFrontendStoreData>): void;
     setLoading(isLoading: boolean): void;
-    setError(error: unknown): void;
     setItems(items: ExampleEntity[]): void;
     addItem(item: ExampleEntity): void;
     updateItem(id: string, updates: Partial<ExampleEntity>): void;
     removeItem(id: string): void;
     selectItem(id: string | null): void;
-    clearError(): void;
 }
 /**
  * Example Frontend Service Configuration
@@ -159,9 +155,17 @@ export interface ExampleUser extends Record<string, unknown> {
 /**
  * Example Domain Service Configuration
  */
-export interface ExampleDomainServiceConfig extends CoreBaseDomainServiceConfig, CoreServiceInitConfig {
+export interface ExampleDomainServiceConfig extends CoreServiceInitConfig {
     /** Use real API client instead of mocks */
     useRealApi?: boolean;
     /** API base path for example endpoints */
     apiBasePath?: string;
+    /** Throw on validation errors (default: true) */
+    throwOnValidationError?: boolean;
+    /** Throw on repository errors (default: true) */
+    throwOnRepositoryError?: boolean;
+    /** Emit lifecycle events (default: true) */
+    emitEvents?: boolean;
+    /** Service enabled */
+    enabled?: boolean;
 }

package/dist/features/cache/index.cjs

@@ -1,4 +1,10 @@
 'use strict';
 
+// @plyaz package - Built with tsup
+
+// src/features/cache/types.ts
+var CACHE_STRATEGIES = ["memory", "redis"];
+
+exports.CACHE_STRATEGIES = CACHE_STRATEGIES;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/features/cache/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../../src/features/cache/types.ts"],"names":[],"mappings":";;;;;AAyBO,IAAM,gBAAA,GAAmB,CAAC,QAAA,EAAU,OAAO","file":"index.cjs","sourcesContent":["/**\n * Cache Types and Interfaces\n *\n * Type definitions for the caching layer.\n * This will be moved to @plyaz/core when the package structure is finalized.\n *\n * @fileoverview Cache type definitions\n * @version 1.0.0\n */\n\n/**\n * Cache entry structure that wraps cached data with metadata.\n */\nimport type {\n  Configurable,\n  WithExpiration,\n  WithMetadata,\n  Enabled,\n  WithUrl,\n  Timestamped,\n} from '../../common/types';\n\n/**\n * Available cache strategies\n */\nexport const CACHE_STRATEGIES = ['memory', 'redis'] as const;\n\n/**\n * Cache strategy type\n */\nexport type CacheStrategyType = (typeof CACHE_STRATEGIES)[number];\n\nexport interface CacheEntry<T = unknown>\n  extends Partial<WithMetadata<Record<string, unknown>>>,\n    WithExpiration<number>,\n    Pick<Timestamped<number, number>, 'createdAt'> {\n  /** The cached data */\n  data: T;\n}\n\nexport interface GenericCacheEntry<T = unknown> {\n  value: T;\n  timestamp: number;\n  ttl: number;\n}\n\n/**\n * Cache statistics for monitoring and debugging.\n */\nexport interface CacheStats {\n  /** Total number of cache hits */\n  hits: number;\n  /** Total number of cache misses */\n  misses: number;\n  /** Total number of set operations */\n  sets: number;\n  /** Total number of delete operations */\n  deletes: number;\n  /** Number of entries currently in cache */\n  size: number;\n  /** Cache hit ratio (hits / (hits + misses)) */\n  hitRatio?: number;\n}\n\n/**\n * Configuration for cache strategies.\n */\nexport interface CacheConfig extends Configurable, Enabled {\n  /** Default TTL in seconds */\n  ttl: number;\n  /** Cache strategy to use */\n  strategy: CacheStrategyType;\n  /** Redis-specific configuration */\n  redisConfig?: RedisCacheConfig;\n  /** Memory cache specific configuration */\n  memoryConfig?: MemoryCacheConfig;\n}\n\n/**\n * Configuration for memory cache strategy.\n */\nexport interface MemoryCacheConfig {\n  /** Maximum number of entries to store (default: 1000) */\n  maxSize?: number;\n  /** Maximum number of entries to store (alias for maxSize) */\n  maxEntries?: number;\n  /** Check for expired entries every N milliseconds (default: 60000) */\n  cleanupInterval?: number;\n  /** Callback when entry is evicted */\n  onEvict?: (key: string, entry: CacheEntry) => void;\n}\n\n/**\n * Configuration for Redis cache strategy.\n */\nexport interface RedisCacheConfig extends WithUrl {\n  /** Redis password for authentication */\n  password?: string;\n  /** Redis database number */\n  db?: number;\n  /** Key prefix for Redis keys */\n  keyPrefix?: string;\n  /** Connection timeout in milliseconds */\n  connectTimeout?: number;\n  /** Command timeout in milliseconds */\n  commandTimeout?: number;\n}\n\n/**\n * Cache manager statistics interface.\n */\nexport type CacheManagerStats = CacheStats;\n\n/**\n * Interface that all cache strategies must implement.\n */\nexport interface CacheStrategy {\n  /**\n   * Stores a cache entry.\n   *\n   * @param key - Cache key\n   * @param entry - Cache entry to store\n   * @returns Promise that resolves when entry is stored\n   */\n  set<T>(key: string, entry: CacheEntry<T>): Promise<void>;\n\n  /**\n   * Retrieves a cache entry.\n   *\n   * @param key - Cache key\n   * @returns Promise that resolves to cache entry or null if not found\n   */\n  get<T>(key: string): Promise<CacheEntry<T> | null>;\n\n  /**\n   * Removes a cache entry.\n   *\n   * @param key - Cache key to remove\n   * @returns Promise that resolves when entry is removed\n   */\n  delete(key: string): Promise<void>;\n\n  /**\n   * Clears all cache entries.\n   *\n   * @returns Promise that resolves when cache is cleared\n   */\n  clear(): Promise<void>;\n\n  /**\n   * Gets cache statistics.\n   *\n   * @returns Promise that resolves to cache statistics\n   */\n  getStats(): Promise<CacheStats>;\n\n  /**\n   * Disposes of the cache strategy and cleans up resources.\n   * Optional method for cleanup.\n   *\n   * @returns Promise that resolves when cleanup is complete\n   */\n  dispose?(): Promise<void>;\n}\n"]}

package/dist/features/cache/index.d.ts

@@ -1 +1,2 @@
 export type * from './types';
+export { CACHE_STRATEGIES } from './types';

package/dist/features/cache/index.js

@@ -1,3 +1,8 @@
+// @plyaz package - Built with tsup
 
+// src/features/cache/types.ts
+var CACHE_STRATEGIES = ["memory", "redis"];
+
+export { CACHE_STRATEGIES };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/features/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../../src/features/cache/types.ts"],"names":[],"mappings":";;;AAyBO,IAAM,gBAAA,GAAmB,CAAC,QAAA,EAAU,OAAO","file":"index.js","sourcesContent":["/**\n * Cache Types and Interfaces\n *\n * Type definitions for the caching layer.\n * This will be moved to @plyaz/core when the package structure is finalized.\n *\n * @fileoverview Cache type definitions\n * @version 1.0.0\n */\n\n/**\n * Cache entry structure that wraps cached data with metadata.\n */\nimport type {\n  Configurable,\n  WithExpiration,\n  WithMetadata,\n  Enabled,\n  WithUrl,\n  Timestamped,\n} from '../../common/types';\n\n/**\n * Available cache strategies\n */\nexport const CACHE_STRATEGIES = ['memory', 'redis'] as const;\n\n/**\n * Cache strategy type\n */\nexport type CacheStrategyType = (typeof CACHE_STRATEGIES)[number];\n\nexport interface CacheEntry<T = unknown>\n  extends Partial<WithMetadata<Record<string, unknown>>>,\n    WithExpiration<number>,\n    Pick<Timestamped<number, number>, 'createdAt'> {\n  /** The cached data */\n  data: T;\n}\n\nexport interface GenericCacheEntry<T = unknown> {\n  value: T;\n  timestamp: number;\n  ttl: number;\n}\n\n/**\n * Cache statistics for monitoring and debugging.\n */\nexport interface CacheStats {\n  /** Total number of cache hits */\n  hits: number;\n  /** Total number of cache misses */\n  misses: number;\n  /** Total number of set operations */\n  sets: number;\n  /** Total number of delete operations */\n  deletes: number;\n  /** Number of entries currently in cache */\n  size: number;\n  /** Cache hit ratio (hits / (hits + misses)) */\n  hitRatio?: number;\n}\n\n/**\n * Configuration for cache strategies.\n */\nexport interface CacheConfig extends Configurable, Enabled {\n  /** Default TTL in seconds */\n  ttl: number;\n  /** Cache strategy to use */\n  strategy: CacheStrategyType;\n  /** Redis-specific configuration */\n  redisConfig?: RedisCacheConfig;\n  /** Memory cache specific configuration */\n  memoryConfig?: MemoryCacheConfig;\n}\n\n/**\n * Configuration for memory cache strategy.\n */\nexport interface MemoryCacheConfig {\n  /** Maximum number of entries to store (default: 1000) */\n  maxSize?: number;\n  /** Maximum number of entries to store (alias for maxSize) */\n  maxEntries?: number;\n  /** Check for expired entries every N milliseconds (default: 60000) */\n  cleanupInterval?: number;\n  /** Callback when entry is evicted */\n  onEvict?: (key: string, entry: CacheEntry) => void;\n}\n\n/**\n * Configuration for Redis cache strategy.\n */\nexport interface RedisCacheConfig extends WithUrl {\n  /** Redis password for authentication */\n  password?: string;\n  /** Redis database number */\n  db?: number;\n  /** Key prefix for Redis keys */\n  keyPrefix?: string;\n  /** Connection timeout in milliseconds */\n  connectTimeout?: number;\n  /** Command timeout in milliseconds */\n  commandTimeout?: number;\n}\n\n/**\n * Cache manager statistics interface.\n */\nexport type CacheManagerStats = CacheStats;\n\n/**\n * Interface that all cache strategies must implement.\n */\nexport interface CacheStrategy {\n  /**\n   * Stores a cache entry.\n   *\n   * @param key - Cache key\n   * @param entry - Cache entry to store\n   * @returns Promise that resolves when entry is stored\n   */\n  set<T>(key: string, entry: CacheEntry<T>): Promise<void>;\n\n  /**\n   * Retrieves a cache entry.\n   *\n   * @param key - Cache key\n   * @returns Promise that resolves to cache entry or null if not found\n   */\n  get<T>(key: string): Promise<CacheEntry<T> | null>;\n\n  /**\n   * Removes a cache entry.\n   *\n   * @param key - Cache key to remove\n   * @returns Promise that resolves when entry is removed\n   */\n  delete(key: string): Promise<void>;\n\n  /**\n   * Clears all cache entries.\n   *\n   * @returns Promise that resolves when cache is cleared\n   */\n  clear(): Promise<void>;\n\n  /**\n   * Gets cache statistics.\n   *\n   * @returns Promise that resolves to cache statistics\n   */\n  getStats(): Promise<CacheStats>;\n\n  /**\n   * Disposes of the cache strategy and cleans up resources.\n   * Optional method for cleanup.\n   *\n   * @returns Promise that resolves when cleanup is complete\n   */\n  dispose?(): Promise<void>;\n}\n"]}

package/dist/features/cache/types.d.ts

@@ -11,6 +11,14 @@
  * Cache entry structure that wraps cached data with metadata.
  */
 import type { Configurable, WithExpiration, WithMetadata, Enabled, WithUrl, Timestamped } from '../../common/types';
+/**
+ * Available cache strategies
+ */
+export declare const CACHE_STRATEGIES: readonly ["memory", "redis"];
+/**
+ * Cache strategy type
+ */
+export type CacheStrategyType = (typeof CACHE_STRATEGIES)[number];
 export interface CacheEntry<T = unknown> extends Partial<WithMetadata<Record<string, unknown>>>, WithExpiration<number>, Pick<Timestamped<number, number>, 'createdAt'> {
     /** The cached data */
     data: T;
@@ -44,7 +52,7 @@ export interface CacheConfig extends Configurable, Enabled {
     /** Default TTL in seconds */
     ttl: number;
     /** Cache strategy to use */
-    strategy: 'memory' | 'redis';
+    strategy: CacheStrategyType;
     /** Redis-specific configuration */
     redisConfig?: RedisCacheConfig;
     /** Memory cache specific configuration */

package/dist/features/index.cjs

@@ -1,4 +1,10 @@
 'use strict';
 
+// @plyaz package - Built with tsup
+
+// src/features/cache/types.ts
+var CACHE_STRATEGIES = ["memory", "redis"];
+
+exports.CACHE_STRATEGIES = CACHE_STRATEGIES;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/features/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../src/features/cache/types.ts"],"names":[],"mappings":";;;;;AAyBO,IAAM,gBAAA,GAAmB,CAAC,QAAA,EAAU,OAAO","file":"index.cjs","sourcesContent":["/**\n * Cache Types and Interfaces\n *\n * Type definitions for the caching layer.\n * This will be moved to @plyaz/core when the package structure is finalized.\n *\n * @fileoverview Cache type definitions\n * @version 1.0.0\n */\n\n/**\n * Cache entry structure that wraps cached data with metadata.\n */\nimport type {\n  Configurable,\n  WithExpiration,\n  WithMetadata,\n  Enabled,\n  WithUrl,\n  Timestamped,\n} from '../../common/types';\n\n/**\n * Available cache strategies\n */\nexport const CACHE_STRATEGIES = ['memory', 'redis'] as const;\n\n/**\n * Cache strategy type\n */\nexport type CacheStrategyType = (typeof CACHE_STRATEGIES)[number];\n\nexport interface CacheEntry<T = unknown>\n  extends Partial<WithMetadata<Record<string, unknown>>>,\n    WithExpiration<number>,\n    Pick<Timestamped<number, number>, 'createdAt'> {\n  /** The cached data */\n  data: T;\n}\n\nexport interface GenericCacheEntry<T = unknown> {\n  value: T;\n  timestamp: number;\n  ttl: number;\n}\n\n/**\n * Cache statistics for monitoring and debugging.\n */\nexport interface CacheStats {\n  /** Total number of cache hits */\n  hits: number;\n  /** Total number of cache misses */\n  misses: number;\n  /** Total number of set operations */\n  sets: number;\n  /** Total number of delete operations */\n  deletes: number;\n  /** Number of entries currently in cache */\n  size: number;\n  /** Cache hit ratio (hits / (hits + misses)) */\n  hitRatio?: number;\n}\n\n/**\n * Configuration for cache strategies.\n */\nexport interface CacheConfig extends Configurable, Enabled {\n  /** Default TTL in seconds */\n  ttl: number;\n  /** Cache strategy to use */\n  strategy: CacheStrategyType;\n  /** Redis-specific configuration */\n  redisConfig?: RedisCacheConfig;\n  /** Memory cache specific configuration */\n  memoryConfig?: MemoryCacheConfig;\n}\n\n/**\n * Configuration for memory cache strategy.\n */\nexport interface MemoryCacheConfig {\n  /** Maximum number of entries to store (default: 1000) */\n  maxSize?: number;\n  /** Maximum number of entries to store (alias for maxSize) */\n  maxEntries?: number;\n  /** Check for expired entries every N milliseconds (default: 60000) */\n  cleanupInterval?: number;\n  /** Callback when entry is evicted */\n  onEvict?: (key: string, entry: CacheEntry) => void;\n}\n\n/**\n * Configuration for Redis cache strategy.\n */\nexport interface RedisCacheConfig extends WithUrl {\n  /** Redis password for authentication */\n  password?: string;\n  /** Redis database number */\n  db?: number;\n  /** Key prefix for Redis keys */\n  keyPrefix?: string;\n  /** Connection timeout in milliseconds */\n  connectTimeout?: number;\n  /** Command timeout in milliseconds */\n  commandTimeout?: number;\n}\n\n/**\n * Cache manager statistics interface.\n */\nexport type CacheManagerStats = CacheStats;\n\n/**\n * Interface that all cache strategies must implement.\n */\nexport interface CacheStrategy {\n  /**\n   * Stores a cache entry.\n   *\n   * @param key - Cache key\n   * @param entry - Cache entry to store\n   * @returns Promise that resolves when entry is stored\n   */\n  set<T>(key: string, entry: CacheEntry<T>): Promise<void>;\n\n  /**\n   * Retrieves a cache entry.\n   *\n   * @param key - Cache key\n   * @returns Promise that resolves to cache entry or null if not found\n   */\n  get<T>(key: string): Promise<CacheEntry<T> | null>;\n\n  /**\n   * Removes a cache entry.\n   *\n   * @param key - Cache key to remove\n   * @returns Promise that resolves when entry is removed\n   */\n  delete(key: string): Promise<void>;\n\n  /**\n   * Clears all cache entries.\n   *\n   * @returns Promise that resolves when cache is cleared\n   */\n  clear(): Promise<void>;\n\n  /**\n   * Gets cache statistics.\n   *\n   * @returns Promise that resolves to cache statistics\n   */\n  getStats(): Promise<CacheStats>;\n\n  /**\n   * Disposes of the cache strategy and cleans up resources.\n   * Optional method for cleanup.\n   *\n   * @returns Promise that resolves when cleanup is complete\n   */\n  dispose?(): Promise<void>;\n}\n"]}

package/dist/features/index.d.ts

@@ -1,3 +1,4 @@
 export type * from './cache';
+export { CACHE_STRATEGIES } from './cache';
 export type * from './feature-flag';
 export type * from './community';

package/dist/features/index.js

@@ -1,3 +1,8 @@
+// @plyaz package - Built with tsup
 
+// src/features/cache/types.ts
+var CACHE_STRATEGIES = ["memory", "redis"];
+
+export { CACHE_STRATEGIES };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/features/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/features/cache/types.ts"],"names":[],"mappings":";;;AAyBO,IAAM,gBAAA,GAAmB,CAAC,QAAA,EAAU,OAAO","file":"index.js","sourcesContent":["/**\n * Cache Types and Interfaces\n *\n * Type definitions for the caching layer.\n * This will be moved to @plyaz/core when the package structure is finalized.\n *\n * @fileoverview Cache type definitions\n * @version 1.0.0\n */\n\n/**\n * Cache entry structure that wraps cached data with metadata.\n */\nimport type {\n  Configurable,\n  WithExpiration,\n  WithMetadata,\n  Enabled,\n  WithUrl,\n  Timestamped,\n} from '../../common/types';\n\n/**\n * Available cache strategies\n */\nexport const CACHE_STRATEGIES = ['memory', 'redis'] as const;\n\n/**\n * Cache strategy type\n */\nexport type CacheStrategyType = (typeof CACHE_STRATEGIES)[number];\n\nexport interface CacheEntry<T = unknown>\n  extends Partial<WithMetadata<Record<string, unknown>>>,\n    WithExpiration<number>,\n    Pick<Timestamped<number, number>, 'createdAt'> {\n  /** The cached data */\n  data: T;\n}\n\nexport interface GenericCacheEntry<T = unknown> {\n  value: T;\n  timestamp: number;\n  ttl: number;\n}\n\n/**\n * Cache statistics for monitoring and debugging.\n */\nexport interface CacheStats {\n  /** Total number of cache hits */\n  hits: number;\n  /** Total number of cache misses */\n  misses: number;\n  /** Total number of set operations */\n  sets: number;\n  /** Total number of delete operations */\n  deletes: number;\n  /** Number of entries currently in cache */\n  size: number;\n  /** Cache hit ratio (hits / (hits + misses)) */\n  hitRatio?: number;\n}\n\n/**\n * Configuration for cache strategies.\n */\nexport interface CacheConfig extends Configurable, Enabled {\n  /** Default TTL in seconds */\n  ttl: number;\n  /** Cache strategy to use */\n  strategy: CacheStrategyType;\n  /** Redis-specific configuration */\n  redisConfig?: RedisCacheConfig;\n  /** Memory cache specific configuration */\n  memoryConfig?: MemoryCacheConfig;\n}\n\n/**\n * Configuration for memory cache strategy.\n */\nexport interface MemoryCacheConfig {\n  /** Maximum number of entries to store (default: 1000) */\n  maxSize?: number;\n  /** Maximum number of entries to store (alias for maxSize) */\n  maxEntries?: number;\n  /** Check for expired entries every N milliseconds (default: 60000) */\n  cleanupInterval?: number;\n  /** Callback when entry is evicted */\n  onEvict?: (key: string, entry: CacheEntry) => void;\n}\n\n/**\n * Configuration for Redis cache strategy.\n */\nexport interface RedisCacheConfig extends WithUrl {\n  /** Redis password for authentication */\n  password?: string;\n  /** Redis database number */\n  db?: number;\n  /** Key prefix for Redis keys */\n  keyPrefix?: string;\n  /** Connection timeout in milliseconds */\n  connectTimeout?: number;\n  /** Command timeout in milliseconds */\n  commandTimeout?: number;\n}\n\n/**\n * Cache manager statistics interface.\n */\nexport type CacheManagerStats = CacheStats;\n\n/**\n * Interface that all cache strategies must implement.\n */\nexport interface CacheStrategy {\n  /**\n   * Stores a cache entry.\n   *\n   * @param key - Cache key\n   * @param entry - Cache entry to store\n   * @returns Promise that resolves when entry is stored\n   */\n  set<T>(key: string, entry: CacheEntry<T>): Promise<void>;\n\n  /**\n   * Retrieves a cache entry.\n   *\n   * @param key - Cache key\n   * @returns Promise that resolves to cache entry or null if not found\n   */\n  get<T>(key: string): Promise<CacheEntry<T> | null>;\n\n  /**\n   * Removes a cache entry.\n   *\n   * @param key - Cache key to remove\n   * @returns Promise that resolves when entry is removed\n   */\n  delete(key: string): Promise<void>;\n\n  /**\n   * Clears all cache entries.\n   *\n   * @returns Promise that resolves when cache is cleared\n   */\n  clear(): Promise<void>;\n\n  /**\n   * Gets cache statistics.\n   *\n   * @returns Promise that resolves to cache statistics\n   */\n  getStats(): Promise<CacheStats>;\n\n  /**\n   * Disposes of the cache strategy and cleans up resources.\n   * Optional method for cleanup.\n   *\n   * @returns Promise that resolves when cleanup is complete\n   */\n  dispose?(): Promise<void>;\n}\n"]}

package/dist/index.cjs

@@ -345,6 +345,17 @@ var CORE_EVENTS = {
   }
 };
 
+// src/core/services/keys.ts
+var SERVICE_KEYS = {
+  /** Example domain service (backend) */
+  EXAMPLE: "example",
+  /** Example domain service (frontend) */
+  EXAMPLE_FRONTEND: "example-frontend",
+  /** Feature flags service */
+  FEATURE_FLAGS: "featureFlags"
+};
+var ALL_SERVICE_KEYS = Object.values(SERVICE_KEYS);
+
 // src/errors/enums.ts
 var ERROR_TYPE = {
   /** A general validation error (e.g., form or input errors). */
@@ -1833,7 +1844,19 @@ var CORE_ERROR_CODES = {
   INITIALIZATION_FAILED: ERROR_CODES.CORE_INITIALIZATION_FAILED,
   CONFIGURATION_INVALID: ERROR_CODES.CORE_CONFIGURATION_INVALID,
   OPERATION_FAILED: ERROR_CODES.CORE_OPERATION_FAILED,
-  UNKNOWN_ERROR: ERROR_CODES.CORE_UNKNOWN_ERROR
+  UNKNOWN_ERROR: ERROR_CODES.CORE_UNKNOWN_ERROR,
+  // Common/Generic Errors (used across core package)
+  CLIENT_INITIALIZATION_FAILED: ERROR_CODES.CLIENT_INITIALIZATION_FAILED,
+  CLIENT_INVALID_CONFIG: ERROR_CODES.CLIENT_INVALID_CONFIG,
+  CONTEXT_OPERATION_FAILED: ERROR_CODES.CONTEXT_OPERATION_FAILED,
+  FEATURE_NOT_SUPPORTED: ERROR_CODES.FEATURE_NOT_SUPPORTED,
+  VALIDATION_ERROR: ERROR_CODES.VALIDATION_ERROR,
+  NETWORK_ERROR: ERROR_CODES.NETWORK_ERROR,
+  RESOURCE_NOT_FOUND: ERROR_CODES.RESOURCE_NOT_FOUND,
+  DB_CONNECTION_FAILED: ERROR_CODES.DB_CONNECTION_FAILED,
+  DB_DUPLICATE_ENTRY: ERROR_CODES.DB_DUPLICATE_ENTRY,
+  PROVIDER_NOT_IMPLEMENTED: ERROR_CODES.PROVIDER_NOT_IMPLEMENTED,
+  STORAGE_FILE_WRITE_FAILED: ERROR_CODES.STORAGE_FILE_WRITE_FAILED
 };
 var PAYMENT_ERROR_CODES = {
   // Timeout & Network
@@ -6289,6 +6312,9 @@ var CHAIN_ID = {
   BaseSepolia: 84532
 };
 
+// src/features/cache/types.ts
+var CACHE_STRATEGIES = ["memory", "redis"];
+
 // src/user/enums.ts
 var COUNTRIES = {
   unitedKingdom: "unitedKingdom",
@@ -8504,6 +8530,7 @@ exports.ALERT_SEVERITY = ALERT_SEVERITY;
 exports.ALERT_SOURCE = ALERT_SOURCE;
 exports.ALERT_TYPES = ALERT_TYPES;
 exports.ALL_EVENTS = ALL_EVENTS;
+exports.ALL_SERVICE_KEYS = ALL_SERVICE_KEYS;
 exports.API_ERROR_CODES = API_ERROR_CODES;
 exports.APP_CONTEXTS = APP_CONTEXTS;
 exports.ATHLETE_PROFILE_ERRORS = ATHLETE_PROFILE_ERRORS;
@@ -8518,6 +8545,7 @@ exports.BUCKET_PURPOSE = BUCKET_PURPOSE;
 exports.BUSINESS_MODEL = BUSINESS_MODEL;
 exports.CACHE_DURATION_MS = CACHE_DURATION_MS;
 exports.CACHE_EVENTS = CACHE_EVENTS;
+exports.CACHE_STRATEGIES = CACHE_STRATEGIES;
 exports.CHAIN_ID = CHAIN_ID;
 exports.CHANGE_TYPES = CHANGE_TYPES;
 exports.CLIENT_EVENTS = CLIENT_EVENTS;
@@ -8668,6 +8696,7 @@ exports.ROUTER_RULE_NAME = ROUTER_RULE_NAME;
 exports.ROUTING_STRATEGY = ROUTING_STRATEGY;
 exports.RTT_THRESHOLDS = RTT_THRESHOLDS;
 exports.SECURITY_THREAT_TYPE = SECURITY_THREAT_TYPE;
+exports.SERVICE_KEYS = SERVICE_KEYS;
 exports.SIGNATURE_METHOD = SIGNATURE_METHOD;
 exports.SORT_DIRECTION = SORT_DIRECTION;
 exports.SPEED_THRESHOLDS = SPEED_THRESHOLDS;