@simplysm/capacitor-plugin-file-system 12.16.27 → 13.0.0-beta.10

package/README.md

@@ -0,0 +1,226 @@
+# @simplysm/capacitor-plugin-file-system
+
+A Capacitor-based file system access plugin. On Android, it provides direct access to the native file system, while in web environments it operates as an IndexedDB-based virtual file system.
+
+## Installation
+
+```bash
+npm install @simplysm/capacitor-plugin-file-system
+npx cap sync
+```
+
+### Peer Dependencies
+
+| Package | Version |
+|--------|------|
+| `@capacitor/core` | `^7.4.4` |
+
+### Internal Dependencies
+
+| Package | Description |
+|--------|------|
+| `@simplysm/core-common` | Common utilities such as base64 conversion, `Bytes` type |
+
+## Supported Platforms
+
+| Platform | Supported | Implementation |
+|--------|----------|----------|
+| Android | Yes | Native Java (API 23+) |
+| Web | Yes | IndexedDB-based virtual file system |
+| iOS | No | - |
+
+### Android Permissions
+
+Different permission models are used depending on the Android version.
+
+| Android Version | Permission | Behavior |
+|-------------|------|------|
+| Android 11+ (API 30+) | `MANAGE_EXTERNAL_STORAGE` | Navigate to settings screen to grant full file access permission |
+| Android 10 and below | `READ_EXTERNAL_STORAGE`, `WRITE_EXTERNAL_STORAGE` | Display runtime permission dialog |
+
+The plugin automatically declares the necessary permissions in `AndroidManifest.xml`, so you don't need to add them separately in your app's manifest.
+
+## Main API
+
+All APIs are provided as static methods of the `FileSystem` class.
+
+```typescript
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+```
+
+### Method List
+
+| Method | Return Type | Description |
+|--------|----------|------|
+| `hasPermission()` | `Promise<boolean>` | Check if file system access permission is granted |
+| `requestPermission()` | `Promise<void>` | Request file system access permission |
+| `readdir(dirPath)` | `Promise<IFileInfo[]>` | List files/folders in directory |
+| `getStoragePath(type)` | `Promise<string>` | Return absolute path by storage type |
+| `getFileUri(filePath)` | `Promise<string>` | Return FileProvider URI (Android) / Blob URL (Web) |
+| `writeFile(filePath, data)` | `Promise<void>` | Write file (string or binary) |
+| `readFileString(filePath)` | `Promise<string>` | Read file as UTF-8 string |
+| `readFileBytes(filePath)` | `Promise<Bytes>` | Read file as binary (`Uint8Array`) |
+| `remove(targetPath)` | `Promise<void>` | Recursively delete file or directory |
+| `mkdir(targetPath)` | `Promise<void>` | Recursively create directory |
+| `exists(targetPath)` | `Promise<boolean>` | Check if file or directory exists |
+
+### Type Definitions
+
+#### `TStorage`
+
+A string literal type representing storage types.
+
+| Value | Android Path | Description |
+|----|-------------|------|
+| `"external"` | `Environment.getExternalStorageDirectory()` | External storage root |
+| `"externalFiles"` | `Context.getExternalFilesDir(null)` | App-specific external files directory |
+| `"externalCache"` | `Context.getExternalCacheDir()` | App-specific external cache directory |
+| `"externalMedia"` | `Context.getExternalMediaDirs()[0]` | App-specific external media directory |
+| `"appData"` | `ApplicationInfo.dataDir` | App data directory |
+| `"appFiles"` | `Context.getFilesDir()` | App internal files directory |
+| `"appCache"` | `Context.getCacheDir()` | App internal cache directory |
+
+#### `IFileInfo`
+
+```typescript
+interface IFileInfo {
+  name: string;        // File or directory name
+  isDirectory: boolean; // Whether it's a directory
+}
+```
+
+## Usage Examples
+
+### Check and Request Permission
+
+```typescript
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+
+async function ensurePermission(): Promise<boolean> {
+  const granted = await FileSystem.hasPermission();
+  if (!granted) {
+    await FileSystem.requestPermission();
+    // On Android 11+, it navigates to settings screen,
+    // so you need to check again after returning to the app.
+    return await FileSystem.hasPermission();
+  }
+  return true;
+}
+```
+
+### Read/Write Text Files
+
+```typescript
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+
+async function textFileExample(): Promise<void> {
+  const storagePath = await FileSystem.getStoragePath("appFiles");
+  const filePath = storagePath + "/config.json";
+
+  // Write file
+  const config = { theme: "dark", lang: "ko" };
+  await FileSystem.writeFile(filePath, JSON.stringify(config, null, 2));
+
+  // Read file
+  const content = await FileSystem.readFileString(filePath);
+  const parsed = JSON.parse(content);
+  console.log(parsed.theme); // "dark"
+}
+```
+
+### Read/Write Binary Files
+
+```typescript
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+
+async function binaryFileExample(): Promise<void> {
+  const storagePath = await FileSystem.getStoragePath("appFiles");
+  const filePath = storagePath + "/data.bin";
+
+  // Write as Uint8Array
+  const bytes = new Uint8Array([0x48, 0x65, 0x6c, 0x6c, 0x6f]);
+  await FileSystem.writeFile(filePath, bytes);
+
+  // Read as binary
+  const readBytes = await FileSystem.readFileBytes(filePath);
+  console.log(readBytes.length); // 5
+}
+```
+
+### Directory Management
+
+```typescript
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+
+async function directoryExample(): Promise<void> {
+  const storagePath = await FileSystem.getStoragePath("appFiles");
+  const dirPath = storagePath + "/logs/2024";
+
+  // Recursively create directory
+  await FileSystem.mkdir(dirPath);
+
+  // Create file
+  await FileSystem.writeFile(dirPath + "/app.log", "Started\n");
+
+  // List directory contents
+  const files = await FileSystem.readdir(dirPath);
+  for (const file of files) {
+    console.log(`${file.name} (directory: ${file.isDirectory})`);
+  }
+
+  // Check existence
+  const dirExists = await FileSystem.exists(dirPath);
+  console.log(dirExists); // true
+
+  // Recursively delete directory
+  await FileSystem.remove(dirPath);
+}
+```
+
+### Get FileProvider URI
+
+On Android, a `content://` URI is needed when sharing files with other apps.
+
+```typescript
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+
+async function shareFile(filePath: string): Promise<string> {
+  // Android: returns content:// URI
+  // Web: returns blob: URL (must call URL.revokeObjectURL() after use)
+  const uri = await FileSystem.getFileUri(filePath);
+  return uri;
+}
+```
+
+> **Warning**: In web environments, the Blob URL returned by `getFileUri()` must be released by calling `URL.revokeObjectURL(uri)` after use to free memory.
+
+## Android Configuration
+
+### FileProvider
+
+The plugin includes its own `FileSystemProvider`, and the authority is automatically set in the format `${applicationId}.filesystem.provider`. Shareable paths are:
+
+- External storage (`external-path`)
+- App-specific external files (`external-files-path`)
+- App-specific external cache (`external-cache-path`)
+- App internal files (`files-path`)
+- App internal cache (`cache-path`)
+
+### Minimum SDK Version
+
+- `minSdkVersion`: 23 (Android 6.0)
+- `compileSdkVersion`: 35
+
+## Web Environment Behavior
+
+In web environments, it operates as an IndexedDB-based virtual file system (`VirtualFileSystem`).
+
+- Database name: `capacitor_web_virtual_fs`
+- Permission-related methods (`hasPermission`, `requestPermission`) always succeed.
+- `getStoragePath()` returns virtual paths in the format `/webfs/{type}`.
+- `getFileUri()` returns a Blob URL, which must be released with `URL.revokeObjectURL()` after use.
+- File data is base64-encoded and stored in IndexedDB.
+
+## License
+
+MIT

