@simplysm/capacitor-plugin-usb-storage 13.0.99 → 14.0.1

package/android/build.gradle

@@ -1,4 +1,5 @@
 apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
 
 android {
     namespace "kr.co.simplysm.capacitor.usbstorage"

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

@@ -0,0 +1,269 @@
+package kr.co.simplysm.capacitor.usbstorage
+
+import android.app.PendingIntent
+import android.content.BroadcastReceiver
+import android.content.Context
+import android.content.Intent
+import android.content.IntentFilter
+import android.hardware.usb.UsbManager
+import android.os.Build
+import android.util.Base64
+import android.util.Log
+import com.getcapacitor.JSArray
+import com.getcapacitor.JSObject
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
+import com.getcapacitor.annotation.CapacitorPlugin
+import me.jahnen.libaums.core.UsbMassStorageDevice
+import me.jahnen.libaums.core.fs.UsbFileInputStream
+import java.nio.ByteBuffer
+
+@CapacitorPlugin(name = "UsbStorage")
+class UsbStoragePlugin : Plugin() {
+
+    companion object {
+        private const val TAG = "UsbStoragePlugin"
+        private const val ACTION_USB_PERMISSION = "kr.co.simplysm.capacitor.usbstorage.USB_PERMISSION"
+        private const val MAX_FILE_SIZE = 100L * 1024 * 1024 // 100MB
+    }
+
+    @PluginMethod
+    fun getDevices(call: PluginCall) {
+        try {
+            val devices = UsbMassStorageDevice.getMassStorageDevices(context)
+
+            val result = JSArray()
+            for (device in devices) {
+                val usbDevice = device.usbDevice
+
+                val deviceObj = JSObject()
+                deviceObj.put("deviceName", usbDevice.deviceName)
+                deviceObj.put("manufacturerName", usbDevice.manufacturerName)
+                deviceObj.put("productName", usbDevice.productName)
+                deviceObj.put("vendorId", usbDevice.vendorId)
+                deviceObj.put("productId", usbDevice.productId)
+                result.put(deviceObj)
+            }
+
+            val ret = JSObject()
+            ret.put("devices", result)
+            call.resolve(ret)
+        } catch (e: Exception) {
+            Log.e(TAG, "getDevices failed", e)
+            call.reject("getDevices failed: ${e.message}")
+        }
+    }
+
+    @PluginMethod
+    fun requestPermissions(call: PluginCall) {
+        val vendorId = call.getInt("vendorId")
+        val productId = call.getInt("productId")
+
+        if (vendorId == null || productId == null) {
+            call.reject("vendorId and productId are required")
+            return
+        }
+
+        try {
+            val device = getDevice(vendorId, productId)
+            val usbDevice = device.usbDevice
+
+            val usbManager = context.getSystemService(Context.USB_SERVICE) as UsbManager
+            if (usbManager.hasPermission(usbDevice)) {
+                val ret = JSObject()
+                ret.put("granted", true)
+                call.resolve(ret)
+                return
+            }
+
+            val receiver = object : BroadcastReceiver() {
+                override fun onReceive(context: Context, intent: Intent) {
+                    try {
+                        context.unregisterReceiver(this)
+                        val granted = intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)
+                        val ret = JSObject()
+                        ret.put("granted", granted)
+                        call.resolve(ret)
+                    } catch (e: Exception) {
+                        Log.e(TAG, "requestPermission callback failed", e)
+                        call.reject("requestPermission failed: ${e.message}")
+                    }
+                }
+            }
+
+            val filter = IntentFilter(ACTION_USB_PERMISSION)
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                context.registerReceiver(receiver, filter, Context.RECEIVER_NOT_EXPORTED)
+            } else {
+                context.registerReceiver(receiver, filter)
+            }
+
+            val flags = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+                PendingIntent.FLAG_MUTABLE
+            } else {
+                0
+            }
+            val permissionIntent = PendingIntent.getBroadcast(
+                context, 0, Intent(ACTION_USB_PERMISSION), flags
+            )
+            usbManager.requestPermission(usbDevice, permissionIntent)
+        } catch (e: Exception) {
+            Log.e(TAG, "requestPermission failed", e)
+            call.reject("requestPermission failed: ${e.message}")
+        }
+    }
+
+    @PluginMethod
+    fun checkPermissions(call: PluginCall) {
+        val vendorId = call.getInt("vendorId")
+        val productId = call.getInt("productId")
+
+        if (vendorId == null || productId == null) {
+            call.reject("vendorId and productId are required")
+            return
+        }
+
+        try {
+            val device = getDevice(vendorId, productId)
+            val usbManager = context.getSystemService(Context.USB_SERVICE) as UsbManager
+            val hasPermission = usbManager.hasPermission(device.usbDevice)
+
+            val ret = JSObject()
+            ret.put("granted", hasPermission)
+            call.resolve(ret)
+        } catch (e: Exception) {
+            Log.e(TAG, "hasPermission failed", e)
+            call.reject("hasPermission failed: ${e.message}")
+        }
+    }
+
+    @PluginMethod
+    fun readdir(call: PluginCall) {
+        val vendorId = call.getInt("vendorId")
+        val productId = call.getInt("productId")
+        val path = call.getString("path")
+
+        if (vendorId == null || productId == null || path == null) {
+            call.reject("vendorId, productId, and path are required")
+            return
+        }
+
+        try {
+            val device = getDevice(vendorId, productId)
+
+            val usbManager = context.getSystemService(Context.USB_SERVICE) as UsbManager
+            if (!usbManager.hasPermission(device.usbDevice)) {
+                call.reject("No permission for this USB device")
+                return
+            }
+
+            device.init()
+            try {
+                val fs = device.partitions[0].fileSystem
+                val root = fs.rootDirectory
+                val dir = root.search(path)
+
+                if (dir == null || !dir.isDirectory) {
+                    call.reject("Directory not found: $path")
+                    return
+                }
+
+                val files = dir.listFiles()
+
+                val result = JSArray()
+                for (file in files) {
+                    val info = JSObject()
+                    info.put("name", file.name)
+                    info.put("isDirectory", file.isDirectory)
+                    result.put(info)
+                }
+
+                val ret = JSObject()
+                ret.put("files", result)
+                call.resolve(ret)
+            } finally {
+                device.close()
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "readdir failed", e)
+            call.reject("readdir failed: ${e.message}")
+        }
+    }
+
+    @PluginMethod
+    fun readFile(call: PluginCall) {
+        val vendorId = call.getInt("vendorId")
+        val productId = call.getInt("productId")
+        val path = call.getString("path")
+
+        if (vendorId == null || productId == null || path == null) {
+            call.reject("vendorId, productId, and path are required")
+            return
+        }
+
+        try {
+            val device = getDevice(vendorId, productId)
+
+            val usbManager = context.getSystemService(Context.USB_SERVICE) as UsbManager
+            if (!usbManager.hasPermission(device.usbDevice)) {
+                call.reject("No permission for this USB device")
+                return
+            }
+
+            device.init()
+            try {
+                val fs = device.partitions[0].fileSystem
+                val root = fs.rootDirectory
+                val usbFile = root.search(path)
+
+                if (usbFile == null) {
+                    val ret = JSObject()
+                    ret.put("data", null as String?)
+                    call.resolve(ret)
+                    return
+                }
+
+                if (usbFile.isDirectory) {
+                    call.reject("Path is a directory: $path")
+                    return
+                }
+
+                val fileLength = usbFile.length
+                if (fileLength > MAX_FILE_SIZE) {
+                    call.reject("File too large: $fileLength bytes (max $MAX_FILE_SIZE)")
+                    return
+                }
+                val buffer = ByteBuffer.allocate(fileLength.toInt())
+
+                val inputStream = UsbFileInputStream(usbFile)
+                val tmpBuf = ByteArray(fs.chunkSize)
+                var count: Int
+                while (inputStream.read(tmpBuf).also { count = it } != -1) {
+                    buffer.put(tmpBuf, 0, count)
+                }
+                inputStream.close()
+
+                val base64Data = Base64.encodeToString(buffer.array(), Base64.NO_WRAP)
+
+                val ret = JSObject()
+                ret.put("data", base64Data)
+                call.resolve(ret)
+            } finally {
+                device.close()
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "readFile failed", e)
+            call.reject("readFile failed: ${e.message}")
+        }
+    }
+
+    @Throws(Exception::class)
+    private fun getDevice(vendorId: Int, productId: Int): UsbMassStorageDevice {
+        val devices = UsbMassStorageDevice.getMassStorageDevices(context)
+        return devices.firstOrNull { device ->
+            val usbDevice = device.usbDevice
+            usbDevice.vendorId == vendorId && usbDevice.productId == productId
+        } ?: throw Exception("USB device not found: vendorId=$vendorId, productId=$productId")
+    }
+}

