@arbidocs/react 0.5.110 → 0.5.112

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": []
+}

package/dist/account/profile.js

@@ -0,0 +1,116 @@
+import { useCallback, useEffect, useState } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { arbiQueryKeys } from "../hooks.js";
+import { useAccountClient } from "./client.js";
+function toProfileView(profile) {
+  return {
+    ...profile,
+    fullName: [profile.givenName, profile.familyName].map((part) => part?.trim()).filter(Boolean).join(" ")
+  };
+}
+function useProfile(options) {
+  const { client, enabled } = useAccountClient();
+  const qc = useQueryClient();
+  useEffect(
+    () => client.onProfileChange(() => qc.setQueryData(arbiQueryKeys.profile(), client.profile())),
+    [client, qc]
+  );
+  return useQuery({
+    queryKey: arbiQueryKeys.profile(),
+    queryFn: () => client.profile(),
+    enabled: (options?.enabled ?? true) && enabled,
+    staleTime: Infinity
+  });
+}
+function useUpdateProfile() {
+  const { client } = useAccountClient();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: async (vars) => {
+      await client.updateProfile(vars);
+      return client.profile();
+    },
+    onSuccess: (profile) => {
+      qc.setQueryData(arbiQueryKeys.profile(), profile);
+      void qc.invalidateQueries({ queryKey: arbiQueryKeys.identity() });
+      return qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() });
+    }
+  });
+}
+function useNameEditor({ givenName, familyName, save }) {
+  const [isEditing, setIsEditing] = useState(false);
+  const [given, setGiven] = useState("");
+  const [family, setFamily] = useState("");
+  const [isSaving, setIsSaving] = useState(false);
+  const [error, setError] = useState(null);
+  const onStartEdit = useCallback(() => {
+    setGiven(givenName ?? "");
+    setFamily(familyName ?? "");
+    setError(null);
+    setIsEditing(true);
+  }, [givenName, familyName]);
+  const onSave = useCallback(() => {
+    const trimmedGiven = given.trim();
+    if (!trimmedGiven) return;
+    setIsSaving(true);
+    setError(null);
+    void Promise.resolve().then(() => save({ givenName: trimmedGiven, familyName: family.trim() })).then(() => setIsEditing(false)).catch((e) => setError(e)).finally(() => setIsSaving(false));
+  }, [given, family, save]);
+  return {
+    isEditing,
+    givenName: given,
+    familyName: family,
+    onGivenNameChange: setGiven,
+    onFamilyNameChange: setFamily,
+    onStartEdit,
+    onSave,
+    onCancel: () => setIsEditing(false),
+    isSaving,
+    error
+  };
+}
+const MAX_AVATAR_FILE_BYTES = 5 * 1024 * 1024;
+function useAvatarCrop({
+  upload,
+  onProblem,
+  maxBytes = MAX_AVATAR_FILE_BYTES
+}) {
+  const [pendingImage, setPendingImage] = useState(null);
+  const [isUploading, setIsUploading] = useState(false);
+  const onFileChosen = useCallback(
+    (file) => {
+      if (!file.type.startsWith("image/")) return onProblem?.("not-image");
+      if (file.size > maxBytes) return onProblem?.("too-large");
+      const reader = new FileReader();
+      reader.onload = () => setPendingImage(reader.result);
+      reader.onerror = () => onProblem?.("unreadable");
+      reader.readAsDataURL(file);
+    },
+    [maxBytes, onProblem]
+  );
+  const onCropComplete = useCallback(
+    (result) => {
+      setPendingImage(null);
+      setIsUploading(true);
+      void Promise.resolve().then(() => upload(result.dataUrl)).catch(() => {
+      }).finally(() => setIsUploading(false));
+    },
+    [upload]
+  );
+  return {
+    onFileChosen,
+    pendingImage,
+    onCropComplete,
+    onCropCancel: () => setPendingImage(null),
+    isUploading
+  };
+}
+export {
+  MAX_AVATAR_FILE_BYTES,
+  toProfileView,
+  useAvatarCrop,
+  useNameEditor,
+  useProfile,
+  useUpdateProfile
+};
+//# sourceMappingURL=profile.js.map

