@adobe/data 0.1.2

package/observe/observe.test.js

@@ -0,0 +1,417 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { assert } from "riteway/vitest";
+import { describe, test } from "vitest";
+import { createObservableState, fromConstant, fromArray, fromProperties, fromPromise, fromPromiseWithError, withCache, withDeduplicate, withDefault, withMap, withOptional, } from "./index.js";
+import { toProperties } from "./to-properties.js";
+import { withAsyncMap } from "./with-async-map.js";
+function createTestObservable(sync, async) {
+    const observers = new Set();
+    const observe = (observer) => {
+        observers.add(observer);
+        if (sync !== undefined) {
+            observer(sync);
+        }
+        return () => {
+            observers.delete(observer);
+        };
+    };
+    return [
+        observe,
+        async () => {
+            for (const value of async) {
+                await Promise.resolve();
+                for (const observer of observers) {
+                    observer(value);
+                }
+            }
+        },
+    ];
+}
+async function testObserver(props) {
+    const { given, expected, observable: observer, doAsync } = props;
+    const actual = { sync: undefined, async: [] };
+    let isSync = true;
+    const unobserve = observer((value) => {
+        if (isSync) {
+            actual.sync = value;
+        }
+        else {
+            actual.async.push(value);
+        }
+    });
+    isSync = false;
+    await doAsync();
+    unobserve();
+    assert({
+        given,
+        should: `observe ${JSON.stringify(expected)}`,
+        actual,
+        expected,
+    });
+}
+export async function testObservableFilter(props) {
+    const { given, input, filter, output } = props;
+    const [observer, done] = createTestObservable(input[0], input[1]);
+    const filtered = filter(observer);
+    await testObserver({
+        given,
+        expected: {
+            sync: output[0],
+            async: output[1],
+        },
+        observable: filtered,
+        doAsync: done,
+    });
+}
+describe("observable", () => {
+    test("createTestObservable", async () => {
+        const [observer, done] = createTestObservable(1, [2, 3]);
+        await testObserver({
+            given: "createTestObservable",
+            expected: {
+                sync: 1,
+                async: [2, 3],
+            },
+            observable: observer,
+            doAsync: done,
+        });
+    });
+    test("fromConstant", async () => {
+        await testObserver({
+            given: "fromConstant",
+            expected: {
+                sync: 1,
+                async: [],
+            },
+            observable: fromConstant(1),
+            doAsync: () => Promise.resolve(),
+        });
+    });
+    test("withOptional", async () => {
+        const observable = withOptional(fromPromise(() => Promise.resolve(1)));
+        //  manually test that we DO get a sync value callback.
+        {
+            let syncCallback = false;
+            let syncValue;
+            observable((value) => {
+                syncValue = value;
+                syncCallback = true;
+            })();
+            assert({
+                given: "withOptional",
+                should: "get a sync value callback",
+                actual: [syncCallback, syncValue],
+                expected: [true, undefined],
+            });
+        }
+        await testObserver({
+            given: "fromOptional",
+            expected: {
+                sync: undefined,
+                async: [1],
+            },
+            observable,
+            doAsync: () => Promise.resolve(),
+        });
+    });
+    test("fromObservableProperties sync", async () => {
+        const observable = fromProperties({
+            a: fromConstant(1),
+            b: fromConstant(2),
+            c: fromConstant(3),
+        });
+        await testObserver({
+            given: "fromObservableProperties called with all sync values should yield sync result",
+            expected: {
+                sync: { a: 1, b: 2, c: 3 },
+                async: [],
+            },
+            observable,
+            doAsync: () => Promise.resolve(),
+        });
+    });
+    test("fromObservableProperties optional called first", async () => {
+        const [observer1, doAsync1] = createTestObservable(undefined, [1, 2, 3]);
+        const [observer2, doAsync2] = createTestObservable("0", ["1", "2", "3"]);
+        const observable = fromProperties({
+            a: observer1,
+            b: withOptional(observer2),
+        });
+        await testObserver({
+            given: "pick",
+            expected: {
+                sync: undefined,
+                async: [
+                    { a: 1, b: "3" },
+                    { a: 2, b: "3" },
+                    { a: 3, b: "3" },
+                ],
+            },
+            observable,
+            doAsync: async () => {
+                await doAsync2();
+                await doAsync1();
+            },
+        });
+    });
+    test("fromObservableProperties optional called second", async () => {
+        const [observer1, doAsync1] = createTestObservable(undefined, [1, 2, 3]);
+        const [observer2, doAsync2] = createTestObservable(undefined, [
+            "1",
+            "2",
+            "3",
+        ]);
+        const observable = fromProperties({
+            a: observer1,
+            b: withOptional(observer2),
+        });
+        await testObserver({
+            given: "pick",
+            expected: {
+                sync: undefined,
+                async: [
+                    { a: 1, b: undefined },
+                    { a: 2, b: undefined },
+                    { a: 3, b: undefined },
+                    { a: 3, b: "1" },
+                    { a: 3, b: "2" },
+                    { a: 3, b: "3" },
+                ],
+            },
+            observable,
+            doAsync: async () => {
+                await doAsync1();
+                await doAsync2();
+            },
+        });
+    });
+    test("fromObservableArray sync", async () => {
+        const observable = fromArray([
+            fromConstant(1),
+            fromConstant(2),
+            fromConstant(3),
+        ]);
+        await testObserver({
+            given: "fromObservableArray called with all sync values should yield sync result",
+            expected: {
+                sync: [1, 2, 3],
+                async: [],
+            },
+            observable,
+            doAsync: () => Promise.resolve(),
+        });
+    });
+    test("fromPromise", async () => {
+        const promise = Promise.resolve(1);
+        await testObserver({
+            given: "fromPromise",
+            expected: {
+                sync: undefined,
+                async: [1],
+            },
+            observable: fromPromise(() => promise),
+            doAsync: async () => {
+                await promise;
+            },
+        });
+    });
+    test("fromPromiseWithError", async () => {
+        const error = new Error("error");
+        const promise = Promise.reject(error);
+        await testObserver({
+            given: "fromPromiseWithError",
+            expected: {
+                sync: undefined,
+                async: [error],
+            },
+            observable: fromPromiseWithError(() => promise),
+            doAsync: async () => {
+                try {
+                    await promise;
+                }
+                catch (_error) {
+                    // ignore
+                }
+            },
+        });
+    });
+    test("cache", async () => {
+        //  create a promise
+        const promise = Promise.resolve(1);
+        //  create the observable with a cache
+        const observable = withCache(fromPromise(() => promise));
+        //  wait for the first observable value to return.
+        const first = await new Promise((resolve) => {
+            const unobserve = observable((value) => {
+                resolve(value);
+                unobserve();
+            });
+        });
+        assert({
+            given: "first return value from cache",
+            should: "be 1",
+            actual: first,
+            expected: 1,
+        });
+        //  now that it's primed let's verify we get a synchronous result.
+        let syncValue;
+        observable((value) => {
+            syncValue = value;
+        })();
+        assert({
+            given: "synchronous return value from primed cache",
+            should: "be 1",
+            actual: syncValue,
+            expected: 1,
+        });
+    });
+    test("deduplicate shallow compare", async () => {
+        await testObservableFilter({
+            given: "an Observable with cache shallow",
+            filter: withDeduplicate,
+            input: [1, [1, 2, 2, 2, 3, 3, 4]],
+            output: [1, [2, 3, 4]],
+        });
+    });
+    // test("deduplicate deep compare", async () => {
+    //   await testObservableFilter({
+    //     given: "an Observable with deduplicate data",
+    //     filter: withDeduplicateData,
+    //     input: [
+    //       { a: 1 },
+    //       [{ a: 1 }, { a: 2 }, { a: 2 }, { a: 3 }, { a: 3 }, { a: 4 }],
+    //     ],
+    //     output: [{ a: 1 }, [{ a: 2 }, { a: 3 }, { a: 4 }]],
+    //   });
+    // });
+    test("withDefault", async () => {
+        await testObservableFilter({
+            given: "an Observable withDefault",
+            filter: withDefault(0),
+            input: [undefined, [1, undefined, 3]],
+            output: [0, [1, 0, 3]],
+        });
+    });
+    test("withMap", async () => {
+        await testObservableFilter({
+            given: "an Observable withMap",
+            filter: (observable) => withMap(observable, (value) => value * 2),
+            input: [1, [1, 2, 3]],
+            output: [2, [2, 4, 6]],
+        });
+    });
+    test("withAsyncMap", async () => {
+        await testObservableFilter({
+            given: "an Observable withAsyncMap",
+            filter: (observable) => withAsyncMap(observable, async (value) => value * 2),
+            input: [1, [1, 2, 3]],
+            output: [undefined, [2, 2, 4, 6]],
+        });
+    });
+    test("withCache shares base observable", async () => {
+        let observeCount = 0;
+        const observer = withCache((callback) => {
+            observeCount++;
+            callback(42);
+            return () => { };
+        });
+        let observe1 = -1;
+        observer((value) => {
+            observe1 = value;
+        });
+        let observe2 = -1;
+        observer((value) => {
+            observe2 = value;
+        });
+        assert({
+            given: "withShared called multiple times",
+            should: "base observable to be called only once",
+            actual: [observe1, observe2, observeCount],
+            expected: [42, 42, 1],
+        });
+    });
+    test("toObservableProperties", async () => {
+        const [observable, setState] = createObservableState({ a: 1, b: "foo" });
+        const properties = toProperties(observable, ["a", "b"]);
+        const observedValues = [];
+        const observer = (value) => {
+            observedValues.push(value);
+        };
+        properties.a(observer);
+        properties.b(observer);
+        assert({
+            given: "toObservableProperties",
+            should: "observe values",
+            actual: observedValues,
+            expected: [1, "foo"],
+        });
+        setState({ a: 2, b: "bar" });
+        assert({
+            given: "toObservableProperties",
+            should: "observe new values",
+            actual: observedValues,
+            expected: [1, "foo", 2, "bar"],
+        });
+        setState({ a: 2, b: "bar" });
+        assert({
+            given: "toObservableProperties",
+            should: "not observe unchanged values",
+            actual: observedValues,
+            expected: [1, "foo", 2, "bar"],
+        });
+        setState({ a: 3, b: "bar" });
+        assert({
+            given: "toObservableProperties",
+            should: "observe only changed values",
+            actual: observedValues,
+            expected: [1, "foo", 2, "bar", 3],
+        });
+    });
+});
+describe("observable", () => {
+    test("createObservableWithSetter", async () => {
+        const [observable, setter] = createObservableState();
+        const observedValues = [];
+        const unobserve = observable((value) => {
+            observedValues.push(value);
+        });
+        const values = [2, 3, 4];
+        // Set subsequent values
+        values.forEach((value) => setter(value));
+        assert({
+            given: "createObservableWithSetter",
+            should: "observe values",
+            actual: observedValues,
+            expected: values,
+        });
+        unobserve();
+        values.forEach((value) => setter(value));
+        assert({
+            given: "createObservableWithSetter",
+            should: "not observe values after unobserve",
+            actual: observedValues,
+            expected: values,
+        });
+    });
+});
+//# sourceMappingURL=observe.test.js.map

