@ai-matrx/records 0.99.32 → 0.99.33

package/dist/core/index.cjs

@@ -6079,6 +6079,99 @@ 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/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 = (refusal, where) => scream({ code: refusal.code, message: refusal.message, ...refusal.hint ? { hint: refusal.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 refusal = absent(door);
+      say(refusal, where);
+      return err(refusal);
+    }
+    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 refusal = !doorReady2 && (code === "PGRST202" || code === "42883") ? absent(door) : mapPgError(response.error, where);
+      if (opts?.quiet) console.info(`[@ai-matrx/records] ${where}: ${refusal.code} - ${refusal.message}`);
+      else say(refusal, where);
+      return err(refusal);
+    }
+    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_slot2 = require("@ai-matrx/kit/global-slot");
 var listeners = (0, import_global_slot2.globalSlot)("ai-matrx.records.record-change-listeners", () => /* @__PURE__ */ new Set());
@@ -6830,11 +6923,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/core/keysetCursor.ts
 function utf8ToBinary(text2) {
   let out = "";
@@ -6949,12 +7082,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
@@ -7725,29 +7853,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);
-  });
-}
 function withTableFacts(tables, facts, me) {
   if (!facts) return [...tables];
   const byId = new Map(facts.map((f) => [f.table_id, f]));
@@ -7775,7 +7880,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();
@@ -7917,56 +8022,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 refusal = doorAbsent(door);
-      scream({ code: refusal.code, message: refusal.message, ...refusal.hint ? { hint: refusal.hint } : {}, where });
-      return err(refusal);
-    }
-    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 refusal = mapPgError(response.error, where);
-      if (opts?.quiet) console.info(`[@ai-matrx/records] ${where}: ${refusal.code} - ${refusal.message}`);
-      else scream({ code: refusal.code, message: refusal.message, ...refusal.hint ? { hint: refusal.hint } : {}, where });
-      return err(refusal);
-    }
-    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);
@@ -8165,7 +8234,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,
@@ -8864,28 +8933,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,
@@ -11419,11 +11467,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(