@ai-matrx/records 0.80.8 → 0.81.1

package/dist/react/index.cjs

@@ -86,6 +86,8 @@ __export(react_exports, {
   RULE_USES: () => RULE_USES,
   RecordsHoldScope: () => RecordsHoldScope,
   RecordsProvider: () => RecordsProvider,
+  RecordsSeedProvider: () => RecordsSeedProvider,
+  SEED_FRESH_MS: () => SEED_FRESH_MS,
   SHOWN_TO_LABEL: () => SHOWN_TO_LABEL,
   SHOWN_TO_VALUES: () => SHOWN_TO_VALUES,
   SHOWN_TO_WHO_MAY_CHANGE: () => SHOWN_TO_WHO_MAY_CHANGE,
@@ -277,6 +279,7 @@ __export(react_exports, {
   useReverseColumns: () => useReverseColumns,
   useReverseLinks: () => useReverseLinks,
   useRowActions: () => useRowActions,
+  useSeededAnswer: () => useSeededAnswer,
   useStoreTable: () => useStoreTable,
   useTable: () => useTable,
   useTableArchive: () => useTableArchive,
@@ -300,6 +303,10 @@ function registry() {
   return g[REGISTRY] ??= /* @__PURE__ */ new Map();
 }
 var primedKey = (organizationId, tableId, viewId) => `${organizationId}|${tableId}|${viewId ?? ""}`;
+function primeTablePageBundle(input) {
+  const answer = Promise.resolve(input.answer).catch((thrown) => ({ data: null, error: thrown }));
+  registry().set(primedKey(input.organizationId, input.tableId, input.viewId), { answer, at: Date.now() });
+}
 function takePrimedTablePageBundle(organizationId, tableId, viewId) {
   if (!organizationId) return null;
   const key = primedKey(organizationId, tableId, viewId);
@@ -309,6 +316,9 @@ function takePrimedTablePageBundle(organizationId, tableId, viewId) {
   primed.delete(key);
   return Date.now() - held.at < PRIMED_TTL_MS ? held.answer : null;
 }
+function primeRecordPageBundle(input) {
+  primeTablePageBundle({ organizationId: input.organizationId, tableId: `record:${input.recordId}`, answer: input.answer });
+}
 
 // src/core/recordChanges.ts
 var listeners = /* @__PURE__ */ new Set();
@@ -426,8 +436,8 @@ function liftWithheld(rows) {
 }
 
 // src/subscription.ts
-function hasQuietHours(quiet) {
-  return Boolean(quiet?.start && quiet?.end);
+function hasQuietHours(quiet2) {
+  return Boolean(quiet2?.start && quiet2?.end);
 }
 function callersTimeZone() {
   try {
@@ -7851,7 +7861,7 @@ function useRecordsActor() {
 }
 
 // src/react/hooks.ts
-var import_react3 = require("react");
+var import_react4 = require("react");
 
 // src/react/dataCache.ts
 var RECORDS_CACHE_GRACE_MS = 3e4;
@@ -8004,6 +8014,12 @@ function releaseEntry(handle) {
   entry.refs = Math.max(0, entry.refs - 1);
   if (entry.refs === 0) scheduleClose(entry);
 }
+function seedEntry(handle, data, stale) {
+  const entry = handle;
+  if (entry.started || entry.snapshot.data !== null) return;
+  entry.snapshot = { data, loading: false, error: null };
+  entry.started = !stale;
+}
 function openHold(holdKey) {
   const holds = root().holds;
   let hold = holds.get(holdKey);
@@ -8034,65 +8050,215 @@ function recordsCacheCounters() {
   return { ...root().counters };
 }
 
-// src/react/hold.tsx
+// src/react/seed.tsx
 var import_react2 = require("react");
-var HoldContext = (0, import_react2.createContext)(null);
+
+// src/core/seed.ts
+var BUNDLE_DOORS = /* @__PURE__ */ new Set(["table_page_bundle", "record_page_bundle"]);
+function seedKey(door, args) {
+  return `${door}|${canonicalArgs(args)}`;
+}
+function answersOf(door, args, data) {
+  const out = [{ door, args, data }];
+  if (!BUNDLE_DOORS.has(door) || !data || typeof data !== "object") return out;
+  const parts = data.parts;
+  if (!Array.isArray(parts)) return out;
+  for (const part of parts) {
+    if (part.error !== void 0 || part.data === void 0) continue;
+    if (typeof part.door !== "string" || !part.args || typeof part.args !== "object") continue;
+    out.push({ door: part.door, args: part.args, data: part.data });
+  }
+  return out;
+}
+function seedIndex(seed) {
+  const index = /* @__PURE__ */ new Map();
+  for (const a of seed.answers) {
+    for (const spread of answersOf(a.door, a.args, a.data)) index.set(seedKey(spread.door, spread.args), spread.data);
+  }
+  return index;
+}
+var MISS = { code: "SEED_MISS", message: "Not in the page's seed.", details: null, hint: null };
+function missingQuery(onMiss) {
+  const answer = () => {
+    onMiss();
+    return Promise.resolve({ data: null, error: MISS, count: null });
+  };
+  const chain = new Proxy(function() {
+  }, {
+    get(_target, prop) {
+      if (prop === "then") return (ok2, bad) => answer().then(ok2, bad);
+      return () => chain;
+    },
+    apply: () => chain
+  });
+  return { select: () => chain };
+}
+function seededDataSource(index) {
+  let missed = false;
+  const source = {
+    rpc(fn, args) {
+      const key = seedKey(fn, args);
+      if (index.has(key)) return Promise.resolve({ data: index.get(key), error: null });
+      missed = true;
+      return Promise.resolve({ data: null, error: MISS });
+    },
+    schema: () => ({ from: () => missingQuery(() => missed = true) })
+  };
+  return { source, missed: () => missed };
+}
+
+// src/react/seed.tsx
+var SEED_FRESH_MS = 3e4;
+var stores = /* @__PURE__ */ new WeakMap();
+var quiet = () => {
+};
+function storeFor(seed) {
+  const held = stores.get(seed);
+  if (held) return held;
+  const index = seedIndex(seed);
+  const runs = /* @__PURE__ */ new Map();
+  const store = {
+    live: true,
+    run(slot, run, config) {
+      const asked = runs.get(slot);
+      if (asked) return asked;
+      const { source, missed } = seededDataSource(index);
+      const { realtime: _live, ...quietConfig } = config;
+      const client = createRecordsClient({ ...quietConfig, dataSource: source, onError: quiet });
+      const stale = typeof seed.at !== "number" || Date.now() - seed.at > SEED_FRESH_MS;
+      const outcome = Promise.resolve().then(() => run(client)).then(
+        (answer) => answer.ok && !missed() ? { seeded: true, data: answer.data, stale } : { seeded: false },
+        () => ({ seeded: false })
+      );
+      runs.set(slot, outcome);
+      return outcome;
+    }
+  };
+  stores.set(seed, store);
+  if (typeof window !== "undefined") {
+    for (const a of seed.answers) {
+      const org = a.args["p_organization_id"];
+      if (typeof org !== "string") continue;
+      if (a.door === "table_page_bundle" && typeof a.args["p_table_id"] === "string") {
+        const view = a.args["p_view_id"];
+        primeTablePageBundle({ organizationId: org, tableId: a.args["p_table_id"], viewId: typeof view === "string" ? view : null, answer: { data: a.data, error: null } });
+      } else if (a.door === "record_page_bundle" && typeof a.args["p_record_id"] === "string") {
+        primeRecordPageBundle({ organizationId: org, recordId: a.args["p_record_id"], answer: { data: a.data, error: null } });
+      }
+    }
+  }
+  return store;
+}
+var SeedContext = (0, import_react2.createContext)(null);
+function RecordsSeedProvider({ seed, children }) {
+  const store = seed && Array.isArray(seed.answers) ? storeFor(seed) : null;
+  (0, import_react2.useEffect)(() => {
+    if (store) store.live = false;
+  }, [store]);
+  return (0, import_react2.createElement)(SeedContext.Provider, { value: store }, children);
+}
+function useSeedStore() {
+  const store = (0, import_react2.useContext)(SeedContext);
+  return store && store.live ? store : null;
+}
+
+// src/react/hold.tsx
+var import_react3 = require("react");
+var HoldContext = (0, import_react3.createContext)(null);
 function RecordsHoldScope({ holdKey, children }) {
-  return (0, import_react2.createElement)(HoldContext.Provider, { value: holdKey }, children);
+  return (0, import_react3.createElement)(HoldContext.Provider, { value: holdKey }, children);
 }
 function useRecordsHold(holdKey) {
-  (0, import_react2.useEffect)(() => holdKey ? openHold(holdKey) : void 0, [holdKey]);
+  (0, import_react3.useEffect)(() => holdKey ? openHold(holdKey) : void 0, [holdKey]);
 }
 function useHoldKey() {
-  return (0, import_react2.useContext)(HoldContext);
+  return (0, import_react3.useContext)(HoldContext);
+}
+
+// src/react/pageOrder.ts
+function pageOrderOf(sort, narrowed) {
+  return { sortFields: (sort ?? []).map((key) => key.field), narrowed };
+}
+var same = (a, b) => {
+  if (a === b) return true;
+  if ((a === null || a === void 0 || a === "") && (b === null || b === void 0 || b === "")) return true;
+  return JSON.stringify(a) === JSON.stringify(b);
+};
+function patchMovesRows(held, fresh, order) {
+  if (order.sortFields.length === 0 && !order.narrowed) return false;
+  for (const row of held) {
+    const next = fresh.get(row.id);
+    if (!next) continue;
+    const was = row.document ?? {};
+    const now = next.document ?? {};
+    if (order.narrowed) {
+      if (!same(was, now)) return true;
+      continue;
+    }
+    for (const field2 of order.sortFields) if (!same(was[field2], now[field2])) return true;
+  }
+  return false;
 }
 
 // src/react/hooks.ts
 function useAsync(run, key, live) {
   const client = useRecordsClient();
   const holdKey = useHoldKey();
-  const slot = (0, import_react3.useId)();
-  const entry = (0, import_react3.useMemo)(
+  const slot = (0, import_react4.useId)();
+  const entry = (0, import_react4.useMemo)(
     () => typeof window === "undefined" ? serverEntry(run, client) : entryFor(client, key, run, live ?? null),
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [client, key]
   );
   entry.run = run;
   entry.client = client;
-  const snapshot = (0, import_react3.useSyncExternalStore)(entry.subscribe, entry.getSnapshot, entry.getSnapshot);
-  (0, import_react3.useEffect)(() => {
+  const seed = useSeedStore();
+  if (seed && entry.snapshot.data === null && !entry.snapshot.error && !entry.started) {
+    const outcome = (0, import_react4.use)(seed.run(`${identityOf(client)}|${key}`, run, client.config));
+    if (outcome.seeded) seedEntry(entry, outcome.data, outcome.stale);
+  }
+  const snapshot = (0, import_react4.useSyncExternalStore)(entry.subscribe, entry.getSnapshot, entry.getSnapshot);
+  (0, import_react4.useEffect)(() => {
     acquireEntry(entry);
     return () => releaseEntry(entry);
   }, [entry]);
-  (0, import_react3.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     if (holdKey) pinToHold(holdKey, slot, entry);
   }, [holdKey, slot, entry]);
-  const lastData = (0, import_react3.useRef)(null);
+  const lastData = (0, import_react4.useRef)(null);
   if (snapshot.data !== null) lastData.current = snapshot.data;
   const shown = snapshot.data === null && snapshot.loading && !snapshot.error && lastData.current !== null ? { ...snapshot, data: lastData.current } : snapshot;
-  const reload = (0, import_react3.useCallback)(() => entry.refetch(), [entry]);
-  const setData = (0, import_react3.useCallback)((update) => entry.setData(update), [entry]);
+  const reload = (0, import_react4.useCallback)(() => entry.refetch(), [entry]);
+  const setData = (0, import_react4.useCallback)((update) => entry.setData(update), [entry]);
   return { ...shown, reload, setData };
 }
+function useSeededAnswer(key, run) {
+  const client = useRecordsClient();
+  const seed = useSeedStore();
+  if (!seed || key === null) return void 0;
+  const outcome = (0, import_react4.use)(seed.run(`${identityOf(client)}|own:${key}`, run, client.config));
+  return outcome.seeded ? outcome.data : void 0;
+}
 function serverEntry(run, client) {
-  const snapshot = { data: null, loading: true, error: null };
-  return {
+  const entry = {
     key: "server",
-    snapshot,
+    snapshot: { data: null, loading: true, error: null },
     run,
     client,
     subscribe: () => () => {
     },
-    getSnapshot: () => snapshot,
+    // Read through the entry: a page seed may answer it during this render (`seedEntry`).
+    getSnapshot: () => entry.snapshot,
     refetch: () => {
     },
     setData: () => {
     }
   };
+  return entry;
 }
 function useTable(tableId) {
   const revision = useShapeRevision(tableId);
-  (0, import_react3.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     if (tableId) registerShapeInterest(tableId);
   }, [tableId]);
   return useAsync(
@@ -8149,12 +8315,12 @@ function subscribeToShape(listener) {
   };
 }
 function useShapeRevision(tableId) {
-  const read = (0, import_react3.useCallback)(() => tableId ? shapeRevisions.get(tableId) ?? 0 : 0, [tableId]);
-  return (0, import_react3.useSyncExternalStore)(subscribeToShape, read, () => 0);
+  const read = (0, import_react4.useCallback)(() => tableId ? shapeRevisions.get(tableId) ?? 0 : 0, [tableId]);
+  return (0, import_react4.useSyncExternalStore)(subscribeToShape, read, () => 0);
 }
 function useFields(tableId, recordType) {
   const revision = useShapeRevision(tableId);
-  (0, import_react3.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     if (tableId) registerShapeInterest(tableId);
   }, [tableId]);
   return useAsync(
@@ -8179,7 +8345,7 @@ async function answerOrRefusal(ask, where) {
   }
 }
 function useReverseColumns(tableId) {
-  const revision = (0, import_react3.useSyncExternalStore)(subscribeToShape, () => anyShapeRevision, () => 0);
+  const revision = (0, import_react4.useSyncExternalStore)(subscribeToShape, () => anyShapeRevision, () => 0);
   return useAsync(
     async (client) => {
       if (!tableId || !doorReady(client.config, DOORS.reverseColumns)) return { ok: true, data: [] };
@@ -8189,8 +8355,8 @@ function useReverseColumns(tableId) {
   );
 }
 function useReverseLinks(tableId, columns, recordIds, limit = 3, offset = 0) {
-  const [writes, setWrites] = (0, import_react3.useState)(0);
-  (0, import_react3.useEffect)(() => onRecordChanged(() => setWrites((n) => n + 1)), []);
+  const [writes, setWrites] = (0, import_react4.useState)(0);
+  (0, import_react4.useEffect)(() => onRecordChanged(() => setWrites((n) => n + 1)), []);
   const idsKey = recordIds.join(",");
   const columnsKey = columns.map((c) => c.source_field_id).join(",");
   return useAsync(
@@ -8217,7 +8383,7 @@ function useReverseLinks(tableId, columns, recordIds, limit = 3, offset = 0) {
     tableId ? `reverse-links:${tableId}:${columnsKey}:${limit}:${offset}:${idsKey}:${writes}` : "reverse-links:none"
   );
 }
-function liveRowsFor(tableId) {
+function liveRowsFor(tableId, order = { sortFields: [], narrowed: false }) {
   return (entry) => {
     const client = entry.client;
     const realtime = client.config.realtime;
@@ -8236,6 +8402,10 @@ function liveRowsFor(tableId) {
         entry.refetch();
         return;
       }
+      if (patchMovesRows(held, fresh, order)) {
+        entry.refetch();
+        return;
+      }
       entry.setData(
         (current) => current === null ? current : {
           ...current,
@@ -8285,7 +8455,7 @@ function liveStatus(client, tableId) {
   return { live, liveReason };
 }
 function useKeptPage(tableId, base) {
-  const lastGood = (0, import_react3.useRef)(null);
+  const lastGood = (0, import_react4.useRef)(null);
   if (base.data !== null && !base.error) lastGood.current = { tableId, data: base.data };
   if (base.error && base.data === null && lastGood.current && lastGood.current.tableId === tableId) {
     return { ...base, data: lastGood.current.data };
@@ -8302,7 +8472,7 @@ function sameRowAnswer(a, b) {
   }
 }
 function useSharedRows(state) {
-  const held = (0, import_react3.useRef)({
+  const held = (0, import_react4.useRef)({
     source: null,
     shared: null,
     byId: /* @__PURE__ */ new Map()
@@ -8343,7 +8513,7 @@ function useRecords(tableId, options = {}) {
     // on every render must not re-read the page on every render, and a parent
     // that changes the question must re-read on the first one.
     `records:${tableId ?? "none"}:${pageSize}:${page2}:${filterKey}:s${shape}`,
-    liveRowsFor(tableId)
+    liveRowsFor(tableId, pageOrderOf(void 0, filterKey !== "{}"))
   );
   const { live, liveReason } = liveStatus(useRecordsClient(), tableId);
   return { ...useSharedRows(useKeptPage(tableId, base)), live, liveReason };
@@ -8371,14 +8541,14 @@ function useRecordPage(tableId, options = {}) {
       return answered.ok ? { ok: true, data: { rows: answered.data.rows, total: answered.data.total, sortIgnored: answered.data.sort_ignored ?? [] } } : answered;
     },
     `page:${tableId ?? "none"}:${pageSize}:${page2}:${filterKey}:${search ?? ""}:${sortKey}:${viewId ?? ""}:s${shape}`,
-    liveRowsFor(tableId)
+    liveRowsFor(tableId, pageOrderOf(options.sort, filterKey !== "{}" || search !== null))
   );
   const { live, liveReason } = liveStatus(useRecordsClient(), tableId);
   return { ...useSharedRows(useKeptPage(tableId, base)), live, liveReason };
 }
 function useRecordChangeRevision(recordId) {
-  const [revision, setRevision] = (0, import_react3.useState)(0);
-  (0, import_react3.useEffect)(() => {
+  const [revision, setRevision] = (0, import_react4.useState)(0);
+  (0, import_react4.useEffect)(() => {
     if (!recordId) return;
     return onRecordChanged((changed) => {
       if (changed === recordId) setRevision((n) => n + 1);
@@ -8429,10 +8599,10 @@ function liveRecordFor(recordId, tableId) {
 }
 function useRecordMutation() {
   const client = useRecordsClient();
-  const [saving, setSaving] = (0, import_react3.useState)(false);
-  const [error, setError] = (0, import_react3.useState)(null);
-  const [conflict, setConflict] = (0, import_react3.useState)(null);
-  const run = (0, import_react3.useCallback)(
+  const [saving, setSaving] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const [conflict, setConflict] = (0, import_react4.useState)(null);
+  const run = (0, import_react4.useCallback)(
     async (recordId, call) => {
       setSaving(true);
       setError(null);
@@ -8451,7 +8621,7 @@ function useRecordMutation() {
     },
     []
   );
-  return (0, import_react3.useMemo)(
+  return (0, import_react4.useMemo)(
     () => ({
       write: (args) => run(null, () => client.recordWrite({ table_id: args.table_id, data: args.data })),
       update: (args) => run(
@@ -8480,15 +8650,15 @@ function useTableArchive(tableId, options) {
   const client = useRecordsClient();
   const chunk = options?.chunk ?? TABLE_ARCHIVE_PASS;
   const includeTable = options?.includeTable ?? true;
-  const [progress, setProgress] = (0, import_react3.useState)(null);
-  const [running, setRunning] = (0, import_react3.useState)(false);
-  const [passes, setPasses] = (0, import_react3.useState)(0);
-  const [error, setError] = (0, import_react3.useState)(null);
-  const [interrupted, setInterrupted] = (0, import_react3.useState)(false);
-  const [chunkInUse, setChunkInUse] = (0, import_react3.useState)(chunk);
-  const [slowedDown, setSlowedDown] = (0, import_react3.useState)(false);
-  const cut = (0, import_react3.useRef)(false);
-  const preview = (0, import_react3.useCallback)(async () => {
+  const [progress, setProgress] = (0, import_react4.useState)(null);
+  const [running, setRunning] = (0, import_react4.useState)(false);
+  const [passes, setPasses] = (0, import_react4.useState)(0);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const [interrupted, setInterrupted] = (0, import_react4.useState)(false);
+  const [chunkInUse, setChunkInUse] = (0, import_react4.useState)(chunk);
+  const [slowedDown, setSlowedDown] = (0, import_react4.useState)(false);
+  const cut = (0, import_react4.useRef)(false);
+  const preview = (0, import_react4.useCallback)(async () => {
     setError(null);
     const answered = await client.tableArchive({ table_id: tableId, chunk: 0, includeTable });
     if (!answered.ok) {
@@ -8499,7 +8669,7 @@ function useTableArchive(tableId, options) {
     if (answered.data.in_progress) setInterrupted(true);
     return answered.data;
   }, [client, tableId, includeTable]);
-  const loop = (0, import_react3.useCallback)(async () => {
+  const loop = (0, import_react4.useCallback)(async () => {
     cut.current = false;
     setRunning(true);
     setError(null);
@@ -8536,7 +8706,7 @@ function useTableArchive(tableId, options) {
       setRunning(false);
     }
   }, [client, tableId, chunk, includeTable]);
-  return (0, import_react3.useMemo)(
+  return (0, import_react4.useMemo)(
     () => ({
       progress,
       running,
@@ -8581,11 +8751,11 @@ function useEntityBackLinks(token, recordId, options) {
     }) : Promise.resolve({ ok: true, data: null }),
     `entity-back-links:${scope}`
   );
-  const [more, setMore] = (0, import_react3.useState)({ scope, items: [], cursor: void 0, busy: false, error: null });
+  const [more, setMore] = (0, import_react4.useState)({ scope, items: [], cursor: void 0, busy: false, error: null });
   const current = more.scope === scope ? more : { scope, items: [], cursor: void 0, busy: false, error: null };
   const firstAnswer = first.data;
   const cursor = current.cursor === void 0 ? firstAnswer?.next_cursor ?? null : current.cursor;
-  const loadMore = (0, import_react3.useCallback)(async () => {
+  const loadMore = (0, import_react4.useCallback)(async () => {
     if (!asking || !cursor) return;
     setMore({ ...current, busy: true, error: null });
     const answered = await client.entityBackLinks({
@@ -8607,7 +8777,7 @@ function useEntityBackLinks(token, recordId, options) {
       error: null
     });
   }, [client, asking?.token, asking?.recordId, asking?.organizationId, limit, cursor, current, scope]);
-  const reload = (0, import_react3.useCallback)(() => {
+  const reload = (0, import_react4.useCallback)(() => {
     setMore({ scope, items: [], cursor: void 0, busy: false, error: null });
     first.reload();
   }, [first, scope]);
@@ -8643,9 +8813,9 @@ function useEntityFieldRights(token) {
 }
 function useEntityFieldMutation() {
   const client = useRecordsClient();
-  const [saving, setSaving] = (0, import_react3.useState)(false);
-  const [error, setError] = (0, import_react3.useState)(null);
-  const run = (0, import_react3.useCallback)(
+  const [saving, setSaving] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const run = (0, import_react4.useCallback)(
     async (call, whenRefused) => {
       setSaving(true);
       setError(null);
@@ -8660,7 +8830,7 @@ function useEntityFieldMutation() {
     },
     []
   );
-  return (0, import_react3.useMemo)(
+  return (0, import_react4.useMemo)(
     () => ({
       declare: (args) => run(() => client.entityFieldDeclare({ token: args.token, spec: args.spec }), null),
       update: (args) => run(
@@ -8686,9 +8856,9 @@ function useEntityFieldMutation() {
 }
 function useFieldMutation() {
   const client = useRecordsClient();
-  const [saving, setSaving] = (0, import_react3.useState)(false);
-  const [error, setError] = (0, import_react3.useState)(null);
-  const run = (0, import_react3.useCallback)(
+  const [saving, setSaving] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const run = (0, import_react4.useCallback)(
     async (call, whenRefused) => {
       setSaving(true);
       setError(null);
@@ -8703,14 +8873,14 @@ function useFieldMutation() {
     },
     []
   );
-  const announce = (0, import_react3.useCallback)((tableId) => {
+  const announce = (0, import_react4.useCallback)((tableId) => {
     if (tableId) {
       tableShapeChanged(tableId);
       return;
     }
     for (const id of [...shapeRevisions.keys()]) tableShapeChanged(id);
   }, []);
-  return (0, import_react3.useMemo)(
+  return (0, import_react4.useMemo)(
     () => ({
       declare: async (args) => {
         const made = await run(
@@ -8747,9 +8917,9 @@ function useFieldMutation() {
 }
 function useMergeField(key, state) {
   const client = useRecordsClient();
-  const [resolution, setResolution] = (0, import_react3.useState)(null);
+  const [resolution, setResolution] = (0, import_react4.useState)(null);
   const resolver = client.config.resolver;
-  (0, import_react3.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     if (!key) {
       setResolution(null);
       return;
@@ -8784,11 +8954,11 @@ function useMergeField(key, state) {
 }
 
 // src/react/entity-reference.ts
-var import_react4 = require("react");
+var import_react5 = require("react");
 function useEntityReferenceKinds() {
   const client = useRecordsClient();
-  const [state, setState] = (0, import_react4.useState)({ data: null, loading: true, error: null });
-  (0, import_react4.useEffect)(() => {
+  const [state, setState] = (0, import_react5.useState)({ data: null, loading: true, error: null });
+  (0, import_react5.useEffect)(() => {
     let live = true;
     void entityReferenceKinds(client.config.dataSource).then((res) => {
       if (!live) return;
@@ -8803,8 +8973,8 @@ function useEntityReferenceKinds() {
 function useEntityReferenceWords(refs) {
   const client = useRecordsClient();
   const key = refs.map((r) => `${r.token}:${r.id}`).join(",");
-  const [state, setState] = (0, import_react4.useState)({ data: null, loading: refs.length > 0, error: null });
-  (0, import_react4.useEffect)(() => {
+  const [state, setState] = (0, import_react5.useState)({ data: null, loading: refs.length > 0, error: null });
+  (0, import_react5.useEffect)(() => {
     let live = true;
     void entityReferenceWords(client.config.dataSource, client.config.organizationId, refs).then((res) => {
       if (!live) return;
@@ -8819,8 +8989,8 @@ function useEntityReferenceWords(refs) {
 function useEntityReferenceSearch(tokens, search, enabled = true) {
   const client = useRecordsClient();
   const key = `${tokens.join(",")}|${search.trim()}|${enabled ? 1 : 0}`;
-  const [state, setState] = (0, import_react4.useState)({ data: null, loading: enabled && tokens.length > 0, error: null });
-  (0, import_react4.useEffect)(() => {
+  const [state, setState] = (0, import_react5.useState)({ data: null, loading: enabled && tokens.length > 0, error: null });
+  (0, import_react5.useEffect)(() => {
     if (!enabled || tokens.length === 0) {
       setState({ data: [], loading: false, error: null });
       return;
@@ -8842,7 +9012,7 @@ function useEntityReferenceSearch(tokens, search, enabled = true) {
 }
 
 // src/react/useAppTable.ts
-var import_react5 = require("react");
+var import_react6 = require("react");
 
 // src/core/declareTable.ts
 function tokenFor(name) {
@@ -9137,16 +9307,16 @@ function useAppTable(def, options = {}) {
   const client = useRecordsClient();
   const narrowed = options.organizationId ?? null;
   const writeOrg = narrowed ?? client.config.organizationId;
-  const [rows, setRows] = (0, import_react5.useState)([]);
-  const [total, setTotal] = (0, import_react5.useState)(null);
-  const [truncated, setTruncated] = (0, import_react5.useState)(false);
-  const [loading, setLoading] = (0, import_react5.useState)(true);
-  const [error, setError] = (0, import_react5.useState)(null);
-  const [status, setStatus] = (0, import_react5.useState)(null);
-  const [revision, setRevision] = (0, import_react5.useState)(0);
-  const rowsRef = (0, import_react5.useRef)([]);
+  const [rows, setRows] = (0, import_react6.useState)([]);
+  const [total, setTotal] = (0, import_react6.useState)(null);
+  const [truncated, setTruncated] = (0, import_react6.useState)(false);
+  const [loading, setLoading] = (0, import_react6.useState)(true);
+  const [error, setError] = (0, import_react6.useState)(null);
+  const [status, setStatus] = (0, import_react6.useState)(null);
+  const [revision, setRevision] = (0, import_react6.useState)(0);
+  const rowsRef = (0, import_react6.useRef)([]);
   rowsRef.current = rows;
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     let live = true;
     setLoading(true);
     (async () => {
@@ -9178,8 +9348,8 @@ function useAppTable(def, options = {}) {
       live = false;
     };
   }, [client, def.slug, def.kept_for, def.specHash, writeOrg, narrowed, revision]);
-  const reload = (0, import_react5.useCallback)(() => setRevision((n) => n + 1), []);
-  const upsert = (0, import_react5.useCallback)(
+  const reload = (0, import_react6.useCallback)(() => setRevision((n) => n + 1), []);
+  const upsert = (0, import_react6.useCallback)(
     async (data, upsertOptions = {}) => {
       if (!writeOrg) {
         return { ok: false, error: { code: "invalid_argument", message: `${def.name}: no organization to write to.` } };
@@ -9190,7 +9360,7 @@ function useAppTable(def, options = {}) {
     },
     [client, def, writeOrg, reload]
   );
-  const remove = (0, import_react5.useCallback)(
+  const remove = (0, import_react6.useCallback)(
     async (rowId) => {
       const org = rowsRef.current.find((r) => r._id === rowId)?._organizationId ?? writeOrg;
       const answer = await removeAppRow(client, def, rowId, { organizationId: org });
@@ -9207,7 +9377,7 @@ function archivedTableOf(error) {
 }
 
 // src/react/useStoreTable.ts
-var import_react7 = require("react");
+var import_react8 = require("react");
 
 // src/app-table/store-table.ts
 function storeTable(def) {
@@ -10442,7 +10612,7 @@ function createTableDataPort({ client, aliases }) {
 }
 
 // src/data/react.tsx
-var import_react6 = require("react");
+var import_react7 = require("react");
 var import_react_query = require("@tanstack/react-query");
 var RECORDS_QUERY_ROOT = "@ai-matrx/records";
 var DATA_LIVE_GRACE_MS = 3e4;
@@ -10489,13 +10659,13 @@ function retryable(failureCount, thrown) {
   const code = thrown instanceof DataRefusal ? thrown.error.code : "unreachable";
   return (code === "unreachable" || code === "timed_out") && failureCount < 2;
 }
-var DataPortContext = (0, import_react6.createContext)(null);
+var DataPortContext = (0, import_react7.createContext)(null);
 function hostEvents(port) {
   return { on: (event, listener) => port.subscribe(event, listener) };
 }
 var warnedNotLive = false;
 function useDataPort(scope) {
-  const held = (0, import_react6.useContext)(DataPortContext);
+  const held = (0, import_react7.useContext)(DataPortContext);
   if (scope) return scope;
   if (!held) {
     throw new Error(
@@ -10781,7 +10951,7 @@ function acquireLive(qc, port, events, portKey, alias) {
 }
 var FALLBACK_KEY = /* @__PURE__ */ Symbol.for("@ai-matrx/records/data-query-client");
 function useRecordsQueryClient() {
-  const provided = (0, import_react6.useContext)(import_react_query.QueryClientContext);
+  const provided = (0, import_react7.useContext)(import_react_query.QueryClientContext);
   if (provided) return provided;
   const g = globalThis;
   let held = g[FALLBACK_KEY];
@@ -10794,7 +10964,7 @@ function useRecordsQueryClient() {
 function useLive(alias, scope) {
   const qc = useRecordsQueryClient();
   const { port, portKey, events } = useDataPort(scope);
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     if (!alias) return;
     return acquireLive(qc, port, events, portKey, alias);
   }, [qc, port, events, portKey, alias]);
@@ -10814,7 +10984,7 @@ function useDataRows(alias, query = {}, scope) {
     },
     qc
   );
-  const rows = (0, import_react6.useMemo)(() => {
+  const rows = (0, import_react7.useMemo)(() => {
     const seen = /* @__PURE__ */ new Set();
     const out = [];
     for (const page2 of q.data?.pages ?? []) {
@@ -10826,11 +10996,11 @@ function useDataRows(alias, query = {}, scope) {
     }
     return out;
   }, [q.data]);
-  const want = (0, import_react6.useRef)({ key: "", pages: 0 });
+  const want = (0, import_react7.useRef)({ key: "", pages: 0 });
   const keyHash = (0, import_react_query.hashKey)(rowsKey);
   const loaded = q.data?.pages.length ?? 0;
   const { isFetching, hasNextPage, isFetchNextPageError, fetchNextPage } = q;
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     const w = want.current;
     if (w.key !== keyHash || isFetching || loaded >= w.pages) return;
     if (!hasNextPage || isFetchNextPageError) {
@@ -10870,7 +11040,7 @@ function drawPatch(before, patch) {
 function useDataMutations(alias, scope) {
   const qc = useRecordsQueryClient();
   const { port, portKey } = useDataPort(scope);
-  return (0, import_react6.useMemo)(() => {
+  return (0, import_react7.useMemo)(() => {
     const snapshotRows = () => qc.getQueriesData({ queryKey: dataKeys.rowsPrefix(portKey, alias) });
     const putBack = (snap) => {
       for (const [key, data] of snap) qc.setQueryData(key, data);
@@ -10972,7 +11142,7 @@ function toNamed(table, row) {
 function useStoreTable(table, options = {}) {
   const client = useRecordsClient();
   const alias = table.id;
-  const scope = (0, import_react7.useMemo)(
+  const scope = (0, import_react8.useMemo)(
     () => {
       const port = createTableDataPort({ client, aliases: { [alias]: { kind: "table", tableId: table.id, organizationId: table.organizationId, label: table.name } } });
       return { port, events: hostEvents(port), portKey: `store-table|${client.config.organizationId ?? "-"}|${client.config.actor.user_id ?? "-"}` };
@@ -10980,7 +11150,7 @@ function useStoreTable(table, options = {}) {
     [client, alias, table.id, table.organizationId, table.name]
   );
   const asked = JSON.stringify(options);
-  const built = (0, import_react7.useMemo)(() => {
+  const built = (0, import_react8.useMemo)(() => {
     const where = [];
     for (const [name, value] of Object.entries(options.where ?? {})) {
       const column = table.columns[name];
@@ -11007,10 +11177,10 @@ function useStoreTable(table, options = {}) {
   const limit = Math.min(options.limit ?? STORE_ROWS_CEILING, STORE_ROWS_CEILING);
   const read = useDataRows(alias, built.ok ? built.data : { pageSize: 1 }, scope);
   const write = useDataMutations(alias, scope);
-  (0, import_react7.useEffect)(() => {
+  (0, import_react8.useEffect)(() => {
     if (built.ok && read.hasMore && !read.loadingMore && !read.loading && !read.error && read.rows.length < limit) read.loadMore();
   }, [built.ok, read.hasMore, read.loadingMore, read.loading, read.error, read.rows.length, limit, read]);
-  const rows = (0, import_react7.useMemo)(() => read.rows.slice(0, limit).filter((r) => r["_pending"] !== true).map((r) => toNamed(table, r)), [read.rows, limit, table]);
+  const rows = (0, import_react8.useMemo)(() => read.rows.slice(0, limit).filter((r) => r["_pending"] !== true).map((r) => toNamed(table, r)), [read.rows, limit, table]);
   const total = built.ok ? read.total : null;
   return {
     rows: built.ok ? rows : [],