@adobe/data 0.2.1 → 0.2.2

package/dist/observe/with-batch.test.js

@@ -0,0 +1,111 @@
+/*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 { describe, it, expect } from 'vitest';
+import { withBatch } from './with-batch.js';
+import { createObservableState } from './create-observable-state.js';
+describe('withBatch', () => {
+    it('should batch multiple rapid emissions into a single notification', async () => {
+        const [source, setSource] = createObservableState(1);
+        const batched = withBatch(source);
+        const observedValues = [];
+        const unsubscribe = batched((value) => {
+            observedValues.push(value);
+        });
+        // Initial value should be emitted immediately
+        expect(observedValues).toEqual([1]);
+        // Multiple rapid updates should be batched
+        setSource(2);
+        setSource(3);
+        setSource(4);
+        // Should not have emitted yet (still in same microtask)
+        expect(observedValues).toEqual([1]);
+        // Wait for next microtask
+        await new Promise(resolve => setTimeout(resolve, 0));
+        // Should have emitted only the last value
+        expect(observedValues).toEqual([1, 4]);
+        unsubscribe();
+    });
+    it('should handle multiple batches correctly', async () => {
+        const [source, setSource] = createObservableState(1);
+        const batched = withBatch(source);
+        const observedValues = [];
+        const unsubscribe = batched((value) => {
+            observedValues.push(value);
+        });
+        // Initial value
+        expect(observedValues).toEqual([1]);
+        // First batch
+        setSource(2);
+        setSource(3);
+        // Second batch (after microtask)
+        await new Promise(resolve => setTimeout(resolve, 0));
+        setSource(4);
+        setSource(5);
+        // Should have emitted only the last value from first batch
+        expect(observedValues).toEqual([1, 3]);
+        // Wait for second batch
+        await new Promise(resolve => setTimeout(resolve, 0));
+        // Should have emitted only the last value from second batch
+        expect(observedValues).toEqual([1, 3, 5]);
+        unsubscribe();
+    });
+    it('should handle unsubscribe correctly', async () => {
+        const [source, setSource] = createObservableState(1);
+        const batched = withBatch(source);
+        const observedValues = [];
+        const unsubscribe = batched((value) => {
+            observedValues.push(value);
+        });
+        // Initial value
+        expect(observedValues).toEqual([1]);
+        // Update and unsubscribe before microtask
+        setSource(2);
+        unsubscribe();
+        // Wait for microtask
+        await new Promise(resolve => setTimeout(resolve, 0));
+        // Should not have emitted after unsubscribe
+        expect(observedValues).toEqual([1]);
+    });
+    it('should work with multiple observers', async () => {
+        const [source, setSource] = createObservableState(1);
+        const batched = withBatch(source);
+        const values1 = [];
+        const values2 = [];
+        const unsubscribe1 = batched((value) => values1.push(value));
+        const unsubscribe2 = batched((value) => values2.push(value));
+        // Both observers should get initial value
+        expect(values1).toEqual([1]);
+        expect(values2).toEqual([1]);
+        // Multiple rapid updates
+        setSource(2);
+        setSource(3);
+        setSource(4);
+        // Wait for microtask
+        await new Promise(resolve => setTimeout(resolve, 0));
+        // Both observers should get only the last value
+        expect(values1).toEqual([1, 4]);
+        expect(values2).toEqual([1, 4]);
+        unsubscribe1();
+        unsubscribe2();
+    });
+});
+//# sourceMappingURL=with-batch.test.js.map

package/dist/observe/with-batch.test.js.map

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

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/observe/with-deduplicate-data.d.ts

@@ -0,0 +1,7 @@
+import { Observe } from "./types.js";
+import { Data } from "../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/dist/observe/with-deduplicate-data.js

@@ -0,0 +1,18 @@
+import { equals } from "../equals.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/dist/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":"AAuBA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;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/dist/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>;

package/dist/observe/with-deduplicate.js

@@ -0,0 +1,19 @@
+/**
+ * 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 function withDeduplicate(observable) {
+    return (observer) => {
+        let notified = false;
+        let lastValue = undefined;
+        return observable((value) => {
+            const notify = !notified || lastValue !== value;
+            if (notify) {
+                notified = true;
+                lastValue = value;
+                observer(value);
+            }
+        });
+    };
+}
+//# sourceMappingURL=with-deduplicate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with-deduplicate.js","sourceRoot":"","sources":["../../src/observe/with-deduplicate.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAI,UAAsB;IACvD,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,SAAS,GAAkB,SAAS,CAAC;QACzC,OAAO,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,CAAC,QAAQ,IAAI,SAAS,KAAK,KAAK,CAAC;YAChD,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,GAAG,IAAI,CAAC;gBAChB,SAAS,GAAG,KAAK,CAAC;gBAClB,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/observe/with-default.d.ts

@@ -0,0 +1,6 @@
+import { Observe } from "./types.js";
+/**
+ * Creates a new observable that will use a defaultValue whenever the observed
+ * value is undefined and will always respond synchronously when called.
+ */
+export declare const withDefault: <T>(defaultValue: T) => (observable: Observe<T | undefined>) => Observe<T>;

