better-effect 0.13.0 → 0.14.0

package/dist/{types-oihI-ESv.d.mts → types-BFTqCCcw.d.mts}

@@ -1,6 +1,5 @@
-import { C as EffectError, M as AnyService, V as ServiceTagOf, k as Program } from "./index-AiKM71-u.mjs";
-import { D as ValidateOneOverride, E as ValidateLayerInput, S as MissingServices, T as RequiredEnvironment, j as MissingDependencies, p as Layer, v as ExecutionMissing, w as ProvidedEnvironment, y as LayerInput } from "./outcome-DI8LPIQ4.mjs";
-import { t as CurrentRequest } from "./current-request-CIU7AHhF.mjs";
+import { Gt as ServiceTagOf, Lt as AnyService, Ot as EffectError, Pt as Program, ct as ValidateLayerInput, et as ExecutionMissing, it as MissingServices, jt as EffectSuccess, lt as ValidateOneOverride, ot as ProvidedEnvironment, pt as MissingDependencies, st as RequiredEnvironment, t as Layer, tt as LayerInput } from "./layer-C2OaqTmB.mjs";
+import { t as CurrentRequest } from "./current-request-Dm-QQ3Xr.mjs";
 //#region src/web/types.d.ts
 /** A Web Response returned synchronously or asynchronously by a boundary policy. */
 type ResponseLike = Response | PromiseLike<Response>;
@@ -14,6 +13,19 @@ type WebEffectSuccess<A = unknown> = {
 };
 /** A lazy Program type accepted by the WebEffect boundary. */
 type WebEffectProgram<A = unknown, E = unknown, R extends AnyService = never> = Program<A, E, R>;
+/** The lazy source accepted by an opt-in managed Web response. */
+type WebEffectStreamSource = ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>;
+/** Context passed to a managed Web response producer. */
+type WebEffectStreamContext = {
+  readonly signal: AbortSignal;
+};
+/** An explicit response descriptor whose producer owns the response body lifetime. */
+type WebEffectStream = {
+  readonly status?: number;
+  readonly statusText?: string;
+  readonly headers?: HeadersInit;
+  readonly producer: (context: WebEffectStreamContext) => WebEffectStreamSource | PromiseLike<WebEffectStreamSource>;
+};
 /** @internal */
 type AnyProgram = WebEffectProgram<any, any, AnyService>;
 type IsAny<Type> = 0 extends 1 & Type ? true : false;
@@ -31,6 +43,12 @@ type InvalidFailure<Actual, Expected> = {
   };
 };
 type FailureCheck<Failure, Actual> = [Actual] extends [Failure] ? unknown : InvalidFailure<Actual, Failure>;
+type StreamValueCheck<Program extends AnyProgram> = [EffectSuccess<Program>] extends [WebEffectStream] ? unknown : {
+  readonly __betterEffectInvalidWebStream: {
+    readonly actual: EffectSuccess<Program>;
+    readonly expected: WebEffectStream;
+  };
+};
 type RequestLayerMissing<Provided extends AnyService, RequestLayer extends LayerInput> = MissingServices<Extract<RequiredEnvironment<RequestLayer>, AnyService>, Extract<Provided | InstanceType<typeof CurrentRequest>, AnyService>>;
 /** @internal Validate a custom request Layer against the Runtime and CurrentRequest. */
 type WebRequestLayerChecks<Provided extends AnyService, RequestLayer extends LayerInput> = ValidateLayerInput<RequestLayer> & (IsWidenedEnvironment<Provided> extends true ? unknown : ValidateOneOverride<Layer<Provided, never>, RequestLayer>) & ValidateOneOverride<DefaultRequestLayer, RequestLayer> & ([RequestLayerMissing<Provided, RequestLayer>] extends [never] ? unknown : MissingDependencies<RequestLayerMissing<Provided, RequestLayer>>);
@@ -38,6 +56,10 @@ type WebRequestLayerChecks<Provided extends AnyService, RequestLayer extends Lay
 type WebProgramMissing<Provided extends AnyService, RequestLayer extends LayerInput, Program extends AnyProgram> = ExecutionMissing<AvailableServices<Provided, RequestLayer>, Program>;
 /** @internal Validate a WebEffect Program's Services and typed failure channel. */
 type CompleteWebProgram<Provided extends AnyService, RequestLayer extends LayerInput, Program extends AnyProgram, Failure = unknown> = Program & WebProgramChecks<Provided, RequestLayer, Program, Failure>;
+/** @internal Validate the explicit stream descriptor returned by a Program. */
+type CompleteWebStreamProgram<Provided extends AnyService, RequestLayer extends LayerInput, Program extends AnyProgram, Failure = unknown> = Program & WebProgramChecks<Provided, RequestLayer, Program, Failure> & StreamValueCheck<Program>;
+/** @internal Checks applied to a streaming Program after the request Layer is inferred. */
+type WebStreamProgramChecks<Provided extends AnyService, RequestLayer extends LayerInput, Program extends AnyProgram, Failure = unknown> = WebProgramChecks<Provided, RequestLayer, Program, Failure> & StreamValueCheck<Program>;
 /** @internal Checks applied to a Program after the request Layer has been inferred. */
 type WebProgramChecks<Provided extends AnyService, RequestLayer extends LayerInput, Program extends AnyProgram, Failure = unknown> = (WebProgramMissing<Provided, RequestLayer, Program> extends never ? unknown : MissingDependencies<WebProgramMissing<Provided, RequestLayer, Program>>) & FailureCheck<NoInfer<Failure>, EffectError<Program>>;
 /** Options for converting a WebEffect Result into a standard Response. */
@@ -49,6 +71,11 @@ type WebEffectOptions<Failure = unknown, RequestLayer extends LayerInput = Defau
   /** Convert a typed Program failure into a Response. */
   readonly onFailure?: (error: Failure) => ResponseLike;
 };
+/** Options for the opt-in managed Web streaming boundary. */
+type WebEffectStreamOptions<Failure = unknown, RequestLayer extends LayerInput = DefaultRequestLayer> = Pick<WebEffectOptions<Failure, RequestLayer, WebEffectStream>, 'requestLayer' | 'onFailure'> & {
+  /** Cancel an unconsumed or abandoned body after this idle period. */
+  readonly unconsumedTimeoutMs?: number;
+};
 //#endregion
-export { WebEffectOptions as a, WebJsonValue as c, ResponseLike as i, WebProgramChecks as l, CompleteWebProgram as n, WebEffectProgram as o, DefaultRequestLayer as r, WebEffectSuccess as s, AnyProgram as t, WebRequestLayerChecks as u };
-//# sourceMappingURL=types-oihI-ESv.d.mts.map
+export { ResponseLike as a, WebEffectStream as c, WebEffectStreamSource as d, WebEffectSuccess as f, WebStreamProgramChecks as g, WebRequestLayerChecks as h, DefaultRequestLayer as i, WebEffectStreamContext as l, WebProgramChecks as m, CompleteWebProgram as n, WebEffectOptions as o, WebJsonValue as p, CompleteWebStreamProgram as r, WebEffectProgram as s, AnyProgram as t, WebEffectStreamOptions as u };
+//# sourceMappingURL=types-BFTqCCcw.d.mts.map

