@ai-matrx/records 0.99.32 → 0.99.33

package/dist/data/index.cjs

@@ -279,137 +279,6 @@ function isWritingDoor(door) {
   return /(_declare|_set(_|$)|_update|_write|_delete|_restore|_archive|_upsert|_reparent|_change|_duplicate|_move|_decide|_run$|_submit|_publish|_import_|_start$|_complete|_sign$|_add$|_retire|_propose|_promote|_land$|_pin$|_mute|_snooze|_unsnooze|_clear|_unclear|_revoke|_issue|_bind|_unbind|_apply|_backfill|_sync$|_decorate|_designate|_ensure|^migrate_|^set_table_|^home_add|^capture_|^claim_|^record_stage|^anon_|^io_import_|^io_comment_resolve|^enrich_(declare|land|pin)|^field_(declare|duplicate|propose|restore|retire|update)|^table_(declare|ensure|from_example|move|sync)|^value_restore|^relation_own)/.test(door);
 }
 
-// src/core/recordChanges.ts
-var import_global_slot = require("@ai-matrx/kit/global-slot");
-var listeners = (0, import_global_slot.globalSlot)("ai-matrx.records.record-change-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);
-    }
-  }
-}
-var removed = (0, import_global_slot.globalSlot)("ai-matrx.records.removed-records", () => /* @__PURE__ */ new Set());
-function markRecordRemoved(recordId) {
-  removed.add(recordId);
-}
-function markRecordRestored(recordId) {
-  removed.delete(recordId);
-}
-function onRecordChanged(listener) {
-  listeners.add(listener);
-  return () => listeners.delete(listener);
-}
-var tableListeners = (0, import_global_slot.globalSlot)("ai-matrx.records.table-structure-listeners", () => /* @__PURE__ */ new Set());
-function announceTableStructureChanged(tableId) {
-  for (const listener of [...tableListeners]) {
-    try {
-      listener(tableId);
-    } catch (thrown) {
-      console.error("[@ai-matrx/records] a table-structure listener threw", thrown);
-    }
-  }
-}
-
-// src/archive.ts
-var DEFAULT_ARCHIVE_LANE = "org";
-
-// src/aggregate.ts
-function isRuleFilter(filter) {
-  if (!filter || typeof filter !== "object" || Array.isArray(filter)) return false;
-  const node = filter;
-  return typeof node.op === "string" && Array.isArray(node.args);
-}
-function stableFilterKey(filter) {
-  if (!filter) return "{}";
-  if (isRuleFilter(filter)) return JSON.stringify(filter);
-  const keys = Object.keys(filter).sort();
-  if (keys.length === 0) return "{}";
-  const parts = keys.map((key) => {
-    const value = filter[key];
-    if (value !== null && typeof value === "object") {
-      const window = value;
-      return `${JSON.stringify(key)}:{"from":${JSON.stringify(window.from ?? null)},"to":${JSON.stringify(window.to ?? null)}}`;
-    }
-    return `${JSON.stringify(key)}:${JSON.stringify(value ?? null)}`;
-  });
-  return `{${parts.join(",")}}`;
-}
-function liftWithheld(rows) {
-  let shared;
-  for (const row of rows) {
-    const m = (row.measures ?? {})["_withheld"];
-    if (m !== void 0 && m !== null && typeof m === "object") {
-      shared = m;
-      break;
-    }
-  }
-  return rows.map((row) => {
-    const measures = row.measures ?? {};
-    const own = measures["_withheld"];
-    const marker = own !== void 0 && own !== null && typeof own === "object" ? own : shared;
-    const rowCount = row.row_count ?? 0;
-    if (marker === void 0 || marker === null || typeof marker !== "object") {
-      return rowCount === row.row_count ? row : { ...row, row_count: rowCount };
-    }
-    const { _withheld: _drop, ...rest } = measures;
-    const withheld = {};
-    for (const [name, raw] of Object.entries(marker)) {
-      const m = raw ?? {};
-      withheld[name] = {
-        reason: m.withheld?.reason ?? null,
-        needs: m.withheld?.needs ?? null,
-        or: m.withheld?.or ?? null,
-        ...m.says ? { says: m.says } : {},
-        ...m.label ? { label: m.label } : {},
-        ...m.field_key ? { field_key: m.field_key } : {}
-      };
-    }
-    return { ...row, measures: rest, withheld, row_count: rowCount };
-  });
-}
-
-// src/record.ts
-function isLockedStub(row) {
-  if (!row) return false;
-  if (row.level !== null && row.level !== void 0) return false;
-  const doc = row.document;
-  if (!doc || typeof doc !== "object") return false;
-  const keys = Object.keys(doc);
-  if (keys.length === 0 || keys.length > 3) return false;
-  const d = doc;
-  return d["exists"] === true && keys.every((k) => k === "id" || k === "exists" || k === "submitted_at");
-}
-function splitLockedRows(rows) {
-  const open = [];
-  let locked = 0;
-  for (const row of rows) {
-    if (isLockedStub(row)) locked += 1;
-    else open.push(row);
-  }
-  return { rows: open, locked };
-}
-
-// src/subscription.ts
-function callersTimeZone() {
-  try {
-    return Intl.DateTimeFormat().resolvedOptions().timeZone || null;
-  } catch {
-    return null;
-  }
-}
-function withCallersClock(spec, zone = callersTimeZone()) {
-  if (!zone || spec.quiet_hours?.tz) return spec;
-  return { ...spec, quiet_hours: { ...spec.quiet_hours ?? {}, tz: zone } };
-}
-
-// src/rowLabel.ts
-function clearsRowLabel(formula) {
-  return formula == null || formula.trim() === "";
-}
-
 // src/results.ts
 var ok = (data) => ({ ok: true, data });
 var err = (error) => ({ ok: false, error });
