react-native-kookit 0.3.8 → 0.4.0

package/README.md

@@ -8,6 +8,7 @@ A comprehensive React Native/Expo module with multiple utilities for Android and
 - 📁 **FTP Client** - Full-featured FTP client with upload/download capabilities
 - 🗂️ **SMB Client** - Access SMB/CIFS network shares
 - 📱 **Content URI Handler** (Android) - Handle `content://` URIs from other apps, bypassing permission restrictions
+- 🔊 **Audio Detection** (Android) - Detect if any audio is currently playing (music, TTS, videos, etc.)
 
 ### Content URI Handler
 
@@ -23,6 +24,36 @@ The Content URI Handler solves a common Android problem: when receiving files vi
 
 📖 [**View Content URI Handler Documentation**](./docs/CONTENT_URI_HANDLER.md)
 
+### Audio Detection
+
+The Audio Detection API allows you to check if the device is currently playing any audio, including music, TTS, videos, or any other audio source.
+
+**Key Benefits:**
+
+- ✅ Detect any audio playback (music, TTS, videos, games)
+- ✅ Simple synchronous API
+- ✅ No permissions required
+- ✅ Lightweight and fast
+- ✅ Perfect for audio queue management
+
+**Quick Example:**
+
+```typescript
+import ReactNativeKookit from "react-native-kookit";
+
+// Check if audio is playing
+const isPlaying = ReactNativeKookit.isAudioPlaying();
+console.log("Audio playing:", isPlaying);
+
+// Monitor audio state
+setInterval(() => {
+  const playing = ReactNativeKookit.isAudioPlaying();
+  console.log("Audio status:", playing ? "Playing" : "Idle");
+}, 500);
+```
+
+📖 [**View Audio Detection Documentation**](./docs/AUDIO_DETECTION.md)
+
 # API documentation
 
 - [Documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/react-native-kookit/)

package/android/src/main/java/expo/modules/kookit/ReactNativeKookitModule.kt

@@ -928,6 +928,13 @@ class ReactNativeKookitModule : Module() {
       }
     }
 
+    // Check if audio is currently playing
+    Function("isAudioPlaying") {
+      val context = appContext.reactContext ?: return@Function false
+      val audioManager = context.getSystemService(Context.AUDIO_SERVICE) as? AudioManager
+      audioManager?.isMusicActive ?: false
+    }
+
     // Cleanup when module is destroyed
     OnDestroy {
       textToSpeech?.shutdown()
@@ -963,7 +970,7 @@ class ReactNativeKookitModule : Module() {
           // Throw an error with helpful message
           throw IllegalStateException(
             "Your MainActivity must implement VolumeKeyInterceptActivity interface and override dispatchKeyEvent method. " +
-            "Please see the documentation at https://github.com/troyeguo/react-native-kookit for setup instructions."
+            "Please see the documentation for setup instructions."
           )
         }
         

package/build/ReactNativeKookitModule.d.ts

@@ -177,6 +177,26 @@ declare class ReactNativeKookitModule extends NativeModule<ReactNativeKookitModu
      * @returns Promise that resolves with file path and duration of the generated audio
      */
     synthesizeSpeech(options: TtsSynthesizeOptions): Promise<TtsSynthesizeResult>;
+    /**
+     * Copy a file with security-scoped resource access (iOS only).
+     * Required for accessing files passed via "Open With" from external apps.
+     *
+     * @param sourceUri The source file URI (file:// or path)
+     * @param destinationPath The destination file path
+     * @returns Promise that resolves with the local path and success status
+     */
+    copySecurityScopedFile(sourceUri: string, destinationPath: string): Promise<{
+        localPath: string;
+        success: boolean;
+    }>;
+    /**
+     * Check if the device is currently playing any audio (music, TTS, or other audio).
+     * Uses AudioManager.isMusicActive() on Android which detects any audio playback.
+     *
+     * @returns Boolean indicating whether audio is currently playing
+     * @platform android
+     */
+    isAudioPlaying(): boolean;
 }
 declare const _default: ReactNativeKookitModule;
 export default _default;

