@ai-matrx/records 0.99.31 → 0.99.33

package/dist/react/index.js

@@ -73,184 +73,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
-import { globalSlot } from "@ai-matrx/kit/global-slot";
-var listeners = 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 = globalSlot("ai-matrx.records.removed-records", () => /* @__PURE__ */ new Set());
-function markRecordRemoved(recordId) {
-  removed.add(recordId);
-}
-function markRecordRestored(recordId) {
-  removed.delete(recordId);
-}
-function isRecordRemoved(recordId) {
-  return removed.has(recordId);
-}
-function onRecordChanged(listener) {
-  listeners.add(listener);
-  return () => listeners.delete(listener);
-}
-var tableListeners = 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 ARCHIVE_LANES = ["mine", "org"];
-var DEFAULT_ARCHIVE_LANE = "org";
-var ARCHIVE_LANE_LABEL = {
-  mine: "Archived by me",
-  org: "Archived by anyone"
-};
-var ARCHIVE_LANE_MEANS = {
-  mine: "The records you archived yourself.",
-  org: "Everything anybody in this organization archived, including you."
-};
-function isArchiveLane(word) {
-  return typeof word === "string" && ARCHIVE_LANES.includes(word);
-}
-function archivedWhen(at, locale = "en-GB") {
-  const when = new Date(at);
-  if (Number.isNaN(when.getTime())) return "a moment nobody recorded";
-  return new Intl.DateTimeFormat(locale, {
-    day: "numeric",
-    month: "long",
-    year: "numeric",
-    hour: "2-digit",
-    minute: "2-digit"
-  }).format(when);
-}
-function archivedByLine(row, locale = "en-GB") {
-  const when = archivedWhen(row.archivedAt, locale);
-  const who = (row.archivedByName ?? "").trim();
-  if (who === "") {
-    return `Archived on ${when}. The store does not know who archived it \u2014 whoever did is no longer in this organization, or it happened before this table kept that.`;
-  }
-  return `Archived by ${who} on ${when}.`;
-}
-function emptyArchiveLine(lane) {
-  return lane === "mine" ? "You have not archived anything in this table. Switch to \u201CArchived by anyone\u201D to see what the rest of the organization has." : "Nothing in this table has been archived. Records you remove from the grid arrive here, and nothing is ever destroyed.";
-}
-function sameDocument(a, b) {
-  return JSON.stringify(a) === JSON.stringify(b);
-}
-
-// 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 measureKey(measure) {
-  return measure.op === "count" ? "count" : `${measure.op}_${measure.key ?? ""}`;
-}
-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 window2 = value;
-      return `${JSON.stringify(key)}:{"from":${JSON.stringify(window2.from ?? null)},"to":${JSON.stringify(window2.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 hasQuietHours(quiet2) {
-  return Boolean(quiet2?.start && quiet2?.end);
-}
-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
-var ROW_LABEL_FORMULA_MAX_LENGTH = 2e3;
-function clearsRowLabel(formula) {
-  return formula == null || formula.trim() === "";
-}
-
 // src/results.ts
 function isRecordsErr(result) {
   return result.ok === false;
@@ -396,48 +218,319 @@ function parseDetail(details) {
     return details;
   }
 }
-function isNotASqlstate(code) {
-  if (!code) return true;
-  return /^[0-9]{3}$/.test(code);
+function isNotASqlstate(code) {
+  if (!code) return true;
+  return /^[0-9]{3}$/.test(code);
+}
+function mapPgError(error, where) {
+  const raw = error.code ?? void 0;
+  const sqlstate = raw && raw !== "" ? raw : void 0;
+  const mapped = {
+    code: "internal",
+    message: error.message,
+    ...error.hint ? { hint: error.hint } : {},
+    ...sqlstate ? { sqlstate } : {}
+  };
+  if (isNotASqlstate(sqlstate)) {
+    mapped.code = "unreachable";
+  } else {
+    mapped.code = BY_SQLSTATE[sqlstate] ?? "internal";
+  }
+  const detail = parseDetail(error.details);
+  if (detail !== void 0) mapped.detail = detail;
+  if (mapped.code === "internal") {
+    mapped.unmapped = true;
+    mapped.diagnostic = `@ai-matrx/records did not recognise SQLSTATE ${sqlstate ?? "(none)"} from ${where}; the store's own message is the thing to act on.`;
+  } else if (mapped.code === "unreachable") {
+    mapped.unmapped = true;
+    mapped.diagnostic = `@ai-matrx/records never reached the store from ${where}: ${raw ? `the transport answered ${raw}` : "no response"} \u2014 ${error.message}`;
+    mapped.message = "We could not reach your data.";
+    delete mapped.hint;
+  }
+  return mapped;
+}
+function staleWriteDetail(error) {
+  if (error.code !== "stale_write") return null;
+  const detail = error.detail;
+  if (!detail || typeof detail.expected_version !== "number" || typeof detail.current_version !== "number") {
+    return null;
+  }
+  return {
+    expected_version: detail.expected_version,
+    current_version: detail.current_version,
+    contested_fields: detail.contested_fields ?? {}
+  };
+}
+
+// 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 = (refusal3, where) => scream({ code: refusal3.code, message: refusal3.message, ...refusal3.hint ? { hint: refusal3.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 refusal3 = absent(door);
+      say(refusal3, where);
+      return err(refusal3);
+    }
+    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 refusal3 = !doorReady2 && (code === "PGRST202" || code === "42883") ? absent(door) : mapPgError(response.error, where);
+      if (opts?.quiet) console.info(`[@ai-matrx/records] ${where}: ${refusal3.code} - ${refusal3.message}`);
+      else say(refusal3, where);
+      return err(refusal3);
+    }
+    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
+import { globalSlot } from "@ai-matrx/kit/global-slot";
+var listeners = 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 = globalSlot("ai-matrx.records.removed-records", () => /* @__PURE__ */ new Set());
+function markRecordRemoved(recordId) {
+  removed.add(recordId);
+}
+function markRecordRestored(recordId) {
+  removed.delete(recordId);
+}
+function isRecordRemoved(recordId) {
+  return removed.has(recordId);
+}
+function onRecordChanged(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+var tableListeners = 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 ARCHIVE_LANES = ["mine", "org"];
+var DEFAULT_ARCHIVE_LANE = "org";
+var ARCHIVE_LANE_LABEL = {
+  mine: "Archived by me",
+  org: "Archived by anyone"
+};
+var ARCHIVE_LANE_MEANS = {
+  mine: "The records you archived yourself.",
+  org: "Everything anybody in this organization archived, including you."
+};
+function isArchiveLane(word) {
+  return typeof word === "string" && ARCHIVE_LANES.includes(word);
+}
+function archivedWhen(at, locale = "en-GB") {
+  const when = new Date(at);
+  if (Number.isNaN(when.getTime())) return "a moment nobody recorded";
+  return new Intl.DateTimeFormat(locale, {
+    day: "numeric",
+    month: "long",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  }).format(when);
+}
+function archivedByLine(row, locale = "en-GB") {
+  const when = archivedWhen(row.archivedAt, locale);
+  const who = (row.archivedByName ?? "").trim();
+  if (who === "") {
+    return `Archived on ${when}. The store does not know who archived it \u2014 whoever did is no longer in this organization, or it happened before this table kept that.`;
+  }
+  return `Archived by ${who} on ${when}.`;
+}
+function emptyArchiveLine(lane) {
+  return lane === "mine" ? "You have not archived anything in this table. Switch to \u201CArchived by anyone\u201D to see what the rest of the organization has." : "Nothing in this table has been archived. Records you remove from the grid arrive here, and nothing is ever destroyed.";
 }
-function mapPgError(error, where) {
-  const raw = error.code ?? void 0;
-  const sqlstate = raw && raw !== "" ? raw : void 0;
-  const mapped = {
-    code: "internal",
-    message: error.message,
-    ...error.hint ? { hint: error.hint } : {},
-    ...sqlstate ? { sqlstate } : {}
-  };
-  if (isNotASqlstate(sqlstate)) {
-    mapped.code = "unreachable";
-  } else {
-    mapped.code = BY_SQLSTATE[sqlstate] ?? "internal";
+function sameDocument(a, b) {
+  return JSON.stringify(a) === JSON.stringify(b);
+}
+
+// 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 measureKey(measure) {
+  return measure.op === "count" ? "count" : `${measure.op}_${measure.key ?? ""}`;
+}
+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 window2 = value;
+      return `${JSON.stringify(key)}:{"from":${JSON.stringify(window2.from ?? null)},"to":${JSON.stringify(window2.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;
+    }
   }
-  const detail = parseDetail(error.details);
-  if (detail !== void 0) mapped.detail = detail;
-  if (mapped.code === "internal") {
-    mapped.unmapped = true;
-    mapped.diagnostic = `@ai-matrx/records did not recognise SQLSTATE ${sqlstate ?? "(none)"} from ${where}; the store's own message is the thing to act on.`;
-  } else if (mapped.code === "unreachable") {
-    mapped.unmapped = true;
-    mapped.diagnostic = `@ai-matrx/records never reached the store from ${where}: ${raw ? `the transport answered ${raw}` : "no response"} \u2014 ${error.message}`;
-    mapped.message = "We could not reach your data.";
-    delete mapped.hint;
+  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 mapped;
+  return { rows: open, locked };
 }
-function staleWriteDetail(error) {
-  if (error.code !== "stale_write") return null;
-  const detail = error.detail;
-  if (!detail || typeof detail.expected_version !== "number" || typeof detail.current_version !== "number") {
+
+// src/subscription.ts
+function hasQuietHours(quiet2) {
+  return Boolean(quiet2?.start && quiet2?.end);
+}
+function callersTimeZone() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || null;
+  } catch {
     return null;
   }
-  return {
-    expected_version: detail.expected_version,
-    current_version: detail.current_version,
-    contested_fields: detail.contested_fields ?? {}
-  };
+}
+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
+var ROW_LABEL_FORMULA_MAX_LENGTH = 2e3;
+function clearsRowLabel(formula) {
+  return formula == null || formula.trim() === "";
 }
 
 // src/relation.ts
@@ -1288,11 +1381,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/choice.ts
 import { isUuidShape as isUuidShape3 } from "@ai-matrx/kit/uuid";
 function optionKey(option) {
@@ -4495,12 +4628,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
@@ -5300,29 +5428,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;
@@ -5335,7 +5440,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();
@@ -5477,56 +5582,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 refusal3 = doorAbsent(door);
-      scream({ code: refusal3.code, message: refusal3.message, ...refusal3.hint ? { hint: refusal3.hint } : {}, where });
-      return err(refusal3);
-    }
-    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 refusal3 = mapPgError(response.error, where);
-      if (opts?.quiet) console.info(`[@ai-matrx/records] ${where}: ${refusal3.code} - ${refusal3.message}`);
-      else scream({ code: refusal3.code, message: refusal3.message, ...refusal3.hint ? { hint: refusal3.hint } : {}, where });
-      return err(refusal3);
-    }
-    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);
@@ -5725,7 +5794,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,
@@ -6424,28 +6493,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,
@@ -8979,11 +9027,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(