@mxweb/core 1.0.2 → 1.2.0

package/dist/execute.d.ts

@@ -8,10 +8,225 @@
  *
  * @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, FeatureContext, Filter, Guard, InjectEntry, InjectInstanceFactory, InjectRegistry, Interceptor, 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.
@@ -48,12 +263,12 @@ export declare class Reflect {
      * Returns the set of exception filter classes attached to this route.
      * @returns Set of filter class constructors
      */
-    getFilters(): Set<Filter<unknown>>;
+    getFilters(): Set<Filter>;
     /**
      * Returns the set of interceptor classes attached to this route.
      * @returns Set of interceptor class constructors
      */
-    getInterceptors(): Set<Interceptor<unknown>>;
+    getInterceptors(): Set<Interceptor>;
     /**
      * Returns the set of pipe classes attached to this route.
      * @returns Set of pipe class constructors
@@ -83,8 +298,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 */
@@ -98,7 +313,7 @@ export interface RequestContext {
     /** Route metadata and decorators */
     reflect: Reflect;
     /** The feature that matched this request */
-    feature: Feature;
+    feature: FeatureContext;
 }
 /**
  * Request-scoped execution context using AsyncLocalStorage.
@@ -176,25 +391,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 +423,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 +506,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 +518,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 */
@@ -339,14 +560,15 @@ export declare class ExecuteContext {
      *
      * @returns The Feature instance or undefined if no context
      */
-    getFeature(): Feature | undefined;
+    getFeature<Feature extends FeatureContext>(): Feature | undefined;
     /**
      * 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 +576,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,35 +592,52 @@ export declare class ExecuteContext {
      * const repo = context.getLocalInjectSync<ProductRepository>("productRepo");
      * ```
      */
-    getLocalInjectSync<T extends FeatureInject>(name: string): T | undefined;
-}
-/**
- * Interface for guard classes that determine if a request should proceed.
- * Guards are used for authorization, authentication, and access control.
- *
- * @example
- * ```ts
- * class AuthGuard implements CanActivate {
- *   canActivate(context: ExecuteContext): boolean {
- *     const token = context.switchHttp().headers()["authorization"];
- *     return !!token && isValidToken(token);
- *   }
- * }
- * ```
- */
-export interface CanActivate {
+    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>;
     /**
-     * Determines if the request should be allowed to proceed.
+     * 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
      *
-     * @param context - The execution context for the current request
-     * @returns true to allow, false to deny (results in 403 Forbidden)
+     * @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");
+     * }
+     * ```
      */
-    canActivate(context: ExecuteContext): boolean | Promise<boolean>;
+    switchSync<T = unknown>(name: string): T | undefined;
 }
-/**
- * Constructor type for guard classes.
- */
-export type Guard = new (...args: unknown[]) => CanActivate;
 /**
  * Function type for route action handlers (inline handlers).
  *
@@ -437,85 +677,3 @@ export type RouteHandler<Data = unknown> = (context: ExecuteContext) => Data;
  * ```
  */
 export type RouteMiddleware = (context: ExecuteContext, next: RouteNextHandler) => void | Promise<void>;
-/**
- * Interface for exception filter classes that handle errors.
- * Filters can transform exceptions into custom responses.
- *
- * @template Response - The type of response the filter returns
- *
- * @example
- * ```ts
- * class HttpExceptionFilter implements ExceptionFilter<Response> {
- *   catch(exception: unknown, context: ExecuteContext): Response {
- *     if (exception instanceof HttpError) {
- *       return new Response(JSON.stringify({ error: exception.message }), {
- *         status: exception.statusCode,
- *       });
- *     }
- *     throw exception; // Re-throw if not handled
- *   }
- * }
- * ```
- */
-export interface ExceptionFilter<Response = unknown> {
-    /**
-     * Handles an exception and optionally returns a response.
-     *
-     * @param exception - The thrown exception
-     * @param context - The execution context for the current request
-     * @returns A response to send, or re-throw to pass to next filter
-     */
-    catch(exception: unknown, context: ExecuteContext): Response | Promise<Response>;
-}
-/**
- * Constructor type for exception filter classes.
- *
- * @template Response - The type of response the filter returns
- */
-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.
- *
- * @template T - The type of the handler result
- *
- * @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;
- *   }
- * }
- *
- * 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;
- *   }
- * }
- * ```
- */
-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>;

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};