react-native-davoice-tts 1.0.362 → 1.0.364

package/README.md

@@ -138,6 +138,7 @@ The unified API is intended for real voice flows where STT and TTS are part of t
 Common methods:
 
 - `initAll({ locale, model, timeoutMs?, onboardingJsonPath? })`
+- `initTTS({ model })` — initialize only TTS; does not create or start STT
 - `destroyAll()`
 - `start(locale, options?)`
 - `stop()`
@@ -169,6 +170,24 @@ Unified events:
 - `onNewSpeechWAV`
   Android-only remote STT flow event.
 
+### TTS-Only Through the Speech API
+
+Use `initTTS()` when the application needs synthesis/playback without speech
+recognition:
+
+```ts
+import Speech from 'react-native-davoice-tts/speech';
+
+await Speech.setLicense('YOUR_LICENSE_KEY');
+await Speech.initTTS({ model });
+await Speech.speak('Hello world');
+```
+
+On both iOS and Android this path initializes only the standalone TTS engine.
+It does not construct or start the STT engine, request microphone permissions,
+or begin microphone capture. `speak()`, `stopSpeaking()`, `playWav()`, and
+`playBuffer()` remain on the standalone TTS bridge until `initAll()` is used.
+
 ### iOS Permission Helpers
 
 The unified API also exposes iOS permission helpers:

package/TTSRNBridge.podspec

@@ -2,7 +2,7 @@ require 'json'
 
 Pod::Spec.new do |s|
     s.name         = "TTSRNBridge"
-    s.version      = "1.0.288" # Update to your package version
+    s.version      = "1.0.292" # Update to your package version
     s.summary      = "TTS for React Native."
     s.description  = <<-DESC
                      A React Native module for tts .

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -1,2 +1,2 @@
-#Wed Jul 29 17:53:46 IDT 2026
-gradle.version=9.2.0
+#Mon Aug 17 12:10:54 IDT 2026
+gradle.version=8.9

package/android/libs/com/davoice/tts/1.0.0/tts-1.0.0.aar.md5

@@ -1 +1 @@
-df8b1b6ae1a732a2ee67656b7879677d  tts-1.0.0.aar
+20bac695ad8c44a85e5ca9ece89a26bc  tts-1.0.0.aar

package/android/libs/com/davoice/tts/1.0.0/tts-1.0.0.aar.sha1

@@ -1 +1 @@
-00a559125ed3cc276def548fdacf9661ddeebefb  tts-1.0.0.aar
+0d733323fe3b29e2ac003a9e677fac17fee18c31  tts-1.0.0.aar

package/android/src/main/java/com/davoice/stt/rn/STTModule.kt

@@ -59,7 +59,9 @@ class STTModule(private val rc: ReactApplicationContext)
         promise.reject("invalid_args", "Missing licenseKey")
         return
       }
-      promise.resolve(ensure().setLicenseKey(licenseKey))
+      // Licensing is process-global. Do not construct STT merely to store the
+      // key: Speech.initTTS() must remain a genuinely TTS-only path.
+      promise.resolve(LicenseManager.setLicenseKey(licenseKey))
     } catch (t: Throwable) {
       promise.reject("LicenseError", t.message, t)
     }

package/ios/SpeechBridge/SpeechBridge.m

@@ -403,8 +403,9 @@ RCT_EXPORT_METHOD(setLicense:(NSString *)licenseKey
   dispatch_async(dispatch_get_main_queue(), ^{
     self.lastLicenseKey = licenseKey;
     BOOL ttsOk = [DaVoiceTTS activateLicenseWithLicenseKey:licenseKey];
-    [self ensureSTT];
-    BOOL sttOk = [self.stt setLicenseWithLicenseKey:licenseKey];
+    // Keep licensing side-effect free. initAll()/the explicit STT APIs create
+    // STT through ensureSTT(), which reapplies lastLicenseKey at that point.
+    BOOL sttOk = self.stt ? [self.stt setLicenseWithLicenseKey:licenseKey] : YES;
     resolve(@(ttsOk && sttOk));
   });
 }

package/ios/TTSRNBridge/DaVoiceTTSBridge.m

@@ -2,6 +2,62 @@
 #import "DaVoiceTTSBridge.h"
 #import <React/RCTLog.h>
 #import <React/RCTConvert.h>
