@plyaz/types 1.22.2 → 1.22.4

package/dist/core/init/types.d.ts

@@ -7,10 +7,11 @@
 import type { ApiClientOptions } from '../../api';
 import type { StoreKey } from '../../store';
 import type { FeatureFlagValue, FeatureFlagPollingConfig, CacheStrategyType } from '../../features';
-import type { PackageErrorLike } from '../../errors';
+import type { PackageErrorLike, MessageCatalog } from '../../errors';
 import type { GlobalErrorHandlerConfig, ErrorHandlerLogger } from '../../errors/middleware';
-import type { CoreAppEnvironment, CoreAppContext, CoreRuntimeEnvironment } from '../modules';
+import type { CoreAppEnvironment, CoreAppContext, CoreRuntimeEnvironment, CoreServiceRuntime } from '../modules';
 import type { CoreDbServiceConfig } from '../services';
+import type { CoreInjectedServices } from '../domain';
 /**
  * Base interface that all domain service instances must implement.
  * This allows the registry to manage services generically.
@@ -184,11 +185,57 @@ export interface CoreServiceInitConfig {
      * ```
      */
     dedicatedCache?: boolean | CoreCacheConfig;
+    /**
+     * Service-level cache configuration.
+     * Controls caching behavior for this specific service's operations.
+     *
+     * @example
+     * ```typescript
+     * {
+     *   service: ExampleService,
+     *   config: {
+     *     cache: {
+     *       enabled: true,
+     *       defaultTtl: 300, // 5 minutes
+     *     },
+     *   },
+     * }
+     * ```
+     */
+    cache?: {
+        /** Enable cache for this service (default: true) */
+        enabled?: boolean;
+        /** Default TTL in seconds for cached operations */
+        defaultTtl?: number;
+    };
 }
 /**
  * Options passed to the service factory method
  */
-export interface CoreServiceCreateOptions {
+export interface CoreServiceCreateOptions<TConfig = unknown, TMapper = unknown, TValidator = unknown> {
+    /**
+     * The service-specific configuration object.
+     * Optional when passed from ServiceRegistry (services build their own).
+     */
+    serviceConfig?: TConfig;
+    /**
+     * Mapper class to use for DTO transformations.
+     */
+    MapperClass?: new () => TMapper;
+    /**
+     * Validator class to use for validation.
+     */
+    ValidatorClass?: new () => TValidator;
+    /**
+     * Service name for logging and identification.
+     * Optional when passed from ServiceRegistry (services provide their own).
+     */
+    serviceName?: string;
+    /**
+     * Supported runtime environments.
+     * Optional when passed from ServiceRegistry (services provide their own).
+     */
+    supportedRuntimes?: readonly CoreServiceRuntime[];
     /**
      * API client configuration and mode.
      */
@@ -261,6 +308,11 @@ export interface CoreServiceCreateOptions {
      * Passed from the service config to the create method.
      */
     storeKeys?: StoreKey[];
+    /**
+     * Injected service instances (cache, db, api).
+     * Services built by ServiceRegistry will receive these automatically.
+     */
+    injected?: CoreInjectedServices;
 }
 /**
  * Static interface that service classes must implement.
@@ -393,6 +445,35 @@ export interface CoreErrorHandlerInitConfig extends Omit<GlobalErrorHandlerConfi
      * Set to false to disable logging.
      */
     logger?: ErrorHandlerLogger | boolean;
+    /**
+     * Localization configuration for error messages.
+     * Configure how error messages are translated and which locales are available.
+     *
+     * @example
+     * ```typescript
+     * import type { MessageCatalog } from '@plyaz/types/errors';
+     *
+     * errorHandler: {
+     *   localization: {
+     *     defaultLocale: 'es',
+     *     fallbackLocale: 'en',
+     *     additionalCatalogs: {
+     *       es: { errors: { custom_error: 'Error personalizado' } }
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    localization?: {
+        /** Default locale to use for error messages (default: 'en') */
+        defaultLocale?: string;
+        /** Fallback locale if translation not found (default: 'en') */
+        fallbackLocale?: string;
+        /** Additional message catalogs to merge with built-in messages */
+        additionalCatalogs?: Record<string, MessageCatalog>;
+        /** Replace built-in catalogs entirely (default: false) */
+        replaceBuiltIn?: boolean;
+    };
 }
 /**
  * Cache initialization configuration

package/dist/core/modules.d.ts

@@ -311,7 +311,7 @@ export interface CoreApiInitOptions {
 /**
  * Core initialization options
  */
-export interface CoreInitOptions<TDbConfig = unknown, TApiConfig = CoreApiInitOptions> {
+export interface CoreInitOptions<TDbConfig = unknown, TApiConfig = CoreApiInitOptions, TCacheConfig = unknown> {
     /** Path to .env file */
     envPath?: string;
     /** Global application environment */
@@ -324,19 +324,24 @@ export interface CoreInitOptions<TDbConfig = unknown, TApiConfig = CoreApiInitOp
     db?: TDbConfig;
     /** API client configuration */
     api?: TApiConfig;
+    /** Cache configuration */
+    cache?: TCacheConfig;
     /** Skip database initialization */
     skipDb?: boolean;
     /** Skip API client initialization */
     skipApi?: boolean;
+    /** Skip cache initialization */
+    skipCache?: boolean;
     /** Enable verbose logging */
     verbose?: boolean;
 }
 /**
  * Core initialization result
  */
-export interface CoreServicesResult<TDb = unknown, TApi = unknown> {
+export interface CoreServicesResult<TDb = unknown, TApi = unknown, TCache = unknown> {
     db: TDb | null;
     api: TApi | null;
+    cache: TCache | null;
     env: CoreEnvVars;
     runtime: CoreRuntimeEnvironment;
     appContext: CoreAppContext;