@eifi1/ui-kit 0.44.0 → 0.46.0

package/dist/notifications/push-worker.js

@@ -0,0 +1,62 @@
+"use client";
+const PUSH_SUBSCRIPTION_CHANGED = "eifi1:push-subscription-changed";
+function keyBytes(key) {
+  const base64 = key.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - key.length % 4) % 4);
+  const raw = atob(base64);
+  const bytes = new Uint8Array(new ArrayBuffer(raw.length));
+  for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);
+  return bytes;
+}
+function pushSubscriptionInput(subscription) {
+  const json = subscription.toJSON();
+  const p256dh = json.keys?.p256dh;
+  const auth = json.keys?.auth;
+  if (!json.endpoint || !p256dh || !auth) return null;
+  return {
+    endpoint: json.endpoint,
+    keys: { p256dh, auth },
+    user_agent: typeof navigator !== "undefined" && navigator.userAgent || null
+  };
+}
+async function resubscribeAfterChange(event, pushManager, options) {
+  const old = event.oldSubscription;
+  const oldAuth = old?.toJSON().keys?.auth;
+  if (!old?.endpoint || !oldAuth) return "no_previous";
+  try {
+    let next = event.newSubscription ?? await pushManager.getSubscription();
+    if (!next || next.endpoint === old.endpoint) {
+      const kept = old.options?.applicationServerKey;
+      const key = kept ? null : await options.pushKey();
+      if (key === "") return "push_off";
+      next = await pushManager.subscribe({
+        userVisibleOnly: true,
+        applicationServerKey: kept ?? keyBytes(key ?? "")
+      });
+    }
+    const subscription = pushSubscriptionInput(next);
+    if (!subscription) return "incomplete";
+    await options.replace({ old_endpoint: old.endpoint, old_auth: oldAuth, subscription });
+    return "replaced";
+  } catch {
+    return "failed";
+  }
+}
+function handlePushSubscriptionChange(scope, options) {
+  scope.addEventListener("pushsubscriptionchange", (event) => {
+    const done = resubscribeAfterChange(event, scope.registration.pushManager, options).then(async (outcome) => {
+      options.onOutcome?.(outcome);
+      const pages = await scope.clients?.matchAll({ type: "window", includeUncontrolled: true }) ?? [];
+      for (const page of pages) page.postMessage({ type: PUSH_SUBSCRIPTION_CHANGED, outcome });
+      return outcome;
+    });
+    event.waitUntil?.(done);
+  });
+}
+export {
+  PUSH_SUBSCRIPTION_CHANGED,
+  handlePushSubscriptionChange,
+  keyBytes,
+  pushSubscriptionInput,
+  resubscribeAfterChange
+};
+//# sourceMappingURL=push-worker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/notifications/push-worker.ts"],"sourcesContent":["/**\n * The service worker's half of Web Push that the kit can own (0.46,\n * docs/notifications-harmonization.md NT:1028): re-registering a subscription the\n * browser ROTATED. A push service may replace a subscription (expiry, a key rotation, a\n * browser update) and fires `pushsubscriptionchange` in the worker; until 0.46 the\n * server kept sending to the old endpoint, got 410, deleted the device, and the person\n * had to turn push on again without knowing why.\n *\n * {@link handlePushSubscriptionChange} listens for the event in the app's worker and\n * calls the app's `replace` — `POST /notifications/devices/replace` (server-kit\n * `PushReplaceIn`): the OLD endpoint and the old subscription's `auth` secret, which only\n * this browser and the server hold, prove the device without a session (a worker has no\n * `Authorization` header to send), and the server moves that row to the new endpoint in\n * place — same account, same device. Open pages are told with a\n * {@link PUSH_SUBSCRIPTION_CHANGED} message, and every mounted `usePushDevice` re-reads.\n *\n * Dependency-free (no React), so an app's worker bundle takes only this file — through\n * the worker-safe subpath `@eifi1/ui-kit/push-worker` (0.46, §10.6 rule 5), not the main\n * barrel, which reaches React and the components:\n *\n *     // sw.ts\n *     import { handlePushSubscriptionChange } from \"@eifi1/ui-kit/push-worker\";\n *     handlePushSubscriptionChange(self, {\n *       pushKey: () => fetch(\"/api/notifications/push-key\").then((r) => r.json()).then((b) => b.key),\n *       replace: (body) => fetch(\"/api/notifications/devices/replace\", {\n *         method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify(body),\n *       }).then((r) => { if (!r.ok) throw new Error(String(r.status)); }),\n *     });\n */\n\n/** What `register` sends: `POST /notifications/devices` (§3.5). */\nexport interface PushSubscriptionInput {\n  endpoint: string;\n  keys: { p256dh: string; auth: string };\n  user_agent: string | null;\n}\n\n/** What `replace` sends: `POST /notifications/devices/replace` (server-kit\n *  `PushReplaceIn`). The endpoint never goes in a URL. */\nexport interface PushReplaceInput {\n  /** The rotated-away subscription's endpoint. */\n  old_endpoint: string;\n  /** Its `keys.auth` as registered — the proof that this browser held it. */\n  old_auth: string;\n  /** The browser's new subscription. */\n  subscription: PushSubscriptionInput;\n}\n\n/** The message a worker posts to its pages after a rotation, and the window event the\n *  hooks re-read on — the same name. */\nexport const PUSH_SUBSCRIPTION_CHANGED = \"eifi1:push-subscription-changed\";\n\n/** A VAPID public key (base64url) as the bytes `PushManager.subscribe` wants. */\nexport function keyBytes(key: string): Uint8Array<ArrayBuffer> {\n  const base64 = key.replace(/-/g, \"+\").replace(/_/g, \"/\") + \"=\".repeat((4 - (key.length % 4)) % 4);\n  const raw = atob(base64);\n  const bytes = new Uint8Array(new ArrayBuffer(raw.length));\n  for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);\n  return bytes;\n}\n\n/** A subscription's register body, or `null` when the browser handed back an incomplete\n *  one. */\nexport function pushSubscriptionInput(subscription: PushSubscription): PushSubscriptionInput | null {\n  const json = subscription.toJSON();\n  const p256dh = json.keys?.p256dh;\n  const auth = json.keys?.auth;\n  if (!json.endpoint || !p256dh || !auth) return null;\n  return {\n    endpoint: json.endpoint,\n    keys: { p256dh, auth },\n    user_agent: (typeof navigator !== \"undefined\" && navigator.userAgent) || null,\n  };\n}\n\n/** The `pushsubscriptionchange` event as the worker receives it (not in TypeScript's\n *  DOM lib). Either subscription may be missing: Chrome often hands neither. */\nexport interface PushSubscriptionChangeEventLike {\n  readonly oldSubscription?: PushSubscription | null;\n  readonly newSubscription?: PushSubscription | null;\n  waitUntil?: (promise: Promise<unknown>) => void;\n}\n\nexport interface PushSubscriptionChangeOptions {\n  /** `GET /notifications/push-key` → its `key` — asked only when the browser handed no\n   *  new subscription and the old one does not carry its key. `\"\"`: push is off. */\n  pushKey: () => Promise<string>;\n  /** `POST /notifications/devices/replace`. A rejection is the outcome `\"failed\"`. */\n  replace: (input: PushReplaceInput) => Promise<unknown>;\n}\n\n/**\n * What a rotation came to: `\"replaced\"` — the server moved the device; `\"no_previous\"` —\n * the browser named no old subscription (or one without its keys), so there is nothing\n * to prove the device with and the page shows push as off; `\"push_off\"` — the server has\n * no key; `\"incomplete\"` — the new subscription has no keys; `\"failed\"` — `replace` (or\n * the browser's subscribe) threw.\n */\nexport type PushResubscribeOutcome = \"replaced\" | \"no_previous\" | \"push_off\" | \"incomplete\" | \"failed\";\n\n/**\n * Re-register after `pushsubscriptionchange`: the browser's new subscription — or, when\n * it handed none, the one it holds now, or a fresh one under the old subscription's key\n * (else `pushKey()`) — sent to `replace` with the old endpoint and its `auth`.\n */\nexport async function resubscribeAfterChange(\n  event: PushSubscriptionChangeEventLike,\n  pushManager: PushManager,\n  options: PushSubscriptionChangeOptions,\n): Promise<PushResubscribeOutcome> {\n  const old = event.oldSubscription;\n  const oldAuth = old?.toJSON().keys?.auth;\n  if (!old?.endpoint || !oldAuth) return \"no_previous\";\n  try {\n    let next = event.newSubscription ?? (await pushManager.getSubscription());\n    if (!next || next.endpoint === old.endpoint) {\n      const kept = old.options?.applicationServerKey;\n      const key = kept ? null : await options.pushKey();\n      if (key === \"\") return \"push_off\";\n      next = await pushManager.subscribe({\n        userVisibleOnly: true,\n        applicationServerKey: kept ?? keyBytes(key ?? \"\"),\n      });\n    }\n    const subscription = pushSubscriptionInput(next);\n    if (!subscription) return \"incomplete\";\n    await options.replace({ old_endpoint: old.endpoint, old_auth: oldAuth, subscription });\n    return \"replaced\";\n  } catch {\n    return \"failed\";\n  }\n}\n\n/** The parts of a `ServiceWorkerGlobalScope` this needs. */\nexport interface PushWorkerScope {\n  addEventListener: (type: \"pushsubscriptionchange\", listener: (event: PushSubscriptionChangeEventLike) => void) => void;\n  registration: { pushManager: PushManager };\n  clients?: { matchAll: (options?: { type?: \"window\"; includeUncontrolled?: boolean }) => Promise<readonly { postMessage: (message: unknown) => void }[]> };\n}\n\n/**\n * Listen for `pushsubscriptionchange` in the app's service worker (`self`) and\n * re-register through {@link resubscribeAfterChange}, holding the worker alive until it\n * is done (`waitUntil`). Then every open page gets `{ type: PUSH_SUBSCRIPTION_CHANGED,\n * outcome }`; `usePushDevice` re-reads on it. `onOutcome` is for the app's own logging.\n */\nexport function handlePushSubscriptionChange(\n  scope: PushWorkerScope,\n  options: PushSubscriptionChangeOptions & { onOutcome?: (outcome: PushResubscribeOutcome) => void },\n): void {\n  scope.addEventListener(\"pushsubscriptionchange\", (event) => {\n    const done = resubscribeAfterChange(event, scope.registration.pushManager, options).then(async (outcome) => {\n      options.onOutcome?.(outcome);\n      const pages = (await scope.clients?.matchAll({ type: \"window\", includeUncontrolled: true })) ?? [];\n      for (const page of pages) page.postMessage({ type: PUSH_SUBSCRIPTION_CHANGED, outcome });\n      return outcome;\n    });\n    event.waitUntil?.(done);\n  });\n}\n"],"mappings":";AAkDO,MAAM,4BAA4B;AAGlC,SAAS,SAAS,KAAsC;AAC7D,QAAM,SAAS,IAAI,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG,IAAI,IAAI,QAAQ,IAAK,IAAI,SAAS,KAAM,CAAC;AAChG,QAAM,MAAM,KAAK,MAAM;AACvB,QAAM,QAAQ,IAAI,WAAW,IAAI,YAAY,IAAI,MAAM,CAAC;AACxD,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAK,OAAM,CAAC,IAAI,IAAI,WAAW,CAAC;AAChE,SAAO;AACT;AAIO,SAAS,sBAAsB,cAA8D;AAClG,QAAM,OAAO,aAAa,OAAO;AACjC,QAAM,SAAS,KAAK,MAAM;AAC1B,QAAM,OAAO,KAAK,MAAM;AACxB,MAAI,CAAC,KAAK,YAAY,CAAC,UAAU,CAAC,KAAM,QAAO;AAC/C,SAAO;AAAA,IACL,UAAU,KAAK;AAAA,IACf,MAAM,EAAE,QAAQ,KAAK;AAAA,IACrB,YAAa,OAAO,cAAc,eAAe,UAAU,aAAc;AAAA,EAC3E;AACF;AAgCA,eAAsB,uBACpB,OACA,aACA,SACiC;AACjC,QAAM,MAAM,MAAM;AAClB,QAAM,UAAU,KAAK,OAAO,EAAE,MAAM;AACpC,MAAI,CAAC,KAAK,YAAY,CAAC,QAAS,QAAO;AACvC,MAAI;AACF,QAAI,OAAO,MAAM,mBAAoB,MAAM,YAAY,gBAAgB;AACvE,QAAI,CAAC,QAAQ,KAAK,aAAa,IAAI,UAAU;AAC3C,YAAM,OAAO,IAAI,SAAS;AAC1B,YAAM,MAAM,OAAO,OAAO,MAAM,QAAQ,QAAQ;AAChD,UAAI,QAAQ,GAAI,QAAO;AACvB,aAAO,MAAM,YAAY,UAAU;AAAA,QACjC,iBAAiB;AAAA,QACjB,sBAAsB,QAAQ,SAAS,OAAO,EAAE;AAAA,MAClD,CAAC;AAAA,IACH;AACA,UAAM,eAAe,sBAAsB,IAAI;AAC/C,QAAI,CAAC,aAAc,QAAO;AAC1B,UAAM,QAAQ,QAAQ,EAAE,cAAc,IAAI,UAAU,UAAU,SAAS,aAAa,CAAC;AACrF,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAeO,SAAS,6BACd,OACA,SACM;AACN,QAAM,iBAAiB,0BAA0B,CAAC,UAAU;AAC1D,UAAM,OAAO,uBAAuB,OAAO,MAAM,aAAa,aAAa,OAAO,EAAE,KAAK,OAAO,YAAY;AAC1G,cAAQ,YAAY,OAAO;AAC3B,YAAM,QAAS,MAAM,MAAM,SAAS,SAAS,EAAE,MAAM,UAAU,qBAAqB,KAAK,CAAC,KAAM,CAAC;AACjG,iBAAW,QAAQ,MAAO,MAAK,YAAY,EAAE,MAAM,2BAA2B,QAAQ,CAAC;AACvF,aAAO;AAAA,IACT,CAAC;AACD,UAAM,YAAY,IAAI;AAAA,EACxB,CAAC;AACH;","names":[]}

