med-scribe-alliance-ts-sdk 2.0.33 → 2.0.34

package/README.md

@@ -198,6 +198,8 @@ await client.reset(); // stops recording if active, clears all state and caches
 - **`cancelSession()` does NOT trigger processing.** It stops the recorder locally, cleans up state, and tells the server the session is cancelled. No `endSession` call is made to the backend.
 - **All async methods return `SDKResult<T>`, never throw.** Always check `result.success` before accessing `result.data`. Errors are in `result.error`.
 - **The SDK validates inputs against the discovery document.** If the server doesn't support an upload type, language, or model you requested, you'll get a `ValidationError` before the API call is made.
+- **Audio uploads go to a server-selected storage backend.** Discovery's `capabilities.storage_provider` (default `aws`) decides the backend; uploads go directly to it (e.g. S3 presigned POST). 
+
 - **SharedWorker is optional.** If you provide `workerScriptUrl`, the SDK offloads MP3 compression and upload to a SharedWorker. If the worker fails to load, it silently falls back to main-thread processing.
 - **Microphone permission is requested on `startRecording()`.** The browser will prompt the user for mic access. If denied, you'll get an error via `onError` callback.
 - **`reset()` is a full teardown.** It destroys the transport, clears discovery cache, removes all callbacks, and sets the client back to uninitialized state. You'll need to call `init()` (or `startRecording()`) again after reset.
@@ -273,6 +275,42 @@ if (client.hasFailedUploads()) {
 }
 ```
 
+### Upload a Pre-recorded Audio File
+
+For processing an already-recorded file (no mic/VAD). Create a session, then upload the file using the session's `upload_url`, then end the session and poll.
+
+```ts
+// 1. Create a session (gives you upload_url)
+const session = await client.createSession({
+  templates: ['soap'],
+  upload_type: 'single',
+  communication_protocol: 'http',
+});
+if (!session.success) return;
+
+// 2. Upload the file to storage using the session's upload_url
+const upload = await client.uploadAudioFile(
+  myAudioFile,
+  'audio_0.mp3',            // storage object name
+  session.data.upload_url
+);
+if (!upload.success) {
+  console.error('Upload failed:', upload.error.message);
+  return;
+}
+console.log(upload.data.status, upload.data.headers); // full storage response
+
+// 3. End the session to trigger processing, then poll getSessionStatus()
+await client.endSession(
+  { audio_files_sent: 1, audio_files_uploaded: 1 },
+  session.data.session_id
+);
+```
+
+- `file` is a `File`/`Blob`; `fileName` is the storage object name; `upload` is the `upload_url` object from the create-session response.
+- Returns `UploadAudioFileResult` — `{ fileName, status, headers, response }` (the full storage response; the body is usually empty for an S3 presigned POST).
+- Failures (network, malformed `upload_url`) come back as `UploadError` in `result.error`; an unknown provider as `UnsupportedStorageProviderError`.
+
 ### Update Auth Token
 
 ```ts