package/dist/types-BFTqCCcw.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BFTqCCcw.d.mts","names":[],"sources":["../src/web/types.ts"],"mappings":";;;;KAiBY,eAAe,WAAW,YAAY;;KAGtC,2DAKC;YACG,cAAc;;;KAGlB,iBAAiB;WAClB,OAAO;;;KAIN,iBAAiB,aAAa,aAAa,UAAU,sBAAsB,QACrF,GACA,GACA;;KAIU,wBAAwB,eAAe,cAAc,cAAc;;KAGnE;WACD,QAAQ;;;KAIP;WACD;WACA;WACA,UAAU;WACV,WACP,SAAS,2BACN,wBAAwB,YAAY;;;KAI/B,aAAa,2BAA2B;KAE/C,MAAM,sBAAsB;KAE5B,qBAAqB,iBAAiB,cACzC,MAAM,+CAA+C,aAAa;;KAGxD,sBAAsB,kBAAkB,eAAe;;KAGvD,gBAAgB,qBAAqB,cAAc,oBAAoB;;KAGvE,kBAAkB,iBAAiB,YAAY,qBAAqB,cAC5E,WACA,oBAAoB,kBACpB,gBAAgB;KAEf,eAAe,QAAQ;WACjB;aACE,QAAQ;aACR,UAAU;;;KAIlB,aAAa,SAAS,WAAW,iBAAiB,qBAEnD,eAAe,QAAQ;KAEtB,iBAAiB,gBAAgB,eAAe,cAAc,mBACjE;WAIa;aACE,QAAQ,cAAc;aACtB,UAAU;;;KAItB,oBACH,iBAAiB,YACjB,qBAAqB,cACnB,gBACF,QAAQ,oBAAoB,eAAe,aAC3C,QAAQ,WAAW,oBAAoB,iBAAiB;;KAI9C,sBACV,iBAAiB,YACjB,qBAAqB,cACnB,mBAAmB,iBACpB,qBAAqB,mCAElB,oBAAoB,MAAM,kBAAkB,iBAChD,oBAAoB,qBAAqB,kBACvC,oBAAoB,UAAU,2CAE5B,oBAAoB,oBAAoB,UAAU;;KAG5C,kBACV,iBAAiB,YACjB,qBAAqB,YACrB,gBAAgB,cACd,iBAAiB,kBAAkB,UAAU,eAAe;;KAGpD,mBACV,iBAAiB,YACjB,qBAAqB,YACrB,gBAAgB,YAChB,qBACE,UAAU,iBAAiB,UAAU,cAAc,SAAS;;KAGpD,yBACV,iBAAiB,YACjB,qBAAqB,YACrB,gBAAgB,YAChB,qBACE,UAAU,iBAAiB,UAAU,cAAc,SAAS,WAAW,iBAAiB;;KAGhF,uBACV,iBAAiB,YACjB,qBAAqB,YACrB,gBAAgB,YAChB,qBACE,iBAAiB,UAAU,cAAc,SAAS,WAAW,iBAAiB;;KAGtE,iBACV,iBAAiB,YACjB,qBAAqB,YACrB,gBAAgB,YAChB,sBACG,kBAAkB,UAAU,cAAc,mCAE3C,oBAAoB,kBAAkB,UAAU,cAAc,aAChE,aAAa,QAAQ,UAAU,YAAY;;KAGjC,iBACV,mBACA,qBAAqB,aAAa,qBAClC;;WAGS,gBAAgB,SAAS,YAAY;;WAErC,aAAa,QAAQ,iBAAiB,aAAa;;WAEnD,aAAa,OAAO,YAAY;;;KAI/B,uBACV,mBACA,qBAAqB,aAAa,uBAChC,KAAK,iBAAiB,SAAS,cAAc;;WAEtC"}

package/dist/web-effect-B9hp9jIe.mjs

