@arbidocs/react 0.5.110 → 0.5.112

package/dist/offline-store/store.js

@@ -0,0 +1,136 @@
+const DB_VERSION = 1;
+const RECORDS = "records";
+const META = "meta";
+function promisify(request) {
+  return new Promise((resolve, reject) => {
+    request.onsuccess = () => resolve(request.result);
+    request.onerror = () => reject(request.error);
+  });
+}
+function createRecordStore(dbName) {
+  let dbPromise = null;
+  function openDB() {
+    if (dbPromise) return dbPromise;
+    let request;
+    try {
+      request = indexedDB.open(dbName, DB_VERSION);
+    } catch (error) {
+      return Promise.reject(error);
+    }
+    dbPromise = new Promise((resolve, reject) => {
+      request.onerror = () => {
+        dbPromise = null;
+        reject(request.error);
+      };
+      request.onsuccess = () => {
+        const db = request.result;
+        db.onversionchange = () => {
+          db.close();
+          dbPromise = null;
+        };
+        resolve(db);
+      };
+      request.onupgradeneeded = () => {
+        const db = request.result;
+        if (!db.objectStoreNames.contains(RECORDS)) {
+          const records = db.createObjectStore(RECORDS, { keyPath: "key" });
+          records.createIndex("bucket", "bucket");
+          records.createIndex("kind", "kind");
+        }
+        if (!db.objectStoreNames.contains(META)) db.createObjectStore(META, { keyPath: "key" });
+      };
+    });
+    return dbPromise;
+  }
+  async function run(store, mode, fn) {
+    const db = await openDB();
+    return promisify(fn(db.transaction(store, mode).objectStore(store)));
+  }
+  async function scan(pick) {
+    const db = await openDB();
+    const store = db.transaction(RECORDS, "readonly").objectStore(RECORDS);
+    return new Promise((resolve, reject) => {
+      const out = [];
+      const cursor = store.openCursor();
+      cursor.onerror = () => reject(cursor.error);
+      cursor.onsuccess = () => {
+        const c = cursor.result;
+        if (!c) return resolve(out);
+        out.push(pick(c.value));
+        c.continue();
+      };
+    });
+  }
+  const self = {
+    dbName,
+    async putRecord(record) {
+      await run(RECORDS, "readwrite", (s) => s.put(record));
+    },
+    async getRecord(key) {
+      return await run(RECORDS, "readonly", (s) => s.get(key));
+    },
+    async hasRecord(key) {
+      return await run(RECORDS, "readonly", (s) => s.count(key)) > 0;
+    },
+    async deleteRecords(keys) {
+      if (keys.length === 0) return;
+      const db = await openDB();
+      const tx = db.transaction(RECORDS, "readwrite");
+      const store = tx.objectStore(RECORDS);
+      for (const key of keys) store.delete(key);
+      await new Promise((resolve, reject) => {
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => reject(tx.error);
+        tx.onabort = () => reject(tx.error);
+      });
+    },
+    async recordsInBucket(bucket) {
+      return await run(
+        RECORDS,
+        "readonly",
+        (s) => s.index("bucket").getAll(bucket)
+      );
+    },
+    async recordsOfKind(kind) {
+      return await run(
+        RECORDS,
+        "readonly",
+        (s) => s.index("kind").getAll(kind)
+      );
+    },
+    allRecordSizes() {
+      return scan(({ key, kind, size }) => ({ key, kind, size }));
+    },
+    allRecordAccess() {
+      return scan(({ key, kind, lastAccess }) => ({ key, kind, lastAccess }));
+    },
+    async touchRecord(key) {
+      const record = await self.getRecord(key);
+      if (record) await self.putRecord({ ...record, lastAccess: Date.now() });
+    },
+    async getMeta(key) {
+      const row = await run(META, "readonly", (s) => s.get(key));
+      return row?.value;
+    },
+    async setMeta(key, value) {
+      await run(META, "readwrite", (s) => s.put({ key, value }));
+    },
+    async deleteDatabase() {
+      const db = await dbPromise?.catch(() => null);
+      db?.close();
+      dbPromise = null;
+      await new Promise((resolve, reject) => {
+        const request = indexedDB.deleteDatabase(dbName);
+        request.onsuccess = () => resolve();
+        request.onerror = () => reject(request.error);
+        request.onblocked = () => {
+        };
+      });
+    }
+  };
+  return self;
+}
+export {
+  createRecordStore
+};
+//# sourceMappingURL=store.js.map

