@superdangerous/app-framework 4.9.0

package/dist/core/StandardServer.js

@@ -0,0 +1,453 @@
+/**
+ * Standard Server Implementation
+ * A simplified, consistent server pattern for all SuperDangerous applications
+ * Combines the best of StartupOrchestrator with the simplicity apps need
+ */
+import express from "express";
+import { createServer } from "http";
+import cors from "cors";
+import { createWebSocketServer } from "../services/websocketServer.js";
+import { displayStartupBanner } from "../utils/startupBanner.js";
+import { getProcessOnPort } from "./portUtils.js";
+import { createLogger, getLogger } from "./index.js";
+import { aiErrorHandler } from "../middleware/aiErrorHandler.js";
+import { apiErrorHandler } from "./apiResponse.js";
+import { createRequestLoggingMiddleware } from "../middleware/requestLogging.js";
+import { getAppDataPath, getLogsPath, isDesktopApp, } from "../utils/appPaths.js";
+let logger; // Will be initialized when needed
+function ensureLogger() {
+    if (!logger) {
+        logger = createLogger("Server");
+    }
+    return logger;
+}
+/**
+ * Standard server implementation that all apps should use
+ * Handles startup, error handling, and banner display consistently
+ */
+export class StandardServer {
+    app;
+    httpServer;
+    config;
+    wsServer;
+    startTime;
+    isInitialized = false;
+    shuttingDown = false;
+    signalsBound = false;
+    connections = new Set();
+    constructor(config) {
+        const environment = process.env.NODE_ENV || "development";
+        // Default to localhost for development/test, 0.0.0.0 for production/containerized environments
+        const defaultHost = environment === "development" || environment === "test"
+            ? "localhost"
+            : "0.0.0.0";
+        // Auto-enable desktop integration if running in Electron or explicitly enabled
+        const enableDesktopIntegration = config.enableDesktopIntegration ?? isDesktopApp();
+        this.config = {
+            port: 8080,
+            host: process.env.HOST || config.host || defaultHost,
+            environment,
+            enableWebSocket: true,
+            bodyLimit: "10mb",
+            requestTimeoutMs: 120_000,
+            headersTimeoutMs: 65_000,
+            keepAliveTimeoutMs: 60_000,
+            gracefulShutdownSignals: ["SIGTERM", "SIGINT"],
+            enableRequestLogging: true,
+            enableDesktopIntegration,
+            appId: config.appId ||
+                `com.company.${config.appName.toLowerCase().replace(/[^a-z0-9]/g, "-")}`,
+            exitOnStartupError: config.exitOnStartupError ?? process.env.NODE_ENV !== "test",
+            ...config,
+        };
+        this.app = express();
+        this.httpServer = createServer(this.app);
+        this.httpServer.on("connection", (socket) => {
+            this.connections.add(socket);
+            socket.on("close", () => this.connections.delete(socket));
+        });
+        this.startTime = Date.now();
+        this.bindShutdownSignals();
+    }
+    /**
+     * Get the Express app instance for middleware setup
+     */
+    getApp() {
+        return this.app;
+    }
+    /**
+     * Get the HTTP server instance
+     */
+    getServer() {
+        return this.httpServer;
+    }
+    /**
+     * Initialize the server (setup middleware, routes, etc.)
+     */
+    async initialize() {
+        if (this.isInitialized)
+            return;
+        this.isInitialized = true;
+        try {
+            // Setup desktop-specific paths, CORS, and logging if running as desktop app
+            if (this.config.enableDesktopIntegration) {
+                await this.setupDesktopIntegration();
+            }
+            // Initialize the logger first to ensure file output works
+            const logger = getLogger;
+            if (logger &&
+                typeof logger.isInitialized === "function" &&
+                !logger.isInitialized()) {
+                // Use proper logs directory for desktop apps
+                const logsDir = this.config.enableDesktopIntegration
+                    ? getLogsPath(this.config.appId, this.config.appName)
+                    : "./data/logs";
+                await logger.initialize({
+                    appName: this.config.appName,
+                    logLevel: this.config.logging?.level || process.env.LOG_LEVEL || "info",
+                    consoleOutput: true,
+                    fileOutput: true,
+                    logsDir,
+                });
+            }
+            // Setup default middleware
+            this.setupDefaultMiddleware();
+            // Initialize WebSocket if enabled (before onInitialize so it can be passed)
+            if (this.config.enableWebSocket) {
+                this.wsServer = await Promise.resolve(createWebSocketServer(this.httpServer));
+            }
+            // Call custom initialization if provided, passing the WebSocket server
+            if (this.config.onInitialize) {
+                const wantsWebSocket = this.config.onInitialize.length >= 2;
+                if (wantsWebSocket) {
+                    await this.config.onInitialize(this.app, this.wsServer);
+                }
+                else {
+                    await this.config.onInitialize(this.app);
+                }
+            }
+            // Setup error handlers (should be last)
+            this.setupErrorHandlers();
+        }
+        catch (_error) {
+            ensureLogger().error("Server initialization failed:", _error);
+            this.isInitialized = false;
+            throw _error;
+        }
+    }
+    /**
+     * Setup desktop app integration (CORS, data paths, logging, etc.)
+     */
+    async setupDesktopIntegration() {
+        ensureLogger().info("Setting up desktop app integration", {
+            appId: this.config.appId,
+            isDesktopApp: isDesktopApp(),
+            dataPath: this.config.desktopDataPath ||
+                getAppDataPath(this.config.appId, this.config.appName),
+        });
+        // Initialize logging for desktop apps
+        const logger = getLogger;
+        if (!logger.isInitialized()) {
+            const logsDir = getLogsPath(this.config.appId, this.config.appName);
+            await logger.initialize({
+                appName: this.config.appName,
+                logLevel: process.env.LOG_LEVEL || "info",
+                consoleOutput: true,
+                fileOutput: true,
+                logsDir,
+            });
+            ensureLogger().info("Logging initialized for desktop app", { logsDir });
+        }
+        // Setup CORS for desktop apps
+        const corsOrigins = [...(this.config.corsOrigins || [])];
+        // Add localhost origins based on webPort if specified
+        if (this.config.webPort) {
+            corsOrigins.push(`http://localhost:${this.config.webPort}`, `http://localhost:${this.config.webPort + 1}`);
+        }
+        // Add Electron origins when running in desktop mode
+        if (isDesktopApp()) {
+            // Electron file:// protocol sends null or file:// origin
+            corsOrigins.push("file://", "null");
+        }
+        this.app.use(cors({
+            origin: corsOrigins,
+            credentials: true,
+        }));
+    }
+    /**
+     * Setup default middleware for all applications
+     */
+    setupDefaultMiddleware() {
+        // Basic middleware that should be present in all apps
+        this.app.use(express.json({ limit: this.config.bodyLimit }));
+        this.app.use(express.urlencoded({ extended: true, limit: this.config.bodyLimit }));
+        // CORS setup for non-desktop apps (desktop setup happens in setupDesktopIntegration)
+        if (!this.config.enableDesktopIntegration) {
+            const corsOrigins = [...(this.config.corsOrigins || [])];
+            // Add localhost origins based on webPort if specified
+            if (this.config.webPort) {
+                corsOrigins.push(`http://localhost:${this.config.webPort}`, `http://localhost:${this.config.webPort + 1}`);
+            }
+            if (corsOrigins.length > 0) {
+                this.app.use(cors({
+                    origin: corsOrigins,
+                    credentials: true,
+                }));
+            }
+            else {
+                this.app.use(cors());
+            }
+        }
+        // Request logging (can be disabled)
+        if (this.config.enableRequestLogging) {
+            this.app.use(createRequestLoggingMiddleware({
+                logger: ensureLogger(),
+                ...this.config.requestLogging,
+            }));
+        }
+        // Trust proxy to respect X-Forwarded-* headers in containerized/proxy envs
+        const trustProxy = this.config.trustProxy ??
+            (this.config.environment !== "development" ? true : false);
+        if (typeof this.app.set === "function") {
+            this.app.set("trust proxy", trustProxy);
+        }
+    }
+    /**
+     * Setup error handlers (should be last in middleware chain)
+     */
+    setupErrorHandlers() {
+        // AI error handler for AI service errors
+        this.app.use(aiErrorHandler);
+        // Standardized API error handler
+        this.app.use(apiErrorHandler);
+    }
+    /**
+     * Start the server and listen on the configured port
+     */
+    async start() {
+        if (!this.isInitialized) {
+            throw new Error("Server not initialized. Call initialize() first.");
+        }
+        const port = this.config.port;
+        const host = this.config.host;
+        const exitOnError = this.config.exitOnStartupError !== false;
+        // Check if API port is available (skip for port 0 which means "pick any available")
+        if (port !== 0) {
+            const processOnPort = await getProcessOnPort(port);
+            if (processOnPort) {
+                const message = `Port ${port} is already in use`;
+                if (exitOnError) {
+                    ensureLogger().error(message);
+                    process.exit(1);
+                }
+                else {
+                    ensureLogger().warn(`${message} (PID ${processOnPort.pid} - ${processOnPort.command})`);
+                    return;
+                }
+            }
+        }
+        return new Promise((resolve, reject) => {
+            const fail = (error) => {
+                ensureLogger().error("Server error:", error);
+                if (exitOnError) {
+                    process.exit(1);
+                }
+                reject(error);
+            };
+            // Handle server errors
+            this.httpServer.on("error", (error) => {
+                if (error.code === "EADDRINUSE") {
+                    const message = `Port ${port} is already in use`;
+                    ensureLogger().error(message);
+                    if (exitOnError) {
+                        process.exit(1);
+                    }
+                    reject(new Error(message));
+                    return;
+                }
+                else if (error.code === "EACCES") {
+                    const message = `Port ${port} requires elevated privileges`;
+                    ensureLogger().error(message);
+                    if (exitOnError) {
+                        process.exit(1);
+                    }
+                    reject(new Error(message));
+                    return;
+                }
+                else {
+                    fail(error instanceof Error ? error : new Error(String(error)));
+                    return;
+                }
+            });
+            // Start listening
+            // Apply safer timeouts for production workloads
+            this.httpServer.requestTimeout = this.config.requestTimeoutMs;
+            this.httpServer.headersTimeout = this.config.headersTimeoutMs;
+            this.httpServer.keepAliveTimeout = this.config.keepAliveTimeoutMs;
+            try {
+                this.httpServer.listen(port, host, async () => {
+                    // Display banner only after successful binding
+                    // Note: In production, webPort is typically not used because the API server
+                    // serves the UI assets directly from the main port. However, if webPort
+                    // is explicitly configured, respect it.
+                    // Only display banner if not suppressed
+                    if (process.env.SUPPRESS_STARTUP_BANNER !== "true") {
+                        displayStartupBanner({
+                            appName: this.config.appName,
+                            appVersion: this.config.appVersion,
+                            description: this.config.description,
+                            port: this.config.port,
+                            webPort: this.config.webPort, // Pass the actual configured webPort
+                            environment: this.config.environment,
+                            startTime: this.startTime,
+                        });
+                    }
+                    // Call custom start handler if provided
+                    if (this.config.onStart) {
+                        try {
+                            await this.config.onStart();
+                        }
+                        catch (_error) {
+                            const error = _error instanceof Error ? _error : new Error(String(_error));
+                            ensureLogger().error("Custom start handler failed:", error);
+                            if (exitOnError) {
+                                process.exit(1);
+                            }
+                            reject(error);
+                            return;
+                        }
+                    }
+                    if (this.config.webPort) {
+                        ensureLogger().info(`Web UI Port: ${this.config.webPort}`);
+                    }
+                    // Bind graceful shutdown signals once per instance
+                    this.bindShutdownSignals();
+                    resolve();
+                });
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                ensureLogger().error("Failed to start server:", error);
+                if (exitOnError) {
+                    process.exit(1);
+                }
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Get the data path for desktop apps (platform-specific)
+     */
+    getDataPath() {
+        if (this.config.enableDesktopIntegration) {
+            return (this.config.desktopDataPath ||
+                getAppDataPath(this.config.appId, this.config.appName));
+        }
+        return "./data";
+    }
+    /**
+     * Check if running as desktop app
+     */
+    isDesktopApp() {
+        return this.config.enableDesktopIntegration || false;
+    }
+    /**
+     * Attach signal listeners for graceful shutdown
+     */
+    bindShutdownSignals() {
+        if (this.signalsBound)
+            return;
+        if (!this.config.gracefulShutdownSignals?.length)
+            return;
+        const signals = this.config.gracefulShutdownSignals;
+        if (process.setMaxListeners) {
+            const current = process.getMaxListeners ? process.getMaxListeners() : 10;
+            process.setMaxListeners(Math.max(current, signals.length + 20));
+        }
+        signals.forEach((signal) => {
+            process.on(signal, async () => {
+                ensureLogger().info(`Received ${signal}, shutting down gracefully...`);
+                try {
+                    await this.stop();
+                    process.exit(0);
+                }
+                catch (error) {
+                    ensureLogger().error("Graceful shutdown failed", error);
+                    process.exit(1);
+                }
+            });
+        });
+        this.signalsBound = true;
+    }
+    /**
+     * Stop the server gracefully
+     */
+    async stop() {
+        if (this.shuttingDown)
+            return Promise.resolve();
+        this.shuttingDown = true;
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                ensureLogger().warn("Force closing server after timeout");
+                this.forceCloseConnections();
+                resolve();
+            }, 10_000);
+            const close = () => {
+                clearTimeout(timeout);
+                ensureLogger().info("Server stopped gracefully");
+                resolve();
+            };
+            try {
+                if (this.wsServer?.shutdown) {
+                    this.wsServer.shutdown();
+                }
+                if (this.wsServer?.close) {
+                    this.wsServer.close();
+                }
+                this.httpServer.close((err) => {
+                    if (err) {
+                        ensureLogger().error("Error while stopping server", err);
+                        reject(err);
+                        return;
+                    }
+                    this.forceCloseConnections();
+                    close();
+                });
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                reject(error);
+            }
+        });
+    }
+    forceCloseConnections() {
+        // Prefer native closeAllConnections if available
+        if (typeof this.httpServer.closeAllConnections === "function") {
+            try {
+                this.httpServer.closeAllConnections();
+            }
+            catch (err) {
+                ensureLogger().warn("closeAllConnections failed", err);
+            }
+        }
+        this.connections.forEach((socket) => {
+            try {
+                socket.destroy();
+            }
+            catch {
+                // ignore
+            }
+        });
+        this.connections.clear();
+    }
+}
+/**
+ * Convenience function to create and start a standard server
+ */
+export async function createStandardServer(config) {
+    const server = new StandardServer(config);
+    await server.initialize();
+    await server.start();
+    return server;
+}
+//# sourceMappingURL=StandardServer.js.map

