@ait-co/polyfill 0.1.3 → 0.1.5

package/dist/auto.js

@@ -116,6 +116,74 @@ function restoreNavigatorProperty(prop, snapshot) {
 		delete target[prop];
 	} catch {}
 }
+/**
+* Mutate methods on an existing object rather than replacing the object
+* itself. This is the path we take for `navigator.geolocation`, `navigator.share`,
+* and `navigator.vibrate` in Chromium, where the slot on `navigator` is a
+* non-configurable own property that we cannot replace — but the methods
+* themselves (or the methods on the referenced object) are still
+* `configurable: true, writable: true`.
+*
+* Each replacement is installed via plain assignment. If any slot is not
+* writable (e.g. frozen object), install is aborted and previously-applied
+* replacements are rolled back, so the caller observes an atomic "all or
+* nothing" failure as `null`. The caller is expected to degrade gracefully
+* (e.g. log a one-time `console.warn`) when that happens.
+*/
+function installObjectMethods(target, replacements) {
+	const methods = {};
+	const applied = [];
+	const bag = target;
+	for (const key of Object.keys(replacements)) {
+		const hadOwn = Object.hasOwn(target, key);
+		const original = bag[key];
+		try {
+			bag[key] = replacements[key];
+		} catch {
+			for (const applieKey of applied) {
+				const prev = methods[applieKey];
+				if (!prev) continue;
+				if (prev.hadOwn) bag[applieKey] = prev.original;
+				else delete bag[applieKey];
+			}
+			return null;
+		}
+		if (bag[key] !== replacements[key]) {
+			for (const applieKey of applied) {
+				const prev = methods[applieKey];
+				if (!prev) continue;
+				if (prev.hadOwn) bag[applieKey] = prev.original;
+				else delete bag[applieKey];
+			}
+			return null;
+		}
+		methods[key] = {
+			hadOwn,
+			original
+		};
+		applied.push(key);
+	}
+	return {
+		target,
+		methods
+	};
+}
+/**
+* Reverse an `installObjectMethods` snapshot. Reassigns originals for slots
+* that were own properties before install; deletes the override for slots
+* that were inherited (so the prototype method surfaces again).
+*/
+function restoreObjectMethods(snapshot) {
+	const bag = snapshot.target;
+	for (const key of Object.keys(snapshot.methods)) {
+		const entry = snapshot.methods[key];
+		if (!entry) continue;
+		try {
+			if (entry.hadOwn) bag[key] = entry.original;
+			else delete bag[key];
+		} catch {}
+	}
+}
 //#endregion
 //#region src/shims/clipboard.ts
 /**
@@ -211,6 +279,13 @@ function uninstallClipboardShim() {
 * Outside Apps in Toss → defers to the browser's native `navigator.geolocation`.
 * If neither is available, the error callback receives a `GeolocationPositionError`.
 *
+* Install strategy: **method-level**. We do **not** replace `navigator.geolocation`
+* itself — Chromium marks that slot as a non-configurable own property, which
+* both `defineProperty(navigator, 'geolocation', …)` and the prototype-level
+* fallback cannot override (the instance shadow blocks prototype reads). We
+* instead mutate the methods on the existing `Geolocation` object, whose own
+* method descriptors are configurable+writable in every browser we've seen.
+*
 * SDK/Web shape mismatch handled here:
 *   - SDK `Accuracy` is a numeric enum (1 = Lowest … 6 = BestForNavigation); the
 *     standard `PositionOptions.enableHighAccuracy` is a boolean. We map
@@ -302,7 +377,7 @@ function createGeolocationShim(fallback) {
 						return;
 					}
 				}
-				if (!fallback) {
+				if (!fallback.getCurrentPosition) {
 					error?.(toPositionError(2, "[@ait-co/polyfill] navigator.geolocation is not available in this environment."));
 					return;
 				}
@@ -340,7 +415,7 @@ function createGeolocationShim(fallback) {
 						return;
 					}
 				}
-				if (!fallback) {
+				if (!fallback.watchPosition) {
 					pendingWatches.delete(id);
 					error?.(toPositionError(2, "[@ait-co/polyfill] navigator.geolocation is not available in this environment."));
 					return;
@@ -351,7 +426,7 @@ function createGeolocationShim(fallback) {
 				}
 				const nativeId = fallback.watchPosition(success, error, options);
 				if (pending.cancelled) {
-					fallback.clearWatch(nativeId);
+					fallback.clearWatch?.(nativeId);
 					pendingWatches.delete(id);
 					return;
 				}
@@ -374,7 +449,7 @@ function createGeolocationShim(fallback) {
 				return;
 			}
 			const nativeId = nativeWatches.get(id);
-			if (nativeId !== void 0 && fallback) {
+			if (nativeId !== void 0 && fallback.clearWatch) {
 				fallback.clearWatch(nativeId);
 				nativeWatches.delete(id);
 			}
@@ -385,13 +460,27 @@ function installGeolocationShim() {
 	if (typeof navigator === "undefined") return () => {};
 	const host = navigator;
 	if (BACKUP_KEY$1 in host) return () => uninstallGeolocationShim();
-	const original = navigator.geolocation;
-	host[BACKUP_KEY$1] = original;
-	host[SNAPSHOT_KEY$1] = installNavigatorProperty("geolocation", {
-		value: createGeolocationShim(original),
-		configurable: true,
-		writable: true
+	const target = navigator.geolocation;
+	if (!target) {
+		host[BACKUP_KEY$1] = void 0;
+		return () => uninstallGeolocationShim();
+	}
+	const shim = createGeolocationShim({
+		getCurrentPosition: target.getCurrentPosition?.bind(target),
+		watchPosition: target.watchPosition?.bind(target),
+		clearWatch: target.clearWatch?.bind(target)
+	});
+	const snapshot = installObjectMethods(target, {
+		getCurrentPosition: shim.getCurrentPosition,
+		watchPosition: shim.watchPosition,
+		clearWatch: shim.clearWatch
 	});
+	if (!snapshot) {
+		host[BACKUP_KEY$1] = void 0;
+		return () => uninstallGeolocationShim();
+	}
+	host[BACKUP_KEY$1] = { target };
+	host[SNAPSHOT_KEY$1] = snapshot;
 	return uninstallGeolocationShim;
 }
 function uninstallGeolocationShim() {
@@ -399,7 +488,7 @@ function uninstallGeolocationShim() {
 	const host = navigator;
 	if (!(BACKUP_KEY$1 in host)) return;
 	const snapshot = host[SNAPSHOT_KEY$1];
-	if (snapshot) restoreNavigatorProperty("geolocation", snapshot);
+	if (snapshot) restoreObjectMethods(snapshot);
 	delete host[BACKUP_KEY$1];
 	delete host[SNAPSHOT_KEY$1];
 }
@@ -426,6 +515,15 @@ function uninstallGeolocationShim() {
 * visible again. We never mutate the prototype — doing so would throw in
 * browsers where the descriptor is non-configurable.
 *
+* Browser-compat caveat (Chromium): `navigator.onLine` and `navigator.connection`
+* are value slots, not methods, so the method-level install trick we use for
+* `geolocation`/`share`/`vibrate` does not apply here. When Chromium marks the
+* instance descriptor as non-configurable AND the prototype descriptor is also
+* non-configurable, we cannot install. In that case the shim logs a one-time
+* `console.warn` and leaves the native values in place — consumers keep the
+* browser's own `onLine`/`connection` values; the SDK-synced state is simply
+* disabled for that session.
+*
 * Caveat: the Web NetworkInformation API is evented (`change` fires on
 * transitions). The SDK exposes only a one-shot query, so listeners attached
 * to `navigator.connection` are accepted but never fire from a `change` event
@@ -531,22 +629,36 @@ function installNetworkShim() {
 	const nativeOnLine = navigator.onLine;
 	const nativeConnection = navigator.connection;
 	refresh();
-	host[ON_LINE_SNAPSHOT_KEY] = installNavigatorProperty("onLine", {
-		configurable: true,
-		get() {
-			refresh();
-			if (cachedStatus !== null) return statusToOnline(cachedStatus);
-			return nativeOnLine ?? true;
-		}
-	});
-	host[CONNECTION_SNAPSHOT_KEY] = installNavigatorProperty("connection", {
-		configurable: true,
-		get() {
-			refresh();
-			if (cachedStatus === null && nativeConnection !== void 0) return nativeConnection;
-			return connection;
-		}
-	});
+	let installWarned = false;
+	const warnNonConfigurable = (e) => {
+		if (installWarned) return;
+		installWarned = true;
+		console.warn("[@ait-co/polyfill] navigator.onLine/connection is non-configurable in this browser; Toss network status sync disabled.", e);
+	};
+	try {
+		host[ON_LINE_SNAPSHOT_KEY] = installNavigatorProperty("onLine", {
+			configurable: true,
+			get() {
+				refresh();
+				if (cachedStatus !== null) return statusToOnline(cachedStatus);
+				return nativeOnLine ?? true;
+			}
+		});
+	} catch (e) {
+		warnNonConfigurable(e);
+	}
+	try {
+		host[CONNECTION_SNAPSHOT_KEY] = installNavigatorProperty("connection", {
+			configurable: true,
+			get() {
+				refresh();
+				if (cachedStatus === null && nativeConnection !== void 0) return nativeConnection;
+				return connection;
+			}
+		});
+	} catch (e) {
+		warnNonConfigurable(e);
+	}
 	return uninstallNetworkShim;
 }
 function uninstallNetworkShim() {
@@ -573,13 +685,18 @@ function uninstallNetworkShim() {
 * Outside Apps in Toss → defers to the browser's native `navigator.share`, or
 * throws `NotSupportedError` if unavailable.
 *
+* Install strategy: **method-level** on `navigator`. Assigning
+* `navigator.share = fn` creates an own property that shadows the prototype
+* method. Uninstall deletes the own shadow so the prototype method surfaces
+* again. We do not mutate `Navigator.prototype` — in real browsers its
+* descriptor may be non-configurable, which would throw on reassignment.
+*
 * Caveat: the SDK's share has no counterpart for `files` (Web Share Level 2).
 * `canShare({ files })` returns `false` whenever the sync-accessible detection
 * says Toss is active (or is being forced via the test override).
 */
 const SHARE_BACKUP_KEY = Symbol.for("@ait-co/polyfill/share.original");
 const SHARE_SNAPSHOT_KEY = Symbol.for("@ait-co/polyfill/share.snapshot");