@@ -0,0 +1,380 @@
+import { t as Layer } from "./layer-2kjHVv4N.mjs";
+import { t as CurrentRequest } from "./current-request-Bc1YHL0w.mjs";
+import { Result } from "better-result";
+//#region src/web/responses.ts
+const DEFAULT_FAILURE_MESSAGE = "Internal Server Error";
+/** An unsupported value encountered by the default Web JSON policy. */
+var WebEffectSerializationError = class extends TypeError {
+	constructor(detail) {
+		super(`WebEffect default success serialization ${detail}`);
+		this.name = "WebEffectSerializationError";
+	}
+};
+const isObject$1 = (value) => typeof value === "object" && value !== null;
+const isCallable = (value) => typeof value === "function";
+const isHeaders = (value) => {
+	if (!isObject$1(value)) return false;
+	const candidate = value;
+	return isCallable(candidate.append) && isCallable(candidate.delete) && isCallable(candidate.get) && isCallable(candidate.getSetCookie) && isCallable(candidate.has) && isCallable(candidate.set) && isCallable(candidate.forEach);
+};
+const isBody = (value) => {
+	if (value === null) return true;
+	if (!isObject$1(value)) return false;
+	const candidate = value;
+	return typeof candidate.locked === "boolean" && isCallable(candidate.cancel) && isCallable(candidate.getReader) && isCallable(candidate.pipeThrough) && isCallable(candidate.pipeTo) && isCallable(candidate.tee);
+};
+const isResponseStatus = (value) => typeof value === "number" && Number.isInteger(value) && (value === 0 || value >= 200 && value <= 599);
+const isResponseType = (value) => value === "basic" || value === "cors" || value === "default" || value === "error" || value === "opaque" || value === "opaqueredirect";
+/** Accept native, cross-realm, and standards-compatible Web Response values. */
+const isWebResponse = (value) => {
+	if (!isObject$1(value)) return false;
+	try {
+		const candidate = value;
+		const status = candidate.status;
+		if (!isResponseStatus(status)) return false;
+		return isBody(candidate.body) && typeof candidate.bodyUsed === "boolean" && isHeaders(candidate.headers) && typeof candidate.ok === "boolean" && candidate.ok === (status >= 200 && status <= 299) && typeof candidate.redirected === "boolean" && typeof candidate.statusText === "string" && isResponseType(candidate.type) && typeof candidate.url === "string" && isCallable(candidate.arrayBuffer) && isCallable(candidate.blob) && isCallable(candidate.bytes) && isCallable(candidate.clone) && isCallable(candidate.formData) && isCallable(candidate.json) && isCallable(candidate.text);
+	} catch {
+		return false;
+	}
+};
+const propertyPath = (path, property) => `${path}.${property}`;
+const unsupported = (path, kind) => {
+	throw new WebEffectSerializationError(`cannot encode ${kind} at ${path}`);
+};
+const ownDataProperties = (value, path) => {
+	if (Object.getOwnPropertySymbols(value).length > 0) unsupported(path, "symbol-keyed properties");
+	return Object.getOwnPropertyNames(value).map((property) => {
+		const descriptor = Object.getOwnPropertyDescriptor(value, property);
+		if (descriptor === void 0 || !("value" in descriptor) || descriptor.enumerable !== true) unsupported(propertyPath(path, property), "non-enumerable or accessor properties");
+		return [property, descriptor.value];
+	});
+};
+const arrayIndex = (property) => {
+	const index = Number(property);
+	return Number.isInteger(index) && index >= 0 && index < 2 ** 32 - 1 && String(index) === property ? index : void 0;
+};
+const sanitizeArray = (value, path, ancestors) => {
+	if (Object.getOwnPropertySymbols(value).length > 0) unsupported(path, "symbol-keyed properties");
+	const properties = Object.getOwnPropertyNames(value);
+	if (properties.length !== value.length + 1 || !properties.includes("length")) unsupported(path, "sparse or augmented arrays");
+	const output = [];
+	for (let index = 0; index < value.length; index += 1) {
+		const property = String(index);
+		const descriptor = Object.getOwnPropertyDescriptor(value, property);
+		if (descriptor === void 0 || !("value" in descriptor) || descriptor.enumerable !== true || arrayIndex(property) === void 0) unsupported(propertyPath(path, property), "sparse or accessor array elements");
+		const dataDescriptor = descriptor;
+		output.push(sanitizeJsonValue(dataDescriptor.value, propertyPath(path, property), ancestors));
+	}
+	return output;
+};
+const sanitizeObject = (value, path, ancestors) => {
+	const prototype = Object.getPrototypeOf(value);
+	if (prototype !== Object.prototype && prototype !== null) unsupported(path, "non-plain objects");
+	const output = Object.create(null);
+	for (const [property, child] of ownDataProperties(value, path)) output[property] = sanitizeJsonValue(child, propertyPath(path, property), ancestors);
+	return output;
+};
+const sanitizeJsonValue = (value, path, ancestors = /* @__PURE__ */ new Set()) => {
+	if (value === null || typeof value === "boolean" || typeof value === "string") return value;
+	if (typeof value === "number") return Number.isFinite(value) ? value : unsupported(path, "non-finite numbers");
+	if (typeof value === "undefined") return unsupported(path, "undefined values");
+	if (typeof value === "bigint" || typeof value === "function" || typeof value === "symbol") return unsupported(path, `${typeof value} values`);
+	if (!isObject$1(value)) return unsupported(path, "unsupported values");
+	if (ancestors.has(value)) return unsupported(path, "circular values");
+	ancestors.add(value);
+	try {
+		return Array.isArray(value) ? sanitizeArray(value, path, ancestors) : sanitizeObject(value, path, ancestors);
+	} finally {
+		ancestors.delete(value);
+	}
+};
+/** Convert a successful value using the boundary's constrained JSON policy. */
+const defaultSuccess = ({ value }) => {
+	if (isWebResponse(value)) return value;
+	if (value === void 0) return new Response(null, { status: 204 });
+	return Response.json({ data: sanitizeJsonValue(value, "$") });
+};
+/** Redact typed failures unless the failure is an intentional Response. */
+const defaultFailure = (error) => {
+	if (isWebResponse(error)) return error;
+	return Response.json({ error: DEFAULT_FAILURE_MESSAGE }, { status: 500 });
+};
+/** Validate policy output at the JavaScript boundary before returning it. */
+const assertResponse = (response) => {
+	if (!isWebResponse(response)) throw new TypeError("WebEffect response policies must return a Response");
+	return response;
+};
+//#endregion
+//#region src/web/web-effect.ts
+const DEFAULT_UNCONSUMED_TIMEOUT_MS = 3e4;
+const deferred = () => {
+	let resolve;
+	let reject;
+	return {
+		promise: new Promise((resolvePromise, rejectPromise) => {
+			resolve = resolvePromise;
+			reject = rejectPromise;
+		}),
+		resolve,
+		reject
+	};
+};
+const isObject = (value) => typeof value === "object" && value !== null;
+const isReadableStream = (value) => isObject(value) && typeof value.getReader === "function";
+const isAsyncIterable = (value) => isObject(value) && typeof value[Symbol.asyncIterator] === "function";
+const assertStreamDescriptor = (value) => {
+	if (!isObject(value) || typeof value.producer !== "function") throw new TypeError("WebEffect.streamWith Programs must return an explicit stream descriptor");
+	return value;
+};
+const assertStreamSource = (value) => {
+	if (!isReadableStream(value) && !isAsyncIterable(value)) throw new TypeError("WebEffect stream producers must return a ReadableStream or AsyncIterable");
+	return value;
+};
+const streamResponseInit = (descriptor) => {
+	const init = {};
+	if (descriptor.status !== void 0) init.status = descriptor.status;
+	if (descriptor.statusText !== void 0) init.statusText = descriptor.statusText;
+	if (descriptor.headers !== void 0) init.headers = descriptor.headers;
+	return init;
+};
+const makeManagedBody = (descriptor, managedPromise, timeoutMs) => {
+	const completionDeferred = deferred();
+	let controller;
+	let reader;
+	let iterator;
+	let sourceStarted = false;
+	let settled = false;
+	let pulling = false;
+	let timer;
+	const clearTimer = () => {
+		if (timer !== void 0) {
+			clearTimeout(timer);
+			timer = void 0;
+		}
+	};
+	const makeTimeout = () => {
+		const error = /* @__PURE__ */ new Error("WebEffect stream body consumption timed out");
+		error.name = "WebEffectStreamTimeoutError";
+		return error;
+	};
+	const fail = (cause, errorBody) => {
+		if (settled) return;
+		settled = true;
+		clearTimer();
+		completionDeferred.reject(cause);
+		if (errorBody) try {
+			controller.error(cause);
+		} catch {}
+	};
+	const succeed = () => {
+		if (settled) return;
+		settled = true;
+		clearTimer();
+		completionDeferred.resolve(void 0);
+	};
+	const closeSource = async (reason) => {
+		const managed = await managedPromise;
+		try {
+			await managed.run(async () => {
+				if (reader !== void 0) {
+					await reader.cancel(reason);
+					reader.releaseLock();
+					reader = void 0;
+				}
+				if (iterator !== void 0) {
+					await iterator.return?.();
+					iterator = void 0;
+				}
+			});
+		} catch {}
+	};
+	const cancel = async (reason) => {
+		if (settled) return;
+		const cause = reason === void 0 ? /* @__PURE__ */ new Error("WebEffect stream body cancelled") : reason;
+		await closeSource(cause);
+		fail(cause, false);
+	};
+	const pull = async () => {
+		if (settled || pulling) return;
+		pulling = true;
+		clearTimer();
+		try {
+			const managed = await managedPromise;
+			const result = await managed.run(async () => {
+				if (!sourceStarted) {
+					sourceStarted = true;
+					const source = assertStreamSource(await descriptor.producer({ signal: managed.signal }));
+					if (isReadableStream(source)) reader = source.getReader();
+					else iterator = source[Symbol.asyncIterator]();
+				}
+				if (reader !== void 0) return await reader.read();
+				if (iterator !== void 0) return await iterator.next();
+				throw new TypeError("WebEffect stream producer did not expose a readable source");
+			});
+			if (result.done) {
+				if (reader !== void 0) {
+					reader.releaseLock();
+					reader = void 0;
+				}
+				iterator = void 0;
+				succeed();
+				controller.close();
+				return;
+			}
+			if (!(result.value instanceof Uint8Array)) throw new TypeError("WebEffect stream producers must yield Uint8Array chunks");
+			controller.enqueue(new Uint8Array(result.value));
+			if (timeoutMs > 0) timer = setTimeout(() => {
+				cancel(makeTimeout());
+			}, timeoutMs);
+		} catch (cause) {
+			await closeSource(cause);
+			fail(cause, true);
+		} finally {
+			pulling = false;
+		}
+	};
+	return {
+		body: new ReadableStream({
+			start(nextController) {
+				controller = nextController;
+			},
+			pull,
+			cancel
+		}, {
+			highWaterMark: 0,
+			size: () => 1
+		}),
+		completion: completionDeferred.promise,
+		cancel,
+		start: () => {
+			if (timeoutMs > 0 && !settled) timer = setTimeout(() => {
+				cancel(makeTimeout());
+			}, timeoutMs);
+		}
+	};
+};
+/** @internal Build a response plan without admitting a second Runtime execution. */
+const makeManagedResponse = (descriptor, managedPromise, timeoutMs = DEFAULT_UNCONSUMED_TIMEOUT_MS) => {
+	if (!Number.isFinite(timeoutMs) || timeoutMs < 0) throw new RangeError("WebEffect stream unconsumedTimeoutMs must be a finite non-negative number");
+	const body = makeManagedBody(descriptor, managedPromise, timeoutMs);
+	const response = new Response(body.body, streamResponseInit(descriptor));
+	body.start();
+	return {
+		readiness: response,
+		completion: body.completion,
+		cancel: body.cancel,
+		retainCompletion: true
+	};
+};
+const combineRequestLayer = (request, customLayer) => {
+	const currentRequestLayer = CurrentRequest.layer(request);
+	if (customLayer === void 0) return currentRequestLayer;
+	return Layer.override(currentRequestLayer, customLayer);
+};
+/** @internal Adapt a managed Runtime execution for framework-owned boundaries. */
+const runManagedWith = async (executor, request, program, options) => {
+	const managedDeferred = deferred();
+	let retainCompletion = false;
+	const managedProgram = async () => {
+		const result = await program();
+		if (Result.isError(result)) return {
+			readiness: assertResponse(await (options.onFailure ?? defaultFailure)(result.error)),
+			completion: Promise.reject(result.error),
+			cancel: async () => {}
+		};
+		const plan = await options.onSuccess({ value: result.value }, managedDeferred.promise);
+		retainCompletion = plan.retainCompletion === true;
+		return plan;
+	};
+	const requestLayer = combineRequestLayer(request, options.requestLayer?.(request));
+	let managed;
+	try {
+		managed = executor.runWithManaged(requestLayer, managedProgram, { signal: request.signal });
+		managedDeferred.resolve(managed);
+		const response = assertResponse(await managed.readiness);
+		if (retainCompletion) managed.completion.catch(() => void 0);
+		else await managed.completion.catch(() => void 0);
+		return response;
+	} catch (cause) {
+		managedDeferred.reject(cause);
+		if (managed !== void 0) {
+			managed.completion.catch(() => void 0);
+			await managed.cancel(cause).catch(() => void 0);
+		}
+		throw cause;
+	}
+};
+/** Execute one Result-valued Program inside a framework-neutral Web request boundary. */
+var WebEffect = class {
+	constructor() {}
+	static async handleWith(executor, request, program, options) {
+		const boundaryOptions = options;
+		const onSuccess = boundaryOptions?.onSuccess ?? defaultSuccess;
+		const onFailure = boundaryOptions?.onFailure ?? defaultFailure;
+		const requestLayer = combineRequestLayer(request, boundaryOptions?.requestLayer?.(request));
+		let response;
+		let failurePolicyFailed = false;
+		let failurePolicyCause;
+		await executor.runWith(requestLayer, async () => {
+			const result = await program();
+			if (Result.isError(result)) {
+				try {
+					response = assertResponse(await onFailure(result.error));
+				} catch (cause) {
+					failurePolicyFailed = true;
+					failurePolicyCause = cause;
+				}
+				return Result.err(result.error);
+			}
+			response = assertResponse(await onSuccess({ value: result.value }));
+			return Result.ok(response);
+		}, { signal: request.signal });
+		if (failurePolicyFailed) throw failurePolicyCause;
+		if (response === void 0) throw new Error("WebEffect response policy did not produce a Response");
+		return response;
+	}
+	static async streamWith(executor, request, program, options) {
+		const timeoutMs = options?.unconsumedTimeoutMs ?? DEFAULT_UNCONSUMED_TIMEOUT_MS;
+		if (!Number.isFinite(timeoutMs) || timeoutMs < 0) throw new RangeError("WebEffect stream unconsumedTimeoutMs must be a finite non-negative number");
+		const onFailure = options?.onFailure ?? defaultFailure;
+		const requestLayer = combineRequestLayer(request, options?.requestLayer?.(request));
+		const managedDeferred = deferred();
+		const managedProgram = async () => {
+			const result = await program();
+			if (Result.isError(result)) return {
+				readiness: assertResponse(await onFailure(result.error)),
+				completion: Promise.reject(result.error),
+				cancel: async () => {}
+			};
+			const descriptor = assertStreamDescriptor(result.value);
+			const body = makeManagedBody(descriptor, managedDeferred.promise, timeoutMs);
+			const response = new Response(body.body, streamResponseInit(descriptor));
+			body.start();
+			return {
+				readiness: response,
+				completion: body.completion,
+				cancel: body.cancel
+			};
+		};
+		let managed;
+		try {
+			const currentManaged = executor.runWithManaged(requestLayer, managedProgram, { signal: request.signal });
+			managed = currentManaged;
+			managedDeferred.resolve(currentManaged);
+			const response = assertResponse(await currentManaged.readiness);
+			currentManaged.completion.catch(() => void 0);
+			return response;
+		} catch (cause) {
+			managedDeferred.reject(cause);
+			if (managed !== void 0) {
+				managed.completion.catch(() => void 0);
+				await managed.cancel(cause).catch(() => void 0);
+			}
+			throw cause;
+		}
+	}
+};
+//#endregion
+export { assertResponse as a, WebEffectSerializationError as i, makeManagedResponse as n, runManagedWith as r, WebEffect as t };
+
+//# sourceMappingURL=web-effect-B9hp9jIe.mjs.map