package/observe/observe.test.js.map

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

package/observe/to-promise.d.ts

@@ -0,0 +1,8 @@
+import { Observe } from "./types.js";
+/**
+ * Converts an Observe function to a Promise that will resolve with the first value.
+ * Note that you will never receive subsequent updates since promises can only resolve once.
+ * @param observe
+ * @returns the first value yielded by the observe function.
+ */
+export declare function toPromise<T>(observable: Observe<T>): Promise<T>;

package/observe/to-promise.js

@@ -0,0 +1,18 @@
+/**
+ * Converts an Observe function to a Promise that will resolve with the first value.
+ * Note that you will never receive subsequent updates since promises can only resolve once.
+ * @param observe
+ * @returns the first value yielded by the observe function.
+ */
+export function toPromise(observable) {
+    return new Promise((resolve, _reject) => {
+        let unobserve = null;
+        unobserve = observable((value) => {
+            resolve(value);
+            if (unobserve) {
+                unobserve();
+            }
+        });
+    });
+}
+//# sourceMappingURL=to-promise.js.map

package/observe/to-promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-promise.js","sourceRoot":"","sources":["../../src/observe/to-promise.ts"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAI,UAAsB;IACjD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACzC,IAAI,SAAS,GAAqB,IAAI,CAAC;QACvC,SAAS,GAAG,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/B,OAAO,CAAC,KAAK,CAAC,CAAC;YACf,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,EAAE,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/observe/to-properties.d.ts

