@ai-matrx/records 0.86.2 → 0.87.1

package/dist/react/index.d.cts

@@ -15285,40 +15285,6 @@ interface RecordsSeed {
     answers: RecordsSeedAnswer[];
 }
 
-/**
- * THE CLIENT OPERATION LEDGER — how a browser recognises the echo of its own write.
- *
- * Every private-channel notice the record store broadcasts reaches EVERY browser watching that
- * Table, including the one that caused it. Until now the writer had no way to tell its own
- * change from a colleague's: the notice carried ids and nothing about who moved them, so
- * `recordsRealtimePort.ts` declared `acceptEchoFromSelf: true` and the writer re-read a page it
- * had already updated. It was named honestly rather than faked, and this is the other half.
- *
- * THE SHAPE. Every write through `RecordsClient` mints a uuid, sends it to the store as the
- * platform envelope key `_op_id`, and remembers it here. The store lifts that key out before
- * storage — it is never written onto the record — carries it on the change-feed row, and puts
- * it in the notice as `op_id`. A notice whose `op_id` is in this ledger is this browser's own
- * echo and is dropped.
- *
- * WHY A TIME WINDOW RATHER THAN A DELETE-ON-MATCH. One write can produce MORE THAN ONE notice:
- * a record write that also moves a column produces a `record` notice and a `field` notice, and
- * a statement touching two Tables produces one per Table. Forgetting an op the first time it
- * came back would make the second notice look like somebody else's and cost the re-read this
- * exists to avoid. So an op is remembered for a window and expires on its own.
- *
- * 🚨 THE WINDOW IS A CORRECTNESS BOUNDARY, NOT A TUNING KNOB, AND IT FAILS IN THE SAFE
- * DIRECTION BY CONSTRUCTION. Too SHORT and a late echo is treated as a stranger's change: one
- * extra read of a page that is already correct — invisible. Too LONG and a stranger's change
- * that happened to reuse our uuid would be dropped — which cannot happen, because it is a v4
- * uuid nobody else has ever seen. The only real cost of a long window is memory, so it is
- * bounded by COUNT as well as by time.
- *
- * WHAT THIS IS NOT. It is not a replacement for the store's optimistic concurrency, and it
- * never decides what is true — a dropped echo means "I already know about this", and every
- * path that could be wrong about that (a reconnect, a tab wake, a notice with no `op_id` at
- * all) re-reads through the door as it always did.
- */
-
 /**
  * Mint the id for one client operation and remember it as ours.
  *
@@ -15997,9 +15963,9 @@ declare const f: {
     member: <const O extends FieldOptions = {}>(opts?: O) => AppField<string, Req<O>, false, Uniq<O>>;
     /** A file. */
     attachment: <const O extends FieldOptions = {}>(opts?: O) => AppField<string, Req<O>, false, Uniq<O>>;
-    /** A platform thing (`note`, `agent` …) of one of `kinds`. */
+    /** A platform thing (`note`, `agent` …) of one of `kinds`: `{ token, id }`, the store's own shape. */
     entityReference: <const O extends FieldOptions = {}>(kinds: readonly string[], opts?: O) => AppField<{
-        type: string;
+        token: string;
         id: Uuid;
     }, Req<O>, false, Uniq<O>>;
     /** Computed by the store from `formulaText` (`{Visit fee} - {Deposit taken}`); read-only. */

package/dist/react/index.d.ts

@@ -15285,40 +15285,6 @@ interface RecordsSeed {
     answers: RecordsSeedAnswer[];
 }
 
-/**
- * THE CLIENT OPERATION LEDGER — how a browser recognises the echo of its own write.
- *
- * Every private-channel notice the record store broadcasts reaches EVERY browser watching that
- * Table, including the one that caused it. Until now the writer had no way to tell its own
- * change from a colleague's: the notice carried ids and nothing about who moved them, so
- * `recordsRealtimePort.ts` declared `acceptEchoFromSelf: true` and the writer re-read a page it
- * had already updated. It was named honestly rather than faked, and this is the other half.
- *
- * THE SHAPE. Every write through `RecordsClient` mints a uuid, sends it to the store as the
- * platform envelope key `_op_id`, and remembers it here. The store lifts that key out before
- * storage — it is never written onto the record — carries it on the change-feed row, and puts
- * it in the notice as `op_id`. A notice whose `op_id` is in this ledger is this browser's own
- * echo and is dropped.
- *
- * WHY A TIME WINDOW RATHER THAN A DELETE-ON-MATCH. One write can produce MORE THAN ONE notice:
- * a record write that also moves a column produces a `record` notice and a `field` notice, and
- * a statement touching two Tables produces one per Table. Forgetting an op the first time it
- * came back would make the second notice look like somebody else's and cost the re-read this
- * exists to avoid. So an op is remembered for a window and expires on its own.
- *
- * 🚨 THE WINDOW IS A CORRECTNESS BOUNDARY, NOT A TUNING KNOB, AND IT FAILS IN THE SAFE
- * DIRECTION BY CONSTRUCTION. Too SHORT and a late echo is treated as a stranger's change: one
- * extra read of a page that is already correct — invisible. Too LONG and a stranger's change
- * that happened to reuse our uuid would be dropped — which cannot happen, because it is a v4
- * uuid nobody else has ever seen. The only real cost of a long window is memory, so it is
- * bounded by COUNT as well as by time.
- *
- * WHAT THIS IS NOT. It is not a replacement for the store's optimistic concurrency, and it
- * never decides what is true — a dropped echo means "I already know about this", and every
- * path that could be wrong about that (a reconnect, a tab wake, a notice with no `op_id` at
- * all) re-reads through the door as it always did.
- */
-
 /**
  * Mint the id for one client operation and remember it as ours.
  *
@@ -15997,9 +15963,9 @@ declare const f: {
     member: <const O extends FieldOptions = {}>(opts?: O) => AppField<string, Req<O>, false, Uniq<O>>;
     /** A file. */
     attachment: <const O extends FieldOptions = {}>(opts?: O) => AppField<string, Req<O>, false, Uniq<O>>;
