@ai-matrx/records 0.77.2 → 0.78.0

package/dist/react/index.d.cts

@@ -1504,6 +1504,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid DEFAULT NULL::uuid";
     readonly returns: "TABLE(kind text, organization_id uuid, organization_name text, item_id uuid, table_id uuid, table_name text, item_row jsonb)";
     readonly security: "definer";
+}, {
+    readonly name: "data_home_slim";
+    readonly args: "p_organization_id uuid DEFAULT NULL::uuid, p_search text DEFAULT NULL::text, p_include_app_tables boolean DEFAULT false";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "data_home_tables";
     readonly args: "p_organization_id uuid DEFAULT NULL::uuid";
@@ -4404,6 +4409,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_table_id uuid, p_to_organization_id uuid, p_expected_version integer DEFAULT NULL::integer";
     readonly returns: "jsonb";
     readonly security: "definer";
+}, {
+    readonly name: "table_page_bundle";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_view_id uuid DEFAULT NULL::uuid";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "table_placement";
     readonly args: "p_organization_id uuid, p_table_id uuid, p_data jsonb, p_is_kernel boolean DEFAULT false";
@@ -11199,6 +11209,12 @@ interface RecordsDataSource {
         data: unknown;
         error: PgError | null;
     }>;
+    /**
+     * OPTIONAL. True for the real supabase adapters: the client may open a table page with ONE
+     * `custom.table_page_bundle` call instead of a dozen shape doors one after another (PAGE-BUNDLE).
+     * Leave it off for a test or replay source that does not model the bundle door.
+     */
+    opensInOneCall?: boolean;
     /** Reads of `custom.*` go through the schema-qualified builder, never a bare `from`. */
     schema(name: string): {
         from(table: string): RecordsTableQuery;

package/dist/react/index.d.ts

@@ -1504,6 +1504,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid DEFAULT NULL::uuid";
     readonly returns: "TABLE(kind text, organization_id uuid, organization_name text, item_id uuid, table_id uuid, table_name text, item_row jsonb)";
     readonly security: "definer";
+}, {
+    readonly name: "data_home_slim";
+    readonly args: "p_organization_id uuid DEFAULT NULL::uuid, p_search text DEFAULT NULL::text, p_include_app_tables boolean DEFAULT false";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "data_home_tables";
     readonly args: "p_organization_id uuid DEFAULT NULL::uuid";
@@ -4404,6 +4409,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_table_id uuid, p_to_organization_id uuid, p_expected_version integer DEFAULT NULL::integer";
     readonly returns: "jsonb";
     readonly security: "definer";
+}, {
+    readonly name: "table_page_bundle";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_view_id uuid DEFAULT NULL::uuid";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
 }, {
     readonly name: "table_placement";
     readonly args: "p_organization_id uuid, p_table_id uuid, p_data jsonb, p_is_kernel boolean DEFAULT false";
@@ -11199,6 +11209,12 @@ interface RecordsDataSource {
         data: unknown;
         error: PgError | null;
     }>;
+    /**
+     * OPTIONAL. True for the real supabase adapters: the client may open a table page with ONE
+     * `custom.table_page_bundle` call instead of a dozen shape doors one after another (PAGE-BUNDLE).
+     * Leave it off for a test or replay source that does not model the bundle door.
+     */
+    opensInOneCall?: boolean;
     /** Reads of `custom.*` go through the schema-qualified builder, never a bare `from`. */
     schema(name: string): {
         from(table: string): RecordsTableQuery;

package/dist/react/index.js

@@ -1217,6 +1217,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" },
@@ -1797,6 +1798,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" },
@@ -3861,6 +3863,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(
@@ -4007,6 +4011,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",
@@ -4035,7 +4045,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 refusal3 = doorAbsent(door);
       scream({ code: refusal3.code, message: refusal3.message, ...refusal3.hint ? { hint: refusal3.hint } : {}, where });
@@ -4050,7 +4136,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) {
@@ -10557,6 +10646,7 @@ function useStoreTable(table, options = {}) {
 }
 
 // src/app-table/graduate.ts
+import { isUuidShape as isUuidShape5 } from "@ai-matrx/kit/uuid";
 var TO_CUSTOM_FIELDS = "custom_fields";
 var TO_ASSOCIATION = "association";
 var GRADUATION_BASE_COLUMNS = [
@@ -10616,10 +10706,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" && isUuidShape5(v));
 }
 function graduatedRow(fields, graduation, snapshot) {
   const row = {
@@ -11083,7 +11172,7 @@ function allowsOtherValues(field2) {
 }
 
 // src/retype.ts
-import { isUuidShape as isUuidShape5 } from "@ai-matrx/kit/uuid";
+import { isUuidShape as isUuidShape6 } from "@ai-matrx/kit/uuid";
 var TRUE_WORDS2 = /* @__PURE__ */ new Set(["true", "t", "yes", "y", "1", "on", "x", "\u2713", "\u2714"]);
 var FALSE_WORDS2 = /* @__PURE__ */ new Set(["false", "f", "no", "n", "0", "off", "\u2610"]);
 function valueConverts(to, value) {
@@ -11104,7 +11193,7 @@ function valueConverts(to, value) {
       return text2.trim() !== "" && /^[+-]?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/i.test(text2.trim());
     case "list":
     case "relation":
-      return typeof value === "string" && isUuidShape5(text2);
+      return typeof value === "string" && isUuidShape6(text2);
     default:
       return false;
   }
@@ -11555,6 +11644,9 @@ function scopeChip(scope) {
   return scope.title ? `About: ${scope.title}` : "About: this record";
 }
 
+// src/table-kind.ts
+import { isLowercaseUuidShape } from "@ai-matrx/kit/uuid";
+
 // src/table-kind-mapping.json
 var table_kind_mapping_default = {
   about: "THE ONE MAPPING from a store Field to a kind's three schemas (KINDS-GLUE wave 3 \xA72). Hand-written here; aidream copies it verbatim to packages/matrx-graph/matrx_graph/table_kind_mapping.json (scripts/generate_table_kind_mapping.py --check). Both languages derive from this file only: @ai-matrx/records src/table-kind.ts and matrx_graph.table_kinds. Keys of `kinds` are the store's field kinds (custom.field_kinds() plus the formula `system` kinds custom.field_kind_of answers). Stored mode only: `column_source_default` is custom.table_column_source's answer when the facts carry none (silence means the doctrine: Field rows are the columns); `platform_keys` mirrors custom.record_platform_keys() with each key's shape (parent_id: custom.containment_parent's uuid cast; icon: the record's own @ai-matrx/icons name, a string or null); `stored_patterns` mirror custom.validate_values' relation id regex and, for dates, refuse a string the timestamptz cast can never read (no digits, not a special word) while never refusing one it can.",
@@ -11633,14 +11725,13 @@ var table_kind_mapping_default = {
 
 // src/table-kind.ts
 var TABLE_KIND_PREFIX = "table:";
-var UUID2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
 var KIND_KEY = "__kind";
 var M = table_kind_mapping_default;
 function tableKindMapping() {
   return M;
 }
 function isTableKind(slug) {
-  return typeof slug === "string" && slug.startsWith(TABLE_KIND_PREFIX) && UUID2.test(slug.slice(TABLE_KIND_PREFIX.length));
+  return typeof slug === "string" && slug.startsWith(TABLE_KIND_PREFIX) && isLowercaseUuidShape(slug.slice(TABLE_KIND_PREFIX.length));
 }
 function tableKindSlug(tableId) {
   const slug = `${TABLE_KIND_PREFIX}${String(tableId).trim().toLowerCase()}`;