@ait-co/polyfill 0.1.5 → 0.1.6

package/dist/shims/network.cjs

@@ -0,0 +1,290 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/detect.ts
+/**
+* Environment detection: are we running inside Apps in Toss, or a plain browser?
+*
+* Strategy: call the SDK's `getAppsInTossGlobals()` — a synchronous export
+* that returns the runtime's Toss globals (deploymentId, brand name, …)
+* inside the Apps in Toss runtime and throws (RN bridge unavailable)
+* anywhere else. The SDK itself is an **optional** peer dependency; if its
+* module can't be imported we are definitely not inside Toss.
+*
+* Just having the SDK module resolvable is not enough — apps can bundle it
+* and still run in a plain browser. We need the bridge probe to confirm.
+*
+* UA sniffing (spoofable) is avoided. We do call `getAppsInTossGlobals`, but
+* that's a constant read from the bridge — no permission dialogs, no
+* analytics fire. In a plain browser the bridge lookup fails fast (sync
+* throw, microsecond-scale), so the startup cost is negligible.
+*/
+let cached;
+/**
+* Returns `true` iff we detect we are running in an environment where the
+* Apps in Toss SDK (`@apps-in-toss/web-framework`) is present and usable.
+*
+* Async because we use dynamic `import()` to probe the optional peer dep
+* without forcing it into the consumer's bundle.
+*/
+async function isTossEnvironment() {
+	const force = globalThis.__AIT_POLYFILL_FORCE__;
+	if (force === "toss") return true;
+	if (force === "browser") return false;
+	if (cached !== void 0) return cached;
+	const mod = await loadTossSdk();
+	if (typeof mod?.getAppsInTossGlobals !== "function") {
+		cached = false;
+		return cached;
+	}
+	try {
+		const globals = mod.getAppsInTossGlobals();
+		cached = Boolean(globals) && typeof globals === "object";
+	} catch {
+		cached = false;
+	}
+	return cached;
+}
+/**
+* Lazy SDK accessor — returns the module if available, else `null`. Callers
+* are expected to `await` and null-check. Never throws.
+*/
+async function loadTossSdk() {
+	try {
+		return await import("@apps-in-toss/web-framework");
+	} catch {
+		return null;
+	}
+}
+//#endregion
+//#region src/shims/_install-helpers.ts
+/**
+* Install `descriptor` at `navigator[prop]`. Prefer instance-level; if the
+* browser refuses (property is non-configurable on the instance), install on
+* `Navigator.prototype` instead.
+*
+* Returns a snapshot describing where the original value was, which
+* `restoreNavigatorProperty` uses to undo the install.
+*/
+function installNavigatorProperty(prop, descriptor) {
+	const nav = navigator;
+	const instanceDesc = Object.getOwnPropertyDescriptor(nav, prop);
+	const instanceHadOwn = instanceDesc !== void 0;
+	if (!instanceDesc || instanceDesc.configurable) try {
+		Object.defineProperty(nav, prop, descriptor);
+		return {
+			location: "instance",
+			originalDescriptor: instanceDesc,
+			instanceHadOwn
+		};
+	} catch {}
+	const proto = Object.getPrototypeOf(nav);
+	const protoDesc = Object.getOwnPropertyDescriptor(proto, prop);
+	if (instanceHadOwn) try {
+		delete nav[prop];
+	} catch {}
+	Object.defineProperty(proto, prop, descriptor);
+	return {
+		location: "prototype",
+		originalDescriptor: protoDesc,
+		instanceHadOwn
+	};
+}
+/**
+* Reverse the install recorded in `snapshot`. If the original descriptor was
+* `undefined` (property didn't exist before), delete the property instead of
+* re-defining it.
+*/
+function restoreNavigatorProperty(prop, snapshot) {
+	const target = snapshot.location === "instance" ? navigator : Object.getPrototypeOf(navigator);
+	if (snapshot.originalDescriptor) try {
+		Object.defineProperty(target, prop, snapshot.originalDescriptor);
+	} catch {}
+	else try {
+		delete target[prop];
+	} catch {}
+}
+//#endregion
+//#region src/shims/network.ts
+/**
+* `navigator.onLine` + `navigator.connection` shim.
+*
+* Inside Apps in Toss → seeded from SDK `getNetworkStatus()` on install and
+* refreshed on read (throttled):
+*   - `'OFFLINE'`   → `onLine = false`
+*   - `'WIFI'`      → `onLine = true`, `effectiveType = '4g'` (no web wifi value)
+*   - `'2G'/'3G'/'4G'/'5G'` → `onLine = true`, `effectiveType = <lowercased>`
+*   - `'WWAN'/'UNKNOWN'`    → `onLine = true`, `effectiveType = '4g'` (best guess)
+*
+* Outside Apps in Toss → both `navigator.onLine` and `navigator.connection`
+* read through to the native value. Install installs own-instance getters
+* that consult the Toss-seeded cache first; when the cache is empty (which
+* it always is in browser mode), the getter temporarily removes its own
+* shadow, reads the prototype value, and reinstates the shadow.
+*
+* Uninstall `delete`s the instance-level override so the prototype descriptor
+* (where `onLine` and `connection` actually live in real browsers) becomes
+* 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
+* unless the shim observes a real status transition. Synthesising richer
+* events via polling is tracked in TODO.md.
+*
+* Lifecycle: `navigator.connection` is a ShimConnection instance that lives in
+* the install closure. On uninstall the instance-level override is removed,
+* but listeners the consumer attached to the old instance stay bound to that
+* (now-orphan) object and will not see events from a subsequent install.
+* Consumers should re-attach listeners after each install.
+*
+* Seed-boundary race: in Toss mode, reads before the install-time SDK seed
+* completes fall through to the native `navigator.connection`. After the seed
+* lands, subsequent reads return the shim's ShimConnection. Consumers that
+* specifically need the ShimConnection instance (e.g., to attach `change`
+* listeners that fire on Toss network transitions) should wait a microtask
+* after `install()` before attaching listeners, or accept that pre-seed
+* reads may return the native object.
+*/
+const INSTALLED_KEY = Symbol.for("@ait-co/polyfill/network.installed");
+const ON_LINE_SNAPSHOT_KEY = Symbol.for("@ait-co/polyfill/network.onLine.snapshot");
+const CONNECTION_SNAPSHOT_KEY = Symbol.for("@ait-co/polyfill/network.connection.snapshot");
+const REFRESH_THROTTLE_MS = 500;
+function statusToOnline(status) {
+	return status !== "OFFLINE";
+}
+function statusToEffectiveType(status) {
+	switch (status) {
+		case "2G": return "2g";
+		case "3G": return "3g";
+		default: return "4g";
+	}
+}
+function statusToConnectionType(status) {
+	switch (status) {
+		case "WIFI": return "wifi";
+		case "2G":
+		case "3G":
+		case "4G":
+		case "5G":
+		case "WWAN": return "cellular";
+		case "OFFLINE": return "none";
+		default: return "unknown";
+	}
+}
+const SET_STATUS = Symbol("@ait-co/polyfill/network.setStatus");
+var ShimConnection = class extends EventTarget {
+	#status = null;
+	onchange = null;
+	constructor() {
+		super();
+		this.addEventListener("change", (ev) => this.onchange?.call(this, ev));
+	}
+	[SET_STATUS](next) {
+		this.#status = next;
+	}
+	get effectiveType() {
+		return statusToEffectiveType(this.#status ?? "UNKNOWN");
+	}
+	get downlink() {
+		return 0;
+	}
+	get rtt() {
+		return 0;
+	}
+	get saveData() {
+		return false;
+	}
+	get type() {
+		return statusToConnectionType(this.#status ?? "UNKNOWN");
+	}
+};
+function installNetworkShim() {
+	if (typeof navigator === "undefined") return () => {};
+	const host = navigator;
+	if (host[INSTALLED_KEY]) return () => uninstallNetworkShim();
+	host[INSTALLED_KEY] = true;
+	let cachedStatus = null;
+	let lastRefresh = 0;
+	let inflight = null;
+	const connection = new ShimConnection();
+	async function refresh() {
+		if (inflight) return inflight;
+		if (Date.now() - lastRefresh < REFRESH_THROTTLE_MS) return;
+		inflight = (async () => {
+			try {
+				if (!await isTossEnvironment()) return;
+				const fn = (await loadTossSdk())?.getNetworkStatus;
+				if (typeof fn !== "function") return;
+				const next = await fn();
+				const prev = cachedStatus;
+				cachedStatus = next;
+				connection[SET_STATUS](next);
+				if (prev !== null && prev !== next) connection.dispatchEvent(new Event("change"));
+			} catch {} finally {
+				lastRefresh = Date.now();
+				inflight = null;
+			}
+		})();
+		return inflight;
+	}
+	const nativeOnLine = navigator.onLine;
+	const nativeConnection = navigator.connection;
+	refresh();
+	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() {
+	if (typeof navigator === "undefined") return;
+	const host = navigator;
+	if (!host[INSTALLED_KEY]) return;
+	const onLineSnap = host[ON_LINE_SNAPSHOT_KEY];
+	if (onLineSnap) restoreNavigatorProperty("onLine", onLineSnap);
+	const connSnap = host[CONNECTION_SNAPSHOT_KEY];
+	if (connSnap) restoreNavigatorProperty("connection", connSnap);
+	delete host[INSTALLED_KEY];
+	delete host[ON_LINE_SNAPSHOT_KEY];
+	delete host[CONNECTION_SNAPSHOT_KEY];
+}
+//#endregion
+exports.installNetworkShim = installNetworkShim;
+exports.uninstallNetworkShim = uninstallNetworkShim;
+
+//# sourceMappingURL=network.cjs.map

package/dist/shims/network.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.cjs","names":["#status"],"sources":["../../src/detect.ts","../../src/shims/_install-helpers.ts","../../src/shims/network.ts"],"sourcesContent":["/**\n * Environment detection: are we running inside Apps in Toss, or a plain browser?\n *\n * Strategy: call the SDK's `getAppsInTossGlobals()` — a synchronous export\n * that returns the runtime's Toss globals (deploymentId, brand name, …)\n * inside the Apps in Toss runtime and throws (RN bridge unavailable)\n * anywhere else. The SDK itself is an **optional** peer dependency; if its\n * module can't be imported we are definitely not inside Toss.\n *\n * Just having the SDK module resolvable is not enough — apps can bundle it\n * and still run in a plain browser. We need the bridge probe to confirm.\n *\n * UA sniffing (spoofable) is avoided. We do call `getAppsInTossGlobals`, but\n * that's a constant read from the bridge — no permission dialogs, no\n * analytics fire. In a plain browser the bridge lookup fails fast (sync\n * throw, microsecond-scale), so the startup cost is negligible.\n */\n\nlet cached: boolean | undefined;\n\n/**\n * Reset the cached detection result. Primarily for tests.\n */\nexport function resetDetection(): void {\n  cached = undefined;\n}\n\n/**\n * Synchronous read of the cached detection result. Returns:\n *   - `true` / `false` if an override is active or the async detection has\n *     already resolved\n *   - `undefined` if detection hasn't run yet\n *\n * Used by spec-sync APIs (e.g. `navigator.canShare`) that can't `await`\n * detection.\n */\nexport function isTossEnvironmentCached(): boolean | undefined {\n  const force = globalThis.__AIT_POLYFILL_FORCE__;\n  if (force === 'toss') return true;\n  if (force === 'browser') return false;\n  return cached;\n}\n\n/**\n * Returns `true` iff we detect we are running in an environment where the\n * Apps in Toss SDK (`@apps-in-toss/web-framework`) is present and usable.\n *\n * Async because we use dynamic `import()` to probe the optional peer dep\n * without forcing it into the consumer's bundle.\n */\nexport async function isTossEnvironment(): Promise<boolean> {\n  // Override check precedes cache so `devtools` / tests can flip the result\n  // mid-session without a `resetDetection()` call.\n  const force = globalThis.__AIT_POLYFILL_FORCE__;\n  if (force === 'toss') return true;\n  if (force === 'browser') return false;\n\n  if (cached !== undefined) return cached;\n\n  const mod = await loadTossSdk();\n  if (typeof mod?.getAppsInTossGlobals !== 'function') {\n    cached = false;\n    return cached;\n  }\n  // Inside Toss the bridge returns a populated globals object. In a plain\n  // browser the RN bridge isn't attached and the call throws — that's our\n  // signal. Any non-throwing call with an object return is treated as Toss.\n  try {\n    const globals = mod.getAppsInTossGlobals();\n    cached = Boolean(globals) && typeof globals === 'object';\n  } catch {\n    cached = false;\n  }\n  return cached;\n}\n\n/**\n * Lazy SDK accessor — returns the module if available, else `null`. Callers\n * are expected to `await` and null-check. Never throws.\n */\nexport async function loadTossSdk(): Promise<typeof import('@apps-in-toss/web-framework') | null> {\n  try {\n    return await import('@apps-in-toss/web-framework');\n  } catch {\n    return null;\n  }\n}\n","/**\n * Shared helpers for installing shims on `navigator`.\n *\n * Chromium now marks a handful of `navigator` properties (e.g. `geolocation`,\n * `clipboard`) as non-configurable **own** properties on the instance. That\n * means a plain `Object.defineProperty(navigator, 'x', …)` throws\n * `TypeError: Cannot redefine property`.\n *\n * The workaround is to shim at the prototype level — `Navigator.prototype`\n * keeps these as configurable accessors, so we can swap them there and every\n * instance that falls through to the prototype (including `window.navigator`)\n * sees the shim. We only reach for the prototype when the instance-level\n * assignment refuses.\n *\n * For restoration we remember the descriptor chain (instance + prototype) so\n * `uninstall()` puts the browser back in its original state.\n */\n\ntype PropertyLocation = 'instance' | 'prototype';\n\nexport interface InstallSnapshot {\n  /** Where we ended up writing the shim. */\n  location: PropertyLocation;\n  /** Original descriptor at that location (may be undefined if nothing was there). */\n  originalDescriptor: PropertyDescriptor | undefined;\n  /** `true` iff the original property lived on the instance before we touched it. */\n  instanceHadOwn: boolean;\n}\n\n/**\n * Install `descriptor` at `navigator[prop]`. Prefer instance-level; if the\n * browser refuses (property is non-configurable on the instance), install on\n * `Navigator.prototype` instead.\n *\n * Returns a snapshot describing where the original value was, which\n * `restoreNavigatorProperty` uses to undo the install.\n */\nexport function installNavigatorProperty(\n  prop: string,\n  descriptor: PropertyDescriptor,\n): InstallSnapshot {\n  const nav = navigator as unknown as Record<PropertyKey, unknown>;\n  const instanceDesc = Object.getOwnPropertyDescriptor(nav, prop);\n  const instanceHadOwn = instanceDesc !== undefined;\n\n  // Fast path: instance-level property is missing or configurable.\n  if (!instanceDesc || instanceDesc.configurable) {\n    try {\n      Object.defineProperty(nav, prop, descriptor);\n      return { location: 'instance', originalDescriptor: instanceDesc, instanceHadOwn };\n    } catch {\n      // Fall through to prototype-level install.\n    }\n  }\n\n  // Prototype-level install. Drop the instance-level shadow so the prototype\n  // accessor is visible to readers on `navigator`.\n  const proto = Object.getPrototypeOf(nav) as object;\n  const protoDesc = Object.getOwnPropertyDescriptor(proto, prop);\n\n  if (instanceHadOwn) {\n    // Try to remove the instance-level shadow. On non-configurable it throws —\n    // we deliberately ignore that; prototype-level install still wins because\n    // the prototype accessor shows through when we read via `navigator[prop]`.\n    try {\n      delete nav[prop];\n    } catch {\n      /* non-configurable own — leave it; prototype install still useful */\n    }\n  }\n\n  Object.defineProperty(proto, prop, descriptor);\n  return { location: 'prototype', originalDescriptor: protoDesc, instanceHadOwn };\n}\n\n/**\n * Reverse the install recorded in `snapshot`. If the original descriptor was\n * `undefined` (property didn't exist before), delete the property instead of\n * re-defining it.\n */\nexport function restoreNavigatorProperty(prop: string, snapshot: InstallSnapshot): void {\n  const target =\n    snapshot.location === 'instance'\n      ? (navigator as unknown as Record<PropertyKey, unknown>)\n      : (Object.getPrototypeOf(navigator) as object);\n\n  if (snapshot.originalDescriptor) {\n    try {\n      Object.defineProperty(target, prop, snapshot.originalDescriptor);\n    } catch {\n      /* descriptor was non-configurable upstream; we can't undo — rare. */\n    }\n  } else {\n    try {\n      delete (target as Record<PropertyKey, unknown>)[prop];\n    } catch {\n      /* non-configurable — rare. */\n    }\n  }\n\n  // If our install pushed past an instance shadow, we leave the instance alone\n  // — the descriptor we captured for `instanceHadOwn: true` lives on the\n  // instance and was not modified at install time.\n}\n\n/**\n * Method-level install snapshot. Captured per-key so `restoreObjectMethods`\n * can distinguish \"was an own property, reassign it\" from \"was inherited,\n * delete the override so the prototype method surfaces again\".\n */\nexport interface MethodInstallSnapshot {\n  target: object;\n  methods: Record<string, { hadOwn: boolean; original: unknown }>;\n}\n\n/**\n * Mutate methods on an existing object rather than replacing the object\n * itself. This is the path we take for `navigator.geolocation`, `navigator.share`,\n * and `navigator.vibrate` in Chromium, where the slot on `navigator` is a\n * non-configurable own property that we cannot replace — but the methods\n * themselves (or the methods on the referenced object) are still\n * `configurable: true, writable: true`.\n *\n * Each replacement is installed via plain assignment. If any slot is not\n * writable (e.g. frozen object), install is aborted and previously-applied\n * replacements are rolled back, so the caller observes an atomic \"all or\n * nothing\" failure as `null`. The caller is expected to degrade gracefully\n * (e.g. log a one-time `console.warn`) when that happens.\n */\nexport function installObjectMethods(\n  target: object,\n  replacements: Record<string, (...args: never[]) => unknown>,\n): MethodInstallSnapshot | null {\n  const methods: Record<string, { hadOwn: boolean; original: unknown }> = {};\n  const applied: string[] = [];\n  const bag = target as Record<string, unknown>;\n\n  for (const key of Object.keys(replacements)) {\n    const hadOwn = Object.hasOwn(target, key);\n    const original = bag[key];\n    try {\n      bag[key] = replacements[key] as unknown;\n    } catch {\n      // Non-writable / frozen. Roll back and return null.\n      for (const applieKey of applied) {\n        const prev = methods[applieKey];\n        if (!prev) continue;\n        if (prev.hadOwn) {\n          bag[applieKey] = prev.original;\n        } else {\n          delete bag[applieKey];\n        }\n      }\n      return null;\n    }\n    // Verify the assignment actually stuck — silent-failure descriptors (e.g.\n    // `writable: false` without strict mode) can skip the throw and leave the\n    // original value in place. Treat that the same as a throw.\n    if (bag[key] !== (replacements[key] as unknown)) {\n      for (const applieKey of applied) {\n        const prev = methods[applieKey];\n        if (!prev) continue;\n        if (prev.hadOwn) {\n          bag[applieKey] = prev.original;\n        } else {\n          delete bag[applieKey];\n        }\n      }\n      return null;\n    }\n    methods[key] = { hadOwn, original };\n    applied.push(key);\n  }\n\n  return { target, methods };\n}\n\n/**\n * Reverse an `installObjectMethods` snapshot. Reassigns originals for slots\n * that were own properties before install; deletes the override for slots\n * that were inherited (so the prototype method surfaces again).\n */\nexport function restoreObjectMethods(snapshot: MethodInstallSnapshot): void {\n  const bag = snapshot.target as Record<string, unknown>;\n  for (const key of Object.keys(snapshot.methods)) {\n    const entry = snapshot.methods[key];\n    if (!entry) continue;\n    try {\n      if (entry.hadOwn) {\n        bag[key] = entry.original;\n      } else {\n        delete bag[key];\n      }\n    } catch {\n      /* frozen between install and restore — rare. */\n    }\n  }\n}\n","/**\n * `navigator.onLine` + `navigator.connection` shim.\n *\n * Inside Apps in Toss → seeded from SDK `getNetworkStatus()` on install and\n * refreshed on read (throttled):\n *   - `'OFFLINE'`   → `onLine = false`\n *   - `'WIFI'`      → `onLine = true`, `effectiveType = '4g'` (no web wifi value)\n *   - `'2G'/'3G'/'4G'/'5G'` → `onLine = true`, `effectiveType = <lowercased>`\n *   - `'WWAN'/'UNKNOWN'`    → `onLine = true`, `effectiveType = '4g'` (best guess)\n *\n * Outside Apps in Toss → both `navigator.onLine` and `navigator.connection`\n * read through to the native value. Install installs own-instance getters\n * that consult the Toss-seeded cache first; when the cache is empty (which\n * it always is in browser mode), the getter temporarily removes its own\n * shadow, reads the prototype value, and reinstates the shadow.\n *\n * Uninstall `delete`s the instance-level override so the prototype descriptor\n * (where `onLine` and `connection` actually live in real browsers) becomes\n * visible again. We never mutate the prototype — doing so would throw in\n * browsers where the descriptor is non-configurable.\n *\n * Browser-compat caveat (Chromium): `navigator.onLine` and `navigator.connection`\n * are value slots, not methods, so the method-level install trick we use for\n * `geolocation`/`share`/`vibrate` does not apply here. When Chromium marks the\n * instance descriptor as non-configurable AND the prototype descriptor is also\n * non-configurable, we cannot install. In that case the shim logs a one-time\n * `console.warn` and leaves the native values in place — consumers keep the\n * browser's own `onLine`/`connection` values; the SDK-synced state is simply\n * disabled for that session.\n *\n * Caveat: the Web NetworkInformation API is evented (`change` fires on\n * transitions). The SDK exposes only a one-shot query, so listeners attached\n * to `navigator.connection` are accepted but never fire from a `change` event\n * unless the shim observes a real status transition. Synthesising richer\n * events via polling is tracked in TODO.md.\n *\n * Lifecycle: `navigator.connection` is a ShimConnection instance that lives in\n * the install closure. On uninstall the instance-level override is removed,\n * but listeners the consumer attached to the old instance stay bound to that\n * (now-orphan) object and will not see events from a subsequent install.\n * Consumers should re-attach listeners after each install.\n *\n * Seed-boundary race: in Toss mode, reads before the install-time SDK seed\n * completes fall through to the native `navigator.connection`. After the seed\n * lands, subsequent reads return the shim's ShimConnection. Consumers that\n * specifically need the ShimConnection instance (e.g., to attach `change`\n * listeners that fire on Toss network transitions) should wait a microtask\n * after `install()` before attaching listeners, or accept that pre-seed\n * reads may return the native object.\n */\n\nimport { isTossEnvironment, loadTossSdk } from '../detect.js';\nimport {\n  type InstallSnapshot,\n  installNavigatorProperty,\n  restoreNavigatorProperty,\n} from './_install-helpers.js';\n\nconst INSTALLED_KEY = Symbol.for('@ait-co/polyfill/network.installed');\nconst ON_LINE_SNAPSHOT_KEY = Symbol.for('@ait-co/polyfill/network.onLine.snapshot');\nconst CONNECTION_SNAPSHOT_KEY = Symbol.for('@ait-co/polyfill/network.connection.snapshot');\n\ninterface BackupHost {\n  [INSTALLED_KEY]?: boolean;\n  [ON_LINE_SNAPSHOT_KEY]?: InstallSnapshot | undefined;\n  [CONNECTION_SNAPSHOT_KEY]?: InstallSnapshot | undefined;\n}\n\ntype SdkNetworkStatus = 'OFFLINE' | 'WIFI' | '2G' | '3G' | '4G' | '5G' | 'WWAN' | 'UNKNOWN';\ntype EffectiveType = 'slow-2g' | '2g' | '3g' | '4g';\n\nconst REFRESH_THROTTLE_MS = 500;\n\nfunction statusToOnline(status: SdkNetworkStatus): boolean {\n  return status !== 'OFFLINE';\n}\n\nfunction statusToEffectiveType(status: SdkNetworkStatus): EffectiveType {\n  switch (status) {\n    case '2G':\n      return '2g';\n    case '3G':\n      return '3g';\n    default:\n      return '4g';\n  }\n}\n\nfunction statusToConnectionType(status: SdkNetworkStatus): string {\n  switch (status) {\n    case 'WIFI':\n      return 'wifi';\n    case '2G':\n    case '3G':\n    case '4G':\n    case '5G':\n    case 'WWAN':\n      return 'cellular';\n    case 'OFFLINE':\n      return 'none';\n    default:\n      return 'unknown';\n  }\n}\n\n// Symbol-keyed setter: the install closure can mutate status without exposing\n// a `setStatus` name on `navigator.connection` (real NetworkInformation has\n// no mutator). `Object.getOwnPropertySymbols(navigator.connection)` returns\n// nothing, so casual enumeration can't find it. A determined caller walking\n// the prototype chain (`Object.getOwnPropertySymbols(Object.getPrototypeOf(...))`)\n// can still surface the symbol — there is no trust boundary between polyfill\n// and consumer code in the same realm, so this is a discouragement, not a\n// security control.\nconst SET_STATUS = Symbol('@ait-co/polyfill/network.setStatus');\n\nclass ShimConnection extends EventTarget {\n  #status: SdkNetworkStatus | null = null;\n  onchange: ((this: ShimConnection, ev: Event) => unknown) | null = null;\n\n  constructor() {\n    super();\n    // Forward `change` events to the legacy `onchange` handler for parity with\n    // the NetworkInformation API.\n    this.addEventListener('change', (ev) => this.onchange?.call(this, ev));\n  }\n\n  [SET_STATUS](next: SdkNetworkStatus | null): void {\n    this.#status = next;\n  }\n\n  get effectiveType(): EffectiveType {\n    return statusToEffectiveType(this.#status ?? 'UNKNOWN');\n  }\n  // `downlink` / `rtt` / `saveData` are placeholders — the SDK does not expose\n  // these. We return 0/false rather than fabricate plausible numbers. Noted\n  // in CLAUDE.md.\n  get downlink(): number {\n    return 0;\n  }\n  get rtt(): number {\n    return 0;\n  }\n  get saveData(): boolean {\n    return false;\n  }\n  get type(): string {\n    return statusToConnectionType(this.#status ?? 'UNKNOWN');\n  }\n}\n\nexport function installNetworkShim(): () => void {\n  if (typeof navigator === 'undefined') {\n    return () => {};\n  }\n\n  const host = navigator as unknown as BackupHost;\n  if (host[INSTALLED_KEY]) {\n    return () => uninstallNetworkShim();\n  }\n  host[INSTALLED_KEY] = true;\n\n  // Per-install state. Kept in closure so uninstall/reinstall cycles don't\n  // leak state between instances (module-scope would leak across tests).\n  let cachedStatus: SdkNetworkStatus | null = null;\n  let lastRefresh = 0;\n  let inflight: Promise<void> | null = null;\n  const connection = new ShimConnection();\n\n  async function refresh(): Promise<void> {\n    // Coalesce concurrent refreshes — without this, rapid reads during an\n    // in-flight SDK call each set `lastRefresh` and return early, without\n    // anyone actually fetching fresh data.\n    if (inflight) return inflight;\n    const now = Date.now();\n    if (now - lastRefresh < REFRESH_THROTTLE_MS) return;\n    inflight = (async () => {\n      try {\n        if (!(await isTossEnvironment())) return;\n        const sdk = await loadTossSdk();\n        const fn = (sdk as { getNetworkStatus?: unknown } | null)?.getNetworkStatus;\n        if (typeof fn !== 'function') return;\n        const next = (await (fn as () => Promise<SdkNetworkStatus>)()) as SdkNetworkStatus;\n        const prev = cachedStatus;\n        cachedStatus = next;\n        connection[SET_STATUS](next);\n        // Only dispatch `change` on real transitions — the null → X seed on\n        // first install is learning, not a transition, and would otherwise\n        // mis-trigger consumer handlers.\n        if (prev !== null && prev !== next) {\n          connection.dispatchEvent(new Event('change'));\n        }\n      } catch {\n        // Advisory — refresh failures keep the prior cache. `void refresh()`\n        // callers would otherwise surface unhandled rejections if\n        // isTossEnvironment / loadTossSdk / getNetworkStatus ever throw.\n      } finally {\n        lastRefresh = Date.now();\n        inflight = null;\n      }\n    })();\n    return inflight;\n  }\n\n  // Capture the native values **before** we install so the getters can fall\n  // through without needing to temporarily remove their own shadow (which is\n  // incompatible with prototype-level installs — Chromium keeps\n  // `navigator.onLine` / `connection` non-configurable on the instance, so we\n  // may end up installing on Navigator.prototype instead).\n  const nativeOnLine = (navigator as Navigator & { onLine?: boolean }).onLine;\n  const nativeConnection = (navigator as Navigator & { connection?: unknown }).connection;\n\n  // Seed the cache on install so the first sync read is meaningful.\n  void refresh();\n\n  // Guard both descriptor installs with try/catch. These properties are value\n  // slots that the plan calls out as not having a method-level equivalent;\n  // when Chromium makes them non-configurable at both the instance and the\n  // prototype, `installNavigatorProperty` may throw. In that case we warn once\n  // and proceed — consumers keep the browser's native values.\n  let installWarned = false;\n  const warnNonConfigurable = (e: unknown): void => {\n    if (installWarned) return;\n    installWarned = true;\n    console.warn(\n      '[@ait-co/polyfill] navigator.onLine/connection is non-configurable in this browser; Toss network status sync disabled.',\n      e,\n    );\n  };\n\n  try {\n    host[ON_LINE_SNAPSHOT_KEY] = installNavigatorProperty('onLine', {\n      configurable: true,\n      get() {\n        void refresh();\n        if (cachedStatus !== null) return statusToOnline(cachedStatus);\n        return nativeOnLine ?? true;\n      },\n    });\n  } catch (e) {\n    warnNonConfigurable(e);\n  }\n\n  try {\n    host[CONNECTION_SNAPSHOT_KEY] = installNavigatorProperty('connection', {\n      configurable: true,\n      get() {\n        void refresh();\n        if (cachedStatus === null && nativeConnection !== undefined) return nativeConnection;\n        return connection;\n      },\n    });\n  } catch (e) {\n    warnNonConfigurable(e);\n  }\n\n  return uninstallNetworkShim;\n}\n\nexport function uninstallNetworkShim(): void {\n  if (typeof navigator === 'undefined') return;\n  const host = navigator as unknown as BackupHost;\n  if (!host[INSTALLED_KEY]) return;\n\n  const onLineSnap = host[ON_LINE_SNAPSHOT_KEY];\n  if (onLineSnap) restoreNavigatorProperty('onLine', onLineSnap);\n  const connSnap = host[CONNECTION_SNAPSHOT_KEY];\n  if (connSnap) restoreNavigatorProperty('connection', connSnap);\n\n  delete host[INSTALLED_KEY];\n  delete host[ON_LINE_SNAPSHOT_KEY];\n  delete host[CONNECTION_SNAPSHOT_KEY];\n}\n"],"mappings":"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"}

package/dist/shims/network.d.cts

@@ -0,0 +1,56 @@
+//#region src/shims/network.d.ts
+/**
+ * `navigator.onLine` + `navigator.connection` shim.
+ *
+ * Inside Apps in Toss → seeded from SDK `getNetworkStatus()` on install and
+ * refreshed on read (throttled):
+ *   - `'OFFLINE'`   → `onLine = false`
+ *   - `'WIFI'`      → `onLine = true`, `effectiveType = '4g'` (no web wifi value)
+ *   - `'2G'/'3G'/'4G'/'5G'` → `onLine = true`, `effectiveType = <lowercased>`
+ *   - `'WWAN'/'UNKNOWN'`    → `onLine = true`, `effectiveType = '4g'` (best guess)
+ *
+ * Outside Apps in Toss → both `navigator.onLine` and `navigator.connection`
+ * read through to the native value. Install installs own-instance getters
+ * that consult the Toss-seeded cache first; when the cache is empty (which
+ * it always is in browser mode), the getter temporarily removes its own
+ * shadow, reads the prototype value, and reinstates the shadow.
+ *
+ * Uninstall `delete`s the instance-level override so the prototype descriptor
+ * (where `onLine` and `connection` actually live in real browsers) becomes
+ * 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
+ * unless the shim observes a real status transition. Synthesising richer
+ * events via polling is tracked in TODO.md.
+ *
+ * Lifecycle: `navigator.connection` is a ShimConnection instance that lives in
+ * the install closure. On uninstall the instance-level override is removed,
+ * but listeners the consumer attached to the old instance stay bound to that
+ * (now-orphan) object and will not see events from a subsequent install.
+ * Consumers should re-attach listeners after each install.
+ *
+ * Seed-boundary race: in Toss mode, reads before the install-time SDK seed
+ * completes fall through to the native `navigator.connection`. After the seed
+ * lands, subsequent reads return the shim's ShimConnection. Consumers that
+ * specifically need the ShimConnection instance (e.g., to attach `change`
+ * listeners that fire on Toss network transitions) should wait a microtask
+ * after `install()` before attaching listeners, or accept that pre-seed
+ * reads may return the native object.
+ */
+declare function installNetworkShim(): () => void;
+declare function uninstallNetworkShim(): void;
+//#endregion
+export { installNetworkShim, uninstallNetworkShim };
+//# sourceMappingURL=network.d.cts.map

package/dist/shims/network.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.cts","names":[],"sources":["../../src/shims/network.ts"],"mappings":";;AAsJA;;;;;AA4GA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA5GgB,kBAAA,CAAA;AAAA,iBA4GA,oBAAA,CAAA"}

package/dist/shims/share.cjs

@@ -0,0 +1,239 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/detect.ts
+/**
+* Environment detection: are we running inside Apps in Toss, or a plain browser?
+*
+* Strategy: call the SDK's `getAppsInTossGlobals()` — a synchronous export
+* that returns the runtime's Toss globals (deploymentId, brand name, …)
+* inside the Apps in Toss runtime and throws (RN bridge unavailable)
+* anywhere else. The SDK itself is an **optional** peer dependency; if its
+* module can't be imported we are definitely not inside Toss.
+*
+* Just having the SDK module resolvable is not enough — apps can bundle it
+* and still run in a plain browser. We need the bridge probe to confirm.
+*
+* UA sniffing (spoofable) is avoided. We do call `getAppsInTossGlobals`, but
+* that's a constant read from the bridge — no permission dialogs, no
+* analytics fire. In a plain browser the bridge lookup fails fast (sync
+* throw, microsecond-scale), so the startup cost is negligible.
+*/
+let cached;
+/**
+* Synchronous read of the cached detection result. Returns:
+*   - `true` / `false` if an override is active or the async detection has
+*     already resolved
+*   - `undefined` if detection hasn't run yet
+*
+* Used by spec-sync APIs (e.g. `navigator.canShare`) that can't `await`
+* detection.
+*/
+function isTossEnvironmentCached() {
+	const force = globalThis.__AIT_POLYFILL_FORCE__;
+	if (force === "toss") return true;
+	if (force === "browser") return false;
+	return cached;
+}
+/**
+* Returns `true` iff we detect we are running in an environment where the
+* Apps in Toss SDK (`@apps-in-toss/web-framework`) is present and usable.
+*
+* Async because we use dynamic `import()` to probe the optional peer dep
+* without forcing it into the consumer's bundle.
+*/
+async function isTossEnvironment() {
+	const force = globalThis.__AIT_POLYFILL_FORCE__;
+	if (force === "toss") return true;
+	if (force === "browser") return false;
+	if (cached !== void 0) return cached;
+	const mod = await loadTossSdk();
+	if (typeof mod?.getAppsInTossGlobals !== "function") {
+		cached = false;
+		return cached;
+	}
+	try {
+		const globals = mod.getAppsInTossGlobals();
+		cached = Boolean(globals) && typeof globals === "object";
+	} catch {
+		cached = false;
+	}
+	return cached;
+}
+/**
+* Lazy SDK accessor — returns the module if available, else `null`. Callers
+* are expected to `await` and null-check. Never throws.
+*/
+async function loadTossSdk() {
+	try {
+		return await import("@apps-in-toss/web-framework");
+	} catch {
+		return null;
+	}
+}
+//#endregion
+//#region src/shims/_install-helpers.ts
+/**
+* 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/share.ts
+/**
+* `navigator.share` shim.
+*
+* Inside Apps in Toss → routes through SDK `share({ message })`. The SDK only
+* accepts a single `message` string, so we concatenate `title`, `text`, and
+* `url` with newline separators (skipping missing/empty values).
+*
+* 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");
+function buildSdkMessage(data) {
+	const parts = [];
+	if (data?.title != null && data.title !== "") parts.push(data.title);
+	if (data?.text != null && data.text !== "") parts.push(data.text);
+	if (data?.url != null && data.url !== "") parts.push(data.url);
+	return parts.join("\n");
+}
+async function shareShim(data) {
+	if (await isTossEnvironment()) {
+		const fn = (await loadTossSdk())?.share;
+		if (typeof fn === "function") {
+			const message = buildSdkMessage(data);
+			if (!message) throw new TypeError("[@ait-co/polyfill] navigator.share requires at least one of title, text, or url.");
+			try {
+				await fn({ message });
+			} catch (e) {
+				const message_ = e instanceof Error ? e.message : String(e);
+				const wrapped = new DOMException(message_, "AbortError");
+				if (e instanceof Error) wrapped.cause = e;
+				throw wrapped;
+			}
+			return;
+		}
+	}
+	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(data);
+}
+function canShareShim(data) {
+	const hasFiles = Boolean(data?.files && data.files.length > 0);
+	const toss = isTossEnvironmentCached();
+	if (hasFiles) {
+		if (toss === true) return false;
+		if (toss === void 0) return false;
+	}
+	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(data);
+	return Boolean(data?.title != null && data.title !== "" || data?.text != null && data.text !== "" || data?.url != null && data.url !== "");
+}
+function installShareShim() {
+	if (typeof navigator === "undefined") return () => {};
+	const host = navigator;
+	if (SHARE_BACKUP_KEY in host) return () => uninstallShareShim();
+	const nav = navigator;
+	host[SHARE_BACKUP_KEY] = {
+		share: nav.share ? nav.share.bind(navigator) : void 0,
+		canShare: nav.canShare ? nav.canShare.bind(navigator) : void 0
+	};
+	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 snapshot = host[SHARE_SNAPSHOT_KEY];
+	if (snapshot) restoreObjectMethods(snapshot);
+	delete host[SHARE_BACKUP_KEY];
+	delete host[SHARE_SNAPSHOT_KEY];
+}
+//#endregion
+exports.installShareShim = installShareShim;
+exports.uninstallShareShim = uninstallShareShim;
+
+//# sourceMappingURL=share.cjs.map