@simplysm/storage 1.0.135 → 13.0.0-beta.2

package/README.md

@@ -0,0 +1,262 @@
+# @simplysm/storage
+
+A storage client package that supports FTP, FTPS, and SFTP protocols. Through the unified `Storage` interface, you can perform file upload, download, directory manipulation and other operations with the same API regardless of protocol.
+
+Using `StorageFactory`, you can automatically manage connection/disconnection, and you can also directly instantiate `FtpStorageClient` or `SftpStorageClient` if needed.
+
+## Installation
+
+```bash
+npm install @simplysm/storage
+# or
+pnpm add @simplysm/storage
+```
+
+### Dependencies
+
+| Package | Description |
+|--------|------|
+| `@simplysm/core-common` | Common utilities (`Bytes` type, etc.) |
+| `basic-ftp` | FTP/FTPS protocol implementation |
+| `ssh2-sftp-client` | SFTP protocol implementation |
+
+## Core Modules
+
+### Export List
+
+| Module | Type | Description |
+|------|------|------|
+| `StorageFactory` | Class | Creates clients based on storage type and automatically manages connection/disconnection |
+| `FtpStorageClient` | Class | FTP/FTPS protocol client (based on `basic-ftp`) |
+| `SftpStorageClient` | Class | SFTP protocol client (based on `ssh2-sftp-client`) |
+| `Storage` | Interface | Common interface implemented by all storage clients |
+| `StorageConnConfig` | Interface | Connection configuration |
+| `FileInfo` | Interface | Directory entry information |
+| `StorageType` | Type | Storage protocol types (`"ftp" \| "ftps" \| "sftp"`) |
+
+## Type Definitions
+
+### StorageConnConfig
+
+Configuration required for server connection.
+
+```typescript
+interface StorageConnConfig {
+  host: string;   // Server host
+  port?: number;  // Port (FTP default: 21, SFTP default: 22)
+  user?: string;  // Username
+  pass?: string;  // Password
+}
+```
+
+### FileInfo
+
+File/directory information returned by `readdir()`.
+
+```typescript
+interface FileInfo {
+  name: string;    // File or directory name
+  isFile: boolean; // true if file, false if directory
+}
+```
+
+### StorageType
+
+Supported storage protocol types.
+
+```typescript
+type StorageType = "ftp" | "ftps" | "sftp";
+```
+
+| Value | Protocol | Default Port | Description |
+|-----|---------|----------|------|
+| `"ftp"` | FTP | 21 | Unencrypted FTP |
+| `"ftps"` | FTPS | 21 | TLS-encrypted FTP |
+| `"sftp"` | SFTP | 22 | SSH-based file transfer |
+
+### Storage Interface
+
+Common interface implemented by all storage clients (`FtpStorageClient`, `SftpStorageClient`). `Bytes` is a `Uint8Array` type alias defined in `@simplysm/core-common`.
+
+| Method | Signature | Description |
+|--------|---------|------|
+| `connect` | `(config: StorageConnConfig) => Promise<void>` | Connect to server |
+| `close` | `() => Promise<void>` | Close connection |
+| `put` | `(localPathOrBuffer: string \| Bytes, storageFilePath: string) => Promise<void>` | Upload file (local path or byte data) |
+| `readFile` | `(filePath: string) => Promise<Bytes>` | Download file (returns `Bytes`) |
+| `readdir` | `(dirPath: string) => Promise<FileInfo[]>` | List directory contents |
+| `remove` | `(filePath: string) => Promise<void>` | Delete file |
+| `exists` | `(filePath: string) => Promise<boolean>` | Check if file/directory exists |
+| `mkdir` | `(dirPath: string) => Promise<void>` | Create directory (recursive) |
+| `rename` | `(fromPath: string, toPath: string) => Promise<void>` | Rename file/directory |
+| `uploadDir` | `(fromPath: string, toPath: string) => Promise<void>` | Upload entire local directory to remote |
+
+## Usage
+
+### StorageFactory (Recommended)
+
+`StorageFactory.connect()` automatically manages connection and disconnection with a callback pattern. The connection is always closed even if an exception occurs in the callback, so it's recommended over using clients directly.
+
+```typescript
+import { StorageFactory } from "@simplysm/storage";
+
+// FTP connection
+const result = await StorageFactory.connect("ftp", {
+  host: "ftp.example.com",
+  port: 21,
+  user: "username",
+  pass: "password",
+}, async (client) => {
+  // Upload local file to remote server
+  await client.put("/local/path/file.txt", "/remote/path/file.txt");
+
+  // Upload byte data directly
+  const data = new TextEncoder().encode("hello world");
+  await client.put(data, "/remote/path/hello.txt");
+
+  // Download remote file
+  const content = await client.readFile("/remote/path/file.txt");
+
+  // The callback's return value becomes the return value of StorageFactory.connect()
+  return content;
+});
+```
+
+```typescript
+// FTPS connection (TLS encryption)
+await StorageFactory.connect("ftps", {
+  host: "ftps.example.com",
+  user: "username",
+  pass: "password",
+}, async (client) => {
+  await client.put("/local/file.txt", "/remote/file.txt");
+});
+```
+
+```typescript
+// SFTP connection
+await StorageFactory.connect("sftp", {
+  host: "sftp.example.com",
+  port: 22,
+  user: "username",
+  pass: "password",
+}, async (client) => {
+  // List directory contents
+  const files = await client.readdir("/remote/path");
+  for (const file of files) {
+    console.log(`${file.name} - ${file.isFile ? "File" : "Directory"}`);
+  }
+
+  // Upload entire directory
+  await client.uploadDir("/local/dir", "/remote/dir");
+});
+```
+
+### FtpStorageClient (Direct Usage)
+
+Client that uses FTP or FTPS protocol. The `secure` parameter in the constructor determines whether to use FTPS.
+
+```typescript
+import { FtpStorageClient } from "@simplysm/storage";
+
+// FTP client (secure: false is default)
+const client = new FtpStorageClient();
+
+// FTPS client
+const secureClient = new FtpStorageClient(true);
+
+await client.connect({
+  host: "ftp.example.com",
+  port: 21,
+  user: "username",
+  pass: "password",
+});
+
+try {
+  // Upload file - from local file path
+  await client.put("/local/path/file.txt", "/remote/path/file.txt");
+
+  // Upload file - from Uint8Array byte data
+  const bytes = new Uint8Array([0x48, 0x65, 0x6c, 0x6c, 0x6f]);
+  await client.put(bytes, "/remote/path/hello.bin");
+
+  // Download file (returns Bytes, i.e. Uint8Array)
+  const data = await client.readFile("/remote/path/file.txt");
+  const text = new TextDecoder().decode(data);
+
+  // List directory contents
+  const files = await client.readdir("/remote/path");
+
+  // Check if file/directory exists
+  const exists = await client.exists("/remote/path/file.txt");
+
+  // Create directory (creates parent directories too)
+  await client.mkdir("/remote/new/nested/path");
+
+  // Rename file
+  await client.rename("/remote/old-name.txt", "/remote/new-name.txt");
+
+  // Delete file
+  await client.remove("/remote/path/file.txt");
+
+  // Upload entire local directory to remote
+  await client.uploadDir("/local/dir", "/remote/dir");
+} finally {
+  // Connection must be closed
+  await client.close();
+}
+```
+
+### SftpStorageClient (Direct Usage)
+
+Client that uses SFTP protocol. It implements the same `Storage` interface as `FtpStorageClient`, so the API is identical.
+
+```typescript
+import { SftpStorageClient } from "@simplysm/storage";
+
+const client = new SftpStorageClient();
+
+await client.connect({
+  host: "sftp.example.com",
+  port: 22,
+  user: "username",
+  pass: "password",
+});
+
+try {
+  // All methods of the Storage interface can be used identically
+  await client.put("/local/path/file.txt", "/remote/path/file.txt");
+  const data = await client.readFile("/remote/path/file.txt");
+  const files = await client.readdir("/remote/path");
+  const exists = await client.exists("/remote/path/file.txt");
+  await client.mkdir("/remote/new/path");
+  await client.rename("/remote/old.txt", "/remote/new.txt");
+  await client.remove("/remote/path/file.txt");
+  await client.uploadDir("/local/dir", "/remote/dir");
+} finally {
+  await client.close();
+}
+```
+
+## Important Notes
+
+### Connection Management
+
+- Using `StorageFactory.connect()` is recommended. The connection is automatically closed when the callback ends, and closure is guaranteed in the `finally` block even if an exception occurs.
+- When using clients directly, you must call `close()` with a `try/finally` pattern. Otherwise, connections may leak.
+- Calling `connect()` again on an already connected instance will cause an error. If reconnection is needed, call `close()` first.
+- Calling `close()` when already closed does not cause an error.
+
+### exists() Behavior
+
+- FTP: Checks files with the `SIZE` command (O(1)), and on failure, lists the parent directory to check if a directory exists. Performance may degrade in directories with many entries.
+- SFTP: Uses `ssh2-sftp-client`'s `exists()` method, returns `true` for files (`"-"`), directories (`"d"`), and symbolic links (`"l"`).
+- Both implementations return `false` instead of throwing exceptions when the parent directory doesn't exist or on network/permission errors.
+
+### Byte Data Type
+
+- `Bytes` used in the return type of `readFile()` and input type of `put()` is a `Uint8Array` type alias defined in `@simplysm/core-common`.
+
+## License
+
+Apache-2.0