@@ -0,0 +1,11 @@
+import { Data } from "../index.js";
+import { Observe } from "./types.js";
+/**
+ * Returns an object which contains an observe function for each key in the input object.
+ * Each individual observe function will only notify observers when it's own value has changed.
+ */
+export declare function toProperties<T extends {
+    [K: string]: Data;
+}, Keys extends keyof T>(observable: Observe<T>, keys: Keys[]): {
+    readonly [K in Keys]: Observe<T[K]>;
+};

package/observe/to-properties.js

@@ -0,0 +1,9 @@
+import { withMapData } from "./with-map-data.js";
+/**
+ * Returns an object which contains an observe function for each key in the input object.
+ * Each individual observe function will only notify observers when it's own value has changed.
+ */
+export function toProperties(observable, keys) {
+    return Object.fromEntries(keys.map((key) => [key, withMapData(observable, (value) => value[key])]));
+}
+//# sourceMappingURL=to-properties.js.map

package/observe/to-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-properties.js","sourceRoot":"","sources":["../../src/observe/to-properties.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAI1B,UAAsB,EACtB,IAAY;IAGZ,OAAO,MAAM,CAAC,WAAW,CACvB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACf,CAAA;AAC7D,CAAC"}

package/observe/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * An Observe type is a function that can be called to observe a sequence of values.
+ * The Observe function is called with a Callback function that may be called zero or more times.
+ * The Observe function returns an Unobserve function that can be called to stop observing the Observe function.
+ */
+export type Observe<T> = (notify: Notify<T>) => Unobserve;
+/**
+ * Callback function called zero or more times with a sequence of values.
+ * *may* be called back synchronously, immediately when selector function is called.
+ * *may* also be called back later asynchronously any number of times.
+ * *may* be called multiple sequential times with the same value.
+ */
+export type Notify<T> = (value: T) => void;
+/**
+ * Function called to stop observing an Observe function.
+ */
+export type Unobserve = () => void;