package/dist/core/StandardServer.js.map

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

package/dist/core/apiResponse.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Standardized API Response Utilities
+ * Provides consistent response format across all applications
+ */
+import { Response } from "express";
+export interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    message?: string;
+    timestamp?: string;
+    metadata?: Record<string, any>;
+}
+export interface ApiErrorResponse extends ApiResponse {
+    success: false;
+    error: string;
+    code?: string;
+    details?: any;
+    stack?: string;
+}
+export interface ApiSuccessResponse<T = any> extends ApiResponse<T> {
+    success: true;
+    data: T;
+}
+/**
+ * Send a successful response
+ */
+export declare function sendSuccess<T = any>(res: Response, data: T, message?: string, statusCode?: number): Response<ApiSuccessResponse<T>>;
+/**
+ * Send an error response
+ */
+export declare function sendError(res: Response, error: string | Error, statusCode?: number, details?: any): Response<ApiErrorResponse>;
+/**
+ * Send a validation error response
+ */
+export declare function sendValidationError(res: Response, errors: any, message?: string): Response<ApiErrorResponse>;
+/**
+ * Send a not found response
+ */
+export declare function sendNotFound(res: Response, resource?: string): Response<ApiErrorResponse>;
+/**
+ * Send an unauthorized response
+ */
+export declare function sendUnauthorized(res: Response, message?: string): Response<ApiErrorResponse>;
+/**
+ * Send a forbidden response
+ */
+export declare function sendForbidden(res: Response, message?: string): Response<ApiErrorResponse>;
+/**
+ * Send a bad request response
+ */
+export declare function sendBadRequest(res: Response, message?: string): Response<ApiErrorResponse>;
+/**
+ * Send a created response
+ */
+export declare function sendCreated<T = any>(res: Response, data: T, message?: string): Response<ApiSuccessResponse<T>>;
+/**
+ * Send a no content response
+ */
+export declare function sendNoContent(res: Response): Response;
+/**
+ * Wrap async route handlers to catch errors
+ */
+export declare function asyncHandler(fn: (req: any, res: any, next: any) => any): (req: any, res: any, next: any) => void;
+/**
+ * Standard error handler middleware
+ */
+export declare function apiErrorHandler(err: any, _req: any, res: any, next: any): any;
+//# sourceMappingURL=apiResponse.d.ts.map

