@ai-matrx/records 0.77.2 → 0.78.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog — @ai-matrx/records
 
+## 0.78.0
+
+PAGE-BUNDLE: a table page opens in one call. `custom.table_page_bundle` answers, in one round trip, the table row, fields, views, look, change actions, decorations, row actions, reverse columns, grid layout, the caller's level and recent imports. The client hands each part to the caller that asks that door with the same arguments (once, within 10 s), so every mapping, mask and refusal is unchanged; a refusing part, a missing door or a failed bundle is a miss and the door is asked itself.
+
+- `RecordsDataSource.opensInOneCall` (optional): set by `supabaseDataSource`; a source without it (tests, replays) never asks the bundle.
+- `store.generated.ts` regenerated from the live catalogue.
+
+**Consumer action:** none. Measured on production as admin: 12 parts identical to their doors; ~0.2-0.6 s for the bundle against ~1.5-2.2 s for the doors one after another (`pnpm perf:bundle` in matrx-frontend).
+
+## 0.77.3
+
+UUID checks in app-table graduation, landing outcomes and template validation use `@ai-matrx/kit/uuid` `isUuidShape`; table-kind slugs use `isLowercaseUuidShape` (the same lower-case contract the local regex had). Scripts' console lines format sizes, durations and cost through kit. Package-twins collapse.
+
+Consumer action: none.
+
 ## 0.77.2
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/app-table/index.cjs

