@ai-matrx/records 0.80.8 → 0.81.1

package/dist/core/index.d.cts

@@ -679,4 +679,38 @@ 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 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, primeRecordPageBundle, primeTablePageBundle, staleWriteDetail, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };
+/** One door's answer, under its exact arguments. Plain JSON: it crosses from server to browser. */
+interface RecordsSeedAnswer {
+    door: string;
+    args: Record<string, unknown>;
+    data: unknown;
+}
+/** What a server asked for a page, as the person, and when. */
+interface RecordsSeed {
+    /** Epoch ms when the server asked. */
+    at: number;
+    answers: RecordsSeedAnswer[];
+}
+/** The match key: a door and every argument, keys sorted at every depth. */
+declare function seedKey(door: string, args: Record<string, unknown>): string;
+/**
+ * A data source that asks `source` and keeps every answer a door GAVE (errors are not kept). For a
+ * server render: create a records client over it, ask what the page will ask, then `seed()`.
+ */
+declare function recordingDataSource(source: RecordsDataSource): {
+    source: RecordsDataSource;
+    seed: () => RecordsSeed;
+};
+/** The seed as a lookup, built once per seed. */
+declare function seedIndex(seed: RecordsSeed): Map<string, unknown>;
+/**
+ * ONE RUN AGAINST THE SEED: a data source answering from `index` only, and whether the run asked a
+ * door the seed does not hold. It never opens a bundle itself (`opensInOneCall` off): the bundle's
+ * parts are already answers in the index.
+ */
+declare function seededDataSource(index: Map<string, unknown>): {
+    source: RecordsDataSource;
+    missed: () => boolean;
+};
+
+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, type RecordsSeed, type RecordsSeedAnswer, 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, primeRecordPageBundle, primeTablePageBundle, recordingDataSource, seedIndex, seedKey, seededDataSource, staleWriteDetail, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };

package/dist/core/index.d.ts

@@ -679,4 +679,38 @@ 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 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, primeRecordPageBundle, primeTablePageBundle, staleWriteDetail, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };
+/** One door's answer, under its exact arguments. Plain JSON: it crosses from server to browser. */
+interface RecordsSeedAnswer {
+    door: string;
+    args: Record<string, unknown>;
+    data: unknown;
+}
+/** What a server asked for a page, as the person, and when. */
+interface RecordsSeed {
+    /** Epoch ms when the server asked. */
+    at: number;
+    answers: RecordsSeedAnswer[];
+}
+/** The match key: a door and every argument, keys sorted at every depth. */
+declare function seedKey(door: string, args: Record<string, unknown>): string;
+/**
+ * A data source that asks `source` and keeps every answer a door GAVE (errors are not kept). For a
+ * server render: create a records client over it, ask what the page will ask, then `seed()`.
+ */
+declare function recordingDataSource(source: RecordsDataSource): {
+    source: RecordsDataSource;
+    seed: () => RecordsSeed;
+};
+/** The seed as a lookup, built once per seed. */
+declare function seedIndex(seed: RecordsSeed): Map<string, unknown>;
+/**
+ * ONE RUN AGAINST THE SEED: a data source answering from `index` only, and whether the run asked a
+ * door the seed does not hold. It never opens a bundle itself (`opensInOneCall` off): the bundle's
+ * parts are already answers in the index.
+ */
+declare function seededDataSource(index: Map<string, unknown>): {
+    source: RecordsDataSource;
+    missed: () => boolean;
+};
+
+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, type RecordsSeed, type RecordsSeedAnswer, 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, primeRecordPageBundle, primeTablePageBundle, recordingDataSource, seedIndex, seedKey, seededDataSource, staleWriteDetail, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };

package/dist/core/index.js

@@ -9948,6 +9948,76 @@ function fromMatrix(matrix) {
   });
   return { headers, rows: rows2 };
 }
+
+// src/core/seed.ts
+var BUNDLE_DOORS = /* @__PURE__ */ new Set(["table_page_bundle", "record_page_bundle"]);
+function seedKey(door, args) {
+  return `${door}|${canonicalArgs(args)}`;
+}
+function answersOf(door, args, data) {
+  const out = [{ door, args, data }];
+  if (!BUNDLE_DOORS.has(door) || !data || typeof data !== "object") return out;
+  const parts = data.parts;
+  if (!Array.isArray(parts)) return out;
+  for (const part of parts) {
+    if (part.error !== void 0 || part.data === void 0) continue;
+    if (typeof part.door !== "string" || !part.args || typeof part.args !== "object") continue;
+    out.push({ door: part.door, args: part.args, data: part.data });
+  }
+  return out;
+}
+function recordingDataSource(source) {
+  const kept = /* @__PURE__ */ new Map();
+  const recording = {
+    ...source.opensInOneCall ? { opensInOneCall: true } : {},
+    rpc(fn, args, options) {
+      return Promise.resolve(source.rpc(fn, args, options)).then((answer) => {
+        if (!answer.error && (options?.schema ?? "custom") === "custom") {
+          for (const a of answersOf(fn, args, answer.data)) kept.set(seedKey(a.door, a.args), a);
+        }
+        return answer;
+      });
+    },
+    schema: (name) => source.schema(name)
+  };
+  return { source: recording, seed: () => ({ at: Date.now(), answers: [...kept.values()] }) };
+}
+function seedIndex(seed) {
+  const index = /* @__PURE__ */ new Map();
+  for (const a of seed.answers) {
+    for (const spread of answersOf(a.door, a.args, a.data)) index.set(seedKey(spread.door, spread.args), spread.data);
+  }
+  return index;
+}
+var MISS = { code: "SEED_MISS", message: "Not in the page's seed.", details: null, hint: null };
+function missingQuery(onMiss) {
+  const answer = () => {
+    onMiss();
+    return Promise.resolve({ data: null, error: MISS, count: null });
+  };
+  const chain = new Proxy(function() {
+  }, {
+    get(_target, prop) {
+      if (prop === "then") return (ok2, bad) => answer().then(ok2, bad);
+      return () => chain;
+    },
+    apply: () => chain
+  });
+  return { select: () => chain };
+}
+function seededDataSource(index) {
+  let missed = false;
+  const source = {
+    rpc(fn, args) {
+      const key = seedKey(fn, args);
+      if (index.has(key)) return Promise.resolve({ data: index.get(key), error: null });
+      missed = true;
+      return Promise.resolve({ data: null, error: MISS });
+    },
+    schema: () => ({ from: () => missingQuery(() => missed = true) })
+  };
+  return { source, missed: () => missed };
+}
 export {
   ABSENCE_REASONS,
   ACTOR_VOCABULARY,
@@ -10163,6 +10233,7 @@ export {
   recordChangeTrigger,
   recordSourceKey,
   recordSourceTable,
+  recordingDataSource,
   recordsUseSentence,
   rehomeSentence,
   relationNameIndexOf,
@@ -10176,6 +10247,9 @@ export {
   safeLinkHref,
   sameDocument,
   scopeChip,
+  seedIndex,
+  seedKey,
+  seededDataSource,
   sheetSyncSpec,
   sourceArchivedOf,
   splitListCell,