@@ -580,6 +449,230 @@ function mapPgError(error, where) {
   return mapped;
 }
 
+// src/core/doorCall.ts
+var DEFAULT_DOOR_SCHEMA = "custom";
+function canonicalArgs(value) {
+  return JSON.stringify(
+    value,
+    (_key, held) => held && typeof held === "object" && !Array.isArray(held) ? Object.fromEntries(Object.keys(held).sort().map((k) => [k, held[k]])) : held
+  );
+}
+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 recordsErrorSink(onError) {
+  return 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 doorAbsentRefusal(name, owedBy) {
+  return {
+    code: "door_absent",
+    message: `The record store has no door \`custom.${name}\` yet, so this call was not made. Nothing was read and nothing was written.`,
+    hint: owedBy ? `That door is ${owedBy}. Until it lands, this call refuses rather than guessing: an empty answer here would read like "there is nothing", which is a different sentence.` : `No lane in the build book claims this door. Either the name is wrong, or the door was removed from the store and this package has not been regenerated \u2014 run \`pnpm records:generate\`.`
+  };
+}
+function primedDoorAnswer(door, args) {
+  const look = LOOK_WRITES[door];
+  if (look) {
+    dropPrimedDoorAnswers(look);
+    return null;
+  }
+  if (isWritingDoor(door)) {
+    dropPrimedDoorAnswers();
+    return null;
+  }
+  return takePrimedDoorAnswer(`${door}|${canonicalArgs(args)}`);
+}
+function createDoorCall(options) {
+  const { dataSource, doorReady: doorReady2, held, wrote } = options;
+  const schema = options.schema ?? DEFAULT_DOOR_SCHEMA;
+  const scream = recordsErrorSink(options.onError);
+  const absent = options.absent ?? ((door) => doorAbsentRefusal(door));
+  const readsInFlight = /* @__PURE__ */ new Map();
+  const say = (refusal2, where) => scream({ code: refusal2.code, message: refusal2.message, ...refusal2.hint ? { hint: refusal2.hint } : {}, where });
+  return async function callDoor(door, args, where, opts) {
+    const primed = primedDoorAnswer(door, args);
+    if (primed) return ok(primed.data);
+    if (held) {
+      const bundled = await held(door, args);
+      if (bundled) return ok(bundled.data);
+    }
+    if (doorReady2 && !doorReady2(door)) {
+      const refusal2 = absent(door);
+      say(refusal2, where);
+      return err(refusal2);
+    }
+    const flightKey = isWritingDoor(door) ? null : `${door}|${canonicalArgs(args)}`;
+    const flying = flightKey ? readsInFlight.get(flightKey) : void 0;
+    const response = await (flying ?? (() => {
+      const call = Promise.resolve(dataSource.rpc(`${door}`, args, { schema }));
+      if (flightKey) {
+        readsInFlight.set(flightKey, call);
+        const forget = () => {
+          if (readsInFlight.get(flightKey) === call) readsInFlight.delete(flightKey);
+        };
+        call.then(forget, forget);
+      }
+      return call;
+    })());
+    if (response.error) {
+      const code = response.error.code;
+      const refusal2 = !doorReady2 && (code === "PGRST202" || code === "42883") ? absent(door) : mapPgError(response.error, where);
+      if (opts?.quiet) console.info(`[@ai-matrx/records] ${where}: ${refusal2.code} - ${refusal2.message}`);
+      else say(refusal2, where);
+      return err(refusal2);
+    }
+    if (isWritingDoor(door) || LOOK_WRITES[door]) {
+      const tableId = args["p_table_id"];
+      wrote?.(door, args);
+      forgetPrimedTablePageBundlesOf(typeof tableId === "string" ? tableId : null);
+      dropPrimedDoorAnswers(LOOK_WRITES[door]);
+    }
+    return ok(response.data);
+  };
+}
+
+// src/core/recordChanges.ts
+var import_global_slot = require("@ai-matrx/kit/global-slot");
+var listeners = (0, import_global_slot.globalSlot)("ai-matrx.records.record-change-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);
+    }
+  }
+}
+var removed = (0, import_global_slot.globalSlot)("ai-matrx.records.removed-records", () => /* @__PURE__ */ new Set());
+function markRecordRemoved(recordId) {
+  removed.add(recordId);
+}
+function markRecordRestored(recordId) {
+  removed.delete(recordId);
+}
+function onRecordChanged(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+var tableListeners = (0, import_global_slot.globalSlot)("ai-matrx.records.table-structure-listeners", () => /* @__PURE__ */ new Set());
+function announceTableStructureChanged(tableId) {
+  for (const listener of [...tableListeners]) {
+    try {
+      listener(tableId);
+    } catch (thrown) {
+      console.error("[@ai-matrx/records] a table-structure listener threw", thrown);
+    }
+  }
+}
+
+// src/archive.ts
+var DEFAULT_ARCHIVE_LANE = "org";
+
+// src/aggregate.ts
+function isRuleFilter(filter) {
+  if (!filter || typeof filter !== "object" || Array.isArray(filter)) return false;
+  const node = filter;
+  return typeof node.op === "string" && Array.isArray(node.args);
+}
+function stableFilterKey(filter) {
+  if (!filter) return "{}";
+  if (isRuleFilter(filter)) return JSON.stringify(filter);
+  const keys = Object.keys(filter).sort();
+  if (keys.length === 0) return "{}";
+  const parts = keys.map((key) => {
+    const value = filter[key];
+    if (value !== null && typeof value === "object") {
+      const window = value;
+      return `${JSON.stringify(key)}:{"from":${JSON.stringify(window.from ?? null)},"to":${JSON.stringify(window.to ?? null)}}`;
+    }
+    return `${JSON.stringify(key)}:${JSON.stringify(value ?? null)}`;
+  });
+  return `{${parts.join(",")}}`;
+}
+function liftWithheld(rows) {
+  let shared;
+  for (const row of rows) {
+    const m = (row.measures ?? {})["_withheld"];
+    if (m !== void 0 && m !== null && typeof m === "object") {
+      shared = m;
+      break;
+    }
+  }
+  return rows.map((row) => {
+    const measures = row.measures ?? {};
+    const own = measures["_withheld"];
+    const marker = own !== void 0 && own !== null && typeof own === "object" ? own : shared;
+    const rowCount = row.row_count ?? 0;
+    if (marker === void 0 || marker === null || typeof marker !== "object") {
+      return rowCount === row.row_count ? row : { ...row, row_count: rowCount };
+    }
+    const { _withheld: _drop, ...rest } = measures;
+    const withheld = {};
+    for (const [name, raw] of Object.entries(marker)) {
+      const m = raw ?? {};
+      withheld[name] = {
+        reason: m.withheld?.reason ?? null,
+        needs: m.withheld?.needs ?? null,
+        or: m.withheld?.or ?? null,
+        ...m.says ? { says: m.says } : {},
+        ...m.label ? { label: m.label } : {},
+        ...m.field_key ? { field_key: m.field_key } : {}
+      };
+    }
+    return { ...row, measures: rest, withheld, row_count: rowCount };
+  });
+}
+
+// src/record.ts
+function isLockedStub(row) {
+  if (!row) return false;
+  if (row.level !== null && row.level !== void 0) return false;
+  const doc = row.document;
+  if (!doc || typeof doc !== "object") return false;
+  const keys = Object.keys(doc);
+  if (keys.length === 0 || keys.length > 3) return false;
+  const d = doc;
+  return d["exists"] === true && keys.every((k) => k === "id" || k === "exists" || k === "submitted_at");
+}
+function splitLockedRows(rows) {
+  const open = [];
+  let locked = 0;
+  for (const row of rows) {
+    if (isLockedStub(row)) locked += 1;
+    else open.push(row);
+  }
+  return { rows: open, locked };
+}
+
+// src/subscription.ts
+function callersTimeZone() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || null;
+  } catch {
+    return null;
+  }
+}
+function withCallersClock(spec, zone = callersTimeZone()) {
+  if (!zone || spec.quiet_hours?.tz) return spec;
+  return { ...spec, quiet_hours: { ...spec.quiet_hours ?? {}, tz: zone } };
+}
+
+// src/rowLabel.ts
+function clearsRowLabel(formula) {
+  return formula == null || formula.trim() === "";
+}
+
 // src/relation.ts
 var import_uuid3 = require("@ai-matrx/kit/uuid");
 function isRefLike(value) {
@@ -1385,11 +1478,51 @@ function createScopeDoors(call) {
           source_type: String(envelope.data?.source_type ?? cell.source_type ?? "ai_enriched")
         }
       };