@@ -56,6 +56,7 @@ __export(app_table_exports, {
 module.exports = __toCommonJS(app_table_exports);
 
 // src/app-table/graduate.ts
+var import_uuid = require("@ai-matrx/kit/uuid");
 var TO_CUSTOM_FIELDS = "custom_fields";
 var TO_ASSOCIATION = "association";
 var GRADUATION_BASE_COLUMNS = [
@@ -115,10 +116,9 @@ function graduationProblems(fields, graduation) {
   }
   return problems;
 }
-var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function idsOf(value) {
   const list = Array.isArray(value) ? value : value === null || value === void 0 ? [] : [value];
-  return list.filter((v) => typeof v === "string" && UUID.test(v));
+  return list.filter((v) => typeof v === "string" && (0, import_uuid.isUuidShape)(v));
 }
 function graduatedRow(fields, graduation, snapshot) {
   const row = {
@@ -649,7 +649,7 @@ function mapPgError(error, where) {
 }
 
 // src/relation.ts
-var import_uuid = require("@ai-matrx/kit/uuid");
+var import_uuid2 = require("@ai-matrx/kit/uuid");
 var REVERSE_LINKS_RECORDS_PER_CALL = 200;
 function sourceArchivedOf(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return null;
@@ -692,7 +692,7 @@ function mintOpId() {
 }
 
 // src/choice.ts
-var import_uuid2 = require("@ai-matrx/kit/uuid");
+var import_uuid3 = require("@ai-matrx/kit/uuid");
 var CHOICE_NUDGES = ["ask", "always_add", "never_add"];
 function asChoiceNudge(value) {
   return typeof value === "string" && CHOICE_NUDGES.includes(value) ? value : "ask";
@@ -1131,6 +1131,7 @@ var STORE_DOORS = [
   { name: "data_home", args: "p_organization_id uuid DEFAULT NULL::uuid, p_search text DEFAULT NULL::text, p_include_app_tables boolean DEFAULT false", returns: "jsonb", security: "definer" },
   { name: "data_home_changed_by", args: "p_asks jsonb", returns: "TABLE(organization_id uuid, id uuid, at timestamp with time zone, who text)", security: "definer" },
   { name: "data_home_items", args: "p_organization_id uuid DEFAULT NULL::uuid", returns: "TABLE(kind text, organization_id uuid, organization_name text, item_id uuid, table_id uuid, table_name text, item_row jsonb)", security: "definer" },
+  { name: "data_home_slim", args: "p_organization_id uuid DEFAULT NULL::uuid, p_search text DEFAULT NULL::text, p_include_app_tables boolean DEFAULT false", returns: "jsonb", security: "invoker" },
   { name: "data_home_tables", args: "p_organization_id uuid DEFAULT NULL::uuid", returns: "TABLE(table_id uuid, table_name text, organization_id uuid, organization_name text, member boolean, visibility text, updated_at timestamp with time zone, mine boolean, shared_with_me boolean, kept_by_the_app boolean, kind text, team boolean, system boolean, created_by uuid)", security: "definer" },
   { name: "data_home_tables", args: "p_organization_id uuid, p_include_app_tables boolean", returns: "TABLE(table_id uuid, table_name text, organization_id uuid, organization_name text, member boolean, visibility text, updated_at timestamp with time zone, mine boolean, shared_with_me boolean, kept_by_the_app boolean, kind text, team boolean, system boolean, created_by uuid)", security: "invoker" },
   { name: "declared_conversation", args: "", returns: "uuid", security: "invoker" },
@@ -1711,6 +1712,7 @@ var STORE_DOORS = [
   { name: "table_list_everywhere", args: "p_organization_id uuid DEFAULT NULL::uuid", returns: "jsonb", security: "definer" },
   { name: "table_list_everywhere", args: "p_organization_id uuid, p_include_app_tables boolean", returns: "jsonb", security: "invoker" },
   { name: "table_move", args: "p_table_id uuid, p_to_organization_id uuid, p_expected_version integer DEFAULT NULL::integer", returns: "jsonb", security: "definer" },
+  { name: "table_page_bundle", args: "p_organization_id uuid, p_table_id uuid, p_view_id uuid DEFAULT NULL::uuid", returns: "jsonb", security: "invoker" },
   { name: "table_placement", args: "p_organization_id uuid, p_table_id uuid, p_data jsonb, p_is_kernel boolean DEFAULT false", returns: "jsonb", security: "invoker" },
   { name: "table_record_ceiling", args: "", returns: "integer", security: "invoker" },
   { name: "table_record_ceiling", args: "p_organization_id uuid", returns: "integer", security: "invoker" },
@@ -2571,6 +2573,8 @@ function supabaseDataSource(client) {
   const supabase = client;
   const hasSchema = typeof supabase.schema === "function";
   const bound = {
+    // PAGE-BUNDLE: the real adapter opens a table page with one `custom.table_page_bundle` call.
+    opensInOneCall: true,
     rpc(fn, args, options) {
       if (!hasSchema) {
         return Promise.resolve(
@@ -2693,6 +2697,12 @@ 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",
@@ -2721,7 +2731,83 @@ function createRecordsClient(given) {
   const schema = config.schema ?? DEFAULT_SCHEMA;
   const org = config.organizationId;
   const scream = sink(config);
+  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();
+  const bundleFlights = /* @__PURE__ */ new Map();
+  const bundleAsked = /* @__PURE__ */ new Map();
+  let bundleKernel = null;
+  const bundleKey = (door, args) => `${door}|${canonicalArgs(args)}`;
+  function bundleTableOf(door, args) {
+    const t = args["p_table_id"];
+    if (door === "read_records_by_ids") {
+      const ids = args["p_record_ids"];
+      return typeof t === "string" && t === bundleKernel && Array.isArray(ids) && ids.length === 1 && typeof ids[0] === "string" ? ids[0] : null;
+    }
+    if (door === "my_levels") {
+      const ids = args["p_ids"];
+      return args["p_type"] === "record" && Array.isArray(ids) && ids.length === 1 && typeof ids[0] === "string" ? ids[0] : null;
+    }
+    return typeof t === "string" ? t : null;
+  }
+  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 answer = response.data;
+      if (response.error || !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;
+        if (part.door === "table_kernel_id" && typeof part.data === "string") bundleKernel = part.data;
+        bundleParts.set(bundleKey(part.door, part.args), { data: part.data, at: now });
+      }
+    } catch {
+    }
+  }
+  async function fromBundle(door, args) {
+    if (!config.dataSource.opensInOneCall || !doorReady(config, "table_page_bundle")) return null;
+    const tableId = bundleTableOf(door, args);
+    if (tableId) {
+      const asked = bundleAsked.get(tableId);
+      const fresh = asked !== void 0 && Date.now() - asked < BUNDLE_TTL_MS;
+      if (!fresh && BUNDLE_OPENERS.has(door)) {
+        bundleAsked.set(tableId, Date.now());
+        const flight2 = fillBundle(tableId, door === "grid_layout" ? args["p_view_id"] : null).finally(() => bundleFlights.delete(tableId));
+        bundleFlights.set(tableId, flight2);
+      }
+      const flight = bundleFlights.get(tableId);
+      if (flight) await flight;
+    } else if (door === "table_kernel_id") {
+      if (bundleKernel === null) {
+        await new Promise((resolve) => setTimeout(resolve, 0));
+        await Promise.all([...bundleFlights.values()]);
+      }
+      return bundleKernel === null ? null : { data: bundleKernel };
+    } else {
+      return null;
+    }
+    const key = bundleKey(door, args);
+    const held = bundleParts.get(key);
+    if (!held) return null;
+    bundleParts.delete(key);
+    return Date.now() - held.at < BUNDLE_TTL_MS ? { data: held.data } : null;
+  }
+  function bundleDrop(tableId) {
+    if (tableId === null) {
+      bundleParts.clear();
+      bundleAsked.clear();
+      return;
+    }
+    bundleAsked.delete(tableId);
+    for (const key of [...bundleParts.keys()]) if (key.includes(tableId)) bundleParts.delete(key);
+  }
   async function callDoor(door, args, where) {
+    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 });
@@ -2736,7 +2822,10 @@ function createRecordsClient(given) {
     return ok(response.data);
   }
   function structureMoved(tableId, result) {
-    if (result.ok) announceTableStructureChanged(tableId);
+    if (result.ok) {
+      bundleDrop(tableId);
+      announceTableStructureChanged(tableId);
+    }
     return result;
   }
   async function owedDoor(door, args, where) {