react-native-kookit 0.3.5 → 0.3.7

package/README.md

@@ -1,6 +1,27 @@
 # react-native-kookit
 
-A React Native module for intercepting volume button presses on both iOS and Android platforms.
+A comprehensive React Native/Expo module with multiple utilities for Android and iOS.
+
+## Features
+
+- 🎵 **Volume Key Interception** - Capture volume button presses on both iOS and Android
+- 📁 **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
+
+### Content URI Handler
+
+The Content URI Handler solves a common Android problem: when receiving files via "Open with" or "Share" intents, apps receive `content://` URIs that often trigger `SecurityException: Permission Denial` errors.
+
+**Key Benefits:**
+
+- ✅ Bypass permission restrictions using Android's ContentResolver
+- ✅ No `READ_EXTERNAL_STORAGE` permission needed
+- ✅ Works with all third-party apps and file managers
+- ✅ Get file metadata (name, size, MIME type)
+- ✅ Copy to app cache directory for further processing
+
+📖 [**View Content URI Handler Documentation**](./docs/CONTENT_URI_HANDLER.md)
 
 # API documentation
 

package/TTS_CHECKLIST.md

@@ -0,0 +1,256 @@
+# 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 原生实现
+- ✅ 完整的示例代码
+- ✅ 详细的文档
+- ✅ 编译通过，无错误
+
+**状态**: 🎉 实现完成，可以使用！

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

@@ -11,6 +11,17 @@ import expo.modules.kotlin.exception.Exceptions
 import expo.modules.kotlin.Promise
 import kotlinx.coroutines.*
 import java.net.URL
