Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,37 @@
import { describe, expect, it, vi } from "vitest";
import { registerServiceWorker } from "./registerServiceWorker";
describe("registerServiceWorker", () => {
it("returns null when navigator has no service worker", async () => {
const result = await registerServiceWorker({ navigatorRef: {} as Navigator });
expect(result).toBeNull();
});
it("returns null in dev mode without calling register", async () => {
const register = vi.fn();
const navigatorRef = { serviceWorker: { register } } as unknown as Navigator;
const result = await registerServiceWorker({ navigatorRef, isDev: true });
expect(result).toBeNull();
expect(register).not.toHaveBeenCalled();
});
it("registers /sw.js by default", async () => {
const fakeRegistration = { scope: "/" } as ServiceWorkerRegistration;
const register = vi.fn().mockResolvedValue(fakeRegistration);
const navigatorRef = { serviceWorker: { register } } as unknown as Navigator;
const result = await registerServiceWorker({ navigatorRef });
expect(register).toHaveBeenCalledWith("/sw.js", { scope: "/" });
expect(result).toBe(fakeRegistration);
});
it("swallows registration errors and returns null", async () => {
const register = vi.fn().mockRejectedValue(new Error("boom"));
const navigatorRef = { serviceWorker: { register } } as unknown as Navigator;
const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
const result = await registerServiceWorker({ navigatorRef });
expect(result).toBeNull();
expect(warn).toHaveBeenCalled();
warn.mockRestore();
});
});
@@ -0,0 +1,44 @@
/**
* Service-worker registration helper used by `root.tsx`. Kept in its own
* module so it can be unit-tested without rendering a React tree.
*
* The function is a no-op when:
* - `navigator.serviceWorker` is unavailable (SSR, older browsers).
* - `window.location.protocol` is not http(s) — file:// previews would
* otherwise throw SecurityError.
* - `import.meta.env.DEV` is true — the dev server hot-reloads, and
* a cached SW would shadow new bundles.
*
* Refs: docs/improvement-plan/10-compliance-polish/lighthouse.md (Step (d)).
*/
export type RegisterServiceWorkerOptions = {
scriptUrl?: string;
scope?: string;
/** Inject an override container so tests can supply a fake navigator. */
navigatorRef?: Navigator;
/** Inject an override container so tests can disable DEV gating. */
isDev?: boolean;
};
export async function registerServiceWorker(options: RegisterServiceWorkerOptions = {}): Promise<ServiceWorkerRegistration | null> {
const navigatorRef = options.navigatorRef ?? (typeof navigator === "undefined" ? undefined : navigator);
if (!navigatorRef || !("serviceWorker" in navigatorRef)) {
return null;
}
if (options.isDev) {
return null;
}
try {
return await navigatorRef.serviceWorker.register(options.scriptUrl ?? "/sw.js", {
scope: options.scope ?? "/",
});
} catch (err) {
// Swallow but log — a failed SW must never break the app render.
if (typeof console !== "undefined") {
console.warn("[pwa] service worker registration failed", err);
}
return null;
}
}