package/dist/notifications/quiet-hours-setting.d.ts

@@ -7,17 +7,29 @@ export interface QuietHoursSettingProps extends Omit<ComponentPropsWithRef<"div"
     start: string | null;
     /** The `GET`'s `quiet_hours_end`. */
     end: string | null;
-    /** The `GET`'s `timezone`, an IANA name, or `null` (the app's zone applies). */
-    timezone: string | null;
+    /** The zone the 0.36 card showed, an IANA name, or `null`.
+     *  @deprecated 0.46 — pass `zone` (§10.3: the zone is the account's, automatic only); removed in 0.47.
+     *  Shown read-only while `zone` is left out; the card no longer offers a picker. */
+    timezone?: string | null;
     /**
-     * Save one change — `PATCH /notifications/settings`: a time (`null` when cleared), with
-     * the device's zone the first time one is entered while `timezone` is `null`; or
-     * `{timezone}`. The field shows the new value while the call runs and goes back if it
+     * 0.46 (§10.3, amended 2026-10-20: automatic only): the account's zone — `/auth/me`'s
+     * `device_timezone`, the zone of the device last used; `null` while no device has
+     * reported one, and the card then names `fallbackZone`, the zone the server applies.
+     * Shown read-only once a time is set ("In your time zone (Europe / Zurich), which follows
+     * the device you last used."). No picker: the zone is never chosen.
+     */
+    zone?: string | null;
+    /** 0.46 (§10.4): the app queues a held push and sends it when the window ends (it runs
+     *  the notifications tick); the description says so. Default `false`: dropped. */
+    held?: boolean;
+    /**
+     * Save one change — `PATCH /notifications/settings`: a time, or `null` when cleared.
+     * Never a zone. The field shows the new value while the call runs and goes back if it
      * rejects.
      */
     onChange: (patch: NotificationSettingsPatch) => Promise<unknown> | void;
-    /** The zone shown, and the one the server applies, while `timezone` is `null`.
-     *  Default `"Europe/Zurich"`, every app's (decision 6). */
+    /** The zone named while neither `zone` nor `timezone` names one: the one the server
+     *  applies. Default `"Europe/Zurich"`, every app's. */
     fallbackZone?: string;
     /** The app keeps an inbox, and the description says a held push still reaches it. */
     inbox?: boolean;
@@ -29,19 +41,19 @@ export interface QuietHoursSettingProps extends Omit<ComponentPropsWithRef<"div"
 /**
  * Quiet hours (docs/notifications-harmonization.md §2.4, §2.6, §4.2): a window of local
  * times in the account's zone, which may cross midnight, when no push of a machine-sent
- * type is sent. A held push is dropped, not delayed; the inbox row and the mail go as
- * usual. keksdose's block, as a card of its own.
+ * type is sent. A held push is dropped — or, with `held` (0.46, §10.4), sent when the
+ * window ends; the inbox row and the mail go as usual. keksdose's block, as a card of its
+ * own.
+ *
+ * **0.46 (§10.3, amended 2026-10-20, Marcel): the zone is the account's, automatic
+ * only** — the zone of the device last used, else `Europe/Zurich`. The card names it
+ * read-only and never sends one; there is no picker and no "Use it".
  *
  * - **Two times**, each saved as it is entered; a cleared time sends `null`. While only
  *   one is set the card says so: the window fails open until both are.
- * - **The zone** shows while a time is set. The first time entered while the account has
- *   none sends this device's zone with it, so "22:00" means the person's 22:00
- *   (keksdose `notifications-card.tsx:288-292`). With none stored, the card shows
- *   `fallbackZone` — the zone the server then applies — never the device's (keksdose's
- *   card showed the device's zone while its server applied UTC).
- * - **"This device is in …"** with "Use it" when the device's zone is not the one in
- *   effect. Never written on its own: a zone is written by a person's pick (§2.6).
+ * - **The zone** shows while a time is set: `zone`, else the deprecated `timezone`, else
+ *   `fallbackZone`.
  *
  * Under a write lock the fields are `commit` controls exempt from billing.
  */
-export declare function QuietHoursSetting({ start, end, timezone, onChange, fallbackZone, inbox, disabled, describeError, labels: labelsProp, className, ...rest }: QuietHoursSettingProps): import("react").JSX.Element;
+export declare function QuietHoursSetting({ start, end, timezone, zone, held, onChange, fallbackZone, inbox, disabled, describeError, labels: labelsProp, className, ...rest }: QuietHoursSettingProps): import("react").JSX.Element;

package/dist/notifications/quiet-hours-setting.js

@@ -2,7 +2,6 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useId, useState } from "react";
 import { cn } from "../lib/cn.js";
-import { Button } from "../components/button.js";
 import { Card } from "../components/card.js";
 import { TimeInput } from "../components/time-input.js";
 import { COMMIT_EXCEPT_BILLING } from "../components/write-lock.js";
@@ -10,12 +9,14 @@ import { CARD_DESCRIPTION_CLASS } from "../settings/settings-card-classes.js";
 import { SettingsCardTitle } from "../settings/settings-heading.js";
 import { settle, useMounted } from "../account/account-parts.js";
 import { describeFailure, FailureLine, useNotificationsLabels, useWriteOverlay } from "./notification-parts.js";
-import { deviceTimeZone, TimeZoneSelect, zoneName } from "./time-zone-select.js";
+import { zoneName } from "./time-zone-select.js";
 const DEFAULT_FALLBACK_ZONE = "Europe/Zurich";
 function QuietHoursSetting({
   start,
   end,
-  timezone,
+  timezone = null,
+  zone,
+  held = false,
   onChange,
   fallbackZone = DEFAULT_FALLBACK_ZONE,
   inbox = false,
@@ -26,16 +27,14 @@ function QuietHoursSetting({
   ...rest
 }) {
   const labels = useNotificationsLabels(labelsProp);
-  const overlay = useWriteOverlay(`${start}|${end}|${timezone}`);
+  const overlay = useWriteOverlay(`${start}|${end}`);
   const [failure, setFailure] = useState(null);
   const mounted = useMounted();
   const id = useId();
   const shown = (field, server) => overlay.has(field) ? overlay.get(field) ?? null : server;
   const startShown = shown("quiet_hours_start", start);
   const endShown = shown("quiet_hours_end", end);
-  const zoneShown = shown("timezone", timezone);
-  const effectiveZone = zoneShown ?? fallbackZone;
-  const device = deviceTimeZone();
+  const accountZone = (zone === void 0 ? timezone : zone) ?? fallbackZone;
   const save = (patch) => {
     const fields = Object.keys(patch);
     setFailure(null);
@@ -54,16 +53,14 @@ function QuietHoursSetting({
   const saveTime = (field, value) => {
     const next = value || null;
     if (next === shown(field, field === "quiet_hours_start" ? start : end)) return;
-    const patch = { [field]: next };
-    if (next && zoneShown === null) patch.timezone = device;
-    save(patch);
+    save({ [field]: next });
   };
   const anySet = Boolean(startShown || endShown);
   const halfSet = Boolean(startShown) !== Boolean(endShown);
   return /* @__PURE__ */ jsxs(Card, { ...rest, className: cn("p-4 space-y-3", className), children: [
     /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx(SettingsCardTitle, { children: labels.quietTitle }),
-      /* @__PURE__ */ jsx("div", { className: CARD_DESCRIPTION_CLASS, children: labels.quietDescription(inbox) })
+      /* @__PURE__ */ jsx("div", { className: CARD_DESCRIPTION_CLASS, children: labels.quietDescription(inbox, held) })
     ] }),
     /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-end gap-3", children: [
       /* @__PURE__ */ jsx(
@@ -92,36 +89,7 @@ function QuietHoursSetting({
       )
     ] }),
     halfSet && /* @__PURE__ */ jsx("p", { className: "text-xs text-warning", "data-quiet-incomplete": "", children: labels.quietIncomplete }),
-    anySet && /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
-      /* @__PURE__ */ jsx(
-        TimeZoneSelect,
-        {
-          id: `${id}-zone`,
-          value: effectiveZone,
-          disabled,
-          commit: COMMIT_EXCEPT_BILLING,
-          onChange: (zone) => save({ timezone: zone }),
-          className: "max-w-72",
-          labels: labelsProp
-        }
-      ),
-      device !== effectiveZone && /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
-        /* @__PURE__ */ jsx("span", { id: `${id}-device`, className: CARD_DESCRIPTION_CLASS, children: labels.deviceZone(zoneName(device, labels.regions)) }),
-        /* @__PURE__ */ jsx(
-          Button,
-          {
-            type: "button",
-            size: "sm",
-            variant: "link",
-            disabled,
-            commit: COMMIT_EXCEPT_BILLING,
-            "aria-describedby": `${id}-device`,
-            onClick: () => save({ timezone: device }),
-            children: labels.useDeviceZone
-          }
-        )
-      ] })
-    ] }),
+    anySet && /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, "data-quiet-zone": "", children: labels.quietZone(zoneName(accountZone, labels.regions)) }),
     /* @__PURE__ */ jsx(FailureLine, { children: failure })
   ] });
 }