+import android.net.Uri
+import android.provider.OpenableColumns
+import android.database.Cursor
+import java.io.File
+import java.io.FileOutputStream
+import java.io.InputStream
+import android.speech.tts.TextToSpeech
+import android.speech.tts.UtteranceProgressListener
+import android.os.Bundle
+import java.util.Locale
+import java.util.UUID
 
 class ReactNativeKookitModule : Module() {
   private var isVolumeListenerEnabled = false
@@ -20,6 +31,8 @@ class ReactNativeKookitModule : Module() {
   private val ftpClients = mutableMapOf<String, FtpClient>()
   private val smbClients = mutableMapOf<String, SmbClient>()
   private val moduleScope = CoroutineScope(Dispatchers.Main + SupervisorJob())
+  private var textToSpeech: TextToSpeech? = null
+  private var ttsInitialized = false
 
   // Each module class must implement the definition function. The definition consists of components
   // that describes the module's functionality and behavior.
@@ -723,6 +736,204 @@ class ReactNativeKookitModule : Module() {
       }
     }
 
+    // ContentResolver functions for handling content:// URIs
+    AsyncFunction("copyContentUriToCache") { contentUri: String, fileName: String?, promise: Promise ->
+      moduleScope.launch(Dispatchers.IO) {
+        try {
+          val context = appContext.reactContext ?: throw Exception("React context is not available")
+          val uri = Uri.parse(contentUri)
+          
+          if (uri.scheme != "content") {
+            throw Exception("Only content:// URIs are supported. Received: ${uri.scheme}://")
+          }
+
+          // Get metadata from ContentResolver
+          val metadata = getContentUriMetadataInternal(context, uri)
+          
+          // Determine file name
+          val finalFileName = fileName ?: metadata["displayName"] as? String 
+            ?: "file_${System.currentTimeMillis()}"
+          
+          // Create destination file in cache directory
+          val cacheDir = context.cacheDir
+          val destFile = File(cacheDir, finalFileName)
+          
+          // Copy file using ContentResolver InputStream
+          var inputStream: InputStream? = null
+          var outputStream: FileOutputStream? = null
+          var totalBytes = 0L
+          
+          try {
+            inputStream = context.contentResolver.openInputStream(uri)
+              ?: throw Exception("Failed to open input stream for URI: $contentUri")
+            
+            outputStream = FileOutputStream(destFile)
+            val buffer = ByteArray(8192)
+            var bytesRead: Int
+            
+            while (inputStream.read(buffer).also { bytesRead = it } != -1) {
+              outputStream.write(buffer, 0, bytesRead)
+              totalBytes += bytesRead
+            }
+            
+            outputStream.flush()
+            
+            // Build result
+            val result = mapOf(
+              "localPath" to destFile.absolutePath,
+              "fileName" to finalFileName,
+              "mimeType" to metadata["mimeType"],
+              "size" to totalBytes
+            )
+            
+            withContext(Dispatchers.Main) { promise.resolve(result) }
+          } finally {
+            inputStream?.close()
+            outputStream?.close()
+          }
+        } catch (e: Exception) {
+          withContext(Dispatchers.Main) { 
+            promise.reject("COPY_CONTENT_URI_ERROR", "Failed to copy content URI: ${e.message}", e) 
+          }
+        }
+      }
+    }
+
+    AsyncFunction("getContentUriMetadata") { contentUri: String, promise: Promise ->
+      moduleScope.launch(Dispatchers.IO) {
+        try {
+          val context = appContext.reactContext ?: throw Exception("React context is not available")
+          val uri = Uri.parse(contentUri)
+          
+          if (uri.scheme != "content") {
+            throw Exception("Only content:// URIs are supported. Received: ${uri.scheme}://")
+          }
+
+          val metadata = getContentUriMetadataInternal(context, uri)
+          withContext(Dispatchers.Main) { promise.resolve(metadata) }
+        } catch (e: Exception) {
+          withContext(Dispatchers.Main) { 
+            promise.reject("GET_CONTENT_URI_METADATA_ERROR", "Failed to get metadata: ${e.message}", e) 
+          }
+        }
+      }
+    }
+
+    // TTS (Text-to-Speech) Function
+    AsyncFunction("synthesizeSpeech") { options: Map<String, Any?>, promise: Promise ->
+      moduleScope.launch(Dispatchers.IO) {
+        try {
+          val context = appContext.reactContext ?: throw Exception("React context is not available")
+          
+          val text = options["text"] as? String ?: throw Exception("Text is required")
+          val voiceId = options["voiceId"] as? String
+          val language = options["language"] as? String ?: "en-US"
+          val pitch = (options["pitch"] as? Double)?.toFloat() ?: 1.0f
+          val rate = (options["rate"] as? Double)?.toFloat() ?: 1.0f
+          
+          // Initialize TTS if not already initialized
+          if (textToSpeech == null) {
+            val latch = CompletableDeferred<Boolean>()
+            withContext(Dispatchers.Main) {
+              textToSpeech = TextToSpeech(context) { status ->
+                if (status == TextToSpeech.SUCCESS) {
+                  ttsInitialized = true
+                  latch.complete(true)
+                } else {
+                  latch.completeExceptionally(Exception("TTS initialization failed"))
+                }
+              }
+            }
+            latch.await()
+          }
+          
+          // Set language
+          val locale = parseLocale(language)
+          val result = textToSpeech?.setLanguage(locale)
+          if (result == TextToSpeech.LANG_MISSING_DATA || result == TextToSpeech.LANG_NOT_SUPPORTED) {
+            throw Exception("Language not supported: $language")
+          }
+          
+          // Set voice if specified
+          if (voiceId != null) {
+            val voices = textToSpeech?.voices
+            val voice = voices?.find { it.name == voiceId }
+            if (voice != null) {
+              textToSpeech?.voice = voice
+            }
+          }
+          
+          // Set pitch and rate
+          textToSpeech?.setPitch(pitch)
+          textToSpeech?.setSpeechRate(rate)
+          
+          // Create TTS cache directory
+          val ttsDir = File(context.cacheDir, "tts")
+          if (!ttsDir.exists()) {
+            ttsDir.mkdirs()
+          }
+          
+          // Generate unique filename
+          val fileName = "tts_${UUID.randomUUID()}.wav"
+          val outputFile = File(ttsDir, fileName)
+          
+          // Synthesize to file
+          val utteranceId = UUID.randomUUID().toString()
+          val synthesisLatch = CompletableDeferred<String>()
+          
+          withContext<Unit>(Dispatchers.Main) {
+            textToSpeech?.setOnUtteranceProgressListener(object : UtteranceProgressListener() {
+              override fun onStart(uId: String?) {}
+              
+              override fun onDone(id: String?) {
+                if (id == utteranceId) {
+                  synthesisLatch.complete(outputFile.absolutePath)
+                }
+              }
+              
+              @Deprecated("Deprecated in Java", ReplaceWith("onError(String)"))
+              override fun onError(uId: String?) {
+                synthesisLatch.completeExceptionally(Exception("TTS synthesis failed"))
+              }
+              
+              override fun onError(uId: String?, errorCode: Int) {
+                synthesisLatch.completeExceptionally(Exception("TTS synthesis failed with code: $errorCode"))
+              }
+            })
+            
+            val params = Bundle().apply {
+              putString(TextToSpeech.Engine.KEY_PARAM_UTTERANCE_ID, utteranceId)
+            }
+            
+            @Suppress("DEPRECATION")
+            textToSpeech?.synthesizeToFile(text, params, outputFile, utteranceId)
+          }
+          
+          val filePath = synthesisLatch.await()
+          
+          // Get file duration (approximate based on text length and rate)
+          val duration = estimateDuration(text, rate)
+          
+          withContext(Dispatchers.Main) {
+            promise.resolve(mapOf(
+              "filePath" to filePath,
+              "duration" to duration
+            ))
+          }
+        } catch (e: Exception) {
+          withContext(Dispatchers.Main) {
+            promise.reject("TTS_SYNTHESIS_ERROR", "Failed to synthesize speech: ${e.message}", e)
+          }
+        }
+      }
+    }
+
+    // Cleanup when module is destroyed
+    OnDestroy {
+      textToSpeech?.shutdown()
+      textToSpeech = null
+    }
+
     // Enables the module to be used as a native view. Definition components that are accepted as part of
     // the view definition: Prop, Events.
     View(ReactNativeKookitView::class) {
@@ -789,4 +1000,77 @@ class ReactNativeKookitModule : Module() {
       // Context might be lost, ignore
     }
   }
+
+  /**
+   * Internal helper to query content URI metadata using ContentResolver
+   */
+  private fun getContentUriMetadataInternal(context: Context, uri: Uri): Map<String, Any?> {
+    var cursor: Cursor? = null
+    try {
+      cursor = context.contentResolver.query(
+        uri,
+        arrayOf(
+          OpenableColumns.DISPLAY_NAME,
+          OpenableColumns.SIZE
+        ),
+        null,
+        null,
+        null
+      )
+
+      var displayName: String? = null
+      var size: Long? = null
+
+      cursor?.use {
+        if (it.moveToFirst()) {
+          val nameIndex = it.getColumnIndex(OpenableColumns.DISPLAY_NAME)
+          val sizeIndex = it.getColumnIndex(OpenableColumns.SIZE)
+          
+          if (nameIndex != -1) {
+            displayName = it.getString(nameIndex)
+          }
+          
+          if (sizeIndex != -1 && !it.isNull(sizeIndex)) {
+            size = it.getLong(sizeIndex)
+          }
+        }
+      }
+
+      // Get MIME type
+      val mimeType = context.contentResolver.getType(uri)
+
+      return mapOf(
+        "displayName" to displayName,
+        "mimeType" to mimeType,
+        "size" to size
+      )
+    } catch (e: Exception) {
+      throw Exception("Failed to query content URI metadata: ${e.message}", e)
+    } finally {
+      cursor?.close()
+    }
+  }
+
+  /**
+   * Parse locale string (e.g., "en-US", "zh-CN") to Locale object
+   */
+  private fun parseLocale(localeString: String): Locale {
+    val parts = localeString.split("-", "_")
+    return when (parts.size) {
+      1 -> Locale(parts[0])
+      2 -> Locale(parts[0], parts[1])
+      else -> Locale(parts[0], parts[1], parts[2])
+    }
+  }
+
+  /**
+   * Estimate audio duration based on text length and speech rate
+   * This is a rough estimation: average speaking rate is about 150 words per minute
+   */
+  private fun estimateDuration(text: String, rate: Float): Double {
+    val wordCount = text.split("\\s+".toRegex()).size
+    val baseMinutes = wordCount / 150.0
+    val durationSeconds = (baseMinutes * 60.0) / rate
+    return durationSeconds
+  }
 }