package/dist/UsbStorage.d.ts

@@ -1,40 +1,40 @@
 import type { UsbDeviceFilter, UsbDeviceInfo, UsbFileInfo } from "./UsbStoragePlugin";
 import type { Bytes } from "@simplysm/core-common";
 /**
- * Plugin for interacting with USB storage devices
- * - Android: USB Mass Storage access via libaums library
- * - Browser: IndexedDB-based virtual USB storage emulation
+ * USB 저장 장치 접근 플러그인
+ * - Android: libaums 라이브러리를 통한 USB Mass Storage 접근
+ * - Browser: IndexedDB 기반 가상 USB 저장소 에뮬레이션
  */
 export declare abstract class UsbStorage {
     /**
-     * Get list of connected USB devices
-     * @returns Array of connected USB device info
+     * 연결된 USB 장치 목록 조회
+     * @returns 연결된 USB 장치 정보 배열
      */
     static getDevices(): Promise<UsbDeviceInfo[]>;
     /**
-     * Request USB device access permission
-     * @param filter vendorId and productId of the USB device to request permission for
-     * @returns Whether permission was granted
+     * USB 장치 접근 권한 요청
+     * @param filter 권한을 요청할 USB 장치의 vendorId 및 productId
+     * @returns 권한 승인 여부
      */
     static requestPermissions(filter: UsbDeviceFilter): Promise<boolean>;
     /**
-     * Check if USB device access permission is granted
-     * @param filter vendorId and productId of the USB device to check permission for
-     * @returns Whether permission is held
+     * USB 장치 접근 권한 확인
+     * @param filter 권한을 확인할 USB 장치의 vendorId 및 productId
+     * @returns 권한 보유 여부
      */
     static checkPermissions(filter: UsbDeviceFilter): Promise<boolean>;
     /**
-     * Read directory contents from USB storage device
-     * @param filter vendorId and productId of the target USB device
-     * @param dirPath Directory path to read
-     * @returns Array of file/folder info in the directory
+     * USB 저장 장치에서 디렉토리 내용 읽기
+     * @param filter 대상 USB 장치의 vendorId 및 productId
+     * @param dirPath 읽을 디렉토리 경로
+     * @returns 디렉토리 내 파일/폴더 정보 배열
      */
     static readdir(filter: UsbDeviceFilter, dirPath: string): Promise<UsbFileInfo[]>;
     /**
-     * Read a file from USB storage device
-     * @param filter vendorId and productId of the target USB device
-     * @param filePath File path to read
-     * @returns Bytes containing file data, or undefined
+     * USB 저장 장치에서 파일 읽기
+     * @param filter 대상 USB 장치의 vendorId 및 productId
+     * @param filePath 읽을 파일 경로
+     * @returns 파일 데이터를 포함하는 Bytes, 또는 undefined
      */
     static readFile(filter: UsbDeviceFilter, filePath: string): Promise<Bytes | undefined>;
 }

