@ai-matrx/records 0.84.1 → 0.84.3

package/dist/core/index.d.cts

@@ -498,6 +498,15 @@ declare function primeRecordPageBundle(input: {
     recordId: string;
     answer: Promise<PrimedBundleAnswer> | PrimedBundleAnswer;
 }): void;
+/** How long a primed door answer stays servable, counted from when the server asked. */
+declare const PRIMED_DOOR_TTL_MS = 10000;
+/** Keep one door's answer (`key` = door name + canonical arguments, as `seedKey` builds it). */
+declare function primeDoorAnswer(key: string, data: unknown, at: number): void;
+/**
+ * A write happened: nothing primed is trusted any more — or, with `doors`, only what those doors answered
+ * (a saved view changes the views and the layout, never a record's value or a count of records).
+ */
+declare function dropPrimedDoorAnswers(doors?: readonly string[]): void;
 
 /**
  * The structural shape of the supabase client this adapter needs. Deliberately
@@ -713,4 +722,4 @@ declare function seededDataSource(index: Map<string, unknown>): {
     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 };
+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, PRIMED_DOOR_TTL_MS, 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, dropPrimedDoorAnswers, exportCellText, exportCsv, exportXlsx, forgetPrimedTablePageBundles, importCsv, importXlsx, landingOutcomesFor, mapPgError, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, primeDoorAnswer, primeRecordPageBundle, primeTablePageBundle, recordingDataSource, seedIndex, seedKey, seededDataSource, staleWriteDetail, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };

package/dist/core/index.d.ts

@@ -498,6 +498,15 @@ declare function primeRecordPageBundle(input: {
     recordId: string;
     answer: Promise<PrimedBundleAnswer> | PrimedBundleAnswer;
 }): void;
+/** How long a primed door answer stays servable, counted from when the server asked. */
+declare const PRIMED_DOOR_TTL_MS = 10000;
+/** Keep one door's answer (`key` = door name + canonical arguments, as `seedKey` builds it). */
+declare function primeDoorAnswer(key: string, data: unknown, at: number): void;
+/**
+ * A write happened: nothing primed is trusted any more — or, with `doors`, only what those doors answered
+ * (a saved view changes the views and the layout, never a record's value or a count of records).
+ */
+declare function dropPrimedDoorAnswers(doors?: readonly string[]): void;
 
 /**
  * The structural shape of the supabase client this adapter needs. Deliberately
@@ -713,4 +722,4 @@ declare function seededDataSource(index: Map<string, unknown>): {
     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 };
+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, PRIMED_DOOR_TTL_MS, 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, dropPrimedDoorAnswers, exportCellText, exportCsv, exportXlsx, forgetPrimedTablePageBundles, importCsv, importXlsx, landingOutcomesFor, mapPgError, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, primeDoorAnswer, primeRecordPageBundle, primeTablePageBundle, recordingDataSource, seedIndex, seedKey, seededDataSource, staleWriteDetail, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };

package/dist/core/index.js

@@ -4876,6 +4876,40 @@ function forgetPrimedTablePageBundles() {
 function primeRecordPageBundle(input) {
   primeTablePageBundle({ organizationId: input.organizationId, tableId: `record:${input.recordId}`, answer: input.answer });
 }
+var DOOR_REGISTRY = /* @__PURE__ */ Symbol.for("@ai-matrx/records/primed-door-answers");
+function doorRegistry() {
+  const g = globalThis;
+  return g[DOOR_REGISTRY] ??= /* @__PURE__ */ new Map();
+}
+var PRIMED_DOOR_TTL_MS = 1e4;
+function primeDoorAnswer(key, data, at) {
+  doorRegistry().set(key, { data, at });
+}
+function takePrimedDoorAnswer(key) {
+  const registry2 = doorRegistry();
+  const held = registry2.get(key);
+  if (!held) return null;
+  if (Date.now() - held.at < PRIMED_DOOR_TTL_MS) return { data: held.data };
+  registry2.delete(key);
+  return null;
+}
+function dropPrimedDoorAnswers(doors) {
+  const registry2 = doorRegistry();
+  if (!doors) {
+    registry2.clear();
+    return;
+  }
+  for (const key of [...registry2.keys()]) if (doors.some((door) => key.startsWith(`${door}|`))) registry2.delete(key);
+}
+var LOOK_WRITES = {
+  view_declare: ["views", "view_look_read", "grid_layout", "table_page_bundle"],
+  view_designate: ["views", "view_look_read", "grid_layout", "table_page_bundle"],
+  view_look_set: ["views", "view_look_read", "grid_layout", "table_page_bundle"],
+  view_record_order_set: ["views", "view_look_read", "grid_layout", "table_page_bundle"]
+};
+function isWritingDoor(door) {
+  return /(_declare|_set(_|$)|_update|_write|_delete|_restore|_archive|_upsert|_reparent|_change|_duplicate|_move|_decide|_run$|_submit|_publish|_import_|_start$|_complete|_sign$|_add$|_retire|_propose|_promote|_land$|_pin$|_mute|_snooze|_unsnooze|_clear|_unclear|_revoke|_issue|_bind|_unbind|_apply|_backfill|_sync$|_decorate|_designate|_ensure|^migrate_|^home_add|^capture_|^claim_|^record_stage|^anon_|^io_import_|^io_comment_resolve|^enrich_(declare|land|pin)|^field_(declare|duplicate|propose|restore|retire|update)|^table_(declare|ensure|from_example|move|sync)|^value_restore|^relation_own)/.test(door);
+}
 
 // src/core/recordChanges.ts
 var listeners = /* @__PURE__ */ new Set();