@@ -351,6 +389,7 @@ interface RecordingOptions {
 | `isRecordingPaused()` | `boolean` | Whether the active recording is paused. |
 | `retryFailedUploads()` | `SDKResult<RetryUploadResult>` | Retry uploads that failed during the last recording. |
 | `hasFailedUploads()` | `boolean` | Whether there are retryable failed uploads. |
+| `uploadAudioFile(file, fileName, upload)` | `SDKResult<UploadAudioFileResult>` | Upload one pre-recorded audio file to storage using a session's `upload_url`. No mic/recorder. |
 
 ### Session
 
@@ -457,10 +496,12 @@ interface CreateSessionResponse {
   status: SessionStatus;
   created_at: string;
   expires_at: string;
-  upload_url: string;
+  upload_url: SessionUploadInfo;
   patient_details?: PatientDetails;
 }
 
+type SessionUploadInfo = Record<string, unknown>;
+
 interface PatchSessionRequest {
   user_status?: string;
   processing_status?: string;
@@ -585,7 +626,8 @@ console.log(result.data.session_id);
 | `DiscoveryError` | — | Discovery fetch/parse failed |
 | `TransportError` | — | Network / IPC failure |
 | `WorkerError` | — | SharedWorker failure |
-| `UploadError` | — | Audio upload failure |
+| `UploadError` | — | Audio upload failure (failed transfer, or malformed `upload_url` payload). Has `failedFiles: string[]`. |
+| `UnsupportedStorageProviderError` | — | Discovery advertised a `storage_provider` this SDK build has no wrapper for. Thrown at `startRecording`. Has `provider: string`. |
 
 ## SharedWorker Support
 
@@ -648,6 +690,8 @@ const client = new ScribeClient({
 
 IPC mode always uses main-thread compression (SharedWorker can't access the IPC bridge).
 
+> **Presigned uploads over IPC need host support.** The SDK forwards `uploadFormFields` + base64 file (`blobData`) in the `IpcRequest`; your host must build the `multipart/form-data` POST (no `Authorization` header). Browser/HTTP mode works out of the box.
+
 ## Building from Source
 
 ```bash

package/dist/index.d.ts

@@ -552,6 +552,17 @@ export interface RetryUploadResult {
 	/** File names that still failed after retry */
 	stillFailed: string[];
 }
+/** Result of ScribeClient.uploadAudioFile() — the storage backend's full response. */
+export interface UploadAudioFileResult {
+	/** The storage object name used. */
+	fileName: string;
+	/** HTTP status from the storage backend (e.g. 204 for an S3 presigned POST). */
+	status: number;
+	/** Response headers from the storage backend (e.g. ETag). */
+	headers: Record<string, string>;
+	/** Raw response body from the storage backend (often empty for S3). */
+	response: unknown;
+}
 export interface RecordingStateChangeEvent {
 	type: RecordingState$1;
 	timestamp: string;
@@ -785,6 +796,14 @@ export declare class ScribeClient {
 	 * Call this after receiving a 'chunk_limit_reached' error to resume chunk uploads.
 	 */
 	forceAllowMoreChunks(): void;
+	/**
+	 * Upload a single pre-recorded audio file to storage.
+	 * @param file - The audio file/blob to upload.
+	 * @param upload - The `upload_url` payload from the create-session response.
+	 * @param options.fileName - Storage object name. Defaults to the File's name,
+	 *   else `audio_0.<ext>` derived from the MIME type.
+	 */
+	uploadAudioFile(file: Blob, fileName: string, upload: SessionUploadInfo): Promise<SDKResult<UploadAudioFileResult>>;
 	/**
 	 * Create a session directly (without starting a recording).
 	 */
@@ -898,6 +917,8 @@ export declare class ScribeClient {
 	 */
 	private createTransport;
 	private resolveWorkerConfig;
+	/** Storage provider name from discovery; defaults to 'aws'. */
+	private getStorageProviderName;
 	/**
 	 * Get the effective base URL — prefer discovery's base_url, fall back to config.
 	 */

package/dist/index.mjs

@@ -139,7 +139,7 @@ var r = "/.well-known/medscribealliance", i = 3600 * 1e3, a = /* @__PURE__ */ fu
 	authorization_endpoint: e.string(),
 	token_endpoint: e.string(),
 	scopes_supported: e.array(e.string())
-}), k = e.object({
+}), ae = e.object({
 	protocol: e.string().min(1, "protocol is required"),
 	protocol_version: e.string().min(1, "protocol_version is required"),
 	supported_versions: e.array(e.string()).optional(),
@@ -171,7 +171,7 @@ var r = "/.well-known/medscribealliance", i = 3600 * 1e3, a = /* @__PURE__ */ fu
 		supported: e.array(e.string()),
 		auto_detection: e.boolean().optional()
 	})
-}), A = e.object({
+}), k = e.object({
 	templates: e.array(e.string()).max(2, "templates cannot have more than 2 items"),
 	upload_type: e.string().min(1, "upload_type is required"),
 	communication_protocol: e.string().min(1, "communication_protocol is required"),
@@ -187,10 +187,10 @@ var r = "/.well-known/medscribealliance", i = 3600 * 1e3, a = /* @__PURE__ */ fu
 		mobile: e.number().optional()
 	}).optional(),
 	session_id: e.string().optional()
-}), j = e.object({
+}), A = e.object({
 	audio_files_sent: e.number().int().min(0, "audio_files_sent must be a non-negative integer"),
 	audio_files_uploaded: e.number().int().min(0, "audio_files_uploaded must be a non-negative integer")
-}), M = e.object({
+}), j = e.object({
 	user_status: e.string().optional(),
 	processing_status: e.string().optional(),
 	patient_details: e.object({
@@ -203,7 +203,7 @@ var r = "/.well-known/medscribealliance", i = 3600 * 1e3, a = /* @__PURE__ */ fu
 	language_hint: e.array(e.string()).optional(),
 	transcript_language: e.string().optional(),
 	templates: e.array(e.string()).optional()
-}), ae = e.object({
+}), M = e.object({
 	session_id: e.string().min(1, "session_id is required"),
 	status: e.string(),
 	created_at: e.string(),
@@ -280,16 +280,16 @@ var r = "/.well-known/medscribealliance", i = 3600 * 1e3, a = /* @__PURE__ */ fu
 	sessionId: e.string().optional()
 }), N = class {
 	validateDiscoveryResponse(e) {
-		this.parseWithValidationError(k, e, "Invalid discovery response");
+		this.parseWithValidationError(ae, e, "Invalid discovery response");
 	}
 	validateCreateSessionRequest(e) {
-		this.parseWithValidationError(A, e, "Invalid CreateSessionRequest");
+		this.parseWithValidationError(k, e, "Invalid CreateSessionRequest");
 	}
 	validateEndSessionRequest(e) {
-		this.parseWithValidationError(j, e, "Invalid EndSessionRequest");
+		this.parseWithValidationError(A, e, "Invalid EndSessionRequest");
 	}
 	validateCreateSessionResponse(e) {
-		this.parseWithValidationError(ae, e, "Invalid CreateSessionResponse");
+		this.parseWithValidationError(M, e, "Invalid CreateSessionResponse");
 	}
 	validateEndSessionResponse(e) {
 		this.parseWithValidationError(oe, e, "Invalid EndSessionResponse");
@@ -304,7 +304,7 @@ var r = "/.well-known/medscribealliance", i = 3600 * 1e3, a = /* @__PURE__ */ fu
 		this.parseWithValidationError(de, e, "Invalid RecordingOptions");
 	}
 	validatePatchSessionRequest(e) {
-		this.parseWithValidationError(M, e, "Invalid PatchSessionRequest");
+		this.parseWithValidationError(j, e, "Invalid PatchSessionRequest");
 	}
 	validatePatchSessionResponse(e) {
 		this.parseWithValidationError(ce, e, "Invalid PatchSessionResponse");
@@ -358,21 +358,21 @@ async function P(e, t = {}) {
 	for (let t = 0; t <= n; t++) try {
 		return await e();
 	} catch (e) {
-		if (a = e instanceof Error ? e : Error(String(e)), F(e?.httpStatus ?? e?.statusCode ?? e?.status)) throw a;
+		if (a = e instanceof Error ? e : Error(String(e)), fe(e?.httpStatus ?? e?.statusCode ?? e?.status)) throw a;
 		if (t >= n || i && i(t + 1, a) === !1) break;
-		await I(r);
+		await F(r);
 	}
 	throw a ?? /* @__PURE__ */ Error("Retry failed: unknown error");
 }
-function F(e) {
+function fe(e) {
 	return typeof e == "number" ? e >= 400 && e < 500 && e !== 408 && e !== 429 : !1;
 }
-function I(e) {
+function F(e) {
 	return new Promise((t) => setTimeout(t, e));
 }
 //#endregion
 //#region src/transport/http-transport.ts
-var L = class {
+var I = class {
 	constructor(e) {
 		this.tokenRefreshPromise = null, this.accessToken = e.accessToken, this.flavour = e.flavour, this.debug = e.debug ?? !1, this.onUnauthorized = e.onUnauthorized;
 	}
@@ -494,7 +494,7 @@ var L = class {
 			}
 		};
 	}
-}, R = class {
+}, L = class {
 	constructor(e) {
 		this.pendingRequests = /* @__PURE__ */ new Map(), this.correlationCounter = 0, this.tokenRefreshPromise = null, this.bridge = e.bridge, this.accessToken = e.accessToken, this.flavour = e.flavour, this.debug = e.debug ?? !1, this.onUnauthorized = e.onUnauthorized, this.bridge.onResponse((e) => {
 			this.handleResponse(e);
@@ -649,7 +649,7 @@ var L = class {
 };
 //#endregion
 //#region src/discovery/resolved-config.ts
-function z(e) {
+function R(e) {
 	try {
 		let t = /* @__PURE__ */ new Map(), n = e.models ?? [];
 		for (let e of n) e.id && typeof e.max_session_duration_seconds == "number" && t.set(e.id, e.max_session_duration_seconds);
@@ -674,7 +674,7 @@ function z(e) {
 }
 //#endregion
 //#region src/discovery/discovery-manager.ts
-var B = class {
+var z = class {
 	constructor(e, t, n = !1) {
 		this.cachedDocument = null, this.resolvedConfig = null, this.cacheTimestamp = 0, this.cacheTtlMs = i, this.transport = e, this.validator = t, this.debug = n;
 	}
@@ -691,7 +691,7 @@ var B = class {
 				url: n
 			});
 			this.validator.validateDiscoveryResponse(i.data);
-			let a = i.data, o = z(a);
+			let a = i.data, o = R(a);
 			return this.cachedDocument = a, this.resolvedConfig = o, this.cacheTimestamp = Date.now(), this.debug && console.log("[ScribeSDK] Discovery complete:", a.service?.name ?? a.protocol), {
 				data: o,
 				httpStatus: i.status
@@ -744,7 +744,7 @@ var B = class {
 	isCacheValid() {
 		return Date.now() - this.cacheTimestamp < this.cacheTtlMs;
 	}
-}, V = class {
+}, B = class {
 	constructor(e, t, n = !1) {
 		this.currentSession = null, this.transport = e, this.validator = t, this.debug = n;
 	}
@@ -910,13 +910,13 @@ var B = class {
 			}, { once: !0 });
 		}) : this.sleep(e);
 	}
-}, H = 1024, U = 16e3;
-H / U, U / H;
-var fe = {
+}, V = 1024, H = 16e3;
+V / H, H / V;
+var pe = {
 	m4a: "audio/m4a",
 	wav: "audio/wav",
 	mp3: "audio/mpeg"
-}, pe = class {
+}, me = class {
 	constructor(e, t) {
 		this.vadPast = [], this.lastClipIndex = 0, this.silDurationAcc = 0, this.micVad = null, this.micStream = null, this.isLoading = !0, this.isRecording = !1, this.noSpeechStartTime = null, this.lastWarningTime = null;
 		let n = e.samplingRate;
@@ -1048,7 +1048,7 @@ var fe = {
 		} catch {}
 		this.micStream = null;
 	}
-}, me = class {
+}, he = class {
 	constructor(e, t) {
 		this.currentSampleLength = 0, this.currentFrameLength = 0, this.samplingRate = e, this.incrementalAllocationSize = Math.floor(e * t), this.buffer = new Float32Array(this.incrementalAllocationSize);
 	}
@@ -1098,7 +1098,7 @@ var fe = {
 	formatTimestamp(e) {
 		return `${Math.floor(e / 60).toString().padStart(2, "0")}:${(e % 60).toFixed(6).padStart(9, "0")}`;
 	}
-}, he = class {
+}, ge = class {
 	constructor() {
 		this.chunks = [], this.successfulUploads = [], this.totalRawSamples = 0, this.totalRawFrames = 0, this.totalInsertedSamples = 0, this.totalInsertedFrames = 0;
 	}
@@ -1192,7 +1192,7 @@ var fe = {
 };
 //#endregion
 //#region src/audio/mp3-encoder.ts
-function ge(e, t = U, r = 128) {
+function _e(e, t = H, r = 128) {
 	try {
 		let i = new n.Mp3Encoder(1, t, r), a = new Int16Array(e.length);
 		for (let t = 0; t < e.length; t++) {
@@ -1203,7 +1203,7 @@ function ge(e, t = U, r = 128) {
 		s && s.length > 0 && o.push(s);
 		let c = i.flush();
 		return c && c.length > 0 && o.push(c), o.length === 0 ? null : {
-			blob: new Blob(o, { type: fe.mp3 }),
+			blob: new Blob(o, { type: pe.mp3 }),
 			chunks: o
 		};
 	} catch (e) {
@@ -1212,25 +1212,25 @@ function ge(e, t = U, r = 128) {
 }
 //#endregion
 //#region src/storage/aws-s3-provider.ts
-var _e = e.object({
+var ve = e.object({
 	uploadData: e.object({
 		url: e.string().min(1, "uploadData.url is required"),
 		fields: e.record(e.string(), e.string())
 	}),
 	folderPath: e.string().optional(),
 	txn_id: e.string().optional()
-}), W = "key", ve = "${filename}", G = "Content-Type", ye = "audio/mp3", K = class {
+}), ye = "key", U = "${filename}", W = "Content-Type", be = "audio/mp3", G = class {
 	constructor() {
 		this.name = "aws";
 	}
 	prepareUpload({ fileName: e, blob: t, upload: n }) {
-		let r = _e.safeParse(n);
+		let r = ve.safeParse(n);
 		if (!r.success) throw new E(`Invalid AWS upload payload in session response: ${r.error.message}`, [e]);
 		let { uploadData: i } = r.data, a = {};
-		for (let [t, n] of Object.entries(i.fields)) a[t] = t === W ? n.split(ve).join(e) : n;
-		if (!(G in a)) {
+		for (let [t, n] of Object.entries(i.fields)) a[t] = t === ye ? n.split(U).join(e) : n;
+		if (!(W in a)) {
 			let e = t?.type;
-			a[G] = e && e.startsWith("audio/") ? e : ye;
+			a[W] = e && e.startsWith("audio/") ? e : be;
 		}
 		return {
 			url: i.url,
@@ -1242,23 +1242,44 @@ var _e = e.object({
 			attachAuth: !1
 		};
 	}
-}, q = { aws: () => new K() };
-function J(e) {
+}, K = { aws: () => new G() };
+function q(e) {
 	return typeof e == "string" ? e.trim().toLowerCase() : "";
 }
-function be(e) {
-	return J(e) in q;
+function xe(e) {
+	return q(e) in K;
 }
-function Y(e) {
-	let t = q[J(e)];
+function J(e) {
+	let t = K[q(e)];
 	if (!t) throw new D(e);
 	return t();
 }
 //#endregion
+//#region src/storage/upload-file.ts
+async function Y(e, t) {
+	let n = J(t.storageProvider).prepareUpload({
+		fileName: t.fileName,
+		blob: t.blob,
+		upload: t.upload
+	});
+	return await e.request({
+		method: n.method,
+		url: n.url,
+		headers: n.headers,
+		isUpload: !0,
+		uploadBlob: t.blob,
+		uploadFormFields: n.formFields,
+		uploadFileFieldName: n.fileFieldName,
+		uploadFileName: t.fileName,
+		attachAuth: n.attachAuth,
+		maxRetries: t.maxRetries
+	});
+}
+//#endregion
 //#region src/worker/worker-manager.ts
-var xe = class {
+var Se = class {
 	constructor(e, t, n, r) {
-		if (this.worker = null, this.port = null, this.useWorker = !1, this.uploadPayload = {}, this.storageProviderName = "", this.storageProvider = null, this.uploadHeaders = {}, this.pendingUploads = /* @__PURE__ */ new Set(), this.allUploadsResolver = null, this.callbackRegistry = e, this.fileManager = t, this.transport = n, !r?.forceMainThread && typeof SharedWorker < "u" && r?.workerScriptUrl) try {
+		if (this.worker = null, this.port = null, this.useWorker = !1, this.uploadPayload = {}, this.storageProviderName = "", this.uploadHeaders = {}, this.pendingUploads = /* @__PURE__ */ new Set(), this.allUploadsResolver = null, this.callbackRegistry = e, this.fileManager = t, this.transport = n, !r?.forceMainThread && typeof SharedWorker < "u" && r?.workerScriptUrl) try {
 			this.worker = new SharedWorker(r.workerScriptUrl, { name: "scribe-sdk-worker" }), this.port = this.worker.port, this.port.onmessage = (e) => {
 				this.handleWorkerMessage(e.data);
 			}, this.port.start(), this.useWorker = !0;
@@ -1267,10 +1288,10 @@ var xe = class {
 		}
 	}
 	setUploadConfig(e, t, n) {
-		this.uploadPayload = e, this.storageProviderName = t, this.uploadHeaders = n, this.storageProvider = Y(t);
+		this.uploadPayload = e, this.storageProviderName = t, this.uploadHeaders = n, J(t);
 	}
 	compressAndUpload(e, t, n) {
-		let r = e.length / U;
+		let r = e.length / H;
 		if (r > 27) {
 			this.fileManager.markFailure(n, new Blob(), `Chunk exceeds maximum length: ${r.toFixed(1)}s > 25s`), this.callbackRegistry.dispatch("onError", {
 				type: m.VALIDATION_ERROR,
@@ -1382,7 +1403,7 @@ var xe = class {
 	async doMainThreadUpload(e, t, n) {
 		let r = null;
 		try {
-			let i = ge(e);
+			let i = _e(e);
 			if (!i) {
 				this.fileManager.markFailure(n, new Blob(), "MP3 encoding failed"), this.callbackRegistry.dispatch("onUploadEvent", {
 					type: f.FAILED,
@@ -1394,7 +1415,7 @@ var xe = class {
 				});
 				return;
 			}
-			if (r = i.blob, this.callbackRegistry.dispatch("onAudioEvent", {
+			r = i.blob, this.callbackRegistry.dispatch("onAudioEvent", {
 				type: d.CHUNK_READY,
 				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
 				data: {
@@ -1402,22 +1423,11 @@ var xe = class {
 					fileName: t,
 					chunkData: i.chunks
 				}
-			}), !this.storageProvider) throw Error("Storage provider not configured. Call setUploadConfig() first.");
-			let a = this.storageProvider.prepareUpload({
+			}), await Y(this.transport, {
 				fileName: t,
 				blob: r,
-				upload: this.uploadPayload
-			});
-			await this.transport.request({
-				method: a.method,
-				url: a.url,
-				headers: a.headers,
-				isUpload: !0,
-				uploadBlob: r,
-				uploadFormFields: a.formFields,
-				uploadFileFieldName: a.fileFieldName,
-				uploadFileName: t,
-				attachAuth: a.attachAuth
+				upload: this.uploadPayload,
+				storageProvider: this.storageProviderName
 			}), this.fileManager.markSuccess(n), this.dispatchUploadProgress();
 		} catch (e) {
 			this.fileManager.markFailure(n, r ?? new Blob(), e?.message ?? "Upload failed"), this.callbackRegistry.dispatch("onUploadEvent", {
@@ -1446,7 +1456,7 @@ var xe = class {
 	}
 }, X = class {
 	constructor(e, t, n, r) {
-		this._isPaused = !1, this.initialized = !1, this.chunkLimitReached = !1, this.chunkLimitOverridden = !1, this.callbackRegistry = e, this.bufferManager = new me(U, 25), this.fileManager = new he();
+		this._isPaused = !1, this.initialized = !1, this.chunkLimitReached = !1, this.chunkLimitOverridden = !1, this.callbackRegistry = e, this.bufferManager = new he(H, 25), this.fileManager = new ge();
 		let i = {
 			prefChunkLength: n?.prefChunkLength ?? 10,
 			despChunkLength: n?.despChunkLength ?? 20,
@@ -1457,7 +1467,7 @@ var xe = class {
 			shortSilenceThreshold: n?.shortSilenceThreshold,
 			longSilenceThreshold: n?.longSilenceThreshold
 		};
-		this.vadClient = new pe(i, e), this.workerManager = new xe(e, this.fileManager, t, r), this.wireVadCallbacks();
+		this.vadClient = new me(i, e), this.workerManager = new Se(e, this.fileManager, t, r), this.wireVadCallbacks();
 	}
 	initialize(e, t) {
 		if (!t.upload || typeof t.upload != "object") throw Error("Upload payload is required for chunked recording");
@@ -1553,12 +1563,12 @@ var xe = class {
 	}
 }, Z = class {
 	constructor(e, t) {
-		this.mediaRecorder = null, this.audioChunks = [], this.micStream = null, this._isPaused = !1, this.uploadPayload = {}, this.storageProvider = null, this.failedUploadData = null, this.callbackRegistry = e, this.transport = t;
+		this.mediaRecorder = null, this.audioChunks = [], this.micStream = null, this._isPaused = !1, this.uploadPayload = {}, this.storageProviderName = "", this.failedUploadData = null, this.callbackRegistry = e, this.transport = t;
 	}
 	initialize(e, t) {
 		if (!t.upload || typeof t.upload != "object") throw Error("Upload payload is required for single recording");
 		if (!t.storageProvider) throw Error("Storage provider is required for single recording");
-		this.uploadPayload = t.upload, this.storageProvider = Y(t.storageProvider), this.failedUploadData = null;
+		this.uploadPayload = t.upload, this.storageProviderName = t.storageProvider, J(t.storageProvider), this.failedUploadData = null;
 	}
 	async start(e) {
 		try {
@@ -1595,22 +1605,11 @@ var xe = class {
 		try {
 			let e = await this.stopMediaRecorder(), t = `audio_0.${this.getFileExtension()}`;
 			try {
-				if (!this.storageProvider) throw Error("Storage provider not configured. Call initialize() first.");
-				let n = this.storageProvider.prepareUpload({
+				return await Y(this.transport, {
 					fileName: t,
 					blob: e,
-					upload: this.uploadPayload
-				});
-				return await this.transport.request({
-					method: n.method,
-					url: n.url,
-					headers: n.headers,
-					isUpload: !0,
-					uploadBlob: e,
-					uploadFormFields: n.formFields,
-					uploadFileFieldName: n.fileFieldName,
-					uploadFileName: t,
-					attachAuth: n.attachAuth
+					upload: this.uploadPayload,
+					storageProvider: this.storageProviderName
 				}), this.callbackRegistry.dispatch("onUploadEvent", {
 					type: f.PROGRESS,
 					timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -1987,24 +1986,14 @@ var xe = class {
 			},
 			httpStatus: void 0
 		};
-		let { upload: e, storageProvider: t, failedChunks: n } = this.retryContext, r = n.length, i = [], a = 0, o = Y(t);
+		let { upload: e, storageProvider: t, failedChunks: n } = this.retryContext, r = n.length, i = [], a = 0;
 		this.config.debug && console.log(`[ScribeSDK] Retrying ${r} failed uploads`);
-		for (let t of n) try {
-			let n = o.prepareUpload({
-				fileName: t.fileName,
-				blob: t.blob,
-				upload: e
-			});
-			await this.transport.request({
-				method: n.method,
-				url: n.url,
-				headers: n.headers,
-				isUpload: !0,
-				uploadBlob: t.blob,
-				uploadFormFields: n.formFields,
-				uploadFileFieldName: n.fileFieldName,
-				uploadFileName: t.fileName,
-				attachAuth: n.attachAuth,
+		for (let o of n) try {
+			await Y(this.transport, {
+				fileName: o.fileName,
+				blob: o.blob,
+				upload: e,
+				storageProvider: t,
 				maxRetries: 0
 			}), a++, this.callbackRegistry.dispatch("onUploadEvent", {
 				type: f.PROGRESS,
@@ -2013,16 +2002,16 @@ var xe = class {
 					successCount: a,
 					totalCount: r
 				}
-			}), this.config.debug && console.log(`[ScribeSDK] Retry succeeded: ${t.fileName}`);
+			}), this.config.debug && console.log(`[ScribeSDK] Retry succeeded: ${o.fileName}`);
 		} catch (e) {
-			i.push(t.fileName), this.callbackRegistry.dispatch("onUploadEvent", {
+			i.push(o.fileName), this.callbackRegistry.dispatch("onUploadEvent", {
 				type: f.FAILED,
 				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
 				data: {
-					fileName: t.fileName,
+					fileName: o.fileName,
 					error: e instanceof Error ? e.message : "Retry failed"
 				}
-			}), this.config.debug && console.log(`[ScribeSDK] Retry failed: ${t.fileName}`, e);
+			}), this.config.debug && console.log(`[ScribeSDK] Retry failed: ${o.fileName}`, e);
 		}
 		return i.length === 0 ? this.retryContext = null : this.retryContext.failedChunks = n.filter((e) => i.includes(e.fileName)), this.config.debug && console.log(`[ScribeSDK] Retry complete: ${a}/${r} succeeded`), {
 			data: {
@@ -2045,7 +2034,7 @@ var xe = class {
 	}
 	resolveStorageProviderName() {
 		let e = this.getStorageProviderName();
-		return Y(e), e;
+		return J(e), e;
 	}
 	buildUploadHeaders(e) {
 		let t = {};
@@ -2092,14 +2081,14 @@ var xe = class {
 	partialCleanupAfterFailedFinalize() {
 		this.recorder = null, this._isRecording = !1, this._isStarting = !1;
 	}
-}, Se = class {
+}, Ce = class {
 	constructor(e) {
 		this.isInitialized = !1, this.validateConfig(e), this.config = {
 			debug: !1,
 			autoDiscovery: !0,
 			mode: l.DIRECT,
 			...e
-		}, this.callbackRegistry = new O(), this.validator = new N(), this.transport = this.createTransport(), this.discoveryManager = new B(this.transport, this.validator, this.config.debug), this.sessionManager = new V(this.transport, this.validator, this.config.debug), this.recordingManager = new Q(this.callbackRegistry, this.sessionManager, this.discoveryManager, this.transport, {
+		}, this.callbackRegistry = new O(), this.validator = new N(), this.transport = this.createTransport(), this.discoveryManager = new z(this.transport, this.validator, this.config.debug), this.sessionManager = new B(this.transport, this.validator, this.config.debug), this.recordingManager = new Q(this.callbackRegistry, this.sessionManager, this.discoveryManager, this.transport, {
 			debug: this.config.debug,
 			flavour: this.config.flavour,
 			workerConfig: this.resolveWorkerConfig()
@@ -2165,6 +2154,28 @@ var xe = class {
 	forceAllowMoreChunks() {
 		this.recordingManager.forceAllowMoreChunks();
 	}
+	async uploadAudioFile(e, t, n) {
+		return this.wrapResult(async () => {
+			if (!e || e.size === 0) throw new y("A non-empty audio file is required");
+			if (!t || !t.trim()) throw new y("fileName is required");
+			if (!n || typeof n != "object") throw new y("upload (upload_url payload) is required");
+			let r = await Y(this.transport, {
+				fileName: t,
+				blob: e,
+				upload: n,
+				storageProvider: this.getStorageProviderName()
+			});
+			return {
+				data: {
+					fileName: t,
+					status: r.status,
+					headers: r.headers,
+					response: r.data
+				},
+				httpStatus: r.status
+			};
+		});
+	}
 	async createSession(e) {
 		let t = this.getEffectiveBaseUrl();
 		return this.wrapResult(() => this.sessionManager.createSession(t, e));
@@ -2275,7 +2286,7 @@ var xe = class {
 		}) : Promise.resolve(void 0);
 		if (this.config.mode === l.IPC) {
 			if (!this.config.ipcTransport) throw new y("ipcTransport (IpcBridge) is required when mode is \"ipc\"");
-			return new R({
+			return new L({
 				bridge: this.config.ipcTransport,
 				accessToken: this.config.accessToken,
 				flavour: this.config.flavour,
@@ -2283,7 +2294,7 @@ var xe = class {
 				onUnauthorized: e
 			});
 		}
-		return new L({
+		return new I({
 			accessToken: this.config.accessToken,
 			flavour: this.config.flavour,
 			debug: this.config.debug,
@@ -2297,6 +2308,13 @@ var xe = class {
 			workerScriptUrl: this.config.workerScriptUrl
 		};
 	}
+	getStorageProviderName() {
+		try {
+			return this.discoveryManager.getResolvedConfig().storageProvider || "aws";
+		} catch {
+			return "aws";
+		}
+	}
 	getEffectiveBaseUrl() {
 		try {
 			return this.discoveryManager.getResolvedConfig().baseUrl;
@@ -2308,7 +2326,7 @@ var xe = class {
 		if (!e.baseUrl) throw new y("baseUrl is required");
 	}
 }, $ = "worker.bundle.js";
-function Ce() {
+function we() {
 	if (typeof window < "u" && window.__MEDSCRIBE_WORKER_URL__) return window.__MEDSCRIBE_WORKER_URL__;
 	if (typeof document < "u" && document.currentScript) {
 		let e = document.currentScript.src;
@@ -2316,11 +2334,11 @@ function Ce() {
 	}
 	return `/${$}`;
 }
-async function we(e) {
+async function Te(e) {
 	let t = e ?? `https://cdn.jsdelivr.net/npm/med-scribe-alliance-ts-sdk/dist/${$}`, n = await fetch(t);
 	if (!n.ok) throw Error(`Failed to fetch worker script: ${n.status} ${n.statusText}`);
 	let r = await n.text(), i = new Blob([r], { type: "application/javascript" });
 	return URL.createObjectURL(i);
 }
 //#endregion
-export { d as AudioEventType, x as AuthenticationError, K as AwsS3StorageProvider, O as CallbackRegistry, c as CommunicationProtocol, h as DiscardReason, b as DiscoveryError, B as DiscoveryManager, g as ErrorCode, m as ErrorEventType, S as ForbiddenError, _ as HttpStatus, L as HttpTransport, R as IpcTransport, w as RateLimitError, Q as RecordingManager, u as RecordingState, Se as ScribeClient, v as ScribeError, p as SessionEventType, te as SessionExpiredError, V as SessionManager, C as SessionNotFoundError, a as SessionStatus, o as TemplateStatus, T as TransportError, l as TransportMode, D as UnsupportedStorageProviderError, E as UploadError, f as UploadEventType, s as UploadType, y as ValidationError, N as Validator, ne as WorkerError, we as createWorkerBlobUrl, Y as getStorageProvider, Ce as getWorkerUrl, be as isStorageProviderSupported };
+export { d as AudioEventType, x as AuthenticationError, G as AwsS3StorageProvider, O as CallbackRegistry, c as CommunicationProtocol, h as DiscardReason, b as DiscoveryError, z as DiscoveryManager, g as ErrorCode, m as ErrorEventType, S as ForbiddenError, _ as HttpStatus, I as HttpTransport, L as IpcTransport, w as RateLimitError, Q as RecordingManager, u as RecordingState, Ce as ScribeClient, v as ScribeError, p as SessionEventType, te as SessionExpiredError, B as SessionManager, C as SessionNotFoundError, a as SessionStatus, o as TemplateStatus, T as TransportError, l as TransportMode, D as UnsupportedStorageProviderError, E as UploadError, f as UploadEventType, s as UploadType, y as ValidationError, N as Validator, ne as WorkerError, Te as createWorkerBlobUrl, J as getStorageProvider, we as getWorkerUrl, xe as isStorageProviderSupported };

package/package.json

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