@navios/core 0.1.7 → 0.1.9

package/dist/_tsup-dts-rollup.d.mts

@@ -1,5 +1,6 @@
 import type { AnyZodObject } from 'zod';
 import type { BaseEndpointConfig } from '@navios/common';
+import type { BaseStreamConfig } from '@navios/common';
 import type { EndpointFunctionArgs } from '@navios/common';
 import { FastifyBaseLogger } from 'fastify';
 import type { FastifyCorsOptions } from '@fastify/cors';
@@ -21,6 +22,7 @@ import { ResolveFastifyRequestType } from 'fastify/types/type-provider.js';
 import { RouteGenericInterface } from 'fastify';
 import { ServerResponse } from 'http';
 import { z } from 'zod';
+import { ZodDiscriminatedUnion } from 'zod';
 import { ZodOptional } from 'zod';
 import type { ZodType } from 'zod';
 
@@ -378,6 +380,7 @@ declare class ControllerAdapterService {
     private provideSchemaForConfig;
     private provideHandler;
     private provideHandlerForConfig;
+    private provideHandlerForStream;
 }
 export { ControllerAdapterService }
 export { ControllerAdapterService as ControllerAdapterService_alias_1 }
@@ -418,7 +421,7 @@ declare interface EndpointMetadata {
     type: EndpointType;
     headers: Partial<Record<HttpHeader, number | string | string[] | undefined>>;
     httpMethod: HttpMethod;
-    config: BaseEndpointConfig | null;
+    config: BaseEndpointConfig | BaseStreamConfig | null;
     guards: Set<ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>>;
     customAttributes: Map<string | symbol, any>;
 }
@@ -438,9 +441,17 @@ export { EndpointParams }
 export { EndpointParams as EndpointParams_alias_1 }
 export { EndpointParams as EndpointParams_alias_2 }
 
+declare type EndpointResult<EndpointDeclaration extends {
+    config: BaseEndpointConfig<any, any, any, any, any>;
+}> = EndpointDeclaration['config']['responseSchema'] extends ZodDiscriminatedUnion<any, infer Options> ? Promise<z.input<Options[number]>> : Promise<z.input<EndpointDeclaration['config']['responseSchema']>>;
+export { EndpointResult }
+export { EndpointResult as EndpointResult_alias_1 }
+export { EndpointResult as EndpointResult_alias_2 }
+
 declare enum EndpointType {
     Unknown = "unknown",
-    Config = "config",
+    Endpoint = "endpoint",
+    Stream = "stream",
     Handler = "handler"
 }
 export { EndpointType }
@@ -1437,6 +1448,20 @@ export { setPromiseCollector }
 export { setPromiseCollector as setPromiseCollector_alias_1 }
 export { setPromiseCollector as setPromiseCollector_alias_2 }
 
+declare function Stream<Method extends HttpMethod = HttpMethod, Url extends string = string, QuerySchema = undefined, RequestSchema = ZodType>(endpoint: {
+    config: BaseStreamConfig<Method, Url, QuerySchema, RequestSchema>;
+}): (target: (params: QuerySchema extends AnyZodObject ? RequestSchema extends ZodType ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema> : EndpointFunctionArgs<Url, QuerySchema, undefined> : RequestSchema extends ZodType ? EndpointFunctionArgs<Url, undefined, RequestSchema> : EndpointFunctionArgs<Url, undefined, undefined>, reply: FastifyReply) => Promise<void>, context: ClassMethodDecoratorContext) => (params: QuerySchema extends AnyZodObject ? RequestSchema extends ZodType ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema> : EndpointFunctionArgs<Url, QuerySchema, undefined> : RequestSchema extends ZodType ? EndpointFunctionArgs<Url, undefined, RequestSchema> : EndpointFunctionArgs<Url, undefined, undefined>, reply: FastifyReply) => Promise<void>;
+export { Stream }
+export { Stream as Stream_alias_1 }
+export { Stream as Stream_alias_2 }
+
+declare type StreamParams<EndpointDeclaration extends {
+    config: BaseStreamConfig<any, any, any, any>;
+}, Url extends string = EndpointDeclaration['config']['url'], QuerySchema = EndpointDeclaration['config']['querySchema']> = QuerySchema extends AnyZodObject ? EndpointDeclaration['config']['requestSchema'] extends ZodType ? EndpointFunctionArgs<Url, QuerySchema, EndpointDeclaration['config']['requestSchema']> : EndpointFunctionArgs<Url, QuerySchema, undefined> : EndpointDeclaration['config']['requestSchema'] extends ZodType ? EndpointFunctionArgs<Url, undefined, EndpointDeclaration['config']['requestSchema']> : EndpointFunctionArgs<Url, undefined, undefined>;
+export { StreamParams }
+export { StreamParams as StreamParams_alias_1 }
+export { StreamParams as StreamParams_alias_2 }
+
 declare const stripEndSlash: (path: string) => string;
 export { stripEndSlash }
 export { stripEndSlash as stripEndSlash_alias_1 }

