@simplysm/capacitor-plugin-file-system 13.0.75 → 13.0.77

package/README.md

@@ -22,22 +22,22 @@ An abstract class that provides static methods for file system access via the Ca
 import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
 ```
 
-#### `FileSystem.hasPermission()`
+#### `FileSystem.checkPermissions()`
 
 Checks whether the required file system permission has been granted.
 
 ```typescript
-static async hasPermission(): Promise<boolean>
+static async checkPermissions(): Promise<boolean>
 ```
 
 ```typescript
-const granted = await FileSystem.hasPermission();
+const granted = await FileSystem.checkPermissions();
 if (!granted) {
-  await FileSystem.requestPermission();
+  await FileSystem.requestPermissions();
 }
 ```
 
-#### `FileSystem.requestPermission()`
+#### `FileSystem.requestPermissions()`
 
 Requests the required file system permission.
 
@@ -45,19 +45,19 @@ Requests the required file system permission.
 - Android 10 and below: Shows the OS permission dialog.
 
 ```typescript
-static async requestPermission(): Promise<void>
+static async requestPermissions(): Promise<void>
 ```
 
 ```typescript
-await FileSystem.requestPermission();
+await FileSystem.requestPermissions();
 ```
 
 #### `FileSystem.readdir(dirPath)`
 
-Reads the contents of a directory and returns an array of `IFileInfo` objects.
+Reads the contents of a directory and returns an array of `FileInfo` objects.
 
 ```typescript
-static async readdir(dirPath: string): Promise<IFileInfo[]>
+static async readdir(dirPath: string): Promise<FileInfo[]>
 ```
 
 ```typescript