+#import <AVFAudio/AVFAudio.h>
+
+static NSData *DTTSBase64Decode(NSString *base64) {
+  if (!base64 || (id)base64 == [NSNull null]) return nil;
+  return [[NSData alloc] initWithBase64EncodedString:base64 options:0];
+}
+
+static AVAudioPCMBuffer *DTTSMakeMonoF32Buffer(NSData *raw,
+                                               double sampleRate,
+                                               NSString *format,
+                                               NSInteger channels,
+                                               BOOL interleaved)
+{
+  if (!raw || raw.length == 0 || sampleRate <= 0 || channels < 1) return nil;
+
+  AVAudioFormat *outputFormat = [[AVAudioFormat alloc] initStandardFormatWithSampleRate:sampleRate
+                                                                               channels:1];
+  NSString *normalizedFormat = format.lowercaseString;
+  NSUInteger bytesPerSample = [normalizedFormat isEqualToString:@"i16"] ? 2 :
+                              ([normalizedFormat isEqualToString:@"f32"] ? 4 : 0);
+  if (bytesPerSample == 0 || raw.length % (bytesPerSample * channels) != 0) return nil;
+
+  NSUInteger frameCount = raw.length / (bytesPerSample * channels);
+  AVAudioPCMBuffer *buffer = [[AVAudioPCMBuffer alloc] initWithPCMFormat:outputFormat
+                                                           frameCapacity:(AVAudioFrameCount)frameCount];
+  buffer.frameLength = (AVAudioFrameCount)frameCount;
+  float *output = buffer.floatChannelData[0];
+
+  if ([normalizedFormat isEqualToString:@"i16"]) {
+    const int16_t *input = (const int16_t *)raw.bytes;
+    for (NSUInteger frame = 0; frame < frameCount; ++frame) {
+      int64_t sum = 0;
+      for (NSInteger channel = 0; channel < channels; ++channel) {
+        NSUInteger index = interleaved || channels == 1
+          ? frame * channels + channel
+          : channel * frameCount + frame;
+        sum += input[index];
+      }
+      output[frame] = (float)(sum / (double)channels) / 32768.0f;
+    }
+  } else {
+    const float *input = (const float *)raw.bytes;
+    for (NSUInteger frame = 0; frame < frameCount; ++frame) {
+      double sum = 0;
+      for (NSInteger channel = 0; channel < channels; ++channel) {
+        NSUInteger index = interleaved || channels == 1
+          ? frame * channels + channel
+          : channel * frameCount + frame;
+        sum += input[index];
+      }
+      output[frame] = (float)(sum / channels);
+    }
+  }
+
+  return buffer;
+}
 
 @interface DaVoiceTTSBridge()
 @property (nonatomic, strong, nullable) DaVoiceTTS *ttsInstance;
@@ -56,6 +112,33 @@ RCT_EXPORT_MODULE();
   return self;
 }
 
