@khorsheed/dsh-ankh-guard 0.1.0 → 0.2.0

package/lib/client.js

@@ -0,0 +1,257 @@
+window.__ModuleLoader__.load({
+	id: "@khorsheed/dsh-ankh-guard",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region src/client/index.ts
+		const ROUTE = "/_ankh-guard/browser-handoff";
+		const CAPABILITY_KEY = "ankh-guard.browser-handoff-capability.v1";
+		const PENDING_KEY = "ankh-guard.browser-handoff-pending.v1";
+		const BOOT_ID_KEY = "ankh-guard.browser-handoff-boot-id.v1";
+		const FALLBACK_HASH_KEY = "ankh-guard-handoff";
+		const ACTIVE_RETRY_MS = 250;
+		const ERROR_RETRY_MIN_MS = 1e3;
+		const ERROR_RETRY_MAX_MS = 3e4;
+		/** Sustained-failure threshold for the disconnected overlay; transient blips never show it. */
+		const DISCONNECTED_OVERLAY_MS = 5e3;
+		/** No Cordis services are needed; this is a same-origin browser lifecycle observer. */
+		const inject = [];
+		function encodeBase64Url(bytes) {
+			let binary = "";
+			for (const byte of bytes) binary += String.fromCharCode(byte);
+			return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "");
+		}
+		function freshCapability() {
+			const bytes = /* @__PURE__ */ new Uint8Array(32);
+			crypto.getRandomValues(bytes);
+			return encodeBase64Url(bytes);
+		}
+		function capability() {
+			const existing = sessionStorage.getItem(CAPABILITY_KEY);
+			if (existing !== null && /^[A-Za-z0-9_-]{43}$/.test(existing)) return existing;
+			const created = freshCapability();
+			sessionStorage.setItem(CAPABILITY_KEY, created);
+			return created;
+		}
+		function readPending() {
+			try {
+				const value = JSON.parse(sessionStorage.getItem(PENDING_KEY) ?? "null");
+				if (value?.version !== 1 || typeof value.cutoverId !== "string" || value.channel !== "original-tab" && value.channel !== "fallback-tab" || value.authentication !== "existing-cookie" && value.authentication !== "launch-url") return null;
+				if (value.channel === "original-tab" && typeof value.capability !== "string") return null;
+				if (value.returnPath !== void 0 && !isSafeReturnPath(value.returnPath)) return null;
+				return value;
+			} catch {
+				return null;
+			}
+		}
+		/** Deliberately discard query and fragment because either may hold credentials. */
+		function safeReturnPath(href, origin) {
+			try {
+				const url = new URL(href);
+				if (url.origin !== origin || url.pathname === "" || url.pathname.startsWith("//") || url.pathname.includes("\\")) return void 0;
+				return url.pathname;
+			} catch {
+				return;
+			}
+		}
+		function isSafeReturnPath(value) {
+			return typeof value === "string" && value.startsWith("/") && !value.startsWith("//") && !value.includes("\\") && !value.includes("?") && !value.includes("#");
+		}
+		function writePending(value) {
+			sessionStorage.setItem(PENDING_KEY, JSON.stringify(value));
+		}
+		function fallbackCutoverId(hash) {
+			const id = new URLSearchParams(hash.startsWith("#") ? hash.slice(1) : hash).get(FALLBACK_HASH_KEY);
+			return id !== null && /^[A-Za-z0-9._-]{1,160}$/.test(id) ? id : null;
+		}
+		function consumeFallbackFragment() {
+			const cutoverId = fallbackCutoverId(location.hash);
+			if (cutoverId === null) return null;
+			const url = new URL(location.href);
+			url.hash = "";
+			history.replaceState(history.state, "", url.href);
+			const pending = {
+				version: 1,
+				cutoverId,
+				channel: "fallback-tab",
+				authentication: "launch-url"
+			};
+			writePending(pending);
+			return pending;
+		}
+		function waitingOverlay(kind = "restarting") {
+			const existing = document.getElementById("ankh-guard-browser-handoff");
+			if (existing !== null) return existing;
+			const zh = navigator.language.toLowerCase().startsWith("zh");
+			const element = document.createElement("div");
+			element.id = "ankh-guard-browser-handoff";
+			element.setAttribute("role", "status");
+			element.setAttribute("aria-live", "polite");
+			element.textContent = kind === "disconnected" ? zh ? "连接已断开,等待服务恢复。" : "Connection lost; waiting for the service to recover." : zh ? "dsh 正在重启；此标签页会自动恢复。" : "dsh is restarting; this tab will recover automatically.";
+			element.style.cssText = [
+				"position:fixed",
+				"inset:0",
+				"z-index:2147483647",
+				"display:grid",
+				"place-items:center",
+				"padding:24px",
+				"background:rgba(15,18,24,.92)",
+				"color:#fff",
+				"font:500 16px/1.5 system-ui,sans-serif",
+				"text-align:center"
+			].join(";");
+			document.documentElement.append(element);
+			return element;
+		}
+		async function post(body) {
+			return fetch(ROUTE, {
+				method: "POST",
+				credentials: "same-origin",
+				cache: "no-store",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify(body)
+			});
+		}
+		async function acknowledge(pending) {
+			return (await post({
+				version: 1,
+				operation: "ack",
+				cutoverId: pending.cutoverId,
+				channel: pending.channel,
+				authentication: pending.authentication,
+				...pending.capability !== void 0 ? { capability: pending.capability } : {}
+			})).status === 204;
+		}
+		/** Install the polling/reload loop for this tab's lifetime. */
+		function apply(_ctx) {
+			let disposed = false;
+			let timer;
+			let pending = consumeFallbackFragment() ?? readPending();
+			let cap;
+			let errorRetryMs = ERROR_RETRY_MIN_MS;
+			let firstFailureAt;
+			const noteDisconnected = () => {
+				firstFailureAt ??= Date.now();
+				if (Date.now() - firstFailureAt >= DISCONNECTED_OVERLAY_MS) waitingOverlay("disconnected");
+			};
+			const schedule = (delayMs = 0) => {
+				if (!disposed) timer = setTimeout(() => {
+					tick();
+				}, delayMs);
+			};
+			const tick = async () => {
+				if (disposed) return;
+				try {
+					if (pending !== null) {
+						waitingOverlay();
+						if (await acknowledge(pending)) {
+							const returnPath = pending.returnPath;
+							const originalTab = pending.channel === "original-tab";
+							sessionStorage.removeItem(PENDING_KEY);
+							sessionStorage.removeItem(CAPABILITY_KEY);
+							document.getElementById("ankh-guard-browser-handoff")?.remove();
+							pending = null;
+							if (originalTab && returnPath !== void 0 && safeReturnPath(location.href, location.origin) !== returnPath) {
+								location.replace(returnPath);
+								return;
+							}
+						}
+						errorRetryMs = ERROR_RETRY_MIN_MS;
+						firstFailureAt = void 0;
+						schedule(ACTIVE_RETRY_MS);
+						return;
+					}
+					const tabCapability = cap ??= capability();
+					const knownBootId = sessionStorage.getItem(BOOT_ID_KEY);
+					const response = await post({
+						version: 1,
+						operation: "poll",
+						capability: tabCapability,
+						...knownBootId === null ? {} : { knownBootId }
+					});
+					if (!response.ok) {
+						noteDisconnected();
+						schedule(errorRetryMs);
+						errorRetryMs = Math.min(errorRetryMs * 2, ERROR_RETRY_MAX_MS);
+						return;
+					}
+					errorRetryMs = ERROR_RETRY_MIN_MS;
+					firstFailureAt = void 0;
+					const result = await response.json();
+					if (typeof result.bootId === "string") sessionStorage.setItem(BOOT_ID_KEY, result.bootId);
+					if (result.state === "idle") {
+						document.getElementById("ankh-guard-browser-handoff")?.remove();
+						schedule();
+						return;
+					}
+					if (result.state === "waiting") waitingOverlay();
+					if (result.state === "ready" && result.action === "reload" && typeof result.cutoverId !== "string") {
+						location.reload();
+						return;
+					}
+					if (result.state !== "ready" || typeof result.cutoverId !== "string") {
+						schedule(ACTIVE_RETRY_MS);
+						return;
+					}
+					if (result.action === "reload" && result.authentication === "existing-cookie") {
+						const returnPath = safeReturnPath(location.href, location.origin);
+						const nextPending = {
+							version: 1,
+							cutoverId: result.cutoverId,
+							channel: "original-tab",
+							authentication: "existing-cookie",
+							capability: tabCapability,
+							...returnPath === void 0 ? {} : { returnPath }
+						};
+						pending = nextPending;
+						writePending(nextPending);
+						waitingOverlay();
+						location.reload();
+						return;
+					}
+					if (result.action === "replace" && result.authentication === "launch-url" && typeof result.launchUrl === "string") {
+						const launch = new URL(result.launchUrl);
+						if (launch.origin !== location.origin || launch.pathname !== "/" || launch.search === "" || launch.username !== "" || launch.password !== "" || launch.hash !== "") {
+							schedule(ACTIVE_RETRY_MS);
+							return;
+						}
+						const returnPath = safeReturnPath(location.href, location.origin);
+						const nextPending = {
+							version: 1,
+							cutoverId: result.cutoverId,
+							channel: "original-tab",
+							authentication: "launch-url",
+							capability: tabCapability,
+							...returnPath === void 0 ? {} : { returnPath }
+						};
+						pending = nextPending;
+						writePending(nextPending);
+						waitingOverlay();
+						location.replace(launch.href);
+						return;
+					}
+				} catch {
+					noteDisconnected();
+					schedule(errorRetryMs);
+					errorRetryMs = Math.min(errorRetryMs * 2, ERROR_RETRY_MAX_MS);
+					return;
+				}
+				schedule(ACTIVE_RETRY_MS);
+			};
+			tick();
+			return () => {
+				disposed = true;
+				if (timer !== void 0) clearTimeout(timer);
+			};
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.fallbackCutoverId = fallbackCutoverId;
+		exports.inject = inject;
+		exports.safeReturnPath = safeReturnPath;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/exit-agent.js

@@ -1,5 +1,5 @@
 import { n as isDirectInvocation } from "./defaults-CduvOcGq.js";
-import { n as findPidOnPort } from "./processes-hCAmwma-.js";
+import { m as findPidOnPort, u as registerCurrentTestProcess } from "./test-seam-dwvaKjRp.js";
 import { writeFileSync } from "node:fs";
 //#region lib/types/exit-agent.js
 /**
@@ -52,6 +52,9 @@ function exitAgentMain(env = process.env) {
 		performExit(port, resultFile, env.WD_INITIATOR);
 	}, delayMs);
 }
-if (isDirectInvocation(import.meta.url)) exitAgentMain();
+if (isDirectInvocation(import.meta.url)) {
+	registerCurrentTestProcess();
+	exitAgentMain();
+}
 //#endregion
 export { exitAgentMain, performExit };