@ai-matrx/records 0.47.0 → 0.49.0

package/dist/react/index.cjs

@@ -94,6 +94,7 @@ __export(react_exports, {
   publicFormPath: () => publicFormPath,
   rememberedOpCount: () => rememberedOpCount,
   scopeChip: () => scopeChip,
+  stableFilterKey: () => stableFilterKey,
   tableShapeChanged: () => tableShapeChanged,
   useEntityFieldMutation: () => useEntityFieldMutation,
   useEntityFieldRights: () => useEntityFieldRights,
@@ -640,6 +641,7 @@ var STORE_DOORS = [
   { name: "read_record", args: "p_organization_id uuid, p_record_id uuid, p_by_id boolean DEFAULT false", returns: "jsonb", security: "definer" },
   { name: "read_records", args: "p_organization_id uuid, p_table_id uuid, p_by_id boolean DEFAULT false, p_limit integer DEFAULT 200, p_offset integer DEFAULT 0", returns: "TABLE(id uuid, document jsonb, level permission_level)", security: "definer" },
   { name: "read_records_by_ids", args: "p_organization_id uuid, p_table_id uuid, p_record_ids uuid[], p_by_id boolean DEFAULT false", returns: "TABLE(id uuid, document jsonb, level permission_level)", security: "definer" },
+  { name: "read_records_matching", args: "p_organization_id uuid, p_table_id uuid, p_filter jsonb DEFAULT '{}'::jsonb, p_by_id boolean DEFAULT false, p_limit integer DEFAULT 200, p_offset integer DEFAULT 0", returns: "TABLE(id uuid, document jsonb, level permission_level)", security: "definer" },
   { name: "realtime_topic_admits", args: "p_topic text", returns: "boolean", security: "definer" },
   { name: "record_aggregate", args: "p_organization_id uuid, p_table_id uuid, p_group_by jsonb DEFAULT '[]'::jsonb, p_measures jsonb DEFAULT '[]'::jsonb, p_bucket jsonb DEFAULT NULL::jsonb, p_filter jsonb DEFAULT '{}'::jsonb, p_limit integer DEFAULT 200, p_required text DEFAULT 'viewer'::text", returns: "TABLE(groups jsonb, measures jsonb, row_count bigint)", security: "definer" },
   { name: "record_applicability", args: "p_organization_id uuid, p_record_id uuid", returns: "TABLE(rule_id uuid, rule_name text, rule_version integer, applies boolean, answer jsonb)", security: "invoker" },
@@ -1969,6 +1971,15 @@ var DOORS = {
   // live Postgres function makes every existing call ambiguous — `is not unique`. Same
   // ladder, same level, same masking, same page ceiling.
   readRecordsByIds: "read_records_by_ids",
+  // THE SAME READ DOOR, ADDRESSED BY A QUESTION. `custom.read_records_matching`
+  // takes the store's one filter shape (`RecordFilter` — the object
+  // `platform.saved_view` carries as `filters` and `custom.record_aggregate`
+  // takes as `p_filter`) and narrows the page INSIDE its own query, in the same
+  // WHERE as Visibility. A separate NAME for the same reason as above. It is
+  // what makes a number on a dashboard walkable: the filter is evaluated by
+  // `custom.record_filter_sql`, the one body `custom.agg_sql` also calls, so the
+  // rows it opens are the rows the number counted.
+  readRecordsMatching: "read_records_matching",
   // DOOR-8, the two clocks. `p_recorded_at` is what the store SAID then;
   // `p_world_on` is what was TRUE of the world on that date, read out of dated
   // values. A client that answered either one itself would be guessing.
@@ -2660,12 +2671,13 @@ function createRecordsClient(config) {
         })
       );
     },
-    async list({ table_id, limit = 50, offset = 0 }) {
+    async list({ table_id, filter, limit = 50, offset = 0 }) {
       const door = await callDoor(
-        DOORS.readRecords,
+        DOORS.readRecordsMatching,
         {
           p_organization_id: org,
           p_table_id: table_id,
+          p_filter: filter ?? {},
           p_limit: limit,
           p_offset: offset
         },
@@ -4374,6 +4386,27 @@ function useRecordsActor() {
 
 // src/react/hooks.ts
 var import_react2 = require("react");
+
+// src/aggregate.ts
+function measureKey(measure) {
+  return measure.op === "count" ? "count" : `${measure.op}_${measure.key ?? ""}`;
+}
+function stableFilterKey(filter) {
+  if (!filter) return "{}";
+  const keys = Object.keys(filter).sort();
+  if (keys.length === 0) return "{}";
+  const parts = keys.map((key) => {
+    const value = filter[key];
+    if (value !== null && typeof value === "object") {
+      const window2 = value;
+      return `${JSON.stringify(key)}:{"from":${JSON.stringify(window2.from ?? null)},"to":${JSON.stringify(window2.to ?? null)}}`;
+    }
+    return `${JSON.stringify(key)}:${JSON.stringify(value ?? null)}`;
+  });
+  return `{${parts.join(",")}}`;
+}
+
+// src/react/hooks.ts
 function useAsync(run, deps) {
   const client = useRecordsClient();
   const [state, setState] = (0, import_react2.useState)(
@@ -4482,16 +4515,21 @@ function useRecords(tableId, options = {}) {
   const client = useRecordsClient();
   const pageSize = options.pageSize ?? 50;
   const page = options.page ?? 0;
+  const filterKey = stableFilterKey(options.filter);
   const base = useAsync(
     async (c) => {
       if (!tableId) return { ok: true, data: { rows: [], total: null } };
       return c.list({
         table_id: tableId,
+        ...filterKey === "{}" ? {} : { filter: options.filter },
         limit: pageSize,
         offset: page * pageSize
       });
     },
-    [tableId, pageSize, page]
+    // The QUESTION, not the object: a parent that rebuilds `{status: "Cancelled"}`
+    // on every render must not re-read the page on every render, and a parent
+    // that changes the question must re-read on the first one.
+    [tableId, pageSize, page, filterKey]
   );
   const realtime = client.config.realtime;
   const { reload, setData } = base;
@@ -5081,11 +5119,6 @@ function portalPath(slug) {
   return `/portal/c/${slug}`;
 }
 
-// src/aggregate.ts
-function measureKey(measure) {
-  return measure.op === "count" ? "count" : `${measure.op}_${measure.key ?? ""}`;
-}
-
 // src/capture-queue.ts
 var DB_NAME = "matrx-capture";
 var DB_VERSION = 1;