package/observe/types.js

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

package/observe/types.js.map

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

package/observe/with-async-map.d.ts

@@ -0,0 +1,6 @@
+import { Observe } from "./types.js";
+/**
+ * Creates a new Observe function that converts the original observe function's values into
+ * a new value at each notification using an async promise mapping function.
+ */
+export declare function withAsyncMap<T, U>(observable: Observe<T>, map: (value: T) => Promise<U>): Observe<U>;

package/observe/with-async-map.js

@@ -0,0 +1,12 @@
+/**
+ * Creates a new Observe function that converts the original observe function's values into
+ * a new value at each notification using an async promise mapping function.
+ */
+export function withAsyncMap(observable, map) {
+    return (observer) => {
+        return observable(async (value) => {
+            observer(await map(value));
+        });
+    };
+}
+//# sourceMappingURL=with-async-map.js.map

package/observe/with-async-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-async-map.js","sourceRoot":"","sources":["../../src/observe/with-async-map.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,UAAsB,EACtB,GAA6B;IAE7B,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,OAAO,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAChC,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/observe/with-cache.d.ts

@@ -0,0 +1,6 @@
+import { Observe } from "./types.js";
+/**
+ * Creates a new Observe function that will cache the last value and notify observers immediately with the last value.
+ * Also prevents the base observe function from being called more than once with multiple simultaneous observers.
+ */
+export declare function withCache<T>(observable: Observe<T>): Observe<T>;

package/observe/with-cache.js

