blendsdk 5.33.0

package/dist/webafx/application/console-logger.js

@@ -0,0 +1,111 @@
+/**
+ * Map log level names to numeric values for comparison.
+ * Lower numbers = higher priority (ERROR is highest).
+ */
+const LOG_LEVEL_MAP = {
+    ERROR: 1,
+    WARN: 2,
+    INFO: 3,
+    DEBUG: 4,
+};
+/**
+ * Console-based logger implementation.
+ * Provides structured logging with configurable log levels and prefixes.
+ *
+ * @remarks
+ * Log levels:
+ * - ERROR (1): Errors only
+ * - WARN (2): Errors and warnings
+ * - INFO (3): Errors, warnings, and info
+ * - DEBUG (4): All messages including debug
+ *
+ * DEBUG mode can also be enabled via DEBUG=true environment variable.
+ */
+export class ConsoleLogger {
+    prefix;
+    level;
+    /**
+     * Creates a new ConsoleLogger instance.
+     *
+     * @param prefix - Optional prefix for log messages (e.g., 'APP', 'Plugin:Auth')
+     * @param logLevel - Optional log level (defaults to process.env.LOG_LEVEL or 'ERROR')
+     */
+    constructor(prefix, logLevel) {
+        this.prefix = prefix;
+        // Use provided log level, fall back to process.env.LOG_LEVEL, then default to ERROR
+        const levelFromEnv = (process.env.LOG_LEVEL || 'ERROR').toUpperCase();
+        this.level = LOG_LEVEL_MAP[logLevel || levelFromEnv] ?? 1;
+    }
+    /**
+     * Logs an error message.
+     *
+     * @param message - Error message
+     * @param data - Optional additional data to log
+     */
+    async error(message, data) {
+        if (this.shouldLog(1)) {
+            console.error(this.message('ERROR', message, data));
+        }
+    }
+    /**
+     * Logs a warning message.
+     *
+     * @param message - Warning message
+     * @param data - Optional additional data to log
+     */
+    async warn(message, data) {
+        if (this.shouldLog(2)) {
+            console.log(this.message('WARN', message, data));
+        }
+    }
+    /**
+     * Logs an informational message.
+     *
+     * @param message - Info message
+     * @param data - Optional additional data to log
+     */
+    async info(message, data) {
+        if (this.shouldLog(3)) {
+            console.log(this.message('INFO', message, data));
+        }
+    }
+    /**
+     * Logs a debug message.
+     * Only logged if LOG_LEVEL >= 4 or DEBUG=true.
+     *
+     * @param message - Debug message
+     * @param data - Optional additional data to log
+     */
+    async debug(message, data) {
+        if (this.shouldLog(4) || process.env.DEBUG === 'true') {
+            console.log(this.message('DEBUG', message, data));
+        }
+    }
+    /**
+     * Determines if a message at the given level should be logged.
+     *
+     * The configured level acts as a threshold: all messages at or below
+     * the configured level are logged. For example, if LOG_LEVEL=WARN (2),
+     * then ERROR (1) and WARN (2) are logged, but INFO (3) and DEBUG (4) are not.
+     *
+     * @param level - Log level of the message (1=ERROR, 2=WARN, 3=INFO, 4=DEBUG)
+     * @returns True if message should be logged
+     * @internal
+     */
+    shouldLog(level) {
+        return level <= this.level;
+    }
+    /**
+     * Formats a log message with type, prefix, and optional data.
+     *
+     * @param type - Log type (ERROR, WARN, INFO, DEBUG)
+     * @param message - Log message
+     * @param data - Optional additional data
+     * @returns Formatted log message
+     * @internal
+     */
+    message(type, message, data) {
+        return `[${type}${this.prefix ? `:${this.prefix.toUpperCase()}` : ''}]: ${message}${data ? ` - ${JSON.stringify(data)}` : ''}`;
+    }
+}
+//# sourceMappingURL=console-logger.js.map

