@alis-kit/routers 1.0.0

package/dist/decorators/parameter/index.js

@@ -0,0 +1,196 @@
+import { paramMetaStore } from "../../types/index.js";
+/**
+ * Internal helper for registering parameter metadata on a method.
+ *
+ * TC39 decorators tidak mendukung parameter decorators, jadi metadata
+ * parameter disimpan di WeakMap (`paramMetaStore`) dan dibaca langsung
+ * oleh RouteResolver tanpa Reflect API.
+ *
+ * @internal
+ */
+function addParamMetadata(target, propertyKey, parameterIndex, metadata) {
+    const methodMap = paramMetaStore.get(target.constructor) ?? new Map();
+    const key = String(propertyKey);
+    const existing = methodMap.get(key) ?? [];
+    existing.push({ ...metadata, index: parameterIndex });
+    methodMap.set(key, existing);
+    paramMetaStore.set(target.constructor, methodMap);
+}
+/**
+ * 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 function Body(schema) {
+    return function (target, propertyKey, parameterIndex) {
+        addParamMetadata(target, propertyKey, parameterIndex, { type: "body", schema });
+    };
+}
+/**
+ * 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 function Query(schema) {
+    return function (target, propertyKey, parameterIndex) {
+        addParamMetadata(target, propertyKey, parameterIndex, { type: "query", schema });
+    };
+}
+/**
+ * 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 function Param(key) {
+    return function (target, propertyKey, parameterIndex) {
+        addParamMetadata(target, propertyKey, parameterIndex, { type: "param", key });
+    };
+}
+/**
+ * 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 function Req() {
+    return function (target, propertyKey, parameterIndex) {
+        addParamMetadata(target, propertyKey, parameterIndex, { type: "req" });
+    };
+}
+/**
+ * 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 function Cookie() {
+    return function (target, propertyKey, parameterIndex) {
+        addParamMetadata(target, propertyKey, parameterIndex, { type: "cookie" });
+    };
+}
+/**
+ * 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 function Reply() {
+    return function (target, propertyKey, parameterIndex) {
+        addParamMetadata(target, propertyKey, parameterIndex, { type: "reply" });
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../decorators/parameter/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CACvB,MAAc,EACd,WAA4B,EAC5B,cAAsB,EACtB,QAAsC;IAEtC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,GAAG,EAA2B,CAAC;IAC/F,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;IACtD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC7B,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,IAAI,CAAC,MAAkB;IACrC,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,cAAsB;QACnF,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,KAAK,CAAC,MAAkB;IACtC,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,cAAsB;QACnF,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,cAAsB;QACnF,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,cAAsB;QACnF,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,cAAsB;QACnF,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,KAAK;IACnB,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,cAAsB;QACnF,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC"}

package/dist/exceptions/BadRequestException.d.ts

@@ -0,0 +1,37 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 400 Bad Request responses.
+ *
+ * Digunakan ketika request validation gagal atau input tidak valid.
+ * RouteResolver otomatis mengirim response 400 dengan field-level errors.
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod";
+ * import { BadRequestException } from "@alis-kit/routers";
+ *
+ * const schema = z.object({ email: z.string().email() });
+ * const result = schema.safeParse(input);
+ * if (!result.success) {
+ *   throw new BadRequestException("Validation failed", {
+ *     errors: result.error.errors.map(e => ({
+ *       field: e.path.join("."),
+ *       message: e.message,
+ *     })),
+ *   });
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Simple usage
+ * if (!req.file) {
+ *   throw new BadRequestException("File is required");
+ * }
+ * ```
+ */
+export declare class BadRequestException extends BaseException {
+    readonly status = 400;
+    readonly code = "BAD_REQUEST";
+}
+//# sourceMappingURL=BadRequestException.d.ts.map

package/dist/exceptions/BadRequestException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BadRequestException.d.ts","sourceRoot":"","sources":["../../exceptions/BadRequestException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,IAAI,iBAAiB;CAC/B"}

package/dist/exceptions/BadRequestException.js

