reactor-core-ts 2.1.6 → 3.2.1

package/dist/sinks/one.js

@@ -0,0 +1,144 @@
+import _defineProperty from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/defineProperty.js";
+import { AsyncQueue } from "../internal/async-queue.js";
+import { SignalType } from "../signal/signal-type.js";
+import { Mono } from "../publisher/mono.js";
+import { addSinkSubscriber, clearSinkSubscribers, removeSinkSubscriber, sinkSubscriberCount } from "./subscribers.js";
+import { EmitFailureHandlers, EmitResult, emitOrThrow } from "./types.js";
+//#region src/sinks/one.ts
+/**
+* @packageDocumentation
+* Sink specifications and default browser-oriented sink implementations.
+*/
+/** Default replaying implementation for `Sinks.one()` and `Sinks.empty()`. */
+var DefaultOneSink = class {
+	constructor() {
+		_defineProperty(
+			this,
+			/** Current terminal or pending state of the sink. */
+			"state",
+			"pending"
+		);
+		_defineProperty(
+			this,
+			/** Stored value replayed to late subscribers after successful termination. */
+			"value",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Stored error replayed to late subscribers after failed termination. */
+			"errorValue",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Active subscriber queues waiting for the terminal result, created only when needed. */
+			"subscribers",
+			void 0
+		);
+	}
+	/** Returns the Mono view of this sink. */
+	asMono() {
+		return new Mono((signal) => {
+			const queue = new AsyncQueue(signal);
+			this.replay(queue);
+			if (this.state === "pending") this.addSubscriber(queue, signal);
+			return queue;
+		});
+	}
+	/** Attempts to emit a value and complete this sink. */
+	tryEmitValue(value) {
+		if (this.state !== "pending") return EmitResult.FAIL_TERMINATED;
+		this.state = "value";
+		this.value = value;
+		const subscribers = this.subscribers;
+		if (subscribers instanceof Set) for (const subscriber of subscribers) {
+			subscriber.push(value);
+			subscriber.complete();
+		}
+		else if (subscribers) {
+			subscribers.push(value);
+			subscribers.complete();
+		}
+		this.clearSubscribers();
+		return EmitResult.OK;
+	}
+	/** Attempts to complete this sink without a value. */
+	tryEmitEmpty() {
+		if (this.state !== "pending") return EmitResult.FAIL_TERMINATED;
+		this.state = "empty";
+		const subscribers = this.subscribers;
+		if (subscribers instanceof Set) for (const subscriber of subscribers) subscriber.complete();
+		else if (subscribers) subscribers.complete();
+		this.clearSubscribers();
+		return EmitResult.OK;
+	}
+	/** Attempts to fail this sink. */
+	tryEmitError(error) {
+		if (this.state !== "pending") return EmitResult.FAIL_TERMINATED;
+		this.state = "error";
+		this.errorValue = error;
+		const subscribers = this.subscribers;
+		if (subscribers instanceof Set) for (const subscriber of subscribers) subscriber.error(error);
+		else if (subscribers) subscribers.error(error);
+		this.clearSubscribers();
+		return EmitResult.OK;
+	}
+	/** Emits a value or delegates failure handling to the provided handler. */
+	emitValue(value, handler = EmitFailureHandlers.FAIL_FAST) {
+		const result = this.tryEmitValue(value);
+		if (result !== EmitResult.FAIL_TERMINATED) emitOrThrow(SignalType.NEXT, () => result, handler);
+	}
+	/** Completes this sink or delegates failure handling to the provided handler. */
+	emitEmpty(handler = EmitFailureHandlers.FAIL_FAST) {
+		const result = this.tryEmitEmpty();
+		if (result !== EmitResult.FAIL_TERMINATED) emitOrThrow(SignalType.COMPLETE, () => result, handler);
+	}
+	/** Fails this sink or delegates failure handling to the provided handler. */
+	emitError(error, handler = EmitFailureHandlers.FAIL_FAST) {
+		const result = this.tryEmitError(error);
+		if (result !== EmitResult.FAIL_TERMINATED) emitOrThrow(SignalType.ERROR, () => result, handler, error);
+	}
+	/** Returns the current number of active subscribers. */
+	currentSubscriberCount() {
+		return sinkSubscriberCount(this.subscribers);
+	}
+	/** Handles an emission failure and returns false to fail fast by default. */
+	onEmitFailure(_signalType, _emitResult) {
+		return false;
+	}
+	/** Adds a subscriber queue and removes it again when its subscription is cancelled. */
+	addSubscriber(queue, signal) {
+		this.subscribers = addSinkSubscriber(this.subscribers, queue);
+		signal.addEventListener("abort", () => this.removeSubscriber(queue), { once: true });
+	}
+	/** Removes a subscriber queue and releases the set when it becomes empty. */
+	removeSubscriber(queue) {
+		this.subscribers = removeSinkSubscriber(this.subscribers, queue);
+	}
+	/** Clears and releases all active subscriber queues. */
+	clearSubscribers() {
+		clearSinkSubscribers(this.subscribers);
+		this.subscribers = void 0;
+	}
+	/** Replays the current state into a newly subscribed queue. */
+	replay(queue) {
+		switch (this.state) {
+			case "value":
+				queue.push(this.value);
+				queue.complete();
+				break;
+			case "empty":
+				queue.complete();
+				break;
+			case "error":
+				queue.error(this.errorValue);
+				break;
+			case "pending": break;
+		}
+	}
+};
+//#endregion
+export { DefaultOneSink };
+
+//# sourceMappingURL=one.js.map