package/dist/offline-store/store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/offline-store/store.ts"],
+  "sourcesContent": ["/**\n * A generic encrypted-at-rest IndexedDB store: one object store of sealed records plus a small\n * plaintext `meta` store. A record's plaintext fields are only what IndexedDB needs to find and\n * evict it (a blind key, its kind, a blind bucket, a sort time, its size, last access); the content\n * is in `data`, sealed by the caller (see ./crypto). The store itself is crypto-agnostic.\n *\n * Used by the offline mailbox (`arbi-offline-mail`) and the offline calendar (`arbi-offline-calendar`).\n */\n\nconst DB_VERSION = 1\nconst RECORDS = 'records'\nconst META = 'meta'\n\nexport interface StoredRecord<K extends string = string> {\n  /** Blind key (see crypto.blind). */\n  key: string\n  kind: K\n  /** Blind group key. */\n  bucket: string\n  sortAt: number\n  /** Ciphertext bytes, for the storage quota. */\n  size: number\n  /** Last read (ms), for least-recently-used eviction. */\n  lastAccess: number\n  /** Sealed contents. */\n  data: Uint8Array\n}\n\nexport interface RecordStore<K extends string> {\n  readonly dbName: string\n  putRecord(record: StoredRecord<K>): Promise<void>\n  getRecord(key: string): Promise<StoredRecord<K> | undefined>\n  hasRecord(key: string): Promise<boolean>\n  deleteRecords(keys: string[]): Promise<void>\n  recordsInBucket(bucket: string): Promise<StoredRecord<K>[]>\n  recordsOfKind(kind: K): Promise<StoredRecord<K>[]>\n  allRecordSizes(): Promise<Array<Pick<StoredRecord<K>, 'key' | 'kind' | 'size'>>>\n  /** Keys, kinds and last access (no data), for LRU eviction. */\n  allRecordAccess(): Promise<Array<Pick<StoredRecord<K>, 'key' | 'kind' | 'lastAccess'>>>\n  touchRecord(key: string): Promise<void>\n  getMeta<T>(key: string): Promise<T | undefined>\n  setMeta(key: string, value: unknown): Promise<void>\n  /** Delete the whole database. */\n  deleteDatabase(): Promise<void>\n}\n\nfunction promisify<T>(request: IDBRequest<T>): Promise<T> {\n  return new Promise((resolve, reject) => {\n    request.onsuccess = () => resolve(request.result)\n    request.onerror = () => reject(request.error)\n  })\n}\n\nexport function createRecordStore<K extends string>(dbName: string): RecordStore<K> {\n  let dbPromise: Promise<IDBDatabase> | null = null\n\n  function openDB(): Promise<IDBDatabase> {\n    if (dbPromise) return dbPromise\n    let request: IDBOpenDBRequest\n    try {\n      request = indexedDB.open(dbName, DB_VERSION)\n    } catch (error) {\n      // No indexedDB here, or opening it threw (e.g. blocked storage): nothing is kept, so the\n      // next call tries again.\n      return Promise.reject(error)\n    }\n    dbPromise = new Promise((resolve, reject) => {\n      request.onerror = () => {\n        dbPromise = null\n        reject(request.error)\n      }\n      request.onsuccess = () => {\n        const db = request.result\n        // Another tab deleting the database (sign-out) must not be blocked by this handle.\n        db.onversionchange = () => {\n          db.close()\n          dbPromise = null\n        }\n        resolve(db)\n      }\n      request.onupgradeneeded = () => {\n        const db = request.result\n        if (!db.objectStoreNames.contains(RECORDS)) {\n          const records = db.createObjectStore(RECORDS, { keyPath: 'key' })\n          records.createIndex('bucket', 'bucket')\n          records.createIndex('kind', 'kind')\n        }\n        if (!db.objectStoreNames.contains(META)) db.createObjectStore(META, { keyPath: 'key' })\n      }\n    })\n    return dbPromise\n  }\n\n  async function run<T>(\n    store: string,\n    mode: IDBTransactionMode,\n    fn: (s: IDBObjectStore) => IDBRequest<T>\n  ): Promise<T> {\n    const db = await openDB()\n    return promisify(fn(db.transaction(store, mode).objectStore(store)))\n  }\n\n  async function scan<T>(pick: (r: StoredRecord<K>) => T): Promise<T[]> {\n    const db = await openDB()\n    const store = db.transaction(RECORDS, 'readonly').objectStore(RECORDS)\n    return new Promise((resolve, reject) => {\n      const out: T[] = []\n      const cursor = store.openCursor()\n      cursor.onerror = () => reject(cursor.error)\n      cursor.onsuccess = () => {\n        const c = cursor.result\n        if (!c) return resolve(out)\n        out.push(pick(c.value as StoredRecord<K>))\n        c.continue()\n      }\n    })\n  }\n\n  const self: RecordStore<K> = {\n    dbName,\n    async putRecord(record) {\n      await run(RECORDS, 'readwrite', (s) => s.put(record))\n    },\n    async getRecord(key) {\n      return (await run(RECORDS, 'readonly', (s) => s.get(key))) as StoredRecord<K> | undefined\n    },\n    async hasRecord(key) {\n      return (await run(RECORDS, 'readonly', (s) => s.count(key))) > 0\n    },\n    async deleteRecords(keys) {\n      if (keys.length === 0) return\n      const db = await openDB()\n      const tx = db.transaction(RECORDS, 'readwrite')\n      const store = tx.objectStore(RECORDS)\n      for (const key of keys) store.delete(key)\n      await new Promise<void>((resolve, reject) => {\n        tx.oncomplete = () => resolve()\n        tx.onerror = () => reject(tx.error)\n        tx.onabort = () => reject(tx.error)\n      })\n    },\n    async recordsInBucket(bucket) {\n      return (await run(RECORDS, 'readonly', (s) =>\n        s.index('bucket').getAll(bucket)\n      )) as StoredRecord<K>[]\n    },\n    async recordsOfKind(kind) {\n      return (await run(RECORDS, 'readonly', (s) =>\n        s.index('kind').getAll(kind)\n      )) as StoredRecord<K>[]\n    },\n    allRecordSizes() {\n      return scan(({ key, kind, size }) => ({ key, kind, size }))\n    },\n    allRecordAccess() {\n      return scan(({ key, kind, lastAccess }) => ({ key, kind, lastAccess }))\n    },\n    async touchRecord(key) {\n      const record = await self.getRecord(key)\n      if (record) await self.putRecord({ ...record, lastAccess: Date.now() })\n    },\n    async getMeta<T>(key: string) {\n      const row = (await run(META, 'readonly', (s) => s.get(key))) as { value: T } | undefined\n      return row?.value\n    },\n    async setMeta(key, value) {\n      await run(META, 'readwrite', (s) => s.put({ key, value }))\n    },\n    async deleteDatabase() {\n      const db = await dbPromise?.catch(() => null)\n      db?.close()\n      dbPromise = null\n      await new Promise<void>((resolve, reject) => {\n        const request = indexedDB.deleteDatabase(dbName)\n        request.onsuccess = () => resolve()\n        request.onerror = () => reject(request.error)\n        // Another tab still holds it open: it closes on versionchange, then this completes.\n        request.onblocked = () => {}\n      })\n    },\n  }\n  return self\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/offline-store/wipe.js

@@ -0,0 +1,8 @@
+async function wipeStore(sealer, store) {
+  sealer.forget();
+  await store.deleteDatabase();
+}
+export {
+  wipeStore
+};
+//# sourceMappingURL=wipe.js.map

package/dist/offline-store/wipe.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/offline-store/wipe.ts"],
+  "sourcesContent": ["import type { OfflineSealer } from '@arbidocs/client'\nimport type { RecordStore } from './store'\n\n/** Forget a store's keys and delete its database. */\nexport async function wipeStore(sealer: OfflineSealer, store: RecordStore<string>): Promise<void> {\n  sealer.forget()\n  await store.deleteDatabase()\n}\n"],
+  "mappings": "AAIA,eAAsB,UAAU,QAAuB,OAA2C;AAChG,SAAO,OAAO;AACd,QAAM,MAAM,eAAe;AAC7B;",
+  "names": []
+}

