@ai-matrx/records 0.84.1 → 0.84.2

package/dist/core/index.d.cts

@@ -498,6 +498,12 @@ 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. */
+declare function dropPrimedDoorAnswers(): void;
 
 /**
  * The structural shape of the supabase client this adapter needs. Deliberately
@@ -713,4 +719,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,12 @@ 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. */
+declare function dropPrimedDoorAnswers(): void;
 
 /**
  * The structural shape of the supabase client this adapter needs. Deliberately
@@ -713,4 +719,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,29 @@ 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() {
+  doorRegistry().clear();
+}
+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 +5970,16 @@ function createRecordsClient(given) {
     bundleAsked.delete(tableId);
     for (const key of [...bundleParts.keys()]) if (key.includes(tableId)) bundleParts.delete(key);
   }
+  function primedFor(door, args) {
+    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 +6004,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 +6071,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 +10130,7 @@ export {
   PIPELINE_RULE_KINDS,
   PORTAL_ACCENTS,
   PORTAL_ARCHIVE_FILTERS,
+  PRIMED_DOOR_TTL_MS,
   PRODUCED_BY_LABEL,
   REFUSALS_WORTH_REPEATING,
   RELATION_BINDINGS,
@@ -10159,6 +10196,7 @@ export {
   doorReady,
   drillAnswerOf,
   drillFindingKnob,
+  dropPrimedDoorAnswers,
   durationText,
   emptyArchiveLine,
   emptyPortalArchiveLine,
@@ -10247,6 +10285,7 @@ export {
   predictWriteRefusals,
   previewRetype,
   previewRuleChange,
+  primeDoorAnswer,
   primeRecordPageBundle,
   primeTablePageBundle,
   publicFormPath,