package/dist/notifications/quiet-hours-setting.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/notifications/quiet-hours-setting.tsx"],"sourcesContent":["import { useId, useState } from \"react\";\nimport type { ComponentPropsWithRef, ReactNode } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { Button } from \"../components/button\";\nimport { Card } from \"../components/card\";\nimport { TimeInput } from \"../components/time-input\";\nimport { COMMIT_EXCEPT_BILLING } from \"../components/write-lock\";\nimport { CARD_DESCRIPTION_CLASS } from \"../settings/settings-card-classes\";\nimport { SettingsCardTitle } from \"../settings/settings-heading\";\nimport { settle, useMounted } from \"../account/account-parts\";\nimport { describeFailure, FailureLine, useNotificationsLabels, useWriteOverlay } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\nimport type { NotificationSettingsPatch } from \"./notification-types\";\nimport { deviceTimeZone, TimeZoneSelect, zoneName } from \"./time-zone-select\";\n\n/** The zone the server applies while the account has none (§2.6): every app's. */\nconst DEFAULT_FALLBACK_ZONE = \"Europe/Zurich\";\n\nexport interface QuietHoursSettingProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"onChange\"> {\n  /** The `GET`'s `quiet_hours_start`, `\"HH:MM\"`, or `null`. */\n  start: string | null;\n  /** The `GET`'s `quiet_hours_end`. */\n  end: string | null;\n  /** The `GET`'s `timezone`, an IANA name, or `null` (the app's zone applies). */\n  timezone: string | null;\n  /**\n   * Save one change — `PATCH /notifications/settings`: a time (`null` when cleared), with\n   * the device's zone the first time one is entered while `timezone` is `null`; or\n   * `{timezone}`. The field shows the new value while the call runs and goes back if it\n   * rejects.\n   */\n  onChange: (patch: NotificationSettingsPatch) => Promise<unknown> | void;\n  /** The zone shown, and the one the server applies, while `timezone` is `null`.\n   *  Default `\"Europe/Zurich\"`, every app's (decision 6). */\n  fallbackZone?: string;\n  /** The app keeps an inbox, and the description says a held push still reaches it. */\n  inbox?: boolean;\n  disabled?: boolean;\n  /** The app's own words for a failed save, or `undefined` for the kit's `failed`. */\n  describeError?: (error: unknown) => ReactNode | undefined;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\ntype QuietField = \"quiet_hours_start\" | \"quiet_hours_end\" | \"timezone\";\n\n/**\n * Quiet hours (docs/notifications-harmonization.md §2.4, §2.6, §4.2): a window of local\n * times in the account's zone, which may cross midnight, when no push of a machine-sent\n * type is sent. A held push is dropped, not delayed; the inbox row and the mail go as\n * usual. keksdose's block, as a card of its own.\n *\n * - **Two times**, each saved as it is entered; a cleared time sends `null`. While only\n *   one is set the card says so: the window fails open until both are.\n * - **The zone** shows while a time is set. The first time entered while the account has\n *   none sends this device's zone with it, so \"22:00\" means the person's 22:00\n *   (keksdose `notifications-card.tsx:288-292`). With none stored, the card shows\n *   `fallbackZone` — the zone the server then applies — never the device's (keksdose's\n *   card showed the device's zone while its server applied UTC).\n * - **\"This device is in …\"** with \"Use it\" when the device's zone is not the one in\n *   effect. Never written on its own: a zone is written by a person's pick (§2.6).\n *\n * Under a write lock the fields are `commit` controls exempt from billing.\n */\nexport function QuietHoursSetting({\n  start,\n  end,\n  timezone,\n  onChange,\n  fallbackZone = DEFAULT_FALLBACK_ZONE,\n  inbox = false,\n  disabled = false,\n  describeError,\n  labels: labelsProp,\n  className,\n  ...rest\n}: QuietHoursSettingProps) {\n  const labels = useNotificationsLabels(labelsProp);\n  const overlay = useWriteOverlay<string | null>(`${start}|${end}|${timezone}`);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const mounted = useMounted();\n  const id = useId();\n\n  const shown = (field: QuietField, server: string | null) =>\n    overlay.has(field) ? (overlay.get(field) ?? null) : server;\n  const startShown = shown(\"quiet_hours_start\", start);\n  const endShown = shown(\"quiet_hours_end\", end);\n  const zoneShown = shown(\"timezone\", timezone);\n  const effectiveZone = zoneShown ?? fallbackZone;\n  const device = deviceTimeZone();\n\n  const save = (patch: NotificationSettingsPatch) => {\n    const fields = Object.keys(patch) as QuietField[];\n    setFailure(null);\n    for (const field of fields) overlay.set(field, patch[field] ?? null);\n    settle(() => onChange(patch)).then(\n      () => {\n        if (mounted.current) for (const field of fields) overlay.settle(field, true);\n      },\n      (error: unknown) => {\n        if (!mounted.current) return;\n        for (const field of fields) overlay.settle(field, false);\n        setFailure(describeFailure(describeError?.(error), labels.failed));\n      },\n    );\n  };\n\n  const saveTime = (field: \"quiet_hours_start\" | \"quiet_hours_end\", value: string) => {\n    const next = value || null;\n    if (next === shown(field, field === \"quiet_hours_start\" ? start : end)) return;\n    const patch: NotificationSettingsPatch = { [field]: next };\n    if (next && zoneShown === null) patch.timezone = device;\n    save(patch);\n  };\n\n  const anySet = Boolean(startShown || endShown);\n  const halfSet = Boolean(startShown) !== Boolean(endShown);\n\n  return (\n    <Card {...rest} className={cn(\"p-4 space-y-3\", className)}>\n      <div>\n        <SettingsCardTitle>{labels.quietTitle}</SettingsCardTitle>\n        <div className={CARD_DESCRIPTION_CLASS}>{labels.quietDescription(inbox)}</div>\n      </div>\n      <div className=\"flex flex-wrap items-end gap-3\">\n        <TimeInput\n          id={`${id}-start`}\n          label={labels.quietFrom}\n          value={startShown ?? \"\"}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onValueChange={(value) => saveTime(\"quiet_hours_start\", value)}\n          className=\"w-36\"\n        />\n        <TimeInput\n          id={`${id}-end`}\n          label={labels.quietUntil}\n          value={endShown ?? \"\"}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onValueChange={(value) => saveTime(\"quiet_hours_end\", value)}\n          className=\"w-36\"\n        />\n      </div>\n      {halfSet && (\n        <p className=\"text-xs text-warning\" data-quiet-incomplete=\"\">\n          {labels.quietIncomplete}\n        </p>\n      )}\n      {anySet && (\n        <div className=\"space-y-2\">\n          <TimeZoneSelect\n            id={`${id}-zone`}\n            value={effectiveZone}\n            disabled={disabled}\n            commit={COMMIT_EXCEPT_BILLING}\n            onChange={(zone) => save({ timezone: zone })}\n            className=\"max-w-72\"\n            labels={labelsProp}\n          />\n          {device !== effectiveZone && (\n            <div className=\"flex flex-wrap items-center gap-x-2 gap-y-1\">\n              <span id={`${id}-device`} className={CARD_DESCRIPTION_CLASS}>\n                {labels.deviceZone(zoneName(device, labels.regions))}\n              </span>\n              <Button\n                type=\"button\"\n                size=\"sm\"\n                variant=\"link\"\n                disabled={disabled}\n                commit={COMMIT_EXCEPT_BILLING}\n                aria-describedby={`${id}-device`}\n                onClick={() => save({ timezone: device })}\n              >\n                {labels.useDeviceZone}\n              </Button>\n            </div>\n          )}\n        </div>\n      )}\n      <FailureLine>{failure}</FailureLine>\n    </Card>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/notifications/quiet-hours-setting.tsx"],"sourcesContent":["import { useId, useState } from \"react\";\nimport type { ComponentPropsWithRef, ReactNode } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { Card } from \"../components/card\";\nimport { TimeInput } from \"../components/time-input\";\nimport { COMMIT_EXCEPT_BILLING } from \"../components/write-lock\";\nimport { CARD_DESCRIPTION_CLASS } from \"../settings/settings-card-classes\";\nimport { SettingsCardTitle } from \"../settings/settings-heading\";\nimport { settle, useMounted } from \"../account/account-parts\";\nimport { describeFailure, FailureLine, useNotificationsLabels, useWriteOverlay } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\nimport type { NotificationSettingsPatch } from \"./notification-types\";\nimport { zoneName } from \"./time-zone-select\";\n\n/** The zone the server applies while no device ever reported one (§10.3): every app's. */\nconst DEFAULT_FALLBACK_ZONE = \"Europe/Zurich\";\n\nexport interface QuietHoursSettingProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"onChange\"> {\n  /** The `GET`'s `quiet_hours_start`, `\"HH:MM\"`, or `null`. */\n  start: string | null;\n  /** The `GET`'s `quiet_hours_end`. */\n  end: string | null;\n  /** The zone the 0.36 card showed, an IANA name, or `null`.\n   *  @deprecated 0.46 — pass `zone` (§10.3: the zone is the account's, automatic only); removed in 0.47.\n   *  Shown read-only while `zone` is left out; the card no longer offers a picker. */\n  timezone?: string | null;\n  /**\n   * 0.46 (§10.3, amended 2026-10-20: automatic only): the account's zone — `/auth/me`'s\n   * `device_timezone`, the zone of the device last used; `null` while no device has\n   * reported one, and the card then names `fallbackZone`, the zone the server applies.\n   * Shown read-only once a time is set (\"In your time zone (Europe / Zurich), which follows\n   * the device you last used.\"). No picker: the zone is never chosen.\n   */\n  zone?: string | null;\n  /** 0.46 (§10.4): the app queues a held push and sends it when the window ends (it runs\n   *  the notifications tick); the description says so. Default `false`: dropped. */\n  held?: boolean;\n  /**\n   * Save one change — `PATCH /notifications/settings`: a time, or `null` when cleared.\n   * Never a zone. The field shows the new value while the call runs and goes back if it\n   * rejects.\n   */\n  onChange: (patch: NotificationSettingsPatch) => Promise<unknown> | void;\n  /** The zone named while neither `zone` nor `timezone` names one: the one the server\n   *  applies. Default `\"Europe/Zurich\"`, every app's. */\n  fallbackZone?: string;\n  /** The app keeps an inbox, and the description says a held push still reaches it. */\n  inbox?: boolean;\n  disabled?: boolean;\n  /** The app's own words for a failed save, or `undefined` for the kit's `failed`. */\n  describeError?: (error: unknown) => ReactNode | undefined;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\ntype QuietField = \"quiet_hours_start\" | \"quiet_hours_end\";\n\n/**\n * Quiet hours (docs/notifications-harmonization.md §2.4, §2.6, §4.2): a window of local\n * times in the account's zone, which may cross midnight, when no push of a machine-sent\n * type is sent. A held push is dropped — or, with `held` (0.46, §10.4), sent when the\n * window ends; the inbox row and the mail go as usual. keksdose's block, as a card of its\n * own.\n *\n * **0.46 (§10.3, amended 2026-10-20, Marcel): the zone is the account's, automatic\n * only** — the zone of the device last used, else `Europe/Zurich`. The card names it\n * read-only and never sends one; there is no picker and no \"Use it\".\n *\n * - **Two times**, each saved as it is entered; a cleared time sends `null`. While only\n *   one is set the card says so: the window fails open until both are.\n * - **The zone** shows while a time is set: `zone`, else the deprecated `timezone`, else\n *   `fallbackZone`.\n *\n * Under a write lock the fields are `commit` controls exempt from billing.\n */\nexport function QuietHoursSetting({\n  start,\n  end,\n  timezone = null,\n  zone,\n  held = false,\n  onChange,\n  fallbackZone = DEFAULT_FALLBACK_ZONE,\n  inbox = false,\n  disabled = false,\n  describeError,\n  labels: labelsProp,\n  className,\n  ...rest\n}: QuietHoursSettingProps) {\n  const labels = useNotificationsLabels(labelsProp);\n  const overlay = useWriteOverlay<string | null>(`${start}|${end}`);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const mounted = useMounted();\n  const id = useId();\n\n  const shown = (field: QuietField, server: string | null) =>\n    overlay.has(field) ? (overlay.get(field) ?? null) : server;\n  const startShown = shown(\"quiet_hours_start\", start);\n  const endShown = shown(\"quiet_hours_end\", end);\n  const accountZone = (zone === undefined ? timezone : zone) ?? fallbackZone;\n\n  const save = (patch: NotificationSettingsPatch) => {\n    const fields = Object.keys(patch) as QuietField[];\n    setFailure(null);\n    for (const field of fields) overlay.set(field, patch[field] ?? null);\n    settle(() => onChange(patch)).then(\n      () => {\n        if (mounted.current) for (const field of fields) overlay.settle(field, true);\n      },\n      (error: unknown) => {\n        if (!mounted.current) return;\n        for (const field of fields) overlay.settle(field, false);\n        setFailure(describeFailure(describeError?.(error), labels.failed));\n      },\n    );\n  };\n\n  const saveTime = (field: \"quiet_hours_start\" | \"quiet_hours_end\", value: string) => {\n    const next = value || null;\n    if (next === shown(field, field === \"quiet_hours_start\" ? start : end)) return;\n    save({ [field]: next });\n  };\n\n  const anySet = Boolean(startShown || endShown);\n  const halfSet = Boolean(startShown) !== Boolean(endShown);\n\n  return (\n    <Card {...rest} className={cn(\"p-4 space-y-3\", className)}>\n      <div>\n        <SettingsCardTitle>{labels.quietTitle}</SettingsCardTitle>\n        <div className={CARD_DESCRIPTION_CLASS}>{labels.quietDescription(inbox, held)}</div>\n      </div>\n      <div className=\"flex flex-wrap items-end gap-3\">\n        <TimeInput\n          id={`${id}-start`}\n          label={labels.quietFrom}\n          value={startShown ?? \"\"}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onValueChange={(value) => saveTime(\"quiet_hours_start\", value)}\n          className=\"w-36\"\n        />\n        <TimeInput\n          id={`${id}-end`}\n          label={labels.quietUntil}\n          value={endShown ?? \"\"}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onValueChange={(value) => saveTime(\"quiet_hours_end\", value)}\n          className=\"w-36\"\n        />\n      </div>\n      {halfSet && (\n        <p className=\"text-xs text-warning\" data-quiet-incomplete=\"\">\n          {labels.quietIncomplete}\n        </p>\n      )}\n      {anySet && (\n        <p className={CARD_DESCRIPTION_CLASS} data-quiet-zone=\"\">\n          {labels.quietZone(zoneName(accountZone, labels.regions))}\n        </p>\n      )}\n      <FailureLine>{failure}</FailureLine>\n    </Card>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/notifications/time-zone-select.d.ts

@@ -5,8 +5,8 @@ import type { CommitScope } from "../components/write-lock.js";
 import type { NotificationRegionLabels, NotificationsLabels } from "./notifications-labels.js";
 /**
  * This device's IANA zone ("Europe/Zurich"), or `"UTC"` where the runtime names none —
- * the zone quiet hours are entered in the first time (§2.6), and the one the card offers
- * when it differs from the account's.
+ * the zone `useDeviceZoneReport` reports, which becomes the account's (§10.3, automatic
+ * only).
  */
 export declare function deviceTimeZone(): string;
 /**
@@ -17,6 +17,7 @@ export declare function deviceTimeZone(): string;
  * rather than trailing the last group as if it were Pacific. `current` is kept even when
  * the runtime does not list it (an old alias such as "Europe/Kiev"): a picker without its
  * own value would show an empty field.
+ * @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47.
  */
 export declare function timeZoneOptions(current: string, regionLabel: (region: string) => string | undefined): ComboOption<string>[];
 /** The region's name in `regions`, or `undefined` for one the labels do not know.
@@ -25,6 +26,7 @@ export declare function regionName(regions: NotificationRegionLabels, region: st
 /** A zone as the picker shows it, for a sentence: "Europe / Zurich", the region in the
  *  kit's words. @internal Not part of the barrel. */
 export declare function zoneName(zone: string, regions: NotificationRegionLabels): string;
+/** @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47. */
 export interface TimeZoneSelectProps {
     /** The IANA zone. Not clearable: a zone can be changed, never emptied. */
     value: string;
@@ -46,5 +48,6 @@ export interface TimeZoneSelectProps {
  * a search box instead of a 400-row wheel. Rows are the city under its region, the region
  * in the kit's words (`labels.regions`); a zone with no region first; a stored zone the
  * runtime does not list is kept. On the kit's {@link InlineEntityCombobox}.
+ * @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47.
  */
 export declare function TimeZoneSelect({ value, onChange, label, disabled, id, className, commit, labels: labelsProp, }: TimeZoneSelectProps): import("react").JSX.Element;

package/dist/notifications/time-zone-select.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/notifications/time-zone-select.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport type { ComboOption } from \"../components/combobox-core\";\nimport { InlineEntityCombobox } from \"../components/inline-entity-combobox\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport { useNotificationsLabels } from \"./notification-parts\";\nimport type { NotificationRegionLabels, NotificationsLabels } from \"./notifications-labels\";\n\n/**\n * This device's IANA zone (\"Europe/Zurich\"), or `\"UTC\"` where the runtime names none —\n * the zone quiet hours are entered in the first time (§2.6), and the one the card offers\n * when it differs from the account's.\n */\nexport function deviceTimeZone(): string {\n  try {\n    return Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\";\n  } catch {\n    return \"UTC\";\n  }\n}\n\n/** Every zone the runtime lists; `[]` where `Intl.supportedValuesOf` is missing. */\nfunction runtimeZones(): string[] {\n  const intl = Intl as typeof Intl & { supportedValuesOf?: (key: \"timeZone\") => string[] };\n  return typeof intl.supportedValuesOf === \"function\" ? intl.supportedValuesOf(\"timeZone\") : [];\n}\n\n/** \"Argentina/Buenos_Aires\" → \"Argentina / Buenos Aires\": the zone's city, as a row. */\nfunction cityOf(rest: string): string {\n  return rest.replace(/_/g, \" \").replace(/\\//g, \" / \");\n}\n\n/**\n * The zone picker's rows (keksdose `notifications-card.tsx:131-146`): every zone `Intl`\n * lists, as its city (\"Argentina / Buenos Aires\") under its region, the region named by\n * `regionLabel` — which answers `undefined` for a region it does not know, and the region\n * keeps its IANA name. A zone with no region (\"UTC\") comes first, ahead of every heading,\n * rather than trailing the last group as if it were Pacific. `current` is kept even when\n * the runtime does not list it (an old alias such as \"Europe/Kiev\"): a picker without its\n * own value would show an empty field.\n */\nexport function timeZoneOptions(\n  current: string,\n  regionLabel: (region: string) => string | undefined,\n): ComboOption<string>[] {\n  const zones = runtimeZones();\n  const all = !current || zones.includes(current) ? zones : [...zones, current].sort();\n  const rows = all.map((zone): ComboOption<string> => {\n    const slash = zone.indexOf(\"/\");\n    if (slash < 0) return { value: zone, label: zone };\n    const region = zone.slice(0, slash);\n    return { value: zone, label: cityOf(zone.slice(slash + 1)), group: regionLabel(region) ?? region };\n  });\n  return [...rows.filter((row) => !row.group), ...rows.filter((row) => row.group)];\n}\n\n/** The region's name in `regions`, or `undefined` for one the labels do not know.\n *  @internal Not part of the barrel. */\nexport function regionName(regions: NotificationRegionLabels, region: string): string | undefined {\n  return Object.prototype.hasOwnProperty.call(regions, region)\n    ? regions[region as keyof NotificationRegionLabels]\n    : undefined;\n}\n\n/** A zone as the picker shows it, for a sentence: \"Europe / Zurich\", the region in the\n *  kit's words. @internal Not part of the barrel. */\nexport function zoneName(zone: string, regions: NotificationRegionLabels): string {\n  const slash = zone.indexOf(\"/\");\n  if (slash < 0) return zone;\n  const region = zone.slice(0, slash);\n  return `${regionName(regions, region) ?? region} / ${cityOf(zone.slice(slash + 1))}`;\n}\n\nexport interface TimeZoneSelectProps {\n  /** The IANA zone. Not clearable: a zone can be changed, never emptied. */\n  value: string;\n  /** The zone picked. Never called for the value it already has. */\n  onChange: (zone: string) => void;\n  /** Default `labels.timeZone`. */\n  label?: ReactNode;\n  disabled?: boolean;\n  /** The input's id. */\n  id?: string;\n  className?: string;\n  /** The picker SAVES on change (quiet hours do): locked under a write lock in scope. */\n  commit?: CommitScope;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/**\n * An IANA time zone, searchable (docs/notifications-harmonization.md §4.2, keksdose's\n * quiet-hours picker): type \"Zur\" for Europe/Zurich, and on a phone the kit's sheet with\n * a search box instead of a 400-row wheel. Rows are the city under its region, the region\n * in the kit's words (`labels.regions`); a zone with no region first; a stored zone the\n * runtime does not list is kept. On the kit's {@link InlineEntityCombobox}.\n */\nexport function TimeZoneSelect({\n  value,\n  onChange,\n  label,\n  disabled,\n  id,\n  className,\n  commit,\n  labels: labelsProp,\n}: TimeZoneSelectProps) {\n  const labels = useNotificationsLabels(labelsProp);\n  const { regions } = labels;\n  const options = useMemo(() => timeZoneOptions(value, (region) => regionName(regions, region)), [value, regions]);\n  return (\n    <InlineEntityCombobox<string>\n      id={id}\n      label={label ?? labels.timeZone}\n      value={value}\n      options={options}\n      disabled={disabled}\n      commit={commit}\n      onChange={(zone) => {\n        if (zone && zone !== value) onChange(zone);\n      }}\n      className={className}\n    />\n  );\n}\n"],"mappings":";AAgHI;AAhHJ,SAAS,eAAe;AAKxB,SAAS,4BAA4B;AAErC,SAAS,8BAA8B;AAQhC,SAAS,iBAAyB;AACvC,MAAI;AACF,WAAO,KAAK,eAAe,EAAE,gBAAgB,EAAE,YAAY;AAAA,EAC7D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,SAAS,eAAyB;AAChC,QAAM,OAAO;AACb,SAAO,OAAO,KAAK,sBAAsB,aAAa,KAAK,kBAAkB,UAAU,IAAI,CAAC;AAC9F;AAGA,SAAS,OAAO,MAAsB;AACpC,SAAO,KAAK,QAAQ,MAAM,GAAG,EAAE,QAAQ,OAAO,KAAK;AACrD;AAWO,SAAS,gBACd,SACA,aACuB;AACvB,QAAM,QAAQ,aAAa;AAC3B,QAAM,MAAM,CAAC,WAAW,MAAM,SAAS,OAAO,IAAI,QAAQ,CAAC,GAAG,OAAO,OAAO,EAAE,KAAK;AACnF,QAAM,OAAO,IAAI,IAAI,CAAC,SAA8B;AAClD,UAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,QAAI,QAAQ,EAAG,QAAO,EAAE,OAAO,MAAM,OAAO,KAAK;AACjD,UAAM,SAAS,KAAK,MAAM,GAAG,KAAK;AAClC,WAAO,EAAE,OAAO,MAAM,OAAO,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,YAAY,MAAM,KAAK,OAAO;AAAA,EACnG,CAAC;AACD,SAAO,CAAC,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,GAAG,KAAK,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;AACjF;AAIO,SAAS,WAAW,SAAmC,QAAoC;AAChG,SAAO,OAAO,UAAU,eAAe,KAAK,SAAS,MAAM,IACvD,QAAQ,MAAwC,IAChD;AACN;AAIO,SAAS,SAAS,MAAc,SAA2C;AAChF,QAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,MAAI,QAAQ,EAAG,QAAO;AACtB,QAAM,SAAS,KAAK,MAAM,GAAG,KAAK;AAClC,SAAO,GAAG,WAAW,SAAS,MAAM,KAAK,MAAM,MAAM,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC;AACpF;AAyBO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,GAAwB;AACtB,QAAM,SAAS,uBAAuB,UAAU;AAChD,QAAM,EAAE,QAAQ,IAAI;AACpB,QAAM,UAAU,QAAQ,MAAM,gBAAgB,OAAO,CAAC,WAAW,WAAW,SAAS,MAAM,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC;AAC/G,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,OAAO,SAAS,OAAO;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,UAAU,CAAC,SAAS;AAClB,YAAI,QAAQ,SAAS,MAAO,UAAS,IAAI;AAAA,MAC3C;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/notifications/time-zone-select.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport type { ComboOption } from \"../components/combobox-core\";\nimport { InlineEntityCombobox } from \"../components/inline-entity-combobox\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport { useNotificationsLabels } from \"./notification-parts\";\nimport type { NotificationRegionLabels, NotificationsLabels } from \"./notifications-labels\";\n\n/**\n * This device's IANA zone (\"Europe/Zurich\"), or `\"UTC\"` where the runtime names none —\n * the zone `useDeviceZoneReport` reports, which becomes the account's (§10.3, automatic\n * only).\n */\nexport function deviceTimeZone(): string {\n  try {\n    return Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\";\n  } catch {\n    return \"UTC\";\n  }\n}\n\n/** Every zone the runtime lists; `[]` where `Intl.supportedValuesOf` is missing. */\nfunction runtimeZones(): string[] {\n  const intl = Intl as typeof Intl & { supportedValuesOf?: (key: \"timeZone\") => string[] };\n  return typeof intl.supportedValuesOf === \"function\" ? intl.supportedValuesOf(\"timeZone\") : [];\n}\n\n/** \"Argentina/Buenos_Aires\" → \"Argentina / Buenos Aires\": the zone's city, as a row. */\nfunction cityOf(rest: string): string {\n  return rest.replace(/_/g, \" \").replace(/\\//g, \" / \");\n}\n\n/**\n * The zone picker's rows (keksdose `notifications-card.tsx:131-146`): every zone `Intl`\n * lists, as its city (\"Argentina / Buenos Aires\") under its region, the region named by\n * `regionLabel` — which answers `undefined` for a region it does not know, and the region\n * keeps its IANA name. A zone with no region (\"UTC\") comes first, ahead of every heading,\n * rather than trailing the last group as if it were Pacific. `current` is kept even when\n * the runtime does not list it (an old alias such as \"Europe/Kiev\"): a picker without its\n * own value would show an empty field.\n * @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47.\n */\nexport function timeZoneOptions(\n  current: string,\n  regionLabel: (region: string) => string | undefined,\n): ComboOption<string>[] {\n  const zones = runtimeZones();\n  const all = !current || zones.includes(current) ? zones : [...zones, current].sort();\n  const rows = all.map((zone): ComboOption<string> => {\n    const slash = zone.indexOf(\"/\");\n    if (slash < 0) return { value: zone, label: zone };\n    const region = zone.slice(0, slash);\n    return { value: zone, label: cityOf(zone.slice(slash + 1)), group: regionLabel(region) ?? region };\n  });\n  return [...rows.filter((row) => !row.group), ...rows.filter((row) => row.group)];\n}\n\n/** The region's name in `regions`, or `undefined` for one the labels do not know.\n *  @internal Not part of the barrel. */\nexport function regionName(regions: NotificationRegionLabels, region: string): string | undefined {\n  return Object.prototype.hasOwnProperty.call(regions, region)\n    ? regions[region as keyof NotificationRegionLabels]\n    : undefined;\n}\n\n/** A zone as the picker shows it, for a sentence: \"Europe / Zurich\", the region in the\n *  kit's words. @internal Not part of the barrel. */\nexport function zoneName(zone: string, regions: NotificationRegionLabels): string {\n  const slash = zone.indexOf(\"/\");\n  if (slash < 0) return zone;\n  const region = zone.slice(0, slash);\n  return `${regionName(regions, region) ?? region} / ${cityOf(zone.slice(slash + 1))}`;\n}\n\n/** @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47. */\nexport interface TimeZoneSelectProps {\n  /** The IANA zone. Not clearable: a zone can be changed, never emptied. */\n  value: string;\n  /** The zone picked. Never called for the value it already has. */\n  onChange: (zone: string) => void;\n  /** Default `labels.timeZone`. */\n  label?: ReactNode;\n  disabled?: boolean;\n  /** The input's id. */\n  id?: string;\n  className?: string;\n  /** The picker SAVES on change (quiet hours do): locked under a write lock in scope. */\n  commit?: CommitScope;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/**\n * An IANA time zone, searchable (docs/notifications-harmonization.md §4.2, keksdose's\n * quiet-hours picker): type \"Zur\" for Europe/Zurich, and on a phone the kit's sheet with\n * a search box instead of a 400-row wheel. Rows are the city under its region, the region\n * in the kit's words (`labels.regions`); a zone with no region first; a stored zone the\n * runtime does not list is kept. On the kit's {@link InlineEntityCombobox}.\n * @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47.\n */\nexport function TimeZoneSelect({\n  value,\n  onChange,\n  label,\n  disabled,\n  id,\n  className,\n  commit,\n  labels: labelsProp,\n}: TimeZoneSelectProps) {\n  const labels = useNotificationsLabels(labelsProp);\n  const { regions } = labels;\n  const options = useMemo(() => timeZoneOptions(value, (region) => regionName(regions, region)), [value, regions]);\n  return (\n    <InlineEntityCombobox<string>\n      id={id}\n      label={label ?? labels.timeZone}\n      value={value}\n      options={options}\n      disabled={disabled}\n      commit={commit}\n      onChange={(zone) => {\n        if (zone && zone !== value) onChange(zone);\n      }}\n      className={className}\n    />\n  );\n}\n"],"mappings":";AAmHI;AAnHJ,SAAS,eAAe;AAKxB,SAAS,4BAA4B;AAErC,SAAS,8BAA8B;AAQhC,SAAS,iBAAyB;AACvC,MAAI;AACF,WAAO,KAAK,eAAe,EAAE,gBAAgB,EAAE,YAAY;AAAA,EAC7D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,SAAS,eAAyB;AAChC,QAAM,OAAO;AACb,SAAO,OAAO,KAAK,sBAAsB,aAAa,KAAK,kBAAkB,UAAU,IAAI,CAAC;AAC9F;AAGA,SAAS,OAAO,MAAsB;AACpC,SAAO,KAAK,QAAQ,MAAM,GAAG,EAAE,QAAQ,OAAO,KAAK;AACrD;AAYO,SAAS,gBACd,SACA,aACuB;AACvB,QAAM,QAAQ,aAAa;AAC3B,QAAM,MAAM,CAAC,WAAW,MAAM,SAAS,OAAO,IAAI,QAAQ,CAAC,GAAG,OAAO,OAAO,EAAE,KAAK;AACnF,QAAM,OAAO,IAAI,IAAI,CAAC,SAA8B;AAClD,UAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,QAAI,QAAQ,EAAG,QAAO,EAAE,OAAO,MAAM,OAAO,KAAK;AACjD,UAAM,SAAS,KAAK,MAAM,GAAG,KAAK;AAClC,WAAO,EAAE,OAAO,MAAM,OAAO,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,YAAY,MAAM,KAAK,OAAO;AAAA,EACnG,CAAC;AACD,SAAO,CAAC,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,GAAG,KAAK,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;AACjF;AAIO,SAAS,WAAW,SAAmC,QAAoC;AAChG,SAAO,OAAO,UAAU,eAAe,KAAK,SAAS,MAAM,IACvD,QAAQ,MAAwC,IAChD;AACN;AAIO,SAAS,SAAS,MAAc,SAA2C;AAChF,QAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,MAAI,QAAQ,EAAG,QAAO;AACtB,QAAM,SAAS,KAAK,MAAM,GAAG,KAAK;AAClC,SAAO,GAAG,WAAW,SAAS,MAAM,KAAK,MAAM,MAAM,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC;AACpF;AA2BO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,GAAwB;AACtB,QAAM,SAAS,uBAAuB,UAAU;AAChD,QAAM,EAAE,QAAQ,IAAI;AACpB,QAAM,UAAU,QAAQ,MAAM,gBAAgB,OAAO,CAAC,WAAW,WAAW,SAAS,MAAM,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC;AAC/G,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,OAAO,SAAS,OAAO;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,UAAU,CAAC,SAAS;AAClB,YAAI,QAAQ,SAAS,MAAO,UAAS,IAAI;AAAA,MAC3C;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;","names":[]}

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

