@alis-kit/routers 1.0.0

package/dist/core/RouteResolver.js

@@ -0,0 +1,279 @@
+import { ZodError } from "zod";
+import { META, getClassMeta, paramMetaStore } from "../types/index.js";
+import { CookieSetter } from "../cookie/CookieSetter.js";
+import { BaseException } from "../exceptions/BaseException.js";
+import { BadRequestException } from "../exceptions/BadRequestException.js";
+import { ServerErrorException } from "../exceptions/ServerErrorException.js";
+import { Logger } from "./Logger.js";
+/**
+ * Internal engine yang membaca metadata dari TC39 decorators (`Symbol.metadata`)
+ * dan WeakMap (parameter decorators), lalu mendaftarkan route ke framework adapter.
+ *
+ * Semua logic inti ada di sini: parameter injection, Zod validation,
+ * error handling, response envelope, auth middleware, dan logging.
+ */
+export class RouteResolver {
+    adapter;
+    loggerConfig;
+    authMiddleware;
+    refreshMiddleware;
+    responseEnvelope;
+    globalPrefix;
+    /** Melacak route yang sudah didaftarkan untuk deteksi duplikat */
+    registeredRoutes = new Set();
+    /** Semua route yang sudah di-resolve — digunakan untuk generate Swagger spec */
+    resolvedRoutes = [];
+    /**
+     * @param adapter - Framework adapter (Express / Fastify)
+     * @param loggerConfig - Konfigurasi logger
+     * @param authMiddleware - Middleware untuk authentication type "auth"
+     * @param refreshMiddleware - Middleware untuk authentication type "refresh"
+     * @param responseEnvelope - Mode response wrapping ("wrap" | "raw")
+     * @param globalPrefix - Prefix global untuk semua route (contoh: "/api")
+     */
+    constructor(adapter, loggerConfig, authMiddleware, refreshMiddleware, responseEnvelope = "wrap", globalPrefix = "") {
+        this.adapter = adapter;
+        this.loggerConfig = loggerConfig;
+        this.authMiddleware = authMiddleware;
+        this.refreshMiddleware = refreshMiddleware;
+        this.responseEnvelope = responseEnvelope;
+        this.globalPrefix = globalPrefix;
+    }
+    /**
+     * Resolves and registers all routes from a controller class.
+     * Membaca metadata dari `Symbol.metadata` (TC39) dan WeakMap (parameter),
+     * lalu mendaftarkan setiap route ke adapter.
+     *
+     * @param Controller - Controller class yang sudah di-decorate dengan @ReqController
+     *
+     * @throws Error jika class tidak memiliki @ReqController
+     * @throws Error jika ditemukan duplikat route
+     *
+     * @example
+     * ```typescript
+     * const resolver = new RouteResolver(adapter);
+     * resolver.resolve(UserController);
+     * ```
+     */
+    resolve(Controller) {
+        const controllerMeta = getClassMeta(Controller, META.CONTROLLER);
+        if (!controllerMeta) {
+            throw new Error(`[RouterKit] Class "${Controller.name}" is not decorated with @ReqController. ` +
+                `Add @ReqController("/path") to the class definition.`);
+        }
+        const routes = getClassMeta(Controller, META.ROUTES) ?? [];
+        const controllerInstance = new Controller();
+        for (const route of routes) {
+            this.registerRoute(Controller, controllerInstance, controllerMeta, route);
+        }
+    }
+    /**
+     * Registers a single route: build path, resolve auth, inject params, register to adapter.
+     */
+    registerRoute(Controller, instance, controllerMeta, route) {
+        const fullPath = this.buildFullPath(controllerMeta.basePath, route.path);
+        const routeKey = `${route.method.toUpperCase()} ${fullPath}`;
+        if (this.registeredRoutes.has(routeKey)) {
+            throw new Error(`[RouterKit] Duplicate route detected: ${routeKey}. ` +
+                `Each route must have a unique method + path combination.`);
+        }
+        this.registeredRoutes.add(routeKey);
+        const authType = this.resolveAuthType(route.options.authentication, controllerMeta.authentication);
+        const authMiddlewares = this.resolveAuthMiddleware(authType);
+        const middlewaresKey = META.MIDDLEWARES_PREFIX + route.propertyKey;
+        const methodMiddlewares = getClassMeta(Controller, middlewaresKey) ?? [];
+        const allMiddlewares = [...authMiddlewares, ...methodMiddlewares];
+        const params = paramMetaStore.get(Controller)?.get(route.propertyKey) ?? [];
+        const httpStatusKey = META.HTTP_STATUS_PREFIX + route.propertyKey;
+        const statusFromDecorator = getClassMeta(Controller, httpStatusKey);
+        const statusCode = route.options.status ?? statusFromDecorator ?? 200;
+        const swaggerVisible = controllerMeta.swagger !== false && route.options.swagger !== false;
+        const resolvedRoute = {
+            method: route.method,
+            fullPath,
+            middlewares: allMiddlewares,
+            params,
+            handler: instance[route.propertyKey],
+            statusCode,
+            controllerTag: controllerMeta.tag,
+            swagger: swaggerVisible,
+            routeOptions: route.options,
+        };
+        this.resolvedRoutes.push(resolvedRoute);
+        const handler = this.createHandler(instance, route.propertyKey, params, statusCode, route.method);
+        this.adapter.registerRoute(route.method, fullPath, allMiddlewares, handler);
+    }
+    /**
+     * Builds the full URL path from controller base path + method path + global prefix.
+     */
+    buildFullPath(basePath, methodPath) {
+        const base = basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+        const method = methodPath.startsWith("/") ? methodPath : "/" + methodPath;
+        const rawPrefix = this.globalPrefix ?? "";
+        if (!rawPrefix)
+            return base + method;
+        const prefix = rawPrefix.startsWith("/") ? rawPrefix : "/" + rawPrefix;
+        const normPrefix = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
+        return normPrefix + base + method;
+    }
+    /**
+     * Resolves effective auth type: method-level override, else controller-level.
+     */
+    resolveAuthType(methodAuth, controllerAuth) {
+        if (methodAuth !== undefined) {
+            return methodAuth;
+        }
+        return controllerAuth;
+    }
+    /**
+     * Resolves authentication middleware array from auth type.
+     * Returns empty array if auth is disabled or middleware not configured.
+     */
+    resolveAuthMiddleware(authType) {
+        if (authType === false)
+            return [];
+        if (authType === "auth" && this.authMiddleware) {
+            return [this.authMiddleware];
+        }
+        if (authType === "refresh" && this.refreshMiddleware) {
+            return [this.refreshMiddleware];
+        }
+        return [];
+    }
+    /**
+     * Creates the route handler that manages parameter injection, response sending,
+     * error handling, and logging.
+     */
+    createHandler(instance, propertyKey, params, statusCode, routeMethod) {
+        const adapter = this.adapter;
+        const loggerConfig = this.loggerConfig;
+        return async (req, res) => {
+            const start = Date.now();
+            try {
+                const args = this.resolveParams(params, req, res);
+                const method = instance[propertyKey];
+                const result = await method.apply(instance, args);
+                const handlerWroteResponse = result === res ||
+                    (typeof result === "object" &&
+                        result !== null &&
+                        result.__rawReply === true);
+                if (handlerWroteResponse) {
+                    // No-op: response sudah dikirim oleh handler (misal: HTML redirect)
+                }
+                else {
+                    const responseBody = this.responseEnvelope === "raw"
+                        ? (result ?? null)
+                        : { message: "OK", data: result ?? null };
+                    adapter.sendResponse(res, statusCode, responseBody);
+                }
+                if (loggerConfig && (loggerConfig === true || (typeof loggerConfig === 'object' && loggerConfig.enabled !== false))) {
+                    const duration = Date.now() - start;
+                    const url = adapter.getUrl(req);
+                    const handler = typeof loggerConfig === 'object' ? loggerConfig.handler : undefined;
+                    Logger.logRequest(routeMethod, url, statusCode, duration, undefined, handler);
+                }
+            }
+            catch (error) {
+                const status = this.handleError(error, res);
+                if (loggerConfig && (loggerConfig === true || (typeof loggerConfig === 'object' && loggerConfig.enabled !== false))) {
+                    const duration = Date.now() - start;
+                    const url = adapter.getUrl(req);
+                    const handler = typeof loggerConfig === 'object' ? loggerConfig.handler : undefined;
+                    Logger.logRequest(routeMethod, url, status, duration, error, handler);
+                }
+            }
+        };
+    }
+    /**
+     * Resolves parameter values from the request based on param metadata.
+     * Parameters are sorted by index to ensure correct order.
+     */
+    resolveParams(params, req, res) {
+        const sorted = [...params].sort((a, b) => a.index - b.index);
+        const args = [];
+        for (const param of sorted) {
+            args[param.index] = this.resolveParam(param, req, res);
+        }
+        return args;
+    }
+    /**
+     * Resolves a single parameter value from the request.
+     * Supports: body, query, param, req, cookie, reply.
+     */
+    resolveParam(param, req, res) {
+        switch (param.type) {
+            case "body": {
+                const body = this.adapter.getBody(req);
+                if (param.schema) {
+                    return this.validateWithZod(param.schema, body);
+                }
+                return body;
+            }
+            case "query": {
+                const query = this.adapter.getQuery(req);
+                if (param.schema) {
+                    return this.validateWithZod(param.schema, query);
+                }
+                return query;
+            }
+            case "param": {
+                const params = this.adapter.getParams(req);
+                return param.key ? params[param.key] : undefined;
+            }
+            case "req":
+                return req;
+            case "cookie":
+                return new CookieSetter(this.adapter, req, res);
+            case "reply":
+                return res;
+            default:
+                return undefined;
+        }
+    }
+    /**
+     * Validates data against a Zod schema.
+     * Throws BadRequestException with field-level errors on validation failure.
+     */
+    validateWithZod(schema, data) {
+        if (!schema)
+            return data;
+        try {
+            return schema.parse(data);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                const errors = error.errors.map((e) => ({
+                    field: e.path.join("."),
+                    message: e.message,
+                }));
+                throw new BadRequestException("Validation failed", { errors });
+            }
+            throw error;
+        }
+    }
+    /**
+     * Handles errors thrown during route execution:
+     * - BaseException → send with its status code
+     * - Unknown errors → wrap as 500 ServerErrorException
+     */
+    handleError(error, res) {
+        if (error instanceof BaseException) {
+            this.adapter.sendResponse(res, error.status, {
+                statusCode: error.status,
+                code: error.code,
+                message: error.message,
+                details: error.data ?? undefined,
+            });
+            return error.status;
+        }
+        const serverError = new ServerErrorException(error instanceof Error ? error.message : "Internal server error");
+        this.adapter.sendResponse(res, serverError.status, {
+            statusCode: serverError.status,
+            code: serverError.code,
+            message: serverError.message,
+            details: undefined,
+        });
+        return serverError.status;
+    }
+}
+//# sourceMappingURL=RouteResolver.js.map

