reactor-core-ts 3.2.1 → 3.2.3

package/dist/publisher/operators/lift.js

@@ -0,0 +1,343 @@
+import _defineProperty from "../../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/defineProperty.js";
+import { Context } from "../../context/context.js";
+import { addCap } from "../../core/demand.js";
+import { Flux } from "../flux.js";
+//#region src/publisher/operators/lift.ts
+/**
+* @packageDocumentation
+* Internal subscriber-lifting primitives for demand-preserving Flux operators.
+*/
+/**
+* Lifts a Flux at the Reactive Streams subscriber boundary while keeping an
+* iterable implementation for explicit async-iterator consumption.
+*/
+function liftFlux(source, sourceFactory, lifter) {
+	return new LiftedFlux(source, sourceFactory, lifter);
+}
+/** Creates a one-to-one operator that forwards downstream demand unchanged. */
+function liftOneToOne(source, sourceFactory, hooksFactory) {
+	return liftFlux(source, sourceFactory, (subscriber) => new OneToOneOperatorSubscriber(subscriber, hooksFactory(subscriber)));
+}
+/** Creates a filtering operator that replenishes only values dropped from finite demand. */
+function liftFilter(source, sourceFactory, predicate) {
+	return liftFlux(source, sourceFactory, (subscriber) => new FilterOperatorSubscriber(subscriber, predicate));
+}
+/** Returns the context exposed by a subscriber, or the shared empty context. */
+function subscriberContext(subscriber) {
+	return subscriber.currentContext?.() ?? Context.empty();
+}
+/** Flux whose normal subscribe path is assembled through a subscriber lifter. */
+var LiftedFlux = class extends Flux {
+	/** Creates a lifted Flux around an upstream source. */
+	constructor(source, sourceFactory, lifter) {
+		super(sourceFactory);
+		_defineProperty(this, "source", void 0);
+		_defineProperty(this, "lifter", void 0);
+		this.source = source;
+		this.lifter = lifter;
+	}
+	/** Subscribes without crossing the async-iterator bridge. */
+	subscribeActual(subscriber) {
+		let upstreamSubscriber;
+		try {
+			upstreamSubscriber = this.lifter(subscriber);
+		} catch (error) {
+			signalAssemblyError(subscriber, error);
+			return;
+		}
+		this.source.subscribe(upstreamSubscriber);
+	}
+};
+/** Subscription/subscriber pair shared by synchronous one-to-one operators. */
+var OneToOneOperatorSubscriber = class {
+	/** Creates a one-to-one operator subscriber. */
+	constructor(actual, hooks) {
+		_defineProperty(this, "actual", void 0);
+		_defineProperty(this, "hooks", void 0);
+		_defineProperty(
+			this,
+			/** Upstream subscription received during the Reactive Streams handshake. */
+			"upstream",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Prevents duplicate subscriptions from replacing the active upstream. */
+			"subscribed",
+			false
+		);
+		_defineProperty(
+			this,
+			/** Suppresses signals and demand after cancellation or termination. */
+			"terminated",
+			false
+		);
+		this.actual = actual;
+		this.hooks = hooks;
+	}
+	/** Installs the upstream subscription and exposes this forwarding subscription downstream. */
+	onSubscribe(subscription) {
+		if (this.subscribed || this.terminated) {
+			subscription.cancel();
+			return;
+		}
+		this.subscribed = true;
+		this.upstream = subscription;
+		try {
+			this.hooks.onSubscribe?.(subscription);
+		} catch (error) {
+			this.terminated = true;
+			cancelSilently(subscription);
+			this.actual.onSubscribe(this);
+			this.signalError(error);
+			return;
+		}
+		try {
+			this.actual.onSubscribe(this);
+		} catch (error) {
+			this.terminated = true;
+			try {
+				subscription.cancel();
+			} finally {
+				this.runFinally("cancel");
+			}
+			throw error;
+		}
+	}
+	/** Converts and forwards one upstream value without changing demand. */
+	onNext(value) {
+		if (this.terminated) return;
+		let mapped;
+		try {
+			mapped = this.hooks.onNext(value);
+		} catch (error) {
+			this.terminateWithError(error, true);
+			return;
+		}
+		this.actual.onNext(mapped);
+	}
+	/** Forwards an upstream error after running the operator callback. */
+	onError(error) {
+		this.terminateWithError(error, false);
+	}
+	/** Forwards successful completion after running the operator callback. */
+	onComplete() {
+		if (this.terminated) return;
+		try {
+			this.hooks.onComplete?.();
+		} catch (error) {
+			this.terminateWithError(error, false);
+			return;
+		}
+		this.terminated = true;
+		try {
+			this.actual.onComplete();
+		} finally {
+			this.runFinally("complete");
+		}
+	}
+	/** Forwards exactly the requested amount to upstream. */
+	request(n) {
+		if (this.terminated) return;
+		try {
+			this.hooks.onRequest?.(n);
+		} catch (error) {
+			this.terminateWithError(error, true);
+			return;
+		}
+		this.upstream?.request(n);
+	}
+	/** Cancels upstream once and reports the cancellation lifecycle hooks. */
+	cancel() {
+		if (this.terminated) return;
+		this.terminated = true;
+		try {
+			this.upstream?.cancel();
+		} finally {
+			try {
+				this.hooks.onCancel?.();
+			} finally {
+				this.runFinally("cancel");
+			}
+		}
+	}
+	/** Exposes downstream context to context-aware upstream publishers. */
+	currentContext() {
+		return this.hooks.currentContext?.() ?? subscriberContext(this.actual);
+	}
+	/** Cancels when needed and emits one downstream error signal. */
+	terminateWithError(error, cancelUpstream) {
+		if (this.terminated) return;
+		this.terminated = true;
+		if (cancelUpstream && this.upstream) cancelSilently(this.upstream);
+		let failure = error;
+		try {
+			this.hooks.onError?.(error);
+		} catch (callbackError) {
+			failure = callbackError;
+		}
+		this.signalError(failure);
+	}
+	/** Delivers an error followed by the final error callback. */
+	signalError(error) {
+		try {
+			this.actual.onError(error);
+		} finally {
+			this.runFinally("error");
+		}
+	}
+	/** Runs a final callback without letting observer code alter terminal semantics. */
+	runFinally(signal) {
+		try {
+			this.hooks.onFinally?.(signal);
+		} catch {}
+	}
+};
+/** Filtering subscriber with stack-safe compensation for dropped values. */
+var FilterOperatorSubscriber = class {
+	/** Creates a filtering subscriber. */
+	constructor(actual, predicate) {
+		_defineProperty(this, "actual", void 0);
+		_defineProperty(this, "predicate", void 0);
+		_defineProperty(
+			this,
+			/** Upstream subscription received during the Reactive Streams handshake. */
+			"upstream",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Prevents duplicate subscriptions from replacing the active upstream. */
+			"subscribed",
+			false
+		);
+		_defineProperty(
+			this,
+			/** Suppresses signals and demand after cancellation or termination. */
+			"terminated",
+			false
+		);
+		_defineProperty(
+			this,
+			/** Avoids compensation requests after downstream switches to unbounded demand. */
+			"unbounded",
+			false
+		);
+		_defineProperty(
+			this,
+			/** Guards synchronous request calls against reentrant compensation. */
+			"requesting",
+			false
+		);
+		_defineProperty(
+			this,
+			/** Compensation or downstream demand accumulated during an active request call. */
+			"missedRequested",
+			0
+		);
+		this.actual = actual;
+		this.predicate = predicate;
+	}
+	/** Installs upstream and exposes the demand-forwarding subscription downstream. */
+	onSubscribe(subscription) {
+		if (this.subscribed || this.terminated) {
+			subscription.cancel();
+			return;
+		}
+		this.subscribed = true;
+		this.upstream = subscription;
+		try {
+			this.actual.onSubscribe(this);
+		} catch (error) {
+			this.terminated = true;
+			subscription.cancel();
+			throw error;
+		}
+	}
+	/** Tests one value, forwarding matches and replenishing finite demand for drops. */
+	onNext(value) {
+		if (this.terminated) return;
+		let accepted;
+		try {
+			accepted = this.predicate(value);
+		} catch (error) {
+			this.terminated = true;
+			if (this.upstream) cancelSilently(this.upstream);
+			this.actual.onError(error);
+			return;
+		}
+		if (accepted) this.actual.onNext(value);
+		else if (!this.unbounded) this.requestUpstream(1);
+	}
+	/** Forwards one terminal error. */
+	onError(error) {
+		if (this.terminated) return;
+		this.terminated = true;
+		this.actual.onError(error);
+	}
+	/** Forwards successful completion once. */
+	onComplete() {
+		if (this.terminated) return;
+		this.terminated = true;
+		this.actual.onComplete();
+	}
+	/** Forwards demand and records when no further compensation is necessary. */
+	request(n) {
+		if (this.terminated) return;
+		if (n === Number.POSITIVE_INFINITY) this.unbounded = true;
+		this.requestUpstream(n);
+	}
+	/** Cancels the upstream once. */
+	cancel() {
+		if (this.terminated) return;
+		this.terminated = true;
+		this.upstream?.cancel();
+	}
+	/** Exposes the downstream context unchanged. */
+	currentContext() {
+		return subscriberContext(this.actual);
+	}
+	/** Drains demand iteratively so synchronous sources cannot recurse through dropped values. */
+	requestUpstream(n) {
+		if (this.requesting) {
+			this.missedRequested = addCap(this.missedRequested, n);
+			return;
+		}
+		const upstream = this.upstream;
+		if (!upstream) return;
+		this.requesting = true;
+		let request = n;
+		try {
+			while (!this.terminated) {
+				upstream.request(request);
+				if (this.terminated || this.missedRequested === 0) return;
+				request = this.missedRequested;
+				this.missedRequested = 0;
+			}
+		} finally {
+			this.requesting = false;
+		}
+	}
+};
+/** Signals a lifter assembly failure through a valid Reactive Streams handshake. */
+function signalAssemblyError(subscriber, error) {
+	subscriber.onSubscribe(EMPTY_SUBSCRIPTION);
+	subscriber.onError(error);
+}
+/** Cancels an upstream while preserving the original operator failure. */
+function cancelSilently(subscription) {
+	try {
+		subscription.cancel();
+	} catch {}
+}
+/** Shared inert subscription used only when operator assembly fails. */
+var EMPTY_SUBSCRIPTION = Object.freeze({
+	/** Ignores requests because the sequence has already failed. */
+	request() {},
+	/** Ignores cancellation because no upstream was subscribed. */
+	cancel() {}
+});
+//#endregion
+export { liftFilter, liftFlux, liftOneToOne, subscriberContext };
+
+//# sourceMappingURL=lift.js.map