package/dist/offline.js

@@ -0,0 +1,58 @@
+import { partialMatchKey } from "@tanstack/react-query";
+import { replayableTagMutations } from "./tags.js";
+import { replayableDocumentMutations } from "./documents/documents-writes.js";
+import { FINISHED_DOCUMENT_STATUSES } from "./documents/documents-data.js";
+import { QUEUED_WRITE_RETRY } from "./queued-writes.js";
+const REPLAYABLE = [
+  ...replayableTagMutations,
+  ...replayableDocumentMutations
+];
+function isReplayableArbiMutation(mutationKey) {
+  return !!mutationKey && REPLAYABLE.some((m) => partialMatchKey(mutationKey, m.mutationKey));
+}
+function registerArbiMutationDefaults(queryClient, client) {
+  for (const m of REPLAYABLE) {
+    queryClient.setMutationDefaults(m.mutationKey, {
+      // Each write is sent in the workspace it was made in (kept in its variables), never in the
+      // one open when it is replayed; one whose workspace can't be opened is tried again, then
+      // kept as not sent.
+      mutationFn: (variables) => m.run(client(), variables),
+      onSuccess: (data, variables) => m.settle(queryClient, data, variables),
+      ...QUEUED_WRITE_RETRY
+    });
+  }
+}
+const DOCUMENT_FAMILIES = [
+  "documents",
+  "document",
+  "documentsById",
+  "documentVersions",
+  "similarDocuments"
+];
+const OFFLINE_READABLE = [
+  ...DOCUMENT_FAMILIES,
+  "workspaces",
+  "userSettings",
+  "projects",
+  "entitlements"
+];
+function isOfflineReadableArbiQuery(queryKey) {
+  return queryKey[0] === "arbi" && OFFLINE_READABLE.includes(queryKey[1]);
+}
+function isRestorableArbiQueryOnline(queryKey, data) {
+  if (queryKey[0] !== "arbi") return true;
+  if (queryKey[1] === "documents" || queryKey[1] === "entitlements") return false;
+  if (!DOCUMENT_FAMILIES.includes(queryKey[1])) return true;
+  const docs = Array.isArray(data) ? data : [data];
+  return !docs.some((doc) => {
+    const status = doc?.status;
+    return !!status && !FINISHED_DOCUMENT_STATUSES.has(status);
+  });
+}
+export {
+  isOfflineReadableArbiQuery,
+  isReplayableArbiMutation,
+  isRestorableArbiQueryOnline,
+  registerArbiMutationDefaults
+};
+//# sourceMappingURL=offline.js.map

