@plyaz/types 1.19.4 → 1.19.5

package/dist/core/modules.d.ts

@@ -6,6 +6,7 @@
  */
 import type { DatabaseServiceInterface } from '../db/databaseService';
 import type { HttpMethod } from '../api/config/types';
+import type { Type, DynamicModule, ForwardReference, InjectionToken, OptionalFactoryDependency, ModuleMetadata } from '@nestjs/common';
 export type { HttpMethod };
 /**
  * Core services available to modules
@@ -352,14 +353,29 @@ export interface CoreNestJsModuleOptions {
     isGlobal?: boolean;
 }
 /**
- * Async options for NestJS CoreModule
+ * Async options for NestJS CoreModule (adapters/nestjs.ts pattern)
+ * Uses NestJS-specific types for proper DI integration.
  */
 export interface CoreNestJsModuleAsyncOptions {
-    imports?: unknown[];
-    inject?: unknown[];
+    /** Modules to import for dependency resolution */
+    imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
+    /** Tokens to inject into the factory */
+    inject?: Array<InjectionToken | OptionalFactoryDependency>;
+    /** Factory function to create module options */
     useFactory: (...args: unknown[]) => CoreNestJsModuleOptions | Promise<CoreNestJsModuleOptions>;
+    /** Whether to make Core services globally available */
     isGlobal?: boolean;
 }
+/**
+ * Async options for NestJS CoreModule (init/nestjs pattern)
+ * Extends ModuleMetadata for full NestJS integration.
+ */
+export interface CoreNestJsCoreModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    /** Factory function to create init options */
+    useFactory: (...args: unknown[]) => CoreInitOptions | Promise<CoreInitOptions>;
+    /** Tokens to inject into the factory */
+    inject?: Array<Type<unknown> | string | symbol>;
+}
 /**
  * Application context type
  *

package/dist/core/services/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Core Services Types
+ * Type definitions for @plyaz/core services
+ */
+export type * from './types';

package/dist/core/{services.d.ts → services/types.d.ts}

@@ -1,9 +1,12 @@
 /**
- * Service Layer Types for @plyaz/core
- * Types specific to core package services
+ * Core Services Types
+ * Type definitions for @plyaz/core services
  */
+import type { DrizzleConfig, SupabaseConfig, SqlConfig, SoftDeleteConfig, DBCacheConfig, AuditConfig, DBEncryptionConfig } from '../../db';
 import type { ReactNode } from 'react';
-import type { ApiClientOptions } from '../api/client';
+import type { ApiClientOptions } from '../../api/client';
+/**
+
 /**
  * Environment configuration for API client initialization
  *
@@ -77,7 +80,7 @@ import type { ApiClientOptions } from '../api/client';
  * @see ServiceOptions from @plyaz/types/api - For per-request configuration overrides
  * @since 1.1.0
  */
