@arbidocs/react 0.5.110 → 0.5.112

package/dist/account/delete.js

@@ -0,0 +1,70 @@
+import { useCallback, useState } from "react";
+import { useMutation } from "@tanstack/react-query";
+import { useAccountClient } from "./client.js";
+function parseDeleteAccountBlockers(error) {
+  const body = error?.apiError ?? error;
+  const detail = body?.detail;
+  if (detail === "active_subscription") return [{ type: "active_subscription" }];
+  if (detail && typeof detail === "object") {
+    const d = detail;
+    if (d.reason === "workspace_members" && Array.isArray(d.workspaces)) {
+      return [{ type: "workspace_members", workspaces: d.workspaces.map(String) }];
+    }
+  }
+  return [];
+}
+function useDeleteAccount() {
+  const { client } = useAccountClient();
+  return useMutation({ mutationFn: () => client.requestDeletion() });
+}
+function useDeleteAccountFlow({
+  userEmail,
+  remove,
+  onClose,
+  onDeleted,
+  onError
+}) {
+  const [step, setStep] = useState("warning");
+  const [confirmEmail, setConfirmEmail] = useState("");
+  const [blockers, setBlockers] = useState([]);
+  const [isDeleting, setIsDeleting] = useState(false);
+  const close = useCallback(() => {
+    setStep("warning");
+    setConfirmEmail("");
+    setBlockers([]);
+    onClose();
+  }, [onClose]);
+  const onSubmit = useCallback(() => {
+    if (confirmEmail.toLowerCase() !== userEmail.toLowerCase()) return;
+    setIsDeleting(true);
+    void Promise.resolve().then(remove).then(() => {
+      close();
+      onDeleted();
+    }).catch((error) => {
+      const found = parseDeleteAccountBlockers(error);
+      if (found.length > 0) {
+        setBlockers(found);
+        setStep("warning");
+      } else {
+        onError?.(error);
+      }
+    }).finally(() => setIsDeleting(false));
+  }, [confirmEmail, userEmail, remove, close, onDeleted, onError]);
+  return {
+    step,
+    blockers,
+    confirmEmail,
+    onConfirmEmailChange: setConfirmEmail,
+    onContinue: () => setStep("confirm"),
+    onBack: () => setStep("warning"),
+    isDeleting,
+    onSubmit,
+    onClose: close
+  };
+}
+export {
+  parseDeleteAccountBlockers,
+  useDeleteAccount,
+  useDeleteAccountFlow
+};
+//# sourceMappingURL=delete.js.map