package/build/ReactNativeKookit.types.d.ts

@@ -96,4 +96,15 @@ export type SmbEventPayload = {
     onComplete?: () => void;
     onError?: (error: string) => void;
 };
+export type TtsSynthesizeOptions = {
+    text: string;
+    voiceId?: string;
+    language?: string;
+    pitch?: number;
+    rate?: number;
+};
+export type TtsSynthesizeResult = {
+    filePath: string;
+    duration?: number;
+};
 //# sourceMappingURL=ReactNativeKookit.types.d.ts.map

package/build/ReactNativeKookit.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeKookit.types.d.ts","sourceRoot":"","sources":["../src/ReactNativeKookit.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C,qBAAqB,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC/D,aAAa,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,aAAa,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAE5C,aAAa,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,aAAa,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,kBAAkB,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAGF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC"}
+{"version":3,"file":"ReactNativeKookit.types.d.ts","sourceRoot":"","sources":["../src/ReactNativeKookit.types.ts"],"names":[],"mappings":"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"}

package/build/ReactNativeKookit.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeKookit.types.js","sourceRoot":"","sources":["../src/ReactNativeKookit.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StyleProp, ViewStyle } from \"react-native\";\n\nexport type OnLoadEventPayload = {\n  url: string;\n};\n\nexport type VolumeKeyEventPayload = {\n  key: \"up\" | \"down\";\n};\n\nexport type FtpConnectionConfig = {\n  host: string;\n  port?: number;\n  username: string;\n  password: string;\n  passive?: boolean;\n  timeout?: number;\n};\n\nexport type FtpFileInfo = {\n  name: string;\n  isDirectory: boolean;\n  size: number;\n  lastModified: string;\n  permissions?: string;\n};\n\nexport type FtpProgressInfo = {\n  transferred: number;\n  total: number;\n  percentage: number;\n};\n\nexport type FtpProgressEvent = FtpProgressInfo & {\n  clientId: string;\n};\n\nexport type FtpCompleteEvent = {\n  clientId: string;\n};\n\nexport type FtpErrorEvent = {\n  clientId: string;\n  error: string;\n};\n\nexport type FtpEventPayload = {\n  onProgress?: (progress: FtpProgressInfo) => void;\n  onComplete?: () => void;\n  onError?: (error: string) => void;\n};\n\nexport type ReactNativeKookitModuleEvents = {\n  onChange: (params: ChangeEventPayload) => void;\n  onVolumeButtonPressed: (params: VolumeKeyEventPayload) => void;\n  onFtpProgress: (params: FtpProgressEvent) => void;\n  onFtpComplete: (params: FtpCompleteEvent) => void;\n  onFtpError: (params: FtpErrorEvent) => void;\n  // SMB events (reserved for future file operations parity)\n  onSmbProgress: (params: SmbProgressEvent) => void;\n  onSmbComplete: (params: SmbCompleteEvent) => void;\n  onSmbError: (params: SmbErrorEvent) => void;\n};\n\nexport type ChangeEventPayload = {\n  value: string;\n};\n\nexport type ReactNativeKookitViewProps = {\n  url: string;\n  onLoad: (event: { nativeEvent: OnLoadEventPayload }) => void;\n  style?: StyleProp<ViewStyle>;\n};\n\n// SMB API parity with FTP (OOP new-client style)\nexport type SmbConnectionConfig = {\n  host: string;\n  port?: number; // default 445\n  username: string;\n  password: string;\n  domain?: string; // optional Windows domain or workgroup\n  share?: string; // optional default share to open\n  timeout?: number; // ms\n};\n\nexport type SmbFileInfo = {\n  name: string;\n  isDirectory: boolean;\n  size: number;\n  lastModified?: string;\n  attributes?: string;\n};\n\nexport type SmbProgressInfo = {\n  transferred: number;\n  total: number;\n  percentage: number;\n};\n\nexport type SmbProgressEvent = SmbProgressInfo & {\n  clientId: string;\n};\n\nexport type SmbCompleteEvent = {\n  clientId: string;\n};\n\nexport type SmbErrorEvent = {\n  clientId: string;\n  error: string;\n};\n\nexport type SmbEventPayload = {\n  onProgress?: (progress: SmbProgressInfo) => void;\n  onComplete?: () => void;\n  onError?: (error: string) => void;\n};\n"]}
+{"version":3,"file":"ReactNativeKookit.types.js","sourceRoot":"","sources":["../src/ReactNativeKookit.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StyleProp, ViewStyle } from \"react-native\";\n\nexport type OnLoadEventPayload = {\n  url: string;\n};\n\nexport type VolumeKeyEventPayload = {\n  key: \"up\" | \"down\";\n};\n\nexport type FtpConnectionConfig = {\n  host: string;\n  port?: number;\n  username: string;\n  password: string;\n  passive?: boolean;\n  timeout?: number;\n};\n\nexport type FtpFileInfo = {\n  name: string;\n  isDirectory: boolean;\n  size: number;\n  lastModified: string;\n  permissions?: string;\n};\n\nexport type FtpProgressInfo = {\n  transferred: number;\n  total: number;\n  percentage: number;\n};\n\nexport type FtpProgressEvent = FtpProgressInfo & {\n  clientId: string;\n};\n\nexport type FtpCompleteEvent = {\n  clientId: string;\n};\n\nexport type FtpErrorEvent = {\n  clientId: string;\n  error: string;\n};\n\nexport type FtpEventPayload = {\n  onProgress?: (progress: FtpProgressInfo) => void;\n  onComplete?: () => void;\n  onError?: (error: string) => void;\n};\n\nexport type ReactNativeKookitModuleEvents = {\n  onChange: (params: ChangeEventPayload) => void;\n  onVolumeButtonPressed: (params: VolumeKeyEventPayload) => void;\n  onFtpProgress: (params: FtpProgressEvent) => void;\n  onFtpComplete: (params: FtpCompleteEvent) => void;\n  onFtpError: (params: FtpErrorEvent) => void;\n  // SMB events (reserved for future file operations parity)\n  onSmbProgress: (params: SmbProgressEvent) => void;\n  onSmbComplete: (params: SmbCompleteEvent) => void;\n  onSmbError: (params: SmbErrorEvent) => void;\n};\n\nexport type ChangeEventPayload = {\n  value: string;\n};\n\nexport type ReactNativeKookitViewProps = {\n  url: string;\n  onLoad: (event: { nativeEvent: OnLoadEventPayload }) => void;\n  style?: StyleProp<ViewStyle>;\n};\n\n// SMB API parity with FTP (OOP new-client style)\nexport type SmbConnectionConfig = {\n  host: string;\n  port?: number; // default 445\n  username: string;\n  password: string;\n  domain?: string; // optional Windows domain or workgroup\n  share?: string; // optional default share to open\n  timeout?: number; // ms\n};\n\nexport type SmbFileInfo = {\n  name: string;\n  isDirectory: boolean;\n  size: number;\n  lastModified?: string;\n  attributes?: string;\n};\n\nexport type SmbProgressInfo = {\n  transferred: number;\n  total: number;\n  percentage: number;\n};\n\nexport type SmbProgressEvent = SmbProgressInfo & {\n  clientId: string;\n};\n\nexport type SmbCompleteEvent = {\n  clientId: string;\n};\n\nexport type SmbErrorEvent = {\n  clientId: string;\n  error: string;\n};\n\nexport type SmbEventPayload = {\n  onProgress?: (progress: SmbProgressInfo) => void;\n  onComplete?: () => void;\n  onError?: (error: string) => void;\n};\n\n// TTS (Text-to-Speech) API\nexport type TtsSynthesizeOptions = {\n  text: string;\n  voiceId?: string; // Voice identifier (platform-specific)\n  language?: string; // Language code (e.g., 'en-US', 'zh-CN')\n  pitch?: number; // Pitch (0.5 - 2.0, default: 1.0)\n  rate?: number; // Speech rate (0.5 - 2.0, default: 1.0)\n};\n\nexport type TtsSynthesizeResult = {\n  filePath: string; // Path to the generated audio file\n  duration?: number; // Duration in seconds (if available)\n};\n"]}