package/dist/offline.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/offline.ts"],
+  "sourcesContent": ["/**\n * Offline writes that survive a reload \u2014 opt in. A mutation made while offline pauses and is sent on\n * reconnect; a host that also persists its query cache (`@tanstack/react-query-persist-client`)\n * keeps the paused write across a reload, but the restored mutation has lost its function. Call\n * {@link registerArbiMutationDefaults} once on the query client, before the persisted cache is\n * restored and `resumePausedMutations()` runs: it gives each replayable package write its request\n * back (on a bare client: the hook's `Arbi` may not exist yet) and what its success does to the\n * cache. {@link isReplayableArbiMutation} says which writes those are, for a host's\n * `shouldDehydrateMutation` and its pending-changes list.\n *\n * Replayable: creating a tag (`useCreateTag`), editing documents' fields (`useUpdateDocuments`),\n * and applying, removing or re-noting a tag on documents (`useAssignDocTags`, `useRemoveDocTags`,\n * `useUpdateDocTag`). Each keeps the workspace it was made in and is replayed there\n * (`queued-writes.ts`), whichever workspace is open after the reload.\n */\n\nimport type { MutationKey, QueryClient, QueryKey } from '@tanstack/react-query'\nimport { partialMatchKey } from '@tanstack/react-query'\nimport type { ArbiClient } from '@arbidocs/client'\nimport { replayableTagMutations } from './tags'\nimport { replayableDocumentMutations } from './documents/documents-writes'\nimport { FINISHED_DOCUMENT_STATUSES } from './documents/documents-data'\nimport { QUEUED_WRITE_RETRY } from './queued-writes'\n\ninterface ReplayableMutation {\n  mutationKey: MutationKey\n  // Each entry types its own variables and result; the registry only passes them through.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  run: (client: ArbiClient, variables: any) => Promise<unknown>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  settle: (qc: QueryClient, data: any, variables: any) => unknown\n}\n\nconst REPLAYABLE: readonly ReplayableMutation[] = [\n  ...replayableTagMutations,\n  ...replayableDocumentMutations,\n]\n\n/** Whether a mutation is a package write that can be queued offline and replayed after a reload. */\nexport function isReplayableArbiMutation(mutationKey: MutationKey | undefined): boolean {\n  return !!mutationKey && REPLAYABLE.some((m) => partialMatchKey(mutationKey, m.mutationKey))\n}\n\n/**\n * Re-supply the replayable package writes on `queryClient` (see the module comment). `client` is\n * the host's API client, read when a restored write is sent.\n */\nexport function registerArbiMutationDefaults(\n  queryClient: QueryClient,\n  client: () => ArbiClient\n): void {\n  for (const m of REPLAYABLE) {\n    queryClient.setMutationDefaults(m.mutationKey, {\n      // Each write is sent in the workspace it was made in (kept in its variables), never in the\n      // one open when it is replayed; one whose workspace can't be opened is tried again, then\n      // kept as not sent.\n      mutationFn: (variables: unknown) => m.run(client(), variables),\n      onSuccess: (data: unknown, variables: unknown) => m.settle(queryClient, data, variables),\n      ...QUEUED_WRITE_RETRY,\n    })\n  }\n}\n\n/** The package query families holding document metadata (never content). */\nconst DOCUMENT_FAMILIES = [\n  'documents',\n  'document',\n  'documentsById',\n  'documentVersions',\n  'similarDocuments',\n]\n\n/**\n * The package query families a host may persist for an offline start. The entitlements too: the\n * paid pages (Mail, Calendar) open only once they are known, so without them a reopened tab offline\n * showed an empty page instead of the mailbox and Outbox kept on this device.\n */\nconst OFFLINE_READABLE = [\n  ...DOCUMENT_FAMILIES,\n  'workspaces',\n  'userSettings',\n  'projects',\n  'entitlements',\n]\n\n/**\n * Whether a package query is worth persisting for an offline start (a host's\n * `shouldDehydrateQuery`): the documents lists, documents, their versions and near-duplicate\n * pairs (metadata, never a document's content), the workspace list (its keys stay wrapped), the\n * user settings, the projects and the entitlements.\n */\nexport function isOfflineReadableArbiQuery(queryKey: QueryKey): boolean {\n  return queryKey[0] === 'arbi' && OFFLINE_READABLE.includes(queryKey[1] as string)\n}\n\n/**\n * Whether a persisted package query may be restored when the app starts online. Not a documents\n * list (it is never re-read on its own, so a stale copy would be trusted all session: it loads\n * fresh instead), nor a document saved while still processing (its saved freshness would keep it\n * \"processing\" with no re-read), nor the entitlements (kept for an offline start only: online they\n * are read fresh, so a plan bought since shows at once). The other families (the workspace list,\n * the settings) always. Offline, everything persisted is restored.\n */\nexport function isRestorableArbiQueryOnline(queryKey: QueryKey, data: unknown): boolean {\n  if (queryKey[0] !== 'arbi') return true\n  if (queryKey[1] === 'documents' || queryKey[1] === 'entitlements') return false\n  if (!DOCUMENT_FAMILIES.includes(queryKey[1] as string)) return true\n  const docs = Array.isArray(data) ? data : [data]\n  return !docs.some((doc) => {\n    const status = (doc as { status?: string | null } | null)?.status\n    return !!status && !FINISHED_DOCUMENT_STATUSES.has(status)\n  })\n}\n"],
+  "mappings": "AAiBA,SAAS,uBAAuB;AAEhC,SAAS,8BAA8B;AACvC,SAAS,mCAAmC;AAC5C,SAAS,kCAAkC;AAC3C,SAAS,0BAA0B;AAWnC,MAAM,aAA4C;AAAA,EAChD,GAAG;AAAA,EACH,GAAG;AACL;AAGO,SAAS,yBAAyB,aAA+C;AACtF,SAAO,CAAC,CAAC,eAAe,WAAW,KAAK,CAAC,MAAM,gBAAgB,aAAa,EAAE,WAAW,CAAC;AAC5F;AAMO,SAAS,6BACd,aACA,QACM;AACN,aAAW,KAAK,YAAY;AAC1B,gBAAY,oBAAoB,EAAE,aAAa;AAAA;AAAA;AAAA;AAAA,MAI7C,YAAY,CAAC,cAAuB,EAAE,IAAI,OAAO,GAAG,SAAS;AAAA,MAC7D,WAAW,CAAC,MAAe,cAAuB,EAAE,OAAO,aAAa,MAAM,SAAS;AAAA,MACvF,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;AAGA,MAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOA,MAAM,mBAAmB;AAAA,EACvB,GAAG;AAAA,EACH;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQO,SAAS,2BAA2B,UAA6B;AACtE,SAAO,SAAS,CAAC,MAAM,UAAU,iBAAiB,SAAS,SAAS,CAAC,CAAW;AAClF;AAUO,SAAS,4BAA4B,UAAoB,MAAwB;AACtF,MAAI,SAAS,CAAC,MAAM,OAAQ,QAAO;AACnC,MAAI,SAAS,CAAC,MAAM,eAAe,SAAS,CAAC,MAAM,eAAgB,QAAO;AAC1E,MAAI,CAAC,kBAAkB,SAAS,SAAS,CAAC,CAAW,EAAG,QAAO;AAC/D,QAAM,OAAO,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC/C,SAAO,CAAC,KAAK,KAAK,CAAC,QAAQ;AACzB,UAAM,SAAU,KAA2C;AAC3D,WAAO,CAAC,CAAC,UAAU,CAAC,2BAA2B,IAAI,MAAM;AAAA,EAC3D,CAAC;AACH;",
+  "names": []
+}

package/dist/people.js