package/dist/account/delete.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/delete.ts"],
+  "sourcesContent": ["/**\n * Delete account: the two-step flow behind `DeleteAccountDialog` and the backend's refusals.\n * The backend closes the account (soft delete) unless the user still has an active subscription\n * or is the sole admin of a workspace with other members; the refusal names which.\n */\n\nimport { useCallback, useState } from 'react'\nimport { useMutation } from '@tanstack/react-query'\nimport { useAccountClient } from './client'\n\n/** Why an account cannot be closed yet. */\nexport type DeleteAccountBlocker =\n  { type: 'active_subscription' } | { type: 'workspace_members'; workspaces: string[] }\n\n/** Read the blockers out of a failed deletion; an empty list means it failed for another reason. */\nexport function parseDeleteAccountBlockers(error: unknown): DeleteAccountBlocker[] {\n  const body = (error as { apiError?: unknown } | null)?.apiError ?? error\n  const detail = (body as { detail?: unknown } | null)?.detail\n  if (detail === 'active_subscription') return [{ type: 'active_subscription' }]\n  if (detail && typeof detail === 'object') {\n    const d = detail as { reason?: unknown; workspaces?: unknown }\n    if (d.reason === 'workspace_members' && Array.isArray(d.workspaces)) {\n      return [{ type: 'workspace_members', workspaces: d.workspaces.map(String) }]\n    }\n  }\n  return []\n}\n\n/** Close the account (the account client in scope). The caller signs out afterwards. */\nexport function useDeleteAccount() {\n  const { client } = useAccountClient()\n  return useMutation({ mutationFn: () => client.requestDeletion() })\n}\n\nexport interface UseDeleteAccountFlowOptions {\n  userEmail: string\n  /** Close the account. Reject with the backend's error to surface blockers. */\n  remove: () => Promise<unknown> | unknown\n  /** The dialog should close. */\n  onClose: () => void\n  /** The account is closed (sign the user out of the app). */\n  onDeleted: () => void\n  /** A failure that is not a blocker. */\n  onError?: (error: unknown) => void\n}\n\nexport interface DeleteAccountFlow {\n  step: 'warning' | 'confirm'\n  blockers: DeleteAccountBlocker[]\n  confirmEmail: string\n  onConfirmEmailChange: (value: string) => void\n  onContinue: () => void\n  onBack: () => void\n  isDeleting: boolean\n  onSubmit: () => void\n  onClose: () => void\n}\n\n/** Step, typed-email confirmation and blockers of `DeleteAccountDialog`. */\nexport function useDeleteAccountFlow({\n  userEmail,\n  remove,\n  onClose,\n  onDeleted,\n  onError,\n}: UseDeleteAccountFlowOptions): DeleteAccountFlow {\n  const [step, setStep] = useState<'warning' | 'confirm'>('warning')\n  const [confirmEmail, setConfirmEmail] = useState('')\n  const [blockers, setBlockers] = useState<DeleteAccountBlocker[]>([])\n  const [isDeleting, setIsDeleting] = useState(false)\n\n  const close = useCallback(() => {\n    setStep('warning')\n    setConfirmEmail('')\n    setBlockers([])\n    onClose()\n  }, [onClose])\n\n  const onSubmit = useCallback(() => {\n    if (confirmEmail.toLowerCase() !== userEmail.toLowerCase()) return\n    setIsDeleting(true)\n    void Promise.resolve()\n      .then(remove)\n      .then(() => {\n        close()\n        onDeleted()\n      })\n      .catch((error: unknown) => {\n        const found = parseDeleteAccountBlockers(error)\n        if (found.length > 0) {\n          setBlockers(found)\n          setStep('warning')\n        } else {\n          onError?.(error)\n        }\n      })\n      .finally(() => setIsDeleting(false))\n  }, [confirmEmail, userEmail, remove, close, onDeleted, onError])\n\n  return {\n    step,\n    blockers,\n    confirmEmail,\n    onConfirmEmailChange: setConfirmEmail,\n    onContinue: () => setStep('confirm'),\n    onBack: () => setStep('warning'),\n    isDeleting,\n    onSubmit,\n    onClose: close,\n  }\n}\n"],
+  "mappings": "AAMA,SAAS,aAAa,gBAAgB;AACtC,SAAS,mBAAmB;AAC5B,SAAS,wBAAwB;AAO1B,SAAS,2BAA2B,OAAwC;AACjF,QAAM,OAAQ,OAAyC,YAAY;AACnE,QAAM,SAAU,MAAsC;AACtD,MAAI,WAAW,sBAAuB,QAAO,CAAC,EAAE,MAAM,sBAAsB,CAAC;AAC7E,MAAI,UAAU,OAAO,WAAW,UAAU;AACxC,UAAM,IAAI;AACV,QAAI,EAAE,WAAW,uBAAuB,MAAM,QAAQ,EAAE,UAAU,GAAG;AACnE,aAAO,CAAC,EAAE,MAAM,qBAAqB,YAAY,EAAE,WAAW,IAAI,MAAM,EAAE,CAAC;AAAA,IAC7E;AAAA,EACF;AACA,SAAO,CAAC;AACV;AAGO,SAAS,mBAAmB;AACjC,QAAM,EAAE,OAAO,IAAI,iBAAiB;AACpC,SAAO,YAAY,EAAE,YAAY,MAAM,OAAO,gBAAgB,EAAE,CAAC;AACnE;AA2BO,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAmD;AACjD,QAAM,CAAC,MAAM,OAAO,IAAI,SAAgC,SAAS;AACjE,QAAM,CAAC,cAAc,eAAe,IAAI,SAAS,EAAE;AACnD,QAAM,CAAC,UAAU,WAAW,IAAI,SAAiC,CAAC,CAAC;AACnE,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAElD,QAAM,QAAQ,YAAY,MAAM;AAC9B,YAAQ,SAAS;AACjB,oBAAgB,EAAE;AAClB,gBAAY,CAAC,CAAC;AACd,YAAQ;AAAA,EACV,GAAG,CAAC,OAAO,CAAC;AAEZ,QAAM,WAAW,YAAY,MAAM;AACjC,QAAI,aAAa,YAAY,MAAM,UAAU,YAAY,EAAG;AAC5D,kBAAc,IAAI;AAClB,SAAK,QAAQ,QAAQ,EAClB,KAAK,MAAM,EACX,KAAK,MAAM;AACV,YAAM;AACN,gBAAU;AAAA,IACZ,CAAC,EACA,MAAM,CAAC,UAAmB;AACzB,YAAM,QAAQ,2BAA2B,KAAK;AAC9C,UAAI,MAAM,SAAS,GAAG;AACpB,oBAAY,KAAK;AACjB,gBAAQ,SAAS;AAAA,MACnB,OAAO;AACL,kBAAU,KAAK;AAAA,MACjB;AAAA,IACF,CAAC,EACA,QAAQ,MAAM,cAAc,KAAK,CAAC;AAAA,EACvC,GAAG,CAAC,cAAc,WAAW,QAAQ,OAAO,WAAW,OAAO,CAAC;AAE/D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,sBAAsB;AAAA,IACtB,YAAY,MAAM,QAAQ,SAAS;AAAA,IACnC,QAAQ,MAAM,QAAQ,SAAS;AAAA,IAC/B;AAAA,IACA;AAAA,IACA,SAAS;AAAA,EACX;AACF;",
+  "names": []
+}

