@burdenoff/fe-libs 2026.904.1 → 2026.904.3

package/dist/shared/assistant/index.d.ts

@@ -60,4 +60,7 @@ export * from './operations';
 export * from './capabilities';
 export * from './speech/hostedTtsProtocol';
 export * from './i18n';
+export * from './voice/speechLabels';
+export * from './voice/replyLanguage';
+export * from './voice/speechPlayback';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/assistant/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AAGxB,cAAc,wBAAwB,CAAC;AAKvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAK/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AAGxB,cAAc,wBAAwB,CAAC;AAKvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAK/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,QAAQ,CAAC;AAEvB,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/shared/assistant/voice/replyLanguage.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Which language is this reply actually in? (BOFF-7107)
+ *
+ * The assistant reads replies aloud by choosing a voice for `useI18n().locale` —
+ * the UI language. That is the wrong signal the moment the model answers in the
+ * language the USER wrote in rather than the one the chrome is set to, which is
+ * exactly what the language directive in `assistantPrompt` now asks it to do.
+ * A Tamil reply read by an English voice is confident nonsense, and it is the
+ * one failure the speech module is built to make impossible.
+ *
+ * So playback keys on the reply text instead. Deliberately by SCRIPT, not by a
+ * statistical language detector:
+ *
+ *  - it is deterministic, dependency-free and costs no bundle;
+ *  - for the languages HealthyBowl actually serves beyond English — Tamil,
+ *    Hindi, Arabic, Chinese — the script IS the language, unambiguously;
+ *  - a detector that can separate en/es/fr/de (`franc` and friends) is ~40KB and
+ *    still guesses on short strings.
+ *
+ * The honest limitation: **Latin-script languages cannot be told apart this
+ * way.** A Spanish reply in an English UI still gets an English voice. That is a
+ * far smaller failure than the cross-script one (an English voice reading
+ * Spanish is accented but intelligible; an English voice reading Tamil is
+ * noise), and closing it needs a real detector — a deliberate later choice, not
+ * an oversight.
+ */
+/**
+ * The locale whose voice should read `text`, or `null` when the script does not
+ * decide it (empty, no letters, or Latin — see the module note).
+ */
+export declare function detectScriptLocale(text: string): string | null;
+/**
+ * The locale to speak `text` in: the script when it decides, else the app locale.
+ *
+ * Falling back to the app locale (rather than refusing) keeps every Latin-script
+ * reply behaving exactly as it did before this existed.
+ */
+/**
+ * ⚠️ `appLocale` is the caller's best available signal for "which language did
+ * the user mean", and it is only as good as that signal.
+ *
+ * With the interface language alone it is a weak proxy: an English-UI user who
+ * writes in Urdu produces an Urdu reply, but `appLocale` says `en`, so a shared
+ * Arabic script falls back to the family default and picks an Arabic voice.
+ * BOFF-7108 is what fixes this properly — it lets the user state the language
+ * they are speaking, independently of the interface, and passes THAT here.
+ *
+ * Callers should therefore hand in the most specific language they know: the
+ * user's declared conversation language if there is one, the UI locale only as a
+ * last resort.
+ */
+export declare function resolveSpeechLocale(text: string, appLocale: string): string;
+//# sourceMappingURL=replyLanguage.d.ts.map

package/dist/shared/assistant/voice/replyLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replyLanguage.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/replyLanguage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA2EH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgD9D;AAED;;;;;GAKG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAU3E"}

package/dist/shared/assistant/voice/replyLanguage.js

