@alis-kit/routers 1.0.0

package/dist/decorators/controller/ReqController.js

@@ -0,0 +1,62 @@
+import { META } from "../../types/index.js";
+/**
+ * Marks a class as a route controller with a base path and optional configuration.
+ *
+ * Menyimpan metadata controller ke `context.metadata` via TC39 native decorator.
+ * Semua route dalam class ini akan mewarisi `authentication` dan `tag` dari sini.
+ *
+ * @param basePath - Base URL path untuk semua route di controller ini.
+ *                   Akan otomatis diprefiks dengan "/" jika tidak ada.
+ * @param options - Opsi tambahan untuk controller.
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users", { authentication: "auth", tag: "User Management" })
+ * class UserController {
+ *   // semua route inheritance authentication: "auth"
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/public")
+ * class PublicController {
+ *   // authentication: false (default)
+ * }
+ * ```
+ */
+export function ReqController(basePath, options) {
+    return function (_value, context) {
+        const tag = options?.tag ?? deriveTagFromClassName(_value.name);
+        const metadata = {
+            basePath: normalizePath(basePath),
+            authentication: options?.authentication ?? false,
+            tag,
+            swagger: options?.swagger !== false,
+        };
+        if (!context.metadata)
+            return;
+        context.metadata[META.CONTROLLER] = metadata;
+    };
+}
+/**
+ * Derives a human-readable Swagger tag from a PascalCase class name.
+ * Contoh: "UserController" → "User", "AuthTokenController" → "Auth Token"
+ */
+function deriveTagFromClassName(name) {
+    const withoutSuffix = name.replace(/Controller$/i, "");
+    return withoutSuffix.replace(/([a-z])([A-Z])/g, "$1 $2").trim() || name;
+}
+/**
+ * Normalizes a path: ensures leading "/" and removes trailing "/".
+ */
+function normalizePath(path) {
+    if (!path.startsWith("/")) {
+        path = "/" + path;
+    }
+    if (path.length > 1 && path.endsWith("/")) {
+        path = path.slice(0, -1);
+    }
+    return path;
+}
+//# sourceMappingURL=ReqController.js.map

package/dist/decorators/controller/ReqController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReqController.js","sourceRoot":"","sources":["../../../decorators/controller/ReqController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAA2B;IACzE,OAAO,UAAU,MAAgB,EAAE,OAA8B;QAC/D,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,QAAQ,GAAuB;YACnC,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;YACjC,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,KAAK;YAChD,GAAG;YACH,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK;SACpC,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAO;QAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,IAAY;IAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,aAAa,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/decorators/mapping/index.d.ts