package/dist/sinks/one.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"one.js","names":[],"sources":["../../src/sinks/one.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Sink specifications and default browser-oriented sink implementations.\n */\nimport {AsyncQueue} from \"@/internal/async-queue.js\";\nimport {Mono} from \"@/publisher/mono.js\";\nimport {SignalType} from \"@/signal/signal-type.js\";\nimport {\n    addSinkSubscriber,\n    clearSinkSubscribers,\n    removeSinkSubscriber,\n    sinkSubscriberCount,\n    type SinkSubscribers\n} from \"@/sinks/subscribers.js\";\nimport {type EmitFailureHandler, EmitFailureHandlers, emitOrThrow, EmitResult, type OneSink} from \"@/sinks/types.js\";\n\n/** Terminal or pending state held by a one-valued sink. */\ntype OneState = \"pending\" | \"empty\" | \"value\" | \"error\";\n\n/** Default replaying implementation for `Sinks.one()` and `Sinks.empty()`. */\nexport class DefaultOneSink<T> implements OneSink<T> {\n    /** Current terminal or pending state of the sink. */\n    private state: OneState = \"pending\";\n    /** Stored value replayed to late subscribers after successful termination. */\n    private value: T | undefined;\n    /** Stored error replayed to late subscribers after failed termination. */\n    private errorValue: unknown;\n    /** Active subscriber queues waiting for the terminal result, created only when needed. */\n    private subscribers: SinkSubscribers<T> | undefined;\n\n    /** Returns the Mono view of this sink. */\n    public asMono(): Mono<T> {\n        return new Mono(signal => {\n            const queue = new AsyncQueue<T>(signal);\n            this.replay(queue);\n            if (this.state === \"pending\") {\n                this.addSubscriber(queue, signal);\n            }\n            return queue;\n        });\n    }\n\n    /** Attempts to emit a value and complete this sink. */\n    public tryEmitValue(value: T): EmitResult {\n        if (this.state !== \"pending\") {\n            return EmitResult.FAIL_TERMINATED;\n        }\n        this.state = \"value\";\n        this.value = value;\n        const subscribers = this.subscribers;\n        if (subscribers instanceof Set) {\n            for (const subscriber of subscribers) {\n                subscriber.push(value);\n                subscriber.complete();\n            }\n        } else if (subscribers) {\n            subscribers.push(value);\n            subscribers.complete();\n        }\n        this.clearSubscribers();\n        return EmitResult.OK;\n    }\n\n    /** Attempts to complete this sink without a value. */\n    public tryEmitEmpty(): EmitResult {\n        if (this.state !== \"pending\") {\n            return EmitResult.FAIL_TERMINATED;\n        }\n        this.state = \"empty\";\n        const subscribers = this.subscribers;\n        if (subscribers instanceof Set) {\n            for (const subscriber of subscribers) {\n                subscriber.complete();\n            }\n        } else if (subscribers) {\n            subscribers.complete();\n        }\n        this.clearSubscribers();\n        return EmitResult.OK;\n    }\n\n    /** Attempts to fail this sink. */\n    public tryEmitError(error: unknown): EmitResult {\n        if (this.state !== \"pending\") {\n            return EmitResult.FAIL_TERMINATED;\n        }\n        this.state = \"error\";\n        this.errorValue = error;\n        const subscribers = this.subscribers;\n        if (subscribers instanceof Set) {\n            for (const subscriber of subscribers) {\n                subscriber.error(error);\n            }\n        } else if (subscribers) {\n            subscribers.error(error);\n        }\n        this.clearSubscribers();\n        return EmitResult.OK;\n    }\n\n    /** Emits a value or delegates failure handling to the provided handler. */\n    public emitValue(value: T, handler: EmitFailureHandler = EmitFailureHandlers.FAIL_FAST): void {\n        const result = this.tryEmitValue(value);\n        if (result !== EmitResult.FAIL_TERMINATED) {\n            emitOrThrow(SignalType.NEXT, () => result, handler);\n        }\n    }\n\n    /** Completes this sink or delegates failure handling to the provided handler. */\n    public emitEmpty(handler: EmitFailureHandler = EmitFailureHandlers.FAIL_FAST): void {\n        const result = this.tryEmitEmpty();\n        if (result !== EmitResult.FAIL_TERMINATED) {\n            emitOrThrow(SignalType.COMPLETE, () => result, handler);\n        }\n    }\n\n    /** Fails this sink or delegates failure handling to the provided handler. */\n    public emitError(error: unknown, handler: EmitFailureHandler = EmitFailureHandlers.FAIL_FAST): void {\n        const result = this.tryEmitError(error);\n        if (result !== EmitResult.FAIL_TERMINATED) {\n            emitOrThrow(SignalType.ERROR, () => result, handler, error);\n        }\n    }\n\n    /** Returns the current number of active subscribers. */\n    public currentSubscriberCount(): number {\n        return sinkSubscriberCount(this.subscribers);\n    }\n\n    /** Handles an emission failure and returns false to fail fast by default. */\n    public onEmitFailure(_signalType: SignalType, _emitResult: EmitResult): boolean {\n        return false;\n    }\n\n    /** Adds a subscriber queue and removes it again when its subscription is cancelled. */\n    private addSubscriber(queue: AsyncQueue<T>, signal: AbortSignal): void {\n        this.subscribers = addSinkSubscriber(this.subscribers, queue);\n        signal.addEventListener(\"abort\", () => this.removeSubscriber(queue), {once: true});\n    }\n\n    /** Removes a subscriber queue and releases the set when it becomes empty. */\n    private removeSubscriber(queue: AsyncQueue<T>): void {\n        this.subscribers = removeSinkSubscriber(this.subscribers, queue);\n    }\n\n    /** Clears and releases all active subscriber queues. */\n    private clearSubscribers(): void {\n        clearSinkSubscribers(this.subscribers);\n        this.subscribers = undefined;\n    }\n\n    /** Replays the current state into a newly subscribed queue. */\n    private replay(queue: AsyncQueue<T>): void {\n        switch (this.state) {\n            case \"value\":\n                queue.push(this.value as T);\n                queue.complete();\n                break;\n            case \"empty\":\n                queue.complete();\n                break;\n            case \"error\":\n                queue.error(this.errorValue);\n                break;\n            case \"pending\":\n                break;\n        }\n    }\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,IAAa,iBAAb,MAAqD;;;;;GAEjD;GAA0B;;;;;GAE1B;;;;;;GAEA;;;;;;GAEA;;;;;CAGA,SAAyB;EACrB,OAAO,IAAI,MAAK,WAAU;GACtB,MAAM,QAAQ,IAAI,WAAc,MAAM;GACtC,KAAK,OAAO,KAAK;GACjB,IAAI,KAAK,UAAU,WACf,KAAK,cAAc,OAAO,MAAM;GAEpC,OAAO;EACX,CAAC;CACL;;CAGA,aAAoB,OAAsB;EACtC,IAAI,KAAK,UAAU,WACf,OAAO,WAAW;EAEtB,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,MAAM,cAAc,KAAK;EACzB,IAAI,uBAAuB,KACvB,KAAK,MAAM,cAAc,aAAa;GAClC,WAAW,KAAK,KAAK;GACrB,WAAW,SAAS;EACxB;OACG,IAAI,aAAa;GACpB,YAAY,KAAK,KAAK;GACtB,YAAY,SAAS;EACzB;EACA,KAAK,iBAAiB;EACtB,OAAO,WAAW;CACtB;;CAGA,eAAkC;EAC9B,IAAI,KAAK,UAAU,WACf,OAAO,WAAW;EAEtB,KAAK,QAAQ;EACb,MAAM,cAAc,KAAK;EACzB,IAAI,uBAAuB,KACvB,KAAK,MAAM,cAAc,aACrB,WAAW,SAAS;OAErB,IAAI,aACP,YAAY,SAAS;EAEzB,KAAK,iBAAiB;EACtB,OAAO,WAAW;CACtB;;CAGA,aAAoB,OAA4B;EAC5C,IAAI,KAAK,UAAU,WACf,OAAO,WAAW;EAEtB,KAAK,QAAQ;EACb,KAAK,aAAa;EAClB,MAAM,cAAc,KAAK;EACzB,IAAI,uBAAuB,KACvB,KAAK,MAAM,cAAc,aACrB,WAAW,MAAM,KAAK;OAEvB,IAAI,aACP,YAAY,MAAM,KAAK;EAE3B,KAAK,iBAAiB;EACtB,OAAO,WAAW;CACtB;;CAGA,UAAiB,OAAU,UAA8B,oBAAoB,WAAiB;EAC1F,MAAM,SAAS,KAAK,aAAa,KAAK;EACtC,IAAI,WAAW,WAAW,iBACtB,YAAY,WAAW,YAAY,QAAQ,OAAO;CAE1D;;CAGA,UAAiB,UAA8B,oBAAoB,WAAiB;EAChF,MAAM,SAAS,KAAK,aAAa;EACjC,IAAI,WAAW,WAAW,iBACtB,YAAY,WAAW,gBAAgB,QAAQ,OAAO;CAE9D;;CAGA,UAAiB,OAAgB,UAA8B,oBAAoB,WAAiB;EAChG,MAAM,SAAS,KAAK,aAAa,KAAK;EACtC,IAAI,WAAW,WAAW,iBACtB,YAAY,WAAW,aAAa,QAAQ,SAAS,KAAK;CAElE;;CAGA,yBAAwC;EACpC,OAAO,oBAAoB,KAAK,WAAW;CAC/C;;CAGA,cAAqB,aAAyB,aAAkC;EAC5E,OAAO;CACX;;CAGA,cAAsB,OAAsB,QAA2B;EACnE,KAAK,cAAc,kBAAkB,KAAK,aAAa,KAAK;EAC5D,OAAO,iBAAiB,eAAe,KAAK,iBAAiB,KAAK,GAAG,EAAC,MAAM,KAAI,CAAC;CACrF;;CAGA,iBAAyB,OAA4B;EACjD,KAAK,cAAc,qBAAqB,KAAK,aAAa,KAAK;CACnE;;CAGA,mBAAiC;EAC7B,qBAAqB,KAAK,WAAW;EACrC,KAAK,cAAc;CACvB;;CAGA,OAAe,OAA4B;EACvC,QAAQ,KAAK,OAAb;GACI,KAAK;IACD,MAAM,KAAK,KAAK,KAAU;IAC1B,MAAM,SAAS;IACf;GACJ,KAAK;IACD,MAAM,SAAS;IACf;GACJ,KAAK;IACD,MAAM,MAAM,KAAK,UAAU;IAC3B;GACJ,KAAK,WACD;EACR;CACJ;AACJ"}

