@simplysm/service-server 13.0.99 → 14.0.1

package/dist/transport/http/upload-handler.js

@@ -6,64 +6,69 @@ import { fsx } from "@simplysm/core-node";
 import { verifyJwt } from "../../auth/jwt-manager.js";
 import consola from "consola";
 const logger = consola.withTag("service-server:UploadHandler");
-async function handleUpload(req, reply, rootPath, jwtSecret) {
-  if (!req.isMultipart()) {
-    reply.status(400).send("Multipart request expected");
-    return;
-  }
-  try {
-    const authHeader = req.headers.authorization;
-    if (authHeader == null) {
-      throw new Error("Authentication token is missing.");
+export async function handleUpload(req, reply, rootPath, jwtSecret) {
+    if (!req.isMultipart()) {
+        reply.status(400).send("Multipart 요청이 필요합니다");
+        return;
     }
-    if (jwtSecret == null) {
-      throw new Error("JWT Secret is not defined.");
-    }
-    const token = authHeader.split(" ")[1];
-    await verifyJwt(jwtSecret, token);
-  } catch (err) {
-    reply.status(401).send({
-      error: "Unauthorized",
-      message: err instanceof Error ? err.message : String(err)
-    });
-    return;
-  }
-  const result = [];
-  const uploadDir = path.resolve(rootPath, "www", "uploads");
-  await fsx.mkdir(uploadDir);
-  let currentSavePath;
-  try {
-    for await (const part of req.parts()) {
-      if (part.type === "file") {
-        const originalFilename = part.filename;
-        const extension = path.extname(originalFilename);
-        const saveName = `${Uuid.generate().toString()}${extension}`;
-        currentSavePath = path.join(uploadDir, saveName);
-        await pipeline(part.file, createWriteStream(currentSavePath));
-        if (part.file.truncated) {
-          throw new Error(`File limit exceeded: ${originalFilename}`);
+    // 인증 확인
+    try {
+        const authHeader = req.headers.authorization;
+        if (authHeader == null) {
+            throw new Error("인증 토큰이 누락되었습니다.");
+        }
+        if (jwtSecret == null) {
+            throw new Error("JWT Secret이 정의되지 않았습니다.");
         }
-        const stats = await fsx.stat(currentSavePath);
-        result.push({
-          path: `uploads/${saveName}`,
-          filename: originalFilename,
-          size: stats.size
+        const token = authHeader.split(" ")[1];
+        await verifyJwt(jwtSecret, token);
+    }
+    catch (err) {
+        reply.status(401).send({
+            error: "인증 실패",
+            message: err instanceof Error ? err.message : String(err),
         });
-        currentSavePath = void 0;
-      }
+        return;
     }
-    reply.send(result);
-  } catch (err) {
-    logger.error("Upload Error", err);
-    if (currentSavePath != null) {
-      await fsx.rm(currentSavePath).catch(() => {
-      });
-      logger.warn(`Incomplete file deleted: ${currentSavePath}`);
+    const result = [];
+    const uploadDir = path.resolve(rootPath, "www", "uploads");
+    await fsx.mkdir(uploadDir);
+    let currentSavePath;
+    try {
+        for await (const part of req.parts()) {
+            if (part.type === "file") {
+                const originalFilename = part.filename;
+                const extension = path.extname(originalFilename);
+                const saveName = `${Uuid.generate().toString()}${extension}`;
+                currentSavePath = path.join(uploadDir, saveName);
+                await pipeline(part.file, createWriteStream(currentSavePath));
+                if (part.file.truncated) {
+                    throw new Error(`파일 크기 제한 초과: ${originalFilename}`);
+                }
+                const stats = await fsx.stat(currentSavePath);
+                result.push({
+                    path: `uploads/${saveName}`,
+                    filename: originalFilename,
+                    size: stats.size,
+                });
+                currentSavePath = undefined;
+            }
+        }
+        reply.send(result);
+    }
+    catch (err) {
+        logger.error("업로드 에러", err);
+        if (currentSavePath != null) {
+            await fsx.rm(currentSavePath).catch(() => { });
+            logger.warn(`불완전한 파일 삭제됨: ${currentSavePath}`);
+        }
+        // 이미 저장된 파일 정리
+        for (const savedFile of result) {
+            const savedPath = path.resolve(rootPath, "www", savedFile.path);
+            await fsx.rm(savedPath).catch(() => { });
+            logger.warn(`이미 저장된 파일 삭제됨: ${savedPath}`);
+        }
+        reply.code(500).send("업로드 실패");
     }
-    reply.code(500).send("Upload Failed");
-  }
 }
-export {
-  handleUpload
-};
-//# sourceMappingURL=upload-handler.js.map
+//# sourceMappingURL=upload-handler.js.map

package/dist/transport/http/upload-handler.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../../src/transport/http/upload-handler.ts"],
-  "mappings": "AAAA,OAAO,UAAU;AACjB,SAAS,yBAAyB;AAClC,SAAS,gBAAgB;AACzB,SAAS,YAAY;AACrB,SAAS,WAAW;AAGpB,SAAS,iBAAiB;AAC1B,OAAO,aAAa;AAEpB,MAAM,SAAS,QAAQ,QAAQ,8BAA8B;AAE7D,eAAsB,aACpB,KACA,OACA,UACA,WACe;AACf,MAAI,CAAC,IAAI,YAAY,GAAG;AACtB,UAAM,OAAO,GAAG,EAAE,KAAK,4BAA4B;AACnD;AAAA,EACF;AAGA,MAAI;AACF,UAAM,aAAa,IAAI,QAAQ;AAC/B,QAAI,cAAc,MAAM;AACtB,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AACA,QAAI,aAAa,MAAM;AACrB,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AACA,UAAM,QAAQ,WAAW,MAAM,GAAG,EAAE,CAAC;AACrC,UAAM,UAAU,WAAW,KAAK;AAAA,EAClC,SAAS,KAAK;AACZ,UAAM,OAAO,GAAG,EAAE,KAAK;AAAA,MACrB,OAAO;AAAA,MACP,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,IAC1D,CAAC;AACD;AAAA,EACF;AAEA,QAAM,SAAgC,CAAC;AACvC,QAAM,YAAY,KAAK,QAAQ,UAAU,OAAO,SAAS;AAEzD,QAAM,IAAI,MAAM,SAAS;AAEzB,MAAI;AAEJ,MAAI;AACF,qBAAiB,QAAQ,IAAI,MAAM,GAAG;AACpC,UAAI,KAAK,SAAS,QAAQ;AACxB,cAAM,mBAAmB,KAAK;AAC9B,cAAM,YAAY,KAAK,QAAQ,gBAAgB;AAC/C,cAAM,WAAW,GAAG,KAAK,SAAS,EAAE,SAAS,CAAC,GAAG,SAAS;AAC1D,0BAAkB,KAAK,KAAK,WAAW,QAAQ;AAE/C,cAAM,SAAS,KAAK,MAAM,kBAAkB,eAAe,CAAC;AAE5D,YAAI,KAAK,KAAK,WAAW;AACvB,gBAAM,IAAI,MAAM,wBAAwB,gBAAgB,EAAE;AAAA,QAC5D;AAEA,cAAM,QAAQ,MAAM,IAAI,KAAK,eAAe;AAE5C,eAAO,KAAK;AAAA,UACV,MAAM,WAAW,QAAQ;AAAA,UACzB,UAAU;AAAA,UACV,MAAM,MAAM;AAAA,QACd,CAAC;AAED,0BAAkB;AAAA,MACpB;AAAA,IACF;AAEA,UAAM,KAAK,MAAM;AAAA,EACnB,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,GAAG;AAEhC,QAAI,mBAAmB,MAAM;AAC3B,YAAM,IAAI,GAAG,eAAe,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAC5C,aAAO,KAAK,4BAA4B,eAAe,EAAE;AAAA,IAC3D;AAEA,UAAM,KAAK,GAAG,EAAE,KAAK,eAAe;AAAA,EACtC;AACF;",
-  "names": []
-}
+{"version":3,"file":"upload-handler.js","sourceRoot":"","sources":["..\\..\\..\\src\\transport\\http\\upload-handler.ts"],"names":[],"mappings":"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"}

package/dist/transport/socket/service-socket.d.ts

@@ -4,10 +4,10 @@ import { WebSocket } from "ws";
 import type { AuthTokenPayload } from "../../auth/auth-token-payload";
 import type { ServiceClientMessage, ServiceServerMessage } from "@simplysm/service-common";
 /**
- * Service socket interface
+ * 서비스 소켓 인터페이스
  *
- * Manages a single WebSocket connection with protocol encoding/decoding,
- * ping/pong keep-alive, and event listener tracking.
+ * 프로토콜 인코딩/디코딩, ping/pong 연결 유지,
+ * 이벤트 리스너 추적이 포함된 단일 WebSocket 연결을 관리한다.
  */
 export interface ServiceSocket {
     readonly connectedAtDateTime: DateTime;
@@ -15,34 +15,34 @@ export interface ServiceSocket {
     readonly connReq: FastifyRequest;
     authTokenPayload?: AuthTokenPayload;
     /**
-     * Close the WebSocket connection
+     * WebSocket 연결을 닫는다
      */
     close(): void;
     /**
-     * Send a message to the client
+     * 클라이언트에 메시지를 전송한다
      */
     send(uuid: string, msg: ServiceServerMessage): Promise<number>;
     /**
-     * Register an event listener with key/name/info
+     * key/name/info로 이벤트 리스너를 등록한다
      */
     addListener(key: string, eventName: string, info: unknown): void;
     /**
-     * Remove an event listener by key
+     * key로 이벤트 리스너를 제거한다
      */
     removeListener(key: string): void;
     /**
-     * Get all event listeners for a specific event name
+     * 특정 이벤트 이름에 해당하는 모든 이벤트 리스너를 조회한다
      */
     getEventListeners(eventName: string): Array<{
         key: string;
         info: unknown;
     }>;
     /**
-     * Filter target keys that exist in this socket's listeners
+     * 이 소켓의 리스너에 존재하는 대상 키를 필터링한다
      */
     filterEventTargetKeys(targetKeys: string[]): string[];
     /**
-     * Register event handlers
+     * 이벤트 핸들러를 등록한다
      */
     on(event: "error", handler: (err: Error) => void): void;
     on(event: "close", handler: (code: number) => void): void;
@@ -52,10 +52,10 @@ export interface ServiceSocket {
     }) => void): void;
 }
 /**
- * Create a service socket instance
+ * 서비스 소켓 인스턴스를 생성한다
  *
- * Manages a single WebSocket connection with protocol encoding/decoding,
- * ping/pong keep-alive, and event listener tracking.
+ * 프로토콜 인코딩/디코딩, ping/pong 연결 유지,
+ * 이벤트 리스너 추적이 포함된 단일 WebSocket 연결을 관리한다.
  */
 export declare function createServiceSocket(socket: WebSocket, clientId: string, clientName: string, connReq: FastifyRequest): ServiceSocket;
 //# sourceMappingURL=service-socket.d.ts.map

package/dist/transport/socket/service-socket.js

@@ -4,117 +4,141 @@ import consola from "consola";
 import { WebSocket } from "ws";
 import { createServerProtocolWrapper } from "../../protocol/protocol-wrapper.js";
 const logger = consola.withTag("service-server:ServiceSocket");
-function createServiceSocket(socket, clientId, clientName, connReq) {
-  const PING_INTERVAL = 5e3;
-  const PONG_PACKET = new Uint8Array([2]);
-  const protocol = createServerProtocolWrapper();
-  const listenerInfos = [];
-  const eventHandlers = {
-    error: [],
-    close: [],
-    message: []
-  };
-  let isAlive = true;
-  let authTokenPayload;
-  const connectedAtDateTime = new DateTime();
-  async function sendInternal(uuid, msg) {
-    if (socket.readyState !== WebSocket.OPEN) return 0;
-    const { chunks } = await protocol.encode(uuid, msg);
-    for (const chunk of chunks) {
-      socket.send(chunk);
-    }
-    return chunks.reduce((acc, item) => acc + item.length, 0);
-  }
-  function emitEvent(event, ...args) {
-    for (const handler of eventHandlers[event]) {
-      handler(...args);
+/**
+ * 서비스 소켓 인스턴스를 생성한다
+ *
+ * 프로토콜 인코딩/디코딩, ping/pong 연결 유지,
+ * 이벤트 리스너 추적이 포함된 단일 WebSocket 연결을 관리한다.
+ */
+export function createServiceSocket(socket, clientId, clientName, connReq) {
+    // -------------------------------------------------------------------
+    // 상태
+    // -------------------------------------------------------------------
+    const PING_INTERVAL = 5000; // 5초마다 ping 전송
+    const PONG_PACKET = new Uint8Array([0x02]);
+    const protocol = createServerProtocolWrapper();
+    const listenerInfos = [];
+    const eventHandlers = {
+        error: [],
+        close: [],
+        message: [],
+    };
+    let isAlive = true;
+    let authTokenPayload;
+    const connectedAtDateTime = new DateTime();
+    // -------------------------------------------------------------------
+    // 헬퍼
+    // -------------------------------------------------------------------
+    async function sendInternal(uuid, msg) {
+        if (socket.readyState !== WebSocket.OPEN)
+            return 0;
+        const { chunks } = await protocol.encode(uuid, msg);
+        for (const chunk of chunks) {
+            socket.send(chunk);
+        }
+        return chunks.reduce((acc, item) => acc + item.length, 0);
     }
-  }
-  function onError(err) {
-    logger.error("WebSocket client error", err);
-    emitEvent("error", err);
-  }
-  function onClose(code) {
-    clearInterval(pingTimer);
-    protocol.dispose();
-    emitEvent("close", code);
-  }
-  async function onMessage(msgBuffer) {
-    try {
-      if (msgBuffer.length === 1 && msgBuffer[0] === 1) {
-        if (socket.readyState === WebSocket.OPEN) {
-          socket.send(PONG_PACKET);
+    function emitEvent(event, ...args) {
+        for (const handler of eventHandlers[event]) {
+            handler(...args);
         }
-        return;
-      }
-      const decodeResult = await protocol.decode(msgBuffer);
-      if (decodeResult.type === "progress") {
-        await sendInternal(decodeResult.uuid, {
-          name: "progress",
-          body: {
-            totalSize: decodeResult.totalSize,
-            completedSize: decodeResult.completedSize
-          }
-        });
-      } else {
-        const msg = decodeResult.message;
-        emitEvent("message", { uuid: decodeResult.uuid, msg });
-      }
-    } catch (err) {
-      logger.error("Error processing WebSocket message", err);
     }
-  }
-  socket.on("close", onClose);
-  socket.on("error", onError);
-  socket.on("message", onMessage);
-  socket.on("pong", () => {
-    isAlive = true;
-  });
-  const pingTimer = setInterval(() => {
-    if (!isAlive) {
-      socket.terminate();
-      return;
+    // -------------------------------------------------------------------
+    // 이벤트 핸들러
+    // -------------------------------------------------------------------
+    function onError(err) {
+        logger.error("WebSocket 클라이언트 에러", err);
+        emitEvent("error", err);
+    }
+    function onClose(code) {
+        clearInterval(pingTimer);
+        protocol.dispose();
+        emitEvent("close", code);
     }
-    isAlive = false;
-    socket.ping();
-  }, PING_INTERVAL);
-  return {
-    connectedAtDateTime,
-    clientName,
-    connReq,
-    get authTokenPayload() {
-      return authTokenPayload;
-    },
-    set authTokenPayload(value) {
-      authTokenPayload = value;
-    },
-    close() {
-      socket.terminate();
-    },
-    async send(uuid, msg) {
-      return sendInternal(uuid, msg);
-    },
-    addListener(key, eventName, info) {
-      listenerInfos.push({ key, eventName, info });
-    },
-    removeListener(key) {
-      const idx = listenerInfos.findIndex((item) => item.key === key);
-      if (idx >= 0) {
-        listenerInfos.splice(idx, 1);
-      }
-    },
-    getEventListeners(eventName) {
-      return listenerInfos.filter((item) => item.eventName === eventName).map((item) => ({ key: item.key, info: item.info }));
-    },
-    filterEventTargetKeys(targetKeys) {
-      return listenerInfos.filter((item) => targetKeys.includes(item.key)).map((item) => item.key);
-    },
-    on(event, handler) {
-      eventHandlers[event].push(handler);
+    async function onMessage(msgBuffer) {
+        try {
+            // ping에 대한 pong 응답 처리
+            if (msgBuffer.length === 1 && msgBuffer[0] === 0x01) {
+                if (socket.readyState === WebSocket.OPEN) {
+                    socket.send(PONG_PACKET);
+                }
+                return;
+            }
+            const decodeResult = await protocol.decode(msgBuffer);
+            if (decodeResult.type === "progress") {
+                await sendInternal(decodeResult.uuid, {
+                    name: "progress",
+                    body: {
+                        totalSize: decodeResult.totalSize,
+                        completedSize: decodeResult.completedSize,
+                    },
+                });
+            }
+            else {
+                const msg = decodeResult.message;
+                emitEvent("message", { uuid: decodeResult.uuid, msg });
+            }
+        }
+        catch (err) {
+            logger.error("WebSocket 메시지 처리 중 에러 발생", err);
+        }
     }
-  };
+    // -------------------------------------------------------------------
+    // 설정
+    // -------------------------------------------------------------------
+    socket.on("close", onClose);
+    socket.on("error", onError);
+    socket.on("message", onMessage);
+    socket.on("pong", () => {
+        isAlive = true;
+    });
+    const pingTimer = setInterval(() => {
+        if (!isAlive) {
+            socket.terminate();
+            return;
+        }
+        isAlive = false;
+        socket.ping();
+    }, PING_INTERVAL);
+    // -------------------------------------------------------------------
+    // 공개 API
+    // -------------------------------------------------------------------
+    return {
+        connectedAtDateTime,
+        clientName,
+        connReq,
+        get authTokenPayload() {
+            return authTokenPayload;
+        },
+        set authTokenPayload(value) {
+            authTokenPayload = value;
+        },
+        close() {
+            socket.terminate();
+        },
+        async send(uuid, msg) {
+            return sendInternal(uuid, msg);
+        },
+        addListener(key, eventName, info) {
+            listenerInfos.push({ key, eventName, info });
+        },
+        removeListener(key) {
+            const idx = listenerInfos.findIndex((item) => item.key === key);
+            if (idx >= 0) {
+                listenerInfos.splice(idx, 1);
+            }
+        },
+        getEventListeners(eventName) {
+            return listenerInfos
+                .filter((item) => item.eventName === eventName)
+                .map((item) => ({ key: item.key, info: item.info }));
+        },
+        filterEventTargetKeys(targetKeys) {
+            return listenerInfos.filter((item) => targetKeys.includes(item.key)).map((item) => item.key);
+        },
+        on(event, handler) {
+            eventHandlers[event].push(handler);
+        },
+    };
 }
-export {
-  createServiceSocket
-};
-//# sourceMappingURL=service-socket.js.map
+//# sourceMappingURL=service-socket.js.map

package/dist/transport/socket/service-socket.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../../src/transport/socket/service-socket.ts"],
-  "mappings": "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",
-  "names": []
-}
+{"version":3,"file":"service-socket.js","sourceRoot":"","sources":["..\\..\\..\\src\\transport\\socket\\service-socket.ts"],"names":[],"mappings":"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"}

package/dist/transport/socket/websocket-handler.d.ts

@@ -3,34 +3,34 @@ import type { ServiceEventDef } from "@simplysm/service-common";
 import { type ServiceSocket } from "./service-socket";
 import type { FastifyRequest } from "fastify";
 /**
- * WebSocket handler interface
+ * WebSocket 핸들러 인터페이스
  *
- * Manages multiple WebSocket connections, routes messages to services,
- * and handles event broadcasting.
+ * 여러 WebSocket 연결을 관리하고, 메시지를 서비스로 라우팅하며,
+ * 이벤트 브로드캐스팅을 처리한다.
  */
 export interface WebSocketHandler {
     /**
-     * Add a new WebSocket connection
+     * 새 WebSocket 연결을 추가한다
      */
     addSocket(socket: WebSocket, clientId: string, clientName: string, connReq: FastifyRequest): void;
     /**
-     * Close all active connections
+     * 모든 활성 연결을 닫는다
      */
     closeAll(): void;
     /**
-     * Broadcast reload message to all clients
+     * 모든 클라이언트에 리로드 메시지를 브로드캐스트한다
      */
     broadcastReload(clientName: string | undefined, changedFileSet: Set<string>): Promise<void>;
     /**
-     * Emit event to matching clients
+     * 매칭되는 클라이언트에 이벤트를 발생시킨다
      */
     emit<TInfo, TData>(eventDef: ServiceEventDef<TInfo, TData>, infoSelector: (item: TInfo) => boolean, data: TData): Promise<void>;
 }
 /**
- * Create a WebSocket handler instance
+ * WebSocket 핸들러 인스턴스를 생성한다
  *
- * Manages multiple WebSocket connections, routes messages to services,
- * and handles event broadcasting.
+ * 여러 WebSocket 연결을 관리하고, 메시지를 서비스로 라우팅하며,
+ * 이벤트 브로드캐스팅을 처리한다.
  */
 export declare function createWebSocketHandler(runMethod: (def: {
     serviceName: string;

package/dist/transport/socket/websocket-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-handler.d.ts","sourceRoot":"","sources":["..\\..\\..\\src\\transport\\socket\\websocket-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAElG;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5F;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,EACf,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,EACvC,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,EACtC,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,CAAC,GAAG,EAAE;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,KAAK,OAAO,CAAC,OAAO,CAAC,EACtB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,gBAAgB,CAkMlB"}
+{"version":3,"file":"websocket-handler.d.ts","sourceRoot":"","sources":["..\\..\\..\\src\\transport\\socket\\websocket-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAElG;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5F;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,EACf,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,EACvC,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,EACtC,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,CAAC,GAAG,EAAE;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,KAAK,OAAO,CAAC,OAAO,CAAC,EACtB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,gBAAgB,CAiMlB"}