package/dist/clients/ftp-storage-client.js

@@ -0,0 +1,126 @@
+import { bytesConcat, SdError } from "@simplysm/core-common";
+import ftp from "basic-ftp";
+import { PassThrough, Readable } from "stream";
+class FtpStorageClient {
+  constructor(_secure = false) {
+    this._secure = _secure;
+  }
+  _client;
+  /**
+   * FTP 서버에 연결합니다.
+   *
+   * @remarks
+   * - 연결 후 반드시 {@link close}로 연결을 종료해야 합니다.
+   * - 동일 인스턴스에서 여러 번 호출하지 마세요. (연결 누수 발생)
+   * - 자동 연결/종료 관리가 필요하면 {@link StorageFactory.connect}를 사용하세요. (권장)
+   */
+  async connect(config) {
+    if (this._client !== void 0) {
+      throw new SdError("\uC774\uBBF8 FTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 close()\uB97C \uD638\uCD9C\uD558\uC138\uC694.");
+    }
+    const client = new ftp.Client();
+    try {
+      await client.access({
+        host: config.host,
+        port: config.port,
+        user: config.user,
+        password: config.pass,
+        secure: this._secure
+      });
+      this._client = client;
+    } catch (err) {
+      client.close();
+      throw err;
+    }
+  }
+  _requireClient() {
+    if (this._client === void 0) {
+      throw new SdError("FTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+    }
+    return this._client;
+  }
+  /** 디렉토리를 생성합니다. 상위 디렉토리가 없으면 함께 생성합니다. */
+  async mkdir(dirPath) {
+    await this._requireClient().ensureDir(dirPath);
+  }
+  async rename(fromPath, toPath) {
+    await this._requireClient().rename(fromPath, toPath);
+  }
+  async readdir(dirPath) {
+    const fileInfos = await this._requireClient().list(dirPath);
+    return fileInfos.map((item) => ({ name: item.name, isFile: item.isFile }));
+  }
+  async readFile(filePath) {
+    const client = this._requireClient();
+    const chunks = [];
+    const writable = new PassThrough();
+    writable.on("data", (chunk) => {
+      chunks.push(chunk);
+    });
+    await client.downloadTo(writable, filePath);
+    return bytesConcat(chunks);
+  }
+  /**
+   * 파일 또는 디렉토리 존재 여부를 확인합니다.
+   *
+   * @remarks
+   * 파일 확인 시 size() 명령으로 O(1) 성능을 제공합니다.
+   * 디렉토리 확인 시 상위 디렉토리 목록을 조회하므로, 항목 수가 많으면 성능이 저하될 수 있습니다.
+   *
+   * 슬래시가 없는 경로(예: `file.txt`)는 루트 디렉토리(`/`)에서 검색합니다.
+   *
+   * 상위 디렉토리가 존재하지 않는 경우에도 false를 반환합니다.
+   * 네트워크 오류, 권한 오류 등 모든 예외도 false를 반환합니다.
+   */
+  async exists(filePath) {
+    try {
+      await this._requireClient().size(filePath);
+      return true;
+    } catch {
+      try {
+        const lastSlash = filePath.lastIndexOf("/");
+        const dirPath = lastSlash > 0 ? filePath.substring(0, lastSlash) : "/";
+        const fileName = filePath.substring(lastSlash + 1);
+        const list = await this._requireClient().list(dirPath);
+        return list.some((item) => item.name === fileName);
+      } catch {
+        return false;
+      }
+    }
+  }
+  async remove(filePath) {
+    await this._requireClient().remove(filePath);
+  }
+  /** 로컬 파일 경로 또는 바이트 데이터를 원격 경로에 업로드합니다. */
+  async put(localPathOrBuffer, storageFilePath) {
+    let param;
+    if (typeof localPathOrBuffer === "string") {
+      param = localPathOrBuffer;
+    } else {
+      param = Readable.from(localPathOrBuffer);
+    }
+    await this._requireClient().uploadFrom(param, storageFilePath);
+  }
+  async uploadDir(fromPath, toPath) {
+    await this._requireClient().uploadFromDir(fromPath, toPath);
+  }
+  /**
+   * 연결을 종료합니다.
+   *
+   * @remarks
+   * 이미 종료된 상태에서 호출해도 에러가 발생하지 않습니다.
+   * 종료 후에는 동일 인스턴스에서 {@link connect}를 다시 호출하여 재연결할 수 있습니다.
+   */
+  close() {
+    if (this._client === void 0) {
+      return Promise.resolve();
+    }
+    this._client.close();
+    this._client = void 0;
+    return Promise.resolve();
+  }
+}
+export {
+  FtpStorageClient
+};
+//# sourceMappingURL=ftp-storage-client.js.map

package/dist/clients/ftp-storage-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/clients/ftp-storage-client.ts"],
+  "sourcesContent": ["import type { Bytes } from \"@simplysm/core-common\";\nimport { bytesConcat, SdError } from \"@simplysm/core-common\";\nimport ftp from \"basic-ftp\";\nimport { PassThrough, Readable } from \"stream\";\nimport type { Storage, FileInfo } from \"../types/storage\";\nimport type { StorageConnConfig } from \"../types/storage-conn-config\";\n\n/**\n * FTP/FTPS \uD504\uB85C\uD1A0\uCF5C\uC744 \uC0AC\uC6A9\uD558\uB294 \uC2A4\uD1A0\uB9AC\uC9C0 \uD074\uB77C\uC774\uC5B8\uD2B8.\n *\n * @remarks\n * \uC0DD\uC131\uC790\uC758 `secure` \uD30C\uB77C\uBBF8\uD130\uB85C FTPS \uC0AC\uC6A9 \uC5EC\uBD80\uB97C \uC124\uC815\uD569\uB2C8\uB2E4.\n * \uC9C1\uC811 \uC0AC\uC6A9\uBCF4\uB2E4 {@link StorageFactory.connect}\uB97C \uD1B5\uD55C \uC0AC\uC6A9\uC744 \uAD8C\uC7A5\uD569\uB2C8\uB2E4.\n */\nexport class FtpStorageClient implements Storage {\n  private _client: ftp.Client | undefined;\n\n  constructor(private readonly _secure: boolean = false) {}\n\n  /**\n   * FTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uD569\uB2C8\uB2E4.\n   *\n   * @remarks\n   * - \uC5F0\uACB0 \uD6C4 \uBC18\uB4DC\uC2DC {@link close}\uB85C \uC5F0\uACB0\uC744 \uC885\uB8CC\uD574\uC57C \uD569\uB2C8\uB2E4.\n   * - \uB3D9\uC77C \uC778\uC2A4\uD134\uC2A4\uC5D0\uC11C \uC5EC\uB7EC \uBC88 \uD638\uCD9C\uD558\uC9C0 \uB9C8\uC138\uC694. (\uC5F0\uACB0 \uB204\uC218 \uBC1C\uC0DD)\n   * - \uC790\uB3D9 \uC5F0\uACB0/\uC885\uB8CC \uAD00\uB9AC\uAC00 \uD544\uC694\uD558\uBA74 {@link StorageFactory.connect}\uB97C \uC0AC\uC6A9\uD558\uC138\uC694. (\uAD8C\uC7A5)\n   */\n  async connect(config: StorageConnConfig): Promise<void> {\n    if (this._client !== undefined) {\n      throw new SdError(\"\uC774\uBBF8 FTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 close()\uB97C \uD638\uCD9C\uD558\uC138\uC694.\");\n    }\n    const client = new ftp.Client();\n    try {\n      await client.access({\n        host: config.host,\n        port: config.port,\n        user: config.user,\n        password: config.pass,\n        secure: this._secure,\n      });\n      this._client = client;\n    } catch (err) {\n      client.close();\n      throw err;\n    }\n  }\n\n  private _requireClient(): ftp.Client {\n    if (this._client === undefined) {\n      throw new SdError(\"FTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.\");\n    }\n    return this._client;\n  }\n\n  /** \uB514\uB809\uD1A0\uB9AC\uB97C \uC0DD\uC131\uD569\uB2C8\uB2E4. \uC0C1\uC704 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC73C\uBA74 \uD568\uAED8 \uC0DD\uC131\uD569\uB2C8\uB2E4. */\n  async mkdir(dirPath: string): Promise<void> {\n    await this._requireClient().ensureDir(dirPath);\n  }\n\n  async rename(fromPath: string, toPath: string): Promise<void> {\n    await this._requireClient().rename(fromPath, toPath);\n  }\n\n  async readdir(dirPath: string): Promise<FileInfo[]> {\n    const fileInfos = await this._requireClient().list(dirPath);\n    return fileInfos.map((item) => ({ name: item.name, isFile: item.isFile }));\n  }\n\n  async readFile(filePath: string): Promise<Bytes> {\n    const client = this._requireClient();\n    const chunks: Bytes[] = [];\n    const writable = new PassThrough();\n    writable.on(\"data\", (chunk: Uint8Array) => {\n      chunks.push(chunk);\n    });\n    await client.downloadTo(writable, filePath);\n    return bytesConcat(chunks);\n  }\n\n  /**\n   * \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC \uC5EC\uBD80\uB97C \uD655\uC778\uD569\uB2C8\uB2E4.\n   *\n   * @remarks\n   * \uD30C\uC77C \uD655\uC778 \uC2DC size() \uBA85\uB839\uC73C\uB85C O(1) \uC131\uB2A5\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.\n   * \uB514\uB809\uD1A0\uB9AC \uD655\uC778 \uC2DC \uC0C1\uC704 \uB514\uB809\uD1A0\uB9AC \uBAA9\uB85D\uC744 \uC870\uD68C\uD558\uBBC0\uB85C, \uD56D\uBAA9 \uC218\uAC00 \uB9CE\uC73C\uBA74 \uC131\uB2A5\uC774 \uC800\uD558\uB420 \uC218 \uC788\uC2B5\uB2C8\uB2E4.\n   *\n   * \uC2AC\uB798\uC2DC\uAC00 \uC5C6\uB294 \uACBD\uB85C(\uC608: `file.txt`)\uB294 \uB8E8\uD2B8 \uB514\uB809\uD1A0\uB9AC(`/`)\uC5D0\uC11C \uAC80\uC0C9\uD569\uB2C8\uB2E4.\n   *\n   * \uC0C1\uC704 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uB294 \uACBD\uC6B0\uC5D0\uB3C4 false\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.\n   * \uB124\uD2B8\uC6CC\uD06C \uC624\uB958, \uAD8C\uD55C \uC624\uB958 \uB4F1 \uBAA8\uB4E0 \uC608\uC678\uB3C4 false\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.\n   */\n  async exists(filePath: string): Promise<boolean> {\n    try {\n      // \uD30C\uC77C\uC778 \uACBD\uC6B0 size()\uB85C \uBE60\uB974\uAC8C \uD655\uC778 (O(1))\n      await this._requireClient().size(filePath);\n      return true;\n    } catch {\n      // size() \uC2E4\uD328 \uC2DC \uB514\uB809\uD1A0\uB9AC\uC77C \uC218 \uC788\uC73C\uBBC0\uB85C list()\uB85C \uD655\uC778\n      try {\n        const lastSlash = filePath.lastIndexOf(\"/\");\n        const dirPath = lastSlash > 0 ? filePath.substring(0, lastSlash) : \"/\";\n        const fileName = filePath.substring(lastSlash + 1);\n        const list = await this._requireClient().list(dirPath);\n        return list.some((item) => item.name === fileName);\n      } catch {\n        return false;\n      }\n    }\n  }\n\n  async remove(filePath: string): Promise<void> {\n    await this._requireClient().remove(filePath);\n  }\n\n  /** \uB85C\uCEEC \uD30C\uC77C \uACBD\uB85C \uB610\uB294 \uBC14\uC774\uD2B8 \uB370\uC774\uD130\uB97C \uC6D0\uACA9 \uACBD\uB85C\uC5D0 \uC5C5\uB85C\uB4DC\uD569\uB2C8\uB2E4. */\n  async put(localPathOrBuffer: string | Bytes, storageFilePath: string): Promise<void> {\n    let param: string | Readable;\n    if (typeof localPathOrBuffer === \"string\") {\n      param = localPathOrBuffer;\n    } else {\n      param = Readable.from(localPathOrBuffer);\n    }\n    await this._requireClient().uploadFrom(param, storageFilePath);\n  }\n\n  async uploadDir(fromPath: string, toPath: string): Promise<void> {\n    await this._requireClient().uploadFromDir(fromPath, toPath);\n  }\n\n  /**\n   * \uC5F0\uACB0\uC744 \uC885\uB8CC\uD569\uB2C8\uB2E4.\n   *\n   * @remarks\n   * \uC774\uBBF8 \uC885\uB8CC\uB41C \uC0C1\uD0DC\uC5D0\uC11C \uD638\uCD9C\uD574\uB3C4 \uC5D0\uB7EC\uAC00 \uBC1C\uC0DD\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.\n   * \uC885\uB8CC \uD6C4\uC5D0\uB294 \uB3D9\uC77C \uC778\uC2A4\uD134\uC2A4\uC5D0\uC11C {@link connect}\uB97C \uB2E4\uC2DC \uD638\uCD9C\uD558\uC5EC \uC7AC\uC5F0\uACB0\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.\n   */\n  close(): Promise<void> {\n    if (this._client === undefined) {\n      return Promise.resolve();\n    }\n\n    this._client.close();\n    this._client = undefined;\n    return Promise.resolve();\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/clients/sftp-storage-client.js

@@ -0,0 +1,108 @@
+import { SdError } from "@simplysm/core-common";
+import SftpClient from "ssh2-sftp-client";
+class SftpStorageClient {
+  _client;
+  /**
+   * SFTP 서버에 연결합니다.
+   *
+   * @remarks
+   * - 연결 후 반드시 {@link close}로 연결을 종료해야 합니다.
+   * - 동일 인스턴스에서 여러 번 호출하지 마세요. (연결 누수 발생)
+   * - 자동 연결/종료 관리가 필요하면 {@link StorageFactory.connect}를 사용하세요. (권장)
+   */
+  async connect(config) {
+    if (this._client !== void 0) {
+      throw new SdError("\uC774\uBBF8 SFTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 close()\uB97C \uD638\uCD9C\uD558\uC138\uC694.");
+    }
+    const client = new SftpClient();
+    try {
+      await client.connect({
+        host: config.host,
+        port: config.port,
+        username: config.user,
+        password: config.pass
+      });
+      this._client = client;
+    } catch (err) {
+      await client.end();
+      throw err;
+    }
+  }
+  _requireClient() {
+    if (this._client === void 0) {
+      throw new SdError("SFTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+    }
+    return this._client;
+  }
+  /** 디렉토리를 생성합니다. 상위 디렉토리가 없으면 함께 생성합니다. */
+  async mkdir(dirPath) {
+    await this._requireClient().mkdir(dirPath, true);
+  }
+  async rename(fromPath, toPath) {
+    await this._requireClient().rename(fromPath, toPath);
+  }
+  /**
+   * 파일 또는 디렉토리 존재 여부를 확인합니다.
+   *
+   * @remarks
+   * 상위 디렉토리가 존재하지 않는 경우에도 false를 반환합니다.
+   * 네트워크 오류, 권한 오류 등 모든 예외도 false를 반환합니다.
+   */
+  async exists(filePath) {
+    try {
+      const result = await this._requireClient().exists(filePath);
+      return typeof result === "string";
+    } catch {
+      return false;
+    }
+  }
+  async readdir(dirPath) {
+    const list = await this._requireClient().list(dirPath);
+    return list.map((item) => ({
+      name: item.name,
+      isFile: item.type === "-"
+    }));
+  }
+  async readFile(filePath) {
+    const result = await this._requireClient().get(filePath);
+    if (result instanceof Uint8Array) {
+      return result;
+    }
+    if (typeof result === "string") {
+      return new TextEncoder().encode(result);
+    }
+    throw new SdError("\uC608\uC0C1\uCE58 \uBABB\uD55C \uC751\uB2F5 \uD0C0\uC785\uC785\uB2C8\uB2E4.");
+  }
+  async remove(filePath) {
+    await this._requireClient().delete(filePath);
+  }
+  /** 로컬 파일 경로 또는 바이트 데이터를 원격 경로에 업로드합니다. */
+  async put(localPathOrBuffer, storageFilePath) {
+    if (typeof localPathOrBuffer === "string") {
+      await this._requireClient().fastPut(localPathOrBuffer, storageFilePath);
+    } else {
+      await this._requireClient().put(Buffer.from(localPathOrBuffer), storageFilePath);
+    }
+  }
+  async uploadDir(fromPath, toPath) {
+    await this._requireClient().uploadDir(fromPath, toPath);
+  }
+  /**
+   * 연결을 종료합니다.
+   *
+   * @remarks
+   * 이미 종료된 상태에서 호출해도 에러가 발생하지 않습니다.
+   * 종료 후에는 동일 인스턴스에서 {@link connect}를 다시 호출하여 재연결할 수 있습니다.
+   */
+  async close() {
+    if (this._client === void 0) {
+      return;
+    }
+    await this._client.end();
+    this._client = void 0;
+  }
+}
+export {
+  SftpStorageClient
+};
+//# sourceMappingURL=sftp-storage-client.js.map

package/dist/clients/sftp-storage-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/clients/sftp-storage-client.ts"],
+  "sourcesContent": ["import type { Bytes } from \"@simplysm/core-common\";\nimport { SdError } from \"@simplysm/core-common\";\nimport SftpClient from \"ssh2-sftp-client\";\nimport type { Storage, FileInfo } from \"../types/storage\";\nimport type { StorageConnConfig } from \"../types/storage-conn-config\";\n\n// ssh2-sftp-client \uB77C\uC774\uBE0C\uB7EC\uB9AC \uD0C0\uC785 \uC815\uC758\uC5D0\uC11C Buffer \uC0AC\uC6A9\ntype SftpGetResult = string | NodeJS.WritableStream | Bytes;\n\n/**\n * SFTP \uD504\uB85C\uD1A0\uCF5C\uC744 \uC0AC\uC6A9\uD558\uB294 \uC2A4\uD1A0\uB9AC\uC9C0 \uD074\uB77C\uC774\uC5B8\uD2B8.\n *\n * @remarks\n * \uC9C1\uC811 \uC0AC\uC6A9\uBCF4\uB2E4 {@link StorageFactory.connect}\uB97C \uD1B5\uD55C \uC0AC\uC6A9\uC744 \uAD8C\uC7A5\uD569\uB2C8\uB2E4.\n */\nexport class SftpStorageClient implements Storage {\n  private _client: SftpClient | undefined;\n\n  /**\n   * SFTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uD569\uB2C8\uB2E4.\n   *\n   * @remarks\n   * - \uC5F0\uACB0 \uD6C4 \uBC18\uB4DC\uC2DC {@link close}\uB85C \uC5F0\uACB0\uC744 \uC885\uB8CC\uD574\uC57C \uD569\uB2C8\uB2E4.\n   * - \uB3D9\uC77C \uC778\uC2A4\uD134\uC2A4\uC5D0\uC11C \uC5EC\uB7EC \uBC88 \uD638\uCD9C\uD558\uC9C0 \uB9C8\uC138\uC694. (\uC5F0\uACB0 \uB204\uC218 \uBC1C\uC0DD)\n   * - \uC790\uB3D9 \uC5F0\uACB0/\uC885\uB8CC \uAD00\uB9AC\uAC00 \uD544\uC694\uD558\uBA74 {@link StorageFactory.connect}\uB97C \uC0AC\uC6A9\uD558\uC138\uC694. (\uAD8C\uC7A5)\n   */\n  async connect(config: StorageConnConfig): Promise<void> {\n    if (this._client !== undefined) {\n      throw new SdError(\"\uC774\uBBF8 SFTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 close()\uB97C \uD638\uCD9C\uD558\uC138\uC694.\");\n    }\n\n    const client = new SftpClient();\n    try {\n      await client.connect({\n        host: config.host,\n        port: config.port,\n        username: config.user,\n        password: config.pass,\n      });\n      this._client = client;\n    } catch (err) {\n      await client.end();\n      throw err;\n    }\n  }\n\n  private _requireClient(): SftpClient {\n    if (this._client === undefined) {\n      throw new SdError(\"SFTP \uC11C\uBC84\uC5D0 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.\");\n    }\n    return this._client;\n  }\n\n  /** \uB514\uB809\uD1A0\uB9AC\uB97C \uC0DD\uC131\uD569\uB2C8\uB2E4. \uC0C1\uC704 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC73C\uBA74 \uD568\uAED8 \uC0DD\uC131\uD569\uB2C8\uB2E4. */\n  async mkdir(dirPath: string): Promise<void> {\n    await this._requireClient().mkdir(dirPath, true);\n  }\n\n  async rename(fromPath: string, toPath: string): Promise<void> {\n    await this._requireClient().rename(fromPath, toPath);\n  }\n\n  /**\n   * \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC \uC5EC\uBD80\uB97C \uD655\uC778\uD569\uB2C8\uB2E4.\n   *\n   * @remarks\n   * \uC0C1\uC704 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uB294 \uACBD\uC6B0\uC5D0\uB3C4 false\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.\n   * \uB124\uD2B8\uC6CC\uD06C \uC624\uB958, \uAD8C\uD55C \uC624\uB958 \uB4F1 \uBAA8\uB4E0 \uC608\uC678\uB3C4 false\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.\n   */\n  async exists(filePath: string): Promise<boolean> {\n    try {\n      // ssh2-sftp-client\uC758 exists()\uB294 false | 'd' | '-' | 'l' \uB97C \uBC18\uD658\uD55C\uB2E4.\n      // false: \uC874\uC7AC\uD558\uC9C0 \uC54A\uC74C, 'd': \uB514\uB809\uD1A0\uB9AC, '-': \uD30C\uC77C, 'l': \uC2EC\uBCFC\uB9AD \uB9C1\uD06C\n      const result = await this._requireClient().exists(filePath);\n      return typeof result === \"string\";\n    } catch {\n      return false;\n    }\n  }\n\n  async readdir(dirPath: string): Promise<FileInfo[]> {\n    const list = await this._requireClient().list(dirPath);\n    return list.map((item) => ({\n      name: item.name,\n      isFile: item.type === \"-\",\n    }));\n  }\n\n  async readFile(filePath: string): Promise<Bytes> {\n    // ssh2-sftp-client\uC758 get()\uC740 dst \uBBF8\uC804\uB2EC \uC2DC Buffer\uB97C \uBC18\uD658\uD55C\uB2E4.\n    // \uD0C0\uC785 \uC815\uC758(string | WritableStream | Buffer)\uC640 \uB2EC\uB9AC \uC2E4\uC81C\uB85C\uB294 Buffer\uB9CC \uBC18\uD658\uB41C\uB2E4.\n    const result = (await this._requireClient().get(filePath)) as SftpGetResult;\n    if (result instanceof Uint8Array) {\n      return result;\n    }\n    // \uD0C0\uC785 \uC815\uC758\uC0C1 string\uB3C4 \uAC00\uB2A5\uD558\uBBC0\uB85C \uBC29\uC5B4 \uCF54\uB4DC\n    if (typeof result === \"string\") {\n      return new TextEncoder().encode(result);\n    }\n    throw new SdError(\"\uC608\uC0C1\uCE58 \uBABB\uD55C \uC751\uB2F5 \uD0C0\uC785\uC785\uB2C8\uB2E4.\");\n  }\n\n  async remove(filePath: string): Promise<void> {\n    await this._requireClient().delete(filePath);\n  }\n\n  /** \uB85C\uCEEC \uD30C\uC77C \uACBD\uB85C \uB610\uB294 \uBC14\uC774\uD2B8 \uB370\uC774\uD130\uB97C \uC6D0\uACA9 \uACBD\uB85C\uC5D0 \uC5C5\uB85C\uB4DC\uD569\uB2C8\uB2E4. */\n  async put(localPathOrBuffer: string | Bytes, storageFilePath: string): Promise<void> {\n    if (typeof localPathOrBuffer === \"string\") {\n      await this._requireClient().fastPut(localPathOrBuffer, storageFilePath);\n    } else {\n      // eslint-disable-next-line no-restricted-globals -- ssh2-sftp-client \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC694\uAD6C\uC0AC\uD56D\n      await this._requireClient().put(Buffer.from(localPathOrBuffer), storageFilePath);\n    }\n  }\n\n  async uploadDir(fromPath: string, toPath: string): Promise<void> {\n    await this._requireClient().uploadDir(fromPath, toPath);\n  }\n\n  /**\n   * \uC5F0\uACB0\uC744 \uC885\uB8CC\uD569\uB2C8\uB2E4.\n   *\n   * @remarks\n   * \uC774\uBBF8 \uC885\uB8CC\uB41C \uC0C1\uD0DC\uC5D0\uC11C \uD638\uCD9C\uD574\uB3C4 \uC5D0\uB7EC\uAC00 \uBC1C\uC0DD\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.\n   * \uC885\uB8CC \uD6C4\uC5D0\uB294 \uB3D9\uC77C \uC778\uC2A4\uD134\uC2A4\uC5D0\uC11C {@link connect}\uB97C \uB2E4\uC2DC \uD638\uCD9C\uD558\uC5EC \uC7AC\uC5F0\uACB0\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.\n   */\n  async close(): Promise<void> {\n    if (this._client === undefined) {\n      return;\n    }\n    await this._client.end();\n    this._client = undefined;\n  }\n}\n"],
+  "mappings": "AACA,SAAS,eAAe;AACxB,OAAO,gBAAgB;AAahB,MAAM,kBAAqC;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUR,MAAM,QAAQ,QAA0C;AACtD,QAAI,KAAK,YAAY,QAAW;AAC9B,YAAM,IAAI,QAAQ,oJAA2C;AAAA,IAC/D;AAEA,UAAM,SAAS,IAAI,WAAW;AAC9B,QAAI;AACF,YAAM,OAAO,QAAQ;AAAA,QACnB,MAAM,OAAO;AAAA,QACb,MAAM,OAAO;AAAA,QACb,UAAU,OAAO;AAAA,QACjB,UAAU,OAAO;AAAA,MACnB,CAAC;AACD,WAAK,UAAU;AAAA,IACjB,SAAS,KAAK;AACZ,YAAM,OAAO,IAAI;AACjB,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,iBAA6B;AACnC,QAAI,KAAK,YAAY,QAAW;AAC9B,YAAM,IAAI,QAAQ,wFAAuB;AAAA,IAC3C;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,MAAM,MAAM,SAAgC;AAC1C,UAAM,KAAK,eAAe,EAAE,MAAM,SAAS,IAAI;AAAA,EACjD;AAAA,EAEA,MAAM,OAAO,UAAkB,QAA+B;AAC5D,UAAM,KAAK,eAAe,EAAE,OAAO,UAAU,MAAM;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OAAO,UAAoC;AAC/C,QAAI;AAGF,YAAM,SAAS,MAAM,KAAK,eAAe,EAAE,OAAO,QAAQ;AAC1D,aAAO,OAAO,WAAW;AAAA,IAC3B,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,SAAsC;AAClD,UAAM,OAAO,MAAM,KAAK,eAAe,EAAE,KAAK,OAAO;AACrD,WAAO,KAAK,IAAI,CAAC,UAAU;AAAA,MACzB,MAAM,KAAK;AAAA,MACX,QAAQ,KAAK,SAAS;AAAA,IACxB,EAAE;AAAA,EACJ;AAAA,EAEA,MAAM,SAAS,UAAkC;AAG/C,UAAM,SAAU,MAAM,KAAK,eAAe,EAAE,IAAI,QAAQ;AACxD,QAAI,kBAAkB,YAAY;AAChC,aAAO;AAAA,IACT;AAEA,QAAI,OAAO,WAAW,UAAU;AAC9B,aAAO,IAAI,YAAY,EAAE,OAAO,MAAM;AAAA,IACxC;AACA,UAAM,IAAI,QAAQ,8EAAkB;AAAA,EACtC;AAAA,EAEA,MAAM,OAAO,UAAiC;AAC5C,UAAM,KAAK,eAAe,EAAE,OAAO,QAAQ;AAAA,EAC7C;AAAA;AAAA,EAGA,MAAM,IAAI,mBAAmC,iBAAwC;AACnF,QAAI,OAAO,sBAAsB,UAAU;AACzC,YAAM,KAAK,eAAe,EAAE,QAAQ,mBAAmB,eAAe;AAAA,IACxE,OAAO;AAEL,YAAM,KAAK,eAAe,EAAE,IAAI,OAAO,KAAK,iBAAiB,GAAG,eAAe;AAAA,IACjF;AAAA,EACF;AAAA,EAEA,MAAM,UAAU,UAAkB,QAA+B;AAC/D,UAAM,KAAK,eAAe,EAAE,UAAU,UAAU,MAAM;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAuB;AAC3B,QAAI,KAAK,YAAY,QAAW;AAC9B;AAAA,IACF;AACA,UAAM,KAAK,QAAQ,IAAI;AACvB,SAAK,UAAU;AAAA,EACjB;AACF;",
+  "names": []
+}

package/dist/core-common/src/common.types.d.ts

@@ -0,0 +1,74 @@
+import { DateTime } from "./types/date-time";
+import { DateOnly } from "./types/date-only";
+import { Time } from "./types/time";
+import { Uuid } from "./types/uuid";
+/**
+ * Buffer 대신 사용하는 바이너리 타입
+ */
+export type Bytes = Uint8Array;
+/**
+ * Primitive 타입 매핑
+ * orm-common과 공유
+ */
+export type PrimitiveTypeMap = {
+    string: string;
+    number: number;
+    boolean: boolean;
+    DateTime: DateTime;
+    DateOnly: DateOnly;
+    Time: Time;
+    Uuid: Uuid;
+    Bytes: Bytes;
+};
+/**
+ * Primitive 타입 문자열 키
+ */
+export type PrimitiveTypeStr = keyof PrimitiveTypeMap;
+/**
+ * Primitive 타입 유니온
+ */
+export type PrimitiveType = PrimitiveTypeMap[PrimitiveTypeStr] | undefined;
+/**
+ * 깊은 Partial 타입
+ *
+ * 객체의 모든 속성을 재귀적으로 선택적(optional)으로 만듭니다.
+ * Primitive 타입(string, number, boolean 등)은 그대로 유지하고,
+ * 객체/배열 타입만 재귀적으로 Partial을 적용합니다.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   name: string;
+ *   profile: {
+ *     age: number;
+ *     address: { city: string };
+ *   };
+ * }
+ *
+ * // 모든 깊이의 속성이 선택적이 됨
+ * const partial: DeepPartial<User> = {
+ *   profile: { address: {} }
+ * };
+ * ```
+ */
+export type DeepPartial<T> = Partial<{
+    [K in keyof T]: T[K] extends PrimitiveType ? T[K] : DeepPartial<T[K]>;
+}>;
+/**
+ * 생성자 타입
+ *
+ * 클래스 생성자를 타입으로 표현할 때 사용합니다.
+ * 주로 의존성 주입, 팩토리 패턴, instanceof 체크 등에서 활용됩니다.
+ *
+ * @example
+ * function create<T>(ctor: Type<T>): T {
+ *   return new ctor();
+ * }
+ *
+ * class MyClass { name = "test"; }
+ * const instance = create(MyClass); // MyClass 인스턴스
+ */
+export interface Type<T> extends Function {
+    new (...args: unknown[]): T;
+}
+//# sourceMappingURL=common.types.d.ts.map

package/dist/core-common/src/common.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../../../core-common/src/common.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAIpC;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC;AAM/B;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;AAM3E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,OAAO,CAAC;KAClC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtE,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,CAAE,SAAQ,QAAQ;IACvC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;CAC7B"}

package/dist/core-common/src/env.d.ts

@@ -0,0 +1,6 @@
+export declare const env: {
+    DEV: boolean;
+    VER?: string;
+    [key: string]: unknown;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/core-common/src/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../core-common/src/env.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,EAAE;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAKxB,CAAC"}

package/dist/core-common/src/errors/argument-error.d.ts

@@ -0,0 +1,25 @@
+import { SdError } from "./sd-error";
+/**
+ * 인수 오류
+ *
+ * 잘못된 인수를 받았을 때 발생시키는 에러이다.
+ * 인수 객체를 YAML 형식으로 메시지에 포함하여 디버깅을 용이하게 한다.
+ *
+ * @example
+ * // 인수 객체만 전달
+ * throw new ArgumentError({ userId: 123, name: null });
+ * // 결과 메시지: "인수가 잘못되었습니다.\n\nuserId: 123\nname: null"
+ *
+ * @example
+ * // 커스텀 메시지와 인수 객체 전달
+ * throw new ArgumentError("유효하지 않은 사용자", { userId: 123 });
+ * // 결과 메시지: "유효하지 않은 사용자\n\nuserId: 123"
+ */
+export declare class ArgumentError extends SdError {
+    /** 기본 메시지("인수가 잘못되었습니다.")와 함께 인수 객체를 YAML 형식으로 출력 */
+    constructor(argObj: Record<string, unknown>);
+    /** 커스텀 메시지와 함께 인수 객체를 YAML 형식으로 출력 */
+    constructor(message: string, argObj: Record<string, unknown>);
+    constructor(arg1: Record<string, unknown> | string, arg2?: Record<string, unknown>);
+}
+//# sourceMappingURL=argument-error.d.ts.map

package/dist/core-common/src/errors/argument-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/argument-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,qDAAqD;gBACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3C,sCAAsC;gBAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYnF"}