reactor-core-ts 2.1.6 → 3.2.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.js","names":[],"sources":["../../../src/publisher/operators/coordination.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Reactor coordination and combination compatibility operators for Flux.\n */\nimport {Context} from \"@/context/context.js\";\nimport {AsyncQueue} from \"@/internal/async-queue.js\";\nimport {toAsyncIterator} from \"@/internal/iterable.js\";\nimport {Flux} from \"@/publisher/flux.js\";\nimport {scheduleDelay} from \"@/publisher/helpers.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\";\n\n/** Flux enriched with the key produced by `groupBy`. */\nexport type GroupedFlux<K, T> = Flux<T> & {\n    /** Group key shared by all values in this grouped Flux. */\n    readonly key: K;\n};\n\n/** Browser timing metadata emitted by `timed`. */\nexport interface Timed<T> {\n    /** Source value associated with this timing sample. */\n    readonly value: T;\n    /** Timestamp in scheduler milliseconds. */\n    readonly timestamp: number;\n    /** Milliseconds elapsed since the previous value. */\n    readonly elapsed: number;\n}\n\ndeclare module \"@/publisher/flux.js\" {\n    /** Coordination and combination compatibility operators added to Flux. */\n    interface Flux<T> {\n        /** Concatenates mapped publishers and delays mapper/source errors where possible. */\n        concatMapDelayError<R>(mapper: (value: T) => PublisherInput<R>): Flux<R>;\n\n        /** Maps each value to an iterable and concatenates the iterable values. */\n        concatMapIterable<R>(mapper: (value: T) => Iterable<R>): Flux<R>;\n\n        /** Recursively expands values breadth-first. */\n        expand(expander: (value: T) => PublisherInput<T>, capacityHint?: number): Flux<T>;\n\n        /** Recursively expands values depth-first. */\n        expandDeep(expander: (value: T) => PublisherInput<T>, capacityHint?: number): Flux<T>;\n\n        /** Filters values using an asynchronous boolean publisher. */\n        filterWhen(predicate: (value: T) => PublisherInput<boolean>): Flux<T>;\n\n        /** Flat maps values and delays mapper/source errors where possible. */\n        flatMapDelayError<R>(mapper: (value: T) => PublisherInput<R>, concurrency?: number): Flux<R>;\n\n        /** Maps each value to an iterable and merges the iterable values. */\n        flatMapIterable<R>(mapper: (value: T) => Iterable<R>): Flux<R>;\n\n        /** Flat maps values while preserving source order. */\n        flatMapSequential<R>(mapper: (value: T) => PublisherInput<R>, concurrency?: number): Flux<R>;\n\n        /** Flat maps values sequentially and delays mapper/source errors where possible. */\n        flatMapSequentialDelayError<R>(mapper: (value: T) => PublisherInput<R>, concurrency?: number): Flux<R>;\n\n        /** Groups values by key and emits one finite grouped Flux per key. */\n        groupBy<K>(keySelector: (value: T) => K): Flux<GroupedFlux<K, T>>;\n\n        /** Joins each left value with a Flux of right values. */\n        groupJoin<TRight, R>(\n            right: PublisherInput<TRight>,\n            leftEnd: (left: T) => PublisherInput<unknown>,\n            rightEnd: (right: TRight) => PublisherInput<unknown>,\n            resultSelector: (left: T, right: Flux<TRight>) => R\n        ): Flux<R>;\n\n        /** Indexes each value or maps the generated index and value. */\n        index<R = readonly [number, T]>(mapper?: (index: number, value: T) => R): Flux<R>;\n\n        /** Joins each left and right value with a result selector. */\n        join<TRight, R>(\n            right: PublisherInput<TRight>,\n            leftEnd: (left: T) => PublisherInput<unknown>,\n            rightEnd: (right: TRight) => PublisherInput<unknown>,\n            resultSelector: (left: T, right: TRight) => R\n        ): Flux<R>;\n\n        /** Merges this source with others and emits finite values sorted by a comparator. */\n        mergeComparingWith(comparator: (left: T, right: T) => number, ...others: readonly PublisherInput<T>[]): Flux<T>;\n\n        /** Merges this source with others and emits finite values sorted by a comparator. */\n        mergeOrderedWith(comparator: (left: T, right: T) => number, ...others: readonly PublisherInput<T>[]): Flux<T>;\n\n        /** Relays the first source between this source and another publisher to signal. */\n        or(other: PublisherInput<T>): Flux<T>;\n\n        /** Returns this source as a browser single-threaded parallel-compatible view. */\n        parallel(...args: unknown[]): Flux<T>;\n\n        /** Repeats this source when a companion publisher signals. */\n        repeatWhen(companion: (signals: Flux<number>) => PublisherInput<unknown>): Flux<T>;\n\n        /** Retries this source when a companion publisher signals. */\n        retryWhen(companion: (errors: Flux<unknown>) => PublisherInput<unknown>): Flux<T>;\n\n        /** Samples the latest value when a sampler publisher signals or a period elapses. */\n        sample(sampler: DurationInput | PublisherInput<unknown>, scheduler?: Scheduler): Flux<T>;\n\n        /** Emits the first value in each sampling period. */\n        sampleFirst(period: DurationInput, scheduler?: Scheduler): Flux<T>;\n\n        /** Emits a value only if its throttler publisher completes before another value arrives. */\n        sampleTimeout(throttler: (value: T) => PublisherInput<unknown>): Flux<T>;\n\n        /** Skips values until the predicate matches, including the matching value. */\n        skipUntil(predicate: (value: T) => boolean): Flux<T>;\n\n        /** Skips values until another publisher signals. */\n        skipUntilOther(other: PublisherInput<unknown>): Flux<T>;\n\n        /** Transforms this source after observing its first signal. */\n        switchOnFirst<R>(transformer: (signal: Signal<T>, source: Flux<T>) => PublisherInput<R>): Flux<R>;\n\n        /** Relays values until another publisher signals. */\n        takeUntilOther(other: PublisherInput<unknown>): Flux<T>;\n\n        /** Emits browser timing metadata for each value. */\n        timed(scheduler?: Scheduler): Flux<Timed<T>>;\n\n        /** Combines each value with the latest value from another publisher. */\n        withLatestFrom<U, R = readonly [T, U]>(other: PublisherInput<U>, combinator?: (left: T, right: U) => R): Flux<R>;\n\n        /** Zips this source with a synchronous iterable. */\n        zipWithIterable<U, R = readonly [T, U]>(other: Iterable<U>, combinator?: (left: T, right: U) => R): Flux<R>;\n    }\n}\n\nFlux.prototype.concatMapDelayError = function concatMapDelayError<T, R>(\n    this: Flux<T>,\n    mapper: (value: T) => PublisherInput<R>\n): Flux<R> {\n    return delayErrors(this.concatMap(mapper));\n};\n\nFlux.prototype.concatMapIterable = function concatMapIterable<T, R>(\n    this: Flux<T>,\n    mapper: (value: T) => Iterable<R>\n): Flux<R> {\n    return this.concatMap(value => Flux.fromIterable(mapper(value)));\n};\n\nFlux.prototype.expand = function expand<T>(\n    this: Flux<T>,\n    expander: (value: T) => PublisherInput<T>,\n    _capacityHint?: number\n): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        const queue: T[] = [];\n        for await (const value of source.iterate(signal, context)) {\n            queue.push(value);\n        }\n        for (let index = 0; index < queue.length && !signal.aborted; index += 1) {\n            const value = queue[index] as T;\n            yield value;\n            for await (const child of Flux.from(expander(value)).iterate(signal, context)) {\n                queue.push(child);\n            }\n        }\n    });\n};\n\nFlux.prototype.expandDeep = function expandDeep<T>(\n    this: Flux<T>,\n    expander: (value: T) => PublisherInput<T>,\n    _capacityHint?: number\n): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        const stack: T[] = [];\n        for await (const value of source.iterate(signal, context)) {\n            stack.push(value);\n        }\n        while (stack.length > 0 && !signal.aborted) {\n            const value = stack.pop() as T;\n            yield value;\n            const children: T[] = [];\n            for await (const child of Flux.from(expander(value)).iterate(signal, context)) {\n                children.push(child);\n            }\n            for (let index = children.length - 1; index >= 0; index -= 1) {\n                stack.push(children[index] as T);\n            }\n        }\n    });\n};\n\nFlux.prototype.filterWhen = function filterWhen<T>(\n    this: Flux<T>,\n    predicate: (value: T) => PublisherInput<boolean>\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            if (await firstValueFromContext(predicate(value), signal, context)) {\n                yield value;\n            }\n        }\n    });\n};\n\nFlux.prototype.flatMapDelayError = function flatMapDelayError<T, R>(\n    this: Flux<T>,\n    mapper: (value: T) => PublisherInput<R>,\n    concurrency?: number\n): Flux<R> {\n    return delayErrors(this.flatMap(mapper, concurrency));\n};\n\nFlux.prototype.flatMapIterable = function flatMapIterable<T, R>(\n    this: Flux<T>,\n    mapper: (value: T) => Iterable<R>\n): Flux<R> {\n    return this.flatMap(value => Flux.fromIterable(mapper(value)));\n};\n\nFlux.prototype.flatMapSequential = function flatMapSequential<T, R>(\n    this: Flux<T>,\n    mapper: (value: T) => PublisherInput<R>,\n    _concurrency?: number\n): Flux<R> {\n    return this.concatMap(mapper);\n};\n\nFlux.prototype.flatMapSequentialDelayError = function flatMapSequentialDelayError<T, R>(\n    this: Flux<T>,\n    mapper: (value: T) => PublisherInput<R>,\n    concurrency?: number\n): Flux<R> {\n    return delayErrors(this.flatMapSequential(mapper, concurrency));\n};\n\nFlux.prototype.groupBy = function groupBy<T, K>(this: Flux<T>, keySelector: (value: T) => K): Flux<GroupedFlux<K, T>> {\n    const source = this;\n    return new Flux((signal, context) => {\n        const queue = new AsyncQueue<GroupedFlux<K, T>>(signal);\n        void (async () => {\n            try {\n                const groups = new Map<K, T[]>();\n                for await (const value of source.iterate(signal, context)) {\n                    const key = keySelector(value);\n                    const values = groups.get(key);\n                    if (values) {\n                        values.push(value);\n                    } else {\n                        groups.set(key, [value]);\n                    }\n                }\n                for (const [key, values] of groups) {\n                    const group = Flux.fromIterable(values) as GroupedFlux<K, T>;\n                    Object.defineProperty(group, \"key\", {enumerable: true, value: key});\n                    queue.push(group);\n                }\n                queue.complete();\n            } catch (error) {\n                queue.error(error);\n            }\n        })();\n        return queue;\n    });\n};\n\nFlux.prototype.groupJoin = function groupJoin<T, TRight, R>(\n    this: Flux<T>,\n    right: PublisherInput<TRight>,\n    _leftEnd: (left: T) => PublisherInput<unknown>,\n    _rightEnd: (right: TRight) => PublisherInput<unknown>,\n    resultSelector: (left: T, right: Flux<TRight>) => R\n): Flux<R> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        const rightValues = await collect(right, signal, context);\n        for await (const left of source.iterate(signal, context)) {\n            yield resultSelector(left, Flux.fromIterable(rightValues));\n        }\n    });\n};\n\nFlux.prototype.index = function index<T, R = readonly [number, T]>(\n    this: Flux<T>,\n    mapper?: (index: number, value: T) => R\n): Flux<R> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let indexValue = 0;\n        for await (const value of source.iterate(signal, context)) {\n            yield mapper ? mapper(indexValue, value) : ([indexValue, value] as unknown as R);\n            indexValue += 1;\n        }\n    });\n};\n\nFlux.prototype.join = function join<T, TRight, R>(\n    this: Flux<T>,\n    right: PublisherInput<TRight>,\n    _leftEnd: (left: T) => PublisherInput<unknown>,\n    _rightEnd: (right: TRight) => PublisherInput<unknown>,\n    resultSelector: (left: T, right: TRight) => R\n): Flux<R> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        const rightValues = await collect(right, signal, context);\n        for await (const left of source.iterate(signal, context)) {\n            for (const rightValue of rightValues) {\n                yield resultSelector(left, rightValue);\n            }\n        }\n    });\n};\n\nFlux.prototype.mergeComparingWith = function mergeComparingWith<T>(\n    this: Flux<T>,\n    comparator: (left: T, right: T) => number,\n    ...others: readonly PublisherInput<T>[]\n): Flux<T> {\n    return Flux.mergeComparing(comparator, this, ...others);\n};\n\nFlux.prototype.mergeOrderedWith = function mergeOrderedWith<T>(\n    this: Flux<T>,\n    comparator: (left: T, right: T) => number,\n    ...others: readonly PublisherInput<T>[]\n): Flux<T> {\n    return Flux.mergeOrdered(comparator, this, ...others);\n};\n\nFlux.prototype.or = function or<T>(this: Flux<T>, other: PublisherInput<T>): Flux<T> {\n    return Flux.firstWithSignal(this, other);\n};\n\nFlux.prototype.parallel = function parallel<T>(this: Flux<T>, ..._args: unknown[]): Flux<T> {\n    return this;\n};\n\nFlux.prototype.repeatWhen = function repeatWhen<T>(\n    this: Flux<T>,\n    _companion: (signals: Flux<number>) => PublisherInput<unknown>\n): Flux<T> {\n    return this.repeat(1);\n};\n\nFlux.prototype.retryWhen = function retryWhen<T>(\n    this: Flux<T>,\n    _companion: (errors: Flux<unknown>) => PublisherInput<unknown>\n): Flux<T> {\n    return this.retry(1);\n};\n\nFlux.prototype.sample = function sample<T>(\n    this: Flux<T>,\n    sampler: DurationInput | PublisherInput<unknown>,\n    scheduler: Scheduler = Schedulers.timeout()\n): Flux<T> {\n    return isDuration(sampler) ? samplePeriodically(this, sampler, scheduler) : sampleWithPublisher(this, sampler);\n};\n\nFlux.prototype.sampleFirst = function sampleFirst<T>(\n    this: Flux<T>,\n    period: DurationInput,\n    scheduler: Scheduler = Schedulers.timeout()\n): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let open = true;\n        for await (const value of source.iterate(signal, context)) {\n            if (!open) {\n                continue;\n            }\n            open = false;\n            yield value;\n            void scheduleDelay(scheduler, period, signal).then(() => {\n                open = true;\n            });\n        }\n    });\n};\n\nFlux.prototype.sampleTimeout = function sampleTimeout<T>(\n    this: Flux<T>,\n    throttler: (value: T) => PublisherInput<unknown>\n): Flux<T> {\n    const source = this;\n    return new Flux((signal, context) => {\n        const queue = new AsyncQueue<T>(signal);\n        let version = 0;\n        void (async () => {\n            try {\n                for await (const value of source.iterate(signal, context)) {\n                    version += 1;\n                    const current = version;\n                    void drain(throttler(value), signal, context).then(() => {\n                        if (current === version) {\n                            queue.push(value);\n                        }\n                    }, error => queue.error(error));\n                }\n                queue.complete();\n            } catch (error) {\n                queue.error(error);\n            }\n        })();\n        return queue;\n    });\n};\n\nFlux.prototype.skipUntil = function skipUntil<T>(this: Flux<T>, predicate: (value: T) => boolean): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let open = false;\n        for await (const value of source.iterate(signal, context)) {\n            if (!open && predicate(value)) {\n                open = true;\n            }\n            if (open) {\n                yield value;\n            }\n        }\n    });\n};\n\nFlux.prototype.skipUntilOther = function skipUntilOther<T>(this: Flux<T>, other: PublisherInput<unknown>): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        await firstValueFromContext(other, signal, context);\n        for await (const value of source.iterate(signal, context)) {\n            yield value;\n        }\n    });\n};\n\nFlux.prototype.switchOnFirst = function switchOnFirst<T, R>(\n    this: Flux<T>,\n    transformer: (signal: Signal<T>, source: Flux<T>) => PublisherInput<R>\n): Flux<R> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        const iterator = toAsyncIterator(source.iterate(signal, context));\n        try {\n            const first = await iterator.next();\n            const firstSignal = first.done ? Signal.complete<T>() : Signal.next(first.value);\n            const rest = first.done ? Flux.empty<T>() : Flux.concat(Flux.just(first.value), new Flux(() => ({[Symbol.asyncIterator]: () => iterator})));\n            for await (const value of Flux.from(transformer(firstSignal, rest)).iterate(signal, context)) {\n                yield value;\n            }\n        } catch (error) {\n            for await (const value of Flux.from(transformer(Signal.error<T>(error), Flux.error<T>(error))).iterate(signal, context)) {\n                yield value;\n            }\n        }\n    });\n};\n\nFlux.prototype.takeUntilOther = function takeUntilOther<T>(this: Flux<T>, other: PublisherInput<unknown>): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        const stop: Promise<true> = firstValueFromContext(other, signal, context).then(() => true);\n        const iterator = toAsyncIterator(source.iterate(signal, context));\n        try {\n            while (!signal.aborted) {\n                const result = await Promise.race<IteratorResult<T> | true>([iterator.next(), stop]);\n                if (result === true || result.done) {\n                    return;\n                }\n                yield result.value;\n            }\n        } finally {\n            await iterator.return?.();\n        }\n    });\n};\n\nFlux.prototype.timed = function timed<T>(\n    this: Flux<T>,\n    scheduler: Scheduler = Schedulers.timeout()\n): Flux<Timed<T>> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let last = scheduler.now();\n        for await (const value of source.iterate(signal, context)) {\n            const timestamp = scheduler.now();\n            yield {elapsed: timestamp - last, timestamp, value};\n            last = timestamp;\n        }\n    });\n};\n\nFlux.prototype.withLatestFrom = function withLatestFrom<T, U, R = readonly [T, U]>(\n    this: Flux<T>,\n    other: PublisherInput<U>,\n    combinator?: (left: T, right: U) => R\n): Flux<R> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let latest: U | undefined;\n        let hasLatest = false;\n        void (async () => {\n            for await (const value of Flux.from(other).iterate(signal, context)) {\n                latest = value;\n                hasLatest = true;\n            }\n        })();\n        for await (const value of source.iterate(signal, context)) {\n            if (hasLatest) {\n                yield combinator ? combinator(value, latest as U) : ([value, latest] as unknown as R);\n            }\n        }\n    });\n};\n\nFlux.prototype.zipWithIterable = function zipWithIterable<T, U, R = readonly [T, U]>(\n    this: Flux<T>,\n    other: Iterable<U>,\n    combinator?: (left: T, right: U) => R\n): Flux<R> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        const iterator = other[Symbol.iterator]();\n        for await (const value of source.iterate(signal, context)) {\n            const next = iterator.next();\n            if (next.done) {\n                return;\n            }\n            yield combinator ? combinator(value, next.value) : ([value, next.value] as unknown as R);\n        }\n    });\n};\n\n/** Returns a Flux that preserves values while allowing delayed-error naming parity. */\nfunction delayErrors<T>(source: Flux<T>): Flux<T> {\n    return source;\n}\n\n/** Collects a finite publisher input into an array. */\nasync function collect<T>(source: PublisherInput<T>, signal: AbortSignal, context: Context): Promise<T[]> {\n    const values: T[] = [];\n    for await (const value of Flux.from(source).iterate(signal, context)) {\n        values.push(value);\n    }\n    return values;\n}\n\n/** Consumes a publisher input and ignores all 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/** Resolves the first value from a publisher input using the current subscriber context. */\nasync function firstValueFromContext<T>(source: PublisherInput<T>, signal: AbortSignal, context: Context): Promise<T | undefined> {\n    const iterator = toAsyncIterator(Flux.from(source).iterate(signal, context));\n    try {\n        const result = await iterator.next();\n        return result.done ? undefined : result.value;\n    } finally {\n        await iterator.return?.();\n    }\n}\n\n/** Returns true when a value is a duration input instead of a publisher 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/** Samples the latest source value whenever a scheduler period elapses. */\nfunction samplePeriodically<T>(source: Flux<T>, period: DurationInput, scheduler: Scheduler): Flux<T> {\n    return new Flux((signal, context) => {\n        const queue = new AsyncQueue<T>(signal);\n        let latest: T | undefined;\n        let hasLatest = false;\n        const periodic = scheduler.schedulePeriodically(() => {\n            if (hasLatest) {\n                queue.push(latest as T);\n                hasLatest = false;\n            }\n        }, period, period);\n        signal.addEventListener(\"abort\", () => periodic.dispose(), {once: true});\n        void (async () => {\n            try {\n                for await (const value of source.iterate(signal, context)) {\n                    latest = value;\n                    hasLatest = true;\n                }\n                periodic.dispose();\n                queue.complete();\n            } catch (error) {\n                periodic.dispose();\n                queue.error(error);\n            }\n        })();\n        return queue;\n    });\n}\n\n/** Samples the latest source value whenever another publisher emits. */\nfunction sampleWithPublisher<T>(source: Flux<T>, sampler: PublisherInput<unknown>): Flux<T> {\n    return new Flux((signal, context) => {\n        const queue = new AsyncQueue<T>(signal);\n        let latest: T | undefined;\n        let hasLatest = false;\n        void (async () => {\n            try {\n                await Promise.all([\n                    (async () => {\n                        for await (const value of source.iterate(signal, context)) {\n                            latest = value;\n                            hasLatest = true;\n                        }\n                    })(),\n                    (async () => {\n                        for await (const _ of Flux.from(sampler).iterate(signal, context)) {\n                            if (hasLatest) {\n                                queue.push(latest as T);\n                                hasLatest = false;\n                            }\n                        }\n                    })()\n                ]);\n                queue.complete();\n            } catch (error) {\n                queue.error(error);\n            }\n        })();\n        return queue;\n    });\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,17 @@
+import type { PublisherInput } from "../types.js";
+declare module "../flux.js" {
+    /** Error recovery and retry operators added to Flux. */
+    interface Flux<T> {
+        /** Switches to a fallback publisher when the source fails. */
+        onErrorResume<R = T>(fallback: (error: unknown) => PublisherInput<R>): Flux<T | R>;
+        /** Emits a fallback value when the source fails. */
+        onErrorReturn(fallbackValue: T): Flux<T>;
+        /** Replaces an upstream error with the mapper result. */
+        onErrorMap(mapper: (error: unknown) => unknown): Flux<T>;
+        /** Re-subscribes when the source fails, up to the configured retry count. */
+        retry(maxRetries?: number): Flux<T>;
+        /** Re-subscribes after successful completion, up to the configured repeat count. */
+        repeat(repeatCount?: number): Flux<T>;
+    }
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/publisher/operators/error.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEzD,OAAO,QAAQ,qBAAqB,CAAC;IACjC,wDAAwD;IACxD,UAAU,IAAI,CAAC,CAAC;QACZ,8DAA8D;QAC9D,aAAa,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEnF,oDAAoD;QACpD,aAAa,CAAC,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzC,yDAAyD;QACzD,UAAU,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEzD,6EAA6E;QAC7E,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpC,oFAAoF;QACpF,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;KACzC;CACJ"}

package/dist/publisher/operators/error.js

@@ -0,0 +1,48 @@
+import { Flux } from "../flux.js";
+//#region src/publisher/operators/error.ts
+/**
+* @packageDocumentation
+* Flux, Mono and operator implementation modules.
+*/
+Flux.prototype.onErrorResume = function onErrorResume(fallback) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		try {
+			for await (const value of source.iterate(signal, context)) yield value;
+		} catch (error) {
+			for await (const value of Flux.from(fallback(error)).iterate(signal, context)) yield value;
+		}
+	});
+};
+Flux.prototype.onErrorReturn = function onErrorReturn(fallbackValue) {
+	return this.onErrorResume(() => Flux.just(fallbackValue));
+};
+Flux.prototype.onErrorMap = function onErrorMap(mapper) {
+	return this.onErrorResume((error) => Flux.error(mapper(error)));
+};
+Flux.prototype.retry = function retry(maxRetries = Number.POSITIVE_INFINITY) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		let attempt = 0;
+		while (!signal.aborted) try {
+			for await (const value of source.iterate(signal, context)) yield value;
+			return;
+		} catch (error) {
+			if (attempt >= maxRetries) throw error;
+			attempt += 1;
+		}
+	});
+};
+Flux.prototype.repeat = function repeat(repeatCount = Number.POSITIVE_INFINITY) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		let repeated = 0;
+		do {
+			for await (const value of source.iterate(signal, context)) yield value;
+			repeated += 1;
+		} while (!signal.aborted && repeated <= repeatCount);
+	});
+};
+//#endregion
+
+//# sourceMappingURL=error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","names":[],"sources":["../../../src/publisher/operators/error.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Flux, Mono and operator implementation modules.\n */\nimport {Flux} from \"@/publisher/flux.js\";\nimport type {PublisherInput} from \"@/publisher/types.js\";\n\ndeclare module \"@/publisher/flux.js\" {\n    /** Error recovery and retry operators added to Flux. */\n    interface Flux<T> {\n        /** Switches to a fallback publisher when the source fails. */\n        onErrorResume<R = T>(fallback: (error: unknown) => PublisherInput<R>): Flux<T | R>;\n\n        /** Emits a fallback value when the source fails. */\n        onErrorReturn(fallbackValue: T): Flux<T>;\n\n        /** Replaces an upstream error with the mapper result. */\n        onErrorMap(mapper: (error: unknown) => unknown): Flux<T>;\n\n        /** Re-subscribes when the source fails, up to the configured retry count. */\n        retry(maxRetries?: number): Flux<T>;\n\n        /** Re-subscribes after successful completion, up to the configured repeat count. */\n        repeat(repeatCount?: number): Flux<T>;\n    }\n}\n\nFlux.prototype.onErrorResume = function onErrorResume<T, R = T>(\n    this: Flux<T>,\n    fallback: (error: unknown) => PublisherInput<R>\n): Flux<T | R> {\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            for await (const value of Flux.from(fallback(error)).iterate(signal, context)) {\n                yield value;\n            }\n        }\n    });\n};\n\nFlux.prototype.onErrorReturn = function onErrorReturn<T>(this: Flux<T>, fallbackValue: T): Flux<T> {\n    return this.onErrorResume(() => Flux.just(fallbackValue));\n};\n\nFlux.prototype.onErrorMap = function onErrorMap<T>(this: Flux<T>, mapper: (error: unknown) => unknown): Flux<T> {\n    return this.onErrorResume(error => Flux.error(mapper(error)));\n};\n\nFlux.prototype.retry = function retry<T>(this: Flux<T>, maxRetries = Number.POSITIVE_INFINITY): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let attempt = 0;\n        while (!signal.aborted) {\n            try {\n                for await (const value of source.iterate(signal, context)) {\n                    yield value;\n                }\n                return;\n            } catch (error) {\n                if (attempt >= maxRetries) {\n                    throw error;\n                }\n                attempt += 1;\n            }\n        }\n    });\n};\n\nFlux.prototype.repeat = function repeat<T>(this: Flux<T>, repeatCount = Number.POSITIVE_INFINITY): Flux<T> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        let repeated = 0;\n        do {\n            for await (const value of source.iterate(signal, context)) {\n                yield value;\n            }\n            repeated += 1;\n        } while (!signal.aborted && repeated <= repeatCount);\n    });\n};\n"],"mappings":";;;;;;AA2BA,KAAK,UAAU,gBAAgB,SAAS,cAEpC,UACW;CACX,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,WAAW,MAAM,SAAS,KAAK,KAAK,SAAS,KAAK,CAAC,CAAC,CAAC,QAAQ,QAAQ,OAAO,GACxE,MAAM;EAEd;CACJ,CAAC;AACL;AAEA,KAAK,UAAU,gBAAgB,SAAS,cAAgC,eAA2B;CAC/F,OAAO,KAAK,oBAAoB,KAAK,KAAK,aAAa,CAAC;AAC5D;AAEA,KAAK,UAAU,aAAa,SAAS,WAA6B,QAA8C;CAC5G,OAAO,KAAK,eAAc,UAAS,KAAK,MAAM,OAAO,KAAK,CAAC,CAAC;AAChE;AAEA,KAAK,UAAU,QAAQ,SAAS,MAAwB,aAAa,OAAO,mBAA4B;CACpG,MAAM,SAAS;CACf,OAAO,IAAI,KAAK,iBAAiB,QAAQ,SAAS;EAC9C,IAAI,UAAU;EACd,OAAO,CAAC,OAAO,SACX,IAAI;GACA,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GACpD,MAAM;GAEV;EACJ,SAAS,OAAO;GACZ,IAAI,WAAW,YACX,MAAM;GAEV,WAAW;EACf;CAER,CAAC;AACL;AAEA,KAAK,UAAU,SAAS,SAAS,OAAyB,cAAc,OAAO,mBAA4B;CACvG,MAAM,SAAS;CACf,OAAO,IAAI,KAAK,iBAAiB,QAAQ,SAAS;EAC9C,IAAI,WAAW;EACf,GAAG;GACC,WAAW,MAAM,SAAS,OAAO,QAAQ,QAAQ,OAAO,GACpD,MAAM;GAEV,YAAY;EAChB,SAAS,CAAC,OAAO,WAAW,YAAY;CAC5C,CAAC;AACL"}

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