-export interface ApiEnvironmentConfig {
+export interface CoreApiEnvironmentConfig {
     /**
      * Environment name - determines which default configuration to apply
      *
@@ -333,7 +336,7 @@ export interface ApiEnvironmentConfig {
  * @see {@link ApiClientOptions} from @plyaz/types/api - Full API configuration options
  * @since 1.1.0
  */
-export interface ApiProviderProps {
+export interface CoreApiProviderProps {
     /**
      * React children to render after successful initialization
      *
@@ -349,7 +352,7 @@ export interface ApiProviderProps {
      *
      * @see {@link ApiEnvironmentConfig} - Full configuration options
      */
-    envConfig: ApiEnvironmentConfig;
+    envConfig: CoreApiEnvironmentConfig;
     /**
      * API configuration
      *
@@ -444,3 +447,68 @@ export interface ApiProviderProps {
      */
     onError?: (error: Error) => void;
 }
+/**
+ * Configuration options for DbService initialization
+ *
+ * Uses types from @plyaz/types/db for consistency across packages.
+ */
+export interface CoreDbServiceConfig {
+    /**
+     * Database adapter type
+     * - 'drizzle': Direct PostgreSQL connection (recommended for performance)
+     * - 'supabase': Supabase REST API (RLS enforced)
+     * - 'sql': Raw SQL adapter
+     * @default 'drizzle'
+     */
+    adapter?: 'drizzle' | 'supabase' | 'sql';
+    /** Drizzle adapter configuration (required when adapter='drizzle') */
+    drizzle?: DrizzleConfig;
+    /** Supabase adapter configuration (required when adapter='supabase') */
+    supabase?: SupabaseConfig;
+    /** SQL adapter configuration (required when adapter='sql') */
+    sql?: SqlConfig;
+    /**
+     * Additional named adapters for multi-database support
+     * Allows using different adapters for specific queries or repositories
+     * @example
+     * ```typescript
+     * adapters: {
+     *   analytics: {
+     *     adapter: 'sql',
+     *     sql: { connectionString: process.env.ANALYTICS_DB_URL }
+     *   },
+     *   cache: {
+     *     adapter: 'drizzle',
+     *     drizzle: { connectionString: process.env.CACHE_DB_URL }
+     *   }
+     * }
+     * // Usage:
+     * await db.query('SELECT * FROM events', { adapter: 'analytics' });
+     * ```
+     */
+    adapters?: Record<string, {
+        adapter: 'drizzle' | 'supabase' | 'sql';
+        drizzle?: DrizzleConfig;
+        supabase?: SupabaseConfig;
+        sql?: SqlConfig;
+    }>;
+    /** Soft delete extension configuration */
+    softDelete?: SoftDeleteConfig;
+    /** Cache extension configuration */
+    cache?: DBCacheConfig;
+    /** Audit extension configuration */
+    audit?: AuditConfig;
+    /**
+     * Encryption extension configuration
+     * Requires ENCRYPTION_KEY env var or explicit key in config (32 bytes for AES-256)
+     * @example
+     * ```typescript
+     * encryption: {
+     *   enabled: true,
+     *   key: process.env.ENCRYPTION_KEY!,
+     *   fields: DEFAULT_ENCRYPTION_FIELDS
+     * }
+     * ```
+     */
+    encryption?: DBEncryptionConfig;
+}

package/dist/errors/codes.d.ts

@@ -295,6 +295,9 @@ export declare const ERROR_CODES: {
     readonly ERROR_SYSTEM_NOT_INITIALIZED: "error.system.not.initialized";
     readonly EVENT_FACTORY_NOT_REGISTERED: "error.event.factory.not.registered";
     readonly DATABASE_ERROR: "error.database";
+    readonly UNCAUGHT_EXCEPTION: "error.uncaught.exception";
+    readonly UNHANDLED_REJECTION: "error.unhandled.rejection";
+    readonly RUNTIME_ERROR: "error.runtime";
     readonly DB_ACCESS_DENIED: "db.access_denied";
     readonly DB_CONFIG_REQUIRED: "db.config_required";
     readonly DB_CONNECT_FAILED: "db.connect_failed";

package/dist/errors/index.cjs

@@ -733,6 +733,10 @@ var ERROR_CODES = {
   ERROR_SYSTEM_NOT_INITIALIZED: "error.system.not.initialized",
   EVENT_FACTORY_NOT_REGISTERED: "error.event.factory.not.registered",
   DATABASE_ERROR: "error.database",
+  // Global Error Handler
+  UNCAUGHT_EXCEPTION: "error.uncaught.exception",
+  UNHANDLED_REJECTION: "error.unhandled.rejection",
+  RUNTIME_ERROR: "error.runtime",
   // ===== Database Errors =====
   // Connection & Configuration
   DB_ACCESS_DENIED: "db.access_denied",
@@ -3873,6 +3877,31 @@ var ERROR_DEFINITIONS = {
     retryable: false,
     userMessage: "errors.database"
   },
+  // Global Error Handler
+  [ERROR_CODES.UNCAUGHT_EXCEPTION]: {
+    code: ERROR_CODES.UNCAUGHT_EXCEPTION,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.System,
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false,
+    userMessage: "errors.uncaught.exception"
+  },
+  [ERROR_CODES.UNHANDLED_REJECTION]: {
+    code: ERROR_CODES.UNHANDLED_REJECTION,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.System,
+    severity: ERROR_SEVERITY.Critical,
+    retryable: false,
+    userMessage: "errors.unhandled.rejection"
+  },
+  [ERROR_CODES.RUNTIME_ERROR]: {
+    code: ERROR_CODES.RUNTIME_ERROR,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.System,
+    severity: ERROR_SEVERITY.High,
+    retryable: false,
+    userMessage: "errors.runtime"
+  },
   // ===== Database Error Definitions =====
   // Connection & Configuration
   [ERROR_CODES.DB_ACCESS_DENIED]: {