@@ -0,0 +1,93 @@
+import type { MappingOptions } from "../../types/index.js";
+/**
+ * Maps a controller method to handle HTTP GET requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping (summary, auth override, swagger, dll)
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @GetMapping("/", { summary: "Get all users" })
+ *   async getAll(@Query(PaginationSchema) query: IPagination) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare const GetMapping: (path: string, options?: MappingOptions) => (_value: Function, context: ClassMethodDecoratorContext) => void;
+/**
+ * Maps a controller method to handle HTTP POST requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @PostMapping("/", { summary: "Create a user" })
+ *   @HttpStatus(201)
+ *   async create(@Body(CreateUserSchema) body: ICreateUser) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare const PostMapping: (path: string, options?: MappingOptions) => (_value: Function, context: ClassMethodDecoratorContext) => void;
+/**
+ * Maps a controller method to handle HTTP PUT requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @PutMapping("/:id", { summary: "Update a user" })
+ *   async update(@Param("id") id: string, @Body(UpdateSchema) body: IUpdate) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare const PutMapping: (path: string, options?: MappingOptions) => (_value: Function, context: ClassMethodDecoratorContext) => void;
+/**
+ * Maps a controller method to handle HTTP PATCH requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @PatchMapping("/:id/status", { summary: "Update user status" })
+ *   async updateStatus(@Param("id") id: string, @Body(StatusSchema) body: { status: string }) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare const PatchMapping: (path: string, options?: MappingOptions) => (_value: Function, context: ClassMethodDecoratorContext) => void;
+/**
+ * Maps a controller method to handle HTTP DELETE requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @DeleteMapping("/:id", { summary: "Delete a user" })
+ *   async delete(@Param("id") id: string) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare const DeleteMapping: (path: string, options?: MappingOptions) => (_value: Function, context: ClassMethodDecoratorContext) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/mapping/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../decorators/mapping/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA6B,MAAM,sBAAsB,CAAC;AAyCtF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,UAAU,SA9CE,MAAM,YAAY,cAAc,MACpC,QAAQ,QAAQ,EAAE,SAAS,2BAA2B,SA6CpB,CAAC;AAExD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,WAAW,SAlEC,MAAM,YAAY,cAAc,MACpC,QAAQ,QAAQ,EAAE,SAAS,2BAA2B,SAiElB,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,UAAU,SArFE,MAAM,YAAY,cAAc,MACpC,QAAQ,QAAQ,EAAE,SAAS,2BAA2B,SAoFpB,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,SAxGA,MAAM,YAAY,cAAc,MACpC,QAAQ,QAAQ,EAAE,SAAS,2BAA2B,SAuGhB,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,SA3HD,MAAM,YAAY,cAAc,MACpC,QAAQ,QAAQ,EAAE,SAAS,2BAA2B,SA0Hd,CAAC"}

package/dist/decorators/mapping/index.js

@@ -0,0 +1,128 @@
+import { META } from "../../types/index.js";
+/**
+ * Factory untuk membuat method mapping decorator (GetMapping, PostMapping, dll).
+ *
+ * Setiap decorator yang dihasilkan menyimpan metadata route ke `context.metadata`
+ * via TC39 native decorator, yang nantinya dibaca oleh RouteResolver.
+ *
+ * @param method - HTTP method yang akan di-map
+ */
+function createMappingDecorator(method) {
+    return function (path, options) {
+        return function (_value, context) {
+            const normalizedPath = normalizePath(path);
+            if (!context.metadata)
+                return;
+            const route = {
+                method,
+                path: normalizedPath,
+                propertyKey: String(context.name),
+                options: options ?? {},
+            };
+            const existingRoutes = context.metadata[META.ROUTES] ?? [];
+            existingRoutes.push(route);
+            context.metadata[META.ROUTES] = existingRoutes;
+        };
+    };
+}
+/**
+ * Normalizes a path: ensures leading "/".
+ */
+function normalizePath(path) {
+    if (!path.startsWith("/")) {
+        path = "/" + path;
+    }
+    return path;
+}
+/**
+ * Maps a controller method to handle HTTP GET requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping (summary, auth override, swagger, dll)
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @GetMapping("/", { summary: "Get all users" })
+ *   async getAll(@Query(PaginationSchema) query: IPagination) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export const GetMapping = createMappingDecorator("get");
+/**
+ * Maps a controller method to handle HTTP POST requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @PostMapping("/", { summary: "Create a user" })
+ *   @HttpStatus(201)
+ *   async create(@Body(CreateUserSchema) body: ICreateUser) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export const PostMapping = createMappingDecorator("post");
+/**
+ * Maps a controller method to handle HTTP PUT requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @PutMapping("/:id", { summary: "Update a user" })
+ *   async update(@Param("id") id: string, @Body(UpdateSchema) body: IUpdate) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export const PutMapping = createMappingDecorator("put");
+/**
+ * Maps a controller method to handle HTTP PATCH requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @PatchMapping("/:id/status", { summary: "Update user status" })
+ *   async updateStatus(@Param("id") id: string, @Body(StatusSchema) body: { status: string }) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export const PatchMapping = createMappingDecorator("patch");
+/**
+ * Maps a controller method to handle HTTP DELETE requests.
+ *
+ * @param path - Route path relatif terhadap basePath controller
+ * @param options - Opsi mapping
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @DeleteMapping("/:id", { summary: "Delete a user" })
+ *   async delete(@Param("id") id: string) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export const DeleteMapping = createMappingDecorator("delete");
+//# sourceMappingURL=index.js.map

package/dist/decorators/mapping/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../decorators/mapping/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAAC,MAAkB;IAChD,OAAO,UAAU,IAAY,EAAE,OAAwB;QACrD,OAAO,UAAU,MAAgB,EAAE,OAAoC;YACrE,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAAE,OAAO;YAE9B,MAAM,KAAK,GAAkB;gBAC3B,MAAM;gBACN,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;gBACjC,OAAO,EAAE,OAAO,IAAI,EAAE;aACvB,CAAC;YAEF,MAAM,cAAc,GAAqB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAqB,IAAI,EAAE,CAAC;YACjG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC;QACjD,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC"}

package/dist/decorators/method/index.d.ts

@@ -0,0 +1,67 @@
+import type { MiddlewareFn } from "../../types/index.js";
+/**
+ * Applies one or more middleware functions to a specific route method.
+ *
+ * Middleware dijalankan secara berurutan sebelum route handler.
+ * Bisa digunakan untuk logging, file upload, rate limiting, dll.
+ *
+ * @param middlewares - Middleware functions to apply (Express/fastify-compatible)
+ *
+ * @example
+ * ```typescript
+ * import multer from "multer";
+ * const upload = multer({ dest: "uploads/" });
+ *
+ * @ReqController("/files")
+ * class FileController {
+ *   @PostMapping("/upload")
+ *   @UseMiddleware(upload.single("avatar"))
+ *   async uploadAvatar(@Req() req: express.Request) {
+ *     return { file: req.file };
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Multiple middlewares
+ * @Get("/admin")
+ * @UseMiddleware(authMiddleware, adminOnlyMiddleware)
+ * async adminPanel() {
+ *   // ...
+ * }
+ * ```
+ */
+export declare function UseMiddleware(...middlewares: MiddlewareFn[]): (_value: Function, context: ClassMethodDecoratorContext) => void;
+/**
+ * Overrides the default HTTP response status code for a specific route.
+ *
+ * Default status code adalah 200. Gunakan decorator ini untuk
+ * kasus seperti 201 Created, 204 No Content, atau kode lain.
+ *
+ * @param code - HTTP status code (contoh: 201, 204, 202)
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @PostMapping("/")
+ *   @HttpStatus(201)
+ *   async create(@Body(CreateUserSchema) body: ICreateUser) {
+ *     return await UserService.create(body);
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * @DeleteMapping("/:id")
+ * @HttpStatus(204)
+ * async delete(@Param("id") id: string) {
+ *   await UserService.delete(id);
+ *   return null; // response 204 tanpa body
+ * }
+ * ```
+ */
+export declare function HttpStatus(code: number): (_value: Function, context: ClassMethodDecoratorContext) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/method/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../decorators/method/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,aAAa,CAAC,GAAG,WAAW,EAAE,YAAY,EAAE,IACzC,QAAQ,QAAQ,EAAE,SAAS,2BAA2B,UAOxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,IACpB,QAAQ,QAAQ,EAAE,SAAS,2BAA2B,UAKxE"}

