@ai-matrx/records 0.92.2 → 0.93.0

package/dist/react/index.cjs

@@ -110,6 +110,7 @@ __export(react_exports, {
   TO_CUSTOM_FIELDS: () => TO_CUSTOM_FIELDS,
   VALUE_ALTERNATE_KEYS: () => VALUE_ALTERNATE_KEYS,
   VALUE_ENVELOPE_KEYS: () => VALUE_ENVELOPE_KEYS,
+  WHERE_ID_OPENS_DOOR: () => WHERE_ID_OPENS_DOOR,
   actionRefusals: () => actionRefusals,
   addressFromText: () => addressFromText,
   addressMapUrl: () => addressMapUrl,
@@ -142,8 +143,10 @@ __export(react_exports, {
   confidentialRefusal: () => confidentialRefusal,
   confidentialRequest: () => confidentialRequest,
   confidentialState: () => confidentialState,
+  createOpLedger: () => createOpLedger,
   decideTypedChoice: () => decideTypedChoice,
   declareDrillDefinition: () => declareDrillDefinition,
+  defaultOpLedger: () => defaultOpLedger,
   defineTypedTable: () => defineTypedTable,
   drillAnswerOf: () => drillAnswerOf,
   drillFindingKnob: () => drillFindingKnob,
@@ -229,6 +232,7 @@ __export(react_exports, {
   publicFormPath: () => publicFormPath,
   rankTypedMatches: () => rankTypedMatches,
   ratingMaxOf: () => ratingMaxOf,
+  readObjectOrganizationAnswer: () => readObjectOrganizationAnswer,
   readTypedDate: () => readTypedDate,
   readTypedDuration: () => readTypedDuration,
   readTypedNumber: () => readTypedNumber,
@@ -246,6 +250,7 @@ __export(react_exports, {
   rememberedOpCount: () => rememberedOpCount,
   removeAppRow: () => removeAppRow,
   removedChoicesInUse: () => removedChoicesInUse,
+  resolveObjectOrganization: () => resolveObjectOrganization,
   richTextPlain: () => richTextPlain,
   rowFromDocument: () => rowFromDocument,
   ruleThatRefuses: () => ruleThatRefuses,
@@ -310,6 +315,7 @@ __export(react_exports, {
   useTables: () => useTables,
   useTypedTable: () => useTypedTable,
   valueConverts: () => valueConverts,
+  whereIdOpensPort: () => whereIdOpensPort,
   withCallersClock: () => withCallersClock,
   withRowCounts: () => withRowCounts,
   withTablePlacement: () => withTablePlacement,
@@ -819,40 +825,59 @@ 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 createOpLedger() {
+  return ledgerOver(/* @__PURE__ */ new Map());
+}
+var defaultOpLedger = ledgerOver((0, import_global_slot2.globalSlot)("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
@@ -4518,6 +4543,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"]);
@@ -4904,14 +4931,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,
         {
@@ -4924,7 +4951,7 @@ function createRecordsClient(given) {
       );
     },
     async recordChangeMany({ table_id, changes }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       const result = await callDoor(
         DOORS.recordChangeMany,
         {
@@ -4947,7 +4974,7 @@ function createRecordsClient(given) {
       return result;
     },
     async recordWriteGraph({ table_id, parent, children, edges }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       return callDoor(
         DOORS.recordWriteGraph,
         {
@@ -4971,7 +4998,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"
@@ -4985,7 +5012,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 }
         },
@@ -6010,7 +6037,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"
@@ -12413,6 +12440,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";