@mxweb/core 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,245 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-01-02
+
+### ⚠️ Breaking Changes
+
+- **Framework Independence**: Removed all direct dependencies on Next.js
+  - The framework is now fully framework-agnostic
+  - Next.js is still the primary target and fully compatible
+  - Removed `next` from `peerDependencies`
+  - Removed `@mxweb/utils` dependency (utilities are now built-in)
+  - Use `CoreRequest` interface instead of `NextRequest`
+  - Use `CoreResponse` class instead of `NextResponse`
+
+- **Interceptor Redesign**: Interceptors now transform responses instead of wrapping handlers
+  - Old pattern: `intercept(context, next)` - wrapped handler execution
+  - New pattern: `transform(response)` - receives `CoreResponse` and transforms it
+  - Interceptors no longer have access to `CallHandler` (deprecated)
+  - Use `ResponseInterceptorHandler` interface instead of `InterceptorHandler`
+
+### Added
+
+- **Application Options**: New configuration options for framework-agnostic response handling
+  - `response?: ResponseClass` - Pass response class (NextResponse, Response) for final response creation
+    - Defaults to standard `Response` if not provided
+    - Example: `Application.create({ response: NextResponse })`
+  - `poweredBy?: string | false` - Customize X-Powered-By header
+    - Defaults to `"MxWeb"`
+    - Set to `false` to disable the header
+    - Example: `Application.create({ poweredBy: "MyAPI/1.0" })`
+
+- **Response**: Added `ResponseClass` interface for response class compatibility
+  - Interface for classes with static `json(body, init)` method
+  - Compatible with `NextResponse`, `Response`, and custom response classes
+  - Allows passing response class directly to `Application.create()`
+
+- **Response**: Added `ResponseInterceptor` type and `ResponseInterceptorHandler` interface
+  - `ResponseInterceptor<T>` - Function type for simple response transformers
+  - `ResponseInterceptorHandler<T>` - Interface for class-based interceptors
+  - `transform(response: CoreResponse)` method for transforming responses
+  - Interceptors can add headers, modify body, or return new `CoreResponse`
+
+- **Response**: Added `applyTransformer()` helper function
+  - Handles both class-based and function-based transformers
+  - Automatically detects if transformer is a class with `json()` method
+
+- **Response**: Added `CoreResponse` class and `CoreResponseBody` interface
+  - Framework-agnostic response wrapper
+  - `CoreResponseBody<T>` - Standardized JSON response structure
+  - `CoreResponse.json()` - Returns the response body for custom response handling
+  - `ResponseTransformer<R>` - Type for custom response transformers
+  - All `ServerResponse` methods now return `CoreResponse` instead of `NextResponse`
+
+- **Route**: Added fluent chain API helper methods for easier route configuration
+  - `decorators(...decorators)` - Add multiple decorator results directly (lazy applied on `getReflect()`)
+  - `middlewares(...middlewares)` - Add middleware functions
+  - `guards(...guards)` - Add guard classes
+  - `filters(...filters)` - Add exception filter classes
+  - `interceptors(...interceptors)` - Add interceptor classes
+  - `pipes(...pipes)` - Add pipe classes
+  - `metadata(key, value)` - Set metadata key-value pairs
+  - All chain methods return new Route instance (immutable pattern)
+  - Example: `Route.get("/users", "findAll").guards(AuthGuard).metadata("roles", ["admin"])`
+
+- **Common**: Added `Switchable<T>` interface for safe inject facade pattern
+  - Provides type-safe way to expose controlled API from injects
+  - `ApplicationInject` and `FeatureInject` now extend `Partial<Switchable>`
+  - Example: `class Connection implements ApplicationInject, Switchable<DbClient> { ... }`
+
+- **Common**: Added `Callback<R, A>` utility type (previously from `@mxweb/utils`)
+
+- **ExecuteContext**: Added `switch()` and `switchSync()` methods for inject context switching
+  - `switch<T>(name)` - Async method to get inject and call its `switch()` method (throws if not found)
+  - `switchSync<T>(name)` - Sync version (only works if inject already initialized)
+  - Searches feature injects first (priority), then falls back to global injects
+  - Example: `const db = await this.context.switch<DatabaseClient>("db")`
+
+- **ExecuteContext**: Added `CoreRequest` interface to abstract HTTP request
+  - Framework-agnostic request interface (compatible with Next.js, Express, Fastify, Fetch API)
+  - Properties: `nextUrl?`, `url?`, `query?`, `headers`, `body`, `json()`, `text()`, `formData()`, `blob()`, `arrayBuffer()`
+  - `RequestContext.req` now uses `CoreRequest` instead of `NextRequest`
+  - `switchHttp().getRequest<T>()` is now generic for type-safe request access
+
+- **ExecuteContext**: Added `CoreSearchParams` class for unified query parameter handling
+  - Constructor accepts `URLSearchParams`, query string, or query object
+  - Type-safe getter methods: `get()`, `getAll()`, `getNumber()`, `getBoolean()`
+  - Helper methods: `has()`, `keys()`, `values()`, `entries()`, `forEach()`, `size`
+  - Conversion methods: `toObject()`, `toObjectAll()`, `toURLSearchParams()`, `toString()`
+  - `switchHttp().searchParams()` returns cached `CoreSearchParams` instance
+  - `switchHttp().query()` now uses `searchParams().toObject()` for backward compatibility
+  - Fallback chain: `nextUrl.searchParams` → `url.searchParams` → `url` string → `query` object
+
+- **Config**: Added `switch()` method implementation
+  - Returns the Config instance itself for context switching
+  - Example: `const config = await this.context.getInject<Config>("config")`
+
+### Changed
+
+- **Application**: Response handling is now centralized in `toResponse()` method
+  - All responses go through `Application.toResponse()` before being returned
+  - Adds `X-Powered-By` header automatically (configurable via `poweredBy` option)
+  - Converts `CoreResponse` to configured response class (NextResponse, Response, etc.)
+
+- **Interceptor**: Complete redesign of interceptor pattern
+  - Interceptors now receive `CoreResponse` and return transformed `CoreResponse`
+  - No longer wrap handler execution - called after handler returns
+  - Route interceptors run first, then global interceptors
+  - Example:
+    ```ts
+    class LoggingInterceptor implements ResponseInterceptorHandler {
+      transform(response: CoreResponse): CoreResponse {
+        console.log(`[${response.status}] ${response.body.message}`);
+        response.headers.set("X-Logged", "true");
+        return response;
+      }
+    }
+    ```
+
+- **ExecuteContext**: `getInject()` and `getLocalInject()` now return `switch()` result
+  - If inject implements `switch()`, returns the switched value instead of raw instance
+  - If inject doesn't implement `switch()`, returns the raw instance (backward compatible)
+  - Same behavior for `getInjectSync()` and `getLocalInjectSync()`
+  - This provides a safe API by default, hiding dangerous methods like `close()`, `destroy()`
+  - Lifecycle hooks (`onInit`, `onDestroy`) are still called on raw instance
+
+- **Feature**: `getInject()` and `getInjectSync()` now return `switch()` result
+  - Same pattern as ExecuteContext for consistency
+  - Lifecycle hooks (`onFeature`, `onFeatureDestroy`) are still called on raw instance
+
+- **Service**: `getInject()` and `getInjectSync()` now return `switch()` result
+  - Follows the same pattern as ExecuteContext for consistency
+
+- **Hooks**: `onRequest` hook now receives `CoreRequest` instead of `NextRequest`
+
+- **Decorator**: `Request()` function now returns `CoreRequest` and is generic
+  - Example: `const req = Request<NextRequest>()` for Next.js type-safe access
+
+### Deprecated
+
+- **Common**: `CallHandler<T>` type is deprecated
+  - Interceptors no longer use the `intercept(context, next)` pattern
+  - Use `ResponseInterceptorHandler` with `transform(response)` instead
+
+### Removed
+
+- Removed `next` from `peerDependencies` (no longer required)
+- Removed `@mxweb/utils` dependency (utilities are now built-in)
+- Removed `InterceptorHandler` interface (replaced by `ResponseInterceptorHandler`)
+
+### Fixed
+
+- **Application**: Fixed inject lifecycle `onInit` not being called at startup
+  - Previously, `onInit` was only called when inject was first accessed (lazy initialization)
+  - Now, all registered injects are initialized during `registerInjectFactories()`
+  - Added `initializeInjects()` method to ensure `onInit` runs for all injects at application startup
+  - This is critical for injects like Migration that need to run immediately
+
+### Migration Guide
+
+#### For Next.js users
+
+The framework remains fully compatible with Next.js. Configure your application:
+
+```ts
+import { Application } from "@mxweb/core";
+import { NextResponse } from "next/server";
+
+const app = Application.create({
+  response: NextResponse,  // Use NextResponse for final responses
+  poweredBy: "MyAPI/1.0",  // Optional: customize X-Powered-By header
+  // ... other options
+});
+
+export const GET = app.GET;
+export const POST = app.POST;
+```
+
+#### Request handling
+
+Use `CoreRequest` interface, which is compatible with `NextRequest`:
+
+```ts
+// Before
+const req: NextRequest = ...
+
+// After (CoreRequest is compatible)
+const req: CoreRequest = nextRequest; // Works as-is
+
+// Or for type-safe Next.js specific features
+const req = Request<NextRequest>();
+```
+
+#### Response handling
+
+`ServerResponse` methods return `CoreResponse`, which is automatically converted:
+
+```ts
+// The framework handles conversion internally
+// For custom handling in filters:
+const coreResponse = response.success(data);
+return NextResponse.json(coreResponse.json(), { 
+  status: coreResponse.status,
+  headers: coreResponse.headers 
+});
+```
+
+#### Interceptor migration
+
+Update interceptors to use the new `transform()` pattern:
+
+```ts
+// Before (v1.0.x)
+class LoggingInterceptor implements InterceptorHandler {
+  async intercept(context: ExecuteContext, next: CallHandler): Promise<unknown> {
+    const start = Date.now();
+    const result = await next();
+    console.log(`Request took ${Date.now() - start}ms`);
+    return result;
+  }
+}
+
+// After (v1.1.0)
+class LoggingInterceptor implements ResponseInterceptorHandler {
+  transform(response: CoreResponse): CoreResponse {
+    console.log(`[${response.status}] ${response.body.message}`);
+    response.headers.set("X-Response-Time", Date.now().toString());
+    return response;
+  }
+}
+```
+
+## [1.0.2] - 2024-12-18
+
+### Changed
+
+- **Build**: Improved terser configuration for logger module
+  - Added custom `terserWithOptions()` plugin for file-specific minification
+  - Logger module now keeps console calls while still being minified
+  - Other modules continue to have console calls removed during minification
+  - Added `loggerMinifyOptions` with `drop_console: false` for logger
+
 ## [1.0.1] - 2024-12-16
 
 ### Changed