package/dist/account/didit.js

@@ -0,0 +1,34 @@
+let sdkPromise = null;
+function loadDidit() {
+  sdkPromise ??= import("@didit-protocol/sdk-web").then((m) => m.DiditSdk);
+  sdkPromise.catch(() => {
+    sdkPromise = null;
+  });
+  return sdkPromise;
+}
+async function mountDiditVerification({
+  url,
+  containerId,
+  onResult
+}) {
+  const Sdk = await loadDidit();
+  const sdk = Sdk.shared;
+  sdk.onComplete = onResult;
+  await sdk.startVerification({
+    url,
+    configuration: {
+      embedded: true,
+      embeddedContainerId: containerId,
+      showCloseButton: false,
+      closeModalOnComplete: true
+    }
+  });
+  return () => {
+    sdk.onComplete = void 0;
+    sdk.destroy();
+  };
+}
+export {
+  mountDiditVerification
+};
+//# sourceMappingURL=didit.js.map

package/dist/account/didit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/didit.ts"],
+  "sourcesContent": ["/**\n * Didit's web SDK, loaded only when a verification starts (like the app loads Stripe), and run\n * embedded in a host element. ID capture, liveness and face match all happen inside Didit's frame.\n */\n\nimport type { DiditSdk, VerificationResult } from '@didit-protocol/sdk-web'\n\nlet sdkPromise: Promise<typeof DiditSdk> | null = null\n\nfunction loadDidit(): Promise<typeof DiditSdk> {\n  sdkPromise ??= import('@didit-protocol/sdk-web').then((m) => m.DiditSdk)\n  // A failed chunk load may succeed on the next attempt.\n  sdkPromise.catch(() => {\n    sdkPromise = null\n  })\n  return sdkPromise\n}\n\nexport interface MountDiditOptions {\n  /** The Didit session URL from the backend. */\n  url: string\n  /** Id of the element the verification renders into; it must have a height. */\n  containerId: string\n  /** The user finished, cancelled or the flow failed (`cameraAccessDenied`, `sessionExpired`, \u2026). */\n  onResult: (result: VerificationResult) => void\n}\n\n/** Start the embedded verification. Resolves with a teardown; rejects if the SDK can't load. */\nexport async function mountDiditVerification({\n  url,\n  containerId,\n  onResult,\n}: MountDiditOptions): Promise<() => void> {\n  const Sdk = await loadDidit()\n  const sdk = Sdk.shared\n  sdk.onComplete = onResult\n  await sdk.startVerification({\n    url,\n    configuration: {\n      embedded: true,\n      embeddedContainerId: containerId,\n      showCloseButton: false,\n      closeModalOnComplete: true,\n    },\n  })\n  return () => {\n    sdk.onComplete = undefined\n    sdk.destroy()\n  }\n}\n"],
+  "mappings": "AAOA,IAAI,aAA8C;AAElD,SAAS,YAAsC;AAC7C,iBAAe,OAAO,yBAAyB,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ;AAEvE,aAAW,MAAM,MAAM;AACrB,iBAAa;AAAA,EACf,CAAC;AACD,SAAO;AACT;AAYA,eAAsB,uBAAuB;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,QAAM,MAAM,MAAM,UAAU;AAC5B,QAAM,MAAM,IAAI;AAChB,MAAI,aAAa;AACjB,QAAM,IAAI,kBAAkB;AAAA,IAC1B;AAAA,IACA,eAAe;AAAA,MACb,UAAU;AAAA,MACV,qBAAqB;AAAA,MACrB,iBAAiB;AAAA,MACjB,sBAAsB;AAAA,IACxB;AAAA,EACF,CAAC;AACD,SAAO,MAAM;AACX,QAAI,aAAa;AACjB,QAAI,QAAQ;AAAA,EACd;AACF;",
+  "names": []
+}

