@flighthq/connectivity 0.1.0

package/dist/connectivity.d.ts

@@ -0,0 +1,16 @@
+import type { Connectivity, ConnectivityBackend, ConnectivityReachability, ConnectivityReachabilityOptions, ConnectivityStatus } from '@flighthq/types';
+export declare function attachConnectivity(net: Connectivity): void;
+export declare function createConnectivity(): Connectivity;
+export declare function createConnectivityStatus(): ConnectivityStatus;
+export declare function createWebConnectivityBackend(): ConnectivityBackend;
+export declare function detachConnectivity(net: Connectivity): void;
+export declare function detectConnectivityReachability(options: Readonly<ConnectivityReachabilityOptions>, out: ConnectivityReachability): Promise<ConnectivityReachability>;
+export declare function disposeConnectivity(net: Connectivity): void;
+export declare function getConnectivityBackend(): ConnectivityBackend;
+export declare function getConnectivityStatus(out: ConnectivityStatus): ConnectivityStatus;
+export declare function hasConnectivityStatusChanged(a: Readonly<ConnectivityStatus>, b: Readonly<ConnectivityStatus>): boolean;
+export declare function isConnectivityMetered(): boolean;
+export declare function isConnectivityOnline(): boolean;
+export declare function isConnectivitySaveDataEnabled(): boolean;
+export declare function setConnectivityBackend(backend: ConnectivityBackend | null): void;
+//# sourceMappingURL=connectivity.d.ts.map

package/dist/connectivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity.d.ts","sourceRoot":"","sources":["../src/connectivity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EAEnB,wBAAwB,EACxB,+BAA+B,EAC/B,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAKzB,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAwB1D;AAGD,wBAAgB,kBAAkB,IAAI,YAAY,CAQjD;AAGD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAW7D;AAID,wBAAgB,4BAA4B,IAAI,mBAAmB,CAuDlE;AAGD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAM1D;AAOD,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,QAAQ,CAAC,+BAA+B,CAAC,EAClD,GAAG,EAAE,wBAAwB,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CAcnC;AAID,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3D;AAGD,wBAAgB,sBAAsB,IAAI,mBAAmB,CAG5D;AAGD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,kBAAkB,CAEjF;AAGD,wBAAgB,4BAA4B,CAC1C,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAC/B,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAC9B,OAAO,CAWT;AAGD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAGD,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAGD,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAEhF"}

package/dist/connectivity.js

