@arbidocs/react 0.5.111 → 0.5.112

package/dist/account/identity.js

@@ -0,0 +1,270 @@
+import { useCallback, useEffect, useId, useMemo, useRef, useState } from "react";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { identityErrorCode } from "@arbidocs/sdk/browser";
+import { useAccountClient } from "./client.js";
+import { arbiQueryKeys } from "../hooks.js";
+import { mountDiditVerification } from "./didit.js";
+function problemOf(error, fallback) {
+  const code = identityErrorCode(error) ?? error?.code;
+  const message = error instanceof Error && error.message ? error.message : fallback;
+  return { code: typeof code === "string" ? code : void 0, message };
+}
+function identityStepFor(status) {
+  if (!status) return "pay";
+  if (["name_mismatch", "in_review", "verified"].includes(status.state)) return "result";
+  if (status.state === "declined") return status.attempts_left > 0 ? "result" : "pay";
+  if (status.state === "in_progress" || status.attempts_left > 0) return "verify";
+  return "pay";
+}
+function formatIdentityPrice(status) {
+  let amount;
+  try {
+    amount = new Intl.NumberFormat("en-GB", {
+      style: "currency",
+      currency: status.currency
+    }).format(status.price_pence / 100);
+  } catch {
+    amount = `${(status.price_pence / 100).toFixed(2)} ${status.currency}`;
+  }
+  return `${amount} incl. VAT`;
+}
+function useIdentityVerificationFlow(api, {
+  enabled = true,
+  onVerifiedChange,
+  onNameAccepted,
+  formatPrice = formatIdentityPrice
+} = {}) {
+  const qc = useQueryClient();
+  const apiRef = useRef(api);
+  apiRef.current = api;
+  const query = useQuery({
+    queryKey: arbiQueryKeys.identity(),
+    queryFn: () => apiRef.current.status(),
+    enabled,
+    staleTime: 6e4
+  });
+  const status = query.data;
+  const [isOpen, setIsOpen] = useState(false);
+  const [step, setStep] = useState("pay");
+  const [busy, setBusy] = useState(null);
+  const [problem, setProblem] = useState(null);
+  const [paymentUrl, setPaymentUrl] = useState(null);
+  const [sessionUrl, setSessionUrl] = useState(null);
+  const [container, setContainer] = useState(null);
+  const [embedFailed, setEmbedFailed] = useState(false);
+  const verifyContainerId = `didit-${useId().replace(/[^a-zA-Z0-9_-]/g, "")}`;
+  const lastVerified = useRef(void 0);
+  const apply = useCallback(
+    (next) => {
+      qc.setQueryData(arbiQueryKeys.identity(), next);
+      if (lastVerified.current !== void 0 && lastVerified.current !== next.verified) {
+        onVerifiedChange?.(next.verified);
+      }
+      lastVerified.current = next.verified;
+      return next;
+    },
+    [qc, onVerifiedChange]
+  );
+  useEffect(() => {
+    if (status && lastVerified.current === void 0) lastVerified.current = status.verified;
+  }, [status]);
+  const run = useCallback(
+    async (kind, fallback, fn) => {
+      setBusy(kind);
+      setProblem(null);
+      try {
+        return await fn();
+      } catch (e) {
+        setProblem(problemOf(e, fallback));
+        return void 0;
+      } finally {
+        setBusy(null);
+      }
+    },
+    []
+  );
+  const isOpenRef = useRef(false);
+  const closeRef = useRef(() => {
+  });
+  const startVerifyRef = useRef(async () => {
+  });
+  const refresh = useCallback(async () => {
+    const next = await run(
+      "refresh",
+      "Could not read the verification result",
+      () => apiRef.current.refresh()
+    );
+    if (!next) return;
+    apply(next);
+    if (next.state === "in_progress") return;
+    setSessionUrl(null);
+    const nextStep = next.state === "declined" ? "result" : identityStepFor(next);
+    if (nextStep === "verify" && isOpenRef.current) void startVerifyRef.current();
+    else setStep(nextStep);
+  }, [run, apply]);
+  const refreshedOnLoad = useRef(false);
+  useEffect(() => {
+    if (refreshedOnLoad.current || !status) return;
+    refreshedOnLoad.current = true;
+    if (status.state === "in_progress" || status.state === "in_review") void refresh();
+  }, [status, refresh]);
+  const startVerify = useCallback(async () => {
+    setStep("verify");
+    setEmbedFailed(false);
+    const url = await run(
+      "start",
+      "Could not start identity verification",
+      () => apiRef.current.startSession()
+    );
+    if (url) {
+      setSessionUrl(url);
+      return;
+    }
+    setStep("pay");
+  }, [run]);
+  startVerifyRef.current = startVerify;
+  useEffect(() => {
+    if (!isOpen || step !== "verify" || !sessionUrl || !container || embedFailed) return;
+    let teardown;
+    let cancelled = false;
+    mountDiditVerification({
+      url: sessionUrl,
+      containerId: container.id,
+      onResult: (result) => {
+        if (result.type === "failed" && result.error?.type === "cameraAccessDenied") {
+          setEmbedFailed(true);
+          return;
+        }
+        if (result.type === "cancelled") {
+          closeRef.current();
+          return;
+        }
+        void refresh();
+      }
+    }).then((stop) => {
+      if (cancelled) stop();
+      else teardown = stop;
+    }).catch(() => setEmbedFailed(true));
+    return () => {
+      cancelled = true;
+      teardown?.();
+    };
+  }, [isOpen, step, sessionUrl, container, embedFailed, refresh]);
+  const [waitingInTab, setWaitingInTab] = useState(false);
+  useEffect(() => {
+    if (!waitingInTab || typeof window === "undefined") return;
+    const onFocus = () => void refresh();
+    window.addEventListener("focus", onFocus);
+    return () => window.removeEventListener("focus", onFocus);
+  }, [waitingInTab, refresh]);
+  const open = useCallback(() => {
+    isOpenRef.current = true;
+    setProblem(null);
+    setPaymentUrl(status?.pending_payment_url ?? null);
+    const first = identityStepFor(status);
+    setStep(first);
+    setIsOpen(true);
+    if (first === "verify") void startVerify();
+  }, [status, startVerify]);
+  const close = useCallback(() => {
+    isOpenRef.current = false;
+    setIsOpen(false);
+    setSessionUrl(null);
+    setWaitingInTab(false);
+    setEmbedFailed(false);
+    setProblem(null);
+  }, []);
+  closeRef.current = close;
+  const pay = useCallback(async () => {
+    const result = await run(
+      "pay",
+      "Payment could not be completed",
+      () => apiRef.current.purchase()
+    );
+    if (!result) return;
+    if (result.status === "requires_action") {
+      setPaymentUrl(result.payment_url ?? null);
+      return;
+    }
+    setPaymentUrl(null);
+    void query.refetch();
+    void startVerify();
+  }, [run, query, startVerify]);
+  const acceptName = useCallback(async () => {
+    const offered = status;
+    const next = await run(
+      "accept",
+      "Could not change your name",
+      () => apiRef.current.acceptName()
+    );
+    if (!next) return;
+    apply(next);
+    if (offered?.document_given_name) {
+      onNameAccepted?.({
+        givenName: offered.document_given_name,
+        familyName: offered.document_family_name ?? null
+      });
+    }
+  }, [run, apply, status, onNameAccepted]);
+  const remove = useCallback(async () => {
+    const next = await run(
+      "remove",
+      "Could not remove the verification",
+      () => apiRef.current.remove()
+    );
+    if (next) apply(next);
+  }, [run, apply]);
+  const price = useMemo(() => status ? formatPrice(status) : null, [status, formatPrice]);
+  return {
+    status,
+    isLoading: query.isLoading,
+    price,
+    isOpen,
+    open,
+    close,
+    step,
+    busy,
+    problem,
+    paymentUrl,
+    pay: () => void pay(),
+    recheckPayment: () => void startVerify(),
+    verifyContainerId,
+    verifyContainerRef: setContainer,
+    embedFailed,
+    openInNewTab: () => {
+      if (!sessionUrl || typeof window === "undefined") return;
+      window.open(sessionUrl, "_blank", "noopener");
+      setWaitingInTab(true);
+    },
+    checkResult: () => void refresh(),
+    retry: () => void startVerify(),
+    acceptName: () => void acceptName(),
+    keepName: close,
+    remove: () => void remove()
+  };
+}
+function useIdentityVerification(options = {}) {
+  const { client, enabled } = useAccountClient();
+  const qc = useQueryClient();
+  const { onVerifiedChange, onNameAccepted, formatPrice } = options;
+  return useIdentityVerificationFlow(client.identity, {
+    enabled,
+    formatPrice,
+    onVerifiedChange: (verified) => {
+      void qc.invalidateQueries({ queryKey: arbiQueryKeys.profile() });
+      onVerifiedChange?.(verified);
+    },
+    onNameAccepted: (name) => {
+      void qc.invalidateQueries({ queryKey: arbiQueryKeys.profile() });
+      void qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() });
+      onNameAccepted?.(name);
+    }
+  });
+}
+export {
+  formatIdentityPrice,
+  identityStepFor,
+  useIdentityVerification,
+  useIdentityVerificationFlow
+};
+//# sourceMappingURL=identity.js.map