package/dist/sinks/specs.d.ts

@@ -0,0 +1,25 @@
+import type { EmptySink, ManySink, ManySpec, ManyWithUpstreamSpec, OneSink } from "./types.js";
+/** Builder tree for unsafe sinks that can subscribe to upstream publishers. */
+declare const unsafeSpec: {
+    /** Creates an empty sink that can only terminate. */
+    empty<T>(): EmptySink<T>;
+    /** Creates a one-valued sink that replays its terminal result. */
+    one<T>(): OneSink<T>;
+    /** Returns builders for many-valued sinks. */
+    many(): ManySpec;
+    /** Returns builders for many-valued sinks that can subscribe to one upstream publisher. */
+    manyWithUpstream(): ManyWithUpstreamSpec;
+};
+/** Public Sinks factory facade. */
+export declare const Sinks: Readonly<{
+    /** Creates an empty sink that can only terminate. */
+    empty<T>(): EmptySink<T>;
+    /** Creates a one-valued sink that replays its terminal result. */
+    one<T>(): OneSink<T>;
+    /** Returns builders for many-valued sinks. */
+    many(): ManySpec;
+    /** Returns unsafe sink builders. */
+    unsafe(): typeof unsafeSpec;
+}>;
+export type { ManySink };
+//# sourceMappingURL=specs.d.ts.map

package/dist/sinks/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../src/sinks/specs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,oBAAoB,EAEpB,OAAO,EAGR,MAAM,kBAAkB,CAAC;AAqF1B,+EAA+E;AAC/E,QAAA,MAAM,UAAU,EAAE;IACd,qDAAqD;IACrD,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;IACzB,kEAAkE;IAClE,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,8CAA8C;IAC9C,IAAI,IAAI,QAAQ,CAAC;IACjB,2FAA2F;IAC3F,gBAAgB,IAAI,oBAAoB,CAAC;CAqB3C,CAAC;AAEH,mCAAmC;AACnC,eAAO,MAAM,KAAK;IACd,qDAAqD;UAC/C,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IAIxB,kEAAkE;QAC9D,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAIpB,8CAA8C;YACtC,QAAQ;IAIhB,oCAAoC;cAC1B,OAAO,UAAU;EAG7B,CAAC;AAEH,YAAY,EAAC,QAAQ,EAAC,CAAC"}

package/dist/sinks/specs.js

@@ -0,0 +1,126 @@
+import { DefaultManySink } from "./many.js";
+import { DefaultOneSink } from "./one.js";
+//#region src/sinks/specs.ts
+/**
+* @packageDocumentation
+* Sink specifications and default browser-oriented sink implementations.
+*/
+/** Shared builders for unicast many-valued sinks. */
+var unicastSpec = Object.freeze({
+	/** Creates a unicast sink with backpressure buffering. */
+	onBackpressureBuffer() {
+		return new DefaultManySink({ mode: "unicast" });
+	},
+	/** Creates a unicast sink that fails emission when demand cannot be honored. */
+	onBackpressureError() {
+		return new DefaultManySink({ mode: "unicast-error" });
+	}
+});
+/** Shared builders for multicast many-valued sinks. */
+var multicastSpec = Object.freeze({
+	/** Creates a multicast sink that buffers when subscribers are temporarily absent. */
+	onBackpressureBuffer() {
+		return new DefaultManySink({ mode: "multicast-buffer" });
+	},
+	/** Creates a multicast sink that fails emission when no subscriber can receive it. */
+	directAllOrNothing() {
+		return new DefaultManySink({ mode: "multicast-direct" });
+	},
+	/** Creates a multicast sink that emits to currently available subscribers. */
+	directBestEffort() {
+		return new DefaultManySink({ mode: "multicast-direct" });
+	}
+});
+/** Shared builders for replaying many-valued sinks. */
+var replaySpec = Object.freeze({
+	/** Creates a replay sink retaining every emitted value. */
+	all() {
+		return new DefaultManySink({ mode: "replay" });
+	},
+	/** Creates a replay sink retaining at most `historySize` values. */
+	limit(historySize) {
+		if (!Number.isInteger(historySize) || historySize <= 0) throw new RangeError("historySize must be a strictly positive integer");
+		return new DefaultManySink({
+			mode: "replay",
+			replayLimit: historySize
+		});
+	},
+	/** Creates a replay sink retaining only the latest emitted value. */
+	latest() {
+		return new DefaultManySink({
+			mode: "replay",
+			replayLimit: 1
+		});
+	},
+	/** Creates a replay sink with an initial default latest value. */
+	latestOrDefault(value) {
+		return new DefaultManySink({
+			mode: "replay",
+			replayLimit: 1,
+			latestDefault: value
+		});
+	}
+});
+/** Shared builder tree for many-valued sink variants. */
+var manySpec = Object.freeze({
+	/** Returns builders for unicast many-valued sinks. */
+	unicast() {
+		return unicastSpec;
+	},
+	/** Returns builders for multicast many-valued sinks. */
+	multicast() {
+		return multicastSpec;
+	},
+	/** Returns builders for replaying many-valued sinks. */
+	replay() {
+		return replaySpec;
+	}
+});
+/** Shared unsafe builders for many-valued sinks that subscribe to upstream publishers. */
+var manyWithUpstreamSpec = Object.freeze({ 
+/** Creates a multicast sink that buffers and can subscribe to one upstream publisher. */
+multicastOnBackpressureBuffer() {
+	return new DefaultManySink({ mode: "multicast-buffer" });
+} });
+/** Builder tree for unsafe sinks that can subscribe to upstream publishers. */
+var unsafeSpec = Object.freeze({
+	/** Creates an empty sink that can only terminate. */
+	empty() {
+		return new DefaultOneSink();
+	},
+	/** Creates a one-valued sink that replays its terminal result. */
+	one() {
+		return new DefaultOneSink();
+	},
+	/** Returns builders for many-valued sinks. */
+	many() {
+		return manySpec;
+	},
+	/** Returns builders for many-valued sinks that can subscribe to one upstream publisher. */
+	manyWithUpstream() {
+		return manyWithUpstreamSpec;
+	}
+});
+/** Public Sinks factory facade. */
+var Sinks = Object.freeze({
+	/** Creates an empty sink that can only terminate. */
+	empty() {
+		return new DefaultOneSink();
+	},
+	/** Creates a one-valued sink that replays its terminal result. */
+	one() {
+		return new DefaultOneSink();
+	},
+	/** Returns builders for many-valued sinks. */
+	many() {
+		return manySpec;
+	},
+	/** Returns unsafe sink builders. */
+	unsafe() {
+		return unsafeSpec;
+	}
+});
+//#endregion
+export { Sinks };
+
+//# sourceMappingURL=specs.js.map

