@navios/core 0.7.0 → 0.7.1

package/lib/{use-guards.decorator-DdvUhB03.cjs.map → use-guards.decorator-B6q_N0sf.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"use-guards.decorator-DdvUhB03.cjs","names":["EndpointMetadataKey","Symbol","getAllEndpointMetadata","context","metadata","Set","Error","getEndpointMetadata","target","endpointMetadata","Array","from","find","item","classMethod","name","newMetadata","url","successStatusCode","adapterToken","headers","httpMethod","config","guards","customAttributes","Map","add","getAllEndpointMetadata","ControllerMetadataKey","Symbol","getControllerMetadata","target","context","metadata","endpointsMetadata","newMetadata","endpoints","guards","Set","customAttributes","Map","Error","extractControllerMetadata","hasControllerMetadata","ModuleMetadataKey","Symbol","getModuleMetadata","target","context","metadata","newMetadata","controllers","Set","imports","guards","customAttributes","Map","Error","extractModuleMetadata","name","hasModuleMetadata","Injectable","InjectableScope","InjectionToken","getControllerMetadata","Controller","guards","target","context","kind","Error","token","create","metadata","controllerMetadata","guard","Array","from","reverse","add","scope","Request","InjectionToken","EndpointAdapterToken","create","InjectionToken","ExecutionContextInjectionToken","ExecutionContext","create","InjectionToken","HttpAdapterToken","create","InjectionToken","MultipartAdapterToken","create","InjectionToken","Reply","create","InjectionToken","Request","create","InjectionToken","StreamAdapterToken","create","InjectionToken","XmlStreamAdapterToken","create","getEndpointMetadata","EndpointAdapterToken","Endpoint","endpoint","target","context","kind","Error","config","metadata","endpointMetadata","url","method","adapterToken","classMethod","name","httpMethod","getEndpointMetadata","Header","name","value","target","context","kind","Error","metadata","headers","getEndpointMetadata","HttpCode","code","target","context","kind","Error","metadata","successStatusCode","Injectable","InjectableScope","InjectionToken","getModuleMetadata","Module","controllers","imports","guards","target","context","kind","Error","token","create","moduleMetadata","controller","add","importedModule","guard","Array","from","reverse","scope","Singleton","getEndpointMetadata","MultipartAdapterToken","Multipart","endpoint","target","context","Error","kind","config","metadata","endpointMetadata","url","method","adapterToken","classMethod","name","httpMethod","getEndpointMetadata","StreamAdapterToken","Stream","endpoint","target","context","Error","kind","config","metadata","endpointMetadata","url","method","adapterToken","classMethod","name","httpMethod","getControllerMetadata","getEndpointMetadata","UseGuards","guards","target","context","kind","controllerMetadata","guard","reverse","add","endpointMetadata","Error"],"sources":["../src/metadata/handler.metadata.mts","../src/metadata/controller.metadata.mts","../src/metadata/module.metadata.mts","../src/decorators/controller.decorator.mts","../src/tokens/endpoint-adapter.token.mts","../src/tokens/execution-context.token.mts","../src/tokens/http-adapter.token.mts","../src/tokens/multipart-adapter.token.mts","../src/tokens/reply.token.mts","../src/tokens/request.token.mts","../src/tokens/stream-adapter.token.mts","../src/tokens/xml-stream-adapter.token.mts","../src/decorators/endpoint.decorator.mts","../src/decorators/header.decorator.mts","../src/decorators/http-code.decorator.mts","../src/decorators/module.decorator.mts","../src/decorators/multipart.decorator.mts","../src/decorators/stream.decorator.mts","../src/decorators/use-guards.decorator.mts"],"sourcesContent":["import type { HttpMethod } from '@navios/builder'\nimport type { ClassTypeWithInstance, InjectionToken } from '@navios/di'\n\nimport type {\n  AbstractHttpHandlerAdapterInterface,\n  CanActivate,\n  HttpHeader,\n} from '../interfaces/index.mjs'\n\nexport const EndpointMetadataKey = Symbol('EndpointMetadataKey')\n\nexport interface HandlerMetadata<Config = null> {\n  classMethod: string\n  url: string\n  successStatusCode: number\n  adapterToken:\n    | InjectionToken<AbstractHttpHandlerAdapterInterface, undefined>\n    | ClassTypeWithInstance<AbstractHttpHandlerAdapterInterface>\n    | null\n  headers: Partial<Record<HttpHeader, number | string | string[] | undefined>>\n  httpMethod: HttpMethod\n  config: Config\n  guards: Set<\n    ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>\n  >\n  customAttributes: Map<string | symbol, any>\n}\n\nexport function getAllEndpointMetadata(\n  context: ClassMethodDecoratorContext | ClassDecoratorContext,\n): Set<HandlerMetadata<any>> {\n  if (context.metadata) {\n    const metadata = context.metadata[EndpointMetadataKey] as\n      | Set<HandlerMetadata>\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      context.metadata[EndpointMetadataKey] = new Set<HandlerMetadata<any>>()\n      return context.metadata[EndpointMetadataKey] as Set<HandlerMetadata<any>>\n    }\n  }\n  throw new Error('[Navios] Wrong environment.')\n}\n\nexport function getEndpointMetadata<Config = any>(\n  target: Function,\n  context: ClassMethodDecoratorContext,\n): HandlerMetadata<Config> {\n  if (context.metadata) {\n    const metadata = getAllEndpointMetadata(context)\n    if (metadata) {\n      const endpointMetadata = Array.from(metadata).find(\n        (item) => item.classMethod === target.name,\n      )\n      if (endpointMetadata) {\n        return endpointMetadata\n      } else {\n        const newMetadata: HandlerMetadata<Config> = {\n          classMethod: target.name,\n          url: '',\n          successStatusCode: 200,\n          adapterToken: null,\n          headers: {},\n          httpMethod: 'GET',\n          // @ts-expect-error We are using a generic type here\n          config: null,\n          guards: new Set<\n            | ClassTypeWithInstance<CanActivate>\n            | InjectionToken<CanActivate, undefined>\n          >(),\n          customAttributes: new Map<string | symbol, any>(),\n        }\n        metadata.add(newMetadata)\n        return newMetadata\n      }\n    }\n  }\n  throw new Error('[Navios] Wrong environment.')\n}\n","import type {\n  ClassType,\n  ClassTypeWithInstance,\n  InjectionToken,\n} from '@navios/di'\n\nimport type { CanActivate } from '../interfaces/index.mjs'\nimport type { HandlerMetadata } from './handler.metadata.mjs'\n\nimport { getAllEndpointMetadata } from './handler.metadata.mjs'\n\nexport const ControllerMetadataKey = Symbol('ControllerMetadataKey')\n\nexport interface ControllerMetadata {\n  endpoints: Set<HandlerMetadata>\n  guards: Set<\n    ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>\n  >\n  customAttributes: Map<string | symbol, any>\n}\n\nexport function getControllerMetadata(\n  target: ClassType,\n  context: ClassDecoratorContext,\n): ControllerMetadata {\n  if (context.metadata) {\n    const metadata = context.metadata[ControllerMetadataKey] as\n      | ControllerMetadata\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      const endpointsMetadata = getAllEndpointMetadata(context)\n      const newMetadata: ControllerMetadata = {\n        endpoints: endpointsMetadata,\n        guards: new Set<\n          | ClassTypeWithInstance<CanActivate>\n          | InjectionToken<CanActivate, undefined>\n        >(),\n        customAttributes: new Map<string | symbol, any>(),\n      }\n      context.metadata[ControllerMetadataKey] = newMetadata\n      // @ts-expect-error We add a custom metadata key to the target\n      target[ControllerMetadataKey] = newMetadata\n      return newMetadata\n    }\n  }\n  throw new Error('[Navios] Wrong environment.')\n}\n\nexport function extractControllerMetadata(\n  target: ClassType,\n): ControllerMetadata {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ControllerMetadataKey] as\n    | ControllerMetadata\n    | undefined\n  if (!metadata) {\n    throw new Error(\n      '[Navios] Controller metadata not found. Make sure to use @Controller decorator.',\n    )\n  }\n  return metadata\n}\n\nexport function hasControllerMetadata(target: ClassType): boolean {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ControllerMetadataKey] as\n    | ControllerMetadata\n    | undefined\n  return !!metadata\n}\n","import type {\n  ClassType,\n  ClassTypeWithInstance,\n  InjectionToken,\n} from '@navios/di'\n\nimport type { CanActivate } from '../index.mjs'\n\nexport const ModuleMetadataKey = Symbol('ControllerMetadataKey')\n\nexport interface ModuleMetadata {\n  controllers: Set<ClassType>\n  imports: Set<ClassType>\n  guards: Set<\n    ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>\n  >\n  customAttributes: Map<string | symbol, any>\n}\n\nexport function getModuleMetadata(\n  target: ClassType,\n  context: ClassDecoratorContext,\n): ModuleMetadata {\n  if (context.metadata) {\n    const metadata = context.metadata[ModuleMetadataKey] as\n      | ModuleMetadata\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      const newMetadata: ModuleMetadata = {\n        controllers: new Set<ClassType>(),\n        imports: new Set<ClassType>(),\n        guards: new Set<\n          | ClassTypeWithInstance<CanActivate>\n          | InjectionToken<CanActivate, undefined>\n        >(),\n        customAttributes: new Map<string | symbol, any>(),\n      }\n      context.metadata[ModuleMetadataKey] = newMetadata\n      // @ts-expect-error We add a custom metadata key to the target\n      target[ModuleMetadataKey] = newMetadata\n      return newMetadata\n    }\n  }\n  throw new Error('[Navios] Wrong environment.')\n}\n\nexport function extractModuleMetadata(target: ClassType): ModuleMetadata {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ModuleMetadataKey] as ModuleMetadata | undefined\n  if (!metadata) {\n    throw new Error(\n      `[Navios] Module metadata not found for ${target.name}. Make sure to use @Module decorator.`,\n    )\n  }\n  return metadata\n}\n\nexport function hasModuleMetadata(target: ClassType): boolean {\n  // @ts-expect-error We add a custom metadata key to the target\n  return !!target[ModuleMetadataKey]\n}\n","import type { ClassType } from '@navios/di'\n\nimport { Injectable, InjectableScope, InjectionToken } from '@navios/di'\n\nimport { getControllerMetadata } from '../metadata/index.mjs'\n\n/**\n * Options for configuring a Navios controller.\n */\nexport interface ControllerOptions {\n  /**\n   * Guards to apply to all endpoints in this controller.\n   * Guards are executed in reverse order (last guard first).\n   */\n  guards?: ClassType[] | Set<ClassType>\n}\n\n/**\n * Decorator that marks a class as a Navios controller.\n * \n * Controllers handle HTTP requests and define endpoints.\n * They are request-scoped by default, meaning a new instance is created for each request.\n * \n * @param options - Controller configuration options\n * @returns A class decorator\n * \n * @example\n * ```typescript\n * @Controller({ guards: [AuthGuard] })\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   async getUser(request: EndpointParams<typeof getUserEndpoint>) {\n *     // Handle request\n *   }\n * }\n * ```\n */\nexport function Controller({ guards }: ControllerOptions = {}) {\n  return function (target: ClassType, context: ClassDecoratorContext) {\n    if (context.kind !== 'class') {\n      throw new Error(\n        '[Navios] @Controller decorator can only be used on classes.',\n      )\n    }\n    const token = InjectionToken.create(target)\n    if (context.metadata) {\n      const controllerMetadata = getControllerMetadata(target, context)\n      if (guards) {\n        for (const guard of Array.from(guards).reverse()) {\n          controllerMetadata.guards.add(guard)\n        }\n      }\n    }\n    return Injectable({\n      token,\n      scope: InjectableScope.Request,\n    })(target, context)\n  }\n}\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpHandlerAdapterInterface } from '../interfaces/index.mjs'\n\nexport const EndpointAdapterToken =\n  InjectionToken.create<AbstractHttpHandlerAdapterInterface>(\n    'EndpointAdapterToken',\n  )\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractExecutionContext } from '../interfaces/index.mjs'\n\nexport const ExecutionContextInjectionToken = 'ExecutionContextInjectionToken'\n\nexport const ExecutionContext = InjectionToken.create<AbstractExecutionContext>(\n  ExecutionContextInjectionToken,\n)\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpAdapterInterface } from '../interfaces/index.mjs'\n\nexport const HttpAdapterToken =\n  InjectionToken.create<AbstractHttpAdapterInterface<any, any, any, any>>(\n    'HttpAdapterToken',\n  )\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpHandlerAdapterInterface } from '../interfaces/index.mjs'\n\nexport const MultipartAdapterToken =\n  InjectionToken.create<AbstractHttpHandlerAdapterInterface>(\n    'MultipartAdapterToken',\n  )\n","import { InjectionToken } from '@navios/di'\n\nexport const Reply = InjectionToken.create<any>('ReplyToken')\n","import { InjectionToken } from '@navios/di'\n\nexport const Request = InjectionToken.create<any>('RequestToken')\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpHandlerAdapterInterface } from '../interfaces/index.mjs'\n\nexport const StreamAdapterToken =\n  InjectionToken.create<AbstractHttpHandlerAdapterInterface>(\n    'StreamAdapterToken',\n  )\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpHandlerAdapterInterface } from '../interfaces/index.mjs'\n\nexport const XmlStreamAdapterToken =\n  InjectionToken.create<AbstractHttpHandlerAdapterInterface>(\n    'XmlStreamAdapterToken',\n  )\n","import type {\n  BaseEndpointConfig,\n  EndpointFunctionArgs,\n  HttpMethod,\n  Util_FlatObject,\n} from '@navios/builder'\nimport type { z, ZodType } from 'zod/v4'\n\nimport { ZodDiscriminatedUnion } from 'zod/v4'\n\nimport { getEndpointMetadata } from '../metadata/index.mjs'\nimport { EndpointAdapterToken } from '../tokens/index.mjs'\n\n/**\n * Extracts the typed parameters for an endpoint handler function.\n *\n * This utility type extracts URL parameters, query parameters, and request body\n * from an endpoint declaration and flattens them into a single object.\n *\n * @typeParam EndpointDeclaration - The endpoint declaration from @navios/builder\n *\n * @example\n * ```typescript\n * const getUserEndpoint = api.declareEndpoint({\n *   method: 'get',\n *   url: '/users/$userId',\n *   querySchema: z.object({ include: z.string().optional() }),\n *   responseSchema: z.object({ id: z.string(), name: z.string() }),\n * })\n *\n * @Endpoint(getUserEndpoint)\n * async getUser(request: EndpointParams<typeof getUserEndpoint>) {\n *   // request.urlParams.userId is typed as string\n *   // request.query.include is typed as string | undefined\n * }\n * ```\n */\nexport type EndpointParams<\n  EndpointDeclaration extends {\n    config: BaseEndpointConfig<any, any, any, any, any>\n  },\n  Url extends string = EndpointDeclaration['config']['url'],\n  QuerySchema = EndpointDeclaration['config']['querySchema'],\n> = QuerySchema extends ZodType\n  ? EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          QuerySchema,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, QuerySchema, undefined, true>>\n  : EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          undefined,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, undefined, undefined, true>>\n\n/**\n * Extracts the typed return value for an endpoint handler function.\n *\n * This utility type extracts the response schema from an endpoint declaration\n * and returns the appropriate Promise type.\n *\n * @typeParam EndpointDeclaration - The endpoint declaration from @navios/builder\n *\n * @example\n * ```typescript\n * const getUserEndpoint = api.declareEndpoint({\n *   method: 'get',\n *   url: '/users/$userId',\n *   responseSchema: z.object({ id: z.string(), name: z.string() }),\n * })\n *\n * @Endpoint(getUserEndpoint)\n * async getUser(request: EndpointParams<typeof getUserEndpoint>): EndpointResult<typeof getUserEndpoint> {\n *   return { id: '1', name: 'John' } // Type-checked against responseSchema\n * }\n * ```\n */\nexport type EndpointResult<\n  EndpointDeclaration extends {\n    config: BaseEndpointConfig<any, any, any, any, any>\n  },\n> =\n  EndpointDeclaration['config']['responseSchema'] extends ZodDiscriminatedUnion<\n    infer Options\n  >\n    ? Promise<z.input<Options[number]>>\n    : Promise<z.input<EndpointDeclaration['config']['responseSchema']>>\n\n/**\n * Decorator that marks a method as an HTTP endpoint.\n *\n * The endpoint must be defined using @navios/builder's `declareEndpoint` method.\n * This ensures type safety and consistency between client and server.\n *\n * @param endpoint - The endpoint declaration from @navios/builder\n * @returns A method decorator\n *\n * @example\n * ```typescript\n * import { builder } from '@navios/builder'\n *\n * const api = builder()\n * const getUserEndpoint = api.declareEndpoint({\n *   method: 'get',\n *   url: '/users/$userId',\n *   responseSchema: z.object({ id: z.string(), name: z.string() }),\n * })\n *\n * @Controller()\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   async getUser(request: EndpointParams<typeof getUserEndpoint>) {\n *     const { userId } = request.urlParams\n *     return { id: userId, name: 'John' }\n *   }\n * }\n * ```\n */\nexport function Endpoint<\n  Method extends HttpMethod = HttpMethod,\n  Url extends string = string,\n  QuerySchema = undefined,\n  ResponseSchema extends ZodType = ZodType,\n  RequestSchema = ZodType,\n>(endpoint: {\n  config: BaseEndpointConfig<\n    Method,\n    Url,\n    QuerySchema,\n    ResponseSchema,\n    RequestSchema\n  >\n}) {\n  return (\n    target: (\n      params: QuerySchema extends ZodType\n        ? RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema, true>\n          : EndpointFunctionArgs<Url, QuerySchema, undefined, true>\n        : RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, undefined, RequestSchema, true>\n          : EndpointFunctionArgs<Url, undefined, undefined, true>,\n    ) => Promise<z.input<ResponseSchema>>,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (context.kind !== 'method') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on methods.',\n      )\n    }\n    const config = endpoint.config\n    if (context.metadata) {\n      let endpointMetadata = getEndpointMetadata<BaseEndpointConfig>(\n        target,\n        context,\n      )\n      if (endpointMetadata.config && endpointMetadata.config.url) {\n        throw new Error(\n          `[Navios] Endpoint ${config.method} ${config.url} already exists. Please use a different method or url.`,\n        )\n      }\n      // @ts-expect-error We don't need to set correctly in the metadata\n      endpointMetadata.config = config\n      endpointMetadata.adapterToken = EndpointAdapterToken\n      endpointMetadata.classMethod = target.name\n      endpointMetadata.httpMethod = config.method\n      endpointMetadata.url = config.url\n    }\n    return target\n  }\n}\n","import type { HttpHeader } from '../interfaces/index.mjs'\n\nimport { getEndpointMetadata } from '../metadata/index.mjs'\n\n/**\n * Decorator that sets a custom HTTP response header for an endpoint.\n * \n * @param name - The header name (e.g., 'Content-Type', 'Cache-Control')\n * @param value - The header value (string, number, or array of strings)\n * @returns A method decorator\n * \n * @example\n * ```typescript\n * @Controller()\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   @Header('Cache-Control', 'max-age=3600')\n *   async getUser() {\n *     return { id: '1', name: 'John' }\n *   }\n * }\n * ```\n */\nexport function Header(name: HttpHeader, value: string | number | string[]) {\n  return <T extends Function>(\n    target: T,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (context.kind !== 'method') {\n      throw new Error('[Navios] Header decorator can only be used on methods.')\n    }\n    const metadata = getEndpointMetadata(target, context)\n\n    metadata.headers[name] = value\n\n    return target\n  }\n}\n","import { getEndpointMetadata } from '../metadata/index.mjs'\n\n/**\n * Decorator that sets a custom HTTP status code for successful responses.\n * \n * By default, endpoints return 200 OK. Use this decorator to return a different status code.\n * \n * @param code - The HTTP status code to return (e.g., 201, 204, 202)\n * @returns A method decorator\n * \n * @example\n * ```typescript\n * @Controller()\n * export class UserController {\n *   @Endpoint(createUserEndpoint)\n *   @HttpCode(201)\n *   async createUser() {\n *     return { id: '1', name: 'John' }\n *   }\n * }\n * ```\n */\nexport function HttpCode(code: number) {\n  return <T extends Function>(\n    target: T,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (context.kind !== 'method') {\n      throw new Error(\n        '[Navios] HttpCode decorator can only be used on methods.',\n      )\n    }\n    const metadata = getEndpointMetadata(target, context)\n    metadata.successStatusCode = code\n\n    return target\n  }\n}\n","import type { ClassType } from '@navios/di'\n\nimport { Injectable, InjectableScope, InjectionToken } from '@navios/di'\n\nimport { getModuleMetadata } from '../metadata/index.mjs'\n\n/**\n * Options for configuring a Navios module.\n */\nexport interface ModuleOptions {\n  /**\n   * Controllers to register in this module.\n   * Controllers handle HTTP requests and define endpoints.\n   */\n  controllers?: ClassType[] | Set<ClassType>\n  /**\n   * Other modules to import into this module.\n   * Imported modules' controllers and services become available.\n   */\n  imports?: ClassType[] | Set<ClassType>\n  /**\n   * Guards to apply to all controllers in this module.\n   * Guards are executed in reverse order (last guard first).\n   */\n  guards?: ClassType[] | Set<ClassType>\n}\n\n/**\n * Decorator that marks a class as a Navios module.\n * \n * Modules are the basic building blocks of a Navios application.\n * They organize controllers, services, and other modules into logical units.\n * \n * @param options - Module configuration options\n * @returns A class decorator\n * \n * @example\n * ```typescript\n * @Module({\n *   controllers: [UserController, AuthController],\n *   imports: [DatabaseModule],\n *   guards: [AuthGuard],\n * })\n * export class AppModule {}\n * ```\n */\nexport function Module(\n  { controllers = [], imports = [], guards = [] }: ModuleOptions = {\n    controllers: [],\n    imports: [],\n    guards: [],\n  },\n) {\n  return (target: ClassType, context: ClassDecoratorContext) => {\n    if (context.kind !== 'class') {\n      throw new Error('[Navios] @Module decorator can only be used on classes.')\n    }\n    // Register the module in the service locator\n    const token = InjectionToken.create(target)\n    const moduleMetadata = getModuleMetadata(target, context)\n    for (const controller of controllers) {\n      moduleMetadata.controllers.add(controller)\n    }\n    for (const importedModule of imports) {\n      moduleMetadata.imports.add(importedModule)\n    }\n    for (const guard of Array.from(guards).reverse()) {\n      moduleMetadata.guards.add(guard)\n    }\n\n    return Injectable({\n      token,\n      scope: InjectableScope.Singleton,\n    })(target, context)\n  }\n}\n","import type {\n  BaseEndpointConfig,\n  EndpointFunctionArgs,\n  HttpMethod,\n  Util_FlatObject,\n} from '@navios/builder'\nimport type { z, ZodObject, ZodType } from 'zod/v4'\n\nimport { ZodDiscriminatedUnion } from 'zod/v4'\n\nimport { getEndpointMetadata } from '../metadata/index.mjs'\nimport { MultipartAdapterToken } from '../tokens/index.mjs'\n\n/**\n * Extracts the typed parameters for a multipart endpoint handler function.\n * \n * Similar to `EndpointParams`, but specifically for multipart/form-data endpoints.\n * \n * @typeParam EndpointDeclaration - The endpoint declaration from @navios/builder\n */\nexport type MultipartParams<\n  EndpointDeclaration extends {\n    config: BaseEndpointConfig<any, any, any, any, any>\n  },\n  Url extends string = EndpointDeclaration['config']['url'],\n  QuerySchema = EndpointDeclaration['config']['querySchema'],\n> = QuerySchema extends ZodObject\n  ? EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          QuerySchema,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, QuerySchema, undefined, true>>\n  : EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          undefined,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, undefined, undefined, true>>\n\n/**\n * Extracts the typed return value for a multipart endpoint handler function.\n * \n * @typeParam EndpointDeclaration - The endpoint declaration from @navios/builder\n */\nexport type MultipartResult<\n  EndpointDeclaration extends {\n    config: BaseEndpointConfig<any, any, any, any, any>\n  },\n> =\n  EndpointDeclaration['config']['responseSchema'] extends ZodDiscriminatedUnion<\n    infer Options\n  >\n    ? Promise<z.input<Options[number]>>\n    : Promise<z.input<EndpointDeclaration['config']['responseSchema']>>\n\n/**\n * Decorator that marks a method as a multipart/form-data endpoint.\n * \n * Use this decorator for endpoints that handle file uploads or form data.\n * The endpoint must be defined using @navios/builder's `declareMultipart` method.\n * \n * @param endpoint - The multipart endpoint declaration from @navios/builder\n * @returns A method decorator\n * \n * @example\n * ```typescript\n * const uploadFileEndpoint = api.declareMultipart({\n *   method: 'post',\n *   url: '/upload',\n *   requestSchema: z.object({ file: z.instanceof(File) }),\n *   responseSchema: z.object({ url: z.string() }),\n * })\n * \n * @Controller()\n * export class FileController {\n *   @Multipart(uploadFileEndpoint)\n *   async uploadFile(request: MultipartParams<typeof uploadFileEndpoint>) {\n *     const { file } = request.data\n *     // Handle file upload\n *     return { url: 'https://example.com/file.jpg' }\n *   }\n * }\n * ```\n */\nexport function Multipart<\n  Method extends HttpMethod = HttpMethod,\n  Url extends string = string,\n  QuerySchema = undefined,\n  ResponseSchema extends ZodType = ZodType,\n  RequestSchema = ZodType,\n>(endpoint: {\n  config: BaseEndpointConfig<\n    Method,\n    Url,\n    QuerySchema,\n    ResponseSchema,\n    RequestSchema\n  >\n}) {\n  return (\n    target: (\n      params: QuerySchema extends ZodObject\n        ? RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema>\n          : EndpointFunctionArgs<Url, QuerySchema, undefined>\n        : RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, undefined, RequestSchema>\n          : EndpointFunctionArgs<Url, undefined, undefined>,\n    ) => Promise<z.input<ResponseSchema>>,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (typeof target !== 'function') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on functions.',\n      )\n    }\n    if (context.kind !== 'method') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on methods.',\n      )\n    }\n    const config = endpoint.config\n    if (context.metadata) {\n      let endpointMetadata = getEndpointMetadata<BaseEndpointConfig>(\n        target,\n        context,\n      )\n      if (endpointMetadata.config && endpointMetadata.config.url) {\n        throw new Error(\n          `[Navios] Endpoint ${config.method} ${config.url} already exists. Please use a different method or url.`,\n        )\n      }\n      // @ts-expect-error We don't need to set correctly in the metadata\n      endpointMetadata.config = config\n      endpointMetadata.adapterToken = MultipartAdapterToken\n      endpointMetadata.classMethod = target.name\n      endpointMetadata.httpMethod = config.method\n      endpointMetadata.url = config.url\n    }\n    return target\n  }\n}\n","import type {\n  BaseStreamConfig,\n  EndpointFunctionArgs,\n  HttpMethod,\n  Util_FlatObject,\n} from '@navios/builder'\nimport type { ZodObject, ZodType } from 'zod/v4'\n\nimport { getEndpointMetadata } from '../metadata/index.mjs'\nimport { StreamAdapterToken } from '../tokens/index.mjs'\n\n/**\n * Extracts the typed parameters for a stream endpoint handler function.\n * \n * Similar to `EndpointParams`, but specifically for streaming endpoints.\n * \n * @typeParam EndpointDeclaration - The stream endpoint declaration from @navios/builder\n */\nexport type StreamParams<\n  EndpointDeclaration extends {\n    config: BaseStreamConfig<any, any, any, any>\n  },\n  Url extends string = EndpointDeclaration['config']['url'],\n  QuerySchema = EndpointDeclaration['config']['querySchema'],\n> = QuerySchema extends ZodObject\n  ? EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          QuerySchema,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, QuerySchema, undefined, true>>\n  : EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          undefined,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, undefined, undefined, true>>\n\n/**\n * Decorator that marks a method as a streaming endpoint.\n * \n * Use this decorator for endpoints that stream data (e.g., file downloads, SSE).\n * The endpoint must be defined using @navios/builder's `declareStream` method.\n * \n * @param endpoint - The stream endpoint declaration from @navios/builder\n * @returns A method decorator\n * \n * @example\n * ```typescript\n * const downloadFileEndpoint = api.declareStream({\n *   method: 'get',\n *   url: '/files/$fileId',\n * })\n * \n * @Controller()\n * export class FileController {\n *   @Stream(downloadFileEndpoint)\n *   async downloadFile(request: StreamParams<typeof downloadFileEndpoint>, reply: any) {\n *     const { fileId } = request.urlParams\n *     // Stream file data to reply\n *   }\n * }\n * ```\n */\nexport function Stream<\n  Method extends HttpMethod = HttpMethod,\n  Url extends string = string,\n  QuerySchema = undefined,\n  RequestSchema = ZodType,\n>(endpoint: {\n  config: BaseStreamConfig<Method, Url, QuerySchema, RequestSchema>\n}) {\n  return (\n    target: (\n      params: QuerySchema extends ZodObject\n        ? RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema>\n          : EndpointFunctionArgs<Url, QuerySchema, undefined>\n        : RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, undefined, RequestSchema>\n          : EndpointFunctionArgs<Url, undefined, undefined>,\n      reply: any,\n    ) => Promise<void>,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (typeof target !== 'function') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on functions.',\n      )\n    }\n    if (context.kind !== 'method') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on methods.',\n      )\n    }\n    const config = endpoint.config\n    if (context.metadata) {\n      let endpointMetadata = getEndpointMetadata<BaseStreamConfig>(\n        target,\n        context,\n      )\n      if (endpointMetadata.config && endpointMetadata.config.url) {\n        throw new Error(\n          `[Navios] Endpoint ${config.method} ${config.url} already exists. Please use a different method or url.`,\n        )\n      }\n      // @ts-expect-error We don't need to set correctly in the metadata\n      endpointMetadata.config = config\n      endpointMetadata.adapterToken = StreamAdapterToken\n      endpointMetadata.classMethod = target.name\n      endpointMetadata.httpMethod = config.method\n      endpointMetadata.url = config.url\n    }\n    return target\n  }\n}\n","import type {\n  ClassType,\n  ClassTypeWithInstance,\n  InjectionToken,\n} from '@navios/di'\n\nimport type { CanActivate } from '../interfaces/index.mjs'\n\nimport {\n  getControllerMetadata,\n  getEndpointMetadata,\n} from '../metadata/index.mjs'\n\n/**\n * Decorator that applies guards to a controller or endpoint.\n * \n * Guards are used for authentication, authorization, and request validation.\n * They implement the `CanActivate` interface and are executed before the endpoint handler.\n * Guards can be applied at the module, controller, or endpoint level.\n * \n * @param guards - Guard classes or injection tokens to apply\n * @returns A class or method decorator\n * \n * @example\n * ```typescript\n * // Apply to a controller\n * @Controller()\n * @UseGuards(AuthGuard, RoleGuard)\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   async getUser() { }\n * }\n * \n * // Apply to a specific endpoint\n * @Controller()\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   @UseGuards(AuthGuard)\n *   async getUser() { }\n * }\n * ```\n */\nexport function UseGuards(\n  ...guards: (\n    | ClassTypeWithInstance<CanActivate>\n    | InjectionToken<CanActivate, undefined>\n  )[]\n) {\n  return function <T extends Function>(\n    target: T,\n    context: ClassMethodDecoratorContext | ClassDecoratorContext,\n  ): T {\n    if (context.kind === 'class') {\n      const controllerMetadata = getControllerMetadata(\n        target as unknown as ClassType,\n        context,\n      )\n      for (const guard of guards.reverse()) {\n        controllerMetadata.guards.add(guard)\n      }\n    } else if (context.kind === 'method') {\n      const endpointMetadata = getEndpointMetadata(target, context)\n      for (const guard of guards.reverse()) {\n        endpointMetadata.guards.add(guard)\n      }\n    } else {\n      throw new Error(\n        '[Navios] @UseGuards decorator can only be used on classes or methods.',\n      )\n    }\n    return target\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-guards.decorator-B6q_N0sf.cjs","names":["EndpointMetadataKey","Symbol","getAllEndpointMetadata","context","metadata","Set","Error","getEndpointMetadata","target","endpointMetadata","Array","from","find","item","classMethod","name","newMetadata","url","successStatusCode","adapterToken","headers","httpMethod","config","guards","customAttributes","Map","add","getAllEndpointMetadata","ControllerMetadataKey","Symbol","getControllerMetadata","target","context","metadata","endpointsMetadata","newMetadata","endpoints","guards","Set","customAttributes","Map","Error","extractControllerMetadata","hasControllerMetadata","ModuleMetadataKey","Symbol","getModuleMetadata","target","context","metadata","newMetadata","controllers","Set","imports","guards","customAttributes","Map","Error","extractModuleMetadata","name","hasModuleMetadata","Injectable","InjectableScope","InjectionToken","getControllerMetadata","Controller","guards","target","context","kind","Error","token","create","metadata","controllerMetadata","guard","Array","from","reverse","add","scope","Request","InjectionToken","EndpointAdapterToken","create","InjectionToken","ExecutionContextInjectionToken","ExecutionContext","create","InjectionToken","HttpAdapterToken","create","InjectionToken","MultipartAdapterToken","create","InjectionToken","Reply","create","InjectionToken","Request","create","InjectionToken","StreamAdapterToken","create","InjectionToken","XmlStreamAdapterToken","create","getEndpointMetadata","EndpointAdapterToken","Endpoint","endpoint","target","context","kind","Error","config","metadata","endpointMetadata","url","method","adapterToken","classMethod","name","httpMethod","getEndpointMetadata","Header","name","value","target","context","kind","Error","metadata","headers","getEndpointMetadata","HttpCode","code","target","context","kind","Error","metadata","successStatusCode","Injectable","InjectableScope","InjectionToken","getModuleMetadata","Module","controllers","imports","guards","target","context","kind","Error","token","create","moduleMetadata","controller","add","importedModule","guard","Array","from","reverse","scope","Singleton","getEndpointMetadata","MultipartAdapterToken","Multipart","endpoint","target","context","Error","kind","config","metadata","endpointMetadata","url","method","adapterToken","classMethod","name","httpMethod","getEndpointMetadata","StreamAdapterToken","Stream","endpoint","target","context","Error","kind","config","metadata","endpointMetadata","url","method","adapterToken","classMethod","name","httpMethod","getControllerMetadata","getEndpointMetadata","UseGuards","guards","target","context","kind","controllerMetadata","guard","reverse","add","endpointMetadata","Error"],"sources":["../src/metadata/handler.metadata.mts","../src/metadata/controller.metadata.mts","../src/metadata/module.metadata.mts","../src/decorators/controller.decorator.mts","../src/tokens/endpoint-adapter.token.mts","../src/tokens/execution-context.token.mts","../src/tokens/http-adapter.token.mts","../src/tokens/multipart-adapter.token.mts","../src/tokens/reply.token.mts","../src/tokens/request.token.mts","../src/tokens/stream-adapter.token.mts","../src/tokens/xml-stream-adapter.token.mts","../src/decorators/endpoint.decorator.mts","../src/decorators/header.decorator.mts","../src/decorators/http-code.decorator.mts","../src/decorators/module.decorator.mts","../src/decorators/multipart.decorator.mts","../src/decorators/stream.decorator.mts","../src/decorators/use-guards.decorator.mts"],"sourcesContent":["import type { HttpMethod } from '@navios/builder'\nimport type { ClassTypeWithInstance, InjectionToken } from '@navios/di'\n\nimport type {\n  AbstractHttpHandlerAdapterInterface,\n  CanActivate,\n  HttpHeader,\n} from '../interfaces/index.mjs'\n\nexport const EndpointMetadataKey = Symbol('EndpointMetadataKey')\n\nexport interface HandlerMetadata<Config = null> {\n  classMethod: string\n  url: string\n  successStatusCode: number\n  adapterToken:\n    | InjectionToken<AbstractHttpHandlerAdapterInterface, undefined>\n    | ClassTypeWithInstance<AbstractHttpHandlerAdapterInterface>\n    | null\n  headers: Partial<Record<HttpHeader, number | string | string[] | undefined>>\n  httpMethod: HttpMethod\n  config: Config\n  guards: Set<\n    ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>\n  >\n  customAttributes: Map<string | symbol, any>\n}\n\nexport function getAllEndpointMetadata(\n  context: ClassMethodDecoratorContext | ClassDecoratorContext,\n): Set<HandlerMetadata<any>> {\n  if (context.metadata) {\n    const metadata = context.metadata[EndpointMetadataKey] as\n      | Set<HandlerMetadata>\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      context.metadata[EndpointMetadataKey] = new Set<HandlerMetadata<any>>()\n      return context.metadata[EndpointMetadataKey] as Set<HandlerMetadata<any>>\n    }\n  }\n  throw new Error('[Navios] Wrong environment.')\n}\n\nexport function getEndpointMetadata<Config = any>(\n  target: Function,\n  context: ClassMethodDecoratorContext,\n): HandlerMetadata<Config> {\n  if (context.metadata) {\n    const metadata = getAllEndpointMetadata(context)\n    if (metadata) {\n      const endpointMetadata = Array.from(metadata).find(\n        (item) => item.classMethod === target.name,\n      )\n      if (endpointMetadata) {\n        return endpointMetadata\n      } else {\n        const newMetadata: HandlerMetadata<Config> = {\n          classMethod: target.name,\n          url: '',\n          successStatusCode: 200,\n          adapterToken: null,\n          headers: {},\n          httpMethod: 'GET',\n          // @ts-expect-error We are using a generic type here\n          config: null,\n          guards: new Set<\n            | ClassTypeWithInstance<CanActivate>\n            | InjectionToken<CanActivate, undefined>\n          >(),\n          customAttributes: new Map<string | symbol, any>(),\n        }\n        metadata.add(newMetadata)\n        return newMetadata\n      }\n    }\n  }\n  throw new Error('[Navios] Wrong environment.')\n}\n","import type {\n  ClassType,\n  ClassTypeWithInstance,\n  InjectionToken,\n} from '@navios/di'\n\nimport type { CanActivate } from '../interfaces/index.mjs'\nimport type { HandlerMetadata } from './handler.metadata.mjs'\n\nimport { getAllEndpointMetadata } from './handler.metadata.mjs'\n\nexport const ControllerMetadataKey = Symbol('ControllerMetadataKey')\n\nexport interface ControllerMetadata {\n  endpoints: Set<HandlerMetadata>\n  guards: Set<\n    ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>\n  >\n  customAttributes: Map<string | symbol, any>\n}\n\nexport function getControllerMetadata(\n  target: ClassType,\n  context: ClassDecoratorContext,\n): ControllerMetadata {\n  if (context.metadata) {\n    const metadata = context.metadata[ControllerMetadataKey] as\n      | ControllerMetadata\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      const endpointsMetadata = getAllEndpointMetadata(context)\n      const newMetadata: ControllerMetadata = {\n        endpoints: endpointsMetadata,\n        guards: new Set<\n          | ClassTypeWithInstance<CanActivate>\n          | InjectionToken<CanActivate, undefined>\n        >(),\n        customAttributes: new Map<string | symbol, any>(),\n      }\n      context.metadata[ControllerMetadataKey] = newMetadata\n      // @ts-expect-error We add a custom metadata key to the target\n      target[ControllerMetadataKey] = newMetadata\n      return newMetadata\n    }\n  }\n  throw new Error('[Navios] Wrong environment.')\n}\n\nexport function extractControllerMetadata(\n  target: ClassType,\n): ControllerMetadata {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ControllerMetadataKey] as\n    | ControllerMetadata\n    | undefined\n  if (!metadata) {\n    throw new Error(\n      '[Navios] Controller metadata not found. Make sure to use @Controller decorator.',\n    )\n  }\n  return metadata\n}\n\nexport function hasControllerMetadata(target: ClassType): boolean {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ControllerMetadataKey] as\n    | ControllerMetadata\n    | undefined\n  return !!metadata\n}\n","import type {\n  ClassType,\n  ClassTypeWithInstance,\n  InjectionToken,\n} from '@navios/di'\n\nimport type { CanActivate } from '../index.mjs'\n\nexport const ModuleMetadataKey = Symbol('ControllerMetadataKey')\n\nexport interface ModuleMetadata {\n  controllers: Set<ClassType>\n  imports: Set<ClassType>\n  guards: Set<\n    ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>\n  >\n  customAttributes: Map<string | symbol, any>\n}\n\nexport function getModuleMetadata(\n  target: ClassType,\n  context: ClassDecoratorContext,\n): ModuleMetadata {\n  if (context.metadata) {\n    const metadata = context.metadata[ModuleMetadataKey] as\n      | ModuleMetadata\n      | undefined\n    if (metadata) {\n      return metadata\n    } else {\n      const newMetadata: ModuleMetadata = {\n        controllers: new Set<ClassType>(),\n        imports: new Set<ClassType>(),\n        guards: new Set<\n          | ClassTypeWithInstance<CanActivate>\n          | InjectionToken<CanActivate, undefined>\n        >(),\n        customAttributes: new Map<string | symbol, any>(),\n      }\n      context.metadata[ModuleMetadataKey] = newMetadata\n      // @ts-expect-error We add a custom metadata key to the target\n      target[ModuleMetadataKey] = newMetadata\n      return newMetadata\n    }\n  }\n  throw new Error('[Navios] Wrong environment.')\n}\n\nexport function extractModuleMetadata(target: ClassType): ModuleMetadata {\n  // @ts-expect-error We add a custom metadata key to the target\n  const metadata = target[ModuleMetadataKey] as ModuleMetadata | undefined\n  if (!metadata) {\n    throw new Error(\n      `[Navios] Module metadata not found for ${target.name}. Make sure to use @Module decorator.`,\n    )\n  }\n  return metadata\n}\n\nexport function hasModuleMetadata(target: ClassType): boolean {\n  // @ts-expect-error We add a custom metadata key to the target\n  return !!target[ModuleMetadataKey]\n}\n","import type { ClassType } from '@navios/di'\n\nimport { Injectable, InjectableScope, InjectionToken } from '@navios/di'\n\nimport { getControllerMetadata } from '../metadata/index.mjs'\n\n/**\n * Options for configuring a Navios controller.\n */\nexport interface ControllerOptions {\n  /**\n   * Guards to apply to all endpoints in this controller.\n   * Guards are executed in reverse order (last guard first).\n   */\n  guards?: ClassType[] | Set<ClassType>\n}\n\n/**\n * Decorator that marks a class as a Navios controller.\n * \n * Controllers handle HTTP requests and define endpoints.\n * They are request-scoped by default, meaning a new instance is created for each request.\n * \n * @param options - Controller configuration options\n * @returns A class decorator\n * \n * @example\n * ```typescript\n * @Controller({ guards: [AuthGuard] })\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   async getUser(request: EndpointParams<typeof getUserEndpoint>) {\n *     // Handle request\n *   }\n * }\n * ```\n */\nexport function Controller({ guards }: ControllerOptions = {}) {\n  return function (target: ClassType, context: ClassDecoratorContext) {\n    if (context.kind !== 'class') {\n      throw new Error(\n        '[Navios] @Controller decorator can only be used on classes.',\n      )\n    }\n    const token = InjectionToken.create(target)\n    if (context.metadata) {\n      const controllerMetadata = getControllerMetadata(target, context)\n      if (guards) {\n        for (const guard of Array.from(guards).reverse()) {\n          controllerMetadata.guards.add(guard)\n        }\n      }\n    }\n    return Injectable({\n      token,\n      scope: InjectableScope.Request,\n    })(target, context)\n  }\n}\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpHandlerAdapterInterface } from '../interfaces/index.mjs'\n\nexport const EndpointAdapterToken =\n  InjectionToken.create<AbstractHttpHandlerAdapterInterface>(\n    'EndpointAdapterToken',\n  )\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractExecutionContext } from '../interfaces/index.mjs'\n\nexport const ExecutionContextInjectionToken = 'ExecutionContextInjectionToken'\n\nexport const ExecutionContext = InjectionToken.create<AbstractExecutionContext>(\n  ExecutionContextInjectionToken,\n)\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpAdapterInterface } from '../interfaces/index.mjs'\n\nexport const HttpAdapterToken =\n  InjectionToken.create<AbstractHttpAdapterInterface<any, any, any, any>>(\n    'HttpAdapterToken',\n  )\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpHandlerAdapterInterface } from '../interfaces/index.mjs'\n\nexport const MultipartAdapterToken =\n  InjectionToken.create<AbstractHttpHandlerAdapterInterface>(\n    'MultipartAdapterToken',\n  )\n","import { InjectionToken } from '@navios/di'\n\nexport const Reply = InjectionToken.create<any>('ReplyToken')\n","import { InjectionToken } from '@navios/di'\n\nexport const Request = InjectionToken.create<any>('RequestToken')\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpHandlerAdapterInterface } from '../interfaces/index.mjs'\n\nexport const StreamAdapterToken =\n  InjectionToken.create<AbstractHttpHandlerAdapterInterface>(\n    'StreamAdapterToken',\n  )\n","import { InjectionToken } from '@navios/di'\n\nimport type { AbstractHttpHandlerAdapterInterface } from '../interfaces/index.mjs'\n\nexport const XmlStreamAdapterToken =\n  InjectionToken.create<AbstractHttpHandlerAdapterInterface>(\n    'XmlStreamAdapterToken',\n  )\n","import type {\n  BaseEndpointConfig,\n  EndpointFunctionArgs,\n  HttpMethod,\n  Util_FlatObject,\n} from '@navios/builder'\nimport type { z, ZodType } from 'zod/v4'\n\nimport { ZodDiscriminatedUnion } from 'zod/v4'\n\nimport { getEndpointMetadata } from '../metadata/index.mjs'\nimport { EndpointAdapterToken } from '../tokens/index.mjs'\n\n/**\n * Extracts the typed parameters for an endpoint handler function.\n *\n * This utility type extracts URL parameters, query parameters, and request body\n * from an endpoint declaration and flattens them into a single object.\n *\n * @typeParam EndpointDeclaration - The endpoint declaration from @navios/builder\n *\n * @example\n * ```typescript\n * const getUserEndpoint = api.declareEndpoint({\n *   method: 'get',\n *   url: '/users/$userId',\n *   querySchema: z.object({ include: z.string().optional() }),\n *   responseSchema: z.object({ id: z.string(), name: z.string() }),\n * })\n *\n * @Endpoint(getUserEndpoint)\n * async getUser(request: EndpointParams<typeof getUserEndpoint>) {\n *   // request.urlParams.userId is typed as string\n *   // request.query.include is typed as string | undefined\n * }\n * ```\n */\nexport type EndpointParams<\n  EndpointDeclaration extends {\n    config: BaseEndpointConfig<any, any, any, any, any>\n  },\n  Url extends string = EndpointDeclaration['config']['url'],\n  QuerySchema = EndpointDeclaration['config']['querySchema'],\n> = QuerySchema extends ZodType\n  ? EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          QuerySchema,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, QuerySchema, undefined, true>>\n  : EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          undefined,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, undefined, undefined, true>>\n\n/**\n * Extracts the typed return value for an endpoint handler function.\n *\n * This utility type extracts the response schema from an endpoint declaration\n * and returns the appropriate Promise type.\n *\n * @typeParam EndpointDeclaration - The endpoint declaration from @navios/builder\n *\n * @example\n * ```typescript\n * const getUserEndpoint = api.declareEndpoint({\n *   method: 'get',\n *   url: '/users/$userId',\n *   responseSchema: z.object({ id: z.string(), name: z.string() }),\n * })\n *\n * @Endpoint(getUserEndpoint)\n * async getUser(request: EndpointParams<typeof getUserEndpoint>): EndpointResult<typeof getUserEndpoint> {\n *   return { id: '1', name: 'John' } // Type-checked against responseSchema\n * }\n * ```\n */\nexport type EndpointResult<\n  EndpointDeclaration extends {\n    config: BaseEndpointConfig<any, any, any, any, any>\n  },\n> =\n  EndpointDeclaration['config']['responseSchema'] extends ZodDiscriminatedUnion<\n    infer Options\n  >\n    ? Promise<z.input<Options[number]>>\n    : Promise<z.input<EndpointDeclaration['config']['responseSchema']>>\n\n/**\n * Decorator that marks a method as an HTTP endpoint.\n *\n * The endpoint must be defined using @navios/builder's `declareEndpoint` method.\n * This ensures type safety and consistency between client and server.\n *\n * @param endpoint - The endpoint declaration from @navios/builder\n * @returns A method decorator\n *\n * @example\n * ```typescript\n * import { builder } from '@navios/builder'\n *\n * const api = builder()\n * const getUserEndpoint = api.declareEndpoint({\n *   method: 'get',\n *   url: '/users/$userId',\n *   responseSchema: z.object({ id: z.string(), name: z.string() }),\n * })\n *\n * @Controller()\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   async getUser(request: EndpointParams<typeof getUserEndpoint>) {\n *     const { userId } = request.urlParams\n *     return { id: userId, name: 'John' }\n *   }\n * }\n * ```\n */\nexport function Endpoint<\n  Method extends HttpMethod = HttpMethod,\n  Url extends string = string,\n  QuerySchema = undefined,\n  ResponseSchema extends ZodType = ZodType,\n  RequestSchema = ZodType,\n>(endpoint: {\n  config: BaseEndpointConfig<\n    Method,\n    Url,\n    QuerySchema,\n    ResponseSchema,\n    RequestSchema\n  >\n}) {\n  return (\n    target: (\n      params: QuerySchema extends ZodType\n        ? RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema, true>\n          : EndpointFunctionArgs<Url, QuerySchema, undefined, true>\n        : RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, undefined, RequestSchema, true>\n          : EndpointFunctionArgs<Url, undefined, undefined, true>,\n    ) => Promise<z.input<ResponseSchema>>,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (context.kind !== 'method') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on methods.',\n      )\n    }\n    const config = endpoint.config\n    if (context.metadata) {\n      let endpointMetadata = getEndpointMetadata<BaseEndpointConfig>(\n        target,\n        context,\n      )\n      if (endpointMetadata.config && endpointMetadata.config.url) {\n        throw new Error(\n          `[Navios] Endpoint ${config.method} ${config.url} already exists. Please use a different method or url.`,\n        )\n      }\n      // @ts-expect-error We don't need to set correctly in the metadata\n      endpointMetadata.config = config\n      endpointMetadata.adapterToken = EndpointAdapterToken\n      endpointMetadata.classMethod = target.name\n      endpointMetadata.httpMethod = config.method\n      endpointMetadata.url = config.url\n    }\n    return target\n  }\n}\n","import type { HttpHeader } from '../interfaces/index.mjs'\n\nimport { getEndpointMetadata } from '../metadata/index.mjs'\n\n/**\n * Decorator that sets a custom HTTP response header for an endpoint.\n * \n * @param name - The header name (e.g., 'Content-Type', 'Cache-Control')\n * @param value - The header value (string, number, or array of strings)\n * @returns A method decorator\n * \n * @example\n * ```typescript\n * @Controller()\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   @Header('Cache-Control', 'max-age=3600')\n *   async getUser() {\n *     return { id: '1', name: 'John' }\n *   }\n * }\n * ```\n */\nexport function Header(name: HttpHeader, value: string | number | string[]) {\n  return <T extends Function>(\n    target: T,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (context.kind !== 'method') {\n      throw new Error('[Navios] Header decorator can only be used on methods.')\n    }\n    const metadata = getEndpointMetadata(target, context)\n\n    metadata.headers[name] = value\n\n    return target\n  }\n}\n","import { getEndpointMetadata } from '../metadata/index.mjs'\n\n/**\n * Decorator that sets a custom HTTP status code for successful responses.\n * \n * By default, endpoints return 200 OK. Use this decorator to return a different status code.\n * \n * @param code - The HTTP status code to return (e.g., 201, 204, 202)\n * @returns A method decorator\n * \n * @example\n * ```typescript\n * @Controller()\n * export class UserController {\n *   @Endpoint(createUserEndpoint)\n *   @HttpCode(201)\n *   async createUser() {\n *     return { id: '1', name: 'John' }\n *   }\n * }\n * ```\n */\nexport function HttpCode(code: number) {\n  return <T extends Function>(\n    target: T,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (context.kind !== 'method') {\n      throw new Error(\n        '[Navios] HttpCode decorator can only be used on methods.',\n      )\n    }\n    const metadata = getEndpointMetadata(target, context)\n    metadata.successStatusCode = code\n\n    return target\n  }\n}\n","import type { ClassType } from '@navios/di'\n\nimport { Injectable, InjectableScope, InjectionToken } from '@navios/di'\n\nimport { getModuleMetadata } from '../metadata/index.mjs'\n\n/**\n * Options for configuring a Navios module.\n */\nexport interface ModuleOptions {\n  /**\n   * Controllers to register in this module.\n   * Controllers handle HTTP requests and define endpoints.\n   */\n  controllers?: ClassType[] | Set<ClassType>\n  /**\n   * Other modules to import into this module.\n   * Imported modules' controllers and services become available.\n   */\n  imports?: ClassType[] | Set<ClassType>\n  /**\n   * Guards to apply to all controllers in this module.\n   * Guards are executed in reverse order (last guard first).\n   */\n  guards?: ClassType[] | Set<ClassType>\n}\n\n/**\n * Decorator that marks a class as a Navios module.\n * \n * Modules are the basic building blocks of a Navios application.\n * They organize controllers, services, and other modules into logical units.\n * \n * @param options - Module configuration options\n * @returns A class decorator\n * \n * @example\n * ```typescript\n * @Module({\n *   controllers: [UserController, AuthController],\n *   imports: [DatabaseModule],\n *   guards: [AuthGuard],\n * })\n * export class AppModule {}\n * ```\n */\nexport function Module(\n  { controllers = [], imports = [], guards = [] }: ModuleOptions = {\n    controllers: [],\n    imports: [],\n    guards: [],\n  },\n) {\n  return (target: ClassType, context: ClassDecoratorContext) => {\n    if (context.kind !== 'class') {\n      throw new Error('[Navios] @Module decorator can only be used on classes.')\n    }\n    // Register the module in the service locator\n    const token = InjectionToken.create(target)\n    const moduleMetadata = getModuleMetadata(target, context)\n    for (const controller of controllers) {\n      moduleMetadata.controllers.add(controller)\n    }\n    for (const importedModule of imports) {\n      moduleMetadata.imports.add(importedModule)\n    }\n    for (const guard of Array.from(guards).reverse()) {\n      moduleMetadata.guards.add(guard)\n    }\n\n    return Injectable({\n      token,\n      scope: InjectableScope.Singleton,\n    })(target, context)\n  }\n}\n","import type {\n  BaseEndpointConfig,\n  EndpointFunctionArgs,\n  HttpMethod,\n  Util_FlatObject,\n} from '@navios/builder'\nimport type { z, ZodObject, ZodType } from 'zod/v4'\n\nimport { ZodDiscriminatedUnion } from 'zod/v4'\n\nimport { getEndpointMetadata } from '../metadata/index.mjs'\nimport { MultipartAdapterToken } from '../tokens/index.mjs'\n\n/**\n * Extracts the typed parameters for a multipart endpoint handler function.\n * \n * Similar to `EndpointParams`, but specifically for multipart/form-data endpoints.\n * \n * @typeParam EndpointDeclaration - The endpoint declaration from @navios/builder\n */\nexport type MultipartParams<\n  EndpointDeclaration extends {\n    config: BaseEndpointConfig<any, any, any, any, any>\n  },\n  Url extends string = EndpointDeclaration['config']['url'],\n  QuerySchema = EndpointDeclaration['config']['querySchema'],\n> = QuerySchema extends ZodObject\n  ? EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          QuerySchema,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, QuerySchema, undefined, true>>\n  : EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          undefined,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, undefined, undefined, true>>\n\n/**\n * Extracts the typed return value for a multipart endpoint handler function.\n * \n * @typeParam EndpointDeclaration - The endpoint declaration from @navios/builder\n */\nexport type MultipartResult<\n  EndpointDeclaration extends {\n    config: BaseEndpointConfig<any, any, any, any, any>\n  },\n> =\n  EndpointDeclaration['config']['responseSchema'] extends ZodDiscriminatedUnion<\n    infer Options\n  >\n    ? Promise<z.input<Options[number]>>\n    : Promise<z.input<EndpointDeclaration['config']['responseSchema']>>\n\n/**\n * Decorator that marks a method as a multipart/form-data endpoint.\n * \n * Use this decorator for endpoints that handle file uploads or form data.\n * The endpoint must be defined using @navios/builder's `declareMultipart` method.\n * \n * @param endpoint - The multipart endpoint declaration from @navios/builder\n * @returns A method decorator\n * \n * @example\n * ```typescript\n * const uploadFileEndpoint = api.declareMultipart({\n *   method: 'post',\n *   url: '/upload',\n *   requestSchema: z.object({ file: z.instanceof(File) }),\n *   responseSchema: z.object({ url: z.string() }),\n * })\n * \n * @Controller()\n * export class FileController {\n *   @Multipart(uploadFileEndpoint)\n *   async uploadFile(request: MultipartParams<typeof uploadFileEndpoint>) {\n *     const { file } = request.data\n *     // Handle file upload\n *     return { url: 'https://example.com/file.jpg' }\n *   }\n * }\n * ```\n */\nexport function Multipart<\n  Method extends HttpMethod = HttpMethod,\n  Url extends string = string,\n  QuerySchema = undefined,\n  ResponseSchema extends ZodType = ZodType,\n  RequestSchema = ZodType,\n>(endpoint: {\n  config: BaseEndpointConfig<\n    Method,\n    Url,\n    QuerySchema,\n    ResponseSchema,\n    RequestSchema\n  >\n}) {\n  return (\n    target: (\n      params: QuerySchema extends ZodObject\n        ? RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema>\n          : EndpointFunctionArgs<Url, QuerySchema, undefined>\n        : RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, undefined, RequestSchema>\n          : EndpointFunctionArgs<Url, undefined, undefined>,\n    ) => Promise<z.input<ResponseSchema>>,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (typeof target !== 'function') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on functions.',\n      )\n    }\n    if (context.kind !== 'method') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on methods.',\n      )\n    }\n    const config = endpoint.config\n    if (context.metadata) {\n      let endpointMetadata = getEndpointMetadata<BaseEndpointConfig>(\n        target,\n        context,\n      )\n      if (endpointMetadata.config && endpointMetadata.config.url) {\n        throw new Error(\n          `[Navios] Endpoint ${config.method} ${config.url} already exists. Please use a different method or url.`,\n        )\n      }\n      // @ts-expect-error We don't need to set correctly in the metadata\n      endpointMetadata.config = config\n      endpointMetadata.adapterToken = MultipartAdapterToken\n      endpointMetadata.classMethod = target.name\n      endpointMetadata.httpMethod = config.method\n      endpointMetadata.url = config.url\n    }\n    return target\n  }\n}\n","import type {\n  BaseStreamConfig,\n  EndpointFunctionArgs,\n  HttpMethod,\n  Util_FlatObject,\n} from '@navios/builder'\nimport type { ZodObject, ZodType } from 'zod/v4'\n\nimport { getEndpointMetadata } from '../metadata/index.mjs'\nimport { StreamAdapterToken } from '../tokens/index.mjs'\n\n/**\n * Extracts the typed parameters for a stream endpoint handler function.\n * \n * Similar to `EndpointParams`, but specifically for streaming endpoints.\n * \n * @typeParam EndpointDeclaration - The stream endpoint declaration from @navios/builder\n */\nexport type StreamParams<\n  EndpointDeclaration extends {\n    config: BaseStreamConfig<any, any, any, any>\n  },\n  Url extends string = EndpointDeclaration['config']['url'],\n  QuerySchema = EndpointDeclaration['config']['querySchema'],\n> = QuerySchema extends ZodObject\n  ? EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          QuerySchema,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, QuerySchema, undefined, true>>\n  : EndpointDeclaration['config']['requestSchema'] extends ZodType\n    ? Util_FlatObject<\n        EndpointFunctionArgs<\n          Url,\n          undefined,\n          EndpointDeclaration['config']['requestSchema'],\n          true\n        >\n      >\n    : Util_FlatObject<EndpointFunctionArgs<Url, undefined, undefined, true>>\n\n/**\n * Decorator that marks a method as a streaming endpoint.\n * \n * Use this decorator for endpoints that stream data (e.g., file downloads, SSE).\n * The endpoint must be defined using @navios/builder's `declareStream` method.\n * \n * @param endpoint - The stream endpoint declaration from @navios/builder\n * @returns A method decorator\n * \n * @example\n * ```typescript\n * const downloadFileEndpoint = api.declareStream({\n *   method: 'get',\n *   url: '/files/$fileId',\n * })\n * \n * @Controller()\n * export class FileController {\n *   @Stream(downloadFileEndpoint)\n *   async downloadFile(request: StreamParams<typeof downloadFileEndpoint>, reply: any) {\n *     const { fileId } = request.urlParams\n *     // Stream file data to reply\n *   }\n * }\n * ```\n */\nexport function Stream<\n  Method extends HttpMethod = HttpMethod,\n  Url extends string = string,\n  QuerySchema = undefined,\n  RequestSchema = ZodType,\n>(endpoint: {\n  config: BaseStreamConfig<Method, Url, QuerySchema, RequestSchema>\n}) {\n  return (\n    target: (\n      params: QuerySchema extends ZodObject\n        ? RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema>\n          : EndpointFunctionArgs<Url, QuerySchema, undefined>\n        : RequestSchema extends ZodType\n          ? EndpointFunctionArgs<Url, undefined, RequestSchema>\n          : EndpointFunctionArgs<Url, undefined, undefined>,\n      reply: any,\n    ) => Promise<void>,\n    context: ClassMethodDecoratorContext,\n  ) => {\n    if (typeof target !== 'function') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on functions.',\n      )\n    }\n    if (context.kind !== 'method') {\n      throw new Error(\n        '[Navios] Endpoint decorator can only be used on methods.',\n      )\n    }\n    const config = endpoint.config\n    if (context.metadata) {\n      let endpointMetadata = getEndpointMetadata<BaseStreamConfig>(\n        target,\n        context,\n      )\n      if (endpointMetadata.config && endpointMetadata.config.url) {\n        throw new Error(\n          `[Navios] Endpoint ${config.method} ${config.url} already exists. Please use a different method or url.`,\n        )\n      }\n      // @ts-expect-error We don't need to set correctly in the metadata\n      endpointMetadata.config = config\n      endpointMetadata.adapterToken = StreamAdapterToken\n      endpointMetadata.classMethod = target.name\n      endpointMetadata.httpMethod = config.method\n      endpointMetadata.url = config.url\n    }\n    return target\n  }\n}\n","import type {\n  ClassType,\n  ClassTypeWithInstance,\n  InjectionToken,\n} from '@navios/di'\n\nimport type { CanActivate } from '../interfaces/index.mjs'\n\nimport {\n  getControllerMetadata,\n  getEndpointMetadata,\n} from '../metadata/index.mjs'\n\n/**\n * Decorator that applies guards to a controller or endpoint.\n * \n * Guards are used for authentication, authorization, and request validation.\n * They implement the `CanActivate` interface and are executed before the endpoint handler.\n * Guards can be applied at the module, controller, or endpoint level.\n * \n * @param guards - Guard classes or injection tokens to apply\n * @returns A class or method decorator\n * \n * @example\n * ```typescript\n * // Apply to a controller\n * @Controller()\n * @UseGuards(AuthGuard, RoleGuard)\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   async getUser() { }\n * }\n * \n * // Apply to a specific endpoint\n * @Controller()\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   @UseGuards(AuthGuard)\n *   async getUser() { }\n * }\n * ```\n */\nexport function UseGuards(\n  ...guards: (\n    | ClassTypeWithInstance<CanActivate>\n    | InjectionToken<CanActivate, undefined>\n  )[]\n) {\n  return function <T extends Function>(\n    target: T,\n    context: ClassMethodDecoratorContext | ClassDecoratorContext,\n  ): T {\n    if (context.kind === 'class') {\n      const controllerMetadata = getControllerMetadata(\n        target as unknown as ClassType,\n        context,\n      )\n      for (const guard of guards.reverse()) {\n        controllerMetadata.guards.add(guard)\n      }\n    } else if (context.kind === 'method') {\n      const endpointMetadata = getEndpointMetadata(target, context)\n      for (const guard of guards.reverse()) {\n        endpointMetadata.guards.add(guard)\n      }\n    } else {\n      throw new Error(\n        '[Navios] @UseGuards decorator can only be used on classes or methods.',\n      )\n    }\n    return target\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@navios/core",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "author": {
     "name": "Oleksandr Hanzha",
     "email": "alex@granted.name"
@@ -12,11 +12,11 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@navios/builder": "^0.5.0",
+    "@navios/builder": "^0.5.1",
     "zod": "^3.25.0 || ^4.0.0"
   },
   "typings": "./lib/index.d.mts",
-  "main": "./lib/index.js",
+  "main": "./lib/index.cjs",
   "module": "./lib/index.mjs",
   "exports": {
     ".": {
@@ -25,8 +25,8 @@
         "default": "./lib/index.mjs"
       },
       "require": {
-        "types": "./lib/index.d.ts",
-        "default": "./lib/index.js"
+        "types": "./lib/index.d.cts",
+        "default": "./lib/index.cjs"
       }
     },
     "./testing": {
@@ -35,8 +35,8 @@
         "default": "./lib/testing/index.mjs"
       },
       "require": {
-        "types": "./lib/testing/index.d.ts",
-        "default": "./lib/testing/index.js"
+        "types": "./lib/testing/index.d.cts",
+        "default": "./lib/testing/index.cjs"
       }
     },
     "./legacy-compat": {
@@ -45,20 +45,20 @@
         "default": "./lib/legacy-compat/index.mjs"
       },
       "require": {
-        "types": "./lib/legacy-compat/index.d.ts",
-        "default": "./lib/legacy-compat/index.js"
+        "types": "./lib/legacy-compat/index.d.cts",
+        "default": "./lib/legacy-compat/index.cjs"
       }
     }
   },
   "devDependencies": {
-    "@navios/builder": "^0.5.0",
+    "@navios/builder": "^0.5.1",
     "@types/supertest": "^6.0.3",
     "supertest": "^7.1.4",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "zod": "^4.1.13"
+    "zod": "^4.2.1"
   },
   "dependencies": {
-    "@navios/di": "^0.6.0"
+    "@navios/di": "^0.6.1"
   }
 }

