@mxweb/core 1.0.2 → 1.1.0

package/dist/config.d.ts

@@ -272,4 +272,22 @@ export declare class Config implements ApplicationInject {
      * ```
      */
     reset(): void;
+    /**
+     * Returns the Config instance itself for context switching.
+     * Allows accessing Config via `context.switch("config")`.
+     *
+     * @template T - The expected return type (defaults to Config)
+     * @returns The Config instance
+     *
+     * @example
+     * ```ts
+     * // In a controller or service
+     * const config = await this.context.switch<Config>("config");
+     * const dbHost = config.get<string>("db.host");
+     *
+     * // Or access config values directly
+     * const port = config.get<number>("port", 3000);
+     * ```
+     */
+    switch<T = Config>(): T;
 }

package/dist/config.js

@@ -1 +1 @@
-"use strict";class t{static forRoot(r="config"){return s=>{s.set(r,()=>(t.instance||(t.instance=new t),t.instance))}}async onInit(){await t.buildAsync()}static register(r,s){return t.providers.set(r,s),t}static registerAsync(r,s){return t.asyncProviders.set(r,s),t}static build(){if(!t.built){for(const[r,s]of t.providers)t.store.has(r)||t.store.set(r,s());t.built=!0}}static async buildAsync(){if(t.build(),!t.asyncBuilt){for(const[r,s]of t.asyncProviders)t.store.has(r)||t.store.set(r,await s());t.asyncBuilt=!0}}get(r,s){return t.build(),t.store.get(r)??s}async getAsync(r,s){return await t.buildAsync(),t.store.get(r)??s}getOrThrow(r){if(t.build(),!t.store.has(r))throw new Error(`[Config] Config key "${r}" not found`);return t.store.get(r)}async getAsyncOrThrow(r){if(await t.buildAsync(),!t.store.has(r))throw new Error(`[Config] Config key "${r}" not found`);return t.store.get(r)}has(r){return t.store.has(r)||t.providers.has(r)||t.asyncProviders.has(r)}getAll(){return new Map(t.store)}reset(){t.instance=null,t.store.clear(),t.providers.clear(),t.asyncProviders.clear(),t.built=!1,t.asyncBuilt=!1}}t.instance=null,t.store=new Map,t.providers=new Map,t.asyncProviders=new Map,t.built=!1,t.asyncBuilt=!1,exports.Config=t;
+"use strict";class t{static forRoot(r="config"){return s=>{s.set(r,()=>(t.instance||(t.instance=new t),t.instance))}}async onInit(){await t.buildAsync()}static register(r,s){return t.providers.set(r,s),t}static registerAsync(r,s){return t.asyncProviders.set(r,s),t}static build(){if(!t.built){for(const[r,s]of t.providers)t.store.has(r)||t.store.set(r,s());t.built=!0}}static async buildAsync(){if(t.build(),!t.asyncBuilt){for(const[r,s]of t.asyncProviders)t.store.has(r)||t.store.set(r,await s());t.asyncBuilt=!0}}get(r,s){return t.build(),t.store.get(r)??s}async getAsync(r,s){return await t.buildAsync(),t.store.get(r)??s}getOrThrow(r){if(t.build(),!t.store.has(r))throw new Error(`[Config] Config key "${r}" not found`);return t.store.get(r)}async getAsyncOrThrow(r){if(await t.buildAsync(),!t.store.has(r))throw new Error(`[Config] Config key "${r}" not found`);return t.store.get(r)}has(r){return t.store.has(r)||t.providers.has(r)||t.asyncProviders.has(r)}getAll(){return new Map(t.store)}reset(){t.instance=null,t.store.clear(),t.providers.clear(),t.asyncProviders.clear(),t.built=!1,t.asyncBuilt=!1}switch(){return this}}t.instance=null,t.store=new Map,t.providers=new Map,t.asyncProviders=new Map,t.built=!1,t.asyncBuilt=!1,exports.Config=t;

package/dist/config.mjs

@@ -1 +1 @@
-class r{static forRoot(t="config"){return s=>{s.set(t,()=>(r.instance||(r.instance=new r),r.instance))}}async onInit(){await r.buildAsync()}static register(t,s){return r.providers.set(t,s),r}static registerAsync(t,s){return r.asyncProviders.set(t,s),r}static build(){if(!r.built){for(const[t,s]of r.providers)r.store.has(t)||r.store.set(t,s());r.built=!0}}static async buildAsync(){if(r.build(),!r.asyncBuilt){for(const[t,s]of r.asyncProviders)r.store.has(t)||r.store.set(t,await s());r.asyncBuilt=!0}}get(t,s){return r.build(),r.store.get(t)??s}async getAsync(t,s){return await r.buildAsync(),r.store.get(t)??s}getOrThrow(t){if(r.build(),!r.store.has(t))throw new Error(`[Config] Config key "${t}" not found`);return r.store.get(t)}async getAsyncOrThrow(t){if(await r.buildAsync(),!r.store.has(t))throw new Error(`[Config] Config key "${t}" not found`);return r.store.get(t)}has(t){return r.store.has(t)||r.providers.has(t)||r.asyncProviders.has(t)}getAll(){return new Map(r.store)}reset(){r.instance=null,r.store.clear(),r.providers.clear(),r.asyncProviders.clear(),r.built=!1,r.asyncBuilt=!1}}r.instance=null,r.store=new Map,r.providers=new Map,r.asyncProviders=new Map,r.built=!1,r.asyncBuilt=!1;export{r as Config};
+class t{static forRoot(r="config"){return s=>{s.set(r,()=>(t.instance||(t.instance=new t),t.instance))}}async onInit(){await t.buildAsync()}static register(r,s){return t.providers.set(r,s),t}static registerAsync(r,s){return t.asyncProviders.set(r,s),t}static build(){if(!t.built){for(const[r,s]of t.providers)t.store.has(r)||t.store.set(r,s());t.built=!0}}static async buildAsync(){if(t.build(),!t.asyncBuilt){for(const[r,s]of t.asyncProviders)t.store.has(r)||t.store.set(r,await s());t.asyncBuilt=!0}}get(r,s){return t.build(),t.store.get(r)??s}async getAsync(r,s){return await t.buildAsync(),t.store.get(r)??s}getOrThrow(r){if(t.build(),!t.store.has(r))throw new Error(`[Config] Config key "${r}" not found`);return t.store.get(r)}async getAsyncOrThrow(r){if(await t.buildAsync(),!t.store.has(r))throw new Error(`[Config] Config key "${r}" not found`);return t.store.get(r)}has(r){return t.store.has(r)||t.providers.has(r)||t.asyncProviders.has(r)}getAll(){return new Map(t.store)}reset(){t.instance=null,t.store.clear(),t.providers.clear(),t.asyncProviders.clear(),t.built=!1,t.asyncBuilt=!1}switch(){return this}}t.instance=null,t.store=new Map,t.providers=new Map,t.asyncProviders=new Map,t.built=!1,t.asyncBuilt=!1;export{t as Config};

package/dist/decorator.d.ts

@@ -8,7 +8,7 @@
  *
  * @module decorator
  */
-import { ExecuteContext, Filter, Guard, Interceptor } from "./execute";
+import { CoreRequest, ExecuteContext, Filter, Guard, Interceptor } from "./execute";
 import { FeatureInject, Pipe } from "./common";
 /**
  * Result object from decorator functions.
@@ -234,18 +234,25 @@ export declare function QueryParam(key: string): string | undefined;
 /**
  * Extracts the raw Request object.
  *
- * @returns The underlying Request object (NextRequest)
+ * @template T - The specific request type (e.g., NextRequest, Express.Request)
+ * @returns The underlying CoreRequest object, cast to the specified type
  *
  * @example
  * ```ts
+ * // Default (CoreRequest)
  * findAll() {
  *   const request = Request();
  *   const url = request.url;
- *   const method = request.method;
+ * }
+ *
+ * // With specific type (Next.js)
+ * findAll() {
+ *   const request = Request<NextRequest>();
+ *   const nextUrl = request.nextUrl; // ✅ Type-safe
  * }
  * ```
  */
-export declare function Request(): globalThis.Request;
+export declare function Request<T extends CoreRequest = CoreRequest>(): T;
 /**
  * Extracts and parses FormData from the request body.
  *

package/dist/execute.d.ts

@@ -8,10 +8,226 @@
  *
  * @module execute
  */
-import { NextRequest } from "next/server";
 import { ServerResponse } from "./response";
 import { Feature } from "./feature";
-import { ApplicationInject, CallHandler, FeatureInject, InjectEntry, InjectInstanceFactory, InjectRegistry, Pipe, RouteMethod, RouteNextHandler } from "./common";
+import { ApplicationInject, InjectEntry, InjectInstanceFactory, InjectRegistry, Pipe, RouteMethod, RouteNextHandler } from "./common";
+/**
+ * Core request interface defining the minimal contract for HTTP requests.
+ * This abstraction allows @mxweb/core to work with any request implementation
+ * (Next.js, Express, Fastify, etc.) as long as it conforms to this interface.
+ *
+ * @remarks
+ * This interface is designed to be compatible with multiple frameworks:
+ * - **Next.js**: Uses `nextUrl` for query params
+ * - **Express/Fastify**: Uses `url` (string) and `query` (parsed object)
+ * - **Fetch API**: Uses `url` (URL object)
+ *
+ * The framework adapter should populate the appropriate properties.
+ * `switchHttp().query()` will use `nextUrl.searchParams` → `url.searchParams` → `query` fallback.
+ *
+ * @example
+ * ```ts
+ * // Next.js Request is compatible with CoreRequest (uses nextUrl)
+ * const coreReq: CoreRequest = nextRequest;
+ *
+ * // Express Request adapter
+ * const expressReq: CoreRequest = {
+ *   url: "/api/users?page=1",
+ *   query: { page: "1" },
+ *   headers: new Headers(req.headers),
+ *   body: null,
+ *   json: async () => req.body,
+ *   text: async () => JSON.stringify(req.body),
+ *   formData: async () => new FormData(),
+ *   blob: async () => new Blob(),
+ *   arrayBuffer: async () => new ArrayBuffer(0),
+ * };
+ *
+ * // Fetch Request adapter
+ * const fetchReq: CoreRequest = {
+ *   url: new URL("https://example.com/api/users?page=1"),
+ *   headers: request.headers,
+ *   body: request.body,
+ *   json: () => request.json(),
+ *   text: () => request.text(),
+ *   formData: () => request.formData(),
+ *   blob: () => request.blob(),
+ *   arrayBuffer: () => request.arrayBuffer(),
+ * };
+ * ```
+ */
+export interface CoreRequest {
+    /**
+     * The NextURL of the request (Next.js specific).
+     * Used for extracting query parameters in Next.js applications.
+     * Takes priority over `url` when available.
+     */
+    readonly nextUrl?: URL | {
+        readonly searchParams: URLSearchParams;
+    };
+    /**
+     * The URL of the request.
+     * Can be:
+     * - URL object (Fetch API, custom implementations)
+     * - string (Express, Fastify - just the path with query string)
+     */
+    readonly url?: URL | string;
+    /**
+     * Pre-parsed query parameters object (Express/Fastify style).
+     * Used as fallback when `nextUrl` and `url` are not available or don't have searchParams.
+     */
+    readonly query?: Record<string, string | string[] | undefined>;
+    /**
+     * The HTTP headers of the request.
+     * Must be iterable (for use with Object.fromEntries).
+     */
+    readonly headers: Headers;
+    /**
+     * The body of the request as a ReadableStream, or null if no body.
+     */
+    readonly body: ReadableStream<Uint8Array> | null;
+    /**
+     * Parses the request body as JSON.
+     * @returns Promise resolving to the parsed JSON value
+     */
+    json(): Promise<unknown>;
+    /**
+     * Returns the request body as text.
+     * @returns Promise resolving to the body text
+     */
+    text(): Promise<string>;
+    /**
+     * Parses the request body as FormData.
+     * @returns Promise resolving to the FormData
+     */
+    formData(): Promise<FormData>;
+    /**
+     * Returns the request body as a Blob.
+     * @returns Promise resolving to the Blob
+     */
+    blob(): Promise<Blob>;
+    /**
+     * Returns the request body as an ArrayBuffer.
+     * @returns Promise resolving to the ArrayBuffer
+     */
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+/**
+ * Unified search params class that works with multiple input sources.
+ * Provides a consistent API for accessing query parameters regardless of the framework.
+ *
+ * @remarks
+ * This class abstracts the differences between:
+ * - URLSearchParams (Fetch API, Next.js)
+ * - Query object (Express, Fastify)
+ * - Query string (raw URL parsing)
+ *
+ * @example
+ * ```ts
+ * // From URLSearchParams
+ * const params = new CoreSearchParams(new URLSearchParams("page=1&limit=10"));
+ *
+ * // From object (Express style)
+ * const params = new CoreSearchParams({ page: "1", limit: "10" });
+ *
+ * // From query string
+ * const params = new CoreSearchParams("page=1&limit=10");
+ *
+ * // Usage
+ * params.get("page"); // "1"
+ * params.getNumber("page"); // 1
+ * params.getAll("tags"); // ["a", "b"]
+ * params.toObject(); // { page: "1", limit: "10" }
+ * ```
+ */
+export declare class CoreSearchParams {
+    private readonly params;
+    /**
+     * Creates a new CoreSearchParams instance.
+     *
+     * @param source - The source of query parameters:
+     *   - URLSearchParams: Used directly
+     *   - Record<string, string | string[] | undefined>: Object with query values
+     *   - string: Query string (with or without leading "?")
+     *   - undefined/null: Empty params
+     */
+    constructor(source?: URLSearchParams | Record<string, string | string[] | undefined> | string | null);
+    /**
+     * Gets the first value for a parameter.
+     * @param name - Parameter name
+     * @returns The value or null if not found
+     */
+    get(name: string): string | null;
+    /**
+     * Gets all values for a parameter.
+     * @param name - Parameter name
+     * @returns Array of values (empty if not found)
+     */
+    getAll(name: string): string[];
+    /**
+     * Checks if a parameter exists.
+     * @param name - Parameter name
+     * @returns true if the parameter exists
+     */
+    has(name: string): boolean;
+    /**
+     * Gets a parameter as a number.
+     * @param name - Parameter name
+     * @param defaultValue - Default value if not found or not a valid number
+     * @returns The parsed number or default value
+     */
+    getNumber(name: string, defaultValue?: number): number | undefined;
+    /**
+     * Gets a parameter as a boolean.
+     * Treats "true", "1", "yes" as true; "false", "0", "no" as false.
+     * @param name - Parameter name
+     * @param defaultValue - Default value if not found
+     * @returns The parsed boolean or default value
+     */
+    getBoolean(name: string, defaultValue?: boolean): boolean | undefined;
+    /**
+     * Returns an iterator of all parameter names.
+     */
+    keys(): IterableIterator<string>;
+    /**
+     * Returns an iterator of all parameter values.
+     */
+    values(): IterableIterator<string>;
+    /**
+     * Returns an iterator of all [name, value] pairs.
+     */
+    entries(): IterableIterator<[string, string]>;
+    /**
+     * Executes a callback for each parameter.
+     */
+    forEach(callback: (value: string, key: string, parent: URLSearchParams) => void): void;
+    /**
+     * Converts to a plain object (first value only for each key).
+     * @returns Object with string values
+     */
+    toObject(): Record<string, string>;
+    /**
+     * Converts to a plain object (all values as arrays).
+     * @returns Object with string array values
+     */
+    toObjectAll(): Record<string, string[]>;
+    /**
+     * Returns the underlying URLSearchParams.
+     */
+    toURLSearchParams(): URLSearchParams;
+    /**
+     * Converts to query string (without leading "?").
+     */
+    toString(): string;
+    /**
+     * Returns the number of parameters (counting duplicates).
+     */
+    get size(): number;
+    /**
+     * Makes the class iterable.
+     */
+    [Symbol.iterator](): IterableIterator<[string, string]>;
+}
 /**
  * Container for route-level metadata, guards, filters, interceptors, and pipes.
  * Created from decorator results and attached to each route.
@@ -83,8 +299,8 @@ export declare class Reflect {
  * Created for each request and available throughout the request lifecycle.
  */
 export interface RequestContext {
-    /** The incoming Next.js request */
-    req: NextRequest;
+    /** The incoming HTTP request (CoreRequest-compatible) */
+    req: CoreRequest;
     /** The response builder */
     res: ServerResponse;
     /** HTTP method of the request */
@@ -176,25 +392,31 @@ export declare class ExecuteContext {
     /**
      * Retrieves a global inject by name with lazy initialization.
      * If the inject hasn't been initialized yet, calls the factory to create it.
+     * Returns the result of switch() if available, otherwise the raw instance.
      *
-     * @template T - Expected type of the inject (must extend ApplicationInject)
+     * @template T - Expected return type (from switch() or the inject itself)
      * @param name - The name of the inject to retrieve
-     * @returns Promise resolving to the inject instance or undefined if not found
+     * @returns Promise resolving to the switched value or undefined if not found
      *
      * @example
      * ```ts
-     * const db = await context.getInject<DatabaseConnection>("db");
+     * // If inject implements switch(), returns the switched value
+     * const db = await context.getInject<DatabaseClient>("db");
+     * const users = await db.query("SELECT * FROM users");
+     *
+     * // If inject doesn't implement switch(), returns the inject instance
      * const config = await context.getInject<Config>("config");
      * ```
      */
-    getInject<T extends ApplicationInject = ApplicationInject>(name: string): Promise<T | undefined>;
+    getInject<T = unknown>(name: string): Promise<T | undefined>;
     /**
      * Retrieves a global inject synchronously (only if already initialized).
      * Returns undefined if the inject hasn't been initialized yet.
+     * Returns the result of switch() if available, otherwise the raw instance.
      *
-     * @template T - Expected type of the inject (must extend ApplicationInject)
+     * @template T - Expected return type (from switch() or the inject itself)
      * @param name - The name of the inject to retrieve
-     * @returns The inject instance or undefined if not found/not initialized
+     * @returns The switched value or undefined if not found/not initialized
      *
      * @example
      * ```ts
@@ -202,7 +424,7 @@ export declare class ExecuteContext {
      * const config = context.getInjectSync<Config>("config");
      * ```
      */
-    getInjectSync<T extends ApplicationInject = ApplicationInject>(name: string): T | undefined;
+    getInjectSync<T = unknown>(name: string): T | undefined;
     /**
      * Checks if a global inject factory exists by name.
      *
@@ -285,8 +507,8 @@ export declare class ExecuteContext {
      * ```
      */
     switchHttp(): {
-        /** Returns the Next.js request object */
-        getRequest: () => NextRequest;
+        /** Returns the CoreRequest object, optionally cast to a specific type */
+        getRequest: <T extends CoreRequest = CoreRequest>() => T;
         /** Returns the ServerResponse builder */
         getResponse: () => ServerResponse;
         /** Returns the HTTP method */
@@ -297,16 +519,16 @@ export declare class ExecuteContext {
         params: () => Record<string, string>;
         /** Returns wildcard segments */
         wildcards: () => string[];
-        /** Returns query parameters as object */
-        query: () => {
-            [k: string]: string;
-        };
+        /** Returns CoreSearchParams instance for query parameter access */
+        searchParams: () => CoreSearchParams;
+        /** Returns query parameters as plain object (first value only) */
+        query: () => Record<string, string>;
         /** Returns headers as object */
         headers: () => {
             [k: string]: string;
         };
         /** Returns the raw body ReadableStream */
-        body: () => ReadableStream<Uint8Array<ArrayBuffer>> | null;
+        body: () => ReadableStream<Uint8Array<ArrayBufferLike>> | null;
         /** Parses and returns the JSON body */
         json: <T = unknown>() => Promise<T>;
         /** Returns the body as text */
@@ -343,10 +565,11 @@ export declare class ExecuteContext {
     /**
      * Retrieves a feature-local inject by name with lazy initialization.
      * Falls back to global injects if not found in the feature.
+     * Returns the result of switch() if available, otherwise the raw instance.
      *
-     * @template T - Expected type of the inject (must extend FeatureInject)
+     * @template T - Expected return type (from switch() or the inject itself)
      * @param name - The name of the inject to retrieve
-     * @returns Promise resolving to the inject instance or undefined if not found
+     * @returns Promise resolving to the switched value or undefined if not found
      *
      * @example
      * ```ts
@@ -354,14 +577,15 @@ export declare class ExecuteContext {
      * const repo = await context.getLocalInject<ProductRepository>("productRepo");
      * ```
      */
-    getLocalInject<T extends FeatureInject>(name: string): Promise<T | undefined>;
+    getLocalInject<T = unknown>(name: string): Promise<T | undefined>;
     /**
      * Retrieves a feature-local inject synchronously (only if already initialized).
      * Falls back to global injects if not found in the feature.
+     * Returns the result of switch() if available, otherwise the raw instance.
      *
-     * @template T - Expected type of the inject (must extend FeatureInject)
+     * @template T - Expected return type (from switch() or the inject itself)
      * @param name - The name of the inject to retrieve
-     * @returns The inject instance or undefined if not found/not initialized
+     * @returns The switched value or undefined if not found/not initialized
      *
      * @example
      * ```ts
@@ -369,7 +593,51 @@ export declare class ExecuteContext {
      * const repo = context.getLocalInjectSync<ProductRepository>("productRepo");
      * ```
      */
-    getLocalInjectSync<T extends FeatureInject>(name: string): T | undefined;
+    getLocalInjectSync<T = unknown>(name: string): T | undefined;
+    /**
+     * Retrieves an inject by name and calls its switch() method.
+     * Searches in feature injects first (priority), then falls back to global injects.
+     *
+     * @template T - Expected return type of the switch() method
+     * @param name - The name of the inject to switch to
+     * @returns Promise resolving to the result of the inject's switch() method
+     * @throws {Error} If the inject is not found or doesn't have a switch() method
+     *
+     * @example
+     * ```ts
+     * // In a controller or service
+     * const db = await this.context.switch<DatabaseClient>("db");
+     * const users = await db.query("SELECT * FROM users");
+     *
+     * // The inject must implement switch():
+     * class Connection implements ApplicationInject {
+     *   switch<T = DatabaseClient>(): T {
+     *     return this.client as T;
+     *   }
+     * }
+     * ```
+     */
+    switch<T = unknown>(name: string): Promise<T>;
+    /**
+     * Retrieves an inject by name and calls its switch() method (synchronous version).
+     * Only works if the inject has already been initialized.
+     * Searches in feature injects first (priority), then falls back to global injects.
+     *
+     * @template T - Expected return type of the switch() method
+     * @param name - The name of the inject to switch to
+     * @returns The result of the inject's switch() method, or undefined if not initialized
+     * @throws {Error} If the inject exists but doesn't have a switch() method
+     *
+     * @example
+     * ```ts
+     * // Only use when you're sure the inject is already initialized
+     * const db = this.context.switchSync<DatabaseClient>("db");
+     * if (db) {
+     *   const users = await db.query("SELECT * FROM users");
+     * }
+     * ```
+     */
+    switchSync<T = unknown>(name: string): T | undefined;
 }
 /**
  * Interface for guard classes that determine if a request should proceed.
@@ -474,48 +742,34 @@ export interface ExceptionFilter<Response = unknown> {
  */
 export type Filter<Response = unknown> = new (...args: unknown[]) => ExceptionFilter<Response>;
 /**
- * Interface for interceptor classes that wrap handler execution.
- * Interceptors can transform requests/responses, add caching, logging, etc.
+ * Constructor type for response interceptor classes.
+ * Interceptors transform the CoreResponse after the handler returns.
  *
- * @template T - The type of the handler result
+ * @template T - The type of the response data
+ *
+ * @remarks
+ * The old `InterceptorHandler` interface with `intercept(context, next)` is deprecated.
+ * Use `ResponseInterceptorHandler` from `response.ts` instead for the new pattern.
  *
  * @example
  * ```ts
- * 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;
+ * import { ResponseInterceptorHandler, CoreResponse } from "@mxweb/core";
+ *
+ * class LoggingInterceptor implements ResponseInterceptorHandler {
+ *   transform(response: CoreResponse): CoreResponse {
+ *     console.log(`Response: ${response.status} ${response.body.message}`);
+ *     return response;
  *   }
  * }
  *
- * class CacheInterceptor implements InterceptorHandler {
- *   async intercept(context: ExecuteContext, next: CallHandler): Promise<unknown> {
- *     const key = getCacheKey(context);
- *     const cached = await cache.get(key);
- *     if (cached) return cached;
- *
- *     const result = await next();
- *     await cache.set(key, result);
- *     return result;
+ * class CacheHeaderInterceptor implements ResponseInterceptorHandler {
+ *   transform(response: CoreResponse): CoreResponse {
+ *     if (response.status >= 200 && response.status < 300) {
+ *       response.headers.set("Cache-Control", "max-age=3600");
+ *     }
+ *     return response;
  *   }
  * }
  * ```
  */
-export interface InterceptorHandler<T = unknown> {
-    /**
-     * Intercepts the handler execution.
-     *
-     * @param context - The execution context for the current request
-     * @param next - Function to call the next interceptor or handler
-     * @returns The (possibly transformed) result
-     */
-    intercept(context: ExecuteContext, next: CallHandler<T>): Promise<T>;
-}
-/**
- * Constructor type for interceptor classes.
- *
- * @template T - The type of the handler result
- */
-export type Interceptor<T = unknown> = new (...args: unknown[]) => InterceptorHandler<T>;
+export type Interceptor<T = unknown> = new (...args: unknown[]) => import("./response").ResponseInterceptorHandler<T>;

package/dist/execute.js

@@ -1 +1 @@
-"use strict";var t=require("async_hooks");class e{constructor(){this.storage=new t.AsyncLocalStorage,this._injections=new Map,this._registry=null}static get instance(){return e._instance||(e._instance=new e),e._instance}setRegistry(t){this._registry=t}get injections(){return this._injections}setInject(t,e){this._injections.set(t,{factory:e})}async getInject(t){const e=this._injections.get(t);if(e){if(!e.instance){if(!this._registry)throw new Error(`[ExecuteContext] Registry not set. Cannot initialize inject '${t}'.`);e.instance=await e.factory(this._registry),"function"==typeof e.instance.onInit&&await e.instance.onInit()}return e.instance}}getInjectSync(t){const e=this._injections.get(t);return e?.instance}hasInject(t){return this._injections.has(t)}isInjectInitialized(t){const e=this._injections.get(t);return!!e?.instance}clearInjections(){this._injections.clear()}run(t,e){return this.storage.run(t,e)}getContext(){return this.storage.getStore()}getContextOrThrow(){const t=this.storage.getStore();if(!t)throw new Error("[ExecuteContext] No context available. Make sure you're inside a request handler.");return t}switchHttp(){const t=this.getContextOrThrow();return{getRequest:()=>t.req,getResponse:()=>t.res,getMethod:()=>t.method,getPath:()=>t.path,params:()=>t.params,wildcards:()=>t.wildcards,query:()=>Object.fromEntries(t.req.nextUrl.searchParams),headers:()=>Object.fromEntries(t.req.headers),body:()=>t.req.body,json:()=>t.req.json(),text:()=>t.req.text(),formData:()=>t.req.formData(),blob:()=>t.req.blob(),arrayBuffer:()=>t.req.arrayBuffer()}}getReflect(){return this.getContext()?.reflect}getMetadata(t){return this.getContext()?.reflect.getMetadata(t)}getFeature(){return this.getContext()?.feature}async getLocalInject(t){const e=this.getContext()?.feature;return e?.hasInject(t)?e.getInject(t):this.getInject(t)}getLocalInjectSync(t){const e=this.getContext()?.feature;return e?.hasInject(t)?e.getInjectSync(t):this.getInjectSync(t)}}e._instance=null,exports.ExecuteContext=e,exports.Reflect=class{constructor(t,e,r,n,s){this.metadata=t,this.guards=e,this.filters=r,this.interceptors=n,this.pipes=s}getGuards(){return this.guards}getFilters(){return this.filters}getInterceptors(){return this.interceptors}getPipes(){return this.pipes}getMetadata(t){return this.metadata.get(t)}getAllMetadata(){return this.metadata}};
+"use strict";var t=require("async_hooks");class e{constructor(t){if(t)if(t instanceof URLSearchParams)this.params=t;else if("string"==typeof t){const e=t.startsWith("?")?t.slice(1):t;this.params=new URLSearchParams(e)}else{this.params=new URLSearchParams;for(const[e,r]of Object.entries(t))if(void 0!==r)if(Array.isArray(r))for(const t of r)this.params.append(e,t);else this.params.set(e,r)}else this.params=new URLSearchParams}get(t){return this.params.get(t)}getAll(t){return this.params.getAll(t)}has(t){return this.params.has(t)}getNumber(t,e){const r=this.params.get(t);if(null===r)return e;const n=Number(r);return isNaN(n)?e:n}getBoolean(t,e){const r=this.params.get(t);if(null===r)return e;const n=r.toLowerCase();return!!["true","1","yes"].includes(n)||!["false","0","no"].includes(n)&&e}keys(){return this.params.keys()}values(){return this.params.values()}entries(){return this.params.entries()}forEach(t){this.params.forEach(t)}toObject(){const t={};for(const e of this.params.keys())t[e]=this.params.get(e);return t}toObjectAll(){const t={};for(const e of this.params.keys())t[e]||(t[e]=this.params.getAll(e));return t}toURLSearchParams(){return this.params}toString(){return this.params.toString()}get size(){let t=0;return this.params.forEach(()=>t++),t}[Symbol.iterator](){return this.params.entries()}}class r{constructor(){this.storage=new t.AsyncLocalStorage,this._injections=new Map,this._registry=null}static get instance(){return r._instance||(r._instance=new r),r._instance}setRegistry(t){this._registry=t}get injections(){return this._injections}setInject(t,e){this._injections.set(t,{factory:e})}async getInject(t){const e=this._injections.get(t);if(e){if(!e.instance){if(!this._registry)throw new Error(`[ExecuteContext] Registry not set. Cannot initialize inject '${t}'.`);e.instance=await e.factory(this._registry),"function"==typeof e.instance.onInit&&await e.instance.onInit()}return"function"==typeof e.instance.switch?e.instance.switch():e.instance}}getInjectSync(t){const e=this._injections.get(t);if(e?.instance)return"function"==typeof e.instance.switch?e.instance.switch():e.instance}hasInject(t){return this._injections.has(t)}isInjectInitialized(t){const e=this._injections.get(t);return!!e?.instance}clearInjections(){this._injections.clear()}run(t,e){return this.storage.run(t,e)}getContext(){return this.storage.getStore()}getContextOrThrow(){const t=this.storage.getStore();if(!t)throw new Error("[ExecuteContext] No context available. Make sure you're inside a request handler.");return t}switchHttp(){const t=this.getContextOrThrow();let r=null;const n=()=>(r||(r=(()=>{if(t.req.nextUrl){const r=(t.req.nextUrl,URL,t.req.nextUrl.searchParams);return new e(r)}if(t.req.url instanceof URL)return new e(t.req.url.searchParams);if("string"==typeof t.req.url&&t.req.url.includes("?")){const r=t.req.url.split("?")[1];return new e(r)}return t.req.query?new e(t.req.query):new e})()),r);return{getRequest:()=>t.req,getResponse:()=>t.res,getMethod:()=>t.method,getPath:()=>t.path,params:()=>t.params,wildcards:()=>t.wildcards,searchParams:n,query:()=>n().toObject(),headers:()=>Object.fromEntries(t.req.headers),body:()=>t.req.body,json:()=>t.req.json(),text:()=>t.req.text(),formData:()=>t.req.formData(),blob:()=>t.req.blob(),arrayBuffer:()=>t.req.arrayBuffer()}}getReflect(){return this.getContext()?.reflect}getMetadata(t){return this.getContext()?.reflect.getMetadata(t)}getFeature(){return this.getContext()?.feature}async getLocalInject(t){const e=this.getContext()?.feature;if(e?.hasInject(t)){const r=await e.getInject(t);if(!r)return;return"function"==typeof r.switch?r.switch():r}return this.getInject(t)}getLocalInjectSync(t){const e=this.getContext()?.feature;if(e?.hasInject(t)){const r=e.getInjectSync(t);if(!r)return;return"function"==typeof r.switch?r.switch():r}return this.getInjectSync(t)}async switch(t){const e=this.getContext()?.feature;if(e?.hasInject(t)){return await e.getInject(t)}const r=this._injections.get(t);if(!r)throw new Error(`[ExecuteContext] Inject '${t}' not found.`);if(!r.instance){if(!this._registry)throw new Error(`[ExecuteContext] Registry not set. Cannot initialize inject '${t}'.`);r.instance=await r.factory(this._registry),"function"==typeof r.instance.onInit&&await r.instance.onInit()}if("function"!=typeof r.instance.switch)throw new Error(`[ExecuteContext] Inject '${t}' does not implement switch() method.`);return r.instance.switch()}switchSync(t){const e=this.getContext()?.feature;let r;if(r=e?.hasInject(t)?e.getInjectSync(t):this.getInjectSync(t),r){if("function"!=typeof r.switch)throw new Error(`[ExecuteContext] Inject '${t}' does not implement switch() method.`);return r.switch()}}}r._instance=null,exports.CoreSearchParams=e,exports.ExecuteContext=r,exports.Reflect=class{constructor(t,e,r,n,s){this.metadata=t,this.guards=e,this.filters=r,this.interceptors=n,this.pipes=s}getGuards(){return this.guards}getFilters(){return this.filters}getInterceptors(){return this.interceptors}getPipes(){return this.pipes}getMetadata(t){return this.metadata.get(t)}getAllMetadata(){return this.metadata}};

package/dist/execute.mjs

@@ -1 +1 @@
-import{AsyncLocalStorage as t}from"async_hooks";class e{constructor(t,e,n,r,s){this.metadata=t,this.guards=e,this.filters=n,this.interceptors=r,this.pipes=s}getGuards(){return this.guards}getFilters(){return this.filters}getInterceptors(){return this.interceptors}getPipes(){return this.pipes}getMetadata(t){return this.metadata.get(t)}getAllMetadata(){return this.metadata}}class n{constructor(){this.storage=new t,this._injections=new Map,this._registry=null}static get instance(){return n._instance||(n._instance=new n),n._instance}setRegistry(t){this._registry=t}get injections(){return this._injections}setInject(t,e){this._injections.set(t,{factory:e})}async getInject(t){const e=this._injections.get(t);if(e){if(!e.instance){if(!this._registry)throw new Error(`[ExecuteContext] Registry not set. Cannot initialize inject '${t}'.`);e.instance=await e.factory(this._registry),"function"==typeof e.instance.onInit&&await e.instance.onInit()}return e.instance}}getInjectSync(t){const e=this._injections.get(t);return e?.instance}hasInject(t){return this._injections.has(t)}isInjectInitialized(t){const e=this._injections.get(t);return!!e?.instance}clearInjections(){this._injections.clear()}run(t,e){return this.storage.run(t,e)}getContext(){return this.storage.getStore()}getContextOrThrow(){const t=this.storage.getStore();if(!t)throw new Error("[ExecuteContext] No context available. Make sure you're inside a request handler.");return t}switchHttp(){const t=this.getContextOrThrow();return{getRequest:()=>t.req,getResponse:()=>t.res,getMethod:()=>t.method,getPath:()=>t.path,params:()=>t.params,wildcards:()=>t.wildcards,query:()=>Object.fromEntries(t.req.nextUrl.searchParams),headers:()=>Object.fromEntries(t.req.headers),body:()=>t.req.body,json:()=>t.req.json(),text:()=>t.req.text(),formData:()=>t.req.formData(),blob:()=>t.req.blob(),arrayBuffer:()=>t.req.arrayBuffer()}}getReflect(){return this.getContext()?.reflect}getMetadata(t){return this.getContext()?.reflect.getMetadata(t)}getFeature(){return this.getContext()?.feature}async getLocalInject(t){const e=this.getContext()?.feature;return e?.hasInject(t)?e.getInject(t):this.getInject(t)}getLocalInjectSync(t){const e=this.getContext()?.feature;return e?.hasInject(t)?e.getInjectSync(t):this.getInjectSync(t)}}n._instance=null;export{n as ExecuteContext,e as Reflect};
+import{AsyncLocalStorage as t}from"async_hooks";class e{constructor(t){if(t)if(t instanceof URLSearchParams)this.params=t;else if("string"==typeof t){const e=t.startsWith("?")?t.slice(1):t;this.params=new URLSearchParams(e)}else{this.params=new URLSearchParams;for(const[e,r]of Object.entries(t))if(void 0!==r)if(Array.isArray(r))for(const t of r)this.params.append(e,t);else this.params.set(e,r)}else this.params=new URLSearchParams}get(t){return this.params.get(t)}getAll(t){return this.params.getAll(t)}has(t){return this.params.has(t)}getNumber(t,e){const r=this.params.get(t);if(null===r)return e;const n=Number(r);return isNaN(n)?e:n}getBoolean(t,e){const r=this.params.get(t);if(null===r)return e;const n=r.toLowerCase();return!!["true","1","yes"].includes(n)||!["false","0","no"].includes(n)&&e}keys(){return this.params.keys()}values(){return this.params.values()}entries(){return this.params.entries()}forEach(t){this.params.forEach(t)}toObject(){const t={};for(const e of this.params.keys())t[e]=this.params.get(e);return t}toObjectAll(){const t={};for(const e of this.params.keys())t[e]||(t[e]=this.params.getAll(e));return t}toURLSearchParams(){return this.params}toString(){return this.params.toString()}get size(){let t=0;return this.params.forEach(()=>t++),t}[Symbol.iterator](){return this.params.entries()}}class r{constructor(t,e,r,n,s){this.metadata=t,this.guards=e,this.filters=r,this.interceptors=n,this.pipes=s}getGuards(){return this.guards}getFilters(){return this.filters}getInterceptors(){return this.interceptors}getPipes(){return this.pipes}getMetadata(t){return this.metadata.get(t)}getAllMetadata(){return this.metadata}}class n{constructor(){this.storage=new t,this._injections=new Map,this._registry=null}static get instance(){return n._instance||(n._instance=new n),n._instance}setRegistry(t){this._registry=t}get injections(){return this._injections}setInject(t,e){this._injections.set(t,{factory:e})}async getInject(t){const e=this._injections.get(t);if(e){if(!e.instance){if(!this._registry)throw new Error(`[ExecuteContext] Registry not set. Cannot initialize inject '${t}'.`);e.instance=await e.factory(this._registry),"function"==typeof e.instance.onInit&&await e.instance.onInit()}return"function"==typeof e.instance.switch?e.instance.switch():e.instance}}getInjectSync(t){const e=this._injections.get(t);if(e?.instance)return"function"==typeof e.instance.switch?e.instance.switch():e.instance}hasInject(t){return this._injections.has(t)}isInjectInitialized(t){const e=this._injections.get(t);return!!e?.instance}clearInjections(){this._injections.clear()}run(t,e){return this.storage.run(t,e)}getContext(){return this.storage.getStore()}getContextOrThrow(){const t=this.storage.getStore();if(!t)throw new Error("[ExecuteContext] No context available. Make sure you're inside a request handler.");return t}switchHttp(){const t=this.getContextOrThrow();let r=null;const n=()=>(r||(r=(()=>{if(t.req.nextUrl){const r=(t.req.nextUrl,URL,t.req.nextUrl.searchParams);return new e(r)}if(t.req.url instanceof URL)return new e(t.req.url.searchParams);if("string"==typeof t.req.url&&t.req.url.includes("?")){const r=t.req.url.split("?")[1];return new e(r)}return t.req.query?new e(t.req.query):new e})()),r);return{getRequest:()=>t.req,getResponse:()=>t.res,getMethod:()=>t.method,getPath:()=>t.path,params:()=>t.params,wildcards:()=>t.wildcards,searchParams:n,query:()=>n().toObject(),headers:()=>Object.fromEntries(t.req.headers),body:()=>t.req.body,json:()=>t.req.json(),text:()=>t.req.text(),formData:()=>t.req.formData(),blob:()=>t.req.blob(),arrayBuffer:()=>t.req.arrayBuffer()}}getReflect(){return this.getContext()?.reflect}getMetadata(t){return this.getContext()?.reflect.getMetadata(t)}getFeature(){return this.getContext()?.feature}async getLocalInject(t){const e=this.getContext()?.feature;if(e?.hasInject(t)){const r=await e.getInject(t);if(!r)return;return"function"==typeof r.switch?r.switch():r}return this.getInject(t)}getLocalInjectSync(t){const e=this.getContext()?.feature;if(e?.hasInject(t)){const r=e.getInjectSync(t);if(!r)return;return"function"==typeof r.switch?r.switch():r}return this.getInjectSync(t)}async switch(t){const e=this.getContext()?.feature;if(e?.hasInject(t)){return await e.getInject(t)}const r=this._injections.get(t);if(!r)throw new Error(`[ExecuteContext] Inject '${t}' not found.`);if(!r.instance){if(!this._registry)throw new Error(`[ExecuteContext] Registry not set. Cannot initialize inject '${t}'.`);r.instance=await r.factory(this._registry),"function"==typeof r.instance.onInit&&await r.instance.onInit()}if("function"!=typeof r.instance.switch)throw new Error(`[ExecuteContext] Inject '${t}' does not implement switch() method.`);return r.instance.switch()}switchSync(t){const e=this.getContext()?.feature;let r;if(r=e?.hasInject(t)?e.getInjectSync(t):this.getInjectSync(t),r){if("function"!=typeof r.switch)throw new Error(`[ExecuteContext] Inject '${t}' does not implement switch() method.`);return r.switch()}}}n._instance=null;export{e as CoreSearchParams,n as ExecuteContext,r as Reflect};

package/dist/feature.d.ts

@@ -10,7 +10,7 @@
 import { ControllerConstructor } from "./controller";
 import { RouteMatched, Router } from "./router";
 import { FeatureHooks, FeatureHooksOptions } from "./hooks";
-import { FeatureInject, FeatureInjectFactory, RouteMethod } from "./common";
+import { FeatureInjectFactory, RouteMethod } from "./common";
 /**
  * Type for feature-specific dependency injection configuration.
  * Array of factory functions that register injects.
@@ -208,25 +208,27 @@ export declare class Feature {
     /**
      * Retrieves a feature-specific inject by name (async - lazy initialization).
      * If instance doesn't exist, calls factory to create it and runs onFeature().
+     * Returns the result of switch() if available, otherwise the raw instance.
      *
-     * @template T - Expected type of the inject (must extend FeatureInject)
+     * @template T - Expected return type (from switch() or the inject itself)
      * @param name - The name of the inject to retrieve
-     * @returns Promise resolving to the inject instance or undefined if not found
+     * @returns Promise resolving to the switched value or undefined if not found
      *
      * @example
      * ```ts
      * const repo = await feature.getInject<ProductRepository>("productRepo");
      * ```
      */
-    getInject<T extends FeatureInject>(name: string): Promise<T | undefined>;
+    getInject<T = unknown>(name: string): Promise<T | undefined>;
     /**
      * Retrieves a feature-specific inject synchronously (only if already initialized).
+     * Returns the result of switch() if available, otherwise the raw instance.
      *
-     * @template T - Expected type of the inject (must extend FeatureInject)
+     * @template T - Expected return type (from switch() or the inject itself)
      * @param name - The name of the inject to retrieve
-     * @returns The inject instance or undefined if not found/not initialized
+     * @returns The switched value or undefined if not found/not initialized
      */
-    getInjectSync<T extends FeatureInject>(name: string): T | undefined;
+    getInjectSync<T = unknown>(name: string): T | undefined;
     /**
      * Checks if a feature-specific inject factory is registered by name.
      *

package/dist/feature.js

@@ -1 +1 @@
-"use strict";var t=require("./hooks.js");class e{constructor(e,s,i){this.options=e,this.ControllerContructor=s,this.router=i,this.routeMatched=null,this.controller=null,this.injects=new Map,this.factoriesRegistered=!1,this.importsLoaded=!1,this.hooks=new t.FeatureHooks(this.options),this.registry=this.createInjectRegistry()}createInjectRegistry(){return{get:t=>this.getInject(t),set:(t,e)=>{this.injects.set(t,{factory:e})}}}static create(t){return new e(t,t.controller,t.router)}async loadImports(){if(this.importsLoaded)return;this.importsLoaded=!0;const{imports:t}=this.options;if(!t)return;"function"==typeof t&&await t()}async loadInjects(){if(await this.loadImports(),this.factoriesRegistered)return;this.factoriesRegistered=!0;const{injects:t}=this.options;if(t&&t.length)for(const e of t)await e(this.registry)}async destroyInjects(){for(const[t,e]of this.injects)if(e.instance&&e.instance.onFeatureDestroy)try{await e.instance.onFeatureDestroy()}catch(t){}this.injects.clear(),this.factoriesRegistered=!1}async getInject(t){const e=this.injects.get(t);if(e)return e.instance||(e.instance=await e.factory(this.registry),"function"==typeof e.instance.onFeature&&await e.instance.onFeature()),e.instance}getInjectSync(t){const e=this.injects.get(t);return e?.instance}hasInject(t){return this.injects.has(t)}isInjectInitialized(t){const e=this.injects.get(t);return!!e?.instance}getController(){if(!this.controller){const t=this.ControllerContructor;this.controller=new t}return this.controller}getHooks(){return this.hooks}matchRoute(t,e){return this.routeMatched=this.router.match(t,e),this.routeMatched}}exports.Feature=e;
+"use strict";var t=require("./hooks.js");class e{constructor(e,s,i){this.options=e,this.ControllerContructor=s,this.router=i,this.routeMatched=null,this.controller=null,this.injects=new Map,this.factoriesRegistered=!1,this.importsLoaded=!1,this.hooks=new t.FeatureHooks(this.options),this.registry=this.createInjectRegistry()}createInjectRegistry(){return{get:t=>this.getInject(t),set:(t,e)=>{this.injects.set(t,{factory:e})}}}static create(t){return new e(t,t.controller,t.router)}async loadImports(){if(this.importsLoaded)return;this.importsLoaded=!0;const{imports:t}=this.options;if(!t)return;"function"==typeof t&&await t()}async loadInjects(){if(await this.loadImports(),this.factoriesRegistered)return;this.factoriesRegistered=!0;const{injects:t}=this.options;if(t&&t.length)for(const e of t)await e(this.registry)}async destroyInjects(){for(const[t,e]of this.injects)if(e.instance&&e.instance.onFeatureDestroy)try{await e.instance.onFeatureDestroy()}catch(t){}this.injects.clear(),this.factoriesRegistered=!1}async getInject(t){const e=this.injects.get(t);if(e)return e.instance||(e.instance=await e.factory(this.registry),"function"==typeof e.instance.onFeature&&await e.instance.onFeature()),"function"==typeof e.instance.switch?e.instance.switch():e.instance}getInjectSync(t){const e=this.injects.get(t);if(e?.instance)return"function"==typeof e.instance.switch?e.instance.switch():e.instance}hasInject(t){return this.injects.has(t)}isInjectInitialized(t){const e=this.injects.get(t);return!!e?.instance}getController(){if(!this.controller){const t=this.ControllerContructor;this.controller=new t}return this.controller}getHooks(){return this.hooks}matchRoute(t,e){return this.routeMatched=this.router.match(t,e),this.routeMatched}}exports.Feature=e;