package/dist/webafx/application/console-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.js","sourceRoot":"","sources":["../../src/application/console-logger.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,aAAa,GAA6B;IAC9C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,aAAa;IACd,MAAM,CAAqB;IAC3B,KAAK,CAAS;IAExB;;;;;OAKG;IACH,YAAY,MAAe,EAAE,QAAmB;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,oFAAoF;QACpF,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC,WAAW,EAAc,CAAC;QAClF,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,IAA0B;QACrD,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,IAA0B;QACpD,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,IAA0B;QACpD,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,IAA0B;QACrD,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACO,SAAS,CAAC,KAAa;QAC/B,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED;;;;;;;;OAQG;IACO,OAAO,CAAC,IAAY,EAAE,OAAe,EAAE,IAA0B;QACzE,OAAO,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACjI,CAAC;CACF"}

package/dist/webafx/application/controller-registry.d.ts

@@ -0,0 +1,34 @@
+import { ApplicationSettings } from './application-settings.js';
+import { ServiceContainer } from './service-container.js';
+/**
+ * Controller definition for registering controllers with WebApplication.
+ */
+export interface ControllerDefinition {
+    /** Base URL path for all controller routes */
+    basePath: string;
+    /** Controller class constructor */
+    ControllerClass: new (settings: ApplicationSettings, services: ServiceContainer) => any;
+}
+/**
+ * Registry for managing application controllers.
+ *
+ * @internal
+ */
+export declare class ControllerRegistry {
+    protected controllers: ControllerDefinition[];
+    constructor();
+    /**
+     * Gets all registered controllers.
+     *
+     * @returns Array of controller definitions
+     */
+    getAll(): ControllerDefinition[];
+    /**
+     * Registers a controller with a base path.
+     *
+     * @param basePath - Base URL path for all controller routes
+     * @param ControllerClass - Controller class constructor
+     */
+    register(basePath: string, ControllerClass: new (settings: ApplicationSettings, services: ServiceContainer) => any): void;
+}
+//# sourceMappingURL=controller-registry.d.ts.map

package/dist/webafx/application/controller-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-registry.d.ts","sourceRoot":"","sources":["../../src/application/controller-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,eAAe,EAAE,KAAK,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,KAAK,GAAG,CAAC;CACzF;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,SAAS,CAAC,WAAW,EAAE,oBAAoB,EAAE,CAAC;;IAK9C;;;;OAIG;IACH,MAAM;IAIN;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,KAAK,GAAG;CAMnH"}

package/dist/webafx/application/controller-registry.js

@@ -0,0 +1,32 @@
+/**
+ * Registry for managing application controllers.
+ *
+ * @internal
+ */
+export class ControllerRegistry {
+    controllers;
+    constructor() {
+        this.controllers = [];
+    }
+    /**
+     * Gets all registered controllers.
+     *
+     * @returns Array of controller definitions
+     */
+    getAll() {
+        return this.controllers;
+    }
+    /**
+     * Registers a controller with a base path.
+     *
+     * @param basePath - Base URL path for all controller routes
+     * @param ControllerClass - Controller class constructor
+     */
+    register(basePath, ControllerClass) {
+        this.controllers.push({
+            basePath,
+            ControllerClass,
+        });
+    }
+}
+//# sourceMappingURL=controller-registry.js.map

package/dist/webafx/application/controller-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-registry.js","sourceRoot":"","sources":["../../src/application/controller-registry.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACnB,WAAW,CAAyB;IAC9C;QACE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAAgB,EAAE,eAAuF;QAChH,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACpB,QAAQ;YACR,eAAe;SAChB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/webafx/application/error-handler-middleware.d.ts

@@ -0,0 +1,22 @@
+import { ErrorRequestHandler, Request } from 'express';
+/**
+ * Error handler middleware options
+ */
+export type onErrorLog = (req: Request, error: Error, data: Record<any, string>) => Promise<void>;
+/**
+ * Error handler middleware
+ * Formats errors and sends appropriate responses using StandardErrorResponse format
+ *
+ * @param logger - Logger function for error logging
+ * @param includeStack - Whether to include stack traces in responses
+ *
+ * @example
+ * ```typescript
+ * app.use(errorHandlerMiddleware(
+ *   async (req, err, data) => logger.error(data.error, data),
+ *   process.env.NODE_ENV === 'development'
+ * ));
+ * ```
+ */
+export declare function errorHandlerMiddleware(logger: onErrorLog, includeStack: boolean): ErrorRequestHandler;
+//# sourceMappingURL=error-handler-middleware.d.ts.map

