med-scribe-alliance-ts-sdk 2.0.29 → 2.0.31

package/dist/index.d.ts

@@ -456,7 +456,8 @@ export interface ProcessTemplateResponse {
 	message: string;
 }
 export interface RecordingOptions {
-	templates: string[];
+	templates: string[] | [
+	];
 	model?: string;
 	languageHint?: string[];
 	transcriptLanguage?: string;
@@ -1041,6 +1042,7 @@ export declare class RecordingManager {
 	private activeBaseUrl;
 	private _isRecording;
 	private _isStarting;
+	private _startGeneration;
 	private retryContext;
 	constructor(callbackRegistry: CallbackRegistry, sessionManager: SessionManager, discoveryManager: DiscoveryManager, transport: ITransport, config?: RecordingManagerConfig);
 	/**
@@ -1051,6 +1053,11 @@ export declare class RecordingManager {
 	 * 4. Start recording
 	 * 5. Dispatch events
 	 *
+	 * Race-safety: Uses a generation counter (`_startGeneration`) so that if
+	 * clearRecordingState() or reset() is called while this method is suspended
+	 * at an `await`, the resumed call detects the mismatch and aborts instead
+	 * of creating an orphaned recorder with a leaked mic/VAD.
+	 *
 	 * @param baseUrl - Server base URL (from discovery or SDK config)
 	 * @param options - Recording options (templates, model, etc.)
 	 * @param accessToken - Current Bearer token for upload auth headers

package/dist/index.mjs

@@ -957,7 +957,7 @@ var oe = {
 		} catch (e) {
 			console.error("[ScribeSDK] Error destroying VAD:", e);
 		}
-		this.isRecording = !1;
+		this.micVad = null, this.isRecording = !1;
 	}
 	reset() {
 		this.destroy(), this.vadPast = [], this.lastClipIndex = 0, this.silDurationAcc = 0, this.noSpeechStartTime = null, this.lastWarningTime = null, this.isLoading = !0, this.micVad = null;
@@ -1605,15 +1605,17 @@ var Y = class {
 	}
 }, Q = class {
 	constructor(e, t, n, r, i) {
-		this.recorder = null, this.activeSession = null, this.activeBaseUrl = "", this._isRecording = !1, this._isStarting = !1, this.retryContext = null, this.callbackRegistry = e, this.sessionManager = t, this.discoveryManager = n, this.transport = r, this.config = i ?? {};
+		this.recorder = null, this.activeSession = null, this.activeBaseUrl = "", this._isRecording = !1, this._isStarting = !1, this._startGeneration = 0, this.retryContext = null, this.callbackRegistry = e, this.sessionManager = t, this.discoveryManager = n, this.transport = r, this.config = i ?? {};
 	}
 	async start(e, t, n) {
 		if (this._isRecording || this._isStarting) throw new y("Recording is already in progress. Stop the current recording first.");
-		this._isStarting = !0, this.retryContext = null, this.activeBaseUrl = e;
-		let r = t.uploadType ?? "chunked", i = t.communicationProtocol ?? "http", a = {
+		this._isStarting = !0;
+		let r = ++this._startGeneration;
+		this.retryContext = null, this.activeBaseUrl = e;
+		let i = t.uploadType ?? "chunked", a = t.communicationProtocol ?? "http", o = {
 			templates: t.templates,
-			upload_type: r,
-			communication_protocol: i,
+			upload_type: i,
+			communication_protocol: a,
 			model: t.model,
 			language_hint: t.languageHint,
 			transcript_language: t.transcriptLanguage,
@@ -1623,69 +1625,99 @@ var Y = class {
 			session_id: t.sessionId
 		};
 		try {
-			let i, o;
+			let a, s;
 			try {
-				let t = await this.sessionManager.createSession(e, a);
-				i = t.data, o = t.httpStatus;
+				let t = await this.sessionManager.createSession(e, o);
+				a = t.data, s = t.httpStatus;
 			} catch (e) {
-				throw this.dispatchStartError(m.TRANSPORT_ERROR, g.SESSION_CREATION_FAILED, e), e;
+				throw r === this._startGeneration && this.dispatchStartError(m.TRANSPORT_ERROR, g.SESSION_CREATION_FAILED, e), e;
 			}
-			this.activeSession = i, this.callbackRegistry.dispatch("onSessionEvent", {
+			if (r !== this._startGeneration) throw new y("Recording start was superseded by a concurrent operation.");
+			this.activeSession = a, this.callbackRegistry.dispatch("onSessionEvent", {
 				type: p.CREATED,
 				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-				data: i
-			}), this.recorder = this.createRecorder(r);
-			let s = {
+				data: a
+			});
+			let c = this.createRecorder(i);
+			this.recorder = c;
+			let l = {
 				accessToken: n,
-				uploadUrl: i.upload_url,
+				uploadUrl: a.upload_url,
 				uploadHeaders: this.buildUploadHeaders(n),
-				sessionId: i.session_id
+				sessionId: a.session_id
 			};
 			try {
-				this.recorder.initialize(i, s);
+				c.initialize(a, l);
 			} catch (e) {
-				throw this.cleanupRecordingState(), this.dispatchStartError(m.VALIDATION_ERROR, g.RECORDER_INIT_FAILED, e), e;
+				try {
+					c.reset();
+				} catch {}
+				throw r === this._startGeneration && (this.cleanupRecordingState(), this.dispatchStartError(m.VALIDATION_ERROR, g.RECORDER_INIT_FAILED, e)), e;
 			}
-			this.recorder instanceof X && this.applyDiscoveryOverrides(this.recorder);
+			c instanceof X && this.applyDiscoveryOverrides(c);
 			try {
-				await this.recorder.start(t.deviceId);
+				await c.start(t.deviceId);
 			} catch (e) {
-				throw this.cleanupRecordingState(), this.dispatchStartError(m.VAD_ERROR, g.VAD_START_FAILED, e), e;
+				try {
+					c.reset();
+				} catch {}
+				throw r === this._startGeneration && (this.cleanupRecordingState(), this.dispatchStartError(m.VAD_ERROR, g.VAD_START_FAILED, e)), e;
+			}
+			if (r !== this._startGeneration) {
+				try {
+					c.reset();
+				} catch {}
+				throw new y("Recording start was superseded by a concurrent operation.");
 			}
 			return this._isRecording = !0, this.callbackRegistry.dispatch("onRecordingStateChange", {
 				type: u.STARTED,
 				timestamp: (/* @__PURE__ */ new Date()).toISOString()
-			}), this.config.debug && console.log("[ScribeSDK] Recording started:", i.session_id), {
-				data: i,
-				httpStatus: o
+			}), this.config.debug && console.log("[ScribeSDK] Recording started:", a.session_id), {
+				data: a,
+				httpStatus: s
 			};
 		} finally {
-			this._isStarting = !1;
+			r === this._startGeneration && (this._isStarting = !1);
 		}
 	}
 	async startWithExistingSession(e, t, n, r) {
 		if (this._isRecording || this._isStarting) throw new y("Recording is already in progress. Stop the current recording first.");
-		this._isStarting = !0, this.retryContext = null, this.activeBaseUrl = e;
-		let i = n?.uploadType ?? "chunked";
+		this._isStarting = !0;
+		let i = ++this._startGeneration;
+		this.retryContext = null, this.activeBaseUrl = e;
+		let a = n?.uploadType ?? "chunked";
 		this.activeSession = t;
 		try {
-			this.recorder = this.createRecorder(i);
-			let e = {
+			let e = this.createRecorder(a);
+			this.recorder = e;
+			let o = {
 				accessToken: r,
 				uploadUrl: t.upload_url,
 				uploadHeaders: this.buildUploadHeaders(r),
 				sessionId: t.session_id
 			};
 			try {
-				this.recorder.initialize(t, e);
-			} catch (e) {
-				throw this.cleanupRecordingState(), this.dispatchStartError(m.VALIDATION_ERROR, g.RECORDER_INIT_FAILED, e), e;
+				e.initialize(t, o);
+			} catch (t) {
+				try {
+					e.reset();
+				} catch {}
+				throw i === this._startGeneration && (this.cleanupRecordingState(), this.dispatchStartError(m.VALIDATION_ERROR, g.RECORDER_INIT_FAILED, t)), t;
 			}
-			this.recorder instanceof X && this.applyDiscoveryOverrides(this.recorder);
+			e instanceof X && this.applyDiscoveryOverrides(e);
 			try {
-				await this.recorder.start(n?.deviceId);
-			} catch (e) {
-				throw this.cleanupRecordingState(), this.dispatchStartError(m.VAD_ERROR, g.VAD_START_FAILED, e), e;
+				await e.start(n?.deviceId);
+			} catch (t) {
+				try {
+					e.reset();
+				} catch {}
+				throw i === this._startGeneration && (this.cleanupRecordingState(), this.dispatchStartError(m.VAD_ERROR, g.VAD_START_FAILED, t)), t;
+			}
+			if (i !== this._startGeneration) {
+				try {
+					e.reset();
+				} catch {}
+				throw new y("Recording start was superseded by a concurrent operation.");
 			}
 			return this._isRecording = !0, this.callbackRegistry.dispatch("onRecordingStateChange", {
 				type: u.STARTED,
@@ -1695,7 +1727,7 @@ var Y = class {
 				httpStatus: void 0
 			};
 		} finally {
-			this._isStarting = !1;
+			i === this._startGeneration && (this._isStarting = !1);
 		}
 	}
 	pause() {
@@ -1801,9 +1833,11 @@ var Y = class {
 		}
 	}
 	forceStop() {
-		if (!(!this.recorder || !this._isRecording)) try {
+		if (++this._startGeneration, !(!this.recorder || !this._isRecording)) try {
 			this.recorder.reset();
-		} catch {} finally {
+		} catch (e) {
+			console.error("[ScribeSDK] Error in forceStop:", e);
+		} finally {
 			this.callbackRegistry.dispatch("onRecordingStateChange", {
 				type: u.ENDED,
 				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -1821,7 +1855,7 @@ var Y = class {
 		this.recorder && this.recorder instanceof X && this.recorder.updateAuthToken(e), this.transport.setAuthToken(e);
 	}
 	reset() {
-		this.recorder && this.recorder.reset(), this.retryContext = null, this.cleanupRecordingState();
+		++this._startGeneration, this.recorder && this.recorder.reset(), this.retryContext = null, this.cleanupRecordingState();
 	}
 	isRecording() {
 		return this._isRecording;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "med-scribe-alliance-ts-sdk",
-  "version": "2.0.29",
+  "version": "2.0.31",
   "description": "TypeScript SDK for the MedScribe Alliance Protocol",
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",