@eifi1/ui-kit 0.32.2 → 0.33.0

package/dist/billing/checkout-processing.d.ts

@@ -0,0 +1,217 @@
+import { DateInput } from '../lib/format.js';
+import { BillingStanding } from './billing-standing.js';
+import '../delete-account-setting-DiPX4Vue.js';
+import 'react';
+import '../components/tooltip.js';
+import '../hooks/use-anchored-rect.js';
+import '../lib/clipping.js';
+import '../data-table-labels-BJ5JE_X2.js';
+import '../components/data-table-sort.js';
+import '../components/swipeable-row.js';
+import '../components/status-dot.js';
+import '../components/progress-bar.js';
+import '../components/signed-amount.js';
+import '../components/stat-tile.js';
+import '../components/chip.js';
+import 'lucide-react';
+import '../components/field-parts.js';
+import '../components/write-lock.js';
+import '../components/mini-calendar.js';
+import '../components/calendar-heatmap.js';
+import '../components/popover.js';
+import '../hooks/use-breakpoint.js';
+import '../components/field-sync.js';
+import '../wizard/types.js';
+import '../tour/tour.js';
+import '../search/command-palette.js';
+import '../search/global-search.js';
+import '../search/search-index.js';
+import '../components/month-picker.js';
+import '../components/page-contents.js';
+import '../components/series-chart-labels.js';
+import '../components/pie-chart-labels.js';
+import '../components/sparkline.js';
+import '../components/signature-pad.js';
+import '../components/password-strength.js';
+import '../components/swatch-picker.js';
+import '../components/tile-radio.js';
+import '../components/icon-picker.js';
+import '../components/dialog-frame.js';
+import '../components/modal.js';
+import '../hooks/use-search-param-state.js';
+import '../components/measured-grid.js';
+import '../components/user-avatar.js';
+import '../lib/person-name.js';
+import '../shell/topbar-action-menu.js';
+import '../components/menu-item.js';
+import '../components/floating-panel.js';
+import '../hooks/use-authed-src.js';
+import '../components/account-settings-labels.js';
+import '../components/bulk-action-bar.js';
+import '../components/list.js';
+import '../components/breadcrumbs.js';
+import '../components/toast.js';
+import '../components/description-list.js';
+import '../components/line-items.js';
+import '../components/error-boundary.js';
+import '../components/authed-image.js';
+import '../components/image-grid.js';
+import '../components/lightbox.js';
+import '../auth/sign-in-form.js';
+import '../landing/access.js';
+import '../landing/landing-labels.js';
+import '../shell/topbar-controls.js';
+import '../theme/palette-presets.js';
+import '../theme/chart-palette.js';
+import '../theme/theme-store.js';
+import 'zustand/middleware';
+import 'zustand';
+import '../auth/complete-name-dialog.js';
+import '../auth/forgot-password-form.js';
+import '../auth/status-parts.js';
+import '../auth/reset-password-form.js';
+import '../auth/verify-email.js';
+import '../auth/not-found-page.js';
+import '../auth/accept-invitation.js';
+import '../shell/company-switcher.js';
+import '../account/email-change-setting.js';
+import '../account/sessions-setting.js';
+import '../account/data-export-setting.js';
+import '../components/account-chips.js';
+import '../admin/admin-parts.js';
+import '../admin/admin-action-log.js';
+import '../settings/settings-labels.js';
+import '../demo/demo-labels.js';
+import '../components/appearance-labels.js';
+import '../theme/contrast.js';
+import '../theme/text-size.js';
+import '../components/reauth-dialog.js';
+import '../components/server-wake.js';
+import '../lib/server-wake.js';
+import '../components/translation-review-labels.js';
+import '../lib/translation-review.js';
+import '../components/country-select.js';
+import '../components/inline-edit-field.js';
+import '../lib/iban.js';
+import '../lib/phone.js';
+import '../components/sign-chip.js';
+import '../components/column-mapper.js';
+import '../lib/column-mapping.js';
+import '../lib/table-text.js';
+import '../components/focus-ring.js';
+
+/**
+ * "Payment processing" after the way back from a checkout (docs/billing-harmonization.md
+ * §12.21, §14.4; keksdose's `features/billing/checkout-return.ts`, made router-agnostic).
+ *
+ * The provider tells the app about a payment by WEBHOOK, and the webhook may land after
+ * the buyer is back: Cloud Run scales to zero, and a cold start can outlast the
+ * provider's redirect. Without this, someone who has just paid comes back to a page that
+ * still says their trial has ended. So the return is recognised (`?checkout=done`,
+ * `isCheckoutReturn`), the page says "your payment is being processed"
+ * (`BillingBanner kind="processing"`), and the overview is asked again every few seconds
+ * until it has moved.
+ *
+ * **"Landed" is judged against the overview at departure** ({@link checkoutFingerprint},
+ * noted by {@link noteCheckoutStarted}), not by "is it `active` yet": a trial and a beta
+ * grant can both buy, and a running free grant keeps its status whatever the provider
+ * says (§12.11) — only its period end moves — so "active" alone would wait for ever on
+ * one of them. A return with no departure on record (another tab, another device) waits
+ * for `active`. kastlan's 60-second poll for `source === "provider"` is the case this
+ * replaces: a payer who bought under a grant never matched it.
+ *
+ * **Bounded:** after `timeoutMs` (10 minutes) the device stops asking, and the page says
+ * what the overview says, whatever that is — a checkout abandoned at the provider must
+ * not leave "processing" up for good.
+ *
+ * **Remembered across the whole-page return, per payer.** The departure goes into the
+ * browser's storage through the kit's safe storage (a throwing storage — Safari's
+ * private mode — keeps it in memory for this page instead), under `storageKey`; a mark
+ * names its payer, so it never speaks for another account on a shared device. It is a
+ * browser entry on the app's origin: an app whose privacy text lists its entries names
+ * it (Kurvenschmiede passes its own key).
+ */
+/** The overview fields a completed checkout changes (wire names, `GET /billing/overview`).
+ *  Pass the overview as it came; the other fields are ignored. */
+type CheckoutOverview = Pick<BillingStanding, "status" | "in_good_standing"> & {
+    plan: string;
+    source: string;
+    current_period_end?: DateInput;
+};
+/**
+ * What of the overview a completed checkout changes, as one string: the plan (read
+ * without case, §12.16), the status, the source, the standing and the period's end (read
+ * as an instant, so `…Z` and `…+00:00` agree).
+ */
+declare function checkoutFingerprint(o: CheckoutOverview): string;
+/**
+ * Whether the overview `now` shows the checkout: it differs from the fingerprint taken
+ * at departure (`before`), or — with no departure on record — it is `active`.
+ */
+declare function checkoutLanded(before: string | null, now: CheckoutOverview): boolean;
+/**
+ * Note the departure for a checkout — just before the page leaves for the provider (or
+ * for the pay page, `payPageUrl(url, locale)`):
+ *
+ *     noteCheckoutStarted(user.id, overview.data);
+ *     window.location.assign(payPageUrl(url, i18n.language));
+ *
+ * `payer` is the user's or the company's id: a mark never speaks for another payer.
+ * `overview` is what the page shows now; left out, the return waits for `active`. Pass
+ * the same `storageKey` as the hook's.
+ */
+declare function noteCheckoutStarted(payer: string | number, overview?: CheckoutOverview, opts?: {
+    storageKey?: string;
+}): void;
+interface CheckoutProcessingOptions {
+    /** The signed-in payer — the user's or the company's id; null while unknown (the
+     *  marker then waits in the URL). */
+    payer: string | number | null;
+    /** The page was reached as the way back: `isCheckoutReturn(location.search)`. */
+    returned: boolean;
+    /** Drop the marker, with replace — `setSearchParams((p) => withoutCheckoutReturn(p),
+     *  { replace: true })`. Called once per return, by the first instance that sees it. */
+    onConsumed: () => void;
+    /** The overview query's data, judged here against the departure. */
+    overview: CheckoutOverview | undefined;
+    /** The overview query's refetch: the hook polls with it — one timer for every
+     *  instance, with the latest mounted one's — and "Check again" calls it. */
+    refetch: () => unknown;
+    /** Once per landing: refresh what a new standing changes — the plans, the items whose
+     *  `locked` may have lifted. The overview itself is already fresh. */
+    onLanded?: () => void;
+    /** How long a return keeps "processing". Default 600 000 (10 minutes). */
+    timeoutMs?: number;
+    /** How often the overview is asked meanwhile. Default 4 000. */
+    pollMs?: number;
+    /** The browser entry. Default `"eifi1-billing-checkout"`. */
+    storageKey?: string;
+}
+/**
+ * Whether this payer is back from a checkout whose payment the overview has not shown
+ * yet — and the "Check again" for the banner that says so:
+ *
+ *     const [params, setParams] = useSearchParams();
+ *     const overview = useQuery(billingOverviewQuery);
+ *     const { processing, checkAgain } = useCheckoutProcessing({
+ *       payer: user?.id ?? null,
+ *       returned: isCheckoutReturn(params),
+ *       onConsumed: () => setParams((p) => withoutCheckoutReturn(p), { replace: true }),
+ *       overview: overview.data,
+ *       refetch: overview.refetch,
+ *       onLanded: () => void qc.invalidateQueries({ queryKey: ["budgets"] }),
+ *     });
+ *     processing && <BillingBanner kind="processing" onAction={checkAgain} />
+ *
+ * The kit has no router: the app says whether the URL returned and how to drop the
+ * marker. Mount it wherever the return lands and the banner shows — every instance with
+ * the same `storageKey` shares one state: the first that sees the marker consumes it,
+ * one timer polls, and `onLanded` runs once. The app's `refetchOnWindowFocus` doesn't
+ * matter.
+ */
+declare function useCheckoutProcessing(options: CheckoutProcessingOptions): {
+    processing: boolean;
+    checkAgain: () => void;
+};
+
+export { type CheckoutOverview, type CheckoutProcessingOptions, checkoutFingerprint, checkoutLanded, noteCheckoutStarted, useCheckoutProcessing };

