@volley/recognition-client-sdk 0.1.417 → 0.1.419

package/package.json

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

package/src/index.ts

@@ -69,6 +69,8 @@ export {
   isValidRecordingStatusTransition
 } from './vgf-recognition-state.js';
 
+export { resetRecognitionVGFState } from './vgf-recognition-mapper.js';
+
 // Re-export WebSocket protocol types for advanced usage
 export { AudioEncoding } from '@recog/websocket';
 

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

@@ -24,10 +24,10 @@ import {
     createVGFStateFromConfig,
     mapTranscriptionResultToState,
     mapErrorToState,
-    updateStateOnStop
+    updateStateOnStop,
+    resetRecognitionVGFState
 } from './vgf-recognition-mapper.js';
 import { RecognitionContextTypeV1 } from '@recog/shared-types';
-import { v4 as uuidv4 } from 'uuid';
 
 /**
  * Configuration for SimplifiedVGFRecognitionClient
@@ -170,8 +170,9 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
                                 initialState.transcriptionStatus === TranscriptionStatus.ERROR ||
                                 (initialState.recognitionActionProcessingState !== undefined && initialState.recognitionActionProcessingState !== RecognitionActionProcessingState.COMPLETED);
             if (needsNewUuid) {
-                // Generate new UUID for fresh session
-                const newUUID = uuidv4();
+                // Reset session state with new UUID
+                this.state = resetRecognitionVGFState(initialState);
+                const newUUID = this.state.audioUtteranceId;
 
                 if (clientConfig.logger) {
                     const reason = !initialState.audioUtteranceId ? 'Missing UUID' :
@@ -180,16 +181,6 @@ export class SimplifiedVGFRecognitionClient implements ISimplifiedVGFRecognition
                     clientConfig.logger('info', `${reason} detected, generating new UUID: ${newUUID}`);
                 }
 
-                // Update state with new UUID and reset session-specific fields
-                this.state = {
-                    ...initialState,
-                    audioUtteranceId: newUUID,
-                    transcriptionStatus: TranscriptionStatus.NOT_STARTED,
-                    startRecordingStatus: RecordingStatus.READY,
-                    recognitionActionProcessingState: RecognitionActionProcessingState.NOT_STARTED,
-                    finalTranscript: undefined
-                };
-
                 // Use new UUID in client config
                 clientConfig.audioUtteranceId = newUUID;
 

package/src/vgf-recognition-mapper.spec.ts

@@ -0,0 +1,78 @@
+/**
+ * Unit tests for VGF Recognition Mapper functions
+ */
+
+import {
+    resetRecognitionVGFState
+} from './vgf-recognition-mapper.js';
+import {
+    RecognitionState,
+    RecordingStatus,
+    TranscriptionStatus,
+    RecognitionActionProcessingState
+} from './vgf-recognition-state.js';
+
+describe('resetRecognitionVGFState', () => {
+    it('should generate a new UUID', () => {
+        const originalState: RecognitionState = {
+            audioUtteranceId: 'old-uuid-123',
+            pendingTranscript: '',
+            transcriptionStatus: TranscriptionStatus.FINALIZED,
+            startRecordingStatus: RecordingStatus.FINISHED,
+            recognitionActionProcessingState: RecognitionActionProcessingState.COMPLETED,
+            finalTranscript: 'hello world'
+        };
+
+        const newState = resetRecognitionVGFState(originalState);
+
+        expect(newState.audioUtteranceId).not.toBe('old-uuid-123');
+        expect(newState.audioUtteranceId).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i);
+    });
+
+    it('should reset session-specific fields', () => {
+        const originalState: RecognitionState = {
+            audioUtteranceId: 'old-uuid-123',
+            pendingTranscript: 'partial',
+            transcriptionStatus: TranscriptionStatus.FINALIZED,
+            startRecordingStatus: RecordingStatus.FINISHED,
+            recognitionActionProcessingState: RecognitionActionProcessingState.COMPLETED,
+            finalTranscript: 'hello world'
+        };
+
+        const newState = resetRecognitionVGFState(originalState);
+
+        expect(newState.transcriptionStatus).toBe(TranscriptionStatus.NOT_STARTED);
+        expect(newState.startRecordingStatus).toBe(RecordingStatus.READY);
+        expect(newState.recognitionActionProcessingState).toBe(RecognitionActionProcessingState.NOT_STARTED);
+        expect(newState.finalTranscript).toBeUndefined();
+    });
+
+    it('should preserve non-session fields like promptSlotMap', () => {
+        const originalState: RecognitionState = {
+            audioUtteranceId: 'old-uuid-123',
+            pendingTranscript: '',
+            transcriptionStatus: TranscriptionStatus.FINALIZED,
+            promptSlotMap: { artist: ['taylor swift'], song: ['shake it off'] },
+            asrConfig: '{"provider":"deepgram"}'
+        };
+
+        const newState = resetRecognitionVGFState(originalState);
+
+        expect(newState.promptSlotMap).toEqual({ artist: ['taylor swift'], song: ['shake it off'] });
+        expect(newState.asrConfig).toBe('{"provider":"deepgram"}');
+    });
+
+    it('should work with minimal state', () => {
+        const originalState: RecognitionState = {
+            audioUtteranceId: 'old-uuid',
+            pendingTranscript: ''
+        };
+
+        const newState = resetRecognitionVGFState(originalState);
+
+        expect(newState.audioUtteranceId).not.toBe('old-uuid');
+        expect(newState.transcriptionStatus).toBe(TranscriptionStatus.NOT_STARTED);
+        expect(newState.startRecordingStatus).toBe(RecordingStatus.READY);
+        expect(newState.recognitionActionProcessingState).toBe(RecognitionActionProcessingState.NOT_STARTED);
+    });
+});

package/src/vgf-recognition-mapper.ts

@@ -9,8 +9,10 @@ import {
     RecognitionState,
     RecordingStatus,
     TranscriptionStatus,
+    RecognitionActionProcessingState,
     createInitialRecognitionState
 } from './vgf-recognition-state.js';
+import { v4 as uuidv4 } from 'uuid';
 import {
     ClientState,
     IRecognitionClientConfig
@@ -142,6 +144,33 @@ export function updateStateOnStop(currentState: RecognitionState): RecognitionSt
     };
 }
 
+/**
+ * Resets session state with a new UUID.
+ * 
+ * This creates a fresh session state while preserving non-session fields
+ * (like promptSlotMap, asrConfig, etc.)
+ * 
+ * Resets:
+ * - audioUtteranceId → new UUID
+ * - transcriptionStatus → NOT_STARTED
+ * - startRecordingStatus → READY
+ * - recognitionActionProcessingState → NOT_STARTED
+ * - finalTranscript → undefined
+ * 
+ * @param currentState - The current recognition state
+ * @returns A new state with reset session fields and a new UUID
+ */
+export function resetRecognitionVGFState(currentState: RecognitionState): RecognitionState {
+    return {
+        ...currentState,
+        audioUtteranceId: uuidv4(),
+        transcriptionStatus: TranscriptionStatus.NOT_STARTED,
+        startRecordingStatus: RecordingStatus.READY,
+        recognitionActionProcessingState: RecognitionActionProcessingState.NOT_STARTED,
+        finalTranscript: undefined
+    };
+}
+
 /**
  * Updates state when client becomes ready
  */