package/dist/core/apiResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiResponse.d.ts","sourceRoot":"","sources":["../../src/core/apiResponse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAMnC,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IACjE,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EACjC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,SAAM,GACf,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CASjC;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,MAAM,GAAG,KAAK,EACrB,UAAU,SAAM,EAChB,OAAO,CAAC,EAAE,GAAG,GACZ,QAAQ,CAAC,gBAAgB,CAAC,CAoB5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,GAAG,EACX,OAAO,SAAsB,GAC5B,QAAQ,CAAC,gBAAgB,CAAC,CAE5B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,QAAQ,EACb,QAAQ,SAAa,GACpB,QAAQ,CAAC,gBAAgB,CAAC,CAE5B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,QAAQ,EACb,OAAO,SAAiB,GACvB,QAAQ,CAAC,gBAAgB,CAAC,CAE5B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,QAAQ,EACb,OAAO,SAAc,GACpB,QAAQ,CAAC,gBAAgB,CAAC,CAE5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,QAAQ,EACb,OAAO,SAAgB,GACtB,QAAQ,CAAC,gBAAgB,CAAC,CAE5B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EACjC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,CAAC,EACP,OAAO,SAAkC,GACxC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAEjC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAErD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,GAAG,IAC7D,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,UAGtC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,OAsCvE"}