+    },
+    tableProvision({ organization_id, item_id, scope_id, home_id }) {
+      return call(
+        "scope_table_provision",
+        { p_organization_id: organization_id, p_item_id: item_id, p_scope_id: scope_id, p_home_id: home_id ?? null },
+        "scopeTableProvision"
+      );
     }
   };
   return doors;
 }
 
+// src/core/pickListDoors.ts
+var PICK_LIST_DOORS = {
+  pickListGet: "pick_list_get",
+  pickListForSelection: "pick_list_for_selection",
+  pickListUpdate: "pick_list_update"
+};
+function createPickListDoors(callDoor) {
+  return {
+    async pickListGet({ list_id }) {
+      return callDoor(PICK_LIST_DOORS.pickListGet, { p_list_id: list_id }, "pickListGet");
+    },
+    async pickListForSelection({ list_id }) {
+      return callDoor(
+        PICK_LIST_DOORS.pickListForSelection,
+        { p_list_id: list_id },
+        "pickListForSelection"
+      );
+    },
+    async pickListUpdate({ list_id, list_name, description, items }) {
+      return callDoor(
+        PICK_LIST_DOORS.pickListUpdate,
+        {
+          p_list_id: list_id,
+          p_list_name: list_name ?? null,
+          p_description: description ?? null,
+          p_items: items ? [...items] : null
+        },
+        "pickListUpdate"
+      );
+    }
+  };
+}
+
 // src/placement.ts
 function countOf(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : 0;
@@ -2709,12 +2842,7 @@ function doorReady(config, name) {
   return DOOR_NAMES.has(name) || Boolean(config?.knownDoors?.includes(name));
 }
 function doorAbsent(name) {
-  const owed = OWED_BY[name];
-  return {
-    code: "door_absent",
-    message: `The record store has no door \`custom.${name}\` yet, so this call was not made. Nothing was read and nothing was written.`,
-    hint: owed ? `That door is ${owed}. Until it lands, this call refuses rather than guessing: an empty answer here would read like "there is nothing", which is a different sentence.` : `No lane in the build book claims this door. Either the name is wrong, or the door was removed from the store and this package has not been regenerated \u2014 run \`pnpm records:generate\`.`
-  };
+  return doorAbsentRefusal(name, OWED_BY[name]);
 }
 var DOORS = {
   // THE READ DOOR (DOOR-1). Every read of a record's values goes through these
@@ -3494,29 +3622,6 @@ function intersectIds(sets) {
 
 // src/core/client.ts
 var DEFAULT_SCHEMA = "custom";
-function canonicalArgs(value) {
-  return JSON.stringify(
-    value,
-    (_key, held) => held && typeof held === "object" && !Array.isArray(held) ? Object.fromEntries(Object.keys(held).sort().map((k) => [k, held[k]])) : held
-  );
-}
-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) => {
-    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);
-  });
-}
 var TABLE_LIST_PAGE = 500;
 var TABLE_ARCHIVE_PASS = 20;
 var TABLE_RESTORE_PASS = 20;
