@powerhousedao/analytics-engine-core 0.3.1 → 0.4.0

package/dist/AnalyticsPath.d.ts

@@ -3,6 +3,7 @@ export declare class AnalyticsPath {
     get segments(): AnalyticsPathSegment[];
     private _segments;
     static fromString(path: string): AnalyticsPath;
+    static fromStringArray(segments: string[]): AnalyticsPath;
     static fromArray(segments: AnalyticsPathSegment[]): AnalyticsPath;
     static fromJSON(json: any): AnalyticsPath;
     constructor(segments: AnalyticsPathSegment[]);

package/dist/AnalyticsPath.js

@@ -8,6 +8,9 @@ export class AnalyticsPath {
         const segments = parseSeparatedList(path, "/").map((segment) => AnalyticsPathSegment.fromString(segment));
         return new AnalyticsPath(segments);
     }
+    static fromStringArray(segments) {
+        return new AnalyticsPath(segments.map((segment) => AnalyticsPathSegment.fromString(segment)));
+    }
     static fromArray(segments) {
         return new AnalyticsPath(segments);
     }

package/dist/AnalyticsPath.js.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsPath.js","sourceRoot":"","sources":["../src/AnalyticsPath.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AnalyticsPath.js","sourceRoot":"","sources":["../src/AnalyticsPath.ts"],"names":[],"mappings":"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"}

package/dist/AnalyticsSubscriptionManager.d.ts

@@ -0,0 +1,47 @@
+import { AnalyticsPath } from "./AnalyticsPath.js";
+import { AnalyticsUpdateCallback } from "./IAnalyticsStore.js";
+export declare class NotificationError extends Error {
+    readonly innerErrors: Error[];
+    constructor(errors: Error[]);
+}
+/**
+ * Manages subscriptions for analytics paths.
+ */
+export declare class AnalyticsSubscriptionManager {
+    private _subscriptions;
+    /**
+     * Subscribe to updates for an analytics path. A subscribed function will be
+     * called for:
+     *
+     * - exact path matches
+     * - matching child paths (i.e. an update to /a/b/c will trigger a callback
+     *   for /a/b/c, /a/b, and /a)
+     * - wildcard matches
+     *
+     * @param path The analytics path to subscribe to.
+     * @param callback Function to be called when the path is updated.
+     *
+     * @returns A function that, when called, unsubscribes from the updates.
+     */
+    subscribeToPath(path: AnalyticsPath, callback: AnalyticsUpdateCallback): () => void;
+    /**
+     * Notifies subscribers about updates to paths.
+     *
+     * @param paths The paths that were updated.
+     */
+    notifySubscribers(paths: AnalyticsPath[]): void;
+    /**
+     * Normalizes a path string to ensure consistent comparison.
+     */
+    private normalizePath;
+    /**
+     * Checks if a path matches a subscription pattern that may contain wildcards.
+     */
+    private pathMatchesWildcardPattern;
+    /**
+     * Gets all path prefixes for a given path.
+     *
+     * For example, for '/a/b/c' it returns ['/a', '/a/b', '/a/b/c'].
+     */
+    private getPathPrefixes;
+}

package/dist/AnalyticsSubscriptionManager.js

@@ -0,0 +1,161 @@
+export class NotificationError extends Error {
+    innerErrors;
+    constructor(errors) {
+        super(errors.map((e) => e.message).join("\n"));
+        this.name = "NotificationError";
+        this.innerErrors = errors;
+    }
+}
+/**
+ * Manages subscriptions for analytics paths.
+ */
+export class AnalyticsSubscriptionManager {
+    _subscriptions = new Map();
+    /**
+     * Subscribe to updates for an analytics path. A subscribed function will be
+     * called for:
+     *
+     * - exact path matches
+     * - matching child paths (i.e. an update to /a/b/c will trigger a callback
+     *   for /a/b/c, /a/b, and /a)
+     * - wildcard matches
+     *
+     * @param path The analytics path to subscribe to.
+     * @param callback Function to be called when the path is updated.
+     *
+     * @returns A function that, when called, unsubscribes from the updates.
+     */
+    subscribeToPath(path, callback) {
+        const pathString = this.normalizePath(path.toString("/"));
+        if (!this._subscriptions.has(pathString)) {
+            this._subscriptions.set(pathString, new Set());
+        }
+        this._subscriptions.get(pathString).add(callback);
+        return () => {
+            const callbacks = this._subscriptions.get(pathString);
+            if (callbacks) {
+                callbacks.delete(callback);
+                // only remove the path entry if there are no more callbacks
+                if (callbacks.size === 0) {
+                    this._subscriptions.delete(pathString);
+                }
+            }
+        };
+    }
+    /**
+     * Notifies subscribers about updates to paths.
+     *
+     * @param paths The paths that were updated.
+     */
+    notifySubscribers(paths) {
+        if (paths.length === 0 || this._subscriptions.size === 0) {
+            return;
+        }
+        const errors = [];
+        for (const path of paths) {
+            const pathString = this.normalizePath(path.toString("/"));
+            const pathPrefixes = this.getPathPrefixes(pathString);
+            const matchingSubscriptions = [];
+            // add the exact prefix matches
+            pathPrefixes
+                .filter((prefix) => this._subscriptions.has(prefix))
+                .forEach((prefix) => {
+                matchingSubscriptions.push({
+                    prefix,
+                    callbacks: this._subscriptions.get(prefix),
+                });
+            });
+            // check all wildcard patterns
+            for (const [subscriptionPath, callbacks,] of this._subscriptions.entries()) {
+                // skip if it's already in the exact matches
+                if (pathPrefixes.includes(subscriptionPath)) {
+                    continue;
+                }
+                // hceck if this subscription path (which might have wildcards) matches the update path
+                if (this.pathMatchesWildcardPattern(pathString, subscriptionPath)) {
+                    matchingSubscriptions.push({
+                        prefix: subscriptionPath,
+                        callbacks,
+                    });
+                }
+            }
+            if (matchingSubscriptions.length === 0)
+                continue;
+            // guarantee delivery to all subscribers
+            for (const { callbacks } of matchingSubscriptions) {
+                for (const callback of callbacks) {
+                    try {
+                        callback(path);
+                    }
+                    catch (e) {
+                        errors.push(e);
+                    }
+                }
+            }
+        }
+        if (errors.length > 0) {
+            throw new NotificationError(errors);
+        }
+    }
+    /**
+     * Normalizes a path string to ensure consistent comparison.
+     */
+    normalizePath(path) {
+        // Handle potential double slashes by first splitting on slashes and rejoining
+        const parts = path.split("/").filter((p) => p.length > 0);
+        let normalized = "/" + parts.join("/");
+        return normalized;
+    }
+    /**
+     * Checks if a path matches a subscription pattern that may contain wildcards.
+     */
+    pathMatchesWildcardPattern(updatePath, subscriptionPath) {
+        // Handle the wildcard segment case
+        if (subscriptionPath.includes("*")) {
+            const updateSegments = updatePath.split("/").filter((s) => s.length > 0);
+            const subscriptionSegments = subscriptionPath
+                .split("/")
+                .filter((s) => s.length > 0);
+            // If subscription is longer than the update path, it can't match
+            if (subscriptionSegments.length > updateSegments.length) {
+                return false;
+            }
+            // Compare each segment
+            for (let i = 0; i < subscriptionSegments.length; i++) {
+                const subSegment = subscriptionSegments[i];
+                const updateSegment = updateSegments[i];
+                // If segment is * or starts with * (wildcard), it matches anything
+                if (subSegment === "*" || subSegment.startsWith("*:")) {
+                    continue;
+                }
+                // Otherwise, segments should match exactly
+                if (subSegment !== updateSegment) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        // If no wildcards, check if subscription is a prefix of the update path
+        return (updatePath === subscriptionPath ||
+            updatePath.startsWith(subscriptionPath + "/"));
+    }
+    /**
+     * Gets all path prefixes for a given path.
+     *
+     * For example, for '/a/b/c' it returns ['/a', '/a/b', '/a/b/c'].
+     */
+    getPathPrefixes(path) {
+        const segments = path.split("/").filter((s) => s.length > 0);
+        const prefixes = [];
+        let currentPath = "";
+        for (const segment of segments) {
+            currentPath = currentPath ? `${currentPath}/${segment}` : `/${segment}`;
+            prefixes.push(currentPath);
+        }
+        if (prefixes.length === 0 && path === "/") {
+            prefixes.push("/");
+        }
+        return prefixes;
+    }
+}
+//# sourceMappingURL=AnalyticsSubscriptionManager.js.map

package/dist/AnalyticsSubscriptionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsSubscriptionManager.js","sourceRoot":"","sources":["../src/AnalyticsSubscriptionManager.ts"],"names":[],"mappings":"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"}

package/dist/IAnalyticsStore.d.ts

@@ -13,6 +13,7 @@ export type AnalyticsSeriesInput = {
     dimensions: Record<string, AnalyticsPath>;
     dimensionMetadata?: Record<string, string>;
 };
+export type AnalyticsUpdateCallback = (source: AnalyticsPath) => void;
 export interface IAnalyticsStore {
     clearSeriesBySource: (source: AnalyticsPath, cleanUpDimensions?: boolean) => Promise<number>;
     clearEmptyAnalyticsDimensions: () => Promise<number>;
@@ -20,4 +21,5 @@ export interface IAnalyticsStore {
     addSeriesValue: (input: AnalyticsSeriesInput) => Promise<void>;
     addSeriesValues: (inputs: AnalyticsSeriesInput[]) => Promise<void>;
     getDimensions: () => Promise<any>;
+    subscribeToSource: (source: AnalyticsPath, callback: AnalyticsUpdateCallback) => () => void;
 }

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 export type { IAnalyticsProfiler } from "./AnalyticsProfiler.js";
 export { AnalyticsProfiler, PassthroughAnalyticsProfiler, } from "./AnalyticsProfiler.js";
-export type { IAnalyticsStore, AnalyticsSeriesInput, } from "./IAnalyticsStore.js";
+export type { IAnalyticsStore, AnalyticsSeriesInput, AnalyticsUpdateCallback, } from "./IAnalyticsStore.js";
 export { AnalyticsPath, AnalyticsPathSegment } from "./AnalyticsPath.js";
 export type { AnalyticsQuery, AnalyticsSeriesQuery, AnalyticsSeries, AnalyticsDimension, } from "./AnalyticsQuery.js";
 export { AnalyticsGranularity } from "./AnalyticsQuery.js";
 export { AnalyticsQueryEngine } from "./AnalyticsQueryEngine.js";
 export type { GroupedPeriodResult, GroupedPeriodResults, } from "./AnalyticsDiscretizer.js";
 export { AnalyticsSerializerTypes, AnalyticsPeriod, } from "./AnalyticsPeriod.js";
+export * from "./AnalyticsSubscriptionManager.js";

package/dist/index.js

@@ -3,4 +3,5 @@ export { AnalyticsPath, AnalyticsPathSegment } from "./AnalyticsPath.js";
 export { AnalyticsGranularity } from "./AnalyticsQuery.js";
 export { AnalyticsQueryEngine } from "./AnalyticsQueryEngine.js";
 export { AnalyticsSerializerTypes, AnalyticsPeriod, } from "./AnalyticsPeriod.js";
+export * from "./AnalyticsSubscriptionManager.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAOzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,EACL,wBAAwB,EACxB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAOzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,EACL,wBAAwB,EACxB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,cAAc,mCAAmC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/analytics-engine-core",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "license": "AGPL-3.0-only",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",