@volley/recognition-client-sdk 0.1.295 → 0.1.296

package/dist/simplified-vgf-recognition-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simplified-vgf-recognition-client.d.ts","sourceRoot":"","sources":["../src/simplified-vgf-recognition-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACH,gBAAgB,EAGnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEH,wBAAwB,EACxB,WAAW,EACd,MAAM,+BAA+B,CAAC;AAWvC;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACvE;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAElD;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAE5C;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,IAAI,IAAI,CAAC;IAGvB;;;OAGG;IACH,WAAW,IAAI,gBAAgB,CAAC;IAGhC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC;IAExB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC;IAEtB;;OAEG;IACH,uBAAuB,IAAI,OAAO,CAAC;IAEnC;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC;IAG/B;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC;IAE9B;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,IAAI,WAAW,CAAC;CAE3B;AAED;;;GAGG;AACH,qBAAa,8BAA+B,YAAW,+BAA+B;IAClF,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,mBAAmB,CAAkD;gBAEjE,MAAM,EAAE,yBAAyB;IAoGvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAc1D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC,cAAc,IAAI,IAAI;IAiCtB,mBAAmB,IAAI,MAAM;IAI7B,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,WAAW;IAIvB,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,OAAO;IAIvB,UAAU,IAAI,OAAO;IAIrB,uBAAuB,IAAI,OAAO;IAIlC,mBAAmB,IAAI,OAAO;IAM9B,WAAW,IAAI,gBAAgB;IAI/B,OAAO,CAAC,iBAAiB;CAK5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,+BAA+B,CAE5G"}
+{"version":3,"file":"simplified-vgf-recognition-client.d.ts","sourceRoot":"","sources":["../src/simplified-vgf-recognition-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACH,gBAAgB,EAGnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEH,wBAAwB,EACxB,WAAW,EACd,MAAM,+BAA+B,CAAC;AAWvC;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACvE;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAElD;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAE5C;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,IAAI,IAAI,CAAC;IAGvB;;;OAGG;IACH,WAAW,IAAI,gBAAgB,CAAC;IAGhC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC;IAExB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC;IAEtB;;OAEG;IACH,uBAAuB,IAAI,OAAO,CAAC;IAEnC;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC;IAG/B;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC;IAE9B;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,IAAI,WAAW,CAAC;CAE3B;AAED;;;GAGG;AACH,qBAAa,8BAA+B,YAAW,+BAA+B;IAClF,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,mBAAmB,CAAkD;gBAEjE,MAAM,EAAE,yBAAyB;IAqIvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI;IAc1D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC,cAAc,IAAI,IAAI;IAiCtB,mBAAmB,IAAI,MAAM;IAI7B,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,WAAW;IAIvB,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,OAAO;IAIvB,UAAU,IAAI,OAAO;IAIrB,uBAAuB,IAAI,OAAO;IAIlC,mBAAmB,IAAI,OAAO;IAM9B,WAAW,IAAI,gBAAgB;IAI/B,OAAO,CAAC,iBAAiB;CAK5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,+BAA+B,CAE5G"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volley/recognition-client-sdk",
-  "version": "0.1.295",
+  "version": "0.1.296",
   "description": "Recognition Service TypeScript/Node.js Client SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -52,9 +52,9 @@
     "semantic-release": "^25.0.1",
     "ts-jest": "^29.4.5",
     "typescript": "^5.1.6",
-    "@recog/shared-config": "1.0.0",
-    "@recog/shared-types": "1.0.0",
     "@recog/shared-utils": "1.0.0",
+    "@recog/shared-types": "1.0.0",
+    "@recog/shared-config": "1.0.0",
     "@recog/websocket": "1.0.0"
   },
   "keywords": [

package/src/simplified-vgf-recognition-client.spec.ts

@@ -80,12 +80,18 @@ describe('SimplifiedVGFRecognitionClient', () => {
       });
 
       const state = simplifiedClient.getVGFState();
-      expect(state.audioUtteranceId).toBe('existing-session-id');
+      // FINALIZED session gets new UUID to prevent server session reuse
+      expect(state.audioUtteranceId).not.toBe('existing-session-id');
+      expect(state.audioUtteranceId).toBeDefined();
+      // Other state preserved
       expect(state.finalTranscript).toBe('Previous transcript');
+      // Status reset to NOT_STARTED
+      expect(state.transcriptionStatus).toBe(TranscriptionStatus.NOT_STARTED);
 
-      // Verify audioUtteranceId was passed to underlying client
+      // Verify NEW audioUtteranceId was passed to underlying client
       const constructorCalls = (RealTimeTwoWayWebSocketRecognitionClient as jest.MockedClass<typeof RealTimeTwoWayWebSocketRecognitionClient>).mock.calls;
-      expect(constructorCalls[0]?.[0]?.audioUtteranceId).toBe('existing-session-id');
+      expect(constructorCalls[0]?.[0]?.audioUtteranceId).not.toBe('existing-session-id');
+      expect(constructorCalls[0]?.[0]?.audioUtteranceId).toBe(state.audioUtteranceId);
     });
 
     it('should store ASR config as JSON string', () => {
@@ -528,6 +534,101 @@ describe('SimplifiedVGFRecognitionClient', () => {
       expect(client.getVGFState).toBeDefined();
       expect(client.connect).toBeDefined();
     });
+
+    it('should auto-generate new UUID for ABORTED session and reset fields', () => {
+      const stateChangeCallback = jest.fn();
+      const abortedState: RecognitionState = {
+        audioUtteranceId: 'old-aborted-uuid',
+        transcriptionStatus: TranscriptionStatus.ABORTED,
+        startRecordingStatus: RecordingStatus.FINISHED,
+        pendingTranscript: '',
+        finalTranscript: 'old transcript from aborted session'
+      };
+
+      const client = createSimplifiedVGFClient({
+        initialState: abortedState,
+        onStateChange: stateChangeCallback,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        }
+      });
+
+      // Should have called callback with new UUID
+      expect(stateChangeCallback).toHaveBeenCalledTimes(1);
+      const newState = stateChangeCallback.mock.calls[0][0];
+
+      // New UUID should be different
+      expect(newState.audioUtteranceId).not.toBe('old-aborted-uuid');
+      expect(newState.audioUtteranceId).toBeDefined();
+
+      // Status fields should be reset for fresh session
+      expect(newState.transcriptionStatus).toBe(TranscriptionStatus.NOT_STARTED);
+      expect(newState.startRecordingStatus).toBe(RecordingStatus.READY);
+
+      // Previous transcript should be cleared
+      expect(newState.finalTranscript).toBeUndefined();
+
+      // Client should use the new UUID
+      expect(client.getVGFState().audioUtteranceId).toBe(newState.audioUtteranceId);
+    });
+
+    it('should auto-generate new UUID for FINALIZED session', () => {
+      const stateChangeCallback = jest.fn();
+      const finalizedState: RecognitionState = {
+        audioUtteranceId: 'old-finalized-uuid',
+        transcriptionStatus: TranscriptionStatus.FINALIZED,
+        startRecordingStatus: RecordingStatus.FINISHED,
+        pendingTranscript: '',
+        finalTranscript: 'completed transcript'
+      };
+
+      const client = createSimplifiedVGFClient({
+        initialState: finalizedState,
+        onStateChange: stateChangeCallback,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        }
+      });
+
+      // Should have generated new UUID
+      expect(stateChangeCallback).toHaveBeenCalledTimes(1);
+      const newState = stateChangeCallback.mock.calls[0][0];
+
+      expect(newState.audioUtteranceId).not.toBe('old-finalized-uuid');
+      expect(newState.transcriptionStatus).toBe(TranscriptionStatus.NOT_STARTED);
+    });
+
+    it('should preserve UUID for IN_PROGRESS session (valid resumption)', () => {
+      const stateChangeCallback = jest.fn();
+      const inProgressState: RecognitionState = {
+        audioUtteranceId: 'in-progress-uuid',
+        transcriptionStatus: TranscriptionStatus.IN_PROGRESS,
+        startRecordingStatus: RecordingStatus.RECORDING,
+        pendingTranscript: 'partial text'
+      };
+
+      const client = createSimplifiedVGFClient({
+        initialState: inProgressState,
+        onStateChange: stateChangeCallback,
+        asrRequestConfig: {
+          provider: 'deepgram',
+          language: 'en',
+          sampleRate: 16000,
+          encoding: AudioEncoding.LINEAR16
+        }
+      });
+
+      // Should NOT generate new UUID (valid reconnection)
+      const currentState = client.getVGFState();
+      expect(currentState.audioUtteranceId).toBe('in-progress-uuid');
+      expect(currentState.transcriptionStatus).toBe(TranscriptionStatus.IN_PROGRESS);
+    });
   });
 
   describe('PromptSlotMap Integration', () => {
@@ -734,6 +835,7 @@ describe('SimplifiedVGFRecognitionClient', () => {
       expect(stateChangeCallback).toHaveBeenCalledTimes(1);
 
       const firstCallState = stateChangeCallback.mock.calls[0][0];
+      const firstTranscript = firstCallState.finalTranscript;
       jest.clearAllMocks();
 
       // Call stopAbnormally second time
@@ -744,7 +846,7 @@ describe('SimplifiedVGFRecognitionClient', () => {
 
       const currentState = simplifiedClient.getVGFState();
       expect(currentState.transcriptionStatus).toBe(TranscriptionStatus.ABORTED);
-      expect(currentState.finalTranscript).toBe('');
+      expect(currentState.finalTranscript).toBe(firstTranscript); // Unchanged
     });
 
     it('should work even if called before any recording', () => {
@@ -753,7 +855,7 @@ describe('SimplifiedVGFRecognitionClient', () => {
 
       const state = simplifiedClient.getVGFState();
       expect(state.transcriptionStatus).toBe(TranscriptionStatus.ABORTED);
-      expect(state.finalTranscript).toBe('');
+      expect(state.finalTranscript).toBeUndefined(); // No transcript was ever received
       expect(state.startRecordingStatus).toBe(RecordingStatus.FINISHED);
     });
 
@@ -853,7 +955,7 @@ describe('SimplifiedVGFRecognitionClient', () => {
       // Verify ABORTED is used (not FINALIZED)
       expect(abortedState.transcriptionStatus).toBe(TranscriptionStatus.ABORTED);
       expect(abortedState.transcriptionStatus).not.toBe(TranscriptionStatus.FINALIZED);
-      expect(abortedState.finalTranscript).toBe(''); // Empty because cancelled
+      // finalTranscript is preserved (whatever partial transcript was received)
 
       // ABORTED clearly indicates user cancelled, vs FINALIZED which means completed normally
     });

package/src/simplified-vgf-recognition-client.ts

@@ -157,10 +157,43 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
 
         // Use provided initial state or create from config
         if (initialState) {
-            this.state = initialState;
-            // Override audioUtteranceId in config if state has one
-            if (initialState.audioUtteranceId && !clientConfig.audioUtteranceId) {
-                clientConfig.audioUtteranceId = initialState.audioUtteranceId;
+            // If previous session is in terminal state (ABORTED/FINALIZED), force new UUID
+            // This prevents server from attaching to completed session which silently drops audio
+            if (initialState.transcriptionStatus === TranscriptionStatus.ABORTED ||
+                initialState.transcriptionStatus === TranscriptionStatus.FINALIZED) {
+
+                // Generate new UUID for fresh session
+                const newUUID = crypto.randomUUID();
+
+                if (clientConfig.logger) {
+                    clientConfig.logger('info', `Terminal session detected (${initialState.transcriptionStatus}), generating new UUID: ${newUUID}`);
+                }
+
+                // Update state with new UUID and reset session-specific fields
+                this.state = {
+                    ...initialState,
+                    audioUtteranceId: newUUID,
+                    // Reset status fields for fresh session
+                    transcriptionStatus: TranscriptionStatus.NOT_STARTED,
+                    startRecordingStatus: RecordingStatus.READY,
+                    // Clear previous session's transcript
+                    finalTranscript: undefined
+                };
+
+                // Use new UUID in client config
+                clientConfig.audioUtteranceId = newUUID;
+
+                // Notify state change immediately so app can update
+                if (onStateChange) {
+                    onStateChange(this.state);
+                }
+            } else {
+                // Non-terminal state - safe to reuse UUID (e.g., reconnecting to IN_PROGRESS session)
+                this.state = initialState;
+                // Override audioUtteranceId in config if state has one
+                if (initialState.audioUtteranceId && !clientConfig.audioUtteranceId) {
+                    clientConfig.audioUtteranceId = initialState.audioUtteranceId;
+                }
             }
         } else {
             // Initialize VGF state from config