@@ -0,0 +1,33 @@
+/**
+ * Creates a new Observe function that will cache the last value and notify observers immediately with the last value.
+ * Also prevents the base observe function from being called more than once with multiple simultaneous observers.
+ */
+export function withCache(observable) {
+    let value = undefined;
+    let hasValue = false;
+    const observers = new Set();
+    let unobserve = null;
+    return (observer) => {
+        observers.add(observer);
+        if (hasValue) {
+            observer(value);
+        }
+        if (observers.size === 1) {
+            unobserve = observable((newValue) => {
+                hasValue = true;
+                value = newValue;
+                for (const callback of observers) {
+                    callback(newValue);
+                }
+            });
+        }
+        return () => {
+            observers.delete(observer);
+            if (observers.size === 0 && unobserve) {
+                unobserve();
+                unobserve = null;
+            }
+        };
+    };
+}
+//# sourceMappingURL=with-cache.js.map

package/observe/with-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-cache.js","sourceRoot":"","sources":["../../src/observe/with-cache.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AAEH,MAAM,UAAU,SAAS,CAAI,UAAsB;IACjD,IAAI,KAAK,GAAkB,SAAS,CAAC;IACrC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAa,CAAC;IACvC,IAAI,SAAS,GAAqB,IAAI,CAAC;IACvC,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAU,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACzB,SAAS,GAAG,UAAU,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAClC,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,GAAG,QAAQ,CAAC;gBACjB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;oBACjC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;gBACtC,SAAS,EAAE,CAAC;gBACZ,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/observe/with-copy.d.ts

@@ -0,0 +1,5 @@
+import { Observe } from "./types.js";
+/**
+ * Makes a deep copy of the observed value using structured cloning.
+ */
+export declare function withCopy<T>(observable: Observe<T>): Observe<T>;

package/observe/with-copy.js

@@ -0,0 +1,10 @@
+import { withMap } from "./with-map.js";
+/**
+ * Makes a deep copy of the observed value using structured cloning.
+ */
+export function withCopy(observable) {
+    return withMap(observable, (value) => {
+        return structuredClone(value);
+    });
+}
+//# sourceMappingURL=with-copy.js.map

package/observe/with-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-copy.js","sourceRoot":"","sources":["../../src/observe/with-copy.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAI,UAAsB;IAChD,OAAO,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;QACnC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/observe/with-deduplicate-data.d.ts

@@ -0,0 +1,7 @@
+import { Observe } from "./types.js";
+import { Data } from "../core/data.js";
+/**
+ * Creates a new Observe function that will cache the last value and only notify observers when the value changes.
+ * Performs a deep comparison of the value to determine if it has changed.
+ */
+export declare function withDeduplicateData<T extends Data>(observable: Observe<T>): Observe<T>;

package/observe/with-deduplicate-data.js

@@ -0,0 +1,18 @@
+import { equals } from "../core/data.js";
+/**
+ * Creates a new Observe function that will cache the last value and only notify observers when the value changes.
+ * Performs a deep comparison of the value to determine if it has changed.
+ */
+export function withDeduplicateData(observable) {
+    return (observer) => {
+        let lastValue = undefined;
+        return observable((value) => {
+            const notify = lastValue === undefined || !equals(lastValue, value);
+            if (notify) {
+                lastValue = value;
+                observer(value);
+            }
+        });
+    };
+}
+//# sourceMappingURL=with-deduplicate-data.js.map

package/observe/with-deduplicate-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-deduplicate-data.js","sourceRoot":"","sources":["../../src/observe/with-deduplicate-data.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAQ,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAsB;IAEtB,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,IAAI,SAAS,GAAkB,SAAS,CAAC;QACzC,OAAO,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,SAAS,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACpE,IAAI,MAAM,EAAE,CAAC;gBACX,SAAS,GAAG,KAAK,CAAC;gBAClB,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/observe/with-deduplicate.d.ts

@@ -0,0 +1,6 @@
+import { Observe } from "./types.js";
+/**
+ * Creates a new Observe function on a data value which will be cached such that
+ * observers will never be notified consecutively of equivalent values.
+ */
+export declare function withDeduplicate<T>(observable: Observe<T>): Observe<T>;