@@ -0,0 +1,122 @@
+import { useMemo } from "react";
+import { useAgents, useWorkspaces } from "./hooks.js";
+import { useContacts, useSearchContacts } from "./contacts.js";
+import { useArbi } from "./useArbi.js";
+import { getUserDisplayName, isAgent } from "./users/user-display.js";
+function peopleDirectory(people, meId) {
+  const ids = /* @__PURE__ */ new Map();
+  const emails = /* @__PURE__ */ new Map();
+  for (const p of people) {
+    if (p.user && p.user.external_id !== meId && !ids.has(p.user.external_id))
+      ids.set(p.user.external_id, p.user);
+    const key = p.email.toLowerCase();
+    if (key && !emails.has(key)) emails.set(key, p);
+  }
+  const users = [...ids.values()].sort(
+    (a, b) => getUserDisplayName(a).localeCompare(getUserDisplayName(b))
+  );
+  return {
+    users,
+    byId: (id) => id ? ids.get(id) : void 0,
+    byEmail: (email) => email ? emails.get(email.toLowerCase()) : void 0
+  };
+}
+function personOfUser(user, contactId = null) {
+  return {
+    email: user.email,
+    name: getUserDisplayName(user) || user.email,
+    user,
+    contactId,
+    addressBookId: null
+  };
+}
+function cardName(contact) {
+  return contact.card?.name?.trim() || [contact.card?.given_name, contact.card?.family_name].filter(Boolean).join(" ");
+}
+function userFromName(externalId, email, name) {
+  const [given = "", ...rest] = (name || email).trim().split(/\s+/);
+  return { external_id: externalId, email, given_name: given, family_name: rest.join(" ") };
+}
+function usePeople() {
+  const arbi = useArbi();
+  const meId = arbi.isLoggedIn ? arbi.user.identity()?.externalId : void 0;
+  const { data: contacts = [] } = useContacts();
+  const { data: workspaces = [] } = useWorkspaces();
+  const { data: agents = [] } = useAgents();
+  return useMemo(() => {
+    const people = [];
+    const contactOf = /* @__PURE__ */ new Map();
+    for (const c of contacts) {
+      if (c.status === "failed" || c.user && isAgent(c.user)) continue;
+      if (c.user) contactOf.set(c.user.external_id, c);
+      const addresses = [
+        c.email ?? c.user?.email,
+        ...(c.card?.emails ?? []).map((e) => e.email)
+      ].filter((e) => !!e);
+      const user = c.status === "registered" ? c.user ?? null : null;
+      for (const email of new Set(addresses))
+        people.push({
+          email,
+          name: cardName(c) || (user ? getUserDisplayName(user) : "") || email,
+          user,
+          contactId: c.external_id ?? null,
+          addressBookId: c.address_book_ext_id ?? null
+        });
+    }
+    const addUser = (user) => {
+      const contact = contactOf.get(user.external_id);
+      people.push({
+        email: user.email,
+        name: getUserDisplayName(user) || user.email,
+        user,
+        contactId: contact?.external_id ?? null,
+        addressBookId: contact?.address_book_ext_id ?? null
+      });
+    };
+    for (const ws of workspaces) for (const wu of ws.users ?? []) addUser(wu.user);
+    for (const agent of agents) addUser(agent);
+    return peopleDirectory(people, meId);
+  }, [contacts, workspaces, agents, meId]);
+}
+function usePeopleSearch(query, { agents = false } = {}) {
+  const arbi = useArbi();
+  const meId = arbi.isLoggedIn ? arbi.user.identity()?.externalId : void 0;
+  const directory = usePeople();
+  const search = useSearchContacts(query);
+  const term = query.trim().toLowerCase();
+  const hits = search.data;
+  const people = useMemo(() => {
+    if (!term) return [];
+    const out = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const hit of hits ?? []) {
+      if (hit.user_id === meId || seen.has(hit.email.toLowerCase())) continue;
+      seen.add(hit.email.toLowerCase());
+      const user = hit.user_id ? directory.byId(hit.user_id) ?? userFromName(hit.user_id, hit.email, hit.name) : null;
+      if (user && isAgent(user)) continue;
+      out.push({
+        email: hit.email,
+        name: hit.name || (user ? getUserDisplayName(user) : "") || hit.email,
+        user,
+        contactId: hit.contact_id ?? null,
+        addressBookId: hit.address_book_ext_id ?? null
+      });
+    }
+    if (agents)
+      for (const user of directory.users) {
+        if (!isAgent(user) || seen.has(user.email.toLowerCase())) continue;
+        const name = getUserDisplayName(user);
+        if (!`${name} ${user.email}`.toLowerCase().includes(term)) continue;
+        out.push({ email: user.email, name, user, contactId: null, addressBookId: null });
+      }
+    return out;
+  }, [term, hits, directory, agents, meId]);
+  return { people, isFetching: search.isFetching };
+}
+export {
+  peopleDirectory,
+  personOfUser,
+  usePeople,
+  usePeopleSearch
+};
+//# sourceMappingURL=people.js.map

