@ai-matrx/records 0.98.10 → 0.98.12

package/dist/react/index.d.cts

@@ -16258,16 +16258,18 @@ interface ChooseAlternateArgs {
     field_key: string;
     /** Position in the field's `alternates` list as the record holds it. */
     alternate_index: number;
+    /** When given, the alternate holding this rank is chosen instead — the list a screen drew may be ordered differently. */
+    rank?: number;
 }
 /** The patch that makes alternate `alternate_index` of `field_key` the value. Pure; exported for tests. */
-declare function alternatePatch(document: RecordDocument, field_key: string, alternate_index: number): {
+declare function alternatePatch(document: RecordDocument, field_key: string, alternate_index: number, rank?: number): {
     ok: true;
     patch: Record<string, unknown>;
 } | {
     ok: false;
     message: string;
 };
-declare function chooseAlternate(client: Pick<RecordsClient, "recordRead" | "recordUpdate">, { record_id, field_key, alternate_index }: ChooseAlternateArgs): Promise<RecordsResult<number>>;
+declare function chooseAlternate(client: Pick<RecordsClient, "recordRead" | "recordAsOf" | "recordUpdate">, { record_id, field_key, alternate_index, rank }: ChooseAlternateArgs): Promise<RecordsResult<number>>;
 
 interface RecordsProviderProps {
     config: RecordsConfig;

package/dist/react/index.d.ts

@@ -16258,16 +16258,18 @@ interface ChooseAlternateArgs {
     field_key: string;
     /** Position in the field's `alternates` list as the record holds it. */
     alternate_index: number;
+    /** When given, the alternate holding this rank is chosen instead — the list a screen drew may be ordered differently. */
+    rank?: number;
 }
 /** The patch that makes alternate `alternate_index` of `field_key` the value. Pure; exported for tests. */
-declare function alternatePatch(document: RecordDocument, field_key: string, alternate_index: number): {
+declare function alternatePatch(document: RecordDocument, field_key: string, alternate_index: number, rank?: number): {
     ok: true;
     patch: Record<string, unknown>;
 } | {
     ok: false;
     message: string;
 };
-declare function chooseAlternate(client: Pick<RecordsClient, "recordRead" | "recordUpdate">, { record_id, field_key, alternate_index }: ChooseAlternateArgs): Promise<RecordsResult<number>>;
+declare function chooseAlternate(client: Pick<RecordsClient, "recordRead" | "recordAsOf" | "recordUpdate">, { record_id, field_key, alternate_index, rank }: ChooseAlternateArgs): Promise<RecordsResult<number>>;
 
 interface RecordsProviderProps {
     config: RecordsConfig;

package/dist/react/index.js

@@ -13456,20 +13456,29 @@ function tableRenderSchema(facts) {
 function refuse4(code, message, hint) {
   return { ok: false, error: { code, message, hint, ours: true } };
 }
-function alternatePatch(document, field_key, alternate_index) {
+function displacedSource(envelope) {
+  if (envelope.src) return { src: envelope.src };
+  const by = envelope.actor === "agent" ? "an agent" : envelope.actor === "system" ? "the system" : envelope.actor ? "a person" : null;
+  if (by === null) return {};
+  const day = typeof envelope.at === "string" && envelope.at.length >= 10 ? ` on ${envelope.at.slice(0, 10)}` : "";
+  return { src: { name: `Entered by ${by}${day}` } };
+}
+function alternatePatch(document, field_key, alternate_index, rank) {
   const block = document._values ?? {};
   const envelope = block[field_key];
   const alternates = Array.isArray(envelope?.alternates) ? envelope.alternates : [];
-  const chosen = alternates[alternate_index];
+  const at = rank === void 0 ? alternate_index : alternates.findIndex((a) => a.rank === rank);
+  alternate_index = at;
+  const chosen = alternates[at];
   if (!envelope || !chosen) return { ok: false, message: "That other value is no longer on this record." };
   const kept = alternates.filter((_, i) => i !== alternate_index);
   const current = document[field_key];
   const next = [...kept];
   if (current !== null && current !== void 0) {
     const taken = new Set(kept.map((a) => a.rank));
-    let rank = 1;
-    while (taken.has(rank)) rank += 1;
-    next.push({ value: current, ...envelope.src ? { src: envelope.src } : {}, rank });
+    let rank2 = 1;
+    while (taken.has(rank2)) rank2 += 1;
+    next.push({ value: current, ...displacedSource(envelope), rank: rank2 });
   }
   const { ver: _ver, actor: _actor, at: _at, on_behalf_of: _on, absent: _absent, alternates: _alts, src: _src, ...rest } = envelope;
   const changed = { ...rest, ...chosen.src ? { src: chosen.src } : {} };
@@ -13483,14 +13492,20 @@ function alternatePatch(document, field_key, alternate_index) {
     }
   };
 }
-async function chooseAlternate(client, { record_id, field_key, alternate_index }) {
+async function chooseAlternate(client, { record_id, field_key, alternate_index, rank }) {
   const read = await client.recordRead({ record_id, withVersion: true });
   if (!read.ok) return read;
+  if (Object.keys(read.data.hidden ?? {}).length > 0) {
+    return refuse4("refused_by_rule", "Some fields here are hidden from you, so this choice can't be saved safely.", "Ask someone who can see every field.");
+  }
   const version = read.data.version;
   if (version === null || version === void 0) {
     return refuse4("stale_read", "Nothing was saved: this record's latest changes could not be checked.", "Reload, then try again.");
   }
-  const built = alternatePatch(read.data.document, field_key, alternate_index);
+  const raw = await client.recordAsOf({ record_id, recorded_at: (/* @__PURE__ */ new Date()).toISOString() });
+  if (!raw.ok) return raw;
+  if (raw.data === null) return refuse4("not_found", "That record is no longer here.", "Reload, then look again.");
+  const built = alternatePatch(raw.data, field_key, alternate_index, rank);
   if (!built.ok) return refuse4("not_found", built.message, "Reload, then look again.");
   return client.recordUpdate({ record_id, patch: built.patch, expectedVersion: version });
 }