@aifabrix/miso-client 1.9.2 → 2.1.0

package/README.md

@@ -10,18 +10,21 @@ The **AI Fabrix Miso Client SDK** provides authentication, authorization, and lo
 ### 🔐 Enterprise Security
 
 **SSO and Federated Identity**
+
 - Single Sign-On (SSO) with Keycloak
 - OAuth 2.0 and OpenID Connect (OIDC) support
 - Multi-factor authentication (MFA) ready
 - Social login integration (Google, Microsoft, etc.)
 
 **Centralized Access Control**
+
 - Role-based access control (RBAC)
 - Fine-grained permissions
 - Dynamic policy enforcement
 - Attribute-based access control (ABAC)
 
 **API Security**
+
 - JWT token validation
 - API key authentication
 - Token revocation support
@@ -31,24 +34,28 @@ The **AI Fabrix Miso Client SDK** provides authentication, authorization, and lo
 ### 📊 Compliance & Audit
 
 **ISO 27001 Compliance**
+
 - Comprehensive audit trails for all user actions
 - Data access logging and monitoring
 - Security event tracking
 - Accountability and non-repudiation
 
 **Regulatory Compliance**
+
 - GDPR-ready data protection
 - HIPAA-compliant audit logging
 - SOC 2 audit trail requirements
 - Industry-standard security controls
 
 **Audit Capabilities**
+
 - Real-time audit event logging
 - Immutable audit records
 - Forensic analysis support
 - Compliance reporting automation
 
 **HTTP Request Audit (ISO 27001 Compliant)**
+
 - Automatic audit logging for all HTTP requests
 - Sensitive data masking (passwords, tokens, PII, financial data)
 - Configurable sensitive fields via JSON configuration
@@ -59,6 +66,7 @@ The **AI Fabrix Miso Client SDK** provides authentication, authorization, and lo
 ### ⚡ Performance & Scalability
 
 **Intelligent Caching**
+
 - Redis-based role and permission caching
 - Generic cache service with Redis and in-memory fallback
 - Configurable cache TTL (default: 15 minutes)
@@ -66,12 +74,14 @@ The **AI Fabrix Miso Client SDK** provides authentication, authorization, and lo
 - Fallback to controller when Redis unavailable
 
 **High Availability**
+
 - Automatic failover to controller
 - Redundant infrastructure support
 - Load balancing compatible
 - Zero-downtime deployments
 
 **Optimized Network**
+
 - Efficient API calls with caching
 - Batch operations support
 - Connection pooling
@@ -80,18 +90,21 @@ The **AI Fabrix Miso Client SDK** provides authentication, authorization, and lo
 ### 🛠️ Developer Experience
 
 **Easy Integration**
+
 - Progressive activation (6-step setup)
 - Works with any framework (Express, Next.js, NestJS, Fastify)
 - TypeScript-first with full type definitions
 - Browser and Node.js support
 
 **Flexible Configuration**
+
 - Environment-based configuration
 - Support for dev, test, and production environments
 - Docker and Kubernetes ready
 - CI/CD friendly
 
 **Observability**
+
 - Centralized logging with correlation IDs
 - Performance tracking and metrics
 - Error tracking and debugging
@@ -166,7 +179,7 @@ aifabrix run miso-controller
 
 ---
 
-## 📚 Documentation
+## 🔍 How It Works
 
 **What happens:** Your app validates user tokens from Keycloak.
 
@@ -345,6 +358,7 @@ MISO_SENSITIVE_FIELDS_CONFIG=/path/to/sensitive-fields.config.json
 
 **Built-in Performance Optimizations:**
 The SDK automatically optimizes audit logging performance:
+
 - Automatic response body truncation for large payloads
 - Optimized masking operations with intelligent size-based processing
 - Batch logging to minimize network overhead