package/dist/people.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/people.ts"],
+  "sourcesContent": ["/**\n * People \u2014 the one place an app learns who someone is.\n *\n * Pickers and autocomplete ask {@link usePeopleSearch}: GET /v1/contacts/search (every address book you can see\n * plus registered people who share a workspace with you, one entry per address), and your own agents where an\n * agent is a valid target. Resolving an id or address seen elsewhere (a DM tab, a tag's creator, a mail\n * recipient) asks {@link usePeople}: the same population, held as a directory \u2014 your contacts, your workspace\n * co-members and your agents. Nothing is learned from notifications.\n */\n\nimport { useMemo } from 'react'\nimport type { components } from '@arbidocs/client'\nimport type { contacts as contactsOps } from '@arbidocs/sdk/browser'\nimport { useAgents, useWorkspaces } from './hooks'\nimport { useContacts, useSearchContacts } from './contacts'\nimport { useArbi } from './useArbi'\nimport { getUserDisplayName, isAgent } from './users/user-display'\n\n/** An ARBI account (or agent) as the API returns it. */\nexport type UserResponse = components['schemas']['UserResponse']\ntype Contact = contactsOps.Contact\n\n// \u2500\u2500 The directory (pure) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 Person {\n  email: string\n  /** Display name: the card's name, else the account's, else the address. */\n  name: string\n  /** The ARBI account (or agent), when the person has one. Null: a contact who is not on ARBI. */\n  user: UserResponse | null\n  /** `cnt-\u2026` when the person is one of the contacts you can see. */\n  contactId: string | null\n  /** `cal-\u2026` of the address book that contact is in. */\n  addressBookId: string | null\n}\n\nexport interface PeopleDirectory {\n  /** Registered people and agents, sorted by name (never you). */\n  users: UserResponse[]\n  byId: (externalId: string | null | undefined) => UserResponse | undefined\n  byEmail: (email: string | null | undefined) => Person | undefined\n}\n\n/** Index people by account id and by every address they have. Pure, so tests can build one. */\nexport function peopleDirectory(people: Person[], meId?: string | null): PeopleDirectory {\n  const ids = new Map<string, UserResponse>()\n  const emails = new Map<string, Person>()\n  for (const p of people) {\n    if (p.user && p.user.external_id !== meId && !ids.has(p.user.external_id))\n      ids.set(p.user.external_id, p.user)\n    const key = p.email.toLowerCase()\n    if (key && !emails.has(key)) emails.set(key, p)\n  }\n  const users = [...ids.values()].sort((a, b) =>\n    getUserDisplayName(a).localeCompare(getUserDisplayName(b))\n  )\n  return {\n    users,\n    byId: (id) => (id ? ids.get(id) : undefined),\n    byEmail: (email) => (email ? emails.get(email.toLowerCase()) : undefined),\n  }\n}\n\n/** A registered person (or agent) as a {@link Person}. */\nexport function personOfUser(user: UserResponse, contactId: string | null = null): Person {\n  return {\n    email: user.email,\n    name: getUserDisplayName(user) || user.email,\n    user,\n    contactId,\n    addressBookId: null,\n  }\n}\n\n// \u2500\u2500 The 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\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction cardName(contact: Contact): string {\n  return (\n    contact.card?.name?.trim() ||\n    [contact.card?.given_name, contact.card?.family_name].filter(Boolean).join(' ')\n  )\n}\n\n/** A stand-in account for a search hit whose full record the directory does not hold. */\nfunction userFromName(externalId: string, email: string, name: string | null | undefined) {\n  const [given = '', ...rest] = (name || email).trim().split(/\\s+/)\n  return { external_id: externalId, email, given_name: given, family_name: rest.join(' ') }\n}\n\n/** Everyone you know, for resolving an id or an address to a person. */\nexport function usePeople(): PeopleDirectory {\n  const arbi = useArbi()\n  const meId = arbi.isLoggedIn ? arbi.user.identity()?.externalId : undefined\n  const { data: contacts = [] } = useContacts()\n  const { data: workspaces = [] } = useWorkspaces()\n  const { data: agents = [] } = useAgents()\n\n  return useMemo(() => {\n    const people: Person[] = []\n    const contactOf = new Map<string, Contact>()\n    for (const c of contacts) {\n      if (c.status === 'failed' || (c.user && isAgent(c.user))) continue\n      if (c.user) contactOf.set(c.user.external_id, c)\n      const addresses = [\n        c.email ?? c.user?.email,\n        ...(c.card?.emails ?? []).map((e) => e.email),\n      ].filter((e): e is string => !!e)\n      const user = c.status === 'registered' ? (c.user ?? null) : null\n      for (const email of new Set(addresses))\n        people.push({\n          email,\n          name: cardName(c) || (user ? getUserDisplayName(user) : '') || email,\n          user,\n          contactId: c.external_id ?? null,\n          addressBookId: c.address_book_ext_id ?? null,\n        })\n    }\n    const addUser = (user: UserResponse) => {\n      const contact = contactOf.get(user.external_id)\n      people.push({\n        email: user.email,\n        name: getUserDisplayName(user) || user.email,\n        user,\n        contactId: contact?.external_id ?? null,\n        addressBookId: contact?.address_book_ext_id ?? null,\n      })\n    }\n    for (const ws of workspaces) for (const wu of ws.users ?? []) addUser(wu.user as UserResponse)\n    for (const agent of agents) addUser(agent as UserResponse)\n    return peopleDirectory(people, meId)\n  }, [contacts, workspaces, agents, meId])\n}\n\n/**\n * People matching `query` (debounced; an empty query matches nobody), for a picker or an autocomplete.\n * `agents`: also your own agents whose name or address matches \u2014 only where an agent is a valid target.\n */\nexport function usePeopleSearch(\n  query: string,\n  { agents = false }: { agents?: boolean } = {}\n): { people: Person[]; isFetching: boolean } {\n  const arbi = useArbi()\n  const meId = arbi.isLoggedIn ? arbi.user.identity()?.externalId : undefined\n  const directory = usePeople()\n  const search = useSearchContacts(query)\n  const term = query.trim().toLowerCase()\n  const hits = search.data\n\n  const people = useMemo(() => {\n    if (!term) return []\n    const out: Person[] = []\n    const seen = new Set<string>()\n    for (const hit of hits ?? []) {\n      if (hit.user_id === meId || seen.has(hit.email.toLowerCase())) continue\n      seen.add(hit.email.toLowerCase())\n      const user = hit.user_id\n        ? (directory.byId(hit.user_id) ??\n          (userFromName(hit.user_id, hit.email, hit.name) as UserResponse))\n        : null\n      if (user && isAgent(user)) continue\n      out.push({\n        email: hit.email,\n        name: hit.name || (user ? getUserDisplayName(user) : '') || hit.email,\n        user,\n        contactId: hit.contact_id ?? null,\n        addressBookId: hit.address_book_ext_id ?? null,\n      })\n    }\n    if (agents)\n      for (const user of directory.users) {\n        if (!isAgent(user) || seen.has(user.email.toLowerCase())) continue\n        const name = getUserDisplayName(user)\n        if (!`${name} ${user.email}`.toLowerCase().includes(term)) continue\n        out.push({ email: user.email, name, user, contactId: null, addressBookId: null })\n      }\n    return out\n  }, [term, hits, directory, agents, meId])\n\n  return { people, isFetching: search.isFetching }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/projects.js

@@ -0,0 +1,30 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "./useArbi.js";
+import { arbiQueryKeys } from "./hooks.js";
+function useUpdateProjectFields() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      projectExtId,
+      patch
+    }) => arbi.projects.update(projectExtId, patch),
+    onSuccess: () => {
+      void qc.invalidateQueries({ queryKey: arbiQueryKeys.projects() });
+      void qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() });
+    }
+  });
+}
+function useProjectConversationUsage(projectExtId, monthsBack = 0, options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys.projectConversationUsage(projectExtId ?? "", monthsBack),
+    queryFn: () => arbi.projects.usageByConversation(projectExtId, monthsBack),
+    enabled: (options?.enabled ?? true) && !!projectExtId && arbi.isLoggedIn
+  });
+}
+export {
+  useProjectConversationUsage,
+  useUpdateProjectFields
+};
+//# sourceMappingURL=projects.js.map

