@ms-cloudpack/data-bus 0.0.2 → 0.1.0

package/CHANGELOG.json

@@ -2,7 +2,52 @@
   "name": "@ms-cloudpack/data-bus",
   "entries": [
     {
-      "date": "Mon, 09 May 2022 18:54:32 GMT",
+      "date": "Fri, 12 Aug 2022 08:12:22 GMT",
+      "tag": "@ms-cloudpack/data-bus_v0.1.0",
+      "version": "0.1.0",
+      "comments": {
+        "minor": [
+          {
+            "author": "dzearing@microsoft.com",
+            "package": "@ms-cloudpack/data-bus",
+            "commit": "e733241cb555d1ae14cdfd8fe211d1d05b471e29",
+            "comment": "Providers can now be added to the root of the data tree."
+          }
+        ]
+      }
+    },
+    {
+      "date": "Fri, 20 May 2022 04:26:15 GMT",
+      "tag": "@ms-cloudpack/data-bus_v0.0.2",
+      "version": "0.0.2",
+      "comments": {
+        "none": [
+          {
+            "author": "dzearing@microsoft.com",
+            "package": "@ms-cloudpack/data-bus",
+            "commit": "b39bb143fc53e622c39f9e9fd349f71c9ebadd77",
+            "comment": "Adding api:update script."
+          }
+        ]
+      }
+    },
+    {
+      "date": "Sat, 14 May 2022 04:36:11 GMT",
+      "tag": "@ms-cloudpack/data-bus_v0.0.2",
+      "version": "0.0.2",
+      "comments": {
+        "none": [
+          {
+            "author": "dzearing@microsoft.com",
+            "package": "@ms-cloudpack/data-bus",
+            "commit": "cc0844a7d18790d69e59b16dbd6eef8fab5bc4e0",
+            "comment": "Updating package details."
+          }
+        ]
+      }
+    },
+    {
+      "date": "Mon, 09 May 2022 18:54:56 GMT",
       "tag": "@ms-cloudpack/data-bus_v0.0.2",
       "version": "0.0.2",
       "comments": {

package/CHANGELOG.md

@@ -1,12 +1,20 @@
 # Change Log - @ms-cloudpack/data-bus
 
-This log was last generated on Mon, 09 May 2022 18:54:32 GMT and should not be manually modified.
+This log was last generated on Fri, 12 Aug 2022 08:12:22 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## 0.1.0
+
+Fri, 12 Aug 2022 08:12:22 GMT
+
+### Minor changes
+
+- Providers can now be added to the root of the data tree. (dzearing@microsoft.com)
+
 ## 0.0.2
 
-Mon, 09 May 2022 18:54:32 GMT
+Mon, 09 May 2022 18:54:56 GMT
 
 ### Patches
 

package/README.md

@@ -28,7 +28,7 @@ export const bus = createDataBus();
 ### Subscribing to data
 
 The data bus provides a method `subscribe` for consumers to subscribe to different types of data. As that data changes, consumers will be notified of changes. Any number of consumers can subscribe for the same data. Data is
-heirarchical, so you can subscribe to a full branch, or to a leaf node within the tree. Paths are represented by
+hierarchical, so you can subscribe to a full branch, or to a leaf node within the tree. Paths are represented by
 string arrays.
 
 ```js

package/lib/addProvider.d.ts

@@ -0,0 +1,5 @@
+import type { DataBusState, DataBusProvider } from './types.js';
+/**
+ * Adds a provider.
+ */
+export declare function addProvider(state: DataBusState, provider: DataBusProvider): void;

package/lib/addProvider.js

@@ -0,0 +1,10 @@
+import { getNode } from './getNode.js';
+/**
+ * Adds a provider.
+ */
+export function addProvider(state, provider) {
+    const { node } = getNode(state, provider.path, true);
+    node.providers ?? (node.providers = []);
+    node.providers.push(provider);
+}
+//# sourceMappingURL=addProvider.js.map

package/lib/addProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addProvider.js","sourceRoot":"","sources":["../src/addProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAmB,EAAE,QAAyB;IACxE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAErD,IAAI,CAAC,SAAS,KAAd,IAAI,CAAC,SAAS,GAAK,EAAE,EAAC;IACtB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/lib/addProvider.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/addProvider.test.js

@@ -0,0 +1,58 @@
+import { jest } from '@jest/globals';
+import { addProvider } from './addProvider.js';
+import { publish } from './publish.js';
+import { subscribe } from './subscribe.js';
+import { createDataBus } from './createDataBus.js';
+const testBus = createDataBus();
+function getTestProvider(path) {
+    return {
+        path,
+        onActivate: jest.fn(),
+        onDeactivate: jest.fn(),
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        onPublish: jest.fn(),
+    };
+}
+describe('addProvider', () => {
+    it('can add a provider', () => {
+        const state = { root: {} };
+        const provider = getTestProvider(['a']);
+        addProvider(state, provider);
+        expect(state.root.children?.['a']?.providers).toContain(provider);
+    });
+    it('can have onActivate executed when a path is subscribed', () => {
+        const state = { root: {} };
+        const provider = getTestProvider(['a']);
+        const changeFn = jest.fn();
+        addProvider(state, provider);
+        subscribe(state, testBus, ['a'], changeFn);
+        expect(provider.onActivate).toBeCalledTimes(1);
+        subscribe(state, testBus, ['a'], changeFn);
+        expect(provider.onActivate).toBeCalledTimes(1);
+        expect(changeFn).not.toBeCalled();
+    });
+    it('can have onDeactivate executed when a path is unsubscribed', () => {
+        const state = { root: {} };
+        const provider = getTestProvider(['a']);
+        addProvider(state, provider);
+        const unsubscribe1 = subscribe(state, testBus, ['a'], jest.fn());
+        const unsubscribe2 = subscribe(state, testBus, ['a'], jest.fn());
+        expect(provider.onActivate).toBeCalled();
+        expect(provider.onDeactivate).not.toBeCalled();
+        unsubscribe1();
+        expect(provider.onDeactivate).not.toBeCalled();
+        unsubscribe2();
+        expect(provider.onDeactivate).toBeCalled();
+    });
+    it('can intercept publishing', () => {
+        const state = { root: {} };
+        const provider = getTestProvider(['a']);
+        const changeFn = jest.fn();
+        provider.onPublish = ({ value }) => 'new-' + value;
+        addProvider(state, provider);
+        subscribe(state, testBus, ['a'], changeFn);
+        publish(state, testBus, ['a'], 'test');
+        expect(changeFn.mock.calls).toEqual([['new-test', undefined, ['a']]]);
+    });
+});
+//# sourceMappingURL=addProvider.test.js.map

package/lib/addProvider.test.js.map

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

package/lib/createDataBus.d.ts

@@ -0,0 +1,5 @@
+import type { DataBus } from './types.js';
+/**
+ * Creates a new data bus instance.
+ */
+export declare function createDataBus(): DataBus;

package/lib/createDataBus.js

@@ -0,0 +1,23 @@
+import { addProvider } from './addProvider.js';
+import { createNode } from './createNode.js';
+import { getData } from './getData.js';
+import { publish } from './publish.js';
+import { subscribe } from './subscribe.js';
+/**
+ * Creates a new data bus instance.
+ */
+export function createDataBus() {
+    const state = {
+        root: createNode(),
+    };
+    const bus = {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        publish: (path, value) => publish(state, bus, path, value),
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        getData: (path) => getData(state, path),
+        subscribe: (path, change) => subscribe(state, bus, path, change),
+        addProvider: (provider) => addProvider(state, provider),
+    };
+    return bus;
+}
+//# sourceMappingURL=createDataBus.js.map

package/lib/createDataBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDataBus.js","sourceRoot":"","sources":["../src/createDataBus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAiB;QAC1B,IAAI,EAAE,UAAU,EAAE;KACnB,CAAC;IAEF,MAAM,GAAG,GAAG;QACV,8DAA8D;QAC9D,OAAO,EAAE,CAAC,IAAc,EAAE,KAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC;QAEzE,8DAA8D;QAC9D,OAAO,EAAE,CAAc,IAAc,EAAE,EAAE,CAAC,OAAO,CAAQ,KAAK,EAAE,IAAI,CAAC;QAErE,SAAS,EAAE,CAAC,IAAc,EAAE,MAA6B,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC;QAEjG,WAAW,EAAE,CAAC,QAAyB,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC;KACzE,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/createDataBus.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/createDataBus.test.js

@@ -0,0 +1,26 @@
+import { createDataBus } from './createDataBus.js';
+import { jest } from '@jest/globals';
+describe('createDataBus', () => {
+    it('can pub/sub using a root provider', () => {
+        const bus = createDataBus();
+        const provider = {
+            path: [],
+            onActivate: jest.fn(),
+            onDeactivate: jest.fn(),
+        };
+        // Register provider
+        bus.addProvider(provider);
+        // Set up subscription
+        const onNotify = jest.fn();
+        const dispose = bus.subscribe(['status'], onNotify);
+        // We have not received any published data.
+        expect(onNotify).toBeCalledTimes(0);
+        // Expect an activation from the root provider.
+        expect(provider.onActivate).toBeCalledTimes(1);
+        // Dispose the subscription.
+        dispose();
+        // Expect a deactivation from the root provider.
+        expect(provider.onDeactivate).toBeCalledTimes(1);
+    });
+});
+//# sourceMappingURL=createDataBus.test.js.map

package/lib/createDataBus.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDataBus.test.js","sourceRoot":"","sources":["../src/createDataBus.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,EAAE;YACR,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE;YACrB,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE;SACxB,CAAC;QAEF,oBAAoB;QACpB,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAE1B,sBAAsB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;QAEpD,2CAA2C;QAC3C,MAAM,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAEpC,+CAA+C;QAC/C,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAE/C,4BAA4B;QAC5B,OAAO,EAAE,CAAC;QAEV,gDAAgD;QAChD,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/createNode.d.ts

@@ -0,0 +1,2 @@
+import type { DataBusNode } from './types.js';
+export declare function createNode(name?: string): DataBusNode;

package/lib/createNode.js

@@ -0,0 +1,6 @@
+export function createNode(name = '') {
+    return {
+        name,
+    };
+}
+//# sourceMappingURL=createNode.js.map

package/lib/createNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNode.js","sourceRoot":"","sources":["../src/createNode.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,IAAI,GAAG,EAAE;IAClC,OAAO;QACL,IAAI;KACL,CAAC;AACJ,CAAC"}

package/lib/getData.d.ts

@@ -0,0 +1,5 @@
+import type { DataBusState } from './types.js';
+/**
+ * Gets data containing the corresponding props.
+ */
+export declare function getData<TData>(state: DataBusState, path: string[]): TData | undefined;

package/lib/getData.js

@@ -0,0 +1,9 @@
+import { getNode } from './getNode.js';
+/**
+ * Gets data containing the corresponding props.
+ */
+export function getData(state, path) {
+    const { node } = getNode(state, path);
+    return node?.value;
+}
+//# sourceMappingURL=getData.js.map

package/lib/getData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getData.js","sourceRoot":"","sources":["../src/getData.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,OAAO,CAAQ,KAAmB,EAAE,IAAc;IAChE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEtC,OAAO,IAAI,EAAE,KAAK,CAAC;AACrB,CAAC"}

package/lib/getData.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/getData.test.js

@@ -0,0 +1,33 @@
+import { getData } from './getData.js';
+const testState = {
+    root: {
+        name: '',
+        children: {
+            a: {
+                name: 'a',
+                value: 'a',
+                providers: [],
+                subscribers: new Set(),
+                children: {
+                    b: {
+                        name: 'b',
+                        value: 'b',
+                        providers: [],
+                        subscribers: new Set(),
+                        children: {},
+                    },
+                },
+            },
+        },
+    },
+};
+describe('getData', () => {
+    it('can get existing data', () => {
+        expect(getData(testState, ['a', 'b'])).toEqual('b');
+    });
+    it('returns undefined on missing data and does not create nodes', () => {
+        expect(getData(testState, ['a', 'b', 'c'])).toBeUndefined();
+        expect(testState.root.children?.['a']?.children?.['b']?.children?.['c']).toBeUndefined();
+    });
+});
+//# sourceMappingURL=getData.test.js.map

package/lib/getData.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getData.test.js","sourceRoot":"","sources":["../src/getData.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,SAAS,GAAiB;IAC9B,IAAI,EAAE;QACJ,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE;YACR,CAAC,EAAE;gBACD,IAAI,EAAE,GAAG;gBACT,KAAK,EAAE,GAAG;gBACV,SAAS,EAAE,EAAE;gBACb,WAAW,EAAE,IAAI,GAAG,EAAE;gBACtB,QAAQ,EAAE;oBACR,CAAC,EAAE;wBACD,IAAI,EAAE,GAAG;wBACT,KAAK,EAAE,GAAG;wBACV,SAAS,EAAE,EAAE;wBACb,WAAW,EAAE,IAAI,GAAG,EAAE;wBACtB,QAAQ,EAAE,EAAE;qBACb;iBACF;aACF;SACF;KACF;CACF,CAAC;AAEF,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC5D,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/getNode.d.ts

@@ -0,0 +1,9 @@
+import type { DataBusNode, DataBusState } from './types.js';
+export declare function getNode(state: DataBusState, path: string[]): {
+    node: DataBusNode;
+    nodePath: DataBusNode[];
+};
+export declare function getNode(state: DataBusState, path: string[], createPath: true): {
+    node: DataBusNode;
+    nodePath: DataBusNode[];
+};

package/lib/getNode.js

@@ -0,0 +1,20 @@
+import { createNode } from './createNode.js';
+export function getNode(state, path, createPath) {
+    let index = 0;
+    let node = state.root;
+    const nodePath = [state.root];
+    while (node && index < path.length) {
+        const pathName = path[index++];
+        if (!node.children?.[pathName] && createPath) {
+            node.children ?? (node.children = {});
+            node.children[pathName] = createNode(pathName);
+        }
+        node = node.children?.[pathName];
+        nodePath.push(node);
+    }
+    return {
+        node,
+        nodePath,
+    };
+}
+//# sourceMappingURL=getNode.js.map

package/lib/getNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNode.js","sourceRoot":"","sources":["../src/getNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAoB7C,MAAM,UAAU,OAAO,CACrB,KAAmB,EACnB,IAAc,EACd,UAAoB;IAKpB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,GAA4B,KAAK,CAAC,IAAI,CAAC;IAC/C,MAAM,QAAQ,GAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7C,OAAO,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAE/B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,UAAU,EAAE;YAC5C,IAAI,CAAC,QAAQ,KAAb,IAAI,CAAC,QAAQ,GAAK,EAAE,EAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;SAChD;QAED,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,IAAmB,CAAC,CAAC;KACpC;IAED,OAAO;QACL,IAAI;QACJ,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/lib/getNode.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/getNode.test.js

@@ -0,0 +1,42 @@
+import { getNode } from './getNode.js';
+function createTestState() {
+    return {
+        root: {
+            name: '',
+            children: {
+                a: {
+                    name: 'a',
+                    children: {
+                        b: {
+                            name: 'b',
+                        },
+                    },
+                },
+            },
+        },
+    };
+}
+describe('getNode', () => {
+    it('can return a node', () => {
+        const testState = createTestState();
+        const { node, nodePath } = getNode(testState, ['a', 'b']);
+        expect(node).toBeDefined();
+        expect(node.name).toEqual('b');
+        expect(nodePath).toEqual([
+            testState.root,
+            testState.root.children?.['a'],
+            testState.root.children?.['a'].children?.['b'],
+        ]);
+    });
+    it('can return undefined on missing path', () => {
+        const testState = createTestState();
+        expect(getNode(testState, ['a', 'c']).node).toBeUndefined();
+        expect(testState.root.children?.['a']?.children?.['c']).toBeUndefined();
+    });
+    it('can return undefined on missing path but create it when specified', () => {
+        const testState = createTestState();
+        expect(testState.root.children?.['a']?.children?.['c']).toBeUndefined();
+        expect(getNode(testState, ['a', 'c'], true).node).toBeTruthy();
+    });
+});
+//# sourceMappingURL=getNode.test.js.map

package/lib/getNode.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNode.test.js","sourceRoot":"","sources":["../src/getNode.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,SAAS,eAAe;IACtB,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,EAAE;YACR,QAAQ,EAAE;gBACR,CAAC,EAAE;oBACD,IAAI,EAAE,GAAG;oBACT,QAAQ,EAAE;wBACR,CAAC,EAAE;4BACD,IAAI,EAAE,GAAG;yBACV;qBACF;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;QACpC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAE1D,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,SAAS,CAAC,IAAI;YACd,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;QAEpC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;QAC5D,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;QAEpC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACxE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { createDataBus } from './createDataBus.js';
+export type { DataBus, DataBusChangeFunction, DataBusNode, DataBusProvider, DataBusState, DisposeFunction, } from './types.js';

package/lib/index.js

@@ -0,0 +1,2 @@
+export { createDataBus } from './createDataBus.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/publish.d.ts

@@ -0,0 +1,5 @@
+import type { DataBus, DataBusState } from './types.js';
+/**
+ * Publishes data to a given dataPath/Id.
+ */
+export declare function publish<TData>(state: DataBusState, bus: DataBus, path: string[], value: TData): void;

package/lib/publish.js

@@ -0,0 +1,23 @@
+import { getNode } from './getNode.js';
+/**
+ * Publishes data to a given dataPath/Id.
+ */
+export function publish(state, bus, path, value) {
+    const { node, nodePath } = getNode(state, path, true);
+    const oldValue = node.value;
+    // Notify pre-publishing providers and allow them to apply transforms or publish additional metadata.
+    for (let i = nodePath.length - 1; i >= 0; i--) {
+        nodePath[i].providers?.forEach((provider) => {
+            const newValue = provider.onPublish?.({ bus, value, oldValue, path });
+            if (newValue !== undefined) {
+                value = newValue;
+            }
+        });
+    }
+    node.value = value;
+    // Notify subscribers
+    for (let i = nodePath.length - 1; i >= 0; i--) {
+        nodePath[i].subscribers?.forEach((subscriber) => subscriber(value, oldValue, path));
+    }
+}
+//# sourceMappingURL=publish.js.map

package/lib/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../src/publish.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,OAAO,CAAQ,KAAmB,EAAE,GAAY,EAAE,IAAc,EAAE,KAAY;IAC5F,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;IAE5B,qGAAqG;IACrG,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7C,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAEtE,IAAI,QAAQ,KAAK,SAAS,EAAE;gBAC1B,KAAK,GAAG,QAAQ,CAAC;aAClB;QACH,CAAC,CAAC,CAAC;KACJ;IAED,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAEnB,qBAAqB;IACrB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7C,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;KACrF;AACH,CAAC"}

package/lib/publish.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/publish.test.js

@@ -0,0 +1,25 @@
+import { publish } from './publish.js';
+import { createDataBus } from './createDataBus.js';
+const testBus = createDataBus();
+describe('publish', () => {
+    it('can publish to an existing value', () => {
+        const state = {
+            root: {
+                children: {
+                    a: {
+                        name: 'a',
+                        value: 42,
+                    },
+                },
+            },
+        };
+        publish(state, testBus, ['a'], 43);
+        expect(state.root.children?.['a'].value).toEqual(43);
+    });
+    it('can publish to a non-existing value', () => {
+        const state = { root: {} };
+        publish(state, testBus, ['a'], 43);
+        expect(state.root.children?.['a'].value).toEqual(43);
+    });
+});
+//# sourceMappingURL=publish.test.js.map

package/lib/publish.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.test.js","sourceRoot":"","sources":["../src/publish.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAEhC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAiB;YAC1B,IAAI,EAAE;gBACJ,QAAQ,EAAE;oBACR,CAAC,EAAE;wBACD,IAAI,EAAE,GAAG;wBACT,KAAK,EAAE,EAAE;qBACV;iBACF;aACF;SACF,CAAC;QAEF,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAEnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,KAAK,GAAiB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAEzC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/subscribe.d.ts

@@ -0,0 +1,2 @@
+import type { DataBusState, DataBusChangeFunction, DisposeFunction, DataBus } from './types.js';
+export declare function subscribe(state: DataBusState, bus: DataBus, path: string[], change: DataBusChangeFunction): DisposeFunction;

package/lib/subscribe.js

@@ -0,0 +1,44 @@
+import { getNode } from './getNode.js';
+export function subscribe(state, bus, path, change) {
+    const { node, nodePath } = getNode(state, path, true);
+    const { value } = node;
+    const pathString = path.join('/');
+    node.subscribers ?? (node.subscribers = new Set());
+    node.subscribers.add(change);
+    // Fire the initial change with the value.
+    if (value !== undefined) {
+        change(value, value, path);
+    }
+    // Activate any deactivated providers available for this path.
+    for (let index = nodePath.length - 1; index >= 0; index--) {
+        const currentNode = nodePath[index];
+        if (currentNode.providers?.length) {
+            const activeProviders = (currentNode.activeProviders ?? (currentNode.activeProviders = {}));
+            currentNode.providers.forEach((provider) => {
+                activeProviders[pathString] ?? (activeProviders[pathString] = { provider, count: 0 });
+                if (activeProviders[pathString].count === 0) {
+                    provider.onActivate?.({ path, bus });
+                }
+                activeProviders[pathString].count++;
+            });
+        }
+    }
+    return () => {
+        node.subscribers?.delete(change);
+        // Deactivate providers.
+        for (let index = nodePath.length - 1; index >= 0; index--) {
+            const currentNode = nodePath[index];
+            if (currentNode.providers?.length) {
+                const activeRecord = currentNode.activeProviders?.[pathString];
+                if (activeRecord) {
+                    activeRecord.count--;
+                    if (!activeRecord.count) {
+                        activeRecord?.provider.onDeactivate?.({ path, bus });
+                        delete currentNode.activeProviders?.[pathString];
+                    }
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=subscribe.js.map

package/lib/subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../src/subscribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,UAAU,SAAS,CACvB,KAAmB,EACnB,GAAY,EACZ,IAAc,EACd,MAA6B;IAE7B,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAElC,IAAI,CAAC,WAAW,KAAhB,IAAI,CAAC,WAAW,GAAK,IAAI,GAAG,EAAyB,EAAC;IACtD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE7B,0CAA0C;IAC1C,IAAI,KAAK,KAAK,SAAS,EAAE;QACvB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;KAC5B;IAED,8DAA8D;IAC9D,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE;QACzD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEpC,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE;YACjC,MAAM,eAAe,GAAG,CAAC,WAAW,CAAC,eAAe,KAA3B,WAAW,CAAC,eAAe,GAAK,EAAE,EAAC,CAAC;YAE7D,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACzC,eAAe,CAAC,UAAU,MAA1B,eAAe,CAAC,UAAU,IAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,EAAC;gBAEvD,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC,KAAK,KAAK,CAAC,EAAE;oBAC3C,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;iBACtC;gBAED,eAAe,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC;YACtC,CAAC,CAAC,CAAC;SACJ;KACF;IAED,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAEjC,wBAAwB;QACxB,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE;YACzD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEpC,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE;gBACjC,MAAM,YAAY,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC,UAAU,CAAC,CAAC;gBAE/D,IAAI,YAAY,EAAE;oBAChB,YAAY,CAAC,KAAK,EAAE,CAAC;oBAErB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE;wBACvB,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;wBACrD,OAAO,WAAW,CAAC,eAAe,EAAE,CAAC,UAAU,CAAC,CAAC;qBAClD;iBACF;aACF;SACF;IACH,CAAC,CAAC;AACJ,CAAC"}

package/lib/subscribe.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/subscribe.test.js

@@ -0,0 +1,66 @@
+import { createDataBus } from './createDataBus.js';
+import { subscribe } from './subscribe.js';
+import { getNode } from './getNode.js';
+import { publish } from './publish.js';
+import { jest } from '@jest/globals';
+const testBus = createDataBus();
+const testFunction = jest.fn();
+describe('subscribe', () => {
+    it('can subscribe to missing data', () => {
+        const state = { root: {} };
+        subscribe(state, testBus, ['a', 'b'], testFunction);
+        expect(state.root.children?.['a']?.children?.['b']?.subscribers?.has(testFunction)).toBeTruthy();
+    });
+    it('can subscribe to existing data', () => {
+        const state = { root: {} };
+        // initialize nodes.
+        getNode(state, ['a', 'b'], true);
+        subscribe(state, testBus, ['a', 'b'], testFunction);
+        expect(state.root.children?.['a']?.children?.['b'].subscribers?.has(testFunction)).toBeTruthy();
+    });
+    it('is idempotent', () => {
+        const state = { root: {} };
+        subscribe(state, testBus, ['a', 'b'], testFunction);
+        subscribe(state, testBus, ['a', 'b'], testFunction);
+        expect(state.root.children?.['a']?.children?.['b'].subscribers?.size).toEqual(1);
+    });
+    it('does not fire a change when data is unavailable', () => {
+        const state = { root: {} };
+        const mockFunction = jest.fn();
+        subscribe(state, testBus, ['a', 'b'], mockFunction);
+        expect(mockFunction).toBeCalledTimes(0);
+    });
+    it('fires a change when data is available', () => {
+        const state = { root: {} };
+        const mockFunction = jest.fn();
+        publish(state, testBus, ['a', 'b'], 42);
+        subscribe(state, testBus, ['a', 'b'], mockFunction);
+        expect(mockFunction).toBeCalledTimes(1);
+    });
+    it('fires a change when data becomes available', () => {
+        const state = { root: {} };
+        const mockFunction = jest.fn();
+        subscribe(state, testBus, ['a', 'b'], mockFunction);
+        expect(mockFunction).toBeCalledTimes(0);
+        publish(state, testBus, ['a', 'b'], 42);
+        expect(mockFunction).toBeCalledTimes(1);
+    });
+    it('can subscribe to nested data', () => {
+        const state = { root: {} };
+        const mockFunction = jest.fn();
+        subscribe(state, testBus, ['a'], mockFunction);
+        expect(mockFunction).toBeCalledTimes(0);
+        publish(state, testBus, ['a', 'b'], 42);
+        expect(mockFunction).toBeCalledTimes(1);
+        expect(mockFunction.mock.calls[0]).toEqual([42, undefined, ['a', 'b']]);
+    });
+    it('can unsubscribe', () => {
+        const state = { root: {} };
+        const mockFunction = jest.fn();
+        const unsubscribe = subscribe(state, testBus, ['a', 'b'], mockFunction);
+        unsubscribe();
+        publish(state, testBus, ['a', 'b'], 42);
+        expect(mockFunction).toBeCalledTimes(0);
+    });
+});
+//# sourceMappingURL=subscribe.test.js.map

package/lib/subscribe.test.js.map

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

package/lib/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.29.0"
+    }
+  ]
+}

package/lib/types.d.ts

@@ -0,0 +1,39 @@
+export declare type DataBusChangeFunction = <TData>(value: TData, oldValue: TData, path: string[]) => void;
+export declare type DisposeFunction = () => void;
+export interface DataBusProvider<TData = any> {
+    path: string[];
+    onActivate?: (options: {
+        path: string[];
+        bus: DataBus;
+    }) => void;
+    onDeactivate?: (options: {
+        path: string[];
+        bus: DataBus;
+    }) => void;
+    onPublish?: (options: {
+        value: TData;
+        oldValue: TData;
+        path: string[];
+        bus: DataBus;
+    }) => TData | undefined;
+}
+export interface DataBusNode {
+    name?: string;
+    value?: any;
+    providers?: DataBusProvider[];
+    activeProviders?: Record<string, {
+        provider: DataBusProvider;
+        count: number;
+    }>;
+    subscribers?: Set<DataBusChangeFunction>;
+    children?: Record<string, DataBusNode>;
+}
+export interface DataBusState {
+    root: DataBusNode;
+}
+export interface DataBus {
+    publish: (path: string[], value: any) => void;
+    subscribe: (path: string[], callback: DataBusChangeFunction) => DisposeFunction;
+    getData: (path: string[]) => any;
+    addProvider: (provider: DataBusProvider) => void;
+}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@ms-cloudpack/data-bus",
-  "version": "0.0.2",
-  "description": "",
+  "version": "0.1.0",
+  "description": "A data bus implementation.",
+  "license": "MIT",
   "type": "module",
   "types": "./lib/index.js",
   "sideEffects": false,
@@ -12,12 +13,15 @@
     }
   },
   "scripts": {
-    "build": "just-scripts build",
-    "build:watch": "just-scripts build:watch",
-    "lint": "just-scripts lint",
-    "lint:fix": "just-scripts lint:fix",
-    "test": "just-scripts test",
-    "test:watch": "just-scripts test:watch"
+    "api:update": "cloudpack-scripts api-update",
+    "api": "cloudpack-scripts api",
+    "build:watch": "cloudpack-scripts build-watch",
+    "build": "cloudpack-scripts build",
+    "lint:update": "cloudpack-scripts lint-update",
+    "lint": "cloudpack-scripts lint",
+    "test:update": "cloudpack-scripts test-update",
+    "test:watch": "cloudpack-scripts test-watch",
+    "test": "cloudpack-scripts test"
   },
   "devDependencies": {
     "@ms-cloudpack/scripts": "*",