package/dist/publisher/operators/lift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lift.js","names":[],"sources":["../../../src/publisher/operators/lift.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Internal subscriber-lifting primitives for demand-preserving Flux operators.\n */\nimport {Context} from \"@/context/context.js\";\nimport {addCap} from \"@/core/demand.js\";\nimport type {SourceFactory} from \"@/publisher/types.js\";\nimport {Flux} from \"@/publisher/flux.js\";\nimport type {CoreSubscriber} from \"@/subscription/core-subscriber.js\";\nimport type {Subscriber} from \"@/subscription/subscriber.js\";\nimport type {Subscription} from \"@/subscription/subscription.js\";\n\n/** Creates the subscriber that an upstream Flux sees for a downstream subscriber. */\nexport type SubscriberLifter<T, R> = (subscriber: Subscriber<R>) => Subscriber<T>;\n\n/** Hooks used by synchronous one-input/one-output operators. */\nexport interface OneToOneOperatorHooks<T, R> {\n    /** Converts one upstream value into exactly one downstream value. */\n    onNext(value: T): R;\n\n    /** Runs before the downstream receives its subscription. */\n    onSubscribe?(subscription: Subscription): void;\n\n    /** Runs before an upstream error is forwarded. */\n    onError?(error: unknown): void;\n\n    /** Runs before downstream demand is forwarded upstream. */\n    onRequest?(request: number): void;\n\n    /** Runs before successful completion is forwarded. */\n    onComplete?(): void;\n\n    /** Runs when downstream cancellation is propagated upstream. */\n    onCancel?(): void;\n\n    /** Runs after the terminal signal or cancellation has been propagated. */\n    onFinally?(signal: \"complete\" | \"error\" | \"cancel\"): void;\n\n    /** Context exposed to the upstream subscriber. */\n    currentContext?(): Context;\n}\n\n/**\n * Lifts a Flux at the Reactive Streams subscriber boundary while keeping an\n * iterable implementation for explicit async-iterator consumption.\n */\nexport function liftFlux<T, R>(\n    source: Flux<T>,\n    sourceFactory: SourceFactory<R>,\n    lifter: SubscriberLifter<T, R>\n): Flux<R> {\n    return new LiftedFlux(source, sourceFactory, lifter);\n}\n\n/** Creates a one-to-one operator that forwards downstream demand unchanged. */\nexport function liftOneToOne<T, R>(\n    source: Flux<T>,\n    sourceFactory: SourceFactory<R>,\n    hooksFactory: (subscriber: Subscriber<R>) => OneToOneOperatorHooks<T, R>\n): Flux<R> {\n    return liftFlux(source, sourceFactory, subscriber =>\n        new OneToOneOperatorSubscriber(subscriber, hooksFactory(subscriber))\n    );\n}\n\n/** Creates a filtering operator that replenishes only values dropped from finite demand. */\nexport function liftFilter<T>(\n    source: Flux<T>,\n    sourceFactory: SourceFactory<T>,\n    predicate: (value: T) => boolean\n): Flux<T> {\n    return liftFlux(source, sourceFactory, subscriber => new FilterOperatorSubscriber(subscriber, predicate));\n}\n\n/** Returns the context exposed by a subscriber, or the shared empty context. */\nexport function subscriberContext<T>(subscriber: Subscriber<T>): Context {\n    return (subscriber as CoreSubscriber<T>).currentContext?.() ?? Context.empty();\n}\n\n/** Flux whose normal subscribe path is assembled through a subscriber lifter. */\nclass LiftedFlux<T, R> extends Flux<R> {\n    /** Creates a lifted Flux around an upstream source. */\n    public constructor(\n        private readonly source: Flux<T>,\n        sourceFactory: SourceFactory<R>,\n        private readonly lifter: SubscriberLifter<T, R>\n    ) {\n        super(sourceFactory);\n    }\n\n    /** Subscribes without crossing the async-iterator bridge. */\n    protected override subscribeActual(subscriber: Subscriber<R>): void {\n        let upstreamSubscriber: Subscriber<T>;\n        try {\n            upstreamSubscriber = this.lifter(subscriber);\n        } catch (error) {\n            signalAssemblyError(subscriber, error);\n            return;\n        }\n        this.source.subscribe(upstreamSubscriber);\n    }\n}\n\n/** Subscription/subscriber pair shared by synchronous one-to-one operators. */\nclass OneToOneOperatorSubscriber<T, R> implements CoreSubscriber<T>, Subscription {\n    /** Upstream subscription received during the Reactive Streams handshake. */\n    private upstream: Subscription | undefined;\n    /** Prevents duplicate subscriptions from replacing the active upstream. */\n    private subscribed = false;\n    /** Suppresses signals and demand after cancellation or termination. */\n    private terminated = false;\n\n    /** Creates a one-to-one operator subscriber. */\n    public constructor(\n        private readonly actual: Subscriber<R>,\n        private readonly hooks: OneToOneOperatorHooks<T, R>\n    ) {\n    }\n\n    /** Installs the upstream subscription and exposes this forwarding subscription downstream. */\n    public onSubscribe(subscription: Subscription): void {\n        if (this.subscribed || this.terminated) {\n            subscription.cancel();\n            return;\n        }\n        this.subscribed = true;\n        this.upstream = subscription;\n\n        try {\n            this.hooks.onSubscribe?.(subscription);\n        } catch (error) {\n            this.terminated = true;\n            cancelSilently(subscription);\n            this.actual.onSubscribe(this);\n            this.signalError(error);\n            return;\n        }\n\n        try {\n            this.actual.onSubscribe(this);\n        } catch (error) {\n            this.terminated = true;\n            try {\n                subscription.cancel();\n            } finally {\n                this.runFinally(\"cancel\");\n            }\n            throw error;\n        }\n    }\n\n    /** Converts and forwards one upstream value without changing demand. */\n    public onNext(value: T): void {\n        if (this.terminated) {\n            return;\n        }\n        let mapped: R;\n        try {\n            mapped = this.hooks.onNext(value);\n        } catch (error) {\n            this.terminateWithError(error, true);\n            return;\n        }\n        this.actual.onNext(mapped);\n    }\n\n    /** Forwards an upstream error after running the operator callback. */\n    public onError(error: unknown): void {\n        this.terminateWithError(error, false);\n    }\n\n    /** Forwards successful completion after running the operator callback. */\n    public onComplete(): void {\n        if (this.terminated) {\n            return;\n        }\n        try {\n            this.hooks.onComplete?.();\n        } catch (error) {\n            this.terminateWithError(error, false);\n            return;\n        }\n        this.terminated = true;\n        try {\n            this.actual.onComplete();\n        } finally {\n            this.runFinally(\"complete\");\n        }\n    }\n\n    /** Forwards exactly the requested amount to upstream. */\n    public request(n: number): void {\n        if (this.terminated) {\n            return;\n        }\n        try {\n            this.hooks.onRequest?.(n);\n        } catch (error) {\n            this.terminateWithError(error, true);\n            return;\n        }\n        this.upstream?.request(n);\n    }\n\n    /** Cancels upstream once and reports the cancellation lifecycle hooks. */\n    public cancel(): void {\n        if (this.terminated) {\n            return;\n        }\n        this.terminated = true;\n        try {\n            this.upstream?.cancel();\n        } finally {\n            try {\n                this.hooks.onCancel?.();\n            } finally {\n                this.runFinally(\"cancel\");\n            }\n        }\n    }\n\n    /** Exposes downstream context to context-aware upstream publishers. */\n    public currentContext(): Context {\n        return this.hooks.currentContext?.() ?? subscriberContext(this.actual);\n    }\n\n    /** Cancels when needed and emits one downstream error signal. */\n    private terminateWithError(error: unknown, cancelUpstream: boolean): void {\n        if (this.terminated) {\n            return;\n        }\n        this.terminated = true;\n        if (cancelUpstream && this.upstream) {\n            cancelSilently(this.upstream);\n        }\n        let failure = error;\n        try {\n            this.hooks.onError?.(error);\n        } catch (callbackError) {\n            failure = callbackError;\n        }\n        this.signalError(failure);\n    }\n\n    /** Delivers an error followed by the final error callback. */\n    private signalError(error: unknown): void {\n        try {\n            this.actual.onError(error);\n        } finally {\n            this.runFinally(\"error\");\n        }\n    }\n\n    /** Runs a final callback without letting observer code alter terminal semantics. */\n    private runFinally(signal: \"complete\" | \"error\" | \"cancel\"): void {\n        try {\n            this.hooks.onFinally?.(signal);\n        } catch {\n            // Final observers run after propagation and cannot replace the terminal signal.\n        }\n    }\n}\n\n/** Filtering subscriber with stack-safe compensation for dropped values. */\nclass FilterOperatorSubscriber<T> implements CoreSubscriber<T>, Subscription {\n    /** Upstream subscription received during the Reactive Streams handshake. */\n    private upstream: Subscription | undefined;\n    /** Prevents duplicate subscriptions from replacing the active upstream. */\n    private subscribed = false;\n    /** Suppresses signals and demand after cancellation or termination. */\n    private terminated = false;\n    /** Avoids compensation requests after downstream switches to unbounded demand. */\n    private unbounded = false;\n    /** Guards synchronous request calls against reentrant compensation. */\n    private requesting = false;\n    /** Compensation or downstream demand accumulated during an active request call. */\n    private missedRequested = 0;\n\n    /** Creates a filtering subscriber. */\n    public constructor(\n        private readonly actual: Subscriber<T>,\n        private readonly predicate: (value: T) => boolean\n    ) {\n    }\n\n    /** Installs upstream and exposes the demand-forwarding subscription downstream. */\n    public onSubscribe(subscription: Subscription): void {\n        if (this.subscribed || this.terminated) {\n            subscription.cancel();\n            return;\n        }\n        this.subscribed = true;\n        this.upstream = subscription;\n        try {\n            this.actual.onSubscribe(this);\n        } catch (error) {\n            this.terminated = true;\n            subscription.cancel();\n            throw error;\n        }\n    }\n\n    /** Tests one value, forwarding matches and replenishing finite demand for drops. */\n    public onNext(value: T): void {\n        if (this.terminated) {\n            return;\n        }\n        let accepted: boolean;\n        try {\n            accepted = this.predicate(value);\n        } catch (error) {\n            this.terminated = true;\n            if (this.upstream) {\n                cancelSilently(this.upstream);\n            }\n            this.actual.onError(error);\n            return;\n        }\n        if (accepted) {\n            this.actual.onNext(value);\n        } else if (!this.unbounded) {\n            this.requestUpstream(1);\n        }\n    }\n\n    /** Forwards one terminal error. */\n    public onError(error: unknown): void {\n        if (this.terminated) {\n            return;\n        }\n        this.terminated = true;\n        this.actual.onError(error);\n    }\n\n    /** Forwards successful completion once. */\n    public onComplete(): void {\n        if (this.terminated) {\n            return;\n        }\n        this.terminated = true;\n        this.actual.onComplete();\n    }\n\n    /** Forwards demand and records when no further compensation is necessary. */\n    public request(n: number): void {\n        if (this.terminated) {\n            return;\n        }\n        if (n === Number.POSITIVE_INFINITY) {\n            this.unbounded = true;\n        }\n        this.requestUpstream(n);\n    }\n\n    /** Cancels the upstream once. */\n    public cancel(): void {\n        if (this.terminated) {\n            return;\n        }\n        this.terminated = true;\n        this.upstream?.cancel();\n    }\n\n    /** Exposes the downstream context unchanged. */\n    public currentContext(): Context {\n        return subscriberContext(this.actual);\n    }\n\n    /** Drains demand iteratively so synchronous sources cannot recurse through dropped values. */\n    private requestUpstream(n: number): void {\n        if (this.requesting) {\n            this.missedRequested = addCap(this.missedRequested, n);\n            return;\n        }\n        const upstream = this.upstream;\n        if (!upstream) {\n            return;\n        }\n        this.requesting = true;\n        let request = n;\n        try {\n            while (!this.terminated) {\n                upstream.request(request);\n                if (this.terminated || this.missedRequested === 0) {\n                    return;\n                }\n                request = this.missedRequested;\n                this.missedRequested = 0;\n            }\n        } finally {\n            this.requesting = false;\n        }\n    }\n}\n\n/** Signals a lifter assembly failure through a valid Reactive Streams handshake. */\nfunction signalAssemblyError<T>(subscriber: Subscriber<T>, error: unknown): void {\n    subscriber.onSubscribe(EMPTY_SUBSCRIPTION);\n    subscriber.onError(error);\n}\n\n/** Cancels an upstream while preserving the original operator failure. */\nfunction cancelSilently(subscription: Subscription): void {\n    try {\n        subscription.cancel();\n    } catch {\n        // The operator failure remains the terminal signal.\n    }\n}\n\n/** Shared inert subscription used only when operator assembly fails. */\nconst EMPTY_SUBSCRIPTION: Subscription = Object.freeze({\n    /** Ignores requests because the sequence has already failed. */\n    request() {\n        // no-op\n    },\n    /** Ignores cancellation because no upstream was subscribed. */\n    cancel() {\n        // no-op\n    }\n});\n"],"mappings":"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"}