package/dist/UsbStorage.js

@@ -1,63 +1,65 @@
 import { registerPlugin } from "@capacitor/core";
 import { bytes } 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.js");
+        return new UsbStorageWeb();
+    },
 });
-class UsbStorage {
-  /**
-   * Get list of connected USB devices
-   * @returns Array of connected USB device info
-   */
-  static async getDevices() {
-    const result = await usbStoragePlugin.getDevices();
-    return result.devices;
-  }
-  /**
-   * Request USB device access permission
-   * @param filter vendorId and productId of the USB device to request permission for
-   * @returns Whether permission was granted
-   */
-  static async requestPermissions(filter) {
-    const result = await usbStoragePlugin.requestPermissions(filter);
-    return result.granted;
-  }
-  /**
-   * Check if USB device access permission is granted
-   * @param filter vendorId and productId of the USB device to check permission for
-   * @returns Whether permission is held
-   */
-  static async checkPermissions(filter) {
-    const result = await usbStoragePlugin.checkPermissions(filter);
-    return result.granted;
-  }
-  /**
-   * Read directory contents from USB storage device
-   * @param filter vendorId and productId of the target USB device
-   * @param dirPath Directory path to read
-   * @returns Array of file/folder info in the directory
-   */
-  static async readdir(filter, dirPath) {
-    const result = await usbStoragePlugin.readdir({ ...filter, path: dirPath });
-    return result.files;
-  }
-  /**
-   * Read a file from USB storage device
-   * @param filter vendorId and productId of the target USB device
-   * @param filePath File path to read
-   * @returns Bytes containing file data, or undefined
-   */
-  static async readFile(filter, filePath) {
-    const result = await usbStoragePlugin.readFile({ ...filter, path: filePath });
-    if (result.data == null) {
-      return void 0;
+/**
+ * USB 저장 장치 접근 플러그인
+ * - Android: libaums 라이브러리를 통한 USB Mass Storage 접근
+ * - Browser: IndexedDB 기반 가상 USB 저장소 에뮬레이션
+ */
+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 requestPermissions(filter) {
+        const result = await usbStoragePlugin.requestPermissions(filter);
+        return result.granted;
+    }
+    /**
+     * USB 장치 접근 권한 확인
+     * @param filter 권한을 확인할 USB 장치의 vendorId 및 productId
+     * @returns 권한 보유 여부
+     */
+    static async checkPermissions(filter) {
+        const result = await usbStoragePlugin.checkPermissions(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 readFile(filter, filePath) {
+        const result = await usbStoragePlugin.readFile({ ...filter, path: filePath });
+        if (result.data == null) {
+            return undefined;
+        }
+        return bytes.fromBase64(result.data);
     }
-    return bytes.fromBase64(result.data);
-  }
 }
-export {
-  UsbStorage
-};
-//# sourceMappingURL=UsbStorage.js.map
+//# sourceMappingURL=UsbStorage.js.map

package/dist/UsbStorage.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/UsbStorage.ts"],
-  "mappings": "AAAA,SAAS,sBAAsB;AAQ/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;AAOM,MAAe,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA,EAK/B,aAAa,aAAuC;AAClD,UAAM,SAAS,MAAM,iBAAiB,WAAW;AACjD,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,mBAAmB,QAA2C;AACzE,UAAM,SAAS,MAAM,iBAAiB,mBAAmB,MAAM;AAC/D,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,iBAAiB,QAA2C;AACvE,UAAM,SAAS,MAAM,iBAAiB,iBAAiB,MAAM;AAC7D,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAa,QAAQ,QAAyB,SAAyC;AACrF,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,SAAS,QAAyB,UAA8C;AAC3F,UAAM,SAAS,MAAM,iBAAiB,SAAS,EAAE,GAAG,QAAQ,MAAM,SAAS,CAAC;AAC5E,QAAI,OAAO,QAAQ,MAAM;AACvB,aAAO;AAAA,IACT;AACA,WAAO,MAAM,WAAW,OAAO,IAAI;AAAA,EACrC;AACF;",
-  "names": []
-}
+{"version":3,"file":"UsbStorage.js","sourceRoot":"","sources":["..\\src\\UsbStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQjD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,MAAM,gBAAgB,GAAG,cAAc,CAAmB,YAAY,EAAE;IACtE,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC9D,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,OAAgB,UAAU;IAC9B;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU;QACrB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,UAAU,EAAE,CAAC;QACnD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAuB;QACrD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAuB;QACnD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAuB,EAAE,OAAe;QAC3D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAuB,EAAE,QAAgB;QAC7D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9E,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/UsbStoragePlugin.js

@@ -1 +1,2 @@
-//# sourceMappingURL=UsbStoragePlugin.js.map
+export {};
+//# sourceMappingURL=UsbStoragePlugin.js.map

package/dist/UsbStoragePlugin.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": [],
-  "mappings": "",
-  "names": []
-}
+{"version":3,"file":"UsbStoragePlugin.js","sourceRoot":"","sources":["..\\src\\UsbStoragePlugin.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -1,3 +1,4 @@
+// USB 저장소
 export * from "./UsbStoragePlugin.js";
 export * from "./UsbStorage.js";
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "mappings": "AACA,cAAc;AACd,cAAc;",
-  "names": []
-}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/web/UsbStorageWeb.d.ts

@@ -22,7 +22,7 @@ export declare class UsbStorageWeb extends WebPlugin implements UsbStoragePlugin
         data: string | null;
     }>;
     /**
-     * Add a virtual USB device. (For testing/development)
+     * 가상 USB 장치를 추가합니다. (테스트/개발용)
      */
     addVirtualDevice(device: {
         vendorId: number;
@@ -32,11 +32,11 @@ export declare class UsbStorageWeb extends WebPlugin implements UsbStoragePlugin
         productName: string;
     }): Promise<void>;
     /**
-     * Add a file to a virtual USB device. (For testing/development)
+     * 가상 USB 장치에 파일을 추가합니다. (테스트/개발용)
      */
     addVirtualFile(filter: UsbDeviceFilter, filePath: string, data: Uint8Array): Promise<void>;
     /**
-     * Add a directory to a virtual USB device. (For testing/development)
+     * 가상 USB 장치에 디렉토리를 추가합니다. (테스트/개발용)
      */
     addVirtualDirectory(filter: UsbDeviceFilter, dirPath: string): Promise<void>;
 }