package/dist/_tsup-dts-rollup.d.ts

@@ -1,5 +1,6 @@
 import type { AnyZodObject } from 'zod';
 import type { BaseEndpointConfig } from '@navios/common';
+import type { BaseStreamConfig } from '@navios/common';
 import type { EndpointFunctionArgs } from '@navios/common';
 import { FastifyBaseLogger } from 'fastify';
 import type { FastifyCorsOptions } from '@fastify/cors';
@@ -21,6 +22,7 @@ import { ResolveFastifyRequestType } from 'fastify/types/type-provider.js';
 import { RouteGenericInterface } from 'fastify';
 import { ServerResponse } from 'http';
 import { z } from 'zod';
+import { ZodDiscriminatedUnion } from 'zod';
 import { ZodOptional } from 'zod';
 import type { ZodType } from 'zod';
 
@@ -378,6 +380,7 @@ declare class ControllerAdapterService {
     private provideSchemaForConfig;
     private provideHandler;
     private provideHandlerForConfig;
+    private provideHandlerForStream;
 }
 export { ControllerAdapterService }
 export { ControllerAdapterService as ControllerAdapterService_alias_1 }
@@ -418,7 +421,7 @@ declare interface EndpointMetadata {
     type: EndpointType;
     headers: Partial<Record<HttpHeader, number | string | string[] | undefined>>;
     httpMethod: HttpMethod;
-    config: BaseEndpointConfig | null;
+    config: BaseEndpointConfig | BaseStreamConfig | null;
     guards: Set<ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>>;
     customAttributes: Map<string | symbol, any>;
 }
@@ -438,9 +441,17 @@ export { EndpointParams }
 export { EndpointParams as EndpointParams_alias_1 }
 export { EndpointParams as EndpointParams_alias_2 }
 
+declare type EndpointResult<EndpointDeclaration extends {
+    config: BaseEndpointConfig<any, any, any, any, any>;
+}> = EndpointDeclaration['config']['responseSchema'] extends ZodDiscriminatedUnion<any, infer Options> ? Promise<z.input<Options[number]>> : Promise<z.input<EndpointDeclaration['config']['responseSchema']>>;
+export { EndpointResult }
+export { EndpointResult as EndpointResult_alias_1 }
+export { EndpointResult as EndpointResult_alias_2 }
+
 declare enum EndpointType {
     Unknown = "unknown",
-    Config = "config",
+    Endpoint = "endpoint",
+    Stream = "stream",
     Handler = "handler"
 }
 export { EndpointType }
@@ -1437,6 +1448,20 @@ export { setPromiseCollector }
 export { setPromiseCollector as setPromiseCollector_alias_1 }
 export { setPromiseCollector as setPromiseCollector_alias_2 }
 
+declare function Stream<Method extends HttpMethod = HttpMethod, Url extends string = string, QuerySchema = undefined, RequestSchema = ZodType>(endpoint: {
+    config: BaseStreamConfig<Method, Url, QuerySchema, RequestSchema>;
+}): (target: (params: QuerySchema extends AnyZodObject ? RequestSchema extends ZodType ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema> : EndpointFunctionArgs<Url, QuerySchema, undefined> : RequestSchema extends ZodType ? EndpointFunctionArgs<Url, undefined, RequestSchema> : EndpointFunctionArgs<Url, undefined, undefined>, reply: FastifyReply) => Promise<void>, context: ClassMethodDecoratorContext) => (params: QuerySchema extends AnyZodObject ? RequestSchema extends ZodType ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema> : EndpointFunctionArgs<Url, QuerySchema, undefined> : RequestSchema extends ZodType ? EndpointFunctionArgs<Url, undefined, RequestSchema> : EndpointFunctionArgs<Url, undefined, undefined>, reply: FastifyReply) => Promise<void>;
+export { Stream }
+export { Stream as Stream_alias_1 }
+export { Stream as Stream_alias_2 }
+
+declare type StreamParams<EndpointDeclaration extends {
+    config: BaseStreamConfig<any, any, any, any>;
+}, Url extends string = EndpointDeclaration['config']['url'], QuerySchema = EndpointDeclaration['config']['querySchema']> = QuerySchema extends AnyZodObject ? EndpointDeclaration['config']['requestSchema'] extends ZodType ? EndpointFunctionArgs<Url, QuerySchema, EndpointDeclaration['config']['requestSchema']> : EndpointFunctionArgs<Url, QuerySchema, undefined> : EndpointDeclaration['config']['requestSchema'] extends ZodType ? EndpointFunctionArgs<Url, undefined, EndpointDeclaration['config']['requestSchema']> : EndpointFunctionArgs<Url, undefined, undefined>;
+export { StreamParams }
+export { StreamParams as StreamParams_alias_1 }
+export { StreamParams as StreamParams_alias_2 }
+
 declare const stripEndSlash: (path: string) => string;
 export { stripEndSlash }
 export { stripEndSlash as stripEndSlash_alias_1 }