-const CAN_SHARE_SNAPSHOT_KEY = Symbol.for("@ait-co/polyfill/canShare.snapshot");
 function buildSdkMessage(data) {
 	const parts = [];
 	if (data?.title != null && data.title !== "") parts.push(data.title);
@@ -606,7 +723,7 @@ async function shareShim(data) {
 	}
 	const original = navigator[SHARE_BACKUP_KEY]?.share;
 	if (!original) throw new DOMException("[@ait-co/polyfill] navigator.share is not available in this environment.", "NotSupportedError");
-	return original.call(navigator, data);
+	return original(data);
 }
 function canShareShim(data) {
 	const hasFiles = Boolean(data?.files && data.files.length > 0);
@@ -617,7 +734,7 @@ function canShareShim(data) {
 	}
 	if (toss === true) return Boolean(data?.title != null && data.title !== "" || data?.text != null && data.text !== "" || data?.url != null && data.url !== "");
 	const originalCanShare = navigator[SHARE_BACKUP_KEY]?.canShare;
-	if (originalCanShare) return originalCanShare.call(navigator, data);
+	if (originalCanShare) return originalCanShare(data);
 	return Boolean(data?.title != null && data.title !== "" || data?.text != null && data.text !== "" || data?.url != null && data.url !== "");
 }
 function installShareShim() {
@@ -626,34 +743,28 @@ function installShareShim() {
 	if (SHARE_BACKUP_KEY in host) return () => uninstallShareShim();
 	const nav = navigator;
 	host[SHARE_BACKUP_KEY] = {
-		share: nav.share,
-		canShare: nav.canShare,
-		hadShare: "share" in nav,
-		hadCanShare: "canShare" in nav
+		share: nav.share ? nav.share.bind(navigator) : void 0,
+		canShare: nav.canShare ? nav.canShare.bind(navigator) : void 0
 	};
-	host[SHARE_SNAPSHOT_KEY] = installNavigatorProperty("share", {
-		value: shareShim,
-		configurable: true,
-		writable: true
-	});
-	host[CAN_SHARE_SNAPSHOT_KEY] = installNavigatorProperty("canShare", {
-		value: canShareShim,
-		configurable: true,
-		writable: true
+	const snapshot = installObjectMethods(navigator, {
+		share: shareShim,
+		canShare: canShareShim
 	});
+	if (!snapshot) {
+		delete host[SHARE_BACKUP_KEY];
+		return () => uninstallShareShim();
+	}
+	host[SHARE_SNAPSHOT_KEY] = snapshot;
 	return uninstallShareShim;
 }
 function uninstallShareShim() {
 	if (typeof navigator === "undefined") return;
 	const host = navigator;
 	if (!(SHARE_BACKUP_KEY in host)) return;
-	const shareSnap = host[SHARE_SNAPSHOT_KEY];
-	if (shareSnap) restoreNavigatorProperty("share", shareSnap);
-	const canShareSnap = host[CAN_SHARE_SNAPSHOT_KEY];
-	if (canShareSnap) restoreNavigatorProperty("canShare", canShareSnap);
+	const snapshot = host[SHARE_SNAPSHOT_KEY];
+	if (snapshot) restoreObjectMethods(snapshot);
 	delete host[SHARE_BACKUP_KEY];
 	delete host[SHARE_SNAPSHOT_KEY];
-	delete host[CAN_SHARE_SNAPSHOT_KEY];
 }
 //#endregion
 //#region src/shims/vibrate.ts
@@ -669,6 +780,11 @@ function uninstallShareShim() {
 * or returns `false` when unavailable (matches the spec — browsers that don't
 * support vibration simply return `false`).
 *
+* Install strategy: **method-level** on `navigator`. We assign our wrapper to
+* `navigator.vibrate` (creating an own shadow over the prototype method) and
+* delete it on uninstall so the prototype re-surfaces. We do not mutate
+* `Navigator.prototype` itself — browsers may mark it non-configurable.
+*
 * Caveats (documented in CLAUDE.md as the known lossy trade-off):
 *   - SDK haptics are qualitative ("tickWeak", "basicMedium"), not millisecond
 *     durations. The shim approximates intensity from duration but cannot
@@ -694,7 +810,7 @@ function vibrateShim(pattern) {
 	const arr = Array.isArray(pattern) ? pattern : [pattern];
 	if (arr.length === 0 || arr.every((n) => n === 0)) {
 		(async () => {
-			if (!await isTossEnvironment()) navigator[BACKUP_KEY]?.call(navigator, pattern);
+			if (!await isTossEnvironment()) navigator[BACKUP_KEY]?.(pattern);
 		})();
 		return true;
 	}
@@ -713,7 +829,8 @@ function vibrateShim(pattern) {
 			}
 			return;
 		}
-		navigator[BACKUP_KEY]?.call(navigator, pattern);
+		const original = navigator[BACKUP_KEY];
+		original?.(pattern);
 	})();
 	return true;
 }
@@ -721,12 +838,14 @@ function installVibrateShim() {
 	if (typeof navigator === "undefined") return () => {};
 	const host = navigator;
 	if (BACKUP_KEY in host) return () => uninstallVibrateShim();
-	host[BACKUP_KEY] = navigator.vibrate?.bind(navigator);
-	host[SNAPSHOT_KEY] = installNavigatorProperty("vibrate", {
-		value: vibrateShim,
-		configurable: true,
-		writable: true
-	});
+	const nav = navigator;
+	host[BACKUP_KEY] = nav.vibrate ? nav.vibrate.bind(navigator) : void 0;
+	const snapshot = installObjectMethods(navigator, { vibrate: vibrateShim });
+	if (!snapshot) {
+		delete host[BACKUP_KEY];
+		return () => uninstallVibrateShim();
+	}
+	host[SNAPSHOT_KEY] = snapshot;
 	return uninstallVibrateShim;
 }
 function uninstallVibrateShim() {
@@ -734,7 +853,7 @@ function uninstallVibrateShim() {
 	const host = navigator;
 	if (!(BACKUP_KEY in host)) return;
 	const snapshot = host[SNAPSHOT_KEY];
-	if (snapshot) restoreNavigatorProperty("vibrate", snapshot);
+	if (snapshot) restoreObjectMethods(snapshot);
 	delete host[BACKUP_KEY];
 	delete host[SNAPSHOT_KEY];
 }