@burdenoff/fe-libs 2026.1007.2 → 2026.1007.4

package/dist/shared/assistant/voice/handsfree/backendStreamTransport.js

@@ -1,9 +1,18 @@
+import { sttSubprotocols as e } from "./streamingConfig.js";
 //#region src/shared/assistant/voice/handsfree/backendStreamTransport.ts
-var e = 6400, t = 1, n = {
+var t = 6400, n = 1, r = {
+	4400: {
+		code: "upstream",
+		retryable: !1
+	},
 	4401: {
 		code: "auth",
 		retryable: !1
 	},
+	4403: {
+		code: "auth",
+		retryable: !1
+	},
 	4408: {
 		code: "closed",
 		retryable: !0
@@ -19,107 +28,173 @@ var e = 6400, t = 1, n = {
 	4500: {
 		code: "upstream",
 		retryable: !0
+	},
+	4503: {
+		code: "upstream",
+		retryable: !0
 	}
-}, r = (e) => typeof e == "object" && e && !Array.isArray(e) ? e : null;
-function i(t) {
-	let n = Math.floor(e / 2), r = [], i = [], a = () => {
+}, i = new Set([
+	1e3,
+	1001,
+	4408,
+	4503
+]), a = 5e3, o = 2e4, s = (e) => typeof e == "object" && e && !Array.isArray(e) ? e : null;
+function c(e) {
+	let n = Math.floor(t / 2), r = [], i = [], a = () => {
 		i.length > 0 && r.push(Int16Array.from(i)), i = [];
 	};
-	for (let e of t) for (let t of e) i.push(t), i.length === n && a();
+	for (let t of e) for (let e of t) i.push(e), i.length === n && a();
 	return a(), r;
 }
-function a(e) {
-	let a = null, o = null, s = "en-IN", c = null, l = null, u = null, d = (e, t) => {
-		o?.onError({
+function l(t) {
+	let a = t.now ?? (() => Date.now()), o = t.setInterval ?? ((e, t) => setInterval(e, t)), l = t.clearInterval ?? ((e) => clearInterval(e)), u = t.keepAliveMs ?? 2e4, d = null, f = null, p = "en-IN", m = null, h = null, g = null, _ = null, v = !1, y = !1, b = (e, t) => {
+		y || v || (y = !0, f?.onError({
 			code: e,
 			retryable: t
-		});
-	}, f = () => new Promise((t) => {
-		e.fetchTicket().then(({ ticket: i, wsUrl: c }) => {
-			let f = e.createSocket(c, [`bearer.${i}`]);
-			a = f, f.listen({
-				open: () => t(!0),
-				error: () => t(!1),
-				close: (e) => {
-					a === f && (a = null), t(!1);
-					let r = n[e];
-					r ? d(r.code, r.retryable) : l && d("closed", !0);
+		}));
+	}, x = (e) => {
+		d && d.readyState === n && d.send(e);
+	}, S = () => {
+		_ !== null && l(_), _ = null;
+	}, C = () => {
+		S(), _ = o(() => {
+			x(JSON.stringify({ t: "ping" }));
+		}, u);
+	}, w = (e) => {
+		h?.utteranceId === e && (h = null), g === e && (g = null);
+	}, T = (e) => {
+		if (typeof e != "string") return;
+		let t;
+		try {
+			t = s(JSON.parse(e));
+		} catch {
+			return;
+		}
+		if (t) {
+			if (t.t === "partial" || t.t === "final") {
+				if (typeof t.text != "string" || typeof t.utteranceId != "string" || typeof t.epoch != "number") return;
+				t.t === "final" && g === t.utteranceId && (g = null), f?.onTranscript({
+					text: t.text,
+					final: t.t === "final",
+					utteranceId: t.utteranceId,
+					epoch: t.epoch,
+					language: typeof t.lang == "string" ? t.lang : p
+				});
+			} else if (t.t === "done") typeof t.utteranceId == "string" && g === t.utteranceId && (g = null);
+			else if (t.t === "error") {
+				let e = t.code === "quota" ? "quota" : t.code === "auth" ? "auth" : "upstream", n = t.retryable === !0;
+				if (e === "upstream" && n && typeof t.utteranceId == "string") {
+					w(t.utteranceId);
+					return;
+				}
+				b(e, n);
+			}
+		}
+	}, E = () => new Promise((n) => {
+		let o = !1, s = (e) => {
+			o || (o = !0, n(e));
+		};
+		t.resolveConnection().then((n) => {
+			if (v) {
+				s(!1);
+				return;
+			}
+			if (n === null) {
+				b("auth", !1), s(!1);
+				return;
+			}
+			let o;
+			try {
+				o = t.createSocket(n.url, e(n.token));
+			} catch {
+				s(!1);
+				return;
+			}
+			d = o;
+			let c = null;
+			o.listen({
+				open: () => {
+					d === o && (c = a(), C(), s(!0));
 				},
-				message: (e) => {
-					if (typeof e != "string") return;
-					let t;
-					try {
-						t = r(JSON.parse(e));
-					} catch {
+				error: () => s(!1),
+				close: (e) => {
+					let t = d === o;
+					if (t && (d = null, S()), s(!1), !t || v || c === null) return;
+					if (i.has(e) && a() - c >= 5e3) {
+						D();
 						return;
 					}
-					if (t) if (t.t === "partial" || t.t === "final") {
-						if (typeof t.text != "string" || typeof t.utteranceId != "string" || typeof t.epoch != "number") return;
-						t.t === "final" && u === t.utteranceId && (u = null), o?.onTranscript({
-							text: t.text,
-							final: t.t === "final",
-							utteranceId: t.utteranceId,
-							epoch: t.epoch,
-							language: typeof t.lang == "string" ? t.lang : s
-						});
-					} else t.t === "error" && d(t.code === "quota" ? "quota" : t.code === "auth" ? "auth" : "upstream", t.retryable === !0);
-				}
+					let n = r[e];
+					n ? b(n.code, n.retryable) : b("closed", !0);
+				},
+				message: T
 			});
 		}).catch(() => {
-			d("auth", !1), t(!1);
+			b("unavailable", !1), s(!1);
+		});
+	}), D = () => {
+		h = null, g = null;
+		let e = E();
+		m = e, e.then((t) => {
+			!t && m === e && b("unavailable", !1);
 		});
-	}), p = (e) => {
-		a && a.readyState === t && a.send(e);
 	};
 	return {
 		kind: "backend-stream",
 		recognitionOwner: "transport",
 		keepsOpeningWords: !0,
-		async start(e, t, n) {
-			o = n, s = t, c = f(), await c || d("unavailable", !1);
+		async start(e, n, r) {
+			if (f = r, p = n, v = !1, y = !1, t.languages(n) === null) {
+				b("unavailable", !1);
+				return;
+			}
+			let i = E();
+			m = i, !await i && m === i && b("unavailable", !1);
 		},
-		openUtterance(t) {
-			l = {
-				utteranceId: t.utteranceId,
-				epoch: t.epoch
+		openUtterance(e) {
+			h = {
+				utteranceId: e.utteranceId,
+				epoch: e.epoch
 			};
-			let n = t.preRoll;
-			(c ?? Promise.resolve(!1)).then((r) => {
-				if (!(!r || l?.utteranceId !== t.utteranceId)) {
-					p(JSON.stringify({
+			let n = e.preRoll;
+			(m ?? Promise.resolve(!1)).then((r) => {
+				if (!r || h?.utteranceId !== e.utteranceId) return;
+				let i = t.languages(p);
+				if (i !== null) {
+					x(JSON.stringify({
 						t: "config",
 						v: 1,
-						utteranceId: t.utteranceId,
-						epoch: t.epoch,
-						langs: e.languages(s),
+						utteranceId: e.utteranceId,
+						epoch: e.epoch,
+						langs: i,
 						sampleRate: 16e3,
 						encoding: "s16le"
 					}));
-					for (let e of i(n)) p(e);
+					for (let e of c(n)) x(e);
 				}
 			});
 		},
 		pushFrame(e) {
-			l && p(e);
+			h && x(e);
 		},
 		closeUtterance(e) {
-			l?.utteranceId === e && (p(JSON.stringify({
+			h?.utteranceId === e && (x(JSON.stringify({
 				t: "end",
 				utteranceId: e
-			})), u = e, l = null);
+			})), g = e, h = null);
 		},
 		cancelUtterance(e) {
-			if (l?.utteranceId === e) l = null;
-			else if (u !== e) return;
-			u = null, p(JSON.stringify({
+			if (h?.utteranceId === e) h = null;
+			else if (g !== e) return;
+			g = null, x(JSON.stringify({
 				t: "cancel",
 				utteranceId: e
 			}));
 		},
 		stop() {
-			l = null;
-			let e = a;
-			a = null, c = null;
+			v = !0, h = null, g = null, S();
+			let e = d;
+			d = null, m = null;
 			try {
 				e?.close(1e3);
 			} catch {}
@@ -127,4 +202,4 @@ function a(e) {
 	};
 }
 //#endregion
-export { n as CLOSE_CODE_ERRORS, e as MAX_SEND_BYTES, i as chunkFrames, a as createBackendStreamTransport };
+export { r as CLOSE_CODE_ERRORS, o as KEEP_ALIVE_MS, t as MAX_SEND_BYTES, a as MIN_STABLE_MS, i as RECONNECT_CLOSE_CODES, c as chunkFrames, l as createBackendStreamTransport };

package/dist/shared/assistant/voice/handsfree/handsFreeController.d.ts

@@ -4,7 +4,13 @@ import { MicCaptureHandle } from './micCapture';
 import { PlaybackSource } from './playbackReference';
 import { SttTransport } from './sttTransport';
 import { VoiceSessionPhase } from '../voiceSession';
-export type FallbackReason = "mic-denied" | "mic-unavailable" | "transport-unavailable" | "transport-auth" | "transport-quota" | "transport-upstream" | "phantom-barge-ins";
+export type FallbackReason = "mic-denied" | "mic-unavailable" | "transport-unavailable" | "transport-auth" | "transport-quota" | "transport-upstream" | "phantom-barge-ins"
+/**
+ * The person chose "Not now" on the backend stream's privacy notice. Raised
+ * by `useHandsFreeInterrupt`, never by the controller: the microphone was
+ * never opened.
+ */
+ | "notice-declined";
 export interface ControllerSession {
     phase: VoiceSessionPhase;
     muted: boolean;

package/dist/shared/assistant/voice/handsfree/handsFreeController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handsFreeController.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/voice/handsfree/handsFreeController.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handsFreeController.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/voice/handsfree/handsFreeController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,iBAAiB,GACjB,uBAAuB,GACvB,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB;AACrB;;;;GAIG;GACD,iBAAiB,CAAC;AAEtB,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,YAAY,EAAE,CACZ,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,KAC1C,OAAO,CAAC,gBAAgB,GAAG,WAAW,CAAC,CAAC;IAC7C,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,MAAM,iBAAiB,CAAC;IACpC,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,cAAc,CAAC;IACxC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;IAC/B,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,oGAAoG;IACpG,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,kDAAkD;IAClD,YAAY,EAAE,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GAAG,SAAS,KACzB,IAAI,CAAC;IACV,mFAAmF;IACnF,UAAU,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACzE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,CAAC;IAC7D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACpD;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,0BAA0B,CAAC;IACvC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACrD,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAW9B,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,IAAI,CAAC;IACb,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,cAAc,GACnB,mBAAmB,CA+NrB"}

package/dist/shared/assistant/voice/handsfree/handsFreeRuntime.d.ts

@@ -1,15 +1,23 @@
+import { SocketLike, StreamConnection } from './backendStreamTransport';
+import { HandsFreeStreamingConfig } from './streamingConfig';
 import { SttTransport, SttTransportKind, TransportChoice, TransportEnvironment } from './sttTransport';
-/** Feature flag + endpoint for the backend stream. Unset by default: never selected. */
-export interface StreamingConfig {
-    enabled: boolean;
-    ticketUrl: string;
-    getAuthorization: () => string | null;
-}
-/** Configure (or, with `null`, clear) the backend-stream route. Nothing calls this today. */
-export declare function configureHandsFreeStreaming(config: StreamingConfig | null): void;
-export declare function readTransportEnvironment(): TransportEnvironment;
+/**
+ * What this browser offers, for the person's input language (a tag such as
+ * `ta-IN`) and the app's streaming configuration (the registered one unless
+ * given).
+ */
+export declare function readTransportEnvironment(language: string, streaming?: HandsFreeStreamingConfig | null): TransportEnvironment;
 /** Phones: the OS recogniser and a getUserMedia stream contend for the one microphone. */
 export declare function isMobileUserAgent(userAgent: string): boolean;
-export declare function chooseTransport(env?: TransportEnvironment): TransportChoice;
+export declare function chooseTransport(env: TransportEnvironment): TransportChoice;
 export declare function createRuntimeTransport(kind: SttTransportKind): SttTransport;
+/**
+ * The configured URL and the signed-in person's token, read when each
+ * connection opens (a refreshed token is picked up). Rejects when the route is
+ * not configured or not switched on (only the test-only transport override can
+ * ask for it then); `null` when there is no usable token.
+ */
+export declare function resolveStreamConnection(): Promise<StreamConnection | null>;
+/** The browser WebSocket behind `SocketLike`. */
+export declare function openBrowserSocket(url: string, protocols: string[]): SocketLike;
 //# sourceMappingURL=handsFreeRuntime.d.ts.map

package/dist/shared/assistant/voice/handsfree/handsFreeRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handsFreeRuntime.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/voice/handsfree/handsFreeRuntime.ts"],"names":[],"mappings":"AAiBA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAOxB,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACvC;AAID,6FAA6F;AAC7F,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,eAAe,GAAG,IAAI,GAC7B,IAAI,CAEN;AAaD,wBAAgB,wBAAwB,IAAI,oBAAoB,CAS/D;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,eAAe,CAC7B,GAAG,GAAE,oBAAiD,GACrD,eAAe,CAIjB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CA0D3E"}
+{"version":3,"file":"handsFreeRuntime.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/voice/handsfree/handsFreeRuntime.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAGL,KAAK,wBAAwB,EAE9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAkBxB;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,wBAAwB,GAAG,IAA+B,GACpE,oBAAoB,CAStB;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,oBAAoB,GAAG,eAAe,CAI1E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAiB3E;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAOhF;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,UAAU,CAgB9E"}

package/dist/shared/assistant/voice/handsfree/handsFreeRuntime.js

@@ -1,78 +1,67 @@
 import { readTransportOverride as e } from "./handsFreeSetting.js";
 import { createAudioTrackTransport as t } from "./audioTrackTransport.js";
-import { createBackendStreamTransport as n } from "./backendStreamTransport.js";
-import { isMicCaptureSupported as r } from "./micCapture.js";
-import { selectSttTransport as i } from "./sttTransport.js";
-import { createWebSpeechTransport as a } from "./webSpeechTransport.js";
+import { accessTokenFrom as n, readHandsFreeStreaming as r, streamLanguagesFor as i } from "./streamingConfig.js";
+import { createBackendStreamTransport as a } from "./backendStreamTransport.js";
+import { isMicCaptureSupported as o } from "./micCapture.js";
+import { selectSttTransport as s } from "./sttTransport.js";
+import { createWebSpeechTransport as c } from "./webSpeechTransport.js";
 //#region src/shared/assistant/voice/handsfree/handsFreeRuntime.ts
-var o = null;
-function s(e) {
-	o = e;
-}
-function c() {
+function l() {
 	if (typeof window > "u") return null;
 	let e = window.SpeechRecognition ?? window.webkitSpeechRecognition;
 	return typeof e == "function" ? e : null;
 }
-function l() {
+function u(e, t = r()) {
 	return {
 		userAgent: typeof navigator > "u" ? "" : navigator.userAgent,
-		hasSpeechRecognition: c() !== null,
-		hasAudioWorklet: r(),
-		backendStreamEnabled: o?.enabled === !0,
-		backendStreamConfigured: o !== null && o.ticketUrl !== ""
+		hasSpeechRecognition: l() !== null,
+		hasAudioWorklet: o(),
+		backendStreamEnabled: t?.enabled === !0,
+		backendStreamConfigured: t !== null,
+		backendStreamLanguage: i(e) !== null
 	};
 }
-function u(e) {
+function d(e) {
 	return /Android|iPhone|iPad|iPod|Mobile/.test(e);
 }
-function d(t = l()) {
+function f(t) {
 	let n = e();
 	return n ? {
 		kind: n,
 		because: "test-override"
-	} : i(t);
+	} : s(t);
 }
-function f(e) {
-	if (e === "audio-track") return t({ createRecognition: () => {
-		let e = c();
+function p(e) {
+	return e === "audio-track" ? t({ createRecognition: () => {
+		let e = l();
 		return e ? new e() : null;
-	} });
-	if (e === "backend-stream") {
-		let e = o;
-		return n({
-			fetchTicket: async () => {
-				if (!e) throw Error("streaming not configured");
-				let t = e.getAuthorization(), n = await fetch(e.ticketUrl, {
-					method: "POST",
-					headers: t ? { authorization: t } : {},
-					credentials: "include"
-				});
-				if (!n.ok) throw Error(`ticket ${n.status}`);
-				let r = await n.json(), i = typeof r == "object" && r ? r : {};
-				if (typeof i.ticket != "string" || typeof i.wsUrl != "string") throw Error("bad ticket response");
-				return {
-					ticket: i.ticket,
-					wsUrl: i.wsUrl
-				};
-			},
-			createSocket: (e, t) => {
-				let n = new WebSocket(e, t);
-				return n.binaryType = "arraybuffer", {
-					get readyState() {
-						return n.readyState;
-					},
-					send: (e) => n.send(e),
-					close: (e) => n.close(e),
-					listen(e) {
-						n.onopen = () => e.open(), n.onerror = () => e.error(), n.onclose = (t) => e.close(t.code), n.onmessage = (t) => e.message(t.data);
-					}
-				};
-			},
-			languages: (e) => e.toLowerCase().startsWith("en") ? [e] : [e, "en-IN"]
-		});
-	}
-	return a();
+	} }) : e === "backend-stream" ? a({
+		resolveConnection: m,
+		createSocket: h,
+		languages: i
+	}) : c();
+}
+async function m() {
+	let e = r();
+	if (e === null || !e.enabled) throw Error("hands-free streaming is not configured");
+	let t = n(await e.getAuthorization());
+	return t === null ? null : {
+		url: e.url,
+		token: t
+	};
+}
+function h(e, t) {
+	let n = new WebSocket(e, t);
+	return n.binaryType = "arraybuffer", {
+		get readyState() {
+			return n.readyState;
+		},
+		send: (e) => n.send(e),
+		close: (e) => n.close(e),
+		listen(e) {
+			n.onopen = () => e.open(), n.onerror = () => e.error(), n.onclose = (t) => e.close(t.code), n.onmessage = (t) => e.message(t.data);
+		}
+	};
 }
 //#endregion
-export { d as chooseTransport, s as configureHandsFreeStreaming, f as createRuntimeTransport, u as isMobileUserAgent, l as readTransportEnvironment };
+export { f as chooseTransport, p as createRuntimeTransport, d as isMobileUserAgent, h as openBrowserSocket, u as readTransportEnvironment, m as resolveStreamConnection };

package/dist/shared/assistant/voice/handsfree/streamingConfig.d.ts

@@ -0,0 +1,103 @@
+/**
+ * The backend-stream route's configuration (BOFF-8613, H3): where the gateway's
+ * streaming speech-to-text socket is, how the caller proves who they are, which
+ * languages it may carry, and which privacy notice the person has to see first.
+ *
+ * ★ INERT UNLESS AN APP CONFIGURES IT. Nothing in fe-libs calls
+ * `configureHandsFreeStreaming`; until a product does (and passes
+ * `enabled: true` with a usable URL) `selectSttTransport` never picks the
+ * backend stream, no notice is shown and no socket is opened. The rest of the
+ * hands-free feature behaves exactly as before.
+ *
+ * The gateway contract (`global-public-gateway` `src/stt-proxy.ts`):
+ *   `GET wss://<gateway>/api/stt/v1/stream`, offered subprotocols
+ *   `boff.stt.v1` and `bearer.<access token>`. The token travels in the
+ *   `Sec-WebSocket-Protocol` header, never in the URL (ALB and CDN logs keep
+ *   URLs), and the gateway removes it before the handshake completes. There is
+ *   no ticket endpoint.
+ *
+ * Pure apart from the module-level registration: every helper here is a
+ * function of its arguments, so it is tested without a browser.
+ */
+/** The gateway route. */
+export declare const STT_STREAM_PATH = "/api/stt/v1/stream";
+/** The one subprotocol the gateway selects; offered next to `bearer.<token>`. */
+export declare const STT_SUBPROTOCOL = "boff.stt.v1";
+export declare const STT_BEARER_PREFIX = "bearer.";
+/**
+ * The privacy notice the person accepts before the microphone first opens on
+ * the backend stream. The accepted VERSION is what is remembered, so a change
+ * of provider or processing region (which changes what the notice says) is a
+ * new version and asks again.
+ */
+export declare const HANDS_FREE_STREAM_NOTICE_VERSION = "google-stt-eu-1";
+/** What an app passes. */
+export interface HandsFreeStreamingOptions {
+    /** The app's switch for this environment. False: never selected. */
+    enabled: boolean;
+    /**
+     * The gateway's stream endpoint, `wss://<gateway>/api/stt/v1/stream`
+     * (`sttStreamUrlFromGateway` builds it from any gateway URL). An `https://`
+     * URL is accepted and converted. A URL that cannot be used leaves the stream
+     * unconfigured rather than half-working.
+     */
+    url: string;
+    /**
+     * The signed-in person's access token, or `Bearer <token>`, read when each
+     * connection opens (so a refreshed token is used). `null`: not signed in, and
+     * the session falls back to the browser's recogniser.
+     */
+    getAuthorization: () => string | null | Promise<string | null>;
+}
+/** The validated form the runtime uses. */
+export interface HandsFreeStreamingConfig {
+    enabled: boolean;
+    url: string;
+    getAuthorization: () => string | null | Promise<string | null>;
+}
+/**
+ * The stream URL in its canonical form, or null when it cannot be used.
+ *
+ * - `https:` becomes `wss:`; `http:` becomes `ws:`;
+ * - plain `ws:` only on a loopback host (the token would otherwise travel in
+ *   clear text);
+ * - an empty or root path becomes the gateway route; any other path is kept
+ *   (a gateway mounted under a prefix);
+ * - a query string or fragment is refused: nothing about the caller belongs in
+ *   a URL that access logs keep, and the gateway reads none.
+ */
+export declare function normalizeSttStreamUrl(raw: string): string | null;
+/**
+ * The stream URL on the same host as any gateway URL an app already has, e.g.
+ * `https://alphagraphql.burdenoff.com/global/graphql` gives
+ * `wss://alphagraphql.burdenoff.com/api/stt/v1/stream`. Null when it cannot be
+ * used (see `normalizeSttStreamUrl`).
+ */
+export declare function sttStreamUrlFromGateway(gatewayUrl: string): string | null;
+/**
+ * The bare token from `Bearer <token>` or `<token>`, or null when it is
+ * missing or could not travel as a subprotocol (the gateway would refuse it
+ * with 4400 anyway; refusing here keeps it off the wire).
+ */
+export declare function accessTokenFrom(authorization: string | null | undefined): string | null;
+/** The subprotocols offered for one connection: ours, then the credential. */
+export declare function sttSubprotocols(token: string): string[];
+/**
+ * The language list sent with each utterance for the person's input language
+ * (a tag such as `ta-IN` or a bare code such as `ta`), or null when the backend
+ * stream does not carry that language.
+ */
+export declare function streamLanguagesFor(inputLanguage: string): string[] | null;
+/**
+ * Configure (or, with `null`, clear) the backend-stream route. An app calls
+ * this once at start-up, for the environments where the operator has switched
+ * the gateway route on. Options with an unusable URL clear it.
+ */
+export declare function configureHandsFreeStreaming(options: HandsFreeStreamingOptions | null): void;
+/** The current configuration, or null when the route is not configured. */
+export declare function readHandsFreeStreaming(): HandsFreeStreamingConfig | null;
+/** True when an app has switched the route on with a usable URL. */
+export declare function isHandsFreeStreamingActive(): boolean;
+/** Called after every `configureHandsFreeStreaming`. Returns the unsubscribe. */
+export declare function subscribeHandsFreeStreaming(listener: () => void): () => void;
+//# sourceMappingURL=streamingConfig.d.ts.map

package/dist/shared/assistant/voice/handsfree/streamingConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamingConfig.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/voice/handsfree/streamingConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,yBAAyB;AACzB,eAAO,MAAM,eAAe,uBAAuB,CAAC;AACpD,iFAAiF;AACjF,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAoC3C;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,oBAAoB,CAAC;AAElE,0BAA0B;AAC1B,MAAM,WAAW,yBAAyB;IACxC,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChE;AAED,2CAA2C;AAC3C,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBhE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQzE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,MAAM,GAAG,IAAI,CAKf;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAIzE;AAUD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GACxC,IAAI,CAeN;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,IAAI,wBAAwB,GAAG,IAAI,CAExE;AAED,oEAAoE;AACpE,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK5E"}

package/dist/shared/assistant/voice/handsfree/streamingConfig.js

@@ -0,0 +1,71 @@
+//#region src/shared/assistant/voice/handsfree/streamingConfig.ts
+var e = "/api/stt/v1/stream", t = "boff.stt.v1", n = "bearer.", r = /^[A-Za-z0-9._~-]+$/, i = 4096, a = new Set([
+	"localhost",
+	"127.0.0.1",
+	"[::1]"
+]), o = {
+	en: ["en-IN"],
+	ta: ["ta-IN", "en-IN"],
+	hi: ["hi-IN", "en-IN"]
+}, s = "google-stt-eu-1";
+function c(t) {
+	if (typeof t != "string" || t.trim() === "") return null;
+	let n;
+	try {
+		n = new URL(t.trim());
+	} catch {
+		return null;
+	}
+	if (n.username !== "" || n.password !== "" || n.search !== "" || n.hash !== "") return null;
+	let r = n.protocol === "https:" ? "wss:" : n.protocol === "http:" ? "ws:" : n.protocol;
+	if (r !== "wss:" && r !== "ws:" || r === "ws:" && !a.has(n.hostname.toLowerCase())) return null;
+	let i = n.pathname === "" || n.pathname === "/" ? e : n.pathname;
+	return `${r}//${n.host}${i}`;
+}
+function l(t) {
+	let n;
+	try {
+		n = new URL(t);
+	} catch {
+		return null;
+	}
+	return c(`${n.protocol}//${n.host}${e}`);
+}
+function u(e) {
+	if (typeof e != "string") return null;
+	let t = e.trim().replace(/^bearer(?:\s+|$)/i, "");
+	return t === "" || t.length > i ? null : r.test(t) ? t : null;
+}
+function d(e) {
+	return [t, `${n}${e}`];
+}
+function f(e) {
+	let t = o[e.trim().toLowerCase().split(/[-_]/)[0] ?? ""];
+	return t ? [...t] : null;
+}
+var p = null, m = /* @__PURE__ */ new Set();
+function h(e) {
+	if (e === null) p = null;
+	else {
+		let t = c(e.url);
+		p = t === null ? null : {
+			enabled: e.enabled === !0,
+			url: t,
+			getAuthorization: e.getAuthorization
+		};
+	}
+	for (let e of [...m]) e();
+}
+function g() {
+	return p;
+}
+function _() {
+	return p !== null && p.enabled;
+}
+function v(e) {
+	return m.add(e), () => {
+		m.delete(e);
+	};
+}
+//#endregion
+export { s as HANDS_FREE_STREAM_NOTICE_VERSION, n as STT_BEARER_PREFIX, e as STT_STREAM_PATH, t as STT_SUBPROTOCOL, u as accessTokenFrom, h as configureHandsFreeStreaming, _ as isHandsFreeStreamingActive, c as normalizeSttStreamUrl, g as readHandsFreeStreaming, f as streamLanguagesFor, l as sttStreamUrlFromGateway, d as sttSubprotocols, v as subscribeHandsFreeStreaming };