med-scribe-alliance-ts-sdk 2.0.30 → 2.0.32

package/dist/index.d.ts

@@ -431,6 +431,7 @@ export interface ProcessingError {
 export interface PollOptions {
 	maxAttempts?: number;
 	intervalMs?: number;
+	timeoutMs?: number;
 	onProgress?: (status: GetSessionStatusResponse) => void;
 	/** AbortSignal to cancel polling early. */
 	signal?: AbortSignal;
@@ -1042,6 +1043,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);
 	/**
@@ -1052,6 +1054,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

@@ -838,21 +838,34 @@ var G = class {
 		try {
 			let r = t ?? this.currentSession?.session_id;
 			if (!r) throw new y("No active session. Provide a sessionId or start a session first.");
-			let i = n?.maxAttempts ?? 60, a = n?.intervalMs ?? 2e3;
+			let i = n?.maxAttempts ?? 60, a = n?.intervalMs ?? 2e3, o = n?.timeoutMs, s = o !== void 0 && o > 0 ? Date.now() + o : void 0;
 			this.debug && console.log("[ScribeSDK] Polling for completion:", r, {
 				maxAttempts: i,
-				intervalMs: a
+				intervalMs: a,
+				timeoutMs: o
 			});
 			for (let t = 1; t <= i; t++) {
 				if (n?.signal?.aborted) throw new y("Polling was aborted", "polling_aborted", void 0, { session_id: r });
-				let o = await this.getSessionStatus(e, r), s = o.data;
+				if (s !== void 0 && Date.now() >= s) throw new y(`Polling timed out after ${o}ms for session '${r}'`, "polling_timeout", void 0, {
+					session_id: r,
+					timeout_ms: o
+				});
+				let c = await this.getSessionStatus(e, r), l = c.data;
 				if (n?.onProgress) try {
-					n.onProgress(s);
+					n.onProgress(l);
 				} catch (e) {
 					console.error("[ScribeSDK] Error in poll onProgress callback:", e);
 				}
-				if (this.isTerminalStatus(s.status)) return this.debug && console.log("[ScribeSDK] Poll complete:", r, s.status, `(attempt ${t})`), o;
-				t < i && await this.sleepWithAbort(a, n?.signal);
+				if (this.isTerminalStatus(l.status)) return this.debug && console.log("[ScribeSDK] Poll complete:", r, l.status, `(attempt ${t})`), c;
+				if (t < i) {
+					let e = a;
+					if (s !== void 0) {
+						let t = s - Date.now();
+						if (t <= 0) continue;
+						e = Math.min(a, t);
+					}
+					await this.sleepWithAbort(e, n?.signal);
+				}
 			}
 			throw new y(`Polling timed out after ${i} attempts for session '${r}'`, "polling_timeout", void 0, {
 				session_id: r,
@@ -957,7 +970,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 +1618,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 +1638,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 +1740,7 @@ var Y = class {
 				httpStatus: void 0
 			};
 		} finally {
-			this._isStarting = !1;
+			i === this._startGeneration && (this._isStarting = !1);
 		}
 	}
 	pause() {
@@ -1801,9 +1846,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 +1868,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.30",
+  "version": "2.0.32",
   "description": "TypeScript SDK for the MedScribe Alliance Protocol",
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",