package/dist/webafx/application/error-handler-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler-middleware.d.ts","sourceRoot":"","sources":["../../src/application/error-handler-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAgB,OAAO,EAAY,MAAM,SAAS,CAAC;AAI/E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElG;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,OAAO,GACpB,mBAAmB,CAwDrB"}

package/dist/webafx/application/error-handler-middleware.js

@@ -0,0 +1,70 @@
+import { ApiError } from '../errors/api-error.js';
+/**
+ * Error handler middleware
+ * Formats errors and sends appropriate responses using StandardErrorResponse format
+ *
+ * @param logger - Logger function for error logging
+ * @param includeStack - Whether to include stack traces in responses
+ *
+ * @example
+ * ```typescript
+ * app.use(errorHandlerMiddleware(
+ *   async (req, err, data) => logger.error(data.error, data),
+ *   process.env.NODE_ENV === 'development'
+ * ));
+ * ```
+ */
+export function errorHandlerMiddleware(logger, includeStack) {
+    return (async (err, req, res, next) => {
+        // Handle ApiError
+        if (err instanceof ApiError) {
+            const response = {
+                success: false,
+                error: {
+                    code: err.code,
+                    message: err.message,
+                    statusCode: err.statusCode,
+                    timestamp: new Date().toISOString(),
+                    requestId: req.id,
+                    path: req.path,
+                    ...(err.details && { details: err.details }),
+                    ...(includeStack && { stack: err.stack }),
+                },
+            };
+            // Wrap logger in try-catch to prevent logger failures from
+            // crashing error handling — the client must always get a response
+            try {
+                await logger(req, err, response.error);
+            }
+            catch {
+                // Logger failed — silently continue to send the error response
+            }
+            return res.status(err.statusCode).json(response);
+        }
+        // Handle unknown errors
+        const statusCode = 500;
+        const message = includeStack ? err.message : 'Internal Server Error';
+        const response = {
+            success: false,
+            error: {
+                code: 'INTERNAL_SERVER_ERROR',
+                message,
+                statusCode,
+                timestamp: new Date().toISOString(),
+                requestId: req.id,
+                path: req.path,
+                ...(includeStack && { stack: err.stack }),
+            },
+        };
+        // Wrap logger in try-catch to prevent logger failures from
+        // crashing error handling — the client must always get a response
+        try {
+            await logger(req, err, response.error);
+        }
+        catch {
+            // Logger failed — silently continue to send the error response
+        }
+        res.status(statusCode).json(response);
+    });
+}
+//# sourceMappingURL=error-handler-middleware.js.map

package/dist/webafx/application/error-handler-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler-middleware.js","sourceRoot":"","sources":["../../src/application/error-handler-middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAQlD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAkB,EAClB,YAAqB;IAErB,OAAO,CAAC,KAAK,EAAE,GAAU,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QAC5E,kBAAkB;QAClB,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAA0B;gBACtC,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS,EAAE,GAAG,CAAC,EAAE;oBACjB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;oBAC5C,GAAG,CAAC,YAAY,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;iBAC1C;aACF,CAAC;YAEF,2DAA2D;YAC3D,kEAAkE;YAClE,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAY,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,+DAA+D;YACjE,CAAC;YAED,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,CAAC;QAED,wBAAwB;QACxB,MAAM,UAAU,GAAG,GAAG,CAAC;QACvB,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;QAErE,MAAM,QAAQ,GAA0B;YACtC,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,uBAAuB;gBAC7B,OAAO;gBACP,UAAU;gBACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,GAAG,CAAC,EAAE;gBACjB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,GAAG,CAAC,YAAY,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;aAC1C;SACF,CAAC;QAEF,2DAA2D;QAC3D,kEAAkE;QAClE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAY,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;QAED,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAwB,CAAC;AAC5B,CAAC"}