package/dist/sinks/specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.js","names":[],"sources":["../../src/sinks/specs.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Sink specifications and default browser-oriented sink implementations.\n */\nimport {DefaultManySink} from \"@/sinks/many.js\";\nimport {DefaultOneSink} from \"@/sinks/one.js\";\nimport type {\n  EmptySink,\n  ManySink,\n  ManySpec,\n  ManyWithUpstreamSpec,\n  MulticastSpec,\n  OneSink,\n  ReplaySpec,\n  UnicastSpec\n} from \"@/sinks/types.js\";\n\n/** Shared builders for unicast many-valued sinks. */\nconst unicastSpec: UnicastSpec = Object.freeze({\n    /** Creates a unicast sink with backpressure buffering. */\n    onBackpressureBuffer<T>() {\n        return new DefaultManySink<T>({mode: \"unicast\"});\n    },\n\n    /** Creates a unicast sink that fails emission when demand cannot be honored. */\n    onBackpressureError<T>() {\n        return new DefaultManySink<T>({mode: \"unicast-error\"});\n    }\n});\n\n/** Shared builders for multicast many-valued sinks. */\nconst multicastSpec: MulticastSpec = Object.freeze({\n    /** Creates a multicast sink that buffers when subscribers are temporarily absent. */\n    onBackpressureBuffer<T>() {\n        return new DefaultManySink<T>({mode: \"multicast-buffer\"});\n    },\n\n    /** Creates a multicast sink that fails emission when no subscriber can receive it. */\n    directAllOrNothing<T>() {\n        return new DefaultManySink<T>({mode: \"multicast-direct\"});\n    },\n\n    /** Creates a multicast sink that emits to currently available subscribers. */\n    directBestEffort<T>() {\n        return new DefaultManySink<T>({mode: \"multicast-direct\"});\n    }\n});\n\n/** Shared builders for replaying many-valued sinks. */\nconst replaySpec: ReplaySpec = Object.freeze({\n    /** Creates a replay sink retaining every emitted value. */\n    all<T>() {\n        return new DefaultManySink<T>({mode: \"replay\"});\n    },\n\n    /** Creates a replay sink retaining at most `historySize` values. */\n    limit<T>(historySize: number) {\n        if (!Number.isInteger(historySize) || historySize <= 0) {\n            throw new RangeError(\"historySize must be a strictly positive integer\");\n        }\n        return new DefaultManySink<T>({mode: \"replay\", replayLimit: historySize});\n    },\n\n    /** Creates a replay sink retaining only the latest emitted value. */\n    latest<T>() {\n        return new DefaultManySink<T>({mode: \"replay\", replayLimit: 1});\n    },\n\n    /** Creates a replay sink with an initial default latest value. */\n    latestOrDefault<T>(value: T) {\n        return new DefaultManySink<T>({mode: \"replay\", replayLimit: 1, latestDefault: value});\n    }\n});\n\n/** Shared builder tree for many-valued sink variants. */\nconst manySpec: ManySpec = Object.freeze({\n    /** Returns builders for unicast many-valued sinks. */\n    unicast(): UnicastSpec {\n        return unicastSpec;\n    },\n\n    /** Returns builders for multicast many-valued sinks. */\n    multicast(): MulticastSpec {\n        return multicastSpec;\n    },\n\n    /** Returns builders for replaying many-valued sinks. */\n    replay(): ReplaySpec {\n        return replaySpec;\n    }\n});\n\n/** Shared unsafe builders for many-valued sinks that subscribe to upstream publishers. */\nconst manyWithUpstreamSpec: ManyWithUpstreamSpec = Object.freeze({\n    /** Creates a multicast sink that buffers and can subscribe to one upstream publisher. */\n    multicastOnBackpressureBuffer<T>() {\n        return new DefaultManySink<T>({mode: \"multicast-buffer\"});\n    }\n});\n\n/** Builder tree for unsafe sinks that can subscribe to upstream publishers. */\nconst unsafeSpec: {\n    /** Creates an empty sink that can only terminate. */\n    empty<T>(): EmptySink<T>;\n    /** Creates a one-valued sink that replays its terminal result. */\n    one<T>(): OneSink<T>;\n    /** Returns builders for many-valued sinks. */\n    many(): ManySpec;\n    /** Returns builders for many-valued sinks that can subscribe to one upstream publisher. */\n    manyWithUpstream(): ManyWithUpstreamSpec;\n} = Object.freeze({\n    /** Creates an empty sink that can only terminate. */\n    empty<T>(): EmptySink<T> {\n        return new DefaultOneSink<T>();\n    },\n\n    /** Creates a one-valued sink that replays its terminal result. */\n    one<T>(): OneSink<T> {\n        return new DefaultOneSink<T>();\n    },\n\n    /** Returns builders for many-valued sinks. */\n    many(): ManySpec {\n        return manySpec;\n    },\n\n    /** Returns builders for many-valued sinks that can subscribe to one upstream publisher. */\n    manyWithUpstream(): ManyWithUpstreamSpec {\n        return manyWithUpstreamSpec;\n    }\n});\n\n/** Public Sinks factory facade. */\nexport const Sinks = Object.freeze({\n    /** Creates an empty sink that can only terminate. */\n    empty<T>(): EmptySink<T> {\n        return new DefaultOneSink<T>();\n    },\n\n    /** Creates a one-valued sink that replays its terminal result. */\n    one<T>(): OneSink<T> {\n        return new DefaultOneSink<T>();\n    },\n\n    /** Returns builders for many-valued sinks. */\n    many(): ManySpec {\n        return manySpec;\n    },\n\n    /** Returns unsafe sink builders. */\n    unsafe(): typeof unsafeSpec {\n        return unsafeSpec;\n    }\n});\n\nexport type {ManySink};\n"],"mappings":";;;;;;;;AAkBA,IAAM,cAA2B,OAAO,OAAO;;CAE3C,uBAA0B;EACtB,OAAO,IAAI,gBAAmB,EAAC,MAAM,UAAS,CAAC;CACnD;;CAGA,sBAAyB;EACrB,OAAO,IAAI,gBAAmB,EAAC,MAAM,gBAAe,CAAC;CACzD;AACJ,CAAC;;AAGD,IAAM,gBAA+B,OAAO,OAAO;;CAE/C,uBAA0B;EACtB,OAAO,IAAI,gBAAmB,EAAC,MAAM,mBAAkB,CAAC;CAC5D;;CAGA,qBAAwB;EACpB,OAAO,IAAI,gBAAmB,EAAC,MAAM,mBAAkB,CAAC;CAC5D;;CAGA,mBAAsB;EAClB,OAAO,IAAI,gBAAmB,EAAC,MAAM,mBAAkB,CAAC;CAC5D;AACJ,CAAC;;AAGD,IAAM,aAAyB,OAAO,OAAO;;CAEzC,MAAS;EACL,OAAO,IAAI,gBAAmB,EAAC,MAAM,SAAQ,CAAC;CAClD;;CAGA,MAAS,aAAqB;EAC1B,IAAI,CAAC,OAAO,UAAU,WAAW,KAAK,eAAe,GACjD,MAAM,IAAI,WAAW,iDAAiD;EAE1E,OAAO,IAAI,gBAAmB;GAAC,MAAM;GAAU,aAAa;EAAW,CAAC;CAC5E;;CAGA,SAAY;EACR,OAAO,IAAI,gBAAmB;GAAC,MAAM;GAAU,aAAa;EAAC,CAAC;CAClE;;CAGA,gBAAmB,OAAU;EACzB,OAAO,IAAI,gBAAmB;GAAC,MAAM;GAAU,aAAa;GAAG,eAAe;EAAK,CAAC;CACxF;AACJ,CAAC;;AAGD,IAAM,WAAqB,OAAO,OAAO;;CAErC,UAAuB;EACnB,OAAO;CACX;;CAGA,YAA2B;EACvB,OAAO;CACX;;CAGA,SAAqB;EACjB,OAAO;CACX;AACJ,CAAC;;AAGD,IAAM,uBAA6C,OAAO,OAAO;;AAE7D,gCAAmC;CAC/B,OAAO,IAAI,gBAAmB,EAAC,MAAM,mBAAkB,CAAC;AAC5D,EACJ,CAAC;;AAGD,IAAM,aASF,OAAO,OAAO;;CAEd,QAAyB;EACrB,OAAO,IAAI,eAAkB;CACjC;;CAGA,MAAqB;EACjB,OAAO,IAAI,eAAkB;CACjC;;CAGA,OAAiB;EACb,OAAO;CACX;;CAGA,mBAAyC;EACrC,OAAO;CACX;AACJ,CAAC;;AAGD,IAAa,QAAQ,OAAO,OAAO;;CAE/B,QAAyB;EACrB,OAAO,IAAI,eAAkB;CACjC;;CAGA,MAAqB;EACjB,OAAO,IAAI,eAAkB;CACjC;;CAGA,OAAiB;EACb,OAAO;CACX;;CAGA,SAA4B;EACxB,OAAO;CACX;AACJ,CAAC"}