@@ -1,3 +1,7 @@
+import { PUSH_SUBSCRIPTION_CHANGED } from "./push-worker.js";
+import type { PushSubscriptionInput } from "./push-worker.js";
+export { PUSH_SUBSCRIPTION_CHANGED };
+export type { PushSubscriptionInput };
 /**
  * This browser's Web Push subscription for the signed-in account
  * (docs/notifications-harmonization.md §2.7, §3.5, §4.2) — keksdose's
@@ -21,15 +25,6 @@ export declare class PushDeviceError extends Error {
     readonly code: PushDeviceErrorCode;
     constructor(code: PushDeviceErrorCode);
 }
-/** What `register` sends: `POST /notifications/devices` (§3.5). */
-export interface PushSubscriptionInput {
-    endpoint: string;
-    keys: {
-        p256dh: string;
-        auth: string;
-    };
-    user_agent: string | null;
-}
 export interface UsePushDeviceOptions {
     /** `GET /notifications/push-key` → its `key`; `""` when push is off on the server. */
     pushKey: () => Promise<string>;
@@ -85,14 +80,6 @@ export interface PushDevice {
         sent: number;
     }>;
 }
-/**
- * The window event every mounted {@link usePushDevice} re-reads its state on. Fired by
- * every enable and disable, and by `PushDevicesSetting` when it removes this device — so
- * an app's own card on the same hook (keksdose's check-up) stays in step. The hook that
- * fires it does not re-read: it knows what it changed. Namespaced for the kit;
- * keksdose's was `"keksdose:push-subscription-changed"`.
- */
-export declare const PUSH_SUBSCRIPTION_CHANGED = "eifi1:push-subscription-changed";
 /** Tell every {@link usePushDevice} that this browser's subscription changed. */
 export declare function notifyPushSubscriptionChanged(): void;
 /** Whether this browser has the APIs push needs. iOS exposes them only to an INSTALLED

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

@@ -2,6 +2,7 @@
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useMediaQuery } from "../hooks/use-media-query.js";
 import { httpStatusOf } from "../auth/auth-errors.js";
+import { PUSH_SUBSCRIPTION_CHANGED, keyBytes, pushSubscriptionInput as inputOf } from "./push-worker.js";
 class PushDeviceError extends Error {
   code;
   constructor(code) {
@@ -10,7 +11,6 @@ class PushDeviceError extends Error {
     this.code = code;
   }
 }
-const PUSH_SUBSCRIPTION_CHANGED = "eifi1:push-subscription-changed";
 function notifyPushSubscriptionChanged() {
   if (typeof window !== "undefined") window.dispatchEvent(new Event(PUSH_SUBSCRIPTION_CHANGED));
 }
@@ -38,20 +38,6 @@ async function activeRegistration() {
   if (!existing) throw new PushDeviceError("no_service_worker");
   return within(navigator.serviceWorker.ready, READY_TIMEOUT_MS, "no_service_worker");
 }
-function keyBytes(key) {
-  const base64 = key.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - key.length % 4) % 4);
-  const raw = atob(base64);
-  const bytes = new Uint8Array(new ArrayBuffer(raw.length));
-  for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);
-  return bytes;
-}
-function inputOf(subscription) {
-  const json = subscription.toJSON();
-  const p256dh = json.keys?.p256dh;
-  const auth = json.keys?.auth;
-  if (!json.endpoint || !p256dh || !auth) return null;
-  return { endpoint: json.endpoint, keys: { p256dh, auth }, user_agent: navigator.userAgent || null };
-}
 const defaultEndpointTaken = (error) => httpStatusOf(error) === 409;
 function usePushDevice(options) {
   const latest = useRef(options);
@@ -133,11 +119,17 @@ function usePushDevice(options) {
     const heard = () => {
       if (!announcing.current) void sync();
     };
+    const fromWorker = (event) => {
+      if (event.data?.type === PUSH_SUBSCRIPTION_CHANGED) void sync();
+    };
+    const worker = navigator.serviceWorker;
     void sync();
     window.addEventListener(PUSH_SUBSCRIPTION_CHANGED, heard);
+    worker?.addEventListener?.("message", fromWorker);
     return () => {
       cancelled = true;
       window.removeEventListener(PUSH_SUBSCRIPTION_CHANGED, heard);
+      worker?.removeEventListener?.("message", fromWorker);
     };
   }, [supported]);
   const enable = useCallback(async () => {

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/notifications/use-push-device.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useMediaQuery } from \"../hooks/use-media-query\";\nimport { httpStatusOf } from \"../auth/auth-errors\";\n\n/**\n * This browser's Web Push subscription for the signed-in account\n * (docs/notifications-harmonization.md §2.7, §3.5, §4.2) — keksdose's\n * `shared/push/use-push.ts`, lifted. The service worker with its `push` and\n * `notificationclick` handlers stays the app's; this hook owns the browser's side:\n * permission, subscribe with the server's VAPID key, register the subscription, and\n * unsubscribe. The kit makes no request of its own: the app hands it one function per\n * endpoint.\n */\n\n/** The browser's notification permission, or `\"unsupported\"` where it has no push. */\nexport type PushPermission = NotificationPermission | \"unsupported\";\n\n/** Why turning push on or off could not finish — a {@link PushDeviceError}'s `code`. */\nexport type PushDeviceErrorCode = \"no_service_worker\" | \"push_timeout\";\n\n/**\n * The two failures the card has words of its own for: no service worker registered (or\n * one not ready in 10 s) — \"reload and try again\" — and a browser push service that did\n * not answer in 15 s — \"check your connection\". Anything else is the app's request\n * failing, rejected as it came.\n */\nexport class PushDeviceError extends Error {\n  readonly code: PushDeviceErrorCode;\n  constructor(code: PushDeviceErrorCode) {\n    super(code);\n    this.name = \"PushDeviceError\";\n    this.code = code;\n  }\n}\n\n/** What `register` sends: `POST /notifications/devices` (§3.5). */\nexport interface PushSubscriptionInput {\n  endpoint: string;\n  keys: { p256dh: string; auth: string };\n  user_agent: string | null;\n}\n\nexport interface UsePushDeviceOptions {\n  /** `GET /notifications/push-key` → its `key`; `\"\"` when push is off on the server. */\n  pushKey: () => Promise<string>;\n  /** `POST /notifications/devices`. A 409 (another account's endpoint) is recovered\n   *  once: the hook unsubscribes and registers a fresh endpoint. */\n  register: (subscription: PushSubscriptionInput) => Promise<unknown>;\n  /** `POST /notifications/devices/unregister {endpoint}` — the endpoint never goes in a\n   *  URL. */\n  unregister: (endpoint: string) => Promise<unknown>;\n  /** `GET /notifications/devices`: the account's own list, which says whether THIS\n   *  account holds this browser's subscription. */\n  devices: () => Promise<readonly { endpoint: string }[]>;\n  /** `POST /notifications/test` → how many devices the push service accepted it for. */\n  test: () => Promise<{ sent: number }>;\n  /** Whether `register` refused another account's endpoint. Default: HTTP 409. */\n  isEndpointTaken?: (error: unknown) => boolean;\n  /** After an enable or a disable: the app refreshes its device queries. */\n  onChange?: () => void;\n}\n\n/** What {@link usePushDevice} answers. */\nexport interface PushDevice {\n  /** The browser exposes service workers, `PushManager` and `Notification`. */\n  supported: boolean;\n  /** The server has VAPID keys; `undefined` until `pushKey` answered (or when it failed). */\n  configured: boolean | undefined;\n  /** Running as an installed app: `display-mode: standalone`, or iOS's\n   *  `navigator.standalone`. */\n  installed: boolean;\n  /** iPhone or iPad — where push reaches only the installed app. */\n  ios: boolean;\n  permission: PushPermission;\n  /** THIS account holds this browser's subscription. An unreachable device list falls\n   *  back to the browser's own answer. */\n  subscribed: boolean;\n  /** This browser holds a subscription that belongs to another account (two accounts in\n   *  one browser profile): `subscribed` is false, and turning on mints a fresh one. */\n  foreignSubscription: boolean;\n  /** This browser's subscription endpoint, or `null` — marks \"This device\" in a list. */\n  currentEndpoint: string | null;\n  /** An enable or a disable is running. */\n  busy: boolean;\n  /** Ask for permission (the browser's one prompt), subscribe and register. `false` when\n   *  the permission was not granted or push is off on the server; rejects with a\n   *  {@link PushDeviceError} or the app's request's error. */\n  enable: () => Promise<boolean>;\n  /** Tell the server first, then the browser, so a dropped device stops at once. */\n  disable: () => Promise<void>;\n  sendTest: () => Promise<{ sent: number }>;\n}\n\n/**\n * The window event every mounted {@link usePushDevice} re-reads its state on. Fired by\n * every enable and disable, and by `PushDevicesSetting` when it removes this device — so\n * an app's own card on the same hook (keksdose's check-up) stays in step. The hook that\n * fires it does not re-read: it knows what it changed. Namespaced for the kit;\n * keksdose's was `\"keksdose:push-subscription-changed\"`.\n */\nexport const PUSH_SUBSCRIPTION_CHANGED = \"eifi1:push-subscription-changed\";\n\n/** Tell every {@link usePushDevice} that this browser's subscription changed. */\nexport function notifyPushSubscriptionChanged(): void {\n  if (typeof window !== \"undefined\") window.dispatchEvent(new Event(PUSH_SUBSCRIPTION_CHANGED));\n}\n\n/** Whether this browser has the APIs push needs. iOS exposes them only to an INSTALLED\n *  app (Add to Home Screen). */\nexport function pushSupported(): boolean {\n  return (\n    typeof window !== \"undefined\" &&\n    typeof navigator !== \"undefined\" &&\n    \"serviceWorker\" in navigator &&\n    \"PushManager\" in window &&\n    \"Notification\" in window\n  );\n}\n\n/** iPhone or iPad. iPadOS 13+ reports itself as a Mac; the touch points tell it apart. */\nfunction isIos(): boolean {\n  if (typeof navigator === \"undefined\") return false;\n  const ua = navigator.userAgent;\n  return /iphone|ipad|ipod/i.test(ua) || (/Macintosh/.test(ua) && navigator.maxTouchPoints > 1);\n}\n\nconst READY_TIMEOUT_MS = 10_000;\nconst PUSH_TIMEOUT_MS = 15_000;\n\n/** `promise`, or a {@link PushDeviceError} after `ms`. The timer is cleared either way. */\nfunction within<T>(promise: Promise<T>, ms: number, code: PushDeviceErrorCode): Promise<T> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  return Promise.race([\n    promise,\n    new Promise<never>((_, reject) => {\n      timer = setTimeout(() => reject(new PushDeviceError(code)), ms);\n    }),\n  ]).finally(() => clearTimeout(timer));\n}\n\n/**\n * The active registration. `navigator.serviceWorker.ready` never settles while the origin\n * has no registration, so a missing one fails at once, and one stuck installing fails\n * after 10 s (keksdose: enable() hung with the button latched before its worker was\n * served).\n */\nasync function activeRegistration(): Promise<ServiceWorkerRegistration> {\n  const existing = await navigator.serviceWorker.getRegistration();\n  if (!existing) throw new PushDeviceError(\"no_service_worker\");\n  return within(navigator.serviceWorker.ready, READY_TIMEOUT_MS, \"no_service_worker\");\n}\n\n/** A VAPID public key (base64url) as the bytes `PushManager.subscribe` wants. */\nfunction keyBytes(key: string): Uint8Array<ArrayBuffer> {\n  const base64 = key.replace(/-/g, \"+\").replace(/_/g, \"/\") + \"=\".repeat((4 - (key.length % 4)) % 4);\n  const raw = atob(base64);\n  const bytes = new Uint8Array(new ArrayBuffer(raw.length));\n  for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);\n  return bytes;\n}\n\n/** A subscription's register body, or `null` when the browser handed back an incomplete\n *  one. */\nfunction inputOf(subscription: PushSubscription): PushSubscriptionInput | null {\n  const json = subscription.toJSON();\n  const p256dh = json.keys?.p256dh;\n  const auth = json.keys?.auth;\n  if (!json.endpoint || !p256dh || !auth) return null;\n  return { endpoint: json.endpoint, keys: { p256dh, auth }, user_agent: navigator.userAgent || null };\n}\n\nconst defaultEndpointTaken = (error: unknown) => httpStatusOf(error) === 409;\n\n/**\n * This browser's push for the signed-in account. Hand it one function per endpoint\n * (§3.8); {@link PushDeviceSetting} draws it, and an app's own card may use it too.\n *\n * **\"Subscribed\" means this account**, not \"this browser holds a subscription\": a\n * browser profile's subscription has no account in it, so a second account in the same\n * profile would read the first's as its own (keksdose). The endpoint is checked against\n * the account's own `devices()`; when that list cannot be read (offline), the browser's\n * answer stands — a wrong \"on\" costs what it did before the check, a wrong \"off\" invites\n * re-subscribing a device that is fine.\n *\n * **A 409 from `register`** — the endpoint belongs to another account, and the server\n * will not re-home what it cannot prove this browser holds — unsubscribes and registers\n * a fresh endpoint, once.\n *\n * **Timeouts:** no registration fails at once and a worker not ready in 10 s fails, both\n * `PushDeviceError(\"no_service_worker\")`; the browser's subscribe and unsubscribe are cut\n * at 15 s, `PushDeviceError(\"push_timeout\")` — so `busy` can never latch.\n *\n * Every mounted hook re-reads its state on {@link PUSH_SUBSCRIPTION_CHANGED}.\n */\nexport function usePushDevice(options: UsePushDeviceOptions): PushDevice {\n  // The app's functions are usually new on every render; the effects read the latest.\n  const latest = useRef(options);\n  useEffect(() => {\n    latest.current = options;\n  });\n\n  const supported = pushSupported();\n  const ios = isIos();\n  const standalone = useMediaQuery(\"(display-mode: standalone)\", false);\n  const installed =\n    standalone ||\n    (typeof navigator !== \"undefined\" && (navigator as Navigator & { standalone?: boolean }).standalone === true);\n\n  const [permission, setPermission] = useState<PushPermission>(() =>\n    supported ? Notification.permission : \"unsupported\",\n  );\n  const [configured, setConfigured] = useState<boolean | undefined>(undefined);\n  const [subscribed, setSubscribed] = useState(false);\n  const [foreignSubscription, setForeignSubscription] = useState(false);\n  const [currentEndpoint, setCurrentEndpoint] = useState<string | null>(null);\n  const [busy, setBusy] = useState(false);\n  const mounted = useRef(true);\n  // Set while this hook fires the event itself: it already knows what changed, and a\n  // re-read could only be worse — an app whose `devices()` answers from a cache would\n  // hand back the list from before the change.\n  const announcing = useRef(false);\n  const announce = useCallback(() => {\n    announcing.current = true;\n    try {\n      notifyPushSubscriptionChanged();\n    } finally {\n      announcing.current = false;\n    }\n    latest.current.onChange?.();\n  }, []);\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n\n  // Whether the server has keys (\"\" → push is off there). Once per mount.\n  useEffect(() => {\n    if (!supported) return;\n    let cancelled = false;\n    latest.current.pushKey().then(\n      (key) => {\n        if (!cancelled) setConfigured(key !== \"\");\n      },\n      () => {\n        /* unknown: the card shows the ordinary states */\n      },\n    );\n    return () => {\n      cancelled = true;\n    };\n  }, [supported]);\n\n  // What this browser holds, and whether it is this account's — at mount, and whenever\n  // a subscription changes anywhere in the app.\n  useEffect(() => {\n    if (!supported) return;\n    let cancelled = false;\n    const sync = async () => {\n      try {\n        const registration = await activeRegistration();\n        const existing = await registration.pushManager.getSubscription();\n        if (cancelled) return;\n        // Read again: the person may have changed it in the browser's settings.\n        setPermission(Notification.permission);\n        if (!existing) {\n          setSubscribed(false);\n          setForeignSubscription(false);\n          setCurrentEndpoint(null);\n          return;\n        }\n        let mine: boolean;\n        try {\n          const devices = await latest.current.devices();\n          mine = devices.some((device) => device.endpoint === existing.endpoint);\n        } catch {\n          mine = true;\n        }\n        if (cancelled) return;\n        setCurrentEndpoint(existing.endpoint);\n        setSubscribed(mine);\n        setForeignSubscription(!mine);\n      } catch {\n        /* no active service worker yet: not subscribed */\n      }\n    };\n    const heard = () => {\n      if (!announcing.current) void sync();\n    };\n    void sync();\n    window.addEventListener(PUSH_SUBSCRIPTION_CHANGED, heard);\n    return () => {\n      cancelled = true;\n      window.removeEventListener(PUSH_SUBSCRIPTION_CHANGED, heard);\n    };\n  }, [supported]);\n\n  const enable = useCallback(async (): Promise<boolean> => {\n    if (!supported) return false;\n    const { pushKey, register, isEndpointTaken = defaultEndpointTaken } = latest.current;\n    setBusy(true);\n    try {\n      const granted = await Notification.requestPermission();\n      if (mounted.current) setPermission(granted);\n      if (granted !== \"granted\") return false;\n\n      const key = await pushKey();\n      if (!key) {\n        if (mounted.current) setConfigured(false);\n        return false;\n      }\n      if (mounted.current) setConfigured(true);\n\n      const registration = await activeRegistration();\n      // The one place the browser is asked for a subscription, so the timeout and the\n      // `{userVisibleOnly, applicationServerKey}` literal are on both paths.\n      const subscribe = (reuse: boolean) =>\n        within(\n          (async () =>\n            (reuse ? await registration.pushManager.getSubscription() : null) ??\n            (await registration.pushManager.subscribe({ userVisibleOnly: true, applicationServerKey: keyBytes(key) })))(),\n          PUSH_TIMEOUT_MS,\n          \"push_timeout\",\n        );\n\n      let subscription = await subscribe(true);\n      let input = inputOf(subscription);\n      if (!input) return false;\n      try {\n        await register(input);\n      } catch (error) {\n        if (!isEndpointTaken(error)) throw error;\n        await within(subscription.unsubscribe(), PUSH_TIMEOUT_MS, \"push_timeout\");\n        subscription = await subscribe(false);\n        input = inputOf(subscription);\n        if (!input) return false;\n        await register(input);\n      }\n      if (mounted.current) {\n        setSubscribed(true);\n        setForeignSubscription(false);\n        setCurrentEndpoint(input.endpoint);\n      }\n      announce();\n      return true;\n    } finally {\n      if (mounted.current) setBusy(false);\n    }\n  }, [supported, announce]);\n\n  const disable = useCallback(async (): Promise<void> => {\n    if (!supported) return;\n    setBusy(true);\n    try {\n      const registration = await activeRegistration();\n      const subscription = await registration.pushManager.getSubscription();\n      if (subscription) {\n        // The server first: a dropped device stops receiving even if the browser's\n        // unsubscribe below fails.\n        await latest.current.unregister(subscription.endpoint);\n        await within(subscription.unsubscribe(), PUSH_TIMEOUT_MS, \"push_timeout\");\n      }\n      if (mounted.current) {\n        setSubscribed(false);\n        setForeignSubscription(false);\n        setCurrentEndpoint(null);\n      }\n      announce();\n    } finally {\n      if (mounted.current) setBusy(false);\n    }\n  }, [supported, announce]);\n\n  const sendTest = useCallback(() => latest.current.test(), []);\n\n  return {\n    supported,\n    configured,\n    installed,\n    ios,\n    permission,\n    subscribed,\n    foreignSubscription,\n    currentEndpoint,\n    busy,\n    enable,\n    disable,\n    sendTest,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/notifications/use-push-device.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useMediaQuery } from \"../hooks/use-media-query\";\nimport { httpStatusOf } from \"../auth/auth-errors\";\nimport { PUSH_SUBSCRIPTION_CHANGED, keyBytes, pushSubscriptionInput as inputOf } from \"./push-worker\";\nimport type { PushSubscriptionInput } from \"./push-worker\";\n\nexport { PUSH_SUBSCRIPTION_CHANGED };\nexport type { PushSubscriptionInput };\n\n/**\n * This browser's Web Push subscription for the signed-in account\n * (docs/notifications-harmonization.md §2.7, §3.5, §4.2) — keksdose's\n * `shared/push/use-push.ts`, lifted. The service worker with its `push` and\n * `notificationclick` handlers stays the app's; this hook owns the browser's side:\n * permission, subscribe with the server's VAPID key, register the subscription, and\n * unsubscribe. The kit makes no request of its own: the app hands it one function per\n * endpoint.\n */\n\n/** The browser's notification permission, or `\"unsupported\"` where it has no push. */\nexport type PushPermission = NotificationPermission | \"unsupported\";\n\n/** Why turning push on or off could not finish — a {@link PushDeviceError}'s `code`. */\nexport type PushDeviceErrorCode = \"no_service_worker\" | \"push_timeout\";\n\n/**\n * The two failures the card has words of its own for: no service worker registered (or\n * one not ready in 10 s) — \"reload and try again\" — and a browser push service that did\n * not answer in 15 s — \"check your connection\". Anything else is the app's request\n * failing, rejected as it came.\n */\nexport class PushDeviceError extends Error {\n  readonly code: PushDeviceErrorCode;\n  constructor(code: PushDeviceErrorCode) {\n    super(code);\n    this.name = \"PushDeviceError\";\n    this.code = code;\n  }\n}\n\nexport interface UsePushDeviceOptions {\n  /** `GET /notifications/push-key` → its `key`; `\"\"` when push is off on the server. */\n  pushKey: () => Promise<string>;\n  /** `POST /notifications/devices`. A 409 (another account's endpoint) is recovered\n   *  once: the hook unsubscribes and registers a fresh endpoint. */\n  register: (subscription: PushSubscriptionInput) => Promise<unknown>;\n  /** `POST /notifications/devices/unregister {endpoint}` — the endpoint never goes in a\n   *  URL. */\n  unregister: (endpoint: string) => Promise<unknown>;\n  /** `GET /notifications/devices`: the account's own list, which says whether THIS\n   *  account holds this browser's subscription. */\n  devices: () => Promise<readonly { endpoint: string }[]>;\n  /** `POST /notifications/test` → how many devices the push service accepted it for. */\n  test: () => Promise<{ sent: number }>;\n  /** Whether `register` refused another account's endpoint. Default: HTTP 409. */\n  isEndpointTaken?: (error: unknown) => boolean;\n  /** After an enable or a disable: the app refreshes its device queries. */\n  onChange?: () => void;\n}\n\n/** What {@link usePushDevice} answers. */\nexport interface PushDevice {\n  /** The browser exposes service workers, `PushManager` and `Notification`. */\n  supported: boolean;\n  /** The server has VAPID keys; `undefined` until `pushKey` answered (or when it failed). */\n  configured: boolean | undefined;\n  /** Running as an installed app: `display-mode: standalone`, or iOS's\n   *  `navigator.standalone`. */\n  installed: boolean;\n  /** iPhone or iPad — where push reaches only the installed app. */\n  ios: boolean;\n  permission: PushPermission;\n  /** THIS account holds this browser's subscription. An unreachable device list falls\n   *  back to the browser's own answer. */\n  subscribed: boolean;\n  /** This browser holds a subscription that belongs to another account (two accounts in\n   *  one browser profile): `subscribed` is false, and turning on mints a fresh one. */\n  foreignSubscription: boolean;\n  /** This browser's subscription endpoint, or `null` — marks \"This device\" in a list. */\n  currentEndpoint: string | null;\n  /** An enable or a disable is running. */\n  busy: boolean;\n  /** Ask for permission (the browser's one prompt), subscribe and register. `false` when\n   *  the permission was not granted or push is off on the server; rejects with a\n   *  {@link PushDeviceError} or the app's request's error. */\n  enable: () => Promise<boolean>;\n  /** Tell the server first, then the browser, so a dropped device stops at once. */\n  disable: () => Promise<void>;\n  sendTest: () => Promise<{ sent: number }>;\n}\n\n/*\n * PUSH_SUBSCRIPTION_CHANGED (push-worker.ts): the window event every mounted\n * {@link usePushDevice} re-reads its state on. Fired by every enable and disable, and by\n * `PushDevicesSetting` when it removes this device — so an app's own card on the same\n * hook (keksdose's check-up) stays in step. The hook that fires it does not re-read: it\n * knows what it changed. Since 0.46 also the message a service worker posts after a\n * rotated subscription was re-registered (`handlePushSubscriptionChange`). Namespaced\n * for the kit; keksdose's was `\"keksdose:push-subscription-changed\"`.\n */\n\n/** Tell every {@link usePushDevice} that this browser's subscription changed. */\nexport function notifyPushSubscriptionChanged(): void {\n  if (typeof window !== \"undefined\") window.dispatchEvent(new Event(PUSH_SUBSCRIPTION_CHANGED));\n}\n\n/** Whether this browser has the APIs push needs. iOS exposes them only to an INSTALLED\n *  app (Add to Home Screen). */\nexport function pushSupported(): boolean {\n  return (\n    typeof window !== \"undefined\" &&\n    typeof navigator !== \"undefined\" &&\n    \"serviceWorker\" in navigator &&\n    \"PushManager\" in window &&\n    \"Notification\" in window\n  );\n}\n\n/** iPhone or iPad. iPadOS 13+ reports itself as a Mac; the touch points tell it apart. */\nfunction isIos(): boolean {\n  if (typeof navigator === \"undefined\") return false;\n  const ua = navigator.userAgent;\n  return /iphone|ipad|ipod/i.test(ua) || (/Macintosh/.test(ua) && navigator.maxTouchPoints > 1);\n}\n\nconst READY_TIMEOUT_MS = 10_000;\nconst PUSH_TIMEOUT_MS = 15_000;\n\n/** `promise`, or a {@link PushDeviceError} after `ms`. The timer is cleared either way. */\nfunction within<T>(promise: Promise<T>, ms: number, code: PushDeviceErrorCode): Promise<T> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  return Promise.race([\n    promise,\n    new Promise<never>((_, reject) => {\n      timer = setTimeout(() => reject(new PushDeviceError(code)), ms);\n    }),\n  ]).finally(() => clearTimeout(timer));\n}\n\n/**\n * The active registration. `navigator.serviceWorker.ready` never settles while the origin\n * has no registration, so a missing one fails at once, and one stuck installing fails\n * after 10 s (keksdose: enable() hung with the button latched before its worker was\n * served).\n */\nasync function activeRegistration(): Promise<ServiceWorkerRegistration> {\n  const existing = await navigator.serviceWorker.getRegistration();\n  if (!existing) throw new PushDeviceError(\"no_service_worker\");\n  return within(navigator.serviceWorker.ready, READY_TIMEOUT_MS, \"no_service_worker\");\n}\n\nconst defaultEndpointTaken = (error: unknown) => httpStatusOf(error) === 409;\n\n/**\n * This browser's push for the signed-in account. Hand it one function per endpoint\n * (§3.8); {@link PushDeviceSetting} draws it, and an app's own card may use it too.\n *\n * **\"Subscribed\" means this account**, not \"this browser holds a subscription\": a\n * browser profile's subscription has no account in it, so a second account in the same\n * profile would read the first's as its own (keksdose). The endpoint is checked against\n * the account's own `devices()`; when that list cannot be read (offline), the browser's\n * answer stands — a wrong \"on\" costs what it did before the check, a wrong \"off\" invites\n * re-subscribing a device that is fine.\n *\n * **A 409 from `register`** — the endpoint belongs to another account, and the server\n * will not re-home what it cannot prove this browser holds — unsubscribes and registers\n * a fresh endpoint, once.\n *\n * **Timeouts:** no registration fails at once and a worker not ready in 10 s fails, both\n * `PushDeviceError(\"no_service_worker\")`; the browser's subscribe and unsubscribe are cut\n * at 15 s, `PushDeviceError(\"push_timeout\")` — so `busy` can never latch.\n *\n * Every mounted hook re-reads its state on {@link PUSH_SUBSCRIPTION_CHANGED}.\n */\nexport function usePushDevice(options: UsePushDeviceOptions): PushDevice {\n  // The app's functions are usually new on every render; the effects read the latest.\n  const latest = useRef(options);\n  useEffect(() => {\n    latest.current = options;\n  });\n\n  const supported = pushSupported();\n  const ios = isIos();\n  const standalone = useMediaQuery(\"(display-mode: standalone)\", false);\n  const installed =\n    standalone ||\n    (typeof navigator !== \"undefined\" && (navigator as Navigator & { standalone?: boolean }).standalone === true);\n\n  const [permission, setPermission] = useState<PushPermission>(() =>\n    supported ? Notification.permission : \"unsupported\",\n  );\n  const [configured, setConfigured] = useState<boolean | undefined>(undefined);\n  const [subscribed, setSubscribed] = useState(false);\n  const [foreignSubscription, setForeignSubscription] = useState(false);\n  const [currentEndpoint, setCurrentEndpoint] = useState<string | null>(null);\n  const [busy, setBusy] = useState(false);\n  const mounted = useRef(true);\n  // Set while this hook fires the event itself: it already knows what changed, and a\n  // re-read could only be worse — an app whose `devices()` answers from a cache would\n  // hand back the list from before the change.\n  const announcing = useRef(false);\n  const announce = useCallback(() => {\n    announcing.current = true;\n    try {\n      notifyPushSubscriptionChanged();\n    } finally {\n      announcing.current = false;\n    }\n    latest.current.onChange?.();\n  }, []);\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n\n  // Whether the server has keys (\"\" → push is off there). Once per mount.\n  useEffect(() => {\n    if (!supported) return;\n    let cancelled = false;\n    latest.current.pushKey().then(\n      (key) => {\n        if (!cancelled) setConfigured(key !== \"\");\n      },\n      () => {\n        /* unknown: the card shows the ordinary states */\n      },\n    );\n    return () => {\n      cancelled = true;\n    };\n  }, [supported]);\n\n  // What this browser holds, and whether it is this account's — at mount, and whenever\n  // a subscription changes anywhere in the app.\n  useEffect(() => {\n    if (!supported) return;\n    let cancelled = false;\n    const sync = async () => {\n      try {\n        const registration = await activeRegistration();\n        const existing = await registration.pushManager.getSubscription();\n        if (cancelled) return;\n        // Read again: the person may have changed it in the browser's settings.\n        setPermission(Notification.permission);\n        if (!existing) {\n          setSubscribed(false);\n          setForeignSubscription(false);\n          setCurrentEndpoint(null);\n          return;\n        }\n        let mine: boolean;\n        try {\n          const devices = await latest.current.devices();\n          mine = devices.some((device) => device.endpoint === existing.endpoint);\n        } catch {\n          mine = true;\n        }\n        if (cancelled) return;\n        setCurrentEndpoint(existing.endpoint);\n        setSubscribed(mine);\n        setForeignSubscription(!mine);\n      } catch {\n        /* no active service worker yet: not subscribed */\n      }\n    };\n    const heard = () => {\n      if (!announcing.current) void sync();\n    };\n    // The worker's word after it re-registered a rotated subscription (0.46).\n    const fromWorker = (event: MessageEvent) => {\n      if ((event.data as { type?: unknown } | null)?.type === PUSH_SUBSCRIPTION_CHANGED) void sync();\n    };\n    const worker = navigator.serviceWorker as ServiceWorkerContainer | undefined;\n    void sync();\n    window.addEventListener(PUSH_SUBSCRIPTION_CHANGED, heard);\n    worker?.addEventListener?.(\"message\", fromWorker);\n    return () => {\n      cancelled = true;\n      window.removeEventListener(PUSH_SUBSCRIPTION_CHANGED, heard);\n      worker?.removeEventListener?.(\"message\", fromWorker);\n    };\n  }, [supported]);\n\n  const enable = useCallback(async (): Promise<boolean> => {\n    if (!supported) return false;\n    const { pushKey, register, isEndpointTaken = defaultEndpointTaken } = latest.current;\n    setBusy(true);\n    try {\n      const granted = await Notification.requestPermission();\n      if (mounted.current) setPermission(granted);\n      if (granted !== \"granted\") return false;\n\n      const key = await pushKey();\n      if (!key) {\n        if (mounted.current) setConfigured(false);\n        return false;\n      }\n      if (mounted.current) setConfigured(true);\n\n      const registration = await activeRegistration();\n      // The one place the browser is asked for a subscription, so the timeout and the\n      // `{userVisibleOnly, applicationServerKey}` literal are on both paths.\n      const subscribe = (reuse: boolean) =>\n        within(\n          (async () =>\n            (reuse ? await registration.pushManager.getSubscription() : null) ??\n            (await registration.pushManager.subscribe({ userVisibleOnly: true, applicationServerKey: keyBytes(key) })))(),\n          PUSH_TIMEOUT_MS,\n          \"push_timeout\",\n        );\n\n      let subscription = await subscribe(true);\n      let input = inputOf(subscription);\n      if (!input) return false;\n      try {\n        await register(input);\n      } catch (error) {\n        if (!isEndpointTaken(error)) throw error;\n        await within(subscription.unsubscribe(), PUSH_TIMEOUT_MS, \"push_timeout\");\n        subscription = await subscribe(false);\n        input = inputOf(subscription);\n        if (!input) return false;\n        await register(input);\n      }\n      if (mounted.current) {\n        setSubscribed(true);\n        setForeignSubscription(false);\n        setCurrentEndpoint(input.endpoint);\n      }\n      announce();\n      return true;\n    } finally {\n      if (mounted.current) setBusy(false);\n    }\n  }, [supported, announce]);\n\n  const disable = useCallback(async (): Promise<void> => {\n    if (!supported) return;\n    setBusy(true);\n    try {\n      const registration = await activeRegistration();\n      const subscription = await registration.pushManager.getSubscription();\n      if (subscription) {\n        // The server first: a dropped device stops receiving even if the browser's\n        // unsubscribe below fails.\n        await latest.current.unregister(subscription.endpoint);\n        await within(subscription.unsubscribe(), PUSH_TIMEOUT_MS, \"push_timeout\");\n      }\n      if (mounted.current) {\n        setSubscribed(false);\n        setForeignSubscription(false);\n        setCurrentEndpoint(null);\n      }\n      announce();\n    } finally {\n      if (mounted.current) setBusy(false);\n    }\n  }, [supported, announce]);\n\n  const sendTest = useCallback(() => latest.current.test(), []);\n\n  return {\n    supported,\n    configured,\n    installed,\n    ios,\n    permission,\n    subscribed,\n    foreignSubscription,\n    currentEndpoint,\n    busy,\n    enable,\n    disable,\n    sendTest,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/offline/local-first.d.ts