package/dist/core/apiResponse.js

@@ -0,0 +1,127 @@
+/**
+ * Standardized API Response Utilities
+ * Provides consistent response format across all applications
+ */
+import { ZodError } from "zod";
+import { createLogger } from "../core/logger.js";
+const logger = createLogger("api-error");
+/**
+ * Send a successful response
+ */
+export function sendSuccess(res, data, message, statusCode = 200) {
+    const requestId = res.locals?.requestId;
+    return res.status(statusCode).json({
+        success: true,
+        data,
+        message,
+        timestamp: new Date().toISOString(),
+        metadata: requestId ? { requestId } : undefined,
+    });
+}
+/**
+ * Send an error response
+ */
+export function sendError(res, error, statusCode = 500, details) {
+    const requestId = res.locals?.requestId;
+    const errorMessage = typeof error === "string" ? error : error.message;
+    const response = {
+        success: false,
+        error: errorMessage,
+        timestamp: new Date().toISOString(),
+        metadata: requestId ? { requestId } : undefined,
+    };
+    if (details) {
+        response.details = details;
+    }
+    // Include stack trace in development
+    if (process.env.NODE_ENV === "development" && error instanceof Error) {
+        response.stack = error.stack;
+    }
+    return res.status(statusCode).json(response);
+}
+/**
+ * Send a validation error response
+ */
+export function sendValidationError(res, errors, message = "Validation failed") {
+    return sendError(res, message, 400, errors);
+}
+/**
+ * Send a not found response
+ */
+export function sendNotFound(res, resource = "Resource") {
+    return sendError(res, `${resource} not found`, 404);
+}
+/**
+ * Send an unauthorized response
+ */
+export function sendUnauthorized(res, message = "Unauthorized") {
+    return sendError(res, message, 401);
+}
+/**
+ * Send a forbidden response
+ */
+export function sendForbidden(res, message = "Forbidden") {
+    return sendError(res, message, 403);
+}
+/**
+ * Send a bad request response
+ */
+export function sendBadRequest(res, message = "Bad request") {
+    return sendError(res, message, 400);
+}
+/**
+ * Send a created response
+ */
+export function sendCreated(res, data, message = "Resource created successfully") {
+    return sendSuccess(res, data, message, 201);
+}
+/**
+ * Send a no content response
+ */
+export function sendNoContent(res) {
+    return res.status(204).send();
+}
+/**
+ * Wrap async route handlers to catch errors
+ */
+export function asyncHandler(fn) {
+    return (req, res, next) => {
+        Promise.resolve(fn(req, res, next)).catch(next);
+    };
+}
+/**
+ * Standard error handler middleware
+ */
+export function apiErrorHandler(err, _req, res, next) {
+    // If response was already sent, delegate to default Express error handler
+    if (res.headersSent) {
+        return next(err);
+    }
+    // Log the error using the framework's enhanced logger
+    logger.error("API Error:", {
+        error: err.message,
+        stack: err.stack,
+        name: err.name,
+        statusCode: err.statusCode || err.status || 500,
+    });
+    // Handle different error types
+    if (err instanceof ZodError || err?.name === "ZodError") {
+        const issues = err instanceof ZodError ? err.issues : err?.issues;
+        return sendValidationError(res, issues || err.message);
+    }
+    if (err.name === "ValidationError") {
+        return sendValidationError(res, err.errors || err.message);
+    }
+    if (err.name === "UnauthorizedError") {
+        return sendUnauthorized(res, err.message);
+    }
+    if (err.name === "CastError" || err.name === "TypeError") {
+        return sendBadRequest(res, "Invalid request parameters");
+    }
+    if (err.statusCode || err.status) {
+        return sendError(res, err.message, err.statusCode || err.status);
+    }
+    // Default to internal server error
+    return sendError(res, err.message || "Internal server error");
+}
+//# sourceMappingURL=apiResponse.js.map