@ai-matrx/records 0.57.0 → 0.57.1

package/dist/react/index.cjs

@@ -2243,6 +2243,7 @@ __export(react_exports, {
   VALUE_ALTERNATE_KEYS: () => VALUE_ALTERNATE_KEYS,
   VALUE_ENVELOPE_KEYS: () => VALUE_ENVELOPE_KEYS,
   actionRefusals: () => actionRefusals,
+  allowsOtherValues: () => allowsOtherValues,
   archivedByLine: () => archivedByLine,
   archivedWhen: () => archivedWhen,
   asPermissionLevel: () => asPermissionLevel,
@@ -2303,6 +2304,7 @@ __export(react_exports, {
   useMyLevels: () => useMyLevels,
   useOptionalRecordsClient: () => useOptionalRecordsClient,
   useRecord: () => useRecord,
+  useRecordChangeRevision: () => useRecordChangeRevision,
   useRecordMutation: () => useRecordMutation,
   useRecords: () => useRecords,
   useRecordsActor: () => useRecordsActor,
@@ -5032,6 +5034,22 @@ function staleWriteDetail(error) {
   };
 }
 
+// src/core/recordChanges.ts
+var listeners = /* @__PURE__ */ new Set();
+function announceRecordChanged(recordId) {
+  for (const listener of [...listeners]) {
+    try {
+      listener(recordId);
+    } catch (thrown) {
+      console.error("[@ai-matrx/records] a record-change listener threw", thrown);
+    }
+  }
+}
+function onRecordChanged(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+
 // src/core/query.ts
 var DEFAULT_PAGE_SIZE = 50;
 function planQuery(query) {
@@ -5073,12 +5091,22 @@ function intersectIds(sets) {
 
 // src/core/client.ts
 var DEFAULT_SCHEMA = "custom";
+var A_PERSONS_REFUSAL = /* @__PURE__ */ new Set([
+  "refused_by_rule",
+  "stale_write",
+  "invalid_argument",
+  "already_exists",
+  "missing_reference"
+]);
+function isAPersonsRefusal(code) {
+  return A_PERSONS_REFUSAL.has(code);
+}
 function sink(config) {
-  return config.onError ?? ((e) => (
-    // The defined degradation, stated: loud, with the store's own words, and
-    // naming where it happened. Never silence.
-    console.error(`[@ai-matrx/records] ${e.where}: ${e.code} \u2014 ${e.message}${e.hint ? ` (${e.hint})` : ""}`)
-  ));
+  return config.onError ?? ((e) => {
+    const line = `[@ai-matrx/records] ${e.where}: ${e.code} \u2014 ${e.message}${e.hint ? ` (${e.hint})` : ""}`;
+    if (isAPersonsRefusal(e.code)) console.info(line);
+    else console.error(line);
+  });
 }
 function createRecordsClient(config) {
   const schema = config.schema ?? DEFAULT_SCHEMA;
@@ -5185,21 +5213,26 @@ function createRecordsClient(config) {
         },
         "recordUpdate"
       );
+      if (result.ok) announceRecordChanged(record_id);
       return result;
     },
     async recordDelete({ record_id }) {
-      return callDoor(
+      const result = await callDoor(
         DOORS.recordDelete,
         { p_organization_id: org, p_record_id: record_id },
         "recordDelete"
       );
+      if (result.ok) announceRecordChanged(record_id);
+      return result;
     },
     async recordRestore({ record_id }) {
-      return callDoor(
+      const result = await callDoor(
         DOORS.recordRestore,
         { p_organization_id: org, p_record_id: record_id },
         "recordRestore"
       );
+      if (result.ok) announceRecordChanged(record_id);
+      return result;
     },
     async tableArchive({ table_id, chunk, includeTable }) {
       return callDoor(
@@ -5249,6 +5282,24 @@ function createRecordsClient(config) {
         })
       );
     },
+    async tableArchived({ table_id }) {
+      const kernel = await callDoor(DOORS.tableKernelId, {}, "tableArchived.kernel");
+      if (!kernel.ok) return err(kernel.error);
+      const PAGE = 200;
+      for (let page = 0; page < 25; page += 1) {
+        const answered = await this.listArchived({
+          table_id: kernel.data,
+          lane: "org",
+          limit: PAGE,
+          offset: page * PAGE
+        });
+        if (!answered.ok) return err(answered.error);
+        const hit = answered.data.rows.find((row) => row.id === table_id);
+        if (hit) return ok(hit);
+        if (answered.data.total !== null) return ok(null);
+      }
+      return ok(null);
+    },
     async listArchived({ table_id, lane = DEFAULT_ARCHIVE_LANE, limit = 50, offset = 0 }) {
       const door = await callDoor(
         DOORS.readRecordsArchived,
@@ -5450,9 +5501,11 @@ function createRecordsClient(config) {
       );
     },
     async fieldDeclare({ table_id, spec }) {
+      const { allow_other, ...rest } = spec;
+      const p_spec = allow_other === void 0 ? rest : { ...rest, config: { ...rest.config ?? {}, allow_other } };
       return callDoor(
         DOORS.fieldDeclare,
-        { p_organization_id: org, p_table_id: table_id, p_spec: spec },
+        { p_organization_id: org, p_table_id: table_id, p_spec },
         "fieldDeclare"
       );
     },
@@ -6420,14 +6473,16 @@ function createRecordsClient(config) {
       );
     },
     async restoreVersion({ record_id, version }) {
-      return callDoor(
+      const result = await callDoor(
         DOORS.restoreVersion,
         { p_organization_id: org, p_record_id: record_id, p_version: version },
         "restoreVersion"
       );
+      if (result.ok) announceRecordChanged(record_id);
+      return result;
     },
     async valueRestore({ record_id, field_key, version }) {
-      return callDoor(
+      const answered = await callDoor(
         DOORS.valueRestore,
         {
           p_organization_id: org,
@@ -6437,6 +6492,8 @@ function createRecordsClient(config) {
         },
         "valueRestore"
       );
+      if (answered.ok) announceRecordChanged(record_id);
+      return answered;
     },
     async commentThread({ record_id, include_resolved }) {
       return callDoor(
@@ -7363,13 +7420,24 @@ function useRecords(tableId, options = {}) {
   const liveReason = realtime ? tableId ? "Live: changes to this table re-read through the read door." : "Not live: no table selected." : "Not live: this host bound no realtime port, so this list updates when you reload it.";
   return { ...base, live, liveReason };
 }
+function useRecordChangeRevision(recordId) {
+  const [revision, setRevision] = (0, import_react2.useState)(0);
+  (0, import_react2.useEffect)(() => {
+    if (!recordId) return;
+    return onRecordChanged((changed) => {
+      if (changed === recordId) setRevision((n) => n + 1);
+    });
+  }, [recordId]);
+  return revision;
+}
 function useRecord(recordId, withComputed = false) {
+  const changed = useRecordChangeRevision(recordId);
   return useAsync(
     async (client) => {
       if (!recordId) return { ok: true, data: null };
       return client.recordRead({ record_id: recordId, withComputed });
     },
-    [recordId, withComputed]
+    [recordId, withComputed, changed]
   );
 }
 function useRecordMutation() {
@@ -7715,6 +7783,11 @@ var OVERRIDE_POLICIES = [
 var FRESHNESS = ["live", "cached", "snapshot"];
 var TABLE_DISPLAYS = ["list", "grid", "board", "calendar", "timeline"];
 
+// src/field.ts
+function allowsOtherValues(field) {
+  return field.type === "list" && field.config?.["allow_other"] === true;
+}
+
 // src/choice.ts
 var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function optionKey(option) {