@simplysm/capacitor-plugin-usb-storage 12.16.27 → 13.0.0-beta.10

package/README.md

@@ -0,0 +1,233 @@
+# @simplysm/capacitor-plugin-usb-storage
+
+A Capacitor plugin for accessing USB Mass Storage devices. On Android, it directly accesses the USB storage device's file system through the [libaums](https://github.com/magnusja/libaums) library, while in web environments it provides an IndexedDB-based virtual USB storage to support development and testing.
+
+## Installation
+
+```bash
+pnpm add @simplysm/capacitor-plugin-usb-storage
+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 | USB Mass Storage access through libaums 0.9.1 |
+| Web | Yes (emulation) | IndexedDB-based virtual USB storage |
+| iOS | No | -- |
+
+### Android Requirements
+
+- `compileSdk`: 35
+- `minSdk`: 23 (Android 6.0 or higher)
+- Maximum file read size: 100MB
+
+## Main API
+
+### UsbStorage (Static Class)
+
+The main entry point of the plugin. All methods are static and operate asynchronously.
+
+| Method | Return Type | Description |
+|--------|-----------|------|
+| `getDevices()` | `Promise<IUsbDeviceInfo[]>` | Retrieve list of connected USB devices |
+| `requestPermission(filter)` | `Promise<boolean>` | Request USB device access permission |
+| `hasPermission(filter)` | `Promise<boolean>` | Check if USB device access permission is granted |
+| `readdir(filter, dirPath)` | `Promise<IUsbFileInfo[]>` | Read list of files/folders in directory |
+| `read(filter, filePath)` | `Promise<Bytes \| undefined>` | Read file contents as binary |
+
+### Interfaces
+
+#### IUsbDeviceInfo
+
+Represents USB device information.
+
+| Property | Type | Description |
+|------|------|------|
+| `deviceName` | `string` | Device name (system path) |
+| `manufacturerName` | `string` | Manufacturer name |
+| `productName` | `string` | Product name |
+| `vendorId` | `number` | USB Vendor ID |
+| `productId` | `number` | USB Product ID |
+
+#### IUsbDeviceFilter
+
+A filter for identifying specific USB devices. Specifies the device using the combination of `vendorId` and `productId`.
+
+| Property | Type | Description |
+|------|------|------|
+| `vendorId` | `number` | USB Vendor ID |
+| `productId` | `number` | USB Product ID |
+
+#### IUsbFileInfo
+
+Represents file or directory information.
+
+| Property | Type | Description |
+|------|------|------|
+| `name` | `string` | File/directory name |
+| `isDirectory` | `boolean` | Whether it's a directory |
+
+## Usage Examples
+
+### List Devices and Request Permission
+
+```typescript
+import { UsbStorage } from "@simplysm/capacitor-plugin-usb-storage";
+
+// Retrieve connected USB device list
+const devices = await UsbStorage.getDevices();
+console.log("Connected devices:", devices);
+
+if (devices.length > 0) {
+  const device = devices[0];
+  const filter = { vendorId: device.vendorId, productId: device.productId };
+
+  // Check permission
+  const hasPerm = await UsbStorage.hasPermission(filter);
+  if (!hasPerm) {
+    // Request permission (displays system dialog on Android)
+    const granted = await UsbStorage.requestPermission(filter);
+    if (!granted) {
+      console.log("USB device access permission was denied.");
+      return;
+    }
+  }
+}
+```
+
+### Read Directory Contents
+
+```typescript
+import { UsbStorage } from "@simplysm/capacitor-plugin-usb-storage";
+
+const filter = { vendorId: 1234, productId: 5678 };
+
+// Read root directory
+const rootFiles = await UsbStorage.readdir(filter, "/");
+for (const file of rootFiles) {
+  const type = file.isDirectory ? "[DIR]" : "[FILE]";
+  console.log(`${type} ${file.name}`);
+}
+
+// Read subdirectory
+const subFiles = await UsbStorage.readdir(filter, "/Documents");
+```
+
+### Read File
+
+```typescript
+import { UsbStorage } from "@simplysm/capacitor-plugin-usb-storage";
+
+const filter = { vendorId: 1234, productId: 5678 };
+
+// Read file as binary (Bytes)
+const data = await UsbStorage.read(filter, "/data/config.json");
+if (data != null) {
+  // Convert Bytes to string
+  const text = new TextDecoder().decode(data);
+  console.log("File contents:", text);
+}
+```
+
+### Complete Flow Example
+
+```typescript
+import { UsbStorage } from "@simplysm/capacitor-plugin-usb-storage";
+import type { IUsbDeviceFilter } from "@simplysm/capacitor-plugin-usb-storage";
+
+async function readUsbFile(filePath: string): Promise<string | undefined> {
+  // 1. Search for device
+  const devices = await UsbStorage.getDevices();
+  if (devices.length === 0) {
+    throw new Error("No USB device is connected.");
+  }
+
+  const device = devices[0];
+  const filter: IUsbDeviceFilter = {
+    vendorId: device.vendorId,
+    productId: device.productId,
+  };
+
+  // 2. Secure permission
+  const hasPerm = await UsbStorage.hasPermission(filter);
+  if (!hasPerm) {
+    const granted = await UsbStorage.requestPermission(filter);
+    if (!granted) {
+      throw new Error("USB device access permission is required.");
+    }
+  }
+
+  // 3. Read file
+  const data = await UsbStorage.read(filter, filePath);
+  if (data == null) {
+    return undefined;
+  }
+
+  return new TextDecoder().decode(data);
+}
+```
+
+## Web Emulation (Development/Testing)
+
+In web environments, the `UsbStorageWeb` class is automatically used, providing an IndexedDB-based virtual USB storage. Permission requests are always processed as approved.
+
+`UsbStorageWeb` provides methods for adding virtual devices and files for development and testing purposes.
+
+| Method | Description |
+|--------|------|
+| `addVirtualDevice(device)` | Register a virtual USB device |
+| `addVirtualFile(filter, filePath, data)` | Add a file to virtual device (parent directories created automatically) |
+| `addVirtualDirectory(filter, dirPath)` | Add a directory to virtual device |
+
+### Web Emulation Usage Example
+
+```typescript
+import { UsbStorageWeb } from "@simplysm/capacitor-plugin-usb-storage/dist/web/UsbStorageWeb";
+
+const web = new UsbStorageWeb();
+
+// Add virtual device
+await web.addVirtualDevice({
+  vendorId: 1234,
+  productId: 5678,
+  deviceName: "Virtual USB",
+  manufacturerName: "Test Manufacturer",
+  productName: "Test USB Drive",
+});
+
+const filter = { vendorId: 1234, productId: 5678 };
+
+// Add virtual file
+const content = new TextEncoder().encode("Hello, USB!");
+await web.addVirtualFile(filter, "/test/hello.txt", content);
+
+// Add virtual directory
+await web.addVirtualDirectory(filter, "/test/subdir");
+```
+
+## Android Native Implementation Details
+
+The Android native layer uses the `libaums` library to directly handle the USB Mass Storage protocol. Key operations are as follows.
+
+- **Device Search**: Uses `UsbMassStorageDevice.getMassStorageDevices()` to query connected USB Mass Storage devices.
+- **Permission Management**: Requests and verifies USB device access permission through Android's `UsbManager`. On Android 12 (API 31) and above, it uses `PendingIntent.FLAG_MUTABLE`, and on Android 13 (API 33) and above, it applies the `RECEIVER_NOT_EXPORTED` flag.
+- **File System Access**: Mounts the file system of the first partition to perform directory navigation and file reading.
+- **Data Transfer**: File data is Base64-encoded for transmission to the JavaScript layer.
+
+## License
+
+MIT

package/android/src/main/java/kr/co/simplysm/capacitor/usbstorage/UsbStoragePlugin.java

@@ -32,6 +32,7 @@ public class UsbStoragePlugin extends Plugin {
 
     private static final String TAG = "UsbStoragePlugin";
     private static final String ACTION_USB_PERMISSION = "kr.co.simplysm.capacitor.usbstorage.USB_PERMISSION";
+    private static final long MAX_FILE_SIZE = 100L * 1024 * 1024; // 100MB
 
     @PluginMethod
     public void getDevices(PluginCall call) {
@@ -158,31 +159,37 @@ public class UsbStoragePlugin extends Plugin {
 
             UsbManager usbManager = (UsbManager) getContext().getSystemService(Context.USB_SERVICE);
             if (!usbManager.hasPermission(device.getUsbDevice())) {
-                call.reject("USB 장치에 대한 접근 권한이 없습니다.");
+                call.reject("No permission for this USB device");
                 return;
             }
 
             device.init();
+            try {
+                FileSystem fs = device.getPartitions().get(0).getFileSystem();
+                UsbFile root = fs.getRootDirectory();
+                UsbFile dir = root.search(path);
+
+                if (dir == null || !dir.isDirectory()) {
+                    call.reject("Directory not found: " + path);
+                    return;
+                }
 
-            FileSystem fs = device.getPartitions().get(0).getFileSystem();
-            UsbFile root = fs.getRootDirectory();
-            UsbFile dir = root.search(path);
-
-            if (dir == null || !dir.isDirectory()) {
-                call.reject("Directory not found: " + path);
-                return;
-            }
+                UsbFile[] files = dir.listFiles();
 
-            UsbFile[] files = dir.listFiles();
+                JSArray result = new JSArray();
+                for (UsbFile file : files) {
+                    JSObject info = new JSObject();
+                    info.put("name", file.getName());
+                    info.put("isDirectory", file.isDirectory());
+                    result.put(info);
+                }
 
-            JSArray result = new JSArray();
-            for (UsbFile file : files) {
-                result.put(file.getName());
+                JSObject ret = new JSObject();
+                ret.put("files", result);
+                call.resolve(ret);
+            } finally {
+                device.close();
             }
-
-            JSObject ret = new JSObject();
-            ret.put("files", result);
-            call.resolve(ret);
         } catch (Exception e) {
             Log.e(TAG, "readdir failed", e);
             call.reject("readdir failed: " + e.getMessage());
@@ -205,43 +212,51 @@ public class UsbStoragePlugin extends Plugin {
 
             UsbManager usbManager = (UsbManager) getContext().getSystemService(Context.USB_SERVICE);
             if (!usbManager.hasPermission(device.getUsbDevice())) {
-                call.reject("USB 장치에 대한 접근 권한이 없습니다.");
+                call.reject("No permission for this USB device");
                 return;
             }
 
             device.init();
+            try {
+                FileSystem fs = device.getPartitions().get(0).getFileSystem();
+                UsbFile root = fs.getRootDirectory();
+                UsbFile usbFile = root.search(path);
+
+                if (usbFile == null) {
+                    JSObject ret = new JSObject();
+                    ret.put("data", (String) null);
+                    call.resolve(ret);
+                    return;
+                }
 
-            FileSystem fs = device.getPartitions().get(0).getFileSystem();
-            UsbFile root = fs.getRootDirectory();
-            UsbFile usbFile = root.search(path);
+                if (usbFile.isDirectory()) {
+                    call.reject("Path is a directory: " + path);
+                    return;
+                }
 
-            if (usbFile == null) {
-                JSObject ret = new JSObject();
-                ret.put("data", (String) null);
-                call.resolve(ret);
-                return;
-            }
+                long fileLength = usbFile.getLength();
+                if (fileLength > MAX_FILE_SIZE) {
+                    call.reject("File too large: " + fileLength + " bytes (max " + MAX_FILE_SIZE + ")");
+                    return;
+                }
+                ByteBuffer buffer = ByteBuffer.allocate((int) fileLength);
 
-            if (usbFile.isDirectory()) {
-                call.reject("해당 경로는 폴더입니다.");
-                return;
-            }
+                UsbFileInputStream inputStream = new UsbFileInputStream(usbFile);
+                byte[] tmpBuf = new byte[fs.getChunkSize()];
+                int count;
+                while ((count = inputStream.read(tmpBuf)) != -1) {
+                    buffer.put(tmpBuf, 0, count);
+                }
+                inputStream.close();
 
-            ByteBuffer buffer = ByteBuffer.allocate((int) usbFile.getLength());
+                String base64Data = Base64.encodeToString(buffer.array(), Base64.NO_WRAP);
 
-            UsbFileInputStream inputStream = new UsbFileInputStream(usbFile);
-            byte[] tmpBuf = new byte[fs.getChunkSize()];
-            int count;
-            while ((count = inputStream.read(tmpBuf)) != -1) {
-                buffer.put(tmpBuf, 0, count);
+                JSObject ret = new JSObject();
+                ret.put("data", base64Data);
+                call.resolve(ret);
+            } finally {
+                device.close();
             }
-            inputStream.close();
-
-            String base64Data = Base64.encodeToString(buffer.array(), Base64.NO_WRAP);
-
-            JSObject ret = new JSObject();
-            ret.put("data", base64Data);
-            call.resolve(ret);
         } catch (Exception e) {
             Log.e(TAG, "read failed", e);
             call.reject("read failed: " + e.getMessage());
@@ -256,7 +271,7 @@ public class UsbStoragePlugin extends Plugin {
         }).findFirst();
 
         if (!optDevice.isPresent()) {
-            throw new Exception("USB 장치를 찾을 수 없습니다.");
+            throw new Exception("USB device not found: vendorId=" + vendorId + ", productId=" + productId);
         }
         return optDevice.get();
     }

package/dist/IUsbStoragePlugin.js

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

package/dist/IUsbStoragePlugin.js.map

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

package/dist/UsbStorage.js

@@ -1,63 +1,63 @@
 import { registerPlugin } from "@capacitor/core";
+import { bytesFromBase64 } from "@simplysm/core-common";
 const UsbStoragePlugin = registerPlugin("UsbStorage", {
-    web: async () => {
-        const { UsbStorageWeb } = await import("./web/UsbStorageWeb");
-        return new UsbStorageWeb();
-    },
+  web: async () => {
+    const { UsbStorageWeb } = await import("./web/UsbStorageWeb");
+    return new UsbStorageWeb();
+  }
 });
-/**
- * USB 저장장치와 상호작용하기 위한 플러그인
- * - Android: libaums 라이브러리를 통한 USB Mass Storage 접근
- * - Browser: alert으로 안내 후 빈 값 반환
- */
-export class UsbStorage {
-    /**
-     * 연결된 USB 장치 목록을 가져옴
-     * @returns 연결된 USB 장치 정보 배열
-     */
-    static async getDevices() {
-        const result = await UsbStoragePlugin.getDevices();
-        return result.devices;
-    }
-    /**
-     * USB 장치 접근 권한을 요청
-     * @param filter 권한을 요청할 USB 장치의 vendorId와 productId
-     * @returns 권한 승인 여부
-     */
-    static async requestPermission(filter) {
-        const result = await UsbStoragePlugin.requestPermission(filter);
-        return result.granted;
-    }
-    /**
-     * USB 장치 접근 권한이 있는지 확인
-     * @param filter 권한을 확인할 USB 장치의 vendorId와 productId
-     * @returns 권한 보유 여부
-     */
-    static async hasPermission(filter) {
-        const result = await UsbStoragePlugin.hasPermission(filter);
-        return result.granted;
-    }
-    /**
-     * USB 저장장치의 디렉토리 내용을 읽어옴
-     * @param filter 대상 USB 장치의 vendorId와 productId
-     * @param dirPath 읽어올 디렉토리 경로
-     * @returns 디렉토리 내 파일/폴더 이름 배열
-     */
-    static async readdir(filter, dirPath) {
-        const result = await UsbStoragePlugin.readdir({ ...filter, path: dirPath });
-        return result.files;
-    }
-    /**
-     * USB 저장장치의 파일을 읽어옴
-     * @param filter 대상 USB 장치의 vendorId와 productId
-     * @param filePath 읽어올 파일 경로
-     * @returns 파일 데이터를 담은 Buffer 또는 undefined
-     */
-    static async read(filter, filePath) {
-        const result = await UsbStoragePlugin.read({ ...filter, path: filePath });
-        if (result.data == null) {
-            return undefined;
-        }
-        return Buffer.from(result.data, "base64");
+class UsbStorage {
+  /**
+   * 연결된 USB 장치 목록을 가져옴
+   * @returns 연결된 USB 장치 정보 배열
+   */
+  static async getDevices() {
+    const result = await UsbStoragePlugin.getDevices();
+    return result.devices;
+  }
+  /**
+   * USB 장치 접근 권한을 요청
+   * @param filter 권한을 요청할 USB 장치의 vendorId와 productId
+   * @returns 권한 승인 여부
+   */
+  static async requestPermission(filter) {
+    const result = await UsbStoragePlugin.requestPermission(filter);
+    return result.granted;
+  }
+  /**
+   * USB 장치 접근 권한이 있는지 확인
+   * @param filter 권한을 확인할 USB 장치의 vendorId와 productId
+   * @returns 권한 보유 여부
+   */
+  static async hasPermission(filter) {
+    const result = await UsbStoragePlugin.hasPermission(filter);
+    return result.granted;
+  }
+  /**
+   * USB 저장장치의 디렉토리 내용을 읽어옴
+   * @param filter 대상 USB 장치의 vendorId와 productId
+   * @param dirPath 읽어올 디렉토리 경로
+   * @returns 디렉토리 내 파일/폴더 정보 배열
+   */
+  static async readdir(filter, dirPath) {
+    const result = await UsbStoragePlugin.readdir({ ...filter, path: dirPath });
+    return result.files;
+  }
+  /**
+   * USB 저장장치의 파일을 읽어옴
+   * @param filter 대상 USB 장치의 vendorId와 productId
+   * @param filePath 읽어올 파일 경로
+   * @returns 파일 데이터를 담은 Bytes 또는 undefined
+   */
+  static async read(filter, filePath) {
+    const result = await UsbStoragePlugin.read({ ...filter, path: filePath });
+    if (result.data == null) {
+      return void 0;
     }
+    return bytesFromBase64(result.data);
+  }
 }
+export {
+  UsbStorage
+};
+//# sourceMappingURL=UsbStorage.js.map

package/dist/UsbStorage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/UsbStorage.ts"],
+  "sourcesContent": ["import { registerPlugin } from \"@capacitor/core\";\nimport type { IUsbDeviceFilter, IUsbDeviceInfo, IUsbFileInfo, IUsbStoragePlugin } from \"./IUsbStoragePlugin\";\nimport type { Bytes } from \"@simplysm/core-common\";\nimport { bytesFromBase64 } from \"@simplysm/core-common\";\n\nconst UsbStoragePlugin = registerPlugin<IUsbStoragePlugin>(\"UsbStorage\", {\n  web: async () => {\n    const { UsbStorageWeb } = await import(\"./web/UsbStorageWeb\");\n    return new UsbStorageWeb();\n  },\n});\n\n/**\n * USB \uC800\uC7A5\uC7A5\uCE58\uC640 \uC0C1\uD638\uC791\uC6A9\uD558\uAE30 \uC704\uD55C \uD50C\uB7EC\uADF8\uC778\n * - Android: libaums \uB77C\uC774\uBE0C\uB7EC\uB9AC\uB97C \uD1B5\uD55C USB Mass Storage \uC811\uADFC\n * - Browser: IndexedDB \uAE30\uBC18 \uAC00\uC0C1 USB \uC800\uC7A5\uC18C \uC5D0\uBBAC\uB808\uC774\uC158\n */\nexport abstract class UsbStorage {\n  /**\n   * \uC5F0\uACB0\uB41C USB \uC7A5\uCE58 \uBAA9\uB85D\uC744 \uAC00\uC838\uC634\n   * @returns \uC5F0\uACB0\uB41C USB \uC7A5\uCE58 \uC815\uBCF4 \uBC30\uC5F4\n   */\n  static async getDevices(): Promise<IUsbDeviceInfo[]> {\n    const result = await UsbStoragePlugin.getDevices();\n    return result.devices;\n  }\n\n  /**\n   * USB \uC7A5\uCE58 \uC811\uADFC \uAD8C\uD55C\uC744 \uC694\uCCAD\n   * @param filter \uAD8C\uD55C\uC744 \uC694\uCCAD\uD560 USB \uC7A5\uCE58\uC758 vendorId\uC640 productId\n   * @returns \uAD8C\uD55C \uC2B9\uC778 \uC5EC\uBD80\n   */\n  static async requestPermission(filter: IUsbDeviceFilter): Promise<boolean> {\n    const result = await UsbStoragePlugin.requestPermission(filter);\n    return result.granted;\n  }\n\n  /**\n   * USB \uC7A5\uCE58 \uC811\uADFC \uAD8C\uD55C\uC774 \uC788\uB294\uC9C0 \uD655\uC778\n   * @param filter \uAD8C\uD55C\uC744 \uD655\uC778\uD560 USB \uC7A5\uCE58\uC758 vendorId\uC640 productId\n   * @returns \uAD8C\uD55C \uBCF4\uC720 \uC5EC\uBD80\n   */\n  static async hasPermission(filter: IUsbDeviceFilter): Promise<boolean> {\n    const result = await UsbStoragePlugin.hasPermission(filter);\n    return result.granted;\n  }\n\n  /**\n   * USB \uC800\uC7A5\uC7A5\uCE58\uC758 \uB514\uB809\uD1A0\uB9AC \uB0B4\uC6A9\uC744 \uC77D\uC5B4\uC634\n   * @param filter \uB300\uC0C1 USB \uC7A5\uCE58\uC758 vendorId\uC640 productId\n   * @param dirPath \uC77D\uC5B4\uC62C \uB514\uB809\uD1A0\uB9AC \uACBD\uB85C\n   * @returns \uB514\uB809\uD1A0\uB9AC \uB0B4 \uD30C\uC77C/\uD3F4\uB354 \uC815\uBCF4 \uBC30\uC5F4\n   */\n  static async readdir(filter: IUsbDeviceFilter, dirPath: string): Promise<IUsbFileInfo[]> {\n    const result = await UsbStoragePlugin.readdir({ ...filter, path: dirPath });\n    return result.files;\n  }\n\n  /**\n   * USB \uC800\uC7A5\uC7A5\uCE58\uC758 \uD30C\uC77C\uC744 \uC77D\uC5B4\uC634\n   * @param filter \uB300\uC0C1 USB \uC7A5\uCE58\uC758 vendorId\uC640 productId\n   * @param filePath \uC77D\uC5B4\uC62C \uD30C\uC77C \uACBD\uB85C\n   * @returns \uD30C\uC77C \uB370\uC774\uD130\uB97C \uB2F4\uC740 Bytes \uB610\uB294 undefined\n   */\n  static async read(filter: IUsbDeviceFilter, filePath: string): Promise<Bytes | undefined> {\n    const result = await UsbStoragePlugin.read({ ...filter, path: filePath });\n    if (result.data == null) {\n      return undefined;\n    }\n    return bytesFromBase64(result.data);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,sBAAsB;AAG/B,SAAS,uBAAuB;AAEhC,MAAM,mBAAmB,eAAkC,cAAc;AAAA,EACvE,KAAK,YAAY;AACf,UAAM,EAAE,cAAc,IAAI,MAAM,OAAO,qBAAqB;AAC5D,WAAO,IAAI,cAAc;AAAA,EAC3B;AACF,CAAC;AAOM,MAAe,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA,EAK/B,aAAa,aAAwC;AACnD,UAAM,SAAS,MAAM,iBAAiB,WAAW;AACjD,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,kBAAkB,QAA4C;AACzE,UAAM,SAAS,MAAM,iBAAiB,kBAAkB,MAAM;AAC9D,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,cAAc,QAA4C;AACrE,UAAM,SAAS,MAAM,iBAAiB,cAAc,MAAM;AAC1D,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAa,QAAQ,QAA0B,SAA0C;AACvF,UAAM,SAAS,MAAM,iBAAiB,QAAQ,EAAE,GAAG,QAAQ,MAAM,QAAQ,CAAC;AAC1E,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAa,KAAK,QAA0B,UAA8C;AACxF,UAAM,SAAS,MAAM,iBAAiB,KAAK,EAAE,GAAG,QAAQ,MAAM,SAAS,CAAC;AACxE,QAAI,OAAO,QAAQ,MAAM;AACvB,aAAO;AAAA,IACT;AACA,WAAO,gBAAgB,OAAO,IAAI;AAAA,EACpC;AACF;",
+  "names": []
+}

package/dist/{IUsbStoragePlugin.d.ts → capacitor-plugin-usb-storage/src/IUsbStoragePlugin.d.ts}

@@ -9,6 +9,10 @@ export interface IUsbDeviceFilter {
     vendorId: number;
     productId: number;
 }
+export interface IUsbFileInfo {
+    name: string;
+    isDirectory: boolean;
+}
 export interface IUsbStoragePlugin {
     getDevices(): Promise<{
         devices: IUsbDeviceInfo[];
@@ -22,7 +26,7 @@ export interface IUsbStoragePlugin {
     readdir(options: IUsbDeviceFilter & {
         path: string;
     }): Promise<{
-        files: string[];
+        files: IUsbFileInfo[];
     }>;
     read(options: IUsbDeviceFilter & {
         path: string;
@@ -30,3 +34,4 @@ export interface IUsbStoragePlugin {
         data: string | null;
     }>;
 }
+//# sourceMappingURL=IUsbStoragePlugin.d.ts.map

package/dist/capacitor-plugin-usb-storage/src/IUsbStoragePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUsbStoragePlugin.d.ts","sourceRoot":"","sources":["../../../src/IUsbStoragePlugin.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IACrD,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5E,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxE,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1F,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACtF"}

package/dist/{UsbStorage.d.ts → capacitor-plugin-usb-storage/src/UsbStorage.d.ts}

@@ -1,8 +1,9 @@
-import { IUsbDeviceInfo } from "./IUsbStoragePlugin";
+import type { IUsbDeviceFilter, IUsbDeviceInfo, IUsbFileInfo } from "./IUsbStoragePlugin";
+import type { Bytes } from "@simplysm/core-common";
 /**
  * USB 저장장치와 상호작용하기 위한 플러그인
  * - Android: libaums 라이브러리를 통한 USB Mass Storage 접근
- * - Browser: alert으로 안내 후 빈 값 반환
+ * - Browser: IndexedDB 기반 가상 USB 저장소 에뮬레이션
  */
 export declare abstract class UsbStorage {
     /**
@@ -15,37 +16,26 @@ export declare abstract class UsbStorage {
      * @param filter 권한을 요청할 USB 장치의 vendorId와 productId
      * @returns 권한 승인 여부
      */
-    static requestPermission(filter: {
-        vendorId: number;
-        productId: number;
-    }): Promise<boolean>;
+    static requestPermission(filter: IUsbDeviceFilter): Promise<boolean>;
     /**
      * USB 장치 접근 권한이 있는지 확인
      * @param filter 권한을 확인할 USB 장치의 vendorId와 productId
      * @returns 권한 보유 여부
      */
-    static hasPermission(filter: {
-        vendorId: number;
-        productId: number;
-    }): Promise<boolean>;
+    static hasPermission(filter: IUsbDeviceFilter): Promise<boolean>;
     /**
      * USB 저장장치의 디렉토리 내용을 읽어옴
      * @param filter 대상 USB 장치의 vendorId와 productId
      * @param dirPath 읽어올 디렉토리 경로
-     * @returns 디렉토리 내 파일/폴더 이름 배열
+     * @returns 디렉토리 내 파일/폴더 정보 배열
      */
-    static readdir(filter: {
-        vendorId: number;
-        productId: number;
-    }, dirPath: string): Promise<string[]>;
+    static readdir(filter: IUsbDeviceFilter, dirPath: string): Promise<IUsbFileInfo[]>;
     /**
      * USB 저장장치의 파일을 읽어옴
      * @param filter 대상 USB 장치의 vendorId와 productId
      * @param filePath 읽어올 파일 경로
-     * @returns 파일 데이터를 담은 Buffer 또는 undefined
+     * @returns 파일 데이터를 담은 Bytes 또는 undefined
      */
-    static read(filter: {
-        vendorId: number;
-        productId: number;
-    }, filePath: string): Promise<Buffer | undefined>;
+    static read(filter: IUsbDeviceFilter, filePath: string): Promise<Bytes | undefined>;
 }
+//# sourceMappingURL=UsbStorage.d.ts.map

package/dist/capacitor-plugin-usb-storage/src/UsbStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsbStorage.d.ts","sourceRoot":"","sources":["../../../src/UsbStorage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAqB,MAAM,qBAAqB,CAAC;AAC7G,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAUnD;;;;GAIG;AACH,8BAAsB,UAAU;IAC9B;;;OAGG;WACU,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAKpD;;;;OAIG;WACU,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAK1E;;;;OAIG;WACU,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtE;;;;;OAKG;WACU,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKxF;;;;;OAKG;WACU,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;CAO1F"}

package/dist/{index.d.ts → capacitor-plugin-usb-storage/src/index.d.ts}

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

package/dist/capacitor-plugin-usb-storage/src/index.d.ts.map

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

package/dist/capacitor-plugin-usb-storage/src/web/IndexedDbStore.d.ts

@@ -0,0 +1,16 @@
+export interface IStoreConfig {
+    name: string;
+    keyPath: string;
+}
+export declare class IndexedDbStore {
+    private readonly _dbName;
+    private readonly _dbVersion;
+    private readonly _storeConfigs;
+    constructor(_dbName: string, _dbVersion: number, _storeConfigs: IStoreConfig[]);
+    open(): Promise<IDBDatabase>;
+    withStore<T>(storeName: string, mode: IDBTransactionMode, fn: (store: IDBObjectStore) => Promise<T>): Promise<T>;
+    get<T>(storeName: string, key: IDBValidKey): Promise<T | undefined>;
+    put(storeName: string, value: unknown): Promise<void>;
+    getAll<T>(storeName: string): Promise<T[]>;
+}
+//# sourceMappingURL=IndexedDbStore.d.ts.map

package/dist/capacitor-plugin-usb-storage/src/web/IndexedDbStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDbStore.d.ts","sourceRoot":"","sources":["../../../../src/web/IndexedDbStore.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,YAAY,EAAE;IAG1C,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAiB5B,SAAS,CAAC,CAAC,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC;IAyBP,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAUnE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CASjD"}