@@ -0,0 +1,33 @@
+/**
+ * An `updated_at` that wins Last-Write-Wins over `previous`: now, or one millisecond past
+ * `previous` when that is not behind this clock (keksdose's sync-client.ts:639-643).
+ *
+ * `/sync` keeps the server's row when it is STRICTLY newer, comparing this device's clock
+ * with the server's. A row the server just wrote carries the server's time, so an edit
+ * stamped by a clock a second slow would lose and come straight back. The millisecond is
+ * enough although the server keeps microseconds: `Date.parse` truncates them.
+ */
+export declare function stampAfter(previous: unknown): string;
+/**
+ * The connection, not the server, failed: the request had no answer (an axios-like error
+ * without `response`, or `fetch`'s `TypeError`), or the session refresh marked a 401 as
+ * passing because the server was out of reach ({@link isTransientRefreshFailure}). A real
+ * HTTP answer — a 4xx or a 5xx — is never offline: the caller must see it.
+ */
+export declare function isOfflineError(err: unknown): boolean;
+/**
+ * Read from the server, and from the device's copy only when the connection failed
+ * ({@link isOfflineError}); a 4xx or 5xx still throws. `onOnline` gets the server's answer
+ * before it is returned (to refresh the copy, say); a throw from it counts as a failure of
+ * the online path. The plain form of keksdose's net.ts:58, without its sealed-household
+ * and cold-start branches (those stay keksdose's).
+ */
+export declare function readLocalFirst<T>(online: () => Promise<T>, offline: () => Promise<T>, onOnline?: (result: T) => void | Promise<void>): Promise<T>;
+/**
+ * Write through the server first (`rest`), and queue the change on the device (`queue`)
+ * only when the connection failed; any other failure throws, nothing queued. Online writes
+ * stay server-stamped (D2). A create mints its id BEFORE calling this and sends it on both
+ * paths, so a REST create that timed out after the server applied it is not created twice
+ * (D16).
+ */
+export declare function writeLocalFirst<T>(rest: () => Promise<T>, queue: () => Promise<T>): Promise<T>;