package/dist/projects.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/projects.ts"],
+  "sourcesContent": ["/**\n * Project details (budget, client, stage, lead, fields) and spend by conversation.\n *\n * Requires an `ArbiHost` (with an `arbi`) and a React Query client above it.\n */\n\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport type {\n  ProjectConversationUsageResponse,\n  ProjectResponse,\n  ProjectUpdateRequest,\n} from '@arbidocs/sdk/browser'\nimport { useArbi } from './useArbi'\nimport { arbiQueryKeys } from './hooks'\n\n/**\n * Patch a project (owner only): name, daily cap, and the details a host sets (`budget` in minor\n * units, `client`, `client_ref`, `stage`, `lead_user`, `fields` merged key by key, `field_schema`).\n * The project list and the workspace list (which carries project names) refresh.\n */\nexport function useUpdateProjectFields() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation({\n    mutationFn: ({\n      projectExtId,\n      patch,\n    }: {\n      projectExtId: string\n      patch: ProjectUpdateRequest\n    }): Promise<ProjectResponse> => arbi.projects.update(projectExtId, patch),\n    onSuccess: () => {\n      void qc.invalidateQueries({ queryKey: arbiQueryKeys.projects() })\n      // Each workspace carries its project's name: a rename shows there at once.\n      void qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() })\n    },\n  })\n}\n\n/** A project's spend by conversation (and what no conversation accounts for), in \u00A3. */\nexport function useProjectConversationUsage(\n  projectExtId: string | undefined,\n  monthsBack: number = 0,\n  options?: { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.projectConversationUsage(projectExtId ?? '', monthsBack),\n    queryFn: (): Promise<ProjectConversationUsageResponse> =>\n      arbi.projects.usageByConversation(projectExtId as string, monthsBack),\n    enabled: (options?.enabled ?? true) && !!projectExtId && arbi.isLoggedIn,\n  })\n}\n"],
+  "mappings": "AAMA,SAAS,aAAa,UAAU,sBAAsB;AAMtD,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAOvB,SAAS,yBAAyB;AACvC,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAK,eAAe;AAC1B,SAAO,YAAY;AAAA,IACjB,YAAY,CAAC;AAAA,MACX;AAAA,MACA;AAAA,IACF,MAGgC,KAAK,SAAS,OAAO,cAAc,KAAK;AAAA,IACxE,WAAW,MAAM;AACf,WAAK,GAAG,kBAAkB,EAAE,UAAU,cAAc,SAAS,EAAE,CAAC;AAEhE,WAAK,GAAG,kBAAkB,EAAE,UAAU,cAAc,WAAW,EAAE,CAAC;AAAA,IACpE;AAAA,EACF,CAAC;AACH;AAGO,SAAS,4BACd,cACA,aAAqB,GACrB,SACA;AACA,QAAM,OAAO,QAAQ;AACrB,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,yBAAyB,gBAAgB,IAAI,UAAU;AAAA,IAC/E,SAAS,MACP,KAAK,SAAS,oBAAoB,cAAwB,UAAU;AAAA,IACtE,UAAU,SAAS,WAAW,SAAS,CAAC,CAAC,gBAAgB,KAAK;AAAA,EAChE,CAAC;AACH;",
+  "names": []
+}

package/dist/query-client.js

@@ -0,0 +1,63 @@
+import { MutationCache, QueryClient } from "@tanstack/react-query";
+import { isAbortError, SETTINGS_WRITE_BREAKER_CODE } from "@arbidocs/client";
+import { notify } from "./notifications/notify-store.js";
+import { createArbiQueryPersistOptions } from "./query-persist.js";
+function isClientError(error) {
+  if (error && typeof error === "object" && "status" in error) {
+    const status = error.status;
+    if (typeof status === "number" && status >= 400 && status < 500) {
+      if (status === 408 || status === 429) return false;
+      return true;
+    }
+  }
+  return false;
+}
+function retryDelay(attempt) {
+  return Math.min(1e3 * 2 ** attempt, 3e4) + Math.random() * 500;
+}
+function shouldRetryQuery(failureCount, error) {
+  return failureCount < 2 && !isClientError(error) && !isAbortError(error);
+}
+const BREAKER_NOTICE_MS = 6e4;
+function createArbiQueryClient({
+  persist = false
+} = {}) {
+  let breakerNoticeAt = -Infinity;
+  const queryClient = new QueryClient({
+    mutationCache: new MutationCache({
+      onError: (error) => {
+        const { detail, code } = error ?? {};
+        if (detail === "account_deletion_pending") {
+          notify.error("Your account is read-only while deletion is pending.");
+        }
+        if (code === SETTINGS_WRITE_BREAKER_CODE && Date.now() - breakerNoticeAt > BREAKER_NOTICE_MS) {
+          breakerNoticeAt = Date.now();
+          notify.warning("Settings are being saved too frequently", {
+            description: "Some changes were not saved. Refresh the page if this keeps happening.",
+            duration: 1e4
+          });
+        }
+      }
+    }),
+    defaultOptions: {
+      queries: {
+        staleTime: 1e3 * 60 * 5,
+        refetchOnWindowFocus: false,
+        retry: shouldRetryQuery,
+        retryDelay,
+        gcTime: 1e3 * 60 * 30
+      },
+      mutations: {
+        retry: false
+      }
+    }
+  });
+  return { queryClient, persistOptions: persist ? createArbiQueryPersistOptions() : null };
+}
+export {
+  createArbiQueryClient,
+  isClientError,
+  retryDelay,
+  shouldRetryQuery
+};
+//# sourceMappingURL=query-client.js.map