package/build/ReactNativeKookitModule.d.ts

@@ -1,5 +1,5 @@
 import { NativeModule } from "expo";
-import { ReactNativeKookitModuleEvents, FtpConnectionConfig, FtpFileInfo, SmbConnectionConfig, SmbFileInfo } from "./ReactNativeKookit.types";
+import { ReactNativeKookitModuleEvents, FtpConnectionConfig, FtpFileInfo, SmbConnectionConfig, SmbFileInfo, TtsSynthesizeOptions, TtsSynthesizeResult } from "./ReactNativeKookit.types";
 declare class ReactNativeKookitModule extends NativeModule<ReactNativeKookitModuleEvents> {
     PI: number;
     /**
@@ -141,6 +141,42 @@ declare class ReactNativeKookitModule extends NativeModule<ReactNativeKookitModu
         }>;
         count: number;
     }>;
+    /**
+     * Copy a file from content:// URI to local cache directory.
+     * This method uses Android's ContentResolver to read the file stream,
+     * bypassing permission restrictions when receiving content URIs from other apps.
+     *
+     * @param contentUri The content:// URI received from another app (e.g., via Intent)
+     * @param fileName Optional filename for the destination file. If not provided, tries to extract from URI
+     * @returns Promise that resolves with the local file path (file://)
+     * @platform android
+     */
+    copyContentUriToCache(contentUri: string, fileName?: string): Promise<{
+        localPath: string;
+        fileName: string;
+        mimeType?: string;
+        size?: number;
+    }>;
+    /**
+     * Get metadata about a content:// URI without copying the file.
+     *
+     * @param contentUri The content:// URI to query
+     * @returns Promise that resolves with file metadata
+     * @platform android
+     */
+    getContentUriMetadata(contentUri: string): Promise<{
+        displayName?: string;
+        mimeType?: string;
+        size?: number;
+    }>;
+    /**
+     * Synthesize speech from text and save to audio file.
+     * The audio file will be saved in the cache directory under 'tts' folder.
+     *
+     * @param options TTS synthesis options including text, voiceId, language, pitch, and rate
+     * @returns Promise that resolves with file path and duration of the generated audio
+     */
+    synthesizeSpeech(options: TtsSynthesizeOptions): Promise<TtsSynthesizeResult>;
 }
 declare const _default: ReactNativeKookitModule;
 export default _default;