@@ -366,12 +380,14 @@ const client = new MisoClient({
 ```
 
 **What gets audited:**
+
 - All HTTP requests to the controller
 - Request/response metadata (method, URL, status, duration, size)
 - User context (extracted from JWT tokens)
 - Sensitive data is automatically masked (passwords, tokens, PII, credit cards, etc.)
 
 **ISO 27001 Compliance:**
+
 - Automatic sensitive data masking before logging
 - Configurable sensitive field patterns
 - Audit trail for all API communications
@@ -483,7 +499,211 @@ const response = createPaginatedListResponse(
 
 ---
 
-### Step 9: Multi-Authentication Strategy
+### Step 9: Express.js Utilities
+
+**What happens:** Use Express-specific utilities for building REST APIs with standardized responses, error handling, and validation.
+
+#### Installation
+
+For Express.js applications, the SDK includes optional Express utilities:
+
+```bash
+npm install @aifabrix/miso-client express
+```
+
+#### Quick Start
+
+```typescript
+import express from 'express';
+import { 
+  injectResponseHelpers,
+  asyncHandler,
+  ValidationHelper,
+  setErrorLogger,
+  EncryptionUtil
+} from '@aifabrix/miso-client';
+
+const app = express();
+
+// Inject response helpers
+app.use(injectResponseHelpers);
+
+// Configure error logger (optional)
+setErrorLogger({
+  async logError(message, options) {
+    console.error(message, options);
+  }
+});
+
+// Use asyncHandler for automatic error handling
+app.get('/users/:id', asyncHandler(async (req, res) => {
+  const user = await ValidationHelper.findOrFail(
+    () => db.user.findById(req.params.id),
+    'User',
+    req.params.id
+  );
+  res.success(user, 'User retrieved');
+}));
+```
+
+#### Response Helpers
+
+Standardized API response formatting:
+
+```typescript
+import { ResponseHelper } from '@aifabrix/miso-client';
+
+// Success response (200)
+return ResponseHelper.success(res, data, 'Success message');
+
+// Created response (201)
+return ResponseHelper.created(res, newResource, 'Resource created');
+
+// Paginated response
+return ResponseHelper.paginated(res, items, {
+  currentPage: 1,
+  pageSize: 20,
+  totalItems: 100,
+  type: 'user'
+});
+
+// No content (204)
+return ResponseHelper.noContent(res);
+
+// Accepted (202)
+return ResponseHelper.accepted(res, { jobId: '123' }, 'Job queued');
+
+// Or use injected methods on res object
+res.success(user);
+res.created(newPost);
+res.paginated(users, meta);
+res.noContent();
+res.accepted(data);
+```
+
+#### Async Handler
+
+Eliminates try-catch blocks in route handlers:
+
+```typescript
+import { asyncHandler } from '@aifabrix/miso-client';
+
+// Automatic error handling
+router.post('/users', asyncHandler(async (req, res) => {
+  const user = await userService.create(req.body);
+  res.created(user, 'User created');
+}));
+
+// Named variant for better error messages
+router.get('/users/:id', asyncHandlerNamed('getUser', async (req, res) => {
+  const user = await userService.findById(req.params.id);
+  res.success(user);
+}));
+```
+
+#### Validation Helper
+
+Common validation patterns:
+
+```typescript
+import { ValidationHelper } from '@aifabrix/miso-client';
+
+// Find or throw 404
+const user = await ValidationHelper.findOrFail(
+  () => prisma.user.findUnique({ where: { id } }),
+  'User',
+  id
+);
+
+// Ensure doesn't exist or throw 409
+await ValidationHelper.ensureNotExists(
+  () => prisma.user.findUnique({ where: { email } }),
+  'User',
+  email
+);
+
+// Check ownership or admin role
+ValidationHelper.ensureOwnershipOrAdmin(req, resourceUserId);
+
+// Validate required fields
+ValidationHelper.validateRequiredFields(data, ['name', 'email'], 'User');
+
+// Validate string length
+ValidationHelper.validateStringLength(password, 'password', 8, 128);
+```
+
+#### Error Handling
+
+RFC 7807 compliant error responses with optional custom logger:
+
+```typescript
+import { setErrorLogger } from '@aifabrix/miso-client';
+
+// Configure during app initialization
+setErrorLogger({
+  async logError(message, options) {
+    await yourLogger.error(message, options);
+  }
+});
+
+// Errors are automatically handled by asyncHandler
+// AppError is automatically converted to RFC 7807 format
+```
+
+#### Encryption
+
+AES-256-GCM encryption for sensitive data:
+
+```typescript
+import { EncryptionUtil } from '@aifabrix/miso-client';
+
+// Initialize once at startup (uses ENCRYPTION_KEY env var)
+EncryptionUtil.initialize();
+
+// Encrypt sensitive data
+const encrypted = EncryptionUtil.encrypt('sensitive-data');
+
+// Decrypt
+const decrypted = EncryptionUtil.decrypt(encrypted);
+
+// Generate new key (for setup)
+const key = EncryptionUtil.generateKey();
+console.log('ENCRYPTION_KEY=' + key);
+```
+
+#### Sort Utilities
+
+Parse and apply sorting for API queries:
+
+```typescript
+import { parseSortParams, applySorting } from '@aifabrix/miso-client';
+
+// Parse sort query parameters
+const sortOptions = parseSortParams({ sort: ['-createdAt', 'name'] });
+// Returns: [{ field: 'createdAt', order: 'desc' }, { field: 'name', order: 'asc' }]
+
+// Apply sorting to in-memory data (client-side)
+const sortedData = applySorting(users, sortOptions);
+
+// Or parse from Express request query
+app.get('/users', (req, res) => {
+  const sortOptions = parseSortParams(req.query);
+  // Use sortOptions to build database query with Prisma/SQL
+  const users = await prisma.user.findMany({
+    orderBy: sortOptions.map(s => ({ [s.field]: s.order }))
+  });
+  res.success(users);
+});
+```
+
+**Note:** For large datasets, always sort at the database level. Use `applySorting()` only for small in-memory datasets or client-side sorting.
+
+→ [Complete Express examples](examples/)  
+→ [API Reference](docs/api-reference.md#express-utilities)
+
+---
+
+### Step 10: Multi-Authentication Strategy
 
 **What happens:** Configure flexible authentication methods with priority-based fallback for advanced authentication scenarios.
 
@@ -516,6 +736,7 @@ const defaultStrategy = client.getDefaultAuthStrategy(token);
 ```
 
 **Supported Authentication Methods:**
+
 - `bearer` - Bearer token authentication (Authorization: Bearer <token>)
 - `client-token` - Client token authentication (x-client-token header)
 - `client-credentials` - Client credentials authentication (X-Client-Id and X-Client-Secret headers)
@@ -524,6 +745,7 @@ const defaultStrategy = client.getDefaultAuthStrategy(token);
 **Priority-Based Fallback:** Methods are tried in the order specified in the strategy array until one succeeds.
 
 **Environment Variable Configuration:**
+
 ```bash
 MISO_AUTH_STRATEGY=bearer,client-token,api-key
 MISO_BEARER_TOKEN=optional-bearer-token
@@ -599,16 +821,19 @@ The SDK consists of five core services:
 **First time setup?** Use the AI Fabrix Builder:
 
 1. **Create your app:**
+
    ```bash
    aifabrix create myapp --port 3000 --database --language typescript
    ```
 
 2. **Login to controller:**
+
    ```bash
    aifabrix login
    ```
 
 3. **Register your application:**
+
    ```bash
    aifabrix app register myapp --environment dev
    ```
@@ -622,6 +847,7 @@ The SDK consists of five core services:
 ## 💡 Next Steps
 
 ### Learn More
+
 - [Express.js Middleware](docs/examples.md#expressjs-middleware) - Protect API routes
 - [React Authentication](docs/examples.md#react-authentication) - Frontend auth
 - [NestJS Guards](docs/examples.md#nestjs-guards) - Decorator-based auth
@@ -630,6 +856,7 @@ The SDK consists of five core services:
 ### Common Tasks
 
 **Add authentication middleware:**
+
 ```typescript
 app.use(async (req, res, next) => {
   const token = client.getToken(req);
@@ -644,6 +871,7 @@ app.use(async (req, res, next) => {
 ```
 
 **Protect routes by role:**
+
 ```typescript
 app.get('/admin', async (req, res) => {
   const token = client.getToken(req);
@@ -658,6 +886,7 @@ app.get('/admin', async (req, res) => {
 ```
 
 **Use environment variables:**
+
 ```bash
 MISO_CLIENTID=ctrl-dev-my-app
 MISO_CLIENTSECRET=your-secret

package/dist/express/async-handler.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Async Handler Utility
+ * Wraps async route handlers to automatically catch and handle errors
+ *
+ * This eliminates the need for try-catch blocks in every route handler
+ * and provides consistent error handling across the application.
+ *
+ * @example
+ * ```typescript
+ * router.get('/users/:id',
+ *   asyncHandler(async (req, res) => {
+ *     const user = await userService.findById(req.params.id);
+ *     res.success(user);
+ *   })
+ * );
+ * ```
+ */
+import { Request, Response, NextFunction, RequestHandler } from "express";
+/**
+ * Wraps an async route handler to catch errors automatically
+ *
+ * @param fn - Async route handler function
+ * @param operationName - Optional operation name for error logging
+ * @returns Express RequestHandler that catches errors
+ */
+export declare function asyncHandler(fn: (req: Request, res: Response, next: NextFunction) => Promise<void>, operationName?: string): RequestHandler;
+/**
+ * Alternative syntax for named operations
+ *
+ * @example
+ * ```typescript
+ * router.get('/users/:id',
+ *   asyncHandlerNamed('getUser', async (req, res) => {
+ *     const user = await userService.findById(req.params.id);
+ *     res.success(user);
+ *   })
+ * );
+ * ```
+ */
+export declare function asyncHandlerNamed(operationName: string, fn: (req: Request, res: Response, next: NextFunction) => Promise<void>): RequestHandler;
+//# sourceMappingURL=async-handler.d.ts.map

package/dist/express/async-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-handler.d.ts","sourceRoot":"","sources":["../../src/express/async-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG1E;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,EACtE,aAAa,CAAC,EAAE,MAAM,GACrB,cAAc,CAehB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GACrE,cAAc,CAEhB"}

package/dist/express/async-handler.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Async Handler Utility
+ * Wraps async route handlers to automatically catch and handle errors
+ *
+ * This eliminates the need for try-catch blocks in every route handler
+ * and provides consistent error handling across the application.
+ *
+ * @example
+ * ```typescript
+ * router.get('/users/:id',
+ *   asyncHandler(async (req, res) => {
+ *     const user = await userService.findById(req.params.id);
+ *     res.success(user);
+ *   })
+ * );
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asyncHandler = asyncHandler;
+exports.asyncHandlerNamed = asyncHandlerNamed;
+const error_handler_1 = require("./error-handler");
+/**
+ * Wraps an async route handler to catch errors automatically
+ *
+ * @param fn - Async route handler function
+ * @param operationName - Optional operation name for error logging
+ * @returns Express RequestHandler that catches errors
+ */
+function asyncHandler(fn, operationName) {
+    return async (req, res, next) => {
+        try {
+            await fn(req, res, next);
+        }
+        catch (error) {
+            // Extract operation name from route if not provided
+            const operation = operationName || `${req.method} ${req.route?.path || req.path}`;
+            await (0, error_handler_1.handleRouteError)(error, req, res, operation);
+        }
+    };
+}
+/**
+ * Alternative syntax for named operations
+ *
+ * @example
+ * ```typescript
+ * router.get('/users/:id',
+ *   asyncHandlerNamed('getUser', async (req, res) => {
+ *     const user = await userService.findById(req.params.id);
+ *     res.success(user);
+ *   })
+ * );
+ * ```
+ */
+function asyncHandlerNamed(operationName, fn) {
+    return asyncHandler(fn, operationName);
+}
+//# sourceMappingURL=async-handler.js.map

package/dist/express/async-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-handler.js","sourceRoot":"","sources":["../../src/express/async-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAYH,oCAkBC;AAeD,8CAKC;AA/CD,mDAAmD;AAEnD;;;;;;GAMG;AACH,SAAgB,YAAY,CAC1B,EAAsE,EACtE,aAAsB;IAEtB,OAAO,KAAK,EACV,GAAY,EACZ,GAAa,EACb,IAAkB,EACH,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oDAAoD;YACpD,MAAM,SAAS,GACb,aAAa,IAAI,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YAClE,MAAM,IAAA,gCAAgB,EAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,iBAAiB,CAC/B,aAAqB,EACrB,EAAsE;IAEtE,OAAO,YAAY,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;AACzC,CAAC"}

package/dist/express/encryption.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Encryption Utility
+ * AES-256-GCM encryption for sensitive database fields
+ */
+export declare class EncryptionUtil {
+    private static algorithm;
+    private static key;
+    private static initialized;
+    /**
+     * Initialize encryption with key from environment
+     * Must be called before encrypt/decrypt operations
+     */
+    static initialize(): void;
+    /**
+     * Encrypt a string value
+     * Returns: iv:authTag:encryptedData (all in hex)
+     */
+    static encrypt(text: string): string;
+    /**
+     * Decrypt an encrypted string
+     * Expects format: iv:authTag:encryptedData (all in hex)
+     */
+    static decrypt(encryptedText: string): string;
+    /**
+     * Generate a new encryption key (for setup/documentation)
+     */
+    static generateKey(): string;
+}
+//# sourceMappingURL=encryption.d.ts.map

package/dist/express/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/express/encryption.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiB;IACzC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,WAAW,CAAS;IAEnC;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAwBzB;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA2BpC;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAuC7C;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM;CAG7B"}

package/dist/express/encryption.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Encryption Utility
+ * AES-256-GCM encryption for sensitive database fields
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EncryptionUtil = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+class EncryptionUtil {
+    /**
+     * Initialize encryption with key from environment
+     * Must be called before encrypt/decrypt operations
+     */
+    static initialize() {
+        if (this.initialized) {
+            return;
+        }
+        const encryptionKey = process.env["ENCRYPTION_KEY"];
+        if (!encryptionKey) {
+            throw new Error("ENCRYPTION_KEY environment variable not configured");
+        }
+        // Validate key length (should be 64 hex characters = 32 bytes)
+        if (encryptionKey.length !== 64) {
+            throw new Error("ENCRYPTION_KEY must be 64 hex characters (32 bytes)");
+        }
+        try {
+            this.key = Buffer.from(encryptionKey, "hex");
+        }
+        catch (error) {
+            throw new Error("ENCRYPTION_KEY must be valid hex string");
+        }
+        this.initialized = true;
+    }
+    /**
+     * Encrypt a string value
+     * Returns: iv:authTag:encryptedData (all in hex)
+     */
+    static encrypt(text) {
+        if (!this.initialized) {
+            throw new Error("EncryptionUtil not initialized. Call initialize() first.");
+        }
+        if (!text) {
+            throw new Error("Cannot encrypt empty text");
+        }
+        const iv = crypto_1.default.randomBytes(16);
+        const cipher = crypto_1.default.createCipheriv(this.algorithm, this.key, iv);
+        let encrypted = cipher.update(text, "utf8", "hex");
+        encrypted += cipher.final("hex");
+        const authTag = cipher.getAuthTag();
+        // Format: iv:authTag:encryptedData
+        return `${iv.toString("hex")}:${authTag.toString("hex")}:${encrypted}`;
+    }
+    /**
+     * Decrypt an encrypted string
+     * Expects format: iv:authTag:encryptedData (all in hex)
+     */
+    static decrypt(encryptedText) {
+        if (!this.initialized) {
+            throw new Error("EncryptionUtil not initialized. Call initialize() first.");
+        }
+        if (!encryptedText) {
+            throw new Error("Cannot decrypt empty text");
+        }
+        try {
+            const parts = encryptedText.split(":");
+            if (parts.length !== 3) {
+                throw new Error("Invalid encrypted text format");
+            }
+            const iv = Buffer.from(parts[0] || "", "hex");
+            const authTag = Buffer.from(parts[1] || "", "hex");
+            const encrypted = parts[2] || "";
+            const decipher = crypto_1.default.createDecipheriv(this.algorithm, this.key, iv);
+            decipher.setAuthTag(authTag);
+            let decrypted = decipher.update(encrypted, "hex", "utf8");
+            decrypted += decipher.final("utf8");
+            return decrypted;
+        }
+        catch (error) {
+            throw new Error(`Decryption failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Generate a new encryption key (for setup/documentation)
+     */
+    static generateKey() {
+        return crypto_1.default.randomBytes(32).toString("hex");
+    }
+}
+exports.EncryptionUtil = EncryptionUtil;
+EncryptionUtil.algorithm = "aes-256-gcm";
+EncryptionUtil.initialized = false;
+//# sourceMappingURL=encryption.js.map

package/dist/express/encryption.js.map

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

package/dist/express/error-handler.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generic Error Handler Utility
+ * Provides standardized error handling for all route handlers
+ */
+import { Request, Response } from "express";
+/**
+ * Error logger interface for dependency injection
+ * Allows applications to provide their own logger implementation
+ */
+export interface ErrorLogger {
+    logError(message: string, options: unknown): Promise<void> | void;
+}
+/**
+ * Set custom error logger for the application
+ * @param logger - Custom logger implementing ErrorLogger interface, or null to use stderr
+ */
+export declare function setErrorLogger(logger: ErrorLogger | null): void;
+/**
+ * Generic route error handler
+ * Logs error and sends RFC 7807 compliant error response
+ */
+export declare function handleRouteError(error: unknown, req: Request, res: Response, operation?: string): Promise<void>;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/express/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/express/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQ5C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnE;AAKD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAE/D;AAqGD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAsDf"}