@ai-matrx/records 0.79.1 → 0.80.0

package/dist/core/index.d.cts

@@ -468,6 +468,27 @@ declare function outcomeForBlock(outcomes: LandingOutcomes, block: LandingBlock)
 /** True when any landing of `kind` for this block is in the record store. */
 declare function blockLandedInStore(outcomes: LandingOutcomes, block: LandingBlock): boolean;
 
+/** What a data source's `rpc` answers for `custom.table_page_bundle` (PostgREST's `{ data, error }`). */
+interface PrimedBundleAnswer {
+    data: unknown;
+    error: unknown;
+}
+/**
+ * Hand the records client a table page's bundle that was asked elsewhere (the server render, as the
+ * same person). The next records client that opens this Table in this organization uses it instead of
+ * asking — once, within PRIMED_TTL_MS.
+ */
+declare function primeTablePageBundle(input: {
+    organizationId: string;
+    tableId: string;
+    viewId?: string | null;
+    answer: Promise<PrimedBundleAnswer> | PrimedBundleAnswer;
+}): void;
+/** The primed answer for this page, once — or null (none, or stale). */
+declare function takePrimedTablePageBundle(organizationId: string | null | undefined, tableId: string, viewId: string | null | undefined): Promise<PrimedBundleAnswer> | null;
+/** Tests only: forget every primed answer. */
+declare function forgetPrimedTablePageBundles(): void;
+
 /**
  * The structural shape of the supabase client this adapter needs. Deliberately
  * NOT `SupabaseClient<Database>`: a generated `Database` type makes
@@ -648,4 +669,4 @@ type ReadFileText = (fileId: Uuid) => Promise<string>;
  */
 declare function withWholeValues(rows: ExportRow[], read?: ReadFileText | null): Promise<ExportRow[]>;
 
-export { type BlockOutcome, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_VALUE_MAX_BYTES, DOORS, type DoorKey, type ExportRow, Field, LANDING_SOURCE_TYPE, LANDING_TARGET_TYPES, type Landing, type LandingBlock, type LandingOutcomes, type LandingState, type LandingStore, MAPPED_SQLSTATES, type MirrorLimits, OUTPUT_KEPT_KEY, PRODUCED_BY_LABEL, type ParsedImport, PgError, PredictedRefusal, type ReadFileText, ReadValue, RecordDocument, RecordsDataSource, RecordsError, RecordsResult, StaleWriteDetail, type SupabaseLike, TableKindFacts, Uuid, WHOLE_VALUE_SOURCE_KIND, type WholeValuePointer, announceRecordChanged, announceTableStructureChanged, asRecordsDataSource, blockLandedInStore, cellText, doorAbsent, doorCensus, doorExists, doorReady, exportCellText, exportCsv, exportXlsx, importCsv, importXlsx, landingOutcomesFor, mapPgError, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, tableKindFacts, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };
+export { type BlockOutcome, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_VALUE_MAX_BYTES, DOORS, type DoorKey, type ExportRow, Field, LANDING_SOURCE_TYPE, LANDING_TARGET_TYPES, type Landing, type LandingBlock, type LandingOutcomes, type LandingState, type LandingStore, MAPPED_SQLSTATES, type MirrorLimits, OUTPUT_KEPT_KEY, PRODUCED_BY_LABEL, type ParsedImport, PgError, PredictedRefusal, type PrimedBundleAnswer, type ReadFileText, ReadValue, RecordDocument, RecordsDataSource, RecordsError, RecordsResult, StaleWriteDetail, type SupabaseLike, TableKindFacts, Uuid, WHOLE_VALUE_SOURCE_KIND, type WholeValuePointer, announceRecordChanged, announceTableStructureChanged, asRecordsDataSource, blockLandedInStore, cellText, doorAbsent, doorCensus, doorExists, doorReady, exportCellText, exportCsv, exportXlsx, forgetPrimedTablePageBundles, importCsv, importXlsx, landingOutcomesFor, mapPgError, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, primeTablePageBundle, staleWriteDetail, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };

package/dist/core/index.d.ts

@@ -468,6 +468,27 @@ declare function outcomeForBlock(outcomes: LandingOutcomes, block: LandingBlock)
 /** True when any landing of `kind` for this block is in the record store. */
 declare function blockLandedInStore(outcomes: LandingOutcomes, block: LandingBlock): boolean;
 
+/** What a data source's `rpc` answers for `custom.table_page_bundle` (PostgREST's `{ data, error }`). */
+interface PrimedBundleAnswer {
+    data: unknown;
+    error: unknown;
+}
+/**
+ * Hand the records client a table page's bundle that was asked elsewhere (the server render, as the
+ * same person). The next records client that opens this Table in this organization uses it instead of
+ * asking — once, within PRIMED_TTL_MS.
+ */
+declare function primeTablePageBundle(input: {
+    organizationId: string;
+    tableId: string;
+    viewId?: string | null;
+    answer: Promise<PrimedBundleAnswer> | PrimedBundleAnswer;
+}): void;
+/** The primed answer for this page, once — or null (none, or stale). */
+declare function takePrimedTablePageBundle(organizationId: string | null | undefined, tableId: string, viewId: string | null | undefined): Promise<PrimedBundleAnswer> | null;
+/** Tests only: forget every primed answer. */
+declare function forgetPrimedTablePageBundles(): void;
+
 /**
  * The structural shape of the supabase client this adapter needs. Deliberately
  * NOT `SupabaseClient<Database>`: a generated `Database` type makes
@@ -648,4 +669,4 @@ type ReadFileText = (fileId: Uuid) => Promise<string>;
  */
 declare function withWholeValues(rows: ExportRow[], read?: ReadFileText | null): Promise<ExportRow[]>;
 