package/dist/billing/checkout-processing.js

@@ -0,0 +1,198 @@
+"use client";
+import { useCallback, useEffect, useEffectEvent, useLayoutEffect, useRef, useSyncExternalStore } from "react";
+import { toDate } from "../lib/format.js";
+import { readStored, writeStored } from "../lib/safe-storage.js";
+const PROCESSING_FOR = 10 * 6e4;
+const POLL_EVERY = 4e3;
+const STORAGE_KEY = "eifi1-billing-checkout";
+function checkoutFingerprint(o) {
+  const end = toDate(o.current_period_end ?? null);
+  return [
+    String(o.plan ?? "").toLowerCase(),
+    o.status,
+    o.source,
+    String(o.in_good_standing),
+    end ? end.toISOString() : ""
+  ].join("|");
+}
+function checkoutLanded(before, now) {
+  return before === null ? now.status === "active" : checkoutFingerprint(now) !== before;
+}
+const stores = /* @__PURE__ */ new Map();
+function readPending(key) {
+  const raw = readStored(key);
+  if (raw === null) return null;
+  try {
+    const value = JSON.parse(raw);
+    if (value && typeof value.payer === "string" && (value.before === null || typeof value.before === "string") && (value.returnedAt === null || typeof value.returnedAt === "number")) {
+      return { payer: value.payer, before: value.before, returnedAt: value.returnedAt };
+    }
+  } catch {
+  }
+  return null;
+}
+function forget(key) {
+  if (typeof window === "undefined") return;
+  try {
+    window.localStorage.removeItem(key);
+  } catch {
+  }
+}
+function storeOf(key) {
+  let store = stores.get(key);
+  if (!store) {
+    store = {
+      key,
+      pending: readPending(key),
+      listeners: /* @__PURE__ */ new Set(),
+      instances: [],
+      poll: null,
+      pollEvery: 0,
+      expiry: null,
+      expiryAt: null,
+      consuming: false
+    };
+    stores.set(key, store);
+  }
+  return store;
+}
+function setPending(store, next) {
+  store.pending = next;
+  if (next) writeStored(store.key, JSON.stringify(next));
+  else forget(store.key);
+  for (const listener of store.listeners) listener();
+  sync(store);
+}
+function refetchLatest(store) {
+  const latest = store.instances.at(-1);
+  if (!latest) return;
+  try {
+    const result = latest.refetch();
+    if (result && typeof result.then === "function") result.then(void 0, () => {
+    });
+  } catch {
+  }
+}
+function sync(store) {
+  const pending = store.pending;
+  const latest = store.instances.at(-1);
+  const returnedAt = pending?.returnedAt ?? null;
+  if (returnedAt === null) {
+    if (store.expiry) clearTimeout(store.expiry);
+    store.expiry = null;
+    store.expiryAt = null;
+  } else {
+    const at = returnedAt + (latest?.timeoutMs ?? PROCESSING_FOR);
+    if (at <= Date.now()) {
+      setPending(store, null);
+      return;
+    }
+    if (store.expiryAt !== at) {
+      if (store.expiry) clearTimeout(store.expiry);
+      store.expiryAt = at;
+      store.expiry = setTimeout(() => {
+        store.expiry = null;
+        store.expiryAt = null;
+        if (store.pending === pending) setPending(store, null);
+      }, at - Date.now());
+    }
+  }
+  const watching = returnedAt !== null && store.instances.some((i) => i.payer === pending.payer);
+  const every = latest?.pollMs ?? POLL_EVERY;
+  if (!watching) {
+    if (store.poll) clearInterval(store.poll);
+    store.poll = null;
+  } else if (!store.poll || store.pollEvery !== every) {
+    if (store.poll) clearInterval(store.poll);
+    store.pollEvery = every;
+    store.poll = setInterval(() => refetchLatest(store), every);
+  }
+}
+function register(store, instance) {
+  store.instances.push(instance);
+  return () => {
+    store.instances = store.instances.filter((i) => i !== instance);
+    sync(store);
+  };
+}
+function claimReturn(store) {
+  if (store.consuming) return false;
+  store.consuming = true;
+  void Promise.resolve().then(() => {
+    store.consuming = false;
+  });
+  return true;
+}
+function noteCheckoutStarted(payer, overview, opts = {}) {
+  const store = storeOf(opts.storageKey ?? STORAGE_KEY);
+  setPending(store, {
+    payer: String(payer),
+    before: overview ? checkoutFingerprint(overview) : null,
+    returnedAt: null
+  });
+}
+function useCheckoutProcessing(options) {
+  const {
+    payer,
+    returned,
+    onConsumed,
+    overview,
+    refetch,
+    onLanded,
+    timeoutMs = PROCESSING_FOR,
+    pollMs = POLL_EVERY,
+    storageKey = STORAGE_KEY
+  } = options;
+  const payerKey = payer === null || payer === void 0 ? null : String(payer);
+  const store = storeOf(storageKey);
+  const subscribe = useCallback(
+    (notify) => {
+      store.listeners.add(notify);
+      return () => {
+        store.listeners.delete(notify);
+      };
+    },
+    [store]
+  );
+  const snapshot = () => store.pending;
+  const pending = useSyncExternalStore(subscribe, snapshot, snapshot);
+  const processing = payerKey !== null && pending?.payer === payerKey && pending.returnedAt !== null;
+  const instanceRef = useRef({ payer: payerKey, refetch, onLanded, timeoutMs, pollMs });
+  useLayoutEffect(() => register(store, instanceRef.current), [store]);
+  useLayoutEffect(() => {
+    Object.assign(instanceRef.current, { payer: payerKey, refetch, onLanded, timeoutMs, pollMs });
+    sync(store);
+  });
+  const consumed = useEffectEvent(() => onConsumed());
+  useEffect(() => {
+    if (!returned || payerKey === null || !claimReturn(store)) return;
+    const before = store.pending?.payer === payerKey ? store.pending.before : null;
+    setPending(store, { payer: payerKey, before, returnedAt: Date.now() });
+    consumed();
+  }, [returned, payerKey, store]);
+  useEffect(() => {
+    if (!processing || !overview) return;
+    const live = store.pending;
+    if (!live || live.payer !== payerKey || live.returnedAt === null) return;
+    if (!checkoutLanded(live.before, overview)) return;
+    setPending(store, null);
+    const latest = [...store.instances].reverse().find((i) => i.onLanded);
+    latest?.onLanded?.();
+  }, [processing, overview, payerKey, store]);
+  const checkAgain = useCallback(() => {
+    try {
+      const result = instanceRef.current.refetch();
+      if (result && typeof result.then === "function") result.then(void 0, () => {
+      });
+    } catch {
+    }
+  }, []);
+  return { processing, checkAgain };
+}
+export {
+  checkoutFingerprint,
+  checkoutLanded,
+  noteCheckoutStarted,
+  useCheckoutProcessing
+};
+//# sourceMappingURL=checkout-processing.js.map

