@reventlessdev/reventless-local 3.0.0-alpha.115 → 3.0.0-alpha.116

package/src/adapter/LocalBus.res

@@ -154,6 +154,33 @@ module type T = {
   // Used by LocalQueryEngine to honour ~limit via Stream.take without loading all items.
   let registerQueryDbStream: (string, unit => Stream.t<JSON.t, string, unit>) => unit
   let getQueryDbStream: string => option<unit => Stream.t<JSON.t, string, unit>>
+  // Indexed equality lookup: (field, value) → matching items. The SQLite backend
+  // registers a closure that pushes the predicate down to a `json_extract` GSI
+  // index instead of materialising + parsing the whole table; the in-memory
+  // backend registers a scan+filter. The `{name}By{Index}` resolvers use this
+  // when present and fall back to `getQueryDbScan` otherwise.
+  let registerQueryDbIndexLookup: (string, (string, string) => array<JSON.t>) => unit
+  let getQueryDbIndexLookup: string => option<(string, string) => array<JSON.t>>
+  // Connection-list push-down: given the GraphQL args + derived capability +
+  // label field, a backend may return a ready Relay connection object computed
+  // entirely in storage (SQLite: json_extract predicates + ORDER BY … LIMIT), or
+  // `None` when it can't serve that query shape — the resolver then falls back to
+  // materialise + `QueryDbListQuery.run`. Only the SQLite backend registers one.
+  let registerQueryDbListPage: (
+    string,
+    (
+      ~argsDict: dict<JSON.t>,
+      ~capability: ReventlessCore.GraphQL_FragmentGenerator.serverCapability,
+      ~labelField: string,
+    ) => option<JSON.t>,
+  ) => unit
+  let getQueryDbListPage: string => option<
+    (
+      ~argsDict: dict<JSON.t>,
+      ~capability: ReventlessCore.GraphQL_FragmentGenerator.serverCapability,
+      ~labelField: string,
+    ) => option<JSON.t>,
+  >
 
   // Event log replay registry: aggregate EventLog name → replay function (entityId → events)
   let registerEventLogReplay: (string, string => promise<array<JSON.t>>) => unit
@@ -196,6 +223,15 @@ module type T = {
   let registerEventCollectorHandler: (string, (JSON.t, unit) => promise<unit>) => unit
   let subscribeEventCollectorToTopic: (string, string) => unit
 
+  // Projection catch-up registry: collector name → its resolved JSON event
+  // handler, registered only by projection-type collectors (the ReadModel
+  // builders, via LocalEventCollectorChannel.MakeProjection). The SQLite
+  // backend's startup catch-up (ProjectionCheckpoint.runCatchup) replays missed
+  // stored events into these handlers; automation/translation collectors are
+  // deliberately NOT in this registry so catch-up can never re-run side effects.
+  let registerProjectionCatchupHandler: (string, (JSON.t, unit) => promise<unit>) => unit
+  let projectionCatchupHandlers: unit => array<(string, (JSON.t, unit) => promise<unit>)>
+
   let reset: unit => unit
 }
 
@@ -227,6 +263,16 @@ module Impl = (C: BusConfig): T => {
   let queryDbRegistry: ref<dict<ReventlessCore.QueryDb_Adapter.operations>> = ref(Dict.make())
   let queryDbScanRegistry: ref<dict<unit => array<JSON.t>>> = ref(Dict.make())
   let queryDbStreamRegistry: ref<dict<unit => Stream.t<JSON.t, string, unit>>> = ref(Dict.make())
+  let queryDbIndexLookupRegistry: ref<dict<(string, string) => array<JSON.t>>> = ref(Dict.make())
+  let queryDbListPageRegistry: ref<
+    dict<
+      (
+        ~argsDict: dict<JSON.t>,
+        ~capability: ReventlessCore.GraphQL_FragmentGenerator.serverCapability,
+        ~labelField: string,
+      ) => option<JSON.t>,
+    >,
+  > = ref(Dict.make())
   let eventLogReplayRegistry: ref<dict<string => promise<array<JSON.t>>>> = ref(Dict.make())
   let dcbEventLogReadRegistry: ref<
     dict<
@@ -401,6 +447,12 @@ module Impl = (C: BusConfig): T => {
   let registerQueryDbStream = (name, streamFn) =>
     queryDbStreamRegistry.contents->Dict.set(name, streamFn)
   let getQueryDbStream = name => queryDbStreamRegistry.contents->Dict.get(name)
+  let registerQueryDbIndexLookup = (name, lookup) =>
+    queryDbIndexLookupRegistry.contents->Dict.set(name, lookup)
+  let getQueryDbIndexLookup = name => queryDbIndexLookupRegistry.contents->Dict.get(name)
+  let registerQueryDbListPage = (name, listPage) =>
+    queryDbListPageRegistry.contents->Dict.set(name, listPage)
+  let getQueryDbListPage = name => queryDbListPageRegistry.contents->Dict.get(name)
 
   let registerEventLogReplay = (name, replay) =>
     eventLogReplayRegistry.contents->Dict.set(name, replay)
@@ -460,6 +512,13 @@ module Impl = (C: BusConfig): T => {
     }
   }
 
+  let projectionCatchupRegistry: ref<dict<(JSON.t, unit) => promise<unit>>> = ref(Dict.make())
+
+  let registerProjectionCatchupHandler = (name, handler) =>
+    projectionCatchupRegistry.contents->Dict.set(name, handler)
+
+  let projectionCatchupHandlers = () => projectionCatchupRegistry.contents->Dict.toArray
+
   let reset = () => {
     // Shut down all hubs — PubSub.shutdown interrupts Stream.fromQueue consumers,
     // causing Stream.runForEach to complete and Effect.scoped to close the subscription.
@@ -477,11 +536,14 @@ module Impl = (C: BusConfig): T => {
     queryDbRegistry := Dict.make()
     queryDbScanRegistry := Dict.make()
     queryDbStreamRegistry := Dict.make()
+    queryDbIndexLookupRegistry := Dict.make()
+    queryDbListPageRegistry := Dict.make()
     eventLogReplayRegistry := Dict.make()
     dcbEventLogReadRegistry := Dict.make()
     stateChangeListeners := Dict.make()
     eventCollectorHandlers := Dict.make()
     eventCollectorPendingTopics := Dict.make()
+    projectionCatchupRegistry := Dict.make()
   }
 }
 

package/src/adapter/LocalBus.res.mjs

@@ -104,6 +104,12 @@ function Impl(C) {
   let queryDbStreamRegistry = {
     contents: {}
   };
+  let queryDbIndexLookupRegistry = {
+    contents: {}
+  };
+  let queryDbListPageRegistry = {
+    contents: {}
+  };
   let eventLogReplayRegistry = {
     contents: {}
   };
@@ -234,6 +240,14 @@ function Impl(C) {
     queryDbStreamRegistry.contents[name] = streamFn;
   };
   let getQueryDbStream = name => queryDbStreamRegistry.contents[name];
+  let registerQueryDbIndexLookup = (name, lookup) => {
+    queryDbIndexLookupRegistry.contents[name] = lookup;
+  };
+  let getQueryDbIndexLookup = name => queryDbIndexLookupRegistry.contents[name];
+  let registerQueryDbListPage = (name, listPage) => {
+    queryDbListPageRegistry.contents[name] = listPage;
+  };
+  let getQueryDbListPage = name => queryDbListPageRegistry.contents[name];
   let registerEventLogReplay = (name, replay) => {
     eventLogReplayRegistry.contents[name] = replay;
   };
@@ -282,6 +296,13 @@ function Impl(C) {
     pending.push(topicName);
     eventCollectorPendingTopics.contents[ecName] = pending;
   };
+  let projectionCatchupRegistry = {
+    contents: {}
+  };
+  let registerProjectionCatchupHandler = (name, handler) => {
+    projectionCatchupRegistry.contents[name] = handler;
+  };
+  let projectionCatchupHandlers = () => Object.entries(projectionCatchupRegistry.contents);
   let reset = () => {
     let shutdownAll = Effect$1.map(Effect$1.all(Object.values(eventHubs.contents).map(hub => PubSub.shutdown(hub)), {
       concurrency: "unbounded"
@@ -294,11 +315,14 @@ function Impl(C) {
     queryDbRegistry.contents = {};
     queryDbScanRegistry.contents = {};
     queryDbStreamRegistry.contents = {};
+    queryDbIndexLookupRegistry.contents = {};
+    queryDbListPageRegistry.contents = {};
     eventLogReplayRegistry.contents = {};
     dcbEventLogReadRegistry.contents = {};
     stateChangeListeners.contents = {};
     eventCollectorHandlers.contents = {};
     eventCollectorPendingTopics.contents = {};
+    projectionCatchupRegistry.contents = {};
   };
   return {
     publishEvent: publishEvent,
@@ -312,6 +336,10 @@ function Impl(C) {
     getQueryDbScan: getQueryDbScan,
     registerQueryDbStream: registerQueryDbStream,
     getQueryDbStream: getQueryDbStream,
+    registerQueryDbIndexLookup: registerQueryDbIndexLookup,
+    getQueryDbIndexLookup: getQueryDbIndexLookup,
+    registerQueryDbListPage: registerQueryDbListPage,
+    getQueryDbListPage: getQueryDbListPage,
     registerEventLogReplay: registerEventLogReplay,
     getEventLogReplay: getEventLogReplay,
     registerDcbEventLogRead: registerDcbEventLogRead,
@@ -320,6 +348,8 @@ function Impl(C) {
     subscribeToStateChanges: subscribeToStateChanges,
     registerEventCollectorHandler: registerEventCollectorHandler,
     subscribeEventCollectorToTopic: subscribeEventCollectorToTopic,
+    registerProjectionCatchupHandler: registerProjectionCatchupHandler,
+    projectionCatchupHandlers: projectionCatchupHandlers,
     reset: reset
   };
 }
@@ -346,6 +376,12 @@ function Make($star) {
   let queryDbStreamRegistry = {
     contents: {}
   };
+  let queryDbIndexLookupRegistry = {
+    contents: {}
+  };
+  let queryDbListPageRegistry = {
+    contents: {}
+  };
   let eventLogReplayRegistry = {
     contents: {}
   };
@@ -470,6 +506,14 @@ function Make($star) {
     queryDbStreamRegistry.contents[name] = streamFn;
   };
   let getQueryDbStream = name => queryDbStreamRegistry.contents[name];
+  let registerQueryDbIndexLookup = (name, lookup) => {
+    queryDbIndexLookupRegistry.contents[name] = lookup;
+  };
+  let getQueryDbIndexLookup = name => queryDbIndexLookupRegistry.contents[name];
+  let registerQueryDbListPage = (name, listPage) => {
+    queryDbListPageRegistry.contents[name] = listPage;
+  };
+  let getQueryDbListPage = name => queryDbListPageRegistry.contents[name];
   let registerEventLogReplay = (name, replay) => {
     eventLogReplayRegistry.contents[name] = replay;
   };
@@ -518,6 +562,13 @@ function Make($star) {
     pending.push(topicName);
     eventCollectorPendingTopics.contents[ecName] = pending;
   };
+  let projectionCatchupRegistry = {
+    contents: {}
+  };
+  let registerProjectionCatchupHandler = (name, handler) => {
+    projectionCatchupRegistry.contents[name] = handler;
+  };
+  let projectionCatchupHandlers = () => Object.entries(projectionCatchupRegistry.contents);
   let reset = () => {
     let shutdownAll = Effect$1.map(Effect$1.all(Object.values(eventHubs.contents).map(hub => PubSub.shutdown(hub)), {
       concurrency: "unbounded"
@@ -530,11 +581,14 @@ function Make($star) {
     queryDbRegistry.contents = {};
     queryDbScanRegistry.contents = {};
     queryDbStreamRegistry.contents = {};
+    queryDbIndexLookupRegistry.contents = {};
+    queryDbListPageRegistry.contents = {};
     eventLogReplayRegistry.contents = {};
     dcbEventLogReadRegistry.contents = {};
     stateChangeListeners.contents = {};
     eventCollectorHandlers.contents = {};
     eventCollectorPendingTopics.contents = {};
+    projectionCatchupRegistry.contents = {};
   };
   return {
     publishEvent: publishEvent,
@@ -548,6 +602,10 @@ function Make($star) {
     getQueryDbScan: getQueryDbScan,
     registerQueryDbStream: registerQueryDbStream,
     getQueryDbStream: getQueryDbStream,
+    registerQueryDbIndexLookup: registerQueryDbIndexLookup,
+    getQueryDbIndexLookup: getQueryDbIndexLookup,
+    registerQueryDbListPage: registerQueryDbListPage,
+    getQueryDbListPage: getQueryDbListPage,
     registerEventLogReplay: registerEventLogReplay,
     getEventLogReplay: getEventLogReplay,
     registerDcbEventLogRead: registerDcbEventLogRead,
@@ -556,6 +614,8 @@ function Make($star) {
     subscribeToStateChanges: subscribeToStateChanges,
     registerEventCollectorHandler: registerEventCollectorHandler,
     subscribeEventCollectorToTopic: subscribeEventCollectorToTopic,
+    registerProjectionCatchupHandler: registerProjectionCatchupHandler,
+    projectionCatchupHandlers: projectionCatchupHandlers,
     reset: reset
   };
 }
@@ -582,6 +642,12 @@ function MakeSilent($star) {
   let queryDbStreamRegistry = {
     contents: {}
   };
+  let queryDbIndexLookupRegistry = {
+    contents: {}
+  };
+  let queryDbListPageRegistry = {
+    contents: {}
+  };
   let eventLogReplayRegistry = {
     contents: {}
   };
@@ -706,6 +772,14 @@ function MakeSilent($star) {
     queryDbStreamRegistry.contents[name] = streamFn;
   };
   let getQueryDbStream = name => queryDbStreamRegistry.contents[name];
+  let registerQueryDbIndexLookup = (name, lookup) => {
+    queryDbIndexLookupRegistry.contents[name] = lookup;
+  };
+  let getQueryDbIndexLookup = name => queryDbIndexLookupRegistry.contents[name];
+  let registerQueryDbListPage = (name, listPage) => {
+    queryDbListPageRegistry.contents[name] = listPage;
+  };
+  let getQueryDbListPage = name => queryDbListPageRegistry.contents[name];
   let registerEventLogReplay = (name, replay) => {
     eventLogReplayRegistry.contents[name] = replay;
   };
@@ -754,6 +828,13 @@ function MakeSilent($star) {
     pending.push(topicName);
     eventCollectorPendingTopics.contents[ecName] = pending;
   };
+  let projectionCatchupRegistry = {
+    contents: {}
+  };
+  let registerProjectionCatchupHandler = (name, handler) => {
+    projectionCatchupRegistry.contents[name] = handler;
+  };
+  let projectionCatchupHandlers = () => Object.entries(projectionCatchupRegistry.contents);
   let reset = () => {
     let shutdownAll = Effect$1.map(Effect$1.all(Object.values(eventHubs.contents).map(hub => PubSub.shutdown(hub)), {
       concurrency: "unbounded"
@@ -766,11 +847,14 @@ function MakeSilent($star) {
     queryDbRegistry.contents = {};
     queryDbScanRegistry.contents = {};
     queryDbStreamRegistry.contents = {};
+    queryDbIndexLookupRegistry.contents = {};
+    queryDbListPageRegistry.contents = {};
     eventLogReplayRegistry.contents = {};
     dcbEventLogReadRegistry.contents = {};
     stateChangeListeners.contents = {};
     eventCollectorHandlers.contents = {};
     eventCollectorPendingTopics.contents = {};
+    projectionCatchupRegistry.contents = {};
   };
   return {
     publishEvent: publishEvent,
@@ -784,6 +868,10 @@ function MakeSilent($star) {
     getQueryDbScan: getQueryDbScan,
     registerQueryDbStream: registerQueryDbStream,
     getQueryDbStream: getQueryDbStream,
+    registerQueryDbIndexLookup: registerQueryDbIndexLookup,
+    getQueryDbIndexLookup: getQueryDbIndexLookup,
+    registerQueryDbListPage: registerQueryDbListPage,
+    getQueryDbListPage: getQueryDbListPage,
     registerEventLogReplay: registerEventLogReplay,
     getEventLogReplay: getEventLogReplay,
     registerDcbEventLogRead: registerDcbEventLogRead,
@@ -792,6 +880,8 @@ function MakeSilent($star) {
     subscribeToStateChanges: subscribeToStateChanges,
     registerEventCollectorHandler: registerEventCollectorHandler,
     subscribeEventCollectorToTopic: subscribeEventCollectorToTopic,
+    registerProjectionCatchupHandler: registerProjectionCatchupHandler,
+    projectionCatchupHandlers: projectionCatchupHandlers,
     reset: reset
   };
 }
@@ -819,6 +909,12 @@ function MakeBounded(C) {
   let queryDbStreamRegistry = {
     contents: {}
   };
+  let queryDbIndexLookupRegistry = {
+    contents: {}
+  };
+  let queryDbListPageRegistry = {
+    contents: {}
+  };
   let eventLogReplayRegistry = {
     contents: {}
   };
@@ -940,6 +1036,14 @@ function MakeBounded(C) {
     queryDbStreamRegistry.contents[name] = streamFn;
   };
   let getQueryDbStream = name => queryDbStreamRegistry.contents[name];
+  let registerQueryDbIndexLookup = (name, lookup) => {
+    queryDbIndexLookupRegistry.contents[name] = lookup;
+  };
+  let getQueryDbIndexLookup = name => queryDbIndexLookupRegistry.contents[name];
+  let registerQueryDbListPage = (name, listPage) => {
+    queryDbListPageRegistry.contents[name] = listPage;
+  };
+  let getQueryDbListPage = name => queryDbListPageRegistry.contents[name];
   let registerEventLogReplay = (name, replay) => {
     eventLogReplayRegistry.contents[name] = replay;
   };
@@ -988,6 +1092,13 @@ function MakeBounded(C) {
     pending.push(topicName);
     eventCollectorPendingTopics.contents[ecName] = pending;
   };
+  let projectionCatchupRegistry = {
+    contents: {}
+  };
+  let registerProjectionCatchupHandler = (name, handler) => {
+    projectionCatchupRegistry.contents[name] = handler;
+  };
+  let projectionCatchupHandlers = () => Object.entries(projectionCatchupRegistry.contents);
   let reset = () => {
     let shutdownAll = Effect$1.map(Effect$1.all(Object.values(eventHubs.contents).map(hub => PubSub.shutdown(hub)), {
       concurrency: "unbounded"
@@ -1000,11 +1111,14 @@ function MakeBounded(C) {
     queryDbRegistry.contents = {};
     queryDbScanRegistry.contents = {};
     queryDbStreamRegistry.contents = {};
+    queryDbIndexLookupRegistry.contents = {};
+    queryDbListPageRegistry.contents = {};
     eventLogReplayRegistry.contents = {};
     dcbEventLogReadRegistry.contents = {};
     stateChangeListeners.contents = {};
     eventCollectorHandlers.contents = {};
     eventCollectorPendingTopics.contents = {};
+    projectionCatchupRegistry.contents = {};
   };
   return {
     publishEvent: publishEvent,
@@ -1018,6 +1132,10 @@ function MakeBounded(C) {
     getQueryDbScan: getQueryDbScan,
     registerQueryDbStream: registerQueryDbStream,
     getQueryDbStream: getQueryDbStream,
+    registerQueryDbIndexLookup: registerQueryDbIndexLookup,
+    getQueryDbIndexLookup: getQueryDbIndexLookup,
+    registerQueryDbListPage: registerQueryDbListPage,
+    getQueryDbListPage: getQueryDbListPage,
     registerEventLogReplay: registerEventLogReplay,
     getEventLogReplay: getEventLogReplay,
     registerDcbEventLogRead: registerDcbEventLogRead,
@@ -1026,6 +1144,8 @@ function MakeBounded(C) {
     subscribeToStateChanges: subscribeToStateChanges,
     registerEventCollectorHandler: registerEventCollectorHandler,
     subscribeEventCollectorToTopic: subscribeEventCollectorToTopic,
+    registerProjectionCatchupHandler: registerProjectionCatchupHandler,
+    projectionCatchupHandlers: projectionCatchupHandlers,
     reset: reset
   };
 }