package/dist/webafx/application/index.d.ts

@@ -0,0 +1,13 @@
+export * from './application-settings.js';
+export * from './base-controller.js';
+export * from './console-logger.js';
+export * from './plugin.js';
+export * from './rate-limiter.js';
+export * from './request-context.js';
+export * from './route-builder.js';
+export * from './service-container.js';
+export * from './services.js';
+export * from './structured-logger.js';
+export * from './type.js';
+export * from './web-application.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/webafx/application/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC"}

package/dist/webafx/application/index.js

@@ -0,0 +1,13 @@
+export * from './application-settings.js';
+export * from './base-controller.js';
+export * from './console-logger.js';
+export * from './plugin.js';
+export * from './rate-limiter.js';
+export * from './request-context.js';
+export * from './route-builder.js';
+export * from './service-container.js';
+export * from './services.js';
+export * from './structured-logger.js';
+export * from './type.js';
+export * from './web-application.js';
+//# sourceMappingURL=index.js.map

package/dist/webafx/application/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC"}

package/dist/webafx/application/logger.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/webafx/application/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/application/logger.ts"],"names":[],"mappings":""}

package/dist/webafx/application/logger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.js.map

package/dist/webafx/application/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/application/logger.ts"],"names":[],"mappings":""}

package/dist/webafx/application/plugin.d.ts