package/dist/account/dismissed-tips.js

@@ -0,0 +1,33 @@
+import { useCallback } from "react";
+import { useQueryClient } from "@tanstack/react-query";
+import { arbiQueryKeys } from "../hooks.js";
+import { useUserSettings, useUpdateUserSettings } from "./settings.js";
+function useDismissedTips() {
+  const queryClient = useQueryClient();
+  const { data: userSettings } = useUserSettings();
+  const { mutate: updateUserSettings } = useUpdateUserSettings();
+  const loaded = userSettings !== void 0;
+  const dismissed = userSettings?.dismissed_tips ?? [];
+  const dismissTip = useCallback(
+    (code) => {
+      const key = arbiQueryKeys.userSettings();
+      const current = queryClient.getQueryData(key);
+      if (!current) return;
+      const list = current.dismissed_tips ?? [];
+      if (list.includes(code)) return;
+      const next = [...list, code];
+      queryClient.setQueryData(key, { ...current, dismissed_tips: next });
+      updateUserSettings({ dismissed_tips: next });
+    },
+    [queryClient, updateUserSettings]
+  );
+  const resetTips = useCallback(() => {
+    if (dismissed.length === 0) return;
+    updateUserSettings({ dismissed_tips: [] });
+  }, [dismissed.length, updateUserSettings]);
+  return { dismissed, loaded, dismissTip, resetTips };
+}
+export {
+  useDismissedTips
+};
+//# sourceMappingURL=dismissed-tips.js.map