@@ -0,0 +1,37 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 400 Bad Request responses.
+ *
+ * Digunakan ketika request validation gagal atau input tidak valid.
+ * RouteResolver otomatis mengirim response 400 dengan field-level errors.
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod";
+ * import { BadRequestException } from "@alis-kit/routers";
+ *
+ * const schema = z.object({ email: z.string().email() });
+ * const result = schema.safeParse(input);
+ * if (!result.success) {
+ *   throw new BadRequestException("Validation failed", {
+ *     errors: result.error.errors.map(e => ({
+ *       field: e.path.join("."),
+ *       message: e.message,
+ *     })),
+ *   });
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Simple usage
+ * if (!req.file) {
+ *   throw new BadRequestException("File is required");
+ * }
+ * ```
+ */
+export class BadRequestException extends BaseException {
+    status = 400;
+    code = "BAD_REQUEST";
+}
+//# sourceMappingURL=BadRequestException.js.map

package/dist/exceptions/BadRequestException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BadRequestException.js","sourceRoot":"","sources":["../../exceptions/BadRequestException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAC3C,MAAM,GAAG,GAAG,CAAC;IACb,IAAI,GAAG,aAAa,CAAC;CAC/B"}

package/dist/exceptions/BaseException.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Base exception class for all HTTP exceptions.
+ *
+ * Semua exception di library ini extend dari class ini.
+ * RouteResolver otomatis menangkap BaseException dan mengirim
+ * response JSON yang sesuai dengan status code + error code.
+ *
+ * @example
+ * ```typescript
+ * class PaymentRequiredException extends BaseException {
+ *   readonly status = 402;
+ *   readonly code = "PAYMENT_REQUIRED";
+ * }
+ * ```
+ */
+export declare abstract class BaseException extends Error {
+    /** HTTP status code (contoh: 400, 401, 404, 500) */
+    abstract readonly status: number;
+    /** Machine-readable error code (contoh: "BAD_REQUEST", "NOT_FOUND") */
+    abstract readonly code: string;
+    /** Optional additional data payload (contoh: field-level validation errors) */
+    data?: unknown;
+    /**
+     * @param message - Human-readable error message
+     * @param data - Optional data payload (akan dikirim di `details` response)
+     */
+    constructor(message: string, data?: unknown);
+}
+//# sourceMappingURL=BaseException.d.ts.map

package/dist/exceptions/BaseException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseException.d.ts","sourceRoot":"","sources":["../../exceptions/BaseException.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,aAAc,SAAQ,KAAK;IAC/C,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAEjC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAK5C"}

package/dist/exceptions/BaseException.js

@@ -0,0 +1,29 @@
+/**
+ * Base exception class for all HTTP exceptions.
+ *
+ * Semua exception di library ini extend dari class ini.
+ * RouteResolver otomatis menangkap BaseException dan mengirim
+ * response JSON yang sesuai dengan status code + error code.
+ *
+ * @example
+ * ```typescript
+ * class PaymentRequiredException extends BaseException {
+ *   readonly status = 402;
+ *   readonly code = "PAYMENT_REQUIRED";
+ * }
+ * ```
+ */
+export class BaseException extends Error {
+    /** Optional additional data payload (contoh: field-level validation errors) */
+    data;
+    /**
+     * @param message - Human-readable error message
+     * @param data - Optional data payload (akan dikirim di `details` response)
+     */
+    constructor(message, data) {
+        super(message);
+        this.name = this.constructor.name;
+        this.data = data ?? null;
+    }
+}
+//# sourceMappingURL=BaseException.js.map

package/dist/exceptions/BaseException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseException.js","sourceRoot":"","sources":["../../exceptions/BaseException.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAgB,aAAc,SAAQ,KAAK;IAO/C,+EAA+E;IAC/E,IAAI,CAAW;IAEf;;;OAGG;IACH,YAAY,OAAe,EAAE,IAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC;IAC3B,CAAC;CACF"}

package/dist/exceptions/ConflictException.d.ts

@@ -0,0 +1,28 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 409 Conflict responses.
+ *
+ * Digunakan ketika request bertentangan dengan state resource saat ini.
+ * Contoh umum: email sudah terdaftar, duplicate entry, atau conflict version.
+ *
+ * @example
+ * ```typescript
+ * import { ConflictException } from "@alis-kit/routers";
+ *
+ * class UserController {
+ *   @PostMapping("/")
+ *   async create(@Body(CreateUserSchema) body: ICreateUser) {
+ *     const existing = await UserService.findByEmail(body.email);
+ *     if (existing) {
+ *       throw new ConflictException("Email already registered");
+ *     }
+ *     return await UserService.create(body);
+ *   }
+ * }
+ * ```
+ */
+export declare class ConflictException extends BaseException {
+    readonly status = 409;
+    readonly code = "CONFLICT";
+}
+//# sourceMappingURL=ConflictException.d.ts.map

package/dist/exceptions/ConflictException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictException.d.ts","sourceRoot":"","sources":["../../exceptions/ConflictException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,IAAI,cAAc;CAC5B"}

package/dist/exceptions/ConflictException.js

@@ -0,0 +1,28 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 409 Conflict responses.
+ *
+ * Digunakan ketika request bertentangan dengan state resource saat ini.
+ * Contoh umum: email sudah terdaftar, duplicate entry, atau conflict version.
+ *
+ * @example
+ * ```typescript
+ * import { ConflictException } from "@alis-kit/routers";
+ *
+ * class UserController {
+ *   @PostMapping("/")
+ *   async create(@Body(CreateUserSchema) body: ICreateUser) {
+ *     const existing = await UserService.findByEmail(body.email);
+ *     if (existing) {
+ *       throw new ConflictException("Email already registered");
+ *     }
+ *     return await UserService.create(body);
+ *   }
+ * }
+ * ```
+ */
+export class ConflictException extends BaseException {
+    status = 409;
+    code = "CONFLICT";
+}
+//# sourceMappingURL=ConflictException.js.map

package/dist/exceptions/ConflictException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictException.js","sourceRoot":"","sources":["../../exceptions/ConflictException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IACzC,MAAM,GAAG,GAAG,CAAC;IACb,IAAI,GAAG,UAAU,CAAC;CAC5B"}

package/dist/exceptions/ForbiddenException.d.ts

@@ -0,0 +1,26 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 403 Forbidden responses.
+ *
+ * Digunakan ketika user sudah terautentikasi (401 bukan masalahnya),
+ * tapi tidak memiliki permission/role yang diperlukan untuk mengakses resource.
+ *
+ * @example
+ * ```typescript
+ * import { ForbiddenException } from "@alis-kit/routers";
+ *
+ * class AdminController {
+ *   @DeleteMapping("/users/:id")
+ *   async deleteUser(@Param("id") id: string, @Req() req: express.Request) {
+ *     if (req.user.role !== "admin") {
+ *       throw new ForbiddenException("Only admins can delete users");
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class ForbiddenException extends BaseException {
+    readonly status = 403;
+    readonly code = "FORBIDDEN";
+}
+//# sourceMappingURL=ForbiddenException.d.ts.map

package/dist/exceptions/ForbiddenException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForbiddenException.d.ts","sourceRoot":"","sources":["../../exceptions/ForbiddenException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,IAAI,eAAe;CAC7B"}

package/dist/exceptions/ForbiddenException.js

@@ -0,0 +1,26 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 403 Forbidden responses.
+ *
+ * Digunakan ketika user sudah terautentikasi (401 bukan masalahnya),
+ * tapi tidak memiliki permission/role yang diperlukan untuk mengakses resource.
+ *
+ * @example
+ * ```typescript
+ * import { ForbiddenException } from "@alis-kit/routers";
+ *
+ * class AdminController {
+ *   @DeleteMapping("/users/:id")
+ *   async deleteUser(@Param("id") id: string, @Req() req: express.Request) {
+ *     if (req.user.role !== "admin") {
+ *       throw new ForbiddenException("Only admins can delete users");
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class ForbiddenException extends BaseException {
+    status = 403;
+    code = "FORBIDDEN";
+}
+//# sourceMappingURL=ForbiddenException.js.map

package/dist/exceptions/ForbiddenException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForbiddenException.js","sourceRoot":"","sources":["../../exceptions/ForbiddenException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAC1C,MAAM,GAAG,GAAG,CAAC;IACb,IAAI,GAAG,WAAW,CAAC;CAC7B"}

package/dist/exceptions/NotFoundException.d.ts

@@ -0,0 +1,28 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 404 Not Found responses.
+ *
+ * Digunakan ketika resource yang diminta tidak ditemukan.
+ * Paling sering dipakai di endpoint GET /:id, PUT /:id, DELETE /:id.
+ *
+ * @example
+ * ```typescript
+ * import { NotFoundException } from "@alis-kit/routers";
+ *
+ * class UserController {
+ *   @GetMapping("/:id")
+ *   async getById(@Param("id") id: string) {
+ *     const user = await UserService.findById(id);
+ *     if (!user) {
+ *       throw new NotFoundException("User not found");
+ *     }
+ *     return user;
+ *   }
+ * }
+ * ```
+ */
+export declare class NotFoundException extends BaseException {
+    readonly status = 404;
+    readonly code = "NOT_FOUND";
+}
+//# sourceMappingURL=NotFoundException.d.ts.map

package/dist/exceptions/NotFoundException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotFoundException.d.ts","sourceRoot":"","sources":["../../exceptions/NotFoundException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,IAAI,eAAe;CAC7B"}

package/dist/exceptions/NotFoundException.js

@@ -0,0 +1,28 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 404 Not Found responses.
+ *
+ * Digunakan ketika resource yang diminta tidak ditemukan.
+ * Paling sering dipakai di endpoint GET /:id, PUT /:id, DELETE /:id.
+ *
+ * @example
+ * ```typescript
+ * import { NotFoundException } from "@alis-kit/routers";
+ *
+ * class UserController {
+ *   @GetMapping("/:id")
+ *   async getById(@Param("id") id: string) {
+ *     const user = await UserService.findById(id);
+ *     if (!user) {
+ *       throw new NotFoundException("User not found");
+ *     }
+ *     return user;
+ *   }
+ * }
+ * ```
+ */
+export class NotFoundException extends BaseException {
+    status = 404;
+    code = "NOT_FOUND";
+}
+//# sourceMappingURL=NotFoundException.js.map

package/dist/exceptions/NotFoundException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotFoundException.js","sourceRoot":"","sources":["../../exceptions/NotFoundException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IACzC,MAAM,GAAG,GAAG,CAAC;IACb,IAAI,GAAG,WAAW,CAAC;CAC7B"}

package/dist/exceptions/ServerErrorException.d.ts

@@ -0,0 +1,33 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 500 Internal Server Error responses.
+ *
+ * Digunakan ketika terjadi error yang tidak terduga di server.
+ * RouteResolver otomatis membungkus error yang tidak dikenal
+ * sebagai ServerErrorException — tidak perlu di-throw manual.
+ *
+ * @example
+ * ```typescript
+ * import { ServerErrorException } from "@alis-kit/routers";
+ *
+ * // Biasanya tidak perlu di-throw manual:
+ * // RouteResolver otomatis wrap unknown error jadi 500.
+ *
+ * // Tapi bisa dipakai explicit untuk kasus tertentu:
+ * class PaymentController {
+ *   @PostMapping("/charge")
+ *   async charge(@Body() body: unknown) {
+ *     try {
+ *       return await paymentGateway.charge(body);
+ *     } catch (error) {
+ *       throw new ServerErrorException("Payment service unavailable");
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class ServerErrorException extends BaseException {
+    readonly status = 500;
+    readonly code = "INTERNAL_SERVER_ERROR";
+}
+//# sourceMappingURL=ServerErrorException.d.ts.map

package/dist/exceptions/ServerErrorException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerErrorException.d.ts","sourceRoot":"","sources":["../../exceptions/ServerErrorException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,IAAI,2BAA2B;CACzC"}

package/dist/exceptions/ServerErrorException.js

@@ -0,0 +1,33 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 500 Internal Server Error responses.
+ *
+ * Digunakan ketika terjadi error yang tidak terduga di server.
+ * RouteResolver otomatis membungkus error yang tidak dikenal
+ * sebagai ServerErrorException — tidak perlu di-throw manual.
+ *
+ * @example
+ * ```typescript
+ * import { ServerErrorException } from "@alis-kit/routers";
+ *
+ * // Biasanya tidak perlu di-throw manual:
+ * // RouteResolver otomatis wrap unknown error jadi 500.
+ *
+ * // Tapi bisa dipakai explicit untuk kasus tertentu:
+ * class PaymentController {
+ *   @PostMapping("/charge")
+ *   async charge(@Body() body: unknown) {
+ *     try {
+ *       return await paymentGateway.charge(body);
+ *     } catch (error) {
+ *       throw new ServerErrorException("Payment service unavailable");
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class ServerErrorException extends BaseException {
+    status = 500;
+    code = "INTERNAL_SERVER_ERROR";
+}
+//# sourceMappingURL=ServerErrorException.js.map

package/dist/exceptions/ServerErrorException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerErrorException.js","sourceRoot":"","sources":["../../exceptions/ServerErrorException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IAC5C,MAAM,GAAG,GAAG,CAAC;IACb,IAAI,GAAG,uBAAuB,CAAC;CACzC"}

package/dist/exceptions/UnauthorizedException.d.ts

@@ -0,0 +1,28 @@
+import { BaseException } from "./BaseException.js";
+/**
+ * Exception for 401 Unauthorized responses.
+ *
+ * Digunakan ketika authentication diperlukan tapi tidak disertakan
+ * atau token tidak valid. Berbeda dengan ForbiddenException (403)
+ * yang berarti user sudah terautentikasi tapi tidak punya akses.
+ *
+ * @example
+ * ```typescript
+ * import { UnauthorizedException } from "@alis-kit/routers";
+ *
+ * class AuthController {
+ *   @PostMapping("/refresh")
+ *   async refresh(@Req() req: express.Request) {
+ *     const token = req.headers["authorization"];
+ *     if (!token) {
+ *       throw new UnauthorizedException("Access token is required");
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class UnauthorizedException extends BaseException {
+    readonly status = 401;
+    readonly code = "UNAUTHORIZED";
+}
+//# sourceMappingURL=UnauthorizedException.d.ts.map

package/dist/exceptions/UnauthorizedException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnauthorizedException.d.ts","sourceRoot":"","sources":["../../exceptions/UnauthorizedException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,IAAI,kBAAkB;CAChC"}