@ai-matrx/records 0.98.7 → 0.98.9

package/dist/core/index.cjs

@@ -103,6 +103,7 @@ __export(core_exports, {
   STORE_DOORS: () => STORE_DOORS,
   STORE_KNOBS: () => STORE_KNOBS,
   STORE_REFUSAL_CODES: () => STORE_REFUSAL_CODES,
+  STORE_SCHEMA: () => STORE_SCHEMA,
   SYSTEM_WRITER_WORDS: () => SYSTEM_WRITER_WORDS,
   TABLE_DISPLAYS: () => TABLE_DISPLAYS,
   TABLE_KIND_PREFIX: () => TABLE_KIND_PREFIX,
@@ -118,6 +119,7 @@ __export(core_exports, {
   addressMapUrl: () => addressMapUrl,
   addressText: () => addressText,
   allowsOtherValues: () => allowsOtherValues,
+  alternatePatch: () => alternatePatch,
   announceRecordChanged: () => announceRecordChanged,
   announceTableStructureChanged: () => announceTableStructureChanged,
   archivedByLine: () => archivedByLine,
@@ -142,6 +144,7 @@ __export(core_exports, {
   choiceSlug: () => choiceSlug,
   choiceValuesOf: () => choiceValuesOf,
   choicesOf: () => choicesOf,
+  chooseAlternate: () => chooseAlternate,
   coerceTypedAnswer: () => coerceTypedAnswer,
   coerceTypedAnswers: () => coerceTypedAnswers,
   coercionLabel: () => coercionLabel,
@@ -296,6 +299,7 @@ __export(core_exports, {
   stableFilterKey: () => stableFilterKey,
   staleWriteDetail: () => staleWriteDetail,
   statusGroupOf: () => statusGroupOf,
+  storeDoors: () => storeDoors,
   supabaseDataSource: () => supabaseDataSource,
   tableIdOf: () => tableIdOf,
   tableJsonSchema: () => tableJsonSchema,
@@ -5455,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");
@@ -6489,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",
@@ -7043,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) {
@@ -7056,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()."
@@ -7066,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."
@@ -8417,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,
@@ -8424,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 }) {
@@ -11059,6 +11158,58 @@ function blockLandedInStore(outcomes, block) {
   return false;
 }
 
+// src/core/storeDoors.ts
+var STORE_SCHEMA = "custom";
+function storeDoors(client) {
+  const source = supabaseDataSource(client ?? {});
+  const call = (fn, args = {}) => source.rpc(fn, args, { schema: STORE_SCHEMA });
+  const typed = (fn, args) => call(fn, args);
+  return {
+    rpc: call,
+    async whereIdOpens(id) {
+      const raw = await call("where_id_opens", { p_id: id });
+      const e = raw.error;
+      return {
+        data: raw.data ?? null,
+        error: e ? { code: typeof e.code === "string" ? e.code : null, message: typeof e.message === "string" ? e.message : "The record store refused." } : null
+      };
+    },
+    tableKernelId: () => typed("table_kernel_id", {}),
+    readRecordsByIds: (organizationId, tableId, ids) => typed("read_records_by_ids", { p_organization_id: organizationId, p_table_id: tableId, p_record_ids: ids }),
+    readRecordsPage: (args) => typed("read_records_page", args),
+    recordTable: (organizationId, recordId) => typed("record_table", { p_organization_id: organizationId, p_record_id: recordId }),
+    applicableFields: (organizationId, tableId) => typed("applicable_fields", { p_organization_id: organizationId, p_table_id: tableId }),
+    fieldDeclare: (organizationId, tableId, spec) => typed("field_declare", { p_organization_id: organizationId, p_table_id: tableId, p_spec: spec }),
+    recordUpdate: (organizationId, recordId, patch) => typed("record_update", { p_organization_id: organizationId, p_record_id: recordId, p_patch: patch }),
+    entityReferenceWords: (organizationId, refs) => typed("entity_reference_words", { p_organization_id: organizationId, p_refs: refs.map((r) => ({ token: r.token, id: r.id })) }),
+    templates: (filter) => typed("templates", { p_filter: filter }),
+    templateFromTables: ({ organizationId, tableIds, includeRows, rowsPerTable }) => typed("template_from_tables", {
+      p_organization_id: organizationId,
+      p_table_ids: tableIds,
+      p_include_rows: includeRows,
+      p_rows_per_table: rowsPerTable
+    }),
+    templateDeclare: (scope, spec) => typed("template_declare", { p_scope: scope, p_spec: spec }),
+    templateKeep: (templateId) => typed("template_keep", { p_template_id: templateId }),
+    templateArchive: (templateId, restore) => typed("template_archive", restore === void 0 ? { p_template_id: templateId } : { p_template_id: templateId, p_restore: restore }),
+    templateInstallClaim: ({ organizationId, installId, kind, label, sourceId, leaseSeconds }) => typed("template_install_claim", {
+      p_organization_id: organizationId,
+      p_install_id: installId,
+      p_kind: kind,
+      p_label: label,
+      ...sourceId ? { p_source_id: sourceId } : {},
+      p_lease_seconds: leaseSeconds
+    }),
+    templateInstallNote: ({ organizationId, installId, kind, id, label }) => typed("template_install_note", {
+      p_organization_id: organizationId,
+      p_install_id: installId,
+      p_kind: kind,
+      p_id: id,
+      p_label: label
+    })
+  };
+}
+
 // src/core/validation.ts
 var import_uuid7 = require("@ai-matrx/kit/uuid");
 var DEFAULT_VALUE_MAX_BYTES = 1e5;