package/dist/sinks/subscribers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @packageDocumentation
+ * Compact subscriber storage shared by sink implementations.
+ */
+import type { AsyncQueue } from "../internal/async-queue.js";
+/** Compact storage for one or many active sink subscriber queues. */
+export type SinkSubscribers<T> = AsyncQueue<T> | Set<AsyncQueue<T>>;
+/** Adds a queue without allocating a Set for the common single-subscriber case. */
+export declare function addSinkSubscriber<T>(subscribers: SinkSubscribers<T> | undefined, queue: AsyncQueue<T>): SinkSubscribers<T>;
+/** Removes a queue and releases multi-subscriber storage when it becomes empty. */
+export declare function removeSinkSubscriber<T>(subscribers: SinkSubscribers<T> | undefined, queue: AsyncQueue<T>): SinkSubscribers<T> | undefined;
+/** Clears multi-subscriber storage before the owner drops its reference. */
+export declare function clearSinkSubscribers<T>(subscribers: SinkSubscribers<T> | undefined): void;
+/** Returns the number of active queues in compact subscriber storage. */
+export declare function sinkSubscriberCount<T>(subscribers: SinkSubscribers<T> | undefined): number;
+//# sourceMappingURL=subscribers.d.ts.map

package/dist/sinks/subscribers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../src/sinks/subscribers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAE1D,qEAAqE;AACrE,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpE,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,CAAC,EAC/B,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3C,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,eAAe,CAAC,CAAC,CAAC,CASpB;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,CAAC,EAClC,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3C,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAShC;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAIzF;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,CAK1F"}

package/dist/sinks/subscribers.js

@@ -0,0 +1,32 @@
+//#region src/sinks/subscribers.ts
+/** Adds a queue without allocating a Set for the common single-subscriber case. */
+function addSinkSubscriber(subscribers, queue) {
+	if (subscribers === void 0) return queue;
+	if (subscribers instanceof Set) {
+		subscribers.add(queue);
+		return subscribers;
+	}
+	return subscribers === queue ? subscribers : /* @__PURE__ */ new Set([subscribers, queue]);
+}
+/** Removes a queue and releases multi-subscriber storage when it becomes empty. */
+function removeSinkSubscriber(subscribers, queue) {
+	if (subscribers === void 0) return;
+	if (subscribers instanceof Set) {
+		subscribers.delete(queue);
+		return subscribers.size === 0 ? void 0 : subscribers;
+	}
+	return subscribers === queue ? void 0 : subscribers;
+}
+/** Clears multi-subscriber storage before the owner drops its reference. */
+function clearSinkSubscribers(subscribers) {
+	if (subscribers instanceof Set) subscribers.clear();
+}
+/** Returns the number of active queues in compact subscriber storage. */
+function sinkSubscriberCount(subscribers) {
+	if (subscribers === void 0) return 0;
+	return subscribers instanceof Set ? subscribers.size : 1;
+}
+//#endregion
+export { addSinkSubscriber, clearSinkSubscribers, removeSinkSubscriber, sinkSubscriberCount };
+
+//# sourceMappingURL=subscribers.js.map

