@ai-matrx/records 0.98.10 → 0.98.12

package/dist/index.d.cts

@@ -410,15 +410,17 @@ 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>>;
 
 export { CaptureFileRef, CaptureOutcome, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSyncReport, type ChooseAlternateArgs, CoercibleField, Delivery, Freshness, type MergeField, MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, type MergeFieldTransform, type MissingBehavior, OverridePolicy, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, REFUSALS_WORTH_REPEATING, RecordDocument, RecordsResult, type ResolutionTriple, Timestamp, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, Uuid, alternatePatch, autonumberJoin, autonumberPrefixOf, autonumberSearchOf, autonumberWords, chooseAlternate, filterWithAutonumber, indexedDbStore, isAutonumberField, isDecided, localeDateOrder, memoryStore, mintClientKey, openCaptureQueue, rankTypedMatches, readTypedDate, readTypedNumber, readTypedTime, twoDigitYear, typedDateText, typedMatchScore, typedTimeText };

package/dist/index.d.ts

@@ -410,15 +410,17 @@ 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>>;
 
 export { CaptureFileRef, CaptureOutcome, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSyncReport, type ChooseAlternateArgs, CoercibleField, Delivery, Freshness, type MergeField, MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, type MergeFieldTransform, type MissingBehavior, OverridePolicy, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, REFUSALS_WORTH_REPEATING, RecordDocument, RecordsResult, type ResolutionTriple, Timestamp, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, Uuid, alternatePatch, autonumberJoin, autonumberPrefixOf, autonumberSearchOf, autonumberWords, chooseAlternate, filterWithAutonumber, indexedDbStore, isAutonumberField, isDecided, localeDateOrder, memoryStore, mintClientKey, openCaptureQueue, rankTypedMatches, readTypedDate, readTypedNumber, readTypedTime, twoDigitYear, typedDateText, typedMatchScore, typedTimeText };

package/dist/index.js

@@ -5114,20 +5114,29 @@ function tableRenderSchema(facts) {
 function refuse(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 } : {} };
@@ -5141,14 +5150,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 refuse("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 refuse("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 refuse("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 refuse("not_found", built.message, "Reload, then look again.");
   return client.recordUpdate({ record_id, patch: built.patch, expectedVersion: version });
 }