package/dist/account/dismissed-tips.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/dismissed-tips.ts"],
+  "sourcesContent": ["/**\n * Per-user \"don't show this tip again\" state, persisted in the `dismissed_tips`\n * user setting (a list of tip codes). Backed by the server so it's durable and\n * cross-device. The settings PATCH merge is shallow, so we always send the\n * whole list.\n *\n * Because the whole list is sent, a write must start from the list the server\n * has: nothing is written until the settings have loaded (an empty list before\n * then is \"not known yet\", and sending it would wipe every saved code), and each\n * write starts from the cached list as it is at that moment and updates the cache\n * at once, so two codes recorded in the same tick both survive.\n *\n * This is distinct from the `show_hints` lightbulb, which is the master on/off\n * for the whole tips bar \u2014 dismissing individual tips doesn't touch it, and\n * toggling it back on doesn't un-dismiss anything (otherwise \"don't show again\"\n * wouldn't stick). \"Reset tips\" (Settings \u203A Privacy) clears the list.\n */\n\nimport { useCallback } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { arbiQueryKeys } from '../hooks'\nimport { useUserSettings, useUpdateUserSettings } from './settings'\n\ntype DismissedTipsSettings = { dismissed_tips?: string[] | null }\n\n/** The tip codes the user hid, and the writes that keep the saved list whole. */\nexport function useDismissedTips() {\n  const queryClient = useQueryClient()\n  const { data: userSettings } = useUserSettings()\n  const { mutate: updateUserSettings } = useUpdateUserSettings()\n\n  const loaded = userSettings !== undefined\n  const dismissed = userSettings?.dismissed_tips ?? []\n\n  const dismissTip = useCallback(\n    (code: string) => {\n      const key = arbiQueryKeys.userSettings()\n      const current = queryClient.getQueryData<DismissedTipsSettings>(key)\n      if (!current) return\n      const list = current.dismissed_tips ?? []\n      if (list.includes(code)) return\n      const next = [...list, code]\n      queryClient.setQueryData<DismissedTipsSettings>(key, { ...current, dismissed_tips: next })\n      updateUserSettings({ dismissed_tips: next })\n    },\n    [queryClient, updateUserSettings]\n  )\n\n  const resetTips = useCallback(() => {\n    if (dismissed.length === 0) return\n    updateUserSettings({ dismissed_tips: [] })\n  }, [dismissed.length, updateUserSettings])\n\n  return { dismissed, loaded, dismissTip, resetTips }\n}\n"],
+  "mappings": "AAkBA,SAAS,mBAAmB;AAC5B,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAC9B,SAAS,iBAAiB,6BAA6B;AAKhD,SAAS,mBAAmB;AACjC,QAAM,cAAc,eAAe;AACnC,QAAM,EAAE,MAAM,aAAa,IAAI,gBAAgB;AAC/C,QAAM,EAAE,QAAQ,mBAAmB,IAAI,sBAAsB;AAE7D,QAAM,SAAS,iBAAiB;AAChC,QAAM,YAAY,cAAc,kBAAkB,CAAC;AAEnD,QAAM,aAAa;AAAA,IACjB,CAAC,SAAiB;AAChB,YAAM,MAAM,cAAc,aAAa;AACvC,YAAM,UAAU,YAAY,aAAoC,GAAG;AACnE,UAAI,CAAC,QAAS;AACd,YAAM,OAAO,QAAQ,kBAAkB,CAAC;AACxC,UAAI,KAAK,SAAS,IAAI,EAAG;AACzB,YAAM,OAAO,CAAC,GAAG,MAAM,IAAI;AAC3B,kBAAY,aAAoC,KAAK,EAAE,GAAG,SAAS,gBAAgB,KAAK,CAAC;AACzF,yBAAmB,EAAE,gBAAgB,KAAK,CAAC;AAAA,IAC7C;AAAA,IACA,CAAC,aAAa,kBAAkB;AAAA,EAClC;AAEA,QAAM,YAAY,YAAY,MAAM;AAClC,QAAI,UAAU,WAAW,EAAG;AAC5B,uBAAmB,EAAE,gBAAgB,CAAC,EAAE,CAAC;AAAA,EAC3C,GAAG,CAAC,UAAU,QAAQ,kBAAkB,CAAC;AAEzC,SAAO,EAAE,WAAW,QAAQ,YAAY,UAAU;AACpD;",
+  "names": []
+}

package/dist/account/email.js