package/dist/sinks/subscribers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.js","names":[],"sources":["../../src/sinks/subscribers.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Compact subscriber storage shared by sink implementations.\n */\nimport type {AsyncQueue} from \"@/internal/async-queue.js\";\n\n/** Compact storage for one or many active sink subscriber queues. */\nexport type SinkSubscribers<T> = AsyncQueue<T> | Set<AsyncQueue<T>>;\n\n/** Adds a queue without allocating a Set for the common single-subscriber case. */\nexport function addSinkSubscriber<T>(\n    subscribers: SinkSubscribers<T> | undefined,\n    queue: AsyncQueue<T>\n): SinkSubscribers<T> {\n    if (subscribers === undefined) {\n        return queue;\n    }\n    if (subscribers instanceof Set) {\n        subscribers.add(queue);\n        return subscribers;\n    }\n    return subscribers === queue ? subscribers : new Set([subscribers, queue]);\n}\n\n/** Removes a queue and releases multi-subscriber storage when it becomes empty. */\nexport function removeSinkSubscriber<T>(\n    subscribers: SinkSubscribers<T> | undefined,\n    queue: AsyncQueue<T>\n): SinkSubscribers<T> | undefined {\n    if (subscribers === undefined) {\n        return undefined;\n    }\n    if (subscribers instanceof Set) {\n        subscribers.delete(queue);\n        return subscribers.size === 0 ? undefined : subscribers;\n    }\n    return subscribers === queue ? undefined : subscribers;\n}\n\n/** Clears multi-subscriber storage before the owner drops its reference. */\nexport function clearSinkSubscribers<T>(subscribers: SinkSubscribers<T> | undefined): void {\n    if (subscribers instanceof Set) {\n        subscribers.clear();\n    }\n}\n\n/** Returns the number of active queues in compact subscriber storage. */\nexport function sinkSubscriberCount<T>(subscribers: SinkSubscribers<T> | undefined): number {\n    if (subscribers === undefined) {\n        return 0;\n    }\n    return subscribers instanceof Set ? subscribers.size : 1;\n}\n"],"mappings":";;AAUA,SAAgB,kBACZ,aACA,OACkB;CAClB,IAAI,gBAAgB,QAChB,OAAO;CAEX,IAAI,uBAAuB,KAAK;EAC5B,YAAY,IAAI,KAAK;EACrB,OAAO;CACX;CACA,OAAO,gBAAgB,QAAQ,8BAAc,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC;AAC7E;;AAGA,SAAgB,qBACZ,aACA,OAC8B;CAC9B,IAAI,gBAAgB,QAChB;CAEJ,IAAI,uBAAuB,KAAK;EAC5B,YAAY,OAAO,KAAK;EACxB,OAAO,YAAY,SAAS,IAAI,SAAY;CAChD;CACA,OAAO,gBAAgB,QAAQ,SAAY;AAC/C;;AAGA,SAAgB,qBAAwB,aAAmD;CACvF,IAAI,uBAAuB,KACvB,YAAY,MAAM;AAE1B;;AAGA,SAAgB,oBAAuB,aAAqD;CACxF,IAAI,gBAAgB,QAChB,OAAO;CAEX,OAAO,uBAAuB,MAAM,YAAY,OAAO;AAC3D"}

package/dist/sinks/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @packageDocumentation
+ * Sink specifications and default browser-oriented sink implementations.
+ */
+import type { Disposable } from "../core/types.js";
+import type { Flux } from "../publisher/flux.js";
+import type { Mono } from "../publisher/mono.js";
+import type { PublisherInput } from "../publisher/types.js";
+import { SignalType } from "../signal/signal-type.js";
+/** Result of a sink emission attempt. */
+export declare enum EmitResult {
+    /** Emission succeeded. */
+    OK = "OK",
+    /** Emission failed because the sink has already terminated. */
+    FAIL_TERMINATED = "FAIL_TERMINATED",
+    /** Emission failed because buffering capacity was exhausted. */
+    FAIL_OVERFLOW = "FAIL_OVERFLOW",
+    /** Emission failed because the sink was cancelled. */
+    FAIL_CANCELLED = "FAIL_CANCELLED",
+    /** Emission failed because concurrent emission was detected. */
+    FAIL_NON_SERIALIZED = "FAIL_NON_SERIALIZED",
+    /** Emission failed because no subscriber was present. */
+    FAIL_ZERO_SUBSCRIBER = "FAIL_ZERO_SUBSCRIBER"
+}
+/** Error thrown when an emitting API cannot recover from an emission failure. */
+export declare class EmissionException extends Error {
+    /** Failed emission result that caused this exception. */
+    readonly reason: EmitResult;
+    /** Creates an emission exception for a failed result. */
+    constructor(reason: EmitResult, cause?: unknown);
+}
+/** Callback that decides whether a failed emission should be retried. */
+export type EmitFailureHandler = (signalType: SignalType, emitResult: EmitResult) => boolean;
+/** Built-in emission failure handlers. */
+export declare const EmitFailureHandlers: {
+    /** Fails immediately without retrying. */
+    FAIL_FAST: () => boolean;
+    /** Retries non-serialized emissions until the busy-loop deadline expires. */
+    busyLooping(durationMs: number): EmitFailureHandler;
+};
+/** Sink that can only emit a terminal signal. */
+export interface EmptySink<T> {
+    /** Returns the Mono view of this sink. */
+    asMono(): Mono<T>;
+    /** Returns current active subscriber count. */
+    currentSubscriberCount(): number;
+    /** Attempts to complete this sink. */
+    tryEmitEmpty(): EmitResult;
+    /** Attempts to fail this sink. */
+    tryEmitError(error: unknown): EmitResult;
+    /** Completes this sink using the provided failure handler. */
+    emitEmpty(handler?: EmitFailureHandler): void;
+    /** Fails this sink using the provided failure handler. */
+    emitError(error: unknown, handler?: EmitFailureHandler): void;
+    /** Handles an emission failure and returns true when the caller should retry. */
+    onEmitFailure(signalType: SignalType, emitResult: EmitResult): boolean;
+}
+/** Sink that can emit zero or one value followed by completion. */
+export interface OneSink<T> extends EmptySink<T> {
+    /** Attempts to emit a value and complete this sink. */
+    tryEmitValue(value: T): EmitResult;
+    /** Emits a value using the provided failure handler. */
+    emitValue(value: T, handler?: EmitFailureHandler): void;
+}
+/** Sink that can emit multiple values and a terminal signal. */
+export interface ManySink<T> {
+    /** Returns the Flux view of this sink. */
+    asFlux(): Flux<T>;
+    /** Attempts to emit a value. */
+    tryEmitNext(value: T): EmitResult;
+    /** Attempts to complete this sink. */
+    tryEmitComplete(): EmitResult;
+    /** Attempts to fail this sink. */
+    tryEmitError(error: unknown): EmitResult;
+    /** Emits a value using the provided failure handler. */
+    emitNext(value: T, handler?: EmitFailureHandler): void;
+    /** Completes this sink using the provided failure handler. */
+    emitComplete(handler?: EmitFailureHandler): void;
+    /** Fails this sink using the provided failure handler. */
+    emitError(error: unknown, handler?: EmitFailureHandler): void;
+    /** Returns current active subscriber count. */
+    currentSubscriberCount(): number;
+    /** Subscribes this sink to an upstream publisher. */
+    subscribeTo(source: PublisherInput<T>): void;
+    /** Handles an emission failure and returns true when the caller should retry. */
+    onEmitFailure(signalType: SignalType, emitResult: EmitResult): boolean;
+}
+/** Root builder for many-valued sink variants. */
+export interface ManySpec {
+    /** Returns unicast sink builders. */
+    unicast(): UnicastSpec;
+    /** Returns multicast sink builders. */
+    multicast(): MulticastSpec;
+    /** Returns replay sink builders. */
+    replay(): ReplaySpec;
+}
+/** Builder for unicast many-valued sinks. */
+export interface UnicastSpec {
+    /** Creates a unicast sink with backpressure buffering. */
+    onBackpressureBuffer<T>(): ManySink<T>;
+    /** Creates a unicast sink that fails when backpressure cannot be honored. */
+    onBackpressureError<T>(): ManySink<T>;
+}
+/** Builder for sinks that can subscribe to one upstream publisher. */
+export interface ManyWithUpstreamSpec {
+    /** Creates a multicast sink that buffers and can subscribe to one upstream publisher. */
+    multicastOnBackpressureBuffer<T>(): ManySink<T>;
+}
+/** Builder for multicast many-valued sinks. */
+export interface MulticastSpec {
+    /** Creates a multicast sink with backpressure buffering. */
+    onBackpressureBuffer<T>(): ManySink<T>;
+    /** Creates a direct multicast sink that fails when no subscriber is present. */
+    directAllOrNothing<T>(): ManySink<T>;
+    /** Creates a direct best-effort multicast sink. */
+    directBestEffort<T>(): ManySink<T>;
+}
+/** Builder for replaying many-valued sinks. */
+export interface ReplaySpec {
+    /** Replays all emitted values to late subscribers. */
+    all<T>(): ManySink<T>;
+    /** Replays up to `historySize` values to late subscribers. */
+    limit<T>(historySize: number): ManySink<T>;
+    /** Replays only the latest value to late subscribers. */
+    latest<T>(): ManySink<T>;
+    /** Replays the latest value or the provided default before the first emission. */
+    latestOrDefault<T>(value: T): ManySink<T>;
+}
+/** Disposable type alias used by sink implementations. */
+export type SinkDisposable = Disposable;
+/** Repeatedly invokes an emission attempt or throws when failure is not recoverable. */
+export declare function emitOrThrow(signalType: SignalType, emit: () => EmitResult, handler: EmitFailureHandler, cause?: unknown): void;
+/** Returns true when the emission result is successful. */
+export declare function isEmitSuccess(result: EmitResult): boolean;
+/** Returns true when the emission result is a failure. */
+export declare function isEmitFailure(result: EmitResult): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/sinks/types.d.ts.map

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