package/dist/account/profile.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/profile.ts"],
+  "sourcesContent": ["/**\n * Profile: the signed-in user's name and picture.\n *\n * Two layers, like the rest of the package. The bound hooks (`useProfile`, `useUpdateProfile`) go\n * through the account client in scope (`useAccountClient`: the host configuration's `account`, else\n * one on its `arbi`). The controllers (`useNameEditor`, `useAvatarCrop`) own only the form\n * state and take the save as a function, so an app that has its own API layer (ARBI-frontend)\n * binds the same `ProfileCard` / `AvatarPicker` parts without a provider.\n */\n\nimport { useCallback, useEffect, useState } from 'react'\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport type { LoginProfile } from '@arbidocs/sdk/browser'\nimport { arbiQueryKeys } from '../hooks'\nimport { useAccountClient } from './client'\n\n// \u2500\u2500 View model \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 ProfileView {\n  givenName: string\n  familyName: string | null\n  picture: string | null\n  email: string\n  /** The sign-in provider manages the email (it cannot be changed here). */\n  isSso: boolean\n  /** Verified tick: passed an ID check under this name, not expired. */\n  isIdentityVerified?: boolean\n  /** Given and family name joined; empty while the profile has no name. */\n  fullName: string\n}\n\n/** The profile as the UI reads it. `fullName` is the profile name, never the email. */\nexport function toProfileView(profile: LoginProfile): ProfileView {\n  return {\n    ...profile,\n    fullName: [profile.givenName, profile.familyName]\n      .map((part) => part?.trim())\n      .filter(Boolean)\n      .join(' '),\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/** The signed-in user's profile; `null` when the session has none (restored without a login). */\nexport function useProfile(options?: { enabled?: boolean }) {\n  const { client, enabled } = useAccountClient()\n  const qc = useQueryClient()\n  // The profile changes outside these hooks too (another tab, an ID check, a re-login).\n  useEffect(\n    () => client.onProfileChange(() => qc.setQueryData(arbiQueryKeys.profile(), client.profile())),\n    [client, qc]\n  )\n  return useQuery({\n    queryKey: arbiQueryKeys.profile(),\n    queryFn: (): ProfileView | null => client.profile(),\n    enabled: (options?.enabled ?? true) && enabled,\n    staleTime: Infinity,\n  })\n}\n\nexport interface UpdateProfileVars {\n  givenName?: string\n  /** `''` clears it. */\n  familyName?: string\n  /** A data URL or URL; `''` clears it (the backend caps it at 100 KB). */\n  picture?: string\n}\n\n/**\n * Save the name and/or picture (PATCH /v1/user/profile). The profile query is updated in place and\n * the workspace list (member rows carry the name) is refreshed, so every surface follows.\n */\nexport function useUpdateProfile() {\n  const { client } = useAccountClient()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationFn: async (vars: UpdateProfileVars) => {\n      await client.updateProfile(vars)\n      return client.profile()\n    },\n    onSuccess: (profile) => {\n      qc.setQueryData(arbiQueryKeys.profile(), profile)\n      // A rename can drop (or restore) the verified tick.\n      void qc.invalidateQueries({ queryKey: arbiQueryKeys.identity() })\n      return qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() })\n    },\n  })\n}\n\n// \u2500\u2500 Controllers (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\n\nexport interface UseNameEditorOptions {\n  givenName: string | null | undefined\n  familyName: string | null | undefined\n  /** Persist the new name. Reject to keep the editor open (see `error`). */\n  save: (name: { givenName: string; familyName: string }) => Promise<unknown> | unknown\n}\n\nexport interface NameEditor {\n  isEditing: boolean\n  givenName: string\n  familyName: string\n  onGivenNameChange: (value: string) => void\n  onFamilyNameChange: (value: string) => void\n  onStartEdit: () => void\n  onSave: () => void\n  onCancel: () => void\n  isSaving: boolean\n  /** The last failed save. */\n  error: unknown\n}\n\n/**\n * State of the inline name editor of `ProfileCard`: start edit (seeded from the current name),\n * save (trimmed; a blank given name is not saved), cancel. Spread it into `ProfileCard`'s `name`\n * with `display`.\n */\nexport function useNameEditor({ givenName, familyName, save }: UseNameEditorOptions): NameEditor {\n  const [isEditing, setIsEditing] = useState(false)\n  const [given, setGiven] = useState('')\n  const [family, setFamily] = useState('')\n  const [isSaving, setIsSaving] = useState(false)\n  const [error, setError] = useState<unknown>(null)\n\n  const onStartEdit = useCallback(() => {\n    setGiven(givenName ?? '')\n    setFamily(familyName ?? '')\n    setError(null)\n    setIsEditing(true)\n  }, [givenName, familyName])\n\n  const onSave = useCallback(() => {\n    const trimmedGiven = given.trim()\n    if (!trimmedGiven) return\n    setIsSaving(true)\n    setError(null)\n    void Promise.resolve()\n      .then(() => save({ givenName: trimmedGiven, familyName: family.trim() }))\n      .then(() => setIsEditing(false))\n      .catch((e: unknown) => setError(e))\n      .finally(() => setIsSaving(false))\n  }, [given, family, save])\n\n  return {\n    isEditing,\n    givenName: given,\n    familyName: family,\n    onGivenNameChange: setGiven,\n    onFamilyNameChange: setFamily,\n    onStartEdit,\n    onSave,\n    onCancel: () => setIsEditing(false),\n    isSaving,\n    error,\n  }\n}\n\n/** Largest picture file accepted before cropping. */\nexport const MAX_AVATAR_FILE_BYTES = 5 * 1024 * 1024\n\nexport type AvatarFileProblem = 'not-image' | 'too-large' | 'unreadable'\n\nexport interface UseAvatarCropOptions {\n  /** Persist the cropped picture (a data URL). */\n  upload: (dataUrl: string) => Promise<unknown> | unknown\n  /** Report a rejected file or a failed read; default is silent (the picker just does not open). */\n  onProblem?: (problem: AvatarFileProblem) => void\n  maxBytes?: number\n}\n\nexport interface AvatarCrop {\n  /** Pass to `AvatarPicker.onFileChosen`. */\n  onFileChosen: (file: File) => void\n  /** The chosen image awaiting a crop (a data URL), else `null`. */\n  pendingImage: string | null\n  /** Pass to the crop dialog's `onComplete`. */\n  onCropComplete: (result: { dataUrl: string }) => void\n  onCropCancel: () => void\n  isUploading: boolean\n}\n\n/**\n * The choose, validate, crop, upload sequence behind `AvatarPicker`: the picker hands over a file,\n * this checks it (image, size) and reads it for the crop dialog, then uploads the cropped data URL.\n */\nexport function useAvatarCrop({\n  upload,\n  onProblem,\n  maxBytes = MAX_AVATAR_FILE_BYTES,\n}: UseAvatarCropOptions): AvatarCrop {\n  const [pendingImage, setPendingImage] = useState<string | null>(null)\n  const [isUploading, setIsUploading] = useState(false)\n\n  const onFileChosen = useCallback(\n    (file: File) => {\n      if (!file.type.startsWith('image/')) return onProblem?.('not-image')\n      if (file.size > maxBytes) return onProblem?.('too-large')\n      const reader = new FileReader()\n      reader.onload = () => setPendingImage(reader.result as string)\n      reader.onerror = () => onProblem?.('unreadable')\n      reader.readAsDataURL(file)\n    },\n    [maxBytes, onProblem]\n  )\n\n  const onCropComplete = useCallback(\n    (result: { dataUrl: string }) => {\n      setPendingImage(null)\n      setIsUploading(true)\n      void Promise.resolve()\n        .then(() => upload(result.dataUrl))\n        .catch(() => {\n          // The host's `upload` reports its own failure; the picker just stops spinning.\n        })\n        .finally(() => setIsUploading(false))\n    },\n    [upload]\n  )\n\n  return {\n    onFileChosen,\n    pendingImage,\n    onCropComplete,\n    onCropCancel: () => setPendingImage(null),\n    isUploading,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/account/recovery.js

@@ -0,0 +1,13 @@
+import { createRecoveryFile } from "@arbidocs/client";
+import { downloadBlob } from "../document-tools/environment.js";
+async function downloadRecoveryFile(params) {
+  const file = await createRecoveryFile({
+    ...params,
+    origin: params.origin ?? window.location.origin
+  });
+  downloadBlob(new Blob([file.html], { type: "text/html" }), file.filename);
+}
+export {
+  downloadRecoveryFile
+};
+//# sourceMappingURL=recovery.js.map

package/dist/account/recovery.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/recovery.ts"],
+  "sourcesContent": ["/**\n * Saving the account's recovery key in the browser: the recovery file (`createRecoveryFile` of\n * `@arbidocs/client`, a one-link HTML page) downloaded for the current origin.\n */\n\nimport { createRecoveryFile, type RecoveryKeyParams } from '@arbidocs/client'\nimport { downloadBlob } from '../document-tools/environment'\n\n/** Download the recovery file. `origin` defaults to the page's own; `auth0Sub` SSO-wraps the key. */\nexport async function downloadRecoveryFile(\n  params: Omit<RecoveryKeyParams, 'origin'> & { origin?: string }\n): Promise<void> {\n  const file = await createRecoveryFile({\n    ...params,\n    origin: params.origin ?? window.location.origin,\n  })\n  downloadBlob(new Blob([file.html], { type: 'text/html' }), file.filename)\n}\n"],
+  "mappings": "AAKA,SAAS,0BAAkD;AAC3D,SAAS,oBAAoB;AAG7B,eAAsB,qBACpB,QACe;AACf,QAAM,OAAO,MAAM,mBAAmB;AAAA,IACpC,GAAG;AAAA,IACH,QAAQ,OAAO,UAAU,OAAO,SAAS;AAAA,EAC3C,CAAC;AACD,eAAa,IAAI,KAAK,CAAC,KAAK,IAAI,GAAG,EAAE,MAAM,YAAY,CAAC,GAAG,KAAK,QAAQ;AAC1E;",
+  "names": []
+}