package/src/interfaces/abstract-http-adapter.interface.mts

@@ -2,19 +2,71 @@ import type { ModuleMetadata } from '../metadata/index.mjs'
 import type { AbstractHttpCorsOptions } from './abstract-http-cors-options.interface.mjs'
 import type { AbstractHttpListenOptions } from './abstract-http-listen-options.interface.mjs'
 
+/**
+ * Abstract interface for HTTP adapters.
+ *
+ * Adapters implement this interface to provide runtime-specific HTTP server
+ * functionality (Fastify, Bun, etc.).
+ *
+ * @typeParam ServerInstance - The underlying server type (e.g., FastifyInstance)
+ * @typeParam CorsOptions - CORS configuration options type
+ * @typeParam Options - Server setup options type
+ * @typeParam MultipartOptions - Multipart form handling options type
+ */
 export interface AbstractHttpAdapterInterface<
   ServerInstance,
   CorsOptions = AbstractHttpCorsOptions,
   Options = {},
   MultipartOptions = {},
 > {
+  /**
+   * Sets up the HTTP server with the provided options.
+   */
   setupHttpServer(options: Options): Promise<void>
+
+  /**
+   * Called after all modules are loaded to register routes.
+   */
   onModulesInit(modules: Map<string, ModuleMetadata>): Promise<void>
+
+  /**
+   * Signals that the server is ready to accept requests.
+   */
   ready(): Promise<void>
+
+  /**
+   * Returns the underlying HTTP server instance.
+   */
   getServer(): ServerInstance
+
+  /**
+   * Sets a global prefix for all routes.
+   */
   setGlobalPrefix(prefix: string): void
+
+  /**
+   * Gets the current global prefix.
+   * Returns empty string if no prefix is set.
+   */
+  getGlobalPrefix(): string
+
+  /**
+   * Enables CORS with the specified options.
+   */
   enableCors(options: CorsOptions): void
+
+  /**
+   * Enables multipart form data handling.
+   */
   enableMultipart(options: MultipartOptions): void
+
+  /**
+   * Starts the server and listens for incoming requests.
+   */
   listen(options: AbstractHttpListenOptions): Promise<string>
+
+  /**
+   * Disposes of the server and cleans up resources.
+   */
   dispose(): Promise<void>
 }