package/dist/index.d.mts

@@ -14,10 +14,13 @@ export { Controller } from './_tsup-dts-rollup.mjs';
 export { ControllerOptions } from './_tsup-dts-rollup.mjs';
 export { Endpoint } from './_tsup-dts-rollup.mjs';
 export { EndpointParams } from './_tsup-dts-rollup.mjs';
+export { EndpointResult } from './_tsup-dts-rollup.mjs';
 export { Header } from './_tsup-dts-rollup.mjs';
 export { HttpCode } from './_tsup-dts-rollup.mjs';
 export { Module } from './_tsup-dts-rollup.mjs';
 export { ModuleOptions } from './_tsup-dts-rollup.mjs';
+export { Stream } from './_tsup-dts-rollup.mjs';
+export { StreamParams } from './_tsup-dts-rollup.mjs';
 export { UseGuards } from './_tsup-dts-rollup.mjs';
 export { HttpException } from './_tsup-dts-rollup.mjs';
 export { BadRequestException } from './_tsup-dts-rollup.mjs';

package/dist/index.d.ts

@@ -14,10 +14,13 @@ export { Controller } from './_tsup-dts-rollup.js';
 export { ControllerOptions } from './_tsup-dts-rollup.js';
 export { Endpoint } from './_tsup-dts-rollup.js';
 export { EndpointParams } from './_tsup-dts-rollup.js';
+export { EndpointResult } from './_tsup-dts-rollup.js';
 export { Header } from './_tsup-dts-rollup.js';
 export { HttpCode } from './_tsup-dts-rollup.js';
 export { Module } from './_tsup-dts-rollup.js';
 export { ModuleOptions } from './_tsup-dts-rollup.js';
+export { Stream } from './_tsup-dts-rollup.js';
+export { StreamParams } from './_tsup-dts-rollup.js';
 export { UseGuards } from './_tsup-dts-rollup.js';
 export { HttpException } from './_tsup-dts-rollup.js';
 export { BadRequestException } from './_tsup-dts-rollup.js';

package/dist/index.js

