@ai-matrx/records 0.98.8 → 0.98.9

package/dist/core/index.cjs

@@ -119,6 +119,7 @@ __export(core_exports, {
   addressMapUrl: () => addressMapUrl,
   addressText: () => addressText,
   allowsOtherValues: () => allowsOtherValues,
+  alternatePatch: () => alternatePatch,
   announceRecordChanged: () => announceRecordChanged,
   announceTableStructureChanged: () => announceTableStructureChanged,
   archivedByLine: () => archivedByLine,
@@ -143,6 +144,7 @@ __export(core_exports, {
   choiceSlug: () => choiceSlug,
   choiceValuesOf: () => choiceValuesOf,
   choicesOf: () => choicesOf,
+  chooseAlternate: () => chooseAlternate,
   coerceTypedAnswer: () => coerceTypedAnswer,
   coerceTypedAnswers: () => coerceTypedAnswers,
   coercionLabel: () => coercionLabel,
@@ -5457,6 +5459,49 @@ 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 });
+}
+
 // src/core/primedBundle.ts
 var PRIMED_TTL_MS = 15e3;
 var REGISTRY = /* @__PURE__ */ Symbol.for("@ai-matrx/records/primed-table-page-bundles");
@@ -6491,6 +6536,14 @@ var DOORS = {
   // archived and aliased), and put any recorded Migration back.
   migrateMerge: "migrate_merge",
   migrateUndo: "migrate_undo",
+  // CORE-VISION (2026-10-10): the structural Migrations a person runs on ONE record from its menu.
+  // Split moves the named values to a new record of the same Table (the original keeps its id);
+  // extract parent copies the named values up into a new record of another Table and puts this
+  // record under it. Both answer a `migration_id` that `migrateUndo` takes. `migrations` lists
+  // the Migration log for one target, newest first.
+  migrateSplit: "migrate_split",
+  migrateExtractParent: "migrate_extract_parent",
+  migrations: "migrations",
   recordValues: "record_values",
   recordValuesVersioned: "record_values_versioned",
   valueRead: "value_read",
@@ -7045,7 +7098,7 @@ function doorCensus() {
 }
 
 // src/core/supabase.ts
-function refuse(code, message, hint) {
+function refuse2(code, message, hint) {
   return { data: null, error: { code, message, hint, details: "" } };
 }
 function supabaseDataSource(client) {
@@ -7058,7 +7111,7 @@ function supabaseDataSource(client) {
     rpc(fn, args, options) {
       if (!hasSchema) {
         return Promise.resolve(
-          refuse(
+          refuse2(
             "data_source_unbound",
             `The records client was given something that is not a supabase client: it has no schema() method, so the door ${fn} cannot be called in the schema it lives in.`,
             "Pass a supabase-js v2 client (createClient(...)) to supabaseDataSource()."
@@ -7068,7 +7121,7 @@ function supabaseDataSource(client) {
       const name = options?.schema;
       if (!name) {
         return Promise.resolve(
-          refuse(
+          refuse2(
             "schema_unsaid",
             `The door ${fn} was called without saying which schema it lives in. Every door of this store is custom.${fn} and every trust door is iam.${fn}; an unqualified call reaches PostgREST's default profile (public) and is refused there.`,
             "This is a bug in the caller, not in your data: /core says the schema on every call."
@@ -8419,6 +8472,49 @@ function createRecordsClient(given) {
       }
       return result;
     },
+    async migrateSplit({ record_id, moved_keys, note }) {
+      const result = await callDoor(
+        DOORS.migrateSplit,
+        { p_organization_id: org, p_record_id: record_id, p_moved_keys: moved_keys, p_note: note ?? null },
+        "migrateSplit"
+      );
+      if (result.ok) {
+        announceRecordChanged(record_id);
+        announceRecordChanged(result.data.new_record);
+      }
+      return result;
+    },
+    async migrateExtractParent({ record_id, parent_table_id, moved_keys, note }) {
+      const result = await callDoor(
+        DOORS.migrateExtractParent,
+        { p_organization_id: org, p_id: record_id, p_parent_table_id: parent_table_id, p_moved_keys: moved_keys, p_note: note ?? null },
+        "migrateExtractParent"
+      );
+      if (result.ok) {
+        announceRecordChanged(record_id);
+        announceRecordChanged(result.data.parent);
+      }
+      return result;
+    },
+    async migrations({ target_id, limit }) {
+      return callDoor(
+        DOORS.migrations,
+        { p_organization_id: org, p_target_id: target_id ?? null, p_limit: limit ?? 100 },
+        "migrations"
+      );
+    },
+    async recordAsOf({ record_id, recorded_at, world_on }) {
+      return callDoor(
+        DOORS.queryRecordAsOf,
+        {
+          p_organization_id: org,
+          p_record_id: record_id,
+          ...recorded_at ? { p_recorded_at: recorded_at } : {},
+          ...world_on ? { p_world_on: world_on.slice(0, 10) } : {}
+        },
+        "recordAsOf"
+      );
+    },
     async migrateUndo({ migration_id }) {
       const result = await callDoor(
         DOORS.migrateUndo,
@@ -8426,6 +8522,7 @@ function createRecordsClient(given) {
         "migrateUndo"
       );
       if (result.ok && result.data.record_id) announceRecordChanged(result.data.record_id);
+      if (result.ok && result.data.removed) announceRecordChanged(result.data.removed);
       return result;
     },
     async fieldUpdate({ field_id, patch }) {