package/src/interfaces/index.mts

@@ -6,3 +6,4 @@ export * from './abstract-http-listen-options.interface.mjs'
 export * from './can-activate.mjs'
 export * from './http-header.mjs'
 export * from './navios-module.mjs'
+export * from './plugin.interface.mjs'

package/src/interfaces/plugin.interface.mts

@@ -0,0 +1,105 @@
+import type { Container } from '@navios/di'
+
+import type { ModuleMetadata } from '../metadata/index.mjs'
+import type { ModuleLoaderService } from '../services/module-loader.service.mjs'
+
+/**
+ * Context provided to plugins during registration.
+ *
+ * This context gives plugins access to the application's modules,
+ * server instance, DI container, and configuration.
+ */
+export interface PluginContext {
+  /**
+   * All loaded modules with their metadata.
+   * Keys are module class names, values are their metadata.
+   */
+  modules: Map<string, ModuleMetadata>
+
+  /**
+   * The underlying HTTP server instance.
+   * Type depends on the adapter used (Fastify, Bun, etc.)
+   */
+  server: any
+
+  /**
+   * The dependency injection container.
+   */
+  container: Container
+
+  /**
+   * Global route prefix (e.g., '/api/v1').
+   * Empty string if no prefix is set.
+   */
+  globalPrefix: string
+
+  /**
+   * Module loader service for extending the module tree.
+   * Use `moduleLoader.extendModules()` to add controllers dynamically.
+   */
+  moduleLoader: ModuleLoaderService
+}
+
+/**
+ * Base interface for Navios plugins.
+ *
+ * Plugins are registered using `app.usePlugin()` and are initialized
+ * after all modules are loaded but before the server starts listening.
+ *
+ * @typeParam TOptions - The type of options the plugin accepts
+ *
+ * @example
+ * ```typescript
+ * const myPlugin: NaviosPlugin<{ enabled: boolean }> = {
+ *   name: 'my-plugin',
+ *   register: async (context, options) => {
+ *     if (options.enabled) {
+ *       // Register routes, services, etc.
+ *     }
+ *   },
+ * }
+ * ```
+ */
+export interface NaviosPlugin<TOptions = unknown> {
+  /**
+   * Plugin name for identification and logging.
+   */
+  name: string
+
+  /**
+   * Called after modules are loaded but before the server starts listening.
+   *
+   * @param context - The plugin context with access to modules and server
+   * @param options - Plugin-specific configuration options
+   */
+  register(context: PluginContext, options: TOptions): Promise<void> | void
+}
+
+/**
+ * Plugin definition combining a plugin with its options.
+ *
+ * This is the type returned by plugin factory functions like `defineOpenApiPlugin()`.
+ *
+ * @typeParam TOptions - The type of options the plugin accepts
+ *
+ * @example
+ * ```typescript
+ * function defineMyPlugin(options: MyPluginOptions): PluginDefinition<MyPluginOptions> {
+ *   return {
+ *     plugin: myPlugin,
+ *     options,
+ *   }
+ * }
+ * ```
+ */
+export interface PluginDefinition<TOptions = unknown> {
+  /**
+   * The plugin instance.
+   */
+  plugin: NaviosPlugin<TOptions>
+
+  /**
+   * Options to pass to the plugin's register function.
+   */
+  options: TOptions
+}

package/src/logger/logger.service.mts

@@ -7,16 +7,16 @@ import { Logger, LoggerOutput } from './logger.tokens.mjs'
 
 /**
  * Logger service instance that can be injected into services and controllers.
- * 
+ *
  * Provides contextualized logging with automatic context injection.
  * The context is set when the logger is injected using the `inject` function.
- * 
+ *
  * @example
  * ```typescript
  * @Injectable()
  * export class UserService {
  *   private logger = inject(Logger, { context: UserService.name })
- *   
+ *
  *   async findUser(id: string) {
  *     this.logger.log(`Finding user ${id}`)
  *     // Logs with context: [UserService]
@@ -60,6 +60,8 @@ export class LoggerInstance implements LoggerService {
     optionalParams = this.context
       ? optionalParams.concat(this.context)
       : optionalParams
+    console.log('log', message, optionalParams)
+    console.log('localInstance', this.localInstance)
     this.localInstance?.log(message, ...optionalParams)
   }