package/dist/application.d.ts

@@ -1,6 +1,6 @@
-import { NextRequest } from "next/server";
 import { Feature } from "./feature";
-import { Filter, Guard, Interceptor } from "./execute";
+import { CoreResponse, ResponseClass } from "./response";
+import { CoreRequest, Filter, Guard, Interceptor } from "./execute";
 import { ApplicationHooksOptions } from "./hooks";
 import { ApplicationInject, InjectEntry, InjectFactory, InjectRegistry, Pipe, RoutePayload } from "./common";
 /**
@@ -44,12 +44,16 @@ export type ApplicationCors = string[] | ((registry: InjectRegistry) => string[]
 /**
  * Configuration options for creating an Application instance.
  *
- * @template Key - The key used to extract path segments from Next.js catch-all route params
+ * @template Key - The key used to extract path segments from catch-all route params
  *
  * @example
  * ```ts
+ * // With Next.js
+ * import { NextResponse } from "next/server";
+ *
  * const options: ApplicationOptions = {
  *   key: "path",
+ *   response: NextResponse, // Use NextResponse for final response
  *   injects: [
  *     Config.forRoot(),
  *     Database.forRoot(),
@@ -63,11 +67,44 @@ export type ApplicationCors = string[] | ((registry: InjectRegistry) => string[]
  *   onRequest: (req, method) => console.log(`${method} request`),
  *   onResponse: (ctx) => console.log("Response sent"),
  * };
+ *
+ * // Without response option - uses standard Response
+ * const options: ApplicationOptions = {
+ *   key: "path",
+ *   // response defaults to Response
+ * };
  * ```
  */
 export interface ApplicationOptions<Key extends string = "path"> extends ApplicationHooksOptions {
     /** The key used to extract path segments from catch-all route params. Defaults to "path". */
     key?: Key;
+    /**
+     * Response class to use for creating final responses.
+     * Pass NextResponse for Next.js, or any class with static json() method.
+     * Defaults to standard Response.
+     *
+     * @example
+     * ```ts
+     * import { NextResponse } from "next/server";
+     * Application.create({ response: NextResponse });
+     * ```
+     */
+    response?: ResponseClass;
+    /**
+     * Custom value for X-Powered-By header.
+     * Set to false to disable the header.
+     * Defaults to "MxWeb".
+     *
+     * @example
+     * ```ts
+     * // Custom value
+     * Application.create({ poweredBy: "MyAPI/1.0" });
+     *
+     * // Disable header
+     * Application.create({ poweredBy: false });
+     * ```
+     */
+    poweredBy?: string | false;
     /** Array of inject factories for dependency injection */
     injects?: ApplicationInjects;
     /** Global guards applied to all routes */
@@ -82,7 +119,8 @@ export interface ApplicationOptions<Key extends string = "path"> extends Applica
     cors?: ApplicationCors;
 }
 /**
- * Main Application class for handling HTTP requests in Next.js App Router.
+ * Main Application class for handling HTTP requests.
+ * Designed to be framework-agnostic with primary support for Next.js App Router.
  *
  * This class provides a NestJS-inspired framework for building APIs with:
  * - Dependency injection
@@ -91,11 +129,11 @@ export interface ApplicationOptions<Key extends string = "path"> extends Applica
  * - Lifecycle hooks
  * - CORS support
  *
- * @template Key - The key used to extract path segments from Next.js catch-all route params
+ * @template Key - The key used to extract path segments from catch-all route params
  *
  * @example
  * ```ts
- * // In app/api/[[...path]]/route.ts
+ * // In app/api/[[...path]]/route.ts (Next.js)
  * import { Application } from "@mxweb/core";
  * import "@/features/products/product.feature";
  *
@@ -121,6 +159,8 @@ export declare class Application<Key extends string = "path"> {
     private readonly request;
     private readonly method;
     private readonly payload;
+    /** Logger instance for Application */
+    private static logger;
     /** Registered features (modules) */
     private static features;
     /** Global guards */