package/build/ReactNativeKookitModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeKookitModule.d.ts","sourceRoot":"","sources":["../src/ReactNativeKookitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,OAAO,uBAAwB,SAAQ,YAAY,CAAC,6BAA6B,CAAC;IACvF,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,IAAI,MAAM;IAEf;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C;;;;;;OAMG;IACH,2BAA2B,IAAI,IAAI;IAEnC;;OAEG;IACH,4BAA4B,IAAI,IAAI;IAIpC;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAEhE;;;;;OAKG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;OAIG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjD;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEtE;;;;;;OAMG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;;;OAMG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;;;OAMG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7E;;;;;OAKG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7E;;;;OAIG;IACH,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE/D;;;;OAIG;IACH,kBAAkB,CAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAEnD;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAChD,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAIF,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAChB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACzE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACpD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACtE,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAChB,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAChB,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,IAAI,CAAC;IAChB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7E,kBAAkB,CAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,cAAc,IAAI,OAAO,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAChD,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;;;;;;;;OASG;IACH,qBAAqB,CACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;;;;;OAMG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QACjD,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAC9E;;AAGD,wBAEE"}
+{"version":3,"file":"ReactNativeKookitModule.d.ts","sourceRoot":"","sources":["../src/ReactNativeKookitModule.ts"],"names":[],"mappings":"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"}

