@plyaz/core 1.2.0 → 1.2.1

package/dist/init/react.d.ts

@@ -0,0 +1,33 @@
+/**
+ * React Integration for ServiceRegistry
+ *
+ * For full React integration, use PlyazProvider directly.
+ *
+ * @example
+ * ```tsx
+ * import { PlyazProvider, useService } from '@plyaz/core/frontend';
+ *
+ * function App() {
+ *   return (
+ *     <PlyazProvider
+ *       config={{
+ *         api: { baseURL: '/api' },
+ *         services: [
+ *           { service: FeatureFlagDomainService, config: { enabled: true } },
+ *           { service: ExampleDomainService, config: { enabled: true } },
+ *         ],
+ *       }}
+ *     >
+ *       <MyApp />
+ *     </PlyazProvider>
+ *   );
+ * }
+ *
+ * function MyComponent() {
+ *   const flagService = useService<FeatureFlagDomainService>('featureFlags');
+ *   // ...
+ * }
+ * ```
+ */
+export { PlyazProvider, usePlyaz, useApi, useApiSafe, useEvents, useFlag, useFeatureFlags, usePlyazReady, useAppContext, useEnvironment, useService, useServiceAsync, useHasService, useServiceKeys, PlyazContext, } from '../frontend/providers/PlyazProvider';
+//# sourceMappingURL=react.d.ts.map

package/dist/init/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/init/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EACL,aAAa,EACb,QAAQ,EACR,MAAM,EACN,UAAU,EACV,SAAS,EACT,OAAO,EACP,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,qCAAqC,CAAC"}

package/dist/models/example/ExampleRepository.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Example Repository
+ *
+ * Data access layer for Example entities.
+ * Extends BaseRepository from @plyaz/db for consistent CRUD operations.
+ * Falls back to in-memory dummy data when DbService is not initialized.
+ *
+ * @example
+ * ```typescript
+ * // With DbService initialized
+ * const db = DbService.getInstance().getDatabase();
+ * const repository = new ExampleRepository(db);
+ *
+ * // Get all entities
+ * const result = await repository.findMany();
+ * if (result.success) {
+ *   console.log('Entities:', result.value.data);
+ * }
+ *
+ * // Get by ID
+ * const entity = await repository.findById('123');
+ * ```
+ */
+import { BaseRepository } from '@plyaz/db';
+import type { DatabaseResult, PaginatedResult, QueryOptions, DatabaseServiceInterface, OperationConfig } from '@plyaz/types/db';
+/**
+ * Database row type for Example entity (snake_case for DB)
+ */
+export interface ExampleDatabaseRow {
+    id: string;
+    name: string;
+    description: string | null;
+    amount: number;
+    owner_id: string;
+    status: string;
+    is_visible: boolean;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string | null;
+    [key: string]: unknown;
+}
+/**
+ * Create input for Example entity
+ */
+export type ExampleCreateInput = Omit<ExampleDatabaseRow, 'id' | 'created_at' | 'updated_at' | 'deleted_at'>;
+/**
+ * Update input for Example entity
+ */
+export type ExampleUpdateInput = Partial<Omit<ExampleDatabaseRow, 'id' | 'created_at'>>;
+/**
+ * Example Repository
+ *
+ * Extends BaseRepository for consistent data access patterns.
+ * When DbService is not initialized, falls back to in-memory dummy data.
+ *
+ * @example
+ * ```typescript
+ * // Create repository (auto-detects DbService availability)
+ * const repo = ExampleRepository.create();
+ *
+ * // Or with explicit database service
+ * const db = DbService.getInstance().getDatabase();
+ * const repo = new ExampleRepository(db);
+ *
+ * // Use CRUD operations
+ * const result = await repo.findById('example-001');
+ * ```
+ */
+export declare class ExampleRepository extends BaseRepository<ExampleDatabaseRow> {
+    private readonly useDummyData;
+    private dummyStore;
+    constructor(db: DatabaseServiceInterface, useDummyData?: boolean);
+    /**
+     * Create repository instance.
+     * Uses DbService if initialized, otherwise creates a dummy-data repository.
+     */
+    static create(): ExampleRepository;
+    /**
+     * Find entity by ID
+     */
+    findById(id: string, config?: OperationConfig): Promise<DatabaseResult<ExampleDatabaseRow | null>>;
+    /**
+     * Find multiple entities
+     */
+    findMany(options?: QueryOptions<ExampleDatabaseRow>, config?: OperationConfig): Promise<DatabaseResult<PaginatedResult<ExampleDatabaseRow>>>;
+    /**
+     * Create new entity
+     */
+    create(data: Partial<ExampleDatabaseRow>, config?: OperationConfig): Promise<DatabaseResult<ExampleDatabaseRow>>;
+    /**
+     * Update entity
+     */
+    update(id: string, data: Partial<ExampleDatabaseRow>, config?: OperationConfig): Promise<DatabaseResult<ExampleDatabaseRow>>;
+    /**
+     * Soft delete entity
+     */
+    softDelete(id: string, config?: OperationConfig): Promise<DatabaseResult<void>>;
+    /**
+     * Hard delete entity
+     */
+    delete(id: string, config?: OperationConfig): Promise<DatabaseResult<void>>;
+    /**
+     * Find entities by status
+     */
+    findByStatus(status: string): Promise<DatabaseResult<PaginatedResult<ExampleDatabaseRow>>>;
+    /**
+     * Find entities by owner
+     */
+    findByOwner(ownerId: string): Promise<DatabaseResult<PaginatedResult<ExampleDatabaseRow>>>;
+    /**
+     * Find visible entities only
+     */
+    findVisible(): Promise<DatabaseResult<PaginatedResult<ExampleDatabaseRow>>>;
+    /**
+     * Check if entity exists by ID
+     */
+    exists(id: string, config?: OperationConfig): Promise<DatabaseResult<boolean>>;
+    /**
+     * Get the table name for this repository
+     * Used for transaction operations
+     */
+    getTableName(): string;
+}
+//# sourceMappingURL=ExampleRepository.d.ts.map