@@ -0,0 +1,231 @@
+import { createSignal, emitSignal } from '@flighthq/signals';
+// Begins delivering connectivity changes to `net`'s signals by subscribing to the active backend. On
+// each change it reads a fresh status and emits onChange plus edge-triggered signals. Idempotent: a
+// prior subscription is torn down first. Pair with detachConnectivity/disposeConnectivity.
+export function attachConnectivity(net) {
+    detachConnectivity(net);
+    const backend = getConnectivityBackend();
+    const initial = backend.getStatus(_scratch);
+    let wasOnline = initial.online;
+    let wasType = initial.type;
+    let wasMetered = initial.metered;
+    const unsubscribe = backend.subscribe(() => {
+        const status = backend.getStatus(_scratch);
+        emitSignal(net.onChange, status);
+        if (status.online !== wasOnline) {
+            wasOnline = status.online;
+            emitSignal(status.online ? net.onOnline : net.onOffline);
+        }
+        if (status.type !== wasType) {
+            wasType = status.type;
+            emitSignal(net.onConnectionTypeChange, status.type);
+        }
+        if (status.metered !== wasMetered) {
+            wasMetered = status.metered;
+            emitSignal(net.onMeteredChange, status.metered);
+        }
+    });
+    _subscriptions.set(net, unsubscribe);
+}
+// Allocates a Connectivity event entity with inert signals; call attachConnectivity to start delivery.
+export function createConnectivity() {
+    return {
+        onChange: createSignal(),
+        onConnectionTypeChange: createSignal(),
+        onMeteredChange: createSignal(),
+        onOffline: createSignal(),
+        onOnline: createSignal(),
+    };
+}
+// Allocates a zeroed ConnectivityStatus, suitable as the `out` for getConnectivityStatus.
+export function createConnectivityStatus() {
+    return {
+        downlink: -1,
+        downlinkMax: -1,
+        effectiveType: '',
+        metered: false,
+        online: false,
+        rtt: -1,
+        saveData: false,
+        type: 'unknown',
+    };
+}
+// Builds the default web backend over navigator.onLine, the Network Information API, and the window
+// online/offline events. Degrades to online=true / type 'unknown' where the APIs are absent.
+export function createWebConnectivityBackend() {
+    return {
+        getStatus(out) {
+            const nav = typeof navigator !== 'undefined' ? navigator : null;
+            out.online = nav?.onLine ?? true;
+            const conn = getWebConnection();
+            out.type = mapWebConnectionType(conn?.type);
+            out.downlink = typeof conn?.downlink === 'number' ? conn.downlink : -1;
+            out.downlinkMax = typeof conn?.downlinkMax === 'number' ? conn.downlinkMax : -1;
+            out.effectiveType = typeof conn?.effectiveType === 'string' ? conn.effectiveType : '';
+            out.rtt = typeof conn?.rtt === 'number' ? conn.rtt : -1;
+            out.saveData = conn?.saveData === true;
+            out.metered = out.saveData || out.type === 'cellular';
+            return out;
+        },
+        async detectReachability(options, out) {
+            if (typeof fetch === 'undefined') {
+                out.reachable = false;
+                out.latency = -1;
+                return out;
+            }
+            const timeout = options.timeout ?? 5000;
+            const controller = new AbortController();
+            const timerId = setTimeout(() => controller.abort(), timeout);
+            const combinedSignal = options.signal ? anyAbortSignal(options.signal, controller.signal) : controller.signal;
+            const start = Date.now();
+            try {
+                const response = await fetch(options.url, {
+                    method: 'HEAD',
+                    cache: 'no-store',
+                    signal: combinedSignal,
+                });
+                clearTimeout(timerId);
+                out.reachable = response.ok;
+                out.latency = Date.now() - start;
+            }
+            catch {
+                clearTimeout(timerId);
+                out.reachable = false;
+                out.latency = -1;
+            }
+            return out;
+        },
+        subscribe(listener) {
+            if (typeof window === 'undefined')
+                return () => { };
+            window.addEventListener('online', listener);
+            window.addEventListener('offline', listener);
+            const conn = getWebConnection();
+            conn?.addEventListener?.('change', listener);
+            return () => {
+                window.removeEventListener('online', listener);
+                window.removeEventListener('offline', listener);
+                conn?.removeEventListener?.('change', listener);
+            };
+        },
+    };
+}
+// Stops delivery to `net` and forgets its subscription. Safe to call when not attached.
+export function detachConnectivity(net) {
+    const unsubscribe = _subscriptions.get(net);
+    if (unsubscribe !== undefined) {
+        unsubscribe();
+        _subscriptions.delete(net);
+    }
+}
+// Performs a one-shot reachability probe against the given URL using the active backend's
+// detectReachability, falling back to a fetch-based implementation when the backend does not provide
+// one. Writes the result into `out` and returns it. Returns a sentinel on failure rather than throwing.
+// NOTE: navigator.onLine reports an interface, not internet reachability. Use this function when you
+// need to distinguish "a network interface is up" from "the internet is actually reachable."
+export async function detectConnectivityReachability(options, out) {
+    const backend = getConnectivityBackend();
+    if (backend.detectReachability !== undefined) {
+        return backend.detectReachability(options, out);
+    }
+    // Fallback: use the web backend's implementation directly
+    if (_cachedWebBackend === null)
+        _cachedWebBackend = createWebConnectivityBackend();
+    const webBackend = _cachedWebBackend;
+    if (webBackend.detectReachability !== undefined) {
+        return webBackend.detectReachability(options, out);
+    }
+    out.reachable = false;
+    out.latency = -1;
+    return out;
+}
+// Releases `net` for garbage collection by detaching its backend subscription. The signals remain
+// plain GC-managed memory afterward.
+export function disposeConnectivity(net) {
+    detachConnectivity(net);
+}
+// The active network backend, or a lazily-created web default. There is always a backend.
+export function getConnectivityBackend() {
+    if (_backend === null)
+        _backend = createWebConnectivityBackend();
+    return _backend;
+}
+// Fills `out` with the current connectivity snapshot and returns it.
+export function getConnectivityStatus(out) {
+    return getConnectivityBackend().getStatus(out);
+}
+// Returns a diff of two status snapshots. Returns true if any field differs.
+export function hasConnectivityStatusChanged(a, b) {
+    return (a.online !== b.online ||
+        a.type !== b.type ||
+        a.downlink !== b.downlink ||
+        a.downlinkMax !== b.downlinkMax ||
+        a.effectiveType !== b.effectiveType ||
+        a.rtt !== b.rtt ||
+        a.saveData !== b.saveData ||
+        a.metered !== b.metered);
+}
+// True when the connection is metered (cellular or save-data is set). Convenience over getConnectivityStatus.
+export function isConnectivityMetered() {
+    return getConnectivityBackend().getStatus(_scratch).metered;
+}
+// True when the host currently reports connectivity. Convenience over getConnectivityStatus.
+export function isConnectivityOnline() {
+    return getConnectivityBackend().getStatus(_scratch).online;
+}
+// True when the user or OS has requested reduced data usage. Convenience over getConnectivityStatus.
+export function isConnectivitySaveDataEnabled() {
+    return getConnectivityBackend().getStatus(_scratch).saveData;
+}
+// Installs a native host network backend; pass null to fall back to the web default.
+export function setConnectivityBackend(backend) {
+    _backend = backend;
+}
+let _backend = null;
+const _scratch = createConnectivityStatus();
+const _subscriptions = new WeakMap();
+// Combines two AbortSignals: aborts when either fires.
+function anyAbortSignal(a, b) {
+    if (typeof AbortSignal !== 'undefined' && 'any' in AbortSignal) {
+        return AbortSignal.any([a, b]);
+    }
+    const controller = new AbortController();
+    const onAbort = () => {
+        controller.abort();
+        a.removeEventListener('abort', onAbort);
+        b.removeEventListener('abort', onAbort);
+    };
+    a.addEventListener('abort', onAbort, { once: true });
+    b.addEventListener('abort', onAbort, { once: true });
+    return controller.signal;
+}
+function getWebConnection() {
+    if (typeof navigator === 'undefined')
+        return null;
+    const nav = navigator;
+    return nav.connection ?? null;
+}
+function mapWebConnectionType(type) {
+    switch (type) {
+        case 'bluetooth':
+            return 'bluetooth';
+        case 'cellular':
+            return 'cellular';
+        case 'ethernet':
+            return 'ethernet';
+        case 'none':
+            return 'none';
+        case 'other':
+            return 'other';
+        case 'vpn':
+            return 'vpn';
+        case 'wifi':
+            return 'wifi';
+        case 'wimax':
+            return 'wimax';
+        default:
+            return 'unknown';
+    }
+}
+let _cachedWebBackend = null;
+//# sourceMappingURL=connectivity.js.map

