@ai-matrx/records 0.79.0 → 0.80.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog — @ai-matrx/records
 
+## 0.80.0
+### PAGE-BUNDLE-2
+
+A TABLE PAGE'S BUNDLE CAN BE ASKED BEFORE THE PAGE BOOTS: `primeTablePageBundle({ organizationId, tableId, viewId?, answer })` (from `@ai-matrx/records/core`) hands the records client a `custom.table_page_bundle` answer asked elsewhere — the server render, as the same person. The next client opening that Table in that organization uses it instead of asking, once, within 15 s. A primed failure or non-bundle answer is ignored and the bundle is asked as before; part-by-part matching is unchanged.
+
+**Consumer action:** none (additive).
+
+## 0.79.1
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records/v0.79.0..npm/records/v0.79.1 -- apps/shared/records`).
+No source changes intended and no consumer action required.
+
 ## 0.79.0
 
 DUPLICATE PROPERTY (Notion N5): `client.fieldDuplicate({ field_id })` calls the new door `custom.field_duplicate` — the copy is declared right after the original ("<name> (1)", same kind, choices with their colours and keys, unit, link, formula, rules, sensitivity) and every record's value is copied into it in one statement. Answers `FieldDuplicated` (`field_id`, `key`, `label`, `values_copied`, `values`). A link column copies its definition only; formula / lookup / roll-up columns work themselves out. Needs the table's add-a-column rung, as `fieldDeclare`.

package/dist/app-table/index.cjs

@@ -416,6 +416,19 @@ function sha256Hex(text2) {
   return Array.from(h, (x) => x.toString(16).padStart(8, "0")).join("");
 }
 
+// src/core/primedBundle.ts
+var PRIMED_TTL_MS = 15e3;
+var primed = /* @__PURE__ */ new Map();
+var primedKey = (organizationId, tableId, viewId) => `${organizationId}|${tableId}|${viewId ?? ""}`;
+function takePrimedTablePageBundle(organizationId, tableId, viewId) {
+  if (!organizationId) return null;
+  const key = primedKey(organizationId, tableId, viewId);
+  const held = primed.get(key);
+  if (!held) return null;
+  primed.delete(key);
+  return Date.now() - held.at < PRIMED_TTL_MS ? held.answer : null;
+}
+
 // src/archive.ts
 var DEFAULT_ARCHIVE_LANE = "org";
 
@@ -2757,13 +2770,20 @@ function createRecordsClient(given) {
   }
   async function fillBundle(tableId, viewId) {
     try {
-      const response = await config.dataSource.rpc(
-        "table_page_bundle",
-        { p_organization_id: org, p_table_id: tableId, p_view_id: typeof viewId === "string" ? viewId : null },
-        { schema }
-      );
+      const view = typeof viewId === "string" ? viewId : null;
+      const usable = (r) => r !== null && !r.error && r.data !== null && typeof r.data === "object" && Array.isArray(r.data.parts);
+      const primedAnswer = takePrimedTablePageBundle(org, tableId, view);
+      let response = primedAnswer ? await primedAnswer : null;
+      if (!usable(response)) {
+        response = await config.dataSource.rpc(
+          "table_page_bundle",
+          { p_organization_id: org, p_table_id: tableId, p_view_id: view },
+          { schema }
+        );
+      }
+      if (!usable(response)) return;
       const answer = response.data;
-      if (response.error || !answer || !Array.isArray(answer.parts)) return;
+      if (!answer || !Array.isArray(answer.parts)) return;
       const now = Date.now();
       for (const part of answer.parts) {
         if (part.error !== void 0 || part.data === void 0) continue;