package/dist/publisher/operators/selection.d.ts

@@ -16,6 +16,11 @@ declare module "../flux.js" {
         distinct<K = T>(keySelector?: (value: T) => K): Flux<T>;
         /** Drops adjacent values whose selected key is equal to the previous key. */
         distinctUntilChanged<K = T>(keySelector?: (value: T) => K): Flux<T>;
+        /**
+         * Drops adjacent values with equal nested state. Snapshots arrays, enumerable properties of ordinary objects,
+         * and local `Date`, `RegExp`, `Map` and `Set` values; other object types retain identity comparison.
+         */
+        distinctUntilChangedDeep<K = T>(keySelector?: (value: T) => K): Flux<T>;
         /** Emits `defaultValue` when the source completes without values. */
         defaultIfEmpty(defaultValue: T): Flux<T>;
         /** Switches to `alternate` when the source completes without values. */

package/dist/publisher/operators/selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/publisher/operators/selection.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEzD,OAAO,QAAQ,qBAAqB,CAAC;IACjC,uDAAuD;IACvD,UAAU,IAAI,CAAC,CAAC;QACZ,iDAAiD;QACjD,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzB,4EAA4E;QAC5E,SAAS,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAErD,mFAAmF;QACnF,SAAS,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAErD,yCAAyC;QACzC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzB,2EAA2E;QAC3E,SAAS,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAErD,wDAAwD;QACxD,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAExD,6EAA6E;QAC7E,oBAAoB,CAAC,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpE,qEAAqE;QACrE,cAAc,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzC,wEAAwE;QACxE,aAAa,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;KACxD;CACJ"}
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/publisher/operators/selection.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEzD,OAAO,QAAQ,qBAAqB,CAAC;IACjC,uDAAuD;IACvD,UAAU,IAAI,CAAC,CAAC;QACZ,iDAAiD;QACjD,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzB,4EAA4E;QAC5E,SAAS,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAErD,mFAAmF;QACnF,SAAS,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAErD,yCAAyC;QACzC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzB,2EAA2E;QAC3E,SAAS,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAErD,wDAAwD;QACxD,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAExD,6EAA6E;QAC7E,oBAAoB,CAAC,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpE;;;WAGG;QACH,wBAAwB,CAAC,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAExE,qEAAqE;QACrE,cAAc,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzC,wEAAwE;QACxE,aAAa,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;KACxD;CACJ"}

package/dist/publisher/operators/selection.js

@@ -2,6 +2,7 @@ import { isAsyncIterable, toAsyncIterator } from "../../internal/iterable.js";
 import { defaultIfEmptyIterable, distinctIterable, distinctUntilChangedIterable, skipIterable, skipWhileIterable, takeUntilIterable, takeWhileIterable } from "../../internal/iterable-transform.js";
 import { identity } from "../helpers.js";
 import { Flux } from "../flux.js";
+import { deepEqual, snapshotDeep } from "../../internal/deep-value.js";
 //#region src/publisher/operators/selection.ts
 /**
 * @packageDocumentation
@@ -88,6 +89,13 @@ Flux.prototype.distinctUntilChanged = function distinctUntilChanged(keySelector
 	const source = this;
 	return new Flux((signal, context) => distinctUntilChangedIterable(source.iterate(signal, context), keySelector));
 };
+Flux.prototype.distinctUntilChangedDeep = function distinctUntilChangedDeep(keySelector = identity) {
+	const source = this;
+	return new Flux((signal, context) => distinctUntilChangedIterable(source.iterate(signal, context), keySelector, {
+		equals: deepEqual,
+		snapshot: snapshotDeep
+	}));
+};
 Flux.prototype.defaultIfEmpty = function defaultIfEmpty(defaultValue) {
 	const source = this;
 	return new Flux((signal, context) => defaultIfEmptyIterable(source.iterate(signal, context), defaultValue));

package/dist/publisher/operators/selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"selection.js","names":[],"sources":["../../../src/publisher/operators/selection.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Flux, Mono and operator implementation modules.\n */\nimport {Flux} from \"@/publisher/flux.js\";\nimport {\n    type AnyIterable,\n    isAsyncIterable,\n    toAsyncIterator\n} from \"@/internal/iterable.js\";\nimport {\n    defaultIfEmptyIterable,\n    distinctIterable,\n    distinctUntilChangedIterable,\n    skipIterable,\n    skipWhileIterable,\n    takeUntilIterable,\n    takeWhileIterable\n} from \"@/internal/iterable-transform.js\";\nimport {identity} from \"@/publisher/helpers.js\";\nimport type {PublisherInput} from \"@/publisher/types.js\";\n\ndeclare module \"@/publisher/flux.js\" {\n    /** Selection and filtering operators added to Flux. */\n    interface Flux<T> {\n        /** Emits at most the first `n` source values. */\n        take(n: number): Flux<T>;\n\n        /** Emits values while the predicate returns true, then cancels upstream. */\n        takeWhile(predicate: (value: T) => boolean): Flux<T>;\n\n        /** Emits values until the predicate returns true, including the matching value. */\n        takeUntil(predicate: (value: T) => boolean): Flux<T>;\n\n        /** Drops the first `n` source values. */\n        skip(n: number): Flux<T>;\n\n        /** Drops values while the predicate returns true, then relays the rest. */\n        skipWhile(predicate: (value: T) => boolean): Flux<T>;\n\n        /** Emits only the first value for each selected key. */\n        distinct<K = T>(keySelector?: (value: T) => K): Flux<T>;\n\n        /** Drops adjacent values whose selected key is equal to the previous key. */\n        distinctUntilChanged<K = T>(keySelector?: (value: T) => K): Flux<T>;\n\n        /** Emits `defaultValue` when the source completes without values. */\n        defaultIfEmpty(defaultValue: T): Flux<T>;\n\n        /** Switches to `alternate` when the source completes without values. */\n        switchIfEmpty(alternate: PublisherInput<T>): Flux<T>;\n    }\n}\n\nFlux.prototype.take = function take<T>(this: Flux<T>, n: number): Flux<T> {\n    if (!Number.isInteger(n) || n < 0) {\n        throw new RangeError(\"take expects a non-negative integer\");\n    }\n    if (n === 0) {\n        return Flux.empty<T>();\n    }\n    const source = this;\n    return new Flux((signal, context) => {\n        const controller = new AbortController();\n        const abort = () => controller.abort(signal.reason);\n        signal.addEventListener(\"abort\", abort, {once: true});\n        let values: AnyIterable<T>;\n        try {\n            values = source.iterate(controller.signal, context);\n        } catch (error) {\n            signal.removeEventListener(\"abort\", abort);\n            throw error;\n        }\n        if (!isAsyncIterable<T>(values)) {\n            return (function* () {\n                let remaining = n;\n                try {\n                    for (const value of values) {\n                        yield value;\n                        remaining -= 1;\n                        if (remaining === 0) {\n                            controller.abort();\n                            return;\n                        }\n                    }\n                } finally {\n                    signal.removeEventListener(\"abort\", abort);\n                    if (signal.aborted && !controller.signal.aborted) {\n                        controller.abort(signal.reason);\n                    }\n                }\n            })();\n        }\n        return (async function* () {\n            const iterator = toAsyncIterator(values);\n            let remaining = n;\n            let cancelledSource = false;\n            try {\n                while (!signal.aborted) {\n                    const result = await iterator.next();\n                    if (result.done) {\n                        return;\n                    }\n                    yield result.value;\n                    remaining -= 1;\n                    if (remaining === 0) {\n                        cancelledSource = true;\n                        controller.abort();\n                        return;\n                    }\n                }\n            } finally {\n                signal.removeEventListener(\"abort\", abort);\n                if (signal.aborted && !controller.signal.aborted) {\n                    controller.abort(signal.reason);\n                }\n                if (cancelledSource || signal.aborted) {\n                    await iterator.return?.();\n                }\n            }\n        })();\n    });\n};\n\nFlux.prototype.takeWhile = function takeWhile<T>(this: Flux<T>, predicate: (value: T) => boolean): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => takeWhileIterable(source.iterate(signal, context), predicate));\n};\n\nFlux.prototype.takeUntil = function takeUntil<T>(this: Flux<T>, predicate: (value: T) => boolean): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => takeUntilIterable(source.iterate(signal, context), predicate));\n};\n\nFlux.prototype.skip = function skip<T>(this: Flux<T>, n: number): Flux<T> {\n    if (!Number.isInteger(n) || n < 0) {\n        throw new RangeError(\"skip expects a non-negative integer\");\n    }\n    if (n === 0) {\n        return this;\n    }\n    const source = this;\n    return new Flux((signal, context) => skipIterable(source.iterate(signal, context), n));\n};\n\nFlux.prototype.skipWhile = function skipWhile<T>(this: Flux<T>, predicate: (value: T) => boolean): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => skipWhileIterable(source.iterate(signal, context), predicate));\n};\n\nFlux.prototype.distinct = function distinct<T, K = T>(\n    this: Flux<T>,\n    keySelector: (value: T) => K = identity as (value: T) => K\n): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => distinctIterable(source.iterate(signal, context), keySelector));\n};\n\nFlux.prototype.distinctUntilChanged = function distinctUntilChanged<T, K = T>(\n    this: Flux<T>,\n    keySelector: (value: T) => K = identity as (value: T) => K\n): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => distinctUntilChangedIterable(source.iterate(signal, context), keySelector));\n};\n\nFlux.prototype.defaultIfEmpty = function defaultIfEmpty<T>(this: Flux<T>, defaultValue: T): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => defaultIfEmptyIterable(source.iterate(signal, context), defaultValue));\n};\n\nFlux.prototype.switchIfEmpty = function switchIfEmpty<T>(this: Flux<T>, alternate: PublisherInput<T>): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let empty = true;\n        for await (const value of source.iterate(signal, context)) {\n            empty = false;\n            yield value;\n        }\n        if (empty) {\n            for await (const value of Flux.from(alternate).iterate(signal, context)) {\n                yield value;\n            }\n        }\n    });\n};\n"],"mappings":"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"}
+{"version":3,"file":"selection.js","names":[],"sources":["../../../src/publisher/operators/selection.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Flux, Mono and operator implementation modules.\n */\nimport {deepEqual, snapshotDeep} from \"@/internal/deep-value.js\";\nimport {\n    type AnyIterable,\n    isAsyncIterable,\n    toAsyncIterator\n} from \"@/internal/iterable.js\";\nimport {\n    defaultIfEmptyIterable,\n    distinctIterable,\n    distinctUntilChangedIterable,\n    skipIterable,\n    skipWhileIterable,\n    takeUntilIterable,\n    takeWhileIterable\n} from \"@/internal/iterable-transform.js\";\nimport {Flux} from \"@/publisher/flux.js\";\nimport {identity} from \"@/publisher/helpers.js\";\nimport type {PublisherInput} from \"@/publisher/types.js\";\n\ndeclare module \"@/publisher/flux.js\" {\n    /** Selection and filtering operators added to Flux. */\n    interface Flux<T> {\n        /** Emits at most the first `n` source values. */\n        take(n: number): Flux<T>;\n\n        /** Emits values while the predicate returns true, then cancels upstream. */\n        takeWhile(predicate: (value: T) => boolean): Flux<T>;\n\n        /** Emits values until the predicate returns true, including the matching value. */\n        takeUntil(predicate: (value: T) => boolean): Flux<T>;\n\n        /** Drops the first `n` source values. */\n        skip(n: number): Flux<T>;\n\n        /** Drops values while the predicate returns true, then relays the rest. */\n        skipWhile(predicate: (value: T) => boolean): Flux<T>;\n\n        /** Emits only the first value for each selected key. */\n        distinct<K = T>(keySelector?: (value: T) => K): Flux<T>;\n\n        /** Drops adjacent values whose selected key is equal to the previous key. */\n        distinctUntilChanged<K = T>(keySelector?: (value: T) => K): Flux<T>;\n\n        /**\n         * Drops adjacent values with equal nested state. Snapshots arrays, enumerable properties of ordinary objects,\n         * and local `Date`, `RegExp`, `Map` and `Set` values; other object types retain identity comparison.\n         */\n        distinctUntilChangedDeep<K = T>(keySelector?: (value: T) => K): Flux<T>;\n\n        /** Emits `defaultValue` when the source completes without values. */\n        defaultIfEmpty(defaultValue: T): Flux<T>;\n\n        /** Switches to `alternate` when the source completes without values. */\n        switchIfEmpty(alternate: PublisherInput<T>): Flux<T>;\n    }\n}\n\nFlux.prototype.take = function take<T>(this: Flux<T>, n: number): Flux<T> {\n    if (!Number.isInteger(n) || n < 0) {\n        throw new RangeError(\"take expects a non-negative integer\");\n    }\n    if (n === 0) {\n        return Flux.empty<T>();\n    }\n    const source = this;\n    return new Flux((signal, context) => {\n        const controller = new AbortController();\n        const abort = () => controller.abort(signal.reason);\n        signal.addEventListener(\"abort\", abort, {once: true});\n        let values: AnyIterable<T>;\n        try {\n            values = source.iterate(controller.signal, context);\n        } catch (error) {\n            signal.removeEventListener(\"abort\", abort);\n            throw error;\n        }\n        if (!isAsyncIterable<T>(values)) {\n            return (function* () {\n                let remaining = n;\n                try {\n                    for (const value of values) {\n                        yield value;\n                        remaining -= 1;\n                        if (remaining === 0) {\n                            controller.abort();\n                            return;\n                        }\n                    }\n                } finally {\n                    signal.removeEventListener(\"abort\", abort);\n                    if (signal.aborted && !controller.signal.aborted) {\n                        controller.abort(signal.reason);\n                    }\n                }\n            })();\n        }\n        return (async function* () {\n            const iterator = toAsyncIterator(values);\n            let remaining = n;\n            let cancelledSource = false;\n            try {\n                while (!signal.aborted) {\n                    const result = await iterator.next();\n                    if (result.done) {\n                        return;\n                    }\n                    yield result.value;\n                    remaining -= 1;\n                    if (remaining === 0) {\n                        cancelledSource = true;\n                        controller.abort();\n                        return;\n                    }\n                }\n            } finally {\n                signal.removeEventListener(\"abort\", abort);\n                if (signal.aborted && !controller.signal.aborted) {\n                    controller.abort(signal.reason);\n                }\n                if (cancelledSource || signal.aborted) {\n                    await iterator.return?.();\n                }\n            }\n        })();\n    });\n};\n\nFlux.prototype.takeWhile = function takeWhile<T>(this: Flux<T>, predicate: (value: T) => boolean): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => takeWhileIterable(source.iterate(signal, context), predicate));\n};\n\nFlux.prototype.takeUntil = function takeUntil<T>(this: Flux<T>, predicate: (value: T) => boolean): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => takeUntilIterable(source.iterate(signal, context), predicate));\n};\n\nFlux.prototype.skip = function skip<T>(this: Flux<T>, n: number): Flux<T> {\n    if (!Number.isInteger(n) || n < 0) {\n        throw new RangeError(\"skip expects a non-negative integer\");\n    }\n    if (n === 0) {\n        return this;\n    }\n    const source = this;\n    return new Flux((signal, context) => skipIterable(source.iterate(signal, context), n));\n};\n\nFlux.prototype.skipWhile = function skipWhile<T>(this: Flux<T>, predicate: (value: T) => boolean): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => skipWhileIterable(source.iterate(signal, context), predicate));\n};\n\nFlux.prototype.distinct = function distinct<T, K = T>(\n    this: Flux<T>,\n    keySelector: (value: T) => K = identity as (value: T) => K\n): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => distinctIterable(source.iterate(signal, context), keySelector));\n};\n\nFlux.prototype.distinctUntilChanged = function distinctUntilChanged<T, K = T>(\n    this: Flux<T>,\n    keySelector: (value: T) => K = identity as (value: T) => K\n): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => distinctUntilChangedIterable(source.iterate(signal, context), keySelector));\n};\n\nFlux.prototype.distinctUntilChangedDeep = function distinctUntilChangedDeep<T, K = T>(\n    this: Flux<T>,\n    keySelector: (value: T) => K = identity as (value: T) => K\n): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => distinctUntilChangedIterable(source.iterate(signal, context), keySelector, {\n        equals: deepEqual,\n        snapshot: snapshotDeep\n    }));\n};\n\nFlux.prototype.defaultIfEmpty = function defaultIfEmpty<T>(this: Flux<T>, defaultValue: T): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => defaultIfEmptyIterable(source.iterate(signal, context), defaultValue));\n};\n\nFlux.prototype.switchIfEmpty = function switchIfEmpty<T>(this: Flux<T>, alternate: PublisherInput<T>): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let empty = true;\n        for await (const value of source.iterate(signal, context)) {\n            empty = false;\n            yield value;\n        }\n        if (empty) {\n            for await (const value of Flux.from(alternate).iterate(signal, context)) {\n                yield value;\n            }\n        }\n    });\n};\n"],"mappings":"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"}