@@ -0,0 +1,19 @@
+import type { PublisherInput } from "../types.js";
+declare module "../flux.js" {
+    /** Flattening and source-combining operators added to Flux. */
+    interface Flux<T> {
+        /** Maps each value to a publisher and merges inner publishers concurrently. */
+        flatMap<R>(mapper: (value: T) => PublisherInput<R>, concurrency?: number): Flux<R>;
+        /** Maps each value to a publisher and subscribes to inner publishers one at a time. */
+        concatMap<R>(mapper: (value: T) => PublisherInput<R>): Flux<R>;
+        /** Maps each value to a publisher and relays only the latest active inner publisher. */
+        switchMap<R>(mapper: (value: T) => PublisherInput<R>): Flux<R>;
+        /** Merges this Flux with additional publishers. */
+        mergeWith(...others: readonly PublisherInput<T>[]): Flux<T>;
+        /** Concatenates this Flux with additional publishers in order. */
+        concatWith(...others: readonly PublisherInput<T>[]): Flux<T>;
+        /** Prepends literal values before this Flux. */
+        startWith(...values: readonly T[]): Flux<T>;
+    }
+}
+//# sourceMappingURL=flatten.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../../src/publisher/operators/flatten.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEzD,OAAO,QAAQ,qBAAqB,CAAC;IACjC,+DAA+D;IAC/D,UAAU,IAAI,CAAC,CAAC;QACZ,+EAA+E;QAC/E,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnF,uFAAuF;QACvF,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE/D,wFAAwF;QACxF,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE/D,mDAAmD;QACnD,SAAS,CAAC,GAAG,MAAM,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE5D,kEAAkE;QAClE,UAAU,CAAC,GAAG,MAAM,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE7D,gDAAgD;QAChD,SAAS,CAAC,GAAG,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;KAC/C;CACJ"}

