@ai-matrx/records 0.92.1 → 0.93.0

package/dist/react/index.js

@@ -509,40 +509,59 @@ function sourceArchivedOf(value) {
 import { globalSlot as globalSlot2 } from "@ai-matrx/kit/global-slot";
 var REMEMBER_MS = 3e4;
 var REMEMBER_MAX = 500;
-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;
-    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 createOpLedger() {
+  return ledgerOver(/* @__PURE__ */ new Map());
+}
+var defaultOpLedger = ledgerOver(globalSlot2("ai-matrx.records.op-ledger", () => /* @__PURE__ */ new Map()));
 function mintOpId() {
-  const id = crypto.randomUUID();
-  const now = Date.now();
-  ours.set(id, now);
-  trim(now);
-  return id;
+  return defaultOpLedger.mint();
 }
 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;
+  return defaultOpLedger.isOwn(opId);
 }
 function forgetAllOps() {
-  ours.clear();
+  defaultOpLedger.clear();
 }
 function rememberedOpCount() {
-  return ours.size;
+  return defaultOpLedger.size;
 }
 
 // src/choice.ts
@@ -4208,6 +4227,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"]);
@@ -4594,14 +4615,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,
         {
@@ -4614,7 +4635,7 @@ function createRecordsClient(given) {
       );
     },
     async recordChangeMany({ table_id, changes }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       const result = await callDoor(
         DOORS.recordChangeMany,
         {
@@ -4637,7 +4658,7 @@ function createRecordsClient(given) {
       return result;
     },
     async recordWriteGraph({ table_id, parent, children, edges }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       return callDoor(
         DOORS.recordWriteGraph,
         {
@@ -4661,7 +4682,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"
@@ -4675,7 +4696,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 }
         },
@@ -5700,7 +5721,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"
@@ -12103,6 +12124,48 @@ function openCaptureQueue(opts) {
   return queue;
 }
 
+// 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/record-scope.ts
 function scopeChip(scope) {
   return scope.title ? `About: ${scope.title}` : "About: this record";
@@ -12576,6 +12639,7 @@ export {
   TO_CUSTOM_FIELDS,
   VALUE_ALTERNATE_KEYS,
   VALUE_ENVELOPE_KEYS,
+  WHERE_ID_OPENS_DOOR,
   actionRefusals,
   addressFromText,
   addressMapUrl,
@@ -12608,8 +12672,10 @@ export {
   confidentialRefusal,
   confidentialRequest,
   confidentialState,
+  createOpLedger,
   decideTypedChoice,
   declareDrillDefinition,
+  defaultOpLedger,
   defineTypedTable,
   drillAnswerOf,
   drillFindingKnob,
@@ -12695,6 +12761,7 @@ export {
   publicFormPath,
   rankTypedMatches,
   ratingMaxOf,
+  readObjectOrganizationAnswer,
   readTypedDate,
   readTypedDuration,
   readTypedNumber,
@@ -12712,6 +12779,7 @@ export {
   rememberedOpCount,
   removeAppRow,
   removedChoicesInUse,
+  resolveObjectOrganization,
   richTextPlain,
   rowFromDocument,
   ruleThatRefuses,
@@ -12776,6 +12844,7 @@ export {
   useTables,
   useTypedTable,
   valueConverts,
+  whereIdOpensPort,
   withCallersClock,
   withRowCounts,
   withTablePlacement,