-export { type BlockOutcome, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_VALUE_MAX_BYTES, DOORS, type DoorKey, type ExportRow, Field, LANDING_SOURCE_TYPE, LANDING_TARGET_TYPES, type Landing, type LandingBlock, type LandingOutcomes, type LandingState, type LandingStore, MAPPED_SQLSTATES, type MirrorLimits, OUTPUT_KEPT_KEY, PRODUCED_BY_LABEL, type ParsedImport, PgError, PredictedRefusal, type ReadFileText, ReadValue, RecordDocument, RecordsDataSource, RecordsError, RecordsResult, StaleWriteDetail, type SupabaseLike, TableKindFacts, Uuid, WHOLE_VALUE_SOURCE_KIND, type WholeValuePointer, announceRecordChanged, announceTableStructureChanged, asRecordsDataSource, blockLandedInStore, cellText, doorAbsent, doorCensus, doorExists, doorReady, exportCellText, exportCsv, exportXlsx, importCsv, importXlsx, landingOutcomesFor, mapPgError, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, tableKindFacts, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };
+export { type BlockOutcome, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_VALUE_MAX_BYTES, DOORS, type DoorKey, type ExportRow, Field, LANDING_SOURCE_TYPE, LANDING_TARGET_TYPES, type Landing, type LandingBlock, type LandingOutcomes, type LandingState, type LandingStore, MAPPED_SQLSTATES, type MirrorLimits, OUTPUT_KEPT_KEY, PRODUCED_BY_LABEL, type ParsedImport, PgError, PredictedRefusal, type PrimedBundleAnswer, type ReadFileText, ReadValue, RecordDocument, RecordsDataSource, RecordsError, RecordsResult, StaleWriteDetail, type SupabaseLike, TableKindFacts, Uuid, WHOLE_VALUE_SOURCE_KIND, type WholeValuePointer, announceRecordChanged, announceTableStructureChanged, asRecordsDataSource, blockLandedInStore, cellText, doorAbsent, doorCensus, doorExists, doorReady, exportCellText, exportCsv, exportXlsx, forgetPrimedTablePageBundles, importCsv, importXlsx, landingOutcomesFor, mapPgError, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, primeTablePageBundle, staleWriteDetail, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };

package/dist/core/index.js

@@ -4812,6 +4812,26 @@ function tableRenderSchema(facts) {
   return { kind: slug, fields: out };
 }
 
+// src/core/primedBundle.ts
+var PRIMED_TTL_MS = 15e3;
+var primed = /* @__PURE__ */ new Map();
+var primedKey = (organizationId, tableId, viewId) => `${organizationId}|${tableId}|${viewId ?? ""}`;
+function primeTablePageBundle(input) {
+  const answer = Promise.resolve(input.answer).catch((thrown) => ({ data: null, error: thrown }));
+  primed.set(primedKey(input.organizationId, input.tableId, input.viewId), { answer, at: Date.now() });
+}
+function takePrimedTablePageBundle(organizationId, tableId, viewId) {
+  if (!organizationId) return null;
+  const key = primedKey(organizationId, tableId, viewId);
+  const held = primed.get(key);
+  if (!held) return null;
+  primed.delete(key);
+  return Date.now() - held.at < PRIMED_TTL_MS ? held.answer : null;
+}
+function forgetPrimedTablePageBundles() {
+  primed.clear();
+}
+
 // src/core/keysetCursor.ts
 function utf8ToBinary(text2) {
   let out = "";
@@ -5761,13 +5781,20 @@ function createRecordsClient(given) {
   }
   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 view = typeof viewId === "string" ? viewId : null;
+      const usable = (r) => r !== null && !r.error && r.data !== null && typeof r.data === "object" && Array.isArray(r.data.parts);
+      const primedAnswer = takePrimedTablePageBundle(org, tableId, view);
+      let response = primedAnswer ? await primedAnswer : null;
+      if (!usable(response)) {
+        response = await config.dataSource.rpc(
+          "table_page_bundle",
+          { p_organization_id: org, p_table_id: tableId, p_view_id: view },
+          { schema }
+        );
+      }
+      if (!usable(response)) return;
       const answer = response.data;
-      if (response.error || !answer || !Array.isArray(answer.parts)) return;
+      if (!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;
@@ -9967,6 +9994,7 @@ export {
   fieldKindFor,
   fieldKindOf,
   forgetAllOps,
+  forgetPrimedTablePageBundles,
   hasQuietHours,
   highestLevel,
   holdsARetiredChoice,
@@ -10035,6 +10063,7 @@ export {
   predictWriteRefusals,
   previewRetype,
   previewRuleChange,
+  primeTablePageBundle,
   publicFormPath,
   rankTypedMatches,
   ratingMaxOf,
@@ -10071,6 +10100,7 @@ export {
   tableKindMapping,
   tableKindSlug,
   tableRenderSchema,
+  takePrimedTablePageBundle,
   toAoa,
   tokenFor,
   twoDigitYear,