@ai-matrx/records-ui 0.109.6 → 0.110.0

package/dist/first-page.d.cts

@@ -303,6 +303,16 @@ declare function firstGridPageRequest(client: Pick<RecordsClient, "tableRead" |
  * decides exactly as it does from the browser. Never throws; a door that refuses is simply not in
  * the seed, and the page asks it for itself.
  */
+/**
+ * THE PERSON'S SERVER-ROWS KNOBS, FROM THE TABLE'S BUNDLE (lane SSR-ROWS-2): `custom.table_page_bundle`
+ * carries a `server_rows` part — `data.server_rows` and `data.server_rows_budget_ms` resolved for the
+ * person asking in that organization. Null when the seed holds no such answer (an older store, a
+ * refused part): the host treats that as off.
+ */
+declare function serverRowsOf(seed: RecordsSeed | null | undefined): {
+    on: boolean;
+    budgetMs: number | null;
+} | null;
 declare function askTablePageSeed(input: {
     dataSource: unknown;
     organizationId: Uuid;
@@ -310,11 +320,16 @@ declare function askTablePageSeed(input: {
     actor: RecordsConfig["actor"];
     /** A record page: its record's bundle (`custom.record_page_bundle`) is asked beside the table's. */
     recordId?: Uuid | null;
-    /** Ask the grid's first page (default true). Off when the address opens something else. */
-    rows?: boolean;
+    /**
+     * Ask the grid's first page (default true). Off when the address opens something else. A function
+     * decides once the table's shape (its bundle) has been answered — it is handed everything asked so
+     * far, so a host can read the person's `server_rows` knob from the bundle (`serverRowsOf`) and ask
+     * the rows only when it is on, at no extra read.
+     */
+    rows?: boolean | ((asked: RecordsSeed) => boolean);
     /** The table is drawn EMBEDDED (`TablePage presentation="embedded"`, a Space's inline table): its page size. */
     embedded?: boolean;
     pageSize?: number;
 }): Promise<RecordsSeed>;
 
-export { EMBEDDED_PAGE_SIZE, type FirstGridPageArgs, TABLE_PAGE_SIZE, askTablePageSeed, firstGridPageArgs, firstGridPageRequest };
+export { EMBEDDED_PAGE_SIZE, type FirstGridPageArgs, TABLE_PAGE_SIZE, askTablePageSeed, firstGridPageArgs, firstGridPageRequest, serverRowsOf };

package/dist/first-page.d.ts

@@ -303,6 +303,16 @@ declare function firstGridPageRequest(client: Pick<RecordsClient, "tableRead" |
  * decides exactly as it does from the browser. Never throws; a door that refuses is simply not in
  * the seed, and the page asks it for itself.
  */
+/**
+ * THE PERSON'S SERVER-ROWS KNOBS, FROM THE TABLE'S BUNDLE (lane SSR-ROWS-2): `custom.table_page_bundle`
+ * carries a `server_rows` part — `data.server_rows` and `data.server_rows_budget_ms` resolved for the
+ * person asking in that organization. Null when the seed holds no such answer (an older store, a
+ * refused part): the host treats that as off.
+ */
+declare function serverRowsOf(seed: RecordsSeed | null | undefined): {
+    on: boolean;
+    budgetMs: number | null;
+} | null;
 declare function askTablePageSeed(input: {
     dataSource: unknown;
     organizationId: Uuid;
@@ -310,11 +320,16 @@ declare function askTablePageSeed(input: {
     actor: RecordsConfig["actor"];
     /** A record page: its record's bundle (`custom.record_page_bundle`) is asked beside the table's. */
     recordId?: Uuid | null;
-    /** Ask the grid's first page (default true). Off when the address opens something else. */
-    rows?: boolean;
+    /**
+     * Ask the grid's first page (default true). Off when the address opens something else. A function
+     * decides once the table's shape (its bundle) has been answered — it is handed everything asked so
+     * far, so a host can read the person's `server_rows` knob from the bundle (`serverRowsOf`) and ask
+     * the rows only when it is on, at no extra read.
+     */
+    rows?: boolean | ((asked: RecordsSeed) => boolean);
     /** The table is drawn EMBEDDED (`TablePage presentation="embedded"`, a Space's inline table): its page size. */
     embedded?: boolean;
     pageSize?: number;
 }): Promise<RecordsSeed>;
 
-export { EMBEDDED_PAGE_SIZE, type FirstGridPageArgs, TABLE_PAGE_SIZE, askTablePageSeed, firstGridPageArgs, firstGridPageRequest };
+export { EMBEDDED_PAGE_SIZE, type FirstGridPageArgs, TABLE_PAGE_SIZE, askTablePageSeed, firstGridPageArgs, firstGridPageRequest, serverRowsOf };

package/dist/first-page.js

@@ -392,6 +392,12 @@ async function firstGridPageRequest(client, tableId, options = {}) {
   const shown = view ? applyLook(view, looks.data[view.id]) : null;
   return firstGridPageArgs({ tableId, table: table.data, fields: fields.data, shown, ...options.pageSize ? { pageSize: options.pageSize } : {} });
 }
+function serverRowsOf(seed) {
+  const found = seed?.answers.find((a) => a.door === "server_rows");
+  const data = found?.data;
+  if (!data || typeof data !== "object") return null;
+  return { on: data.on === true, budgetMs: typeof data.budget_ms === "number" && data.budget_ms > 0 ? data.budget_ms : null };
+}
 async function askTablePageSeed(input) {
   const recording = recordingDataSource(asRecordsDataSource(input.dataSource));
   const client = createRecordsClient({
@@ -407,7 +413,8 @@ async function askTablePageSeed(input) {
   try {
     const pageSize = input.pageSize ?? (input.embedded ? EMBEDDED_PAGE_SIZE : TABLE_PAGE_SIZE);
     const args = await firstGridPageRequest(client, input.tableId, { pageSize });
-    if (args && input.rows !== false) {
+    const wantRows = typeof input.rows === "function" ? input.rows(recording.seed()) : input.rows !== false;
+    if (args && wantRows) {
       await client.listPage({
         table_id: args.p_table_id,
         filter: args.p_filter,
@@ -424,6 +431,6 @@ async function askTablePageSeed(input) {
   return recording.seed();
 }
 
-export { EMBEDDED_PAGE_SIZE, TABLE_PAGE_SIZE, askTablePageSeed, firstGridPageArgs, firstGridPageRequest };
+export { EMBEDDED_PAGE_SIZE, TABLE_PAGE_SIZE, askTablePageSeed, firstGridPageArgs, firstGridPageRequest, serverRowsOf };
 //# sourceMappingURL=first-page.js.map
 //# sourceMappingURL=first-page.js.map