package/dist/web-effect-B9hp9jIe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-effect-B9hp9jIe.mjs","names":["isObject","dataDescriptor"],"sources":["../src/web/responses.ts","../src/web/web-effect.ts"],"sourcesContent":["import type { WebEffectSuccess, WebJsonValue } from './types'\n\n/* oxlint-disable anti-slop/no-object-parameters -- Web Response values are validated structurally at this boundary. */\n/* oxlint-disable anti-slop/no-runtime-typeof -- Web Response and JSON values require runtime protocol validation. */\n/* oxlint-disable anti-slop/no-unknown-parameters -- Web Response and JSON policies accept opaque JavaScript values. */\n/* oxlint-disable anti-slop/no-unknown-returns -- Web Response and JSON policies narrow opaque JavaScript values locally. */\n\nconst DEFAULT_FAILURE_MESSAGE = 'Internal Server Error'\n\ntype BodyCandidate = {\n  readonly cancel: unknown\n  readonly getReader: unknown\n  readonly locked: unknown\n  readonly pipeThrough: unknown\n  readonly pipeTo: unknown\n  readonly tee: unknown\n}\n\ntype ResponseCandidate = {\n  readonly body: unknown\n  readonly bodyUsed: unknown\n  readonly headers: unknown\n  readonly ok: unknown\n  readonly redirected: unknown\n  readonly status: unknown\n  readonly statusText: unknown\n  readonly type: unknown\n  readonly url: unknown\n  readonly arrayBuffer: unknown\n  readonly blob: unknown\n  readonly bytes: unknown\n  readonly clone: unknown\n  readonly formData: unknown\n  readonly json: unknown\n  readonly text: unknown\n}\n\n/** An unsupported value encountered by the default Web JSON policy. */\nexport class WebEffectSerializationError extends TypeError {\n  constructor(detail: string) {\n    super(`WebEffect default success serialization ${detail}`)\n    this.name = 'WebEffectSerializationError'\n  }\n}\n\nconst isObject = (value: unknown): value is object => typeof value === 'object' && value !== null\n\nconst isCallable = (value: unknown): value is (...arguments_: never[]) => unknown =>\n  typeof value === 'function'\n\ntype HeadersCandidate = {\n  readonly append: unknown\n  readonly delete: unknown\n  readonly get: unknown\n  readonly getSetCookie: unknown\n  readonly has: unknown\n  readonly set: unknown\n  readonly forEach: unknown\n}\n\nconst isHeaders = (value: unknown): boolean => {\n  if (!isObject(value)) {\n    return false\n  }\n\n  // SAFETY: isObject above establishes the runtime object shape before structural field inspection.\n  const candidate = value as HeadersCandidate\n\n  return (\n    isCallable(candidate.append) &&\n    isCallable(candidate.delete) &&\n    isCallable(candidate.get) &&\n    isCallable(candidate.getSetCookie) &&\n    isCallable(candidate.has) &&\n    isCallable(candidate.set) &&\n    isCallable(candidate.forEach)\n  )\n}\n\nconst isBody = (value: unknown): boolean => {\n  if (value === null) {\n    return true\n  }\n\n  if (!isObject(value)) {\n    return false\n  }\n\n  // SAFETY: isObject above establishes the runtime object shape before structural field inspection.\n  const candidate = value as BodyCandidate\n\n  return (\n    typeof candidate.locked === 'boolean' &&\n    isCallable(candidate.cancel) &&\n    isCallable(candidate.getReader) &&\n    isCallable(candidate.pipeThrough) &&\n    isCallable(candidate.pipeTo) &&\n    isCallable(candidate.tee)\n  )\n}\n\nconst isResponseStatus = (value: unknown): value is number =>\n  typeof value === 'number' &&\n  Number.isInteger(value) &&\n  (value === 0 || (value >= 200 && value <= 599))\n\nconst isResponseType = (value: unknown): value is Response['type'] =>\n  value === 'basic' ||\n  value === 'cors' ||\n  value === 'default' ||\n  value === 'error' ||\n  value === 'opaque' ||\n  value === 'opaqueredirect'\n\n/** Accept native, cross-realm, and standards-compatible Web Response values. */\nconst isWebResponse = (value: unknown): value is Response => {\n  if (!isObject(value)) {\n    return false\n  }\n\n  try {\n    // SAFETY: isObject above establishes the runtime object shape before structural field inspection.\n    const candidate = value as ResponseCandidate\n\n    const status = candidate.status\n\n    if (!isResponseStatus(status)) {\n      return false\n    }\n\n    return (\n      isBody(candidate.body) &&\n      typeof candidate.bodyUsed === 'boolean' &&\n      isHeaders(candidate.headers) &&\n      typeof candidate.ok === 'boolean' &&\n      candidate.ok === (status >= 200 && status <= 299) &&\n      typeof candidate.redirected === 'boolean' &&\n      typeof candidate.statusText === 'string' &&\n      isResponseType(candidate.type) &&\n      typeof candidate.url === 'string' &&\n      isCallable(candidate.arrayBuffer) &&\n      isCallable(candidate.blob) &&\n      isCallable(candidate.bytes) &&\n      isCallable(candidate.clone) &&\n      isCallable(candidate.formData) &&\n      isCallable(candidate.json) &&\n      isCallable(candidate.text)\n    )\n  } catch {\n    return false\n  }\n}\n\nconst propertyPath = (path: string, property: string): string => `${path}.${property}`\n\nconst unsupported = (path: string, kind: string): never => {\n  throw new WebEffectSerializationError(`cannot encode ${kind} at ${path}`)\n}\n\nconst ownDataProperties = (\n  value: object,\n  path: string\n): readonly (readonly [string, unknown])[] => {\n  const symbols = Object.getOwnPropertySymbols(value)\n\n  if (symbols.length > 0) {\n    unsupported(path, 'symbol-keyed properties')\n  }\n\n  return Object.getOwnPropertyNames(value).map((property) => {\n    const descriptor = Object.getOwnPropertyDescriptor(value, property)\n\n    if (descriptor === undefined || !('value' in descriptor) || descriptor.enumerable !== true) {\n      unsupported(propertyPath(path, property), 'non-enumerable or accessor properties')\n    }\n\n    // SAFETY: the preceding descriptor guard establishes a data descriptor with an enumerable value.\n    const dataDescriptor = descriptor as PropertyDescriptor & { readonly value: unknown }\n\n    return [property, dataDescriptor.value] as const\n  })\n}\n\nconst arrayIndex = (property: string): number | undefined => {\n  const index = Number(property)\n\n  return Number.isInteger(index) && index >= 0 && index < 2 ** 32 - 1 && String(index) === property\n    ? index\n    : undefined\n}\n\nconst sanitizeArray = (\n  value: readonly unknown[],\n  path: string,\n  ancestors: Set<object>\n): readonly WebJsonValue[] => {\n  const symbols = Object.getOwnPropertySymbols(value)\n\n  if (symbols.length > 0) {\n    unsupported(path, 'symbol-keyed properties')\n  }\n\n  const properties = Object.getOwnPropertyNames(value)\n\n  if (properties.length !== value.length + 1 || !properties.includes('length')) {\n    unsupported(path, 'sparse or augmented arrays')\n  }\n\n  const output: WebJsonValue[] = []\n\n  for (let index = 0; index < value.length; index += 1) {\n    const property = String(index)\n    const descriptor = Object.getOwnPropertyDescriptor(value, property)\n\n    if (\n      descriptor === undefined ||\n      !('value' in descriptor) ||\n      descriptor.enumerable !== true ||\n      arrayIndex(property) === undefined\n    ) {\n      unsupported(propertyPath(path, property), 'sparse or accessor array elements')\n    }\n\n    // SAFETY: the preceding descriptor guard establishes a data descriptor with an enumerable value.\n    const dataDescriptor = descriptor as PropertyDescriptor & { readonly value: unknown }\n\n    output.push(sanitizeJsonValue(dataDescriptor.value, propertyPath(path, property), ancestors))\n  }\n\n  return output\n}\n\nconst sanitizeObject = (\n  value: object,\n  path: string,\n  ancestors: Set<object>\n): { readonly [key: string]: WebJsonValue } => {\n  const prototype = Object.getPrototypeOf(value)\n\n  if (prototype !== Object.prototype && prototype !== null) {\n    unsupported(path, 'non-plain objects')\n  }\n\n  // SAFETY: Object.create(null) is an empty dictionary that is populated only with sanitized values.\n  const output: { [key: string]: WebJsonValue } = Object.create(null) as {\n    [key: string]: WebJsonValue\n  }\n\n  for (const [property, child] of ownDataProperties(value, path)) {\n    output[property] = sanitizeJsonValue(child, propertyPath(path, property), ancestors)\n  }\n\n  return output\n}\n\nconst sanitizeJsonValue = (\n  value: unknown,\n  path: string,\n  ancestors: Set<object> = new Set()\n): WebJsonValue => {\n  if (value === null || typeof value === 'boolean' || typeof value === 'string') {\n    return value\n  }\n\n  if (typeof value === 'number') {\n    return Number.isFinite(value) ? value : unsupported(path, 'non-finite numbers')\n  }\n\n  if (typeof value === 'undefined') {\n    return unsupported(path, 'undefined values')\n  }\n\n  if (typeof value === 'bigint' || typeof value === 'function' || typeof value === 'symbol') {\n    return unsupported(path, `${typeof value} values`)\n  }\n\n  if (!isObject(value)) {\n    return unsupported(path, 'unsupported values')\n  }\n\n  if (ancestors.has(value)) {\n    return unsupported(path, 'circular values')\n  }\n\n  ancestors.add(value)\n\n  try {\n    return Array.isArray(value)\n      ? sanitizeArray(value, path, ancestors)\n      : sanitizeObject(value, path, ancestors)\n  } finally {\n    ancestors.delete(value)\n  }\n}\n\n/** Convert a successful value using the boundary's constrained JSON policy. */\nexport const defaultSuccess = ({ value }: WebEffectSuccess): Response => {\n  if (isWebResponse(value)) {\n    return value\n  }\n\n  if (value === undefined) {\n    return new Response(null, { status: 204 })\n  }\n\n  return Response.json({ data: sanitizeJsonValue(value, '$') })\n}\n\n/** Redact typed failures unless the failure is an intentional Response. */\n// oxlint-disable-next-line anti-slop/no-unknown-parameters -- Typed Result errors are intentionally opaque at this HTTP boundary.\nexport const defaultFailure = (error: unknown): Response => {\n  if (isWebResponse(error)) {\n    return error\n  }\n\n  return Response.json({ error: DEFAULT_FAILURE_MESSAGE }, { status: 500 })\n}\n\n/** Validate policy output at the JavaScript boundary before returning it. */\n// oxlint-disable-next-line anti-slop/no-unknown-parameters -- Policy callbacks are opaque JavaScript inputs at this boundary.\nexport const assertResponse = (response: unknown): Response => {\n  if (!isWebResponse(response)) {\n    throw new TypeError('WebEffect response policies must return a Response')\n  }\n\n  return response\n}\n","import { Result } from 'better-result'\n\nimport { Layer } from '../layer'\nimport type { LayerInput } from '../layer/inference'\nimport { CurrentRequest } from '../standard-services/current-request'\nimport type { RuntimeExecutor, RuntimeManagedExecution, RuntimeManagedPlan } from '../runtime'\nimport type { AnyService } from '../service'\nimport type { EffectError, EffectSuccess } from '../effect/types'\nimport { assertResponse, defaultFailure, defaultSuccess } from './responses'\nimport type {\n  AnyProgram,\n  CompleteWebProgram,\n  CompleteWebStreamProgram,\n  DefaultRequestLayer,\n  WebEffectStream,\n  WebEffectStreamContext,\n  WebEffectStreamOptions,\n  WebEffectOptions,\n  WebEffectProgram,\n  WebProgramChecks,\n  WebStreamProgramChecks,\n  WebRequestLayerChecks\n} from './types'\n\n/* oxlint-disable anti-slop/no-unknown-parameters, anti-slop/no-runtime-typeof, anti-slop/no-unsafe-dictionary-type, anti-slop/no-chained-type-assertions, anti-slop/require-safety-comment-for-type-assertion -- this boundary validates opaque Web stream protocols before execution. */\n\nconst DEFAULT_UNCONSUMED_TIMEOUT_MS = 30_000\n\ntype Deferred<A> = {\n  readonly promise: Promise<A>\n  readonly resolve: (value: A | PromiseLike<A>) => void\n  readonly reject: (cause?: unknown) => void\n}\n\nconst deferred = <A>(): Deferred<A> => {\n  let resolve!: (value: A | PromiseLike<A>) => void\n  let reject!: (cause?: unknown) => void\n  const promise = new Promise<A>((resolvePromise, rejectPromise) => {\n    resolve = resolvePromise\n    reject = rejectPromise\n  })\n\n  return { promise, resolve, reject }\n}\n\nconst isObject = (value: unknown): value is Record<PropertyKey, unknown> =>\n  typeof value === 'object' && value !== null\n\nconst isReadableStream = (value: unknown): value is ReadableStream<Uint8Array> =>\n  isObject(value) && typeof value.getReader === 'function'\n\nconst isAsyncIterable = (value: unknown): value is AsyncIterable<Uint8Array> =>\n  isObject(value) && typeof value[Symbol.asyncIterator] === 'function'\n\nconst assertStreamDescriptor = (value: unknown): WebEffectStream => {\n  if (!isObject(value) || typeof value.producer !== 'function') {\n    throw new TypeError('WebEffect.streamWith Programs must return an explicit stream descriptor')\n  }\n\n  return value as WebEffectStream\n}\n\nconst assertStreamSource = (\n  value: unknown\n): ReadableStream<Uint8Array> | AsyncIterable<Uint8Array> => {\n  if (!isReadableStream(value) && !isAsyncIterable(value)) {\n    throw new TypeError('WebEffect stream producers must return a ReadableStream or AsyncIterable')\n  }\n\n  return value\n}\n\nconst streamResponseInit = (descriptor: WebEffectStream): ResponseInit => {\n  const init: ResponseInit = {}\n\n  if (descriptor.status !== undefined) init.status = descriptor.status\n  if (descriptor.statusText !== undefined) init.statusText = descriptor.statusText\n  if (descriptor.headers !== undefined) init.headers = descriptor.headers\n\n  return init\n}\n\ntype ManagedBody = {\n  readonly body: ReadableStream<Uint8Array>\n  readonly completion: Promise<void>\n  readonly cancel: (reason?: unknown) => Promise<void>\n  readonly start: () => void\n}\n\n/** @internal A managed Web response plan used by framework adapters. */\nexport type ManagedWebResponse = RuntimeManagedPlan<Response> & {\n  /** @internal Keep the request execution alive after readiness is returned. */\n  readonly retainCompletion?: boolean\n}\n\nconst makeManagedBody = (\n  descriptor: WebEffectStream,\n  managedPromise: Promise<RuntimeManagedExecution<unknown>>,\n  timeoutMs: number\n): ManagedBody => {\n  const completionDeferred = deferred<void>()\n  let controller!: ReadableStreamDefaultController<Uint8Array>\n  let reader: ReadableStreamDefaultReader<Uint8Array> | undefined\n  let iterator: AsyncIterator<Uint8Array> | undefined\n  let sourceStarted = false\n  let settled = false\n  let pulling = false\n  let timer: ReturnType<typeof setTimeout> | undefined\n\n  const clearTimer = (): void => {\n    if (timer !== undefined) {\n      clearTimeout(timer)\n      timer = undefined\n    }\n  }\n\n  const makeTimeout = (): Error => {\n    const error = new Error('WebEffect stream body consumption timed out')\n    error.name = 'WebEffectStreamTimeoutError'\n    return error\n  }\n\n  const fail = (cause: unknown, errorBody: boolean): void => {\n    if (settled) return\n    settled = true\n    clearTimer()\n    completionDeferred.reject(cause)\n    if (errorBody) {\n      try {\n        controller.error(cause)\n      } catch {\n        // The body may already have been cancelled by its consumer.\n      }\n    }\n  }\n\n  const succeed = (): void => {\n    if (settled) return\n    settled = true\n    clearTimer()\n    completionDeferred.resolve(undefined)\n  }\n\n  const closeSource = async (reason?: unknown): Promise<void> => {\n    const managed = await managedPromise\n\n    try {\n      await managed.run(async () => {\n        if (reader !== undefined) {\n          await reader.cancel(reason)\n          reader.releaseLock()\n          reader = undefined\n        }\n\n        if (iterator !== undefined) {\n          await iterator.return?.()\n          iterator = undefined\n        }\n      })\n    } catch {\n      // The managed execution remains the owner of the primary cancellation cause.\n    }\n  }\n\n  const cancel = async (reason?: unknown): Promise<void> => {\n    if (settled) return\n    const cause = reason === undefined ? new Error('WebEffect stream body cancelled') : reason\n    await closeSource(cause)\n    fail(cause, false)\n  }\n\n  const pull = async (): Promise<void> => {\n    if (settled || pulling) return\n    pulling = true\n    clearTimer()\n\n    try {\n      const managed = await managedPromise\n      const result = await managed.run(async () => {\n        if (!sourceStarted) {\n          sourceStarted = true\n          const source = assertStreamSource(await descriptor.producer({ signal: managed.signal }))\n\n          if (isReadableStream(source)) {\n            reader = source.getReader()\n          } else {\n            iterator = source[Symbol.asyncIterator]()\n          }\n        }\n\n        if (reader !== undefined) return await reader.read()\n        if (iterator !== undefined) return await iterator.next()\n        throw new TypeError('WebEffect stream producer did not expose a readable source')\n      })\n\n      if (result.done) {\n        if (reader !== undefined) {\n          reader.releaseLock()\n          reader = undefined\n        }\n        iterator = undefined\n        succeed()\n        controller.close()\n        return\n      }\n\n      if (!(result.value instanceof Uint8Array)) {\n        throw new TypeError('WebEffect stream producers must yield Uint8Array chunks')\n      }\n\n      controller.enqueue(new Uint8Array(result.value))\n      if (timeoutMs > 0) {\n        timer = setTimeout(() => {\n          void cancel(makeTimeout())\n        }, timeoutMs)\n      }\n    } catch (cause) {\n      await closeSource(cause)\n      fail(cause, true)\n    } finally {\n      pulling = false\n    }\n  }\n\n  const body = new ReadableStream<Uint8Array>(\n    {\n      start(nextController) {\n        controller = nextController\n      },\n      pull,\n      cancel\n    },\n    { highWaterMark: 0, size: () => 1 }\n  )\n\n  return {\n    body,\n    completion: completionDeferred.promise,\n    cancel,\n    start: () => {\n      if (timeoutMs > 0 && !settled) {\n        timer = setTimeout(() => {\n          void cancel(makeTimeout())\n        }, timeoutMs)\n      }\n    }\n  }\n}\n\n/** @internal Build a response plan without admitting a second Runtime execution. */\nexport const makeManagedResponse = (\n  descriptor: WebEffectStream,\n  managedPromise: Promise<RuntimeManagedExecution<unknown>>,\n  timeoutMs = DEFAULT_UNCONSUMED_TIMEOUT_MS\n): ManagedWebResponse => {\n  if (!Number.isFinite(timeoutMs) || timeoutMs < 0) {\n    throw new RangeError(\n      'WebEffect stream unconsumedTimeoutMs must be a finite non-negative number'\n    )\n  }\n\n  const body = makeManagedBody(descriptor, managedPromise, timeoutMs)\n  const response = new Response(body.body, streamResponseInit(descriptor))\n  body.start()\n\n  return {\n    readiness: response,\n    completion: body.completion,\n    cancel: body.cancel,\n    retainCompletion: true\n  }\n}\n\nconst combineRequestLayer = <RequestLayer extends LayerInput>(\n  request: Request,\n  customLayer: RequestLayer | undefined\n): LayerInput => {\n  const currentRequestLayer = CurrentRequest.layer(request)\n\n  if (customLayer === undefined) {\n    return currentRequestLayer\n  }\n\n  // SAFETY: WebEffect.handleWith validates the custom Layer's shape and override contract at its public boundary.\n  return Layer.override(currentRequestLayer, customLayer as never)\n}\n\n/** @internal Run a framework boundary with a readiness/completion split. */\nexport type ManagedWebBoundaryOptions = {\n  readonly requestLayer?: (request: Request) => LayerInput\n  readonly onSuccess: (\n    result: { readonly value: unknown },\n    managed: Promise<RuntimeManagedExecution<unknown>>\n  ) => ManagedWebResponse | PromiseLike<ManagedWebResponse>\n  readonly onFailure?: (error: unknown) => Response | PromiseLike<Response>\n}\n\n/** @internal Adapt a managed Runtime execution for framework-owned boundaries. */\nexport const runManagedWith = async (\n  executor: RuntimeExecutor<AnyService>,\n  request: Request,\n  program: AnyProgram,\n  options: ManagedWebBoundaryOptions\n): Promise<Response> => {\n  const managedDeferred = deferred<RuntimeManagedExecution<unknown>>()\n  let retainCompletion = false\n  const managedProgram = async (): Promise<ManagedWebResponse> => {\n    const result = await program()\n\n    if (Result.isError(result)) {\n      const response = assertResponse(await (options.onFailure ?? defaultFailure)(result.error))\n      return {\n        readiness: response,\n        completion: Promise.reject(result.error),\n        cancel: async () => {}\n      }\n    }\n\n    const plan = await options.onSuccess({ value: result.value }, managedDeferred.promise)\n    retainCompletion = plan.retainCompletion === true\n    return plan\n  }\n\n  const requestLayer = combineRequestLayer(request, options.requestLayer?.(request))\n  let managed: RuntimeManagedExecution<unknown> | undefined\n\n  try {\n    managed = executor.runWithManaged(requestLayer as Layer.Any, managedProgram as never, {\n      signal: request.signal\n    })\n    managedDeferred.resolve(managed)\n    const response = assertResponse(await managed.readiness)\n    if (retainCompletion) {\n      void managed.completion.catch(() => undefined)\n    } else {\n      await managed.completion.catch(() => undefined)\n    }\n    return response\n  } catch (cause) {\n    managedDeferred.reject(cause)\n    if (managed !== undefined) {\n      void managed.completion.catch(() => undefined)\n      await managed.cancel(cause).catch(() => undefined)\n    }\n    throw cause\n  }\n}\n\n/** Execute one Result-valued Program inside a framework-neutral Web request boundary. */\nexport class WebEffect {\n  private constructor() {}\n\n  /**\n   * Run one lazy Program and map its Result to a standard Web Response.\n   *\n   * The request Layer and execution Scope are owned by the Runtime behind the\n   * supplied executor; request resources close before this Promise resolves,\n   * while Runtime-root resources remain owned by that Runtime.\n   */\n  static handleWith<\n    Provided extends AnyService,\n    const Program extends AnyProgram,\n    RequestLayer extends LayerInput,\n    Failure = EffectError<Program>\n  >(\n    executor: RuntimeExecutor<Provided>,\n    request: Request,\n    program: Program,\n    options: WebEffectOptions<NoInfer<Failure>, RequestLayer, EffectSuccess<Program>> & {\n      readonly requestLayer: (request: Request) => RequestLayer\n    } & WebRequestLayerChecks<Provided, RequestLayer> &\n      WebProgramChecks<Provided, RequestLayer, Program, NoInfer<Failure>>\n  ): Promise<Response>\n\n  static handleWith<\n    Provided extends AnyService,\n    const Program extends AnyProgram,\n    Failure = EffectError<Program>\n  >(\n    executor: RuntimeExecutor<Provided>,\n    request: Request,\n    program: Program & CompleteWebProgram<Provided, DefaultRequestLayer, Program, NoInfer<Failure>>,\n    options: WebEffectOptions<NoInfer<Failure>, DefaultRequestLayer, EffectSuccess<Program>>\n  ): Promise<Response>\n\n  static handleWith<Provided extends AnyService, const Program extends AnyProgram>(\n    executor: RuntimeExecutor<Provided>,\n    request: Request,\n    program: Program & CompleteWebProgram<Provided, DefaultRequestLayer, Program>,\n    options?: undefined\n  ): Promise<Response>\n\n  static async handleWith(\n    executor: RuntimeExecutor<AnyService>,\n    request: Request,\n    program: AnyProgram,\n    options?: WebEffectOptions<unknown, LayerInput, unknown>\n  ): Promise<Response> {\n    const boundaryOptions = options\n    const onSuccess = boundaryOptions?.onSuccess ?? defaultSuccess\n    const onFailure = boundaryOptions?.onFailure ?? defaultFailure\n    const requestLayer = combineRequestLayer(request, boundaryOptions?.requestLayer?.(request))\n    let response: Response | undefined\n    let failurePolicyFailed = false\n    let failurePolicyCause: unknown\n\n    // Return a Result from the execution even after mapping it so Runtime can\n    // classify typed failures and give request finalizers the original cause.\n    // A policy defect is rethrown after this Result settles so it cannot replace\n    // the typed failure supplied to the request Scope.\n    // SAFETY: Public overloads validate the request Layer before this erased Runtime boundary.\n    await executor.runWith(\n      requestLayer as Layer.Any,\n      async () => {\n        const result = await program()\n\n        if (Result.isError(result)) {\n          try {\n            response = assertResponse(await onFailure(result.error))\n          } catch (cause) {\n            failurePolicyFailed = true\n            failurePolicyCause = cause\n          }\n\n          return Result.err(result.error)\n        }\n\n        response = assertResponse(\n          await onSuccess({\n            value: result.value\n          })\n        )\n        return Result.ok(response)\n      },\n      { signal: request.signal }\n    )\n\n    if (failurePolicyFailed) {\n      throw failurePolicyCause\n    }\n\n    if (response === undefined) {\n      throw new Error('WebEffect response policy did not produce a Response')\n    }\n\n    return response\n  }\n\n  static streamWith<\n    Provided extends AnyService,\n    const Program extends AnyProgram,\n    RequestLayer extends LayerInput,\n    Failure = EffectError<Program>\n  >(\n    executor: RuntimeExecutor<Provided>,\n    request: Request,\n    program: Program,\n    options: WebEffectStreamOptions<NoInfer<Failure>, RequestLayer> & {\n      readonly requestLayer: (request: Request) => RequestLayer\n    } & WebRequestLayerChecks<Provided, RequestLayer> &\n      WebStreamProgramChecks<Provided, RequestLayer, Program, NoInfer<Failure>>\n  ): Promise<Response>\n\n  static streamWith<\n    Provided extends AnyService,\n    const Program extends AnyProgram,\n    Failure = EffectError<Program>\n  >(\n    executor: RuntimeExecutor<Provided>,\n    request: Request,\n    program: Program &\n      CompleteWebStreamProgram<Provided, DefaultRequestLayer, Program, NoInfer<Failure>>,\n    options?: WebEffectStreamOptions<NoInfer<Failure>, DefaultRequestLayer>\n  ): Promise<Response>\n\n  static async streamWith(\n    executor: RuntimeExecutor<AnyService>,\n    request: Request,\n    program: AnyProgram,\n    options?: WebEffectStreamOptions<unknown, LayerInput>\n  ): Promise<Response> {\n    const timeoutMs = options?.unconsumedTimeoutMs ?? DEFAULT_UNCONSUMED_TIMEOUT_MS\n\n    if (!Number.isFinite(timeoutMs) || timeoutMs < 0) {\n      throw new RangeError(\n        'WebEffect stream unconsumedTimeoutMs must be a finite non-negative number'\n      )\n    }\n\n    const onFailure = options?.onFailure ?? defaultFailure\n    const requestLayer = combineRequestLayer(request, options?.requestLayer?.(request))\n    const managedDeferred = deferred<RuntimeManagedExecution<unknown>>()\n\n    const managedProgram = async (): Promise<RuntimeManagedPlan<Response>> => {\n      const result = await program()\n\n      if (Result.isError(result)) {\n        const response = assertResponse(await onFailure(result.error))\n\n        return {\n          readiness: response,\n          completion: Promise.reject(result.error),\n          cancel: async () => {}\n        }\n      }\n\n      const descriptor = assertStreamDescriptor(result.value)\n      const body = makeManagedBody(descriptor, managedDeferred.promise, timeoutMs)\n      const response = new Response(body.body, streamResponseInit(descriptor))\n\n      body.start()\n\n      return {\n        readiness: response,\n        completion: body.completion,\n        cancel: body.cancel\n      }\n    }\n\n    let managed: RuntimeManagedExecution<unknown> | undefined\n\n    try {\n      const currentManaged = executor.runWithManaged(\n        requestLayer as Layer.Any,\n        managedProgram as never,\n        {\n          signal: request.signal\n        }\n      )\n      managed = currentManaged\n      managedDeferred.resolve(currentManaged)\n      const response = assertResponse(await currentManaged.readiness)\n      void currentManaged.completion.catch(() => undefined)\n      return response\n    } catch (cause) {\n      managedDeferred.reject(cause)\n      if (managed !== undefined) {\n        void managed.completion.catch(() => undefined)\n        await managed.cancel(cause).catch(() => undefined)\n      }\n      throw cause\n    }\n  }\n}\n\n/** Type-level aliases for the framework-neutral Web boundary. */\nexport declare namespace WebEffect {\n  /** Options used by `WebEffect.handleWith`. */\n  export type Options<\n    Failure = unknown,\n    RequestLayer extends LayerInput = DefaultRequestLayer,\n    Success = unknown\n  > = WebEffectOptions<Failure, RequestLayer, Success>\n\n  /** The success value passed to `onSuccess`. */\n  export type Success<A = unknown> = {\n    readonly value: A\n  }\n\n  /** A standard Web response or an asynchronous response. */\n  export type ResponseLike = Response | PromiseLike<Response>\n\n  /** A lazy Result-valued Program accepted by `handleWith`. */\n  export type Program<A = unknown, E = unknown, R extends AnyService = never> = WebEffectProgram<\n    A,\n    E,\n    R\n  >\n\n  /** Extract a Program's success channel. */\n  export type Value<Program extends WebEffectProgram<any, any, AnyService>> = EffectSuccess<Program>\n\n  /** Extract a Program's typed failure channel. */\n  export type Failure<Program extends WebEffectProgram<any, any, AnyService>> = EffectError<Program>\n\n  /** Explicit response descriptor accepted by `streamWith`. */\n  export type Stream = WebEffectStream\n\n  /** Producer context accepted by a managed response descriptor. */\n  export type StreamContext = WebEffectStreamContext\n\n  /** Options used by `streamWith`. */\n  export type StreamOptions<\n    Failure = unknown,\n    RequestLayer extends LayerInput = DefaultRequestLayer\n  > = WebEffectStreamOptions<Failure, RequestLayer>\n}\n"],"mappings":"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"}

package/dist/web.d.mts

@@ -1,7 +1,6 @@
-import { C as EffectError, E as EffectSuccess, M as AnyService } from "./index-AiKM71-u.mjs";
-import { y as LayerInput } from "./outcome-DI8LPIQ4.mjs";
-import { l as Runtime } from "./index-BodMy6rO.mjs";
-import { a as WebEffectOptions, i as ResponseLike, l as WebProgramChecks, n as CompleteWebProgram, o as WebEffectProgram, r as DefaultRequestLayer, s as WebEffectSuccess, t as AnyProgram, u as WebRequestLayerChecks } from "./types-oihI-ESv.mjs";
+import { Lt as AnyService, Ot as EffectError, jt as EffectSuccess, tt as LayerInput, u as RuntimeExecutor } from "./layer-C2OaqTmB.mjs";
+import "./index-ClNndn2-.mjs";
+import { a as ResponseLike, c as WebEffectStream, d as WebEffectStreamSource, f as WebEffectSuccess, g as WebStreamProgramChecks, h as WebRequestLayerChecks, i as DefaultRequestLayer, l as WebEffectStreamContext, m as WebProgramChecks, n as CompleteWebProgram, o as WebEffectOptions, r as CompleteWebStreamProgram, s as WebEffectProgram, t as AnyProgram, u as WebEffectStreamOptions } from "./types-BFTqCCcw.mjs";
 //#region src/web/web-effect.d.ts
 /** Execute one Result-valued Program inside a framework-neutral Web request boundary. */
 declare class WebEffect {
@@ -9,19 +8,23 @@ declare class WebEffect {
   /**
    * Run one lazy Program and map its Result to a standard Web Response.
    *
-   * The request Layer and execution Scope are owned by the supplied Runtime;
-   * request resources close before this Promise resolves, while Runtime-root
-   * resources remain owned by the Runtime.
+   * The request Layer and execution Scope are owned by the Runtime behind the
+   * supplied executor; request resources close before this Promise resolves,
+   * while Runtime-root resources remain owned by that Runtime.
    */
-  static handle<Provided extends AnyService, const Program extends AnyProgram, RequestLayer extends LayerInput, Failure = EffectError<Program>>(runtime: Runtime<Provided>, request: Request, program: Program, options: WebEffectOptions<NoInfer<Failure>, RequestLayer, EffectSuccess<Program>> & {
+  static handleWith<Provided extends AnyService, const Program extends AnyProgram, RequestLayer extends LayerInput, Failure = EffectError<Program>>(executor: RuntimeExecutor<Provided>, request: Request, program: Program, options: WebEffectOptions<NoInfer<Failure>, RequestLayer, EffectSuccess<Program>> & {
     readonly requestLayer: (request: Request) => RequestLayer;
   } & WebRequestLayerChecks<Provided, RequestLayer> & WebProgramChecks<Provided, RequestLayer, Program, NoInfer<Failure>>): Promise<Response>;
-  static handle<Provided extends AnyService, const Program extends AnyProgram, Failure = EffectError<Program>>(runtime: Runtime<Provided>, request: Request, program: Program & CompleteWebProgram<Provided, DefaultRequestLayer, Program, NoInfer<Failure>>, options: WebEffectOptions<NoInfer<Failure>, DefaultRequestLayer, EffectSuccess<Program>>): Promise<Response>;
-  static handle<Provided extends AnyService, const Program extends AnyProgram>(runtime: Runtime<Provided>, request: Request, program: Program & CompleteWebProgram<Provided, DefaultRequestLayer, Program>, options?: undefined): Promise<Response>;
+  static handleWith<Provided extends AnyService, const Program extends AnyProgram, Failure = EffectError<Program>>(executor: RuntimeExecutor<Provided>, request: Request, program: Program & CompleteWebProgram<Provided, DefaultRequestLayer, Program, NoInfer<Failure>>, options: WebEffectOptions<NoInfer<Failure>, DefaultRequestLayer, EffectSuccess<Program>>): Promise<Response>;
+  static handleWith<Provided extends AnyService, const Program extends AnyProgram>(executor: RuntimeExecutor<Provided>, request: Request, program: Program & CompleteWebProgram<Provided, DefaultRequestLayer, Program>, options?: undefined): Promise<Response>;
+  static streamWith<Provided extends AnyService, const Program extends AnyProgram, RequestLayer extends LayerInput, Failure = EffectError<Program>>(executor: RuntimeExecutor<Provided>, request: Request, program: Program, options: WebEffectStreamOptions<NoInfer<Failure>, RequestLayer> & {
+    readonly requestLayer: (request: Request) => RequestLayer;
+  } & WebRequestLayerChecks<Provided, RequestLayer> & WebStreamProgramChecks<Provided, RequestLayer, Program, NoInfer<Failure>>): Promise<Response>;
+  static streamWith<Provided extends AnyService, const Program extends AnyProgram, Failure = EffectError<Program>>(executor: RuntimeExecutor<Provided>, request: Request, program: Program & CompleteWebStreamProgram<Provided, DefaultRequestLayer, Program, NoInfer<Failure>>, options?: WebEffectStreamOptions<NoInfer<Failure>, DefaultRequestLayer>): Promise<Response>;
 }
 /** Type-level aliases for the framework-neutral Web boundary. */
 declare namespace WebEffect {
-  /** Options used by `WebEffect.handle`. */
+  /** Options used by `WebEffect.handleWith`. */
   type Options<Failure = unknown, RequestLayer extends LayerInput = DefaultRequestLayer, Success = unknown> = WebEffectOptions<Failure, RequestLayer, Success>;
   /** The success value passed to `onSuccess`. */
   type Success<A = unknown> = {
@@ -29,12 +32,18 @@ declare namespace WebEffect {
   };
   /** A standard Web response or an asynchronous response. */
   type ResponseLike = Response | PromiseLike<Response>;
-  /** A lazy Result-valued Program accepted by `handle`. */
+  /** A lazy Result-valued Program accepted by `handleWith`. */
   type Program<A = unknown, E = unknown, R extends AnyService = never> = WebEffectProgram<A, E, R>;
   /** Extract a Program's success channel. */
   type Value<Program extends WebEffectProgram<any, any, AnyService>> = EffectSuccess<Program>;
   /** Extract a Program's typed failure channel. */
   type Failure<Program extends WebEffectProgram<any, any, AnyService>> = EffectError<Program>;
+  /** Explicit response descriptor accepted by `streamWith`. */
+  type Stream = WebEffectStream;
+  /** Producer context accepted by a managed response descriptor. */
+  type StreamContext = WebEffectStreamContext;
+  /** Options used by `streamWith`. */
+  type StreamOptions<Failure = unknown, RequestLayer extends LayerInput = DefaultRequestLayer> = WebEffectStreamOptions<Failure, RequestLayer>;
 }
 //#endregion
 //#region src/web/responses.d.ts
@@ -43,5 +52,5 @@ declare class WebEffectSerializationError extends TypeError {
   constructor(detail: string);
 }
 //#endregion
-export { type ResponseLike, WebEffect, type WebEffectOptions, type WebEffectProgram, WebEffectSerializationError, type WebEffectSuccess };
+export { type ResponseLike, WebEffect, type WebEffectOptions, type WebEffectProgram, WebEffectSerializationError, type WebEffectStream, type WebEffectStreamContext, type WebEffectStreamOptions, type WebEffectStreamSource, type WebEffectSuccess };
 //# sourceMappingURL=web.d.mts.map

package/dist/web.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.mts","names":[],"sources":["../src/web/web-effect.ts","../src/web/responses.ts"],"mappings":";;;;;;cAkCa;UACJ;;;;;;;;SASA,OACL,iBAAiB,kBACX,gBAAgB,YACtB,qBAAqB,YACrB,UAAU,YAAY,UAEtB,SAAS,QAAQ,WACjB,SAAS,SACT,SAAS,SACT,SAAS,iBAAiB,QAAQ,UAAU,cAAc,cAAc;aAC7D,eAAe,SAAS,YAAY;MAC3C,sBAAsB,UAAU,gBAClC,iBAAiB,UAAU,cAAc,SAAS,QAAQ,YAC3D,QAAQ;SAEJ,OACL,iBAAiB,kBACX,gBAAgB,YACtB,UAAU,YAAY,UAEtB,SAAS,QAAQ,WACjB,SAAS,SACT,SAAS,UAAU,mBAAmB,UAAU,qBAAqB,SAAS,QAAQ,WACtF,SAAS,iBAAiB,QAAQ,UAAU,qBAAqB,cAAc,YAC9E,QAAQ;SAEJ,OAAO,iBAAiB,kBAAkB,gBAAgB,YAC/D,SAAS,QAAQ,WACjB,SAAS,SACT,SAAS,UAAU,mBAAmB,UAAU,qBAAqB,UACrE,sBACC,QAAQ;;;kBA4DY;;OAEX,QACV,mBACA,qBAAqB,aAAa,qBAClC,qBACE,iBAAiB,SAAS,cAAc;;OAGhC,QAAQ;aACT,OAAO;;;OAIN,eAAe,WAAW,YAAY;;OAGtC,QAAQ,aAAa,aAAa,UAAU,sBAAsB,iBAC5E,GACA,GACA;;OAIU,MAAM,gBAAgB,2BAA2B,eAAe,cAAc;;OAG9E,QAAQ,gBAAgB,2BAA2B,eAAe,YAAY;;;;;cC5H/E,oCAAoC;EACnC,YAAA"}
+{"version":3,"file":"web.d.mts","names":[],"sources":["../src/web/web-effect.ts","../src/web/responses.ts"],"mappings":";;;;;cA6Va;UACJ;;;;;;;;SASA,WACL,iBAAiB,kBACX,gBAAgB,YACtB,qBAAqB,YACrB,UAAU,YAAY,UAEtB,UAAU,gBAAgB,WAC1B,SAAS,SACT,SAAS,SACT,SAAS,iBAAiB,QAAQ,UAAU,cAAc,cAAc;aAC7D,eAAe,SAAS,YAAY;MAC3C,sBAAsB,UAAU,gBAClC,iBAAiB,UAAU,cAAc,SAAS,QAAQ,YAC3D,QAAQ;SAEJ,WACL,iBAAiB,kBACX,gBAAgB,YACtB,UAAU,YAAY,UAEtB,UAAU,gBAAgB,WAC1B,SAAS,SACT,SAAS,UAAU,mBAAmB,UAAU,qBAAqB,SAAS,QAAQ,WACtF,SAAS,iBAAiB,QAAQ,UAAU,qBAAqB,cAAc,YAC9E,QAAQ;SAEJ,WAAW,iBAAiB,kBAAkB,gBAAgB,YACnE,UAAU,gBAAgB,WAC1B,SAAS,SACT,SAAS,UAAU,mBAAmB,UAAU,qBAAqB,UACrE,sBACC,QAAQ;SA0DJ,WACL,iBAAiB,kBACX,gBAAgB,YACtB,qBAAqB,YACrB,UAAU,YAAY,UAEtB,UAAU,gBAAgB,WAC1B,SAAS,SACT,SAAS,SACT,SAAS,uBAAuB,QAAQ,UAAU;aACvC,eAAe,SAAS,YAAY;MAC3C,sBAAsB,UAAU,gBAClC,uBAAuB,UAAU,cAAc,SAAS,QAAQ,YACjE,QAAQ;SAEJ,WACL,iBAAiB,kBACX,gBAAgB,YACtB,UAAU,YAAY,UAEtB,UAAU,gBAAgB,WAC1B,SAAS,SACT,SAAS,UACP,yBAAyB,UAAU,qBAAqB,SAAS,QAAQ,WAC3E,UAAU,uBAAuB,QAAQ,UAAU,uBAClD,QAAQ;;;kBAyEY;;OAEX,QACV,mBACA,qBAAqB,aAAa,qBAClC,qBACE,iBAAiB,SAAS,cAAc;;OAGhC,QAAQ;aACT,OAAO;;;OAIN,eAAe,WAAW,YAAY;;OAGtC,QAAQ,aAAa,aAAa,UAAU,sBAAsB,iBAC5E,GACA,GACA;;OAIU,MAAM,gBAAgB,2BAA2B,eAAe,cAAc;;OAG9E,QAAQ,gBAAgB,2BAA2B,eAAe,YAAY;;OAG9E,SAAS;;OAGT,gBAAgB;;OAGhB,cACV,mBACA,qBAAqB,aAAa,uBAChC,uBAAuB,SAAS;;;;;cCniBzB,oCAAoC;EAC/C,YAAY"}

package/dist/web.mjs

@@ -1,2 +1,2 @@
-import { n as WebEffectSerializationError, t as WebEffect } from "./web-Bq3MfMrj.mjs";
+import { i as WebEffectSerializationError, t as WebEffect } from "./web-effect-B9hp9jIe.mjs";
 export { WebEffect, WebEffectSerializationError };