package/dist/account/identity.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/identity.ts"],
+  "sourcesContent": ["/**\n * Identity verification: the optional, paid ID check behind the verified tick (Pro plans only).\n *\n * Two layers, like `profile.ts`. `useIdentityVerificationFlow` owns the dialog's state and takes\n * the backend calls as functions, so an app with its own API layer (ARBI-frontend) binds the same\n * `IdentityVerificationCard` / `IdentityVerificationDialog` blocks without a provider.\n * `useIdentityVerification` binds it to the SDK (`arbi.identity`).\n *\n * Steps: pay the one-time fee (charged to the user's Pro project card) \u2192 verify inside Didit's\n * embedded frame \u2192 result (verified, declined, in review, or the name on the document differs from\n * the account name, offered as the new name). No webhooks: completing Didit's flow calls `refresh`.\n */\n\nimport { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react'\nimport { useQuery, useQueryClient } from '@tanstack/react-query'\nimport { identityErrorCode } from '@arbidocs/sdk/browser'\nimport { useAccountClient } from './client'\nimport { arbiQueryKeys } from '../hooks'\nimport { mountDiditVerification } from './didit'\nimport type {\n  IdentityBusy,\n  IdentityProblem,\n  IdentityPurchase,\n  IdentityStatus,\n  IdentityStep,\n  IdentityVerificationFlow,\n} from './identity-types'\n\nexport type {\n  IdentityBusy,\n  IdentityProblem,\n  IdentityPurchase,\n  IdentityState,\n  IdentityStatus,\n  IdentityStep,\n  IdentityVerificationFlow,\n} from './identity-types'\n\n/** The backend calls of the flow, as functions (see the module comment). */\nexport interface IdentityVerificationApi {\n  status: () => Promise<IdentityStatus>\n  purchase: () => Promise<IdentityPurchase>\n  /** The Didit session URL. */\n  startSession: () => Promise<string>\n  refresh: () => Promise<IdentityStatus>\n  acceptName: () => Promise<IdentityStatus>\n  remove: () => Promise<IdentityStatus>\n}\n\nexport interface UseIdentityVerificationFlowOptions {\n  /** Load the status (default true; e.g. false while signed out). */\n  enabled?: boolean\n  /** The tick changed (granted, renamed away, removed): update the host's copy of the user. */\n  onVerifiedChange?: (verified: boolean) => void\n  /** The account name became the name on the document. */\n  onNameAccepted?: (name: { givenName: string; familyName: string | null }) => void\n  /** The host's price format (e.g. its billing helpers); default `formatIdentityPrice`. */\n  formatPrice?: (status: IdentityStatus) => string\n}\n\nfunction problemOf(error: unknown, fallback: string): IdentityProblem {\n  const code = identityErrorCode(error) ?? (error as { code?: unknown } | null)?.code\n  const message = error instanceof Error && error.message ? error.message : fallback\n  return { code: typeof code === 'string' ? code : undefined, message }\n}\n\n/** Which step the dialog opens on for a status. */\nexport function identityStepFor(status: IdentityStatus | undefined): IdentityStep {\n  if (!status) return 'pay'\n  if (['name_mismatch', 'in_review', 'verified'].includes(status.state)) return 'result'\n  if (status.state === 'declined') return status.attempts_left > 0 ? 'result' : 'pay'\n  if (status.state === 'in_progress' || status.attempts_left > 0) return 'verify'\n  return 'pay'\n}\n\n/** \"\u00A35.00 incl. VAT\": the fee is quoted including UK VAT. */\nexport function formatIdentityPrice(status: IdentityStatus): string {\n  let amount: string\n  try {\n    amount = new Intl.NumberFormat('en-GB', {\n      style: 'currency',\n      currency: status.currency,\n    }).format(status.price_pence / 100)\n  } catch {\n    amount = `${(status.price_pence / 100).toFixed(2)} ${status.currency}`\n  }\n  return `${amount} incl. VAT`\n}\n\n/** The identity verification dialog's state, bound to the backend calls in `api`. */\nexport function useIdentityVerificationFlow(\n  api: IdentityVerificationApi,\n  {\n    enabled = true,\n    onVerifiedChange,\n    onNameAccepted,\n    formatPrice = formatIdentityPrice,\n  }: UseIdentityVerificationFlowOptions = {}\n): IdentityVerificationFlow {\n  const qc = useQueryClient()\n  const apiRef = useRef(api)\n  apiRef.current = api\n  const query = useQuery({\n    queryKey: arbiQueryKeys.identity(),\n    queryFn: () => apiRef.current.status(),\n    enabled,\n    staleTime: 60_000,\n  })\n  const status = query.data\n\n  const [isOpen, setIsOpen] = useState(false)\n  const [step, setStep] = useState<IdentityStep>('pay')\n  const [busy, setBusy] = useState<IdentityBusy>(null)\n  const [problem, setProblem] = useState<IdentityProblem | null>(null)\n  const [paymentUrl, setPaymentUrl] = useState<string | null>(null)\n  const [sessionUrl, setSessionUrl] = useState<string | null>(null)\n  const [container, setContainer] = useState<HTMLElement | null>(null)\n  const [embedFailed, setEmbedFailed] = useState(false)\n  const verifyContainerId = `didit-${useId().replace(/[^a-zA-Z0-9_-]/g, '')}`\n\n  const lastVerified = useRef<boolean | undefined>(undefined)\n  const apply = useCallback(\n    (next: IdentityStatus) => {\n      qc.setQueryData(arbiQueryKeys.identity(), next)\n      if (lastVerified.current !== undefined && lastVerified.current !== next.verified) {\n        onVerifiedChange?.(next.verified)\n      }\n      lastVerified.current = next.verified\n      return next\n    },\n    [qc, onVerifiedChange]\n  )\n  useEffect(() => {\n    if (status && lastVerified.current === undefined) lastVerified.current = status.verified\n  }, [status])\n\n  const run = useCallback(\n    async <T>(kind: Exclude<IdentityBusy, null>, fallback: string, fn: () => Promise<T>) => {\n      setBusy(kind)\n      setProblem(null)\n      try {\n        return await fn()\n      } catch (e) {\n        setProblem(problemOf(e, fallback))\n        return undefined\n      } finally {\n        setBusy(null)\n      }\n    },\n    []\n  )\n\n  const isOpenRef = useRef(false)\n  const closeRef = useRef<() => void>(() => {})\n  const startVerifyRef = useRef<() => Promise<void>>(async () => {})\n\n  const refresh = useCallback(async () => {\n    const next = await run('refresh', 'Could not read the verification result', () =>\n      apiRef.current.refresh()\n    )\n    if (!next) return\n    apply(next)\n    if (next.state === 'in_progress') return\n    setSessionUrl(null)\n    const nextStep = next.state === 'declined' ? 'result' : identityStepFor(next)\n    // An abandoned or expired session (state none, attempts left): open a fresh one.\n    if (nextStep === 'verify' && isOpenRef.current) void startVerifyRef.current()\n    else setStep(nextStep)\n  }, [run, apply])\n\n  // A check left open (closed tab, reload, manual review): ask for its result once on load.\n  const refreshedOnLoad = useRef(false)\n  useEffect(() => {\n    if (refreshedOnLoad.current || !status) return\n    refreshedOnLoad.current = true\n    if (status.state === 'in_progress' || status.state === 'in_review') void refresh()\n  }, [status, refresh])\n\n  const startVerify = useCallback(async () => {\n    setStep('verify')\n    setEmbedFailed(false)\n    const url = await run('start', 'Could not start identity verification', () =>\n      apiRef.current.startSession()\n    )\n    if (url) {\n      setSessionUrl(url)\n      return\n    }\n    // Still unpaid (a 3-D Secure payment not confirmed yet): back to the payment step.\n    setStep('pay')\n  }, [run])\n  startVerifyRef.current = startVerify\n\n  // Mount Didit once the session is open and its host element is on screen.\n  useEffect(() => {\n    if (!isOpen || step !== 'verify' || !sessionUrl || !container || embedFailed) return\n    let teardown: (() => void) | undefined\n    let cancelled = false\n    mountDiditVerification({\n      url: sessionUrl,\n      containerId: container.id,\n      onResult: (result) => {\n        if (result.type === 'failed' && result.error?.type === 'cameraAccessDenied') {\n          setEmbedFailed(true)\n          return\n        }\n        if (result.type === 'cancelled') {\n          closeRef.current()\n          return\n        }\n        void refresh()\n      },\n    })\n      .then((stop) => {\n        if (cancelled) stop()\n        else teardown = stop\n      })\n      .catch(() => setEmbedFailed(true))\n    return () => {\n      cancelled = true\n      teardown?.()\n    }\n  }, [isOpen, step, sessionUrl, container, embedFailed, refresh])\n\n  // Verifying in another tab: look for the result when the user comes back.\n  const [waitingInTab, setWaitingInTab] = useState(false)\n  useEffect(() => {\n    if (!waitingInTab || typeof window === 'undefined') return\n    const onFocus = () => void refresh()\n    window.addEventListener('focus', onFocus)\n    return () => window.removeEventListener('focus', onFocus)\n  }, [waitingInTab, refresh])\n\n  const open = useCallback(() => {\n    isOpenRef.current = true\n    setProblem(null)\n    setPaymentUrl(status?.pending_payment_url ?? null)\n    const first = identityStepFor(status)\n    setStep(first)\n    setIsOpen(true)\n    if (first === 'verify') void startVerify()\n  }, [status, startVerify])\n\n  const close = useCallback(() => {\n    isOpenRef.current = false\n    setIsOpen(false)\n    setSessionUrl(null)\n    setWaitingInTab(false)\n    setEmbedFailed(false)\n    setProblem(null)\n  }, [])\n  closeRef.current = close\n\n  const pay = useCallback(async () => {\n    const result = await run('pay', 'Payment could not be completed', () =>\n      apiRef.current.purchase()\n    )\n    if (!result) return\n    if (result.status === 'requires_action') {\n      setPaymentUrl(result.payment_url ?? null)\n      return\n    }\n    setPaymentUrl(null)\n    void query.refetch()\n    void startVerify()\n  }, [run, query, startVerify])\n\n  const acceptName = useCallback(async () => {\n    const offered = status\n    const next = await run('accept', 'Could not change your name', () =>\n      apiRef.current.acceptName()\n    )\n    if (!next) return\n    apply(next)\n    if (offered?.document_given_name) {\n      onNameAccepted?.({\n        givenName: offered.document_given_name,\n        familyName: offered.document_family_name ?? null,\n      })\n    }\n  }, [run, apply, status, onNameAccepted])\n\n  const remove = useCallback(async () => {\n    const next = await run('remove', 'Could not remove the verification', () =>\n      apiRef.current.remove()\n    )\n    if (next) apply(next)\n  }, [run, apply])\n\n  const price = useMemo(() => (status ? formatPrice(status) : null), [status, formatPrice])\n\n  return {\n    status,\n    isLoading: query.isLoading,\n    price,\n    isOpen,\n    open,\n    close,\n    step,\n    busy,\n    problem,\n    paymentUrl,\n    pay: () => void pay(),\n    recheckPayment: () => void startVerify(),\n    verifyContainerId,\n    verifyContainerRef: setContainer,\n    embedFailed,\n    openInNewTab: () => {\n      if (!sessionUrl || typeof window === 'undefined') return\n      window.open(sessionUrl, '_blank', 'noopener')\n      setWaitingInTab(true)\n    },\n    checkResult: () => void refresh(),\n    retry: () => void startVerify(),\n    acceptName: () => void acceptName(),\n    keepName: close,\n    remove: () => void remove(),\n  }\n}\n\n// \u2500\u2500 Bound \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * The identity verification flow over the account client in scope; the profile query follows the\n * tick and name.\n */\nexport function useIdentityVerification(\n  options: Omit<UseIdentityVerificationFlowOptions, 'enabled'> = {}\n): IdentityVerificationFlow {\n  const { client, enabled } = useAccountClient()\n  const qc = useQueryClient()\n  const { onVerifiedChange, onNameAccepted, formatPrice } = options\n  return useIdentityVerificationFlow(client.identity, {\n    enabled,\n    formatPrice,\n    onVerifiedChange: (verified) => {\n      void qc.invalidateQueries({ queryKey: arbiQueryKeys.profile() })\n      onVerifiedChange?.(verified)\n    },\n    onNameAccepted: (name) => {\n      void qc.invalidateQueries({ queryKey: arbiQueryKeys.profile() })\n      void qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() })\n      onNameAccepted?.(name)\n    },\n  })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/account/index.js

@@ -0,0 +1,93 @@
+import {
+  useProfile,
+  useUpdateProfile,
+  toProfileView,
+  useNameEditor,
+  useAvatarCrop,
+  MAX_AVATAR_FILE_BYTES
+} from "./profile.js";
+import {
+  useRequestEmailChange,
+  useConfirmEmailChange,
+  useEmailChange
+} from "./email.js";
+import {
+  usePasswordChange,
+  usePasswordChangeForm,
+  DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES
+} from "./password.js";
+import { useUserSettings, useUpdateUserSettings } from "./settings.js";
+import { useDismissedTips } from "./dismissed-tips.js";
+import {
+  useNotificationPreferences,
+  toNotificationPreferences
+} from "./notifications.js";
+import {
+  useWorkspaceNotificationLevel,
+  useFollowThread
+} from "./relevance.js";
+import { useSessions, useTerminateSession, useSignOut, useCurrentSessionId } from "./sessions.js";
+import {
+  arbiAccountClient,
+  useAccountClient
+} from "./client.js";
+import {
+  useDeleteAccount,
+  useDeleteAccountFlow,
+  parseDeleteAccountBlockers
+} from "./delete.js";
+import {
+  useIdentityVerification,
+  useIdentityVerificationFlow,
+  identityStepFor,
+  formatIdentityPrice
+} from "./identity.js";
+import { mountDiditVerification } from "./didit.js";
+import { downloadRecoveryFile } from "./recovery.js";
+import {
+  useEntitlements,
+  useInvalidateEntitlements,
+  useIsEntitled,
+  entitlementRefusal
+} from "./entitlements.js";
+export {
+  DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES,
+  MAX_AVATAR_FILE_BYTES,
+  arbiAccountClient,
+  downloadRecoveryFile,
+  entitlementRefusal,
+  formatIdentityPrice,
+  identityStepFor,
+  mountDiditVerification,
+  parseDeleteAccountBlockers,
+  toNotificationPreferences,
+  toProfileView,
+  useAccountClient,
+  useAvatarCrop,
+  useConfirmEmailChange,
+  useCurrentSessionId,
+  useDeleteAccount,
+  useDeleteAccountFlow,
+  useDismissedTips,
+  useEmailChange,
+  useEntitlements,
+  useFollowThread,
+  useIdentityVerification,
+  useIdentityVerificationFlow,
+  useInvalidateEntitlements,
+  useIsEntitled,
+  useNameEditor,
+  useNotificationPreferences,
+  usePasswordChange,
+  usePasswordChangeForm,
+  useProfile,
+  useRequestEmailChange,
+  useSessions,
+  useSignOut,
+  useTerminateSession,
+  useUpdateProfile,
+  useUpdateUserSettings,
+  useUserSettings,
+  useWorkspaceNotificationLevel
+};
+//# sourceMappingURL=index.js.map

package/dist/account/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/index.ts"],
+  "sourcesContent": ["export {\n  useProfile,\n  useUpdateProfile,\n  toProfileView,\n  useNameEditor,\n  useAvatarCrop,\n  MAX_AVATAR_FILE_BYTES,\n  type ProfileView,\n  type UpdateProfileVars,\n  type UseNameEditorOptions,\n  type NameEditor,\n  type UseAvatarCropOptions,\n  type AvatarCrop,\n  type AvatarFileProblem,\n} from './profile'\nexport {\n  useRequestEmailChange,\n  useConfirmEmailChange,\n  useEmailChange,\n  type UseEmailChangeOptions,\n  type EmailChange,\n} from './email'\nexport {\n  usePasswordChange,\n  usePasswordChangeForm,\n  DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES,\n  type PasswordChangeVars,\n  type PasswordChangeFormMessages,\n  type UsePasswordChangeFormOptions,\n  type PasswordChangeForm,\n} from './password'\nexport { useUserSettings, useUpdateUserSettings, type UserSettingsPatch } from './settings'\nexport { useDismissedTips } from './dismissed-tips'\nexport {\n  useNotificationPreferences,\n  toNotificationPreferences,\n  type EmailPreferences,\n  type NotificationPreferencesModel,\n} from './notifications'\nexport {\n  useWorkspaceNotificationLevel,\n  useFollowThread,\n  type WorkspaceNotificationLevel,\n  type RelevancePatch,\n  type FollowSaveCallbacks,\n} from './relevance'\nexport { useSessions, useTerminateSession, useSignOut, useCurrentSessionId } from './sessions'\nexport {\n  arbiAccountClient,\n  useAccountClient,\n  type AccountClient,\n  type AccountClientContextValue,\n  type AccountSession,\n  type AccountSignOutOptions,\n} from './client'\nexport {\n  useDeleteAccount,\n  useDeleteAccountFlow,\n  parseDeleteAccountBlockers,\n  type DeleteAccountBlocker,\n  type UseDeleteAccountFlowOptions,\n  type DeleteAccountFlow,\n} from './delete'\nexport {\n  useIdentityVerification,\n  useIdentityVerificationFlow,\n  identityStepFor,\n  formatIdentityPrice,\n  type IdentityVerificationApi,\n  type IdentityVerificationFlow,\n  type UseIdentityVerificationFlowOptions,\n  type IdentityStep,\n  type IdentityBusy,\n  type IdentityProblem,\n  type IdentityStatus,\n  type IdentityState,\n  type IdentityPurchase,\n} from './identity'\nexport { mountDiditVerification, type MountDiditOptions } from './didit'\nexport { downloadRecoveryFile } from './recovery'\nexport {\n  useEntitlements,\n  useInvalidateEntitlements,\n  useIsEntitled,\n  entitlementRefusal,\n  type FeatureEntitlements,\n  type EntitledFeature,\n  type FeatureRefusal,\n} from './entitlements'\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AACP,SAAS,iBAAiB,6BAAqD;AAC/E,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP,SAAS,aAAa,qBAAqB,YAAY,2BAA2B;AAClF;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAUK;AACP,SAAS,8BAAsD;AAC/D,SAAS,4BAA4B;AACrC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;",
+  "names": []
+}

package/dist/account/notifications.js

@@ -0,0 +1,59 @@
+import { useCallback, useMemo } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "../useArbi.js";
+import { arbiQueryKeys } from "../hooks.js";
+import { useUserSettings } from "./settings.js";
+function toNotificationPreferences(stored, keys) {
+  const checked = Object.fromEntries(keys.map((key) => [key, stored?.[key] ?? true]));
+  return {
+    masterChecked: keys.some((key) => checked[key]),
+    checked,
+    masterPatch: (value) => Object.fromEntries(keys.map((key) => [key, value])),
+    categoryPatch: (key, value) => ({ [key]: value })
+  };
+}
+function useNotificationPreferences(keys, options) {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  const settings = useUserSettings(options);
+  const stored = settings.data?.email_notifications;
+  const save = useMutation({
+    mutationFn: (patch) => arbi.settings.update({ email_notifications: patch }),
+    onMutate: async (patch) => {
+      await qc.cancelQueries({ queryKey: arbiQueryKeys.userSettings() });
+      const previous = qc.getQueryData(arbiQueryKeys.userSettings());
+      qc.setQueryData(
+        arbiQueryKeys.userSettings(),
+        (old) => old ? { ...old, email_notifications: { ...old.email_notifications, ...patch } } : old
+      );
+      return { previous };
+    },
+    onError: (_err, _patch, context) => {
+      qc.setQueryData(arbiQueryKeys.userSettings(), context?.previous);
+    },
+    onSettled: () => qc.invalidateQueries({ queryKey: arbiQueryKeys.userSettings() })
+  });
+  const model = useMemo(() => toNotificationPreferences(stored, keys), [stored, keys]);
+  const setAll = useCallback(
+    (value) => save.mutate(model.masterPatch(value)),
+    [save, model]
+  );
+  const setCategory = useCallback(
+    (key, value) => save.mutate(model.categoryPatch(key, value)),
+    [save, model]
+  );
+  return {
+    ...model,
+    isLoading: settings.isLoading,
+    isSaving: save.isPending,
+    /** The master switch handler: every category on or off. */
+    setAll,
+    /** One category's handler. */
+    setCategory
+  };
+}
+export {
+  toNotificationPreferences,
+  useNotificationPreferences
+};
+//# sourceMappingURL=notifications.js.map

package/dist/account/notifications.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/notifications.ts"],
+  "sourcesContent": ["/**\n * Notification preferences: which email categories the user wants (the `email_notifications`\n * record of the user settings). All default on. The master switch on `NotificationCategoryList`\n * is \"on while at least one category is on\" and writes every category at once.\n */\n\nimport { useCallback, useMemo } from 'react'\nimport { useMutation, useQueryClient } from '@tanstack/react-query'\nimport { useArbi } from '../useArbi'\nimport { arbiQueryKeys } from '../hooks'\nimport { useUserSettings } from './settings'\n\n/** Category key to on/off, e.g. `{ messages: true, product_updates: false }`. */\nexport type EmailPreferences = Record<string, boolean>\n\n// \u2500\u2500 Pure core \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface NotificationPreferencesModel {\n  /** Master switch: on while at least one category is on. */\n  masterChecked: boolean\n  /** Each category's state (`true` when the record says nothing: the default). */\n  checked: Record<string, boolean>\n  /** The PATCH body for the master switch: every category set to `value`. */\n  masterPatch: (value: boolean) => EmailPreferences\n  /** The PATCH body for one category. */\n  categoryPatch: (key: string, value: boolean) => EmailPreferences\n}\n\n/** Derive the switch states from the stored record and the list of category keys. */\nexport function toNotificationPreferences(\n  stored: EmailPreferences | null | undefined,\n  keys: readonly string[]\n): NotificationPreferencesModel {\n  const checked = Object.fromEntries(keys.map((key) => [key, stored?.[key] ?? true]))\n  return {\n    masterChecked: keys.some((key) => checked[key]),\n    checked,\n    masterPatch: (value) => Object.fromEntries(keys.map((key) => [key, value])),\n    categoryPatch: (key, value) => ({ [key]: value }),\n  }\n}\n\n// \u2500\u2500 SDK-bound hooks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * The email notification preferences and the save. `save` writes the given keys (a patch,\n * merged by the server) and updates the cached settings straight away, so the switches do not\n * wait for the round trip; a failed write rolls back.\n */\nexport function useNotificationPreferences(\n  keys: readonly string[],\n  options?: { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  const settings = useUserSettings(options)\n  const stored = settings.data?.email_notifications as EmailPreferences | undefined\n\n  const save = useMutation({\n    mutationFn: (patch: EmailPreferences) =>\n      arbi.settings.update({ email_notifications: patch } as never),\n    onMutate: async (patch) => {\n      await qc.cancelQueries({ queryKey: arbiQueryKeys.userSettings() })\n      const previous = qc.getQueryData(arbiQueryKeys.userSettings())\n      qc.setQueryData(arbiQueryKeys.userSettings(), (old: typeof settings.data) =>\n        old ? { ...old, email_notifications: { ...old.email_notifications, ...patch } } : old\n      )\n      return { previous }\n    },\n    onError: (_err, _patch, context) => {\n      qc.setQueryData(arbiQueryKeys.userSettings(), context?.previous)\n    },\n    onSettled: () => qc.invalidateQueries({ queryKey: arbiQueryKeys.userSettings() }),\n  })\n\n  const model = useMemo(() => toNotificationPreferences(stored, keys), [stored, keys])\n  const setAll = useCallback(\n    (value: boolean) => save.mutate(model.masterPatch(value)),\n    [save, model]\n  )\n  const setCategory = useCallback(\n    (key: string, value: boolean) => save.mutate(model.categoryPatch(key, value)),\n    [save, model]\n  )\n\n  return {\n    ...model,\n    isLoading: settings.isLoading,\n    isSaving: save.isPending,\n    /** The master switch handler: every category on or off. */\n    setAll,\n    /** One category's handler. */\n    setCategory,\n  }\n}\n"],
+  "mappings": "AAMA,SAAS,aAAa,eAAe;AACrC,SAAS,aAAa,sBAAsB;AAC5C,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAmBzB,SAAS,0BACd,QACA,MAC8B;AAC9B,QAAM,UAAU,OAAO,YAAY,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,GAAG,KAAK,IAAI,CAAC,CAAC;AAClF,SAAO;AAAA,IACL,eAAe,KAAK,KAAK,CAAC,QAAQ,QAAQ,GAAG,CAAC;AAAA,IAC9C;AAAA,IACA,aAAa,CAAC,UAAU,OAAO,YAAY,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,CAAC;AAAA,IAC1E,eAAe,CAAC,KAAK,WAAW,EAAE,CAAC,GAAG,GAAG,MAAM;AAAA,EACjD;AACF;AASO,SAAS,2BACd,MACA,SACA;AACA,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAK,eAAe;AAC1B,QAAM,WAAW,gBAAgB,OAAO;AACxC,QAAM,SAAS,SAAS,MAAM;AAE9B,QAAM,OAAO,YAAY;AAAA,IACvB,YAAY,CAAC,UACX,KAAK,SAAS,OAAO,EAAE,qBAAqB,MAAM,CAAU;AAAA,IAC9D,UAAU,OAAO,UAAU;AACzB,YAAM,GAAG,cAAc,EAAE,UAAU,cAAc,aAAa,EAAE,CAAC;AACjE,YAAM,WAAW,GAAG,aAAa,cAAc,aAAa,CAAC;AAC7D,SAAG;AAAA,QAAa,cAAc,aAAa;AAAA,QAAG,CAAC,QAC7C,MAAM,EAAE,GAAG,KAAK,qBAAqB,EAAE,GAAG,IAAI,qBAAqB,GAAG,MAAM,EAAE,IAAI;AAAA,MACpF;AACA,aAAO,EAAE,SAAS;AAAA,IACpB;AAAA,IACA,SAAS,CAAC,MAAM,QAAQ,YAAY;AAClC,SAAG,aAAa,cAAc,aAAa,GAAG,SAAS,QAAQ;AAAA,IACjE;AAAA,IACA,WAAW,MAAM,GAAG,kBAAkB,EAAE,UAAU,cAAc,aAAa,EAAE,CAAC;AAAA,EAClF,CAAC;AAED,QAAM,QAAQ,QAAQ,MAAM,0BAA0B,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC;AACnF,QAAM,SAAS;AAAA,IACb,CAAC,UAAmB,KAAK,OAAO,MAAM,YAAY,KAAK,CAAC;AAAA,IACxD,CAAC,MAAM,KAAK;AAAA,EACd;AACA,QAAM,cAAc;AAAA,IAClB,CAAC,KAAa,UAAmB,KAAK,OAAO,MAAM,cAAc,KAAK,KAAK,CAAC;AAAA,IAC5E,CAAC,MAAM,KAAK;AAAA,EACd;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,WAAW,SAAS;AAAA,IACpB,UAAU,KAAK;AAAA;AAAA,IAEf;AAAA;AAAA,IAEA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/account/password.js

@@ -0,0 +1,103 @@
+import { useCallback, useMemo, useState } from "react";
+import { useMutation } from "@tanstack/react-query";
+import { passwordChangeErrorMessage } from "@arbidocs/client";
+import { useAccountClient } from "./client.js";
+function usePasswordChange() {
+  const { client } = useAccountClient();
+  return useMutation({
+    mutationFn: (vars) => client.changePassword(vars)
+  });
+}
+const DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES = {
+  required: "All fields are required",
+  mismatch: "New passwords do not match",
+  sameAsCurrent: "New password must be different from current password",
+  wrongCurrent: "Current password is incorrect.",
+  wrongRecoveryKey: "Recovery key did not match this account. Try a different recovery file."
+};
+function usePasswordChangeForm({
+  recoveryMode = false,
+  getUnmetRequirement,
+  submit,
+  onClose,
+  onRecoveryComplete,
+  messages
+}) {
+  const m = useMemo(() => ({ ...DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES, ...messages }), [messages]);
+  const [currentPassword, setCurrentPassword] = useState("");
+  const [newPassword, setNewPassword] = useState("");
+  const [confirmPassword, setConfirmPassword] = useState("");
+  const [error, setError] = useState(null);
+  const [isProcessing, setIsProcessing] = useState(false);
+  const [isChanged, setIsChanged] = useState(false);
+  const clear = useCallback(() => {
+    setCurrentPassword("");
+    setNewPassword("");
+    setConfirmPassword("");
+  }, []);
+  const isSubmitDisabled = isProcessing || !recoveryMode && !currentPassword || !newPassword || !confirmPassword || getUnmetRequirement(newPassword) !== null || newPassword !== confirmPassword;
+  const onSubmit = useCallback(() => {
+    setError(null);
+    if (!recoveryMode && !currentPassword || !newPassword || !confirmPassword) {
+      return setError(m.required);
+    }
+    if (newPassword !== confirmPassword) return setError(m.mismatch);
+    const unmet = getUnmetRequirement(newPassword);
+    if (unmet !== null) return setError(unmet);
+    if (!recoveryMode && currentPassword === newPassword) return setError(m.sameAsCurrent);
+    setIsProcessing(true);
+    void submit({ newPassword, currentPassword: recoveryMode ? void 0 : currentPassword }).then(() => {
+      clear();
+      if (recoveryMode) {
+        onClose();
+        onRecoveryComplete?.();
+      } else {
+        setIsChanged(true);
+      }
+    }).catch((e) => {
+      const message = passwordChangeErrorMessage(e);
+      const wrongCurrent = /invalid signature|current password|401/i.test(message);
+      setError(wrongCurrent ? recoveryMode ? m.wrongRecoveryKey : m.wrongCurrent : message);
+    }).finally(() => setIsProcessing(false));
+  }, [
+    recoveryMode,
+    currentPassword,
+    newPassword,
+    confirmPassword,
+    getUnmetRequirement,
+    submit,
+    clear,
+    onClose,
+    onRecoveryComplete,
+    m
+  ]);
+  return {
+    currentPassword,
+    onCurrentPasswordChange: setCurrentPassword,
+    newPassword,
+    onNewPasswordChange: setNewPassword,
+    confirmPassword,
+    onConfirmPasswordChange: setConfirmPassword,
+    error,
+    isProcessing,
+    isSubmitDisabled,
+    onSubmit,
+    isChanged,
+    onCancel: () => {
+      clear();
+      setError(null);
+      setIsChanged(false);
+      onClose();
+    },
+    onDone: () => {
+      setIsChanged(false);
+      onClose();
+    }
+  };
+}
+export {
+  DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES,
+  usePasswordChange,
+  usePasswordChangeForm
+};
+//# sourceMappingURL=password.js.map

package/dist/account/password.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/password.ts"],
+  "sourcesContent": ["/**\n * Password change: a new master password for the same account identity.\n *\n * The password only wraps the identity keypair, so a change is one request that re-encrypts nothing\n * and leaves the recovery key as it was (see `Arbi.account.changePassword`). `usePasswordChange` is\n * the SDK-bound mutation. `usePasswordChangeForm` is the controller behind `PasswordChangeDialog`:\n * fields, validation, error wording and the success state. It takes the submit as a function, so an\n * app without an `arbi` in its host binds the same dialog.\n */\n\nimport { useCallback, useMemo, useState } from 'react'\nimport { useMutation } from '@tanstack/react-query'\nimport { passwordChangeErrorMessage } from '@arbidocs/client'\nimport { useAccountClient } from './client'\n\n// \u2500\u2500 SDK-bound hook \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface PasswordChangeVars {\n  newPassword: string\n  /** Omit in recovery mode (after signing in with a recovery key). */\n  currentPassword?: string\n}\n\n/** Change (or, in recovery mode, set) the master password through the account client in scope. */\nexport function usePasswordChange() {\n  const { client } = useAccountClient()\n  return useMutation({\n    mutationFn: (vars: PasswordChangeVars): Promise<void> => client.changePassword(vars),\n  })\n}\n\n// \u2500\u2500 Controller (no SDK) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface PasswordChangeFormMessages {\n  required: string\n  mismatch: string\n  sameAsCurrent: string\n  wrongCurrent: string\n  wrongRecoveryKey: string\n}\n\nexport const DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES: PasswordChangeFormMessages = {\n  required: 'All fields are required',\n  mismatch: 'New passwords do not match',\n  sameAsCurrent: 'New password must be different from current password',\n  wrongCurrent: 'Current password is incorrect.',\n  wrongRecoveryKey: 'Recovery key did not match this account. Try a different recovery file.',\n}\n\nexport interface UsePasswordChangeFormOptions {\n  /** After recovery with a key: no current password is asked for. */\n  recoveryMode?: boolean\n  /** The host's password policy: the first unmet requirement, or `null` when the password is fine. */\n  getUnmetRequirement: (password: string) => string | null\n  /** Do the change. */\n  submit: (vars: PasswordChangeVars) => Promise<void>\n  /** The dialog should close (cancel, or done). */\n  onClose: () => void\n  /** Recovery finished: continue into the app. Recovery closes itself, with no success screen. */\n  onRecoveryComplete?: () => void\n  messages?: Partial<PasswordChangeFormMessages>\n}\n\nexport interface PasswordChangeForm {\n  currentPassword: string\n  onCurrentPasswordChange: (value: string) => void\n  newPassword: string\n  onNewPasswordChange: (value: string) => void\n  confirmPassword: string\n  onConfirmPasswordChange: (value: string) => void\n  error: string | null\n  isProcessing: boolean\n  isSubmitDisabled: boolean\n  onSubmit: () => void\n  /** The change went through (normal mode): the dialog shows its success state. */\n  isChanged: boolean\n  /** Cancel and clear the form. */\n  onCancel: () => void\n  /** Leave the success screen. */\n  onDone: () => void\n}\n\n/** The state machine of `PasswordChangeDialog`; spread it into the dialog's props. */\nexport function usePasswordChangeForm({\n  recoveryMode = false,\n  getUnmetRequirement,\n  submit,\n  onClose,\n  onRecoveryComplete,\n  messages,\n}: UsePasswordChangeFormOptions): PasswordChangeForm {\n  const m = useMemo(() => ({ ...DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES, ...messages }), [messages])\n  const [currentPassword, setCurrentPassword] = useState('')\n  const [newPassword, setNewPassword] = useState('')\n  const [confirmPassword, setConfirmPassword] = useState('')\n  const [error, setError] = useState<string | null>(null)\n  const [isProcessing, setIsProcessing] = useState(false)\n  const [isChanged, setIsChanged] = useState(false)\n\n  const clear = useCallback(() => {\n    setCurrentPassword('')\n    setNewPassword('')\n    setConfirmPassword('')\n  }, [])\n\n  const isSubmitDisabled =\n    isProcessing ||\n    (!recoveryMode && !currentPassword) ||\n    !newPassword ||\n    !confirmPassword ||\n    getUnmetRequirement(newPassword) !== null ||\n    newPassword !== confirmPassword\n\n  const onSubmit = useCallback(() => {\n    setError(null)\n    if ((!recoveryMode && !currentPassword) || !newPassword || !confirmPassword) {\n      return setError(m.required)\n    }\n    if (newPassword !== confirmPassword) return setError(m.mismatch)\n    const unmet = getUnmetRequirement(newPassword)\n    if (unmet !== null) return setError(unmet)\n    if (!recoveryMode && currentPassword === newPassword) return setError(m.sameAsCurrent)\n\n    setIsProcessing(true)\n    void submit({ newPassword, currentPassword: recoveryMode ? undefined : currentPassword })\n      .then(() => {\n        clear()\n        if (recoveryMode) {\n          onClose()\n          onRecoveryComplete?.()\n        } else {\n          setIsChanged(true)\n        }\n      })\n      .catch((e: unknown) => {\n        const message = passwordChangeErrorMessage(e)\n        const wrongCurrent = /invalid signature|current password|401/i.test(message)\n        setError(wrongCurrent ? (recoveryMode ? m.wrongRecoveryKey : m.wrongCurrent) : message)\n      })\n      .finally(() => setIsProcessing(false))\n  }, [\n    recoveryMode,\n    currentPassword,\n    newPassword,\n    confirmPassword,\n    getUnmetRequirement,\n    submit,\n    clear,\n    onClose,\n    onRecoveryComplete,\n    m,\n  ])\n\n  return {\n    currentPassword,\n    onCurrentPasswordChange: setCurrentPassword,\n    newPassword,\n    onNewPasswordChange: setNewPassword,\n    confirmPassword,\n    onConfirmPasswordChange: setConfirmPassword,\n    error,\n    isProcessing,\n    isSubmitDisabled,\n    onSubmit,\n    isChanged,\n    onCancel: () => {\n      clear()\n      setError(null)\n      setIsChanged(false)\n      onClose()\n    },\n    onDone: () => {\n      setIsChanged(false)\n      onClose()\n    },\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}