reactor-core-ts 3.2.3 → 3.2.4

package/dist/publisher/operators/lifecycle.js

@@ -1,3 +1,5 @@
+import { UNBOUNDED_DEMAND } from "../../core/demand.js";
+import { collectPublisher, drainPublisher } from "../../internal/publisher-terminal.js";
 import { Schedulers } from "../../schedulers/schedulers.js";
 import { scheduleDelay } from "../helpers.js";
 import { Flux } from "../flux.js";
@@ -10,15 +12,11 @@ Flux.prototype.cache = function cache(_ttl, _scheduler) {
 	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;
-			}
-		})());
+		loaded ?? (loaded = collectPublisher(source, signal, context).then((nextValues) => {
+			values = nextValues;
+		}, (error) => {
+			failure = error;
+		}));
 		await loaded;
 		if (failure !== void 0) throw failure;
 		yield* values ?? [];
@@ -69,7 +67,7 @@ Flux.prototype.delayUntil = function delayUntil(triggerProvider) {
 };
 Flux.prototype.doAfterTerminate = function doAfterTerminate(callback) {
 	const source = this;
-	return new Flux(async function* (signal, context) {
+	return liftOneToOne(source, async function* (signal, context) {
 		let terminated = false;
 		try {
 			for await (const value of source.iterate(signal, context)) yield value;
@@ -77,28 +75,40 @@ Flux.prototype.doAfterTerminate = function doAfterTerminate(callback) {
 		} finally {
 			if (terminated) callback();
 		}
-	});
+	}, () => ({
+		onNext: passThrough,
+		/** Runs the callback after non-cancellation terminal signals. */
+		onFinally(signal) {
+			if (signal !== "cancel") callback();
+		}
+	}));
 };
 Flux.prototype.doFirst = function doFirst(callback) {
 	const source = this;
-	return new Flux((signal, context) => {
+	return liftOneToOne(source, (signal, context) => {
 		callback();
 		return source.iterate(signal, context);
+	}, () => {
+		callback();
+		return { onNext: passThrough };
 	});
 };
 Flux.prototype.doOnCancel = function doOnCancel(callback) {
 	const source = this;
-	return new Flux((signal, context) => {
+	return liftOneToOne(source, (signal, context) => {
 		signal.addEventListener("abort", callback, { once: true });
 		return source.iterate(signal, context);
-	});
+	}, () => ({
+		onNext: passThrough,
+		onCancel: callback
+	}));
 };
 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) {
+	return liftOneToOne(source, async function* (signal, context) {
 		try {
 			for await (const value of source.iterate(signal, context)) {
 				callback(Signal.next(value));
@@ -109,12 +119,20 @@ Flux.prototype.doOnEach = function doOnEach(callback) {
 			callback(Signal.error(error));
 			throw error;
 		}
-	});
+	}, () => ({
+		/** Observes one next signal and relays its value. */
+		onNext(value) {
+			callback(Signal.next(value));
+			return value;
+		},
+		onError: (error) => callback(Signal.error(error)),
+		onComplete: () => callback(Signal.complete())
+	}));
 };
 Flux.prototype.doOnRequest = function doOnRequest(callback) {
 	const source = this;
 	return liftOneToOne(source, (signal, context) => {
-		callback(Number.POSITIVE_INFINITY);
+		callback(UNBOUNDED_DEMAND);
 		return source.iterate(signal, context);
 	}, () => ({
 		onNext: passThrough,
@@ -133,7 +151,7 @@ Flux.prototype.doOnSubscribe = function doOnSubscribe(callback) {
 };
 Flux.prototype.doOnTerminate = function doOnTerminate(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;
 			callback();
@@ -141,7 +159,11 @@ Flux.prototype.doOnTerminate = function doOnTerminate(callback) {
 			callback();
 			throw error;
 		}
-	});
+	}, () => ({
+		onNext: passThrough,
+		onError: callback,
+		onComplete: callback
+	}));
 };
 Flux.prototype.limitRate = function limitRate(_highTide, _lowTide) {
 	return this;
@@ -212,7 +234,7 @@ Flux.prototype.tag = function tag(_key, _value) {
 };
 Flux.prototype.tap = function tap(listener) {
 	const source = this;
-	return new Flux(async function* (signal, context) {
+	return liftOneToOne(source, async function* (signal, context) {
 		const actual = typeof listener === "function" ? listener() : listener;
 		signal.addEventListener("abort", () => actual.onCancel?.(), { once: true });
 		try {
@@ -228,6 +250,27 @@ Flux.prototype.tap = function tap(listener) {
 			actual.onSignal?.(Signal.error(error));
 			throw error;
 		}
+	}, () => {
+		const actual = typeof listener === "function" ? listener() : listener;
+		return {
+			/** Notifies the listener about one value and relays it. */
+			onNext(value) {
+				actual.onNext?.(value);
+				actual.onSignal?.(Signal.next(value));
+				return value;
+			},
+			/** Notifies the listener about an error signal. */
+			onError(error) {
+				actual.onError?.(error);
+				actual.onSignal?.(Signal.error(error));
+			},
+			/** Notifies the listener about successful completion. */
+			onComplete() {
+				actual.onComplete?.();
+				actual.onSignal?.(Signal.complete());
+			},
+			onCancel: () => actual.onCancel?.()
+		};
 	});
 };
 Flux.prototype.toStream = function toStream() {
@@ -243,7 +286,7 @@ function isPublisherLike(value) {
 }
 /** 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));
+	await drainPublisher(Flux.from(source), signal, context);
 }
 /** Creates a no-op subscription object for doOnSubscribe callbacks. */
 function noopSubscription() {

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

@@ -1 +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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"}
+{"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 {UNBOUNDED_DEMAND} from \"@/core/demand.js\";\nimport {Flux} from \"@/publisher/flux.js\";\nimport {collectPublisher, drainPublisher} from \"@/internal/publisher-terminal.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 ??= collectPublisher<T>(source, signal, context).then(\n            nextValues => {\n                values = nextValues;\n            },\n            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 liftOneToOne(\n        source,\n        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            onNext: passThrough,\n            /** Runs the callback after non-cancellation terminal signals. */\n            onFinally(signal) {\n                if (signal !== \"cancel\") {\n                    callback();\n                }\n            }\n        })\n    );\n};\n\nFlux.prototype.doFirst = function doFirst<T>(this: Flux<T>, callback: () => void): Flux<T> {\n    const source = this;\n    return liftOneToOne(\n        source,\n        (signal, context) => {\n            callback();\n            return source.iterate(signal, context);\n        },\n        () => {\n            callback();\n            return {onNext: passThrough};\n        }\n    );\n};\n\nFlux.prototype.doOnCancel = function doOnCancel<T>(this: Flux<T>, callback: () => void): Flux<T> {\n    const source = this;\n    return liftOneToOne(\n        source,\n        (signal, context) => {\n            signal.addEventListener(\"abort\", callback, {once: true});\n            return source.iterate(signal, context);\n        },\n        () => ({\n            onNext: passThrough,\n            onCancel: callback\n        })\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 liftOneToOne(\n        source,\n        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            /** Observes one next signal and relays its value. */\n            onNext(value) {\n                callback(Signal.next(value));\n                return value;\n            },\n            onError: error => callback(Signal.error(error)),\n            onComplete: () => callback(Signal.complete())\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(UNBOUNDED_DEMAND);\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 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                callback();\n            } catch (error) {\n                callback();\n                throw error;\n            }\n        },\n        () => ({\n            onNext: passThrough,\n            onError: callback,\n            onComplete: callback\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 liftOneToOne(\n        source,\n        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            const actual = typeof listener === \"function\" ? listener() : listener;\n            return {\n                /** Notifies the listener about one value and relays it. */\n                onNext(value) {\n                    actual.onNext?.(value);\n                    actual.onSignal?.(Signal.next(value));\n                    return value;\n                },\n                /** Notifies the listener about an error signal. */\n                onError(error) {\n                    actual.onError?.(error);\n                    actual.onSignal?.(Signal.error(error));\n                },\n                /** Notifies the listener about successful completion. */\n                onComplete() {\n                    actual.onComplete?.();\n                    actual.onSignal?.(Signal.complete());\n                },\n                onCancel: () => actual.onCancel?.()\n            };\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    await drainPublisher(Flux.from(source), signal, context);\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

@@ -37,6 +37,8 @@ export declare function liftFlux<T, R>(source: Flux<T>, sourceFactory: SourceFac
 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>;
+/** Creates a limiting operator that never requests more than its remaining item count. */
+export declare function liftTake<T>(source: Flux<T>, sourceFactory: SourceFactory<T>, count: number): 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

@@ -1 +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"}
+{"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;AAG7C,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,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAEpG;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAEvE"}

package/dist/publisher/operators/lift.js

@@ -1,6 +1,7 @@
 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 { UNBOUNDED_DEMAND, addCap, normalizeRequest } from "../../core/demand.js";
+import { ITERATION_DEMAND_HINT, iterationDemandHint } from "../../internal/iteration-demand.js";
 import { Flux } from "../flux.js";
 //#region src/publisher/operators/lift.ts
 /**
@@ -22,6 +23,10 @@ function liftOneToOne(source, sourceFactory, hooksFactory) {
 function liftFilter(source, sourceFactory, predicate) {
 	return liftFlux(source, sourceFactory, (subscriber) => new FilterOperatorSubscriber(subscriber, predicate));
 }
+/** Creates a limiting operator that never requests more than its remaining item count. */
+function liftTake(source, sourceFactory, count) {
+	return liftFlux(source, sourceFactory, (subscriber) => new TakeOperatorSubscriber(subscriber, count));
+}
 /** Returns the context exposed by a subscriber, or the shared empty context. */
 function subscriberContext(subscriber) {
 	return subscriber.currentContext?.() ?? Context.empty();
@@ -114,6 +119,7 @@ var OneToOneOperatorSubscriber = class {
 			this.terminateWithError(error, true);
 			return;
 		}
+		if (this.terminated) return;
 		this.actual.onNext(mapped);
 	}
 	/** Forwards an upstream error after running the operator callback. */
@@ -129,6 +135,7 @@ var OneToOneOperatorSubscriber = class {
 			this.terminateWithError(error, false);
 			return;
 		}
+		if (this.terminated) return;
 		this.terminated = true;
 		try {
 			this.actual.onComplete();
@@ -145,6 +152,7 @@ var OneToOneOperatorSubscriber = class {
 			this.terminateWithError(error, true);
 			return;
 		}
+		if (this.terminated) return;
 		this.upstream?.request(n);
 	}
 	/** Cancels upstream once and reports the cancellation lifecycle hooks. */
@@ -165,6 +173,10 @@ var OneToOneOperatorSubscriber = class {
 	currentContext() {
 		return this.hooks.currentContext?.() ?? subscriberContext(this.actual);
 	}
+	/** Propagates a known terminal demand batch through this one-to-one boundary. */
+	[ITERATION_DEMAND_HINT]() {
+		return iterationDemandHint(this.actual);
+	}
 	/** Cancels when needed and emits one downstream error signal. */
 	terminateWithError(error, cancelUpstream) {
 		if (this.terminated) return;
@@ -284,7 +296,7 @@ var FilterOperatorSubscriber = class {
 	/** Forwards demand and records when no further compensation is necessary. */
 	request(n) {
 		if (this.terminated) return;
-		if (n === Number.POSITIVE_INFINITY) this.unbounded = true;
+		if (n === UNBOUNDED_DEMAND) this.unbounded = true;
 		this.requestUpstream(n);
 	}
 	/** Cancels the upstream once. */
@@ -297,6 +309,10 @@ var FilterOperatorSubscriber = class {
 	currentContext() {
 		return subscriberContext(this.actual);
 	}
+	/** Propagates a known unbounded terminal batch through this filtering boundary. */
+	[ITERATION_DEMAND_HINT]() {
+		return iterationDemandHint(this.actual);
+	}
 	/** Drains demand iteratively so synchronous sources cannot recurse through dropped values. */
 	requestUpstream(n) {
 		if (this.requesting) {
@@ -319,6 +335,160 @@ var FilterOperatorSubscriber = class {
 		}
 	}
 };
+/** Subscriber that caps cumulative upstream demand and completes after a fixed number of values. */
+var TakeOperatorSubscriber = class {
+	/** Creates a take subscriber with the provided maximum value count. */
+	constructor(actual, count) {
+		_defineProperty(this, "actual", void 0);
+		_defineProperty(
+			this,
+			/** Active upstream subscription. */
+			"upstream",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Remaining values before this operator completes. */
+			"remaining",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Requested upstream values that have not arrived yet. */
+			"outstanding",
+			0
+		);
+		_defineProperty(
+			this,
+			/** Guards synchronous upstream request calls against recursive downstream demand. */
+			"requesting",
+			false
+		);
+		_defineProperty(
+			this,
+			/** Downstream demand accumulated while an upstream request is active. */
+			"missedRequested",
+			0
+		);
+		_defineProperty(
+			this,
+			/** Prevents duplicate subscriptions from replacing the active upstream. */
+			"subscribed",
+			false
+		);
+		_defineProperty(
+			this,
+			/** Suppresses signals after cancellation or termination. */
+			"terminated",
+			false
+		);
+		this.actual = actual;
+		this.remaining = count;
+	}
+	/** Stores upstream and exposes the capped subscription downstream. */
+	onSubscribe(subscription) {
+		if (this.subscribed || this.terminated) {
+			cancelSilently(subscription);
+			return;
+		}
+		this.subscribed = true;
+		this.upstream = subscription;
+		try {
+			this.actual.onSubscribe(this);
+		} catch (error) {
+			this.terminated = true;
+			cancelSilently(subscription);
+			throw error;
+		}
+	}
+	/** Forwards one value and cancels upstream exactly at the configured limit. */
+	onNext(value) {
+		if (this.terminated || this.remaining === 0) return;
+		if (this.outstanding > 0) this.outstanding -= 1;
+		this.remaining -= 1;
+		try {
+			this.actual.onNext(value);
+		} catch (error) {
+			if (this.terminated) return;
+			this.terminated = true;
+			if (this.upstream) cancelSilently(this.upstream);
+			this.actual.onError(error);
+			return;
+		}
+		if (this.remaining === 0 && !this.terminated) {
+			this.terminated = true;
+			if (this.upstream) cancelSilently(this.upstream);
+			this.actual.onComplete();
+		}
+	}
+	/** Forwards the first upstream failure. */
+	onError(error) {
+		if (this.terminated) return;
+		this.terminated = true;
+		this.actual.onError(error);
+	}
+	/** Forwards early upstream completion. */
+	onComplete() {
+		if (this.terminated) return;
+		this.terminated = true;
+		this.actual.onComplete();
+	}
+	/** Requests only demand that still fits below the take limit. */
+	request(n) {
+		if (this.terminated) return;
+		let demand;
+		try {
+			demand = normalizeRequest(n);
+		} catch (error) {
+			this.terminated = true;
+			if (this.upstream) cancelSilently(this.upstream);
+			this.actual.onError(error);
+			return;
+		}
+		if (this.requesting) {
+			this.missedRequested = addCap(this.missedRequested, demand);
+			return;
+		}
+		this.requesting = true;
+		let nextDemand = demand;
+		try {
+			while (!this.terminated) {
+				const available = this.remaining - this.outstanding;
+				if (available > 0) {
+					const request = Math.min(nextDemand, available);
+					this.outstanding += request;
+					this.upstream?.request(request);
+				}
+				if (this.terminated || this.missedRequested === 0) return;
+				nextDemand = this.missedRequested;
+				this.missedRequested = 0;
+			}
+		} catch (error) {
+			if (!this.terminated) {
+				this.terminated = true;
+				if (this.upstream) cancelSilently(this.upstream);
+				this.actual.onError(error);
+			}
+		} finally {
+			this.requesting = false;
+		}
+	}
+	/** Cancels the active upstream once. */
+	cancel() {
+		if (this.terminated) return;
+		this.terminated = true;
+		this.upstream?.cancel();
+	}
+	/** Exposes the downstream context unchanged. */
+	currentContext() {
+		return subscriberContext(this.actual);
+	}
+	/** Propagates downstream demand metadata while `take` still applies its own cap. */
+	[ITERATION_DEMAND_HINT]() {
+		const downstream = iterationDemandHint(this.actual);
+		return downstream === void 0 ? void 0 : Math.min(downstream, this.remaining);
+	}
+};
 /** Signals a lifter assembly failure through a valid Reactive Streams handshake. */
 function signalAssemblyError(subscriber, error) {
 	subscriber.onSubscribe(EMPTY_SUBSCRIPTION);
@@ -338,6 +508,6 @@ var EMPTY_SUBSCRIPTION = Object.freeze({
 	cancel() {}
 });
 //#endregion
-export { liftFilter, liftFlux, liftOneToOne, subscriberContext };
+export { liftFilter, liftFlux, liftOneToOne, liftTake, subscriberContext };
 
 //# sourceMappingURL=lift.js.map