package/dist/observe/with-default.js

@@ -0,0 +1,21 @@
+/**
+ * Creates a new observable that will use a defaultValue whenever the observed
+ * value is undefined and will always respond synchronously when called.
+ */
+export const withDefault = (defaultValue) => (observable) => {
+    return (observer) => {
+        let notified = false;
+        const notify = (value) => {
+            notified = true;
+            observer(value === undefined ? defaultValue : value);
+        };
+        const unobserverInternal = observable((value) => {
+            notify(value);
+        });
+        if (!notified) {
+            notify();
+        }
+        return unobserverInternal;
+    };
+};
+//# sourceMappingURL=with-default.js.map

package/dist/observe/with-default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-default.js","sourceRoot":"","sources":["../../src/observe/with-default.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GACtB,CAAI,YAAe,EAAE,EAAE,CACrB,CAAC,UAAkC,EAAc,EAAE;IACjD,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,IAAI,QAAQ,GAAG,KAAgB,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,KAAS,EAAE,EAAE;YAC3B,QAAQ,GAAG,IAAI,CAAC;YAChB,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC,CAAC;QAEF,MAAM,kBAAkB,GAAG,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9C,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,EAAE,CAAC;QACX,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/observe/with-lazy.d.ts

@@ -0,0 +1,7 @@
+import { Observe } from "./types.js";
+/**
+ * Creates a new Observe function that defers the creation of an expensive observable
+ * until the first subscription. The created observable is cached and reused for
+ * all subsequent subscriptions.
+ */
+export declare function withLazy<T>(factory: () => Observe<T>): Observe<T>;

package/dist/observe/with-lazy.js

@@ -0,0 +1,15 @@
+/**
+ * Creates a new Observe function that defers the creation of an expensive observable
+ * until the first subscription. The created observable is cached and reused for
+ * all subsequent subscriptions.
+ */
+export function withLazy(factory) {
+    let cachedObservable = null;
+    return (observer) => {
+        if (!cachedObservable) {
+            cachedObservable = factory();
+        }
+        return cachedObservable(observer);
+    };
+}
+//# sourceMappingURL=with-lazy.js.map

package/dist/observe/with-lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-lazy.js","sourceRoot":"","sources":["../../src/observe/with-lazy.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAI,OAAyB;IACjD,IAAI,gBAAgB,GAAsB,IAAI,CAAC;IAE/C,OAAO,CAAC,QAAQ,EAAE,EAAE;QAChB,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpB,gBAAgB,GAAG,OAAO,EAAE,CAAC;QACjC,CAAC;QACD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC;AACN,CAAC"}

package/dist/observe/with-lazy.test.d.ts

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

package/dist/observe/with-lazy.test.js