package/dist/account/relevance.js

@@ -0,0 +1,82 @@
+import { useCallback } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { settings as settingsOps } from "@arbidocs/sdk/browser";
+import { useArbi } from "../useArbi.js";
+import { arbiQueryKeys } from "../hooks.js";
+import { useUserSettings } from "./settings.js";
+function useRelevanceSave() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (patch) => arbi.settings.update(patch),
+    onMutate: async (patch) => {
+      await qc.cancelQueries({ queryKey: arbiQueryKeys.userSettings() });
+      const previous = qc.getQueryData(arbiQueryKeys.userSettings());
+      qc.setQueryData(
+        arbiQueryKeys.userSettings(),
+        (old) => old ? { ...old, ...patch } : old
+      );
+      return { previous };
+    },
+    onError: (_err, _patch, context) => {
+      qc.setQueryData(arbiQueryKeys.userSettings(), context?.previous);
+    },
+    onSettled: () => qc.invalidateQueries({ queryKey: arbiQueryKeys.userSettings() })
+  });
+}
+function useWorkspaceNotificationLevel(workspaceId, options) {
+  const qc = useQueryClient();
+  const settings = useUserSettings(options);
+  const save = useRelevanceSave();
+  const level = workspaceId ? settingsOps.workspaceNotificationLevel(settings.data, workspaceId) : "default";
+  const setLevel = useCallback(
+    (next) => {
+      if (!workspaceId) return;
+      const current = qc.getQueryData(arbiQueryKeys.userSettings()) ?? settings.data;
+      save.mutate(settingsOps.workspaceLevelPatch(current, workspaceId, next));
+    },
+    [qc, save, settings.data, workspaceId]
+  );
+  return {
+    level,
+    setLevel,
+    isLoading: settings.isLoading,
+    isSaving: save.isPending,
+    error: save.error
+  };
+}
+function useFollowThread(conversationId, options) {
+  const qc = useQueryClient();
+  const settings = useUserSettings(options);
+  const save = useRelevanceSave();
+  const following = !!conversationId && !!settings.data?.followed_threads?.includes(conversationId);
+  const setFollowing = useCallback(
+    (on, callbacks) => {
+      if (!conversationId) return;
+      const current = qc.getQueryData(arbiQueryKeys.userSettings()) ?? settings.data;
+      save.mutate(
+        {
+          followed_threads: settingsOps.withMembership(
+            current?.followed_threads,
+            conversationId,
+            on
+          )
+        },
+        callbacks
+      );
+    },
+    [qc, save, settings.data, conversationId]
+  );
+  return {
+    following,
+    setFollowing,
+    isLoading: settings.isLoading,
+    isSaving: save.isPending,
+    error: save.error
+  };
+}
+export {
+  useFollowThread,
+  useWorkspaceNotificationLevel
+};
+//# sourceMappingURL=relevance.js.map

