svelte-effect-runtime 3.4.11 → 4.0.1

package/.dist/server.js

@@ -1,145 +1,108 @@
-import { C as UncheckedLiveQueryHandlerMissingError, S as UncheckedFormHandlerMissingError, T as UncheckedQueryHandlerMissingError, c as InvalidLiveQueryReturnError, i as BatchQueryHandlerMissingError, w as UncheckedPrerenderHandlerMissingError, x as UncheckedCommandHandlerMissingError } from "./chunks/errors-Dcf0MVbq.js";
-import { create_form_error } from "./remote/shared.js";
-import { t as copy_property_descriptors } from "./chunks/descriptors-cOe9uRJz.js";
-import { normalize_remote_helper_error, run_remote_effect } from "./remote/server.js";
-import { i as get_server_runtime_or_throw, n as ServerRuntime, t as RequestEvent } from "./chunks/runtime-ekkMQ-wL.js";
-import { Effect, Schema, Stream } from "effect";
+import { D as UncheckedPrerenderHandlerMissingError, E as UncheckedLiveQueryHandlerMissingError, O as UncheckedQueryHandlerMissingError, T as UncheckedFormHandlerMissingError, i as BatchQueryHandlerMissingError, l as InvalidLiveQueryReturnError, w as UncheckedCommandHandlerMissingError } from "./chunks/errors-CLsbGjIa.js";
+import { create_form_error, create_remote_transport_error } from "./remote/shared.js";
+import { i as make_remote_live_stream, r as make_failed_remote_live_stream, t as Live } from "./chunks/live-BundLSoY.js";
+import { a as normalize_validator, c as attach_remote_resource_getters, d as MakeEffectFromPromise, f as MakeEffectFromSync, l as is_remote_resource, n as attach_native_remote_query_update, o as attach_failed_remote_query_resource, r as resolve_native_remote_query_updates, s as attach_failed_remote_resource_getters, t as copy_property_descriptors, u as FailWithRemoteError } from "./chunks/descriptors-B4otDlm1.js";
+import { i as throw_remote_cause, n as run_remote_effect, t as normalize_remote_helper_error } from "./chunks/server-BNrA1I-u.js";
+import { i as get_server_runtime_or_throw, n as ServerRuntime, t as RequestEvent } from "./chunks/runtime-HDTlEnzp.js";
+import { Effect, Result, Stream } from "effect";
 import { error, invalid, redirect } from "@sveltejs/kit";
+import { stringify } from "devalue";
 import { command, form, getRequestEvent, prerender, query } from "$app/server";