@@ -0,0 +1,59 @@
+/*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 { describe, it, expect } from 'vitest';
+import { withLazy } from './with-lazy.js';
+import { createObservableState } from './create-observable-state.js';
+describe('withLazy', () => {
+    it('should defer observable creation until first subscription', () => {
+        let factoryCalled = false;
+        const factory = () => {
+            factoryCalled = true;
+            const [source] = createObservableState(42);
+            return source;
+        };
+        const lazyObs = withLazy(factory);
+        expect(factoryCalled).toBe(false);
+        const values = [];
+        const unsubscribe = lazyObs(value => values.push(value));
+        expect(factoryCalled).toBe(true);
+        expect(values).toEqual([42]);
+        unsubscribe();
+    });
+    it('should cache the observable after first creation', () => {
+        let callCount = 0;
+        const factory = () => {
+            callCount++;
+            const [source] = createObservableState(42);
+            return source;
+        };
+        const lazyObs = withLazy(factory);
+        // First subscription
+        const unsubscribe1 = lazyObs(() => { });
+        expect(callCount).toBe(1);
+        // Second subscription should reuse the same observable
+        const unsubscribe2 = lazyObs(() => { });
+        expect(callCount).toBe(1);
+        unsubscribe1();
+        unsubscribe2();
+    });
+});
+//# sourceMappingURL=with-lazy.test.js.map

package/dist/observe/with-lazy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-lazy.test.js","sourceRoot":"","sources":["../../src/observe/with-lazy.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACjE,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,EAAE;YACjB,aAAa,GAAG,IAAI,CAAC;YACrB,MAAM,CAAC,MAAM,CAAC,GAAG,qBAAqB,CAAS,EAAE,CAAC,CAAC;YACnD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAElC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAEzD,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAE7B,WAAW,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,GAAG,EAAE;YACjB,SAAS,EAAE,CAAC;YACZ,MAAM,CAAC,MAAM,CAAC,GAAG,qBAAqB,CAAS,EAAE,CAAC,CAAC;YACnD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAElC,qBAAqB;QACrB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE1B,uDAAuD;QACvD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE1B,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/observe/with-map-data.d.ts

@@ -0,0 +1,7 @@
+import { Data } from "../index.js";
+import { Observe } from "./types.js";
+/**
+ * A higher order observable that maps to a specific data value, deduplicates the data, and copies the data.
+ * withMapData(observable, map) = withCopy(withDeduplicateData(withMap(observable, map)))
+ */
+export declare function withMapData<T, U extends Data>(observable: Observe<T>, map: (value: T) => U): Observe<U>;

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

@@ -0,0 +1,32 @@
+/*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 { withCopy } from "./with-copy.js";
+import { withDeduplicateData } from "./with-deduplicate-data.js";
+import { withMap } from "./with-map.js";
+/**
+ * A higher order observable that maps to a specific data value, deduplicates the data, and copies the data.
+ * withMapData(observable, map) = withCopy(withDeduplicateData(withMap(observable, map)))
+ */
+export function withMapData(observable, map) {
+    return withCopy(withDeduplicateData(withMap(observable, map)));
+}
+//# sourceMappingURL=with-map-data.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with-map-data.js","sourceRoot":"","sources":["../../src/observe/with-map-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAIX,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,UAAsB,EACtB,GAAoB;IAEpB,OAAO,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,5 @@
+import { Observe } from "./types.js";
+/**
+ * Creates a new Observe function that converts the original observe functions notify values into a new value at each notification.
+ */
+export declare function withMap<T, U>(observable: Observe<T>, map: (value: T) => U): Observe<U>;

package/dist/observe/with-map.js

@@ -0,0 +1,11 @@
+/**
+ * Creates a new Observe function that converts the original observe functions notify values into a new value at each notification.
+ */
+export function withMap(observable, map) {
+    return (observer) => {
+        return observable((value) => {
+            observer(map(value));
+        });
+    };
+}
+//# sourceMappingURL=with-map.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with-map.js","sourceRoot":"","sources":["../../src/observe/with-map.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,UAAsB,EACtB,GAAoB;IAEpB,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,OAAO,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/observe/with-optional.d.ts

@@ -0,0 +1,5 @@
+import { Observe } from "./types.js";
+/**
+ * Creates a new Observe function that may be undefined but will always yield a result or undefined synchronously when called.
+ */
+export declare const withOptional: <T>(observable: Observe<T>) => Observe<T | undefined>;

package/dist/observe/with-optional.js

