@absolutejs/sync 2.0.0 → 2.1.0

package/dist/engine/devtools.d.ts

@@ -113,6 +113,21 @@ export type EngineMetrics = {
     schedules: {
         registered: number;
     };
+    /**
+     * Change-source liveness, aggregated across every `connectSource` (e.g. a
+     * CDC adapter). Lets a health check distinguish a healthy-but-quiet feed
+     * from a wired-but-silent or disconnected one. Added in 2.1.0.
+     */
+    source: {
+        /** Currently-connected change sources (0 once all have disconnected). */
+        connected: number;
+        /** Total changes delivered by connected sources since engine start. */
+        changesReceived: number;
+        /** `Date.now()` of the most recent source change, or `null` if none yet. */
+        lastChangeAt: number | null;
+        /** Wall-clock age of the most recent source change in ms, or `null`. */
+        lastChangeAgeMs: number | null;
+    };
 };
 /**
  * A live engine event (see {@link SyncEngine.onActivity}): a committed change or

package/dist/engine/index.js

@@ -1611,6 +1611,9 @@ var createSyncEngine = (options = {}) => {
   let mutationsFailed = 0;
   let mutationsRetried = 0;
   let mutationsInFlight = 0;
+  let connectedSources = 0;
+  let sourceChangesReceived = 0;
+  let sourceLastChangeAt = null;
   const mutationWaiters = [];
   let mutationsQueued = 0;
   const activeFences = new Set;
@@ -2664,8 +2667,18 @@ var createSyncEngine = (options = {}) => {
     },
     applyChange: (table, change) => applyChange(table, change),
     connectSource: async (source) => {
-      await source.start((table, change) => applyChange(table, change));
+      await source.start((table, change) => {
+        sourceChangesReceived += 1;
+        sourceLastChangeAt = Date.now();
+        return applyChange(table, change);
+      });
+      connectedSources += 1;
+      let stopped = false;
       return async () => {
+        if (!stopped) {
+          stopped = true;
+          connectedSources -= 1;
+        }
         await source.stop();
       };
     },
@@ -3226,6 +3239,12 @@ var createSyncEngine = (options = {}) => {
         schedules: {
           registered: schedules.size
         },
+        source: {
+          changesReceived: sourceChangesReceived,
+          connected: connectedSources,
+          lastChangeAgeMs: sourceLastChangeAt === null ? null : now - sourceLastChangeAt,
+          lastChangeAt: sourceLastChangeAt
+        },
         subscriptions: {
           byCollection,
           byTenant: Object.fromEntries(subscriptionsByTenant),
@@ -3769,5 +3788,5 @@ export {
   CdcConsumerSlowError
 };
 
-//# debugId=6D23BAC246E5201264756E2164756E21
+//# debugId=34D5A585C92FDCCE64756E2164756E21
 //# sourceMappingURL=index.js.map