package/dist/models/example/ExampleRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExampleRepository.d.ts","sourceRoot":"","sources":["../../../src/models/example/ExampleRepository.ts"],"names":[],"mappings":"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"}

package/dist/models/example/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Example Models/Repositories
+ *
+ * Data access layer for Example entities.
+ */
+export { ExampleRepository, type ExampleDatabaseRow, type ExampleCreateInput, type ExampleUpdateInput, } from './ExampleRepository';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/example/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/example/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC"}

package/dist/{backend/featureFlags/database/repository.d.ts → models/featureFlags/FeatureFlagRepository.d.ts}

@@ -8,6 +8,7 @@
  */
 import { type FeatureFlag, type FeatureFlagRule, type FeatureFlagValue, type CreateFlagRequest, type FeatureFlagContext } from '@plyaz/types';
 import type { FeatureFlagKey } from '@domain/types';
+import { type CoreFeatureFlagTableConfig } from '@plyaz/types/core';
 /**
  * Database Repository for Feature Flags
  *
@@ -15,10 +16,10 @@ import type { FeatureFlagKey } from '@domain/types';
  *
  * **EXECUTION ORDER:**
  * 1. FeatureFlagService.onModuleInit()
- * 2. → FeatureFlagConfigFactory.fromEnvironment()
- * 3. → DatabaseConnectionManager.initialize()
+ * 2. → FeatureFlagConfigFactory.fromOptions()
+ * 3. → DbService.initialize()
  * 4. → **THIS REPOSITORY USED** ← YOU ARE HERE
- * 5. → Database queries executed via Drizzle ORM
+ * 5. → Database queries executed via @plyaz/db
  *
  * **PURPOSE:**
  * - Executes optimized SQL queries using Drizzle ORM
@@ -61,7 +62,42 @@ import type { FeatureFlagKey } from '@domain/types';
  * ```
  */
 export declare class FeatureFlagDatabaseRepository<TKey extends string = FeatureFlagKey> {
-    private connectionManager;
+    private readonly tableConfig;
+    /**
+     * Creates a new repository with optional custom table names.
+     *
+     * @param tableConfig - Optional custom table configuration
+     *
+     * @example Default tables
+     * ```typescript
+     * const repo = new FeatureFlagDatabaseRepository();
+     * // Uses: feature_flags, feature_flag_rules, feature_flag_evaluations, feature_flag_overrides
+     * ```
+     *
+     * @example Custom test tables
+     * ```typescript
+     * const repo = new FeatureFlagDatabaseRepository({
+     *   flagsTable: 'test_feature_flags',
+     *   rulesTable: 'test_feature_flag_rules',
+     *   evaluationsTable: 'test_feature_flag_evaluations',
+     *   overridesTable: 'test_feature_flag_overrides',
+     *   evaluationsSchema: 'audit',
+     * });
+     * ```
+     */
+    constructor(tableConfig?: Partial<CoreFeatureFlagTableConfig>);
+    /**
+     * Gets the current table configuration.
+     */
+    getTableConfig(): CoreFeatureFlagTableConfig;
+    /**
+     * Gets the full table name including schema if needed.
+     */
+    private getEvaluationsTableName;
+    /**
+     * Gets the database service from DbService singleton
+     */
+    private getDb;
     /**
      * Retrieves all feature flags from the database with optional environment filtering
      *
@@ -209,6 +245,12 @@ export declare class FeatureFlagDatabaseRepository<TKey extends string = Feature
      *
      */
     updateFlag(key: TKey, data: Partial<CreateFlagRequest<TKey>>): Promise<FeatureFlag<TKey>>;
+    /**
+     * Infers the type of a given value as a string for the type field
+     * @param value Unknown value
+     * @returns Inferred type as string
+     */
+    private toTypeField;
     /**
      * Deletes a feature flag from the database
      *
@@ -515,4 +557,4 @@ export declare class FeatureFlagDatabaseRepository<TKey extends string = Feature
      */
     private mapToFeatureFlagRule;
 }