-    /** A platform thing (`note`, `agent` …) of one of `kinds`. */
+    /** A platform thing (`note`, `agent` …) of one of `kinds`: `{ token, id }`, the store's own shape. */
     entityReference: <const O extends FieldOptions = {}>(kinds: readonly string[], opts?: O) => AppField<{
-        type: string;
+        token: string;
         id: Uuid;
     }, Req<O>, false, Uniq<O>>;
     /** Computed by the store from `formulaText` (`{Visit fee} - {Deposit taken}`); read-only. */

package/dist/react/index.js

@@ -70,7 +70,8 @@ function isWritingDoor(door) {
 }
 
 // src/core/recordChanges.ts
-var listeners = /* @__PURE__ */ new Set();
+import { globalSlot } from "@ai-matrx/kit/global-slot";
+var listeners = globalSlot("ai-matrx.records.record-change-listeners", () => /* @__PURE__ */ new Set());
 function announceRecordChanged(recordId) {
   for (const listener of [...listeners]) {
     try {
@@ -80,7 +81,7 @@ function announceRecordChanged(recordId) {
     }
   }
 }
-var removed = /* @__PURE__ */ new Set();
+var removed = globalSlot("ai-matrx.records.removed-records", () => /* @__PURE__ */ new Set());
 function markRecordRemoved(recordId) {
   removed.add(recordId);
 }
@@ -94,7 +95,7 @@ function onRecordChanged(listener) {
   listeners.add(listener);
   return () => listeners.delete(listener);
 }
-var tableListeners = /* @__PURE__ */ new Set();
+var tableListeners = globalSlot("ai-matrx.records.table-structure-listeners", () => /* @__PURE__ */ new Set());
 function announceTableStructureChanged(tableId) {
   for (const listener of [...tableListeners]) {
     try {
@@ -496,9 +497,10 @@ function sourceArchivedOf(value) {
 }
 
 // src/ops.ts
+import { globalSlot as globalSlot2 } from "@ai-matrx/kit/global-slot";
 var REMEMBER_MS = 3e4;
 var REMEMBER_MAX = 500;
-var ours = /* @__PURE__ */ new Map();
+var ours = globalSlot2("ai-matrx.records.op-ledger", () => /* @__PURE__ */ new Map());
 function trim(now) {
   for (const [id, at] of ours) {
     if (now - at <= REMEMBER_MS) break;
@@ -10418,8 +10420,9 @@ function optionsTableOf(field2) {
   return typeof id === "string" && id ? id : null;
 }
 async function readTableShape(client, tableId) {
-  const fields = await client.fields({ table_id: tableId });
+  const [fields, table] = await Promise.all([client.fields({ table_id: tableId }), client.tableRead({ table_id: tableId, organization_id: client.config.organizationId })]);
   if (!fields.ok) return fields;
+  const titleField = table.ok ? table.data?.title_field ?? null : null;
   const choiceFields = fields.data.filter((f2) => optionsTableOf(f2) !== null);
   const options = await Promise.all(choiceFields.map((f2) => client.fieldOptions({ field_id: f2.id })));
   const choicesById = /* @__PURE__ */ new Map();
@@ -10443,8 +10446,10 @@ async function readTableShape(client, tableId) {
       type,
       origin: "custom",
       required: Boolean(field2.required),
+      multi: field2.multi === true,
       readOnly: COMPUTED_TYPES.has(field2.type) || field2.source === "formula" || field2.compute_on !== null && field2.compute_on !== void 0
     };
+    if (titleField !== null && (titleField === field2.key || titleField === field2.id)) column.title = true;
     const choices = choicesById.get(field2.id);
     if (choices) column.choices = choices;
     if (field2.type === "relation" && field2.relation_target) column.linksTo = [field2.relation_target];
@@ -10710,7 +10715,15 @@ function createTableDataPort({ client, aliases }) {
       const binding = bindingOf(alias);
       if (!binding) return noSuchAlias(alias);
       const shape = await shapeOf(alias, binding);
-      return shape.ok ? { ok: true, data: shape.data.columns } : shape;
+      if (!shape.ok) return shape;
+      return {
+        ok: true,
+        data: shape.data.columns.map((c) => {
+          const target = c.type === "relation" && c.linksTo?.length === 1 ? c.linksTo[0] : null;
+          const served = target ? Object.entries(aliases).find(([, b]) => b.tableId === target)?.[0] : void 0;
+          return served ? { ...c, linksToSource: served } : c;
+        })
+      };
     },
     async list(alias, q = {}, cursor) {
       const binding = bindingOf(alias);
@@ -11557,7 +11570,7 @@ var f = {
   member: (opts) => field("member", opts),
   /** A file. */
   attachment: (opts) => field("attachment", opts),
-  /** A platform thing (`note`, `agent` …) of one of `kinds`. */
+  /** A platform thing (`note`, `agent` …) of one of `kinds`: `{ token, id }`, the store's own shape. */
   entityReference: (kinds, opts) => field("entity_reference", opts, { allowedTypes: [...kinds] }),
   /** Computed by the store from `formulaText` (`{Visit fee} - {Deposit taken}`); read-only. */
   formula: (formulaText, opts) => field("formula", opts, { declaration: { formula_text: formulaText, ...opts?.declaration ?? {} } }, true),