package/dist/billing/checkout-processing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/billing/checkout-processing.ts"],"sourcesContent":["import { useCallback, useEffect, useEffectEvent, useLayoutEffect, useRef, useSyncExternalStore } from \"react\";\n\nimport { toDate } from \"../lib/format\";\nimport type { DateInput } from \"../lib/format\";\nimport { readStored, writeStored } from \"../lib/safe-storage\";\nimport type { BillingStanding } from \"./billing-standing\";\n\n/**\n * \"Payment processing\" after the way back from a checkout (docs/billing-harmonization.md\n * §12.21, §14.4; keksdose's `features/billing/checkout-return.ts`, made router-agnostic).\n *\n * The provider tells the app about a payment by WEBHOOK, and the webhook may land after\n * the buyer is back: Cloud Run scales to zero, and a cold start can outlast the\n * provider's redirect. Without this, someone who has just paid comes back to a page that\n * still says their trial has ended. So the return is recognised (`?checkout=done`,\n * `isCheckoutReturn`), the page says \"your payment is being processed\"\n * (`BillingBanner kind=\"processing\"`), and the overview is asked again every few seconds\n * until it has moved.\n *\n * **\"Landed\" is judged against the overview at departure** ({@link checkoutFingerprint},\n * noted by {@link noteCheckoutStarted}), not by \"is it `active` yet\": a trial and a beta\n * grant can both buy, and a running free grant keeps its status whatever the provider\n * says (§12.11) — only its period end moves — so \"active\" alone would wait for ever on\n * one of them. A return with no departure on record (another tab, another device) waits\n * for `active`. kastlan's 60-second poll for `source === \"provider\"` is the case this\n * replaces: a payer who bought under a grant never matched it.\n *\n * **Bounded:** after `timeoutMs` (10 minutes) the device stops asking, and the page says\n * what the overview says, whatever that is — a checkout abandoned at the provider must\n * not leave \"processing\" up for good.\n *\n * **Remembered across the whole-page return, per payer.** The departure goes into the\n * browser's storage through the kit's safe storage (a throwing storage — Safari's\n * private mode — keeps it in memory for this page instead), under `storageKey`; a mark\n * names its payer, so it never speaks for another account on a shared device. It is a\n * browser entry on the app's origin: an app whose privacy text lists its entries names\n * it (Kurvenschmiede passes its own key).\n */\n\n/** The overview fields a completed checkout changes (wire names, `GET /billing/overview`).\n *  Pass the overview as it came; the other fields are ignored. */\nexport type CheckoutOverview = Pick<BillingStanding, \"status\" | \"in_good_standing\"> & {\n  plan: string;\n  source: string;\n  current_period_end?: DateInput;\n};\n\n/** How long a return keeps the page in \"processing\" before it trusts the overview. */\nconst PROCESSING_FOR = 10 * 60_000;\n/** How often the overview is asked meanwhile. */\nconst POLL_EVERY = 4_000;\n/** The browser entry, unless the app names its own. */\nconst STORAGE_KEY = \"eifi1-billing-checkout\";\n\n/**\n * What of the overview a completed checkout changes, as one string: the plan (read\n * without case, §12.16), the status, the source, the standing and the period's end (read\n * as an instant, so `…Z` and `…+00:00` agree).\n */\nexport function checkoutFingerprint(o: CheckoutOverview): string {\n  const end = toDate(o.current_period_end ?? null);\n  return [\n    String(o.plan ?? \"\").toLowerCase(),\n    o.status,\n    o.source,\n    String(o.in_good_standing),\n    end ? end.toISOString() : \"\",\n  ].join(\"|\");\n}\n\n/**\n * Whether the overview `now` shows the checkout: it differs from the fingerprint taken\n * at departure (`before`), or — with no departure on record — it is `active`.\n */\nexport function checkoutLanded(before: string | null, now: CheckoutOverview): boolean {\n  return before === null ? now.status === \"active\" : checkoutFingerprint(now) !== before;\n}\n\n/* ── The store: one per storage key, shared by every mounted instance ─────── */\n\ninterface PendingCheckout {\n  /** Whose checkout: a user's or a company's id, as a string. */\n  payer: string;\n  /** The overview's fingerprint at departure, or null when it was not known. */\n  before: string | null;\n  /** When the buyer came back; null while they are (or were) at the provider. */\n  returnedAt: number | null;\n}\n\n/** One mounted hook: what the shared timers call, kept current on every render. */\ninterface Instance {\n  payer: string | null;\n  refetch: () => unknown;\n  onLanded: (() => void) | undefined;\n  timeoutMs: number;\n  pollMs: number;\n}\n\ninterface CheckoutStore {\n  key: string;\n  pending: PendingCheckout | null;\n  listeners: Set<() => void>;\n  /** The mounted instances, in mount order: the last is the latest. */\n  instances: Instance[];\n  poll: ReturnType<typeof setInterval> | null;\n  pollEvery: number;\n  expiry: ReturnType<typeof setTimeout> | null;\n  expiryAt: number | null;\n  /** An instance consumed the marker in this commit; the others leave it be. */\n  consuming: boolean;\n}\n\n/** Module-level, so the banner's instance and the subscription page's share one state,\n *  one poll and one landing (keksdose mounts the hook twice, §14.4). */\nconst stores = new Map<string, CheckoutStore>();\n\nfunction readPending(key: string): PendingCheckout | null {\n  const raw = readStored(key);\n  if (raw === null) return null;\n  try {\n    const value = JSON.parse(raw) as Partial<PendingCheckout> | null;\n    if (\n      value &&\n      typeof value.payer === \"string\" &&\n      (value.before === null || typeof value.before === \"string\") &&\n      (value.returnedAt === null || typeof value.returnedAt === \"number\")\n    ) {\n      return { payer: value.payer, before: value.before, returnedAt: value.returnedAt };\n    }\n  } catch {\n    // Not ours, or damaged: as if nothing was noted.\n  }\n  return null;\n}\n\n/** Drop the browser entry. lib/safe-storage reads and writes; removing needs the same\n *  guard (a blocked storage throws on access). */\nfunction forget(key: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.removeItem(key);\n  } catch {\n    // ignore (private mode, partitioned storage)\n  }\n}\n\nfunction storeOf(key: string): CheckoutStore {\n  let store = stores.get(key);\n  if (!store) {\n    store = {\n      key,\n      pending: readPending(key),\n      listeners: new Set(),\n      instances: [],\n      poll: null,\n      pollEvery: 0,\n      expiry: null,\n      expiryAt: null,\n      consuming: false,\n    };\n    stores.set(key, store);\n  }\n  return store;\n}\n\nfunction setPending(store: CheckoutStore, next: PendingCheckout | null): void {\n  store.pending = next;\n  if (next) writeStored(store.key, JSON.stringify(next));\n  else forget(store.key);\n  for (const listener of store.listeners) listener();\n  sync(store);\n}\n\n/** The latest mounted instance's refetch, failures swallowed: a poll that fails is\n *  simply asked again at the next tick. */\nfunction refetchLatest(store: CheckoutStore): void {\n  const latest = store.instances.at(-1);\n  if (!latest) return;\n  try {\n    const result = latest.refetch() as PromiseLike<unknown> | undefined;\n    if (result && typeof result.then === \"function\") result.then(undefined, () => {});\n  } catch {\n    // as above\n  }\n}\n\n/** Arms or stops the store's two timers — the bound and the poll — for its state. */\nfunction sync(store: CheckoutStore): void {\n  const pending = store.pending;\n  const latest = store.instances.at(-1);\n  const returnedAt = pending?.returnedAt ?? null;\n\n  if (returnedAt === null) {\n    if (store.expiry) clearTimeout(store.expiry);\n    store.expiry = null;\n    store.expiryAt = null;\n  } else {\n    const at = returnedAt + (latest?.timeoutMs ?? PROCESSING_FOR);\n    if (at <= Date.now()) {\n      setPending(store, null);\n      return;\n    }\n    if (store.expiryAt !== at) {\n      if (store.expiry) clearTimeout(store.expiry);\n      store.expiryAt = at;\n      store.expiry = setTimeout(() => {\n        store.expiry = null;\n        store.expiryAt = null;\n        if (store.pending === pending) setPending(store, null);\n      }, at - Date.now());\n    }\n  }\n\n  // One poll for every instance, while a mounted one is the mark's payer.\n  const watching = returnedAt !== null && store.instances.some((i) => i.payer === pending!.payer);\n  const every = latest?.pollMs ?? POLL_EVERY;\n  if (!watching) {\n    if (store.poll) clearInterval(store.poll);\n    store.poll = null;\n  } else if (!store.poll || store.pollEvery !== every) {\n    if (store.poll) clearInterval(store.poll);\n    store.pollEvery = every;\n    store.poll = setInterval(() => refetchLatest(store), every);\n  }\n}\n\n/** A mounted instance joins the store's timers; the latest is the one they call. */\nfunction register(store: CheckoutStore, instance: Instance): () => void {\n  store.instances.push(instance);\n  return () => {\n    store.instances = store.instances.filter((i) => i !== instance);\n    sync(store);\n  };\n}\n\n/**\n * Whether this instance is the one to consume a return marker: the first in a commit is.\n * Another instance in the same commit sees the same marker and leaves it be; the claim\n * lapses once the commit's effects have run.\n */\nfunction claimReturn(store: CheckoutStore): boolean {\n  if (store.consuming) return false;\n  store.consuming = true;\n  void Promise.resolve().then(() => {\n    store.consuming = false;\n  });\n  return true;\n}\n\n/**\n * Note the departure for a checkout — just before the page leaves for the provider (or\n * for the pay page, `payPageUrl(url, locale)`):\n *\n *     noteCheckoutStarted(user.id, overview.data);\n *     window.location.assign(payPageUrl(url, i18n.language));\n *\n * `payer` is the user's or the company's id: a mark never speaks for another payer.\n * `overview` is what the page shows now; left out, the return waits for `active`. Pass\n * the same `storageKey` as the hook's.\n */\nexport function noteCheckoutStarted(\n  payer: string | number,\n  overview?: CheckoutOverview,\n  opts: { storageKey?: string } = {},\n): void {\n  const store = storeOf(opts.storageKey ?? STORAGE_KEY);\n  setPending(store, {\n    payer: String(payer),\n    before: overview ? checkoutFingerprint(overview) : null,\n    returnedAt: null,\n  });\n}\n\nexport interface CheckoutProcessingOptions {\n  /** The signed-in payer — the user's or the company's id; null while unknown (the\n   *  marker then waits in the URL). */\n  payer: string | number | null;\n  /** The page was reached as the way back: `isCheckoutReturn(location.search)`. */\n  returned: boolean;\n  /** Drop the marker, with replace — `setSearchParams((p) => withoutCheckoutReturn(p),\n   *  { replace: true })`. Called once per return, by the first instance that sees it. */\n  onConsumed: () => void;\n  /** The overview query's data, judged here against the departure. */\n  overview: CheckoutOverview | undefined;\n  /** The overview query's refetch: the hook polls with it — one timer for every\n   *  instance, with the latest mounted one's — and \"Check again\" calls it. */\n  refetch: () => unknown;\n  /** Once per landing: refresh what a new standing changes — the plans, the items whose\n   *  `locked` may have lifted. The overview itself is already fresh. */\n  onLanded?: () => void;\n  /** How long a return keeps \"processing\". Default 600 000 (10 minutes). */\n  timeoutMs?: number;\n  /** How often the overview is asked meanwhile. Default 4 000. */\n  pollMs?: number;\n  /** The browser entry. Default `\"eifi1-billing-checkout\"`. */\n  storageKey?: string;\n}\n\n/**\n * Whether this payer is back from a checkout whose payment the overview has not shown\n * yet — and the \"Check again\" for the banner that says so:\n *\n *     const [params, setParams] = useSearchParams();\n *     const overview = useQuery(billingOverviewQuery);\n *     const { processing, checkAgain } = useCheckoutProcessing({\n *       payer: user?.id ?? null,\n *       returned: isCheckoutReturn(params),\n *       onConsumed: () => setParams((p) => withoutCheckoutReturn(p), { replace: true }),\n *       overview: overview.data,\n *       refetch: overview.refetch,\n *       onLanded: () => void qc.invalidateQueries({ queryKey: [\"budgets\"] }),\n *     });\n *     processing && <BillingBanner kind=\"processing\" onAction={checkAgain} />\n *\n * The kit has no router: the app says whether the URL returned and how to drop the\n * marker. Mount it wherever the return lands and the banner shows — every instance with\n * the same `storageKey` shares one state: the first that sees the marker consumes it,\n * one timer polls, and `onLanded` runs once. The app's `refetchOnWindowFocus` doesn't\n * matter.\n */\nexport function useCheckoutProcessing(options: CheckoutProcessingOptions): {\n  processing: boolean;\n  checkAgain: () => void;\n} {\n  const {\n    payer,\n    returned,\n    onConsumed,\n    overview,\n    refetch,\n    onLanded,\n    timeoutMs = PROCESSING_FOR,\n    pollMs = POLL_EVERY,\n    storageKey = STORAGE_KEY,\n  } = options;\n  const payerKey = payer === null || payer === undefined ? null : String(payer);\n  const store = storeOf(storageKey);\n  const subscribe = useCallback(\n    (notify: () => void) => {\n      store.listeners.add(notify);\n      return () => {\n        store.listeners.delete(notify);\n      };\n    },\n    [store],\n  );\n  const snapshot = () => store.pending;\n  const pending = useSyncExternalStore(subscribe, snapshot, snapshot);\n  const processing = payerKey !== null && pending?.payer === payerKey && pending.returnedAt !== null;\n\n  // This instance, as the shared timers see it. Registered before paint, so a mark that\n  // ran out while the page was closed is dropped before \"processing\" can flash.\n  const instanceRef = useRef<Instance>({ payer: payerKey, refetch, onLanded, timeoutMs, pollMs });\n  useLayoutEffect(() => register(store, instanceRef.current), [store]);\n  useLayoutEffect(() => {\n    Object.assign(instanceRef.current, { payer: payerKey, refetch, onLanded, timeoutMs, pollMs });\n    sync(store);\n  });\n\n  // The return: note it, then drop the marker so a reload does not count it twice.\n  const consumed = useEffectEvent(() => onConsumed());\n  useEffect(() => {\n    if (!returned || payerKey === null || !claimReturn(store)) return;\n    const before = store.pending?.payer === payerKey ? store.pending.before : null;\n    setPending(store, { payer: payerKey, before, returnedAt: Date.now() });\n    consumed();\n  }, [returned, payerKey, store]);\n\n  // Caught up: the overview has moved since the departure. Judged against the store as\n  // it is NOW, so a second instance in the same commit finds the mark gone.\n  useEffect(() => {\n    if (!processing || !overview) return;\n    const live = store.pending;\n    if (!live || live.payer !== payerKey || live.returnedAt === null) return;\n    if (!checkoutLanded(live.before, overview)) return;\n    setPending(store, null);\n    const latest = [...store.instances].reverse().find((i) => i.onLanded);\n    latest?.onLanded?.();\n  }, [processing, overview, payerKey, store]);\n\n  const checkAgain = useCallback(() => {\n    try {\n      const result = instanceRef.current.refetch() as PromiseLike<unknown> | undefined;\n      if (result && typeof result.then === \"function\") result.then(undefined, () => {});\n    } catch {\n      // The banner stays; the next poll asks again.\n    }\n  }, []);\n\n  return { processing, checkAgain };\n}\n"],"mappings":"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","names":[]}

