@ai-matrx/records 0.98.7 → 0.98.9

package/dist/{declareTable-BIuPJ3Vj.d.ts → declareTable-B6ic3leL.d.ts}

@@ -1,7 +1,6 @@
-import { R as RecordsClient } from './client-C1B-MNzb.js';
-import { a as FieldTypeWord, N as NewFieldDeclaration } from './field-CJtssH3q.js';
-import { U as Uuid, a as RecordsError } from './record-CxGK1OEK.js';
-import { F as FieldDrift } from './table-kind-B4sdlvHf.js';
+import { F as FieldDrift, R as RecordsClient } from './client-DcWZjmg2.js';
+import { a as FieldTypeWord, N as NewFieldDeclaration } from './field-BIRNApm1.js';
+import { U as Uuid, a as RecordsError } from './record-BrJNCmH1.js';
 
 /** One Field a person asked for, in the words a person uses (FLD-1 / FLD-11). */
 interface NewFieldSpec {

package/dist/{declareTable-d-HxRmF0.d.cts → declareTable-_GwN-ERY.d.cts}

@@ -1,7 +1,6 @@
-import { R as RecordsClient } from './client-D2jAgJNn.cjs';
-import { a as FieldTypeWord, N as NewFieldDeclaration } from './field-DoVl2I9K.cjs';
-import { U as Uuid, a as RecordsError } from './record-CxGK1OEK.cjs';
-import { F as FieldDrift } from './table-kind-CboiMJuE.cjs';
+import { F as FieldDrift, R as RecordsClient } from './client-9fzhCPD5.cjs';
+import { a as FieldTypeWord, N as NewFieldDeclaration } from './field-BLy8drjM.cjs';
+import { U as Uuid, a as RecordsError } from './record-BrJNCmH1.cjs';
 
 /** One Field a person asked for, in the words a person uses (FLD-1 / FLD-11). */
 interface NewFieldSpec {

package/dist/{doors-Bx3Shs3z.d.cts → doors-Dm5q9H8Y.d.cts}

@@ -1,4 +1,4 @@
-import { U as Uuid, R as RecordsResult } from './record-CxGK1OEK.cjs';
+import { U as Uuid, R as RecordsResult } from './record-BrJNCmH1.cjs';
 
 /**
  * What a context field holds, as a person thinks of it — derived from the Field's behaviour, `multi`,

package/dist/{doors-BTifsjNv.d.ts → doors-t-Oc2l9E.d.ts}

@@ -1,4 +1,4 @@
-import { U as Uuid, R as RecordsResult } from './record-CxGK1OEK.js';
+import { U as Uuid, R as RecordsResult } from './record-BrJNCmH1.js';
 
 /**
  * What a context field holds, as a person thinks of it — derived from the Field's behaviour, `multi`,

package/dist/entity/index.d.cts

@@ -1,11 +1,11 @@
-import { a as EntityWireQuery, b as EntityColumnWire, c as EntityWireRow } from '../port-CRP5g9l9.cjs';
-export { d as CreateEntityClientOptions, C as CreateEntityDataPortOptions, e as CreateEntityRealtimeOptions, D as DEFAULT_BATCH_MS, f as DEFAULT_MAX_ORG_TOPICS, g as DEFAULT_MAX_WAIT_MS, h as ENTITY_DOOR_SCHEMA, i as ENTITY_NOTICE_EVENT, j as EntityAlias, k as EntityClient, l as EntityColumnsAnswer, E as EntityDataPort, m as EntityGetAnswer, n as EntityListAnswer, o as EntityListRequest, p as EntityNotice, q as EntityNoticeSink, r as EntityRealtime, s as EntitySortApplied, t as EntityTypeFacts, u as EntityWirePredicate, v as EntityWireRef, w as EntityWireSort, x as EntityWriteAnswer, y as EntityWriteOptions, O as OP_ID_HEADER, z as createEntityClient, A as createEntityDataPort, B as createEntityRealtime, F as createSeedPort, G as entityNoticeKey, H as entityOrgChannel, I as entityOrgChannelSpec, J as entityOrgTopic, K as orderOrganizationTopics, L as readEntityRealtimeKnobs, M as toWireValue, N as toWireValues } from '../port-CRP5g9l9.cjs';
-import { k as RecordsErrorCode, P as PgError, a as RecordsError } from '../record-CxGK1OEK.cjs';
-import { Q as Query, C as Column, f as EntityRef, R as Row } from '../types-3lM5f6b0.cjs';
-import '../ports-YIh9jrCZ.cjs';
-import '../field-DoVl2I9K.cjs';
+import { a as EntityWireQuery, b as EntityColumnWire, c as EntityWireRow } from '../port-B9glCG2h.cjs';
+export { d as CreateEntityClientOptions, C as CreateEntityDataPortOptions, e as CreateEntityRealtimeOptions, D as DEFAULT_BATCH_MS, f as DEFAULT_MAX_ORG_TOPICS, g as DEFAULT_MAX_WAIT_MS, h as ENTITY_DOOR_SCHEMA, i as ENTITY_NOTICE_EVENT, j as EntityAlias, k as EntityClient, l as EntityColumnsAnswer, E as EntityDataPort, m as EntityGetAnswer, n as EntityListAnswer, o as EntityListRequest, p as EntityNotice, q as EntityNoticeSink, r as EntityRealtime, s as EntitySortApplied, t as EntityTypeFacts, u as EntityWirePredicate, v as EntityWireRef, w as EntityWireSort, x as EntityWriteAnswer, y as EntityWriteOptions, O as OP_ID_HEADER, z as createEntityClient, A as createEntityDataPort, B as createEntityRealtime, F as createSeedPort, G as entityNoticeKey, H as entityOrgChannel, I as entityOrgChannelSpec, J as entityOrgTopic, K as orderOrganizationTopics, L as readEntityRealtimeKnobs, M as toWireValue, N as toWireValues } from '../port-B9glCG2h.cjs';
+import { m as RecordsErrorCode, P as PgError, a as RecordsError } from '../record-BrJNCmH1.cjs';
+import { Q as Query, C as Column, f as EntityRef, R as Row } from '../types-5ql9_q-o.cjs';
+import '../ports-BIdYUS-C.cjs';
+import '../field-BLy8drjM.cjs';
 import '@ai-matrx/realtime';
-import '../relation-DSGhM3tO.cjs';
+import '../relation-R10qQyQU.cjs';
 
 /**
  * Every MX code a read door raises, and the engine code a screen branches on. A code the doors learn

package/dist/entity/index.d.ts

@@ -1,11 +1,11 @@
-import { a as EntityWireQuery, b as EntityColumnWire, c as EntityWireRow } from '../port-CtnELAJQ.js';
-export { d as CreateEntityClientOptions, C as CreateEntityDataPortOptions, e as CreateEntityRealtimeOptions, D as DEFAULT_BATCH_MS, f as DEFAULT_MAX_ORG_TOPICS, g as DEFAULT_MAX_WAIT_MS, h as ENTITY_DOOR_SCHEMA, i as ENTITY_NOTICE_EVENT, j as EntityAlias, k as EntityClient, l as EntityColumnsAnswer, E as EntityDataPort, m as EntityGetAnswer, n as EntityListAnswer, o as EntityListRequest, p as EntityNotice, q as EntityNoticeSink, r as EntityRealtime, s as EntitySortApplied, t as EntityTypeFacts, u as EntityWirePredicate, v as EntityWireRef, w as EntityWireSort, x as EntityWriteAnswer, y as EntityWriteOptions, O as OP_ID_HEADER, z as createEntityClient, A as createEntityDataPort, B as createEntityRealtime, F as createSeedPort, G as entityNoticeKey, H as entityOrgChannel, I as entityOrgChannelSpec, J as entityOrgTopic, K as orderOrganizationTopics, L as readEntityRealtimeKnobs, M as toWireValue, N as toWireValues } from '../port-CtnELAJQ.js';
-import { k as RecordsErrorCode, P as PgError, a as RecordsError } from '../record-CxGK1OEK.js';
-import { Q as Query, C as Column, f as EntityRef, R as Row } from '../types-04kFNi3-.js';
-import '../ports-WwHHNwge.js';
-import '../field-CJtssH3q.js';
+import { a as EntityWireQuery, b as EntityColumnWire, c as EntityWireRow } from '../port-C-p-_lAu.js';
+export { d as CreateEntityClientOptions, C as CreateEntityDataPortOptions, e as CreateEntityRealtimeOptions, D as DEFAULT_BATCH_MS, f as DEFAULT_MAX_ORG_TOPICS, g as DEFAULT_MAX_WAIT_MS, h as ENTITY_DOOR_SCHEMA, i as ENTITY_NOTICE_EVENT, j as EntityAlias, k as EntityClient, l as EntityColumnsAnswer, E as EntityDataPort, m as EntityGetAnswer, n as EntityListAnswer, o as EntityListRequest, p as EntityNotice, q as EntityNoticeSink, r as EntityRealtime, s as EntitySortApplied, t as EntityTypeFacts, u as EntityWirePredicate, v as EntityWireRef, w as EntityWireSort, x as EntityWriteAnswer, y as EntityWriteOptions, O as OP_ID_HEADER, z as createEntityClient, A as createEntityDataPort, B as createEntityRealtime, F as createSeedPort, G as entityNoticeKey, H as entityOrgChannel, I as entityOrgChannelSpec, J as entityOrgTopic, K as orderOrganizationTopics, L as readEntityRealtimeKnobs, M as toWireValue, N as toWireValues } from '../port-C-p-_lAu.js';
+import { m as RecordsErrorCode, P as PgError, a as RecordsError } from '../record-BrJNCmH1.js';
+import { Q as Query, C as Column, f as EntityRef, R as Row } from '../types-BALEbMc8.js';
+import '../ports-BE_5jz-c.js';
+import '../field-BIRNApm1.js';
 import '@ai-matrx/realtime';
-import '../relation-Dh-lCkkh.js';
+import '../relation-BxGXLRaG.js';
 
 /**
  * Every MX code a read door raises, and the engine code a screen branches on. A code the doors learn

package/dist/{field-CJtssH3q.d.ts → field-BIRNApm1.d.ts}

@@ -1,4 +1,4 @@
-import { U as Uuid, D as DeclarableFieldKind, x as FieldBehavior, y as ParityFieldType, c as FieldSensitivity, d as ContextPolicy, C as ComputeOn, O as OnDelete, F as FieldSource, h as Timestamp } from './record-CxGK1OEK.js';
+import { U as Uuid, D as DeclarableFieldKind, o as FieldBehavior, p as ParityFieldType, c as FieldSensitivity, d as ContextPolicy, C as ComputeOn, O as OnDelete, F as FieldSource, h as Timestamp } from './record-BrJNCmH1.js';
 
 /**
  * EVERYTHING THIS FILE NEEDS TO KNOW ABOUT A FIELD, AND NOTHING ELSE.
@@ -738,4 +738,4 @@ interface FieldDuplicated {
     values: "copied" | "not_a_value";
 }
 
-export { isButtonField as $, ADDRESS_PARTS as A, type ButtonPressed as B, type ChoiceOptions as C, STATUS_GROUP_WORDS as D, SYSTEM_WRITER_WORDS as E, type Field as F, type StatusGroup as G, addressFromText as H, addressMapUrl as I, addressText as J, type KernelTargets as K, allowsOtherValues as L, buttonNeeds as M, type NewFieldDeclaration as N, buttonOf as O, type ParityFieldTypeDescriptor as P, buttonUrlPlaceholders as Q, type RelationNamesAnswer as R, STATUS_GROUPS as S, type TableProposal as T, coerceTypedAnswer as U, coerceTypedAnswers as V, coercionLabel as W, durationText as X, entityReferenceKindsOf as Y, fieldKindFor as Z, isAddressValue as _, type FieldTypeWord as a, isEntityReferenceConfig as a0, isPersonStamp as a1, newerKindExportWords as a2, newerKindOf as a3, newerKindWords as a4, personStampText as a5, ratingMaxOf as a6, readTypedDuration as a7, relationNameIndexOf as a8, relationNameKey as a9, relationNamesIn as aa, richTextPlain as ab, safeLinkHref as ac, splitListCell as ad, statusGroupOf as ae, type FieldRule as b, type FieldPatch as c, type FieldDuplicated as d, type FieldProposal as e, AGENT_WRITER_WORDS as f, type AddressPart as g, type AddressValue as h, BARCODE_SYMBOLOGIES as i, BUTTON_DOES as j, type ButtonDoes as k, type ButtonSettings as l, type CoerceOptions as m, type Coerced as n, type CoercedAnswers as o, type CoercibleField as p, FIELD_KINDS as q, type FieldKind as r, type FieldOptionEdit as s, NEWER_FIELD_KINDS as t, NOT_A_MEMBER_WORDS as u, type NewerFieldKind as v, type PersonStamp as w, type RelationDisplay as x, type RelationNameIndex as y, type RelationNameMatch as z };
+export { isButtonField as $, ADDRESS_PARTS as A, BARCODE_SYMBOLOGIES as B, type ChoiceOptions as C, STATUS_GROUP_WORDS as D, SYSTEM_WRITER_WORDS as E, type Field as F, type StatusGroup as G, addressFromText as H, addressMapUrl as I, addressText as J, type KernelTargets as K, allowsOtherValues as L, buttonNeeds as M, type NewFieldDeclaration as N, buttonOf as O, type ParityFieldTypeDescriptor as P, buttonUrlPlaceholders as Q, type RelationDisplay as R, STATUS_GROUPS as S, type TableProposal as T, coerceTypedAnswer as U, coerceTypedAnswers as V, coercionLabel as W, durationText as X, entityReferenceKindsOf as Y, fieldKindFor as Z, isAddressValue as _, type FieldTypeWord as a, isEntityReferenceConfig as a0, isPersonStamp as a1, newerKindExportWords as a2, newerKindOf as a3, newerKindWords as a4, personStampText as a5, ratingMaxOf as a6, readTypedDuration as a7, relationNameIndexOf as a8, relationNameKey as a9, relationNamesIn as aa, richTextPlain as ab, safeLinkHref as ac, splitListCell as ad, statusGroupOf as ae, type FieldRule as b, AGENT_WRITER_WORDS as c, type AddressPart as d, type AddressValue as e, BUTTON_DOES as f, type ButtonDoes as g, type ButtonPressed as h, type ButtonSettings as i, type CoerceOptions as j, type Coerced as k, type CoercedAnswers as l, type CoercibleField as m, FIELD_KINDS as n, type FieldDuplicated as o, type FieldKind as p, type FieldOptionEdit as q, type FieldPatch as r, type FieldProposal as s, NEWER_FIELD_KINDS as t, NOT_A_MEMBER_WORDS as u, type NewerFieldKind as v, type PersonStamp as w, type RelationNameIndex as x, type RelationNameMatch as y, type RelationNamesAnswer as z };

package/dist/{field-DoVl2I9K.d.cts → field-BLy8drjM.d.cts}

@@ -1,4 +1,4 @@
-import { U as Uuid, D as DeclarableFieldKind, x as FieldBehavior, y as ParityFieldType, c as FieldSensitivity, d as ContextPolicy, C as ComputeOn, O as OnDelete, F as FieldSource, h as Timestamp } from './record-CxGK1OEK.cjs';
+import { U as Uuid, D as DeclarableFieldKind, o as FieldBehavior, p as ParityFieldType, c as FieldSensitivity, d as ContextPolicy, C as ComputeOn, O as OnDelete, F as FieldSource, h as Timestamp } from './record-BrJNCmH1.cjs';
 
 /**
  * EVERYTHING THIS FILE NEEDS TO KNOW ABOUT A FIELD, AND NOTHING ELSE.
@@ -738,4 +738,4 @@ interface FieldDuplicated {
     values: "copied" | "not_a_value";
 }
 
-export { isButtonField as $, ADDRESS_PARTS as A, type ButtonPressed as B, type ChoiceOptions as C, STATUS_GROUP_WORDS as D, SYSTEM_WRITER_WORDS as E, type Field as F, type StatusGroup as G, addressFromText as H, addressMapUrl as I, addressText as J, type KernelTargets as K, allowsOtherValues as L, buttonNeeds as M, type NewFieldDeclaration as N, buttonOf as O, type ParityFieldTypeDescriptor as P, buttonUrlPlaceholders as Q, type RelationNamesAnswer as R, STATUS_GROUPS as S, type TableProposal as T, coerceTypedAnswer as U, coerceTypedAnswers as V, coercionLabel as W, durationText as X, entityReferenceKindsOf as Y, fieldKindFor as Z, isAddressValue as _, type FieldTypeWord as a, isEntityReferenceConfig as a0, isPersonStamp as a1, newerKindExportWords as a2, newerKindOf as a3, newerKindWords as a4, personStampText as a5, ratingMaxOf as a6, readTypedDuration as a7, relationNameIndexOf as a8, relationNameKey as a9, relationNamesIn as aa, richTextPlain as ab, safeLinkHref as ac, splitListCell as ad, statusGroupOf as ae, type FieldRule as b, type FieldPatch as c, type FieldDuplicated as d, type FieldProposal as e, AGENT_WRITER_WORDS as f, type AddressPart as g, type AddressValue as h, BARCODE_SYMBOLOGIES as i, BUTTON_DOES as j, type ButtonDoes as k, type ButtonSettings as l, type CoerceOptions as m, type Coerced as n, type CoercedAnswers as o, type CoercibleField as p, FIELD_KINDS as q, type FieldKind as r, type FieldOptionEdit as s, NEWER_FIELD_KINDS as t, NOT_A_MEMBER_WORDS as u, type NewerFieldKind as v, type PersonStamp as w, type RelationDisplay as x, type RelationNameIndex as y, type RelationNameMatch as z };
+export { isButtonField as $, ADDRESS_PARTS as A, BARCODE_SYMBOLOGIES as B, type ChoiceOptions as C, STATUS_GROUP_WORDS as D, SYSTEM_WRITER_WORDS as E, type Field as F, type StatusGroup as G, addressFromText as H, addressMapUrl as I, addressText as J, type KernelTargets as K, allowsOtherValues as L, buttonNeeds as M, type NewFieldDeclaration as N, buttonOf as O, type ParityFieldTypeDescriptor as P, buttonUrlPlaceholders as Q, type RelationDisplay as R, STATUS_GROUPS as S, type TableProposal as T, coerceTypedAnswer as U, coerceTypedAnswers as V, coercionLabel as W, durationText as X, entityReferenceKindsOf as Y, fieldKindFor as Z, isAddressValue as _, type FieldTypeWord as a, isEntityReferenceConfig as a0, isPersonStamp as a1, newerKindExportWords as a2, newerKindOf as a3, newerKindWords as a4, personStampText as a5, ratingMaxOf as a6, readTypedDuration as a7, relationNameIndexOf as a8, relationNameKey as a9, relationNamesIn as aa, richTextPlain as ab, safeLinkHref as ac, splitListCell as ad, statusGroupOf as ae, type FieldRule as b, AGENT_WRITER_WORDS as c, type AddressPart as d, type AddressValue as e, BUTTON_DOES as f, type ButtonDoes as g, type ButtonPressed as h, type ButtonSettings as i, type CoerceOptions as j, type Coerced as k, type CoercedAnswers as l, type CoercibleField as m, FIELD_KINDS as n, type FieldDuplicated as o, type FieldKind as p, type FieldOptionEdit as q, type FieldPatch as r, type FieldProposal as s, NEWER_FIELD_KINDS as t, NOT_A_MEMBER_WORDS as u, type NewerFieldKind as v, type PersonStamp as w, type RelationNameIndex as x, type RelationNameMatch as y, type RelationNamesAnswer as z };

package/dist/forms/index.d.cts

@@ -1,6 +1,6 @@
-import { k as PortalAccent } from '../portal-C4N9ByaY.cjs';
-import { F as FormSummary, R as RuleExpression } from '../rule-DQpC7WqT.cjs';
-import { U as Uuid } from '../record-CxGK1OEK.cjs';
+import { P as PortalAccent } from '../portal-C_LgvDeh.cjs';
+import { F as FormSummary, R as RuleExpression } from '../rule-BGtYd6Pf.cjs';
+import { U as Uuid } from '../record-BrJNCmH1.cjs';
 
 /**
  * THE WORDS FOR EACH STATE, SAID ONCE, FOR EVERY SCREEN THAT SHOWS A FORM.

package/dist/forms/index.d.ts

@@ -1,6 +1,6 @@
-import { k as PortalAccent } from '../portal-DW5NGBT0.js';
-import { F as FormSummary, R as RuleExpression } from '../rule-xNwJF6Qo.js';
-import { U as Uuid } from '../record-CxGK1OEK.js';
+import { P as PortalAccent } from '../portal-B9HCNPTc.js';
+import { F as FormSummary, R as RuleExpression } from '../rule-BtjrE42J.js';
+import { U as Uuid } from '../record-BrJNCmH1.js';
 
 /**
  * THE WORDS FOR EACH STATE, SAID ONCE, FOR EVERY SCREEN THAT SHOWS A FORM.

package/dist/index.cjs

@@ -104,6 +104,7 @@ __export(src_exports, {
   addressMapUrl: () => addressMapUrl,
   addressText: () => addressText,
   allowsOtherValues: () => allowsOtherValues,
+  alternatePatch: () => alternatePatch,
   archivedByLine: () => archivedByLine,
   archivedWhen: () => archivedWhen,
   asChoiceNudge: () => asChoiceNudge,
@@ -121,6 +122,7 @@ __export(src_exports, {
   choiceSlug: () => choiceSlug,
   choiceValuesOf: () => choiceValuesOf,
   choicesOf: () => choicesOf,
+  chooseAlternate: () => chooseAlternate,
   coerceTypedAnswer: () => coerceTypedAnswer,
   coerceTypedAnswers: () => coerceTypedAnswers,
   coercionLabel: () => coercionLabel,
@@ -5345,4 +5347,47 @@ function tableRenderSchema(facts) {
   }
   return { kind: slug, fields: out };
 }
+
+// src/alternates.ts
+function refuse(code, message, hint) {
+  return { ok: false, error: { code, message, hint, ours: true } };
+}
+function alternatePatch(document, field_key, alternate_index) {
+  const block = document._values ?? {};
+  const envelope = block[field_key];
+  const alternates = Array.isArray(envelope?.alternates) ? envelope.alternates : [];
+  const chosen = alternates[alternate_index];
+  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 });
+  }
+  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 } : {} };
+  if (next.length > 0) changed["alternates"] = next;
+  return {
+    ok: true,
+    patch: {
+      [field_key]: chosen.value,
+      // THE WHOLE BLOCK — every other field's envelope and alternates travel with it.
+      _values: { ...block, [field_key]: changed }
+    }
+  };
+}
+async function chooseAlternate(client, { record_id, field_key, alternate_index }) {
+  const read = await client.recordRead({ record_id, withVersion: true });
+  if (!read.ok) return read;
+  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);
+  if (!built.ok) return refuse("not_found", built.message, "Reload, then look again.");
+  return client.recordUpdate({ record_id, patch: built.patch, expectedVersion: version });
+}
 //# sourceMappingURL=index.cjs.map