@plyaz/types 1.21.4 → 1.22.1

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

@@ -8,7 +8,7 @@ import type { ApiClientOptions } from '../../api';
 import type { StoreKey } from '../../store';
 import type { FeatureFlagValue, FeatureFlagPollingConfig } from '../../features';
 import type { PackageErrorLike } from '../../errors';
-import type { GlobalErrorHandlerConfig } from '../../errors/middleware';
+import type { GlobalErrorHandlerConfig, ErrorHandlerLogger } from '../../errors/middleware';
 import type { CoreAppEnvironment, CoreAppContext, CoreRuntimeEnvironment } from '../modules';
 import type { CoreDbServiceConfig } from '../services';
 /**
@@ -299,6 +299,27 @@ export interface CoreErrorHandlerInitConfig extends Omit<GlobalErrorHandlerConfi
      * Set to false to use your own error handling.
      */
     enabled?: boolean;
+    /**
+     * Whether to auto-create HTTP error handler based on runtime (default: true).
+     * When enabled, Core will create the appropriate middleware for:
+     * - Express: createHttpErrorHandler
+     * - NestJS: createNestJsExceptionFilter
+     * - Next.js: withErrorHandler / createNextApiErrorHandler
+     * - Node.js: handleNodeError
+     *
+     * Access via Core.httpErrorHandler or Core.getHttpErrorHandler()
+     */
+    httpHandler?: boolean;
+    /**
+     * Include stack traces in HTTP error responses (default: false in production)
+     */
+    includeStack?: boolean;
+    /**
+     * Custom logger for error handlers.
+     * If not provided, uses default console logger.
+     * Set to false to disable logging.
+     */
+    logger?: ErrorHandlerLogger | boolean;
 }
 /**
  * Base core initialization options

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.
@@ -46,10 +65,12 @@ export interface GlobalErrorHandlerConfig {
  * Provides methods to capture errors and manage the error store.
  */
 export interface GlobalErrorHandler {
-    /** Manually capture an error */
+    /** Manually capture an error (supports single error or array of errors) */
     captureError: (error: unknown, source?: string) => void;
-    /** Manually capture an exception (alias) */
+    /** Manually capture an exception (alias for captureError) */
     captureException: (error: unknown, source?: string) => void;
+    /** Capture multiple errors at once (batch operation) */
+    captureErrors: (errors: unknown[], source?: string) => void;
     /** Get the error store */
     getStore: () => ErrorStoreActions;
     /** Cleanup and remove listeners */
@@ -86,7 +107,7 @@ export interface BackendErrorStore extends ErrorStoreActions {
 /**
  * Keys for backend error store action methods.
  */
-export type BackendErrorStoreActionKeys = 'addError' | 'removeError' | 'clearErrors' | 'clearErrorsByCategory' | 'clearErrorsBySource' | 'dismissError' | 'dismissAllErrors' | 'setConnected' | 'reset';
+export type BackendErrorStoreActionKeys = 'addError' | 'addErrors' | 'removeError' | 'clearErrors' | 'clearErrorsByCategory' | 'clearErrorsBySource' | 'dismissError' | 'dismissAllErrors' | 'setConnected' | 'reset';
 /**
  * Keys for backend error store getter methods.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.21.4",
+  "version": "1.22.1",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",