package/dist/core/RouteResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteResolver.js","sourceRoot":"","sources":["../../core/RouteResolver.ts"],"names":[],"mappings":"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"}

package/dist/core/RouterKit.d.ts

@@ -0,0 +1,116 @@
+import type { RouterKitConfig, Class } from "../types/index.js";
+/**
+ * Main entry point for router-api-kit.
+ * Static facade for setup, registration, and lifecycle management.
+ *
+ * ---
+ * ### Lifecycle
+ * 1. `RouterKit.setup(config)` — inisialisasi adapter dan resolver
+ * 2. `RouterKit.register(ControllerA, ControllerB)` — daftarkan controller
+ * 3. `RouterKit.handleNotFound()` — (opsional) daftarkan handler 404 global
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { RouterKit } from "@alis-kit/routers";
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * RouterKit.setup({
+ *   framework: "express",
+ *   app,
+ *   authMiddleware: verifyAccessToken,
+ *   swagger: { enabled: true, path: "/api/docs" },
+ *   logger: true,
+ * });
+ *
+ * RouterKit.register(AuthController, UserController);
+ * RouterKit.handleNotFound();
+ *
+ * app.listen(3000);
+ * ```
+ */
+export declare class RouterKit {
+    private static adapter;
+    private static resolver;
+    private static config;
+    private static isSetup;
+    /**
+     * Configures RouterKit with framework adapter, authentication,
+     * swagger settings, and other global options.
+     *
+     * Wajib dipanggil **sebelum** `register()`.
+     *
+     * @param config - Konfigurasi lengkap RouterKit
+     *
+     * @throws Error jika framework tidak dikenali
+     *
+     * @example
+     * ```typescript
+     * // Express
+     * RouterKit.setup({
+     *   framework: "express",
+     *   app: expressApp,
+     *   swagger: { enabled: true, path: "/docs" },
+     *   logger: true,
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Fastify dengan global prefix dan raw envelope
+     * RouterKit.setup({
+     *   framework: "fastify",
+     *   app: fastifyInstance,
+     *   responseEnvelope: "raw",
+     *   globalPrefix: "/api/v1",
+     * });
+     * ```
+     */
+    static setup(config: RouterKitConfig): void;
+    /**
+     * Registers one or more controller classes.
+     * Setiap controller harus di-decorate dengan `@ReqController`.
+     *
+     * Jika Swagger diaktifkan, spec akan digenerate otomatis setelah registrasi.
+     *
+     * @param controllers - Satu atau lebih controller class
+     *
+     * @throws Error jika `setup()` belum dipanggil
+     * @throws Error jika controller tidak memiliki `@ReqController`
+     * @throws Error jika ada duplikat route (method + path sama)
+     *
+     * @example
+     * ```typescript
+     * // Single controller
+     * RouterKit.register(UserController);
+     *
+     * // Multiple sekaligus
+     * RouterKit.register(AuthController, UserController, ProductController);
+     * ```
+     */
+    static register(...controllers: Class[]): void;
+    /**
+     * Registers a global catch-all handler for 404 Not Found errors.
+     * Panggil method ini **setelah** semua route sudah didaftarkan.
+     *
+     * @throws Error jika `setup()` belum dipanggil
+     *
+     * @example
+     * ```typescript
+     * RouterKit.setup({ framework: "express", app });
+     * RouterKit.register(UserController);
+     *
+     * // Handler 404 harus setelah semua route
+     * RouterKit.handleNotFound();
+     * ```
+     */
+    static handleNotFound(): void;
+    /**
+     * Resets RouterKit state — berguna untuk testing agar state bersih antar test.
+     * @internal
+     */
+    static reset(): void;
+}
+//# sourceMappingURL=RouterKit.d.ts.map

