@simplysm/storage 13.0.0-beta.7 → 13.0.2

package/dist/clients/ftp-storage-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ftp-storage-client.d.ts","sourceRoot":"","sources":["../../src/clients/ftp-storage-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAInD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,OAAO;IAGlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,OAAO,CAAyB;gBAEX,OAAO,GAAE,OAAe;IAErD;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvD,OAAO,CAAC,cAAc;IAOtB,0CAA0C;IACpC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAWhD;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,0CAA0C;IACpC,GAAG,CAAC,iBAAiB,EAAE,MAAM,GAAG,KAAK,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE;;;;;;OAMG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CASvB"}

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

@@ -1,7 +1,6 @@
 {
   "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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sftp-storage-client.d.ts","sourceRoot":"","sources":["../../src/clients/sftp-storage-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAKtE;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,OAAO,CAAC,OAAO,CAAyB;IAExC;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CvD,OAAO,CAAC,cAAc;IAOtB,0CAA0C;IACpC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;OAMG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW1C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAQ7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAc1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,0CAA0C;IACpC,GAAG,CAAC,iBAAiB,EAAE,MAAM,GAAG,KAAK,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

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

@@ -16,12 +16,33 @@ class SftpStorageClient {
     }
     const client = new SftpClient();
     try {
-      await client.connect({
-        host: config.host,
-        port: config.port,
-        username: config.user,
-        password: config.pass
-      });
+      if (config.pass != null) {
+        await client.connect({
+          host: config.host,
+          port: config.port,
+          username: config.user,
+          password: config.pass
+        });
+      } else {
+        const fsP = await import("fs/promises");
+        const os = await import("os");
+        const pathMod = await import("path");
+        const keyPath = pathMod.join(os.homedir(), ".ssh", "id_ed25519");
+        const baseOptions = {
+          host: config.host,
+          port: config.port,
+          username: config.user,
+          ...process.env["SSH_AUTH_SOCK"] != null ? { agent: process.env["SSH_AUTH_SOCK"] } : {}
+        };
+        try {
+          await client.connect({
+            ...baseOptions,
+            privateKey: await fsP.readFile(keyPath)
+          });
+        } catch {
+          await client.connect(baseOptions);
+        }
+      }
       this._client = client;
     } catch (err) {
       await client.end();

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

@@ -1,7 +1,6 @@
 {
   "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;",
+  "mappings": "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",
   "names": []
 }

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AAIrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAI9C,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
-export * from "./types/storage-conn-config";
-export * from "./types/storage";
-export * from "./types/storage-type";
-export * from "./clients/ftp-storage-client";
-export * from "./clients/sftp-storage-client";
-export * from "./storage-factory";
+export * from "./types/storage-conn-config.js";
+export * from "./types/storage.js";
+export * from "./types/storage-type.js";
+export * from "./clients/ftp-storage-client.js";
+export * from "./clients/sftp-storage-client.js";
+export * from "./storage-factory.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["//#region Types\nexport * from \"./types/storage-conn-config\";\nexport * from \"./types/storage\";\nexport * from \"./types/storage-type\";\n//#endregion\n\n//#region Clients\nexport * from \"./clients/ftp-storage-client\";\nexport * from \"./clients/sftp-storage-client\";\n//#endregion\n\n//#region Factory\nexport * from \"./storage-factory\";\n//#endregion\n"],
   "mappings": "AACA,cAAc;AACd,cAAc;AACd,cAAc;AAId,cAAc;AACd,cAAc;AAId,cAAc;",
   "names": []
 }

package/dist/storage-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-factory.d.ts","sourceRoot":"","sources":["../src/storage-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD;;;;GAIG;AACH,qBAAa,cAAc;IACzB;;;;;;OAMG;WACU,OAAO,CAAC,CAAC,EACpB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,iBAAiB,EACzB,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC;IAab,OAAO,CAAC,MAAM,CAAC,aAAa;CAU7B"}

package/dist/storage-factory.js

@@ -1,5 +1,5 @@
-import { FtpStorageClient } from "./clients/ftp-storage-client";
-import { SftpStorageClient } from "./clients/sftp-storage-client";
+import { FtpStorageClient } from "./clients/ftp-storage-client.js";
+import { SftpStorageClient } from "./clients/sftp-storage-client.js";
 class StorageFactory {
   /**
    * 스토리지에 연결하고 콜백을 실행한 후 자동으로 연결을 종료한다.

package/dist/storage-factory.js.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/storage-factory.ts"],
-  "sourcesContent": ["import type { StorageConnConfig } from \"./types/storage-conn-config\";\nimport type { Storage } from \"./types/storage\";\nimport type { StorageType } from \"./types/storage-type\";\nimport { FtpStorageClient } from \"./clients/ftp-storage-client\";\nimport { SftpStorageClient } from \"./clients/sftp-storage-client\";\n\n/**\n * \uC2A4\uD1A0\uB9AC\uC9C0 \uD074\uB77C\uC774\uC5B8\uD2B8 \uD329\uD1A0\uB9AC\n *\n * FTP, FTPS, SFTP \uC2A4\uD1A0\uB9AC\uC9C0 \uC5F0\uACB0\uC744 \uC0DD\uC131\uD558\uACE0 \uAD00\uB9AC\uD55C\uB2E4.\n */\nexport class StorageFactory {\n  /**\n   * \uC2A4\uD1A0\uB9AC\uC9C0\uC5D0 \uC5F0\uACB0\uD558\uACE0 \uCF5C\uBC31\uC744 \uC2E4\uD589\uD55C \uD6C4 \uC790\uB3D9\uC73C\uB85C \uC5F0\uACB0\uC744 \uC885\uB8CC\uD55C\uB2E4.\n   *\n   * @remarks\n   * \uCF5C\uBC31 \uD328\uD134\uC73C\uB85C \uC5F0\uACB0/\uC885\uB8CC\uAC00 \uC790\uB3D9 \uAD00\uB9AC\uB418\uBBC0\uB85C, \uC9C1\uC811 \uD074\uB77C\uC774\uC5B8\uD2B8\uB97C \uC0AC\uC6A9\uD558\uB294 \uAC83\uBCF4\uB2E4 \uAD8C\uC7A5\uB41C\uB2E4.\n   * \uCF5C\uBC31\uC5D0\uC11C \uC608\uC678\uAC00 \uBC1C\uC0DD\uD574\uB3C4 \uC5F0\uACB0\uC740 \uC790\uB3D9\uC73C\uB85C \uC885\uB8CC\uB41C\uB2E4.\n   */\n  static async connect<R>(\n    type: StorageType,\n    config: StorageConnConfig,\n    fn: (storage: Storage) => R | Promise<R>,\n  ): Promise<R> {\n    const client = StorageFactory._createClient(type);\n\n    await client.connect(config);\n    try {\n      return await fn(client);\n    } finally {\n      await client.close().catch(() => {\n        // \uC774\uBBF8 \uB2EB\uD78C \uACBD\uC6B0 \uBB34\uC2DC\n      });\n    }\n  }\n\n  private static _createClient(type: StorageType): Storage {\n    switch (type) {\n      case \"sftp\":\n        return new SftpStorageClient();\n      case \"ftps\":\n        return new FtpStorageClient(true);\n      case \"ftp\":\n        return new FtpStorageClient(false);\n    }\n  }\n}\n"],
   "mappings": "AAGA,SAAS,wBAAwB;AACjC,SAAS,yBAAyB;AAO3B,MAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ1B,aAAa,QACX,MACA,QACA,IACY;AACZ,UAAM,SAAS,eAAe,cAAc,IAAI;AAEhD,UAAM,OAAO,QAAQ,MAAM;AAC3B,QAAI;AACF,aAAO,MAAM,GAAG,MAAM;AAAA,IACxB,UAAE;AACA,YAAM,OAAO,MAAM,EAAE,MAAM,MAAM;AAAA,MAEjC,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,OAAe,cAAc,MAA4B;AACvD,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,eAAO,IAAI,kBAAkB;AAAA,MAC/B,KAAK;AACH,eAAO,IAAI,iBAAiB,IAAI;AAAA,MAClC,KAAK;AACH,eAAO,IAAI,iBAAiB,KAAK;AAAA,IACrC;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/types/storage-conn-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-conn-config.d.ts","sourceRoot":"","sources":["../../src/types/storage-conn-config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types/storage-conn-config.js.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": [],
-  "sourcesContent": [],
   "mappings": "",
   "names": []
 }

package/dist/types/storage-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-type.d.ts","sourceRoot":"","sources":["../../src/types/storage-type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/dist/types/storage-type.js.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": [],
-  "sourcesContent": [],
   "mappings": "",
   "names": []
 }

package/dist/types/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/types/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,GAAG,CAAC,iBAAiB,EAAE,MAAM,GAAG,KAAK,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/types/storage.js.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
   "sources": [],
-  "sourcesContent": [],
   "mappings": "",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simplysm/storage",
   "sideEffects": false,
-  "version": "13.0.0-beta.7",
+  "version": "13.0.2",
   "description": "심플리즘 패키지 - 스토리지 모듈 (node)",
   "author": "김석래",
   "repository": {
@@ -14,14 +14,15 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "dependencies": {
-    "@simplysm/core-common": "workspace:*",
     "basic-ftp": "^5.1.0",
-    "ssh2-sftp-client": "^12.0.1"
+    "ssh2-sftp-client": "^12.0.1",
+    "@simplysm/core-common": "13.0.2"
   },
   "devDependencies": {
     "@types/ssh2-sftp-client": "^9.0.6"
   }
-}
+}

package/src/clients/ftp-storage-client.ts

@@ -0,0 +1,146 @@
+import type { Bytes } from "@simplysm/core-common";
+import { bytesConcat, SdError } from "@simplysm/core-common";
+import ftp from "basic-ftp";
+import { PassThrough, Readable } from "stream";
+import type { Storage, FileInfo } from "../types/storage";
+import type { StorageConnConfig } from "../types/storage-conn-config";
+
+/**
+ * FTP/FTPS 프로토콜을 사용하는 스토리지 클라이언트.
+ *
+ * @remarks
+ * 생성자의 `secure` 파라미터로 FTPS 사용 여부를 설정합니다.
+ * 직접 사용보다 {@link StorageFactory.connect}를 통한 사용을 권장합니다.
+ */
+export class FtpStorageClient implements Storage {
+  private _client: ftp.Client | undefined;
+
+  constructor(private readonly _secure: boolean = false) {}
+
+  /**
+   * FTP 서버에 연결합니다.
+   *
+   * @remarks
+   * - 연결 후 반드시 {@link close}로 연결을 종료해야 합니다.
+   * - 동일 인스턴스에서 여러 번 호출하지 마세요. (연결 누수 발생)
+   * - 자동 연결/종료 관리가 필요하면 {@link StorageFactory.connect}를 사용하세요. (권장)
+   */
+  async connect(config: StorageConnConfig): Promise<void> {
+    if (this._client !== undefined) {
+      throw new SdError("이미 FTP 서버에 연결되어 있습니다. 먼저 close()를 호출하세요.");
+    }
+    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;
+    }
+  }
+
+  private _requireClient(): ftp.Client {
+    if (this._client === undefined) {
+      throw new SdError("FTP 서버에 연결되어있지 않습니다.");
+    }
+    return this._client;
+  }
+
+  /** 디렉토리를 생성합니다. 상위 디렉토리가 없으면 함께 생성합니다. */
+  async mkdir(dirPath: string): Promise<void> {
+    await this._requireClient().ensureDir(dirPath);
+  }
+
+  async rename(fromPath: string, toPath: string): Promise<void> {
+    await this._requireClient().rename(fromPath, toPath);
+  }
+
+  async readdir(dirPath: string): Promise<FileInfo[]> {
+    const fileInfos = await this._requireClient().list(dirPath);
+    return fileInfos.map((item) => ({ name: item.name, isFile: item.isFile }));
+  }
+
+  async readFile(filePath: string): Promise<Bytes> {
+    const client = this._requireClient();
+    const chunks: Bytes[] = [];
+    const writable = new PassThrough();
+    writable.on("data", (chunk: Uint8Array) => {
+      chunks.push(chunk);
+    });
+    await client.downloadTo(writable, filePath);
+    return bytesConcat(chunks);
+  }
+
+  /**
+   * 파일 또는 디렉토리 존재 여부를 확인합니다.
+   *
+   * @remarks
+   * 파일 확인 시 size() 명령으로 O(1) 성능을 제공합니다.
+   * 디렉토리 확인 시 상위 디렉토리 목록을 조회하므로, 항목 수가 많으면 성능이 저하될 수 있습니다.
+   *
+   * 슬래시가 없는 경로(예: `file.txt`)는 루트 디렉토리(`/`)에서 검색합니다.
+   *
+   * 상위 디렉토리가 존재하지 않는 경우에도 false를 반환합니다.
+   * 네트워크 오류, 권한 오류 등 모든 예외도 false를 반환합니다.
+   */
+  async exists(filePath: string): Promise<boolean> {
+    try {
+      // 파일인 경우 size()로 빠르게 확인 (O(1))
+      await this._requireClient().size(filePath);
+      return true;
+    } catch {
+      // size() 실패 시 디렉토리일 수 있으므로 list()로 확인
+      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: string): Promise<void> {
+    await this._requireClient().remove(filePath);
+  }
+
+  /** 로컬 파일 경로 또는 바이트 데이터를 원격 경로에 업로드합니다. */
+  async put(localPathOrBuffer: string | Bytes, storageFilePath: string): Promise<void> {
+    let param: string | Readable;
+    if (typeof localPathOrBuffer === "string") {
+      param = localPathOrBuffer;
+    } else {
+      param = Readable.from(localPathOrBuffer);
+    }
+    await this._requireClient().uploadFrom(param, storageFilePath);
+  }
+
+  async uploadDir(fromPath: string, toPath: string): Promise<void> {
+    await this._requireClient().uploadFromDir(fromPath, toPath);
+  }
+
+  /**
+   * 연결을 종료합니다.
+   *
+   * @remarks
+   * 이미 종료된 상태에서 호출해도 에러가 발생하지 않습니다.
+   * 종료 후에는 동일 인스턴스에서 {@link connect}를 다시 호출하여 재연결할 수 있습니다.
+   */
+  close(): Promise<void> {
+    if (this._client === undefined) {
+      return Promise.resolve();
+    }
+
+    this._client.close();
+    this._client = undefined;
+    return Promise.resolve();
+  }
+}

package/src/clients/sftp-storage-client.ts

@@ -0,0 +1,160 @@
+import type { Bytes } from "@simplysm/core-common";
+import { SdError } from "@simplysm/core-common";
+import SftpClient from "ssh2-sftp-client";
+import type { Storage, FileInfo } from "../types/storage";
+import type { StorageConnConfig } from "../types/storage-conn-config";
+
+// ssh2-sftp-client 라이브러리 타입 정의에서 Buffer 사용
+type SftpGetResult = string | NodeJS.WritableStream | Bytes;
+
+/**
+ * SFTP 프로토콜을 사용하는 스토리지 클라이언트.
+ *
+ * @remarks
+ * 직접 사용보다 {@link StorageFactory.connect}를 통한 사용을 권장합니다.
+ */
+export class SftpStorageClient implements Storage {
+  private _client: SftpClient | undefined;
+
+  /**
+   * SFTP 서버에 연결합니다.
+   *
+   * @remarks
+   * - 연결 후 반드시 {@link close}로 연결을 종료해야 합니다.
+   * - 동일 인스턴스에서 여러 번 호출하지 마세요. (연결 누수 발생)
+   * - 자동 연결/종료 관리가 필요하면 {@link StorageFactory.connect}를 사용하세요. (권장)
+   */
+  async connect(config: StorageConnConfig): Promise<void> {
+    if (this._client !== undefined) {
+      throw new SdError("이미 SFTP 서버에 연결되어 있습니다. 먼저 close()를 호출하세요.");
+    }
+
+    const client = new SftpClient();
+    try {
+      if (config.pass != null) {
+        await client.connect({
+          host: config.host,
+          port: config.port,
+          username: config.user,
+          password: config.pass,
+        });
+      } else {
+        // SSH agent + 키 파일로 인증 시도
+        const fsP = await import("fs/promises");
+        const os = await import("os");
+        const pathMod = await import("path");
+        const keyPath = pathMod.join(os.homedir(), ".ssh", "id_ed25519");
+
+        const baseOptions = {
+          host: config.host,
+          port: config.port,
+          username: config.user,
+          ...(process.env["SSH_AUTH_SOCK"] != null ? { agent: process.env["SSH_AUTH_SOCK"] } : {}),
+        };
+
+        try {
+          await client.connect({
+            ...baseOptions,
+            privateKey: await fsP.readFile(keyPath),
+          });
+        } catch {
+          // privateKey 파싱 실패 (암호화된 키 등) → agent만으로 재시도
+          await client.connect(baseOptions);
+        }
+      }
+      this._client = client;
+    } catch (err) {
+      await client.end();
+      throw err;
+    }
+  }
+
+  private _requireClient(): SftpClient {
+    if (this._client === undefined) {
+      throw new SdError("SFTP 서버에 연결되어있지 않습니다.");
+    }
+    return this._client;
+  }
+
+  /** 디렉토리를 생성합니다. 상위 디렉토리가 없으면 함께 생성합니다. */
+  async mkdir(dirPath: string): Promise<void> {
+    await this._requireClient().mkdir(dirPath, true);
+  }
+
+  async rename(fromPath: string, toPath: string): Promise<void> {
+    await this._requireClient().rename(fromPath, toPath);
+  }
+
+  /**
+   * 파일 또는 디렉토리 존재 여부를 확인합니다.
+   *
+   * @remarks
+   * 상위 디렉토리가 존재하지 않는 경우에도 false를 반환합니다.
+   * 네트워크 오류, 권한 오류 등 모든 예외도 false를 반환합니다.
+   */
+  async exists(filePath: string): Promise<boolean> {
+    try {
+      // ssh2-sftp-client의 exists()는 false | 'd' | '-' | 'l' 를 반환한다.
+      // false: 존재하지 않음, 'd': 디렉토리, '-': 파일, 'l': 심볼릭 링크
+      const result = await this._requireClient().exists(filePath);
+      return typeof result === "string";
+    } catch {
+      return false;
+    }
+  }
+
+  async readdir(dirPath: string): Promise<FileInfo[]> {
+    const list = await this._requireClient().list(dirPath);
+    return list.map((item) => ({
+      name: item.name,
+      isFile: item.type === "-",
+    }));
+  }
+
+  async readFile(filePath: string): Promise<Bytes> {
+    // ssh2-sftp-client의 get()은 dst 미전달 시 Buffer를 반환한다.
+    // 타입 정의(string | WritableStream | Buffer)와 달리 실제로는 Buffer만 반환된다.
+    const result = (await this._requireClient().get(filePath)) as SftpGetResult;
+    if (result instanceof Uint8Array) {
+      return result;
+    }
+    // 타입 정의상 string도 가능하므로 방어 코드
+    if (typeof result === "string") {
+      return new TextEncoder().encode(result);
+    }
+    throw new SdError("예상치 못한 응답 타입입니다.");
+  }
+
+  async remove(filePath: string): Promise<void> {
+    await this._requireClient().delete(filePath);
+  }
+
+  /** 로컬 파일 경로 또는 바이트 데이터를 원격 경로에 업로드합니다. */
+  async put(localPathOrBuffer: string | Bytes, storageFilePath: string): Promise<void> {
+    if (typeof localPathOrBuffer === "string") {
+      await this._requireClient().fastPut(localPathOrBuffer, storageFilePath);
+    } else {
+      // eslint-disable-next-line no-restricted-globals -- ssh2-sftp-client 라이브러리 요구사항
+      await this._requireClient().put(Buffer.from(localPathOrBuffer), storageFilePath);
+    }
+  }
+
+  async uploadDir(fromPath: string, toPath: string): Promise<void> {
+    await this._requireClient().uploadDir(fromPath, toPath);
+  }
+
+  /**
+   * 연결을 종료합니다.
+   *
+   * @remarks
+   * 이미 종료된 상태에서 호출해도 에러가 발생하지 않습니다.
+   * 종료 후에는 동일 인스턴스에서 {@link connect}를 다시 호출하여 재연결할 수 있습니다.
+   */
+  async close(): Promise<void> {
+    if (this._client === undefined) {
+      return;
+    }
+    await this._client.end();
+    this._client = undefined;
+  }
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+//#region Types
+export * from "./types/storage-conn-config";
+export * from "./types/storage";
+export * from "./types/storage-type";
+//#endregion
+
+//#region Clients
+export * from "./clients/ftp-storage-client";
+export * from "./clients/sftp-storage-client";
+//#endregion
+
+//#region Factory
+export * from "./storage-factory";
+//#endregion

package/src/storage-factory.ts

@@ -0,0 +1,47 @@
+import type { StorageConnConfig } from "./types/storage-conn-config";
+import type { Storage } from "./types/storage";
+import type { StorageType } from "./types/storage-type";
+import { FtpStorageClient } from "./clients/ftp-storage-client";
+import { SftpStorageClient } from "./clients/sftp-storage-client";
+
+/**
+ * 스토리지 클라이언트 팩토리
+ *
+ * FTP, FTPS, SFTP 스토리지 연결을 생성하고 관리한다.
+ */
+export class StorageFactory {
+  /**
+   * 스토리지에 연결하고 콜백을 실행한 후 자동으로 연결을 종료한다.
+   *
+   * @remarks
+   * 콜백 패턴으로 연결/종료가 자동 관리되므로, 직접 클라이언트를 사용하는 것보다 권장된다.
+   * 콜백에서 예외가 발생해도 연결은 자동으로 종료된다.
+   */
+  static async connect<R>(
+    type: StorageType,
+    config: StorageConnConfig,
+    fn: (storage: Storage) => R | Promise<R>,
+  ): Promise<R> {
+    const client = StorageFactory._createClient(type);
+
+    await client.connect(config);
+    try {
+      return await fn(client);
+    } finally {
+      await client.close().catch(() => {
+        // 이미 닫힌 경우 무시
+      });
+    }
+  }
+
+  private static _createClient(type: StorageType): Storage {
+    switch (type) {
+      case "sftp":
+        return new SftpStorageClient();
+      case "ftps":
+        return new FtpStorageClient(true);
+      case "ftp":
+        return new FtpStorageClient(false);
+    }
+  }
+}

package/src/types/storage-conn-config.ts

@@ -0,0 +1,6 @@
+export interface StorageConnConfig {
+  host: string;
+  port?: number;
+  user?: string;
+  pass?: string;
+}

package/src/types/storage-type.ts

@@ -0,0 +1 @@
+export type StorageType = "ftp" | "ftps" | "sftp";

package/src/types/storage.ts

@@ -0,0 +1,20 @@
+import type { Bytes } from "@simplysm/core-common";
+import type { StorageConnConfig } from "./storage-conn-config";
+
+export interface FileInfo {
+  name: string;
+  isFile: boolean;
+}
+
+export interface Storage {
+  connect(config: StorageConnConfig): Promise<void>;
+  mkdir(dirPath: string): Promise<void>;
+  rename(fromPath: string, toPath: string): Promise<void>;
+  readdir(dirPath: string): Promise<FileInfo[]>;
+  readFile(filePath: string): Promise<Bytes>;
+  exists(filePath: string): Promise<boolean>;
+  put(localPathOrBuffer: string | Bytes, storageFilePath: string): Promise<void>;
+  uploadDir(fromPath: string, toPath: string): Promise<void>;
+  remove(filePath: string): Promise<void>;
+  close(): Promise<void>;
+}