katanakit-js 2.2.1 → 2.12.9

package/dist/adapters/express/products.controller.d.ts

@@ -1,10 +1,69 @@
 import type { Request, Response } from "express";
-export declare class ProductController {
-    private products;
-    useGetAll(_request: Request, response: Response): void;
-    useGetProductById(request: Request, response: Response): void;
-    useCreateProduct(request: Request, response: Response): void;
-    useUpsertProduct(request: Request, response: Response): void;
-    useDeleteProductById(request: Request, response: Response): void;
-}
+/**
+ * Get all products.
+ *
+ * @param _request - Express request (unused)
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.get("/products", useExpressGetAllProducts);
+ * // GET /products → [{ id: 1, name: "Widget", price: 9.99 }]
+ * ```
+ */
+export declare const useExpressGetAllProducts: (_request: Request, response: Response) => void;
+/**
+ * Get a product by ID.
+ *
+ * @param request - Express request with `id` param
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.get("/products/:id", useExpressGetProductById);
+ * // GET /products/1 → { productById: { id: 1, name: "Widget", price: 9.99 } }
+ * ```
+ */
+export declare const useExpressGetProductById: (request: Request, response: Response) => void;
+/**
+ * Create a new product.
+ *
+ * @param request - Express request with `name` and `price` in body
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.post("/products", useExpressCreateProduct);
+ * // POST /products { name: "Gadget", price: 19.99 }
+ * // → { id: 1, name: "Gadget", price: 19.99 }
+ * ```
+ */
+export declare const useExpressCreateProduct: (request: Request, response: Response) => void;
+/**
+ * Update an existing product by ID.
+ *
+ * @param request - Express request with `id` param and body fields
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.put("/products/:id", useExpressUpdateProduct);
+ * // PUT /products/1 { name: "Updated Widget" }
+ * // → { id: 1, name: "Updated Widget", price: 9.99 }
+ * ```
+ */
+export declare const useExpressUpdateProduct: (request: Request, response: Response) => void;
+/**
+ * Delete a product by ID.
+ *
+ * @param request - Express request with `id` param
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.delete("/products/:id", useExpressDeleteProduct);
+ * // DELETE /products/1 → 204 No Content
+ * ```
+ */
+export declare const useExpressDeleteProduct: (request: Request, response: Response) => void;
 //# sourceMappingURL=products.controller.d.ts.map

package/dist/adapters/express/products.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"products.controller.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/products.controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIjD,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAqB;IAGrC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAErD;IAGD,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAU5D;IAGD,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAc3D;IAGD,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAiB3D;IAGD,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAW/D;CACD"}
+{"version":3,"file":"products.controller.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/products.controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAOjD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,aAAc,OAAO,YAAY,QAAQ,KAAG,IAEhF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,YAAa,OAAO,YAAY,QAAQ,KAAG,IAU/E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,YAAa,OAAO,YAAY,QAAQ,KAAG,IAc9E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,YAAa,OAAO,YAAY,QAAQ,KAAG,IAiB9E,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,YAAa,OAAO,YAAY,QAAQ,KAAG,IAW9E,CAAC"}

package/dist/adapters/express/products.controller.js

