@ai-matrx/records 0.92.1 → 0.93.0

package/dist/setup/index.cjs

@@ -410,35 +410,48 @@ function sourceArchivedOf(value) {
 var import_global_slot2 = require("@ai-matrx/kit/global-slot");
 var REMEMBER_MS = 3e4;
 var REMEMBER_MAX = 500;
-var ours = (0, import_global_slot2.globalSlot)("ai-matrx.records.op-ledger", () => /* @__PURE__ */ new Map());
-function trim(now) {
-  for (const [id, at] of ours) {
-    if (now - at <= REMEMBER_MS) break;
-    ours.delete(id);
-  }
-  while (ours.size > REMEMBER_MAX) {
-    const oldest = ours.keys().next();
-    if (oldest.done === true) break;
-    ours.delete(oldest.value);
+function ledgerOver(ours) {
+  function trim(now) {
+    for (const [id, at] of ours) {
+      if (now - at <= REMEMBER_MS) break;
+      ours.delete(id);
+    }
+    while (ours.size > REMEMBER_MAX) {
+      const oldest = ours.keys().next();
+      if (oldest.done === true) break;
+      ours.delete(oldest.value);
+    }
   }
+  return {
+    mint() {
+      const id = crypto.randomUUID();
+      const now = Date.now();
+      ours.set(id, now);
+      trim(now);
+      return id;
+    },
+    isOwn(opId) {
+      if (!opId) return false;
+      const at = ours.get(opId);
+      if (at === void 0) return false;
+      if (Date.now() - at > REMEMBER_MS) {
+        ours.delete(opId);
+        return false;
+      }
+      return true;
+    },
+    clear() {
+      ours.clear();
+    },
+    get size() {
+      return ours.size;
+    }
+  };
 }
-function mintOpId() {
-  const id = crypto.randomUUID();
-  const now = Date.now();
-  ours.set(id, now);
-  trim(now);
-  return id;
-}
-function isOwnOp(opId) {
-  if (!opId) return false;
-  const at = ours.get(opId);
-  if (at === void 0) return false;
-  if (Date.now() - at > REMEMBER_MS) {
-    ours.delete(opId);
-    return false;
-  }
-  return true;
+function createOpLedger() {
+  return ledgerOver(/* @__PURE__ */ new Map());
 }
+var defaultOpLedger = ledgerOver((0, import_global_slot2.globalSlot)("ai-matrx.records.op-ledger", () => /* @__PURE__ */ new Map()));
 
 // src/choice.ts
 var import_uuid2 = require("@ai-matrx/kit/uuid");
@@ -2497,6 +2510,8 @@ function createRecordsClient(given) {
   const config = { ...given, dataSource: asRecordsDataSource(given.dataSource) };
   const schema = config.schema ?? DEFAULT_SCHEMA;
   const org = config.organizationId;
+  const ledger = config.opLedger ?? defaultOpLedger;
+  const mintOp = () => ledger.mint();
   const scream = sink(config);
   const BUNDLE_TTL_MS = 1e4;
   const BUNDLE_OPENERS = /* @__PURE__ */ new Set(["applicable_fields", "views", "view_look_read", "table_decorations", "row_actions", "reverse_columns", "record_change_actions", "grid_layout", "io_imports"]);
@@ -2883,14 +2898,14 @@ function createRecordsClient(given) {
     async recordWrite({ table_id, data }) {
       const result = await callDoor(
         DOORS.recordWrite,
-        { p_organization_id: org, p_table_id: table_id, p_data: { ...data, _op_id: mintOpId() } },
+        { p_organization_id: org, p_table_id: table_id, p_data: { ...data, _op_id: mintOp() } },
         "recordWrite"
       );
       if (result.ok && typeof result.data === "string") announceRecordChanged(result.data);
       return result;
     },
     async recordWriteMany({ table_id, rows, ids }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       return callDoor(
         DOORS.recordWriteMany,
         {
@@ -2903,7 +2918,7 @@ function createRecordsClient(given) {
       );
     },
     async recordChangeMany({ table_id, changes }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       const result = await callDoor(
         DOORS.recordChangeMany,
         {
@@ -2926,7 +2941,7 @@ function createRecordsClient(given) {
       return result;
     },
     async recordWriteGraph({ table_id, parent, children, edges }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       return callDoor(
         DOORS.recordWriteGraph,
         {
@@ -2950,7 +2965,7 @@ function createRecordsClient(given) {
         {
           p_organization_id: org,
           p_record_id: record_id,
-          p_patch: { ...patch, _op_id: mintOpId() },
+          p_patch: { ...patch, _op_id: mintOp() },
           ...expectedVersion === void 0 ? {} : { p_expected_version: expectedVersion }
         },
         "recordUpdate"
@@ -2964,7 +2979,7 @@ function createRecordsClient(given) {
         {
           p_organization_id: org,
           p_record_id: record_id,
-          p_patch: { ...patch, _op_id: mintOpId() },
+          p_patch: { ...patch, _op_id: mintOp() },
           p_add: add,
           ...expectedVersion === void 0 ? {} : { p_expected_version: expectedVersion }
         },
@@ -3989,7 +4004,7 @@ function createRecordsClient(given) {
           p_table_id: table_id,
           p_key: keys,
           // The op id rides the envelope, as `recordWrite` / `recordUpdate` send it; each door takes it off.
-          p_data: { ...data, _op_id: mintOpId() },
+          p_data: { ...data, _op_id: mintOp() },
           ...expectedVersion === void 0 ? {} : { p_expected_version: expectedVersion }
         },
         "recordUpsert"
@@ -6374,6 +6389,7 @@ function toWireValues(values) {
 }
 function createEntityDataPort(options) {
   const client = options.client ?? createEntityClient({ dataSource: options.dataSource });
+  const ledger = options.opLedger ?? defaultOpLedger;
   const activeOrganization = () => (options.activeOrganizationId ? options.activeOrganizationId() : options.organization) ?? null;
   const gets = /* @__PURE__ */ new Map();
   const aliases = options.aliases;
@@ -6564,27 +6580,27 @@ function createEntityDataPort(options) {
           "Pick an organization, then add the row again. Nothing was saved."
         );
       }
-      const answer = await client.insert({ token: binding.token, organizationId, rows: [toWireValues(values)], opId: mintOpId() });
+      const answer = await client.insert({ token: binding.token, organizationId, rows: [toWireValues(values)], opId: ledger.mint() });
       return readBack(alias, answer, "The new row");
     },
     async update(alias, id, patch, baseVersion) {
       const binding = bindingOf(alias);
       if (!binding) return noSuchAlias(alias);
       if (!(0, import_uuid3.isUuidShape)(id)) return refusal("invalid_argument", `"${String(id)}" is not a row id.`);
-      const answer = await client.update({ token: binding.token, id, baseVersion, patch: toWireValues(patch), opId: mintOpId() });
+      const answer = await client.update({ token: binding.token, id, baseVersion, patch: toWireValues(patch), opId: ledger.mint() });
       return readBack(alias, answer, "The change");
     },
     async archive(alias, id) {
       const binding = bindingOf(alias);
       if (!binding) return noSuchAlias(alias);
       if (!(0, import_uuid3.isUuidShape)(id)) return refusal("invalid_argument", `"${String(id)}" is not a row id.`);
-      return done(await client.archive({ token: binding.token, ids: [id], opId: mintOpId() }));
+      return done(await client.archive({ token: binding.token, ids: [id], opId: ledger.mint() }));
     },
     async restore(alias, id) {
       const binding = bindingOf(alias);
       if (!binding) return noSuchAlias(alias);
       if (!(0, import_uuid3.isUuidShape)(id)) return refusal("invalid_argument", `"${String(id)}" is not a row id.`);
-      return done(await client.unarchive({ token: binding.token, ids: [id], opId: mintOpId() }));
+      return done(await client.unarchive({ token: binding.token, ids: [id], opId: ledger.mint() }));
     },
     subscribe(event, listener) {
       const alias = event.startsWith("rows:") ? event.slice(5) : null;
@@ -6634,6 +6650,48 @@ function createEntityDataPort(options) {
   };
 }
 
+// src/objectOrganization.ts
+var WHERE_ID_OPENS_DOOR = "where_id_opens";
+function doorIsAbsent(error) {
+  if (error.code === "PGRST202" || error.code === "42883") return true;
+  return /could not find the function/i.test(error.message ?? "");
+}
+var DOOR_ABSENT_WHY = "custom.where_id_opens is missing from this database, so this page cannot tell which organization the record lives in and holds instead of guessing. Remedy: the chair applies migrations/campaign/openbyid_one_address_opens_any_id.sql and openbyid_the_resolver_can_be_reached.sql.";
+async function resolveObjectOrganization(dataSource, id) {
+  let answered;
+  try {
+    answered = await dataSource.rpc(WHERE_ID_OPENS_DOOR, { p_id: id }, { schema: "custom" });
+  } catch (thrown) {
+    return { state: "unavailable", why: thrown instanceof Error ? thrown.message : "The record store did not answer." };
+  }
+  return readObjectOrganizationAnswer(answered, id);
+}
+function readObjectOrganizationAnswer(answered, id) {
+  if (answered.error) {
+    if (doorIsAbsent(answered.error)) {
+      console.warn(`[@ai-matrx/records] ${DOOR_ABSENT_WHY}`);
+      return { state: "unavailable", why: DOOR_ABSENT_WHY };
+    }
+    return { state: "unavailable", why: answered.error.message ?? "The record store refused to say where this is." };
+  }
+  const row = answered.data;
+  if (row === null || row === void 0) return { state: "not-given" };
+  if (typeof row !== "object" || typeof row.organization_id !== "string" || typeof row.kind !== "string") {
+    return { state: "unavailable", why: "The record store answered something this page cannot read." };
+  }
+  return {
+    state: "found",
+    organizationId: row.organization_id,
+    kind: row.kind,
+    path: typeof row.path === "string" ? row.path : null,
+    live: row.live !== false,
+    resolvedId: typeof row.resolved_id === "string" ? row.resolved_id : id
+  };
+}
+function whereIdOpensPort(dataSource) {
+  return { organizationOf: (id) => resolveObjectOrganization(dataSource, id) };
+}
+
 // src/realtime/index.ts
 var import_realtime3 = require("@ai-matrx/realtime");
 var storeTableChannel = (0, import_realtime3.defineChannelNamespace)({
@@ -6649,7 +6707,7 @@ function noticeKey(notice) {
   const ids = notice.record_ids == null ? "*" : [...notice.record_ids].sort().join(",");
   return `${notice.table_id ?? ""}:${notice.kind ?? ""}:${notice.op ?? ""}:${notice.op_id ?? ""}:${notice.at}:${ids}`;
 }
-function storeTableChannelSpec(tableId, onNotice, onBackfill) {
+function storeTableChannelSpec(tableId, onNotice, onBackfill, ledger = defaultOpLedger) {
   return {
     topic: storeTableChannel.topic({ tableId }),
     // Database Broadcast is authorized by RLS on realtime.messages — that is what `private` means here;
@@ -6657,14 +6715,14 @@ function storeTableChannelSpec(tableId, onNotice, onBackfill) {
     // delivers nothing forever).
     private: true,
     // The sender is Postgres: no Matrx envelope. OUR OWN WRITE is known by the op id the write door carried.
-    wire: { mode: "raw", isOwnMessage: (payload) => isOwnOp(payload?.op_id) },
+    wire: { mode: "raw", isOwnMessage: (payload) => ledger.isOwn(payload?.op_id) },
     eventKey: (_source, payload) => noticeKey(payload ?? {}),
     broadcast: [
       {
         event: STORE_NOTICE_EVENT,
         onMessage: (message) => {
           const notice = message.data ?? {};
-          if (isOwnOp(notice.op_id)) return;
+          if (ledger.isOwn(notice.op_id)) return;
           onNotice(notice);
         }
       }
@@ -6684,7 +6742,8 @@ function createRecordsRealtimePort(options = {}) {
       },
       () => {
         for (const listener of channel.listeners) listener.backfill();
-      }
+      },
+      options.ledger
     );
     if (options.manager) {
       const handle = options.manager.open(spec);
@@ -6802,22 +6861,26 @@ async function createRecords(options) {
   } else if (options.live) {
     realtime = options.live;
   }
-  const realtimePort = realtime ? createRecordsRealtimePort({ manager: realtime }) : void 0;
+  const opLedger = createOpLedger();
+  const realtimePort = realtime ? createRecordsRealtimePort({ manager: realtime, ledger: opLedger }) : void 0;
   const actor = options.actor ?? { actor: "user", ...userId ? { user_id: userId } : {} };
   const records = createRecordsClient({
     dataSource,
     actor,
     organizationId,
     organizationIds,
+    opLedger,
     ...realtimePort ? { realtime: realtimePort } : {},
     ...options.onError ? { onError: options.onError } : {}
   });
   const entities = createEntityDataPort({
     dataSource,
     aliases: options.entityAliases ?? {},
+    opLedger,
     ...organizationId ? { organization: organizationId } : {}
   });
   const organizationIdChosen = organizationId;
+  const organizationPort = options.organizationOf ?? whereIdOpensPort(dataSource);
   let warnedNotLive = false;
   return {
     authKind: options.auth.kind,
@@ -6846,6 +6909,18 @@ async function createRecords(options) {
       }) });
     },
     associations: options.associations,
+    organizationOf: (id) => organizationPort.organizationOf(id),
+    rowAgent: options.rowAgent ?? null,
+    async runAgentOnRow(target) {
+      if (!options.rowAgent) {
+        return {
+          ok: false,
+          error: { code: "not_supported", message: "No agent runner is bound: pass createRecords({ rowAgent }) to run an agent on a row." }
+        };
+      }
+      await options.rowAgent.run(target);
+      return { ok: true, data: void 0 };
+    },
     close() {
       if (ownsRealtime) realtime?.dispose();
     }