package/dist/sinks/types.js

@@ -0,0 +1,58 @@
+import _defineProperty from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/defineProperty.js";
+import { SignalType } from "../signal/signal-type.js";
+//#region src/sinks/types.ts
+/** Result of a sink emission attempt. */
+var EmitResult = /* @__PURE__ */ function(EmitResult) {
+	/** Emission succeeded. */
+	EmitResult["OK"] = "OK";
+	/** Emission failed because the sink has already terminated. */
+	EmitResult["FAIL_TERMINATED"] = "FAIL_TERMINATED";
+	/** Emission failed because buffering capacity was exhausted. */
+	EmitResult["FAIL_OVERFLOW"] = "FAIL_OVERFLOW";
+	/** Emission failed because the sink was cancelled. */
+	EmitResult["FAIL_CANCELLED"] = "FAIL_CANCELLED";
+	/** Emission failed because concurrent emission was detected. */
+	EmitResult["FAIL_NON_SERIALIZED"] = "FAIL_NON_SERIALIZED";
+	/** Emission failed because no subscriber was present. */
+	EmitResult["FAIL_ZERO_SUBSCRIBER"] = "FAIL_ZERO_SUBSCRIBER";
+	return EmitResult;
+}({});
+/** Error thrown when an emitting API cannot recover from an emission failure. */
+var EmissionException = class extends Error {
+	/** Creates an emission exception for a failed result. */
+	constructor(reason, cause) {
+		super(cause === void 0 ? `Emission failed with ${reason}` : `Emission failed with ${reason}: ${String(cause)}`);
+		_defineProperty(
+			this,
+			/** Failed emission result that caused this exception. */
+			"reason",
+			void 0
+		);
+		this.reason = reason;
+		this.name = "EmissionException";
+	}
+};
+/** Built-in emission failure handlers. */
+var EmitFailureHandlers = {
+	/** Fails immediately without retrying. */
+	FAIL_FAST: () => false,
+	/** Retries non-serialized emissions until the busy-loop deadline expires. */
+	busyLooping(durationMs) {
+		return (signalType, emitResult) => {
+			const deadline = Date.now() + durationMs;
+			return signalType !== SignalType.ERROR && emitResult === "FAIL_NON_SERIALIZED" && Date.now() < deadline;
+		};
+	}
+};
+/** Repeatedly invokes an emission attempt or throws when failure is not recoverable. */
+function emitOrThrow(signalType, emit, handler, cause) {
+	for (;;) {
+		const result = emit();
+		if (result === "OK") return;
+		if (!handler(signalType, result)) throw new EmissionException(result, cause);
+	}
+}
+//#endregion
+export { EmissionException, EmitFailureHandlers, EmitResult, emitOrThrow };
+
+//# sourceMappingURL=types.js.map