@@ -0,0 +1,112 @@
+//#region src/shared/assistant/voice/replyLanguage.ts
+var e = [
+	{
+		locale: "ja",
+		pattern: /[\p{Script=Hiragana}\p{Script=Katakana}]/u
+	},
+	{
+		locale: "ko",
+		pattern: /\p{Script=Hangul}/u
+	},
+	{
+		locale: "zh",
+		pattern: /\p{Script=Han}/u
+	},
+	{
+		locale: "ta",
+		pattern: /\p{Script=Tamil}/u
+	},
+	{
+		locale: "hi",
+		pattern: /\p{Script=Devanagari}/u
+	},
+	{
+		locale: "bn",
+		pattern: /\p{Script=Bengali}/u
+	},
+	{
+		locale: "te",
+		pattern: /\p{Script=Telugu}/u
+	},
+	{
+		locale: "kn",
+		pattern: /\p{Script=Kannada}/u
+	},
+	{
+		locale: "ml",
+		pattern: /\p{Script=Malayalam}/u
+	},
+	{
+		locale: "gu",
+		pattern: /\p{Script=Gujarati}/u
+	},
+	{
+		locale: "pa",
+		pattern: /\p{Script=Gurmukhi}/u
+	},
+	{
+		locale: "ar",
+		pattern: /\p{Script=Arabic}/u
+	},
+	{
+		locale: "he",
+		pattern: /\p{Script=Hebrew}/u
+	},
+	{
+		locale: "ru",
+		pattern: /\p{Script=Cyrillic}/u
+	},
+	{
+		locale: "el",
+		pattern: /\p{Script=Greek}/u
+	}
+], t = {
+	zh: ["zh", "ja"],
+	ar: [
+		"ar",
+		"ur",
+		"fa",
+		"ps",
+		"sd"
+	],
+	hi: [
+		"hi",
+		"mr",
+		"ne",
+		"sa",
+		"kok"
+	],
+	ru: [
+		"ru",
+		"uk",
+		"bg",
+		"sr",
+		"mk",
+		"be"
+	]
+}, n = .3, r = .2, i = /\p{L}/u;
+function a(t) {
+	if (!t) return null;
+	let a = 0, o = /* @__PURE__ */ new Map();
+	for (let n of t) if (i.test(n)) {
+		a += 1;
+		for (let { locale: t, pattern: r } of e) if (r.test(n)) {
+			o.set(t, (o.get(t) ?? 0) + 1);
+			break;
+		}
+	}
+	if (a === 0) return null;
+	let s = o.get("ja") ?? 0, c = o.get("zh") ?? 0;
+	s > 0 && s >= (s + c) * r && (o.set("ja", s + c), o.delete("zh"));
+	let l = null, u = 0;
+	for (let [e, t] of o) t > u && (l = e, u = t);
+	return l !== null && u / a >= n ? l : null;
+}
+function o(e, n) {
+	let r = a(e);
+	if (r === null) return n;
+	let i = t[r];
+	return i && i.includes(n) ? n : r;
+}
+//#endregion
+export { a as detectScriptLocale, o as resolveSpeechLocale };

package/dist/shared/assistant/voice/speechLabels.d.ts

@@ -0,0 +1,12 @@
+import { SpeakableLabels } from './speakableText';
+/**
+ * Labels to read a reply in `locale` with.
+ *
+ * `uiLabels` is the interface-language set, used both as the base and as the
+ * fallback for any language not carried here — so English replies, and any
+ * language we have no table for, behave exactly as before.
+ */
+export declare function speechLabelsFor(locale: string, uiLabels: SpeakableLabels): SpeakableLabels;
+/** Exposed for tests: which languages have their own spoken labels. */
+export declare const SPOKEN_LABEL_LANGUAGES: string[];
+//# sourceMappingURL=speechLabels.d.ts.map

package/dist/shared/assistant/voice/speechLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechLabels.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/speechLabels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAyGvD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,GACxB,eAAe,CAKjB;AAED,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,UAAkC,CAAC"}

package/dist/shared/assistant/voice/speechLabels.js