+- (NSURL *)resolveLocalURLFromPathOrURL:(NSString *)pathOrURL
+{
+  if (!pathOrURL || (id)pathOrURL == [NSNull null] || pathOrURL.length == 0) return nil;
+
+  if ([pathOrURL hasPrefix:@"http://"] || [pathOrURL hasPrefix:@"https://"]) {
+    NSURL *remoteURL = [NSURL URLWithString:pathOrURL];
+    NSData *data = remoteURL ? [NSData dataWithContentsOfURL:remoteURL] : nil;
+    if (!data) return nil;
+    NSString *extension = remoteURL.pathExtension.length ? remoteURL.pathExtension : @"bin";
+    NSString *name = [NSString stringWithFormat:@"rn_asset_%f.%@",
+                      [[NSDate date] timeIntervalSince1970], extension];
+    NSString *path = [NSTemporaryDirectory() stringByAppendingPathComponent:name];
+    return [data writeToFile:path atomically:YES] ? [NSURL fileURLWithPath:path] : nil;
+  }
+
+  if ([pathOrURL hasPrefix:@"file://"]) return [NSURL URLWithString:pathOrURL];
+
+  if ([pathOrURL hasPrefix:@"asset:/"]) {
+    NSString *assetName = [pathOrURL substringFromIndex:@"asset:/".length];
+    NSString *bundlePath = [[NSBundle mainBundle] pathForResource:assetName.stringByDeletingPathExtension
+                                                           ofType:assetName.pathExtension];
+    return bundlePath ? [NSURL fileURLWithPath:bundlePath] : nil;
+  }
+
+  return [NSURL fileURLWithPath:pathOrURL];
+}
+
 RCT_EXPORT_METHOD(setLicense:(NSString *)licenseKey
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
@@ -99,9 +182,11 @@ RCT_EXPORT_METHOD(initTTS:(NSDictionary *)configDict
     return;
   }
 
-  NSURL *modelURL = [modelPath hasPrefix:@"file://"]
-    ? [NSURL URLWithString:modelPath]
-    : [NSURL fileURLWithPath:modelPath];
+  NSURL *modelURL = [self resolveLocalURLFromPathOrURL:modelPath];
+  if (!modelURL) {
+    reject(@"bad_model", [NSString stringWithFormat:@"Could not resolve model path: %@", modelPath], nil);
+    return;
+  }
 
   dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
     NSError *error = nil;
@@ -179,6 +264,62 @@ RCT_EXPORT_METHOD(initTTS:(NSDictionary *)configDict
     });
   }
 
+  RCT_EXPORT_METHOD(playWav:(NSString *)pathOrURL
+                    markAsLast:(nonnull NSNumber *)markAsLast
+                    resolver:(RCTPromiseResolveBlock)resolve
+                    rejecter:(RCTPromiseRejectBlock)reject)
+  {
+    if (!self.ttsInstance) {
+      reject(@"no_instance", @"TTS not initialized", nil);
+      return;
+    }
+
+    NSURL *fileURL = [self resolveLocalURLFromPathOrURL:pathOrURL];
+    if (!fileURL || ![[NSFileManager defaultManager] fileExistsAtPath:fileURL.path]) {
+      reject(@"file_missing", [NSString stringWithFormat:@"File missing: %@", fileURL.path ?: pathOrURL], nil);
+      return;
+    }
+
+    [self.ttsInstance playWav:fileURL markAsLastUtterance:markAsLast.boolValue];
+    resolve(@"queued");
+  }
+
+  RCT_EXPORT_METHOD(playBuffer:(NSDictionary *)description
+                    resolver:(RCTPromiseResolveBlock)resolve
+                    rejecter:(RCTPromiseRejectBlock)reject)
+  {
+    if (!self.ttsInstance) {
+      reject(@"no_instance", @"TTS not initialized", nil);
+      return;
+    }
+
+    NSString *base64 = [RCTConvert NSString:description[@"base64"]];
+    NSNumber *sampleRate = [RCTConvert NSNumber:description[@"sampleRate"]];
+    NSString *format = [RCTConvert NSString:description[@"format"]];
+    NSNumber *channels = description[@"channels"] ? [RCTConvert NSNumber:description[@"channels"]] : @(1);
+    NSNumber *interleaved = description[@"interleaved"] ? [RCTConvert NSNumber:description[@"interleaved"]] : @(YES);
+    NSNumber *markAsLast = description[@"markAsLast"] ? [RCTConvert NSNumber:description[@"markAsLast"]] : @(YES);
+
+    if (!base64 || !sampleRate || !format) {
+      reject(@"invalid_args", @"Missing one of base64/sampleRate/format", nil);
+      return;
+    }
+
+    NSData *raw = DTTSBase64Decode(base64);
+    AVAudioPCMBuffer *buffer = DTTSMakeMonoF32Buffer(raw,
+                                                     sampleRate.doubleValue,
+                                                     format,
+                                                     channels.integerValue,
+                                                     interleaved.boolValue);
+    if (!buffer) {
+      reject(@"bad_buffer", @"Unsupported PCM layout, invalid base64, or empty data", nil);
+      return;
+    }
+
+    [self.ttsInstance playBuffer:buffer markAsLastUtterance:markAsLast.boolValue];
+    resolve(@"queued");
+  }
+
   RCT_EXPORT_METHOD(destroy:(RCTPromiseResolveBlock)resolve
                     rejecter:(RCTPromiseRejectBlock)reject)
   {