-//# sourceMappingURL=repository.d.ts.map
+//# sourceMappingURL=FeatureFlagRepository.d.ts.map

package/dist/models/featureFlags/FeatureFlagRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFlagRepository.d.ts","sourceRoot":"","sources":["../../../src/models/featureFlags/FeatureFlagRepository.ts"],"names":[],"mappings":"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"}

package/dist/models/featureFlags/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Feature Flags Models/Repositories
+ *
+ * Data access layer for feature flags.
+ */
+export { FeatureFlagDatabaseRepository } from './FeatureFlagRepository';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/featureFlags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/featureFlags/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/models/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Models/Repositories
+ *
+ * Centralized data access layer organized by domain.
+ * Repositories use DbService when initialized, fall back to dummy data otherwise.
+ */
+export * from './example';
+export * from './featureFlags';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/dist/services/ApiClientService.d.ts

@@ -9,7 +9,7 @@
  */
 import type { ApiClientWithEvents, ApiClientOptions } from '@plyaz/types/api';
 import { type ClientEventManager, type EndpointsList } from '@plyaz/api';
-import type { ApiEnvironmentConfig } from '@plyaz/types/core';
+import type { CoreApiEnvironmentConfig } from '@plyaz/types/core';
 /**
  * API Client Singleton Service
  * Manages API client instance lifecycle with environment-specific configurations
@@ -55,7 +55,7 @@ export declare class ApiClientService {
      * @param apiConfig - API configuration (baseURL, encryption, timeout, event handlers, etc.)
      * @returns Promise that resolves to the initialized client
      */
-    static init(envConfig: ApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>): Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
+    static init(envConfig: CoreApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>): Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
     /**
      * Internal initialization logic
      * Merges environment-specific defaults with API configuration
@@ -79,12 +79,100 @@ export declare class ApiClientService {
     /**
      * Reinitialize with new config and options
      */
-    static reinitialize(envConfig: ApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>): Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
+    static reinitialize(envConfig: CoreApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>): Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
     /**
      * Dispose of the client instance
      */
     static dispose(): void;