@@ -0,0 +1,75 @@
+//#region src/shared/assistant/voice/speechLabels.ts
+var e = {
+	en: {
+		codeBlock: "Code block",
+		image: "image",
+		link: "link",
+		largeTable: "Table with {{rows}} rows and {{columns}} columns",
+		truncated: "The rest of this message is not read aloud",
+		nestedItem: "Sub-item {{ordinal}}",
+		emailAt: "at",
+		emailDot: "dot"
+	},
+	ta: {
+		codeBlock: "நிரல் தொகுதி",
+		image: "படம்",
+		link: "இணைப்பு",
+		largeTable: "{{rows}} வரிசைகள் மற்றும் {{columns}} நெடுவரிசைகள் கொண்ட அட்டவணை",
+		truncated: "இந்தச் செய்தியின் மீதமுள்ள பகுதி வாசிக்கப்படவில்லை",
+		nestedItem: "துணை உருப்படி {{ordinal}}",
+		emailAt: "அட்",
+		emailDot: "புள்ளி"
+	},
+	hi: {
+		codeBlock: "कोड ब्लॉक",
+		image: "छवि",
+		link: "लिंक",
+		largeTable: "{{rows}} पंक्तियों और {{columns}} स्तंभों वाली तालिका",
+		truncated: "इस संदेश का शेष भाग नहीं पढ़ा जाता",
+		nestedItem: "उप-आइटम {{ordinal}}",
+		emailAt: "ऐट",
+		emailDot: "डॉट"
+	},
+	ar: {
+		codeBlock: "كتلة برمجية",
+		image: "صورة",
+		link: "رابط",
+		largeTable: "جدول من {{rows}} صفوف و {{columns}} أعمدة",
+		truncated: "لا تتم قراءة بقية هذه الرسالة بصوت عالٍ",
+		nestedItem: "عنصر فرعي {{ordinal}}",
+		emailAt: "أت",
+		emailDot: "نقطة"
+	},
+	es: {
+		codeBlock: "Bloque de código",
+		image: "imagen",
+		link: "enlace",
+		largeTable: "Tabla con {{rows}} filas y {{columns}} columnas",
+		truncated: "El resto de este mensaje no se lee en voz alta",
+		nestedItem: "Subelemento {{ordinal}}",
+		emailAt: "arroba",
+		emailDot: "punto"
+	},
+	zh: {
+		codeBlock: "代码块",
+		image: "图片",
+		link: "链接",
+		largeTable: "包含 {{rows}} 行 {{columns}} 列的表格",
+		truncated: "此消息的其余部分不会朗读",
+		nestedItem: "子项 {{ordinal}}",
+		emailAt: "at",
+		emailDot: "点"
+	}
+};
+function t(t, n) {
+	let r = t.trim().toLowerCase().split(/[-_]/)[0];
+	if (!r) return n;
+	let i = e[r];
+	return i ? {
+		...n,
+		...i
+	} : n;
+}
+var n = Object.keys(e);
+//#endregion
+export { n as SPOKEN_LABEL_LANGUAGES, t as speechLabelsFor };