@@ -5947,7 +5981,21 @@ function createRecordsClient(given) {
     bundleAsked.delete(tableId);
     for (const key of [...bundleParts.keys()]) if (key.includes(tableId)) bundleParts.delete(key);
   }
+  function primedFor(door, args) {
+    const look = LOOK_WRITES[door];
+    if (look) {
+      dropPrimedDoorAnswers(look);
+      return null;
+    }
+    if (isWritingDoor(door)) {
+      dropPrimedDoorAnswers();
+      return null;
+    }
+    return takePrimedDoorAnswer(`${door}|${canonicalArgs(args)}`);
+  }
   async function callDoor(door, args, where) {
+    const primed = primedFor(door, args);
+    if (primed) return ok(primed.data);
     const bundled = await fromBundle(door, args);
     if (bundled) return ok(bundled.data);
     if (!doorReady(config, door)) {
@@ -5972,6 +6020,8 @@ function createRecordsClient(given) {
   }
   async function owedDoor(door, args, where) {
     if (doorExists(door)) return callDoor(door, args, where);
+    const primed = primedFor(door, args);
+    if (primed) return ok(primed.data);
     const response = await config.dataSource.rpc(door, args, { schema });
     if (response.error) {
       const code = response.error.code;
@@ -6037,6 +6087,8 @@ function createRecordsClient(given) {
     return ok(response.data);
   }
   async function drillDoor(door, args, where) {
+    const primed = primedFor(door, args);
+    if (primed) return ok(primed.data);
     const response = await config.dataSource.rpc(door, args, { schema: DRILL_SCHEMA });
     if (response.error) {
       const refusal = mapPgError(response.error, where);
@@ -10094,6 +10146,7 @@ export {
   PIPELINE_RULE_KINDS,
   PORTAL_ACCENTS,
   PORTAL_ARCHIVE_FILTERS,
+  PRIMED_DOOR_TTL_MS,
   PRODUCED_BY_LABEL,
   REFUSALS_WORTH_REPEATING,
   RELATION_BINDINGS,
@@ -10159,6 +10212,7 @@ export {
   doorReady,
   drillAnswerOf,
   drillFindingKnob,
+  dropPrimedDoorAnswers,
   durationText,
   emptyArchiveLine,
   emptyPortalArchiveLine,
@@ -10247,6 +10301,7 @@ export {
   predictWriteRefusals,
   previewRetype,
   previewRuleChange,
+  primeDoorAnswer,
   primeRecordPageBundle,
   primeTablePageBundle,
   publicFormPath,