med-scribe-alliance-ts-sdk 2.0.44 → 2.0.47

package/README.md

@@ -198,7 +198,7 @@ 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). 
+- **Audio uploads go to a server-selected storage backend.** The create-session response decides it: `storage_provider: "aws"` with an `upload_url` object means a direct S3 presigned POST; an `upload_url` string means the audio is posted to the backend endpoint instead. Discovery's `capabilities.storage_providers` only advertises which backends the deployment can mint URLs for. 
 
 - **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.
@@ -390,7 +390,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. |
+| `uploadAudioFile(file, fileName, upload, options?)` | `SDKResult<UploadAudioFileResult>` | Upload one pre-recorded audio file using a session's `upload_url` (string or presigned object). No mic/recorder. The provider is taken from the session's `storage_provider`, or inferred from the payload shape; `options.storageProvider` overrides both. |
 
 ### Session
 
@@ -628,7 +628,7 @@ console.log(result.data.session_id);
 | `TransportError` | — | Network / IPC failure |
 | `WorkerError` | — | SharedWorker 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`. |
+| `UnsupportedStorageProviderError` | — | The session's `storage_provider` names a backend this SDK build has no wrapper for. Thrown at `startRecording`. Has `provider: string`. |
 
 ## SharedWorker Support
 

package/dist/index.d.ts

@@ -323,7 +323,7 @@ export interface CapabilitiesInfo {
 	upload_methods?: string[];
 	webhook_delivery?: boolean;
 	client_sdk_delivery?: boolean;
-	storage_provider?: string;
+	storage_providers?: string[];
 }
 export interface ModelConfig {
 	id: string;
@@ -352,7 +352,7 @@ export interface ResolvedConfig {
 	autoDetectLanguage: boolean;
 	supportedAudioFormats: string[];
 	supportedUploadMethods: string[];
-	storageProvider: string;
+	storageProviders: string[];
 	maxChunkDurationSeconds: number;
 	/** modelId -> max session duration in seconds */
 	maxSessionDurationSeconds: Map<string, number>;
@@ -381,14 +381,14 @@ export interface CreateSessionRequest {
 	patient_details?: PatientDetails;
 	session_id?: string;
 }
-/** Provider-specific upload payload; validated/interpreted by the StorageProvider, not the session schema. */
-export type SessionUploadInfo = Record<string, unknown>;
+export type SessionUploadInfo = string | Record<string, unknown>;
 export interface CreateSessionResponse {
 	session_id: string;
 	status: SessionStatus;
 	created_at: string;
 	expires_at: string;
 	upload_url: SessionUploadInfo;
+	storage_provider?: string | null;
 	patient_details?: PatientDetails;
 }
 export interface EndSessionRequest {
@@ -818,7 +818,9 @@ export declare class ScribeClient {
 	 * @param fileName - Storage object name, e.g. "1.mp3".
 	 * @param upload - The `upload_url` payload from the create-session response.
 	 */
-	uploadAudioFile(file: Blob, fileName: string, upload: SessionUploadInfo): Promise<SDKResult<UploadAudioFileResult>>;
+	uploadAudioFile(file: Blob, fileName: string, upload: SessionUploadInfo, options?: {
+		storageProvider?: string | null;
+	}): Promise<SDKResult<UploadAudioFileResult>>;
 	/**
 	 * Create a session directly (without starting a recording).
 	 */
@@ -934,8 +936,7 @@ export declare class ScribeClient {
 	 */
 	private createTransport;
 	private resolveWorkerConfig;
-	/** Storage provider name from discovery; defaults to 'aws'. */
-	private getStorageProviderName;
+	private providerForUpload;
 	/**
 	 * Get the effective base URL — prefer discovery's base_url, fall back to config.
 	 */
@@ -965,7 +966,6 @@ export interface PreparedUpload {
 	attachAuth: boolean;
 }
 export interface StorageProvider {
-	/** Matches discovery's `capabilities.storage_provider`. */
 	readonly name: string;
 	/** @throws UploadError if the upload payload is malformed. */
 	prepareUpload(ctx: UploadContext): PreparedUpload;
@@ -974,6 +974,14 @@ export declare class AwsS3StorageProvider implements StorageProvider {
 	readonly name = "aws";
 	prepareUpload({ fileName, blob, upload }: UploadContext): PreparedUpload;
 }
+export declare class BackendStorageProvider implements StorageProvider {
+	readonly name = "backend";
+	prepareUpload({ fileName, blob, upload }: UploadContext): PreparedUpload;
+}
+export declare const AWS_STORAGE_PROVIDER = "aws";
+export declare const BACKEND_STORAGE_PROVIDER = "backend";
+export declare function hasUploadPayload(upload: unknown): upload is SessionUploadInfo;
+export declare function resolveStorageProvider(sessionProvider: string | null | undefined, upload: SessionUploadInfo | undefined): string;
 export declare function isStorageProviderSupported(name: string): boolean;
 /** @throws UnsupportedStorageProviderError if no wrapper is registered. */
 export declare function getStorageProvider(name: string): StorageProvider;
@@ -1245,9 +1253,7 @@ export declare class RecordingManager {
 	 * Create the appropriate recorder based on upload type.
 	 */
 	private createRecorder;
-	/** Storage provider name from discovery; defaults to 'aws'. */
 	private getStorageProviderName;
-	/** Validate the provider has a wrapper (throws UnsupportedStorageProviderError) and return its name. */
 	private resolveStorageProviderName;
 	/**
 	 * Build upload headers from the current auth state.