@@ -72,34 +72,34 @@ for (const entry of entries) {
 Returns the absolute path for the given storage type.
 
 ```typescript
-static async getStoragePath(type: TStorage): Promise<string>
+static async getStoragePath(type: StorageType): Promise<string>
 ```
 
-| `type` value     | Description                                                   |
-|------------------|---------------------------------------------------------------|
-| `"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                                           |
+| `type` value      | Description                                                        |
+|-------------------|--------------------------------------------------------------------|
+| `"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                                                |
 
 ```typescript
 const path = await FileSystem.getStoragePath("external");
 console.log(path); // e.g. "/storage/emulated/0"
 ```
 
-#### `FileSystem.getFileUri(filePath)`
+#### `FileSystem.getUri(filePath)`
 
 Returns a `FileProvider` URI for the given file path. Required for sharing files with other apps on Android.
 
 ```typescript
-static async getFileUri(filePath: string): Promise<string>
+static async getUri(filePath: string): Promise<string>
 ```
 
 ```typescript
-const uri = await FileSystem.getFileUri("/storage/emulated/0/Download/report.pdf");
+const uri = await FileSystem.getUri("/storage/emulated/0/Download/report.pdf");
 console.log(uri); // content://...
 ```
 
@@ -120,30 +120,23 @@ const bytes: Uint8Array = new Uint8Array([0x89, 0x50, 0x4e, 0x47]);
 await FileSystem.writeFile("/storage/emulated/0/Download/image.png", bytes);
 ```
 
-#### `FileSystem.readFileString(filePath)`
+#### `FileSystem.readFile(filePath)`
 
-Reads a file as a UTF-8 string.
+Reads a file. When called without an encoding argument, returns a `Bytes` (`Uint8Array`) value. When called with `"utf8"`, returns a UTF-8 string.
 
 ```typescript
-static async readFileString(filePath: string): Promise<string>
+static async readFile(filePath: string): Promise<Bytes>
+static async readFile(filePath: string, encoding: "utf8"): Promise<string>
 ```
 
 ```typescript
-const text = await FileSystem.readFileString("/storage/emulated/0/Download/hello.txt");
-console.log(text);
-```
-
-#### `FileSystem.readFileBytes(filePath)`
-
-Reads a file as a `Bytes` (`Uint8Array`) value.
-
-```typescript
-static async readFileBytes(filePath: string): Promise<Bytes>
-```
-
-```typescript
-const bytes = await FileSystem.readFileBytes("/storage/emulated/0/Download/image.png");
+// Read as bytes
+const bytes = await FileSystem.readFile("/storage/emulated/0/Download/image.png");
 console.log(bytes.length);
+
+// Read as string
+const text = await FileSystem.readFile("/storage/emulated/0/Download/hello.txt", "utf8");
+console.log(text);
 ```
 
 #### `FileSystem.remove(targetPath)`
@@ -185,14 +178,14 @@ console.log(exists); // true or false
 
 ## Types
 
-### `TStorage`
+### `StorageType`
 
 Union type representing supported storage location identifiers used with `FileSystem.getStoragePath()`.
 
 ```typescript
-import { type TStorage } from "@simplysm/capacitor-plugin-file-system";
+import { type StorageType } from "@simplysm/capacitor-plugin-file-system";
 
-type TStorage =
+type StorageType =
   | "external"
   | "externalFiles"
   | "externalCache"
@@ -202,32 +195,32 @@ type TStorage =
   | "appCache";
 ```
 
-### `IFileInfo`
+### `FileInfo`
 
 Represents a single entry returned by `FileSystem.readdir()`.
 
 ```typescript
-import { type IFileInfo } from "@simplysm/capacitor-plugin-file-system";
+import { type FileInfo } from "@simplysm/capacitor-plugin-file-system";
 
-interface IFileInfo {
+interface FileInfo {
   name: string;        // File or directory name
   isDirectory: boolean; // true if the entry is a directory
 }
 ```
 
-### `IFileSystemPlugin`
+### `FileSystemPlugin`
 
 The low-level plugin interface registered with Capacitor. Used internally by `FileSystem`. Direct use is not required in most cases.
 
 ```typescript
-import { type IFileSystemPlugin } from "@simplysm/capacitor-plugin-file-system";
+import { type FileSystemPlugin } from "@simplysm/capacitor-plugin-file-system";
 
-interface IFileSystemPlugin {
-  hasPermission(): Promise<{ granted: boolean }>;
-  requestPermission(): Promise<void>;
-  readdir(options: { path: string }): Promise<{ files: IFileInfo[] }>;
-  getStoragePath(options: { type: TStorage }): Promise<{ path: string }>;
-  getFileUri(options: { path: string }): Promise<{ uri: string }>;
+interface FileSystemPlugin {
+  checkPermissions(): Promise<{ granted: boolean }>;
+  requestPermissions(): Promise<void>;
+  readdir(options: { path: string }): Promise<{ files: FileInfo[] }>;
+  getStoragePath(options: { type: StorageType }): Promise<{ path: string }>;
+  getUri(options: { path: string }): Promise<{ uri: string }>;
   writeFile(options: { path: string; data: string; encoding?: "utf8" | "base64" }): Promise<void>;
   readFile(options: { path: string; encoding?: "utf8" | "base64" }): Promise<{ data: string }>;
   remove(options: { path: string }): Promise<void>;

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

@@ -32,7 +32,7 @@ public class FileSystemPlugin extends Plugin {
     private static final int PERMISSION_REQUEST_CODE = 1001;
 
     @PluginMethod
-    public void hasPermission(PluginCall call) {
+    public void checkPermissions(PluginCall call) {
         boolean granted;
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
             granted = Environment.isExternalStorageManager();
@@ -47,7 +47,7 @@ public class FileSystemPlugin extends Plugin {
     }
 
     @PluginMethod
-    public void requestPermission(PluginCall call) {
+    public void requestPermissions(PluginCall call) {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
             if (!Environment.isExternalStorageManager()) {
                 Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
@@ -155,7 +155,7 @@ public class FileSystemPlugin extends Plugin {
     }
 
     @PluginMethod
-    public void getFileUri(PluginCall call) {
+    public void getUri(PluginCall call) {
         String path = call.getString("path");
         if (path == null) {
             call.reject("path is required");
@@ -169,8 +169,8 @@ public class FileSystemPlugin extends Plugin {
             ret.put("uri", uri.toString());
             call.resolve(ret);
         } catch (Exception e) {
-            Log.e(TAG, "getFileUri failed", e);
-            call.reject("getFileUri failed: " + e.getMessage());
+            Log.e(TAG, "getUri failed", e);
+            call.reject("getUri failed: " + e.getMessage());
         }
     }
 

package/dist/FileSystem.d.ts

@@ -1,4 +1,4 @@
-import type { IFileInfo, TStorage } from "./IFileSystemPlugin";
+import type { FileInfo, StorageType } from "./FileSystemPlugin";
 import type { Bytes } from "@simplysm/core-common";
 /**
  * File system access plugin
@@ -10,17 +10,17 @@ export declare abstract class FileSystem {
     /**
      * Check permission
      */
-    static hasPermission(): Promise<boolean>;
+    static checkPermissions(): Promise<boolean>;
     /**
      * Request permission
      * - Android 11+: Navigate to settings
      * - Android 10-: Show permission dialog
      */
-    static requestPermission(): Promise<void>;
+    static requestPermissions(): Promise<void>;
     /**
      * Read directory
      */
-    static readdir(dirPath: string): Promise<IFileInfo[]>;
+    static readdir(dirPath: string): Promise<FileInfo[]>;
     /**
      * Get storage path
      * @param type Storage type
@@ -32,23 +32,20 @@ export declare abstract class FileSystem {
      * - appFiles: App files directory
      * - appCache: App cache directory
      */
-    static getStoragePath(type: TStorage): Promise<string>;
+    static getStoragePath(type: StorageType): Promise<string>;
     /**
      * Get file URI (FileProvider)
      */
-    static getFileUri(filePath: string): Promise<string>;
+    static getUri(filePath: string): Promise<string>;
     /**
      * Write file
      */
     static writeFile(filePath: string, data: string | Bytes): Promise<void>;
     /**
-     * Read file (UTF-8 string)
+     * Read file (default: Bytes, with encoding "utf8": string)
      */
-    static readFileString(filePath: string): Promise<string>;
-    /**
-     * Read file (Bytes)
-     */
-    static readFileBytes(filePath: string): Promise<Bytes>;
+    static readFile(filePath: string): Promise<Bytes>;
+    static readFile(filePath: string, encoding: "utf8"): Promise<string>;
     /**
      * Delete file/directory (recursive)
      */

package/dist/FileSystem.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["..\\src\\FileSystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAoB,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAUnD;;;;;GAKG;AACH,8BAAsB,UAAU;IAC9B;;OAEG;WACU,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKjD;;;;OAIG;WACU,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;WACU,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK1D;;;;;;;;;;OAUG;WACU,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D;;OAEG;WACU,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtD;;OAEG;WACU,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7E;;OAEG;WACU,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;WAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW1E;;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/FileSystem.js

@@ -1,6 +1,6 @@
 import { registerPlugin } from "@capacitor/core";
-import { bytesToBase64, bytesFromBase64 } from "@simplysm/core-common";
-const FileSystemPlugin = registerPlugin("FileSystem", {
+import { bytes } from "@simplysm/core-common";
+const fileSystemPlugin = registerPlugin("FileSystem", {
   web: async () => {
     const { FileSystemWeb } = await import("./web/FileSystemWeb");
     return new FileSystemWeb();
@@ -10,8 +10,8 @@ class FileSystem {
   /**
    * Check permission
    */
-  static async hasPermission() {
-    const result = await FileSystemPlugin.hasPermission();
+  static async checkPermissions() {
+    const result = await fileSystemPlugin.checkPermissions();
     return result.granted;
   }
   /**
@@ -19,14 +19,14 @@ class FileSystem {
    * - Android 11+: Navigate to settings
    * - Android 10-: Show permission dialog
    */
-  static async requestPermission() {
-    await FileSystemPlugin.requestPermission();
+  static async requestPermissions() {
+    await fileSystemPlugin.requestPermissions();
   }
   /**
    * Read directory
    */
   static async readdir(dirPath) {
-    const result = await FileSystemPlugin.readdir({ path: dirPath });
+    const result = await fileSystemPlugin.readdir({ path: dirPath });
     return result.files;
   }
   /**
@@ -41,14 +41,14 @@ class FileSystem {
    * - appCache: App cache directory
    */
   static async getStoragePath(type) {
-    const result = await FileSystemPlugin.getStoragePath({ type });
+    const result = await fileSystemPlugin.getStoragePath({ type });
     return result.path;
   }
   /**
    * Get file URI (FileProvider)
    */
-  static async getFileUri(filePath) {
-    const result = await FileSystemPlugin.getFileUri({ path: filePath });
+  static async getUri(filePath) {
+    const result = await fileSystemPlugin.getUri({ path: filePath });
     return result.uri;
   }
   /**
@@ -56,50 +56,45 @@ class FileSystem {
    */
   static async writeFile(filePath, data) {
     if (typeof data !== "string") {
-      await FileSystemPlugin.writeFile({
+      await fileSystemPlugin.writeFile({
         path: filePath,
-        data: bytesToBase64(data),
+        data: bytes.toBase64(data),
         encoding: "base64"
       });
     } else {
-      await FileSystemPlugin.writeFile({
+      await fileSystemPlugin.writeFile({
         path: filePath,
         data,
         encoding: "utf8"
       });
     }
   }
-  /**
-   * Read file (UTF-8 string)
-   */
-  static async readFileString(filePath) {
-    const result = await FileSystemPlugin.readFile({ path: filePath, encoding: "utf8" });
-    return result.data;
-  }
-  /**
-   * Read file (Bytes)
-   */
-  static async readFileBytes(filePath) {
-    const result = await FileSystemPlugin.readFile({ path: filePath, encoding: "base64" });
-    return bytesFromBase64(result.data);
+  static async readFile(filePath, encoding) {
+    if (encoding === "utf8") {
+      const result = await fileSystemPlugin.readFile({ path: filePath, encoding: "utf8" });
+      return result.data;
+    } else {
+      const result = await fileSystemPlugin.readFile({ path: filePath, encoding: "base64" });
+      return bytes.fromBase64(result.data);
+    }
   }
   /**
    * Delete file/directory (recursive)
    */
   static async remove(targetPath) {
-    await FileSystemPlugin.remove({ path: targetPath });
+    await fileSystemPlugin.remove({ path: targetPath });
   }
   /**
    * Create directory (recursive)
    */
   static async mkdir(targetPath) {
-    await FileSystemPlugin.mkdir({ path: targetPath });
+    await fileSystemPlugin.mkdir({ path: targetPath });
   }
   /**
    * Check existence
    */
   static async exists(targetPath) {
-    const result = await FileSystemPlugin.exists({ path: targetPath });
+    const result = await fileSystemPlugin.exists({ path: targetPath });
     return result.exists;
   }
 }

package/dist/FileSystem.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/FileSystem.ts"],
-  "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;",
+  "mappings": "AAAA,SAAS,sBAAsB;AAG/B,SAAS,aAAa;AAEtB,MAAM,mBAAmB,eAAiC,cAAc;AAAA,EACtE,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,mBAAqC;AAChD,UAAM,SAAS,MAAM,iBAAiB,iBAAiB;AACvD,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,qBAAoC;AAC/C,UAAM,iBAAiB,mBAAmB;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,QAAQ,SAAsC;AACzD,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,MAAoC;AAC9D,UAAM,SAAS,MAAM,iBAAiB,eAAe,EAAE,KAAK,CAAC;AAC7D,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,OAAO,UAAmC;AACrD,UAAM,SAAS,MAAM,iBAAiB,OAAO,EAAE,MAAM,SAAS,CAAC;AAC/D,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,MAAM,SAAS,IAAI;AAAA,QACzB,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,EAOA,aAAa,SAAS,UAAkB,UAA4C;AAClF,QAAI,aAAa,QAAQ;AACvB,YAAM,SAAS,MAAM,iBAAiB,SAAS,EAAE,MAAM,UAAU,UAAU,OAAO,CAAC;AACnF,aAAO,OAAO;AAAA,IAChB,OAAO;AACL,YAAM,SAAS,MAAM,iBAAiB,SAAS,EAAE,MAAM,UAAU,UAAU,SAAS,CAAC;AACrF,aAAO,MAAM,WAAW,OAAO,IAAI;AAAA,IACrC;AAAA,EACF;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.d.ts → FileSystemPlugin.d.ts}

@@ -1,24 +1,24 @@
-export type TStorage = "external" | "externalFiles" | "externalCache" | "externalMedia" | "appData" | "appFiles" | "appCache";
-export interface IFileInfo {
+export type StorageType = "external" | "externalFiles" | "externalCache" | "externalMedia" | "appData" | "appFiles" | "appCache";
+export interface FileInfo {
     name: string;
     isDirectory: boolean;
 }
-export interface IFileSystemPlugin {
-    hasPermission(): Promise<{
+export interface FileSystemPlugin {
+    checkPermissions(): Promise<{
         granted: boolean;
     }>;
-    requestPermission(): Promise<void>;
+    requestPermissions(): Promise<void>;
     readdir(options: {
         path: string;
     }): Promise<{
-        files: IFileInfo[];
+        files: FileInfo[];
     }>;
     getStoragePath(options: {
-        type: TStorage;
+        type: StorageType;
     }): Promise<{
         path: string;
     }>;
-    getFileUri(options: {
+    getUri(options: {
         path: string;
     }): Promise<{
         uri: string;
@@ -46,4 +46,4 @@ export interface IFileSystemPlugin {
         exists: boolean;
     }>;
 }
-//# sourceMappingURL=IFileSystemPlugin.d.ts.map
+//# sourceMappingURL=FileSystemPlugin.d.ts.map

package/dist/FileSystemPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemPlugin.d.ts","sourceRoot":"","sources":["..\\src\\FileSystemPlugin.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,eAAe,GACf,eAAe,GACf,eAAe,GACf,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClD,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC,CAAC;IACnE,cAAc,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,MAAM,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,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/FileSystemPlugin.js

@@ -0,0 +1 @@
+//# sourceMappingURL=FileSystemPlugin.js.map

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

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

package/dist/web/FileSystemWeb.d.ts

@@ -1,20 +1,20 @@
 import { WebPlugin } from "@capacitor/core";
-import type { IFileInfo, IFileSystemPlugin, TStorage } from "../IFileSystemPlugin";
-export declare class FileSystemWeb extends WebPlugin implements IFileSystemPlugin {
+import type { FileInfo, FileSystemPlugin, StorageType } from "../FileSystemPlugin";
+export declare class FileSystemWeb extends WebPlugin implements FileSystemPlugin {
     private readonly _fs;
     private readonly _textEncoder;
     private readonly _textDecoder;
-    hasPermission(): Promise<{
+    checkPermissions(): Promise<{
         granted: boolean;
     }>;
-    requestPermission(): Promise<void>;
+    requestPermissions(): Promise<void>;
     readdir(options: {
         path: string;
     }): Promise<{
-        files: IFileInfo[];
+        files: FileInfo[];
     }>;
     getStoragePath(options: {
-        type: TStorage;
+        type: StorageType;
     }): Promise<{
         path: string;
     }>;
@@ -23,7 +23,7 @@ export declare class FileSystemWeb extends WebPlugin implements IFileSystemPlugi
      * @warning The returned URI must be released by calling `URL.revokeObjectURL(uri)` after use.
      * Failure to release may cause memory leaks.
      */
-    getFileUri(options: {
+    getUri(options: {
         path: string;
     }): Promise<{
         uri: string;

package/dist/web/FileSystemWeb.d.ts.map

@@ -1 +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;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;KAC9B,GAAG,OAAO,CAAC,IAAI,CAAC;IAWX,QAAQ,CAAC,OAAO,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;KAC9B,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAYvB,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"}
+{"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,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAInF,qBAAa,aAAc,SAAQ,SAAU,YAAW,gBAAgB;IACtE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqD;IACzE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAE5C,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAIjD,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAEnC,OAAO,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IASlE,cAAc,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/E;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAU3D,SAAS,CAAC,OAAO,EAAE;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;KAC9B,GAAG,OAAO,CAAC,IAAI,CAAC;IAWX,QAAQ,CAAC,OAAO,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;KAC9B,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAYvB,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"}

package/dist/web/FileSystemWeb.js

@@ -1,14 +1,14 @@
 import { WebPlugin } from "@capacitor/core";
 import { VirtualFileSystem } from "./VirtualFileSystem.js";
-import { bytesToBase64, bytesFromBase64 } from "@simplysm/core-common";
+import { bytes } from "@simplysm/core-common";
 class FileSystemWeb extends WebPlugin {
   _fs = new VirtualFileSystem("capacitor_web_virtual_fs");
   _textEncoder = new TextEncoder();
   _textDecoder = new TextDecoder();
-  async hasPermission() {
+  async checkPermissions() {
     return Promise.resolve({ granted: true });
   }
-  async requestPermission() {
+  async requestPermissions() {
   }
   async readdir(options) {
     const entry = await this._fs.getEntry(options.path);
@@ -19,33 +19,7 @@ class FileSystemWeb extends WebPlugin {
     return { files };
   }
   async getStoragePath(options) {
-    const base = "/webfs";
-    let storagePath;
-    switch (options.type) {
-      case "external":
-        storagePath = base + "/external";
-        break;
-      case "externalFiles":
-        storagePath = base + "/externalFiles";
-        break;
-      case "externalCache":
-        storagePath = base + "/externalCache";
-        break;
-      case "externalMedia":
-        storagePath = base + "/externalMedia";
-        break;
-      case "appData":
-        storagePath = base + "/appData";
-        break;
-      case "appFiles":
-        storagePath = base + "/appFiles";
-        break;
-      case "appCache":
-        storagePath = base + "/appCache";
-        break;
-      default:
-        throw new Error("Unknown storage type: " + options.type);
-    }
+    const storagePath = "/webfs/" + options.type;
     await this._fs.ensureDir(storagePath);
     return { path: storagePath };
   }
@@ -54,20 +28,20 @@ class FileSystemWeb extends WebPlugin {
    * @warning The returned URI must be released by calling `URL.revokeObjectURL(uri)` after use.
    * Failure to release may cause memory leaks.
    */
-  async getFileUri(options) {
+  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);
     }
-    const bytes = bytesFromBase64(entry.dataBase64);
-    const blob = new Blob([bytes]);
+    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 : bytesToBase64(this._textEncoder.encode(options.data));
+    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) {
@@ -75,7 +49,7 @@ class FileSystemWeb extends WebPlugin {
     if (!entry || entry.kind !== "file" || entry.dataBase64 == null) {
       throw new Error("File not found: " + options.path);
     }
-    const data = options.encoding === "base64" ? entry.dataBase64 : this._textDecoder.decode(bytesFromBase64(entry.dataBase64));
+    const data = options.encoding === "base64" ? entry.dataBase64 : this._textDecoder.decode(bytes.fromBase64(entry.dataBase64));
     return { data };
   }
   async remove(options) {