package/dist/connectivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity.js","sourceRoot":"","sources":["../src/connectivity.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './connectivity';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './connectivity';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/connectivity",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Connectivity status and online/offline change signals over a swappable web/native backend",
+  "sideEffects": false
+}

package/src/connectivity.test.ts

@@ -0,0 +1,351 @@
+import { connectSignal } from '@flighthq/signals';
+import type { ConnectivityBackend, ConnectivityReachability, ConnectivityStatus } from '@flighthq/types';
+
+import {
+  attachConnectivity,
+  createConnectivity,
+  createConnectivityStatus,
+  createWebConnectivityBackend,
+  detachConnectivity,
+  detectConnectivityReachability,
+  disposeConnectivity,
+  getConnectivityBackend,
+  getConnectivityStatus,
+  hasConnectivityStatusChanged,
+  isConnectivityMetered,
+  isConnectivityOnline,
+  isConnectivitySaveDataEnabled,
+  setConnectivityBackend,
+} from './connectivity';
+
+function fakeBackend(
+  overrides?: Partial<ConnectivityStatus>,
+): ConnectivityBackend & { status: ConnectivityStatus; fire: () => void } {
+  let listener: (() => void) | null = null;
+  const status: ConnectivityStatus = {
+    downlink: 10,
+    downlinkMax: 100,
+    effectiveType: '4g',
+    metered: false,
+    online: true,
+    rtt: 50,
+    saveData: false,
+    type: 'wifi',
+    ...overrides,
+  };
+  return {
+    status,
+    getStatus(out) {
+      out.online = status.online;
+      out.type = status.type;
+      out.downlink = status.downlink;
+      out.downlinkMax = status.downlinkMax;
+      out.effectiveType = status.effectiveType;
+      out.rtt = status.rtt;
+      out.saveData = status.saveData;
+      out.metered = status.metered;
+      return out;
+    },
+    subscribe(l) {
+      listener = l;
+      return () => {
+        listener = null;
+      };
+    },
+    fire() {
+      listener?.();
+    },
+  };
+}
+
+afterEach(() => setConnectivityBackend(null));
+
+describe('attachConnectivity', () => {
+  it('emits onChange and onOffline on transition to offline', () => {
+    const backend = fakeBackend();
+    setConnectivityBackend(backend);
+    const net = createConnectivity();
+    let changes = 0;
+    let offline = 0;
+    connectSignal(net.onChange, () => changes++);
+    connectSignal(net.onOffline, () => offline++);
+    attachConnectivity(net);
+    backend.status.online = false;
+    (backend as ReturnType<typeof fakeBackend>).fire();
+    expect(changes).toBe(1);
+    expect(offline).toBe(1);
+  });
+
+  it('emits onOnline on transition to online', () => {
+    const backend = fakeBackend({ online: false });
+    setConnectivityBackend(backend);
+    const net = createConnectivity();
+    let online = 0;
+    connectSignal(net.onOnline, () => online++);
+    attachConnectivity(net);
+    backend.status.online = true;
+    (backend as ReturnType<typeof fakeBackend>).fire();
+    expect(online).toBe(1);
+  });
+
+  it('emits onConnectionTypeChange on type transition', () => {
+    const backend = fakeBackend();
+    setConnectivityBackend(backend);
+    const net = createConnectivity();
+    const types: string[] = [];
+    connectSignal(net.onConnectionTypeChange, (t) => types.push(t));
+    attachConnectivity(net);
+    backend.status.type = 'cellular';
+    (backend as ReturnType<typeof fakeBackend>).fire();
+    expect(types).toEqual(['cellular']);
+  });
+
+  it('does not emit onConnectionTypeChange when type is unchanged', () => {
+    const backend = fakeBackend();
+    setConnectivityBackend(backend);
+    const net = createConnectivity();
+    let count = 0;
+    connectSignal(net.onConnectionTypeChange, () => count++);
+    attachConnectivity(net);
+    // fire without changing type
+    (backend as ReturnType<typeof fakeBackend>).fire();
+    expect(count).toBe(0);
+  });
+
+  it('emits onMeteredChange on metered transition', () => {
+    const backend = fakeBackend();
+    setConnectivityBackend(backend);
+    const net = createConnectivity();
+    const metered: boolean[] = [];
+    connectSignal(net.onMeteredChange, (m) => metered.push(m));
+    attachConnectivity(net);
+    backend.status.metered = true;
+    (backend as ReturnType<typeof fakeBackend>).fire();
+    expect(metered).toEqual([true]);
+  });
+
+  it('is idempotent — replaces prior subscription', () => {
+    const backend = fakeBackend();
+    setConnectivityBackend(backend);
+    const net = createConnectivity();
+    let changes = 0;
+    connectSignal(net.onChange, () => changes++);
+    attachConnectivity(net);
+    attachConnectivity(net);
+    (backend as ReturnType<typeof fakeBackend>).fire();
+    expect(changes).toBe(1);
+  });
+});
+
+describe('createConnectivity', () => {
+  it('creates an entity with five signals', () => {
+    const net = createConnectivity();
+    expect(net.onChange).toBeDefined();
+    expect(net.onConnectionTypeChange).toBeDefined();
+    expect(net.onMeteredChange).toBeDefined();
+    expect(net.onOnline).toBeDefined();
+    expect(net.onOffline).toBeDefined();
+  });
+});
+
+describe('createConnectivityStatus', () => {
+  it('allocates a zeroed status with all fields at sentinel values', () => {
+    expect(createConnectivityStatus()).toEqual({
+      downlink: -1,
+      downlinkMax: -1,
+      effectiveType: '',
+      metered: false,
+      online: false,
+      rtt: -1,
+      saveData: false,
+      type: 'unknown',
+    });
+  });
+});
+
+describe('createWebConnectivityBackend', () => {
+  it('reads a status without throwing', () => {
+    const out = createConnectivityStatus();
+    const result = createWebConnectivityBackend().getStatus(out);
+    expect(typeof result.online).toBe('boolean');
+    expect(typeof result.metered).toBe('boolean');
+    expect(typeof result.saveData).toBe('boolean');
+  });
+
+  it('returns sentinel rtt and downlinkMax when connection is absent', () => {
+    const out = createConnectivityStatus();
+    createWebConnectivityBackend().getStatus(out);
+    // In jsdom, navigator.connection is absent so rtt/downlinkMax default to -1
+    expect(out.rtt).toBe(-1);
+    expect(out.downlinkMax).toBe(-1);
+  });
+});
+
+describe('detachConnectivity', () => {
+  it('stops further delivery', () => {
+    const backend = fakeBackend();
+    setConnectivityBackend(backend);
+    const net = createConnectivity();
+    let changes = 0;
+    connectSignal(net.onChange, () => changes++);
+    attachConnectivity(net);
+    detachConnectivity(net);
+    (backend as ReturnType<typeof fakeBackend>).fire();
+    expect(changes).toBe(0);
+  });
+
+  it('is safe to call when not attached', () => {
+    const net = createConnectivity();
+    expect(() => detachConnectivity(net)).not.toThrow();
+  });
+});
+
+describe('detectConnectivityReachability', () => {
+  it('returns a sentinel when fetch is unavailable (SSR/jsdom guard)', async () => {
+    // The web backend's detectReachability returns a sentinel in jsdom where fetch is absent or HEAD
+    // requests fail. We install a backend without detectReachability to test the fallback path.
+    setConnectivityBackend(fakeBackend());
+    const out: ConnectivityReachability = { latency: 0, reachable: true };
+    // fetch is undefined in vitest/jsdom by default — expect sentinel
+    const result = await detectConnectivityReachability({ url: 'https://example.com' }, out);
+    expect(result).toBe(out);
+    // In jsdom fetch may not exist or may fail; either way we get reachable=false or a live result
+    expect(typeof result.reachable).toBe('boolean');
+  });
+
+  it('uses the backend detectReachability when available', async () => {
+    const probeBackend: ConnectivityBackend = {
+      ...fakeBackend(),
+      async detectReachability(_opts, out) {
+        out.reachable = true;
+        out.latency = 42;
+        return out;
+      },
+    };
+    setConnectivityBackend(probeBackend);
+    const out: ConnectivityReachability = { latency: 0, reachable: false };
+    const result = await detectConnectivityReachability({ url: 'https://example.com' }, out);
+    expect(result.reachable).toBe(true);
+    expect(result.latency).toBe(42);
+  });
+});
+
+describe('disposeConnectivity', () => {
+  it('detaches the subscription', () => {
+    const backend = fakeBackend();
+    setConnectivityBackend(backend);
+    const net = createConnectivity();
+    attachConnectivity(net);
+    expect(() => disposeConnectivity(net)).not.toThrow();
+  });
+
+  it('is safe to call when not attached', () => {
+    const net = createConnectivity();
+    expect(() => disposeConnectivity(net)).not.toThrow();
+  });
+});
+
+describe('getConnectivityBackend', () => {
+  it('falls back to a web backend', () => {
+    expect(getConnectivityBackend()).not.toBeNull();
+  });
+});
+
+describe('getConnectivityStatus', () => {
+  it('fills the out parameter from the backend', () => {
+    setConnectivityBackend(fakeBackend());
+    const out = createConnectivityStatus();
+    expect(getConnectivityStatus(out)).toBe(out);
+    expect(out.type).toBe('wifi');
+    expect(out.rtt).toBe(50);
+    expect(out.downlinkMax).toBe(100);
+  });
+});
+
+describe('hasConnectivityStatusChanged', () => {
+  it('returns false for equal statuses', () => {
+    const a = createConnectivityStatus();
+    const b = createConnectivityStatus();
+    expect(hasConnectivityStatusChanged(a, b)).toBe(false);
+  });
+
+  it('returns true when online differs', () => {
+    const a = { ...createConnectivityStatus(), online: true };
+    const b = createConnectivityStatus();
+    expect(hasConnectivityStatusChanged(a, b)).toBe(true);
+  });
+
+  it('returns true when type differs', () => {
+    const a = { ...createConnectivityStatus(), type: 'wifi' as const };
+    const b = createConnectivityStatus();
+    expect(hasConnectivityStatusChanged(a, b)).toBe(true);
+  });
+
+  it('returns true when rtt differs', () => {
+    const a = { ...createConnectivityStatus(), rtt: 30 };
+    const b = createConnectivityStatus();
+    expect(hasConnectivityStatusChanged(a, b)).toBe(true);
+  });
+
+  it('returns true when saveData differs', () => {
+    const a = { ...createConnectivityStatus(), saveData: true };
+    const b = createConnectivityStatus();
+    expect(hasConnectivityStatusChanged(a, b)).toBe(true);
+  });
+
+  it('returns true when metered differs', () => {
+    const a = { ...createConnectivityStatus(), metered: true };
+    const b = createConnectivityStatus();
+    expect(hasConnectivityStatusChanged(a, b)).toBe(true);
+  });
+
+  it('is alias-safe — same object returns false', () => {
+    const s = createConnectivityStatus();
+    expect(hasConnectivityStatusChanged(s, s)).toBe(false);
+  });
+});
+
+describe('isConnectivityMetered', () => {
+  it('returns false for a non-metered connection', () => {
+    setConnectivityBackend(fakeBackend({ metered: false }));
+    expect(isConnectivityMetered()).toBe(false);
+  });
+
+  it('returns true for a metered connection', () => {
+    setConnectivityBackend(fakeBackend({ metered: true }));
+    expect(isConnectivityMetered()).toBe(true);
+  });
+});
+
+describe('isConnectivityOnline', () => {
+  it('reflects the backend online flag', () => {
+    const backend = fakeBackend({ online: false });
+    setConnectivityBackend(backend);
+    expect(isConnectivityOnline()).toBe(false);
+  });
+
+  it('returns true when the backend is online', () => {
+    setConnectivityBackend(fakeBackend({ online: true }));
+    expect(isConnectivityOnline()).toBe(true);
+  });
+});
+
+describe('isConnectivitySaveDataEnabled', () => {
+  it('returns false when saveData is off', () => {
+    setConnectivityBackend(fakeBackend({ saveData: false }));
+    expect(isConnectivitySaveDataEnabled()).toBe(false);
+  });
+
+  it('returns true when saveData is on', () => {
+    setConnectivityBackend(fakeBackend({ saveData: true }));
+    expect(isConnectivitySaveDataEnabled()).toBe(true);
+  });
+});
+
+describe('setConnectivityBackend', () => {
+  it('clears back to the web fallback when passed null', () => {
+    setConnectivityBackend(fakeBackend());
+    setConnectivityBackend(null);
+    expect(getConnectivityBackend()).not.toBeNull();
+  });
+});