package/dist/account/relevance.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/relevance.ts"],
+  "sourcesContent": ["/**\n * Follow and mute: the relevance lists of the user settings. A workspace member is pushed only what\n * concerns them (a mention, an assignment, a reply in a thread they take part in). Following a\n * workspace or a thread opts in to everything from it; muting a workspace silences it, mentions\n * included. Everything else is in the workspace's activity feed.\n *\n * The server takes each list whole: a save sends the full new list, worked out from the cached\n * settings, and updates the cache straight away; a failed write rolls back.\n */\n\nimport { useCallback } from 'react'\nimport { useMutation, useQueryClient } from '@tanstack/react-query'\nimport { settings as settingsOps } from '@arbidocs/sdk/browser'\nimport { useArbi } from '../useArbi'\nimport { arbiQueryKeys } from '../hooks'\nimport { useUserSettings } from './settings'\n\n/** `default` (what names or involves you), `following` (everything) or `muted` (nothing). */\nexport type WorkspaceNotificationLevel = settingsOps.WorkspaceNotificationLevel\n\n/** The lists a follow or mute write may send. */\nexport interface RelevancePatch {\n  muted_workspaces?: string[]\n  followed_workspaces?: string[]\n  followed_threads?: string[]\n}\n\ntype Settings = NonNullable<ReturnType<typeof useUserSettings>['data']>\n\n/** A write of some of the lists, applied to the cached settings at once. */\nfunction useRelevanceSave() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationFn: (patch: RelevancePatch) => arbi.settings.update(patch),\n    onMutate: async (patch) => {\n      await qc.cancelQueries({ queryKey: arbiQueryKeys.userSettings() })\n      const previous = qc.getQueryData<Settings>(arbiQueryKeys.userSettings())\n      qc.setQueryData<Settings>(arbiQueryKeys.userSettings(), (old) =>\n        old ? { ...old, ...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\n/**\n * How much of a workspace reaches the user: `default`, `following` (everything) or `muted`\n * (nothing). `setLevel` moves the workspace between the two lists in one write.\n */\nexport function useWorkspaceNotificationLevel(\n  workspaceId: string | null | undefined,\n  options?: { enabled?: boolean }\n) {\n  const qc = useQueryClient()\n  const settings = useUserSettings(options)\n  const save = useRelevanceSave()\n  const level = workspaceId\n    ? settingsOps.workspaceNotificationLevel(settings.data, workspaceId)\n    : 'default'\n  const setLevel = useCallback(\n    (next: WorkspaceNotificationLevel) => {\n      if (!workspaceId) return\n      const current = qc.getQueryData<Settings>(arbiQueryKeys.userSettings()) ?? settings.data\n      save.mutate(settingsOps.workspaceLevelPatch(current, workspaceId, next))\n    },\n    [qc, save, settings.data, workspaceId]\n  )\n  return {\n    level,\n    setLevel,\n    isLoading: settings.isLoading,\n    isSaving: save.isPending,\n    error: save.error,\n  }\n}\n\n/** What the host does once a follow switch is saved or refused (e.g. a toast: nothing else shows). */\nexport interface FollowSaveCallbacks {\n  onSuccess?: () => void\n  onError?: (error: Error) => void\n}\n\n/** Whether the user follows a thread (pushed everything in it), and the switch. */\nexport function useFollowThread(\n  conversationId: string | null | undefined,\n  options?: { enabled?: boolean }\n) {\n  const qc = useQueryClient()\n  const settings = useUserSettings(options)\n  const save = useRelevanceSave()\n  const following = !!conversationId && !!settings.data?.followed_threads?.includes(conversationId)\n  const setFollowing = useCallback(\n    (on: boolean, callbacks?: FollowSaveCallbacks) => {\n      if (!conversationId) return\n      const current = qc.getQueryData<Settings>(arbiQueryKeys.userSettings()) ?? settings.data\n      save.mutate(\n        {\n          followed_threads: settingsOps.withMembership(\n            current?.followed_threads,\n            conversationId,\n            on\n          ),\n        },\n        callbacks\n      )\n    },\n    [qc, save, settings.data, conversationId]\n  )\n  return {\n    following,\n    setFollowing,\n    isLoading: settings.isLoading,\n    isSaving: save.isPending,\n    error: save.error,\n  }\n}\n"],
+  "mappings": "AAUA,SAAS,mBAAmB;AAC5B,SAAS,aAAa,sBAAsB;AAC5C,SAAS,YAAY,mBAAmB;AACxC,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAehC,SAAS,mBAAmB;AAC1B,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAK,eAAe;AAC1B,SAAO,YAAY;AAAA,IACjB,YAAY,CAAC,UAA0B,KAAK,SAAS,OAAO,KAAK;AAAA,IACjE,UAAU,OAAO,UAAU;AACzB,YAAM,GAAG,cAAc,EAAE,UAAU,cAAc,aAAa,EAAE,CAAC;AACjE,YAAM,WAAW,GAAG,aAAuB,cAAc,aAAa,CAAC;AACvE,SAAG;AAAA,QAAuB,cAAc,aAAa;AAAA,QAAG,CAAC,QACvD,MAAM,EAAE,GAAG,KAAK,GAAG,MAAM,IAAI;AAAA,MAC/B;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;AACH;AAMO,SAAS,8BACd,aACA,SACA;AACA,QAAM,KAAK,eAAe;AAC1B,QAAM,WAAW,gBAAgB,OAAO;AACxC,QAAM,OAAO,iBAAiB;AAC9B,QAAM,QAAQ,cACV,YAAY,2BAA2B,SAAS,MAAM,WAAW,IACjE;AACJ,QAAM,WAAW;AAAA,IACf,CAAC,SAAqC;AACpC,UAAI,CAAC,YAAa;AAClB,YAAM,UAAU,GAAG,aAAuB,cAAc,aAAa,CAAC,KAAK,SAAS;AACpF,WAAK,OAAO,YAAY,oBAAoB,SAAS,aAAa,IAAI,CAAC;AAAA,IACzE;AAAA,IACA,CAAC,IAAI,MAAM,SAAS,MAAM,WAAW;AAAA,EACvC;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,WAAW,SAAS;AAAA,IACpB,UAAU,KAAK;AAAA,IACf,OAAO,KAAK;AAAA,EACd;AACF;AASO,SAAS,gBACd,gBACA,SACA;AACA,QAAM,KAAK,eAAe;AAC1B,QAAM,WAAW,gBAAgB,OAAO;AACxC,QAAM,OAAO,iBAAiB;AAC9B,QAAM,YAAY,CAAC,CAAC,kBAAkB,CAAC,CAAC,SAAS,MAAM,kBAAkB,SAAS,cAAc;AAChG,QAAM,eAAe;AAAA,IACnB,CAAC,IAAa,cAAoC;AAChD,UAAI,CAAC,eAAgB;AACrB,YAAM,UAAU,GAAG,aAAuB,cAAc,aAAa,CAAC,KAAK,SAAS;AACpF,WAAK;AAAA,QACH;AAAA,UACE,kBAAkB,YAAY;AAAA,YAC5B,SAAS;AAAA,YACT;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,IACA,CAAC,IAAI,MAAM,SAAS,MAAM,cAAc;AAAA,EAC1C;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,WAAW,SAAS;AAAA,IACpB,UAAU,KAAK;AAAA,IACf,OAAO,KAAK;AAAA,EACd;AACF;",
+  "names": []
+}