package/dist/query-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/query-client.ts"],
+  "sourcesContent": ["/**\n * The React Query client every ARBI host shares: ARBI-frontend's own, and a blocks-only site's\n * through `defaultHost`. Call once per page, at module scope.\n *\n *   const { queryClient } = createArbiQueryClient()\n *   const { queryClient, persistOptions } = createArbiQueryClient({ persist: true })\n *   <PersistQueryClientProvider client={queryClient} persistOptions={persistOptions}>\n *\n * Reads are fresh for 5 minutes and kept 30, are not re-read on window focus, and retry twice\n * with backoff, never on a 4xx (but 408/429) nor on a read a sign-out aborted. Writes never retry.\n * A write refused because the account's deletion is pending, or dropped by the client's settings\n * write breaker, tells the user. With `persist`, the offline slice of the cache is kept on this\n * device (`query-persist.ts`). Sign-out and sign-in clear it with `queryClient.clear()`; the same\n * client stays, so the provider and every hook keep theirs.\n */\n\nimport { MutationCache, QueryClient } from '@tanstack/react-query'\nimport { isAbortError, SETTINGS_WRITE_BREAKER_CODE } from '@arbidocs/client'\nimport { notify } from './notifications/notify-store'\nimport { createArbiQueryPersistOptions, type ArbiQueryPersistOptions } from './query-persist'\n\n/**\n * Returns true for HTTP 4xx errors that should NOT be retried, except for\n * 408 (Request Timeout) and 429 (Too Many Requests) which are transient\n * and worth retrying.\n *\n * Auth errors (401/403) are already handled by the client's re-login, so\n * React Query does not stack additional retries on top of its retry.\n */\nexport function isClientError(error: unknown): boolean {\n  if (error && typeof error === 'object' && 'status' in error) {\n    const status = (error as { status?: number }).status\n    if (typeof status === 'number' && status >= 400 && status < 500) {\n      // Transient client errors \u2014 allow retry\n      if (status === 408 || status === 429) return false\n      return true\n    }\n  }\n  return false\n}\n\n/**\n * Exponential backoff with jitter.\n * attempt 0 \u2192 ~1 s, attempt 1 \u2192 ~2 s, capped at 30 s.\n */\nexport function retryDelay(attempt: number): number {\n  return Math.min(1000 * 2 ** attempt, 30_000) + Math.random() * 500\n}\n\n/** Whether a failed read is tried again (`failureCount` failures so far). */\nexport function shouldRetryQuery(failureCount: number, error: unknown): boolean {\n  return failureCount < 2 && !isClientError(error) && !isAbortError(error)\n}\n\n// A write storm fails hundreds of writes a minute: tell the user once per minute, not per write.\nconst BREAKER_NOTICE_MS = 60_000\n\nexport interface ArbiQueryClientOptions {\n  /** Keep the offline slice of the cache on this device, for an offline start. */\n  persist?: boolean\n}\n\nexport interface ArbiQueryClient {\n  queryClient: QueryClient\n  /** For `<PersistQueryClientProvider persistOptions>`; `null` without `persist`. */\n  persistOptions: ArbiQueryPersistOptions | null\n}\n\n/** The shared React Query client (see the module comment). */\nexport function createArbiQueryClient(options: {\n  persist: true\n}): ArbiQueryClient & { persistOptions: ArbiQueryPersistOptions }\nexport function createArbiQueryClient(options?: ArbiQueryClientOptions): ArbiQueryClient\nexport function createArbiQueryClient({\n  persist = false,\n}: ArbiQueryClientOptions = {}): ArbiQueryClient {\n  let breakerNoticeAt = -Infinity\n  const queryClient = new QueryClient({\n    mutationCache: new MutationCache({\n      onError: (error: unknown) => {\n        const { detail, code } = (error ?? {}) as { detail?: unknown; code?: unknown }\n        // The structured 403 of an account whose deletion is pending.\n        if (detail === 'account_deletion_pending') {\n          notify.error('Your account is read-only while deletion is pending.')\n        }\n        if (\n          code === SETTINGS_WRITE_BREAKER_CODE &&\n          Date.now() - breakerNoticeAt > BREAKER_NOTICE_MS\n        ) {\n          breakerNoticeAt = Date.now()\n          notify.warning('Settings are being saved too frequently', {\n            description: 'Some changes were not saved. Refresh the page if this keeps happening.',\n            duration: 10_000,\n          })\n        }\n      },\n    }),\n    defaultOptions: {\n      queries: {\n        staleTime: 1000 * 60 * 5,\n        refetchOnWindowFocus: false,\n        retry: shouldRetryQuery,\n        retryDelay,\n        gcTime: 1000 * 60 * 30,\n      },\n      mutations: {\n        retry: false,\n      },\n    },\n  })\n  return { queryClient, persistOptions: persist ? createArbiQueryPersistOptions() : null }\n}\n"],
+  "mappings": "AAgBA,SAAS,eAAe,mBAAmB;AAC3C,SAAS,cAAc,mCAAmC;AAC1D,SAAS,cAAc;AACvB,SAAS,qCAAmE;AAUrE,SAAS,cAAc,OAAyB;AACrD,MAAI,SAAS,OAAO,UAAU,YAAY,YAAY,OAAO;AAC3D,UAAM,SAAU,MAA8B;AAC9C,QAAI,OAAO,WAAW,YAAY,UAAU,OAAO,SAAS,KAAK;AAE/D,UAAI,WAAW,OAAO,WAAW,IAAK,QAAO;AAC7C,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAMO,SAAS,WAAW,SAAyB;AAClD,SAAO,KAAK,IAAI,MAAO,KAAK,SAAS,GAAM,IAAI,KAAK,OAAO,IAAI;AACjE;AAGO,SAAS,iBAAiB,cAAsB,OAAyB;AAC9E,SAAO,eAAe,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,aAAa,KAAK;AACzE;AAGA,MAAM,oBAAoB;AAkBnB,SAAS,sBAAsB;AAAA,EACpC,UAAU;AACZ,IAA4B,CAAC,GAAoB;AAC/C,MAAI,kBAAkB;AACtB,QAAM,cAAc,IAAI,YAAY;AAAA,IAClC,eAAe,IAAI,cAAc;AAAA,MAC/B,SAAS,CAAC,UAAmB;AAC3B,cAAM,EAAE,QAAQ,KAAK,IAAK,SAAS,CAAC;AAEpC,YAAI,WAAW,4BAA4B;AACzC,iBAAO,MAAM,sDAAsD;AAAA,QACrE;AACA,YACE,SAAS,+BACT,KAAK,IAAI,IAAI,kBAAkB,mBAC/B;AACA,4BAAkB,KAAK,IAAI;AAC3B,iBAAO,QAAQ,2CAA2C;AAAA,YACxD,aAAa;AAAA,YACb,UAAU;AAAA,UACZ,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF,CAAC;AAAA,IACD,gBAAgB;AAAA,MACd,SAAS;AAAA,QACP,WAAW,MAAO,KAAK;AAAA,QACvB,sBAAsB;AAAA,QACtB,OAAO;AAAA,QACP;AAAA,QACA,QAAQ,MAAO,KAAK;AAAA,MACtB;AAAA,MACA,WAAW;AAAA,QACT,OAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF,CAAC;AACD,SAAO,EAAE,aAAa,gBAAgB,UAAU,8BAA8B,IAAI,KAAK;AACzF;",
+  "names": []
+}

package/dist/{query-keys.d-ChgpJLPF.d.ts → query-keys.d-B1Am9tIF.d.ts}

@@ -155,7 +155,7 @@ declare const arbiQueryKeys: {
      * `['arbi', 'databases', 'rows', workspaceId, databaseId, params]`.
      */
     databaseRows: (workspaceId?: string, databaseId?: string, params?: object) => readonly ["arbi", "databases", "rows"] | readonly ["arbi", "databases", "rows", string, string] | readonly ["arbi", "databases", "rows", string, string, object];
-    /** The saved dashboards of a store's scope (a workspace). */
+    /** The saved dashboards of a store's scope (the user's own, or a workspace's database). */
     dashboards: (scope: string) => readonly ["arbi", "dashboards", string];
     /** A database's rows grouped and measured (a chart); no workspace: every database's. */
     databaseAggregate: (workspaceId?: string, databaseId?: string, request?: object) => readonly ["arbi", "databases", "aggregate"] | readonly ["arbi", "databases", "aggregate", string, string, object];