@navios/core 0.5.1 → 0.7.0

package/src/legacy-compat/decorators/endpoint.decorator.mts

@@ -0,0 +1,99 @@
+import type {
+  BaseEndpointConfig,
+  EndpointFunctionArgs,
+  HttpMethod,
+} from '@navios/builder'
+import type { z, ZodType } from 'zod/v4'
+
+import { Endpoint as OriginalEndpoint } from '../../decorators/endpoint.decorator.mjs'
+import { createMethodContext } from '../context-compat.mjs'
+
+/**
+ * Type helper to constrain a PropertyDescriptor's value to match an endpoint signature.
+ * Note: In legacy decorators, type constraints are checked when the decorator is applied,
+ * but may not be preserved perfectly when decorators are stacked.
+ */
+type EndpointMethodDescriptor<
+  Url extends string,
+  QuerySchema,
+  RequestSchema,
+  ResponseSchema extends ZodType,
+> = TypedPropertyDescriptor<
+  (
+    params: QuerySchema extends ZodType
+      ? RequestSchema extends ZodType
+        ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema, true>
+        : EndpointFunctionArgs<Url, QuerySchema, undefined, true>
+      : RequestSchema extends ZodType
+        ? EndpointFunctionArgs<Url, undefined, RequestSchema, true>
+        : EndpointFunctionArgs<Url, undefined, undefined, true>,
+  ) => Promise<z.input<ResponseSchema>>
+>
+
+/**
+ * Legacy-compatible Endpoint decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ * Provides type safety by ensuring method signatures match the endpoint configuration.
+ *
+ * @param endpoint - The endpoint declaration from @navios/builder
+ * @returns A method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Controller()
+ * export class UserController {
+ *   @Endpoint(getUserEndpoint)
+ *   async getUser(request: EndpointParams<typeof getUserEndpoint>): EndpointResult<typeof getUserEndpoint> {
+ *     return { id: '1', name: 'John' }
+ *   }
+ * }
+ * ```
+ */
+export function Endpoint<
+  Method extends HttpMethod = HttpMethod,
+  Url extends string = string,
+  QuerySchema = undefined,
+  ResponseSchema extends ZodType = ZodType,
+  RequestSchema = ZodType,
+>(endpoint: {
+  config: BaseEndpointConfig<
+    Method,
+    Url,
+    QuerySchema,
+    ResponseSchema,
+    RequestSchema
+  >
+}) {
+  return function (
+    target: any,
+    propertyKey: string | symbol,
+    descriptor: EndpointMethodDescriptor<
+      Url,
+      QuerySchema,
+      RequestSchema,
+      ResponseSchema
+    >,
+  ): PropertyDescriptor | void {
+    if (!descriptor) {
+      throw new Error(
+        '[Navios] @Endpoint decorator requires a method descriptor. Make sure experimentalDecorators is enabled.',
+      )
+    }
+    // Type check the descriptor value matches expected signature
+    const typedDescriptor = descriptor as EndpointMethodDescriptor<
+      Url,
+      QuerySchema,
+      RequestSchema,
+      ResponseSchema
+    >
+    const context = createMethodContext(target, propertyKey, typedDescriptor)
+    const originalDecorator = OriginalEndpoint(endpoint)
+    // @ts-expect-error - we don't need to type the value
+    const result = originalDecorator(typedDescriptor.value, context)
+    if (result !== typedDescriptor.value) {
+      typedDescriptor.value = result
+    }
+    return typedDescriptor
+  }
+}

package/src/legacy-compat/decorators/header.decorator.d.mts

