@powersync/common 0.0.0-dev-20260202160933 → 0.0.0-dev-20260202163643

package/lib/utils/MetaBaseObserver.d.ts

@@ -0,0 +1,29 @@
+import { BaseListener, BaseObserver, BaseObserverInterface } from './BaseObserver.js';
+/**
+ * Represents the counts of listeners for each event type in a BaseListener.
+ */
+export type ListenerCounts<Listener extends BaseListener> = Partial<Record<keyof Listener, number>> & {
+    total: number;
+};
+/**
+ * Meta listener which reports the counts of listeners for each event type.
+ */
+export interface MetaListener<ParentListener extends BaseListener> extends BaseListener {
+    listenersChanged?: (counts: ListenerCounts<ParentListener>) => void;
+}
+export interface ListenerMetaManager<Listener extends BaseListener> extends BaseObserverInterface<MetaListener<Listener>> {
+    counts: ListenerCounts<Listener>;
+}
+export interface MetaBaseObserverInterface<Listener extends BaseListener> extends BaseObserverInterface<Listener> {
+    listenerMeta: ListenerMetaManager<Listener>;
+}
+/**
+ * A BaseObserver that tracks the counts of listeners for each event type.
+ */
+export declare class MetaBaseObserver<Listener extends BaseListener> extends BaseObserver<Listener> implements MetaBaseObserverInterface<Listener> {
+    protected get listenerCounts(): ListenerCounts<Listener>;
+    get listenerMeta(): ListenerMetaManager<Listener>;
+    protected metaListener: BaseObserver<MetaListener<Listener>>;
+    constructor();
+    registerListener(listener: Partial<Listener>): () => void;
+}

package/lib/utils/MetaBaseObserver.js

@@ -0,0 +1,51 @@
+import { BaseObserver } from './BaseObserver.js';
+/**
+ * A BaseObserver that tracks the counts of listeners for each event type.
+ */
+export class MetaBaseObserver extends BaseObserver {
+    get listenerCounts() {
+        const counts = {};
+        let total = 0;
+        for (const listener of this.listeners) {
+            for (const key in listener) {
+                if (listener[key]) {
+                    counts[key] = (counts[key] ?? 0) + 1;
+                    total++;
+                }
+            }
+        }
+        return {
+            ...counts,
+            total
+        };
+    }
+    get listenerMeta() {
+        return {
+            counts: this.listenerCounts,
+            // Allows registering a meta listener that will be notified of changes in listener counts
+            registerListener: (listener) => {
+                return this.metaListener.registerListener(listener);
+            }
+        };
+    }
+    metaListener;
+    constructor() {
+        super();
+        this.metaListener = new BaseObserver();
+    }
+    registerListener(listener) {
+        const dispose = super.registerListener(listener);
+        const updatedCount = this.listenerCounts;
+        this.metaListener.iterateListeners((l) => {
+            l.listenersChanged?.(updatedCount);
+        });
+        return () => {
+            dispose();
+            const updatedCount = this.listenerCounts;
+            this.metaListener.iterateListeners((l) => {
+                l.listenersChanged?.(updatedCount);
+            });
+        };
+    }
+}
+//# sourceMappingURL=MetaBaseObserver.js.map

package/lib/utils/MetaBaseObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaBaseObserver.js","sourceRoot":"","sources":["../../src/utils/MetaBaseObserver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,YAAY,EAAyB,MAAM,mBAAmB,CAAC;AAyBtF;;GAEG;AACH,MAAM,OAAO,gBACX,SAAQ,YAAsB;IAG9B,IAAc,cAAc;QAC1B,MAAM,MAAM,GAAG,EAA6C,CAAC;QAC7D,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;oBACrC,KAAK,EAAE,CAAC;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO;YACL,GAAG,MAAM;YACT,KAAK;SACN,CAAC;IACJ,CAAC;IAED,IAAI,YAAY;QACd,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,cAAc;YAC3B,yFAAyF;YACzF,gBAAgB,EAAE,CAAC,QAAyC,EAAE,EAAE;gBAC9D,OAAO,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACtD,CAAC;SACF,CAAC;IACJ,CAAC;IAES,YAAY,CAAuC;IAE7D;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,EAA0B,CAAC;IACjE,CAAC;IAED,gBAAgB,CAAC,QAA2B;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC;QACzC,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE;YACvC,CAAC,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,OAAO,EAAE,CAAC;YACV,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE;gBACvC,CAAC,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;CACF"}

