@ai-matrx/records 0.79.1 → 0.80.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog — @ai-matrx/records
 
+## 0.80.1
+### PAGE-BUNDLE-2 fix
+
+THE PRIMED BUNDLE IS SEEN BY EVERY ENTRY: the package's entries (`/core`, `/react`, `/data`, `/app-table`) each bundle their own copy of the client, so 0.80.0's module-level registry was four registries — a host priming through `/core` was never seen by the `RecordsProvider` (`/react`), and the bundle was asked again. The registry now lives on `globalThis` under `Symbol.for("@ai-matrx/records/primed-table-page-bundles")`.
+
+**Consumer action:** none.
+
+## 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

package/dist/app-table/index.cjs

@@ -416,6 +416,24 @@ 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 REGISTRY = /* @__PURE__ */ Symbol.for("@ai-matrx/records/primed-table-page-bundles");
+function registry() {
+  const g = globalThis;
+  return g[REGISTRY] ??= /* @__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 primed = registry();
+  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 +2775,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;