@protobase/ui 0.45.19 → 0.45.20

package/dist/auth/auth-provider.js

@@ -1,8 +1,9 @@
 import { nativeAuthFetch } from "../app/native-auth-fetch.js";
+import { pushNotifications } from "../notifications/push/push-notifications.js";
 import { providerName, withoutSignInLink } from "./provider-link.js";
 import { text } from "./messages.js";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
-import { createAuthSession } from "@protobase/client";
+import { createAuthSession, createClient } from "@protobase/client";
 import { jsx } from "react/jsx-runtime";
 //#region src/auth/auth-provider.tsx
 const AuthContext = createContext(null);
@@ -32,7 +33,11 @@ const AuthProvider = ({ session: given, origin, nativeBridge, children }) => {
 	const [beforeSignIn, setBeforeSignIn] = useState([]);
 	const [locale, setLocale] = useState();
 	const signedOutState = useCallback(() => anonymous ? { kind: "visitor" } : { kind: "signed-out" }, [anonymous]);
-	const markSignedOut = useCallback(() => setState((current) => current.kind === "signed-in" ? { kind: "signed-out" } : current), []);
+	const forgetPush = useRef(async () => {});
+	const markSignedOut = useCallback(() => {
+		forgetPush.current();
+		setState((current) => current.kind === "signed-in" ? { kind: "signed-out" } : current);
+	}, []);
 	const signedOut = useRef(markSignedOut);
 	signedOut.current = markSignedOut;
 	const session = useMemo(() => given ?? createAuthSession({
@@ -44,6 +49,36 @@ const AuthProvider = ({ session: given, origin, nativeBridge, children }) => {
 		origin,
 		nativeBridge
 	]);
+	const pushUser = useRef(void 0);
+	pushUser.current = state.kind === "signed-in" ? {
+		id: state.user.id,
+		own: !state.staff
+	} : void 0;
+	const push = useMemo(() => {
+		const client = createClient({
+			baseUrl: `${origin ?? globalThis.location?.origin ?? ""}/api/v1`,
+			token: ({ refresh }) => session.token({ refresh })
+		});
+		const meta = async () => {
+			const answer = await client.meta();
+			if (answer.status !== "modified") throw new Error("The app answered /meta without its content");
+			return {
+				appName: answer.meta.appName,
+				...answer.meta.notifications && { webPushKey: answer.meta.notifications.webPushKey }
+			};
+		};
+		return pushNotifications({
+			...nativeBridge && { nativeBridge },
+			devices: client.devices,
+			meta,
+			user: () => pushUser.current
+		});
+	}, [
+		session,
+		origin,
+		nativeBridge
+	]);
+	forgetPush.current = push.forget;
 	const enter = useCallback(async (user) => {
 		const [{ missing }, staff] = await Promise.all([session.account.signInMethods(), session.staff.current()]);
 		setState(missing.length > 0 ? {
@@ -55,7 +90,11 @@ const AuthProvider = ({ session: given, origin, nativeBridge, children }) => {
 			user,
 			...staff && { staff }
 		});
-	}, [session]);
+		if (missing.length === 0) push.adopt({
+			id: user.id,
+			own: !staff
+		});
+	}, [session, push]);
 	const finish = useCallback(async (result) => result.kind === "two-factor" ? setState({
 		kind: "two-factor",
 		methods: result.methods
@@ -134,14 +173,18 @@ const AuthProvider = ({ session: given, origin, nativeBridge, children }) => {
 			window.location.assign(await session.account.linkProvider(provider, new URL(withoutSignInLink(window.location.href), window.location.href).href));
 		},
 		stopStaffSession: async () => {
+			await push.forget();
 			await session.staff.stop();
 			setState(signedOutState());
 		},
 		signOut: async () => {
+			await push.turnOff();
 			await session.signOut();
 			setState(signedOutState());
-		}
+		},
+		push
 	}), [
+		push,
 		state,
 		session,
 		signInMethods,

package/dist/data/api-provider.d.ts

@@ -57,6 +57,10 @@ export declare const useClient: () => {
   formChallenge: (name: string) => Promise<import("@protobase/client").FormChallenge>;
   submitForm: (name: string, values: Record<string, unknown>, proof: import("@protobase/client").FormProof) => Promise<void>;
   live: (handlers: import("@protobase/client").LiveHandlers) => () => void;
+  devices: {
+    register: (device: import("@protobase/client").WebDeviceRegistration) => Promise<import("@protobase/client").RegisteredDevice>;
+    remove: (id: string) => Promise<void>;
+  };
 };
 /**
  * The client of the API that serves `resource`: a source's for a resource the app draws from one, the app's own
@@ -116,6 +120,10 @@ export declare const useResourceClient: (resource: string) => {
   formChallenge: (name: string) => Promise<import("@protobase/client").FormChallenge>;
   submitForm: (name: string, values: Record<string, unknown>, proof: import("@protobase/client").FormProof) => Promise<void>;
   live: (handlers: import("@protobase/client").LiveHandlers) => () => void;
+  devices: {
+    register: (device: import("@protobase/client").WebDeviceRegistration) => Promise<import("@protobase/client").RegisteredDevice>;
+    remove: (id: string) => Promise<void>;
+  };
 };
 export type ApiProviderProps = {
   /** Defaults to `/api/v1` on the current origin. */

package/dist/index.d.ts

@@ -25,6 +25,8 @@ import { ListDisplayRow, RecordCardProps } from "./app/displays/list-displays.js
 import { ListDisplay, useListDisplay } from "./app/displays/display-context.js";
 import { RecordLink } from "./app/displays/record-link.js";
 import { useApiToken } from "./auth/use-api-token.js";
+import { PushState } from "./notifications/push/web-push.js";
+import { usePushNotifications } from "./notifications/push/use-push-notifications.js";
 import { SignInPrompt, SignInPromptProps } from "./auth/sign-in-prompt.js";
 import { ResponsiveDialog, ResponsiveDialogProps } from "./primitives/responsive-dialog.js";
 import { OtpInput, OtpInputProps } from "./primitives/otp-input.js";
@@ -66,4 +68,4 @@ import { Section } from "./record-view/section.js";
 import { Form, FormProps } from "./app/create/form.js";
 import { RecordPicker, RecordPickerProps } from "./app/record-picker.js";
 import { Spinner } from "./primitives/spinner.js";
-export { ActionCard, type ActionCardProps, type ActionContext, type ActionHandler, ActionInputError, type ActionInputProps, ApiProvider, type ApiProviderProps, App, AppLink, type AppProps, AssistantDock, type AssistantDockProps, AuthLayout, type AuthLayoutProps, type BackendData, type BackendRefresh, type BeforeSignInProps, type BoardDrop, type BoardDropContext, type BoardDropUndo, type BoardDropWrite, Button, type ButtonProps, type CardAction, type CardTone, ChatMessage, ChatThread, type ChatThreadProps, type ChoiceOption, Choices, type ChoicesProps, CodeForm, type CodeFormProps, CompactTable, type CompactTableProps, Composer, type ComposerProps, type CurrentAddress, Dialog, type DialogProps, type DiffLine, DiffView, type DiffViewProps, type Drop, type DropRule, Field, FieldList, type FieldProps, type FieldWidget, type FieldWidgetEditorProps, type FieldWidgetProps, Form, type FormProps, Input, type InputProps, type LayoutRecord, type ListAddress, type ListChange, type ListDisplay, type ListDisplayRow, LogoMark, Markdown, type MarkdownContentProps as MarkdownProps, MenuSelect, type MenuSelectProps, type MetaData, OtpInput, type OtpInputProps, PartView, type PluginInfo, type ProjectUi, type RecordCardProps, RecordLink, RecordPicker, type RecordPickerProps, ResendCodeButton, type ResendCodeButtonProps, ResponsiveDialog, type ResponsiveDialogProps, Section, Segmented, type SegmentedOption, type SegmentedProps, type ShellLogoProps, SidePanel, type SidePanelProps, SignInPrompt, type SignInPromptProps, Spinner, type Step, StepList, type StepState, Textarea, type TextareaProps, allowDelayMs, buttonClass, definePlugin, defineUi, diffStats, isConflict, isFramed, mergeUi, parseDiff, pluginApi, protobaseVersion, uiFromModule, useApiToken, useAppAddress, useArmedAfterFocus, useAssistant, useAssistantClient, useBackendData, useClient, useFacets, useFieldControl, useGuardedPress, useHistogram, useLayoutRecord, useList, useListDisplay, useMeta, usePlugin, useRecord, useResourceClient, useSeries, useUpdateRecord };
+export { ActionCard, type ActionCardProps, type ActionContext, type ActionHandler, ActionInputError, type ActionInputProps, ApiProvider, type ApiProviderProps, App, AppLink, type AppProps, AssistantDock, type AssistantDockProps, AuthLayout, type AuthLayoutProps, type BackendData, type BackendRefresh, type BeforeSignInProps, type BoardDrop, type BoardDropContext, type BoardDropUndo, type BoardDropWrite, Button, type ButtonProps, type CardAction, type CardTone, ChatMessage, ChatThread, type ChatThreadProps, type ChoiceOption, Choices, type ChoicesProps, CodeForm, type CodeFormProps, CompactTable, type CompactTableProps, Composer, type ComposerProps, type CurrentAddress, Dialog, type DialogProps, type DiffLine, DiffView, type DiffViewProps, type Drop, type DropRule, Field, FieldList, type FieldProps, type FieldWidget, type FieldWidgetEditorProps, type FieldWidgetProps, Form, type FormProps, Input, type InputProps, type LayoutRecord, type ListAddress, type ListChange, type ListDisplay, type ListDisplayRow, LogoMark, Markdown, type MarkdownContentProps as MarkdownProps, MenuSelect, type MenuSelectProps, type MetaData, OtpInput, type OtpInputProps, PartView, type PluginInfo, type ProjectUi, type PushState, type RecordCardProps, RecordLink, RecordPicker, type RecordPickerProps, ResendCodeButton, type ResendCodeButtonProps, ResponsiveDialog, type ResponsiveDialogProps, Section, Segmented, type SegmentedOption, type SegmentedProps, type ShellLogoProps, SidePanel, type SidePanelProps, SignInPrompt, type SignInPromptProps, Spinner, type Step, StepList, type StepState, Textarea, type TextareaProps, allowDelayMs, buttonClass, definePlugin, defineUi, diffStats, isConflict, isFramed, mergeUi, parseDiff, pluginApi, protobaseVersion, uiFromModule, useApiToken, useAppAddress, useArmedAfterFocus, useAssistant, useAssistantClient, useBackendData, useClient, useFacets, useFieldControl, useGuardedPress, useHistogram, useLayoutRecord, useList, useListDisplay, useMeta, usePlugin, usePushNotifications, useRecord, useResourceClient, useSeries, useUpdateRecord };

package/dist/index.js

@@ -51,6 +51,7 @@ import { Form } from "./app/create/form.js";
 import { isConflict, useUpdateRecord } from "./data/use-update-record.js";
 import { App } from "./app/app.js";
 import { RecordLink } from "./app/displays/record-link.js";
+import { usePushNotifications } from "./notifications/push/use-push-notifications.js";
 import { Choices } from "./primitives/choices.js";
 import { RecordPicker } from "./app/record-picker.js";
-export { ActionCard, ActionInputError, ApiProvider, App, AppLink, AssistantDock, AuthLayout, Button, ChatMessage, ChatThread, Choices, CodeForm, CompactTable, Composer, Dialog, DiffView, Field, FieldList, Form, Input, LogoMark, Markdown, MenuSelect, OtpInput, PartView, RecordLink, RecordPicker, ResendCodeButton, ResponsiveDialog, Section, Segmented, SidePanel, SignInPrompt, Spinner, StepList, Textarea, allowDelayMs, buttonClass, definePlugin, defineUi, diffStats, isConflict, isFramed, mergeUi, parseDiff, pluginApi, protobaseVersion, uiFromModule, useApiToken, useAppAddress, useArmedAfterFocus, useAssistant, useAssistantClient, useBackendData, useClient, useFacets, useFieldControl, useGuardedPress, useHistogram, useLayoutRecord, useList, useListDisplay, useMeta, usePlugin, useRecord, useResourceClient, useSeries, useUpdateRecord };
+export { ActionCard, ActionInputError, ApiProvider, App, AppLink, AssistantDock, AuthLayout, Button, ChatMessage, ChatThread, Choices, CodeForm, CompactTable, Composer, Dialog, DiffView, Field, FieldList, Form, Input, LogoMark, Markdown, MenuSelect, OtpInput, PartView, RecordLink, RecordPicker, ResendCodeButton, ResponsiveDialog, Section, Segmented, SidePanel, SignInPrompt, Spinner, StepList, Textarea, allowDelayMs, buttonClass, definePlugin, defineUi, diffStats, isConflict, isFramed, mergeUi, parseDiff, pluginApi, protobaseVersion, uiFromModule, useApiToken, useAppAddress, useArmedAfterFocus, useAssistant, useAssistantClient, useBackendData, useClient, useFacets, useFieldControl, useGuardedPress, useHistogram, useLayoutRecord, useList, useListDisplay, useMeta, usePlugin, usePushNotifications, useRecord, useResourceClient, useSeries, useUpdateRecord };

package/dist/notifications/push/push-browser.js

@@ -0,0 +1,23 @@
+import { serviceWorkerFile } from "@protobase/schema/internal";
+//#region src/notifications/push/push-browser.ts
+/** The page's own browser. */
+const windowPushBrowser = (win = window) => {
+	const { navigator } = win;
+	return {
+		supported: "serviceWorker" in navigator && "PushManager" in win && "Notification" in win && "userActivation" in navigator,
+		permission: () => win.Notification.permission,
+		requestPermission: () => win.Notification.requestPermission(),
+		activated: () => navigator.userActivation.isActive,
+		existingRegistration: () => navigator.serviceWorker.getRegistration("/"),
+		registration: async () => {
+			if (!await navigator.serviceWorker.getRegistration("/")) await navigator.serviceWorker.register(`/${serviceWorkerFile}`);
+			return navigator.serviceWorker.ready;
+		},
+		clearBadge: async () => {
+			if ("clearAppBadge" in navigator) await navigator.clearAppBadge();
+		},
+		userAgent: navigator.userAgent.replace(/[\u0000-\u001f\u007f]/g, "").slice(0, 512)
+	};
+};
+//#endregion
+export { windowPushBrowser };

package/dist/notifications/push/push-notifications.js

@@ -0,0 +1,27 @@
+import { windowPushBrowser } from "./push-browser.js";
+import { indexedDbPushRecords } from "./push-records.js";
+import { webPush } from "./web-push.js";
+//#region src/notifications/push/push-notifications.ts
+const noPush = {
+	state: async () => "unsupported",
+	turnOn: async () => "unsupported",
+	turnOff: async () => {},
+	forget: async () => {},
+	adopt: async () => {}
+};
+/**
+* The push of this page, the one place its transport is chosen: Web Push in a browser; none in the iOS or Android app
+* (`nativeBridge`) yet, nor where the page has no window.
+*/
+const pushNotifications = ({ nativeBridge, ...options }) => {
+	if (nativeBridge || typeof window === "undefined") return noPush;
+	const browser = windowPushBrowser();
+	if (!browser.supported) return noPush;
+	return webPush({
+		...options,
+		browser,
+		records: indexedDbPushRecords()
+	});
+};
+//#endregion
+export { pushNotifications };

package/dist/notifications/push/push-records.js

@@ -0,0 +1,23 @@
+import { pushRecord } from "@protobase/schema/internal";
+//#region src/notifications/push/push-records.ts
+/** The push record in IndexedDB, at the database, store and key the service worker reads (`pushRecord`). */
+const indexedDbPushRecords = (factory = indexedDB) => {
+	const request = (mode, act) => new Promise((resolve, reject) => {
+		const opened = factory.open(pushRecord.database, 1);
+		opened.onupgradeneeded = () => opened.result.createObjectStore(pushRecord.store);
+		opened.onerror = () => reject(opened.error);
+		opened.onsuccess = () => {
+			const db = opened.result;
+			const asked = act(db.transaction(pushRecord.store, mode).objectStore(pushRecord.store));
+			asked.onsuccess = () => (db.close(), resolve(asked.result));
+			asked.onerror = () => (db.close(), reject(asked.error));
+		};
+	});
+	return {
+		read: () => request("readonly", (store) => store.get(pushRecord.key)),
+		write: async (record) => void await request("readwrite", (store) => store.put(record, pushRecord.key)),
+		clear: async () => void await request("readwrite", (store) => store.delete(pushRecord.key))
+	};
+};
+//#endregion
+export { indexedDbPushRecords };

package/dist/notifications/push/use-push-notifications.d.ts

@@ -0,0 +1,15 @@
+import { PushState } from "./web-push.js";
+//#region src/notifications/push/use-push-notifications.d.ts
+/**
+ * Push in this browser for the signed-in user, for a bell or an app's own button: `state` is `loading` until known,
+ * then `unsupported` (hide the button: no Web Push here, such as a tab on iPhone and iPad, or the app has no VAPID key),
+ * `off`, `on` or `blocked` (the user refused notifications in the browser's settings). Call `turnOn` straight from a
+ * click: the browser asks for permission only then, and without a click by someone signed in as themselves nothing
+ * happens. `turnOff` unsubscribes this browser and removes its device.
+ */
+export declare const usePushNotifications: () => {
+  state: "loading" | PushState;
+  turnOn: () => Promise<void>;
+  turnOff: () => Promise<void>;
+};
+//#endregion

package/dist/notifications/push/use-push-notifications.js

@@ -0,0 +1,32 @@
+import { useAuth } from "../../auth/auth-provider.js";
+import { useCallback, useEffect, useState } from "react";
+//#region src/notifications/push/use-push-notifications.ts
+/**
+* Push in this browser for the signed-in user, for a bell or an app's own button: `state` is `loading` until known,
+* then `unsupported` (hide the button: no Web Push here, such as a tab on iPhone and iPad, or the app has no VAPID key),
+* `off`, `on` or `blocked` (the user refused notifications in the browser's settings). Call `turnOn` straight from a
+* click: the browser asks for permission only then, and without a click by someone signed in as themselves nothing
+* happens. `turnOff` unsubscribes this browser and removes its device.
+*/
+const usePushNotifications = () => {
+	const { push, state: auth } = useAuth();
+	const userId = auth.kind === "signed-in" ? auth.user.id : void 0;
+	const [state, setState] = useState("loading");
+	useEffect(() => {
+		let current = true;
+		push.state().then((read) => current && setState(read));
+		return () => {
+			current = false;
+		};
+	}, [push, userId]);
+	return {
+		state,
+		turnOn: useCallback(async () => setState(await push.turnOn()), [push]),
+		turnOff: useCallback(async () => {
+			await push.turnOff();
+			setState(await push.state());
+		}, [push])
+	};
+};
+//#endregion
+export { usePushNotifications };

package/dist/notifications/push/web-push.d.ts

@@ -0,0 +1,5 @@
+import "@protobase/client";
+//#region src/notifications/push/web-push.d.ts
+/** Whether this browser gets the signed-in user's push: it cannot, it does not, it does, or the user blocked it. */
+export type PushState = 'unsupported' | 'off' | 'on' | 'blocked';
+//#endregion

package/dist/notifications/push/web-push.js

@@ -0,0 +1,165 @@
+import { ApiError } from "@protobase/client";
+//#region src/notifications/push/web-push.ts
+const keyBytes = (key) => Uint8Array.from(atob(key.replace(/-/g, "+").replace(/_/g, "/")), (char) => char.charCodeAt(0));
+const within = (ms, promise) => Promise.race([promise, new Promise((resolve) => setTimeout(resolve, ms))]);
+/** Someone else signed in while push was being turned on. */
+var SignedInChanged = class extends Error {};
+const isRefusal = (error, slug) => error instanceof ApiError && error.status === 409 && error.slug === slug;
+/**
+* Web Push for the signed-in user in this browser. It registers only from a click by someone signed in as themselves,
+* never on its own, except to renew the registration this browser already has for that same user. Signing out, or
+* someone else signing in, forgets the registration here first, closing what it showed, then unsubscribes and removes
+* the device, without waiting long on either.
+*/
+const webPush = ({ browser, records, devices, meta, user, waitMs = 3e3 }) => {
+	let metaRead;
+	const appMeta = () => metaRead ??= meta();
+	const forgetHere = async (registration) => {
+		await records.clear();
+		for (const shown of registration ? await registration.getNotifications() : []) shown.close();
+		await browser.clearBadge();
+	};
+	const unsubscribe = async (registration) => {
+		const subscription = await registration?.pushManager.getSubscription();
+		if (subscription) await subscription.unsubscribe();
+	};
+	const drop = async (registration) => {
+		await forgetHere(registration);
+		await unsubscribe(registration);
+	};
+	const register = async (subscription, record) => {
+		const keys = subscription.toJSON().keys ?? {};
+		const device = await devices.register({
+			kind: "web",
+			endpoint: subscription.endpoint,
+			keys: {
+				p256dh: keys.p256dh ?? "",
+				auth: keys.auth ?? ""
+			},
+			userAgent: browser.userAgent,
+			userId: record.userId
+		});
+		await records.write({
+			...record,
+			deviceId: device.id
+		});
+	};
+	const state = async () => {
+		if (!browser.supported || !(await appMeta()).webPushKey) return "unsupported";
+		if (browser.permission() === "denied") return "blocked";
+		const signedIn = user();
+		const registration = await browser.existingRegistration();
+		const [subscription, record] = await Promise.all([registration?.pushManager.getSubscription(), records.read()]);
+		return signedIn && subscription && record?.userId === signedIn.id && record.endpoint === subscription.endpoint ? "on" : "off";
+	};
+	/**
+	* Turns push on for the signed-in user, from their click: call it in the click handler itself. Asks for permission
+	* when the user has not answered yet, subscribes and registers the device. Does nothing without a click, for staff
+	* signed in as the user or for a visitor; a refusal or someone else signing in meanwhile leaves push off.
+	*/
+	const turnOn = async () => {
+		const signedIn = user();
+		if (!browser.supported || !browser.activated() || !signedIn?.own) return state();
+		if (browser.permission() === "default" && await browser.requestPermission() !== "granted") return state();
+		if (browser.permission() !== "granted") return state();
+		const { appName, webPushKey } = await appMeta();
+		if (!webPushKey) return "unsupported";
+		const same = () => user()?.id === signedIn.id && user()?.own === true;
+		const registration = await browser.registration();
+		if (!same()) return state();
+		const [held, earlier] = await Promise.all([registration.pushManager.getSubscription(), records.read()]);
+		if (held && (earlier?.userId !== signedIn.id || earlier.endpoint !== held.endpoint)) await drop(registration);
+		const subscribeAndRegister = async () => {
+			if (!same()) throw new SignedInChanged();
+			const subscription = await registration.pushManager.getSubscription() ?? await registration.pushManager.subscribe({
+				userVisibleOnly: true,
+				applicationServerKey: keyBytes(webPushKey)
+			});
+			const record = {
+				userId: signedIn.id,
+				endpoint: subscription.endpoint,
+				appName
+			};
+			await records.write(record);
+			if (!same()) throw new SignedInChanged();
+			await register(subscription, record);
+		};
+		try {
+			await subscribeAndRegister();
+		} catch (error) {
+			if (isRefusal(error, "device-held")) {
+				await drop(registration);
+				return retryOnce(registration, subscribeAndRegister);
+			}
+			await drop(registration);
+			if (error instanceof SignedInChanged || isRefusal(error, "other-user")) return "off";
+			throw error;
+		}
+		return "on";
+	};
+	const retryOnce = async (registration, attempt) => {
+		try {
+			await attempt();
+		} catch (error) {
+			await drop(registration);
+			if (error instanceof SignedInChanged || isRefusal(error, "device-held") || isRefusal(error, "other-user")) return "off";
+			throw error;
+		}
+		return "on";
+	};
+	/**
+	* Turns push off in this browser: forgets it here, unsubscribes and removes the device, waiting at most `waitMs` on
+	* the push service and the server. A removal that fails is left to the server, which drops the endpoint once the push
+	* service reports it gone.
+	*/
+	const turnOff = async () => {
+		if (!browser.supported) return;
+		const registration = await browser.existingRegistration();
+		const record = await records.read();
+		await forgetHere(registration);
+		await within(waitMs, Promise.allSettled([unsubscribe(registration), record?.deviceId ? devices.remove(record.deviceId) : Promise.resolve()]));
+	};
+	/** As `turnOff`, for a session already over, whose device the server can no longer be asked to remove. */
+	const forget = async () => {
+		if (!browser.supported) return;
+		const registration = await browser.existingRegistration();
+		await forgetHere(registration);
+		await within(waitMs, Promise.allSettled([unsubscribe(registration)]));
+	};
+	/**
+	* Takes the signed-in user in, on every load and sign-in: a registration here for anyone else, or without a record,
+	* is forgotten and unsubscribed; the user's own, when they signed in as themselves and the permission stands, is
+	* registered again, so the device follows their session and a renewed subscription. Nothing is ever registered anew.
+	*/
+	const adopt = async (signedIn) => {
+		if (!browser.supported) return;
+		const registration = await browser.existingRegistration();
+		const [subscription, record] = await Promise.all([registration?.pushManager.getSubscription(), records.read()]);
+		if (!registration) return record ? records.clear() : void 0;
+		if (!record || record.userId !== signedIn.id) return subscription || record ? drop(registration) : void 0;
+		if (!signedIn.own) return;
+		if (!subscription || browser.permission() !== "granted") return drop(registration);
+		if (record.endpoint !== subscription.endpoint && !record.renew) return drop(registration);
+		const renewed = {
+			userId: record.userId,
+			endpoint: subscription.endpoint,
+			appName: record.appName
+		};
+		await records.write(renewed);
+		try {
+			await register(subscription, renewed);
+		} catch (error) {
+			if (!isRefusal(error, "device-held") && !isRefusal(error, "other-user")) throw error;
+			await drop(registration);
+		}
+	};
+	return {
+		state,
+		turnOn,
+		turnOff,
+		forget,
+		adopt
+	};
+};
+//#endregion
+export { webPush };

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.45.19";
+var version = "0.45.20";
 var protobase = { "pluginApi": 1 };
 //#endregion
 export { protobase, version };