dsh-mobile 0.8.5 → 0.8.6

package/lib/client.js

@@ -3791,6 +3791,28 @@ window.__ModuleLoader__.load({
 			if (bridge === void 0 || typeof bridge.capabilities !== "function" || typeof bridge.invoke !== "function") return void 0;
 			return bridge;
 		}
+		/** Encode one opaque Session id for the App's internal notification route. */
+		function taskNotificationNavigate(sessionId) {
+			if (sessionId === "") return void 0;
+			const bytes = new TextEncoder().encode(sessionId);
+			let binary = "";
+			for (const byte of bytes) binary += String.fromCharCode(byte);
+			const route = `/?dsh-session=${globalThis.btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "")}`;
+			return route.length <= 270 ? route : void 0;
+		}
+		/** Decode only the App's bounded internal Session route. */
+		function decodeTaskNotificationNavigate(value) {
+			if (value === null || value === void 0 || !/^[A-Za-z0-9_-]{1,256}$/u.test(value)) return void 0;
+			try {
+				const padded = value.replaceAll("-", "+").replaceAll("_", "/") + "=".repeat((4 - value.length % 4) % 4);
+				const binary = globalThis.atob(padded);
+				const bytes = Uint8Array.from(binary, (character) => character.charCodeAt(0));
+				const decoded = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+				return decoded === "" ? void 0 : decoded;
+			} catch {
+				return;
+			}
+		}
 		/** Parse a `task-notify` SSE payload; rejects anything malformed or empty. */
 		function parseTaskNotifyPayload(value) {
 			let record;
@@ -3845,7 +3867,8 @@ window.__ModuleLoader__.load({
 				return bridge.invoke("notification.notify", {
 					title: event.title,
 					body: event.body,
-					tag: event.tag
+					tag: event.tag,
+					...event.navigate === void 0 ? {} : { navigate: event.navigate }
 				});
 			}).then(() => void 0, (error) => {
 				const code = typeof error === "object" && error !== null && "code" in error ? String(error.code) : "";
@@ -9582,10 +9605,7 @@ window.__ModuleLoader__.load({
 						});
 						if (currentHostSubscription) consentedSubscriptions.delete(currentHostSubscription);
 						currentHostSubscription = void 0;
-						const sub = ownedSubscription;
-						if (sub) {
-							if (await sub.unsubscribe().catch(() => false) && ownedSubscription === sub) ownedSubscription = void 0;
-						}
+						ownedSubscription = void 0;
 						if (await refresh(token) && current(token) && operation === attempt && config?.status === "disabled") publish({
 							state: "disabled",
 							preferences: config.preferences
@@ -9746,7 +9766,13 @@ window.__ModuleLoader__.load({
 		const MOBILE_PUSH_SETTINGS_COPY = {
 			en: {
 				title: "Web push notifications",
-				desc: "Receive notifications when this page is closed.",
+				desc: "Receive notifications when this page is closed. Disable stops sends but keeps the browser subscription so it can be reused safely.",
+				permission: {
+					granted: "System permission: granted. A reinstalled Home Screen app can inherit this site-level grant.",
+					default: "System permission: not decided.",
+					denied: "System permission: blocked.",
+					unknown: "System permission: unavailable."
+				},
 				enable: "Enable",
 				disable: "Disable",
 				test: "Send test",
@@ -9771,7 +9797,13 @@ window.__ModuleLoader__.load({
 			},
 			zh: {
 				title: "网页推送通知",
-				desc: "关闭此页面后仍可接收通知。",
+				desc: "关闭此页面后仍可接收通知。停用会停止发送，但保留浏览器订阅，便于安全地重新启用。",
+				permission: {
+					granted: "系统权限：已允许。重新安装的主屏幕 App 可能继承站点级授权。",
+					default: "系统权限：尚未选择。",
+					denied: "系统权限：已阻止。",
+					unknown: "系统权限：不可读取。"
+				},
 				enable: "启用",
 				disable: "停用",
 				test: "发送测试",
@@ -9796,7 +9828,13 @@ window.__ModuleLoader__.load({
 			},
 			it: {
 				title: "Notifiche Web push",
-				desc: "Ricevi notifiche quando la pagina è chiusa.",
+				desc: "Ricevi notifiche quando la pagina è chiusa. La disattivazione interrompe gli invii ma conserva l’iscrizione del browser per poterla riutilizzare.",
+				permission: {
+					granted: "Permesso di sistema: concesso. Una Web App reinstallata può ereditare questa autorizzazione del sito.",
+					default: "Permesso di sistema: non ancora scelto.",
+					denied: "Permesso di sistema: bloccato.",
+					unknown: "Permesso di sistema: non disponibile."
+				},
 				enable: "Attiva",
 				disable: "Disattiva",
 				test: "Invia test",
@@ -9845,6 +9883,7 @@ window.__ModuleLoader__.load({
 			if (snapshot.state === "unsupported") return null;
 			const prefs = snapshot.preferences;
 			const Switch = switchComponent ?? requirePublicMobilePushSwitch();
+			const permission = typeof Notification === "undefined" ? "unknown" : Notification.permission;
 			const toggle = (key, checked) => {
 				if (!prefs) return;
 				controller.updatePreferences({
@@ -9866,7 +9905,7 @@ window.__ModuleLoader__.load({
 			}, (0, react.createElement)("div", { className: "dsh-mobile-settings_title" }, copy.title), (0, react.createElement)("div", {
 				className: "dsh-mobile-settings_desc",
 				"aria-live": "polite"
-			}, message(snapshot, copy)), prefs && Switch !== void 0 ? (0, react.createElement)("div", { className: "dsh-mobile-push-categories" }, ...KEYS.map((key, index) => {
+			}, message(snapshot, copy)), (0, react.createElement)("div", { className: "dsh-mobile-settings_desc" }, copy.permission[permission]), prefs && Switch !== void 0 ? (0, react.createElement)("div", { className: "dsh-mobile-push-categories" }, ...KEYS.map((key, index) => {
 				const name = copy.categories[index];
 				if (name === void 0) return null;
 				return (0, react.createElement)("label", {
@@ -9907,7 +9946,6 @@ window.__ModuleLoader__.load({
 			}, copy.busy)));
 		}
 		// src/mobile-push/navigation.ts
-		const REF_PARAMETER = "mobile-push";
 		/**
 		* Consume one authenticated tap reference after the public Workspace and Session
 		* list baselines are ready. Return the disposal function for list subscriptions.
@@ -9918,15 +9956,16 @@ window.__ModuleLoader__.load({
 				location: window.location,
 				history: window.history
 			};
+			const refParameter = options.parameter ?? "mobile-push";
 			const params = new URLSearchParams(browser.location.search);
-			const reference = params.get(REF_PARAMETER);
+			const reference = params.get(refParameter);
 			let disposed = false;
 			let consumed = false;
 			let resolving = false;
 			let opened = false;
 			const clearReference = () => {
-				if (!params.has(REF_PARAMETER)) return;
-				params.delete(REF_PARAMETER);
+				if (!params.has(refParameter)) return;
+				params.delete(refParameter);
 				const query = params.toString();
 				const url = `${browser.location.pathname}${query ? `?${query}` : ""}${browser.location.hash}`;
 				browser.history.replaceState(null, "", url);
@@ -11412,6 +11451,111 @@ dialog.dshm-picker[open]{display:grid;place-items:center}dialog.dshm-picker::bac
 				onClick: invoke
 			}, state === "busy" ? copy.busy : state === "success" ? copy.reopen : state === "error" ? copy.retry : copy.action));
 		}
+		function mobileBackgroundNotificationCopy(locale) {
+			if (locale === "zh") return {
+				title: "后台任务提醒",
+				description: "App 页面被系统挂起后，通过可关闭的常驻连接继续接收任务完成提醒。",
+				enabled: "关闭后台提醒",
+				disabled: "开启后台提醒",
+				busy: "正在处理…",
+				error: "无法更新后台提醒；请确认任务通知权限和当前连接。"
+			};
+			if (locale === "it") return {
+				title: "Promemoria in background",
+				description: "Continua a ricevere gli avvisi quando Android sospende la pagina, tramite una connessione persistente disattivabile.",
+				enabled: "Disattiva promemoria",
+				disabled: "Attiva promemoria",
+				busy: "Operazione…",
+				error: "Impossibile aggiornare i promemoria; controlla il permesso notifiche e la connessione attiva."
+			};
+			return {
+				title: "Background task reminders",
+				description: "Keep receiving completion alerts after Android suspends the page, through a dismissible persistent connection.",
+				enabled: "Disable background reminders",
+				disabled: "Enable background reminders",
+				busy: "Working…",
+				error: "Could not update background reminders. Check notification permission and the active connection."
+			};
+		}
+		/** Android-only opt-in for the foreground SSE fallback when the WebView is suspended. */
+		function MobileBackgroundNotificationRow() {
+			const [supported, setSupported] = (0, react.useState)(false);
+			const [enabled, setEnabled] = (0, react.useState)(false);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(false);
+			const generation = (0, react.useRef)(0);
+			(0, react.useEffect)(() => {
+				let active = true;
+				const refresh = () => {
+					const attempt = ++generation.current;
+					const bridge = window.__DSH_MOBILE_NATIVE__;
+					if (bridge === void 0) {
+						if (active) {
+							setSupported(false);
+							setError(false);
+						}
+						return;
+					}
+					Promise.resolve(bridge.capabilities()).then(async (capabilities) => {
+						const available = capabilities.includes("notification.background.get") && capabilities.includes("notification.background.set");
+						if (!active || attempt !== generation.current) return;
+						setSupported(available);
+						if (!available) return;
+						const result = await bridge.invoke("notification.background.get", {});
+						if (!active || attempt !== generation.current) return;
+						if (typeof result?.enabled !== "boolean") throw new Error("invalid background notification status");
+						setEnabled(result.enabled);
+						setError(false);
+					}).catch(() => {
+						if (active && attempt === generation.current) {
+							setSupported(true);
+							setError(true);
+						}
+					});
+				};
+				refresh();
+				window.addEventListener("dsh-mobile-native-ready", refresh);
+				return () => {
+					active = false;
+					generation.current += 1;
+					window.removeEventListener("dsh-mobile-native-ready", refresh);
+				};
+			}, []);
+			if (!supported) return null;
+			const locale = selectedMobileControlLocale();
+			const copy = mobileBackgroundNotificationCopy(locale);
+			const toggle = () => {
+				const bridge = window.__DSH_MOBILE_NATIVE__;
+				if (bridge === void 0 || busy) return;
+				const attempt = ++generation.current;
+				setBusy(true);
+				setError(false);
+				bridge.invoke("notification.background.set", { enabled: !enabled }).then((result) => {
+					if (attempt !== generation.current) return;
+					const next = result?.enabled;
+					if (typeof next !== "boolean") throw new Error("invalid background notification status");
+					setEnabled(next);
+				}).catch(() => {
+					if (attempt === generation.current) setError(true);
+				}).finally(() => {
+					if (attempt === generation.current) setBusy(false);
+				});
+			};
+			return (0, react.createElement)("div", {
+				className: "dsh-mobile-settings_row",
+				lang: locale
+			}, (0, react.createElement)("div", { className: "dsh-mobile-settings_rowText" }, (0, react.createElement)("div", { className: "dsh-mobile-settings_title" }, copy.title), (0, react.createElement)("div", {
+				className: "dsh-mobile-settings_desc",
+				"aria-live": "polite"
+			}, error ? copy.error : copy.description)), (0, react.createElement)("button", {
+				type: "button",
+				className: "dsh-mobile-settings_selector",
+				disabled: busy,
+				"aria-busy": busy ? "true" : void 0,
+				"aria-pressed": enabled ? "true" : "false",
+				onClick: toggle
+			}, busy ? copy.busy : enabled ? copy.enabled : copy.disabled));
+		}
 		const CONTROL_REQUEST_TIMEOUT_MS = 15e3;
 		const LONG_CONTROL_REQUEST_TIMEOUT_MS = 21e4;
 		const GITHUB_RELEASES_URL = "https://github.com/saya-ch/dsh-mobile/releases";
@@ -17252,7 +17396,8 @@ dialog.dshm-picker[open]{display:grid;place-items:center}dialog.dshm-picker::bac
 					kind: "done",
 					title: label("Attività completata", "Task finished", "任务已完成"),
 					body: label("Il tuo task DSH è terminato", "Your DSH task finished", "你的 DSH 任务已完成"),
-					tag: taskCompletionTag(parsed.sessionId, parsed.turn)
+					tag: taskCompletionTag(parsed.sessionId, parsed.turn),
+					navigate: taskNotificationNavigate(parsed.sessionId)
 				});
 			}, () => {
 				fireDeviceRevoked();
@@ -17471,6 +17616,46 @@ dialog.dshm-picker[open]{display:grid;place-items:center}dialog.dshm-picker::bac
 			page.body.append(node);
 			view.setTimeout(() => node.remove(), 3e3);
 		}
+		/** Consume the Android background service's opaque Session route on cold or warm launch. */
+		function installTaskNotificationNavigation(ctx, page, view) {
+			if (view.__DSH_MOBILE_FRONTEND__ !== "dedicated" || ctx.inject === void 0) return () => void 0;
+			if (new URLSearchParams(view.location.search).get("dsh-session") === null) return () => void 0;
+			let closed = false;
+			let removeNavigation;
+			const fiber = ctx.inject(mobilePushNavigationServices, (navigationContext) => {
+				if (closed) return () => void 0;
+				if (new URLSearchParams(view.location.search).get("dsh-session") === null) return () => void 0;
+				const remove = installPushNavigation(navigationContext, {
+					parameter: "dsh-session",
+					resolve: async (value) => {
+						const sessionId = decodeTaskNotificationNavigate(value);
+						return sessionId === void 0 ? void 0 : {
+							sessionId,
+							interaction: "current"
+						};
+					},
+					notify: (key) => {
+						if (key === "session-unavailable" || key === "session-resolved") showMobilePushNavigationNotice(page, view, key);
+					},
+					browser: {
+						location: view.location,
+						history: view.history
+					}
+				});
+				removeNavigation = remove;
+				return () => {
+					if (removeNavigation === remove) removeNavigation = void 0;
+					remove();
+				};
+			});
+			return () => {
+				if (closed) return;
+				closed = true;
+				removeNavigation?.();
+				removeNavigation = void 0;
+				fiber.dispose();
+			};
+		}
 		/** Own the browser-only push controller, settings row, and optional authenticated tap navigation. */
 		function installMobilePushBrowserClient(ctx, runtime) {
 			const { page, view } = runtime;
@@ -17582,6 +17767,7 @@ dialog.dshm-picker[open]{display:grid;place-items:center}dialog.dshm-picker::bac
 				page: document,
 				view: window
 			}), "dsh-mobile: authenticated browser push lifecycle");
+			ctx.effect(() => installTaskNotificationNavigation(ctx, document, window), "dsh-mobile: native task notification navigation");
 			ctx.effect(() => {
 				const desktopAdmin = isDesktopAdminSurface(location.hostname, location.search, window.__DSH_MOBILE_FRONTEND__, location.protocol);
 				const gatewayCustomization = ownsMobileCustomization(document.querySelector("meta[name=\"dsh-mobile-gateway\"][content=\"authenticated\"]") !== null, window.__DSH_MOBILE_FRONTEND__);
@@ -17639,7 +17825,13 @@ dialog.dshm-picker[open]{display:grid;place-items:center}dialog.dshm-picker::bac
 							id: "dsh-mobile-task-notifications",
 							order: 110
 						}, MobileTaskNotificationRow);
+						const removeBackgroundNotifications = ctx.slots.register({
+							name: "settings.general.item",
+							id: "dsh-mobile-background-notifications",
+							order: 111
+						}, MobileBackgroundNotificationRow);
 						return () => {
+							removeBackgroundNotifications();
 							removeTaskNotifications();
 							removeSwitchComputer();
 							removeDisplayScale();
@@ -17752,6 +17944,7 @@ dialog.dshm-picker[open]{display:grid;place-items:center}dialog.dshm-picker::bac
 		exports.installDshLanguageBoundSurface = installDshLanguageBoundSurface;
 		exports.installMobileNativeBack = installMobileNativeBack;
 		exports.installMobilePushBrowserClient = installMobilePushBrowserClient;
+		exports.installTaskNotificationNavigation = installTaskNotificationNavigation;
 		exports.localizedDiagnosticEntryCopy = localizedDiagnosticEntryCopy;
 		exports.mobileBackBlockedMessage = mobileBackBlockedMessage;
 		exports.mobilePushNavigationNotice = mobilePushNavigationNotice;