+    /**
+     * Emits an API error event via CoreEventManager.
+     * Called when API operations fail to integrate with global error handling.
+     *
+     * **CRITICAL**: This event emission triggers automatic error state updates.
+     * The global error store MUST subscribe to CORE_EVENTS.API.REQUEST_ERROR to:
+     * 1. Capture all API errors automatically
+     * 2. Update global error state for UI display
+     * 3. Ensure individual domain stores remain error-free (only domain data)
+     *
+     * This is the unified error hook that:
+     * - On frontend: Emits event that global error store subscribes to
+     * - On backend: Emits event for logging/monitoring (can be configured to rethrow)
+     *
+     * @param error - The error that occurred
+     * @param options - Additional context for the error
+     * @param options.method - HTTP method (GET, POST, etc.)
+     * @param options.url - Request URL
+     * @param options.requestId - Unique request identifier
+     * @param options.status - HTTP status code (if available)
+     * @param options.duration - Request duration in ms
+     * @param options.rethrow - Whether to rethrow the error after emitting (default: false)
+     *
+     * @example
+     * ```typescript
+     * // Global error store setup (in @plyaz/store)
+     * CoreEventManager.on(CORE_EVENTS.API.REQUEST_ERROR, (payload) => {
+     *   errorStore.setError({
+     *     message: payload.error.message,
+     *     status: payload.status,
+     *     url: payload.url,
+     *     requestId: payload.requestId,
+     *   });
+     * });
+     *
+     * // Frontend usage - emit to store
+     * ApiClientService.emitApiError(error, {
+     *   method: 'GET',
+     *   url: '/api/users',
+     *   requestId: '123',
+     *   duration: 500,
+     * });
+     *
+     * // Backend usage - emit and rethrow
+     * ApiClientService.emitApiError(error, {
+     *   method: 'POST',
+     *   url: '/api/orders',
+     *   requestId: '456',
+     *   duration: 1200,
+     *   rethrow: true,
+     * });
+     * ```
+     */
+    static emitApiError(error: unknown, options: {
+        method: string;
+        url: string;
+        requestId: string;
+        status?: number;
+        duration: number;
+        rethrow?: boolean;
+    }): void;
+    /**
+     * Create a dedicated API client instance (NOT the singleton)
+     *
+     * Use this when you need an isolated client with its own configuration
+     * that doesn't affect or get affected by the shared singleton instance.
+     *
+     * @param envConfig - Environment metadata (env, apiKey)
+     * @param apiConfig - API configuration (baseURL, encryption, timeout, etc.)
+     * @returns Promise that resolves to a new dedicated client instance
+     *
+     * @example
+     * ```typescript
+     * // Create a dedicated client for feature flags service
+     * const flagsClient = await ApiClientService.createInstance(
+     *   { env: 'production' },
+     *   {
+     *     baseURL: 'https://flags.example.com',
+     *     timeout: 5000,
+     *   }
+     * );
+     *
+     * // This client is independent from ApiClientService.getClient()
+     * flagsClient.updateConfig({ timeout: 3000 }); // Only affects this instance
+     * ```
+     */
+    static createInstance(envConfig: CoreApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>): Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
 }
 export declare const getApiClient: () => ApiClientWithEvents<ClientEventManager, EndpointsList>;
-export declare const initApiClient: (envConfig: ApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>) => Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
+export declare const initApiClient: (envConfig: CoreApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>) => Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
+export declare const createApiClientInstance: (envConfig: CoreApiEnvironmentConfig, apiConfig?: Partial<ApiClientOptions>) => Promise<ApiClientWithEvents<ClientEventManager, EndpointsList>>;
 //# sourceMappingURL=ApiClientService.d.ts.map