package/android/src/main/java/kr/co/simplysm/capacitor/filesystem/FileSystemPlugin.java

@@ -11,6 +11,7 @@ import android.provider.Settings;
 import android.util.Base64;
 import android.util.Log;
 
+import androidx.core.app.ActivityCompat;
 import androidx.core.content.ContextCompat;
 import androidx.core.content.FileProvider;
 
@@ -28,9 +29,10 @@ import java.nio.charset.StandardCharsets;
 public class FileSystemPlugin extends Plugin {
 
     private static final String TAG = "FileSystemPlugin";
+    private static final int PERMISSION_REQUEST_CODE = 1001;
 
     @PluginMethod
-    public void checkPermission(PluginCall call) {
+    public void hasPermission(PluginCall call) {
         boolean granted;
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
             granted = Environment.isExternalStorageManager();
@@ -52,6 +54,20 @@ public class FileSystemPlugin extends Plugin {
                 intent.setData(Uri.parse("package:" + getContext().getPackageName()));
                 getActivity().startActivity(intent);
             }
+        } else {
+            boolean readGranted = ContextCompat.checkSelfPermission(getContext(),
+                Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED;
+            boolean writeGranted = ContextCompat.checkSelfPermission(getContext(),
+                Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED;
+
+            if (!readGranted || !writeGranted) {
+                ActivityCompat.requestPermissions(getActivity(),
+                    new String[]{
+                        Manifest.permission.READ_EXTERNAL_STORAGE,
+                        Manifest.permission.WRITE_EXTERNAL_STORAGE
+                    },
+                    PERMISSION_REQUEST_CODE);
+            }
         }
         call.resolve();
     }

package/dist/FileSystem.js

@@ -1,111 +1,109 @@
 import { registerPlugin } from "@capacitor/core";
+import { bytesToBase64, bytesFromBase64 } from "@simplysm/core-common";
 const FileSystemPlugin = registerPlugin("FileSystem", {
-    web: async () => {
-        const { FileSystemWeb } = await import("./web/FileSystemWeb");
-        return new FileSystemWeb();
-    },
+  web: async () => {
+    const { FileSystemWeb } = await import("./web/FileSystemWeb");
+    return new FileSystemWeb();
+  }
 });
-/**
- * 파일 시스템 접근 플러그인
- * - Android 11+: MANAGE_EXTERNAL_STORAGE 권한으로 전체 파일 시스템 접근
- * - Android 10-: READ/WRITE_EXTERNAL_STORAGE 권한
- * - Browser: IndexedDB 기반 에뮬레이션
- */
-export class FileSystem {
-    /**
-     * 권한 확인
-     */
-    static async checkPermissionAsync() {
-        const result = await FileSystemPlugin.checkPermission();
-        return result.granted;
-    }
-    /**
-     * 권한 요청
-     * - Android 11+: 설정 화면으로 이동
-     * - Android 10-: 권한 다이얼로그 표시
-     */
-    static async requestPermissionAsync() {
-        await FileSystemPlugin.requestPermission();
-    }
-    /**
-     * 디렉토리 읽기
-     */
-    static async readdirAsync(dirPath) {
-        const result = await FileSystemPlugin.readdir({ path: dirPath });
-        return result.files;
-    }
-    /**
-     * 저장소 경로 얻기
-     * @param type 저장소 타입
-     * - external: 외부 저장소 루트 (Environment.getExternalStorageDirectory)
-     * - externalFiles: 앱 전용 외부 파일 디렉토리
-     * - externalCache: 앱 전용 외부 캐시 디렉토리
-     * - externalMedia: 앱 전용 외부 미디어 디렉토리
-     * - appData: 앱 데이터 디렉토리
-     * - appFiles: 앱 파일 디렉토리
-     * - appCache: 앱 캐시 디렉토리
-     */
-    static async getStoragePathAsync(type) {
-        const result = await FileSystemPlugin.getStoragePath({ type });
-        return result.path;
-    }
-    /**
-     * 파일 URI 얻기 (FileProvider)
-     */
-    static async getFileUriAsync(filePath) {
-        const result = await FileSystemPlugin.getFileUri({ path: filePath });
-        return result.uri;
-    }
-    /**
-     * 파일 쓰기
-     */
-    static async writeFileAsync(filePath, data) {
-        if (Buffer.isBuffer(data)) {
-            await FileSystemPlugin.writeFile({
-                path: filePath,
-                data: data.toString("base64"),
-                encoding: "base64",
-            });
-        }
-        else {
-            await FileSystemPlugin.writeFile({
-                path: filePath,
-                data,
-                encoding: "utf8",
-            });
-        }
-    }
-    /**
-     * 파일 읽기 (UTF-8 문자열)
-     */
-    static async readFileStringAsync(filePath) {
-        const result = await FileSystemPlugin.readFile({ path: filePath, encoding: "utf8" });
-        return result.data;
-    }
-    /**
-     * 파일 읽기 (Buffer)
-     */
-    static async readFileBufferAsync(filePath) {
-        const result = await FileSystemPlugin.readFile({ path: filePath, encoding: "base64" });
-        return Buffer.from(result.data, "base64");
-    }
-    /**
-     * 파일/디렉토리 삭제 (재귀)
-     */
-    static async removeAsync(targetPath) {
-        await FileSystemPlugin.remove({ path: targetPath });
-    }
-    /**
-     * 디렉토리 생성 (재귀)
-     */
-    static async mkdirsAsync(targetPath) {
-        await FileSystemPlugin.mkdir({ path: targetPath });
-    }
-    /**
-     * 존재 여부 확인
-     */
-    static async existsAsync(targetPath) {
-        const result = await FileSystemPlugin.exists({ path: targetPath });
-        return result.exists;
+class FileSystem {
+  /**
+   * 권한 확인
+   */
+  static async hasPermission() {
+    const result = await FileSystemPlugin.hasPermission();
+    return result.granted;
+  }
+  /**
+   * 권한 요청
+   * - Android 11+: 설정 화면으로 이동
+   * - Android 10-: 권한 다이얼로그 표시
+   */
+  static async requestPermission() {
+    await FileSystemPlugin.requestPermission();
+  }
+  /**
+   * 디렉토리 읽기
+   */
+  static async readdir(dirPath) {
+    const result = await FileSystemPlugin.readdir({ path: dirPath });
+    return result.files;
+  }
+  /**
+   * 저장소 경로 얻기
+   * @param type 저장소 타입
+   * - external: 외부 저장소 루트 (Environment.getExternalStorageDirectory)
+   * - externalFiles: 앱 전용 외부 파일 디렉토리
+   * - externalCache: 앱 전용 외부 캐시 디렉토리
+   * - externalMedia: 앱 전용 외부 미디어 디렉토리
+   * - appData: 앱 데이터 디렉토리
+   * - appFiles: 앱 파일 디렉토리
+   * - appCache: 앱 캐시 디렉토리
+   */
+  static async getStoragePath(type) {
+    const result = await FileSystemPlugin.getStoragePath({ type });
+    return result.path;
+  }
+  /**
+   * 파일 URI 얻기 (FileProvider)
+   */
+  static async getFileUri(filePath) {
+    const result = await FileSystemPlugin.getFileUri({ path: filePath });
+    return result.uri;
+  }
+  /**
+   * 파일 쓰기
+   */
+  static async writeFile(filePath, data) {
+    if (typeof data !== "string") {
+      await FileSystemPlugin.writeFile({
+        path: filePath,
+        data: bytesToBase64(data),
+        encoding: "base64"
+      });
+    } else {
+      await FileSystemPlugin.writeFile({
+        path: filePath,
+        data,
+        encoding: "utf8"
+      });
     }
+  }
+  /**
+   * 파일 읽기 (UTF-8 문자열)
+   */
+  static async readFileString(filePath) {
+    const result = await FileSystemPlugin.readFile({ path: filePath, encoding: "utf8" });
+    return result.data;
+  }
+  /**
+   * 파일 읽기 (Bytes)
+   */
+  static async readFileBytes(filePath) {
+    const result = await FileSystemPlugin.readFile({ path: filePath, encoding: "base64" });
+    return bytesFromBase64(result.data);
+  }
+  /**
+   * 파일/디렉토리 삭제 (재귀)
+   */
+  static async remove(targetPath) {
+    await FileSystemPlugin.remove({ path: targetPath });
+  }
+  /**
+   * 디렉토리 생성 (재귀)
+   */
+  static async mkdir(targetPath) {
+    await FileSystemPlugin.mkdir({ path: targetPath });
+  }
+  /**
+   * 존재 여부 확인
+   */
+  static async exists(targetPath) {
+    const result = await FileSystemPlugin.exists({ path: targetPath });
+    return result.exists;
+  }
 }
+export {
+  FileSystem
+};
+//# sourceMappingURL=FileSystem.js.map

package/dist/FileSystem.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/FileSystem.ts"],
+  "sourcesContent": ["import { registerPlugin } from \"@capacitor/core\";\nimport type { IFileInfo, IFileSystemPlugin, TStorage } from \"./IFileSystemPlugin\";\nimport type { Bytes } from \"@simplysm/core-common\";\nimport { bytesToBase64, bytesFromBase64 } from \"@simplysm/core-common\";\n\nconst FileSystemPlugin = registerPlugin<IFileSystemPlugin>(\"FileSystem\", {\n  web: async () => {\n    const { FileSystemWeb } = await import(\"./web/FileSystemWeb\");\n    return new FileSystemWeb();\n  },\n});\n\n/**\n * \uD30C\uC77C \uC2DC\uC2A4\uD15C \uC811\uADFC \uD50C\uB7EC\uADF8\uC778\n * - Android 11+: MANAGE_EXTERNAL_STORAGE \uAD8C\uD55C\uC73C\uB85C \uC804\uCCB4 \uD30C\uC77C \uC2DC\uC2A4\uD15C \uC811\uADFC\n * - Android 10-: READ/WRITE_EXTERNAL_STORAGE \uAD8C\uD55C\n * - Browser: IndexedDB \uAE30\uBC18 \uC5D0\uBBAC\uB808\uC774\uC158\n */\nexport abstract class FileSystem {\n  /**\n   * \uAD8C\uD55C \uD655\uC778\n   */\n  static async hasPermission(): Promise<boolean> {\n    const result = await FileSystemPlugin.hasPermission();\n    return result.granted;\n  }\n\n  /**\n   * \uAD8C\uD55C \uC694\uCCAD\n   * - Android 11+: \uC124\uC815 \uD654\uBA74\uC73C\uB85C \uC774\uB3D9\n   * - Android 10-: \uAD8C\uD55C \uB2E4\uC774\uC5BC\uB85C\uADF8 \uD45C\uC2DC\n   */\n  static async requestPermission(): Promise<void> {\n    await FileSystemPlugin.requestPermission();\n  }\n\n  /**\n   * \uB514\uB809\uD1A0\uB9AC \uC77D\uAE30\n   */\n  static async readdir(dirPath: string): Promise<IFileInfo[]> {\n    const result = await FileSystemPlugin.readdir({ path: dirPath });\n    return result.files;\n  }\n\n  /**\n   * \uC800\uC7A5\uC18C \uACBD\uB85C \uC5BB\uAE30\n   * @param type \uC800\uC7A5\uC18C \uD0C0\uC785\n   * - external: \uC678\uBD80 \uC800\uC7A5\uC18C \uB8E8\uD2B8 (Environment.getExternalStorageDirectory)\n   * - externalFiles: \uC571 \uC804\uC6A9 \uC678\uBD80 \uD30C\uC77C \uB514\uB809\uD1A0\uB9AC\n   * - externalCache: \uC571 \uC804\uC6A9 \uC678\uBD80 \uCE90\uC2DC \uB514\uB809\uD1A0\uB9AC\n   * - externalMedia: \uC571 \uC804\uC6A9 \uC678\uBD80 \uBBF8\uB514\uC5B4 \uB514\uB809\uD1A0\uB9AC\n   * - appData: \uC571 \uB370\uC774\uD130 \uB514\uB809\uD1A0\uB9AC\n   * - appFiles: \uC571 \uD30C\uC77C \uB514\uB809\uD1A0\uB9AC\n   * - appCache: \uC571 \uCE90\uC2DC \uB514\uB809\uD1A0\uB9AC\n   */\n  static async getStoragePath(type: TStorage): Promise<string> {\n    const result = await FileSystemPlugin.getStoragePath({ type });\n    return result.path;\n  }\n\n  /**\n   * \uD30C\uC77C URI \uC5BB\uAE30 (FileProvider)\n   */\n  static async getFileUri(filePath: string): Promise<string> {\n    const result = await FileSystemPlugin.getFileUri({ path: filePath });\n    return result.uri;\n  }\n\n  /**\n   * \uD30C\uC77C \uC4F0\uAE30\n   */\n  static async writeFile(filePath: string, data: string | Bytes): Promise<void> {\n    if (typeof data !== \"string\") {\n      // Bytes (Uint8Array) - cross-realm \uD658\uACBD\uC5D0\uC11C\uB3C4 \uC548\uC804\uD558\uAC8C \uB3D9\uC791\n      await FileSystemPlugin.writeFile({\n        path: filePath,\n        data: bytesToBase64(data),\n        encoding: \"base64\",\n      });\n    } else {\n      await FileSystemPlugin.writeFile({\n        path: filePath,\n        data,\n        encoding: \"utf8\",\n      });\n    }\n  }\n\n  /**\n   * \uD30C\uC77C \uC77D\uAE30 (UTF-8 \uBB38\uC790\uC5F4)\n   */\n  static async readFileString(filePath: string): Promise<string> {\n    const result = await FileSystemPlugin.readFile({ path: filePath, encoding: \"utf8\" });\n    return result.data;\n  }\n\n  /**\n   * \uD30C\uC77C \uC77D\uAE30 (Bytes)\n   */\n  static async readFileBytes(filePath: string): Promise<Bytes> {\n    const result = await FileSystemPlugin.readFile({ path: filePath, encoding: \"base64\" });\n    return bytesFromBase64(result.data);\n  }\n\n  /**\n   * \uD30C\uC77C/\uB514\uB809\uD1A0\uB9AC \uC0AD\uC81C (\uC7AC\uADC0)\n   */\n  static async remove(targetPath: string): Promise<void> {\n    await FileSystemPlugin.remove({ path: targetPath });\n  }\n\n  /**\n   * \uB514\uB809\uD1A0\uB9AC \uC0DD\uC131 (\uC7AC\uADC0)\n   */\n  static async mkdir(targetPath: string): Promise<void> {\n    await FileSystemPlugin.mkdir({ path: targetPath });\n  }\n\n  /**\n   * \uC874\uC7AC \uC5EC\uBD80 \uD655\uC778\n   */\n  static async exists(targetPath: string): Promise<boolean> {\n    const result = await FileSystemPlugin.exists({ path: targetPath });\n    return result.exists;\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,sBAAsB;AAG/B,SAAS,eAAe,uBAAuB;AAE/C,MAAM,mBAAmB,eAAkC,cAAc;AAAA,EACvE,KAAK,YAAY;AACf,UAAM,EAAE,cAAc,IAAI,MAAM,OAAO,qBAAqB;AAC5D,WAAO,IAAI,cAAc;AAAA,EAC3B;AACF,CAAC;AAQM,MAAe,WAAW;AAAA;AAAA;AAAA;AAAA,EAI/B,aAAa,gBAAkC;AAC7C,UAAM,SAAS,MAAM,iBAAiB,cAAc;AACpD,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,oBAAmC;AAC9C,UAAM,iBAAiB,kBAAkB;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,QAAQ,SAAuC;AAC1D,UAAM,SAAS,MAAM,iBAAiB,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC/D,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,aAAa,eAAe,MAAiC;AAC3D,UAAM,SAAS,MAAM,iBAAiB,eAAe,EAAE,KAAK,CAAC;AAC7D,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,WAAW,UAAmC;AACzD,UAAM,SAAS,MAAM,iBAAiB,WAAW,EAAE,MAAM,SAAS,CAAC;AACnE,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,UAAU,UAAkB,MAAqC;AAC5E,QAAI,OAAO,SAAS,UAAU;AAE5B,YAAM,iBAAiB,UAAU;AAAA,QAC/B,MAAM;AAAA,QACN,MAAM,cAAc,IAAI;AAAA,QACxB,UAAU;AAAA,MACZ,CAAC;AAAA,IACH,OAAO;AACL,YAAM,iBAAiB,UAAU;AAAA,QAC/B,MAAM;AAAA,QACN;AAAA,QACA,UAAU;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,eAAe,UAAmC;AAC7D,UAAM,SAAS,MAAM,iBAAiB,SAAS,EAAE,MAAM,UAAU,UAAU,OAAO,CAAC;AACnF,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,cAAc,UAAkC;AAC3D,UAAM,SAAS,MAAM,iBAAiB,SAAS,EAAE,MAAM,UAAU,UAAU,SAAS,CAAC;AACrF,WAAO,gBAAgB,OAAO,IAAI;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,OAAO,YAAmC;AACrD,UAAM,iBAAiB,OAAO,EAAE,MAAM,WAAW,CAAC;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,MAAM,YAAmC;AACpD,UAAM,iBAAiB,MAAM,EAAE,MAAM,WAAW,CAAC;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,OAAO,YAAsC;AACxD,UAAM,SAAS,MAAM,iBAAiB,OAAO,EAAE,MAAM,WAAW,CAAC;AACjE,WAAO,OAAO;AAAA,EAChB;AACF;",
+  "names": []
+}

package/dist/IFileSystemPlugin.js

@@ -1 +1 @@
-export {};
+//# sourceMappingURL=IFileSystemPlugin.js.map

package/dist/IFileSystemPlugin.js.map

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

package/dist/{FileSystem.d.ts → capacitor-plugin-file-system/src/FileSystem.d.ts}

@@ -1,4 +1,5 @@
-import { IFileInfo, TStorage } from "./IFileSystemPlugin";
+import type { IFileInfo, TStorage } from "./IFileSystemPlugin";
+import type { Bytes } from "@simplysm/core-common";
 /**
  * 파일 시스템 접근 플러그인
  * - Android 11+: MANAGE_EXTERNAL_STORAGE 권한으로 전체 파일 시스템 접근
@@ -9,17 +10,17 @@ export declare abstract class FileSystem {
     /**
      * 권한 확인
      */
-    static checkPermissionAsync(): Promise<boolean>;
+    static hasPermission(): Promise<boolean>;
     /**
      * 권한 요청
      * - Android 11+: 설정 화면으로 이동
      * - Android 10-: 권한 다이얼로그 표시
      */
-    static requestPermissionAsync(): Promise<void>;
+    static requestPermission(): Promise<void>;
     /**
      * 디렉토리 읽기
      */
-    static readdirAsync(dirPath: string): Promise<IFileInfo[]>;
+    static readdir(dirPath: string): Promise<IFileInfo[]>;
     /**
      * 저장소 경로 얻기
      * @param type 저장소 타입
@@ -31,33 +32,34 @@ export declare abstract class FileSystem {
      * - appFiles: 앱 파일 디렉토리
      * - appCache: 앱 캐시 디렉토리
      */
-    static getStoragePathAsync(type: TStorage): Promise<string>;
+    static getStoragePath(type: TStorage): Promise<string>;
     /**
      * 파일 URI 얻기 (FileProvider)
      */
-    static getFileUriAsync(filePath: string): Promise<string>;
+    static getFileUri(filePath: string): Promise<string>;
     /**
      * 파일 쓰기
      */
-    static writeFileAsync(filePath: string, data: string | Buffer): Promise<void>;
+    static writeFile(filePath: string, data: string | Bytes): Promise<void>;
     /**
      * 파일 읽기 (UTF-8 문자열)
      */
-    static readFileStringAsync(filePath: string): Promise<string>;
+    static readFileString(filePath: string): Promise<string>;
     /**
-     * 파일 읽기 (Buffer)
+     * 파일 읽기 (Bytes)
      */
-    static readFileBufferAsync(filePath: string): Promise<Buffer>;
+    static readFileBytes(filePath: string): Promise<Bytes>;
     /**
      * 파일/디렉토리 삭제 (재귀)
      */
-    static removeAsync(targetPath: string): Promise<void>;
+    static remove(targetPath: string): Promise<void>;
     /**
      * 디렉토리 생성 (재귀)
      */
-    static mkdirsAsync(targetPath: string): Promise<void>;
+    static mkdir(targetPath: string): Promise<void>;
     /**
      * 존재 여부 확인
      */
-    static existsAsync(targetPath: string): Promise<boolean>;
+    static exists(targetPath: string): Promise<boolean>;
 }
+//# sourceMappingURL=FileSystem.d.ts.map

package/dist/capacitor-plugin-file-system/src/FileSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../../src/FileSystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAqB,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAUnD;;;;;GAKG;AACH,8BAAsB,UAAU;IAC9B;;OAEG;WACU,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAK9C;;;;OAIG;WACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;WACU,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAK3D;;;;;;;;;;OAUG;WACU,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D;;OAEG;WACU,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D;;OAEG;WACU,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7E;;OAEG;WACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9D;;OAEG;WACU,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAK5D;;OAEG;WACU,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;OAEG;WACU,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;OAEG;WACU,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAI1D"}

package/dist/{IFileSystemPlugin.d.ts → capacitor-plugin-file-system/src/IFileSystemPlugin.d.ts}

@@ -4,7 +4,7 @@ export interface IFileInfo {
     isDirectory: boolean;
 }
 export interface IFileSystemPlugin {
-    checkPermission(): Promise<{
+    hasPermission(): Promise<{
         granted: boolean;
     }>;
     requestPermission(): Promise<void>;
@@ -46,3 +46,4 @@ export interface IFileSystemPlugin {
         exists: boolean;
     }>;
 }
+//# sourceMappingURL=IFileSystemPlugin.d.ts.map

package/dist/capacitor-plugin-file-system/src/IFileSystemPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFileSystemPlugin.d.ts","sourceRoot":"","sources":["../../../src/IFileSystemPlugin.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,eAAe,GACf,eAAe,GACf,eAAe,GACf,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC,CAAC;IACpE,cAAc,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,UAAU,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,SAAS,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChG,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,MAAM,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACjE"}

package/dist/{index.d.ts → capacitor-plugin-file-system/src/index.d.ts}

@@ -1,2 +1,3 @@
 export * from "./FileSystem";
 export * from "./IFileSystemPlugin";
+//# sourceMappingURL=index.d.ts.map

package/dist/capacitor-plugin-file-system/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}

package/dist/{web → capacitor-plugin-file-system/src/web}/FileSystemWeb.d.ts

@@ -1,8 +1,10 @@
 import { WebPlugin } from "@capacitor/core";
-import { IFileInfo, IFileSystemPlugin, TStorage } from "../IFileSystemPlugin";
+import type { IFileInfo, IFileSystemPlugin, TStorage } from "../IFileSystemPlugin";
 export declare class FileSystemWeb extends WebPlugin implements IFileSystemPlugin {
     private readonly _fs;
-    checkPermission(): Promise<{
+    private readonly _textEncoder;
+    private readonly _textDecoder;
+    hasPermission(): Promise<{
         granted: boolean;
     }>;
     requestPermission(): Promise<void>;
@@ -16,6 +18,11 @@ export declare class FileSystemWeb extends WebPlugin implements IFileSystemPlugi
     }): Promise<{
         path: string;
     }>;
+    /**
+     * 파일의 Blob URL을 반환합니다.
+     * @warning 반환된 URI는 사용 후 반드시 `URL.revokeObjectURL(uri)`를 호출하여 해제해야 합니다.
+     * 해제하지 않으면 메모리 누수가 발생할 수 있습니다.
+     */
     getFileUri(options: {
         path: string;
     }): Promise<{
@@ -44,3 +51,4 @@ export declare class FileSystemWeb extends WebPlugin implements IFileSystemPlugi
         exists: boolean;
     }>;
 }
+//# sourceMappingURL=FileSystemWeb.d.ts.map

package/dist/capacitor-plugin-file-system/src/web/FileSystemWeb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemWeb.d.ts","sourceRoot":"","sources":["../../../../src/web/FileSystemWeb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAInF,qBAAa,aAAc,SAAQ,SAAU,YAAW,iBAAiB;IACvE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqD;IACzE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAE5C,aAAa,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAI9C,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC,OAAO,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IASnE,cAAc,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAgC5E;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAU/D,SAAS,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/F,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAU5F,MAAM,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,KAAK,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,MAAM,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAItE"}