package/dist/decorators/method/index.js

@@ -0,0 +1,83 @@
+import { META } from "../../types/index.js";
+/**
+ * Applies one or more middleware functions to a specific route method.
+ *
+ * Middleware dijalankan secara berurutan sebelum route handler.
+ * Bisa digunakan untuk logging, file upload, rate limiting, dll.
+ *
+ * @param middlewares - Middleware functions to apply (Express/fastify-compatible)
+ *
+ * @example
+ * ```typescript
+ * import multer from "multer";
+ * const upload = multer({ dest: "uploads/" });
+ *
+ * @ReqController("/files")
+ * class FileController {
+ *   @PostMapping("/upload")
+ *   @UseMiddleware(upload.single("avatar"))
+ *   async uploadAvatar(@Req() req: express.Request) {
+ *     return { file: req.file };
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Multiple middlewares
+ * @Get("/admin")
+ * @UseMiddleware(authMiddleware, adminOnlyMiddleware)
+ * async adminPanel() {
+ *   // ...
+ * }
+ * ```
+ */
+export function UseMiddleware(...middlewares) {
+    return function (_value, context) {
+        if (!context.metadata)
+            return;
+        const key = META.MIDDLEWARES_PREFIX + String(context.name);
+        const existing = context.metadata[key] ?? [];
+        existing.push(...middlewares);
+        context.metadata[key] = existing;
+    };
+}
+/**
+ * Overrides the default HTTP response status code for a specific route.
+ *
+ * Default status code adalah 200. Gunakan decorator ini untuk
+ * kasus seperti 201 Created, 204 No Content, atau kode lain.
+ *
+ * @param code - HTTP status code (contoh: 201, 204, 202)
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @PostMapping("/")
+ *   @HttpStatus(201)
+ *   async create(@Body(CreateUserSchema) body: ICreateUser) {
+ *     return await UserService.create(body);
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * @DeleteMapping("/:id")
+ * @HttpStatus(204)
+ * async delete(@Param("id") id: string) {
+ *   await UserService.delete(id);
+ *   return null; // response 204 tanpa body
+ * }
+ * ```
+ */
+export function HttpStatus(code) {
+    return function (_value, context) {
+        if (!context.metadata)
+            return;
+        const key = META.HTTP_STATUS_PREFIX + String(context.name);
+        context.metadata[key] = code;
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/decorators/method/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../decorators/method/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,aAAa,CAAC,GAAG,WAA2B;IAC1D,OAAO,UAAU,MAAgB,EAAE,OAAoC;QACrE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAO;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAoB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB,IAAI,EAAE,CAAC;QACjF,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,UAAU,MAAgB,EAAE,OAAoC;QACrE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAO;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/parameter/index.d.ts

@@ -0,0 +1,155 @@
+import type { ZodSchema } from "zod";
+/**
+ * Injects and optionally validates `req.body` using a Zod schema.
+ *
+ * @param schema - Optional Zod schema for validation. Jika diberikan,
+ *                 request body akan di-parse dan divalidasi otomatis.
+ *                 Throw `BadRequestException` jika validasi gagal.
+ *
+ * @example
+ * ```typescript
+ * const CreateUserSchema = z.object({
+ *   name: z.string().min(1),
+ *   email: z.string().email(),
+ * });
+ *
+ * @ReqController("/users")
+ * class UserController {
+ *   @PostMapping("/")
+ *   async create(@Body(CreateUserSchema) body: { name: string; email: string }) {
+ *     // body sudah tervalidasi dan typed
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Tanpa schema — body dikirim raw
+ * @PostMapping("/webhook")
+ * async handleWebhook(@Body() body: unknown) {
+ *   // validasi manual
+ * }
+ * ```
+ */
+export declare function Body(schema?: ZodSchema): (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * Injects and optionally validates `req.query` using a Zod schema.
+ *
+ * Gunakan `z.coerce` untuk type conversion (string → number, dll).
+ *
+ * @param schema - Optional Zod schema for validation
+ *
+ * @example
+ * ```typescript
+ * const PaginationSchema = z.object({
+ *   page: z.coerce.number().default(1),
+ *   size: z.coerce.number().default(10),
+ * });
+ *
+ * @ReqController("/users")
+ * class UserController {
+ *   @GetMapping("/")
+ *   async getAll(@Query(PaginationSchema) query: { page: number; size: number }) {
+ *     // query.page dan query.size otomatis di-coerce ke number
+ *   }
+ * }
+ * ```
+ */
+export declare function Query(schema?: ZodSchema): (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * Injects a single route parameter by key.
+ *
+ * @param key - Nama route parameter (contoh: "id" untuk route `/:id`)
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/users")
+ * class UserController {
+ *   @GetMapping("/:id")
+ *   async getById(@Param("id") id: string) {
+ *     // id = "123" untuk request GET /users/123
+ *   }
+ * }
+ * ```
+ */
+export declare function Param(key: string): (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * Injects the raw framework request object.
+ *
+ * Berguna saat perlu akses ke properti native request
+ * seperti headers, raw body stream, atau IP address.
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/auth")
+ * class AuthController {
+ *   @PostMapping("/refresh")
+ *   async refresh(@Req() req: express.Request) {
+ *     const token = req.headers["authorization"];
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Dengan Fastify
+ * @PostMapping("/webhook")
+ * async handle(@Req() req: FastifyRequest) {
+ *   const sourceIp = req.ip;
+ * }
+ * ```
+ */
+export declare function Req(): (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * Injects a CookieSetter instance for reading, setting, and deleting cookies.
+ *
+ * CookieSetter adalah helper yang mengabstraksi operasi cookie
+ * di Express dan Fastify melalui adapter pattern.
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/auth")
+ * class AuthController {
+ *   @PostMapping("/login")
+ *   async login(@Body(LoginSchema) body: ILogin, @Cookie() cookie: CookieSetter) {
+ *     cookie.set("refresh_token", token, { httpOnly: true, secure: true });
+ *     const existing = cookie.get("refresh_token");
+ *     cookie.delete("old_token");
+ *   }
+ * }
+ * ```
+ */
+export declare function Cookie(): (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * Injects the raw framework reply object (FastifyReply / express.Response).
+ *
+ * Digunakan saat handler perlu kontrol penuh terhadap response:
+ * - Set content-type selain JSON (HTML, file stream)
+ * - Set custom headers
+ * - Return non-JSON response (misal: redirect, HTML page)
+ *
+ * @example
+ * ```typescript
+ * @ReqController("/oauth")
+ * class OAuthController {
+ *   @GetMapping("/callback")
+ *   async callback(@Reply() reply: FastifyReply) {
+ *     reply.type("text/html").send("<h1>Login berhasil</h1>");
+ *     return reply; // Wajib return reply agar framework tidak auto-send
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Express Response — set cookie domain
+ * @Get("/download")
+ * async download(@Reply() res: express.Response) {
+ *   res.setHeader("Content-Type", "application/octet-stream");
+ *   res.status(200).send(Buffer.from("..."));
+ *   return res;
+ * }
+ * ```
+ */
+export declare function Reply(): (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/parameter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../decorators/parameter/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AA2BrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,IACpB,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,gBAAgB,MAAM,KAAG,IAAI,CAG7F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,IACrB,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,gBAAgB,MAAM,KAAG,IAAI,CAG7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,IACd,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,gBAAgB,MAAM,KAAG,IAAI,CAG7F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,GAAG,KACA,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,gBAAgB,MAAM,KAAG,IAAI,CAG7F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,MAAM,KACH,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,gBAAgB,MAAM,KAAG,IAAI,CAG7F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,KAAK,KACF,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,gBAAgB,MAAM,KAAG,IAAI,CAG7F"}