package/dist/services/ApiClientService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiClientService.d.ts","sourceRoot":"","sources":["../../src/services/ApiClientService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAa,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAmB,MAAM,YAAY,CAAC;AAG1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AA2c9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuE;IAC9F,OAAO,CAAC,MAAM,CAAC,cAAc,CAAS;IACtC,OAAO,CAAC,MAAM,CAAC,WAAW,CAA8B;IAExD;;;;;;OAMG;WACU,IAAI,CACf,SAAS,EAAE,oBAAoB,EAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IA4BlE;;;;;;;;OAQG;mBACkB,YAAY;IA6CjC;;;;OAIG;IACH,MAAM,CAAC,SAAS,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC;IAmB1E;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO;IAI/B;;OAEG;WACU,YAAY,CACvB,SAAS,EAAE,oBAAoB,EAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAKlE;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,IAAI;CAQvB;AAGD,eAAO,MAAM,YAAY,QAAO,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CACvD,CAAC;AAE/B,eAAO,MAAM,aAAa,GACxB,WAAW,oBAAoB,EAC/B,YAAY,OAAO,CAAC,gBAAgB,CAAC,KACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CACpB,CAAC"}
+{"version":3,"file":"ApiClientService.d.ts","sourceRoot":"","sources":["../../src/services/ApiClientService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAa,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAmB,MAAM,YAAY,CAAC;AAW1F,OAAO,KAAK,EAA8B,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AA+c9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuE;IAC9F,OAAO,CAAC,MAAM,CAAC,cAAc,CAAS;IACtC,OAAO,CAAC,MAAM,CAAC,WAAW,CAA8B;IAExD;;;;;;OAMG;WACU,IAAI,CACf,SAAS,EAAE,wBAAwB,EACnC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IA4BlE;;;;;;;;OAQG;mBAEkB,YAAY;IAuIjC;;;;OAIG;IACH,MAAM,CAAC,SAAS,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC;IAmB1E;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO;IAI/B;;OAEG;WACU,YAAY,CACvB,SAAS,EAAE,wBAAwB,EACnC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAKlE;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,IAAI;IAStB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GACA,IAAI;IAkBP;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACU,cAAc,CACzB,SAAS,EAAE,wBAAwB,EACnC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;CA2CnE;AAGD,eAAO,MAAM,YAAY,QAAO,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CACvD,CAAC;AAE/B,eAAO,MAAM,aAAa,GACxB,WAAW,wBAAwB,EACnC,YAAY,OAAO,CAAC,gBAAgB,CAAC,KACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CACpB,CAAC;AAE9C,eAAO,MAAM,uBAAuB,GAClC,WAAW,wBAAwB,EACnC,YAAY,OAAO,CAAC,gBAAgB,CAAC,KACpC,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,CAAC,CACV,CAAC"}

package/dist/services/CacheService.d.ts

@@ -0,0 +1,176 @@
+/**
+ * CacheService - Singleton Cache Manager
+ *
+ * @description Manages cache instance for the entire application using a singleton pattern.
+ * This service wraps the CacheManager from @plyaz/core/base/cache and provides a centralized
+ * way to initialize and access caching across all backend services.
+ *
+ * **Architecture:**
+ * - Supports multiple strategies: Memory (in-process), Redis (distributed)
+ * - Configurable TTL, key prefixing, and strategy-specific options
+ * - Singleton pattern ensures single cache instance across application
+ *
+ * **Strategy Configuration:**
+ * - **Memory**: In-process LRU cache, no external dependencies
+ * - **Redis**: Distributed cache using ioredis, requires Redis server
+ *
+ * **Required Environment Variables (Redis):**
+ * - REDIS_URL: Redis connection string (e.g., redis://localhost:6379)
+ * - Or REDIS_HOST, REDIS_PORT, REDIS_PASSWORD for individual config
+ *
+ * @example Using with Core.initialize() (Recommended)
+ * ```typescript
+ * import { Core } from '@plyaz/core';
+ *
+ * await Core.initialize({
+ *   envPath: '.env',
+ *   cache: {
+ *     strategy: 'memory',
+ *     isEnabled: true,
+ *     ttl: 300, // 5 minutes default
+ *   },
+ * });
+ *
+ * // Access via Core.cache
+ * const cache = Core.cache.getCacheManager();
+ * await cache.set('user:123', userData, 600); // 10 minutes TTL
+ * const cached = await cache.get('user:123');
+ * ```
+ *
+ * @example With Redis Strategy
+ * ```typescript
+ * await Core.initialize({
+ *   envPath: '.env',
+ *   cache: {
+ *     strategy: 'redis',
+ *     isEnabled: true,
+ *     ttl: 300,
+ *     prefix: 'myapp',
+ *     redis: {
+ *       url: process.env.REDIS_URL,
+ *       // Or individual options:
+ *       // host: process.env.REDIS_HOST,
+ *       // port: parseInt(process.env.REDIS_PORT),
+ *       // password: process.env.REDIS_PASSWORD,
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * @example Direct Usage
+ * ```typescript
+ * import { CacheService } from '@plyaz/core/services';
+ *
+ * await CacheService.initialize({
+ *   strategy: 'memory',
+ *   isEnabled: true,
+ *   ttl: 300,
+ * });
+ *
+ * const cache = CacheService.getInstance().getCacheManager();
+ * await cache.set('key', value);
+ * ```
+ *
+ * @example Skip Cache (Disable Caching)
+ * ```typescript
+ * await Core.initialize({
+ *   skipCache: true, // Cache will not be initialized
+ * });
+ * ```
+ *
+ * @fileoverview Cache service singleton
+ * @module services/CacheService
+ */
+import { CacheManager } from '../base/cache';
+import type { CoreCacheConfig } from '@plyaz/types/core';
+/**
+ * Singleton service for managing application-wide cache
+ *
+ * Provides centralized access to cache functionality across all backend services.
+ * Automatically integrates with BaseBackendDomainService when initialized.
+ */
+export declare class CacheService {
+    /** Singleton instance */
+    private static instance;
+    /** Cache manager instance */
+    private cacheManager;
+    /** Configuration used to initialize cache */
+    private config;
+    /** Logger instance */
+    private logger;
+    /** Private constructor to enforce singleton */
+    private constructor();
+    /**
+     * Initialize the cache service with configuration
+     *
+     * @param config - Cache configuration
+     * @throws {CorePackageError} If already initialized or config is invalid
+     *
+     * @example
+     * ```typescript
+     * await CacheService.initialize({
+     *   strategy: 'redis',
+     *   isEnabled: true,
+     *   ttl: 300,
+     *   prefix: 'app',
+     *   redis: { url: process.env.REDIS_URL },
+     * });
+     * ```
+     */
+    static initialize(config: CoreCacheConfig): Promise<void>;
+    /**
+     * Get the singleton instance
+     *
+     * @throws {CorePackageError} If not initialized
+     * @returns CacheService singleton instance
+     *
+     * @example
+     * ```typescript
+     * const cacheService = CacheService.getInstance();
+     * const cache = cacheService.getCacheManager();
+     * ```
+     */
+    static getInstance(): CacheService;
+    /**
+     * Get the cache manager instance
+     *
+     * @throws {CorePackageError} If cache not initialized
+     * @returns CacheManager instance
+     *
+     * @example
+     * ```typescript
+     * const cache = CacheService.getInstance().getCacheManager();
+     * await cache.set('user:123', userData);
+     * const user = await cache.get('user:123');
+     * ```
+     */
+    getCacheManager(): CacheManager;
+    /**
+     * Get current cache configuration
+     *
+     * @returns Current cache configuration or null if not initialized
+     */
+    getConfig(): CoreCacheConfig | null;
+    /**
+     * Check if cache is initialized and enabled
+     *
+     * @returns True if cache is ready to use
+     */
+    isInitialized(): boolean;
+    /**
+     * Reset the cache service (useful for testing)
+     *
+     * @internal
+     */
+    static reset(): void;
+    /**
+     * Validate cache configuration
+     *
+     * @param config - Configuration to validate
+     * @throws {CorePackageError} If configuration is invalid
+     * @private
+     */
+    private validateConfig;
+}
+export declare const getCacheService: () => CacheService;
+//# sourceMappingURL=CacheService.d.ts.map

package/dist/services/CacheService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheService.d.ts","sourceRoot":"","sources":["../../src/services/CacheService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,yBAAyB;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IAEpD,6BAA6B;IAC7B,OAAO,CAAC,YAAY,CAA6B;IAEjD,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAgC;IAE9C,sBAAsB;IACtB,OAAO,CAAC,MAAM,CAA+C;IAE7D,+CAA+C;IAC/C,OAAO;IAEP;;;;;;;;;;;;;;;;OAgBG;WACU,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C/D;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,WAAW,IAAI,YAAY;IAUlC;;;;;;;;;;;;OAYG;IACH,eAAe,IAAI,YAAY;IAU/B;;;;OAIG;IACH,SAAS,IAAI,eAAe,GAAG,IAAI;IAInC;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;OAIG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAWpB;;;;;;OAMG;IAEH,OAAO,CAAC,cAAc;CA6BvB;AAGD,eAAO,MAAM,eAAe,QAAO,YAA0C,CAAC"}