package/lib/utils/async.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A ponyfill for `Symbol.asyncIterator` that is compatible with the
+ * [recommended polyfill](https://github.com/Azure/azure-sdk-for-js/blob/%40azure/core-asynciterator-polyfill_1.0.2/sdk/core/core-asynciterator-polyfill/src/index.ts#L4-L6)
+ * we recommend for React Native.
+ *
+ * As long as we use this symbol (instead of `for await` and `async *`) in this package, we can be compatible with async
+ * iterators without requiring them.
+ */
+export declare const symbolAsyncIterator: typeof Symbol.asyncIterator;
+/**
+ * Throttle a function to be called at most once every "wait" milliseconds,
+ * on the trailing edge.
+ *
+ * Roughly equivalent to lodash/throttle with {leading: false, trailing: true}
+ */
+export declare function throttleTrailing(func: () => void, wait: number): () => void;
+/**
+ * Throttle a function to be called at most once every "wait" milliseconds,
+ * on the leading and trailing edge.
+ *
+ * Roughly equivalent to lodash/throttle with {leading: true, trailing: true}
+ */
+export declare function throttleLeadingTrailing(func: () => void, wait: number): () => void;

package/lib/utils/async.js

@@ -0,0 +1,55 @@
+/**
+ * A ponyfill for `Symbol.asyncIterator` that is compatible with the
+ * [recommended polyfill](https://github.com/Azure/azure-sdk-for-js/blob/%40azure/core-asynciterator-polyfill_1.0.2/sdk/core/core-asynciterator-polyfill/src/index.ts#L4-L6)
+ * we recommend for React Native.
+ *
+ * As long as we use this symbol (instead of `for await` and `async *`) in this package, we can be compatible with async
+ * iterators without requiring them.
+ */
+export const symbolAsyncIterator = Symbol.asyncIterator ?? Symbol.for('Symbol.asyncIterator');
+/**
+ * Throttle a function to be called at most once every "wait" milliseconds,
+ * on the trailing edge.
+ *
+ * Roughly equivalent to lodash/throttle with {leading: false, trailing: true}
+ */
+export function throttleTrailing(func, wait) {
+    let timeoutId = null;
+    const later = () => {
+        func();
+        timeoutId = null;
+    };
+    return function () {
+        if (timeoutId == null) {
+            timeoutId = setTimeout(later, wait);
+        }
+    };
+}
+/**
+ * Throttle a function to be called at most once every "wait" milliseconds,
+ * on the leading and trailing edge.
+ *
+ * Roughly equivalent to lodash/throttle with {leading: true, trailing: true}
+ */
+export function throttleLeadingTrailing(func, wait) {
+    let timeoutId = null;
+    let lastCallTime = 0;
+    const invokeFunction = () => {
+        func();
+        lastCallTime = Date.now();
+        timeoutId = null;
+    };
+    return function () {
+        const now = Date.now();
+        const timeToWait = wait - (now - lastCallTime);
+        if (timeToWait <= 0) {
+            // Leading edge: Call the function immediately if enough time has passed
+            invokeFunction();
+        }
+        else if (!timeoutId) {
+            // Set a timeout for the trailing edge if not already set
+            timeoutId = setTimeout(invokeFunction, timeToWait);
+        }
+    };
+}
+//# sourceMappingURL=async.js.map

package/lib/utils/async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.js","sourceRoot":"","sources":["../../src/utils/async.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,IAAY;IAC7D,IAAI,SAAS,GAAyC,IAAI,CAAC;IAE3D,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,EAAE,CAAC;QACP,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAgB,EAAE,IAAY;IACpE,IAAI,SAAS,GAAyC,IAAI,CAAC;IAC3D,IAAI,YAAY,GAAW,CAAC,CAAC;IAE7B,MAAM,cAAc,GAAG,GAAG,EAAE;QAC1B,IAAI,EAAE,CAAC;QACP,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC;QAE/C,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,wEAAwE;YACxE,cAAc,EAAE,CAAC;QACnB,CAAC;aAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACtB,yDAAyD;YACzD,SAAS,GAAG,UAAU,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/lib/utils/mutex.d.ts

@@ -0,0 +1,7 @@
+import { Mutex } from 'async-mutex';
+/**
+ * Wrapper for async-mutex runExclusive, which allows for a timeout on each exclusive lock.
+ */
+export declare function mutexRunExclusive<T>(mutex: Mutex, callback: () => Promise<T>, options?: {
+    timeoutMs?: number;
+}): Promise<T>;

package/lib/utils/mutex.js

@@ -0,0 +1,29 @@
+/**
+ * Wrapper for async-mutex runExclusive, which allows for a timeout on each exclusive lock.
+ */
+export async function mutexRunExclusive(mutex, callback, options) {
+    return new Promise((resolve, reject) => {
+        const timeout = options?.timeoutMs;
+        let timedOut = false;
+        const timeoutId = timeout
+            ? setTimeout(() => {
+                timedOut = true;
+                reject(new Error('Timeout waiting for lock'));
+            }, timeout)
+            : undefined;
+        mutex.runExclusive(async () => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            if (timedOut)
+                return;
+            try {
+                resolve(await callback());
+            }
+            catch (ex) {
+                reject(ex);
+            }
+        });
+    });
+}
+//# sourceMappingURL=mutex.js.map