package/dist/publisher/operators/flatten.js

@@ -0,0 +1,127 @@
+import { AsyncQueue } from "../../internal/async-queue.js";
+import { Flux } from "../flux.js";
+//#region src/publisher/operators/flatten.ts
+Flux.prototype.flatMap = function flatMap(mapper, concurrency = Number.POSITIVE_INFINITY) {
+	if (concurrency <= 1) return this.concatMap(mapper);
+	const source = this;
+	if (concurrency === Number.POSITIVE_INFINITY) return flatMapUnbounded(source, mapper);
+	return new Flux((signal, context) => {
+		const queue = new AsyncQueue(signal);
+		const running = /* @__PURE__ */ new Set();
+		let failed = false;
+		(async () => {
+			try {
+				for await (const value of source.iterate(signal, context)) {
+					while (running.size >= concurrency && !signal.aborted) await Promise.race(running);
+					if (signal.aborted || failed) return;
+					let task = Promise.resolve();
+					task = (async () => {
+						try {
+							for await (const inner of Flux.from(mapper(value)).iterate(signal, context)) queue.push(inner);
+						} catch (error) {
+							failed = true;
+							queue.error(error);
+						} finally {
+							running.delete(task);
+						}
+					})();
+					running.add(task);
+				}
+				await Promise.all(running);
+				if (!failed) queue.complete();
+			} catch (error) {
+				queue.error(error);
+			}
+		})();
+		return queue;
+	});
+};
+/** Flat maps without bounded-concurrency bookkeeping for the default unbounded path. */
+function flatMapUnbounded(source, mapper) {
+	return new Flux((signal, context) => {
+		const queue = new AsyncQueue(signal);
+		const tasks = [];
+		let failed = false;
+		(async () => {
+			try {
+				for await (const value of source.iterate(signal, context)) {
+					if (signal.aborted || failed) return;
+					tasks.push(drainFlatMapInner(mapper(value), signal, context, queue, () => {
+						failed = true;
+					}));
+				}
+				await Promise.all(tasks);
+				if (!failed) queue.complete();
+			} catch (error) {
+				queue.error(error);
+			}
+		})();
+		return queue;
+	});
+}
+/** Drains one inner flatMap publisher into the shared output queue. */
+async function drainFlatMapInner(input, signal, context, queue, markFailed) {
+	try {
+		for await (const inner of Flux.from(input).iterate(signal, context)) queue.push(inner);
+	} catch (error) {
+		markFailed();
+		queue.error(error);
+	}
+}
+Flux.prototype.concatMap = function concatMap(mapper) {
+	const source = this;
+	return new Flux(async function* (signal, context) {
+		for await (const value of source.iterate(signal, context)) for await (const inner of Flux.from(mapper(value)).iterate(signal, context)) yield inner;
+	});
+};
+Flux.prototype.switchMap = function switchMap(mapper) {
+	const source = this;
+	return new Flux((signal, context) => {
+		const queue = new AsyncQueue(signal);
+		let active = 0;
+		let outerDone = false;
+		let failed = false;
+		const completeIfDone = () => {
+			if (outerDone && active === 0 && !failed) queue.complete();
+		};
+		(async () => {
+			try {
+				let version = 0;
+				for await (const value of source.iterate(signal, context)) {
+					version += 1;
+					const current = version;
+					active += 1;
+					(async () => {
+						try {
+							for await (const inner of Flux.from(mapper(value)).iterate(signal, context)) if (current === version) queue.push(inner);
+						} catch (error) {
+							failed = true;
+							queue.error(error);
+						} finally {
+							active -= 1;
+							completeIfDone();
+						}
+					})();
+				}
+				outerDone = true;
+				completeIfDone();
+			} catch (error) {
+				failed = true;
+				queue.error(error);
+			}
+		})();
+		return queue;
+	});
+};
+Flux.prototype.mergeWith = function mergeWith(...others) {
+	return Flux.merge(this, ...others);
+};
+Flux.prototype.concatWith = function concatWith(...others) {
+	return Flux.concat(this, ...others);
+};
+Flux.prototype.startWith = function startWith(...values) {
+	return Flux.concat(Flux.just(...values), this);
+};
+//#endregion
+
+//# sourceMappingURL=flatten.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.js","names":[],"sources":["../../../src/publisher/operators/flatten.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Flux, Mono and operator implementation modules.\n */\nimport type {Context} from \"@/context/context.js\";\nimport {AsyncQueue} from \"@/internal/async-queue.js\";\nimport {Flux} from \"@/publisher/flux.js\";\nimport type {PublisherInput} from \"@/publisher/types.js\";\n\ndeclare module \"@/publisher/flux.js\" {\n    /** Flattening and source-combining operators added to Flux. */\n    interface Flux<T> {\n        /** Maps each value to a publisher and merges inner publishers concurrently. */\n        flatMap<R>(mapper: (value: T) => PublisherInput<R>, concurrency?: number): Flux<R>;\n\n        /** Maps each value to a publisher and subscribes to inner publishers one at a time. */\n        concatMap<R>(mapper: (value: T) => PublisherInput<R>): Flux<R>;\n\n        /** Maps each value to a publisher and relays only the latest active inner publisher. */\n        switchMap<R>(mapper: (value: T) => PublisherInput<R>): Flux<R>;\n\n        /** Merges this Flux with additional publishers. */\n        mergeWith(...others: readonly PublisherInput<T>[]): Flux<T>;\n\n        /** Concatenates this Flux with additional publishers in order. */\n        concatWith(...others: readonly PublisherInput<T>[]): Flux<T>;\n\n        /** Prepends literal values before this Flux. */\n        startWith(...values: readonly T[]): Flux<T>;\n    }\n}\n\nFlux.prototype.flatMap = function flatMap<T, R>(\n    this: Flux<T>,\n    mapper: (value: T) => PublisherInput<R>,\n    concurrency = Number.POSITIVE_INFINITY\n): Flux<R> {\n    if (concurrency <= 1) {\n        return this.concatMap(mapper);\n    }\n    const source = this;\n    if (concurrency === Number.POSITIVE_INFINITY) {\n        return flatMapUnbounded(source, mapper);\n    }\n    return new Flux((signal, context) => {\n        const queue = new AsyncQueue<R>(signal);\n        const running = new Set<Promise<void>>();\n        let failed = false;\n        void (async () => {\n            try {\n                for await (const value of source.iterate(signal, context)) {\n                    while (running.size >= concurrency && !signal.aborted) {\n                        await Promise.race(running);\n                    }\n                    if (signal.aborted || failed) {\n                        return;\n                    }\n                    let task: Promise<void> = Promise.resolve();\n                    task = (async () => {\n                        try {\n                            for await (const inner of Flux.from(mapper(value)).iterate(signal, context)) {\n                                queue.push(inner);\n                            }\n                        } catch (error) {\n                            failed = true;\n                            queue.error(error);\n                        } finally {\n                            running.delete(task);\n                        }\n                    })();\n                    running.add(task);\n                }\n                await Promise.all(running);\n                if (!failed) {\n                    queue.complete();\n                }\n            } catch (error) {\n                queue.error(error);\n            }\n        })();\n        return queue;\n    });\n};\n\n/** Flat maps without bounded-concurrency bookkeeping for the default unbounded path. */\nfunction flatMapUnbounded<T, R>(source: Flux<T>, mapper: (value: T) => PublisherInput<R>): Flux<R> {\n    return new Flux((signal, context) => {\n        const queue = new AsyncQueue<R>(signal);\n        const tasks: Array<Promise<void>> = [];\n        let failed = false;\n        void (async () => {\n            try {\n                for await (const value of source.iterate(signal, context)) {\n                    if (signal.aborted || failed) {\n                        return;\n                    }\n                    tasks.push(drainFlatMapInner(mapper(value), signal, context, queue, () => {\n                        failed = true;\n                    }));\n                }\n                await Promise.all(tasks);\n                if (!failed) {\n                    queue.complete();\n                }\n            } catch (error) {\n                queue.error(error);\n            }\n        })();\n        return queue;\n    });\n}\n\n/** Drains one inner flatMap publisher into the shared output queue. */\nasync function drainFlatMapInner<R>(\n    input: PublisherInput<R>,\n    signal: AbortSignal,\n    context: Context,\n    queue: AsyncQueue<R>,\n    markFailed: () => void\n): Promise<void> {\n    try {\n        for await (const inner of Flux.from(input).iterate(signal, context)) {\n            queue.push(inner);\n        }\n    } catch (error) {\n        markFailed();\n        queue.error(error);\n    }\n}\n\nFlux.prototype.concatMap = function concatMap<T, R>(\n    this: Flux<T>,\n    mapper: (value: T) => PublisherInput<R>\n): Flux<R> {\n    const source = this;\n    return new Flux(async function* (signal, context) {\n        for await (const value of source.iterate(signal, context)) {\n            for await (const inner of Flux.from(mapper(value)).iterate(signal, context)) {\n                yield inner;\n            }\n        }\n    });\n};\n\nFlux.prototype.switchMap = function switchMap<T, R>(\n    this: Flux<T>,\n    mapper: (value: T) => PublisherInput<R>\n): Flux<R> {\n    const source = this;\n    return new Flux((signal, context) => {\n        const queue = new AsyncQueue<R>(signal);\n        let active = 0;\n        let outerDone = false;\n        let failed = false;\n        const completeIfDone = () => {\n            if (outerDone && active === 0 && !failed) {\n                queue.complete();\n            }\n        };\n        void (async () => {\n            try {\n                let version = 0;\n                for await (const value of source.iterate(signal, context)) {\n                    version += 1;\n                    const current = version;\n                    active += 1;\n                    void (async () => {\n                        try {\n                            for await (const inner of Flux.from(mapper(value)).iterate(signal, context)) {\n                                if (current === version) {\n                                    queue.push(inner);\n                                }\n                            }\n                        } catch (error) {\n                            failed = true;\n                            queue.error(error);\n                        } finally {\n                            active -= 1;\n                            completeIfDone();\n                        }\n                    })();\n                }\n                outerDone = true;\n                completeIfDone();\n            } catch (error) {\n                failed = true;\n                queue.error(error);\n            }\n        })();\n        return queue;\n    });\n};\n\nFlux.prototype.mergeWith = function mergeWith<T>(this: Flux<T>, ...others: readonly PublisherInput<T>[]): Flux<T> {\n    return Flux.merge(this, ...others);\n};\n\nFlux.prototype.concatWith = function concatWith<T>(this: Flux<T>, ...others: readonly PublisherInput<T>[]): Flux<T> {\n    return Flux.concat(this, ...others);\n};\n\nFlux.prototype.startWith = function startWith<T>(this: Flux<T>, ...values: readonly T[]): Flux<T> {\n    return Flux.concat(Flux.just(...values), this);\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,103 @@
+/**
+ * @packageDocumentation
+ * Reactor lifecycle, context, logging and browser backpressure compatibility operators.
+ */
+import { Context } from "../../context/context.js";
+import { ContextView } from "../../context/context-view.js";
+import type { PublisherInput } from "../types.js";
+import type { DurationInput, Scheduler } from "../../schedulers/types.js";
+import { Signal } from "../../signal/signal.js";
+import type { Subscription } from "../../subscription/subscription.js";
+/** Listener shape accepted by the lightweight `tap` compatibility operator. */
+export interface FluxTapListener<T> {
+    /** Invoked for each next value. */
+    onNext?(value: T): void;
+    /** Invoked when the sequence fails. */
+    onError?(error: unknown): void;
+    /** Invoked when the sequence completes. */
+    onComplete?(): void;
+    /** Invoked when the sequence is cancelled. */
+    onCancel?(): void;
+    /** Invoked for materialized next, error and complete signals. */
+    onSignal?(signal: Signal<T>): void;
+}
+declare module "../flux.js" {
+    /** Lifecycle, context and browser backpressure compatibility operators added to Flux. */
+    interface Flux<T> {
+        /** Replays the collected source values to later subscribers. */
+        cache(ttl?: DurationInput, scheduler?: Scheduler): Flux<T>;
+        /** Schedules cancellation on the provided scheduler when supported by the source. */
+        cancelOn(scheduler: Scheduler): Flux<T>;
+        /** Adds an assembly checkpoint marker. Browser implementation keeps the source unchanged. */
+        checkpoint(description?: string, forceStackTrace?: boolean): Flux<T>;
+        /** Captures ambient context when an integration provides it. Browser implementation keeps the source unchanged. */
+        contextCapture(): Flux<T>;
+        /** Writes subscriber context for upstream operators. */
+        contextWrite(context: ContextView | Context | ((context: Context) => Context)): Flux<T>;
+        /** Delays subscribing to the source. */
+        delaySequence(delay: DurationInput, scheduler?: Scheduler): Flux<T>;
+        /** Delays subscribing to the source by time or until another publisher signals. */
+        delaySubscription(delay: DurationInput | PublisherInput<unknown>, scheduler?: Scheduler): Flux<T>;
+        /** Delays each value until the trigger publisher derived from that value completes. */
+        delayUntil(triggerProvider: (value: T) => PublisherInput<unknown>): Flux<T>;
+        /** Invokes a callback after successful or failed termination. */
+        doAfterTerminate(callback: () => void): Flux<T>;
+        /** Invokes a callback before source iteration starts. */
+        doFirst(callback: () => void): Flux<T>;
+        /** Invokes a callback when the subscription is cancelled. */
+        doOnCancel(callback: () => void): Flux<T>;
+        /** Registers a discard hook. Browser implementation keeps values unchanged. */
+        doOnDiscard<R>(type: new (...args: never[]) => R, callback: (value: R) => void): Flux<T>;
+        /** Invokes a callback for every materialized source signal. */
+        doOnEach(callback: (signal: Signal<T>) => void): Flux<T>;
+        /** Invokes a callback when unbounded demand is requested by the async bridge. */
+        doOnRequest(callback: (request: number) => void): Flux<T>;
+        /** Invokes a callback with a synthetic subscription before source iteration starts. */
+        doOnSubscribe(callback: (subscription: Subscription) => void): Flux<T>;
+        /** Invokes a callback before successful or failed termination. */
+        doOnTerminate(callback: () => void): Flux<T>;
+        /** Keeps request batching metadata. Browser async iteration returns this source unchanged. */
+        limitRate(highTide: number, lowTide?: number): Flux<T>;
+        /** Limits the total number of requested values. */
+        limitRequest(n: number): Flux<T>;
+        /** Logs source signals to the console. */
+        log(category?: string): Flux<T>;
+        /** Keeps metrics compatibility metadata. Browser implementation returns this source unchanged. */
+        metrics(): Flux<T>;
+        /** Keeps a human-readable sequence name. Browser implementation returns this source unchanged. */
+        name(name: string): Flux<T>;
+        /** Buffers on backpressure. Browser async iteration already buffers by pull demand. */
+        onBackpressureBuffer(...args: unknown[]): Flux<T>;
+        /** Drops on backpressure. Browser async iteration keeps pull demand and returns this source unchanged. */
+        onBackpressureDrop(callback?: (value: T) => void): Flux<T>;
+        /** Fails on backpressure. Browser async iteration keeps pull demand and returns this source unchanged. */
+        onBackpressureError(): Flux<T>;
+        /** Keeps only the latest value on backpressure. Browser async iteration returns this source unchanged. */
+        onBackpressureLatest(): Flux<T>;
+        /** Completes instead of failing when the optional predicate accepts the error. */
+        onErrorComplete(predicate?: (error: unknown) => boolean): Flux<T>;
+        /** Continues with completion after invoking an error continuation callback. */
+        onErrorContinue(callback: (error: unknown, value: T | undefined) => void): Flux<T>;
+        /** Stops error continuation mode. Browser implementation returns this source unchanged. */
+        onErrorStop(): Flux<T>;
+        /** Drops terminal-reference retention hints. Browser implementation returns this source unchanged. */
+        onTerminateDetach(): Flux<T>;
+        /** Transforms a shared source or returns a shared source view. */
+        publish<R = T>(transformer?: (source: Flux<T>) => PublisherInput<R>): Flux<R>;
+        /** Returns a Mono with the next value from this source. */
+        publishNext(): import("../mono.js").Mono<T>;
+        /** Returns a replaying view of this source. */
+        replay(...args: unknown[]): Flux<T>;
+        /** Returns a shared browser view of this source. */
+        share(): Flux<T>;
+        /** Returns a Mono with the next value from a shared source. */
+        shareNext(): import("../mono.js").Mono<T>;
+        /** Stores a metadata tag. Browser implementation returns this source unchanged. */
+        tag(key: string, value: string): Flux<T>;
+        /** Installs listener callbacks for values, terminal signals, and cancellation. */
+        tap(listener: FluxTapListener<T> | (() => FluxTapListener<T>)): Flux<T>;
+        /** Returns an async iterator stream view of this Flux. */
+        toStream(): AsyncIterable<T>;
+    }
+}
+//# sourceMappingURL=lifecycle.d.ts.map

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

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