@@ -0,0 +1,73 @@
+import { Express } from 'express';
+import { ConsoleLogger } from './console-logger.js';
+import { Logger } from './type.js';
+import { WebApplication } from './web-application.js';
+/**
+ * Plugin interface for extending WebApplication functionality.
+ * Plugins can provide health checks and cleanup on shutdown.
+ */
+export interface Plugin {
+    /** Optional health check function */
+    health?: () => Promise<boolean>;
+    /** Optional cleanup function called on application shutdown */
+    shutdown?: () => Promise<void>;
+}
+/**
+ * Plugin definition for registering plugins with WebApplication.
+ */
+export interface PluginDefinition {
+    /** Unique plugin name */
+    name: string;
+    /** Factory function that creates and initializes the plugin */
+    factory: (params: {
+        app: WebApplication;
+        express: Express;
+        logger: Logger;
+    }) => Promise<Plugin | void>;
+    /** Plugin priority. Lower numbers install first. Default: 100 */
+    priority?: number;
+}
+/**
+ * Registry for managing application plugins.
+ * Handles plugin installation, health checks, and shutdown.
+ *
+ * @internal
+ */
+export declare class PluginRegistry {
+    protected registry: Record<string, PluginDefinition>;
+    protected _shutdown: {
+        shutdown: () => Promise<void>;
+        name: string;
+    }[];
+    protected _health: {
+        health: () => Promise<boolean>;
+        name: string;
+    }[];
+    protected logger: ConsoleLogger;
+    constructor();
+    /**
+     * Installs all registered plugins.
+     * Plugins are installed in priority order (lower priority values first).
+     *
+     * @param app - WebApplication instance
+     * @param express - Express application instance
+     */
+    install(app: WebApplication, express: Express): Promise<void>;
+    /**
+     * Checks health status of all plugins.
+     *
+     * @returns True if all plugins are healthy, false otherwise
+     */
+    health(): Promise<boolean>;
+    /**
+     * Shuts down all plugins in order.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Registers a plugin definition.
+     *
+     * @param def - Plugin definition to register
+     */
+    register(def: PluginDefinition): void;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/webafx/application/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/application/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,OAAO,EAAE,CAAC,MAAM,EAAE;QAChB,GAAG,EAAE,cAAc,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACrD,SAAS,CAAC,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvE,SAAS,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAEtE,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC;;IAQhC;;;;;;OAMG;IACG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO;IA4BnD;;;;OAIG;IACG,MAAM;IAkBZ;;OAEG;IACG,QAAQ;IAOd;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,gBAAgB;CAG/B"}

package/dist/webafx/application/plugin.js

@@ -0,0 +1,90 @@
+import { ConsoleLogger } from './console-logger.js';
+/**
+ * Registry for managing application plugins.
+ * Handles plugin installation, health checks, and shutdown.
+ *
+ * @internal
+ */
+export class PluginRegistry {
+    registry;
+    _shutdown;
+    _health;
+    logger;
+    constructor() {
+        this.registry = {};
+        this._shutdown = [];
+        this._health = [];
+        this.logger = new ConsoleLogger('Plugins');
+    }
+    /**
+     * Installs all registered plugins.
+     * Plugins are installed in priority order (lower priority values first).
+     *
+     * @param app - WebApplication instance
+     * @param express - Express application instance
+     */
+    async install(app, express) {
+        // Sort plugins by priority (lower numbers first)
+        const items = Object.values(this.registry).sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+        for (const item of items) {
+            const plugin = (await item.factory({
+                app,
+                express,
+                logger: new ConsoleLogger(`Plugin:${item.name}`),
+            }));
+            if (plugin?.shutdown) {
+                this._shutdown.push({
+                    name: item.name,
+                    shutdown: plugin.shutdown,
+                });
+            }
+            if (plugin?.health) {
+                this._health.push({
+                    name: item.name,
+                    health: plugin.health,
+                });
+            }
+            await this.logger.info(`Plugin ${item.name} installed.`);
+        }
+    }
+    /**
+     * Checks health status of all plugins.
+     *
+     * @returns True if all plugins are healthy, false otherwise
+     */
+    async health() {
+        // If no health checks registered, consider system healthy
+        if (this._health.length === 0) {
+            return true;
+        }
+        let count = 0;
+        for (const item of this._health) {
+            const healthy = await item.health();
+            if (!healthy) {
+                await this.logger.debug(`${item.name} plugin is not healthy`);
+            }
+            else {
+                count += 1;
+            }
+        }
+        return count === this._health.length;
+    }
+    /**
+     * Shuts down all plugins in order.
+     */
+    async shutdown() {
+        for (const item of this._shutdown) {
+            await this.logger.info(`Shutting down ${item.name} plugin.`);
+            await item.shutdown();
+        }
+    }
+    /**
+     * Registers a plugin definition.
+     *
+     * @param def - Plugin definition to register
+     */
+    register(def) {
+        this.registry[def.name] = def;
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/webafx/application/plugin.js.map

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

package/dist/webafx/application/rate-limiter.d.ts

@@ -0,0 +1,35 @@
+import { NextFunction, Request, Response } from 'express';
+/**
+ * Configuration options for rate limiting middleware.
+ */
+export interface RateLimitOptions {
+    /** Maximum requests per window. Default: 100 */
+    maxRequests?: number;
+    /** Window duration in milliseconds. Default: 60000 (1 minute) */
+    windowMs?: number;
+    /** Key extractor function. Default: uses IP address */
+    keyExtractor?: (req: Request) => string;
+    /** Optional message for rate limit errors */
+    message?: string;
+}
+/**
+ * Creates a rate limiting middleware.
+ * Uses in-memory storage — suitable for single-instance deployments.
+ * For multi-instance deployments, use a Redis-backed implementation via plugins.
+ *
+ * @param options - Rate limiting configuration options
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * // Global rate limiting
+ * app.express.use(rateLimitMiddleware({ maxRequests: 100, windowMs: 60000 }));
+ *
+ * // Per-route rate limiting
+ * this.route().get('/api/search')
+ *   .middleware(rateLimitMiddleware({ maxRequests: 10, windowMs: 60000 }))
+ *   .handle(this.search);
+ * ```
+ */
+export declare function rateLimitMiddleware(options?: RateLimitOptions): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/webafx/application/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/application/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG1D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IACxC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,gBAAgB,IAyBpD,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UAyBxD"}

package/dist/webafx/application/rate-limiter.js

@@ -0,0 +1,74 @@
+import { RateLimitError } from '../errors/http-errors.js';
+/**
+ * Creates a rate limiting middleware.
+ * Uses in-memory storage — suitable for single-instance deployments.
+ * For multi-instance deployments, use a Redis-backed implementation via plugins.
+ *
+ * @param options - Rate limiting configuration options
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * // Global rate limiting
+ * app.express.use(rateLimitMiddleware({ maxRequests: 100, windowMs: 60000 }));
+ *
+ * // Per-route rate limiting
+ * this.route().get('/api/search')
+ *   .middleware(rateLimitMiddleware({ maxRequests: 10, windowMs: 60000 }))
+ *   .handle(this.search);
+ * ```
+ */
+export function rateLimitMiddleware(options) {
+    const { maxRequests = 100, windowMs = 60_000, keyExtractor = (req) => req.ip || 'unknown', message = 'Rate limit exceeded', } = options || {};
+    // In-memory storage: key -> { count, resetTime }
+    const hits = new Map();
+    // Periodic cleanup to prevent memory leaks
+    // Runs every windowMs to remove expired entries
+    const cleanup = setInterval(() => {
+        const now = Date.now();
+        for (const [key, value] of hits) {
+            if (value.resetTime <= now) {
+                hits.delete(key);
+            }
+        }
+    }, windowMs);
+    // Prevent cleanup interval from keeping process alive
+    if (cleanup.unref)
+        cleanup.unref();
+    return (req, res, next) => {
+        const key = keyExtractor(req);
+        const now = Date.now();
+        const record = hits.get(key);
+        // First request or window expired — create new record
+        if (!record || record.resetTime <= now) {
+            hits.set(key, { count: 1, resetTime: now + windowMs });
+            setRateLimitHeaders(res, maxRequests, maxRequests - 1, now + windowMs);
+            return next();
+        }
+        // Increment counter for existing window
+        record.count += 1;
+        // Rate limit exceeded
+        if (record.count > maxRequests) {
+            setRateLimitHeaders(res, maxRequests, 0, record.resetTime);
+            throw new RateLimitError(message);
+        }
+        // Within limit
+        setRateLimitHeaders(res, maxRequests, maxRequests - record.count, record.resetTime);
+        next();
+    };
+}
+/**
+ * Sets standard rate limit headers on the response.
+ *
+ * @param res - Express response object
+ * @param limit - Maximum requests allowed
+ * @param remaining - Remaining requests in current window
+ * @param reset - Unix timestamp (seconds) when the window resets
+ * @internal
+ */
+function setRateLimitHeaders(res, limit, remaining, reset) {
+    res.setHeader('X-RateLimit-Limit', limit);
+    res.setHeader('X-RateLimit-Remaining', Math.max(0, remaining));
+    res.setHeader('X-RateLimit-Reset', Math.ceil(reset / 1000));
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/webafx/application/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/application/rate-limiter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAgB1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA0B;IAC5D,MAAM,EACJ,WAAW,GAAG,GAAG,EACjB,QAAQ,GAAG,MAAM,EACjB,YAAY,GAAG,CAAC,GAAY,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,SAAS,EACpD,OAAO,GAAG,qBAAqB,GAChC,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,iDAAiD;IACjD,MAAM,IAAI,GAAsD,IAAI,GAAG,EAAE,CAAC;IAE1E,2CAA2C;IAC3C,gDAAgD;IAChD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEb,sDAAsD;IACtD,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,EAAE,CAAC;IAEnC,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QACzD,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,sDAAsD;QACtD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,QAAQ,EAAE,CAAC,CAAC;YACvD,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,CAAC;YACvE,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,wCAAwC;QACxC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;QAElB,sBAAsB;QACtB,IAAI,MAAM,CAAC,KAAK,GAAG,WAAW,EAAE,CAAC;YAC/B,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3D,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QAED,eAAe;QACf,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACpF,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,mBAAmB,CAAC,GAAa,EAAE,KAAa,EAAE,SAAiB,EAAE,KAAa;IACzF,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAC1C,GAAG,CAAC,SAAS,CAAC,uBAAuB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAC/D,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC"}