apps-sdk 2.1.0 → 2.1.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "apps-sdk",
-  "version": "2.1.0",
-  "description": "Apps SDK - Compatible with Expo SDK 54 + React 19 - Firebase optional",
+  "version": "2.1.1",
+  "description": "Apps SDK - Compatible with Expo SDK 54 + React 19 - create User pre url",
   "main": "index.js",
   "author": "ASD",
   "license": "ISC",

package/src/libraries/Session.js

@@ -26,10 +26,15 @@ class Session {
     }
 
     setConfigEndpoint = (endpoint) => {
-        config.DEBUG_MODE && console.debug("setInitEndpoint - endpoint: ", endpoint);
+        config.DEBUG_MODE && console.debug("setConfigEndpoint - endpoint: ", endpoint);
         config.ENDPOINTS.CONFIG = endpoint;
     }
 
+    setUserCreateEndpoint = (endpoint) => {
+        config.DEBUG_MODE && console.debug("setUserCreateEndpoint - endpoint: ", endpoint);
+        config.ENDPOINTS.USER_CREATE_ID = endpoint;
+    }
+
     initSession = async () => {
         config.DEBUG_MODE && console.debug("initSession");
         await Networking.sendEvent(config.EVENT_TYPES.OTHER, 'init_session');

package/src/libraries/Voice.js

@@ -5,16 +5,75 @@ import * as Speech from 'expo-speech';
 import { franc } from 'franc-min';
 import Networking from './Networking';
 import MixPanel from './MixPanel';
+import { Platform } from 'react-native';
+
+const ANDROID_STOP_DELAY_MS = 400;
 
 class VoiceService {
     constructor() {
         this.inactivityTimeout = null;
-        this.resultListener = null;
-        this.volumeListener = null;
+
+        // Tracked listeners — always removed before re-registering
+        this.startListener    = null;
+        this.resultListener   = null;
+        this.errorListener    = null;
+        this.volumeListener   = null;
+
+        // State flags used to prevent race conditions
         this.isRecognizing = false;
+        this.isStarting    = false;
+        this.isStopping    = false;
+
+        // Android delivers speech in segments; we accumulate finalized segments here
+        // so callers always receive the full transcript, not just the latest chunk.
+        this._committedTranscript = '';
+    }
+
+    // ─────────────────────────────────────────────
+    // Internal helpers
+    // ─────────────────────────────────────────────
+
+    /** Remove ALL tracked listeners in one call. */
+    _removeAllListeners() {
+        const listeners = ['startListener', 'resultListener', 'errorListener', 'volumeListener'];
+        listeners.forEach(key => {
+            if (this[key]) {
+                try { this[key].remove(); } catch (_) {}
+                this[key] = null;
+            }
+        });
+    }
+
+    /** Wait for a given number of milliseconds. */
+    _delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
     }
 
-    async startRecognizing(onSpeechStart, onSpeechRecognized, onSpeechResults, onInactivityTimeout, inactivitySeconds = 3, onVolumeChange = null, onNoSpeech = null) {
+    // ─────────────────────────────────────────────
+    // Public API
+    // ─────────────────────────────────────────────
+
+    async startRecognizing(
+        onSpeechStart,
+        onSpeechRecognized,
+        onSpeechResults,
+        onInactivityTimeout,
+        inactivitySeconds = 3,
+        onVolumeChange = null,
+        onNoSpeech = null
+    ) {
+        // Prevent concurrent start calls
+        if (this.isStarting || this.isStopping) {
+            config.DEBUG_MODE && console.log('Voice: startRecognizing skipped — transition in progress');
+            return;
+        }
+        if (this.isRecognizing) {
+            config.DEBUG_MODE && console.log('Voice: startRecognizing skipped — already recognizing');
+            return;
+        }
+
+        this.isStarting = true;
+
         try {
             const { status } = await ExpoSpeechRecognitionModule.requestPermissionsAsync();
             if (status !== 'granted') {
@@ -33,36 +92,56 @@ class VoiceService {
             let language = Session.getDeviceLanguageAndRegion();
             language = this.normalizeLocale(language);
 
-            if (this.resultListener) {
-                this.resultListener.remove();
-            }
+            // Always remove stale listeners before registering new ones
+            this._removeAllListeners();
 
-             this.volumeListener = ExpoSpeechRecognitionModule.addListener("volumechange" , ({value}) => {
-                if (onVolumeChange) {
-                    onVolumeChange(value);
-                }
-            })
+            // ── volume ──────────────────────────────────────────────────
+            this.volumeListener = ExpoSpeechRecognitionModule.addListener('volumechange', ({ value }) => {
+                if (onVolumeChange) onVolumeChange(value);
+            });
 
-            ExpoSpeechRecognitionModule.addListener('start', () => {
+            // ── start ───────────────────────────────────────────────────
+            this.startListener = ExpoSpeechRecognitionModule.addListener('start', () => {
+                console.log('SPEECH -  start');
+                // Reset accumulator at the beginning of each new recognition session
+                this._committedTranscript = '';
                 onSpeechStart();
                 this.resetInactivityTimeout(inactivitySeconds, onInactivityTimeout);
             });
 
+            // ── result ──────────────────────────────────────────────────
             this.resultListener = ExpoSpeechRecognitionModule.addListener('result', (event) => {
+                console.log('SPEECH -  result', event);
                 if (event.results && event.results.length > 0) {
-                    const results = event.results.map(r => r.transcript);
-                    onSpeechResults(results);
+                    // event.results[0] is the best hypothesis for the current segment
+                    const currentSegment = event.results[0].transcript || '';
+                    const isFinal = event.isFinal ?? false;
+
+                    // Build the full transcript: everything committed so far + current segment
+                    const fullTranscript = (this._committedTranscript + ' ' + currentSegment).trim();
+
+
+                    // Always pass the full accumulated transcript to the caller
+                    onSpeechResults([fullTranscript]);
+
+                    // When the engine finalises a segment, commit it
+                    if (isFinal) {
+                        this._committedTranscript = fullTranscript;
+                        console.log('SPEECH -  segment committed:', this._committedTranscript);
+                    }
+
                     this.resetInactivityTimeout(inactivitySeconds, onInactivityTimeout);
                 }
             });
 
-            ExpoSpeechRecognitionModule.addListener('error', (event) => {
+            // ── error ───────────────────────────────────────────────────
+            this.errorListener = ExpoSpeechRecognitionModule.addListener('error', (event) => {
+                config.DEBUG_MODE && console.log('Voice - ERROR', event);
                 console.error('Speech recognition error:', event.error, event.message);
-                
-                // Handle "no-speech" error specifically
+
                 if (event.error === 'no-speech' && onNoSpeech) {
                     onNoSpeech();
-                    // Don't stop recognition, just notify user
+                    // Non-fatal — just notify, recognition keeps running
                 }
             });
 
@@ -71,51 +150,81 @@ class VoiceService {
                 interimResults: true,
                 maxAlternatives: 1,
                 continuous: true,
-                volumeChangeEventOptions : {
-                    enabled : true,
-                    intervalMillis:150
-                }
+                volumeChangeEventOptions: {
+                    enabled: true,
+                    intervalMillis: 150,
+                },
             });
 
             this.isRecognizing = true;
 
         } catch (e) {
-            console.error('Speech recognition error:', e);
+            console.error('Speech recognition start error:', e);
+            this._removeAllListeners();
             this.isRecognizing = false;
+        } finally {
+            this.isStarting = false;
         }
     }
 
     resetInactivityTimeout(seconds, onInactivityTimeout) {
+        // Always clear any existing timer first
         if (this.inactivityTimeout) {
             clearTimeout(this.inactivityTimeout);
+            this.inactivityTimeout = null;
         }
-        this.inactivityTimeout = setTimeout(() => {
-            this.stopRecognizing();
-            if (onInactivityTimeout) {
-                onInactivityTimeout();
-            }
+
+        // A falsy / zero value means "run indefinitely — no auto-stop"
+        if (!seconds) {
+            config.DEBUG_MODE && console.log('Voice: inactivity timeout disabled (indefinite recognition)');
+            return;
+        }
+
+        this.inactivityTimeout = setTimeout(async () => {
+            // Await full stop (incl. Android delay) before notifying the caller.
+            // Without this await, onInactivityTimeout fires while isStopping=true
+            // and a secondary destroyVoice() call gets skipped by the guard.
+            await this.stopRecognizing();
+            if (onInactivityTimeout) onInactivityTimeout();
         }, seconds * 1000);
     }
 
     async stopRecognizing() {
+        // Prevent concurrent stop calls or stopping when already idle
+        if (this.isStopping) {
+            config.DEBUG_MODE && console.log('Voice: stopRecognizing skipped — already stopping');
+            return;
+        }
+        if (!this.isRecognizing && !this.isStarting) {
+            config.DEBUG_MODE && console.log('Voice: stopRecognizing skipped — not active');
+            return;
+        }
+
+        this.isStopping = true;
+
         try {
+            // Clear the inactivity timer first
             if (this.inactivityTimeout) {
                 clearTimeout(this.inactivityTimeout);
+                this.inactivityTimeout = null;
             }
-            if (this.resultListener) {
-                this.resultListener.remove();
-                this.resultListener = null;
-            }
-            if (this.volumeListener) {
-                this.volumeListener.remove();
-                this.volumeListener = null;
-            }
+
+            // Remove all event listeners before stopping the engine
+            this._removeAllListeners();
+
             if (this.isRecognizing) {
+                // Android needs a short pause before stop() is accepted reliably
+                if (Platform.OS === 'android') {
+                    await this._delay(ANDROID_STOP_DELAY_MS);
+                }
                 await ExpoSpeechRecognitionModule.stop();
                 this.isRecognizing = false;
             }
         } catch (e) {
             console.error('Stop recognition error:', e);
+            this.isRecognizing = false;
+        } finally {
+            this.isStopping = false;
         }
     }
 
@@ -129,7 +238,7 @@ class VoiceService {
 
     normalizeLocale(locale) {
         const [lang, region] = locale.split('-');
-        
+
         const validCombinations = {
             'en': ['US', 'GB', 'AU', 'CA', 'NZ', 'ZA', 'AE', 'IN', 'SG', 'IE', 'PH', 'SA', 'ID'],
             'es': ['ES', 'MX', 'CL', 'CO', '419', 'US'],
@@ -170,7 +279,7 @@ class VoiceService {
         }
 
         const validRegions = validCombinations[lang];
-        
+
         if (validRegions.includes(region)) {
             return locale;
         }
@@ -205,21 +314,19 @@ class VoiceService {
         const detectedLanguage = languageMap[detectedLanguageCode] || 'en_US';
         const finalLanguage = detectedLanguage || Session.getDeviceLanguageAndRegion();
         const finalVoice = voice || `${finalLanguage}-voice`;
-        config.DEBUG_MODE && console.log('Speech detected language:', detectedLanguage, 'final language:', finalLanguage, 'final voice:', finalVoice);
+        config.DEBUG_MODE && console.log(
+            'Speech detected language:', detectedLanguage,
+            'final language:', finalLanguage,
+            'final voice:', finalVoice
+        );
 
         Speech.speak(message, {
             language: finalLanguage,
             rate: 1,
             pitch: 1,
-            onStart: () => {
-                if (onStart) onStart();
-            },
-            onDone: () => {
-                if (onDone) onDone();
-            },
-            onError: (error) => {
-                if (onError) onError(error);
-            }
+            onStart: () => { if (onStart) onStart(); },
+            onDone:  () => { if (onDone)  onDone();  },
+            onError: (error) => { if (onError) onError(error); },
         });
     }
 
@@ -228,7 +335,7 @@ class VoiceService {
             await Speech.stop();
             if (onStop) onStop();
         } catch (error) {
-            console.error("Error stopping speech:", error);
+            console.error('Error stopping speech:', error);
         }
     }
 }