-//#region src/server/schema.ts
-/**
-* Checks whether a value is the string sentinel for unchecked remotes.
-*
-* @since 2.0.0
-* @param value - Value to inspect.
-* @returns Whether the value is `"unchecked"`.
-*/
-function is_unchecked(value) {
-	return value === "unchecked";
-}
-/**
-* Checks whether a value is a remote handler function.
-*
-* @since 2.0.0
-* @param value - Value to inspect.
-* @returns Whether the value is callable as a handler.
-*/
-function is_handler(value) {
-	return typeof value === "function";
-}
-/**
-* Checks whether a value implements the Standard Schema contract.
-*
-* @since 2.0.0
-* @param value - Value to inspect.
-* @returns Whether the value is a Standard Schema.
-*/
-function is_standard_schema(value) {
-	return typeof value === "object" && value !== null && "~standard" in value;
-}
-/**
-* Checks whether a value looks like an Effect Schema.
-*
-* @since 2.0.0
-* @param value - Value to inspect.
-* @returns Whether the value should be converted to Standard Schema.
-*/
-function is_effect_schema(value) {
-	return typeof value === "object" && value !== null && "ast" in value && "make" in value;
-}
-/**
-* Converts Effect Schema inputs to Standard Schema for SvelteKit.
-*
-* @since 2.0.0
-* @param value - Schema or handler input.
-* @returns Original value or Standard Schema view of an Effect Schema.
-*/
-function normalize_validator(value) {
-	if (is_standard_schema(value) || !is_effect_schema(value)) return value;
-	return Schema.toStandardSchemaV1(value);
+import * as SvelteKitInternalServer from "@sveltejs/kit/internal/server";
+//#region src/server/remote-handler-context.ts
+const active_remote_handler_counts = /* @__PURE__ */ new WeakMap();
+/** Tracks ownership per request event so concurrent requests remain isolated. */
+function is_running_remote_effect_handler(event) {
+	const request_event = event ?? get_current_request_event();
+	if (!request_event) return false;
+	return (active_remote_handler_counts.get(request_event) ?? 0) > 0;
+}
+/** Marks one request as handler-owned for the lifetime of the supplied Effect. */
+const RunInsideRemoteEffectHandler = (event, effect) => Effect.acquireUseRelease(AcquireRemoteHandlerOwnership(event), () => effect, () => ReleaseRemoteHandlerOwnership(event));
+const AcquireRemoteHandlerOwnership = (event) => Effect.sync(() => {
+	const active_count = active_remote_handler_counts.get(event) ?? 0;
+	active_remote_handler_counts.set(event, active_count + 1);
+});
+const ReleaseRemoteHandlerOwnership = (event) => Effect.sync(() => {
+	const remaining_count = (active_remote_handler_counts.get(event) ?? 1) - 1;
+	if (remaining_count === 0) {
+		active_remote_handler_counts.delete(event);
+		return;
+	}
+	active_remote_handler_counts.set(event, remaining_count);
+});
+function get_current_request_event() {
+	try {
+		const event = getRequestEvent();
+		return typeof event === "object" && event !== null ? event : void 0;
+	} catch {
+		return;
+	}
 }
 //#endregion
 //#region src/server/effects.ts
-/**
-* Checks whether a value is an Effect generator return object.
-*
-* @since 2.0.0
-* @param value - Value to inspect.
-* @returns Whether the value should be wrapped with `Effect.gen`.
-*/
 function is_generator_result(value) {
 	return typeof value === "object" && value !== null && typeof value.next === "function";
 }
-/**
-* Normalizes an Effect-like handler return value into an Effect.
-*
-* @since 2.0.0
-* @param value - Effect or generator return value.
-* @returns Normalized Effect.
-*/
 function ToEffect(value) {
 	if (is_generator_result(value)) return Effect.gen(() => value);
 	return value;
 }
-/**
-* Checks whether a value is a live query source SvelteKit can consume.
-*
-* @since 2.0.0
-* @param value - Value to inspect.
-* @returns Whether the value is an Effect Stream or native iterable source.
-*/
 function is_live_source(value) {
-	if (Stream.isStream(value)) return true;
-	if (typeof value !== "object" || value === null) return false;
-	const source = value;
-	return typeof source.next === "function" || typeof source[Symbol.asyncIterator] === "function" || typeof source[Symbol.iterator] === "function";
+	return Stream.isStream(value);
 }
-/**
-* Runs and normalizes a live query handler result with request services
-* available to Effect Streams.
-*
-* @since 2.0.0
-* @param value - Live query source or Effect that resolves to one.
-* @param event - SvelteKit request event for this remote call.
-* @returns Promise resolving with a source SvelteKit can stream.
-*/
-function run_live_handler_source(value, event) {
-	const runtime = get_server_runtime_or_throw();
-	return run_remote_effect(Effect.provideService(ToLiveSourceEffect(value), RequestEvent, event), runtime, invalid, svelte_remote_error);
+/** Runs a live handler inside the request-local ownership scope. */
+function run_live_handler(handler, event) {
+	return run_live_source_effect(RunInsideRemoteEffectHandler(event, Effect.suspend(() => {
+		const value = handler();
+		if (!is_live_source(value)) return Effect.die(new InvalidLiveQueryReturnError());
+		return ToLiveSourceEffect(value, event);
+	})), event);
 }
-function ToLiveSourceEffect(value) {
-	if (Stream.isStream(value)) return Stream.toAsyncIterableEffect(value);
-	if (is_native_live_source(value)) return Effect.succeed(value);
-	if (!Effect.isEffect(value)) return Effect.fail(new InvalidLiveQueryReturnError());
-	return Effect.flatMap(value, ToLiveSourceEffect);
+function run_live_source_effect(effect, event) {
+	const runtime = get_server_runtime_or_throw();
+	return run_remote_effect(Effect.provideService(effect, RequestEvent, event), runtime, invalid, svelte_remote_error);
+}
+const ToLiveSourceEffect = (value, event) => Stream.toAsyncIterableEffect(preserve_live_source_cause(value)).pipe(Effect.map((source) => wrap_live_source_errors(source, event)));
+const preserve_live_source_cause = (value) => value.pipe(Stream.catchCause((cause) => Stream.fromEffect(Effect.sync(() => throw_remote_cause(cause, invalid, svelte_remote_error)))));
+function wrap_live_source_errors(source, event) {
+	return { [Symbol.asyncIterator]() {
+		const iterator = source[Symbol.asyncIterator]();
+		const throw_iterator = iterator.throw?.bind(iterator);
+		return {
+			next() {
+				return RunLiveIteratorCall(event, () => iterator.next());
+			},
+			return(value) {
+				if (iterator.return) return RunLiveIteratorCall(event, () => iterator.return?.(value));
+				return Promise.resolve({
+					done: true,
+					value: void 0
+				});
+			},
+			...throw_iterator === void 0 ? {} : { throw(error) {
+				return RunLiveIteratorCall(event, () => throw_iterator(error));
+			} }
+		};
+	} };
 }
-function is_native_live_source(value) {
-	return is_live_source(value) && !Stream.isStream(value);
+function RunLiveIteratorCall(event, run) {
+	const runtime = get_server_runtime_or_throw();
+	const IteratorEffect = Effect.tryPromise({
+		try: run,
+		catch: (error) => error
+	});
+	return runtime.runPromise(RunInsideRemoteEffectHandler(event, IteratorEffect));
 }
-/**
-* Runs a remote handler Effect with the current request event provided.
-*
-* @since 2.0.0
-* @param value - Handler return value.
-* @param event - SvelteKit request event for this remote call.
-* @returns Promise resolving with the handler output.
-*/
 function run_handler_effect(value, event) {
 	const runtime = get_server_runtime_or_throw();
-	return run_remote_effect(Effect.provideService(ToEffect(value), RequestEvent, event), runtime, invalid, svelte_remote_error);
+	return run_remote_effect(Effect.provideService(RunInsideRemoteEffectHandler(event, ToEffect(value)), RequestEvent, event), runtime, invalid, svelte_remote_error);
 }
 const svelte_remote_error = (status, body) => {
 	error(status, body);
 };
 //#endregion
 //#region src/server/invalid.ts
-/**
-* Creates a path-aware proxy for remote form validation failures.
-*
-* @since 2.0.0
-* @param path - Current nested form path.
-* @returns Callable invalid proxy for this path.
-*/
 function make_invalid_proxy(path = []) {
 	const invalid_at_path = (message) => Effect.fail(create_form_error([{
 		message,
@@ -147,37 +110,33 @@ function make_invalid_proxy(path = []) {
 	}]));
 	return new Proxy(invalid_at_path, { get(_target, property) {
 		if (typeof property === "symbol") return;
-		return make_invalid_proxy([...path, property]);
+		const segment = path.length === 0 ? property : normalize_nested_path_segment(property);
+		return make_invalid_proxy([...path, segment]);
 	} });
 }
+function normalize_nested_path_segment(property) {
+	return /^(0|[1-9]\d*)$/.test(property) ? Number(property) : property;
+}
+//#endregion
+//#region src/server/schema.ts
+function is_unchecked(value) {
+	return value === "unchecked";
+}
+function is_handler(value) {
+	return typeof value === "function";
+}
 //#endregion
 //#region src/server/wrappers.ts
-let running_remote_effect_handlers = 0;
-/**
-* Reports whether SER is currently executing user remote handler code.
-*
-* @example
-* ```ts
-* if (is_running_remote_effect_handler()) {
-*   return query();
-* }
-* ```
-*
-* @since 2.0.0
-* @returns Whether a remote handler wrapper is currently active.
-* @internal
-*/
-function is_running_remote_effect_handler() {
-	return running_remote_effect_handlers > 0;
+function make_prerender_inputs_wrapper(generate_inputs) {
+	return () => {
+		const runtime = get_server_runtime_or_throw();
+		const CollectInputs = Effect.gen(function* () {
+			const inputs = yield* Effect.suspend(() => ToEffect(generate_inputs()));
+			return Array.from(inputs);
+		});
+		return runtime.runPromise(CollectInputs);
+	};
 }
-/**
-* Builds the wrapper passed to native query, command, and prerender helpers.
-*
-* @since 2.0.0
-* @param handler - Effect handler or already-built Effect-like value.
-* @param helper_name - Remote helper name for error normalization.
-* @returns Native SvelteKit handler wrapper.
-*/
 function make_remote_wrapper(handler, helper_name) {
 	return async (input) => {
 		let event;
@@ -186,23 +145,11 @@ function make_remote_wrapper(handler, helper_name) {
 		} catch (error) {
 			throw normalize_remote_helper_error(error, helper_name);
 		}
-		return await run_inside_remote_effect_handler(() => {
-			try {
-				return run_handler_effect(is_handler(handler) ? handler(input) : handler, event);
-			} catch (error) {
-				throw normalize_remote_helper_error(error, helper_name);
-			}
-		});
+		return await run_handler_effect(Effect.suspend(() => {
+			return ToEffect(is_handler(handler) ? handler(input) : handler);
+		}), event);
 	};
 }
-/**
-* Builds the wrapper passed to native live query helpers.
-*
-* @since 2.0.0
-* @param handler - Effect-aware live source handler.
-* @param helper_name - Remote helper name for error normalization.
-* @returns Native SvelteKit live query wrapper.
-*/
 function make_remote_live_wrapper(handler, helper_name) {
 	return async (input) => {
 		let event;
@@ -211,23 +158,9 @@ function make_remote_live_wrapper(handler, helper_name) {
 		} catch (error) {
 			throw normalize_remote_helper_error(error, helper_name);
 		}
-		return await run_inside_remote_effect_handler(() => {
-			try {
-				return run_live_handler_source(typeof handler === "function" ? handler(input) : handler, event);
-			} catch (error) {
-				throw normalize_remote_helper_error(error, helper_name);
-			}
-		});
+		return await run_live_handler(() => typeof handler === "function" ? handler(input) : handler, event);
 	};
 }
-/**
-* Builds the wrapper passed to native form helpers.
-*
-* @since 2.0.0
-* @param handler - Effect-aware form handler.
-* @param helper_name - Remote helper name for error normalization.
-* @returns Native SvelteKit form handler wrapper.
-*/
 function make_remote_form_wrapper(handler, helper_name) {
 	return async (data, issue) => {
 		let event;
@@ -236,50 +169,102 @@ function make_remote_form_wrapper(handler, helper_name) {
 		} catch (error) {
 			throw normalize_remote_helper_error(error, helper_name);
 		}
-		return await run_inside_remote_effect_handler(() => {
-			const invalid_proxy = make_invalid_proxy();
-			try {
-				return run_handler_effect(handler({
-					data,
-					invalid: invalid_proxy,
-					issue
-				}), event);
-			} catch (error) {
-				throw normalize_remote_helper_error(error, helper_name);
-			}
-		});
+		return await run_handler_effect(Effect.suspend(() => {
+			return ToEffect(handler({
+				data,
+				invalid: make_invalid_proxy(),
+				issue
+			}));
+		}), event);
 	};
 }
-async function run_inside_remote_effect_handler(run) {
-	running_remote_effect_handlers += 1;
-	try {
-		return await run();
-	} finally {
-		running_remote_effect_handlers -= 1;
-	}
+//#endregion
+//#region src/server/live-snapshot.ts
+/** Converts SvelteKit transport hooks into a devalue live snapshot encoder. */
+function make_remote_live_snapshot_encoder(transport) {
+	const encoders = Object.fromEntries(Object.entries(transport).map(([key, transformer]) => [key, transformer.encode]));
+	return (value) => stringify(value, encoders);
+}
+//#endregion
+//#region src/server/transport.ts
+/** Creates the current SvelteKit request's transport-aware live snapshot encoder. */
+function get_remote_live_snapshot_encoder() {
+	const try_get_request_store = SvelteKitInternalServer.try_get_request_store;
+	const request_store = try_get_request_store?.();
+	if (!request_store) return;
+	return make_remote_live_snapshot_encoder(request_store.state.transport);
 }
 //#endregion
 //#region src/server/factories.ts
 const request_event_context_error_start = "Can only read the current request event inside functions invoked during `handle`";
 const request_store_context_error = "Could not get the request store.";
-function to_effect_query(native) {
+function to_effect_query(native, mode = "standard") {
+	return to_effect_remote_resource(native, attach_query_resource_methods, attach_failed_remote_query_resource, mode);
+}
+function to_effect_prerender(native) {
+	return to_effect_remote_resource(native, attach_remote_resource_getters, attach_failed_remote_resource_getters);
+}
+function to_effect_command(native) {
 	const wrapped = ((input) => {
 		if (is_current_remote_request()) return native(input);
-		const resource = native(input);
-		const effect = Effect.tryPromise({
-			try: () => Promise.resolve(resource),
-			catch: (error) => error
+		return MakeServerCommandEffect(native, input);
+	});
+	copy_property_descriptors(native, wrapped);
+	return wrapped;
+}
+const MakeServerCommandEffect = (native, input) => {
+	let updates_args;
+	const CommandEffect = Effect.gen(function* () {
+		const invocation = yield* MakeEffectFromSync(() => {
+			const result = native(input);
+			if (updates_args && has_command_updates(result)) return result.updates(...resolve_native_remote_query_updates(updates_args));
+			return result;
 		});
-		attach_query_resource_methods(resource, effect);
-		return effect;
+		return yield* MakeEffectFromPromise(() => Promise.resolve(invocation));
+	});
+	Object.defineProperty(CommandEffect, "updates", {
+		configurable: true,
+		enumerable: false,
+		value: (...args) => {
+			updates_args ??= args;
+			return CommandEffect;
+		}
+	});
+	return CommandEffect;
+};
+function has_command_updates(value) {
+	const value_type = typeof value;
+	return (value_type === "object" && value !== null || value_type === "function") && typeof value.updates === "function";
+}
+function to_effect_remote_resource(native, attach_resource, attach_failed_resource, mode = "standard") {
+	const wrapped = ((input) => {
+		if (is_current_remote_request()) return native(input);
+		const resource_attempt = Result.try(() => native(input));
+		if (Result.isFailure(resource_attempt)) {
+			const ResourceEffect = FailWithRemoteError(resource_attempt.failure);
+			attach_failed_resource(resource_attempt.failure, ResourceEffect);
+			return ResourceEffect;
+		}
+		const resource = resource_attempt.success;
+		const started_result = mode === "batch" ? begin_batch_resource(resource) : void 0;
+		const ResourceEffect = MakeEffectFromPromise(() => started_result ?? Promise.resolve(resource));
+		attach_native_remote_query_update(ResourceEffect, resource);
+		attach_resource(resource, ResourceEffect);
+		return ResourceEffect;
 	});
 	copy_property_descriptors(native, wrapped);
+	attach_native_remote_query_update(wrapped, native);
 	return wrapped;
 }
+function begin_batch_resource(resource) {
+	const result = Promise.resolve(resource);
+	result.catch(() => {});
+	return result;
+}
 function is_current_remote_request() {
-	if (is_running_remote_effect_handler()) return false;
 	const detection = detect_current_remote_request();
 	if (detection._tag === "NoCurrentRemoteRequest") return false;
+	if (is_running_remote_effect_handler(detection.event)) return false;
 	return detection.event.isRemoteRequest === true;
 }
 function detect_current_remote_request() {
@@ -299,43 +284,20 @@ function is_request_event_context_error(error) {
 }
 function to_effect_live_query(native) {
 	const wrapped = ((input) => {
-		return Effect.try({
-			try: () => {
-				return make_live_resource(native(input));
-			},
-			catch: (error) => error
-		});
+		const snapshot_encoder = get_remote_live_snapshot_encoder();
+		const resource_attempt = Result.try(() => native(input));
+		if (Result.isFailure(resource_attempt)) return make_failed_remote_live_stream(resource_attempt.failure, create_remote_transport_error);
+		const resource = resource_attempt.success;
+		const stream = make_remote_live_stream(resource, create_remote_transport_error, snapshot_encoder);
+		attach_native_remote_query_update(stream, resource);
+		return stream;
 	});
 	copy_property_descriptors(native, wrapped);
+	attach_native_remote_query_update(wrapped, native);
 	return wrapped;
 }
-function is_query_resource(resource) {
-	const resource_type = typeof resource;
-	return resource_type === "object" && resource !== null || resource_type === "function";
-}
-function is_live_resource(resource) {
-	const resource_type = typeof resource;
-	return resource_type === "object" && resource !== null || resource_type === "function";
-}
-function attach_remote_resource_getters(resource, effect) {
-	const methods = is_query_resource(resource) ? resource : void 0;
-	const keys = [
-		"current",
-		"error",
-		"loading",
-		"ready"
-	];
-	if (!methods) return;
-	for (const key of keys) {
-		if (!(key in methods)) continue;
-		Object.defineProperty(effect, key, {
-			configurable: true,
-			get: () => methods[key]
-		});
-	}
-}
 function attach_query_resource_methods(resource, effect) {
-	const methods = is_query_resource(resource) ? resource : void 0;
+	const methods = is_remote_resource(resource) ? resource : void 0;
 	const refresh = methods?.refresh;
 	const set = methods?.set;
 	const with_override = methods?.withOverride;
@@ -343,10 +305,7 @@ function attach_query_resource_methods(resource, effect) {
 	if (!methods) return;
 	if (typeof refresh === "function") Object.defineProperty(effect, "refresh", {
 		configurable: true,
-		value: () => Effect.tryPromise({
-			try: () => Promise.resolve(refresh.call(resource)),
-			catch: (error) => error
-		})
+		value: () => MakeEffectFromPromise(() => Promise.resolve(refresh.call(resource)))
 	});
 	if (typeof set === "function") Object.defineProperty(effect, "set", {
 		configurable: true,
@@ -357,42 +316,12 @@ function attach_query_resource_methods(resource, effect) {
 		value: (update) => with_override.call(resource, update)
 	});
 }
-function attach_live_resource_methods(resource, effect) {
-	const methods = is_live_resource(resource) ? resource : void 0;
-	const reconnect = methods?.reconnect;
-	const async_iterator = methods?.[Symbol.asyncIterator];
-	const keys = [
-		"connected",
-		"current",
-		"done",
-		"error",
-		"loading",
-		"ready"
-	];
-	if (!methods) return;
-	for (const key of keys) {
-		if (!(key in methods)) continue;
-		Object.defineProperty(effect, key, {
-			configurable: true,
-			get: () => methods[key]
-		});
-	}
-	if (typeof reconnect === "function") Object.defineProperty(effect, "reconnect", {
-		configurable: true,
-		value: () => Effect.tryPromise({
-			try: () => Promise.resolve(reconnect.call(resource)),
-			catch: (error) => error
-		})
-	});
-	if (typeof async_iterator === "function") Object.defineProperty(effect, Symbol.asyncIterator, {
-		configurable: true,
-		value: () => async_iterator.call(resource)
-	});
-}
-function make_live_resource(resource) {
-	const live_resource = {};
-	attach_live_resource_methods(resource, live_resource);
-	return live_resource;
+function normalize_prerender_options(options) {
+	if (!options) return;
+	return {
+		dynamic: options.dynamic,
+		inputs: options.inputs ? make_prerender_inputs_wrapper(options.inputs) : void 0
+	};
 }
 function QueryRoot(validate_or_handler, maybe_handler) {
 	try {
@@ -406,7 +335,7 @@ function QueryRoot(validate_or_handler, maybe_handler) {
 function QueryBatch(validate_or_handler, maybe_handler) {
 	try {
 		if (!maybe_handler) throw new BatchQueryHandlerMissingError();
-		return to_effect_query(query.batch(normalize_validator(validate_or_handler), make_remote_wrapper(maybe_handler, "Query.batch")));
+		return to_effect_query(query.batch(normalize_validator(validate_or_handler), make_remote_wrapper(maybe_handler, "Query.batch")), "batch");
 	} catch (error) {
 		throw normalize_remote_helper_error(error, "Query.batch");
 	}
@@ -442,9 +371,9 @@ const Query = Object.assign(QueryRoot, {
 });
 function Command(validate_or_handler, maybe_handler) {
 	try {
-		if (maybe_handler) return command(normalize_validator(validate_or_handler), make_remote_wrapper(maybe_handler, "Command"));
+		if (maybe_handler) return to_effect_command(command(normalize_validator(validate_or_handler), make_remote_wrapper(maybe_handler, "Command")));
 		if (is_unchecked(validate_or_handler)) throw new UncheckedCommandHandlerMissingError();
-		return command(make_remote_wrapper(validate_or_handler, "Command"));
+		return to_effect_command(command(make_remote_wrapper(validate_or_handler, "Command")));
 	} catch (error) {
 		throw normalize_remote_helper_error(error, "Command");
 	}
@@ -466,16 +395,63 @@ function Form(validate_or_handler, maybe_handler) {
 		throw normalize_remote_helper_error(error, "Form");
 	}
 }
-function Prerender(validate_or_handler, maybe_handler_or_options, maybe_options) {
+function Prerender(validate_or_handler, maybe_handler_or_options, maybe_options, native_factory = prerender) {
 	try {
-		if (is_handler(maybe_handler_or_options)) return prerender(normalize_validator(validate_or_handler), make_remote_wrapper(maybe_handler_or_options, "Prerender"), maybe_options);
+		if (is_handler(maybe_handler_or_options)) return to_effect_prerender(native_factory(normalize_validator(validate_or_handler), make_remote_wrapper(maybe_handler_or_options, "Prerender"), normalize_prerender_options(maybe_options)));
 		if (is_unchecked(validate_or_handler)) throw new UncheckedPrerenderHandlerMissingError();
-		return prerender(make_remote_wrapper(validate_or_handler, "Prerender"), maybe_handler_or_options);
+		return to_effect_prerender(native_factory(make_remote_wrapper(validate_or_handler, "Prerender"), normalize_prerender_options(maybe_handler_or_options)));
 	} catch (error) {
 		throw normalize_remote_helper_error(error, "Prerender");
 	}
 }
 //#endregion
+//#region src/server/handler.ts
+/**
+* Adapts an Effect-producing callback to a native SvelteKit server handler.
+* SvelteKit continues to select the handler by its exported binding name, such
+* as `GET`, `PUT`, or `load`.
+*
+* @example A `+server.ts` request handler:
+* ```ts
+* import { Handler } from "svelte-effect-runtime/server";
+* import type { RequestHandler } from "./$types";
+*
+* export const GET = Handler<RequestHandler>(function* ({ params }) {
+*   const post = yield* Posts.get(params.slug);
+*
+*   return Response.json(post);
+* });
+* ```
+*
+* @example A `+page.server.ts` load function:
+* ```ts
+* import { Handler } from "svelte-effect-runtime/server";
+* import type { PageServerLoad } from "./$types";
+*
+* export const load = Handler<PageServerLoad>(function* ({ locals }) {
+*   const profile = yield* Profiles.get(locals.user.id);
+*
+*   return { profile };
+* });
+* ```
+*
+* @since 4.0.0
+* @param handler - Effect-producing callback whose parameters and successful
+*   result match the native SvelteKit handler type.
+* @returns A native handler that runs the callback through the configured
+*   {@link ServerRuntime} with the current {@link RequestEvent} available.
+*/
+function Handler(handler) {
+	const native_handler = async (...arguments_) => {
+		const event = getRequestEvent();
+		const runtime = get_server_runtime_or_throw();
+		const HandlerOwnedEffect = RunInsideRemoteEffectHandler(event, Effect.suspend(() => ToEffect(handler(...arguments_))));
+		const EffectWithRequestEvent = Effect.provideService(HandlerOwnedEffect, RequestEvent, event);
+		return await runtime.runPromise(EffectWithRequestEvent, { signal: event.request.signal });
+	};
+	return native_handler;
+}
+//#endregion
 //#region src/server/control-flow.ts
 const error_status_codes = {
 	ProxyAuthenticationRequired: 407,
@@ -589,6 +565,6 @@ function resolve_redirect_status(status) {
 	return redirect_status_codes[status];
 }
 //#endregion
-export { Command, Error$1 as Error, Form, Prerender, Query, Redirect, RequestEvent, ServerRuntime, get_server_runtime_or_throw };
+export { Command, Error$1 as Error, Form, Handler, Live, Prerender, Query, Redirect, RequestEvent, ServerRuntime, get_server_runtime_or_throw };
 
 //# sourceMappingURL=server.js.map