package/dist/core/RouterKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterKit.d.ts","sourceRoot":"","sources":["../../core/RouterKit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAShE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,OAAO,CAA4B;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IACrD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAgC;IACrD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAS;IAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IA6B3C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI;IAmB9C;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,cAAc,IAAI,IAAI;IAyB7B;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;CAMrB"}

package/dist/core/RouterKit.js

@@ -0,0 +1,175 @@
+import { ExpressAdapter } from "../adapters/ExpressAdapter.js";
+import { FastifyAdapter } from "../adapters/FastifyAdapter.js";
+import { RouteResolver } from "./RouteResolver.js";
+import { Logger } from "./Logger.js";
+import { SwaggerGenerator } from "../swagger/SwaggerGenerator.js";
+import { SwaggerUI } from "../swagger/SwaggerUI.js";
+/**
+ * Main entry point for router-api-kit.
+ * Static facade for setup, registration, and lifecycle management.
+ *
+ * ---
+ * ### Lifecycle
+ * 1. `RouterKit.setup(config)` — inisialisasi adapter dan resolver
+ * 2. `RouterKit.register(ControllerA, ControllerB)` — daftarkan controller
+ * 3. `RouterKit.handleNotFound()` — (opsional) daftarkan handler 404 global
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { RouterKit } from "@alis-kit/routers";
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * RouterKit.setup({
+ *   framework: "express",
+ *   app,
+ *   authMiddleware: verifyAccessToken,
+ *   swagger: { enabled: true, path: "/api/docs" },
+ *   logger: true,
+ * });
+ *
+ * RouterKit.register(AuthController, UserController);
+ * RouterKit.handleNotFound();
+ *
+ * app.listen(3000);
+ * ```
+ */
+export class RouterKit {
+    static adapter = null;
+    static resolver = null;
+    static config = null;
+    static isSetup = false;
+    /**
+     * Configures RouterKit with framework adapter, authentication,
+     * swagger settings, and other global options.
+     *
+     * Wajib dipanggil **sebelum** `register()`.
+     *
+     * @param config - Konfigurasi lengkap RouterKit
+     *
+     * @throws Error jika framework tidak dikenali
+     *
+     * @example
+     * ```typescript
+     * // Express
+     * RouterKit.setup({
+     *   framework: "express",
+     *   app: expressApp,
+     *   swagger: { enabled: true, path: "/docs" },
+     *   logger: true,
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Fastify dengan global prefix dan raw envelope
+     * RouterKit.setup({
+     *   framework: "fastify",
+     *   app: fastifyInstance,
+     *   responseEnvelope: "raw",
+     *   globalPrefix: "/api/v1",
+     * });
+     * ```
+     */
+    static setup(config) {
+        switch (config.framework) {
+            case "express":
+                RouterKit.adapter = new ExpressAdapter(config.app);
+                break;
+            case "fastify":
+                RouterKit.adapter = new FastifyAdapter(config.app);
+                break;
+            default:
+                throw new Error(`[RouterKit] Unsupported framework: "${config.framework}". ` +
+                    `Supported frameworks are "express" and "fastify".`);
+        }
+        RouterKit.config = config;
+        RouterKit.resolver = new RouteResolver(RouterKit.adapter, config.logger, config.authMiddleware, config.refreshMiddleware, config.responseEnvelope ?? "wrap", config.globalPrefix ?? "");
+        RouterKit.isSetup = true;
+        console.log(`RouterKit initialized with ${config.framework} adapter`);
+    }
+    /**
+     * Registers one or more controller classes.
+     * Setiap controller harus di-decorate dengan `@ReqController`.
+     *
+     * Jika Swagger diaktifkan, spec akan digenerate otomatis setelah registrasi.
+     *
+     * @param controllers - Satu atau lebih controller class
+     *
+     * @throws Error jika `setup()` belum dipanggil
+     * @throws Error jika controller tidak memiliki `@ReqController`
+     * @throws Error jika ada duplikat route (method + path sama)
+     *
+     * @example
+     * ```typescript
+     * // Single controller
+     * RouterKit.register(UserController);
+     *
+     * // Multiple sekaligus
+     * RouterKit.register(AuthController, UserController, ProductController);
+     * ```
+     */
+    static register(...controllers) {
+        if (!RouterKit.isSetup || !RouterKit.resolver || !RouterKit.config) {
+            throw new Error(`[RouterKit] RouterKit.setup() must be called before RouterKit.register(). ` +
+                `Configure the framework and adapter first.`);
+        }
+        for (const Controller of controllers) {
+            RouterKit.resolver.resolve(Controller);
+            console.log(`Registered controller: ${Controller.name}`);
+        }
+        if (RouterKit.config.swagger?.enabled && RouterKit.resolver.resolvedRoutes.length > 0) {
+            const spec = SwaggerGenerator.generate(RouterKit.resolver.resolvedRoutes, RouterKit.config.swagger);
+            SwaggerUI.serve(RouterKit.config.app, spec, RouterKit.config.swagger);
+        }
+    }
+    /**
+     * Registers a global catch-all handler for 404 Not Found errors.
+     * Panggil method ini **setelah** semua route sudah didaftarkan.
+     *
+     * @throws Error jika `setup()` belum dipanggil
+     *
+     * @example
+     * ```typescript
+     * RouterKit.setup({ framework: "express", app });
+     * RouterKit.register(UserController);
+     *
+     * // Handler 404 harus setelah semua route
+     * RouterKit.handleNotFound();
+     * ```
+     */
+    static handleNotFound() {
+        if (!RouterKit.isSetup || !RouterKit.adapter) {
+            throw new Error(`[RouterKit] RouterKit.setup() must be called first.`);
+        }
+        RouterKit.adapter.registerNotFoundHandler((_req, res) => {
+            const start = Date.now();
+            RouterKit.adapter.sendResponse(res, 404, {
+                message: "Path not found",
+                data: null,
+            });
+            const config = RouterKit.config;
+            if (config?.logger && (config.logger === true || (typeof config.logger === 'object' && config.logger.enabled !== false))) {
+                const duration = Date.now() - start;
+                const method = RouterKit.adapter.getMethod(_req);
+                const url = RouterKit.adapter.getUrl(_req);
+                const handler = typeof config.logger === 'object' ? config.logger.handler : undefined;
+                Logger.logRequest(method, url, 404, duration, undefined, handler);
+            }
+        });
+        console.log(`Registered global Not Found handler`);
+    }
+    /**
+     * Resets RouterKit state — berguna untuk testing agar state bersih antar test.
+     * @internal
+     */
+    static reset() {
+        RouterKit.adapter = null;
+        RouterKit.resolver = null;
+        RouterKit.config = null;
+        RouterKit.isSetup = false;
+    }
+}
+//# sourceMappingURL=RouterKit.js.map

package/dist/core/RouterKit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterKit.js","sourceRoot":"","sources":["../../core/RouterKit.ts"],"names":[],"mappings":"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"}

package/dist/decorators/controller/ReqController.d.ts

@@ -0,0 +1,29 @@
+import type { ControllerOptions } 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 declare function ReqController(basePath: string, options?: ControllerOptions): (_value: Function, context: ClassDecoratorContext) => void;
+//# sourceMappingURL=ReqController.d.ts.map

package/dist/decorators/controller/ReqController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReqController.d.ts","sourceRoot":"","sources":["../../../decorators/controller/ReqController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,sBAAsB,CAAC;AAGlF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,IACxD,QAAQ,QAAQ,EAAE,SAAS,qBAAqB,UAalE"}