package/build/ReactNativeKookitModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeKookitModule.js","sourceRoot":"","sources":["../src/ReactNativeKookitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AA+OzD,yDAAyD;AACzD,eAAe,mBAAmB,CAChC,mBAAmB,CACpB,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\n\nimport {\n  ReactNativeKookitModuleEvents,\n  FtpConnectionConfig,\n  FtpFileInfo,\n  SmbConnectionConfig,\n  SmbFileInfo,\n  TtsSynthesizeOptions,\n  TtsSynthesizeResult,\n} from \"./ReactNativeKookit.types\";\n\ndeclare class ReactNativeKookitModule extends NativeModule<ReactNativeKookitModuleEvents> {\n  PI: number;\n\n  /**\n   * Returns a hello world string\n   */\n  hello(): string;\n\n  /**\n   * Test async function that sends a change event\n   */\n  setValueAsync(value: string): Promise<void>;\n\n  /**\n   * Enables volume key interception.\n   * On Android, your MainActivity must implement VolumeKeyInterceptActivity interface.\n   * On iOS, this works automatically.\n   *\n   * @throws Error if MainActivity doesn't implement VolumeKeyInterceptActivity on Android\n   */\n  enableVolumeKeyInterception(): void;\n\n  /**\n   * Disables volume key interception\n   */\n  disableVolumeKeyInterception(): void;\n\n  // New FTP Client API Methods\n\n  /**\n   * Create a new FTP client instance\n   * @param clientId Unique identifier for the FTP client\n   * @returns Promise that resolves with client creation result\n   */\n  createFtpClient(clientId: string): Promise<{ clientId: string }>;\n\n  /**\n   * Connect FTP client to server\n   * @param clientId FTP client identifier\n   * @param config FTP connection configuration\n   * @returns Promise that resolves when connected\n   */\n  ftpClientConnect(\n    clientId: string,\n    config: FtpConnectionConfig\n  ): Promise<void>;\n\n  /**\n   * Disconnect FTP client from server\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves when disconnected\n   */\n  ftpClientDisconnect(clientId: string): Promise<void>;\n\n  /**\n   * Dispose FTP client and clean up resources\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves when disposed\n   */\n  disposeFtpClient(clientId: string): Promise<void>;\n\n  /**\n   * List files and directories\n   * @param clientId FTP client identifier\n   * @param path Optional path to list (defaults to current directory)\n   * @returns Promise that resolves with array of file information\n   */\n  ftpClientList(clientId: string, path?: string): Promise<FtpFileInfo[]>;\n\n  /**\n   * Download a file from FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote file path on FTP server\n   * @param localPath Local file path to save the downloaded file\n   * @returns Promise that resolves when download is complete\n   */\n  ftpClientDownload(\n    clientId: string,\n    remotePath: string,\n    localPath: string\n  ): Promise<void>;\n\n  /**\n   * Upload a file to FTP server\n   * @param clientId FTP client identifier\n   * @param localPath Local file path to upload\n   * @param remotePath Remote file path on FTP server\n   * @returns Promise that resolves when upload is complete\n   */\n  ftpClientUpload(\n    clientId: string,\n    localPath: string,\n    remotePath: string\n  ): Promise<void>;\n\n  /**\n   * Delete a file or directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote file or directory path to delete\n   * @param isDirectory Whether the path is a directory (default: false)\n   * @returns Promise that resolves when deletion is complete\n   */\n  ftpClientDelete(\n    clientId: string,\n    remotePath: string,\n    isDirectory?: boolean\n  ): Promise<void>;\n\n  /**\n   * Create a directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote directory path to create\n   * @returns Promise that resolves when directory is created\n   */\n  ftpClientCreateDirectory(clientId: string, remotePath: string): Promise<void>;\n\n  /**\n   * Change current working directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote directory path to change to\n   * @returns Promise that resolves when directory is changed\n   */\n  ftpClientChangeDirectory(clientId: string, remotePath: string): Promise<void>;\n\n  /**\n   * Get current working directory on FTP server\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves with current directory path\n   */\n  ftpClientGetCurrentDirectory(clientId: string): Promise<string>;\n\n  /**\n   * Get FTP client status\n   * @param clientId FTP client identifier\n   * @returns Client status information\n   */\n  getFtpClientStatus(\n    clientId: string\n  ): Promise<{ exists: boolean; connected: boolean }>;\n\n  /**\n   * List all FTP clients\n   * @returns Object containing all clients and their status\n   */\n  listFtpClients(): Promise<{\n    clients: Record<string, { connected: boolean }>;\n    count: number;\n  }>;\n\n  // SMB Client API\n\n  createSmbClient(clientId: string): Promise<{ clientId: string }>;\n  smbClientConnect(\n    clientId: string,\n    config: SmbConnectionConfig\n  ): Promise<void>;\n  smbClientConnectShare(clientId: string, shareName: string): Promise<void>;\n  smbClientDisconnect(clientId: string): Promise<void>;\n  disposeSmbClient(clientId: string): Promise<void>;\n  smbClientList(clientId: string, path?: string): Promise<SmbFileInfo[]>;\n  smbClientDownload(\n    clientId: string,\n    remotePath: string,\n    localPath: string\n  ): Promise<void>;\n  smbClientUpload(\n    clientId: string,\n    localPath: string,\n    remotePath: string\n  ): Promise<void>;\n  smbClientDelete(\n    clientId: string,\n    remotePath: string,\n    isDirectory?: boolean\n  ): Promise<void>;\n  smbClientCreateDirectory(clientId: string, remotePath: string): Promise<void>;\n  getSmbClientStatus(\n    clientId: string\n  ): Promise<{ exists: boolean; connected: boolean }>;\n  listSmbClients(): Promise<{\n    clients: Record<string, { connected: boolean }>;\n    count: number;\n  }>;\n\n  /**\n   * Copy a file from content:// URI to local cache directory.\n   * This method uses Android's ContentResolver to read the file stream,\n   * bypassing permission restrictions when receiving content URIs from other apps.\n   *\n   * @param contentUri The content:// URI received from another app (e.g., via Intent)\n   * @param fileName Optional filename for the destination file. If not provided, tries to extract from URI\n   * @returns Promise that resolves with the local file path (file://)\n   * @platform android\n   */\n  copyContentUriToCache(\n    contentUri: string,\n    fileName?: string\n  ): Promise<{\n    localPath: string;\n    fileName: string;\n    mimeType?: string;\n    size?: number;\n  }>;\n\n  /**\n   * Get metadata about a content:// URI without copying the file.\n   *\n   * @param contentUri The content:// URI to query\n   * @returns Promise that resolves with file metadata\n   * @platform android\n   */\n  getContentUriMetadata(contentUri: string): Promise<{\n    displayName?: string;\n    mimeType?: string;\n    size?: number;\n  }>;\n\n  /**\n   * Synthesize speech from text and save to audio file.\n   * The audio file will be saved in the cache directory under 'tts' folder.\n   *\n   * @param options TTS synthesis options including text, voiceId, language, pitch, and rate\n   * @returns Promise that resolves with file path and duration of the generated audio\n   */\n  synthesizeSpeech(options: TtsSynthesizeOptions): Promise<TtsSynthesizeResult>;\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<ReactNativeKookitModule>(\n  \"ReactNativeKookit\"\n);\n"]}
+{"version":3,"file":"ReactNativeKookitModule.js","sourceRoot":"","sources":["../src/ReactNativeKookitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAsQzD,yDAAyD;AACzD,eAAe,mBAAmB,CAChC,mBAAmB,CACpB,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\n\nimport {\n  ReactNativeKookitModuleEvents,\n  FtpConnectionConfig,\n  FtpFileInfo,\n  SmbConnectionConfig,\n  SmbFileInfo,\n  TtsSynthesizeOptions,\n  TtsSynthesizeResult,\n} from \"./ReactNativeKookit.types\";\n\ndeclare class ReactNativeKookitModule extends NativeModule<ReactNativeKookitModuleEvents> {\n  PI: number;\n\n  /**\n   * Returns a hello world string\n   */\n  hello(): string;\n\n  /**\n   * Test async function that sends a change event\n   */\n  setValueAsync(value: string): Promise<void>;\n\n  /**\n   * Enables volume key interception.\n   * On Android, your MainActivity must implement VolumeKeyInterceptActivity interface.\n   * On iOS, this works automatically.\n   *\n   * @throws Error if MainActivity doesn't implement VolumeKeyInterceptActivity on Android\n   */\n  enableVolumeKeyInterception(): void;\n\n  /**\n   * Disables volume key interception\n   */\n  disableVolumeKeyInterception(): void;\n\n  // New FTP Client API Methods\n\n  /**\n   * Create a new FTP client instance\n   * @param clientId Unique identifier for the FTP client\n   * @returns Promise that resolves with client creation result\n   */\n  createFtpClient(clientId: string): Promise<{ clientId: string }>;\n\n  /**\n   * Connect FTP client to server\n   * @param clientId FTP client identifier\n   * @param config FTP connection configuration\n   * @returns Promise that resolves when connected\n   */\n  ftpClientConnect(\n    clientId: string,\n    config: FtpConnectionConfig,\n  ): Promise<void>;\n\n  /**\n   * Disconnect FTP client from server\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves when disconnected\n   */\n  ftpClientDisconnect(clientId: string): Promise<void>;\n\n  /**\n   * Dispose FTP client and clean up resources\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves when disposed\n   */\n  disposeFtpClient(clientId: string): Promise<void>;\n\n  /**\n   * List files and directories\n   * @param clientId FTP client identifier\n   * @param path Optional path to list (defaults to current directory)\n   * @returns Promise that resolves with array of file information\n   */\n  ftpClientList(clientId: string, path?: string): Promise<FtpFileInfo[]>;\n\n  /**\n   * Download a file from FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote file path on FTP server\n   * @param localPath Local file path to save the downloaded file\n   * @returns Promise that resolves when download is complete\n   */\n  ftpClientDownload(\n    clientId: string,\n    remotePath: string,\n    localPath: string,\n  ): Promise<void>;\n\n  /**\n   * Upload a file to FTP server\n   * @param clientId FTP client identifier\n   * @param localPath Local file path to upload\n   * @param remotePath Remote file path on FTP server\n   * @returns Promise that resolves when upload is complete\n   */\n  ftpClientUpload(\n    clientId: string,\n    localPath: string,\n    remotePath: string,\n  ): Promise<void>;\n\n  /**\n   * Delete a file or directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote file or directory path to delete\n   * @param isDirectory Whether the path is a directory (default: false)\n   * @returns Promise that resolves when deletion is complete\n   */\n  ftpClientDelete(\n    clientId: string,\n    remotePath: string,\n    isDirectory?: boolean,\n  ): Promise<void>;\n\n  /**\n   * Create a directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote directory path to create\n   * @returns Promise that resolves when directory is created\n   */\n  ftpClientCreateDirectory(clientId: string, remotePath: string): Promise<void>;\n\n  /**\n   * Change current working directory on FTP server\n   * @param clientId FTP client identifier\n   * @param remotePath Remote directory path to change to\n   * @returns Promise that resolves when directory is changed\n   */\n  ftpClientChangeDirectory(clientId: string, remotePath: string): Promise<void>;\n\n  /**\n   * Get current working directory on FTP server\n   * @param clientId FTP client identifier\n   * @returns Promise that resolves with current directory path\n   */\n  ftpClientGetCurrentDirectory(clientId: string): Promise<string>;\n\n  /**\n   * Get FTP client status\n   * @param clientId FTP client identifier\n   * @returns Client status information\n   */\n  getFtpClientStatus(\n    clientId: string,\n  ): Promise<{ exists: boolean; connected: boolean }>;\n\n  /**\n   * List all FTP clients\n   * @returns Object containing all clients and their status\n   */\n  listFtpClients(): Promise<{\n    clients: Record<string, { connected: boolean }>;\n    count: number;\n  }>;\n\n  // SMB Client API\n\n  createSmbClient(clientId: string): Promise<{ clientId: string }>;\n  smbClientConnect(\n    clientId: string,\n    config: SmbConnectionConfig,\n  ): Promise<void>;\n  smbClientConnectShare(clientId: string, shareName: string): Promise<void>;\n  smbClientDisconnect(clientId: string): Promise<void>;\n  disposeSmbClient(clientId: string): Promise<void>;\n  smbClientList(clientId: string, path?: string): Promise<SmbFileInfo[]>;\n  smbClientDownload(\n    clientId: string,\n    remotePath: string,\n    localPath: string,\n  ): Promise<void>;\n  smbClientUpload(\n    clientId: string,\n    localPath: string,\n    remotePath: string,\n  ): Promise<void>;\n  smbClientDelete(\n    clientId: string,\n    remotePath: string,\n    isDirectory?: boolean,\n  ): Promise<void>;\n  smbClientCreateDirectory(clientId: string, remotePath: string): Promise<void>;\n  getSmbClientStatus(\n    clientId: string,\n  ): Promise<{ exists: boolean; connected: boolean }>;\n  listSmbClients(): Promise<{\n    clients: Record<string, { connected: boolean }>;\n    count: number;\n  }>;\n\n  /**\n   * Copy a file from content:// URI to local cache directory.\n   * This method uses Android's ContentResolver to read the file stream,\n   * bypassing permission restrictions when receiving content URIs from other apps.\n   *\n   * @param contentUri The content:// URI received from another app (e.g., via Intent)\n   * @param fileName Optional filename for the destination file. If not provided, tries to extract from URI\n   * @returns Promise that resolves with the local file path (file://)\n   * @platform android\n   */\n  copyContentUriToCache(\n    contentUri: string,\n    fileName?: string,\n  ): Promise<{\n    localPath: string;\n    fileName: string;\n    mimeType?: string;\n    size?: number;\n  }>;\n\n  /**\n   * Get metadata about a content:// URI without copying the file.\n   *\n   * @param contentUri The content:// URI to query\n   * @returns Promise that resolves with file metadata\n   * @platform android\n   */\n  getContentUriMetadata(contentUri: string): Promise<{\n    displayName?: string;\n    mimeType?: string;\n    size?: number;\n  }>;\n\n  /**\n   * Synthesize speech from text and save to audio file.\n   * The audio file will be saved in the cache directory under 'tts' folder.\n   *\n   * @param options TTS synthesis options including text, voiceId, language, pitch, and rate\n   * @returns Promise that resolves with file path and duration of the generated audio\n   */\n  synthesizeSpeech(options: TtsSynthesizeOptions): Promise<TtsSynthesizeResult>;\n  /**\n   * Copy a file with security-scoped resource access (iOS only).\n   * Required for accessing files passed via \"Open With\" from external apps.\n   *\n   * @param sourceUri The source file URI (file:// or path)\n   * @param destinationPath The destination file path\n   * @returns Promise that resolves with the local path and success status\n   */\n  copySecurityScopedFile(\n    sourceUri: string,\n    destinationPath: string,\n  ): Promise<{\n    localPath: string;\n    success: boolean;\n  }>;\n  /**\n   * Check if the device is currently playing any audio (music, TTS, or other audio).\n   * Uses AudioManager.isMusicActive() on Android which detects any audio playback.\n   *\n   * @returns Boolean indicating whether audio is currently playing\n   * @platform android\n   */\n  isAudioPlaying(): boolean;\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<ReactNativeKookitModule>(\n  \"ReactNativeKookit\",\n);\n"]}