@@ -132,6 +132,7 @@ __export(src_exports, {
   ServiceLocatorInstanceHolderKind: () => ServiceLocatorInstanceHolderKind,
   ServiceLocatorInstanceHolderStatus: () => ServiceLocatorInstanceHolderStatus,
   ServiceLocatorManager: () => ServiceLocatorManager,
+  Stream: () => Stream,
   UnauthorizedException: () => UnauthorizedException,
   UnknownError: () => UnknownError,
   UseGuards: () => UseGuards,
@@ -1804,7 +1805,8 @@ function provideConfig(options) {
 var EndpointMetadataKey = Symbol("EndpointMetadataKey");
 var EndpointType = /* @__PURE__ */ ((EndpointType2) => {
   EndpointType2["Unknown"] = "unknown";
-  EndpointType2["Config"] = "config";
+  EndpointType2["Endpoint"] = "endpoint";
+  EndpointType2["Stream"] = "stream";
   EndpointType2["Handler"] = "handler";
   return EndpointType2;
 })(EndpointType || {});
@@ -1909,7 +1911,7 @@ function extractModuleMetadata(target) {
   const metadata = target[ModuleMetadataKey];
   if (!metadata) {
     throw new Error(
-      "[Navios] Module metadata not found. Make sure to use @Module decorator."
+      `[Navios] Module metadata not found for ${target.name}. Make sure to use @Module decorator.`
     );
   }
   return metadata;
@@ -1944,6 +1946,7 @@ function Controller({ guards } = {}) {
 }
 
 // packages/core/src/decorators/endpoint.decorator.mts
+var import_zod4 = require("zod");
 function Endpoint(endpoint) {
   return (target, context) => {
     if (typeof target !== "function") {
@@ -1965,7 +1968,7 @@ function Endpoint(endpoint) {
         );
       }
       endpointMetadata.config = config;
-      endpointMetadata.type = "config" /* Config */;
+      endpointMetadata.type = "endpoint" /* Endpoint */;
       endpointMetadata.classMethod = target.name;
       endpointMetadata.httpMethod = config.method;
       endpointMetadata.url = config.url;
@@ -1981,6 +1984,11 @@ function Header(name2, value) {
       throw new Error("[Navios] Header decorator can only be used on methods.");
     }
     const metadata = getEndpointMetadata(target, context);
+    if (metadata.type === "stream" /* Stream */) {
+      throw new Error(
+        "[Navios] HttpCode decorator cannot be used on stream endpoints."
+      );
+    }
     metadata.headers[name2] = value;
     return target;
   };
@@ -1995,6 +2003,11 @@ function HttpCode(code) {
       );
     }
     const metadata = getEndpointMetadata(target, context);
+    if (metadata.type === "stream" /* Stream */) {
+      throw new Error(
+        "[Navios] HttpCode decorator cannot be used on stream endpoints."
+      );
+    }
     metadata.successStatusCode = code;
     return target;
   };
@@ -2031,6 +2044,37 @@ function Module(metadata) {
   };
 }
 
+// packages/core/src/decorators/stream.decorator.mts
+function Stream(endpoint) {
+  return (target, context) => {
+    if (typeof target !== "function") {
+      throw new Error(
+        "[Navios] Endpoint decorator can only be used on functions."
+      );
+    }
+    if (context.kind !== "method") {
+      throw new Error(
+        "[Navios] Endpoint decorator can only be used on methods."
+      );
+    }
+    const config = endpoint.config;
+    if (context.metadata) {
+      let endpointMetadata = getEndpointMetadata(target, context);
+      if (endpointMetadata.config && endpointMetadata.config.url) {
+        throw new Error(
+          `[Navios] Endpoint ${config.method} ${config.url} already exists. Please use a different method or url.`
+        );
+      }
+      endpointMetadata.config = config;
+      endpointMetadata.type = "stream" /* Stream */;
+      endpointMetadata.classMethod = target.name;
+      endpointMetadata.httpMethod = config.method;
+      endpointMetadata.url = config.url;
+    }
+    return target;
+  };
+}
+
 // packages/core/src/decorators/use-guards.decorator.mts
 function UseGuards(...guards) {
   return function(target, context) {
@@ -2332,12 +2376,18 @@ var _ControllerAdapterService = class _ControllerAdapterService {
           `Unknown endpoint type ${endpointMetadata.type} for ${controller.name}:${endpointMetadata.classMethod}`
         );
         throw new import_common4.NaviosException("Unknown endpoint type");
-      case "config" /* Config */:
+      case "endpoint" /* Endpoint */:
         return this.provideHandlerForConfig(
           controller,
           executionContext,
           endpointMetadata
         );
+      case "stream" /* Stream */:
+        return this.provideHandlerForStream(
+          controller,
+          executionContext,
+          endpointMetadata
+        );
       case "handler" /* Handler */:
         this.logger.error("Not implemented yet");
         throw new import_common4.NaviosException("Not implemented yet");
@@ -2375,6 +2425,37 @@ var _ControllerAdapterService = class _ControllerAdapterService {
       }
     };
   }
+  provideHandlerForStream(controller, executionContext, endpointMetadata) {
+    return async (request, reply) => {
+      getServiceLocator().registerInstance(Request, request);
+      getServiceLocator().registerInstance(Reply, reply);
+      getServiceLocator().registerInstance(
+        ExecutionContextToken,
+        executionContext
+      );
+      executionContext.provideRequest(request);
+      executionContext.provideReply(reply);
+      const controllerInstance = await inject(controller);
+      try {
+        const { query, params, body } = request;
+        const argument = {};
+        if (query && Object.keys(query).length > 0) {
+          argument.params = query;
+        }
+        if (params && Object.keys(params).length > 0) {
+          argument.urlParams = params;
+        }
+        if (body) {
+          argument.data = body;
+        }
+        await controllerInstance[endpointMetadata.classMethod](argument, reply);
+      } finally {
+        getServiceLocator().removeInstance(Request);
+        getServiceLocator().removeInstance(Reply);
+        getServiceLocator().removeInstance(ExecutionContextToken);
+      }
+    };
+  }
 };
 _init6 = __decoratorStart(null);
 _ControllerAdapterService = __decorateElement(_init6, 0, "ControllerAdapterService", _ControllerAdapterService_decorators, _ControllerAdapterService);
@@ -2744,6 +2825,7 @@ var NaviosFactory = class {
   ServiceLocatorInstanceHolderKind,
   ServiceLocatorInstanceHolderStatus,
   ServiceLocatorManager,
+  Stream,
   UnauthorizedException,
   UnknownError,
   UseGuards,

package/dist/index.mjs

@@ -1675,7 +1675,8 @@ function provideConfig(options) {
 var EndpointMetadataKey = Symbol("EndpointMetadataKey");
 var EndpointType = /* @__PURE__ */ ((EndpointType2) => {
   EndpointType2["Unknown"] = "unknown";
-  EndpointType2["Config"] = "config";
+  EndpointType2["Endpoint"] = "endpoint";
+  EndpointType2["Stream"] = "stream";
   EndpointType2["Handler"] = "handler";
   return EndpointType2;
 })(EndpointType || {});
@@ -1780,7 +1781,7 @@ function extractModuleMetadata(target) {
   const metadata = target[ModuleMetadataKey];
   if (!metadata) {
     throw new Error(
-      "[Navios] Module metadata not found. Make sure to use @Module decorator."
+      `[Navios] Module metadata not found for ${target.name}. Make sure to use @Module decorator.`
     );
   }
   return metadata;
@@ -1815,6 +1816,7 @@ function Controller({ guards } = {}) {
 }
 
 // packages/core/src/decorators/endpoint.decorator.mts
+import "zod";
 function Endpoint(endpoint) {
   return (target, context) => {
     if (typeof target !== "function") {
@@ -1836,7 +1838,7 @@ function Endpoint(endpoint) {
         );
       }
       endpointMetadata.config = config;
-      endpointMetadata.type = "config" /* Config */;
+      endpointMetadata.type = "endpoint" /* Endpoint */;
       endpointMetadata.classMethod = target.name;
       endpointMetadata.httpMethod = config.method;
       endpointMetadata.url = config.url;
@@ -1852,6 +1854,11 @@ function Header(name2, value) {
       throw new Error("[Navios] Header decorator can only be used on methods.");
     }
     const metadata = getEndpointMetadata(target, context);
+    if (metadata.type === "stream" /* Stream */) {
+      throw new Error(
+        "[Navios] HttpCode decorator cannot be used on stream endpoints."
+      );
+    }
     metadata.headers[name2] = value;
     return target;
   };
@@ -1866,6 +1873,11 @@ function HttpCode(code) {
       );
     }
     const metadata = getEndpointMetadata(target, context);
+    if (metadata.type === "stream" /* Stream */) {
+      throw new Error(
+        "[Navios] HttpCode decorator cannot be used on stream endpoints."
+      );
+    }
     metadata.successStatusCode = code;
     return target;
   };
@@ -1902,6 +1914,37 @@ function Module(metadata) {
   };
 }
 
+// packages/core/src/decorators/stream.decorator.mts
+function Stream(endpoint) {
+  return (target, context) => {
+    if (typeof target !== "function") {
+      throw new Error(
+        "[Navios] Endpoint decorator can only be used on functions."
+      );
+    }
+    if (context.kind !== "method") {
+      throw new Error(
+        "[Navios] Endpoint decorator can only be used on methods."
+      );
+    }
+    const config = endpoint.config;
+    if (context.metadata) {
+      let endpointMetadata = getEndpointMetadata(target, context);
+      if (endpointMetadata.config && endpointMetadata.config.url) {
+        throw new Error(
+          `[Navios] Endpoint ${config.method} ${config.url} already exists. Please use a different method or url.`
+        );
+      }
+      endpointMetadata.config = config;
+      endpointMetadata.type = "stream" /* Stream */;
+      endpointMetadata.classMethod = target.name;
+      endpointMetadata.httpMethod = config.method;
+      endpointMetadata.url = config.url;
+    }
+    return target;
+  };
+}
+
 // packages/core/src/decorators/use-guards.decorator.mts
 function UseGuards(...guards) {
   return function(target, context) {
@@ -2203,12 +2246,18 @@ var _ControllerAdapterService = class _ControllerAdapterService {
           `Unknown endpoint type ${endpointMetadata.type} for ${controller.name}:${endpointMetadata.classMethod}`
         );
         throw new NaviosException4("Unknown endpoint type");
-      case "config" /* Config */:
+      case "endpoint" /* Endpoint */:
         return this.provideHandlerForConfig(
           controller,
           executionContext,
           endpointMetadata
         );
+      case "stream" /* Stream */:
+        return this.provideHandlerForStream(
+          controller,
+          executionContext,
+          endpointMetadata
+        );
       case "handler" /* Handler */:
         this.logger.error("Not implemented yet");
         throw new NaviosException4("Not implemented yet");
@@ -2246,6 +2295,37 @@ var _ControllerAdapterService = class _ControllerAdapterService {
       }
     };
   }
+  provideHandlerForStream(controller, executionContext, endpointMetadata) {
+    return async (request, reply) => {
+      getServiceLocator().registerInstance(Request, request);
+      getServiceLocator().registerInstance(Reply, reply);
+      getServiceLocator().registerInstance(
+        ExecutionContextToken,
+        executionContext
+      );
+      executionContext.provideRequest(request);
+      executionContext.provideReply(reply);
+      const controllerInstance = await inject(controller);
+      try {
+        const { query, params, body } = request;
+        const argument = {};
+        if (query && Object.keys(query).length > 0) {
+          argument.params = query;
+        }
+        if (params && Object.keys(params).length > 0) {
+          argument.urlParams = params;
+        }
+        if (body) {
+          argument.data = body;
+        }
+        await controllerInstance[endpointMetadata.classMethod](argument, reply);
+      } finally {
+        getServiceLocator().removeInstance(Request);
+        getServiceLocator().removeInstance(Reply);
+        getServiceLocator().removeInstance(ExecutionContextToken);
+      }
+    };
+  }
 };
 _init6 = __decoratorStart(null);
 _ControllerAdapterService = __decorateElement(_init6, 0, "ControllerAdapterService", _ControllerAdapterService_decorators, _ControllerAdapterService);
@@ -2617,6 +2697,7 @@ export {
   ServiceLocatorInstanceHolderKind,
   ServiceLocatorInstanceHolderStatus,
   ServiceLocatorManager,
+  Stream,
   UnauthorizedException,
   UnknownError,
   UseGuards,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@navios/core",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "author": {
     "name": "Oleksandr Hanzha",
     "email": "alex@granted.name"
@@ -15,7 +15,7 @@
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "peerDependencies": {
-    "@navios/common": "^0.1.1",
+    "@navios/common": "^0.1.2",
     "zod": "^3.23.8"
   },
   "exports": {
@@ -32,7 +32,7 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@navios/common": "^0.1.1",
+    "@navios/common": "^0.1.2",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "zod": "^3.24.4"

package/src/decorators/endpoint.decorator.mts

@@ -5,6 +5,8 @@ import type {
 } from '@navios/common'
 import type { AnyZodObject, z, ZodType } from 'zod'
 
+import { ZodDiscriminatedUnion } from 'zod'
+
 import { EndpointType, getEndpointMetadata } from '../metadata/index.mjs'
 
 export type EndpointParams<
@@ -29,6 +31,18 @@ export type EndpointParams<
       >
     : EndpointFunctionArgs<Url, undefined, undefined>
 
+export type EndpointResult<
+  EndpointDeclaration extends {
+    config: BaseEndpointConfig<any, any, any, any, any>
+  },
+> =
+  EndpointDeclaration['config']['responseSchema'] extends ZodDiscriminatedUnion<
+    any,
+    infer Options
+  >
+    ? Promise<z.input<Options[number]>>
+    : Promise<z.input<EndpointDeclaration['config']['responseSchema']>>
+
 export function Endpoint<
   Method extends HttpMethod = HttpMethod,
   Url extends string = string,
@@ -76,7 +90,7 @@ export function Endpoint<
       }
       // @ts-expect-error We don't need to set correctly in the metadata
       endpointMetadata.config = config
-      endpointMetadata.type = EndpointType.Config
+      endpointMetadata.type = EndpointType.Endpoint
       endpointMetadata.classMethod = target.name
       endpointMetadata.httpMethod = config.method
       endpointMetadata.url = config.url

package/src/decorators/header.decorator.mts

@@ -1,6 +1,6 @@
 import type { HttpHeader } from 'fastify/types/utils.js'
 
-import { getEndpointMetadata } from '../metadata/index.mjs'
+import { EndpointType, getEndpointMetadata } from '../metadata/index.mjs'
 
 export function Header(name: HttpHeader, value: string | number | string[]) {
   return <T extends Function>(
@@ -11,6 +11,12 @@ export function Header(name: HttpHeader, value: string | number | string[]) {
       throw new Error('[Navios] Header decorator can only be used on methods.')
     }
     const metadata = getEndpointMetadata(target, context)
+    if (metadata.type === EndpointType.Stream) {
+      throw new Error(
+        '[Navios] HttpCode decorator cannot be used on stream endpoints.',
+      )
+    }
+
     metadata.headers[name] = value
 
     return target

package/src/decorators/http-code.decorator.mts

@@ -1,4 +1,4 @@
-import { getEndpointMetadata } from '../metadata/index.mjs'
+import { EndpointType, getEndpointMetadata } from '../metadata/index.mjs'
 
 export function HttpCode(code: number) {
   return <T extends Function>(
@@ -11,6 +11,11 @@ export function HttpCode(code: number) {
       )
     }
     const metadata = getEndpointMetadata(target, context)
+    if (metadata.type === EndpointType.Stream) {
+      throw new Error(
+        '[Navios] HttpCode decorator cannot be used on stream endpoints.',
+      )
+    }
     metadata.successStatusCode = code
 
     return target

package/src/decorators/index.mts

@@ -3,4 +3,5 @@ export * from './endpoint.decorator.mjs'
 export * from './header.decorator.mjs'
 export * from './http-code.decorator.mjs'
 export * from './module.decorator.mjs'
+export * from './stream.decorator.mjs'
 export * from './use-guards.decorator.mjs'

package/src/decorators/stream.decorator.mts

@@ -0,0 +1,81 @@
+import type {
+  BaseStreamConfig,
+  EndpointFunctionArgs,
+  HttpMethod,
+} from '@navios/common'
+import type { FastifyReply } from 'fastify'
+import type { AnyZodObject, ZodType } from 'zod'
+
+import { EndpointType, getEndpointMetadata } from '../metadata/index.mjs'
+
+export type StreamParams<
+  EndpointDeclaration extends {
+    config: BaseStreamConfig<any, any, any, any>
+  },
+  Url extends string = EndpointDeclaration['config']['url'],
+  QuerySchema = EndpointDeclaration['config']['querySchema'],
+> = QuerySchema extends AnyZodObject
+  ? EndpointDeclaration['config']['requestSchema'] extends ZodType
+    ? EndpointFunctionArgs<
+        Url,
+        QuerySchema,
+        EndpointDeclaration['config']['requestSchema']
+      >
+    : EndpointFunctionArgs<Url, QuerySchema, undefined>
+  : EndpointDeclaration['config']['requestSchema'] extends ZodType
+    ? EndpointFunctionArgs<
+        Url,
+        undefined,
+        EndpointDeclaration['config']['requestSchema']
+      >
+    : EndpointFunctionArgs<Url, undefined, undefined>
+
+export function Stream<
+  Method extends HttpMethod = HttpMethod,
+  Url extends string = string,
+  QuerySchema = undefined,
+  RequestSchema = ZodType,
+>(endpoint: {
+  config: BaseStreamConfig<Method, Url, QuerySchema, RequestSchema>
+}) {
+  return (
+    target: (
+      params: QuerySchema extends AnyZodObject
+        ? RequestSchema extends ZodType
+          ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema>
+          : EndpointFunctionArgs<Url, QuerySchema, undefined>
+        : RequestSchema extends ZodType
+          ? EndpointFunctionArgs<Url, undefined, RequestSchema>
+          : EndpointFunctionArgs<Url, undefined, undefined>,
+      reply: FastifyReply,
+    ) => Promise<void>,
+    context: ClassMethodDecoratorContext,
+  ) => {
+    if (typeof target !== 'function') {
+      throw new Error(
+        '[Navios] Endpoint decorator can only be used on functions.',
+      )
+    }
+    if (context.kind !== 'method') {
+      throw new Error(
+        '[Navios] Endpoint decorator can only be used on methods.',
+      )
+    }
+    const config = endpoint.config
+    if (context.metadata) {
+      let endpointMetadata = getEndpointMetadata(target, context)
+      if (endpointMetadata.config && endpointMetadata.config.url) {
+        throw new Error(
+          `[Navios] Endpoint ${config.method} ${config.url} already exists. Please use a different method or url.`,
+        )
+      }
+      // @ts-expect-error We don't need to set correctly in the metadata
+      endpointMetadata.config = config
+      endpointMetadata.type = EndpointType.Stream
+      endpointMetadata.classMethod = target.name
+      endpointMetadata.httpMethod = config.method
+      endpointMetadata.url = config.url
+    }
+    return target
+  }
+}

package/src/metadata/endpoint.metadata.mts

@@ -1,4 +1,8 @@
-import type { BaseEndpointConfig, HttpMethod } from '@navios/common'
+import type {
+  BaseEndpointConfig,
+  BaseStreamConfig,
+  HttpMethod,
+} from '@navios/common'
 import type { HttpHeader } from 'fastify/types/utils.js'
 
 import type { CanActivate } from '../interfaces/index.mjs'
@@ -11,7 +15,8 @@ export const EndpointMetadataKey = Symbol('EndpointMetadataKey')
 
 export enum EndpointType {
   Unknown = 'unknown',
-  Config = 'config',
+  Endpoint = 'endpoint',
+  Stream = 'stream',
   Handler = 'handler',
 }
 
@@ -22,7 +27,7 @@ export interface EndpointMetadata {
   type: EndpointType
   headers: Partial<Record<HttpHeader, number | string | string[] | undefined>>
   httpMethod: HttpMethod
-  config: BaseEndpointConfig | null
+  config: BaseEndpointConfig | BaseStreamConfig | null
   guards: Set<
     ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>
   >

package/src/metadata/module.metadata.mts

@@ -50,7 +50,7 @@ export function extractModuleMetadata(target: ClassType): ModuleMetadata {
   const metadata = target[ModuleMetadataKey] as ModuleMetadata | undefined
   if (!metadata) {
     throw new Error(
-      '[Navios] Module metadata not found. Make sure to use @Module decorator.',
+      `[Navios] Module metadata not found for ${target.name}. Make sure to use @Module decorator.`,
     )
   }
   return metadata

package/src/services/controller-adapter.service.mts

@@ -1,3 +1,4 @@
+import type { BaseEndpointConfig } from '@navios/common'
 import type { FastifyInstance, FastifyReply, FastifyRequest } from 'fastify'
 import type { ZodTypeProvider } from 'fastify-type-provider-zod'
 
@@ -94,7 +95,7 @@ export class ControllerAdapterService {
       return {}
     }
     const { querySchema, requestSchema, responseSchema } =
-      endpointMetadata.config
+      endpointMetadata.config as BaseEndpointConfig
     const schema: Record<string, any> = {}
     if (querySchema) {
       schema.querystring = querySchema
@@ -122,12 +123,18 @@ export class ControllerAdapterService {
           `Unknown endpoint type ${endpointMetadata.type} for ${controller.name}:${endpointMetadata.classMethod}`,
         )
         throw new NaviosException('Unknown endpoint type')
-      case EndpointType.Config:
+      case EndpointType.Endpoint:
         return this.provideHandlerForConfig(
           controller,
           executionContext,
           endpointMetadata,
         )
+      case EndpointType.Stream:
+        return this.provideHandlerForStream(
+          controller,
+          executionContext,
+          endpointMetadata,
+        )
       case EndpointType.Handler:
         this.logger.error('Not implemented yet')
         throw new NaviosException('Not implemented yet')
@@ -174,4 +181,41 @@ export class ControllerAdapterService {
       }
     }
   }
+
+  private provideHandlerForStream(
+    controller: ClassType,
+    executionContext: ExecutionContext,
+    endpointMetadata: EndpointMetadata,
+  ): (request: FastifyRequest, reply: FastifyReply) => Promise<void> {
+    return async (request, reply) => {
+      getServiceLocator().registerInstance(Request, request)
+      getServiceLocator().registerInstance(Reply, reply)
+      getServiceLocator().registerInstance(
+        ExecutionContextToken,
+        executionContext,
+      )
+      executionContext.provideRequest(request)
+      executionContext.provideReply(reply)
+      const controllerInstance = await inject(controller)
+      try {
+        const { query, params, body } = request
+        const argument: Record<string, any> = {}
+        if (query && Object.keys(query).length > 0) {
+          argument.params = query
+        }
+        if (params && Object.keys(params).length > 0) {
+          argument.urlParams = params
+        }
+        if (body) {
+          argument.data = body
+        }
+
+        await controllerInstance[endpointMetadata.classMethod](argument, reply)
+      } finally {
+        getServiceLocator().removeInstance(Request)
+        getServiceLocator().removeInstance(Reply)
+        getServiceLocator().removeInstance(ExecutionContextToken)
+      }
+    }
+  }
 }