@@ -135,6 +175,10 @@ export declare class Application<Key extends string = "path"> {
     private static corsOrigins;
     /** Application configuration options */
     private static options;
+    /** Response class for creating final responses */
+    private static ResponseClass;
+    /** X-Powered-By header value (false to disable) */
+    private static poweredBy;
     /** Application-level hooks manager */
     private static hooks;
     /** Flag indicating if features are initialized */
@@ -151,11 +195,18 @@ export declare class Application<Key extends string = "path"> {
     private route;
     /** Request-scoped hooks manager */
     private requestHooks;
+    /**
+     * Converts a CoreResponse to the configured Response class.
+     *
+     * @param coreResponse - The CoreResponse to convert
+     * @returns Response instance (NextResponse, Response, etc.)
+     */
+    private static toResponse;
     /**
      * Creates a new Application instance for handling a request.
      * This constructor is private - use Application.create() to set up the application.
      *
-     * @param request - The incoming Next.js request
+     * @param request - The incoming CoreRequest (compatible with NextRequest)
      * @param method - The HTTP method of the request
      * @param payload - The route payload containing path params
      */
@@ -228,6 +279,16 @@ export declare class Application<Key extends string = "path"> {
      * - Loads CORS configuration (may need injects)
      */
     private static registerInjectFactories;
+    /**
+     * Initializes all registered injects by calling their onInit lifecycle hook.
+     * This ensures injects like Migration run at application startup.
+     *
+     * @remarks
+     * - Injects are initialized in registration order
+     * - Each inject's factory is called to create the instance
+     * - onInit is called if the inject implements it
+     */
+    private static initializeInjects;
     /**
      * Registers process shutdown handlers for graceful cleanup.
      * Handles SIGTERM and SIGINT signals to properly destroy injects.
@@ -284,24 +345,23 @@ export declare class Application<Key extends string = "path"> {
      * Route-level filters run first, then global filters.
      *
      * @param error - The error to handle
-     * @returns A Response if a filter handles the error, null otherwise
+     * @returns A CoreResponse or Response if a filter handles the error, null otherwise
      *
      * @remarks
-     * Filters are tried in order until one returns a Response.
+     * Filters are tried in order until one returns a Response or CoreResponse.
      * If no filter handles the error, null is returned and default error handling applies.
      */
     private executeFilters;
     /**
-     * Wraps the handler with interceptor chain.
-     * Route-level interceptors are outermost, global interceptors are innermost.
+     * Applies interceptors to transform the response.
+     * Route-level interceptors run first, then global interceptors.
      *
-     * @template T - The return type of the handler
-     * @param handler - The original handler function to wrap
-     * @returns The result of executing the interceptor chain
+     * @param response - The CoreResponse to transform
+     * @returns The transformed CoreResponse after passing through all interceptors
      *
      * @remarks
-     * Interceptors form a chain where each can modify the request/response.
-     * The chain is built from right to left (last interceptor wraps handler first).
+     * Interceptors are applied in order: route interceptors first, then global.
+     * Each interceptor receives the response and can transform headers or body.
      */
     private executeInterceptors;
     /**
@@ -320,10 +380,11 @@ export declare class Application<Key extends string = "path"> {
      */
     private checkCors;
     /**
-     * Applies CORS headers to the response.
+     * Applies CORS headers to the CoreResponse.
+     * Does not convert to Response - that's the responsibility of the response transformer.
      *
-     * @param response - The response to apply headers to
-     * @returns A new Response with CORS headers applied
+     * @param response - The CoreResponse to apply CORS headers to
+     * @returns The same CoreResponse with CORS headers applied
      */
     private applyCorsHeaders;
     /**
@@ -361,7 +422,7 @@ export declare class Application<Key extends string = "path"> {
      *
      * @template Key - The key used to extract path segments from route params
      * @param method - The HTTP method this handler will process
-     * @returns An async function that handles Next.js requests
+     * @returns An async function that handles HTTP requests
      *
      * @remarks
      * The returned handler:
@@ -398,13 +459,13 @@ export declare class Application<Key extends string = "path"> {
      * ```
      */
     static create<Key extends string = "path">(options?: ApplicationOptions<Key>): {
-        GET: (req: NextRequest, payload: RoutePayload<"path">) => Promise<Response>;
-        POST: (req: NextRequest, payload: RoutePayload<"path">) => Promise<Response>;
-        PUT: (req: NextRequest, payload: RoutePayload<"path">) => Promise<Response>;
-        PATCH: (req: NextRequest, payload: RoutePayload<"path">) => Promise<Response>;
-        DELETE: (req: NextRequest, payload: RoutePayload<"path">) => Promise<Response>;
-        HEAD: (req: NextRequest, payload: RoutePayload) => Promise<Response>;
-        OPTIONS: (req: NextRequest) => Promise<Response>;
+        GET: (req: CoreRequest, payload: RoutePayload<"path">) => Promise<Response>;
+        POST: (req: CoreRequest, payload: RoutePayload<"path">) => Promise<Response>;
+        PUT: (req: CoreRequest, payload: RoutePayload<"path">) => Promise<Response>;
+        PATCH: (req: CoreRequest, payload: RoutePayload<"path">) => Promise<Response>;
+        DELETE: (req: CoreRequest, payload: RoutePayload<"path">) => Promise<Response>;
+        HEAD: (req: CoreRequest, payload: RoutePayload) => Promise<Response>;
+        OPTIONS: (req: CoreRequest) => Promise<Response | CoreResponse<unknown>>;
     };
     /**
      * Creates a handler for HEAD requests.

package/dist/application.js

@@ -1 +1 @@
-"use strict";var e=require("./error.js"),t=require("./context.js"),s=require("./response.js"),r=require("./hooks.js"),n=require("./common.js");const o={key:"path"};class i{constructor(e,t,n){this.request=e,this.method=t,this.payload=n,this.feature=null,this.route=null,this.response=new s.ServerResponse,this.requestHooks=new r.RequestHooks(i.hooks)}static getInject(e){return t.executeContext.getInject(e)}static getInjectSync(e){return t.executeContext.getInjectSync(e)}static getInjects(){return new Map(t.executeContext.injections)}static createInjectRegistry(){return this.registryCreated||(this.registry={get:async e=>t.executeContext.getInject(e),set(e,s){t.executeContext.setInject(e,s)}},t.executeContext.setRegistry(this.registry),this.registryCreated=!0),this.registry}static async registerInjectFactories(){if(this.factoriesRegistered)return;const e=this.options.injects;if(!e||!e.length)return void(this.factoriesRegistered=!0);const t=this.createInjectRegistry();for(const s of e)await s(t);this.factoriesRegistered=!0,this.registerShutdown(),await this.loadCors()}static registerShutdown(){if(this.shutdownRegistered)return;this.shutdownRegistered=!0;const e=async()=>{for(const e of this.features)await e.destroyInjects();for(const[e,s]of t.executeContext.injections)if(s.instance&&"function"==typeof s.instance.onDestroy)try{await s.instance.onDestroy()}catch(e){}process.exit(0)};process.on("SIGTERM",e),process.on("SIGINT",e)}static async loadCors(){const e=this.options.cors;e&&(Array.isArray(e)?this.corsOrigins=e:this.corsOrigins=await e(this.registry))}static async loadImports(){if(!this.initialized)return this.initPromise||(this.initPromise=(async()=>{this.initialized=!0})()),this.initPromise}isMatchFeature(e,t){for(const s of i.features)if(this.route=s.matchRoute(e,t),this.route)return this.feature=s,!0;return null}async executeGuards(){const e=this.route?.route.getReflect().getGuards()??new Set,s=[...i.guards,...e];if(!s.length)return!0;for(const e of s)try{const s=new e;if(!await s.canActivate(t.executeContext))return!1}catch{return!1}return!0}async executeMiddlewares(){const e=this.route.route.getMiddlewares();if(!e.length)return!0;for(const s of e){let e=!1;const r=()=>{e=!0};try{if(await s(t.executeContext,r),!e)return!1}catch{return!1}}return!0}async executeFilters(e){const s=[...this.route?.route.getReflect().getFilters()??new Set,...i.filters];for(const r of s)try{const s=new r,n=await s.catch(e,t.executeContext);if(n instanceof Response)return n}catch{continue}return null}async executeInterceptors(e){const s=[...this.route?.route.getReflect().getInterceptors()??new Set,...i.interceptors];if(!s.length)return e();let r=e;for(let e=s.length-1;e>=0;e--){const n=new(0,s[e]),o=r;r=()=>n.intercept(t.executeContext,o)}return r()}async executePipes(e){const t=this.route?.route.getReflect().getPipes()??new Set,s=[...i.pipes,...t];if(!s.length)return e;let r=e;for(const e of s){const t=new e;r=await t.transform(r)}return r}checkCors(){const e=i.corsOrigins;if(!e.length)return!0;const t=this.request.headers.get("origin");return!t||(e.includes("*")||e.includes(t))}applyCorsHeaders(e){const t=i.corsOrigins;if(!t.length)return e;const s=this.request.headers.get("origin");if(!s)return e;const r=new Headers(e.headers);return t.includes("*")?r.set("Access-Control-Allow-Origin","*"):t.includes(s)&&(r.set("Access-Control-Allow-Origin",s),r.set("Vary","Origin")),r.set("Access-Control-Allow-Methods","GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS"),r.set("Access-Control-Allow-Headers","Content-Type, Authorization"),r.set("Access-Control-Max-Age","86400"),new Response(e.body,{status:e.status,statusText:e.statusText,headers:r})}async dispatch(){const s=this.route,r=this.feature,n=t.executeContext.getContextOrThrow();try{if(!await this.executeGuards())return this.response.forbidden();if(!await this.executeMiddlewares())return this.response.forbidden();const e=s.route.getAction();let t=null;if("string"==typeof e){const s=r.getController();"function"==typeof s._initDependencies&&await s._initDependencies(),"function"==typeof s[e]&&(t=s[e].bind(s))}else"function"==typeof e&&(t=e);if(!t)return this.response.internalServer(new Error("Route action handler not found"));await this.executePipes(n);const o=await this.executeInterceptors(()=>t(n));return this.response.success(o)}catch(t){const s=await this.executeFilters(t);if(s)return s;if(t instanceof e.HttpError){switch(t.statusCode){case 400:return this.response.badRequest(t.message,t.error);case 401:return this.response.unauthorized(t.message,t.error);case 403:return this.response.forbidden(t.message,t.error);case 404:return this.response.notFound(t.message,t.error);case 409:return this.response.conflict(t.message,t.error);case 422:return this.response.unprocessableEntity(t.message,t.error);case 429:return this.response.tooManyRequests(t.message,t.error);case 501:return this.response.notImplemented(t.message,t.error);case 502:return this.response.badGateway(t.message,t.error);case 503:return this.response.serviceUnavailable(t.message,t.error);case 504:return this.response.gatewayTimeout(t.message,t.error)}return this.response.internalServer(t)}return this.response.internalServer(t)}}async match(){let e=null;try{if(!this.checkCors())return this.applyCorsHeaders(this.response.forbidden("CORS not allowed"));const s=await this.payload.params,r=i.options.key||o.key,n=s?.[r]?.join("/")||"";if(!this.isMatchFeature(this.method,n))return this.applyCorsHeaders(this.response.notFound("Route not found",{method:this.method,path:n,params:s}));await this.feature.loadInjects(),e={req:this.request,res:this.response,method:this.method,path:n,params:this.route.params,wildcards:this.route.wildcards,reflect:this.route.route.getReflect(),feature:this.feature},this.requestHooks.setFeatureHooks(this.feature.getHooks()),await this.requestHooks.featureRequest(e);const a=await t.executeContext.run(e,()=>this.dispatch());return await this.requestHooks.featureResponse(e),await this.requestHooks.appResponse(e),this.applyCorsHeaders(a)}catch(t){return e&&(await this.requestHooks.featureResponse(e),await this.requestHooks.appResponse(e)),this.applyCorsHeaders(this.response.internalServer(t))}}static createHandler(e){return async(t,s)=>{await i.registerInjectFactories(),await i.loadImports();const r=new i(t,e,s);return await r.requestHooks.appRequest(t,e),await r.match.bind(r)()}}static create(e=o){return this.options=e,this.hooks=new r.ApplicationHooks(this.options),e.guards&&e.guards.forEach(e=>this.guards.add(e)),e.filters&&e.filters.forEach(e=>this.filters.add(e)),e.interceptors&&e.interceptors.forEach(e=>this.interceptors.add(e)),e.pipes&&e.pipes.forEach(e=>this.pipes.add(e)),{[n.RouteMethod.GET]:i.createHandler(n.RouteMethod.GET),[n.RouteMethod.POST]:i.createHandler(n.RouteMethod.POST),[n.RouteMethod.PUT]:i.createHandler(n.RouteMethod.PUT),[n.RouteMethod.PATCH]:i.createHandler(n.RouteMethod.PATCH),[n.RouteMethod.DELETE]:i.createHandler(n.RouteMethod.DELETE),[n.RouteMethod.HEAD]:i.createHeadHandler(),[n.RouteMethod.OPTIONS]:i.createOptionsHandler()}}static createHeadHandler(){return async(e,t)=>{await i.registerInjectFactories(),await i.loadImports();const s=new i(e,n.RouteMethod.HEAD,t);await s.requestHooks.appRequest(e,n.RouteMethod.HEAD);const r=await s.match.bind(s)();return new Response(null,{status:r.status,statusText:r.statusText,headers:r.headers})}}static createOptionsHandler(){return async e=>{await i.registerInjectFactories();const t=this.corsOrigins,r=e.headers.get("origin"),n=s.ServerResponse.options();if(!t.length||!r)return n;const o=new Headers(n.headers);return t.includes("*")?o.set("Access-Control-Allow-Origin","*"):t.includes(r)&&(o.set("Access-Control-Allow-Origin",r),o.set("Vary","Origin")),o.set("Access-Control-Allow-Methods","GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS"),o.set("Access-Control-Allow-Headers","Content-Type, Authorization"),o.set("Access-Control-Max-Age","86400"),new Response(null,{status:204,headers:o})}}static register(...e){return e.forEach(e=>this.features.add(e)),this}}i.features=new Set,i.guards=new Set,i.filters=new Set,i.interceptors=new Set,i.pipes=new Set,i.corsOrigins=[],i.options=o,i.initialized=!1,i.initPromise=null,i.shutdownRegistered=!1,i.registryCreated=!1,i.factoriesRegistered=!1,exports.Application=i;
+"use strict";var e=require("./error.js"),t=require("./context.js"),s=require("./response.js"),r=require("./hooks.js"),o=require("./logger.js"),n=require("./common.js");const i={key:"path"};class a{static toResponse(e){return!1!==this.poweredBy&&e.headers.set("X-Powered-By",this.poweredBy),this.ResponseClass.json(e.body,{status:e.status,statusText:e.statusText,headers:e.headers})}constructor(e,t,o){this.request=e,this.method=t,this.payload=o,this.feature=null,this.route=null,this.response=new s.ServerResponse,this.requestHooks=new r.RequestHooks(a.hooks)}static getInject(e){return t.executeContext.getInject(e)}static getInjectSync(e){return t.executeContext.getInjectSync(e)}static getInjects(){return new Map(t.executeContext.injections)}static createInjectRegistry(){return this.registryCreated||(this.registry={get:async e=>t.executeContext.getInject(e),set(e,s){t.executeContext.setInject(e,s)}},t.executeContext.setRegistry(this.registry),this.registryCreated=!0),this.registry}static async registerInjectFactories(){if(this.factoriesRegistered)return;const e=this.options.injects;if(!e||!e.length)return void(this.factoriesRegistered=!0);const t=this.createInjectRegistry();for(const s of e)await s(t);this.factoriesRegistered=!0,await this.initializeInjects(),this.registerShutdown(),await this.loadCors()}static async initializeInjects(){for(const[e,s]of t.executeContext.injections)if(!s.instance)try{const e=this.createInjectRegistry();s.instance=await s.factory(e),s.instance&&"function"==typeof s.instance.onInit&&await s.instance.onInit()}catch(t){throw a.logger.error(`Error initializing inject ${e}:`,t),t}}static registerShutdown(){if(this.shutdownRegistered)return;this.shutdownRegistered=!0;const e=async()=>{a.logger.info("Shutting down...");for(const e of this.features)await e.destroyInjects();for(const[e,s]of t.executeContext.injections)if(s.instance&&"function"==typeof s.instance.onDestroy)try{await s.instance.onDestroy(),a.logger.info(`Destroyed inject: ${e}`)}catch(t){a.logger.error(`Error destroying inject ${e}:`,t)}a.logger.info("Shutdown complete"),process.exit(0)};process.on("SIGTERM",e),process.on("SIGINT",e)}static async loadCors(){const e=this.options.cors;e&&(Array.isArray(e)?this.corsOrigins=e:this.corsOrigins=await e(this.registry))}static async loadImports(){if(!this.initialized)return this.initPromise||(this.initPromise=(async()=>{this.initialized=!0})()),this.initPromise}isMatchFeature(e,t){for(const s of a.features)if(this.route=s.matchRoute(e,t),this.route)return this.feature=s,!0;return null}async executeGuards(){const e=this.route?.route.getReflect().getGuards()??new Set,s=[...a.guards,...e];if(!s.length)return!0;for(const e of s)try{const s=new e;if(!await s.canActivate(t.executeContext))return!1}catch{return!1}return!0}async executeMiddlewares(){const e=this.route.route.getMiddlewares();if(!e.length)return!0;for(const s of e){let e=!1;const r=()=>{e=!0};try{if(await s(t.executeContext,r),!e)return!1}catch{return!1}}return!0}async executeFilters(e){const r=[...this.route?.route.getReflect().getFilters()??new Set,...a.filters];for(const o of r)try{const r=new o,n=await r.catch(e,t.executeContext);if(n instanceof s.CoreResponse||n instanceof Response)return n}catch{continue}return null}async executeInterceptors(e){const t=[...this.route?.route.getReflect().getInterceptors()??new Set,...a.interceptors];if(!t.length)return e;let s=e;for(const e of t){const t=new e;s=await t.transform(s)}return s}async executePipes(e){const t=this.route?.route.getReflect().getPipes()??new Set,s=[...a.pipes,...t];if(!s.length)return e;let r=e;for(const e of s){const t=new e;r=await t.transform(r)}return r}checkCors(){const e=a.corsOrigins;if(!e.length)return!0;const t=this.request.headers.get("origin");return!t||(e.includes("*")||e.includes(t))}applyCorsHeaders(e){const t=a.corsOrigins;if(!t.length)return e;const s=this.request.headers.get("origin");return s?(t.includes("*")?e.headers.set("Access-Control-Allow-Origin","*"):t.includes(s)&&(e.headers.set("Access-Control-Allow-Origin",s),e.headers.set("Vary","Origin")),e.headers.set("Access-Control-Allow-Methods","GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS"),e.headers.set("Access-Control-Allow-Headers","Content-Type, Authorization"),e.headers.set("Access-Control-Max-Age","86400"),e):e}async dispatch(){const r=this.route,o=this.feature,n=t.executeContext.getContextOrThrow();try{if(!await this.executeGuards())return this.response.forbidden();if(!await this.executeMiddlewares())return this.response.forbidden();const e=r.route.getAction();let t=null;if("string"==typeof e){const s=o.getController();"function"==typeof s._initDependencies&&await s._initDependencies(),"function"==typeof s[e]&&(t=s[e].bind(s))}else"function"==typeof e&&(t=e);if(!t)return this.response.internalServer(new Error("Route action handler not found"));await this.executePipes(n);const s=await t(n);let i=this.response.success(s);return i=await this.executeInterceptors(i),i}catch(t){const r=await this.executeFilters(t);if(r)return r instanceof Response?s.CoreResponse.json({success:r.ok,message:r.statusText,code:"FILTER_RESPONSE",status:r.status,data:null,error:null},{status:r.status,statusText:r.statusText}):r;if(t instanceof e.HttpError)switch(t.statusCode){case 400:return this.response.badRequest(t.message,t.error);case 401:return this.response.unauthorized(t.message,t.error);case 403:return this.response.forbidden(t.message,t.error);case 404:return this.response.notFound(t.message,t.error);case 409:return this.response.conflict(t.message,t.error);case 422:return this.response.unprocessableEntity(t.message,t.error);case 429:return this.response.tooManyRequests(t.message,t.error);case 501:return this.response.notImplemented(t.message,t.error);case 502:return this.response.badGateway(t.message,t.error);case 503:return this.response.serviceUnavailable(t.message,t.error);case 504:return this.response.gatewayTimeout(t.message,t.error)}return a.logger.error("[dispatch] Error:",t instanceof Error?t.message:t),t instanceof Error&&t.stack&&a.logger.debug("Stack trace:",t.stack),this.response.internalServer(t)}}async match(){let e=null;try{if(!this.checkCors())return this.applyCorsHeaders(this.response.forbidden("CORS not allowed"));const s=await this.payload.params,r=a.options.key||i.key,o=s?.[r]?.join("/")||"";if(!this.isMatchFeature(this.method,o))return this.applyCorsHeaders(this.response.notFound("Route not found",{method:this.method,path:o,params:s}));await this.feature.loadInjects(),e={req:this.request,res:this.response,method:this.method,path:o,params:this.route.params,wildcards:this.route.wildcards,reflect:this.route.route.getReflect(),feature:this.feature},this.requestHooks.setFeatureHooks(this.feature.getHooks()),await this.requestHooks.featureRequest(e);const n=await t.executeContext.run(e,()=>this.dispatch());return await this.requestHooks.featureResponse(e),await this.requestHooks.appResponse(e),this.applyCorsHeaders(n)}catch(t){return e&&(await this.requestHooks.featureResponse(e),await this.requestHooks.appResponse(e)),this.applyCorsHeaders(this.response.internalServer(t))}}static createHandler(e){return async(t,s)=>{await a.registerInjectFactories(),await a.loadImports();const r=new a(t,e,s);await r.requestHooks.appRequest(t,e);const o=await r.match.bind(r)();return a.toResponse(o)}}static create(e=i){return this.options=e,this.hooks=new r.ApplicationHooks(this.options),this.ResponseClass=e.response??Response,this.poweredBy=e.poweredBy??"MxWeb",e.guards&&e.guards.forEach(e=>this.guards.add(e)),e.filters&&e.filters.forEach(e=>this.filters.add(e)),e.interceptors&&e.interceptors.forEach(e=>this.interceptors.add(e)),e.pipes&&e.pipes.forEach(e=>this.pipes.add(e)),{[n.RouteMethod.GET]:a.createHandler(n.RouteMethod.GET),[n.RouteMethod.POST]:a.createHandler(n.RouteMethod.POST),[n.RouteMethod.PUT]:a.createHandler(n.RouteMethod.PUT),[n.RouteMethod.PATCH]:a.createHandler(n.RouteMethod.PATCH),[n.RouteMethod.DELETE]:a.createHandler(n.RouteMethod.DELETE),[n.RouteMethod.HEAD]:a.createHeadHandler(),[n.RouteMethod.OPTIONS]:a.createOptionsHandler()}}static createHeadHandler(){return async(e,t)=>{await a.registerInjectFactories(),await a.loadImports();const s=new a(e,n.RouteMethod.HEAD,t);await s.requestHooks.appRequest(e,n.RouteMethod.HEAD);const r=await s.match.bind(s)();return new Response(null,{status:r.status,statusText:r.statusText,headers:r.headers})}}static createOptionsHandler(){return async e=>{await a.registerInjectFactories();const t=this.corsOrigins,r=e.headers.get("origin"),o=s.ServerResponse.options();if(!t.length||!r)return o;const n=new Headers(o.headers);return t.includes("*")?n.set("Access-Control-Allow-Origin","*"):t.includes(r)&&(n.set("Access-Control-Allow-Origin",r),n.set("Vary","Origin")),n.set("Access-Control-Allow-Methods","GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS"),n.set("Access-Control-Allow-Headers","Content-Type, Authorization"),n.set("Access-Control-Max-Age","86400"),new Response(null,{status:204,headers:n})}}static register(...e){return e.forEach(e=>this.features.add(e)),this}}a.logger=o.Logger.create("Application"),a.features=new Set,a.guards=new Set,a.filters=new Set,a.interceptors=new Set,a.pipes=new Set,a.corsOrigins=[],a.options=i,a.ResponseClass=Response,a.poweredBy="MxWeb",a.initialized=!1,a.initPromise=null,a.shutdownRegistered=!1,a.registryCreated=!1,a.factoriesRegistered=!1,exports.Application=a;

package/dist/application.mjs

@@ -1 +1 @@
-import{HttpError as e}from"./error.mjs";import{executeContext as t}from"./context.mjs";import{ServerResponse as s}from"./response.mjs";import{RequestHooks as r,ApplicationHooks as n}from"./hooks.mjs";import{RouteMethod as i}from"./common.mjs";const o={key:"path"};class a{constructor(e,t,n){this.request=e,this.method=t,this.payload=n,this.feature=null,this.route=null,this.response=new s,this.requestHooks=new r(a.hooks)}static getInject(e){return t.getInject(e)}static getInjectSync(e){return t.getInjectSync(e)}static getInjects(){return new Map(t.injections)}static createInjectRegistry(){return this.registryCreated||(this.registry={get:async e=>t.getInject(e),set(e,s){t.setInject(e,s)}},t.setRegistry(this.registry),this.registryCreated=!0),this.registry}static async registerInjectFactories(){if(this.factoriesRegistered)return;const e=this.options.injects;if(!e||!e.length)return void(this.factoriesRegistered=!0);const t=this.createInjectRegistry();for(const s of e)await s(t);this.factoriesRegistered=!0,this.registerShutdown(),await this.loadCors()}static registerShutdown(){if(this.shutdownRegistered)return;this.shutdownRegistered=!0;const e=async()=>{for(const e of this.features)await e.destroyInjects();for(const[e,s]of t.injections)if(s.instance&&"function"==typeof s.instance.onDestroy)try{await s.instance.onDestroy()}catch(e){}process.exit(0)};process.on("SIGTERM",e),process.on("SIGINT",e)}static async loadCors(){const e=this.options.cors;e&&(Array.isArray(e)?this.corsOrigins=e:this.corsOrigins=await e(this.registry))}static async loadImports(){if(!this.initialized)return this.initPromise||(this.initPromise=(async()=>{this.initialized=!0})()),this.initPromise}isMatchFeature(e,t){for(const s of a.features)if(this.route=s.matchRoute(e,t),this.route)return this.feature=s,!0;return null}async executeGuards(){const e=this.route?.route.getReflect().getGuards()??new Set,s=[...a.guards,...e];if(!s.length)return!0;for(const e of s)try{const s=new e;if(!await s.canActivate(t))return!1}catch{return!1}return!0}async executeMiddlewares(){const e=this.route.route.getMiddlewares();if(!e.length)return!0;for(const s of e){let e=!1;const r=()=>{e=!0};try{if(await s(t,r),!e)return!1}catch{return!1}}return!0}async executeFilters(e){const s=[...this.route?.route.getReflect().getFilters()??new Set,...a.filters];for(const r of s)try{const s=new r,n=await s.catch(e,t);if(n instanceof Response)return n}catch{continue}return null}async executeInterceptors(e){const s=[...this.route?.route.getReflect().getInterceptors()??new Set,...a.interceptors];if(!s.length)return e();let r=e;for(let e=s.length-1;e>=0;e--){const n=new(0,s[e]),i=r;r=()=>n.intercept(t,i)}return r()}async executePipes(e){const t=this.route?.route.getReflect().getPipes()??new Set,s=[...a.pipes,...t];if(!s.length)return e;let r=e;for(const e of s){const t=new e;r=await t.transform(r)}return r}checkCors(){const e=a.corsOrigins;if(!e.length)return!0;const t=this.request.headers.get("origin");return!t||(e.includes("*")||e.includes(t))}applyCorsHeaders(e){const t=a.corsOrigins;if(!t.length)return e;const s=this.request.headers.get("origin");if(!s)return e;const r=new Headers(e.headers);return t.includes("*")?r.set("Access-Control-Allow-Origin","*"):t.includes(s)&&(r.set("Access-Control-Allow-Origin",s),r.set("Vary","Origin")),r.set("Access-Control-Allow-Methods","GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS"),r.set("Access-Control-Allow-Headers","Content-Type, Authorization"),r.set("Access-Control-Max-Age","86400"),new Response(e.body,{status:e.status,statusText:e.statusText,headers:r})}async dispatch(){const s=this.route,r=this.feature,n=t.getContextOrThrow();try{if(!await this.executeGuards())return this.response.forbidden();if(!await this.executeMiddlewares())return this.response.forbidden();const e=s.route.getAction();let t=null;if("string"==typeof e){const s=r.getController();"function"==typeof s._initDependencies&&await s._initDependencies(),"function"==typeof s[e]&&(t=s[e].bind(s))}else"function"==typeof e&&(t=e);if(!t)return this.response.internalServer(new Error("Route action handler not found"));await this.executePipes(n);const i=await this.executeInterceptors(()=>t(n));return this.response.success(i)}catch(t){const s=await this.executeFilters(t);if(s)return s;if(t instanceof e){switch(t.statusCode){case 400:return this.response.badRequest(t.message,t.error);case 401:return this.response.unauthorized(t.message,t.error);case 403:return this.response.forbidden(t.message,t.error);case 404:return this.response.notFound(t.message,t.error);case 409:return this.response.conflict(t.message,t.error);case 422:return this.response.unprocessableEntity(t.message,t.error);case 429:return this.response.tooManyRequests(t.message,t.error);case 501:return this.response.notImplemented(t.message,t.error);case 502:return this.response.badGateway(t.message,t.error);case 503:return this.response.serviceUnavailable(t.message,t.error);case 504:return this.response.gatewayTimeout(t.message,t.error)}return this.response.internalServer(t)}return this.response.internalServer(t)}}async match(){let e=null;try{if(!this.checkCors())return this.applyCorsHeaders(this.response.forbidden("CORS not allowed"));const s=await this.payload.params,r=a.options.key||o.key,n=s?.[r]?.join("/")||"";if(!this.isMatchFeature(this.method,n))return this.applyCorsHeaders(this.response.notFound("Route not found",{method:this.method,path:n,params:s}));await this.feature.loadInjects(),e={req:this.request,res:this.response,method:this.method,path:n,params:this.route.params,wildcards:this.route.wildcards,reflect:this.route.route.getReflect(),feature:this.feature},this.requestHooks.setFeatureHooks(this.feature.getHooks()),await this.requestHooks.featureRequest(e);const i=await t.run(e,()=>this.dispatch());return await this.requestHooks.featureResponse(e),await this.requestHooks.appResponse(e),this.applyCorsHeaders(i)}catch(t){return e&&(await this.requestHooks.featureResponse(e),await this.requestHooks.appResponse(e)),this.applyCorsHeaders(this.response.internalServer(t))}}static createHandler(e){return async(t,s)=>{await a.registerInjectFactories(),await a.loadImports();const r=new a(t,e,s);return await r.requestHooks.appRequest(t,e),await r.match.bind(r)()}}static create(e=o){return this.options=e,this.hooks=new n(this.options),e.guards&&e.guards.forEach(e=>this.guards.add(e)),e.filters&&e.filters.forEach(e=>this.filters.add(e)),e.interceptors&&e.interceptors.forEach(e=>this.interceptors.add(e)),e.pipes&&e.pipes.forEach(e=>this.pipes.add(e)),{[i.GET]:a.createHandler(i.GET),[i.POST]:a.createHandler(i.POST),[i.PUT]:a.createHandler(i.PUT),[i.PATCH]:a.createHandler(i.PATCH),[i.DELETE]:a.createHandler(i.DELETE),[i.HEAD]:a.createHeadHandler(),[i.OPTIONS]:a.createOptionsHandler()}}static createHeadHandler(){return async(e,t)=>{await a.registerInjectFactories(),await a.loadImports();const s=new a(e,i.HEAD,t);await s.requestHooks.appRequest(e,i.HEAD);const r=await s.match.bind(s)();return new Response(null,{status:r.status,statusText:r.statusText,headers:r.headers})}}static createOptionsHandler(){return async e=>{await a.registerInjectFactories();const t=this.corsOrigins,r=e.headers.get("origin"),n=s.options();if(!t.length||!r)return n;const i=new Headers(n.headers);return t.includes("*")?i.set("Access-Control-Allow-Origin","*"):t.includes(r)&&(i.set("Access-Control-Allow-Origin",r),i.set("Vary","Origin")),i.set("Access-Control-Allow-Methods","GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS"),i.set("Access-Control-Allow-Headers","Content-Type, Authorization"),i.set("Access-Control-Max-Age","86400"),new Response(null,{status:204,headers:i})}}static register(...e){return e.forEach(e=>this.features.add(e)),this}}a.features=new Set,a.guards=new Set,a.filters=new Set,a.interceptors=new Set,a.pipes=new Set,a.corsOrigins=[],a.options=o,a.initialized=!1,a.initPromise=null,a.shutdownRegistered=!1,a.registryCreated=!1,a.factoriesRegistered=!1;export{a as Application};
+import{HttpError as e}from"./error.mjs";import{executeContext as t}from"./context.mjs";import{ServerResponse as s,CoreResponse as r}from"./response.mjs";import{RequestHooks as n,ApplicationHooks as i}from"./hooks.mjs";import{Logger as o}from"./logger.mjs";import{RouteMethod as a}from"./common.mjs";const c={key:"path"};class u{static toResponse(e){return!1!==this.poweredBy&&e.headers.set("X-Powered-By",this.poweredBy),this.ResponseClass.json(e.body,{status:e.status,statusText:e.statusText,headers:e.headers})}constructor(e,t,r){this.request=e,this.method=t,this.payload=r,this.feature=null,this.route=null,this.response=new s,this.requestHooks=new n(u.hooks)}static getInject(e){return t.getInject(e)}static getInjectSync(e){return t.getInjectSync(e)}static getInjects(){return new Map(t.injections)}static createInjectRegistry(){return this.registryCreated||(this.registry={get:async e=>t.getInject(e),set(e,s){t.setInject(e,s)}},t.setRegistry(this.registry),this.registryCreated=!0),this.registry}static async registerInjectFactories(){if(this.factoriesRegistered)return;const e=this.options.injects;if(!e||!e.length)return void(this.factoriesRegistered=!0);const t=this.createInjectRegistry();for(const s of e)await s(t);this.factoriesRegistered=!0,await this.initializeInjects(),this.registerShutdown(),await this.loadCors()}static async initializeInjects(){for(const[e,s]of t.injections)if(!s.instance)try{const e=this.createInjectRegistry();s.instance=await s.factory(e),s.instance&&"function"==typeof s.instance.onInit&&await s.instance.onInit()}catch(t){throw u.logger.error(`Error initializing inject ${e}:`,t),t}}static registerShutdown(){if(this.shutdownRegistered)return;this.shutdownRegistered=!0;const e=async()=>{u.logger.info("Shutting down...");for(const e of this.features)await e.destroyInjects();for(const[e,s]of t.injections)if(s.instance&&"function"==typeof s.instance.onDestroy)try{await s.instance.onDestroy(),u.logger.info(`Destroyed inject: ${e}`)}catch(t){u.logger.error(`Error destroying inject ${e}:`,t)}u.logger.info("Shutdown complete"),process.exit(0)};process.on("SIGTERM",e),process.on("SIGINT",e)}static async loadCors(){const e=this.options.cors;e&&(Array.isArray(e)?this.corsOrigins=e:this.corsOrigins=await e(this.registry))}static async loadImports(){if(!this.initialized)return this.initPromise||(this.initPromise=(async()=>{this.initialized=!0})()),this.initPromise}isMatchFeature(e,t){for(const s of u.features)if(this.route=s.matchRoute(e,t),this.route)return this.feature=s,!0;return null}async executeGuards(){const e=this.route?.route.getReflect().getGuards()??new Set,s=[...u.guards,...e];if(!s.length)return!0;for(const e of s)try{const s=new e;if(!await s.canActivate(t))return!1}catch{return!1}return!0}async executeMiddlewares(){const e=this.route.route.getMiddlewares();if(!e.length)return!0;for(const s of e){let e=!1;const r=()=>{e=!0};try{if(await s(t,r),!e)return!1}catch{return!1}}return!0}async executeFilters(e){const s=[...this.route?.route.getReflect().getFilters()??new Set,...u.filters];for(const n of s)try{const s=new n,i=await s.catch(e,t);if(i instanceof r||i instanceof Response)return i}catch{continue}return null}async executeInterceptors(e){const t=[...this.route?.route.getReflect().getInterceptors()??new Set,...u.interceptors];if(!t.length)return e;let s=e;for(const e of t){const t=new e;s=await t.transform(s)}return s}async executePipes(e){const t=this.route?.route.getReflect().getPipes()??new Set,s=[...u.pipes,...t];if(!s.length)return e;let r=e;for(const e of s){const t=new e;r=await t.transform(r)}return r}checkCors(){const e=u.corsOrigins;if(!e.length)return!0;const t=this.request.headers.get("origin");return!t||(e.includes("*")||e.includes(t))}applyCorsHeaders(e){const t=u.corsOrigins;if(!t.length)return e;const s=this.request.headers.get("origin");return s?(t.includes("*")?e.headers.set("Access-Control-Allow-Origin","*"):t.includes(s)&&(e.headers.set("Access-Control-Allow-Origin",s),e.headers.set("Vary","Origin")),e.headers.set("Access-Control-Allow-Methods","GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS"),e.headers.set("Access-Control-Allow-Headers","Content-Type, Authorization"),e.headers.set("Access-Control-Max-Age","86400"),e):e}async dispatch(){const s=this.route,n=this.feature,i=t.getContextOrThrow();try{if(!await this.executeGuards())return this.response.forbidden();if(!await this.executeMiddlewares())return this.response.forbidden();const e=s.route.getAction();let t=null;if("string"==typeof e){const s=n.getController();"function"==typeof s._initDependencies&&await s._initDependencies(),"function"==typeof s[e]&&(t=s[e].bind(s))}else"function"==typeof e&&(t=e);if(!t)return this.response.internalServer(new Error("Route action handler not found"));await this.executePipes(i);const r=await t(i);let o=this.response.success(r);return o=await this.executeInterceptors(o),o}catch(t){const s=await this.executeFilters(t);if(s)return s instanceof Response?r.json({success:s.ok,message:s.statusText,code:"FILTER_RESPONSE",status:s.status,data:null,error:null},{status:s.status,statusText:s.statusText}):s;if(t instanceof e)switch(t.statusCode){case 400:return this.response.badRequest(t.message,t.error);case 401:return this.response.unauthorized(t.message,t.error);case 403:return this.response.forbidden(t.message,t.error);case 404:return this.response.notFound(t.message,t.error);case 409:return this.response.conflict(t.message,t.error);case 422:return this.response.unprocessableEntity(t.message,t.error);case 429:return this.response.tooManyRequests(t.message,t.error);case 501:return this.response.notImplemented(t.message,t.error);case 502:return this.response.badGateway(t.message,t.error);case 503:return this.response.serviceUnavailable(t.message,t.error);case 504:return this.response.gatewayTimeout(t.message,t.error)}return u.logger.error("[dispatch] Error:",t instanceof Error?t.message:t),t instanceof Error&&t.stack&&u.logger.debug("Stack trace:",t.stack),this.response.internalServer(t)}}async match(){let e=null;try{if(!this.checkCors())return this.applyCorsHeaders(this.response.forbidden("CORS not allowed"));const s=await this.payload.params,r=u.options.key||c.key,n=s?.[r]?.join("/")||"";if(!this.isMatchFeature(this.method,n))return this.applyCorsHeaders(this.response.notFound("Route not found",{method:this.method,path:n,params:s}));await this.feature.loadInjects(),e={req:this.request,res:this.response,method:this.method,path:n,params:this.route.params,wildcards:this.route.wildcards,reflect:this.route.route.getReflect(),feature:this.feature},this.requestHooks.setFeatureHooks(this.feature.getHooks()),await this.requestHooks.featureRequest(e);const i=await t.run(e,()=>this.dispatch());return await this.requestHooks.featureResponse(e),await this.requestHooks.appResponse(e),this.applyCorsHeaders(i)}catch(t){return e&&(await this.requestHooks.featureResponse(e),await this.requestHooks.appResponse(e)),this.applyCorsHeaders(this.response.internalServer(t))}}static createHandler(e){return async(t,s)=>{await u.registerInjectFactories(),await u.loadImports();const r=new u(t,e,s);await r.requestHooks.appRequest(t,e);const n=await r.match.bind(r)();return u.toResponse(n)}}static create(e=c){return this.options=e,this.hooks=new i(this.options),this.ResponseClass=e.response??Response,this.poweredBy=e.poweredBy??"MxWeb",e.guards&&e.guards.forEach(e=>this.guards.add(e)),e.filters&&e.filters.forEach(e=>this.filters.add(e)),e.interceptors&&e.interceptors.forEach(e=>this.interceptors.add(e)),e.pipes&&e.pipes.forEach(e=>this.pipes.add(e)),{[a.GET]:u.createHandler(a.GET),[a.POST]:u.createHandler(a.POST),[a.PUT]:u.createHandler(a.PUT),[a.PATCH]:u.createHandler(a.PATCH),[a.DELETE]:u.createHandler(a.DELETE),[a.HEAD]:u.createHeadHandler(),[a.OPTIONS]:u.createOptionsHandler()}}static createHeadHandler(){return async(e,t)=>{await u.registerInjectFactories(),await u.loadImports();const s=new u(e,a.HEAD,t);await s.requestHooks.appRequest(e,a.HEAD);const r=await s.match.bind(s)();return new Response(null,{status:r.status,statusText:r.statusText,headers:r.headers})}}static createOptionsHandler(){return async e=>{await u.registerInjectFactories();const t=this.corsOrigins,r=e.headers.get("origin"),n=s.options();if(!t.length||!r)return n;const i=new Headers(n.headers);return t.includes("*")?i.set("Access-Control-Allow-Origin","*"):t.includes(r)&&(i.set("Access-Control-Allow-Origin",r),i.set("Vary","Origin")),i.set("Access-Control-Allow-Methods","GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS"),i.set("Access-Control-Allow-Headers","Content-Type, Authorization"),i.set("Access-Control-Max-Age","86400"),new Response(null,{status:204,headers:i})}}static register(...e){return e.forEach(e=>this.features.add(e)),this}}u.logger=o.create("Application"),u.features=new Set,u.guards=new Set,u.filters=new Set,u.interceptors=new Set,u.pipes=new Set,u.corsOrigins=[],u.options=c,u.ResponseClass=Response,u.poweredBy="MxWeb",u.initialized=!1,u.initPromise=null,u.shutdownRegistered=!1,u.registryCreated=!1,u.factoriesRegistered=!1;export{u as Application};

package/dist/common.d.ts

@@ -1,4 +1,9 @@
-import { Callback } from "@mxweb/utils";
+/**
+ * Generic callback function type.
+ * @template R - Return type
+ * @template A - Arguments tuple type
+ */
+export type Callback<R = void, A extends any[] = []> = (...args: A) => R;
 /**
  * @fileoverview Common types, interfaces, and utilities used throughout the @mxweb/core framework.
  * This module provides foundational types for dependency injection, routing, and lifecycle management.
@@ -29,7 +34,46 @@ import { Callback } from "@mxweb/utils";
  * }
  * ```
  */
-export interface ApplicationInject {
+/**
+ * Interface for injects that support context switching.
+ * Implement this interface to expose a safe, controlled API via `context.switch()`.
+ *
+ * @template T - The type of object returned by the switch() method
+ *
+ * @remarks
+ * This interface is used to expose a **safe facade** instead of the raw inject instance.
+ * The switch() method should return an object that only exposes safe operations,
+ * hiding dangerous methods like close(), destroy(), or direct state manipulation.
+ *
+ * @example
+ * ```ts
+ * interface DbSwitchable {
+ *   query<T>(sql: string): Promise<T>;
+ *   getRepo<T>(entity: EntityClass<T>): Repository<T>;
+ * }
+ *
+ * class Connection implements ApplicationInject, Switchable<DbSwitchable> {
+ *   private client: DatabaseClient;
+ *
+ *   switch(): DbSwitchable {
+ *     return {
+ *       query: (sql) => this.client.query(sql),
+ *       getRepo: (entity) => this.getRepo(entity),
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface Switchable<T = unknown> {
+    /**
+     * Returns a safe, controlled interface for this inject.
+     * Called by `context.switch()` to get the public API.
+     *
+     * @returns The switched context or utility object
+     */
+    switch(): T;
+}
+export interface ApplicationInject extends Partial<Switchable> {
     /**
      * Called when the inject is initialized (on first request).
      * Use this to establish connections, load resources, or perform async setup.
@@ -62,7 +106,7 @@ export interface ApplicationInject {
  * }
  * ```
  */
-export interface FeatureInject {
+export interface FeatureInject extends Partial<Switchable> {
     /**
      * Called when the feature is loaded.
      * Use this for feature-specific initialization.
@@ -192,6 +236,9 @@ export type RouteNextHandler = () => void;
  * Function type for call handlers used in interceptors.
  * Returns a promise of the handler result.
  *
+ * @deprecated Since v1.1.0, interceptors no longer wrap handlers.
+ * Use `ResponseInterceptorHandler` from `response.ts` instead.
+ *
  * @template T - The type of the resolved value
  */
 export type CallHandler<T = unknown> = () => Promise<T>;