@plyaz/core 1.2.0 → 1.3.0

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,166 @@
+/**
+ * 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 using fluent QueryBuilder
+     *
+     * @example
+     * ```typescript
+     * const result = await repo.findByStatus('active');
+     * ```
+     */
+    findByStatus(status: string): Promise<DatabaseResult<PaginatedResult<ExampleDatabaseRow>>>;
+    /**
+     * Find entities by owner using fluent QueryBuilder
+     *
+     * @example
+     * ```typescript
+     * const result = await repo.findByOwner('user-001');
+     * ```
+     */
+    findByOwner(ownerId: string): Promise<DatabaseResult<PaginatedResult<ExampleDatabaseRow>>>;
+    /**
+     * Find visible entities only using fluent QueryBuilder
+     *
+     * @example
+     * ```typescript
+     * const result = await repo.findVisible();
+     * ```
+     */
+    findVisible(): Promise<DatabaseResult<PaginatedResult<ExampleDatabaseRow>>>;
+    /**
+     * Find active and visible entities using complex QueryBuilder
+     *
+     * @example
+     * ```typescript
+     * const items = await repo.findActiveAndVisible();
+     * ```
+     */
+    findActiveAndVisible(): Promise<ExampleDatabaseRow[]>;
+    /**
+     * Find entities by owner with status filter using QueryBuilder
+     *
+     * @example
+     * ```typescript
+     * const items = await repo.findByOwnerWithStatus('user-001', 'active');
+     * ```
+     */
+    findByOwnerWithStatus(ownerId: string, status: string): Promise<ExampleDatabaseRow[]>;
+    /**
+     * Count entities by status using QueryBuilder
+     *
+     * @example
+     * ```typescript
+     * const count = await repo.countByStatus('active');
+     * ```
+     */
+    countByStatus(status: string): Promise<number>;
+    /**
+     * 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/models/featureFlags/FeatureFlagRepository.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Database Repository Implementation
+ *
+ * Database adapter integration with @plyaz/db for feature flag storage.
+ * Extends BaseRepository for consistent CRUD operations and QueryBuilder support.
+ *
+ * @fileoverview Database repository for feature flags
+ */
+import { BaseRepository } from '@plyaz/db';
+import { type FeatureFlag, type FeatureFlagRule, type FeatureFlagValue, type CreateFlagRequest, type FeatureFlagContext } from '@plyaz/types';
+import type { FeatureFlagKey } from '@domain/types';
+import { type CoreDatabaseFeatureFlagRow, type CoreFeatureFlagTableConfig } from '@plyaz/types/core';
+import type { DatabaseServiceInterface } from '@plyaz/types/db';
+/**
+ * Extended row type with index signature for BaseRepository compatibility
+ */
+type FeatureFlagRow = CoreDatabaseFeatureFlagRow & Record<string, unknown>;
+/**
+ * Database Repository for Feature Flags
+ *
+ * Extends BaseRepository for consistent CRUD operations and QueryBuilder support.
+ * Manages feature flags, rules, evaluations, and overrides across multiple tables.
+ *
+ * @template TKey - Feature flag key type (extends string)
+ *
+ * @example
+ * ```typescript
+ * // Create repository
+ * const repository = FeatureFlagDatabaseRepository.create();
+ *
+ * // Use QueryBuilder for complex queries
+ * const enabledFlags = await repository.query()
+ *   .where('is_enabled', 'eq', true)
+ *   .orderByAsc('key')
+ *   .getMany();
+ *
+ * // Get all flags with environment filter
+ * const prodFlags = await repository.getAllFlags('production');
+ * ```
+ */
+export declare class FeatureFlagDatabaseRepository<TKey extends string = FeatureFlagKey> extends BaseRepository<FeatureFlagRow> {
+    private readonly tableConfig;
+    private readonly logger;
+    /**
+     * Creates a new repository with optional custom table names.
+     *
+     * @param db - Database service interface
+     * @param tableConfig - Optional custom table configuration
+     */
+    constructor(db: DatabaseServiceInterface, tableConfig?: Partial<CoreFeatureFlagTableConfig>);
+    /**
+     * Factory method to create repository instance.
+     * Uses DbService singleton if initialized.
+     */
+    static create<TKey extends string = FeatureFlagKey>(tableConfig?: Partial<CoreFeatureFlagTableConfig>): FeatureFlagDatabaseRepository<TKey>;
+    /**
+     * Gets the current table configuration.
+     */
+    getTableConfig(): CoreFeatureFlagTableConfig;
+    /**
+     * Gets the full table name including schema if needed.
+     */
+    private getEvaluationsTableName;
+    /**
+     * Retrieves all feature flags with optional environment filtering.
+     * Uses QueryBuilder fluent API for the query.
+     *
+     * @param environment - Optional environment filter
+     * @returns Array of feature flags
+     */
+    getAllFlags(environment?: string): Promise<FeatureFlag<TKey>[]>;
+    /**
+     * Retrieves a specific feature flag by its key.
+     * Uses findById with 'key' as the ID column.
+     *
+     * @param key - The feature flag key
+     * @returns The feature flag or null
+     */
+    getFlag(key: TKey): Promise<FeatureFlag<TKey> | null>;
+    /**
+     * Find flags by enabled status using QueryBuilder.
+     *
+     * @param isEnabled - Filter by enabled status
+     * @returns Array of matching flags
+     */
+    findByEnabled(isEnabled: boolean): Promise<FeatureFlag<TKey>[]>;
+    /**
+     * Count flags by enabled status using QueryBuilder.
+     */
+    countByEnabled(isEnabled: boolean): Promise<number>;
+    /**
+     * Creates a new feature flag.
+     *
+     * @param data - Flag creation data
+     * @returns The created flag
+     */
+    createFlag(data: CreateFlagRequest<TKey>): Promise<FeatureFlag<TKey>>;
+    /**
+     * Updates an existing feature flag.
+     *
+     * @param key - Flag key to update
+     * @param data - Partial update data
+     * @returns The updated flag
+     */
+    updateFlag(key: TKey, data: Partial<CreateFlagRequest<TKey>>): Promise<FeatureFlag<TKey>>;
+    /**
+     * Deletes a feature flag.
+     *
+     * @param key - Flag key to delete
+     */
+    deleteFlag(key: TKey): Promise<void>;
+    /**
+     * Retrieves rules for a specific flag using direct db query.
+     * Rules are in a separate table, so we use the underlying db service.
+     *
+     * @param key - Flag key to get rules for
+     * @returns Array of rules
+     */
+    getFlagRules(key: TKey): Promise<FeatureFlagRule<TKey>[]>;
+    /**
+     * Retrieves all enabled rules across all flags.
+     *
+     * @returns Array of all enabled rules
+     */
+    getAllRules(): Promise<FeatureFlagRule<TKey>[]>;
+    /**
+     * Logs a feature flag evaluation for audit purposes.
+     */
+    logEvaluation(params: {
+        flagKey: TKey;
+        userId?: string;
+        context?: FeatureFlagContext;
+        result: FeatureFlagValue;
+    }): Promise<void>;
+    /**
+     * Sets a user-specific override for a feature flag.
+     */
+    setOverride(flagKey: TKey, userId: string, value: FeatureFlagValue, expiresAt?: Date): Promise<void>;
+    /**
+     * Retrieves a user-specific override for a feature flag.
+     */
+    getOverride(flagKey: TKey, userId: string): Promise<FeatureFlagValue | null>;
+    /**
+     * Removes user-specific overrides for a feature flag.
+     */
+    removeOverride(flagKey: TKey, userId: string): Promise<void>;
+    /**
+     * Infers the type of a value for the type field.
+     */
+    private toTypeField;
+    /**
+     * Maps a database row to a FeatureFlag object.
+     */
+    private mapToFeatureFlag;
+    /**
+     * Maps a database row to a FeatureFlagRule object.
+     */
+    private mapToFeatureFlagRule;
+}
+export {};
+//# 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"}