@ai-matrx/records 0.77.2 → 0.78.0

package/dist/{ports-CaYEF1dG.d.ts → ports-Ch4Ym0tj.d.ts}

@@ -1,4 +1,4 @@
-import { P as PgError, A as Actor, U as Uuid } from './record-B7iwye2k.js';
+import { P as PgError, A as Actor, U as Uuid } from './record-Ba1F1CNS.js';
 
 /**
  * The data seam: a structural subset of `SupabaseClient`. The package never
@@ -29,6 +29,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/{ports-PpvsH1cQ.d.cts → ports-Cjl-IjFa.d.cts}

@@ -1,4 +1,4 @@
-import { P as PgError, A as Actor, U as Uuid } from './record-B7iwye2k.cjs';
+import { P as PgError, A as Actor, U as Uuid } from './record-Ba1F1CNS.cjs';
 
 /**
  * The data seam: a structural subset of `SupabaseClient`. The package never
@@ -29,6 +29,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.cjs

@@ -1499,6 +1499,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" },
@@ -2079,6 +2080,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" },
@@ -4143,6 +4145,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(
@@ -4289,6 +4293,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",
@@ -4317,7 +4327,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 });
@@ -4332,7 +4418,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) {
@@ -10832,6 +10921,7 @@ function useStoreTable(table, options = {}) {
 }
 
 // src/app-table/graduate.ts
+var import_uuid5 = require("@ai-matrx/kit/uuid");
 var TO_CUSTOM_FIELDS = "custom_fields";
 var TO_ASSOCIATION = "association";
 var GRADUATION_BASE_COLUMNS = [
@@ -10891,10 +10981,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_uuid5.isUuidShape)(v));
 }
 function graduatedRow(fields, graduation, snapshot) {
   const row = {
@@ -11358,7 +11447,7 @@ function allowsOtherValues(field2) {
 }
 
 // src/retype.ts
-var import_uuid5 = require("@ai-matrx/kit/uuid");
+var import_uuid6 = require("@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) {
@@ -11379,7 +11468,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" && (0, import_uuid5.isUuidShape)(text2);
+      return typeof value === "string" && (0, import_uuid6.isUuidShape)(text2);
     default:
       return false;
   }
@@ -11830,6 +11919,9 @@ function scopeChip(scope) {
   return scope.title ? `About: ${scope.title}` : "About: this record";
 }
 
+// src/table-kind.ts
+var import_uuid7 = require("@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.",
@@ -11908,14 +12000,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) && (0, import_uuid7.isLowercaseUuidShape)(slug.slice(TABLE_KIND_PREFIX.length));
 }
 function tableKindSlug(tableId) {
   const slug = `${TABLE_KIND_PREFIX}${String(tableId).trim().toLowerCase()}`;