@powersync/service-core 0.0.0-dev-20250317122913 → 0.0.0-dev-20250325131118

package/dist/sync/RequestTracker.js

@@ -1,17 +1,22 @@
-import { Metrics } from '../metrics/Metrics.js';
+import { APIMetric } from '@powersync/service-types';
 /**
  * Record sync stats per request stream.
  */
 export class RequestTracker {
+    metrics;
     operationsSynced = 0;
     dataSyncedBytes = 0;
+    constructor(metrics) {
+        this.metrics = metrics;
+        this.metrics = metrics;
+    }
     addOperationsSynced(operations) {
         this.operationsSynced += operations;
-        Metrics.getInstance().operations_synced_total.add(operations);
+        this.metrics.getCounter(APIMetric.OPERATIONS_SYNCED).add(operations);
     }
     addDataSynced(bytes) {
         this.dataSyncedBytes += bytes;
-        Metrics.getInstance().data_synced_bytes.add(bytes);
+        this.metrics.getCounter(APIMetric.DATA_SYNCED_BYTES).add(bytes);
     }
 }
 //# sourceMappingURL=RequestTracker.js.map

package/dist/sync/RequestTracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"RequestTracker.js","sourceRoot":"","sources":["../../src/sync/RequestTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,cAAc;IACzB,gBAAgB,GAAG,CAAC,CAAC;IACrB,eAAe,GAAG,CAAC,CAAC;IAEpB,mBAAmB,CAAC,UAAkB;QACpC,IAAI,CAAC,gBAAgB,IAAI,UAAU,CAAC;QAEpC,OAAO,CAAC,WAAW,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChE,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC;QAE9B,OAAO,CAAC,WAAW,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;CACF"}
+{"version":3,"file":"RequestTracker.js","sourceRoot":"","sources":["../../src/sync/RequestTracker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;GAEG;AACH,MAAM,OAAO,cAAc;IAIL;IAHpB,gBAAgB,GAAG,CAAC,CAAC;IACrB,eAAe,GAAG,CAAC,CAAC;IAEpB,YAAoB,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,mBAAmB,CAAC,UAAkB;QACpC,IAAI,CAAC,gBAAgB,IAAI,UAAU,CAAC;QAEpC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC;QAE9B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/sync/util.d.ts

@@ -1,6 +1,6 @@
+import { SemaphoreInterface } from 'async-mutex';
 import * as util from '../util/util-index.js';
 import { RequestTracker } from './RequestTracker.js';
-import { SemaphoreInterface } from 'async-mutex';
 export type TokenStreamOptions = {
     /**
      * Adds periodic keepalive events
@@ -32,4 +32,12 @@ export declare function acquireSemaphoreAbortable(semaphone: SemaphoreInterface,
  * if it is not specifically handled.
  */
 export declare function settledPromise<T>(promise: Promise<T>): Promise<PromiseSettledResult<T>>;
-export declare function hasIntersection<T>(a: Set<T>, b: Set<T>): true | undefined;
+export type MapOrSet<T> = Map<T, any> | Set<T>;
+/**
+ * Check if two sets have any element(s) in common.
+ */
+export declare function hasIntersection<T>(a: MapOrSet<T>, b: MapOrSet<T>): boolean;
+/**
+ * Return the intersection of two sets or maps.
+ */
+export declare function getIntersection<T>(a: MapOrSet<T>, b: MapOrSet<T>): IterableIterator<T>;

package/dist/sync/util.js

@@ -113,14 +113,33 @@ export function settledPromise(promise) {
         };
     });
 }