package/ios/ReactNativeKookitModule.swift

@@ -1548,6 +1548,67 @@ public class ReactNativeKookitModule: Module {
         }
       }
     }
+    // Copy file with security-scoped resource access (for iOS "Open With")
+    AsyncFunction("copySecurityScopedFile") { (sourceUri: String, destinationPath: String, promise: Promise) in
+      DispatchQueue.global(qos: .userInitiated).async {
+        do {
+          // Parse source URL
+          guard let sourceURL = URL(string: sourceUri) ?? URL(fileURLWithPath: sourceUri.replacingOccurrences(of: "file://", with: "")) else {
+            promise.reject("COPY_ERROR", "Invalid source URI: \(sourceUri)")
+            return
+          }
+
+          let destURL = URL(fileURLWithPath: destinationPath.replacingOccurrences(of: "file://", with: ""))
+
+          // Ensure destination directory exists
+          let destDir = destURL.deletingLastPathComponent()
+          try FileManager.default.createDirectory(at: destDir, withIntermediateDirectories: true)
+
+          // Remove existing file at destination
+          if FileManager.default.fileExists(atPath: destURL.path) {
+            try FileManager.default.removeItem(at: destURL)
+          }
+
+          // Start accessing security-scoped resource
+          let didStartAccessing = sourceURL.startAccessingSecurityScopedResource()
+          defer {
+            if didStartAccessing {
+              sourceURL.stopAccessingSecurityScopedResource()
+            }
+          }
+
+          // Use NSFileCoordinator for coordinated read
+          var coordinatorError: NSError?
+          var copyError: Error?
+          let coordinator = NSFileCoordinator()
+
+          coordinator.coordinate(readingItemAt: sourceURL, options: [], error: &coordinatorError) { coordinatedURL in
+            do {
+              try FileManager.default.copyItem(at: coordinatedURL, to: destURL)
+            } catch {
+              copyError = error
+            }
+          }
+
+          if let error = coordinatorError {
+            promise.reject("COPY_ERROR", "File coordination failed: \(error.localizedDescription)")
+            return
+          }
+
+          if let error = copyError {
+            promise.reject("COPY_ERROR", "File copy failed: \(error.localizedDescription)")
+            return
+          }
+
+          promise.resolve([
+            "localPath": destURL.path,
+            "success": true
+          ])
+        } catch {
+          promise.reject("COPY_ERROR", "Unexpected error: \(error.localizedDescription)")
+        }
+      }
+    }
 
     // TTS (Text-to-Speech) Function
     AsyncFunction("synthesizeSpeech") { (options: [String: Any], promise: Promise) in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-kookit",
-  "version": "0.3.8",
+  "version": "0.4.0",
   "description": "React Native module for intercepting volume button presses on iOS and Android, with FTP client functionality",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -31,12 +31,14 @@
     "react-native-kookit",
     "ReactNativeKookit"
   ],