package/dist/shared/assistant/voice/speechPlayback.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Playback state for the assistant's spoken reply (BOFF-6290).
+ *
+ * A reducer rather than a pile of `useState` calls, because the awkward part of
+ * speech playback is not "is it speaking" — it is that the engine's `end` and
+ * `error` events arrive AFTER the state has already moved on:
+ *
+ *  - tapping speak on message B while A is talking cancels A, and A's `end`
+ *    event lands a tick later. Without a guard it would clear B's speaking state
+ *    and leave a button that says "stop" next to silence — or worse, silence
+ *    next to a button that says "speak" while the voice keeps going;
+ *  - closing the panel cancels playback, and the cancellation itself fires
+ *    `error` on every queued utterance.
+ *
+ * Every transition therefore carries a monotonically increasing `requestId`, and
+ * a terminal event is only honoured when it belongs to the CURRENT request. That
+ * is the whole trick, and it is pure, so it is tested directly (the audio around
+ * it is not testable in this repo's node-environment vitest).
+ */
+export type SpeechPlaybackState = {
+    readonly status: "idle";
+} | {
+    readonly status: "speaking";
+    readonly messageId: string;
+    readonly requestId: number;
+};
+export type SpeechPlaybackAction = 
+/** User pressed speak on a message (or auto-speak fired). */
+{
+    readonly type: "start";
+    readonly messageId: string;
+    readonly requestId: number;
+}
+/** User pressed the control on `messageId`: stop if it is the one talking. */
+ | {
+    readonly type: "toggle";
+    readonly messageId: string;
+    readonly requestId: number;
+}
+/** Explicit stop: the stop button, panel close, conversation switch, unmount. */
+ | {
+    readonly type: "stop";
+}
+/** The engine finished the queue for `requestId`. */
+ | {
+    readonly type: "finished";
+    readonly requestId: number;
+}
+/** The engine failed (or was cancelled) on `requestId`. */
+ | {
+    readonly type: "failed";
+    readonly requestId: number;
+};
+export declare const IDLE_PLAYBACK: SpeechPlaybackState;
+export declare function speechPlaybackReducer(state: SpeechPlaybackState, action: SpeechPlaybackAction): SpeechPlaybackState;
+/** Is THIS message the one currently being spoken? Drives one button's state. */
+export declare function isSpeakingMessage(state: SpeechPlaybackState, messageId: string): boolean;
+/**
+ * Does acting on `messageId` require cancelling what the engine is doing now?
+ *
+ * True whenever anything is playing — including the same message, where the tap
+ * means "stop". The caller cancels first, then speaks; that ordering is what
+ * makes "starting a new playback cancels the previous one" hold with a queue of
+ * utterances rather than a single one.
+ */
+export declare function requiresCancel(state: SpeechPlaybackState): boolean;
+//# sourceMappingURL=speechPlayback.d.ts.map

package/dist/shared/assistant/voice/speechPlayback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechPlayback.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/speechPlayback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3B;IACE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEN,MAAM,MAAM,oBAAoB;AAC9B,6DAA6D;AAC3D;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AACH,8EAA8E;GAC5E;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AACH,iFAAiF;GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC3B,qDAAqD;GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC3D,2DAA2D;GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,aAAa,EAAE,mBAAwC,CAAC;AAErE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,CAgCrB;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAElE"}

package/dist/shared/assistant/voice/speechPlayback.js

@@ -0,0 +1,28 @@
+//#region src/shared/assistant/voice/speechPlayback.ts
+var e = { status: "idle" };
+function t(t, n) {
+	switch (n.type) {
+		case "start": return {
+			status: "speaking",
+			messageId: n.messageId,
+			requestId: n.requestId
+		};
+		case "toggle": return t.status === "speaking" && t.messageId === n.messageId ? e : {
+			status: "speaking",
+			messageId: n.messageId,
+			requestId: n.requestId
+		};
+		case "stop": return t.status === "idle" ? t : e;
+		case "finished":
+		case "failed": return t.status !== "speaking" || t.requestId !== n.requestId ? t : e;
+		default: return t;
+	}
+}
+function n(e, t) {
+	return e.status === "speaking" && e.messageId === t;
+}
+function r(e) {
+	return e.status === "speaking";
+}
+//#endregion
+export { e as IDLE_PLAYBACK, n as isSpeakingMessage, r as requiresCancel, t as speechPlaybackReducer };

package/dist/shared/config/authBridgeUrls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authBridgeUrls.d.ts","sourceRoot":"","sources":["../../../src/shared/config/authBridgeUrls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;AAyCD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,uBAAuB,CAcjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,IAAI,uBAAuB,GAAG,SAAS,CAGlF"}
+{"version":3,"file":"authBridgeUrls.d.ts","sourceRoot":"","sources":["../../../src/shared/config/authBridgeUrls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;AAyCD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,uBAAuB,CAcjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,IAAI,uBAAuB,GAAG,SAAS,CAWlF"}

package/dist/shared/config/authBridgeUrls.js

@@ -1,35 +1,36 @@
-import { isDesktop as e } from "../native/desktop.js";
-import { ALL_PRODUCT_DOMAINS as t, ALPHA_HOSTS as n, PROD_HOSTS as r, getCurrentHostname as i } from "./gatewayUrls.js";
+import { isCapacitorNative as e } from "../native/capacitor.js";
+import { isDesktop as t } from "../native/desktop.js";
+import { ALL_PRODUCT_DOMAINS as n, ALPHA_HOSTS as r, PROD_HOSTS as i, getCurrentHostname as a } from "./gatewayUrls.js";
 //#region src/shared/config/authBridgeUrls.ts
-var a = {
+var o = {
 	url: "https://app.burdenoff.com/auth/session-bridge",
-	allowedOrigins: t.map((e) => `https://app.${e}`).join(","),
+	allowedOrigins: n.map((e) => `https://app.${e}`).join(","),
 	debug: !1
-}, o = {
+}, s = {
 	url: "https://alphaapp.burdenoff.com/auth/session-bridge",
-	allowedOrigins: t.map((e) => `https://alphaapp.${e}`).join(","),
+	allowedOrigins: n.map((e) => `https://alphaapp.${e}`).join(","),
 	debug: !1
-}, s = {
+}, c = {
 	url: "https://app.local.burdenoff.com/auth/session-bridge",
 	allowedOrigins: "*",
 	debug: !0
 };
-function c(e) {
+function l(e) {
 	return e ? e === "localhost" || e === "127.0.0.1" || e === "0.0.0.0" || e === "[::1]" || e === "::1" || e.endsWith(".localhost") : !1;
 }
-function l() {
+function u() {
 	return {
 		url: `${typeof window > "u" ? "" : window.location.origin}/auth/session-bridge`,
 		allowedOrigins: "*",
 		debug: !0
 	};
 }
-function u() {
-	let e = i();
-	return r.has(e) ? a : n.has(e) ? o : c(e) ? l() : s;
-}
 function d() {
-	if (!e()) return u();
+	let e = a();
+	return i.has(e) ? o : r.has(e) ? s : l(e) ? u() : c;
+}
+function f() {
+	if (!t() && !e()) return d();
 }
 //#endregion
-export { u as resolveAuthBridgeConfig, d as resolveShellAuthBridgeConfig };
+export { d as resolveAuthBridgeConfig, f as resolveShellAuthBridgeConfig };

package/dist/shared/config/gatewayUrls.d.ts

@@ -22,6 +22,35 @@ export declare const PROD_HOSTS: Set<string>;
  */
 export declare const ALPHA_HOSTS: Set<string>;
 export declare function getCurrentHostname(): string;
+/**
+ * Which backend estate a bundle is built to talk to.
+ *
+ * `'local'` means the developer stack behind the `gw-*.local.burdenoff.com`
+ * nginx proxy — reachable only from a machine with the dev `/etc/hosts`
+ * entries, never from a phone.
+ */
+export type DeployTarget = 'prod' | 'alpha' | 'local';
+/**
+ * Resolve the deploy target for a shell whose origin carries no information —
+ * a Capacitor WebView, which is always `https://localhost` (or `capacitor://`)
+ * regardless of which product or environment the binary was built for.
+ *
+ * Precedence:
+ *  1. `VITE_GATEWAY_TARGET` — the explicit override, already honoured for
+ *     localhost dev servers.
+ *  2. `VITE_DEPLOY_ENV` — the build-time environment marker the shells
+ *     already set for analytics.
+ *  3. `'prod'`.
+ *
+ * Defaulting to prod is the safe answer here, and it is the OPPOSITE of the
+ * fail-loud default for an unknown *web* hostname (BOFF-2507). A web app
+ * served from a domain we do not recognise might be anything, so pointing it
+ * at production would be reckless. A Capacitor binary is something we built
+ * and signed ourselves; the only reason it is on a device at all is to talk to
+ * a real backend, and `LOCAL_DEFAULTS` there is not a safe fallback but a
+ * guaranteed `TypeError: Failed to fetch` on the first request.
+ */
+export declare function resolveNativeDeployTarget(): DeployTarget;
 /**
  * Resolve runtime gateway URLs from the current hostname, with an optional
  * env-driven override for localhost dev servers.

package/dist/shared/config/gatewayUrls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gatewayUrls.d.ts","sourceRoot":"","sources":["../../../src/shared/config/gatewayUrls.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAoBD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UA+C/B,CAAC;AAEF,eAAO,MAAM,UAAU,aAGrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,aAOtB,CAAC;AAEH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAuCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,kBAAkB,CAqCvD"}
+{"version":3,"file":"gatewayUrls.d.ts","sourceRoot":"","sources":["../../../src/shared/config/gatewayUrls.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAoBD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UA+C/B,CAAC;AAEF,eAAO,MAAM,UAAU,aAGrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,aAOtB,CAAC;AAEH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAkCD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAWtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,IAAI,YAAY,CAUxD;AAOD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,kBAAkB,CAkDvD"}

package/dist/shared/config/gatewayUrls.js

@@ -1,22 +1,23 @@
-import { getDesktopGatewayUrls as e } from "../native/desktop.js";
+import { isCapacitorNative as e } from "../native/capacitor.js";
+import { getDesktopGatewayUrls as t } from "../native/desktop.js";
 //#region src/shared/config/gatewayUrls.ts
-var t = {
+var n = {
 	workspaceBaseUrl: "https://alphagraphqlworkspaces.burdenoff.com",
 	globalBaseUrl: "https://alphagraphql.burdenoff.com",
 	publicStoreBaseUrl: "https://alphagraphql.burdenoff.com"
-}, n = {
+}, r = {
 	workspaceBaseUrl: "https://graphqlworkspaces.burdenoff.com",
 	globalBaseUrl: "https://graphql.burdenoff.com",
 	publicStoreBaseUrl: "https://graphql.burdenoff.com"
-}, r = {
+}, i = {
 	workspaceBaseUrl: "https://gw-wspace.local.burdenoff.com",
 	globalBaseUrl: "https://gw-global.local.burdenoff.com",
 	publicStoreBaseUrl: "https://gw-global.local.burdenoff.com"
-}, i = /* @__PURE__ */ "burdenoff.com,vibecontrols.com,fluidgrids.com,fluidgrids.ai,botlit.ai,botmanor.com,bigconsole.com,gethealthybowl.com,headshotmarketing.com,timecampus.com,ggnomad.com,movethewheels.com,crewfoundry.com,planmagnet.com,eventfullymanaged.com,kadaikodi.com,assethandler.com,technospam.com,semanticfed.com,manufacturedops.com,theglobalfuel.com,housingvista.com,proserviceworld.com,mybodyshield.com,artistrybase.com,collabkin.com,brainyrich.com,theculturepost.com,comradecircle.com,cosmicintersection.com,govcitizenhub.com,intelwatchtower.com,ecoimpacthub.com,buildmyiq.com,fluidgrids.ai,atheletebridge.com,adaptercloud.com,coolandlovely.com,subscriberbot.com,labsofscience.com,hookmovies.com".split(","), a = new Set([...i.map((e) => `app.${e}`), "admin.burdenoff.com"]), o = new Set([...i.map((e) => `alphaapp.${e}`), "alphaadmin.burdenoff.com"]);
-function s() {
+}, a = /* @__PURE__ */ "burdenoff.com,vibecontrols.com,fluidgrids.com,fluidgrids.ai,botlit.ai,botmanor.com,bigconsole.com,gethealthybowl.com,headshotmarketing.com,timecampus.com,ggnomad.com,movethewheels.com,crewfoundry.com,planmagnet.com,eventfullymanaged.com,kadaikodi.com,assethandler.com,technospam.com,semanticfed.com,manufacturedops.com,theglobalfuel.com,housingvista.com,proserviceworld.com,mybodyshield.com,artistrybase.com,collabkin.com,brainyrich.com,theculturepost.com,comradecircle.com,cosmicintersection.com,govcitizenhub.com,intelwatchtower.com,ecoimpacthub.com,buildmyiq.com,fluidgrids.ai,atheletebridge.com,adaptercloud.com,coolandlovely.com,subscriberbot.com,labsofscience.com,hookmovies.com".split(","), o = new Set([...a.map((e) => `app.${e}`), "admin.burdenoff.com"]), s = new Set([...a.map((e) => `alphaapp.${e}`), "alphaadmin.burdenoff.com"]);
+function c() {
 	return typeof window > "u" ? "" : window.location.hostname.toLowerCase();
 }
-function c(e) {
+function l(e) {
 	let t = `https://${e}`;
 	return {
 		workspaceBaseUrl: t,
@@ -24,24 +25,47 @@ function c(e) {
 		publicStoreBaseUrl: t
 	};
 }
-function l(e) {
+function u(e) {
 	return e ? e === "localhost" || e === "127.0.0.1" || e === "0.0.0.0" || e === "[::1]" || e === "::1" || e.endsWith(".localhost") || e.endsWith(".local.burdenoff.com") : !1;
 }
-var u = !1;
 function d() {
-	let i = e();
-	if (i) return i;
-	let d = s();
-	if (a.has(d)) return n;
-	if (o.has(d)) return c(d);
-	if (l(d)) {
-		let e = f();
-		if (e === "prod") return u || (u = !0, console.warn("[gatewayUrls] WARNING: localhost dev server is configured to hit PRODUCTION backends (VITE_GATEWAY_TARGET=prod). Any mutation will modify real prod data. Remove the env var or delete .env.local to disable.")), n;
-		if (e === "alpha") return t;
+	try {
+		return {
+			BASE_URL: "/",
+			DEV: !1,
+			MODE: "production",
+			PROD: !0,
+			SSR: !1
+		}?.VITE_DEPLOY_ENV?.toLowerCase();
+	} catch {
+		return;
 	}
-	return r;
 }
 function f() {
+	let e = h();
+	if (e === "prod" || e === "alpha" || e === "local") return e;
+	let t = d();
+	return t === "alpha" || t === "staging" ? "alpha" : t === "dev" || t === "development" ? "local" : "prod";
+}
+var p = !1;
+function m() {
+	let a = t();
+	if (a) return a;
+	if (e()) {
+		let e = f();
+		return e === "local" ? i : e === "alpha" ? n : r;
+	}
+	let d = c();
+	if (o.has(d)) return r;
+	if (s.has(d)) return l(d);
+	if (u(d)) {
+		let e = h();
+		if (e === "prod") return p || (p = !0, console.warn("[gatewayUrls] WARNING: localhost dev server is configured to hit PRODUCTION backends (VITE_GATEWAY_TARGET=prod). Any mutation will modify real prod data. Remove the env var or delete .env.local to disable.")), r;
+		if (e === "alpha") return n;
+	}
+	return i;
+}
+function h() {
 	try {
 		return {
 			BASE_URL: "/",
@@ -55,4 +79,4 @@ function f() {
 	}
 }
 //#endregion
-export { i as ALL_PRODUCT_DOMAINS, o as ALPHA_HOSTS, a as PROD_HOSTS, s as getCurrentHostname, d as resolveGatewayUrls };
+export { a as ALL_PRODUCT_DOMAINS, s as ALPHA_HOSTS, o as PROD_HOSTS, c as getCurrentHostname, m as resolveGatewayUrls, f as resolveNativeDeployTarget };

package/dist/shared/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;;QAEjB,uCAAuC;;QAEvC,4BAA4B;;QAE5B,6FAA6F;;;;QAI7F,uCAAuC;;QAEvC,4BAA4B;;QAE5B,6FAA6F;;QAE7F,uDAAuD;;;CAGjD,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;AACjD,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,QAAQ,CAAC;AAE5C;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAMlF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO;IApC7C,uCAAuC;;IAEvC,4BAA4B;;IAE5B,6FAA6F;;;IAI7F,uCAAuC;;IAEvC,4BAA4B;;IAE5B,6FAA6F;;IAE7F,uDAAuD;;EAwB1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAKnF;AAGD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACzF,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAGhE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;;QAEjB,uCAAuC;;QAEvC,4BAA4B;;QAE5B,6FAA6F;;;;QAI7F,uCAAuC;;QAEvC,4BAA4B;;QAE5B,6FAA6F;;QAE7F,uDAAuD;;;CAGjD,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;AACjD,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,QAAQ,CAAC;AAE5C;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAMlF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO;IApC7C,uCAAuC;;IAEvC,4BAA4B;;IAE5B,6FAA6F;;;IAI7F,uCAAuC;;IAEvC,4BAA4B;;IAE5B,6FAA6F;;IAE7F,uDAAuD;;EAwB1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAanF;AAYD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACzF,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAGhE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/shared/native/capacitor.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Capacitor (mobile) runtime detection — MFE-safe, boot-order independent.
+ *
+ * WHY THIS EXISTS SEPARATELY FROM `platform.ts`
+ * --------------------------------------------
+ * `isNative()` in `./platform` reads `window.__burdenoffNativeBridge`, which is
+ * only published by `installNativeBridge()` during `bootNativeShell()`. Gateway
+ * URLs are resolved at module scope in every shell's `main.tsx` — BEFORE React
+ * renders and long before that boot step runs — so `isNative()` is still
+ * `false` at the moment it matters most. Anything that resolves a network
+ * target must therefore use the detector here instead.
+ *
+ * WHY IT DOES NOT IMPORT `@capacitor/core`
+ * ----------------------------------------
+ * `shared/*` is the MFE-safe half of fe-libs: a microfrontend must never
+ * resolve a Capacitor package (that is the whole reason `shell-native` is a
+ * separate, shell-only subpath). Capacitor's native runtime injects a
+ * `window.Capacitor` global into the WebView before any application script
+ * executes, which is exactly what `@capacitor/core` itself reads — so sniffing
+ * that global is both dependency-free and available at module-scope time.
+ *
+ * PRESENTATION PREVIEWS ARE DELIBERATELY NOT DETECTED HERE.
+ * `?__nativePreview=ios|android` (see `shell-native/preview`) changes how the
+ * app LOOKS in a normal browser. It must never change which backend the app
+ * talks to, so it does not set `window.Capacitor` and is invisible to this
+ * module.
+ *
+ * @module @burdenoff/fe-libs/shared/native/capacitor
+ */
+/** The two real Capacitor mobile platforms (`'web'` is not native). */
+export type CapacitorNativePlatform = 'ios' | 'android';
+/**
+ * The real Capacitor platform, or `null` when this is not a native mobile
+ * shell. Never returns a value for a presentation preview.
+ */
+export declare function getCapacitorPlatform(): CapacitorNativePlatform | null;
+/**
+ * True when running inside a real Capacitor mobile WebView (iOS or Android).
+ *
+ * Three independent signals are accepted because a wrong `false` here sends a
+ * shipped mobile app to a developer-only gateway hostname that resolves
+ * nowhere:
+ *  1. `Capacitor.isNativePlatform()` — the canonical check.
+ *  2. A platform name of `ios`/`android` — correct even if (1) is missing.
+ *  3. A `capacitor:` document protocol — the origin a shell gets when it
+ *     overrides `server.iosScheme`, and proof of a native WebView on its own.
+ */
+export declare function isCapacitorNative(): boolean;
+//# sourceMappingURL=capacitor.d.ts.map

package/dist/shared/native/capacitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitor.d.ts","sourceRoot":"","sources":["../../../src/shared/native/capacitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,uEAAuE;AACvE,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,SAAS,CAAC;AAiCxD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,uBAAuB,GAAG,IAAI,CAWrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAgB3C"}