+/**
+ * Check if two sets have any element(s) in common.
+ */
 export function hasIntersection(a, b) {
-    if (a.size > b.size) {
-        [a, b] = [b, a];
+    for (let _ of getIntersection(a, b)) {
+        return true;
     }
-    // Now, a is always smaller than b, so iterate over a
-    for (let value of a) {
-        if (b.has(value)) {
-            return true;
+    return false;
+}
+/**
+ * Return the intersection of two sets or maps.
+ */
+export function* getIntersection(a, b) {
+    // Iterate over the smaller set to reduce the number of lookups
+    if (a.size < b.size) {
+        for (let key of a.keys()) {
+            if (b.has(key)) {
+                yield key;
+            }
+        }
+        return false;
+    }
+    else {
+        for (let key of b.keys()) {
+            if (a.has(key)) {
+                yield key;
+            }
         }
     }
 }

package/dist/sync/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/sync/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAiB1C,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,4BAA4B,GAAuB;IACvD,UAAU,EAAE,IAAI;IAChB,qBAAqB,EAAE,MAAM;CAC9B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAChC,KAAsB,EACtB,MAAmB,EACnB,OAAqC;IAErC,MAAM,gBAAgB,GAAuB;QAC3C,GAAG,4BAA4B;QAC/B,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;KACnB,CAAC;IAEF,MAAM,EAAE,UAAU,EAAE,qBAAqB,EAAE,GAAG,gBAAgB,CAAC;IAE/D,8CAA8C;IAC9C,+DAA+D;IAC/D,+BAA+B;IAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC;IACpC,MAAM,iBAAiB,GAAG,UAAU,GAAG,qBAAqB,CAAC;IAE7D,IAAI,iBAAiB,GAAG,IAAI,CAAC;IAE7B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC/E,IAAI,iBAAiB,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;YAC9C,iBAAiB,GAAG,KAAK,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;YAC7C,IAAI,gBAAgB,IAAI,CAAC,EAAE,CAAC;gBAC1B,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAE1E,4CAA4C;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7E,6CAA6C;QAC7C,MAAM,qBAAqB,GAAG,oBAAoB,IAAI,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,YAAY,CAAC;QAE9F,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC;QACrG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC1D,oBAAoB;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC,QAA4D;IACxF,IAAI,KAAK,EAAE,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,uCAAuC;YACvC,SAAS;QACX,CAAC;aAAM,IAAI,OAAO,IAAI,IAAI,QAAQ,EAAE,CAAC;YACnC,uBAAuB;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACpC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,uBAAuB,CAC5C,QAA+B,EAC/B,OAAuB;IAEvB,IAAI,KAAK,EAAE,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,OAAO,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,SAA6B,EAC7B,KAAkB;IAElB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,YAAY,GAAG,KAAK,CAAC;QAEzB,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,GAAG,IAAI,CAAC;gBACf,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC7C,OAAO,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC;QACF,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE1C,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACpC,YAAY,GAAG,IAAI,CAAC;YACpB,IAAI,OAAO,EAAE,CAAC;gBACZ,qCAAqC;gBACrC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC7C,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,EAAE,MAAM,CAAC,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAI,OAAmB;IACnD,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,MAAM,EAAE,EAAE;QACT,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,MAAM;SACd,CAAC;IACJ,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;QACR,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,CAAS,EAAE,CAAS;IACrD,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,qDAAqD;IACrD,KAAK,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/sync/util.ts"],"names":[],"mappings":"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"}

package/dist/system/ServiceContext.d.ts

@@ -1,5 +1,5 @@
 import { LifeCycledSystem, ServiceIdentifier } from '@powersync/lib-services-framework';
-import * as metrics from '../metrics/Metrics.js';
+import * as metrics from '../metrics/MetricsEngine.js';
 import { PowerSyncMigrationManager } from '../migrations/PowerSyncMigrationManager.js';
 import * as replication from '../replication/replication-index.js';
 import * as routes from '../routes/routes-index.js';
@@ -9,7 +9,7 @@ import { SyncContext } from '../sync/SyncContext.js';
 export interface ServiceContext {
     configuration: utils.ResolvedPowerSyncConfig;
     lifeCycleEngine: LifeCycledSystem;
-    metrics: metrics.Metrics | null;
+    metricsEngine: metrics.MetricsEngine;
     replicationEngine: replication.ReplicationEngine | null;
     routerEngine: routes.RouterEngine | null;
     storageEngine: storage.StorageEngine;
@@ -29,7 +29,7 @@ export declare class ServiceContextContainer implements ServiceContext {
     constructor(configuration: utils.ResolvedPowerSyncConfig);
     get replicationEngine(): replication.ReplicationEngine | null;
     get routerEngine(): routes.RouterEngine | null;
-    get metrics(): metrics.Metrics | null;
+    get metricsEngine(): metrics.MetricsEngine;
     get migrations(): PowerSyncMigrationManager;
     /**
      * Allows for registering core and generic implementations of services/helpers.

package/dist/system/ServiceContext.js

@@ -1,6 +1,6 @@
 import { LifeCycledSystem, MigrationManager, container } from '@powersync/lib-services-framework';
 import { framework } from '../index.js';
-import * as metrics from '../metrics/Metrics.js';
+import * as metrics from '../metrics/MetricsEngine.js';
 import * as replication from '../replication/replication-index.js';
 import * as routes from '../routes/routes-index.js';
 import * as storage from '../storage/storage-index.js';
@@ -21,6 +21,10 @@ export class ServiceContextContainer {
         this.storageEngine = new storage.StorageEngine({
             configuration
         });
+        this.lifeCycleEngine.withLifecycle(this.storageEngine, {
+            start: (storageEngine) => storageEngine.start(),
+            stop: (storageEngine) => storageEngine.shutDown()
+        });
         this.syncContext = new SyncContext({
             maxDataFetchConcurrency: configuration.api_parameters.max_data_fetch_concurrency,
             maxBuckets: configuration.api_parameters.max_buckets_per_connection,
@@ -43,8 +47,8 @@ export class ServiceContextContainer {
     get routerEngine() {
         return container.getOptional(routes.RouterEngine);
     }
-    get metrics() {
-        return container.getOptional(metrics.Metrics);
+    get metricsEngine() {
+        return container.getImplementation(metrics.MetricsEngine);
     }
     get migrations() {
         return container.getImplementation(framework.ContainerImplementation.MIGRATION_MANAGER);

package/dist/system/ServiceContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceContext.js","sourceRoot":"","sources":["../../src/system/ServiceContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAqB,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAErH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAC;AAEjD,OAAO,KAAK,WAAW,MAAM,qCAAqC,CAAC;AACnE,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAarD;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAKf;IAJnB,eAAe,CAAmB;IAClC,aAAa,CAAwB;IACrC,WAAW,CAAc;IAEzB,YAAmB,aAA4C;QAA5C,kBAAa,GAAb,aAAa,CAA+B;QAC7D,IAAI,CAAC,eAAe,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAE9C,IAAI,CAAC,aAAa,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;YAC7C,aAAa;SACd,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC;YACjC,uBAAuB,EAAE,aAAa,CAAC,cAAc,CAAC,0BAA0B;YAChF,UAAU,EAAE,aAAa,CAAC,cAAc,CAAC,0BAA0B;YACnE,wBAAwB,EAAE,aAAa,CAAC,cAAc,CAAC,2BAA2B;SACnF,CAAC,CAAC;QAEH,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAChD,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;QAE1F,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,gBAAgB,EAAE;YACnD,yDAAyD;YACzD,KAAK,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;SACrD,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE;YACrD,KAAK,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE;YAC/C,IAAI,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,YAAY;QACd,OAAO,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,OAAO;QACT,OAAO,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IAC1F,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAI,UAAgC,EAAE,cAAiB;QAC7D,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,UAAgC;QACrC,OAAO,SAAS,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"ServiceContext.js","sourceRoot":"","sources":["../../src/system/ServiceContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAqB,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAErH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AAEvD,OAAO,KAAK,WAAW,MAAM,qCAAqC,CAAC;AACnE,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAarD;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAKf;IAJnB,eAAe,CAAmB;IAClC,aAAa,CAAwB;IACrC,WAAW,CAAc;IAEzB,YAAmB,aAA4C;QAA5C,kBAAa,GAAb,aAAa,CAA+B;QAC7D,IAAI,CAAC,eAAe,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAE9C,IAAI,CAAC,aAAa,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;YAC7C,aAAa;SACd,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE;YACrD,KAAK,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE;YAC/C,IAAI,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE;SAClD,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC;YACjC,uBAAuB,EAAE,aAAa,CAAC,cAAc,CAAC,0BAA0B;YAChF,UAAU,EAAE,aAAa,CAAC,cAAc,CAAC,0BAA0B;YACnE,wBAAwB,EAAE,aAAa,CAAC,cAAc,CAAC,2BAA2B;SACnF,CAAC,CAAC;QAEH,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAChD,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;QAE1F,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,gBAAgB,EAAE;YACnD,yDAAyD;YACzD,KAAK,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;SACrD,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE;YACrD,KAAK,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE;YAC/C,IAAI,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,YAAY;QACd,OAAO,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,aAAa;QACf,OAAO,SAAS,CAAC,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IAC1F,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAI,UAAgC,EAAE,cAAiB;QAC7D,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,UAAgC;QACrC,OAAO,SAAS,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;CACF"}

package/package.json

@@ -5,17 +5,17 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.0-dev-20250317122913",
+  "version": "0.0.0-dev-20250325131118",
   "main": "dist/index.js",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",
   "dependencies": {
     "@js-sdsl/ordered-set": "^4.4.2",
-    "@opentelemetry/api": "~1.8.0",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.51.1",
-    "@opentelemetry/exporter-prometheus": "^0.51.1",
-    "@opentelemetry/resources": "^1.24.1",
-    "@opentelemetry/sdk-metrics": "1.24.1",
+    "@opentelemetry/api": "~1.9.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.57.2",
+    "@opentelemetry/exporter-prometheus": "^0.57.2",
+    "@opentelemetry/resources": "^1.30.1",
+    "@opentelemetry/sdk-metrics": "1.30.1",
     "async": "^3.2.4",
     "async-mutex": "^0.5.0",
     "bson": "^6.10.3",
@@ -35,8 +35,8 @@
     "@powersync/lib-services-framework": "0.5.3",
     "@powersync/service-jsonbig": "0.17.10",
     "@powersync/service-rsocket-router": "0.0.20",
-    "@powersync/service-sync-rules": "0.0.0-dev-20250317122913",
-    "@powersync/service-types": "0.9.0"
+    "@powersync/service-sync-rules": "0.25.0",
+    "@powersync/service-types": "0.0.0-dev-20250325131118"
   },
   "devDependencies": {
     "@types/async": "^3.2.24",

package/src/api/api-index.ts

@@ -1,3 +1,4 @@
 export * from './diagnostics.js';
 export * from './RouteAPI.js';
 export * from './schema.js';
+export * from './api-metrics.js';

package/src/api/api-metrics.ts

@@ -0,0 +1,35 @@
+import { MetricsEngine } from '../metrics/MetricsEngine.js';
+import { APIMetric } from '@powersync/service-types';
+
+/**
+ *  Create and register the core API metrics.
+ *  @param engine
+ */
+export function createCoreAPIMetrics(engine: MetricsEngine): void {
+  engine.createCounter({
+    name: APIMetric.DATA_SYNCED_BYTES,
+    description: 'Uncompressed size of synced data',
+    unit: 'bytes'
+  });
+
+  engine.createCounter({
+    name: APIMetric.OPERATIONS_SYNCED,
+    description: 'Number of operations synced'
+  });
+
+  engine.createUpDownCounter({
+    name: APIMetric.CONCURRENT_CONNECTIONS,
+    description: 'Number of concurrent sync connections'
+  });
+}
+
+/**
+ *  Initialise the core API metrics. This should be called after the metrics have been created.
+ *  @param engine
+ */
+export function initializeCoreAPIMetrics(engine: MetricsEngine): void {
+  const concurrent_connections = engine.getUpDownCounter(APIMetric.CONCURRENT_CONNECTIONS);
+
+  // Initialize the metric, so that it reports a value before connections have been opened.
+  concurrent_connections.add(0);
+}

package/src/index.ts

@@ -12,8 +12,8 @@ export * as entry from './entry/entry-index.js';
 // Re-export framework for easy use of Container API
 export * as framework from '@powersync/lib-services-framework';
 
-export * from './metrics/Metrics.js';
-export * as metrics from './metrics/Metrics.js';
+export * from './metrics/metrics-index.js';
+export * as metrics from './metrics/metrics-index.js';
 
 export * from './migrations/migrations-index.js';
 export * as migrations from './migrations/migrations-index.js';

package/src/metrics/MetricsEngine.ts

@@ -0,0 +1,98 @@
+import { logger, ServiceAssertionError } from '@powersync/lib-services-framework';
+import { Counter, UpDownCounter, ObservableGauge, MetricMetadata, MetricsFactory } from './metrics-interfaces.js';
+
+export interface MetricsEngineOptions {
+  factory: MetricsFactory;
+  disable_telemetry_sharing: boolean;
+}
+
+export class MetricsEngine {
+  private counters: Map<string, Counter>;
+  private upDownCounters: Map<string, UpDownCounter>;
+  private observableGauges: Map<string, ObservableGauge>;
+
+  constructor(private options: MetricsEngineOptions) {
+    this.counters = new Map();
+    this.upDownCounters = new Map();
+    this.observableGauges = new Map();
+  }
+
+  private get factory(): MetricsFactory {
+    return this.options.factory;
+  }
+
+  createCounter(metadata: MetricMetadata): Counter {
+    if (this.counters.has(metadata.name)) {
+      logger.warn(`Counter with name ${metadata.name} already created and registered, skipping.`);
+      return this.counters.get(metadata.name)!;
+    }
+
+    const counter = this.factory.createCounter(metadata);
+    this.counters.set(metadata.name, counter);
+    return counter;
+  }
+  createUpDownCounter(metadata: MetricMetadata): UpDownCounter {
+    if (this.upDownCounters.has(metadata.name)) {
+      logger.warn(`UpDownCounter with name ${metadata.name} already created and registered, skipping.`);
+      return this.upDownCounters.get(metadata.name)!;
+    }
+
+    const upDownCounter = this.factory.createUpDownCounter(metadata);
+    this.upDownCounters.set(metadata.name, upDownCounter);
+    return upDownCounter;
+  }
+
+  createObservableGauge(metadata: MetricMetadata): ObservableGauge {
+    if (this.observableGauges.has(metadata.name)) {
+      logger.warn(`ObservableGauge with name ${metadata.name} already created and registered, skipping.`);
+      return this.observableGauges.get(metadata.name)!;
+    }
+
+    const observableGauge = this.factory.createObservableGauge(metadata);
+    this.observableGauges.set(metadata.name, observableGauge);
+    return observableGauge;
+  }
+
+  getCounter(name: string): Counter {
+    const counter = this.counters.get(name);
+    if (!counter) {
+      throw new ServiceAssertionError(`Counter '${name}' has not been created and registered yet.`);
+    }
+    return counter;
+  }
+
+  getUpDownCounter(name: string): UpDownCounter {
+    const upDownCounter = this.upDownCounters.get(name);
+    if (!upDownCounter) {
+      throw new ServiceAssertionError(`UpDownCounter '${name}' has not been created and registered yet.`);
+    }
+    return upDownCounter;
+  }
+
+  getObservableGauge(name: string): ObservableGauge {
+    const observableGauge = this.observableGauges.get(name);
+    if (!observableGauge) {
+      throw new ServiceAssertionError(`ObservableGauge '${name}' has not been created and registered yet.`);
+    }
+    return observableGauge;
+  }
+
+  public async start(): Promise<void> {
+    logger.info(
+      `
+Attention:
+PowerSync collects completely anonymous telemetry regarding usage.
+This information is used to shape our roadmap to better serve our customers.
+You can learn more, including how to opt-out if you'd not like to participate in this anonymous program, by visiting the following URL:
+https://docs.powersync.com/self-hosting/lifecycle-maintenance/telemetry
+    `.trim()
+    );
+    logger.info(`Anonymous telemetry is currently: ${this.options.disable_telemetry_sharing ? 'disabled' : 'enabled'}`);
+
+    logger.info('Successfully started Metrics Engine.');
+  }
+
+  public async shutdown(): Promise<void> {
+    logger.info('Successfully shut down Metrics Engine.');
+  }
+}

package/src/metrics/metrics-index.ts

@@ -0,0 +1,4 @@
+export * from './MetricsEngine.js';
+export * from './metrics-interfaces.js';
+export * from './open-telemetry/OpenTelemetryMetricsFactory.js';
+export * from './open-telemetry/util.js';

package/src/metrics/metrics-interfaces.ts

@@ -0,0 +1,41 @@
+export interface Counter {
+  /**
+   *  Increment the counter by the given value. Only positive numbers are valid.
+   *  @param value
+   */
+  add(value: number): void;
+}
+
+export interface UpDownCounter {
+  /**
+   *  Increment or decrement(if negative) the counter by the given value.
+   *  @param value
+   */
+  add(value: number): void;
+}
+
+export interface ObservableGauge {
+  /**
+   *  Set a value provider that provides the value for the gauge at the time of observation.
+   *  @param valueProvider
+   */
+  setValueProvider(valueProvider: () => Promise<number | undefined>): void;
+}
+
+export enum Precision {
+  INT = 'int',
+  DOUBLE = 'double'
+}
+
+export interface MetricMetadata {
+  name: string;
+  description?: string;
+  unit?: string;
+  precision?: Precision;
+}
+
+export interface MetricsFactory {
+  createCounter(metadata: MetricMetadata): Counter;
+  createUpDownCounter(metadata: MetricMetadata): UpDownCounter;
+  createObservableGauge(metadata: MetricMetadata): ObservableGauge;
+}

package/src/metrics/open-telemetry/OpenTelemetryMetricsFactory.ts

@@ -0,0 +1,66 @@
+import { Meter, ValueType } from '@opentelemetry/api';
+import {
+  Counter,
+  ObservableGauge,
+  UpDownCounter,
+  MetricMetadata,
+  MetricsFactory,
+  Precision
+} from '../metrics-interfaces.js';
+
+export class OpenTelemetryMetricsFactory implements MetricsFactory {
+  private meter: Meter;
+
+  constructor(meter: Meter) {
+    this.meter = meter;
+  }
+
+  createCounter(metadata: MetricMetadata): Counter {
+    return this.meter.createCounter(metadata.name, {
+      description: metadata.description,
+      unit: metadata.unit,
+      valueType: this.toValueType(metadata.precision)
+    });
+  }
+
+  createObservableGauge(metadata: MetricMetadata): ObservableGauge {
+    const gauge = this.meter.createObservableGauge(metadata.name, {
+      description: metadata.description,
+      unit: metadata.unit,
+      valueType: this.toValueType(metadata.precision)
+    });
+
+    return {
+      setValueProvider(valueProvider: () => Promise<number | undefined>) {
+        gauge.addCallback(async (result) => {
+          const value = await valueProvider();
+
+          if (value) {
+            result.observe(value);
+          }
+        });
+      }
+    };
+  }
+
+  createUpDownCounter(metadata: MetricMetadata): UpDownCounter {
+    return this.meter.createUpDownCounter(metadata.name, {
+      description: metadata.description,
+      unit: metadata.unit,
+      valueType: this.toValueType(metadata.precision)
+    });
+  }
+
+  private toValueType(precision?: Precision): ValueType {
+    if (!precision) {
+      return ValueType.INT;
+    }
+
+    switch (precision) {
+      case Precision.INT:
+        return ValueType.INT;
+      case Precision.DOUBLE:
+        return ValueType.DOUBLE;
+    }
+  }
+}

package/src/metrics/open-telemetry/util.ts

@@ -0,0 +1,74 @@
+import { MeterProvider, MetricReader, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
+import { env } from '../../util/env.js';
+import { PrometheusExporter } from '@opentelemetry/exporter-prometheus';
+import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';
+import { Resource } from '@opentelemetry/resources';
+import { ServiceContext } from '../../system/ServiceContext.js';
+import { OpenTelemetryMetricsFactory } from './OpenTelemetryMetricsFactory.js';
+import { MetricsFactory } from '../metrics-interfaces.js';
+
+export interface RuntimeMetadata {
+  [key: string]: string | number | undefined;
+}
+
+export function createOpenTelemetryMetricsFactory(context: ServiceContext): MetricsFactory {
+  const { configuration, lifeCycleEngine, storageEngine } = context;
+  const configuredExporters: MetricReader[] = [];
+
+  if (env.METRICS_PORT) {
+    const prometheusExporter = new PrometheusExporter({ port: env.METRICS_PORT, preventServerStart: true });
+    configuredExporters.push(prometheusExporter);
+
+    lifeCycleEngine.withLifecycle(prometheusExporter, {
+      start: () => prometheusExporter.startServer()
+    });
+  }
+
+  if (!configuration.telemetry.disable_telemetry_sharing) {
+    const periodicExporter = new PeriodicExportingMetricReader({
+      exporter: new OTLPMetricExporter({
+        url: configuration.telemetry.internal_service_endpoint
+      }),
+      exportIntervalMillis: 1000 * 60 * 5 // 5 minutes
+    });
+
+    configuredExporters.push(periodicExporter);
+  }
+
+  let resolvedMetadata: (metadata: RuntimeMetadata) => void;
+  const runtimeMetadata: Promise<RuntimeMetadata> = new Promise((resolve) => {
+    resolvedMetadata = resolve;
+  });
+
+  lifeCycleEngine.withLifecycle(null, {
+    start: async () => {
+      const bucketStorage = storageEngine.activeBucketStorage;
+      try {
+        const instanceId = await bucketStorage.getPowerSyncInstanceId();
+        resolvedMetadata({ ['instance_id']: instanceId });
+      } catch (err) {
+        resolvedMetadata({ ['instance_id']: 'Unknown' });
+      }
+    }
+  });
+
+  const meterProvider = new MeterProvider({
+    resource: new Resource(
+      {
+        ['service']: 'PowerSync'
+      },
+      runtimeMetadata
+    ),
+    readers: configuredExporters
+  });
+
+  lifeCycleEngine.withLifecycle(meterProvider, {
+    stop: async () => {
+      await meterProvider.shutdown();
+    }
+  });
+
+  const meter = meterProvider.getMeter('powersync');
+
+  return new OpenTelemetryMetricsFactory(meter);
+}

package/src/replication/AbstractReplicationJob.ts

@@ -2,10 +2,12 @@ import { container, logger } from '@powersync/lib-services-framework';
 import winston from 'winston';
 import * as storage from '../storage/storage-index.js';
 import { ErrorRateLimiter } from './ErrorRateLimiter.js';
+import { MetricsEngine } from '../metrics/MetricsEngine.js';
 
 export interface AbstractReplicationJobOptions {
   id: string;
   storage: storage.SyncRulesBucketStorage;
+  metrics: MetricsEngine;
   lock: storage.ReplicationLock;
   rateLimiter: ErrorRateLimiter;
 }

package/src/replication/AbstractReplicator.ts

@@ -7,6 +7,7 @@ import { SyncRulesProvider } from '../util/config/sync-rules/sync-rules-provider
 import { AbstractReplicationJob } from './AbstractReplicationJob.js';
 import { ErrorRateLimiter } from './ErrorRateLimiter.js';
 import { ConnectionTestResult } from './ReplicationModule.js';
+import { MetricsEngine } from '../metrics/MetricsEngine.js';
 
 // 5 minutes
 const PING_INTERVAL = 1_000_000_000n * 300n;
@@ -19,6 +20,7 @@ export interface CreateJobOptions {
 export interface AbstractReplicatorOptions {
   id: string;
   storageEngine: StorageEngine;
+  metricsEngine: MetricsEngine;
   syncRuleProvider: SyncRulesProvider;
   /**
    * This limits the effect of retries when there is a persistent issue.
@@ -33,6 +35,7 @@ export interface AbstractReplicatorOptions {
  */
 export abstract class AbstractReplicator<T extends AbstractReplicationJob = AbstractReplicationJob> {
   protected logger: winston.Logger;
+
   /**
    *  Map of replication jobs by sync rule id. Usually there is only one running job, but there could be two when
    *  transitioning to a new set of sync rules.
@@ -72,6 +75,10 @@ export abstract class AbstractReplicator<T extends AbstractReplicationJob = Abst
     return this.options.rateLimiter;
   }
 
+  protected get metrics() {
+    return this.options.metricsEngine;
+  }
+
   public async start(): Promise<void> {
     this.runLoop().catch((e) => {
       this.logger.error('Data source fatal replication error', e);

package/src/replication/ReplicationModule.ts

@@ -64,6 +64,14 @@ export abstract class ReplicationModule<TConfig extends DataSourceConfig>
    */
   protected abstract createReplicator(context: system.ServiceContext): AbstractReplicator;
 
+  /**
+   *  Any additional initialization specific to the module should be added here. Will be called if necessary after the
+   *  main initialization has been completed
+   *  @param context
+   *  @protected
+   */
+  protected abstract onInitialized(context: system.ServiceContext): Promise<void>;
+
   public abstract testConnection(config: TConfig): Promise<ConnectionTestResult>;
 
   /**
@@ -93,6 +101,8 @@ export abstract class ReplicationModule<TConfig extends DataSourceConfig>
 
     context.replicationEngine?.register(this.createReplicator(context));
     context.routerEngine?.registerAPI(this.createRouteAPIAdapter());
+
+    await this.onInitialized(context);
   }
 
   protected decodeConfig(config: TConfig): void {

package/src/replication/replication-index.ts

@@ -3,3 +3,4 @@ export * from './AbstractReplicator.js';
 export * from './ErrorRateLimiter.js';
 export * from './ReplicationEngine.js';
 export * from './ReplicationModule.js';
+export * from './replication-metrics.js';