@@ -3529,7 +3634,7 @@ function createRecordsClient(given) {
   const org = config.organizationId;
   const ledger = config.opLedger ?? defaultOpLedger;
   const mintOp = () => ledger.mint();
-  const scream = sink(config);
+  const scream = recordsErrorSink(config.onError);
   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"]);
   const bundleParts = /* @__PURE__ */ new Map();
@@ -3671,56 +3776,20 @@ function createRecordsClient(given) {
     bundleAsked.delete(tableId);
     for (const key of [...bundleParts.keys()]) if (key.includes(tableId)) bundleParts.delete(key);
   }
-  function primedFor(door, args) {
-    const look = LOOK_WRITES[door];
-    if (look) {
-      dropPrimedDoorAnswers(look);
-      return null;
-    }
-    if (isWritingDoor(door)) {
-      dropPrimedDoorAnswers();
-      return null;
-    }
-    return takePrimedDoorAnswer(`${door}|${canonicalArgs(args)}`);
-  }
-  const readsInFlight = /* @__PURE__ */ new Map();
-  async function callDoor(door, args, where, opts) {
-    const primed = primedFor(door, args);
-    if (primed) return ok(primed.data);
-    const bundled = await fromBundle(door, args);
-    if (bundled) return ok(bundled.data);
-    if (!doorReady(config, door)) {
-      const refusal2 = doorAbsent(door);
-      scream({ code: refusal2.code, message: refusal2.message, ...refusal2.hint ? { hint: refusal2.hint } : {}, where });
-      return err(refusal2);
-    }
-    const flightKey = isWritingDoor(door) ? null : `${door}|${canonicalArgs(args)}`;
-    const flying = flightKey ? readsInFlight.get(flightKey) : void 0;
-    const response = await (flying ?? (() => {
-      const call = Promise.resolve(config.dataSource.rpc(`${door}`, args, { schema }));
-      if (flightKey) {
-        readsInFlight.set(flightKey, call);
-        const forget = () => {
-          if (readsInFlight.get(flightKey) === call) readsInFlight.delete(flightKey);
-        };
-        call.then(forget, forget);
-      }
-      return call;
-    })());
-    if (response.error) {
-      const refusal2 = mapPgError(response.error, where);
-      if (opts?.quiet) console.info(`[@ai-matrx/records] ${where}: ${refusal2.code} - ${refusal2.message}`);
-      else scream({ code: refusal2.code, message: refusal2.message, ...refusal2.hint ? { hint: refusal2.hint } : {}, where });
-      return err(refusal2);
-    }
-    if (isWritingDoor(door) || LOOK_WRITES[door]) {
+  const primedFor = primedDoorAnswer;
+  const callDoor = createDoorCall({
+    dataSource: config.dataSource,
+    schema,
+    onError: scream,
+    doorReady: (door) => doorReady(config, door),
+    absent: doorAbsent,
+    held: fromBundle,
+    wrote: (_door, args) => {
       const tableId = args["p_table_id"];
       bundleDrop(typeof tableId === "string" ? tableId : null);
-      forgetPrimedTablePageBundlesOf(typeof tableId === "string" ? tableId : null);
-      dropPrimedDoorAnswers(LOOK_WRITES[door]);
     }
-    return ok(response.data);
-  }
+  });
+  const scopes = createScopeDoors(callDoor);
   function structureMoved(tableId, result) {
     if (result.ok) {
       bundleDrop(tableId);
@@ -3919,7 +3988,7 @@ function createRecordsClient(given) {
   const unavailableReason = (error) => `${error.message}${error.hint ? ` ${error.hint}` : ""}`;
   const client = {
     config,
-    scopes: createScopeDoors(callDoor),
+    scopes,
     async recordWrite({ table_id, data }) {
       const result = await callDoor(
         DOORS.recordWrite,
@@ -4618,28 +4687,7 @@ function createRecordsClient(given) {
         "fieldOptions"
       );
     },
-    async pickListGet({ list_id }) {
-      return callDoor(DOORS.pickListGet, { p_list_id: list_id }, "pickListGet");
-    },
-    async pickListForSelection({ list_id }) {
-      return callDoor(
-        DOORS.pickListForSelection,
-        { p_list_id: list_id },
-        "pickListForSelection"
-      );
-    },
-    async pickListUpdate({ list_id, list_name, description, items }) {
-      return callDoor(
-        DOORS.pickListUpdate,
-        {
-          p_list_id: list_id,
-          p_list_name: list_name ?? null,
-          p_description: description ?? null,
-          p_items: items ? [...items] : null
-        },
-        "pickListUpdate"
-      );
-    },
+    ...createPickListDoors(callDoor),
     async fieldChoiceUsage({ field_id }) {
       const result = await callDoor(
         DOORS.fieldChoiceUsage,
@@ -7173,11 +7221,7 @@ function createRecordsClient(given) {
       );
     },
     async scopeTableProvision({ home_id, item_id, scope_id }) {
-      return callDoor(
-        DOORS.scopeTableProvision,
-        { p_organization_id: org, p_item_id: item_id, p_scope_id: scope_id, p_home_id: home_id ?? null },
-        "scopeTableProvision"
-      );
+      return scopes.tableProvision({ organization_id: org, item_id, scope_id, home_id: home_id ?? null });
     },
     async tableRowCounts({ table_ids }) {
       return callDoor(