-  "repository": "https://github.com/troyeguo/react-native-kookit",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/troyeguo/react-native-kookit.git"
+  },
   "bugs": {
     "url": "https://github.com/troyeguo/react-native-kookit/issues"
   },
   "author": "troyeguo <13820674+troyeguo@users.noreply.github.com> (https://github.com/troyeguo)",
-  "license": "MIT",
   "homepage": "https://github.com/troyeguo/react-native-kookit#readme",
   "files": [
     "build",
@@ -49,7 +51,6 @@
     "plugin/package.json",
     "*.md"
   ],
-  "dependencies": {},
   "devDependencies": {
     "@expo/config-plugins": "^8.0.0",
     "@types/react": "~19.0.0",
@@ -68,5 +69,9 @@
     "configPlugins": [
       "./app.plugin.js"
     ]
+  },
+  "directories": {
+    "doc": "docs",
+    "example": "example"
   }
 }

package/TTS_CHECKLIST.md

@@ -1,256 +0,0 @@
-# TTS 功能实现检查清单
-
-## ✅ 已完成的任务
-
-### 1. TypeScript 类型定义
-
-- [x] 在 `src/ReactNativeKookit.types.ts` 中添加 `TtsSynthesizeOptions` 类型
-- [x] 在 `src/ReactNativeKookit.types.ts` 中添加 `TtsSynthesizeResult` 类型
-- [x] 类型包含所有必需和可选参数
-- [x] 添加了清晰的注释说明
-
-### 2. TypeScript 模块接口
-
-- [x] 在 `src/ReactNativeKookitModule.ts` 中导入 TTS 类型
-- [x] 声明 `synthesizeSpeech` 方法
-- [x] 添加 JSDoc 注释
-- [x] 正确的类型签名和返回值
-
-### 3. Android 原生实现
-
-- [x] 导入必要的 Android TTS 相关类
-- [x] 添加 TTS 实例变量
-- [x] 实现 `synthesizeSpeech` AsyncFunction
-- [x] TTS 初始化逻辑（异步等待）
-- [x] 语言设置和验证
-- [x] 语音ID支持（可选）
-- [x] 音调和语速设置
-- [x] 创建缓存目录 `tts`
-- [x] 生成唯一文件名（UUID）
-- [x] 合成音频到 WAV 文件
-- [x] 实现 `parseLocale()` 辅助函数
-- [x] 实现 `estimateDuration()` 辅助函数
-- [x] 在 `onDestroy()` 中清理 TTS 资源
-- [x] 完善的错误处理
-
-### 4. iOS 原生实现
-
-- [x] 添加 `AVSpeechSynthesizer` 实例变量
-- [x] 实现 `synthesizeSpeech` AsyncFunction
-- [x] 初始化语音合成器
-- [x] 语言设置和语音选择
-- [x] 支持语音ID（可选）
-- [x] 音调和语速设置
-- [x] 创建缓存目录 `tts`
-- [x] 生成唯一文件名（UUID）
-- [x] 使用 `AVSpeechSynthesizer.write()` 生成音频
-- [x] 实现 `synthesizeSpeechToFile()` 核心方法
-- [x] 实现 `writeBuffersToFile()` 音频写入方法
-- [x] 实现 `estimateDuration()` 辅助函数
-- [x] 使用 async/await 处理异步操作
-- [x] 完善的错误处理
-
-### 5. 导出和集成
-
-- [x] `src/index.ts` 已通过 `export *` 自动导出 TTS 类型
-- [x] 模块可以直接使用
-
-### 6. 示例代码
-
-- [x] 创建 `example/TtsExample.tsx` 完整示例
-- [x] 包含文本输入界面
-- [x] 语言选择功能
-- [x] 音调和语速调整
-- [x] 错误处理展示
-- [x] 结果显示
-- [x] 友好的用户界面
-
-### 7. 文档
-
-- [x] 创建 `docs/TTS_FEATURE.md` 完整文档
-  - API 说明
-  - 使用示例
-  - 平台详情
-  - 支持的语言
-  - 参数指南
-  - 错误处理
-  - 最佳实践
-  - 故障排除
-
-- [x] 创建 `docs/TTS_QUICK_START.md` 快速入门
-  - 快速示例
-  - 常用语言代码
-  - 文件位置说明
-
-- [x] 创建 `docs/TTS_IMPLEMENTATION_SUMMARY.md` 实现总结
-  - 技术细节
-  - 文件清单
-  - 后续改进建议
-
-- [x] 创建 `docs/TTS_README_SECTION.md` README片段
-  - 可直接添加到主README
-
-### 8. 测试和验证
-
-- [x] TypeScript 编译通过
-- [x] 无编译错误
-- [x] 类型检查通过
-- [x] 代码构建成功 (`npm run build`)
-
-## 📋 功能特性验证
-
-### 核心功能
-
-- [x] 文本转语音合成
-- [x] 支持自定义语言
-- [x] 支持音调调整（0.5-2.0）
-- [x] 支持语速调整（0.5-2.0）
-- [x] 可选语音ID
-- [x] 返回文件路径
-- [x] 返回预估时长
-
-### 平台支持
-
-- [x] Android 实现（TextToSpeech API）
-- [x] iOS 实现（AVSpeechSynthesizer）
-- [x] 跨平台统一API
-
-### 文件管理
-
-- [x] 自动创建缓存目录
-- [x] 唯一文件命名（UUID）
-- [x] Android: WAV 格式
-- [x] iOS: CAF 格式
-
-### 开发体验
-
-- [x] TypeScript 完整类型支持
-- [x] Promise-based API
-- [x] 清晰的错误消息
-- [x] 详细的文档
-- [x] 实用的示例
-
-## 📁 文件清单
-
-### 修改的文件（5个）
-
-1. ✅ `src/ReactNativeKookit.types.ts` - TTS类型定义
-2. ✅ `src/ReactNativeKookitModule.ts` - TTS方法声明
-3. ✅ `android/src/main/java/expo/modules/kookit/ReactNativeKookitModule.kt` - Android实现
-4. ✅ `ios/ReactNativeKookitModule.swift` - iOS实现
-5. ✅ `src/index.ts` - 导出（已有 export \*）
-
-### 新增的文件（5个）
-
-1. ✅ `example/TtsExample.tsx` - 完整示例应用
-2. ✅ `docs/TTS_FEATURE.md` - 完整文档
-3. ✅ `docs/TTS_QUICK_START.md` - 快速入门
-4. ✅ `docs/TTS_IMPLEMENTATION_SUMMARY.md` - 实现总结
-5. ✅ `docs/TTS_README_SECTION.md` - README片段
-
-## 🎯 API 使用示例
-
-### 基础使用
-
-```typescript
-const result = await ReactNativeKookitModule.synthesizeSpeech({
-  text: "Hello World",
-});
-```
-
-### 完整参数
-
-```typescript
-const result = await ReactNativeKookitModule.synthesizeSpeech({
-  text: "你好世界",
-  language: "zh-CN",
-  voiceId: "optional-voice-id",
-  pitch: 1.2,
-  rate: 0.9,
-});
-```
-
-### 返回值
-
-```typescript
-{
-  filePath: "/path/to/cache/tts/tts_uuid.wav",  // Android
-  // or
-  filePath: "/path/to/cache/tts/tts_uuid.caf",  // iOS
-  duration: 2.5  // seconds
-}
-```
-
-## ✨ 代码质量
-
-- [x] 遵循项目代码风格
-- [x] 使用 TypeScript 严格类型
-- [x] 完善的错误处理
-- [x] 清晰的变量命名
-- [x] 详细的代码注释
-- [x] 模块化设计
-- [x] 资源清理（Android onDestroy）
-
-## 🔍 测试状态
-
-- [x] TypeScript 编译成功
-- [x] 无语法错误
-- [x] 无类型错误
-- [x] Build 构建成功
-- ⏳ 运行时测试（需要在设备上测试）
-
-## 📦 输出文件
-
-### Android
-
-- **格式**: WAV (PCM)
-- **位置**: `{cacheDir}/tts/`
-- **命名**: `tts_{uuid}.wav`
-- **API**: `TextToSpeech.synthesizeToFile()`
-
-### iOS
-
-- **格式**: CAF (Core Audio Format)
-- **位置**: `{cachesDirectory}/tts/`
-- **命名**: `tts_{uuid}.caf`
-- **API**: `AVSpeechSynthesizer.write()`
-
-## 🌍 语言支持
-
-已文档化的常用语言：
-
-- 英语（en-US, en-GB, en-AU）
-- 中文（zh-CN, zh-TW, zh-HK）
-- 西班牙语（es-ES, es-MX）
-- 法语（fr-FR）
-- 德语（de-DE）
-- 日语（ja-JP）
-- 韩语（ko-KR）
-- 意大利语（it-IT）
-- 葡萄牙语（pt-BR）
-- 俄语（ru-RU）
-- 阿拉伯语（ar-SA）
-
-## 🚀 下一步
-
-建议的后续步骤：
-
-1. 在真实设备上测试 Android 版本
-2. 在真实设备上测试 iOS 版本
-3. 测试多种语言
-4. 验证音频文件质量
-5. 测试边界情况（长文本、特殊字符等）
-6. 考虑添加单元测试
-
-## ✅ 总结
-
-TTS 功能已完全实现，包括：
-
-- ✅ TypeScript 类型和接口定义
-- ✅ Android 原生实现
-- ✅ iOS 原生实现
-- ✅ 完整的示例代码
-- ✅ 详细的文档
-- ✅ 编译通过，无错误
-
-**状态**: 🎉 实现完成，可以使用！