package/dist/sinks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/sinks/types.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Sink specifications and default browser-oriented sink implementations.\n */\nimport type {Disposable} from \"@/core/types.js\";\nimport type {Flux} from \"@/publisher/flux.js\";\nimport type {Mono} from \"@/publisher/mono.js\";\nimport type {PublisherInput} from \"@/publisher/types.js\";\nimport {SignalType} from \"@/signal/signal-type.js\";\n\n/** Result of a sink emission attempt. */\nexport enum EmitResult {\n    /** Emission succeeded. */\n    OK = \"OK\",\n    /** Emission failed because the sink has already terminated. */\n    FAIL_TERMINATED = \"FAIL_TERMINATED\",\n    /** Emission failed because buffering capacity was exhausted. */\n    FAIL_OVERFLOW = \"FAIL_OVERFLOW\",\n    /** Emission failed because the sink was cancelled. */\n    FAIL_CANCELLED = \"FAIL_CANCELLED\",\n    /** Emission failed because concurrent emission was detected. */\n    FAIL_NON_SERIALIZED = \"FAIL_NON_SERIALIZED\",\n    /** Emission failed because no subscriber was present. */\n    FAIL_ZERO_SUBSCRIBER = \"FAIL_ZERO_SUBSCRIBER\"\n}\n\n/** Error thrown when an emitting API cannot recover from an emission failure. */\nexport class EmissionException extends Error {\n    /** Failed emission result that caused this exception. */\n    public readonly reason: EmitResult;\n\n    /** Creates an emission exception for a failed result. */\n    public constructor(reason: EmitResult, cause?: unknown) {\n        super(cause === undefined ? `Emission failed with ${reason}` : `Emission failed with ${reason}: ${String(cause)}`);\n        this.reason = reason;\n        this.name = \"EmissionException\";\n    }\n}\n\n/** Callback that decides whether a failed emission should be retried. */\nexport type EmitFailureHandler = (signalType: SignalType, emitResult: EmitResult) => boolean;\n\n/** Built-in emission failure handlers. */\nexport const EmitFailureHandlers = {\n    /** Fails immediately without retrying. */\n    FAIL_FAST: () => false,\n\n    /** Retries non-serialized emissions until the busy-loop deadline expires. */\n    busyLooping(durationMs: number): EmitFailureHandler {\n        return (signalType, emitResult) => {\n            const deadline = Date.now() + durationMs;\n            return signalType !== SignalType.ERROR && emitResult === EmitResult.FAIL_NON_SERIALIZED && Date.now() < deadline;\n        };\n    }\n};\n\n/** Sink that can only emit a terminal signal. */\nexport interface EmptySink<T> {\n    /** Returns the Mono view of this sink. */\n    asMono(): Mono<T>;\n\n    /** Returns current active subscriber count. */\n    currentSubscriberCount(): number;\n\n    /** Attempts to complete this sink. */\n    tryEmitEmpty(): EmitResult;\n\n    /** Attempts to fail this sink. */\n    tryEmitError(error: unknown): EmitResult;\n\n    /** Completes this sink using the provided failure handler. */\n    emitEmpty(handler?: EmitFailureHandler): void;\n\n    /** Fails this sink using the provided failure handler. */\n    emitError(error: unknown, handler?: EmitFailureHandler): void;\n\n    /** Handles an emission failure and returns true when the caller should retry. */\n    onEmitFailure(signalType: SignalType, emitResult: EmitResult): boolean;\n}\n\n/** Sink that can emit zero or one value followed by completion. */\nexport interface OneSink<T> extends EmptySink<T> {\n    /** Attempts to emit a value and complete this sink. */\n    tryEmitValue(value: T): EmitResult;\n\n    /** Emits a value using the provided failure handler. */\n    emitValue(value: T, handler?: EmitFailureHandler): void;\n}\n\n/** Sink that can emit multiple values and a terminal signal. */\nexport interface ManySink<T> {\n    /** Returns the Flux view of this sink. */\n    asFlux(): Flux<T>;\n\n    /** Attempts to emit a value. */\n    tryEmitNext(value: T): EmitResult;\n\n    /** Attempts to complete this sink. */\n    tryEmitComplete(): EmitResult;\n\n    /** Attempts to fail this sink. */\n    tryEmitError(error: unknown): EmitResult;\n\n    /** Emits a value using the provided failure handler. */\n    emitNext(value: T, handler?: EmitFailureHandler): void;\n\n    /** Completes this sink using the provided failure handler. */\n    emitComplete(handler?: EmitFailureHandler): void;\n\n    /** Fails this sink using the provided failure handler. */\n    emitError(error: unknown, handler?: EmitFailureHandler): void;\n\n    /** Returns current active subscriber count. */\n    currentSubscriberCount(): number;\n\n    /** Subscribes this sink to an upstream publisher. */\n    subscribeTo(source: PublisherInput<T>): void;\n\n    /** Handles an emission failure and returns true when the caller should retry. */\n    onEmitFailure(signalType: SignalType, emitResult: EmitResult): boolean;\n}\n\n/** Root builder for many-valued sink variants. */\nexport interface ManySpec {\n    /** Returns unicast sink builders. */\n    unicast(): UnicastSpec;\n\n    /** Returns multicast sink builders. */\n    multicast(): MulticastSpec;\n\n    /** Returns replay sink builders. */\n    replay(): ReplaySpec;\n}\n\n/** Builder for unicast many-valued sinks. */\nexport interface UnicastSpec {\n    /** Creates a unicast sink with backpressure buffering. */\n    onBackpressureBuffer<T>(): ManySink<T>;\n\n    /** Creates a unicast sink that fails when backpressure cannot be honored. */\n    onBackpressureError<T>(): ManySink<T>;\n}\n\n/** Builder for sinks that can subscribe to one upstream publisher. */\nexport interface ManyWithUpstreamSpec {\n    /** Creates a multicast sink that buffers and can subscribe to one upstream publisher. */\n    multicastOnBackpressureBuffer<T>(): ManySink<T>;\n}\n\n/** Builder for multicast many-valued sinks. */\nexport interface MulticastSpec {\n    /** Creates a multicast sink with backpressure buffering. */\n    onBackpressureBuffer<T>(): ManySink<T>;\n\n    /** Creates a direct multicast sink that fails when no subscriber is present. */\n    directAllOrNothing<T>(): ManySink<T>;\n\n    /** Creates a direct best-effort multicast sink. */\n    directBestEffort<T>(): ManySink<T>;\n}\n\n/** Builder for replaying many-valued sinks. */\nexport interface ReplaySpec {\n    /** Replays all emitted values to late subscribers. */\n    all<T>(): ManySink<T>;\n\n    /** Replays up to `historySize` values to late subscribers. */\n    limit<T>(historySize: number): ManySink<T>;\n\n    /** Replays only the latest value to late subscribers. */\n    latest<T>(): ManySink<T>;\n\n    /** Replays the latest value or the provided default before the first emission. */\n    latestOrDefault<T>(value: T): ManySink<T>;\n}\n\n/** Disposable type alias used by sink implementations. */\nexport type SinkDisposable = Disposable;\n\n/** Repeatedly invokes an emission attempt or throws when failure is not recoverable. */\nexport function emitOrThrow(\n    signalType: SignalType,\n    emit: () => EmitResult,\n    handler: EmitFailureHandler,\n    cause?: unknown\n): void {\n    for (; ;) {\n        const result = emit();\n        if (result === EmitResult.OK) {\n            return;\n        }\n        if (!handler(signalType, result)) {\n            throw new EmissionException(result, cause);\n        }\n    }\n}\n\n/** Returns true when the emission result is successful. */\nexport function isEmitSuccess(result: EmitResult): boolean {\n    return result === EmitResult.OK;\n}\n\n/** Returns true when the emission result is a failure. */\nexport function isEmitFailure(result: EmitResult): boolean {\n    return result !== EmitResult.OK;\n}\n"],"mappings":";;;;AAWA,IAAY,aAAL,yBAAA,YAAA;;CAEH,WAAA,QAAA;;CAEA,WAAA,qBAAA;;CAEA,WAAA,mBAAA;;CAEA,WAAA,oBAAA;;CAEA,WAAA,yBAAA;;CAEA,WAAA,0BAAA;;AACJ,EAAA,CAAA,CAAA;;AAGA,IAAa,oBAAb,cAAuC,MAAM;;CAKzC,YAAmB,QAAoB,OAAiB;EACpD,MAAM,UAAU,SAAY,wBAAwB,WAAW,wBAAwB,OAAO,IAAI,OAAO,KAAK,GAAG;;;;GAJrH;;;EAKI,KAAK,SAAS;EACd,KAAK,OAAO;CAChB;AACJ;;AAMA,IAAa,sBAAsB;;CAE/B,iBAAiB;;CAGjB,YAAY,YAAwC;EAChD,QAAQ,YAAY,eAAe;GAC/B,MAAM,WAAW,KAAK,IAAI,IAAI;GAC9B,OAAO,eAAe,WAAW,SAAS,eAAA,yBAAiD,KAAK,IAAI,IAAI;EAC5G;CACJ;AACJ;;AA8HA,SAAgB,YACZ,YACA,MACA,SACA,OACI;CACJ,SAAU;EACN,MAAM,SAAS,KAAK;EACpB,IAAI,WAAA,MACA;EAEJ,IAAI,CAAC,QAAQ,YAAY,MAAM,GAC3B,MAAM,IAAI,kBAAkB,QAAQ,KAAK;CAEjD;AACJ"}

package/dist/subscription/core-subscriber.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @packageDocumentation
+ * Context-aware subscriber contract.
+ */
+import type { Context } from "../context/context.js";
+import type { Subscriber } from "./subscriber.js";
+/** Subscriber variant that can expose a Reactor context to operators. */
+export interface CoreSubscriber<T> extends Subscriber<T> {
+    /** Returns the subscriber context used for contextual operators. */
+    currentContext?(): Context;
+}
+//# sourceMappingURL=core-subscriber.d.ts.map

package/dist/subscription/core-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-subscriber.d.ts","sourceRoot":"","sources":["../../src/subscription/core-subscriber.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,8BAA8B,CAAC;AAE7D,yEAAyE;AACzE,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACpD,oEAAoE;IACpE,cAAc,CAAC,IAAI,OAAO,CAAC;CAC9B"}