package/dist/billing/checkout-return.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The way back from the provider's checkout (docs/billing-harmonization.md §14.4,
+ * decision 20): `?checkout=done` on the app's subscription page — kastlan's
+ * `/admin/billing`, keksdose's and Kurvenschmiede's `/settings/subscription`.
+ *
+ * The checkout request carries NO success URL: a redirect the client chooses is an open
+ * redirect, and Paddle's create-transaction takes none. The way back is configuration
+ * instead — the pay page's Paddle.js `successUrl` (`checkoutReturnUrl(returnUrl)`), or a
+ * hosted checkout's redirect in Paddle's dashboard — and the page that lands reads the
+ * marker with {@link isCheckoutReturn}, then drops it with `replace`
+ * ({@link withoutCheckoutReturn}) so a reload or a shared link does not count twice.
+ *
+ * Pure and router-agnostic, and imports nothing: the pay page (`dist/pay/`, no React)
+ * bundles this module too. server-kit names the same two values
+ * (`CHECKOUT_RETURN_PARAM`, `CHECKOUT_RETURN_VALUE`, `checkout_return_url`) for the
+ * deploy notes and its tests.
+ */
+/** The query parameter of the way back. */
+declare const CHECKOUT_RETURN_PARAM = "checkout";
+/** Its one value: the buyer came back from a completed checkout. */
+declare const CHECKOUT_RETURN_VALUE = "done";
+/**
+ * Whether the page was reached as the way back from a checkout: `?checkout=done`.
+ *
+ *     const returned = isCheckoutReturn(location.search);       // react-router's useLocation()
+ *     const returned = isCheckoutReturn(searchParams);           // useSearchParams()[0]
+ */
+declare function isCheckoutReturn(where: string | URLSearchParams | {
+    search: string;
+}): boolean;
+/**
+ * The same parameters without the marker — every other one kept, in order. A new
+ * object; the one passed in is not changed:
+ *
+ *     setSearchParams((p) => withoutCheckoutReturn(p), { replace: true });
+ */
+declare function withoutCheckoutReturn(params: URLSearchParams): URLSearchParams;
+/**
+ * The subscription page's way-back URL: `page` with `checkout=done` in its query —
+ * after any query it already has, before its hash. A marker already there is replaced,
+ * not doubled.
+ *
+ *     checkoutReturnUrl("https://keksdose.app/settings/subscription")
+ *     // → "https://keksdose.app/settings/subscription?checkout=done"
+ *
+ * What the pay page hands Paddle.js as `successUrl`, and what a hosted checkout's
+ * redirect is set to in Paddle's dashboard.
+ */
+declare function checkoutReturnUrl(page: string): string;
+
+export { CHECKOUT_RETURN_PARAM, CHECKOUT_RETURN_VALUE, checkoutReturnUrl, isCheckoutReturn, withoutCheckoutReturn };