@@ -0,0 +1,24 @@
+import type { HttpHeader } from '../../interfaces/index.mjs';
+/**
+ * Legacy-compatible Header decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ *
+ * @param name - The header name (e.g., 'Content-Type', 'Cache-Control')
+ * @param value - The header value (string, number, or array of strings)
+ * @returns A method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Controller()
+ * export class UserController {
+ *   @Endpoint(getUserEndpoint)
+ *   @Header('Cache-Control', 'max-age=3600')
+ *   async getUser() {
+ *     return { id: '1', name: 'John' }
+ *   }
+ * }
+ * ```
+ */
+export declare function Header(name: HttpHeader, value: string | number | string[]): <T extends object>(target: T, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=header.decorator.d.mts.map

package/src/legacy-compat/decorators/header.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.decorator.d.mts","sourceRoot":"","sources":["header.decorator.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAK5D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,IACvD,CAAC,SAAS,MAAM,EAC/B,QAAQ,CAAC,EACT,aAAa,MAAM,GAAG,MAAM,EAC5B,YAAY,kBAAkB,wBAUjC"}

package/src/legacy-compat/decorators/header.decorator.mts

@@ -0,0 +1,42 @@
+import type { HttpHeader } from '../../interfaces/index.mjs'
+
+import { Header as OriginalHeader } from '../../decorators/header.decorator.mjs'
+import { createMethodContext } from '../context-compat.mjs'
+
+/**
+ * Legacy-compatible Header decorator.
+ * 
+ * Works with TypeScript experimental decorators (legacy API).
+ * 
+ * @param name - The header name (e.g., 'Content-Type', 'Cache-Control')
+ * @param value - The header value (string, number, or array of strings)
+ * @returns A method decorator compatible with legacy decorator API
+ * 
+ * @example
+ * ```typescript
+ * @Controller()
+ * export class UserController {
+ *   @Endpoint(getUserEndpoint)
+ *   @Header('Cache-Control', 'max-age=3600')
+ *   async getUser() {
+ *     return { id: '1', name: 'John' }
+ *   }
+ * }
+ * ```
+ */
+export function Header(name: HttpHeader, value: string | number | string[]) {
+  return function <T extends object>(
+    target: T,
+    propertyKey: string | symbol,
+    descriptor: PropertyDescriptor,
+  ) {
+    const context = createMethodContext(target, propertyKey, descriptor)
+    const originalDecorator = OriginalHeader(name, value)
+    const result = originalDecorator(descriptor.value, context)
+    if (result !== descriptor.value) {
+      descriptor.value = result
+    }
+    return descriptor
+  }
+}
+

package/src/legacy-compat/decorators/http-code.decorator.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Legacy-compatible HttpCode decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ *
+ * @param code - The HTTP status code to return (e.g., 201, 204, 202)
+ * @returns A method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Controller()
+ * export class UserController {
+ *   @Endpoint(createUserEndpoint)
+ *   @HttpCode(201)
+ *   async createUser() {
+ *     return { id: '1', name: 'John' }
+ *   }
+ * }
+ * ```
+ */
+export declare function HttpCode(code: number): <T extends object>(target: T, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=http-code.decorator.d.mts.map

package/src/legacy-compat/decorators/http-code.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-code.decorator.d.mts","sourceRoot":"","sources":["http-code.decorator.mts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,IAClB,CAAC,SAAS,MAAM,EAC/B,QAAQ,CAAC,EACT,aAAa,MAAM,GAAG,MAAM,EAC5B,YAAY,kBAAkB,wBAUjC"}

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

@@ -0,0 +1,38 @@
+import { HttpCode as OriginalHttpCode } from '../../decorators/http-code.decorator.mjs'
+import { createMethodContext } from '../context-compat.mjs'
+
+/**
+ * Legacy-compatible HttpCode decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ *
+ * @param code - The HTTP status code to return (e.g., 201, 204, 202)
+ * @returns A method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Controller()
+ * export class UserController {
+ *   @Endpoint(createUserEndpoint)
+ *   @HttpCode(201)
+ *   async createUser() {
+ *     return { id: '1', name: 'John' }
+ *   }
+ * }
+ * ```
+ */
+export function HttpCode(code: number) {
+  return function <T extends object>(
+    target: T,
+    propertyKey: string | symbol,
+    descriptor: PropertyDescriptor,
+  ) {
+    const context = createMethodContext(target, propertyKey, descriptor)
+    const originalDecorator = OriginalHttpCode(code)
+    const result = originalDecorator(descriptor.value, context)
+    if (result !== descriptor.value) {
+      descriptor.value = result
+    }
+    return descriptor
+  }
+}

package/src/legacy-compat/decorators/index.d.mts

@@ -0,0 +1,9 @@
+export * from './module.decorator.mjs';
+export * from './controller.decorator.mjs';
+export * from './endpoint.decorator.mjs';
+export * from './use-guards.decorator.mjs';
+export * from './header.decorator.mjs';
+export * from './http-code.decorator.mjs';
+export * from './multipart.decorator.mjs';
+export * from './stream.decorator.mjs';
+//# sourceMappingURL=index.d.mts.map

package/src/legacy-compat/decorators/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["index.mts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA"}

package/src/legacy-compat/decorators/index.mts

@@ -0,0 +1,9 @@
+export * from './module.decorator.mjs'
+export * from './controller.decorator.mjs'
+export * from './endpoint.decorator.mjs'
+export * from './use-guards.decorator.mjs'
+export * from './header.decorator.mjs'
+export * from './http-code.decorator.mjs'
+export * from './multipart.decorator.mjs'
+export * from './stream.decorator.mjs'
+

package/src/legacy-compat/decorators/module.decorator.d.mts

@@ -0,0 +1,22 @@
+import type { ClassType } from '@navios/di';
+import { type ModuleOptions } from '../../decorators/module.decorator.mjs';
+/**
+ * Legacy-compatible Module decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ *
+ * @param options - Module configuration options
+ * @returns A class decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   controllers: [UserController, AuthController],
+ *   imports: [DatabaseModule],
+ *   guards: [AuthGuard],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare function Module(options?: ModuleOptions): (target: ClassType) => ClassType;
+//# sourceMappingURL=module.decorator.d.mts.map

package/src/legacy-compat/decorators/module.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.decorator.d.mts","sourceRoot":"","sources":["module.decorator.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,uCAAuC,CAAA;AAGpG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CACpB,OAAO,GAAE,aAIR,IAEgB,QAAQ,SAAS,eAKnC"}

package/src/legacy-compat/decorators/module.decorator.mts

@@ -0,0 +1,37 @@
+import type { ClassType } from '@navios/di'
+
+import { Module as OriginalModule, type ModuleOptions } from '../../decorators/module.decorator.mjs'
+import { createClassContext } from '../context-compat.mjs'
+
+/**
+ * Legacy-compatible Module decorator.
+ * 
+ * Works with TypeScript experimental decorators (legacy API).
+ * 
+ * @param options - Module configuration options
+ * @returns A class decorator compatible with legacy decorator API
+ * 
+ * @example
+ * ```typescript
+ * @Module({
+ *   controllers: [UserController, AuthController],
+ *   imports: [DatabaseModule],
+ *   guards: [AuthGuard],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export function Module(
+  options: ModuleOptions = {
+    controllers: [],
+    imports: [],
+    guards: [],
+  },
+) {
+  return function (target: ClassType) {
+    const context = createClassContext(target)
+    const originalDecorator = OriginalModule(options)
+    return originalDecorator(target, context)
+  }
+}
+

package/src/legacy-compat/decorators/multipart.decorator.d.mts

@@ -0,0 +1,34 @@
+import type { BaseEndpointConfig, EndpointFunctionArgs, HttpMethod } from '@navios/builder';
+import type { z, ZodObject, ZodType } from 'zod/v4';
+/**
+ * Type helper to constrain a PropertyDescriptor's value to match a multipart endpoint signature.
+ * Note: In legacy decorators, type constraints are checked when the decorator is applied,
+ * but may not be preserved perfectly when decorators are stacked.
+ */
+type MultipartMethodDescriptor<Url extends string, QuerySchema, RequestSchema, ResponseSchema extends ZodType> = TypedPropertyDescriptor<(params: QuerySchema extends ZodObject ? RequestSchema extends ZodType ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema> : EndpointFunctionArgs<Url, QuerySchema, undefined> : RequestSchema extends ZodType ? EndpointFunctionArgs<Url, undefined, RequestSchema> : EndpointFunctionArgs<Url, undefined, undefined>) => Promise<z.input<ResponseSchema>>>;
+/**
+ * Legacy-compatible Multipart decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ * Provides type safety by ensuring method signatures match the endpoint configuration.
+ *
+ * @param endpoint - The multipart endpoint declaration from @navios/builder
+ * @returns A method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Controller()
+ * export class FileController {
+ *   @Multipart(uploadFileEndpoint)
+ *   async uploadFile(request: MultipartParams<typeof uploadFileEndpoint>): MultipartResult<typeof uploadFileEndpoint> {
+ *     const { file } = request.data
+ *     return { url: 'https://example.com/file.jpg' }
+ *   }
+ * }
+ * ```
+ */
+export declare function Multipart<Method extends HttpMethod = HttpMethod, Url extends string = string, QuerySchema = undefined, ResponseSchema extends ZodType = ZodType, RequestSchema = ZodType>(endpoint: {
+    config: BaseEndpointConfig<Method, Url, QuerySchema, ResponseSchema, RequestSchema>;
+}): <T extends object>(target: T, propertyKey: string | symbol, descriptor: MultipartMethodDescriptor<Url, QuerySchema, RequestSchema, ResponseSchema>) => PropertyDescriptor | void;
+
+//# sourceMappingURL=multipart.decorator.d.mts.map

package/src/legacy-compat/decorators/multipart.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.decorator.d.mts","sourceRoot":"","sources":["multipart.decorator.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACX,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAKnD;;;;GAIG;AACH,KAAK,yBAAyB,CAC5B,GAAG,SAAS,MAAM,EAClB,WAAW,EACX,aAAa,EACb,cAAc,SAAS,OAAO,IAC5B,uBAAuB,CACzB,CACE,MAAM,EAAE,WAAW,SAAS,SAAS,GACjC,aAAa,SAAS,OAAO,GAC3B,oBAAoB,CAAC,GAAG,EAAE,WAAW,EAAE,aAAa,CAAC,GACrD,oBAAoB,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,GACnD,aAAa,SAAS,OAAO,GAC3B,oBAAoB,CAAC,GAAG,EAAE,SAAS,EAAE,aAAa,CAAC,GACnD,oBAAoB,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,KAClD,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CACtC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CACvB,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,GAAG,SAAS,MAAM,GAAG,MAAM,EAC3B,WAAW,GAAG,SAAS,EACvB,cAAc,SAAS,OAAO,GAAG,OAAO,EACxC,aAAa,GAAG,OAAO,EACvB,QAAQ,EAAE;IACV,MAAM,EAAE,kBAAkB,CACxB,MAAM,EACN,GAAG,EACH,WAAW,EACX,cAAc,EACd,aAAa,CACd,CAAA;CACF,IACkB,CAAC,SAAS,MAAM,EAC/B,QAAQ,CAAC,EACT,aAAa,MAAM,GAAG,MAAM,EAC5B,YAAY,yBAAyB,CACnC,GAAG,EACH,WAAW,EACX,aAAa,EACb,cAAc,CACf,KACA,kBAAkB,GAAG,IAAI,CAe7B"}

package/src/legacy-compat/decorators/multipart.decorator.mts

@@ -0,0 +1,93 @@
+import type {
+  BaseEndpointConfig,
+  EndpointFunctionArgs,
+  HttpMethod,
+} from '@navios/builder'
+import type { z, ZodObject, ZodType } from 'zod/v4'
+
+import { Multipart as OriginalMultipart } from '../../decorators/multipart.decorator.mjs'
+import { createMethodContext } from '../context-compat.mjs'
+
+/**
+ * Type helper to constrain a PropertyDescriptor's value to match a multipart endpoint signature.
+ * Note: In legacy decorators, type constraints are checked when the decorator is applied,
+ * but may not be preserved perfectly when decorators are stacked.
+ */
+type MultipartMethodDescriptor<
+  Url extends string,
+  QuerySchema,
+  RequestSchema,
+  ResponseSchema extends ZodType,
+> = TypedPropertyDescriptor<
+  (
+    params: QuerySchema extends ZodObject
+      ? RequestSchema extends ZodType
+        ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema>
+        : EndpointFunctionArgs<Url, QuerySchema, undefined>
+      : RequestSchema extends ZodType
+        ? EndpointFunctionArgs<Url, undefined, RequestSchema>
+        : EndpointFunctionArgs<Url, undefined, undefined>,
+  ) => Promise<z.input<ResponseSchema>>
+>
+
+/**
+ * Legacy-compatible Multipart decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ * Provides type safety by ensuring method signatures match the endpoint configuration.
+ *
+ * @param endpoint - The multipart endpoint declaration from @navios/builder
+ * @returns A method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Controller()
+ * export class FileController {
+ *   @Multipart(uploadFileEndpoint)
+ *   async uploadFile(request: MultipartParams<typeof uploadFileEndpoint>): MultipartResult<typeof uploadFileEndpoint> {
+ *     const { file } = request.data
+ *     return { url: 'https://example.com/file.jpg' }
+ *   }
+ * }
+ * ```
+ */
+export function Multipart<
+  Method extends HttpMethod = HttpMethod,
+  Url extends string = string,
+  QuerySchema = undefined,
+  ResponseSchema extends ZodType = ZodType,
+  RequestSchema = ZodType,
+>(endpoint: {
+  config: BaseEndpointConfig<
+    Method,
+    Url,
+    QuerySchema,
+    ResponseSchema,
+    RequestSchema
+  >
+}) {
+  return function <T extends object>(
+    target: T,
+    propertyKey: string | symbol,
+    descriptor: MultipartMethodDescriptor<
+      Url,
+      QuerySchema,
+      RequestSchema,
+      ResponseSchema
+    >,
+  ): PropertyDescriptor | void {
+    if (!descriptor) {
+      throw new Error(
+        '[Navios] @Multipart decorator requires a method descriptor. Make sure experimentalDecorators is enabled.',
+      )
+    }
+    const context = createMethodContext(target, propertyKey, descriptor)
+    const originalDecorator = OriginalMultipart(endpoint)
+    // @ts-expect-error - we don't need to type the value
+    const result = originalDecorator(descriptor.value, context)
+    if (result !== descriptor.value) {
+      descriptor.value = result
+    }
+    return descriptor
+  }
+}

package/src/legacy-compat/decorators/stream.decorator.d.mts

@@ -0,0 +1,34 @@
+import type { BaseStreamConfig, EndpointFunctionArgs, HttpMethod } from '@navios/builder';
+import type { ZodObject, ZodType } from 'zod/v4';
+/**
+ * Type helper to constrain a PropertyDescriptor's value to match a stream endpoint signature.
+ * Note: In legacy decorators, type constraints are checked when the decorator is applied,
+ * but may not be preserved perfectly when decorators are stacked.
+ */
+type StreamMethodDescriptor<Url extends string, QuerySchema, RequestSchema> = TypedPropertyDescriptor<(params: QuerySchema extends ZodObject ? RequestSchema extends ZodType ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema> : EndpointFunctionArgs<Url, QuerySchema, undefined> : RequestSchema extends ZodType ? EndpointFunctionArgs<Url, undefined, RequestSchema> : EndpointFunctionArgs<Url, undefined, undefined>, reply: any) => Promise<void>>;
+/**
+ * Legacy-compatible Stream decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ * Provides type safety by ensuring method signatures match the endpoint configuration.
+ *
+ * @param endpoint - The stream endpoint declaration from @navios/builder
+ * @returns A method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Controller()
+ * export class FileController {
+ *   @Stream(downloadFileEndpoint)
+ *   async downloadFile(request: StreamParams<typeof downloadFileEndpoint>, reply: any) {
+ *     const { fileId } = request.urlParams
+ *     // Stream file data to reply
+ *   }
+ * }
+ * ```
+ */
+export declare function Stream<Method extends HttpMethod = HttpMethod, Url extends string = string, QuerySchema = undefined, RequestSchema = ZodType>(endpoint: {
+    config: BaseStreamConfig<Method, Url, QuerySchema, RequestSchema>;
+}): <T extends object>(target: T, propertyKey: string | symbol, descriptor: StreamMethodDescriptor<Url, QuerySchema, RequestSchema>) => StreamMethodDescriptor<Url, QuerySchema, RequestSchema>;
+
+//# sourceMappingURL=stream.decorator.d.mts.map

package/src/legacy-compat/decorators/stream.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.decorator.d.mts","sourceRoot":"","sources":["stream.decorator.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACX,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAKhD;;;;GAIG;AACH,KAAK,sBAAsB,CACzB,GAAG,SAAS,MAAM,EAClB,WAAW,EACX,aAAa,IACX,uBAAuB,CACzB,CACE,MAAM,EAAE,WAAW,SAAS,SAAS,GACjC,aAAa,SAAS,OAAO,GAC3B,oBAAoB,CAAC,GAAG,EAAE,WAAW,EAAE,aAAa,CAAC,GACrD,oBAAoB,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,GACnD,aAAa,SAAS,OAAO,GAC3B,oBAAoB,CAAC,GAAG,EAAE,SAAS,EAAE,aAAa,CAAC,GACnD,oBAAoB,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,EACrD,KAAK,EAAE,GAAG,KACP,OAAO,CAAC,IAAI,CAAC,CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CACpB,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,GAAG,SAAS,MAAM,GAAG,MAAM,EAC3B,WAAW,GAAG,SAAS,EACvB,aAAa,GAAG,OAAO,EACvB,QAAQ,EAAE;IACV,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,aAAa,CAAC,CAAA;CAClE,IACkB,CAAC,SAAS,MAAM,EAC/B,QAAQ,CAAC,EACT,aAAa,MAAM,GAAG,MAAM,EAC5B,YAAY,sBAAsB,CAAC,GAAG,EAAE,WAAW,EAAE,aAAa,CAAC,6DAWtE"}

package/src/legacy-compat/decorators/stream.decorator.mts

@@ -0,0 +1,76 @@
+import type {
+  BaseStreamConfig,
+  EndpointFunctionArgs,
+  HttpMethod,
+} from '@navios/builder'
+import type { ZodObject, ZodType } from 'zod/v4'
+
+import { Stream as OriginalStream } from '../../decorators/stream.decorator.mjs'
+import { createMethodContext } from '../context-compat.mjs'
+
+/**
+ * Type helper to constrain a PropertyDescriptor's value to match a stream endpoint signature.
+ * Note: In legacy decorators, type constraints are checked when the decorator is applied,
+ * but may not be preserved perfectly when decorators are stacked.
+ */
+type StreamMethodDescriptor<
+  Url extends string,
+  QuerySchema,
+  RequestSchema,
+> = TypedPropertyDescriptor<
+  (
+    params: QuerySchema extends ZodObject
+      ? RequestSchema extends ZodType
+        ? EndpointFunctionArgs<Url, QuerySchema, RequestSchema>
+        : EndpointFunctionArgs<Url, QuerySchema, undefined>
+      : RequestSchema extends ZodType
+        ? EndpointFunctionArgs<Url, undefined, RequestSchema>
+        : EndpointFunctionArgs<Url, undefined, undefined>,
+    reply: any,
+  ) => Promise<void>
+>
+
+/**
+ * Legacy-compatible Stream decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ * Provides type safety by ensuring method signatures match the endpoint configuration.
+ *
+ * @param endpoint - The stream endpoint declaration from @navios/builder
+ * @returns A method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Controller()
+ * export class FileController {
+ *   @Stream(downloadFileEndpoint)
+ *   async downloadFile(request: StreamParams<typeof downloadFileEndpoint>, reply: any) {
+ *     const { fileId } = request.urlParams
+ *     // Stream file data to reply
+ *   }
+ * }
+ * ```
+ */
+export function Stream<
+  Method extends HttpMethod = HttpMethod,
+  Url extends string = string,
+  QuerySchema = undefined,
+  RequestSchema = ZodType,
+>(endpoint: {
+  config: BaseStreamConfig<Method, Url, QuerySchema, RequestSchema>
+}) {
+  return function <T extends object>(
+    target: T,
+    propertyKey: string | symbol,
+    descriptor: StreamMethodDescriptor<Url, QuerySchema, RequestSchema>,
+  ) {
+    const context = createMethodContext(target, propertyKey, descriptor)
+    const originalDecorator = OriginalStream(endpoint)
+    // @ts-expect-error - we don't need to type the value
+    const result = originalDecorator(descriptor.value, context)
+    if (result !== descriptor.value) {
+      descriptor.value = result
+    }
+    return descriptor
+  }
+}

package/src/legacy-compat/decorators/use-guards.decorator.d.mts

@@ -0,0 +1,29 @@
+import type { ClassTypeWithInstance, InjectionToken } from '@navios/di';
+import type { CanActivate } from '../../interfaces/index.mjs';
+/**
+ * Legacy-compatible UseGuards decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ * Can be applied to classes or methods.
+ *
+ * @param guards - Guard classes or injection tokens to apply
+ * @returns A class or method decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * // Apply to a controller
+ * @Controller()
+ * @UseGuards(AuthGuard, RoleGuard)
+ * export class UserController { }
+ *
+ * // Apply to a specific endpoint
+ * @Controller()
+ * export class UserController {
+ *   @Endpoint(getUserEndpoint)
+ *   @UseGuards(AuthGuard)
+ *   async getUser() { }
+ * }
+ * ```
+ */
+export declare function UseGuards(...guards: (ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>)[]): any;
+//# sourceMappingURL=use-guards.decorator.d.mts.map

package/src/legacy-compat/decorators/use-guards.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-guards.decorator.d.mts","sourceRoot":"","sources":["use-guards.decorator.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,cAAc,EACf,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAK7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CACvB,GAAG,MAAM,EAAE,CACP,qBAAqB,CAAC,WAAW,CAAC,GAClC,cAAc,CAAC,WAAW,EAAE,SAAS,CAAC,CACzC,EAAE,GAsCqB,GAAG,CAC5B"}