@@ -0,0 +1,20 @@
+/**
+ * Creates a new Observe function that may be undefined but will always yield a result or undefined synchronously when called.
+ */
+export const withOptional = (observable) => {
+    return (observer) => {
+        let notified = false;
+        const notify = (value) => {
+            notified = true;
+            observer(value);
+        };
+        const unobserverInternal = observable((value) => {
+            notify(value);
+        });
+        if (!notified) {
+            notify();
+        }
+        return unobserverInternal;
+    };
+};
+//# sourceMappingURL=with-optional.js.map

package/dist/observe/with-optional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-optional.js","sourceRoot":"","sources":["../../src/observe/with-optional.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,UAAsB,EACE,EAAE;IAC1B,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,IAAI,QAAQ,GAAG,KAAgB,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,KAAS,EAAE,EAAE;YAC3B,QAAQ,GAAG,IAAI,CAAC;YAChB,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,kBAAkB,GAAG,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9C,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,EAAE,CAAC;QACX,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/observe/with-unwrap.d.ts

@@ -0,0 +1,5 @@
+import { Observe } from "./types.js";
+/**
+ * Unwraps a nested observable to provide a single observable with the inner observable's values.
+ */
+export declare function withUnwrap<T>(observable: Observe<Observe<T>>): Observe<T>;

package/dist/observe/with-unwrap.js

@@ -0,0 +1,26 @@
+/**
+ * Unwraps a nested observable to provide a single observable with the inner observable's values.
+ */
+export function withUnwrap(observable) {
+    return (observer) => {
+        let currentUnsubscribe = null; // Track the current subscription
+        const unsubscribe = observable((innerObservable) => {
+            // Unsubscribe from the current inner observable before subscribing to the new one
+            if (currentUnsubscribe) {
+                currentUnsubscribe();
+            }
+            // Subscribe to the new inner observable and update the currentUnsubscribe
+            currentUnsubscribe = innerObservable((value) => {
+                observer(value);
+            });
+        });
+        // Return a new unsubscribe function that unsubscribes from both the outer and current inner observables
+        return () => {
+            unsubscribe(); // Unsubscribe from the outer observable
+            if (currentUnsubscribe) {
+                currentUnsubscribe(); // Ensure we unsubscribe from the current inner observable
+            }
+        };
+    };
+}
+//# sourceMappingURL=with-unwrap.js.map

package/dist/observe/with-unwrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-unwrap.js","sourceRoot":"","sources":["../../src/observe/with-unwrap.ts"],"names":[],"mappings":"AAuBA;;GAEG;AAEH,MAAM,UAAU,UAAU,CACxB,UAA+B;IAE/B,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClB,IAAI,kBAAkB,GAAqB,IAAI,CAAC,CAAC,iCAAiC;QAElF,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,eAAe,EAAE,EAAE;YACjD,kFAAkF;YAClF,IAAI,kBAAkB,EAAE,CAAC;gBACvB,kBAAkB,EAAE,CAAC;YACvB,CAAC;YAED,0EAA0E;YAC1E,kBAAkB,GAAG,eAAe,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC7C,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,wGAAwG;QACxG,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAC,CAAC,wCAAwC;YACvD,IAAI,kBAAkB,EAAE,CAAC;gBACvB,kBAAkB,EAAE,CAAC,CAAC,0DAA0D;YAClF,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/old-ecs/action-ecs/action-ecs.d.ts

@@ -0,0 +1,19 @@
+import { ECSArchetypes, ECSComponents, ECSResources } from "../ecs/ecs-types.js";
+import { TransactionECS } from "../transaction-ecs/transaction-types.js";
+import { ActionECS, ECSActionFunctions } from "./action-types.js";
+export declare function createActionECS<C extends ECSComponents, A extends ECSArchetypes, R extends ECSResources, F extends ECSActionFunctions = {}>(options?: {
+    ecs?: TransactionECS<C, A, R>;
+    /**
+     * A unique user identifier for the current user.
+     */
+    user?: string;
+    /**
+     * A function which returns a unique, increasing time in UTC milliseconds.
+     * The function cannot return the same value twice but must increment if needed.
+     */
+    getUniqueTimeMs?: () => number;
+    /**
+     * Maximum time in milliseconds to wait for applied actions to be reordered.
+     */
+    maxSynchronizeDurationMs?: number;
+}): ActionECS<C, A, R, F>;