@simplysm/capacitor-plugin-file-system 13.0.99 → 14.0.1

package/dist/web/FileSystemWeb.js

@@ -1,72 +1,72 @@
 import { WebPlugin } from "@capacitor/core";
 import { VirtualFileSystem } from "./VirtualFileSystem.js";
 import { bytes } from "@simplysm/core-common";
-class FileSystemWeb extends WebPlugin {
-  _fs = new VirtualFileSystem("capacitor_web_virtual_fs");
-  _textEncoder = new TextEncoder();
-  _textDecoder = new TextDecoder();
-  async checkPermissions() {
-    return Promise.resolve({ granted: true });
-  }
-  async requestPermissions() {
-  }
-  async readdir(options) {
-    const entry = await this._fs.getEntry(options.path);
-    if (!entry || entry.kind !== "dir") {
-      throw new Error("Directory does not exist");
+export class FileSystemWeb extends WebPlugin {
+    _fs = new VirtualFileSystem("capacitor_web_virtual_fs");
+    _textEncoder = new TextEncoder();
+    _textDecoder = new TextDecoder();
+    async checkPermissions() {
+        return Promise.resolve({ granted: true });
     }
-    const files = await this._fs.listChildren(options.path);
-    return { files };
-  }
-  async getStoragePath(options) {
-    const storagePath = "/webfs/" + options.type;
-    await this._fs.ensureDir(storagePath);
-    return { path: storagePath };
-  }
-  /**
-   * Return the Blob URL of a file.
-   * @warning The returned URI must be released by calling `URL.revokeObjectURL(uri)` after use.
-   * Failure to release may cause memory leaks.
-   */
-  async getUri(options) {
-    const entry = await this._fs.getEntry(options.path);
-    if (!entry || entry.kind !== "file" || entry.dataBase64 == null) {
-      throw new Error("File not found: " + options.path);
+    async requestPermissions() { }
+    async readdir(options) {
+        const entry = await this._fs.getEntry(options.path);
+        if (!entry || entry.kind !== "dir") {
+            throw new Error("디렉토리가 존재하지 않습니다");
+        }
+        const files = await this._fs.listChildren(options.path);
+        return { files };
     }
-    const data = bytes.fromBase64(entry.dataBase64);
-    const blob = new Blob([data]);
-    return { uri: URL.createObjectURL(blob) };
-  }
-  async writeFile(options) {
-    const idx = options.path.lastIndexOf("/");
-    const dir = idx === -1 ? "." : options.path.substring(0, idx) || "/";
-    await this._fs.ensureDir(dir);
-    const dataBase64 = options.encoding === "base64" ? options.data : bytes.toBase64(this._textEncoder.encode(options.data));
-    await this._fs.putEntry({ path: options.path, kind: "file", dataBase64 });
-  }
-  async readFile(options) {
-    const entry = await this._fs.getEntry(options.path);
-    if (!entry || entry.kind !== "file" || entry.dataBase64 == null) {
-      throw new Error("File not found: " + options.path);
+    async getStoragePath(options) {
+        const storagePath = "/webfs/" + options.type;
+        await this._fs.ensureDir(storagePath);
+        return { path: storagePath };
     }
-    const data = options.encoding === "base64" ? entry.dataBase64 : this._textDecoder.decode(bytes.fromBase64(entry.dataBase64));
-    return { data };
-  }
-  async remove(options) {
-    const ok = await this._fs.deleteByPrefix(options.path);
-    if (!ok) {
-      throw new Error("Deletion failed");
+    /**
+     * 파일의 Blob URL을 반환합니다.
+     * @warning 반환된 URI는 사용 후 `URL.revokeObjectURL(uri)`를 호출하여 해제해야 합니다.
+     * 해제하지 않으면 메모리 누수가 발생할 수 있습니다.
+     */
+    async getUri(options) {
+        const entry = await this._fs.getEntry(options.path);
+        if (!entry || entry.kind !== "file" || entry.dataBase64 == null) {
+            throw new Error("파일을 찾을 수 없습니다: " + options.path);
+        }
+        const data = bytes.fromBase64(entry.dataBase64);
+        const blob = new Blob([data]);
+        return { uri: URL.createObjectURL(blob) };
+    }
+    async writeFile(options) {
+        const idx = options.path.lastIndexOf("/");
+        const dir = idx === -1 ? "." : options.path.substring(0, idx) || "/";
+        await this._fs.ensureDir(dir);
+        const dataBase64 = options.encoding === "base64"
+            ? options.data
+            : bytes.toBase64(this._textEncoder.encode(options.data));
+        await this._fs.putEntry({ path: options.path, kind: "file", dataBase64 });
+    }
+    async readFile(options) {
+        const entry = await this._fs.getEntry(options.path);
+        if (!entry || entry.kind !== "file" || entry.dataBase64 == null) {
+            throw new Error("파일을 찾을 수 없습니다: " + options.path);
+        }
+        const data = options.encoding === "base64"
+            ? entry.dataBase64
+            : this._textDecoder.decode(bytes.fromBase64(entry.dataBase64));
+        return { data };
+    }
+    async remove(options) {
+        const ok = await this._fs.deleteByPrefix(options.path);
+        if (!ok) {
+            throw new Error("삭제에 실패했습니다");
+        }
+    }
+    async mkdir(options) {
+        await this._fs.ensureDir(options.path);
+    }
+    async exists(options) {
+        const entry = await this._fs.getEntry(options.path);
+        return { exists: !!entry };
     }
-  }
-  async mkdir(options) {
-    await this._fs.ensureDir(options.path);
-  }
-  async exists(options) {
-    const entry = await this._fs.getEntry(options.path);
-    return { exists: !!entry };
-  }
 }
-export {
-  FileSystemWeb
-};
-//# sourceMappingURL=FileSystemWeb.js.map
+//# sourceMappingURL=FileSystemWeb.js.map

package/dist/web/FileSystemWeb.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/web/FileSystemWeb.ts"],
-  "mappings": "AAAA,SAAS,iBAAiB;AAE1B,SAAS,yBAAyB;AAClC,SAAS,aAAa;AAEf,MAAM,sBAAsB,UAAsC;AAAA,EACtD,MAAM,IAAI,kBAAkB,0BAA0B;AAAA,EACtD,eAAe,IAAI,YAAY;AAAA,EAC/B,eAAe,IAAI,YAAY;AAAA,EAEhD,MAAM,mBAAkD;AACtD,WAAO,QAAQ,QAAQ,EAAE,SAAS,KAAK,CAAC;AAAA,EAC1C;AAAA,EAEA,MAAM,qBAAoC;AAAA,EAAC;AAAA,EAE3C,MAAM,QAAQ,SAA2D;AACvE,UAAM,QAAQ,MAAM,KAAK,IAAI,SAAS,QAAQ,IAAI;AAClD,QAAI,CAAC,SAAS,MAAM,SAAS,OAAO;AAClC,YAAM,IAAI,MAAM,0BAA0B;AAAA,IAC5C;AACA,UAAM,QAAQ,MAAM,KAAK,IAAI,aAAa,QAAQ,IAAI;AACtD,WAAO,EAAE,MAAM;AAAA,EACjB;AAAA,EAEA,MAAM,eAAe,SAA2D;AAC9E,UAAM,cAAc,YAAY,QAAQ;AACxC,UAAM,KAAK,IAAI,UAAU,WAAW;AACpC,WAAO,EAAE,MAAM,YAAY;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,SAAqD;AAChE,UAAM,QAAQ,MAAM,KAAK,IAAI,SAAS,QAAQ,IAAI;AAClD,QAAI,CAAC,SAAS,MAAM,SAAS,UAAU,MAAM,cAAc,MAAM;AAC/D,YAAM,IAAI,MAAM,qBAAqB,QAAQ,IAAI;AAAA,IACnD;AACA,UAAM,OAAO,MAAM,WAAW,MAAM,UAAU;AAC9C,UAAM,OAAO,IAAI,KAAK,CAAC,IAAgB,CAAC;AACxC,WAAO,EAAE,KAAK,IAAI,gBAAgB,IAAI,EAAE;AAAA,EAC1C;AAAA,EAEA,MAAM,UAAU,SAIE;AAChB,UAAM,MAAM,QAAQ,KAAK,YAAY,GAAG;AACxC,UAAM,MAAM,QAAQ,KAAK,MAAM,QAAQ,KAAK,UAAU,GAAG,GAAG,KAAK;AACjE,UAAM,KAAK,IAAI,UAAU,GAAG;AAC5B,UAAM,aACJ,QAAQ,aAAa,WACjB,QAAQ,OACR,MAAM,SAAS,KAAK,aAAa,OAAO,QAAQ,IAAI,CAAC;AAC3D,UAAM,KAAK,IAAI,SAAS,EAAE,MAAM,QAAQ,MAAM,MAAM,QAAQ,WAAW,CAAC;AAAA,EAC1E;AAAA,EAEA,MAAM,SAAS,SAGe;AAC5B,UAAM,QAAQ,MAAM,KAAK,IAAI,SAAS,QAAQ,IAAI;AAClD,QAAI,CAAC,SAAS,MAAM,SAAS,UAAU,MAAM,cAAc,MAAM;AAC/D,YAAM,IAAI,MAAM,qBAAqB,QAAQ,IAAI;AAAA,IACnD;AACA,UAAM,OACJ,QAAQ,aAAa,WACjB,MAAM,aACN,KAAK,aAAa,OAAO,MAAM,WAAW,MAAM,UAAU,CAAC;AACjE,WAAO,EAAE,KAAK;AAAA,EAChB;AAAA,EAEA,MAAM,OAAO,SAA0C;AACrD,UAAM,KAAK,MAAM,KAAK,IAAI,eAAe,QAAQ,IAAI;AACrD,QAAI,CAAC,IAAI;AACP,YAAM,IAAI,MAAM,iBAAiB;AAAA,IACnC;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,SAA0C;AACpD,UAAM,KAAK,IAAI,UAAU,QAAQ,IAAI;AAAA,EACvC;AAAA,EAEA,MAAM,OAAO,SAAyD;AACpE,UAAM,QAAQ,MAAM,KAAK,IAAI,SAAS,QAAQ,IAAI;AAClD,WAAO,EAAE,QAAQ,CAAC,CAAC,MAAM;AAAA,EAC3B;AACF;",
-  "names": []
-}
+{"version":3,"file":"FileSystemWeb.js","sourceRoot":"","sources":["..\\..\\src\\web\\FileSystemWeb.ts"],"names":[],"mappings":"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"}

package/dist/web/VirtualFileSystem.d.ts

@@ -13,12 +13,12 @@ export declare class VirtualFileSystem {
     }): Promise<void>;
     deleteByPrefix(pathPrefix: string): Promise<boolean>;
     /**
-     * Return the direct children of a directory.
-     * @param dirPath Directory path to query
-     * @returns List of child files/directories
-     * @note Implicit directory handling: Even when only file paths exist without directory entries,
-     * intermediate paths are treated as directories. e.g., With only "/a/b/c.txt" stored,
-     * calling listChildren("/a") returns "b" with isDirectory: true.
+     * 디렉토리의 직접 하위 항목을 반환합니다.
+     * @param dirPath 조회할 디렉토리 경로
+     * @returns 하위 파일/디렉토리 목록
+     * @note 암시적 디렉토리 처리: 디렉토리 항목 없이 파일 경로만 존재하더라도
+     * 중간 경로를 디렉토리로 취급합니다. 예: "/a/b/c.txt"만 저장된 경우,
+     * listChildren("/a") 호출 시 "b"를 isDirectory: true로 반환합니다.
      */
     listChildren(dirPath: string): Promise<FileInfo[]>;
     ensureDir(dirPath: string): Promise<void>;

package/dist/web/VirtualFileSystem.js

@@ -1,38 +1,35 @@
 import { IndexedDbStore, IndexedDbVirtualFs } from "@simplysm/core-browser";
-class VirtualFileSystem {
-  _STORE_NAME = "entries";
-  _db;
-  _vfs;
-  constructor(dbName) {
-    this._db = new IndexedDbStore(dbName, 1, [{ name: this._STORE_NAME, keyPath: "path" }]);
-    this._vfs = new IndexedDbVirtualFs(this._db, this._STORE_NAME, "path");
-  }
-  async getEntry(filePath) {
-    return this._vfs.getEntry(filePath);
-  }
-  async putEntry(entry) {
-    return this._vfs.putEntry(entry.path, entry.kind, entry.dataBase64);
-  }
-  async deleteByPrefix(pathPrefix) {
-    return this._vfs.deleteByPrefix(pathPrefix);
-  }
-  /**
-   * Return the direct children of a directory.
-   * @param dirPath Directory path to query
-   * @returns List of child files/directories
-   * @note Implicit directory handling: Even when only file paths exist without directory entries,
-   * intermediate paths are treated as directories. e.g., With only "/a/b/c.txt" stored,
-   * calling listChildren("/a") returns "b" with isDirectory: true.
-   */
-  async listChildren(dirPath) {
-    const prefix = dirPath === "/" ? "/" : dirPath + "/";
-    return this._vfs.listChildren(prefix);
-  }
-  async ensureDir(dirPath) {
-    return this._vfs.ensureDir((path) => path, dirPath);
-  }
+export class VirtualFileSystem {
+    _STORE_NAME = "entries";
+    _db;
+    _vfs;
+    constructor(dbName) {
+        this._db = new IndexedDbStore(dbName, 1, [{ name: this._STORE_NAME, keyPath: "path" }]);
+        this._vfs = new IndexedDbVirtualFs(this._db, this._STORE_NAME, "path");
+    }
+    async getEntry(filePath) {
+        return this._vfs.getEntry(filePath);
+    }
+    async putEntry(entry) {
+        return this._vfs.putEntry(entry.path, entry.kind, entry.dataBase64);
+    }
+    async deleteByPrefix(pathPrefix) {
+        return this._vfs.deleteByPrefix(pathPrefix);
+    }
+    /**
+     * 디렉토리의 직접 하위 항목을 반환합니다.
+     * @param dirPath 조회할 디렉토리 경로
+     * @returns 하위 파일/디렉토리 목록
+     * @note 암시적 디렉토리 처리: 디렉토리 항목 없이 파일 경로만 존재하더라도
+     * 중간 경로를 디렉토리로 취급합니다. 예: "/a/b/c.txt"만 저장된 경우,
+     * listChildren("/a") 호출 시 "b"를 isDirectory: true로 반환합니다.
+     */
+    async listChildren(dirPath) {
+        const prefix = dirPath === "/" ? "/" : dirPath + "/";
+        return this._vfs.listChildren(prefix);
+    }
+    async ensureDir(dirPath) {
+        return this._vfs.ensureDir((path) => path, dirPath);
+    }
 }
-export {
-  VirtualFileSystem
-};
-//# sourceMappingURL=VirtualFileSystem.js.map
+//# sourceMappingURL=VirtualFileSystem.js.map

package/dist/web/VirtualFileSystem.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/web/VirtualFileSystem.ts"],
-  "mappings": "AAEA,SAAS,gBAAgB,0BAA0B;AAE5C,MAAM,kBAAkB;AAAA,EACZ,cAAc;AAAA,EACd;AAAA,EACA;AAAA,EAEjB,YAAY,QAAgB;AAC1B,SAAK,MAAM,IAAI,eAAe,QAAQ,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,SAAS,OAAO,CAAC,CAAC;AACtF,SAAK,OAAO,IAAI,mBAAmB,KAAK,KAAK,KAAK,aAAa,MAAM;AAAA,EACvE;AAAA,EAEA,MAAM,SAAS,UAAuD;AACpE,WAAO,KAAK,KAAK,SAAS,QAAQ;AAAA,EACpC;AAAA,EAEA,MAAM,SAAS,OAAmF;AAChG,WAAO,KAAK,KAAK,SAAS,MAAM,MAAM,MAAM,MAAM,MAAM,UAAU;AAAA,EACpE;AAAA,EAEA,MAAM,eAAe,YAAsC;AACzD,WAAO,KAAK,KAAK,eAAe,UAAU;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,aAAa,SAAsC;AACvD,UAAM,SAAS,YAAY,MAAM,MAAM,UAAU;AACjD,WAAO,KAAK,KAAK,aAAa,MAAM;AAAA,EACtC;AAAA,EAEA,MAAM,UAAU,SAAgC;AAC9C,WAAO,KAAK,KAAK,UAAU,CAAC,SAAS,MAAM,OAAO;AAAA,EACpD;AACF;",
-  "names": []
-}
+{"version":3,"file":"VirtualFileSystem.js","sourceRoot":"","sources":["..\\..\\src\\web\\VirtualFileSystem.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,MAAM,OAAO,iBAAiB;IACX,WAAW,GAAG,SAAS,CAAC;IACxB,GAAG,CAAiB;IACpB,IAAI,CAAqB;IAE1C,YAAY,MAAc;QACxB,IAAI,CAAC,GAAG,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAkE;QAC/E,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,MAAM,MAAM,GAAG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;CACF"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@simplysm/capacitor-plugin-file-system",
-  "version": "13.0.99",
-  "description": "Simplysm Package - Capacitor File System Plugin",
+  "version": "14.0.1",
+  "description": "심플리즘 패키지 - Capacitor 파일 시스템 플러그인",
   "author": "simplysm",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/kslhunter/simplysm.git",
@@ -18,14 +18,14 @@
     "android"
   ],
   "dependencies": {
-    "@simplysm/core-common": "13.0.99",
-    "@simplysm/core-browser": "13.0.99"
+    "@simplysm/core-browser": "14.0.1",
+    "@simplysm/core-common": "14.0.1"
   },
   "devDependencies": {
     "@capacitor/core": "^7.6.0"
   },
   "peerDependencies": {
-    "@capacitor/core": "^7.4.4"
+    "@capacitor/core": "^7"
   },
   "capacitor": {
     "android": {

package/src/FileSystem.ts

@@ -11,14 +11,14 @@ const fileSystemPlugin = registerPlugin<FileSystemPlugin>("FileSystem", {
 });
 
 /**
- * File system access plugin
- * - Android 11+: Full file system access via MANAGE_EXTERNAL_STORAGE permission
- * - Android 10-: READ/WRITE_EXTERNAL_STORAGE permission
- * - Browser: IndexedDB-based emulation
+ * 파일 시스템 접근 플러그인
+ * - Android 11+: MANAGE_EXTERNAL_STORAGE 권한을 통한 전체 파일 시스템 접근
+ * - Android 10-: READ/WRITE_EXTERNAL_STORAGE 권한
+ * - Browser: IndexedDB 기반 에뮬레이션
  */
 export abstract class FileSystem {
   /**
-   * Check permission
+   * 권한 확인
    */
   static async checkPermissions(): Promise<boolean> {
     const result = await fileSystemPlugin.checkPermissions();
@@ -26,16 +26,16 @@ export abstract class FileSystem {
   }
 
   /**
-   * Request permission
-   * - Android 11+: Navigate to settings
-   * - Android 10-: Show permission dialog
+   * 권한 요청
+   * - Android 11+: 설정 화면으로 이동
+   * - Android 10-: 권한 대화상자 표시
    */
   static async requestPermissions(): Promise<void> {
     await fileSystemPlugin.requestPermissions();
   }
 
   /**
-   * Read directory
+   * 디렉토리 읽기
    */
   static async readdir(dirPath: string): Promise<FileInfo[]> {
     const result = await fileSystemPlugin.readdir({ path: dirPath });
@@ -43,15 +43,15 @@ export abstract class FileSystem {
   }
 
   /**
-   * Get storage path
-   * @param type Storage type
-   * - external: External storage root (Environment.getExternalStorageDirectory)
-   * - externalFiles: App-specific external files directory
-   * - externalCache: App-specific external cache directory
-   * - externalMedia: App-specific external media directory
-   * - appData: App data directory
-   * - appFiles: App files directory
-   * - appCache: App cache directory
+   * 저장소 경로 조회
+   * @param type 저장소 유형
+   * - external: 외부 저장소 루트 (Environment.getExternalStorageDirectory)
+   * - externalFiles: 앱 전용 외부 파일 디렉토리
+   * - externalCache: 앱 전용 외부 캐시 디렉토리
+   * - externalMedia: 앱 전용 외부 미디어 디렉토리
+   * - appData: 앱 데이터 디렉토리
+   * - appFiles: 앱 파일 디렉토리
+   * - appCache: 앱 캐시 디렉토리
    */
   static async getStoragePath(type: StorageType): Promise<string> {
     const result = await fileSystemPlugin.getStoragePath({ type });
@@ -59,7 +59,7 @@ export abstract class FileSystem {
   }
 
   /**
-   * Get file URI (FileProvider)
+   * 파일 URI 조회 (FileProvider)
    */
   static async getUri(filePath: string): Promise<string> {
     const result = await fileSystemPlugin.getUri({ path: filePath });
@@ -67,11 +67,11 @@ export abstract class FileSystem {
   }
 
   /**
-   * Write file
+   * 파일 쓰기
    */
   static async writeFile(filePath: string, data: string | Bytes): Promise<void> {
     if (typeof data !== "string") {
-      // Bytes (Uint8Array) - works safely in cross-realm environments
+      // Bytes (Uint8Array) - cross-realm 환경에서도 안전하게 동작
       await fileSystemPlugin.writeFile({
         path: filePath,
         data: bytes.toBase64(data),
@@ -87,7 +87,7 @@ export abstract class FileSystem {
   }
 
   /**
-   * Read file (default: Bytes, with encoding "utf8": string)
+   * 파일 읽기 (기본: Bytes, encoding "utf8" 지정 시: string)
    */
   static async readFile(filePath: string): Promise<Bytes>;
   static async readFile(filePath: string, encoding: "utf8"): Promise<string>;
@@ -102,21 +102,21 @@ export abstract class FileSystem {
   }
 
   /**
-   * Delete file/directory (recursive)
+   * 파일/디렉토리 삭제 (재귀)
    */
   static async remove(targetPath: string): Promise<void> {
     await fileSystemPlugin.remove({ path: targetPath });
   }
 
   /**
-   * Create directory (recursive)
+   * 디렉토리 생성 (재귀)
    */
   static async mkdir(targetPath: string): Promise<void> {
     await fileSystemPlugin.mkdir({ path: targetPath });
   }
 
   /**
-   * Check existence
+   * 존재 여부 확인
    */
   static async exists(targetPath: string): Promise<boolean> {
     const result = await fileSystemPlugin.exists({ path: targetPath });

package/src/index.ts

@@ -1,3 +1,3 @@
-// File System
+// 파일 시스템
 export * from "./FileSystem";
 export * from "./FileSystemPlugin";

package/src/web/FileSystemWeb.ts

@@ -17,7 +17,7 @@ export class FileSystemWeb extends WebPlugin implements FileSystemPlugin {
   async readdir(options: { path: string }): Promise<{ files: FileInfo[] }> {
     const entry = await this._fs.getEntry(options.path);
     if (!entry || entry.kind !== "dir") {
-      throw new Error("Directory does not exist");
+      throw new Error("디렉토리가 존재하지 않습니다");
     }
     const files = await this._fs.listChildren(options.path);
     return { files };
@@ -30,14 +30,14 @@ export class FileSystemWeb extends WebPlugin implements FileSystemPlugin {
   }
 
   /**
-   * Return the Blob URL of a file.
-   * @warning The returned URI must be released by calling `URL.revokeObjectURL(uri)` after use.
-   * Failure to release may cause memory leaks.
+   * 파일의 Blob URL을 반환합니다.
+   * @warning 반환된 URI는 사용 후 `URL.revokeObjectURL(uri)`를 호출하여 해제해야 합니다.
+   * 해제하지 않으면 메모리 누수가 발생할 수 있습니다.
    */
   async getUri(options: { path: string }): Promise<{ uri: string }> {
     const entry = await this._fs.getEntry(options.path);
     if (!entry || entry.kind !== "file" || entry.dataBase64 == null) {
-      throw new Error("File not found: " + options.path);
+      throw new Error("파일을 찾을 수 없습니다: " + options.path);
     }
     const data = bytes.fromBase64(entry.dataBase64);
     const blob = new Blob([data as BlobPart]);
@@ -65,7 +65,7 @@ export class FileSystemWeb extends WebPlugin implements FileSystemPlugin {
   }): Promise<{ data: string }> {
     const entry = await this._fs.getEntry(options.path);
     if (!entry || entry.kind !== "file" || entry.dataBase64 == null) {
-      throw new Error("File not found: " + options.path);
+      throw new Error("파일을 찾을 수 없습니다: " + options.path);
     }
     const data =
       options.encoding === "base64"
@@ -77,7 +77,7 @@ export class FileSystemWeb extends WebPlugin implements FileSystemPlugin {
   async remove(options: { path: string }): Promise<void> {
     const ok = await this._fs.deleteByPrefix(options.path);
     if (!ok) {
-      throw new Error("Deletion failed");
+      throw new Error("삭제에 실패했습니다");
     }
   }
 

package/src/web/VirtualFileSystem.ts

@@ -25,12 +25,12 @@ export class VirtualFileSystem {
   }
 
   /**
-   * Return the direct children of a directory.
-   * @param dirPath Directory path to query
-   * @returns List of child files/directories
-   * @note Implicit directory handling: Even when only file paths exist without directory entries,
-   * intermediate paths are treated as directories. e.g., With only "/a/b/c.txt" stored,
-   * calling listChildren("/a") returns "b" with isDirectory: true.
+   * 디렉토리의 직접 하위 항목을 반환합니다.
+   * @param dirPath 조회할 디렉토리 경로
+   * @returns 하위 파일/디렉토리 목록
+   * @note 암시적 디렉토리 처리: 디렉토리 항목 없이 파일 경로만 존재하더라도
+   * 중간 경로를 디렉토리로 취급합니다. 예: "/a/b/c.txt"만 저장된 경우,
+   * listChildren("/a") 호출 시 "b"를 isDirectory: true로 반환합니다.
    */
   async listChildren(dirPath: string): Promise<FileInfo[]> {
     const prefix = dirPath === "/" ? "/" : dirPath + "/";

package/README.md

@@ -1,98 +0,0 @@
-# @simplysm/capacitor-plugin-file-system
-
-Simplysm Package - Capacitor File System Plugin. Provides file system access for Android (MANAGE_EXTERNAL_STORAGE on Android 11+) with IndexedDB-based browser emulation.
-
-## Installation
-
-```bash
-npm install @simplysm/capacitor-plugin-file-system
-```
-
-## API Overview
-
-### File System
-
-| API | Type | Description |
-|-----|------|-------------|
-| `FileSystem` | class | File system access plugin (static methods) |
-| `FileSystemPlugin` | interface | Low-level Capacitor plugin interface for file system |
-| `StorageType` | type | Storage location type |
-| `FileInfo` | interface | File/directory entry information |
-
----
-
-### `StorageType`
-
-```typescript
-type StorageType =
-  | "external"       // External storage root (Environment.getExternalStorageDirectory)
-  | "externalFiles"  // App-specific external files directory
-  | "externalCache"  // App-specific external cache directory
-  | "externalMedia"  // App-specific external media directory
-  | "appData"        // App data directory
-  | "appFiles"       // App files directory
-  | "appCache";      // App cache directory
-```
-
-### `FileInfo`
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string` | File or directory name |
-| `isDirectory` | `boolean` | Whether the entry is a directory |
-
-### `FileSystemPlugin`
-
-| Method | Signature | Description |
-|--------|-----------|-------------|
-| `checkPermissions` | `() => Promise<{ granted: boolean }>` | Check file system permission |
-| `requestPermissions` | `() => Promise<void>` | Request file system permission |
-| `readdir` | `(options: { path: string }) => Promise<{ files: FileInfo[] }>` | Read directory contents |
-| `getStoragePath` | `(options: { type: StorageType }) => Promise<{ path: string }>` | Get storage path by type |
-| `getUri` | `(options: { path: string }) => Promise<{ uri: string }>` | Get FileProvider URI |
-| `writeFile` | `(options: { path: string; data: string; encoding?: "utf8" \| "base64" }) => Promise<void>` | Write file |
-| `readFile` | `(options: { path: string; encoding?: "utf8" \| "base64" }) => Promise<{ data: string }>` | Read file |
-| `remove` | `(options: { path: string }) => Promise<void>` | Delete file/directory |
-| `mkdir` | `(options: { path: string }) => Promise<void>` | Create directory |
-| `exists` | `(options: { path: string }) => Promise<{ exists: boolean }>` | Check existence |
-
-### `FileSystem`
-
-Abstract class with static methods for file system access. Android 11+ uses MANAGE_EXTERNAL_STORAGE; Android 10- uses READ/WRITE_EXTERNAL_STORAGE; browser uses IndexedDB emulation.
-
-| Method | Signature | Description |
-|--------|-----------|-------------|
-| `checkPermissions` | `() => Promise<boolean>` | Check permission |
-| `requestPermissions` | `() => Promise<void>` | Request permission (Android 11+: settings, Android 10-: dialog) |
-| `readdir` | `(dirPath: string) => Promise<FileInfo[]>` | Read directory |
-| `getStoragePath` | `(type: StorageType) => Promise<string>` | Get storage path |
-| `getUri` | `(filePath: string) => Promise<string>` | Get FileProvider URI |
-| `writeFile` | `(filePath: string, data: string \| Bytes) => Promise<void>` | Write file (string or Uint8Array) |
-| `readFile` | `(filePath: string) => Promise<Bytes>` | Read file as Bytes |
-| `readFile` | `(filePath: string, encoding: "utf8") => Promise<string>` | Read file as UTF-8 string |
-| `remove` | `(targetPath: string) => Promise<void>` | Delete file/directory (recursive) |
-| `mkdir` | `(targetPath: string) => Promise<void>` | Create directory (recursive) |
-| `exists` | `(targetPath: string) => Promise<boolean>` | Check existence |
-
-## Usage Examples
-
-### Read and write files
-
-```typescript
-import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
-
-// Check and request permissions
-if (!(await FileSystem.checkPermissions())) {
-  await FileSystem.requestPermissions();
-}
-
-// Get storage path and write a file
-const storagePath = await FileSystem.getStoragePath("appFiles");
-await FileSystem.writeFile(`${storagePath}/data.txt`, "Hello, world!");
-
-// Read it back
-const content = await FileSystem.readFile(`${storagePath}/data.txt`, "utf8");
-
-// List directory contents
-const files = await FileSystem.readdir(storagePath);
-```