package/lib/utils/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../src/utils/mutex.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAY,EACZ,QAA0B,EAC1B,OAAgC;IAEhC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,OAAO,EAAE,SAAS,CAAC;QACnC,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,SAAS,GAAG,OAAO;YACvB,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;gBACd,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;YAChD,CAAC,EAAE,OAAO,CAAC;YACb,CAAC,CAAC,SAAS,CAAC;QAEd,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,QAAQ;gBAAE,OAAO;YAErB,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,EAAE,EAAE,CAAC;gBACZ,MAAM,CAAC,EAAE,CAAC,CAAC;YACb,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/utils/parseQuery.d.ts

@@ -0,0 +1,6 @@
+import type { CompilableQuery } from '../types/types.js';
+export interface ParsedQuery {
+    sqlStatement: string;
+    parameters: any[];
+}
+export declare const parseQuery: <T>(query: string | CompilableQuery<T>, parameters: any[]) => ParsedQuery;

package/lib/utils/parseQuery.js

@@ -0,0 +1,17 @@
+export const parseQuery = (query, parameters) => {
+    let sqlStatement;
+    if (typeof query == 'string') {
+        sqlStatement = query;
+    }
+    else {
+        const hasAdditionalParameters = parameters.length > 0;
+        if (hasAdditionalParameters) {
+            throw new Error('You cannot pass parameters to a compiled query.');
+        }
+        const compiled = query.compile();
+        sqlStatement = compiled.sql;
+        parameters = compiled.parameters;
+    }
+    return { sqlStatement, parameters: parameters };
+};
+//# sourceMappingURL=parseQuery.js.map

package/lib/utils/parseQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseQuery.js","sourceRoot":"","sources":["../../src/utils/parseQuery.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,KAAkC,EAAE,UAAiB,EAAe,EAAE;IAClG,IAAI,YAAoB,CAAC;IAEzB,IAAI,OAAO,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,YAAY,GAAG,KAAK,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,MAAM,uBAAuB,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACtD,IAAI,uBAAuB,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACjC,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC;QAC5B,UAAU,GAAG,QAAQ,CAAC,UAAmB,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AAClD,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powersync/common",
-  "version": "0.0.0-dev-20260202160933",
+  "version": "0.0.0-dev-20260202163643",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"