package/dist/publisher/operators/side-effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"side-effect.d.ts","sourceRoot":"","sources":["../../../src/publisher/operators/side-effect.ts"],"names":[],"mappings":"AAMA,OAAO,QAAQ,qBAAqB,CAAC;IACjC,oDAAoD;IACpD,UAAU,IAAI,CAAC,CAAC;QACZ,uEAAuE;QACvE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEhD,6EAA6E;QAC7E,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEvD,kEAAkE;QAClE,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE5C,wEAAwE;QACxE,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;KACnF;CACJ"}
+{"version":3,"file":"side-effect.d.ts","sourceRoot":"","sources":["../../../src/publisher/operators/side-effect.ts"],"names":[],"mappings":"AAOA,OAAO,QAAQ,qBAAqB,CAAC;IACjC,oDAAoD;IACpD,UAAU,IAAI,CAAC,CAAC;QACZ,uEAAuE;QACvE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEhD,6EAA6E;QAC7E,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEvD,kEAAkE;QAClE,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE5C,wEAAwE;QACxE,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;KACnF;CACJ"}

package/dist/publisher/operators/side-effect.js

@@ -1,4 +1,5 @@
 import { Flux } from "../flux.js";
+import { liftOneToOne } from "./lift.js";
 //#region src/publisher/operators/side-effect.ts
 /**
 * @packageDocumentation
@@ -6,34 +7,45 @@ import { Flux } from "../flux.js";
 */
 Flux.prototype.doOnNext = function doOnNext(callback) {
 	const source = this;
-	return new Flux(async function* (signal, context) {
+	return liftOneToOne(source, async function* (signal, context) {
 		for await (const value of source.iterate(signal, context)) {
 			callback(value);
 			yield value;
 		}
-	});
+	}, () => ({ 
+	/** Runs the side effect and retains the original value. */
+onNext(value) {
+		callback(value);
+		return value;
+	} }));
 };
 Flux.prototype.doOnError = function doOnError(callback) {
 	const source = this;
-	return new Flux(async function* (signal, context) {
+	return liftOneToOne(source, async function* (signal, context) {
 		try {
 			for await (const value of source.iterate(signal, context)) yield value;
 		} catch (error) {
 			callback(error);
 			throw error;
 		}
-	});
+	}, () => ({
+		onNext: passThrough,
+		onError: callback
+	}));
 };
 Flux.prototype.doOnComplete = function doOnComplete(callback) {
 	const source = this;
-	return new Flux(async function* (signal, context) {
+	return liftOneToOne(source, async function* (signal, context) {
 		for await (const value of source.iterate(signal, context)) yield value;
 		callback();
-	});
+	}, () => ({
+		onNext: passThrough,
+		onComplete: callback
+	}));
 };
 Flux.prototype.doFinally = function doFinally(callback) {
 	const source = this;
-	return new Flux(async function* (signal, context) {
+	return liftOneToOne(source, async function* (signal, context) {
 		let terminal = "complete";
 		try {
 			for await (const value of source.iterate(signal, context)) {
@@ -47,10 +59,23 @@ Flux.prototype.doFinally = function doFinally(callback) {
 			terminal = signal.aborted ? "cancel" : "error";
 			throw error;
 		} finally {
-			callback(signal.aborted ? "cancel" : terminal);
+			runFinallyCallback(callback, signal.aborted ? "cancel" : terminal);
 		}
-	});
+	}, () => ({
+		onNext: passThrough,
+		onFinally: callback
+	}));
 };
+/** Returns an operator value unchanged. */
+function passThrough(value) {
+	return value;
+}
+/** Runs a final observer without allowing it to replace sequence termination. */
+function runFinallyCallback(callback, signal) {
+	try {
+		callback(signal);
+	} catch {}
+}
 //#endregion
 
 //# sourceMappingURL=side-effect.js.map

package/dist/publisher/operators/side-effect.js.map

@@ -1 +1 @@
-{"version":3,"file":"side-effect.js","names":[],"sources":["../../../src/publisher/operators/side-effect.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Flux, Mono and operator implementation modules.\n */\nimport {Flux} from \"@/publisher/flux.js\";\n\ndeclare module \"@/publisher/flux.js\" {\n    /** Side-effect callback operators added to Flux. */\n    interface Flux<T> {\n        /** Invokes a callback for each value without changing the sequence. */\n        doOnNext(callback: (value: T) => void): Flux<T>;\n\n        /** Invokes a callback when the source fails without recovering the error. */\n        doOnError(callback: (error: unknown) => void): Flux<T>;\n\n        /** Invokes a callback after the source completes successfully. */\n        doOnComplete(callback: () => void): Flux<T>;\n\n        /** Invokes a callback once after completion, error, or cancellation. */\n        doFinally(callback: (signal: \"complete\" | \"error\" | \"cancel\") => void): Flux<T>;\n    }\n}\n\nFlux.prototype.doOnNext = function doOnNext<T>(this: Flux<T>, callback: (value: T) => void): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        for await (const value of source.iterate(signal, context)) {\n            callback(value);\n            yield value;\n        }\n    });\n};\n\nFlux.prototype.doOnError = function doOnError<T>(this: Flux<T>, callback: (error: unknown) => void): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        try {\n            for await (const value of source.iterate(signal, context)) {\n                yield value;\n            }\n        } catch (error) {\n            callback(error);\n            throw error;\n        }\n    });\n};\n\nFlux.prototype.doOnComplete = function doOnComplete<T>(this: Flux<T>, callback: () => void): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        for await (const value of source.iterate(signal, context)) {\n            yield value;\n        }\n        callback();\n    });\n};\n\nFlux.prototype.doFinally = function doFinally<T>(\n    this: Flux<T>,\n    callback: (signal: \"complete\" | \"error\" | \"cancel\") => void\n): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let terminal: \"complete\" | \"error\" | \"cancel\" = \"complete\";\n        try {\n            for await (const value of source.iterate(signal, context)) {\n                if (signal.aborted) {\n                    terminal = \"cancel\";\n                    return;\n                }\n                yield value;\n            }\n        } catch (error) {\n            terminal = signal.aborted ? \"cancel\" : \"error\";\n            throw error;\n        } finally {\n            callback(signal.aborted ? \"cancel\" : terminal);\n        }\n    });\n};\n"],"mappings":";;;;;;AAuBA,KAAK,UAAU,WAAW,SAAS,SAA2B,UAAuC;CACjG,MAAM,SAAS;CACf,OAAO,IAAI,KAAK,iBAAiB,QAAQ,SAAS;EAC9C,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GAAG;GACvD,SAAS,KAAK;GACd,MAAM;EACV;CACJ,CAAC;AACL;AAEA,KAAK,UAAU,YAAY,SAAS,UAA4B,UAA6C;CACzG,MAAM,SAAS;CACf,OAAO,IAAI,KAAK,iBAAiB,QAAQ,SAAS;EAC9C,IAAI;GACA,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GACpD,MAAM;EAEd,SAAS,OAAO;GACZ,SAAS,KAAK;GACd,MAAM;EACV;CACJ,CAAC;AACL;AAEA,KAAK,UAAU,eAAe,SAAS,aAA+B,UAA+B;CACjG,MAAM,SAAS;CACf,OAAO,IAAI,KAAK,iBAAiB,QAAQ,SAAS;EAC9C,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GACpD,MAAM;EAEV,SAAS;CACb,CAAC;AACL;AAEA,KAAK,UAAU,YAAY,SAAS,UAEhC,UACO;CACP,MAAM,SAAS;CACf,OAAO,IAAI,KAAK,iBAAiB,QAAQ,SAAS;EAC9C,IAAI,WAA4C;EAChD,IAAI;GACA,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GAAG;IACvD,IAAI,OAAO,SAAS;KAChB,WAAW;KACX;IACJ;IACA,MAAM;GACV;EACJ,SAAS,OAAO;GACZ,WAAW,OAAO,UAAU,WAAW;GACvC,MAAM;EACV,UAAU;GACN,SAAS,OAAO,UAAU,WAAW,QAAQ;EACjD;CACJ,CAAC;AACL"}
+{"version":3,"file":"side-effect.js","names":[],"sources":["../../../src/publisher/operators/side-effect.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Flux, Mono and operator implementation modules.\n */\nimport {Flux} from \"@/publisher/flux.js\";\nimport {liftOneToOne} from \"@/publisher/operators/lift.js\";\n\ndeclare module \"@/publisher/flux.js\" {\n    /** Side-effect callback operators added to Flux. */\n    interface Flux<T> {\n        /** Invokes a callback for each value without changing the sequence. */\n        doOnNext(callback: (value: T) => void): Flux<T>;\n\n        /** Invokes a callback when the source fails without recovering the error. */\n        doOnError(callback: (error: unknown) => void): Flux<T>;\n\n        /** Invokes a callback after the source completes successfully. */\n        doOnComplete(callback: () => void): Flux<T>;\n\n        /** Invokes a callback once after completion, error, or cancellation. */\n        doFinally(callback: (signal: \"complete\" | \"error\" | \"cancel\") => void): Flux<T>;\n    }\n}\n\nFlux.prototype.doOnNext = function doOnNext<T>(this: Flux<T>, callback: (value: T) => void): Flux<T> {\n    const source = this;\n    return liftOneToOne(\n        source,\n        async function* (signal, context) {\n            for await (const value of source.iterate(signal, context)) {\n                callback(value);\n                yield value;\n            }\n        },\n        () => ({\n            /** Runs the side effect and retains the original value. */\n            onNext(value) {\n                callback(value);\n                return value;\n            }\n        })\n    );\n};\n\nFlux.prototype.doOnError = function doOnError<T>(this: Flux<T>, callback: (error: unknown) => void): Flux<T> {\n    const source = this;\n    return liftOneToOne(\n        source,\n        async function* (signal, context) {\n            try {\n                for await (const value of source.iterate(signal, context)) {\n                    yield value;\n                }\n            } catch (error) {\n                callback(error);\n                throw error;\n            }\n        },\n        () => ({\n            onNext: passThrough,\n            onError: callback\n        })\n    );\n};\n\nFlux.prototype.doOnComplete = function doOnComplete<T>(this: Flux<T>, callback: () => void): Flux<T> {\n    const source = this;\n    return liftOneToOne(\n        source,\n        async function* (signal, context) {\n            for await (const value of source.iterate(signal, context)) {\n                yield value;\n            }\n            callback();\n        },\n        () => ({\n            onNext: passThrough,\n            onComplete: callback\n        })\n    );\n};\n\nFlux.prototype.doFinally = function doFinally<T>(\n    this: Flux<T>,\n    callback: (signal: \"complete\" | \"error\" | \"cancel\") => void\n): Flux<T> {\n    const source = this;\n    return liftOneToOne(\n        source,\n        async function* (signal, context) {\n            let terminal: \"complete\" | \"error\" | \"cancel\" = \"complete\";\n            try {\n                for await (const value of source.iterate(signal, context)) {\n                    if (signal.aborted) {\n                        terminal = \"cancel\";\n                        return;\n                    }\n                    yield value;\n                }\n            } catch (error) {\n                terminal = signal.aborted ? \"cancel\" : \"error\";\n                throw error;\n            } finally {\n                runFinallyCallback(callback, signal.aborted ? \"cancel\" : terminal);\n            }\n        },\n        () => ({\n            onNext: passThrough,\n            onFinally: callback\n        })\n    );\n};\n\n/** Returns an operator value unchanged. */\nfunction passThrough<T>(value: T): T {\n    return value;\n}\n\n/** Runs a final observer without allowing it to replace sequence termination. */\nfunction runFinallyCallback(\n    callback: (signal: \"complete\" | \"error\" | \"cancel\") => void,\n    signal: \"complete\" | \"error\" | \"cancel\"\n): void {\n    try {\n        callback(signal);\n    } catch {\n        // Final observers run after propagation and cannot replace the terminal signal.\n    }\n}\n"],"mappings":";;;;;;;AAwBA,KAAK,UAAU,WAAW,SAAS,SAA2B,UAAuC;CACjG,MAAM,SAAS;CACf,OAAO,aACH,QACA,iBAAiB,QAAQ,SAAS;EAC9B,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GAAG;GACvD,SAAS,KAAK;GACd,MAAM;EACV;CACJ,UACO;;AAEH,OAAO,OAAO;EACV,SAAS,KAAK;EACd,OAAO;CACX,EACJ,EACJ;AACJ;AAEA,KAAK,UAAU,YAAY,SAAS,UAA4B,UAA6C;CACzG,MAAM,SAAS;CACf,OAAO,aACH,QACA,iBAAiB,QAAQ,SAAS;EAC9B,IAAI;GACA,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GACpD,MAAM;EAEd,SAAS,OAAO;GACZ,SAAS,KAAK;GACd,MAAM;EACV;CACJ,UACO;EACH,QAAQ;EACR,SAAS;CACb,EACJ;AACJ;AAEA,KAAK,UAAU,eAAe,SAAS,aAA+B,UAA+B;CACjG,MAAM,SAAS;CACf,OAAO,aACH,QACA,iBAAiB,QAAQ,SAAS;EAC9B,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GACpD,MAAM;EAEV,SAAS;CACb,UACO;EACH,QAAQ;EACR,YAAY;CAChB,EACJ;AACJ;AAEA,KAAK,UAAU,YAAY,SAAS,UAEhC,UACO;CACP,MAAM,SAAS;CACf,OAAO,aACH,QACA,iBAAiB,QAAQ,SAAS;EAC9B,IAAI,WAA4C;EAChD,IAAI;GACA,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GAAG;IACvD,IAAI,OAAO,SAAS;KAChB,WAAW;KACX;IACJ;IACA,MAAM;GACV;EACJ,SAAS,OAAO;GACZ,WAAW,OAAO,UAAU,WAAW;GACvC,MAAM;EACV,UAAU;GACN,mBAAmB,UAAU,OAAO,UAAU,WAAW,QAAQ;EACrE;CACJ,UACO;EACH,QAAQ;EACR,WAAW;CACf,EACJ;AACJ;;AAGA,SAAS,YAAe,OAAa;CACjC,OAAO;AACX;;AAGA,SAAS,mBACL,UACA,QACI;CACJ,IAAI;EACA,SAAS,MAAM;CACnB,QAAQ,CAER;AACJ"}

package/dist/publisher/operators/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/publisher/operators/transform.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAC;AAG3D,OAAO,KAAK,EAAC,MAAM,EAAE,cAAc,EAAE,eAAe,EAAC,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE1C,OAAO,QAAQ,qBAAqB,CAAC;IACjC,gEAAgE;IAChE,UAAU,IAAI,CAAC,CAAC;QACZ,yDAAyD;QACzD,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtC,6DAA6D;QAC7D,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnB,0DAA0D;QAC1D,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAElD,mFAAmF;QACnF,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE1E,gEAAgE;QAChE,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/B,4EAA4E;QAC5E,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEjD,4EAA4E;QAC5E,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3E,8DAA8D;QAC9D,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnF,oFAAoF;QACpF,2BAA2B,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;KACtH;CACJ"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/publisher/operators/transform.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAC;AAI3D,OAAO,KAAK,EAAC,MAAM,EAAE,cAAc,EAAE,eAAe,EAAC,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE1C,OAAO,QAAQ,qBAAqB,CAAC;IACjC,gEAAgE;IAChE,UAAU,IAAI,CAAC,CAAC;QACZ,yDAAyD;QACzD,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtC,6DAA6D;QAC7D,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnB,0DAA0D;QAC1D,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAElD,mFAAmF;QACnF,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE1E,gEAAgE;QAChE,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/B,4EAA4E;QAC5E,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEjD,4EAA4E;QAC5E,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3E,8DAA8D;QAC9D,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnF,oFAAoF;QACpF,2BAA2B,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;KACtH;CACJ"}

package/dist/publisher/operators/transform.js

@@ -1,17 +1,18 @@
 import { filterIterable, mapIterable } from "../../internal/iterable-transform.js";
 import { Flux } from "../flux.js";
+import { liftFilter, liftOneToOne } from "./lift.js";
 import { Signal } from "../../signal/signal.js";
 //#region src/publisher/operators/transform.ts
 Flux.prototype.map = function map(mapper) {
 	const source = this;
-	return new Flux((signal, context) => mapIterable(source.iterate(signal, context), mapper));
+	return liftOneToOne(source, (signal, context) => mapIterable(source.iterate(signal, context), mapper), () => ({ onNext: mapper }));
 };
 Flux.prototype.cast = function cast() {
 	return this;
 };
 Flux.prototype.filter = function filter(predicate) {
 	const source = this;
-	return new Flux((signal, context) => filterIterable(source.iterate(signal, context), predicate));
+	return liftFilter(source, (signal, context) => filterIterable(source.iterate(signal, context), predicate), predicate);
 };
 Flux.prototype.handle = function handle(handler) {
 	const source = this;