reactor-core-ts 2.1.6 → 3.2.2

package/dist/publisher/operators/lifecycle.js

@@ -0,0 +1,263 @@
+import { Schedulers } from "../../schedulers/schedulers.js";
+import { scheduleDelay } from "../helpers.js";
+import { Flux } from "../flux.js";
+import { liftOneToOne, subscriberContext } from "./lift.js";
+import { Signal } from "../../signal/signal.js";
+//#region src/publisher/operators/lifecycle.ts
+Flux.prototype.cache = function cache(_ttl, _scheduler) {
+	const source = this;
+	let values;
+	let failure;
+	let loaded;
+	return new Flux(async function* (signal, context) {
+		loaded ?? (loaded = (async () => {
+			const nextValues = [];
+			try {
+				for await (const value of source.iterate(signal, context)) nextValues.push(value);
+				values = nextValues;
+			} catch (error) {
+				failure = error;
+			}
+		})());
+		await loaded;
+		if (failure !== void 0) throw failure;
+		yield* values ?? [];
+	});
+};
+Flux.prototype.cancelOn = function cancelOn(_scheduler) {
+	return this;
+};
+Flux.prototype.checkpoint = function checkpoint(_description, _forceStackTrace) {
+	return this;
+};
+Flux.prototype.contextCapture = function contextCapture() {
+	return this;
+};
+Flux.prototype.contextWrite = function contextWrite(contextUpdate) {
+	const source = this;
+	return liftOneToOne(source, (signal, context) => {
+		const nextContext = typeof contextUpdate === "function" ? contextUpdate(context) : context.putAll(contextUpdate);
+		return source.iterate(signal, nextContext);
+	}, (subscriber) => {
+		const context = subscriberContext(subscriber);
+		const nextContext = typeof contextUpdate === "function" ? contextUpdate(context) : context.putAll(contextUpdate);
+		return {
+			onNext: passThrough,
+			currentContext: () => nextContext
+		};
+	});
+};
+Flux.prototype.delaySequence = function delaySequence(delay, scheduler) {
+	return this.delaySubscription(delay, scheduler);
+};
+Flux.prototype.delaySubscription = function delaySubscription(delay, scheduler) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		if (isDuration(delay)) await scheduleDelay(scheduler ?? Schedulers.timeout(), delay, signal);
+		else await drain(delay, signal, context);
+		for await (const value of source.iterate(signal, context)) yield value;
+	});
+};
+Flux.prototype.delayUntil = function delayUntil(triggerProvider) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		for await (const value of source.iterate(signal, context)) {
+			await drain(triggerProvider(value), signal, context);
+			yield value;
+		}
+	});
+};
+Flux.prototype.doAfterTerminate = function doAfterTerminate(callback) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		let terminated = false;
+		try {
+			for await (const value of source.iterate(signal, context)) yield value;
+			terminated = true;
+		} finally {
+			if (terminated) callback();
+		}
+	});
+};
+Flux.prototype.doFirst = function doFirst(callback) {
+	const source = this;
+	return new Flux((signal, context) => {
+		callback();
+		return source.iterate(signal, context);
+	});
+};
+Flux.prototype.doOnCancel = function doOnCancel(callback) {
+	const source = this;
+	return new Flux((signal, context) => {
+		signal.addEventListener("abort", callback, { once: true });
+		return source.iterate(signal, context);
+	});
+};
+Flux.prototype.doOnDiscard = function doOnDiscard(_type, _callback) {
+	return this;
+};
+Flux.prototype.doOnEach = function doOnEach(callback) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		try {
+			for await (const value of source.iterate(signal, context)) {
+				callback(Signal.next(value));
+				yield value;
+			}
+			callback(Signal.complete());
+		} catch (error) {
+			callback(Signal.error(error));
+			throw error;
+		}
+	});
+};
+Flux.prototype.doOnRequest = function doOnRequest(callback) {
+	const source = this;
+	return liftOneToOne(source, (signal, context) => {
+		callback(Number.POSITIVE_INFINITY);
+		return source.iterate(signal, context);
+	}, () => ({
+		onNext: passThrough,
+		onRequest: callback
+	}));
+};
+Flux.prototype.doOnSubscribe = function doOnSubscribe(callback) {
+	const source = this;
+	return liftOneToOne(source, (signal, context) => {
+		callback(noopSubscription());
+		return source.iterate(signal, context);
+	}, () => ({
+		onNext: passThrough,
+		onSubscribe: callback
+	}));
+};
+Flux.prototype.doOnTerminate = function doOnTerminate(callback) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		try {
+			for await (const value of source.iterate(signal, context)) yield value;
+			callback();
+		} catch (error) {
+			callback();
+			throw error;
+		}
+	});
+};
+Flux.prototype.limitRate = function limitRate(_highTide, _lowTide) {
+	return this;
+};
+Flux.prototype.limitRequest = function limitRequest(n) {
+	return this.take(n);
+};
+Flux.prototype.log = function log(category = "Flux") {
+	return this.doOnEach((signal) => console.debug(category, signal.type, signal.value ?? signal.error));
+};
+Flux.prototype.metrics = function metrics() {
+	return this;
+};
+Flux.prototype.name = function name(_name) {
+	return this;
+};
+Flux.prototype.onBackpressureBuffer = function onBackpressureBuffer(..._args) {
+	return this;
+};
+Flux.prototype.onBackpressureDrop = function onBackpressureDrop(_callback) {
+	return this;
+};
+Flux.prototype.onBackpressureError = function onBackpressureError() {
+	return this;
+};
+Flux.prototype.onBackpressureLatest = function onBackpressureLatest() {
+	return this;
+};
+Flux.prototype.onErrorComplete = function onErrorComplete(predicate = () => true) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		try {
+			for await (const value of source.iterate(signal, context)) yield value;
+		} catch (error) {
+			if (!predicate(error)) throw error;
+		}
+	});
+};
+Flux.prototype.onErrorContinue = function onErrorContinue(callback) {
+	return this.onErrorResume((error) => {
+		callback(error, void 0);
+		return Flux.empty();
+	});
+};
+Flux.prototype.onErrorStop = function onErrorStop() {
+	return this;
+};
+Flux.prototype.onTerminateDetach = function onTerminateDetach() {
+	return this;
+};
+Flux.prototype.publish = function publish(transformer) {
+	return transformer ? Flux.from(transformer(this.share())) : this.share();
+};
+Flux.prototype.publishNext = function publishNext() {
+	return this.next();
+};
+Flux.prototype.replay = function replay(..._args) {
+	return this.cache();
+};
+Flux.prototype.share = function share() {
+	return this;
+};
+Flux.prototype.shareNext = function shareNext() {
+	return this.next();
+};
+Flux.prototype.tag = function tag(_key, _value) {
+	return this;
+};
+Flux.prototype.tap = function tap(listener) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		const actual = typeof listener === "function" ? listener() : listener;
+		signal.addEventListener("abort", () => actual.onCancel?.(), { once: true });
+		try {
+			for await (const value of source.iterate(signal, context)) {
+				actual.onNext?.(value);
+				actual.onSignal?.(Signal.next(value));
+				yield value;
+			}
+			actual.onComplete?.();
+			actual.onSignal?.(Signal.complete());
+		} catch (error) {
+			actual.onError?.(error);
+			actual.onSignal?.(Signal.error(error));
+			throw error;
+		}
+	});
+};
+Flux.prototype.toStream = function toStream() {
+	return this;
+};
+/** Returns true when a value can be treated as a duration input. */
+function isDuration(value) {
+	return typeof value === "number" || typeof value === "object" && value !== null && !isPublisherLike(value);
+}
+/** Returns true when a value looks like a publisher or iterable source. */
+function isPublisherLike(value) {
+	return typeof value.subscribe === "function" || typeof value.then === "function" || typeof value[Symbol.iterator] === "function" || typeof value[Symbol.asyncIterator] === "function";
+}
+/** Consumes a publisher input and ignores all emitted values. */
+async function drain(source, signal, context) {
+	for await (const _ of Flux.from(source).iterate(signal, context));
+}
+/** Creates a no-op subscription object for doOnSubscribe callbacks. */
+function noopSubscription() {
+	return {
+		/** Ignores request accounting for synthetic subscriptions. */
+		request() {},
+		/** Ignores cancellation for synthetic subscriptions. */
+		cancel() {}
+	};
+}
+/** Returns an operator value unchanged. */
+function passThrough(value) {
+	return value;
+}
+//#endregion
+
+//# sourceMappingURL=lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","names":[],"sources":["../../../src/publisher/operators/lifecycle.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Reactor lifecycle, context, logging and browser backpressure compatibility operators.\n */\nimport {Context} from \"@/context/context.js\";\nimport {ContextView} from \"@/context/context-view.js\";\nimport {Flux} from \"@/publisher/flux.js\";\nimport {scheduleDelay} from \"@/publisher/helpers.js\";\nimport {liftOneToOne, subscriberContext} from \"@/publisher/operators/lift.js\";\nimport type {PublisherInput} from \"@/publisher/types.js\";\nimport {Schedulers} from \"@/schedulers/schedulers.js\";\nimport type {DurationInput, Scheduler} from \"@/schedulers/types.js\";\nimport {Signal} from \"@/signal/signal.js\";\nimport type {Subscription} from \"@/subscription/subscription.js\";\n\n/** Listener shape accepted by the lightweight `tap` compatibility operator. */\nexport interface FluxTapListener<T> {\n    /** Invoked for each next value. */\n    onNext?(value: T): void;\n\n    /** Invoked when the sequence fails. */\n    onError?(error: unknown): void;\n\n    /** Invoked when the sequence completes. */\n    onComplete?(): void;\n\n    /** Invoked when the sequence is cancelled. */\n    onCancel?(): void;\n\n    /** Invoked for materialized next, error and complete signals. */\n    onSignal?(signal: Signal<T>): void;\n}\n\ndeclare module \"@/publisher/flux.js\" {\n    /** Lifecycle, context and browser backpressure compatibility operators added to Flux. */\n    interface Flux<T> {\n        /** Replays the collected source values to later subscribers. */\n        cache(ttl?: DurationInput, scheduler?: Scheduler): Flux<T>;\n\n        /** Schedules cancellation on the provided scheduler when supported by the source. */\n        cancelOn(scheduler: Scheduler): Flux<T>;\n\n        /** Adds an assembly checkpoint marker. Browser implementation keeps the source unchanged. */\n        checkpoint(description?: string, forceStackTrace?: boolean): Flux<T>;\n\n        /** Captures ambient context when an integration provides it. Browser implementation keeps the source unchanged. */\n        contextCapture(): Flux<T>;\n\n        /** Writes subscriber context for upstream operators. */\n        contextWrite(context: ContextView | Context | ((context: Context) => Context)): Flux<T>;\n\n        /** Delays subscribing to the source. */\n        delaySequence(delay: DurationInput, scheduler?: Scheduler): Flux<T>;\n\n        /** Delays subscribing to the source by time or until another publisher signals. */\n        delaySubscription(delay: DurationInput | PublisherInput<unknown>, scheduler?: Scheduler): Flux<T>;\n\n        /** Delays each value until the trigger publisher derived from that value completes. */\n        delayUntil(triggerProvider: (value: T) => PublisherInput<unknown>): Flux<T>;\n\n        /** Invokes a callback after successful or failed termination. */\n        doAfterTerminate(callback: () => void): Flux<T>;\n\n        /** Invokes a callback before source iteration starts. */\n        doFirst(callback: () => void): Flux<T>;\n\n        /** Invokes a callback when the subscription is cancelled. */\n        doOnCancel(callback: () => void): Flux<T>;\n\n        /** Registers a discard hook. Browser implementation keeps values unchanged. */\n        doOnDiscard<R>(type: new (...args: never[]) => R, callback: (value: R) => void): Flux<T>;\n\n        /** Invokes a callback for every materialized source signal. */\n        doOnEach(callback: (signal: Signal<T>) => void): Flux<T>;\n\n        /** Invokes a callback when unbounded demand is requested by the async bridge. */\n        doOnRequest(callback: (request: number) => void): Flux<T>;\n\n        /** Invokes a callback with a synthetic subscription before source iteration starts. */\n        doOnSubscribe(callback: (subscription: Subscription) => void): Flux<T>;\n\n        /** Invokes a callback before successful or failed termination. */\n        doOnTerminate(callback: () => void): Flux<T>;\n\n        /** Keeps request batching metadata. Browser async iteration returns this source unchanged. */\n        limitRate(highTide: number, lowTide?: number): Flux<T>;\n\n        /** Limits the total number of requested values. */\n        limitRequest(n: number): Flux<T>;\n\n        /** Logs source signals to the console. */\n        log(category?: string): Flux<T>;\n\n        /** Keeps metrics compatibility metadata. Browser implementation returns this source unchanged. */\n        metrics(): Flux<T>;\n\n        /** Keeps a human-readable sequence name. Browser implementation returns this source unchanged. */\n        name(name: string): Flux<T>;\n\n        /** Buffers on backpressure. Browser async iteration already buffers by pull demand. */\n        onBackpressureBuffer(...args: unknown[]): Flux<T>;\n\n        /** Drops on backpressure. Browser async iteration keeps pull demand and returns this source unchanged. */\n        onBackpressureDrop(callback?: (value: T) => void): Flux<T>;\n\n        /** Fails on backpressure. Browser async iteration keeps pull demand and returns this source unchanged. */\n        onBackpressureError(): Flux<T>;\n\n        /** Keeps only the latest value on backpressure. Browser async iteration returns this source unchanged. */\n        onBackpressureLatest(): Flux<T>;\n\n        /** Completes instead of failing when the optional predicate accepts the error. */\n        onErrorComplete(predicate?: (error: unknown) => boolean): Flux<T>;\n\n        /** Continues with completion after invoking an error continuation callback. */\n        onErrorContinue(callback: (error: unknown, value: T | undefined) => void): Flux<T>;\n\n        /** Stops error continuation mode. Browser implementation returns this source unchanged. */\n        onErrorStop(): Flux<T>;\n\n        /** Drops terminal-reference retention hints. Browser implementation returns this source unchanged. */\n        onTerminateDetach(): Flux<T>;\n\n        /** Transforms a shared source or returns a shared source view. */\n        publish<R = T>(transformer?: (source: Flux<T>) => PublisherInput<R>): Flux<R>;\n\n        /** Returns a Mono with the next value from this source. */\n        publishNext(): import(\"@/publisher/mono.js\").Mono<T>;\n\n        /** Returns a replaying view of this source. */\n        replay(...args: unknown[]): Flux<T>;\n\n        /** Returns a shared browser view of this source. */\n        share(): Flux<T>;\n\n        /** Returns a Mono with the next value from a shared source. */\n        shareNext(): import(\"@/publisher/mono.js\").Mono<T>;\n\n        /** Stores a metadata tag. Browser implementation returns this source unchanged. */\n        tag(key: string, value: string): Flux<T>;\n\n        /** Installs listener callbacks for values, terminal signals, and cancellation. */\n        tap(listener: FluxTapListener<T> | (() => FluxTapListener<T>)): Flux<T>;\n\n        /** Returns an async iterator stream view of this Flux. */\n        toStream(): AsyncIterable<T>;\n    }\n}\n\nFlux.prototype.cache = function cache<T>(this: Flux<T>, _ttl?: DurationInput, _scheduler?: Scheduler): Flux<T> {\n    const source = this;\n    let values: T[] | undefined;\n    let failure: unknown;\n    let loaded: Promise<void> | undefined;\n    return new Flux(async function* (signal, context) {\n        loaded ??= (async () => {\n            const nextValues: T[] = [];\n            try {\n                for await (const value of source.iterate(signal, context)) {\n                    nextValues.push(value);\n                }\n                values = nextValues;\n            } catch (error) {\n                failure = error;\n            }\n        })();\n        await loaded;\n        if (failure !== undefined) {\n            throw failure;\n        }\n        yield* values ?? [];\n    });\n};\n\nFlux.prototype.cancelOn = function cancelOn<T>(this: Flux<T>, _scheduler: Scheduler): Flux<T> {\n    return this;\n};\n\nFlux.prototype.checkpoint = function checkpoint<T>(\n    this: Flux<T>,\n    _description?: string,\n    _forceStackTrace?: boolean\n): Flux<T> {\n    return this;\n};\n\nFlux.prototype.contextCapture = function contextCapture<T>(this: Flux<T>): Flux<T> {\n    return this;\n};\n\nFlux.prototype.contextWrite = function contextWrite<T>(\n    this: Flux<T>,\n    contextUpdate: ContextView | Context | ((context: Context) => Context)\n): Flux<T> {\n    const source = this;\n    return liftOneToOne(\n        source,\n        (signal, context) => {\n            const nextContext =\n                typeof contextUpdate === \"function\"\n                    ? contextUpdate(context)\n                    : context.putAll(contextUpdate);\n            return source.iterate(signal, nextContext);\n        },\n        subscriber => {\n            const context = subscriberContext(subscriber);\n            const nextContext =\n                typeof contextUpdate === \"function\"\n                    ? contextUpdate(context)\n                    : context.putAll(contextUpdate);\n            return {\n                onNext: passThrough,\n                currentContext: () => nextContext\n            };\n        }\n    );\n};\n\nFlux.prototype.delaySequence = function delaySequence<T>(\n    this: Flux<T>,\n    delay: DurationInput,\n    scheduler?: Scheduler\n): Flux<T> {\n    return this.delaySubscription(delay, scheduler);\n};\n\nFlux.prototype.delaySubscription = function delaySubscription<T>(\n    this: Flux<T>,\n    delay: DurationInput | PublisherInput<unknown>,\n    scheduler?: Scheduler\n): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        if (isDuration(delay)) {\n            await scheduleDelay(scheduler ?? Schedulers.timeout(), delay, signal);\n        } else {\n            await drain(delay, signal, context);\n        }\n        for await (const value of source.iterate(signal, context)) {\n            yield value;\n        }\n    });\n};\n\nFlux.prototype.delayUntil = function delayUntil<T>(\n    this: Flux<T>,\n    triggerProvider: (value: T) => PublisherInput<unknown>\n): 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            await drain(triggerProvider(value), signal, context);\n            yield value;\n        }\n    });\n};\n\nFlux.prototype.doAfterTerminate = function doAfterTerminate<T>(this: Flux<T>, callback: () => void): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let terminated = false;\n        try {\n            for await (const value of source.iterate(signal, context)) {\n                yield value;\n            }\n            terminated = true;\n        } finally {\n            if (terminated) {\n                callback();\n            }\n        }\n    });\n};\n\nFlux.prototype.doFirst = function doFirst<T>(this: Flux<T>, callback: () => void): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => {\n        callback();\n        return source.iterate(signal, context);\n    });\n};\n\nFlux.prototype.doOnCancel = function doOnCancel<T>(this: Flux<T>, callback: () => void): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => {\n        signal.addEventListener(\"abort\", callback, {once: true});\n        return source.iterate(signal, context);\n    });\n};\n\nFlux.prototype.doOnDiscard = function doOnDiscard<T, R>(\n    this: Flux<T>,\n    _type: new (...args: never[]) => R,\n    _callback: (value: R) => void\n): Flux<T> {\n    return this;\n};\n\nFlux.prototype.doOnEach = function doOnEach<T>(this: Flux<T>, callback: (signal: Signal<T>) => 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                callback(Signal.next(value));\n                yield value;\n            }\n            callback(Signal.complete());\n        } catch (error) {\n            callback(Signal.error(error));\n            throw error;\n        }\n    });\n};\n\nFlux.prototype.doOnRequest = function doOnRequest<T>(this: Flux<T>, callback: (request: number) => void): Flux<T> {\n    const source = this;\n    return liftOneToOne(\n        source,\n        (signal, context) => {\n            callback(Number.POSITIVE_INFINITY);\n            return source.iterate(signal, context);\n        },\n        () => ({\n            onNext: passThrough,\n            onRequest: callback\n        })\n    );\n};\n\nFlux.prototype.doOnSubscribe = function doOnSubscribe<T>(\n    this: Flux<T>,\n    callback: (subscription: Subscription) => void\n): Flux<T> {\n    const source = this;\n    return liftOneToOne(\n        source,\n        (signal, context) => {\n            callback(noopSubscription());\n            return source.iterate(signal, context);\n        },\n        () => ({\n            onNext: passThrough,\n            onSubscribe: callback\n        })\n    );\n};\n\nFlux.prototype.doOnTerminate = function doOnTerminate<T>(this: Flux<T>, callback: () => 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            callback();\n        } catch (error) {\n            callback();\n            throw error;\n        }\n    });\n};\n\nFlux.prototype.limitRate = function limitRate<T>(this: Flux<T>, _highTide: number, _lowTide?: number): Flux<T> {\n    return this;\n};\n\nFlux.prototype.limitRequest = function limitRequest<T>(this: Flux<T>, n: number): Flux<T> {\n    return this.take(n);\n};\n\nFlux.prototype.log = function log<T>(this: Flux<T>, category = \"Flux\"): Flux<T> {\n    return this.doOnEach(signal => console.debug(category, signal.type, signal.value ?? signal.error));\n};\n\nFlux.prototype.metrics = function metrics<T>(this: Flux<T>): Flux<T> {\n    return this;\n};\n\nFlux.prototype.name = function name<T>(this: Flux<T>, _name: string): Flux<T> {\n    return this;\n};\n\nFlux.prototype.onBackpressureBuffer = function onBackpressureBuffer<T>(this: Flux<T>, ..._args: unknown[]): Flux<T> {\n    return this;\n};\n\nFlux.prototype.onBackpressureDrop = function onBackpressureDrop<T>(\n    this: Flux<T>,\n    _callback?: (value: T) => void\n): Flux<T> {\n    return this;\n};\n\nFlux.prototype.onBackpressureError = function onBackpressureError<T>(this: Flux<T>): Flux<T> {\n    return this;\n};\n\nFlux.prototype.onBackpressureLatest = function onBackpressureLatest<T>(this: Flux<T>): Flux<T> {\n    return this;\n};\n\nFlux.prototype.onErrorComplete = function onErrorComplete<T>(\n    this: Flux<T>,\n    predicate: (error: unknown) => boolean = () => true\n): 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            if (!predicate(error)) {\n                throw error;\n            }\n        }\n    });\n};\n\nFlux.prototype.onErrorContinue = function onErrorContinue<T>(\n    this: Flux<T>,\n    callback: (error: unknown, value: T | undefined) => void\n): Flux<T> {\n    return this.onErrorResume(error => {\n        callback(error, undefined);\n        return Flux.empty<T>();\n    });\n};\n\nFlux.prototype.onErrorStop = function onErrorStop<T>(this: Flux<T>): Flux<T> {\n    return this;\n};\n\nFlux.prototype.onTerminateDetach = function onTerminateDetach<T>(this: Flux<T>): Flux<T> {\n    return this;\n};\n\nFlux.prototype.publish = function publish<T, R = T>(\n    this: Flux<T>,\n    transformer?: (source: Flux<T>) => PublisherInput<R>\n): Flux<R> {\n    return transformer ? Flux.from(transformer(this.share())) : (this.share() as unknown as Flux<R>);\n};\n\nFlux.prototype.publishNext = function publishNext<T>(this: Flux<T>) {\n    return this.next();\n};\n\nFlux.prototype.replay = function replay<T>(this: Flux<T>, ..._args: unknown[]): Flux<T> {\n    return this.cache();\n};\n\nFlux.prototype.share = function share<T>(this: Flux<T>): Flux<T> {\n    return this;\n};\n\nFlux.prototype.shareNext = function shareNext<T>(this: Flux<T>) {\n    return this.next();\n};\n\nFlux.prototype.tag = function tag<T>(this: Flux<T>, _key: string, _value: string): Flux<T> {\n    return this;\n};\n\nFlux.prototype.tap = function tap<T>(this: Flux<T>, listener: FluxTapListener<T> | (() => FluxTapListener<T>)): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        const actual = typeof listener === \"function\" ? listener() : listener;\n        signal.addEventListener(\"abort\", () => actual.onCancel?.(), {once: true});\n        try {\n            for await (const value of source.iterate(signal, context)) {\n                actual.onNext?.(value);\n                actual.onSignal?.(Signal.next(value));\n                yield value;\n            }\n            actual.onComplete?.();\n            actual.onSignal?.(Signal.complete());\n        } catch (error) {\n            actual.onError?.(error);\n            actual.onSignal?.(Signal.error(error));\n            throw error;\n        }\n    });\n};\n\nFlux.prototype.toStream = function toStream<T>(this: Flux<T>): AsyncIterable<T> {\n    return this;\n};\n\n/** Returns true when a value can be treated as a duration input. */\nfunction isDuration(value: unknown): value is DurationInput {\n    return typeof value === \"number\" || (typeof value === \"object\" && value !== null && !isPublisherLike(value));\n}\n\n/** Returns true when a value looks like a publisher or iterable source. */\nfunction isPublisherLike(value: object): boolean {\n    return (\n        typeof (value as { subscribe?: unknown }).subscribe === \"function\" ||\n        typeof (value as { then?: unknown }).then === \"function\" ||\n        typeof (value as { [Symbol.iterator]?: unknown })[Symbol.iterator] === \"function\" ||\n        typeof (value as { [Symbol.asyncIterator]?: unknown })[Symbol.asyncIterator] === \"function\"\n    );\n}\n\n/** Consumes a publisher input and ignores all emitted values. */\nasync function drain(source: PublisherInput<unknown>, signal: AbortSignal, context: Context): Promise<void> {\n    for await (const _ of Flux.from(source).iterate(signal, context)) {\n        // ignored\n    }\n}\n\n/** Creates a no-op subscription object for doOnSubscribe callbacks. */\nfunction noopSubscription(): Subscription {\n    return {\n        /** Ignores request accounting for synthetic subscriptions. */\n        request() {\n            // no-op\n        },\n        /** Ignores cancellation for synthetic subscriptions. */\n        cancel() {\n            // no-op\n        }\n    };\n}\n\n/** Returns an operator value unchanged. */\nfunction passThrough<T>(value: T): T {\n    return value;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,42 @@
+/**
+ * @packageDocumentation
+ * Internal subscriber-lifting primitives for demand-preserving Flux operators.
+ */
+import { Context } from "../../context/context.js";
+import type { SourceFactory } from "../types.js";
+import { Flux } from "../flux.js";
+import type { Subscriber } from "../../subscription/subscriber.js";
+import type { Subscription } from "../../subscription/subscription.js";
+/** Creates the subscriber that an upstream Flux sees for a downstream subscriber. */
+export type SubscriberLifter<T, R> = (subscriber: Subscriber<R>) => Subscriber<T>;
+/** Hooks used by synchronous one-input/one-output operators. */
+export interface OneToOneOperatorHooks<T, R> {
+    /** Converts one upstream value into exactly one downstream value. */
+    onNext(value: T): R;
+    /** Runs before the downstream receives its subscription. */
+    onSubscribe?(subscription: Subscription): void;
+    /** Runs before an upstream error is forwarded. */
+    onError?(error: unknown): void;
+    /** Runs before downstream demand is forwarded upstream. */
+    onRequest?(request: number): void;
+    /** Runs before successful completion is forwarded. */
+    onComplete?(): void;
+    /** Runs when downstream cancellation is propagated upstream. */
+    onCancel?(): void;
+    /** Runs after the terminal signal or cancellation has been propagated. */
+    onFinally?(signal: "complete" | "error" | "cancel"): void;
+    /** Context exposed to the upstream subscriber. */
+    currentContext?(): Context;
+}
+/**
+ * Lifts a Flux at the Reactive Streams subscriber boundary while keeping an
+ * iterable implementation for explicit async-iterator consumption.
+ */
+export declare function liftFlux<T, R>(source: Flux<T>, sourceFactory: SourceFactory<R>, lifter: SubscriberLifter<T, R>): Flux<R>;
+/** Creates a one-to-one operator that forwards downstream demand unchanged. */
+export declare function liftOneToOne<T, R>(source: Flux<T>, sourceFactory: SourceFactory<R>, hooksFactory: (subscriber: Subscriber<R>) => OneToOneOperatorHooks<T, R>): Flux<R>;
+/** Creates a filtering operator that replenishes only values dropped from finite demand. */
+export declare function liftFilter<T>(source: Flux<T>, sourceFactory: SourceFactory<T>, predicate: (value: T) => boolean): Flux<T>;
+/** Returns the context exposed by a subscriber, or the shared empty context. */
+export declare function subscriberContext<T>(subscriber: Subscriber<T>): Context;
+//# sourceMappingURL=lift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lift.d.ts","sourceRoot":"","sources":["../../../src/publisher/operators/lift.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAC,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAE7C,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAEzC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gCAAgC,CAAC;AAEjE,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC;AAElF,gEAAgE;AAChE,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC;IACvC,qEAAqE;IACrE,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IAEpB,4DAA4D;IAC5D,WAAW,CAAC,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAE/C,kDAAkD;IAClD,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAE/B,2DAA2D;IAC3D,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,sDAAsD;IACtD,UAAU,CAAC,IAAI,IAAI,CAAC;IAEpB,gEAAgE;IAChE,QAAQ,CAAC,IAAI,IAAI,CAAC;IAElB,0EAA0E;IAC1E,SAAS,CAAC,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;IAE1D,kDAAkD;IAClD,cAAc,CAAC,IAAI,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EACzB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EACf,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,EAC/B,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC/B,IAAI,CAAC,CAAC,CAAC,CAET;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAC7B,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EACf,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,EAC/B,YAAY,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,GACzE,IAAI,CAAC,CAAC,CAAC,CAIT;AAED,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,CAAC,EACxB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EACf,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,EAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GACjC,IAAI,CAAC,CAAC,CAAC,CAET;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAEvE"}