@@ -0,0 +1,84 @@
+import { useCallback, useEffect, useState } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { arbiQueryKeys } from "../hooks.js";
+import { useAccountClient } from "./client.js";
+function useRequestEmailChange() {
+  const { client } = useAccountClient();
+  return useMutation({
+    mutationFn: (newEmail) => client.requestEmailChange(newEmail)
+  });
+}
+function useConfirmEmailChange() {
+  const { client } = useAccountClient();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: ({ newEmail, code }) => client.confirmEmailChange(newEmail, code),
+    onSuccess: () => qc.setQueryData(arbiQueryKeys.profile(), client.profile())
+  });
+}
+function useEmailChange({
+  requestCode,
+  confirm,
+  cooldownSeconds: cooldownLength = 30
+}) {
+  const [isOpen, setIsOpen] = useState(false);
+  const [step, setStep] = useState("enter");
+  const [newEmail, setNewEmail] = useState("");
+  const [code, setCode] = useState("");
+  const [cooldown, setCooldown] = useState(0);
+  const [isSending, setIsSending] = useState(false);
+  const [isConfirming, setIsConfirming] = useState(false);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (cooldown <= 0) return;
+    const timer = setTimeout(() => setCooldown((c) => c - 1), 1e3);
+    return () => clearTimeout(timer);
+  }, [cooldown]);
+  const reset = useCallback(() => {
+    setIsOpen(false);
+    setStep("enter");
+    setNewEmail("");
+    setCode("");
+    setError(null);
+  }, []);
+  const onSendCode = useCallback(() => {
+    const email = newEmail.trim();
+    if (!email) return;
+    setIsSending(true);
+    setError(null);
+    void Promise.resolve().then(() => requestCode(email)).then(() => {
+      setStep("verify");
+      setCooldown(cooldownLength);
+    }).catch((e) => setError(e)).finally(() => setIsSending(false));
+  }, [newEmail, requestCode, cooldownLength]);
+  const onConfirm = useCallback(() => {
+    const email = newEmail.trim();
+    const entered = code.trim();
+    if (!email || !entered) return;
+    setIsConfirming(true);
+    setError(null);
+    void Promise.resolve().then(() => confirm({ newEmail: email, code: entered })).then(reset).catch((e) => setError(e)).finally(() => setIsConfirming(false));
+  }, [newEmail, code, confirm, reset]);
+  return {
+    isOpen,
+    onStart: () => setIsOpen(true),
+    step,
+    newEmail,
+    onNewEmailChange: setNewEmail,
+    onSendCode,
+    isSending,
+    code,
+    onCodeChange: setCode,
+    onConfirm,
+    isConfirming,
+    cooldownSeconds: cooldown,
+    onCancel: reset,
+    error
+  };
+}
+export {
+  useConfirmEmailChange,
+  useEmailChange,
+  useRequestEmailChange
+};
+//# sourceMappingURL=email.js.map