package/dist/billing/checkout-return.js

@@ -0,0 +1,43 @@
+"use client";
+const CHECKOUT_RETURN_PARAM = "checkout";
+const CHECKOUT_RETURN_VALUE = "done";
+function paramsOf(where) {
+  if (where instanceof URLSearchParams) return where;
+  const text = typeof where === "string" ? where : where.search;
+  const query = text.includes("?") ? text.slice(text.indexOf("?") + 1) : text;
+  return new URLSearchParams(query.split("#")[0]);
+}
+function isCheckoutReturn(where) {
+  return paramsOf(where).get(CHECKOUT_RETURN_PARAM) === CHECKOUT_RETURN_VALUE;
+}
+function withoutCheckoutReturn(params) {
+  const next = new URLSearchParams(params);
+  next.delete(CHECKOUT_RETURN_PARAM);
+  return next;
+}
+function checkoutReturnUrl(page) {
+  const hashAt = page.indexOf("#");
+  const hash = hashAt === -1 ? "" : page.slice(hashAt);
+  const beforeHash = hashAt === -1 ? page : page.slice(0, hashAt);
+  const queryAt = beforeHash.indexOf("?");
+  const path = queryAt === -1 ? beforeHash : beforeHash.slice(0, queryAt);
+  const kept = (queryAt === -1 ? "" : beforeHash.slice(queryAt + 1)).split("&").filter((part) => part !== "" && decodeKey(part) !== CHECKOUT_RETURN_PARAM);
+  kept.push(`${CHECKOUT_RETURN_PARAM}=${CHECKOUT_RETURN_VALUE}`);
+  return `${path}?${kept.join("&")}${hash}`;
+}
+function decodeKey(part) {
+  const key = part.split("=")[0].replace(/\+/g, " ");
+  try {
+    return decodeURIComponent(key);
+  } catch {
+    return key;
+  }
+}
+export {
+  CHECKOUT_RETURN_PARAM,
+  CHECKOUT_RETURN_VALUE,
+  checkoutReturnUrl,
+  isCheckoutReturn,
+  withoutCheckoutReturn
+};
+//# sourceMappingURL=checkout-return.js.map