@@ -1,53 +1,109 @@
-export class ProductController {
-    products = [];
-    // GET /products
-    useGetAll(_request, response) {
-        response.json(this.products);
+/** Module-level products storage. */
+const products = [];
+/**
+ * Get all products.
+ *
+ * @param _request - Express request (unused)
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.get("/products", useExpressGetAllProducts);
+ * // GET /products → [{ id: 1, name: "Widget", price: 9.99 }]
+ * ```
+ */
+export const useExpressGetAllProducts = (_request, response) => {
+    response.json(products);
+};
+/**
+ * Get a product by ID.
+ *
+ * @param request - Express request with `id` param
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.get("/products/:id", useExpressGetProductById);
+ * // GET /products/1 → { productById: { id: 1, name: "Widget", price: 9.99 } }
+ * ```
+ */
+export const useExpressGetProductById = (request, response) => {
+    const id = Number.parseInt(String(request.params.id), 10);
+    const product = products.find((item) => item.id === id);
+    if (!product) {
+        response.status(404).json({ error: "Product not found" });
+        return;
     }
-    // GET /products/:id
-    useGetProductById(request, response) {
-        const id = Number.parseInt(String(request.params.id), 10);
-        const product = this.products.find((item) => item.id === id);
-        if (!product) {
-            response.status(404).json({ error: "Product not found" });
-            return;
-        }
-        response.json({ productById: product });
+    response.json({ productById: product });
+};
+/**
+ * Create a new product.
+ *
+ * @param request - Express request with `name` and `price` in body
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.post("/products", useExpressCreateProduct);
+ * // POST /products { name: "Gadget", price: 19.99 }
+ * // → { id: 1, name: "Gadget", price: 19.99 }
+ * ```
+ */
+export const useExpressCreateProduct = (request, response) => {
+    const { name = "", price = 0 } = (request.body ?? {});
+    const product = {
+        id: products.length + 1,
+        name,
+        price: Number(price),
+    };
+    products.push(product);
+    response.status(201).json(product);
+};
+/**
+ * Update an existing product by ID.
+ *
+ * @param request - Express request with `id` param and body fields
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.put("/products/:id", useExpressUpdateProduct);
+ * // PUT /products/1 { name: "Updated Widget" }
+ * // → { id: 1, name: "Updated Widget", price: 9.99 }
+ * ```
+ */
+export const useExpressUpdateProduct = (request, response) => {
+    const id = Number.parseInt(String(request.params.id), 10);
+    const product = products.find((item) => item.id === id);
+    if (!product) {
+        response.status(404).json({ error: "Product not found" });
+        return;
     }
-    // POST /products
-    useCreateProduct(request, response) {
-        const { name = "", price = 0 } = (request.body ?? {});
-        const product = {
-            id: this.products.length + 1,
-            name,
-            price: Number(price),
-        };
-        this.products.push(product);
-        response.status(201).json(product);
+    const { name, price } = (request.body ?? {});
+    product.name = name ?? product.name;
+    product.price = Number(price ?? product.price);
+    response.json(product);
+};
+/**
+ * Delete a product by ID.
+ *
+ * @param request - Express request with `id` param
+ * @param response - Express response
+ *
+ * @example
+ * ```ts
+ * router.delete("/products/:id", useExpressDeleteProduct);
+ * // DELETE /products/1 → 204 No Content
+ * ```
+ */
+export const useExpressDeleteProduct = (request, response) => {
+    const id = Number.parseInt(String(request.params.id), 10);
+    const index = products.findIndex((item) => item.id === id);
+    if (index === -1) {
+        response.status(404).json({ error: "Product not found" });
+        return;
     }
-    // PUT /products/:id
-    useUpsertProduct(request, response) {
-        const id = Number.parseInt(String(request.params.id), 10);
-        const product = this.products.find((item) => item.id === id);
-        if (!product) {
-            response.status(404).json({ error: "Product not found" });
-            return;
-        }
-        const { name, price } = (request.body ?? {});
-        product.name = name ?? product.name;
-        product.price = Number(price ?? product.price);
-        response.json(product);
-    }
-    // DELETE /products/:id
-    useDeleteProductById(request, response) {
-        const id = Number.parseInt(String(request.params.id), 10);
-        const index = this.products.findIndex((item) => item.id === id);
-        if (index === -1) {
-            response.status(404).json({ error: "Product not found" });
-            return;
-        }
-        this.products.splice(index, 1);
-        response.status(204).send();
-    }
-}
+    products.splice(index, 1);
+    response.status(204).send();
+};
 //# sourceMappingURL=products.controller.js.map

package/dist/adapters/express/products.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"products.controller.js","sourceRoot":"","sources":["../../../src/adapters/express/products.controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"products.controller.js","sourceRoot":"","sources":["../../../src/adapters/express/products.controller.ts"],"names":[],"mappings":"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"}

package/dist/adapters/express/server.d.ts

@@ -1,15 +1,39 @@
 import { type Application } from "express";
-export default class ServerExpress {
-    private static instance;
-    private readonly app;
-    private readonly port;
-    private readonly host;
-    private constructor();
-    static getInstance(): ServerExpress;
-    useStart: () => void;
-    useGetApp: () => Application;
-    private setupMiddlewares;
-    private setupRoutes;
-    private setupErrorHandling;
-}
+/**
+ * Create and configure the Express application.
+ *
+ * @returns Configured Express Application instance
+ *
+ * @example
+ * ```ts
+ * const expressApp = useExpressCreate();
+ * // App is ready with middleware, routes and error handling
+ * ```
+ */
+export declare const useExpressCreate: () => Application;
+/**
+ * Start the Express HTTP server. Idempotent — subsequent calls are no-ops.
+ *
+ * @param port - Port to listen on (default: 3000)
+ * @param host - Host to bind to (default: "localhost")
+ *
+ * @example
+ * ```ts
+ * useExpressStart(3000, "localhost");
+ * // Server running on http://localhost:3000
+ * ```
+ */
+export declare const useExpressStart: (port?: number, host?: string) => void;
+/**
+ * Get the Express application instance. Creates it if it doesn't exist.
+ *
+ * @returns Express Application instance
+ *
+ * @example
+ * ```ts
+ * const expressApp = useExpressGetApp();
+ * expressApp.get("/custom", (req, res) => res.json({ ok: true }));
+ * ```
+ */
+export declare const useExpressGetApp: () => Application;
 //# sourceMappingURL=server.d.ts.map

package/dist/adapters/express/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/server.ts"],"names":[],"mappings":"AACA,OAAgB,EAAE,KAAK,WAAW,EAAkD,MAAM,SAAS,CAAC;AAKpG,MAAM,CAAC,OAAO,OAAO,aAAa;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,OAAO,eAIN;IAED,MAAM,CAAC,WAAW,IAAI,aAAa,CAKlC;IAED,QAAQ,QAAO,IAAI,CAQjB;IAEF,SAAS,QAAO,WAAW,CAAa;IAExC,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,kBAAkB;CAU1B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/server.ts"],"names":[],"mappings":"AACA,OAAgB,EAAE,KAAK,WAAW,EAAkD,MAAM,SAAS,CAAC;AAgFpG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,QAAO,WASnC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,oCAAsC,IASjE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,QAAO,WAAiC,CAAC"}

package/dist/adapters/express/server.js

@@ -1,59 +1,124 @@
 import cors from "cors";
 import express from "express";
-import { useLog } from "../../core/services/logger.service.js";
+import { useLogger } from "../../core/services/logger.service.js";
 import router from "./router.js";
-export default class ServerExpress {
-    static instance;
-    app;
-    port;
-    host;
-    constructor(port = 3000, host = "localhost") {
-        this.app = express();
-        this.port = port;
-        this.host = host;
-    }
-    static getInstance() {
-        if (!ServerExpress.instance) {
-            ServerExpress.instance = new ServerExpress();
-        }
-        return ServerExpress.instance;
-    }
-    useStart = () => {
-        this.setupMiddlewares();
-        this.setupRoutes();
-        this.setupErrorHandling();
-        this.app.listen(this.port, this.host, () => {
-            useLog(`Server running on http://${this.host}:${this.port}`);
-        });
-    };
-    useGetApp = () => this.app;
-    setupMiddlewares() {
-        // Restrict CORS to configured origins (defaults to localhost).
-        this.app.use(cors({
-            origin: process.env.CORS_ORIGINS?.split(",") ?? ["http://localhost:3000"],
-            methods: ["GET", "POST", "PUT", "DELETE"],
-        }));
-        this.app.disable("x-powered-by");
-        this.app.use(express.json({ limit: "100kb" }));
-        this.app.use(express.urlencoded({ extended: true, limit: "100kb" }));
-    }
-    setupRoutes() {
-        this.app.get("/health", (_request, response) => {
-            return response.json({
-                status: "ok",
-                timestamp: new Date().toISOString(),
-            });
-        });
-        this.app.use("/", router);
-    }
-    setupErrorHandling() {
-        this.app.use((err, _req, res, _next) => {
-            console.error("Unhandled error:", err);
-            res.status(500).json({ error: "Internal Server Error" });
-        });
-        this.app.use((_req, res) => {
-            res.status(404).json({ error: "Not Found" });
+/** Module-level state for the Express server. */
+let app = null;
+let started = false;
+/**
+ * Set up CORS, JSON body parser and URL-encoded middleware.
+ *
+ * @param expressApp - Express application instance
+ *
+ * @example
+ * ```ts
+ * const expressApp = express();
+ * useExpressSetupMiddlewares(expressApp);
+ * ```
+ */
+function useExpressSetupMiddlewares(expressApp) {
+    const origins = (process.env.CORS_ORIGINS?.split(",") ?? ["http://localhost:3000"])
+        .map((origin) => origin.trim())
+        .filter(Boolean);
+    expressApp.use(cors({
+        origin: origins,
+        methods: ["GET", "POST", "PUT", "DELETE"],
+    }));
+    expressApp.disable("x-powered-by");
+    expressApp.use(express.json({ limit: "100kb" }));
+    expressApp.use(express.urlencoded({ extended: true, limit: "100kb" }));
+}
+/**
+ * Set up health check and application routes.
+ *
+ * @param expressApp - Express application instance
+ *
+ * @example
+ * ```ts
+ * useExpressSetupRoutes(expressApp);
+ * // GET /health returns { status: "ok", timestamp: "..." }
+ * ```
+ */
+function useExpressSetupRoutes(expressApp) {
+    expressApp.get("/health", (_request, response) => {
+        return response.json({
+            status: "ok",
+            timestamp: new Date().toISOString(),
         });
-    }
+    });
+    expressApp.use("/", router);
+}
+/**
+ * Set up global error handling and 404 fallback.
+ *
+ * @param expressApp - Express application instance
+ *
+ * @example
+ * ```ts
+ * useExpressSetupErrorHandling(expressApp);
+ * // Unhandled errors return 500, unknown routes return 404
+ * ```
+ */
+function useExpressSetupErrorHandling(expressApp) {
+    expressApp.use((err, _req, res, _next) => {
+        console.error("Unhandled error:", err);
+        res.status(500).json({ error: "Internal Server Error" });
+    });
+    expressApp.use((_req, res) => {
+        res.status(404).json({ error: "Not Found" });
+    });
 }
+/**
+ * Create and configure the Express application.
+ *
+ * @returns Configured Express Application instance
+ *
+ * @example
+ * ```ts
+ * const expressApp = useExpressCreate();
+ * // App is ready with middleware, routes and error handling
+ * ```
+ */
+export const useExpressCreate = () => {
+    if (app)
+        return app;
+    app = express();
+    useExpressSetupMiddlewares(app);
+    useExpressSetupRoutes(app);
+    useExpressSetupErrorHandling(app);
+    return app;
+};
+/**
+ * Start the Express HTTP server. Idempotent — subsequent calls are no-ops.
+ *
+ * @param port - Port to listen on (default: 3000)
+ * @param host - Host to bind to (default: "localhost")
+ *
+ * @example
+ * ```ts
+ * useExpressStart(3000, "localhost");
+ * // Server running on http://localhost:3000
+ * ```
+ */
+export const useExpressStart = (port = 3000, host = "localhost") => {
+    if (started)
+        return;
+    started = true;
+    const expressApp = useExpressCreate();
+    expressApp.listen(port, host, () => {
+        useLogger("info", `Server running on http://${host}:${port}`);
+    });
+};
+/**
+ * Get the Express application instance. Creates it if it doesn't exist.
+ *
+ * @returns Express Application instance
+ *
+ * @example
+ * ```ts
+ * const expressApp = useExpressGetApp();
+ * expressApp.get("/custom", (req, res) => res.json({ ok: true }));
+ * ```
+ */
+export const useExpressGetApp = () => useExpressCreate();
 //# sourceMappingURL=server.js.map

package/dist/adapters/express/server.js.map

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

package/dist/adapters/nuxt/nuxt.service.d.ts

@@ -3,6 +3,8 @@ import type { FetchResult } from "../../types/index.js";
  * Unwraps a KatanaKit Safe Result, throwing an H3-compatible error on failure.
  * Returns the data directly on success.
  *
+ * Prefers `h3.createError` when available so Nuxt/H3 status codes work correctly.
+ *
  * @param result - The Safe Result from `useFetch`, `useGet`, `usePost`, etc.
  * @param context - Optional context prefix for the error message.
  * @returns The data from the result.
@@ -11,12 +13,12 @@ import type { FetchResult } from "../../types/index.js";
  * @example
  * ```ts
  * // server/api/pokemon/[id].ts
- * import { useGet } from "katanakit-js";
+ * import { useGetApi } from "katanakit-js";
  * import { useUnwrap } from "katanakit-js/adapters/nuxt";
  *
  * export default defineEventHandler(async (event) => {
  *   const id = getRouterParam(event, "id");
- *   const result = await useGet("pokeapi", "pokemonById", { params: { id } });
+ *   const result = await useGetApi("pokeapi", "pokemonById", { params: { id } });
  *   return useUnwrap(result, `Pokemon ${id}`);
  * });
  * ```
@@ -33,11 +35,11 @@ export declare function useUnwrap<T>(result: FetchResult<T>, context?: string):
  * @example
  * ```ts
  * // server/api/users.ts
- * import { useGet } from "katanakit-js";
+ * import { useGetApi } from "katanakit-js";
  * import { useSafeResponse } from "katanakit-js/adapters/nuxt";
  *
  * export default defineEventHandler(async () => {
- *   const result = await useGet("api", "users");
+ *   const result = await useGetApi("api", "users");
  *   return useSafeResponse(result);
  * });
  * ```
@@ -61,11 +63,11 @@ export declare function useSafeResponse<T>(result: FetchResult<T>): {
  * @example
  * ```ts
  * // server/api/products.ts
- * import { useFetch } from "katanakit-js";
+ * import { useFetchApi } from "katanakit-js";
  * import { useEventResponse } from "katanakit-js/adapters/nuxt";
  *
  * export default defineEventHandler(async (event) => {
- *   const result = await useFetch("shop", "products");
+ *   const result = await useFetchApi("shop", "products");
  *   return useEventResponse(event, result);
  * });
  * ```

package/dist/adapters/nuxt/nuxt.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nuxt.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/nuxt/nuxt.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAYxE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG;IAC3D,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,EAAE,EAAE,OAAO,CAAC;CACZ,CAaA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,KAAK,EAAE;IAAE,IAAI,EAAE;QAAE,GAAG,EAAE;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,EAChD,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACpB,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWvC"}
+{"version":3,"file":"nuxt.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/nuxt/nuxt.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAsBxD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAUxE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG;IAC3D,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,EAAE,EAAE,OAAO,CAAC;CACZ,CAaA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,KAAK,EAAE;IAAE,IAAI,EAAE;QAAE,GAAG,EAAE;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,EAChD,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACpB,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWvC"}