package/dist/account/email.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/email.ts"],
+  "sourcesContent": ["/**\n * Email change: ask for a code at the new address, confirm it. The SDK-bound mutations and the\n * `ProfileCard` flow controller (cooldown on re-sending the code) are separate, as in `profile.ts`.\n */\n\nimport { useCallback, useEffect, useState } from 'react'\nimport { useMutation, useQueryClient } from '@tanstack/react-query'\nimport { arbiQueryKeys } from '../hooks'\nimport { useAccountClient } from './client'\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/** Send the 3-word verification code to the new address (not for SSO accounts). */\nexport function useRequestEmailChange() {\n  const { client } = useAccountClient()\n  return useMutation({\n    mutationFn: (newEmail: string) => client.requestEmailChange(newEmail),\n  })\n}\n\n/** Confirm the new address with the emailed code; the profile query shows the new email. */\nexport function useConfirmEmailChange() {\n  const { client } = useAccountClient()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationFn: ({ newEmail, code }: { newEmail: string; code: string }) =>\n      client.confirmEmailChange(newEmail, code),\n    onSuccess: () => qc.setQueryData(arbiQueryKeys.profile(), client.profile()),\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 UseEmailChangeOptions {\n  /** Send a code to `newEmail`. */\n  requestCode: (newEmail: string) => Promise<unknown> | unknown\n  /** Confirm `newEmail` with `code`. Resolve to finish the flow. */\n  confirm: (args: { newEmail: string; code: string }) => Promise<unknown> | unknown\n  /** Seconds before another code may be requested. Default 30. */\n  cooldownSeconds?: number\n}\n\nexport interface EmailChange {\n  /** The flow is open: `ProfileCard` hides the plain email row. */\n  isOpen: boolean\n  onStart: () => void\n  step: 'enter' | 'verify'\n  newEmail: string\n  onNewEmailChange: (value: string) => void\n  onSendCode: () => void\n  isSending: boolean\n  code: string\n  onCodeChange: (value: string) => void\n  onConfirm: () => void\n  isConfirming: boolean\n  cooldownSeconds: number\n  onCancel: () => void\n  /** The last failed send or confirm. */\n  error: unknown\n}\n\n/** The two-step email-change flow of `ProfileCard`: enter address, verify code. */\nexport function useEmailChange({\n  requestCode,\n  confirm,\n  cooldownSeconds: cooldownLength = 30,\n}: UseEmailChangeOptions): EmailChange {\n  const [isOpen, setIsOpen] = useState(false)\n  const [step, setStep] = useState<'enter' | 'verify'>('enter')\n  const [newEmail, setNewEmail] = useState('')\n  const [code, setCode] = useState('')\n  const [cooldown, setCooldown] = useState(0)\n  const [isSending, setIsSending] = useState(false)\n  const [isConfirming, setIsConfirming] = useState(false)\n  const [error, setError] = useState<unknown>(null)\n\n  useEffect(() => {\n    if (cooldown <= 0) return\n    const timer = setTimeout(() => setCooldown((c) => c - 1), 1000)\n    return () => clearTimeout(timer)\n  }, [cooldown])\n\n  const reset = useCallback(() => {\n    setIsOpen(false)\n    setStep('enter')\n    setNewEmail('')\n    setCode('')\n    setError(null)\n  }, [])\n\n  const onSendCode = useCallback(() => {\n    const email = newEmail.trim()\n    if (!email) return\n    setIsSending(true)\n    setError(null)\n    void Promise.resolve()\n      .then(() => requestCode(email))\n      .then(() => {\n        setStep('verify')\n        setCooldown(cooldownLength)\n      })\n      .catch((e: unknown) => setError(e))\n      .finally(() => setIsSending(false))\n  }, [newEmail, requestCode, cooldownLength])\n\n  const onConfirm = useCallback(() => {\n    const email = newEmail.trim()\n    const entered = code.trim()\n    if (!email || !entered) return\n    setIsConfirming(true)\n    setError(null)\n    void Promise.resolve()\n      .then(() => confirm({ newEmail: email, code: entered }))\n      .then(reset)\n      .catch((e: unknown) => setError(e))\n      .finally(() => setIsConfirming(false))\n  }, [newEmail, code, confirm, reset])\n\n  return {\n    isOpen,\n    onStart: () => setIsOpen(true),\n    step,\n    newEmail,\n    onNewEmailChange: setNewEmail,\n    onSendCode,\n    isSending,\n    code,\n    onCodeChange: setCode,\n    onConfirm,\n    isConfirming,\n    cooldownSeconds: cooldown,\n    onCancel: reset,\n    error,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/account/entitlements.js

@@ -0,0 +1,47 @@
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useArbiHost } from "../host/config.js";
+import { arbiQueryKeys } from "../hooks.js";
+function useEntitlements() {
+  const { arbi } = useArbiHost();
+  return useQuery({
+    queryKey: arbiQueryKeys.entitlements(),
+    queryFn: () => arbi.account.entitlements(),
+    enabled: !!arbi?.isLoggedIn,
+    // A plan change shows on the next read; the API enforces it at once either way.
+    staleTime: 5 * 60 * 1e3
+  });
+}
+function useInvalidateEntitlements() {
+  const qc = useQueryClient();
+  return () => qc.invalidateQueries({ queryKey: arbiQueryKeys.entitlements() });
+}
+function useIsEntitled(feature) {
+  const { data } = useEntitlements();
+  return data?.[feature] === true;
+}
+function entitlementRefusal(reason) {
+  switch (reason) {
+    case "external_user":
+      return {
+        title: "Not available for external users",
+        description: "Mail, Calendar and hosting calls are for members of the firm. You can still join calls others host."
+      };
+    case "not_entitled":
+      return {
+        title: "Not available on this account",
+        description: "Mail, Calendar and hosting calls are not available on this account."
+      };
+    default:
+      return {
+        title: "Available on Pro",
+        description: "Mail, Calendar and hosting calls come with a Pro plan. You can still join calls others host."
+      };
+  }
+}
+export {
+  entitlementRefusal,
+  useEntitlements,
+  useInvalidateEntitlements,
+  useIsEntitled
+};
+//# sourceMappingURL=entitlements.js.map