package/dist/billing/checkout-return.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/billing/checkout-return.ts"],"sourcesContent":["/**\n * The way back from the provider's checkout (docs/billing-harmonization.md §14.4,\n * decision 20): `?checkout=done` on the app's subscription page — kastlan's\n * `/admin/billing`, keksdose's and Kurvenschmiede's `/settings/subscription`.\n *\n * The checkout request carries NO success URL: a redirect the client chooses is an open\n * redirect, and Paddle's create-transaction takes none. The way back is configuration\n * instead — the pay page's Paddle.js `successUrl` (`checkoutReturnUrl(returnUrl)`), or a\n * hosted checkout's redirect in Paddle's dashboard — and the page that lands reads the\n * marker with {@link isCheckoutReturn}, then drops it with `replace`\n * ({@link withoutCheckoutReturn}) so a reload or a shared link does not count twice.\n *\n * Pure and router-agnostic, and imports nothing: the pay page (`dist/pay/`, no React)\n * bundles this module too. server-kit names the same two values\n * (`CHECKOUT_RETURN_PARAM`, `CHECKOUT_RETURN_VALUE`, `checkout_return_url`) for the\n * deploy notes and its tests.\n */\n\n/** The query parameter of the way back. */\nexport const CHECKOUT_RETURN_PARAM = \"checkout\";\n/** Its one value: the buyer came back from a completed checkout. */\nexport const CHECKOUT_RETURN_VALUE = \"done\";\n\n/** The query of `where`, however the app holds it: a search string (\"?a=1\"), a whole\n *  URL, `URLSearchParams`, or a location (`{ search }`). */\nfunction paramsOf(where: string | URLSearchParams | { search: string }): URLSearchParams {\n  if (where instanceof URLSearchParams) return where;\n  const text = typeof where === \"string\" ? where : where.search;\n  const query = text.includes(\"?\") ? text.slice(text.indexOf(\"?\") + 1) : text;\n  // A whole URL's hash is not part of its query.\n  return new URLSearchParams(query.split(\"#\")[0]);\n}\n\n/**\n * Whether the page was reached as the way back from a checkout: `?checkout=done`.\n *\n *     const returned = isCheckoutReturn(location.search);       // react-router's useLocation()\n *     const returned = isCheckoutReturn(searchParams);           // useSearchParams()[0]\n */\nexport function isCheckoutReturn(where: string | URLSearchParams | { search: string }): boolean {\n  return paramsOf(where).get(CHECKOUT_RETURN_PARAM) === CHECKOUT_RETURN_VALUE;\n}\n\n/**\n * The same parameters without the marker — every other one kept, in order. A new\n * object; the one passed in is not changed:\n *\n *     setSearchParams((p) => withoutCheckoutReturn(p), { replace: true });\n */\nexport function withoutCheckoutReturn(params: URLSearchParams): URLSearchParams {\n  const next = new URLSearchParams(params);\n  next.delete(CHECKOUT_RETURN_PARAM);\n  return next;\n}\n\n/**\n * The subscription page's way-back URL: `page` with `checkout=done` in its query —\n * after any query it already has, before its hash. A marker already there is replaced,\n * not doubled.\n *\n *     checkoutReturnUrl(\"https://keksdose.app/settings/subscription\")\n *     // → \"https://keksdose.app/settings/subscription?checkout=done\"\n *\n * What the pay page hands Paddle.js as `successUrl`, and what a hosted checkout's\n * redirect is set to in Paddle's dashboard.\n */\nexport function checkoutReturnUrl(page: string): string {\n  const hashAt = page.indexOf(\"#\");\n  const hash = hashAt === -1 ? \"\" : page.slice(hashAt);\n  const beforeHash = hashAt === -1 ? page : page.slice(0, hashAt);\n  const queryAt = beforeHash.indexOf(\"?\");\n  const path = queryAt === -1 ? beforeHash : beforeHash.slice(0, queryAt);\n  // Kept as written, part by part: a URLSearchParams round trip would re-encode the\n  // page's own parameters (a space as \"+\").\n  const kept = (queryAt === -1 ? \"\" : beforeHash.slice(queryAt + 1))\n    .split(\"&\")\n    .filter((part) => part !== \"\" && decodeKey(part) !== CHECKOUT_RETURN_PARAM);\n  kept.push(`${CHECKOUT_RETURN_PARAM}=${CHECKOUT_RETURN_VALUE}`);\n  return `${path}?${kept.join(\"&\")}${hash}`;\n}\n\n/** The decoded key of one `key=value` part of a query. */\nfunction decodeKey(part: string): string {\n  const key = part.split(\"=\")[0].replace(/\\+/g, \" \");\n  try {\n    return decodeURIComponent(key);\n  } catch {\n    return key;\n  }\n}\n"],"mappings":";AAmBO,MAAM,wBAAwB;AAE9B,MAAM,wBAAwB;AAIrC,SAAS,SAAS,OAAuE;AACvF,MAAI,iBAAiB,gBAAiB,QAAO;AAC7C,QAAM,OAAO,OAAO,UAAU,WAAW,QAAQ,MAAM;AACvD,QAAM,QAAQ,KAAK,SAAS,GAAG,IAAI,KAAK,MAAM,KAAK,QAAQ,GAAG,IAAI,CAAC,IAAI;AAEvE,SAAO,IAAI,gBAAgB,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC;AAChD;AAQO,SAAS,iBAAiB,OAA+D;AAC9F,SAAO,SAAS,KAAK,EAAE,IAAI,qBAAqB,MAAM;AACxD;AAQO,SAAS,sBAAsB,QAA0C;AAC9E,QAAM,OAAO,IAAI,gBAAgB,MAAM;AACvC,OAAK,OAAO,qBAAqB;AACjC,SAAO;AACT;AAaO,SAAS,kBAAkB,MAAsB;AACtD,QAAM,SAAS,KAAK,QAAQ,GAAG;AAC/B,QAAM,OAAO,WAAW,KAAK,KAAK,KAAK,MAAM,MAAM;AACnD,QAAM,aAAa,WAAW,KAAK,OAAO,KAAK,MAAM,GAAG,MAAM;AAC9D,QAAM,UAAU,WAAW,QAAQ,GAAG;AACtC,QAAM,OAAO,YAAY,KAAK,aAAa,WAAW,MAAM,GAAG,OAAO;AAGtE,QAAM,QAAQ,YAAY,KAAK,KAAK,WAAW,MAAM,UAAU,CAAC,GAC7D,MAAM,GAAG,EACT,OAAO,CAAC,SAAS,SAAS,MAAM,UAAU,IAAI,MAAM,qBAAqB;AAC5E,OAAK,KAAK,GAAG,qBAAqB,IAAI,qBAAqB,EAAE;AAC7D,SAAO,GAAG,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC,GAAG,IAAI;AACzC;AAGA,SAAS,UAAU,MAAsB;AACvC,QAAM,MAAM,KAAK,MAAM,GAAG,EAAE,CAAC,EAAE,QAAQ,OAAO,GAAG;AACjD,MAAI;AACF,WAAO,mBAAmB,GAAG;AAAA,EAC/B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}