@navios/core 0.6.0 → 0.7.1

package/lib/legacy-compat/index.d.mts

@@ -0,0 +1,219 @@
+import { $ as CanActivate, B as MultipartResult, H as ModuleOptions, Jt as EndpointParams, L as StreamParams, Yt as EndpointResult, Z as HttpHeader, Zt as ControllerOptions, z as MultipartParams } from "../index-DW9EPAE6.mjs";
+import { ClassType, ClassTypeWithInstance, InjectionToken } from "@navios/di";
+import { ZodObject, ZodType, z as z$1 } from "zod/v4";
+import { BaseEndpointConfig, BaseStreamConfig, EndpointFunctionArgs, HttpMethod } from "@navios/builder";
+
+//#region src/legacy-compat/decorators/module.decorator.d.mts
+
+/**
+ * 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 {}
+ * ```
+ */
+declare function Module(options?: ModuleOptions): (target: ClassType) => ClassType;
+//#endregion
+//#region src/legacy-compat/decorators/controller.decorator.d.mts
+/**
+ * Legacy-compatible Controller decorator.
+ *
+ * Works with TypeScript experimental decorators (legacy API).
+ *
+ * @param options - Controller configuration options
+ * @returns A class decorator compatible with legacy decorator API
+ *
+ * @example
+ * ```typescript
+ * @Controller({ guards: [AuthGuard] })
+ * export class UserController {
+ *   @Endpoint(getUserEndpoint)
+ *   async getUser() { }
+ * }
+ * ```
+ */
+declare function Controller(options?: ControllerOptions): (target: ClassType) => ClassType;
+//#endregion
+//#region src/legacy-compat/decorators/endpoint.decorator.d.mts
+/**
+ * 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$1.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' }
+ *   }
+ * }
+ * ```
+ */
+declare 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>;
+}): (target: any, propertyKey: string | symbol, descriptor: EndpointMethodDescriptor<Url, QuerySchema, RequestSchema, ResponseSchema>) => PropertyDescriptor | void;
+//#endregion
+//#region src/legacy-compat/decorators/use-guards.decorator.d.mts
+/**
+ * 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() { }
+ * }
+ * ```
+ */
+declare function UseGuards(...guards: (ClassTypeWithInstance<CanActivate> | InjectionToken<CanActivate, undefined>)[]): any;
+//#endregion
+//#region src/legacy-compat/decorators/header.decorator.d.mts
+/**
+ * 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' }
+ *   }
+ * }
+ * ```
+ */
+declare function Header(name: HttpHeader, value: string | number | string[]): <T extends object>(target: T, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//#endregion
+//#region src/legacy-compat/decorators/http-code.decorator.d.mts
+/**
+ * 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' }
+ *   }
+ * }
+ * ```
+ */
+declare function HttpCode(code: number): <T extends object>(target: T, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//#endregion
+//#region src/legacy-compat/decorators/multipart.decorator.d.mts
+/**
+ * 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$1.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' }
+ *   }
+ * }
+ * ```
+ */
+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;
+//#endregion
+//#region src/legacy-compat/decorators/stream.decorator.d.mts
+/**
+ * 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
+ *   }
+ * }
+ * ```
+ */
+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>;
+//#endregion
+export { Controller, type ControllerOptions, Endpoint, type EndpointParams, type EndpointResult, Header, HttpCode, Module, type ModuleOptions, Multipart, type MultipartParams, type MultipartResult, Stream, type StreamParams, UseGuards };
+//# sourceMappingURL=index.d.mts.map

package/lib/legacy-compat/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/legacy-compat/decorators/module.decorator.mts","../../src/legacy-compat/decorators/controller.decorator.mts","../../src/legacy-compat/decorators/endpoint.decorator.mts","../../src/legacy-compat/decorators/use-guards.decorator.mts","../../src/legacy-compat/decorators/header.decorator.mts","../../src/legacy-compat/decorators/http-code.decorator.mts","../../src/legacy-compat/decorators/multipart.decorator.mts","../../src/legacy-compat/decorators/stream.decorator.mts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAuBA;;;;;;;;ACCA;;;;;;iBDDgB,MAAA,WACL,yBAMgB,cAAS;;;;;;;AAPpC;;;;;;;;ACCA;;;;;iBAAgB,UAAA,WAAoB,6BACT,cAAS;;;;;;;ADFpC;KERK,wBFSM,CAAA,YAAA,MAAA,EAAA,WAAA,EAAA,aAAA,EAAA,uBELc,OFKd,CAAA,GEJP,uBFIO,CAAA,CAAA,MAAA,EEFC,WFED,SEFqB,OFErB,GEDH,aFCG,SEDmB,OFCnB,GEAD,oBFAC,CEAoB,GFApB,EEAyB,WFAzB,EEAsC,aFAtC,EAAA,IAAA,CAAA,GECD,oBFDC,CECoB,GFDpB,EECyB,WFDzB,EAAA,SAAA,EAAA,IAAA,CAAA,GEEH,aFFG,SEEmB,OFFnB,GEGD,oBFHC,CEGoB,GFHpB,EAAA,SAAA,EEGoC,aFHpC,EAAA,IAAA,CAAA,GEID,oBFJC,CEIoB,GFJpB,EAAA,SAAA,EAAA,SAAA,EAAA,IAAA,CAAA,EAAA,GEKJ,OFLI,CEKI,GAAA,CAAE,KFLN,CEKY,cFLZ,CAAA,CAAA,CAAA;;;;;;;ACAX;;;;;;;;ACnBwC;;;;;;AAmBT,iBA4Bf,QA5Be,CAAA,eA6Bd,UA7Bc,GA6BD,UA7BC,EAAA,YAAA,MAAA,GAAA,MAAA,EAAA,cAAA,SAAA,EAAA,uBAgCN,OAhCM,GAgCI,OAhCJ,EAAA,gBAiCb,OAjCa,CAAA,CAAA,QAAA,EAAA;EAAK,MAAA,EAmC1B,kBAnC0B,CAoChC,MApCgC,EAqChC,GArCgC,EAsChC,WAtCgC,EAuChC,cAvCgC,EAwChC,aAxCgC,CAAA;CAAa,CAAA,EAAA,CAAA,MAAA,EAAA,GAAA,EAAA,WAAA,EAAA,MAAA,GAAA,MAAA,EAAA,UAAA,EA8CjC,wBA9CiC,CA+C3C,GA/C2C,EAgD3C,WAhD2C,EAiD3C,aAjD2C,EAkD3C,cAlD2C,CAAA,EAAA,GAoD5C,kBApD4C,GAAA,IAAA;;;;;;;AFDjD;;;;;;;;ACCA;;;;;;;;ACnBwC;;;;;AAkBV,iBCad,SAAA,CDbc,GAAA,MAAA,EAAA,CCexB,qBDfwB,CCeF,WDfE,CAAA,GCgBxB,cDhBwB,CCgBT,WDhBS,EAAA,SAAA,CAAA,CAAA,EAAA,CAAA,EAAA,GAAA;;;;;;;;AFA9B;;;;;;;;ACCA;;;;;;;;ACTK,iBEWW,MAAA,CFXa,IAAA,EEWA,UFXA,EAAA,KAAA,EAAA,MAAA,GAAA,MAAA,GAAA,MAAA,EAAA,CAAA,EAAA,CAAA,UAAA,MAAA,CAAA,CAAA,MAAA,EEajB,CFbiB,EAAA,WAAA,EAAA,MAAA,GAAA,MAAA,EAAA,UAAA,EEeb,kBFfa,EAAA,GEeK,kBFfL;;;;;;;;;AFQ7B;;;;;;;;ACCA;;;;;;iBIDgB,QAAA,2CAEJ,6CAEI,uBAAkB;;;;;;;ALJlC;KMRK,yBNSM,CAAA,YAAA,MAAA,EAAA,WAAA,EAAA,aAAA,EAAA,uBMLc,ONKd,CAAA,GMJP,uBNIO,CAAA,CAAA,MAAA,EMFC,WNED,SMFqB,SNErB,GMDH,aNCG,SMDmB,ONCnB,GMAD,oBNAC,CMAoB,GNApB,EMAyB,WNAzB,EMAsC,aNAtC,CAAA,GMCD,oBNDC,CMCoB,GNDpB,EMCyB,WNDzB,EAAA,SAAA,CAAA,GMEH,aNFG,SMEmB,ONFnB,GMGD,oBNHC,CMGoB,GNHpB,EAAA,SAAA,EMGoC,aNHpC,CAAA,GMID,oBNJC,CMIoB,GNJpB,EAAA,SAAA,EAAA,SAAA,CAAA,EAAA,GMKJ,ONLI,CMKI,GAAA,CAAE,KNLN,CMKY,cNLZ,CAAA,CAAA,CAAA;;;;;;;ACAX;;;;;;;;ACnBwC;;;;;;;AAmBJ,iBI6BpB,SJ7BoB,CAAA,eI8BnB,UJ9BmB,GI8BN,UJ9BM,EAAA,YAAA,MAAA,GAAA,MAAA,EAAA,cAAA,SAAA,EAAA,uBIiCX,OJjCW,GIiCD,OJjCC,EAAA,gBIkClB,OJlCkB,CAAA,CAAA,QAAA,EAAA;EAAa,MAAA,EIoCvC,kBJpCuC,CIqC7C,MJrC6C,EIsC7C,GJtC6C,EIuC7C,WJvC6C,EIwC7C,cJxC6C,EIyC7C,aJzC6C,CAAA;CAAvC,CAAA,EAAA,CAAA,UAAA,MAAA,CAAA,CAAA,MAAA,EI6CE,CJ7CF,EAAA,WAAA,EAAA,MAAA,GAAA,MAAA,EAAA,UAAA,EI+CM,yBJ/CN,CIgDJ,GJhDI,EIiDJ,WJjDI,EIkDJ,aJlDI,EImDJ,cJnDI,CAAA,EAAA,GIqDL,kBJrDK,GAAA,IAAA;;;;;;;AFDV;KORK,sBPSM,CAAA,YAAA,MAAA,EAAA,WAAA,EAAA,aAAA,CAAA,GOLP,uBPKO,CAAA,CAAA,MAAA,EOHC,WPGD,SOHqB,SPGrB,GOFH,aPEG,SOFmB,OPEnB,GODD,oBPCC,CODoB,GPCpB,EODyB,WPCzB,EODsC,aPCtC,CAAA,GOAD,oBPAC,COAoB,GPApB,EOAyB,WPAzB,EAAA,SAAA,CAAA,GOCH,aPDG,SOCmB,OPDnB,GOED,oBPFC,COEoB,GPFpB,EAAA,SAAA,EOEoC,aPFpC,CAAA,GOGD,oBPHC,COGoB,GPHpB,EAAA,SAAA,EAAA,SAAA,CAAA,EAAA,KAAA,EAAA,GAAA,EAAA,GOKJ,OPLI,CAAA,IAAA,CAAA,CAAA;;;;;;;ACAX;;;;;;;;ACnBwC;;;;;;;AAmBJ,iBK6BpB,ML7BoB,CAAA,eK8BnB,UL9BmB,GK8BN,UL9BM,EAAA,YAAA,MAAA,GAAA,MAAA,EAAA,cAAA,SAAA,EAAA,gBKiClB,OLjCkB,CAAA,CAAA,QAAA,EAAA;EAAa,MAAA,EKmCvC,gBLnCuC,CKmCtB,MLnCsB,EKmCd,GLnCc,EKmCT,WLnCS,EKmCI,aLnCJ,CAAA;CAAvC,CAAA,EAAA,CAAA,UAAA,MAAA,CAAA,CAAA,MAAA,EKsCE,CLtCF,EAAA,WAAA,EAAA,MAAA,GAAA,MAAA,EAAA,UAAA,EKwCM,sBLxCN,CKwC6B,GLxC7B,EKwCkC,WLxClC,EKwC+C,aLxC/C,CAAA,EAAA,GKwC6D,sBLxC7D,CKwC6D,GLxC7D,EKwC6D,WLxC7D,EKwC6D,aLxC7D,CAAA"}

package/lib/legacy-compat/index.mjs

@@ -0,0 +1,308 @@
+import { _ as Controller$1, a as HttpCode$1, i as Module$1, n as Stream$1, o as Header$1, r as Multipart$1, s as Endpoint$1, t as UseGuards$1 } from "../use-guards.decorator-kZ3lNK8v.mjs";
+
+//#region src/legacy-compat/context-compat.mts
+/**
+* Compatibility layer for converting legacy decorator signatures to Stage 3 format.
+*
+* This module provides utilities to create mock Stage 3 decorator contexts
+* from legacy decorator arguments, and manages metadata storage using WeakMap.
+*/ const classMetadataMap = /* @__PURE__ */ new WeakMap();
+/**
+* Gets the constructor from a prototype (for method decorators).
+*/ function getConstructor(prototype) {
+	if (!prototype || typeof prototype !== "object") return null;
+	const constructor = prototype.constructor;
+	if (constructor && typeof constructor === "function") return constructor;
+	return null;
+}
+/**
+* Creates a mock ClassDecoratorContext for legacy class decorators.
+*/ function createClassContext(target) {
+	if (!classMetadataMap.has(target)) classMetadataMap.set(target, {});
+	const metadata = classMetadataMap.get(target);
+	return {
+		kind: "class",
+		name: target.name,
+		metadata,
+		addInitializer() {}
+	};
+}
+/**
+* Creates a mock ClassMethodDecoratorContext for legacy method decorators.
+*
+* Note: Method decorators need to share metadata with the class context
+* because endpoint metadata is stored at the class level.
+*/ function createMethodContext(target, propertyKey, descriptor) {
+	const constructor = getConstructor(target);
+	if (!constructor) throw new Error("[Navios] Could not determine class constructor from method decorator target.");
+	if (!classMetadataMap.has(constructor)) classMetadataMap.set(constructor, {});
+	return {
+		kind: "method",
+		name: propertyKey,
+		metadata: classMetadataMap.get(constructor),
+		static: false,
+		private: false,
+		access: {
+			has: () => true,
+			get: () => descriptor.value,
+			set: () => {}
+		},
+		addInitializer() {}
+	};
+}
+
+//#endregion
+//#region src/legacy-compat/decorators/module.decorator.mts
+/**
+* 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 {}
+* ```
+*/ function Module(options = {
+	controllers: [],
+	imports: [],
+	guards: []
+}) {
+	return function(target) {
+		const context = createClassContext(target);
+		return Module$1(options)(target, context);
+	};
+}
+
+//#endregion
+//#region src/legacy-compat/decorators/controller.decorator.mts
+/**
+* Legacy-compatible Controller decorator.
+*
+* Works with TypeScript experimental decorators (legacy API).
+*
+* @param options - Controller configuration options
+* @returns A class decorator compatible with legacy decorator API
+*
+* @example
+* ```typescript
+* @Controller({ guards: [AuthGuard] })
+* export class UserController {
+*   @Endpoint(getUserEndpoint)
+*   async getUser() { }
+* }
+* ```
+*/ function Controller(options = {}) {
+	return function(target) {
+		const context = createClassContext(target);
+		return Controller$1(options)(target, context);
+	};
+}
+
+//#endregion
+//#region src/legacy-compat/decorators/endpoint.decorator.mts
+/**
+* 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' }
+*   }
+* }
+* ```
+*/ function Endpoint(endpoint) {
+	return function(target, propertyKey, descriptor) {
+		if (!descriptor) throw new Error("[Navios] @Endpoint decorator requires a method descriptor. Make sure experimentalDecorators is enabled.");
+		const typedDescriptor = descriptor;
+		const context = createMethodContext(target, propertyKey, typedDescriptor);
+		const result = Endpoint$1(endpoint)(typedDescriptor.value, context);
+		if (result !== typedDescriptor.value) typedDescriptor.value = result;
+		return typedDescriptor;
+	};
+}
+
+//#endregion
+//#region src/legacy-compat/decorators/use-guards.decorator.mts
+/**
+* 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() { }
+* }
+* ```
+*/ function UseGuards(...guards) {
+	function decoratorImpl(target, propertyKey, descriptor) {
+		if (propertyKey !== void 0 && descriptor !== void 0) {
+			const context = createMethodContext(target, propertyKey, descriptor);
+			const result = UseGuards$1(...guards)(descriptor.value, context);
+			if (result !== descriptor.value) descriptor.value = result;
+			return descriptor;
+		} else {
+			const context = createClassContext(target);
+			return UseGuards$1(...guards)(target, context);
+		}
+	}
+	return decoratorImpl;
+}
+
+//#endregion
+//#region src/legacy-compat/decorators/header.decorator.mts
+/**
+* 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' }
+*   }
+* }
+* ```
+*/ function Header(name, value) {
+	return function(target, propertyKey, descriptor) {
+		const context = createMethodContext(target, propertyKey, descriptor);
+		const result = Header$1(name, value)(descriptor.value, context);
+		if (result !== descriptor.value) descriptor.value = result;
+		return descriptor;
+	};
+}
+
+//#endregion
+//#region src/legacy-compat/decorators/http-code.decorator.mts
+/**
+* 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' }
+*   }
+* }
+* ```
+*/ function HttpCode(code) {
+	return function(target, propertyKey, descriptor) {
+		const context = createMethodContext(target, propertyKey, descriptor);
+		const result = HttpCode$1(code)(descriptor.value, context);
+		if (result !== descriptor.value) descriptor.value = result;
+		return descriptor;
+	};
+}
+
+//#endregion
+//#region src/legacy-compat/decorators/multipart.decorator.mts
+/**
+* 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' }
+*   }
+* }
+* ```
+*/ function Multipart(endpoint) {
+	return function(target, propertyKey, descriptor) {
+		if (!descriptor) throw new Error("[Navios] @Multipart decorator requires a method descriptor. Make sure experimentalDecorators is enabled.");
+		const context = createMethodContext(target, propertyKey, descriptor);
+		const result = Multipart$1(endpoint)(descriptor.value, context);
+		if (result !== descriptor.value) descriptor.value = result;
+		return descriptor;
+	};
+}
+
+//#endregion
+//#region src/legacy-compat/decorators/stream.decorator.mts
+/**
+* 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
+*   }
+* }
+* ```
+*/ function Stream(endpoint) {
+	return function(target, propertyKey, descriptor) {
+		const context = createMethodContext(target, propertyKey, descriptor);
+		const result = Stream$1(endpoint)(descriptor.value, context);
+		if (result !== descriptor.value) descriptor.value = result;
+		return descriptor;
+	};
+}
+
+//#endregion
+export { Controller, Endpoint, Header, HttpCode, Module, Multipart, Stream, UseGuards };
+//# sourceMappingURL=index.mjs.map

package/lib/legacy-compat/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["classMetadataMap","WeakMap","getConstructor","prototype","constructor","createClassContext","target","has","set","metadata","get","kind","name","addInitializer","createMethodContext","propertyKey","descriptor","Error","static","private","access","value","Module","OriginalModule","createClassContext","options","controllers","imports","guards","target","context","originalDecorator","Controller","OriginalController","createClassContext","options","target","context","originalDecorator","Endpoint","OriginalEndpoint","createMethodContext","endpoint","target","propertyKey","descriptor","Error","typedDescriptor","context","originalDecorator","result","value","UseGuards","OriginalUseGuards","createClassContext","createMethodContext","guards","decoratorImpl","target","propertyKey","descriptor","undefined","context","originalDecorator","result","value","Header","OriginalHeader","createMethodContext","name","value","target","propertyKey","descriptor","context","originalDecorator","result","HttpCode","OriginalHttpCode","createMethodContext","code","target","propertyKey","descriptor","context","originalDecorator","result","value","Multipart","OriginalMultipart","createMethodContext","endpoint","target","propertyKey","descriptor","Error","context","originalDecorator","result","value","Stream","OriginalStream","createMethodContext","endpoint","target","propertyKey","descriptor","context","originalDecorator","result","value"],"sources":["../../src/legacy-compat/context-compat.mts","../../src/legacy-compat/decorators/module.decorator.mts","../../src/legacy-compat/decorators/controller.decorator.mts","../../src/legacy-compat/decorators/endpoint.decorator.mts","../../src/legacy-compat/decorators/use-guards.decorator.mts","../../src/legacy-compat/decorators/header.decorator.mts","../../src/legacy-compat/decorators/http-code.decorator.mts","../../src/legacy-compat/decorators/multipart.decorator.mts","../../src/legacy-compat/decorators/stream.decorator.mts"],"sourcesContent":["/**\n * Compatibility layer for converting legacy decorator signatures to Stage 3 format.\n *\n * This module provides utilities to create mock Stage 3 decorator contexts\n * from legacy decorator arguments, and manages metadata storage using WeakMap.\n */\n\nimport type { ClassType } from '@navios/di'\n\n// WeakMap to store metadata for legacy decorators\n// Keyed by class constructor for class decorators\n// For method decorators, we use the class constructor (extracted from the prototype)\nconst classMetadataMap = new WeakMap<ClassType, Record<string | symbol, any>>()\n\n/**\n * Gets the constructor from a prototype (for method decorators).\n */\nfunction getConstructor(prototype: any): ClassType | null {\n  if (!prototype || typeof prototype !== 'object') {\n    return null\n  }\n  // In legacy decorators, target is the prototype\n  // The constructor is typically available via prototype.constructor\n  const constructor = prototype.constructor\n  if (constructor && typeof constructor === 'function') {\n    return constructor as ClassType\n  }\n  return null\n}\n\n/**\n * Creates a mock ClassDecoratorContext for legacy class decorators.\n */\nexport function createClassContext(target: ClassType): ClassDecoratorContext {\n  // Get or create metadata storage for this class\n  if (!classMetadataMap.has(target)) {\n    classMetadataMap.set(target, {})\n  }\n  const metadata = classMetadataMap.get(target)!\n\n  return {\n    kind: 'class',\n    name: target.name,\n    metadata,\n    addInitializer() {\n      // Legacy decorators don't support initializers\n    },\n  } as ClassDecoratorContext\n}\n\n/**\n * Creates a mock ClassMethodDecoratorContext for legacy method decorators.\n *\n * Note: Method decorators need to share metadata with the class context\n * because endpoint metadata is stored at the class level.\n */\nexport function createMethodContext(\n  target: any,\n  propertyKey: string | symbol,\n  descriptor: PropertyDescriptor,\n): ClassMethodDecoratorContext {\n  // For method decorators, target is the prototype\n  // We need to get the class constructor to access class-level metadata\n  const constructor = getConstructor(target)\n  if (!constructor) {\n    throw new Error(\n      '[Navios] Could not determine class constructor from method decorator target.',\n    )\n  }\n\n  // Get or create metadata storage for the class\n  // Method decorators share metadata with the class\n  if (!classMetadataMap.has(constructor)) {\n    classMetadataMap.set(constructor, {})\n  }\n  const metadata = classMetadataMap.get(constructor)!\n\n  return {\n    kind: 'method',\n    name: propertyKey,\n    metadata,\n    static: false, // We can't determine this from legacy decorators\n    private: false, // We can't determine this from legacy decorators\n    access: {\n      has: () => true,\n      get: () => descriptor.value,\n      set: () => {},\n    },\n    addInitializer() {\n      // Legacy decorators don't support initializers\n    },\n  } as ClassMethodDecoratorContext\n}\n","import type { ClassType } from '@navios/di'\n\nimport { Module as OriginalModule, type ModuleOptions } from '../../decorators/module.decorator.mjs'\nimport { createClassContext } from '../context-compat.mjs'\n\n/**\n * Legacy-compatible Module decorator.\n * \n * Works with TypeScript experimental decorators (legacy API).\n * \n * @param options - Module configuration options\n * @returns A class decorator compatible with legacy decorator API\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  options: ModuleOptions = {\n    controllers: [],\n    imports: [],\n    guards: [],\n  },\n) {\n  return function (target: ClassType) {\n    const context = createClassContext(target)\n    const originalDecorator = OriginalModule(options)\n    return originalDecorator(target, context)\n  }\n}\n\n","import type { ClassType } from '@navios/di'\n\nimport type { ControllerOptions } from '../../decorators/controller.decorator.mjs'\n\nimport { Controller as OriginalController } from '../../decorators/controller.decorator.mjs'\nimport { createClassContext } from '../context-compat.mjs'\n\n/**\n * Legacy-compatible Controller decorator.\n *\n * Works with TypeScript experimental decorators (legacy API).\n *\n * @param options - Controller configuration options\n * @returns A class decorator compatible with legacy decorator API\n *\n * @example\n * ```typescript\n * @Controller({ guards: [AuthGuard] })\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   async getUser() { }\n * }\n * ```\n */\nexport function Controller(options: ControllerOptions = {}) {\n  return function (target: ClassType) {\n    const context = createClassContext(target)\n    const originalDecorator = OriginalController(options)\n    return originalDecorator(target, context)\n  }\n}\n","import type {\n  BaseEndpointConfig,\n  EndpointFunctionArgs,\n  HttpMethod,\n} from '@navios/builder'\nimport type { z, ZodType } from 'zod/v4'\n\nimport { Endpoint as OriginalEndpoint } from '../../decorators/endpoint.decorator.mjs'\nimport { createMethodContext } from '../context-compat.mjs'\n\n/**\n * Type helper to constrain a PropertyDescriptor's value to match an endpoint signature.\n * Note: In legacy decorators, type constraints are checked when the decorator is applied,\n * but may not be preserved perfectly when decorators are stacked.\n */\ntype EndpointMethodDescriptor<\n  Url extends string,\n  QuerySchema,\n  RequestSchema,\n  ResponseSchema extends ZodType,\n> = TypedPropertyDescriptor<\n  (\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>\n\n/**\n * Legacy-compatible Endpoint decorator.\n *\n * Works with TypeScript experimental decorators (legacy API).\n * Provides type safety by ensuring method signatures match the endpoint configuration.\n *\n * @param endpoint - The endpoint declaration from @navios/builder\n * @returns A method decorator compatible with legacy decorator API\n *\n * @example\n * ```typescript\n * @Controller()\n * export class UserController {\n *   @Endpoint(getUserEndpoint)\n *   async getUser(request: EndpointParams<typeof getUserEndpoint>): EndpointResult<typeof getUserEndpoint> {\n *     return { id: '1', 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 function (\n    target: any,\n    propertyKey: string | symbol,\n    descriptor: EndpointMethodDescriptor<\n      Url,\n      QuerySchema,\n      RequestSchema,\n      ResponseSchema\n    >,\n  ): PropertyDescriptor | void {\n    if (!descriptor) {\n      throw new Error(\n        '[Navios] @Endpoint decorator requires a method descriptor. Make sure experimentalDecorators is enabled.',\n      )\n    }\n    // Type check the descriptor value matches expected signature\n    const typedDescriptor = descriptor as EndpointMethodDescriptor<\n      Url,\n      QuerySchema,\n      RequestSchema,\n      ResponseSchema\n    >\n    const context = createMethodContext(target, propertyKey, typedDescriptor)\n    const originalDecorator = OriginalEndpoint(endpoint)\n    // @ts-expect-error - we don't need to type the value\n    const result = originalDecorator(typedDescriptor.value, context)\n    if (result !== typedDescriptor.value) {\n      typedDescriptor.value = result\n    }\n    return typedDescriptor\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 { UseGuards as OriginalUseGuards } from '../../decorators/use-guards.decorator.mjs'\nimport { createClassContext, createMethodContext } from '../context-compat.mjs'\n\n/**\n * Legacy-compatible UseGuards decorator.\n *\n * Works with TypeScript experimental decorators (legacy API).\n * Can be applied to classes or methods.\n *\n * @param guards - Guard classes or injection tokens to apply\n * @returns A class or method decorator compatible with legacy decorator API\n *\n * @example\n * ```typescript\n * // Apply to a controller\n * @Controller()\n * @UseGuards(AuthGuard, RoleGuard)\n * export class UserController { }\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  // Create the decorator function\n  // Note: TypeScript's legacy decorator system has strict type checking for decorators\n  // We use a flexible implementation that works for both class and method decorators\n  function decoratorImpl(\n    target: ClassType | Function,\n    propertyKey?: string | symbol,\n    descriptor?: PropertyDescriptor,\n  ): any {\n    // Determine if this is a class or method decorator\n    if (propertyKey !== undefined && descriptor !== undefined) {\n      // Method decorator\n      const context = createMethodContext(\n        target as Function,\n        propertyKey,\n        descriptor,\n      )\n      const originalDecorator = OriginalUseGuards(...guards)\n      const result = originalDecorator(descriptor.value, context)\n      if (result !== descriptor.value) {\n        descriptor.value = result\n      }\n      return descriptor\n    } else {\n      // Class decorator\n      const context = createClassContext(target as ClassType)\n      const originalDecorator = OriginalUseGuards(...guards)\n      return originalDecorator(target as ClassType, context)\n    }\n  }\n\n  // Return with 'any' type to work around TypeScript's strict decorator checking\n  // TypeScript's legacy decorator system cannot properly type-check decorators\n  // that work as both class and method decorators. The runtime behavior is correct.\n  // When used as a class decorator, it returns the class (preserving type at runtime)\n  // When used as a method decorator, it returns the PropertyDescriptor\n  // @ts-ignore - TypeScript limitation with dual-purpose legacy decorators\n  return decoratorImpl as any\n}\n","import type { HttpHeader } from '../../interfaces/index.mjs'\n\nimport { Header as OriginalHeader } from '../../decorators/header.decorator.mjs'\nimport { createMethodContext } from '../context-compat.mjs'\n\n/**\n * Legacy-compatible Header decorator.\n * \n * Works with TypeScript experimental decorators (legacy API).\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 compatible with legacy decorator API\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 function <T extends object>(\n    target: T,\n    propertyKey: string | symbol,\n    descriptor: PropertyDescriptor,\n  ) {\n    const context = createMethodContext(target, propertyKey, descriptor)\n    const originalDecorator = OriginalHeader(name, value)\n    const result = originalDecorator(descriptor.value, context)\n    if (result !== descriptor.value) {\n      descriptor.value = result\n    }\n    return descriptor\n  }\n}\n\n","import { HttpCode as OriginalHttpCode } from '../../decorators/http-code.decorator.mjs'\nimport { createMethodContext } from '../context-compat.mjs'\n\n/**\n * Legacy-compatible HttpCode decorator.\n *\n * Works with TypeScript experimental decorators (legacy API).\n *\n * @param code - The HTTP status code to return (e.g., 201, 204, 202)\n * @returns A method decorator compatible with legacy decorator API\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 function <T extends object>(\n    target: T,\n    propertyKey: string | symbol,\n    descriptor: PropertyDescriptor,\n  ) {\n    const context = createMethodContext(target, propertyKey, descriptor)\n    const originalDecorator = OriginalHttpCode(code)\n    const result = originalDecorator(descriptor.value, context)\n    if (result !== descriptor.value) {\n      descriptor.value = result\n    }\n    return descriptor\n  }\n}\n","import type {\n  BaseEndpointConfig,\n  EndpointFunctionArgs,\n  HttpMethod,\n} from '@navios/builder'\nimport type { z, ZodObject, ZodType } from 'zod/v4'\n\nimport { Multipart as OriginalMultipart } from '../../decorators/multipart.decorator.mjs'\nimport { createMethodContext } from '../context-compat.mjs'\n\n/**\n * Type helper to constrain a PropertyDescriptor's value to match a multipart endpoint signature.\n * Note: In legacy decorators, type constraints are checked when the decorator is applied,\n * but may not be preserved perfectly when decorators are stacked.\n */\ntype MultipartMethodDescriptor<\n  Url extends string,\n  QuerySchema,\n  RequestSchema,\n  ResponseSchema extends ZodType,\n> = TypedPropertyDescriptor<\n  (\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>\n\n/**\n * Legacy-compatible Multipart decorator.\n *\n * Works with TypeScript experimental decorators (legacy API).\n * Provides type safety by ensuring method signatures match the endpoint configuration.\n *\n * @param endpoint - The multipart endpoint declaration from @navios/builder\n * @returns A method decorator compatible with legacy decorator API\n *\n * @example\n * ```typescript\n * @Controller()\n * export class FileController {\n *   @Multipart(uploadFileEndpoint)\n *   async uploadFile(request: MultipartParams<typeof uploadFileEndpoint>): MultipartResult<typeof uploadFileEndpoint> {\n *     const { file } = request.data\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 function <T extends object>(\n    target: T,\n    propertyKey: string | symbol,\n    descriptor: MultipartMethodDescriptor<\n      Url,\n      QuerySchema,\n      RequestSchema,\n      ResponseSchema\n    >,\n  ): PropertyDescriptor | void {\n    if (!descriptor) {\n      throw new Error(\n        '[Navios] @Multipart decorator requires a method descriptor. Make sure experimentalDecorators is enabled.',\n      )\n    }\n    const context = createMethodContext(target, propertyKey, descriptor)\n    const originalDecorator = OriginalMultipart(endpoint)\n    // @ts-expect-error - we don't need to type the value\n    const result = originalDecorator(descriptor.value, context)\n    if (result !== descriptor.value) {\n      descriptor.value = result\n    }\n    return descriptor\n  }\n}\n","import type {\n  BaseStreamConfig,\n  EndpointFunctionArgs,\n  HttpMethod,\n} from '@navios/builder'\nimport type { ZodObject, ZodType } from 'zod/v4'\n\nimport { Stream as OriginalStream } from '../../decorators/stream.decorator.mjs'\nimport { createMethodContext } from '../context-compat.mjs'\n\n/**\n * Type helper to constrain a PropertyDescriptor's value to match a stream endpoint signature.\n * Note: In legacy decorators, type constraints are checked when the decorator is applied,\n * but may not be preserved perfectly when decorators are stacked.\n */\ntype StreamMethodDescriptor<\n  Url extends string,\n  QuerySchema,\n  RequestSchema,\n> = TypedPropertyDescriptor<\n  (\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>\n\n/**\n * Legacy-compatible Stream decorator.\n *\n * Works with TypeScript experimental decorators (legacy API).\n * Provides type safety by ensuring method signatures match the endpoint configuration.\n *\n * @param endpoint - The stream endpoint declaration from @navios/builder\n * @returns A method decorator compatible with legacy decorator API\n *\n * @example\n * ```typescript\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 function <T extends object>(\n    target: T,\n    propertyKey: string | symbol,\n    descriptor: StreamMethodDescriptor<Url, QuerySchema, RequestSchema>,\n  ) {\n    const context = createMethodContext(target, propertyKey, descriptor)\n    const originalDecorator = OriginalStream(endpoint)\n    // @ts-expect-error - we don't need to type the value\n    const result = originalDecorator(descriptor.value, context)\n    if (result !== descriptor.value) {\n      descriptor.value = result\n    }\n    return descriptor\n  }\n}\n"],"mappings":";;;;;;;;GAYA,MAAMA,mCAAmB,IAAIC,SAAAA;;;GAK7B,SAASC,eAAeC,WAAc;AACpC,KAAI,CAACA,aAAa,OAAOA,cAAc,SACrC,QAAO;CAIT,MAAMC,cAAcD,UAAU;AAC9B,KAAIC,eAAe,OAAOA,gBAAgB,WACxC,QAAOA;AAET,QAAO;;;;GAMT,SAAgBC,mBAAmBC,QAAiB;AAElD,KAAI,CAACN,iBAAiBO,IAAID,OAAAA,CACxBN,kBAAiBQ,IAAIF,QAAQ,EAAC,CAAA;CAEhC,MAAMG,WAAWT,iBAAiBU,IAAIJ,OAAAA;AAEtC,QAAO;EACLK,MAAM;EACNC,MAAMN,OAAOM;EACbH;EACAI,iBAAAA;EAGF;;;;;;;GASF,SAAgBC,oBACdR,QACAS,aACAC,YAA8B;CAI9B,MAAMZ,cAAcF,eAAeI,OAAAA;AACnC,KAAI,CAACF,YACH,OAAM,IAAIa,MACR,+EAAA;AAMJ,KAAI,CAACjB,iBAAiBO,IAAIH,YAAAA,CACxBJ,kBAAiBQ,IAAIJ,aAAa,EAAC,CAAA;AAIrC,QAAO;EACLO,MAAM;EACNC,MAAMG;EACNN,UALeT,iBAAiBU,IAAIN,YAAAA;EAMpCc,QAAQ;EACRC,SAAS;EACTC,QAAQ;GACNb,WAAW;GACXG,WAAWM,WAAWK;GACtBb,WAAK;GACP;EACAK,iBAAAA;EAGF;;;;;;;;;;;;;;;;;;;;;;GCpEF,SAAgBS,OACdG,UAAyB;CACvBC,aAAa,EAAE;CACfC,SAAS,EAAE;CACXC,QAAQ,EAAE;CACX,EAAA;AAED,QAAO,SAAUC,QAAiB;EAChC,MAAMC,UAAUN,mBAAmBK,OAAAA;AAEnC,SAD0BN,SAAeE,QAAAA,CAChBI,QAAQC,QAAAA;;;;;;;;;;;;;;;;;;;;;;GCTrC,SAAgBE,WAAWG,UAA6B,EAAE,EAAA;AACxD,QAAO,SAAUC,QAAiB;EAChC,MAAMC,UAAUH,mBAAmBE,OAAAA;AAEnC,SAD0BH,aAAmBE,QAAAA,CACpBC,QAAQC,QAAAA;;;;;;;;;;;;;;;;;;;;;;;;;GCwBrC,SAAgBE,SAMdG,UAQD;AACC,QAAO,SACLC,QACAC,aACAC,YAKC;AAED,MAAI,CAACA,WACH,OAAM,IAAIC,MACR,0GAAA;EAIJ,MAAMC,kBAAkBF;EAMxB,MAAMG,UAAUP,oBAAoBE,QAAQC,aAAaG,gBAAAA;EAGzD,MAAMG,SAFoBV,WAAiBE,SAAAA,CAEVK,gBAAgBI,OAAOH,QAAAA;AACxD,MAAIE,WAAWH,gBAAgBI,MAC7BJ,iBAAgBI,QAAQD;AAE1B,SAAOH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GC5DX,SAAgBK,UACd,GAAGI,QAGA;CAKH,SAASC,cACPC,QACAC,aACAC,YAA+B;AAG/B,MAAID,gBAAgBE,UAAaD,eAAeC,QAAW;GAEzD,MAAMC,UAAUP,oBACdG,QACAC,aACAC,WAAAA;GAGF,MAAMI,SADoBX,YAAAA,GAAqBG,OAAAA,CACdI,WAAWK,OAAOH,QAAAA;AACnD,OAAIE,WAAWJ,WAAWK,MACxBL,YAAWK,QAAQD;AAErB,UAAOJ;SACF;GAEL,MAAME,UAAUR,mBAAmBI,OAAAA;AAEnC,UAD0BL,YAAAA,GAAqBG,OAAAA,CACtBE,QAAqBI,QAAAA;;;AAUlD,QAAOL;;;;;;;;;;;;;;;;;;;;;;;;;GCpDT,SAAgBS,OAAOG,MAAkBC,OAAiC;AACxE,QAAO,SACLC,QACAC,aACAC,YAA8B;EAE9B,MAAMC,UAAUN,oBAAoBG,QAAQC,aAAaC,WAAAA;EAEzD,MAAMG,SADoBT,SAAeE,MAAMC,MAAAA,CACdG,WAAWH,OAAOI,QAAAA;AACnD,MAAIE,WAAWH,WAAWH,MACxBG,YAAWH,QAAQM;AAErB,SAAOH;;;;;;;;;;;;;;;;;;;;;;;;;GCfX,SAAgBI,SAASG,MAAY;AACnC,QAAO,SACLC,QACAC,aACAC,YAA8B;EAE9B,MAAMC,UAAUL,oBAAoBE,QAAQC,aAAaC,WAAAA;EAEzD,MAAMG,SADoBR,WAAiBE,KAAAA,CACVG,WAAWI,OAAOH,QAAAA;AACnD,MAAIE,WAAWH,WAAWI,MACxBJ,YAAWI,QAAQD;AAErB,SAAOH;;;;;;;;;;;;;;;;;;;;;;;;;;GCkBX,SAAgBK,UAMdG,UAQD;AACC,QAAO,SACLC,QACAC,aACAC,YAKC;AAED,MAAI,CAACA,WACH,OAAM,IAAIC,MACR,2GAAA;EAGJ,MAAMC,UAAUN,oBAAoBE,QAAQC,aAAaC,WAAAA;EAGzD,MAAMI,SAFoBT,YAAkBE,SAAAA,CAEXG,WAAWK,OAAOH,QAAAA;AACnD,MAAIE,WAAWJ,WAAWK,MACxBL,YAAWK,QAAQD;AAErB,SAAOJ;;;;;;;;;;;;;;;;;;;;;;;;;;GCrCX,SAAgBM,OAKdG,UAED;AACC,QAAO,SACLC,QACAC,aACAC,YAAmE;EAEnE,MAAMC,UAAUL,oBAAoBE,QAAQC,aAAaC,WAAAA;EAGzD,MAAMG,SAFoBR,SAAeE,SAAAA,CAERG,WAAWI,OAAOH,QAAAA;AACnD,MAAIE,WAAWH,WAAWI,MACxBJ,YAAWI,QAAQD;AAErB,SAAOH"}