package/dist/account/entitlements.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/account/entitlements.ts"],
+  "sourcesContent": ["/**\n * Feature entitlements: native mail, the calendar and hosting calls are paid features (Pro on the hosted\n * service; internal users on a Box). Joining a call someone else hosts is never gated. The API refuses gated\n * routes with 403 and the same `reason`, so a UI hides what the API would refuse.\n */\n\nimport { useQuery, useQueryClient } from '@tanstack/react-query'\nimport type { account } from '@arbidocs/sdk/browser'\nimport { useArbiHost } from '../host/config'\nimport { arbiQueryKeys } from '../hooks'\n\nexport type FeatureEntitlements = account.FeatureEntitlements\nexport type EntitledFeature = account.EntitledFeature\nexport type FeatureRefusal = account.FeatureRefusal\n\n/**\n * The person's entitlements; `data` is undefined until known (treat that as not entitled), and\n * stays so under a host with no `arbi` (e.g. one that brings only its own mail client).\n */\nexport function useEntitlements() {\n  const { arbi } = useArbiHost()\n  return useQuery({\n    queryKey: arbiQueryKeys.entitlements(),\n    queryFn: () => arbi!.account.entitlements(),\n    enabled: !!arbi?.isLoggedIn,\n    // A plan change shows on the next read; the API enforces it at once either way.\n    staleTime: 5 * 60 * 1000,\n  })\n}\n\n/**\n * Read the entitlements again: after something that changes them (Pro bought, a plan change), so\n * the paid pages open at once instead of waiting out the cached copy.\n */\nexport function useInvalidateEntitlements(): () => Promise<void> {\n  const qc = useQueryClient()\n  return () => qc.invalidateQueries({ queryKey: arbiQueryKeys.entitlements() })\n}\n\n/** Whether the person may use `feature` (false while unknown, so nothing the API would refuse flashes up). */\nexport function useIsEntitled(feature: EntitledFeature): boolean {\n  const { data } = useEntitlements()\n  return data?.[feature] === true\n}\n\n/** Why the paid features are off, in the words a UI shows. */\nexport function entitlementRefusal(reason: FeatureRefusal | null | undefined): {\n  title: string\n  description: string\n} {\n  switch (reason) {\n    case 'external_user':\n      return {\n        title: 'Not available for external users',\n        description:\n          'Mail, Calendar and hosting calls are for members of the firm. You can still join calls others host.',\n      }\n    case 'not_entitled':\n      return {\n        title: 'Not available on this account',\n        description: 'Mail, Calendar and hosting calls are not available on this account.',\n      }\n    default:\n      return {\n        title: 'Available on Pro',\n        description:\n          'Mail, Calendar and hosting calls come with a Pro plan. You can still join calls others host.',\n      }\n  }\n}\n"],
+  "mappings": "AAMA,SAAS,UAAU,sBAAsB;AAEzC,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAUvB,SAAS,kBAAkB;AAChC,QAAM,EAAE,KAAK,IAAI,YAAY;AAC7B,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,aAAa;AAAA,IACrC,SAAS,MAAM,KAAM,QAAQ,aAAa;AAAA,IAC1C,SAAS,CAAC,CAAC,MAAM;AAAA;AAAA,IAEjB,WAAW,IAAI,KAAK;AAAA,EACtB,CAAC;AACH;AAMO,SAAS,4BAAiD;AAC/D,QAAM,KAAK,eAAe;AAC1B,SAAO,MAAM,GAAG,kBAAkB,EAAE,UAAU,cAAc,aAAa,EAAE,CAAC;AAC9E;AAGO,SAAS,cAAc,SAAmC;AAC/D,QAAM,EAAE,KAAK,IAAI,gBAAgB;AACjC,SAAO,OAAO,OAAO,MAAM;AAC7B;AAGO,SAAS,mBAAmB,QAGjC;AACA,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,QACL,OAAO;AAAA,QACP,aACE;AAAA,MACJ;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,IACF;AACE,aAAO;AAAA,QACL,OAAO;AAAA,QACP,aACE;AAAA,MACJ;AAAA,EACJ;AACF;",
+  "names": []
+}

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