@alis-kit/routers 1.0.0

package/README.md

@@ -0,0 +1,302 @@
+# @alis-kit/routers
+
+A TC39 native decorator-based controller library for Node.js APIs. Supports **Express** and **Fastify**, includes **Zod-based request validation**, structured **exception handling**, optional **Swagger UI** generation, and **cookie management**.
+
+## Installation
+
+```bash
+npm install @alis-kit/routers zod
+```
+
+> **Note:** You also need one of the supported frameworks:
+> ```bash
+> npm install express          # for Express
+> npm install fastify          # for Fastify
+> ```
+
+## Requirements
+
+- **Node.js** >= 18
+- **TypeScript** >= 5.2
+
+No `reflect-metadata` needed — this library uses **TC39 native decorators** (stage 3):
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": false,
+    "useDefineForClassFields": true,
+    "strict": true
+  }
+}
+```
+
+---
+
+## Quick Start
+
+```typescript
+import express from "express";
+import { RouterKit, ReqController, GetMapping, PostMapping } from "@alis-kit/routers";
+
+@ReqController("/hello")
+class HelloController {
+  @GetMapping("/")
+  async sayHello() {
+    return { greeting: "Hello, World!" };
+  }
+}
+
+const app = express();
+app.use(express.json());
+
+RouterKit.setup({
+  framework: "express",
+  app,
+  swagger: { enabled: true, path: "/api/docs" },
+});
+
+RouterKit.register(HelloController);
+
+app.listen(3000, () => console.log("Server running on port 3000"));
+```
+
+---
+
+## API Reference
+
+### `RouterKit`
+
+Central setup class. Configured once at application entry point.
+
+```typescript
+RouterKit.setup(config: RouterKitConfig): void
+RouterKit.register(...controllers: Class[]): void
+RouterKit.handleNotFound(): void
+```
+
+**Configuration:**
+
+```typescript
+interface RouterKitConfig {
+  framework: "express" | "fastify";
+  app: express.Application | FastifyInstance;
+  authMiddleware?: MiddlewareFn;       // for authentication: "auth"
+  refreshMiddleware?: MiddlewareFn;    // for authentication: "refresh"
+  swagger?: {
+    enabled: boolean;
+    path?: string;            // default: "/api/docs"
+    title?: string;           // default: "API Documentation"
+    version?: string;         // default: "1.0.0"
+    sortBy?: "path" | "method";
+    searchByPath?: boolean;
+    searchByMethod?: boolean;
+    searchByTag?: boolean;
+  };
+  logger?: boolean | {
+    enabled?: boolean;
+    handler?: (level: "info" | "error", message: string, meta: LoggerMeta) => void;
+  };
+  responseEnvelope?: "wrap" | "raw";  // "wrap" (default) or "raw"
+  globalPrefix?: string;              // e.g. "/api"
+}
+```
+
+### `@ReqController(basePath, options?)`
+
+Marks a class as a route controller with a base path and default authentication.
+
+```typescript
+@ReqController("/users", { authentication: "auth", tag: "User Management" })
+class UserController { ... }
+```
+
+**Options:**
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `authentication` | `"auth" \| "refresh" \| false` | `false` | Default auth for all routes |
+| `tag` | `string` | Derived from class name | Swagger tag |
+| `swagger` | `boolean` | `true` | Include in Swagger docs |
+
+### Method Mapping Decorators
+
+```typescript
+@GetMapping(path, options?)
+@PostMapping(path, options?)
+@PutMapping(path, options?)
+@PatchMapping(path, options?)
+@DeleteMapping(path, options?)
+```
+
+**Options:**
+| Option | Type | Description |
+|---|---|---|
+| `authentication` | `"auth" \| "refresh" \| false` | Override controller-level auth |
+| `swagger` | `boolean` | Include in Swagger docs |
+| `tag` | `string` | Override controller tag |
+| `summary` | `string` | Swagger summary |
+| `description` | `string` | Swagger description |
+| `status` | `number` | Default response status code |
+
+### Parameter Decorators
+
+| Decorator | Description |
+|---|---|
+| `@Body(schema?)` | Injects and validates `req.body` with Zod |
+| `@Query(schema?)` | Injects and validates `req.query` with Zod |
+| `@Param(key)` | Injects a single route parameter |
+| `@Req()` | Injects the raw request object |
+| `@Cookie()` | Injects a `CookieSetter` instance |
+| `@Reply()` | Injects the raw framework reply object (FastifyReply / express.Response) |
+
+### Method Decorators
+
+| Decorator | Description |
+|---|---|
+| `@UseMiddleware(...fns)` | Applies middleware to a route |
+| `@HttpStatus(code)` | Sets default response status code |
+
+### Exceptions
+
+All exceptions extend `BaseException` and auto-send the appropriate HTTP response.
+
+| Exception | Status | Code |
+|---|---|---|
+| `BadRequestException` | 400 | `BAD_REQUEST` |
+| `UnauthorizedException` | 401 | `UNAUTHORIZED` |
+| `ForbiddenException` | 403 | `FORBIDDEN` |
+| `NotFoundException` | 404 | `NOT_FOUND` |
+| `ConflictException` | 409 | `CONFLICT` |
+| `ServerErrorException` | 500 | `INTERNAL_ERROR` |
+
+### `CookieSetter`
+
+Injected via `@Cookie()`. Abstracts cookie operations across frameworks.
+
+```typescript
+cookie.set(key, value, options?)   // Set a cookie
+cookie.get(key)                    // Get a cookie value
+cookie.delete(key)                 // Delete a cookie
+```
+
+---
+
+## Full Usage Example
+
+```typescript
+import express from "express";
+import { z } from "zod";
+import {
+  RouterKit,
+  ReqController,
+  GetMapping, PostMapping, PutMapping, DeleteMapping,
+  Body, Query, Param, Req, Cookie,
+  UseMiddleware, HttpStatus,
+  BadRequestException, NotFoundException, ConflictException,
+  CookieSetter,
+} from "@alis-kit/routers";
+
+// ── Zod Schemas ───────────────────────────────────────────────────
+
+const CreateUserSchema = z.object({
+  firstName: z.string().min(1),
+  lastName: z.string().min(1),
+  email: z.string().email(),
+  age: z.coerce.number().min(1),
+});
+
+const UserQuerySchema = z.object({
+  page: z.coerce.number().default(1),
+  size: z.coerce.number().default(10),
+  search: z.string().optional(),
+});
+
+// ── Controllers ───────────────────────────────────────────────────
+
+@ReqController("/auth", { tag: "Authentication", authentication: false })
+class AuthController {
+  @PostMapping("/login", { summary: "Login user" })
+  async login(
+    @Body(z.object({ email: z.string().email(), password: z.string().min(6) })) body: { email: string; password: string },
+    @Cookie() cookie: CookieSetter
+  ) {
+    cookie.set("refresh_token", "token-value", { httpOnly: true, secure: true });
+    return { accessToken: "jwt-token" };
+  }
+}
+
+@ReqController("/users", { authentication: "auth", tag: "User Management" })
+class UserController {
+  @GetMapping("/", { summary: "Get all users with pagination" })
+  async getAll(@Query(UserQuerySchema) query: { page: number; size: number; search?: string }) {
+    // return await UserService.findAll(query);
+  }
+
+  @GetMapping("/:id", { summary: "Get user by ID" })
+  async getById(@Param("id") id: string) {
+    // if (!user) throw new NotFoundException("User not found");
+  }
+
+  @PostMapping("/", { authentication: false, summary: "Register new user" })
+  @HttpStatus(201)
+  async create(@Body(CreateUserSchema) body: { firstName: string; lastName: string; email: string; age: number }) {
+    // return await UserService.create(body);
+  }
+
+  @PutMapping("/:id", { summary: "Update user" })
+  async update(@Param("id") id: string, @Body(CreateUserSchema.partial()) body: Partial<{ firstName: string; lastName: string; email: string; age: number }>) {
+    // return await UserService.update(id, body);
+  }
+
+  @DeleteMapping("/:id", { summary: "Delete user" })
+  async delete(@Param("id") id: string) {
+    // return await UserService.delete(id);
+  }
+}
+
+// ── App Setup ─────────────────────────────────────────────────────
+
+const app = express();
+app.use(express.json());
+
+RouterKit.setup({
+  framework: "express",
+  app,
+  swagger: { enabled: true, path: "/api/docs", title: "My API", version: "1.0.0" },
+});
+
+RouterKit.register(AuthController, UserController);
+RouterKit.handleNotFound();
+
+app.listen(3000, () => console.log("Server running on port 3000"));
+```
+
+### Response Format
+
+**Success:**
+```json
+{ "message": "OK", "data": { "_id": "...", "firstName": "Dudi" } }
+```
+
+**Error:**
+```json
+{ "message": "User not found", "data": null }
+```
+
+---
+
+## Architecture
+
+This library follows a **Functional Core + Decorator Sugar** pattern:
+
+- **`core/`** — All logic lives here: route resolution, parameter injection, Zod validation, error handling
+- **`decorators/`** — Pure metadata writers using TC39 native decorators (`context.metadata`)
+- **`adapters/`** — Framework-agnostic adapters for Express and Fastify
+
+See `ARCHITECTURE-RULES.md` for detailed guidelines.
+
+---
+
+## License
+
+MIT

package/dist/adapters/BaseAdapter.d.ts

@@ -0,0 +1,63 @@
+import type { HttpMethod, MiddlewareFn, CookieOptions } from "../types/index.js";
+/**
+ * Abstract adapter interface untuk framework-agnostic route registration.
+ *
+ * Setiap framework (Express, Fastify, dll) perlu mengimplementasikan class ini.
+ * RouteResolver hanya berkomunikasi melalui BaseAdapter — tidak pernah
+ * langsung menyentuh Express/Fastify API.
+ *
+ * @example
+ * ```typescript
+ * class KoaAdapter extends BaseAdapter {
+ *   // implement semua abstract method
+ * }
+ * ```
+ */
+export declare abstract class BaseAdapter {
+    /**
+     * Framework application instance (raw).
+     * Contoh: Express `app`, Fastify instance, dll.
+     */
+    abstract readonly app: unknown;
+    /**
+     * Registers a route on the framework instance.
+     *
+     * @param method - HTTP method (get, post, put, patch, delete)
+     * @param path - Route path (contoh: "/users/:id")
+     * @param middlewares - Array middleware yang dijalankan sebelum handler
+     * @param handler - Route handler utama
+     */
+    abstract registerRoute(method: HttpMethod, path: string, middlewares: MiddlewareFn[], handler: (req: unknown, res: unknown, next?: unknown) => void): void;
+    /** Extracts the request body from the framework's request object */
+    abstract getBody(req: unknown): unknown;
+    /** Extracts the query parameters from the framework's request object */
+    abstract getQuery(req: unknown): unknown;
+    /** Extracts the route parameters (contoh: `:id` → `{ id: "123" }`) */
+    abstract getParams(req: unknown): Record<string, string>;
+    /** Extracts the request headers */
+    abstract getHeaders(req: unknown): Record<string, string>;
+    /** Extracts cookies from the request */
+    abstract getCookies(req: unknown): Record<string, string>;
+    /**
+     * Sets a cookie on the response.
+     * @param res - Framework response object
+     * @param key - Cookie name
+     * @param value - Cookie value
+     * @param options - Cookie configuration (httpOnly, secure, maxAge, path, sameSite)
+     */
+    abstract setCookie(res: unknown, key: string, value: string, options: CookieOptions): void;
+    /** Deletes a cookie by key (sets empty value with expired date) */
+    abstract deleteCookie(res: unknown, key: string): void;
+    /** Extracts request URL path (contoh: "/users/123") */
+    abstract getUrl(req: unknown): string;
+    /** Extracts request HTTP method string (GET, POST, dll) */
+    abstract getMethod(req: unknown): string;
+    /** Sends a JSON response with the given status code and body */
+    abstract sendResponse(res: unknown, status: number, body: unknown): void;
+    /**
+     * Registers a catch-all handler for unmatched routes (404 Not Found).
+     * @param handler - Handler yang dipanggil saat route tidak ditemukan
+     */
+    abstract registerNotFoundHandler(handler: (req: unknown, res: unknown) => void): void;
+}
+//# sourceMappingURL=BaseAdapter.d.ts.map

package/dist/adapters/BaseAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAdapter.d.ts","sourceRoot":"","sources":["../../adapters/BaseAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEjF;;;;;;;;;;;;;GAaG;AACH,8BAAsB,WAAW;IAC/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IAE/B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CACpB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,YAAY,EAAE,EAC3B,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAC5D,IAAI;IAEP,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAEvC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAExC,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAExD,mCAAmC;IACnC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzD,wCAAwC;IACxC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzD;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAE1F,mEAAmE;IACnE,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAEtD,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAErC,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAExC,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAExE;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;CACtF"}

package/dist/adapters/BaseAdapter.js

@@ -0,0 +1,17 @@
+/**
+ * Abstract adapter interface untuk framework-agnostic route registration.
+ *
+ * Setiap framework (Express, Fastify, dll) perlu mengimplementasikan class ini.
+ * RouteResolver hanya berkomunikasi melalui BaseAdapter — tidak pernah
+ * langsung menyentuh Express/Fastify API.
+ *
+ * @example
+ * ```typescript
+ * class KoaAdapter extends BaseAdapter {
+ *   // implement semua abstract method
+ * }
+ * ```
+ */
+export class BaseAdapter {
+}
+//# sourceMappingURL=BaseAdapter.js.map

package/dist/adapters/BaseAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAdapter.js","sourceRoot":"","sources":["../../adapters/BaseAdapter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAgB,WAAW;CA+DhC"}

package/dist/adapters/ExpressAdapter.d.ts

@@ -0,0 +1,44 @@
+import { BaseAdapter } from "./BaseAdapter.js";
+import type { HttpMethod, MiddlewareFn, CookieOptions } from "../types/index.js";
+/** Express-like application interface */
+interface ExpressApp {
+    get(path: string, ...handlers: unknown[]): void;
+    post(path: string, ...handlers: unknown[]): void;
+    put(path: string, ...handlers: unknown[]): void;
+    patch(path: string, ...handlers: unknown[]): void;
+    delete(path: string, ...handlers: unknown[]): void;
+    use(path: string, ...handlers: unknown[]): void;
+}
+/**
+ * Express.js adapter implementation.
+ *
+ * Mengkonversi method+middleware+handler Express-style ke route registration.
+ * Digunakan oleh RouteResolver saat framework yang dipilih adalah "express".
+ *
+ * @example
+ * ```typescript
+ * const app = express();
+ * const adapter = new ExpressAdapter(app);
+ * adapter.registerRoute("get", "/hello", [], (req, res) => {
+ *   res.status(200).json({ message: "OK" });
+ * });
+ * ```
+ */
+export declare class ExpressAdapter extends BaseAdapter {
+    readonly app: ExpressApp;
+    constructor(app: unknown);
+    registerRoute(method: HttpMethod, path: string, middlewares: MiddlewareFn[], handler: (req: unknown, res: unknown, next?: unknown) => void): void;
+    getBody(req: unknown): unknown;
+    getQuery(req: unknown): unknown;
+    getParams(req: unknown): Record<string, string>;
+    getHeaders(req: unknown): Record<string, string>;
+    getCookies(req: unknown): Record<string, string>;
+    setCookie(res: unknown, key: string, value: string, options: CookieOptions): void;
+    deleteCookie(res: unknown, key: string): void;
+    getUrl(req: unknown): string;
+    getMethod(req: unknown): string;
+    sendResponse(res: unknown, status: number, body: unknown): void;
+    registerNotFoundHandler(handler: (req: unknown, res: unknown) => void): void;
+}
+export {};
+//# sourceMappingURL=ExpressAdapter.d.ts.map

package/dist/adapters/ExpressAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpressAdapter.d.ts","sourceRoot":"","sources":["../../adapters/ExpressAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAmBjF,yCAAyC;AACzC,UAAU,UAAU;IAClB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACnD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;gBAEb,GAAG,EAAE,OAAO;IAKxB,aAAa,CACX,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,YAAY,EAAE,EAC3B,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAC5D,IAAI;IAKP,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAI9B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAI/B,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI/C,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhD,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhD,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAWjF,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7C,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAK5B,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI/B,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAK/D,uBAAuB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;CAK7E"}

package/dist/adapters/ExpressAdapter.js

@@ -0,0 +1,73 @@
+import { BaseAdapter } from "./BaseAdapter.js";
+/**
+ * Express.js adapter implementation.
+ *
+ * Mengkonversi method+middleware+handler Express-style ke route registration.
+ * Digunakan oleh RouteResolver saat framework yang dipilih adalah "express".
+ *
+ * @example
+ * ```typescript
+ * const app = express();
+ * const adapter = new ExpressAdapter(app);
+ * adapter.registerRoute("get", "/hello", [], (req, res) => {
+ *   res.status(200).json({ message: "OK" });
+ * });
+ * ```
+ */
+export class ExpressAdapter extends BaseAdapter {
+    app;
+    constructor(app) {
+        super();
+        this.app = app;
+    }
+    registerRoute(method, path, middlewares, handler) {
+        const routeHandler = this.app[method].bind(this.app);
+        routeHandler(path, ...middlewares, handler);
+    }
+    getBody(req) {
+        return req.body;
+    }
+    getQuery(req) {
+        return req.query;
+    }
+    getParams(req) {
+        return req.params;
+    }
+    getHeaders(req) {
+        return req.headers;
+    }
+    getCookies(req) {
+        return req.cookies ?? {};
+    }
+    setCookie(res, key, value, options) {
+        const expressRes = res;
+        expressRes.cookie(key, value, {
+            httpOnly: options.httpOnly,
+            secure: options.secure,
+            maxAge: options.maxAge ? options.maxAge * 1000 : undefined,
+            path: options.path,
+            sameSite: options.sameSite,
+        });
+    }
+    deleteCookie(res, key) {
+        const expressRes = res;
+        expressRes.clearCookie(key, { path: "/" });
+    }
+    getUrl(req) {
+        const r = req;
+        return r.originalUrl || r.url || "";
+    }
+    getMethod(req) {
+        return req.method || "UNKNOWN";
+    }
+    sendResponse(res, status, body) {
+        const expressRes = res;
+        expressRes.status(status).json(body);
+    }
+    registerNotFoundHandler(handler) {
+        this.app.use("*", (req, res) => {
+            handler(req, res);
+        });
+    }
+}
+//# sourceMappingURL=ExpressAdapter.js.map

package/dist/adapters/ExpressAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpressAdapter.js","sourceRoot":"","sources":["../../adapters/ExpressAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA8B/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,cAAe,SAAQ,WAAW;IACpC,GAAG,CAAa;IAEzB,YAAY,GAAY;QACtB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,GAAG,GAAiB,CAAC;IAC/B,CAAC;IAED,aAAa,CACX,MAAkB,EAClB,IAAY,EACZ,WAA2B,EAC3B,OAA6D;QAE7D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,YAAY,CAAC,IAAI,EAAE,GAAG,WAAW,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,GAAY;QAClB,OAAQ,GAAsB,CAAC,IAAI,CAAC;IACtC,CAAC;IAED,QAAQ,CAAC,GAAY;QACnB,OAAQ,GAAsB,CAAC,KAAK,CAAC;IACvC,CAAC;IAED,SAAS,CAAC,GAAY;QACpB,OAAQ,GAAsB,CAAC,MAAM,CAAC;IACxC,CAAC;IAED,UAAU,CAAC,GAAY;QACrB,OAAQ,GAAsB,CAAC,OAAO,CAAC;IACzC,CAAC;IAED,UAAU,CAAC,GAAY;QACrB,OAAQ,GAAsB,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,SAAS,CAAC,GAAY,EAAE,GAAW,EAAE,KAAa,EAAE,OAAsB;QACxE,MAAM,UAAU,GAAG,GAAsB,CAAC;QAC1C,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS;YAC1D,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CAAC,GAAY,EAAE,GAAW;QACpC,MAAM,UAAU,GAAG,GAAsB,CAAC;QAC1C,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,GAAY;QACjB,MAAM,CAAC,GAAG,GAA6C,CAAC;QACxD,OAAO,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;IACtC,CAAC;IAED,SAAS,CAAC,GAAY;QACpB,OAAQ,GAA2B,CAAC,MAAM,IAAI,SAAS,CAAC;IAC1D,CAAC;IAED,YAAY,CAAC,GAAY,EAAE,MAAc,EAAE,IAAa;QACtD,MAAM,UAAU,GAAG,GAAsB,CAAC;QAC1C,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,uBAAuB,CAAC,OAA6C;QACnE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAY,EAAE,GAAY,EAAE,EAAE;YAC/C,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/adapters/FastifyAdapter.d.ts

@@ -0,0 +1,61 @@
+import { BaseAdapter } from "./BaseAdapter.js";
+import type { HttpMethod, MiddlewareFn, CookieOptions } from "../types/index.js";
+/** Fastify-like application interface */
+interface FastifyApp {
+    get(path: string, options: Record<string, unknown>, handler: unknown): void;
+    post(path: string, options: Record<string, unknown>, handler: unknown): void;
+    put(path: string, options: Record<string, unknown>, handler: unknown): void;
+    patch(path: string, options: Record<string, unknown>, handler: unknown): void;
+    delete(path: string, options: Record<string, unknown>, handler: unknown): void;
+    addHook(name: string, hook: unknown): void;
+    setNotFoundHandler(handler: unknown): void;
+}
+/**
+ * Fastify adapter implementation.
+ *
+ * Middleware Express-style dikonversi ke Fastify `preHandler` hooks.
+ * Handler di-await dan reply di-return untuk mencegah Fastify auto-send.
+ *
+ * @example
+ * ```typescript
+ * const fastify = Fastify();
+ * const adapter = new FastifyAdapter(fastify);
+ * adapter.registerRoute("get", "/hello", [], async (req, reply) => {
+ *   reply.code(200).send({ message: "OK" });
+ * });
+ * ```
+ */
+export declare class FastifyAdapter extends BaseAdapter {
+    readonly app: FastifyApp;
+    constructor(app: unknown);
+    /**
+     * Fastify route handler signature berbeda dari Express.
+     * Middleware dikonversi ke preHandler, handler di-await.
+     */
+    registerRoute(method: HttpMethod, path: string, middlewares: MiddlewareFn[], handler: (req: unknown, res: unknown) => void): void;
+    getBody(req: unknown): unknown;
+    getQuery(req: unknown): unknown;
+    getParams(req: unknown): Record<string, string>;
+    getHeaders(req: unknown): Record<string, string>;
+    getCookies(req: unknown): Record<string, string>;
+    /**
+     * Sets a cookie on Fastify reply.
+     * Fallback ke manual Set-Cookie header jika `setCookie` tidak tersedia.
+     */
+    setCookie(res: unknown, key: string, value: string, options: CookieOptions): void;
+    /**
+     * Deletes a cookie on Fastify reply.
+     * Fallback ke Expires header manual jika `clearCookie` tidak tersedia.
+     */
+    deleteCookie(res: unknown, key: string): void;
+    getUrl(req: unknown): string;
+    getMethod(req: unknown): string;
+    sendResponse(res: unknown, status: number, body: unknown): void;
+    /**
+     * Fastify memiliki `setNotFoundHandler` native. Jika tidak ada,
+     * fallback ke warning — tidak runtime error.
+     */
+    registerNotFoundHandler(handler: (req: unknown, res: unknown) => void): void;
+}
+export {};
+//# sourceMappingURL=FastifyAdapter.d.ts.map

package/dist/adapters/FastifyAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FastifyAdapter.d.ts","sourceRoot":"","sources":["../../adapters/FastifyAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAqBjF,yCAAyC;AACzC,UAAU,UAAU;IAClB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7E,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5C;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;gBAEb,GAAG,EAAE,OAAO;IAKxB;;;OAGG;IACH,aAAa,CACX,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,YAAY,EAAE,EAC3B,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAC5C,IAAI;IAqBP,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAI9B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAI/B,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI/C,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhD,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhD;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAqBjF;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAS7C,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAK5B,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAK/B,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAK/D;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;CAS7E"}