svelte-effect-runtime 4.0.0 → 4.1.0

package/.dist/remote/server.d.ts

@@ -1,59 +1,14 @@
 import type { FormIssue } from "./shared.js";
-import { Effect } from "effect";
+import { Cause, Effect } from "effect";
 type SvelteInvalid = (...issues: readonly (FormIssue | string)[]) => never;
 type SvelteError = (status: number, body: unknown) => never;
 export { encode_remote_failure } from "./cause-codec.js";
-/**
- * Runs a user-supplied Effect program through a ManagedRuntime, maps its
- * exit into the shape expected by SvelteKit, and returns the result or
- * throws a SvelteKit-compatible error.
- *
- * @since 2.0.0
- * @param effect - The Effect program to execute.
- * @param runtime - The server-side ManagedRuntime.
- * @param invalid - SvelteKit's `invalid` helper (bound per-request).
- * @param error - SvelteKit's `error` helper.
- * @returns A Promise that resolves with the effect's success value.
- * @internal
- */
+/** Maps a remote Effect exit into the control flow expected by SvelteKit. */
 export declare function run_remote_effect<A>(effect: Effect.Effect<A, unknown, unknown>, runtime: {
     runPromise: (e: Effect.Effect<unknown, unknown, unknown>) => Promise<unknown>;
 }, invalid: SvelteInvalid, error: SvelteError): Promise<A>;
-/**
- * Throws a SvelteKit `invalid` response from a {@link FormError}, calling
- * through to the request-scoped `invalid` helper.
- *
- * @example
- * ```ts
- * throw_form_error(
- *   [{ message: "Name is required", path: ["name"] }],
- *   invalid,
- * );
- * ```
- *
- * @since 2.0.0
- * @param issues - The list of form validation issues.
- * @param invalid - SvelteKit's `invalid` helper bound to the current request.
- * @internal
- */
+/** Applies a classified remote Cause decision to SvelteKit's server helpers. */
+export declare function throw_remote_cause(cause: Cause.Cause<unknown>, invalid: SvelteInvalid, error: SvelteError): never;
 export declare function throw_form_error(issues: readonly FormIssue[], invalid: SvelteInvalid): never;
-/**
- * Remaps SvelteKit's unbranded request-context errors into clear, actionable
- * messages.
- *
- * @example
- * ```ts
- * try {
- *   return native_query(handler);
- * } catch (err) {
- *   throw normalize_remote_helper_error(err, "Query");
- * }
- * ```
- *
- * @since 2.0.0
- * @param err - The error thrown by SvelteKit's native functions.
- * @param helper_name - Name of the helper that triggered the error.
- * @returns A more descriptive error.
- * @internal
- */
+/** Rebrands SvelteKit context failures with the remote helper that triggered them. */
 export declare function normalize_remote_helper_error(err: unknown, helper_name: string): Error;

package/.dist/remote/server.js

@@ -1,2 +1,2 @@
-import { i as encode_remote_failure, n as run_remote_effect, r as throw_form_error, t as normalize_remote_helper_error } from "../chunks/server-D1LcDnZE.js";
-export { encode_remote_failure, normalize_remote_helper_error, run_remote_effect, throw_form_error };
+import { a as encode_remote_failure, i as throw_remote_cause, n as run_remote_effect, r as throw_form_error, t as normalize_remote_helper_error } from "../chunks/server-yQrNoiCR.js";
+export { encode_remote_failure, normalize_remote_helper_error, run_remote_effect, throw_form_error, throw_remote_cause };

package/.dist/remote/shared.d.ts

@@ -1,39 +1,8 @@
-/**
- * Shared types, markers, and constructors used by both the client-side remote
- * adapters and the server-side handler runtime. These types define the error
- * protocol that flows across the network boundary.
- *
- * @since 2.0.0
- */
-/**
- * Well-known marker injected into every serialised remote-failure envelope
- * so the client can reliably distinguish runtime errors from domain values.
- *
- * @example
- * ```ts
- * if (envelope[EFFECT_REMOTE_ERROR_MARKER] === true) {
- *   console.log(envelope.encoded);
- * }
- * ```
- *
- * @since 2.0.0
- * @internal
- */
-export declare const EFFECT_REMOTE_ERROR_MARKER = "__svelte_effect_remote__";
-/**
- * Well-known symbol used to attach a payload decoder to a remote function
- * so the client's transport layer can decode domain error types.
- *
- * @example
- * ```ts
- * Reflect.get(remote_function, REMOTE_ERROR_DECODER);
- * ```
- *
- * @since 2.0.0
- * @internal
- */
-export declare const REMOTE_ERROR_DECODER: unique symbol;
-/** Form validation helpers and types. */
+/** Remote error wire protocol shared by client and server adapters. */
+/** Shared marker used to recognize remote errors across package copies. */
+export declare const effect_remote_error_marker = "__svelte_effect_remote__";
+/** Decodes the shared remote-error marker without relying on class identity. */
+export declare const remote_error_decoder: unique symbol;
 /**
  * A single field-level or form-level validation issue reported by a
  * {@link Form} handler.
@@ -75,20 +44,6 @@ export interface FormError<SchemaType = unknown> {
     /** Phantom type slot for the schema this error was derived from. */
     readonly _schema?: SchemaType;
 }
-/**
- * Creates a {@link FormError} holding the given issues.
- *
- * @example
- * ```ts
- * const error = create_form_error([
- *   { message: "Required.", path: ["email"] },
- * ]);
- * ```
- *
- * @since 2.0.0
- * @param issues - The validation issues to attach.
- * @returns A FormError with the `_tag` set and no schema reference.
- */
 export declare function create_form_error(issues: readonly FormIssue[]): FormError;
 /**
  * Type guard that narrows an unknown value to a {@link FormError}.
@@ -105,15 +60,13 @@ export declare function create_form_error(issues: readonly FormIssue[]): FormErr
  * @returns `true` when the value is a FormError.
  */
 export declare function is_form_error(value: unknown): value is FormError;
-/** Remote error types shared by client and server helpers. */
 /**
  * Union of all wire-level error shapes that a remote function can
  * surface on its error channel.
  *
  * @example
  * ```ts
- * const result = yield* myQuery();
- * // error channel is RemoteFailure<DomainError>
+ * const result: Effect.Effect<User, RemoteFailure<DomainError>> = myQuery();
  * ```
  *
  * @since 2.0.0
@@ -180,106 +133,14 @@ export interface RemoteTransportError {
     readonly cause?: unknown;
     readonly body?: unknown;
 }
-/**
- * Wire format for an encoded remote failure. The server wraps domain
- * errors in this envelope before serialising them with devalue.
- *
- * @example
- * ```ts
- * const envelope: SerializedRemoteFailureEnvelope = {
- *   __svelte_effect_remote__: true,
- *   encoded: "[\"DomainError\"]",
- * };
- * ```
- *
- * @since 2.0.0
- * @internal
- */
 export interface SerializedRemoteFailureEnvelope {
     readonly __svelte_effect_remote__: true;
     readonly encoded: string;
 }
-/** Constructors for structured remote error values. */
-/**
- * Creates a {@link RemoteValidationError} from a list of form issues.
- *
- * @example
- * ```ts
- * const error = create_remote_validation_error([
- *   { message: "Required.", path: ["email"] },
- * ]);
- * ```
- *
- * @since 2.0.0
- * @param issues - The validation issues reported by the server handler.
- * @param body - Optional response body returned alongside the error.
- * @param status - HTTP status code (defaults to 400).
- * @returns A remote-validation error shape.
- * @internal
- */
 export declare function create_remote_validation_error(issues: readonly FormIssue[], body?: unknown, status?: number): RemoteValidationError;
-/**
- * Creates a {@link RemoteHttpError} for a given HTTP status.
- *
- * @example
- * ```ts
- * const error = create_remote_http_error(404, { message: "Not found" });
- * ```
- *
- * @since 2.0.0
- * @param status - The HTTP status code.
- * @param body - Optional response body.
- * @param cause - Optional underlying cause.
- * @returns A remote HTTP error shape.
- * @internal
- */
 export declare function create_remote_http_error(status: number, body?: unknown, cause?: unknown): RemoteHttpError;
-/**
- * Creates a {@link RemoteTransportError} for network or decode failures.
- *
- * @example
- * ```ts
- * const error = create_remote_transport_error(new Error("Network unavailable"));
- * ```
- *
- * @since 2.0.0
- * @param cause - The underlying error that caused the transport failure.
- * @param body - Optional response body if one was received.
- * @returns A remote transport error shape.
- * @internal
- */
 export declare function create_remote_transport_error(cause: unknown, body?: unknown): RemoteTransportError;
-/**
- * Wraps a devalue-encoded error string inside a
- * {@link SerializedRemoteFailureEnvelope}.
- *
- * @example
- * ```ts
- * const envelope = create_serialized_remote_failure_envelope(encoded);
- * ```
- *
- * @since 2.0.0
- * @param encoded - The devalue-encoded error value.
- * @returns The wire-format envelope.
- * @internal
- */
 export declare function create_serialized_remote_failure_envelope(encoded: string): SerializedRemoteFailureEnvelope;
-/** Type guards for structured remote error values. */
-/**
- * Checks whether a value is a {@link SerializedRemoteFailureEnvelope}.
- *
- * @example
- * ```ts
- * if (is_serialized_remote_failure_envelope(value)) {
- *   console.log(value.encoded);
- * }
- * ```
- *
- * @since 2.0.0
- * @param value - The value to check.
- * @returns `true` when the value is a serialised failure envelope.
- * @internal
- */
 export declare function is_serialized_remote_failure_envelope(value: unknown): value is SerializedRemoteFailureEnvelope;
 /**
  * Checks whether a value is a {@link RemoteValidationError}.

package/.dist/remote/shared.js

@@ -1,54 +1,10 @@
 import { Schema } from "effect";
 //#region src/remote/shared.ts
-/**
-* Shared types, markers, and constructors used by both the client-side remote
-* adapters and the server-side handler runtime. These types define the error
-* protocol that flows across the network boundary.
-*
-* @since 2.0.0
-*/
-/**
-* Well-known marker injected into every serialised remote-failure envelope
-* so the client can reliably distinguish runtime errors from domain values.
-*
-* @example
-* ```ts
-* if (envelope[EFFECT_REMOTE_ERROR_MARKER] === true) {
-*   console.log(envelope.encoded);
-* }
-* ```
-*
-* @since 2.0.0
-* @internal
-*/
-const EFFECT_REMOTE_ERROR_MARKER = "__svelte_effect_remote__";
-/**
-* Well-known symbol used to attach a payload decoder to a remote function
-* so the client's transport layer can decode domain error types.
-*
-* @example
-* ```ts
-* Reflect.get(remote_function, REMOTE_ERROR_DECODER);
-* ```
-*
-* @since 2.0.0
-* @internal
-*/
-const REMOTE_ERROR_DECODER = Symbol.for("svelte-effect-runtime/remote-error-decoder");
-/**
-* Creates a {@link FormError} holding the given issues.
-*
-* @example
-* ```ts
-* const error = create_form_error([
-*   { message: "Required.", path: ["email"] },
-* ]);
-* ```
-*
-* @since 2.0.0
-* @param issues - The validation issues to attach.
-* @returns A FormError with the `_tag` set and no schema reference.
-*/
+/** Remote error wire protocol shared by client and server adapters. */
+/** Shared marker used to recognize remote errors across package copies. */
+const effect_remote_error_marker = "__svelte_effect_remote__";
+/** Decodes the shared remote-error marker without relying on class identity. */
+const remote_error_decoder = Symbol.for("svelte-effect-runtime/remote-error-decoder");
 function create_form_error(issues) {
 	return {
 		_tag: "FormError",
@@ -107,24 +63,6 @@ const is_remote_http_error_value = Schema.is(RemoteHttpErrorSchema);
 const is_remote_transport_error_value = Schema.is(RemoteTransportErrorSchema);
 const is_remote_validation_error_value = Schema.is(RemoteValidationErrorSchema);
 const is_serialized_remote_failure_envelope_value = Schema.is(SerializedRemoteFailureEnvelopeSchema);
-/** Constructors for structured remote error values. */
-/**
-* Creates a {@link RemoteValidationError} from a list of form issues.
-*
-* @example
-* ```ts
-* const error = create_remote_validation_error([
-*   { message: "Required.", path: ["email"] },
-* ]);
-* ```
-*
-* @since 2.0.0
-* @param issues - The validation issues reported by the server handler.
-* @param body - Optional response body returned alongside the error.
-* @param status - HTTP status code (defaults to 400).
-* @returns A remote-validation error shape.
-* @internal
-*/
 function create_remote_validation_error(issues, body, status = 400) {
 	return {
 		_tag: "RemoteValidationError",
@@ -133,21 +71,6 @@ function create_remote_validation_error(issues, body, status = 400) {
 		status
 	};
 }
-/**
-* Creates a {@link RemoteHttpError} for a given HTTP status.
-*
-* @example
-* ```ts
-* const error = create_remote_http_error(404, { message: "Not found" });
-* ```
-*
-* @since 2.0.0
-* @param status - The HTTP status code.
-* @param body - Optional response body.
-* @param cause - Optional underlying cause.
-* @returns A remote HTTP error shape.
-* @internal
-*/
 function create_remote_http_error(status, body, cause) {
 	return {
 		_tag: "RemoteHttpError",
@@ -156,20 +79,6 @@ function create_remote_http_error(status, body, cause) {
 		cause
 	};
 }
-/**
-* Creates a {@link RemoteTransportError} for network or decode failures.
-*
-* @example
-* ```ts
-* const error = create_remote_transport_error(new Error("Network unavailable"));
-* ```
-*
-* @since 2.0.0
-* @param cause - The underlying error that caused the transport failure.
-* @param body - Optional response body if one was received.
-* @returns A remote transport error shape.
-* @internal
-*/
 function create_remote_transport_error(cause, body) {
 	return {
 		_tag: "RemoteTransportError",
@@ -177,42 +86,12 @@ function create_remote_transport_error(cause, body) {
 		body
 	};
 }
-/**
-* Wraps a devalue-encoded error string inside a
-* {@link SerializedRemoteFailureEnvelope}.
-*
-* @example
-* ```ts
-* const envelope = create_serialized_remote_failure_envelope(encoded);
-* ```
-*
-* @since 2.0.0
-* @param encoded - The devalue-encoded error value.
-* @returns The wire-format envelope.
-* @internal
-*/
 function create_serialized_remote_failure_envelope(encoded) {
 	return {
 		__svelte_effect_remote__: true,
 		encoded
 	};
 }
-/** Type guards for structured remote error values. */
-/**
-* Checks whether a value is a {@link SerializedRemoteFailureEnvelope}.
-*
-* @example
-* ```ts
-* if (is_serialized_remote_failure_envelope(value)) {
-*   console.log(value.encoded);
-* }
-* ```
-*
-* @since 2.0.0
-* @param value - The value to check.
-* @returns `true` when the value is a serialised failure envelope.
-* @internal
-*/
 function is_serialized_remote_failure_envelope(value) {
 	return is_serialized_remote_failure_envelope_value(value);
 }
@@ -268,6 +147,6 @@ function is_remote_transport_error(value) {
 	return is_remote_transport_error_value(value);
 }
 //#endregion
-export { EFFECT_REMOTE_ERROR_MARKER, REMOTE_ERROR_DECODER, create_form_error, create_remote_http_error, create_remote_transport_error, create_remote_validation_error, create_serialized_remote_failure_envelope, is_form_error, is_remote_http_error, is_remote_transport_error, is_remote_validation_error, is_serialized_remote_failure_envelope };
+export { create_form_error, create_remote_http_error, create_remote_transport_error, create_remote_validation_error, create_serialized_remote_failure_envelope, effect_remote_error_marker, is_form_error, is_remote_http_error, is_remote_transport_error, is_remote_validation_error, is_serialized_remote_failure_envelope, remote_error_decoder };
 
 //# sourceMappingURL=shared.js.map

package/.dist/remote/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/remote/shared.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\n/**\n * Shared types, markers, and constructors used by both the client-side remote\n * adapters and the server-side handler runtime. These types define the error\n * protocol that flows across the network boundary.\n *\n * @since 2.0.0\n */\n\n/**\n * Well-known marker injected into every serialised remote-failure envelope\n * so the client can reliably distinguish runtime errors from domain values.\n *\n * @example\n * ```ts\n * if (envelope[EFFECT_REMOTE_ERROR_MARKER] === true) {\n *   console.log(envelope.encoded);\n * }\n * ```\n *\n * @since 2.0.0\n * @internal\n */\nexport const EFFECT_REMOTE_ERROR_MARKER = \"__svelte_effect_remote__\";\n\n/**\n * Well-known symbol used to attach a payload decoder to a remote function\n * so the client's transport layer can decode domain error types.\n *\n * @example\n * ```ts\n * Reflect.get(remote_function, REMOTE_ERROR_DECODER);\n * ```\n *\n * @since 2.0.0\n * @internal\n */\nexport const REMOTE_ERROR_DECODER = Symbol.for(\"svelte-effect-runtime/remote-error-decoder\");\n\n/** Form validation helpers and types. */\n\n/**\n * A single field-level or form-level validation issue reported by a\n * {@link Form} handler.\n *\n * @example\n * ```ts\n * const issue: FormIssue = {\n *   message: \"Use an email address.\",\n *   path: [\"email\"],\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface FormIssue {\n\t/** Human-readable validation message. */\n\tmessage: string;\n\t/** Path to the offending field as an array of string-or-number keys. */\n\tpath: (string | number)[];\n}\n\n/**\n * Error subtype thrown by {@link Form} handlers to signal validation\n * failures. The `issues` array is forwarded to SvelteKit's `invalid()`\n * helper on the server and surfaced as `FormError` on the client.\n *\n * @example\n * ```ts\n * const error: FormError = {\n *   _tag: \"FormError\",\n *   issues: [{ message: \"Required.\", path: [\"email\"] }],\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface FormError<SchemaType = unknown> {\n\treadonly _tag: \"FormError\";\n\treadonly issues: readonly FormIssue[];\n\t/** Phantom type slot for the schema this error was derived from. */\n\treadonly _schema?: SchemaType;\n}\n\n/**\n * Creates a {@link FormError} holding the given issues.\n *\n * @example\n * ```ts\n * const error = create_form_error([\n *   { message: \"Required.\", path: [\"email\"] },\n * ]);\n * ```\n *\n * @since 2.0.0\n * @param issues - The validation issues to attach.\n * @returns A FormError with the `_tag` set and no schema reference.\n */\nexport function create_form_error(issues: readonly FormIssue[]): FormError {\n\treturn { _tag: \"FormError\", issues };\n}\n\n/**\n * Type guard that narrows an unknown value to a {@link FormError}.\n *\n * @example\n * ```ts\n * if (is_form_error(error)) {\n *   console.log(error.issues);\n * }\n * ```\n *\n * @since 2.0.0\n * @param value - The value to check.\n * @returns `true` when the value is a FormError.\n */\nexport function is_form_error(value: unknown): value is FormError {\n\treturn is_form_error_value(value);\n}\n\n/** Remote error types shared by client and server helpers. */\n\n/**\n * Union of all wire-level error shapes that a remote function can\n * surface on its error channel.\n *\n * @example\n * ```ts\n * const result = yield* myQuery();\n * // error channel is RemoteFailure<DomainError>\n * ```\n *\n * @since 2.0.0\n */\nexport type RemoteFailure<ErrorType> =\n\t| ErrorType\n\t| RemoteValidationError\n\t| RemoteHttpError\n\t| RemoteTransportError;\n\n/**\n * Validation errors that originate from a server-side {@link Form}\n * handler calling `invalid()` (SvelteKit's `fail`).\n *\n * @example\n * ```ts\n * const error: RemoteValidationError = {\n *   _tag: \"RemoteValidationError\",\n *   status: 400,\n *   issues: [{ message: \"Required.\", path: [\"email\"] }],\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface RemoteValidationError {\n\treadonly _tag: \"RemoteValidationError\";\n\treadonly issues?: readonly FormIssue[];\n\treadonly body?: unknown;\n\treadonly status: number;\n}\n\n/**\n * HTTP-level errors with a status code and optional response body. Raised\n * when the server explicitly calls SvelteKit's `error(status, body)`.\n *\n * @example\n * ```ts\n * const error: RemoteHttpError = {\n *   _tag: \"RemoteHttpError\",\n *   status: 404,\n *   body: { message: \"Not found\" },\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface RemoteHttpError {\n\treadonly _tag: \"RemoteHttpError\";\n\treadonly status: number;\n\treadonly body?: unknown;\n\treadonly cause?: unknown;\n}\n\n/**\n * Transport-level errors raised by the client adapter when the network\n * request fails or the response cannot be decoded.\n *\n * @example\n * ```ts\n * const error: RemoteTransportError = {\n *   _tag: \"RemoteTransportError\",\n *   cause: new Error(\"Network unavailable\"),\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface RemoteTransportError {\n\treadonly _tag: \"RemoteTransportError\";\n\treadonly cause?: unknown;\n\treadonly body?: unknown;\n}\n\n/**\n * Wire format for an encoded remote failure. The server wraps domain\n * errors in this envelope before serialising them with devalue.\n *\n * @example\n * ```ts\n * const envelope: SerializedRemoteFailureEnvelope = {\n *   __svelte_effect_remote__: true,\n *   encoded: \"[\\\"DomainError\\\"]\",\n * };\n * ```\n *\n * @since 2.0.0\n * @internal\n */\nexport interface SerializedRemoteFailureEnvelope {\n\treadonly __svelte_effect_remote__: true;\n\treadonly encoded: string;\n}\n\nconst FormIssuePathSegmentSchema = Schema.Union([Schema.String, Schema.Number]);\n\nconst FormIssueSchema = Schema.Struct({\n\tmessage: Schema.String,\n\tpath: Schema.Array(FormIssuePathSegmentSchema),\n});\n\nconst FormErrorSchema = Schema.Struct({\n\t_tag: Schema.Literal(\"FormError\"),\n\tissues: Schema.Array(FormIssueSchema),\n});\n\nconst SerializedRemoteFailureEnvelopeSchema = Schema.Struct({\n\t__svelte_effect_remote__: Schema.Literal(true),\n\tencoded: Schema.String,\n});\n\nconst RemoteValidationErrorSchema = Schema.Struct({\n\t_tag: Schema.Literal(\"RemoteValidationError\"),\n\tbody: Schema.optional(Schema.Unknown),\n\tissues: Schema.optional(Schema.Array(FormIssueSchema)),\n\tstatus: Schema.Number,\n});\n\nconst RemoteHttpErrorSchema = Schema.Struct({\n\t_tag: Schema.Literal(\"RemoteHttpError\"),\n\tbody: Schema.optional(Schema.Unknown),\n\tcause: Schema.optional(Schema.Unknown),\n\tstatus: Schema.Number,\n});\n\nconst RemoteTransportErrorSchema = Schema.Struct({\n\t_tag: Schema.Literal(\"RemoteTransportError\"),\n\tbody: Schema.optional(Schema.Unknown),\n\tcause: Schema.optional(Schema.Unknown),\n});\n\nconst is_form_error_value = Schema.is(FormErrorSchema);\nconst is_remote_http_error_value = Schema.is(RemoteHttpErrorSchema);\nconst is_remote_transport_error_value = Schema.is(RemoteTransportErrorSchema);\nconst is_remote_validation_error_value = Schema.is(RemoteValidationErrorSchema);\nconst is_serialized_remote_failure_envelope_value = Schema.is(\n\tSerializedRemoteFailureEnvelopeSchema,\n);\n\n/** Constructors for structured remote error values. */\n\n/**\n * Creates a {@link RemoteValidationError} from a list of form issues.\n *\n * @example\n * ```ts\n * const error = create_remote_validation_error([\n *   { message: \"Required.\", path: [\"email\"] },\n * ]);\n * ```\n *\n * @since 2.0.0\n * @param issues - The validation issues reported by the server handler.\n * @param body - Optional response body returned alongside the error.\n * @param status - HTTP status code (defaults to 400).\n * @returns A remote-validation error shape.\n * @internal\n */\nexport function create_remote_validation_error(\n\tissues: readonly FormIssue[],\n\tbody?: unknown,\n\tstatus = 400,\n): RemoteValidationError {\n\treturn { _tag: \"RemoteValidationError\", issues, body, status };\n}\n\n/**\n * Creates a {@link RemoteHttpError} for a given HTTP status.\n *\n * @example\n * ```ts\n * const error = create_remote_http_error(404, { message: \"Not found\" });\n * ```\n *\n * @since 2.0.0\n * @param status - The HTTP status code.\n * @param body - Optional response body.\n * @param cause - Optional underlying cause.\n * @returns A remote HTTP error shape.\n * @internal\n */\nexport function create_remote_http_error(\n\tstatus: number,\n\tbody?: unknown,\n\tcause?: unknown,\n): RemoteHttpError {\n\treturn { _tag: \"RemoteHttpError\", status, body, cause };\n}\n\n/**\n * Creates a {@link RemoteTransportError} for network or decode failures.\n *\n * @example\n * ```ts\n * const error = create_remote_transport_error(new Error(\"Network unavailable\"));\n * ```\n *\n * @since 2.0.0\n * @param cause - The underlying error that caused the transport failure.\n * @param body - Optional response body if one was received.\n * @returns A remote transport error shape.\n * @internal\n */\nexport function create_remote_transport_error(\n\tcause: unknown,\n\tbody?: unknown,\n): RemoteTransportError {\n\treturn { _tag: \"RemoteTransportError\", cause, body };\n}\n\n/**\n * Wraps a devalue-encoded error string inside a\n * {@link SerializedRemoteFailureEnvelope}.\n *\n * @example\n * ```ts\n * const envelope = create_serialized_remote_failure_envelope(encoded);\n * ```\n *\n * @since 2.0.0\n * @param encoded - The devalue-encoded error value.\n * @returns The wire-format envelope.\n * @internal\n */\nexport function create_serialized_remote_failure_envelope(\n\tencoded: string,\n): SerializedRemoteFailureEnvelope {\n\treturn { __svelte_effect_remote__: true, encoded };\n}\n\n/** Type guards for structured remote error values. */\n\n/**\n * Checks whether a value is a {@link SerializedRemoteFailureEnvelope}.\n *\n * @example\n * ```ts\n * if (is_serialized_remote_failure_envelope(value)) {\n *   console.log(value.encoded);\n * }\n * ```\n *\n * @since 2.0.0\n * @param value - The value to check.\n * @returns `true` when the value is a serialised failure envelope.\n * @internal\n */\nexport function is_serialized_remote_failure_envelope(\n\tvalue: unknown,\n): value is SerializedRemoteFailureEnvelope {\n\treturn is_serialized_remote_failure_envelope_value(value);\n}\n\n/**\n * Checks whether a value is a {@link RemoteValidationError}.\n *\n * @example\n * ```ts\n * if (is_remote_validation_error(error)) {\n *   console.log(error.issues);\n * }\n * ```\n *\n * @since 2.0.0\n * @param value - The value to check.\n * @returns `true` when the value is a remote validation error.\n */\nexport function is_remote_validation_error(value: unknown): value is RemoteValidationError {\n\treturn is_remote_validation_error_value(value);\n}\n\n/**\n * Checks whether a value is a {@link RemoteHttpError}.\n *\n * @example\n * ```ts\n * if (is_remote_http_error(error)) {\n *   console.log(error.status);\n * }\n * ```\n *\n * @since 2.0.0\n * @param value - The value to check.\n * @returns `true` when the value is a remote HTTP error.\n */\nexport function is_remote_http_error(value: unknown): value is RemoteHttpError {\n\treturn is_remote_http_error_value(value);\n}\n\n/**\n * Checks whether a value is a {@link RemoteTransportError}.\n *\n * @example\n * ```ts\n * if (is_remote_transport_error(error)) {\n *   console.error(error.cause);\n * }\n * ```\n *\n * @since 2.0.0\n * @param value - The value to check.\n * @returns `true` when the value is a remote transport error.\n */\nexport function is_remote_transport_error(value: unknown): value is RemoteTransportError {\n\treturn is_remote_transport_error_value(value);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,6BAA6B;;;;;;;;;;;;;AAc1C,MAAa,uBAAuB,OAAO,IAAI,4CAA4C;;;;;;;;;;;;;;;AA6D3F,SAAgB,kBAAkB,QAAyC;CAC1E,OAAO;EAAE,MAAM;EAAa;CAAO;AACpC;;;;;;;;;;;;;;;AAgBA,SAAgB,cAAc,OAAoC;CACjE,OAAO,oBAAoB,KAAK;AACjC;AA0GA,MAAM,6BAA6B,OAAO,MAAM,CAAC,OAAO,QAAQ,OAAO,MAAM,CAAC;AAE9E,MAAM,kBAAkB,OAAO,OAAO;CACrC,SAAS,OAAO;CAChB,MAAM,OAAO,MAAM,0BAA0B;AAC9C,CAAC;AAED,MAAM,kBAAkB,OAAO,OAAO;CACrC,MAAM,OAAO,QAAQ,WAAW;CAChC,QAAQ,OAAO,MAAM,eAAe;AACrC,CAAC;AAED,MAAM,wCAAwC,OAAO,OAAO;CAC3D,0BAA0B,OAAO,QAAQ,IAAI;CAC7C,SAAS,OAAO;AACjB,CAAC;AAED,MAAM,8BAA8B,OAAO,OAAO;CACjD,MAAM,OAAO,QAAQ,uBAAuB;CAC5C,MAAM,OAAO,SAAS,OAAO,OAAO;CACpC,QAAQ,OAAO,SAAS,OAAO,MAAM,eAAe,CAAC;CACrD,QAAQ,OAAO;AAChB,CAAC;AAED,MAAM,wBAAwB,OAAO,OAAO;CAC3C,MAAM,OAAO,QAAQ,iBAAiB;CACtC,MAAM,OAAO,SAAS,OAAO,OAAO;CACpC,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,QAAQ,OAAO;AAChB,CAAC;AAED,MAAM,6BAA6B,OAAO,OAAO;CAChD,MAAM,OAAO,QAAQ,sBAAsB;CAC3C,MAAM,OAAO,SAAS,OAAO,OAAO;CACpC,OAAO,OAAO,SAAS,OAAO,OAAO;AACtC,CAAC;AAED,MAAM,sBAAsB,OAAO,GAAG,eAAe;AACrD,MAAM,6BAA6B,OAAO,GAAG,qBAAqB;AAClE,MAAM,kCAAkC,OAAO,GAAG,0BAA0B;AAC5E,MAAM,mCAAmC,OAAO,GAAG,2BAA2B;AAC9E,MAAM,8CAA8C,OAAO,GAC1D,qCACD;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,+BACf,QACA,MACA,SAAS,KACe;CACxB,OAAO;EAAE,MAAM;EAAyB;EAAQ;EAAM;CAAO;AAC9D;;;;;;;;;;;;;;;;AAiBA,SAAgB,yBACf,QACA,MACA,OACkB;CAClB,OAAO;EAAE,MAAM;EAAmB;EAAQ;EAAM;CAAM;AACvD;;;;;;;;;;;;;;;AAgBA,SAAgB,8BACf,OACA,MACuB;CACvB,OAAO;EAAE,MAAM;EAAwB;EAAO;CAAK;AACpD;;;;;;;;;;;;;;;AAgBA,SAAgB,0CACf,SACkC;CAClC,OAAO;EAAE,0BAA0B;EAAM;CAAQ;AAClD;;;;;;;;;;;;;;;;;AAmBA,SAAgB,sCACf,OAC2C;CAC3C,OAAO,4CAA4C,KAAK;AACzD;;;;;;;;;;;;;;;AAgBA,SAAgB,2BAA2B,OAAgD;CAC1F,OAAO,iCAAiC,KAAK;AAC9C;;;;;;;;;;;;;;;AAgBA,SAAgB,qBAAqB,OAA0C;CAC9E,OAAO,2BAA2B,KAAK;AACxC;;;;;;;;;;;;;;;AAgBA,SAAgB,0BAA0B,OAA+C;CACxF,OAAO,gCAAgC,KAAK;AAC7C"}
+{"version":3,"file":"shared.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/remote/shared.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\n/** Remote error wire protocol shared by client and server adapters. */\n\n/** Shared marker used to recognize remote errors across package copies. */\nexport const effect_remote_error_marker = \"__svelte_effect_remote__\";\n\n/** Decodes the shared remote-error marker without relying on class identity. */\nexport const remote_error_decoder = Symbol.for(\"svelte-effect-runtime/remote-error-decoder\");\n\n/**\n * A single field-level or form-level validation issue reported by a\n * {@link Form} handler.\n *\n * @example\n * ```ts\n * const issue: FormIssue = {\n *   message: \"Use an email address.\",\n *   path: [\"email\"],\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface FormIssue {\n\t/** Human-readable validation message. */\n\tmessage: string;\n\t/** Path to the offending field as an array of string-or-number keys. */\n\tpath: (string | number)[];\n}\n\n/**\n * Error subtype thrown by {@link Form} handlers to signal validation\n * failures. The `issues` array is forwarded to SvelteKit's `invalid()`\n * helper on the server and surfaced as `FormError` on the client.\n *\n * @example\n * ```ts\n * const error: FormError = {\n *   _tag: \"FormError\",\n *   issues: [{ message: \"Required.\", path: [\"email\"] }],\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface FormError<SchemaType = unknown> {\n\treadonly _tag: \"FormError\";\n\treadonly issues: readonly FormIssue[];\n\t/** Phantom type slot for the schema this error was derived from. */\n\treadonly _schema?: SchemaType;\n}\n\nexport function create_form_error(issues: readonly FormIssue[]): FormError {\n\treturn { _tag: \"FormError\", issues };\n}\n\n/**\n * Type guard that narrows an unknown value to a {@link FormError}.\n *\n * @example\n * ```ts\n * if (is_form_error(error)) {\n *   console.log(error.issues);\n * }\n * ```\n *\n * @since 2.0.0\n * @param value - The value to check.\n * @returns `true` when the value is a FormError.\n */\nexport function is_form_error(value: unknown): value is FormError {\n\treturn is_form_error_value(value);\n}\n\n/**\n * Union of all wire-level error shapes that a remote function can\n * surface on its error channel.\n *\n * @example\n * ```ts\n * const result: Effect.Effect<User, RemoteFailure<DomainError>> = myQuery();\n * ```\n *\n * @since 2.0.0\n */\nexport type RemoteFailure<ErrorType> =\n\t| ErrorType\n\t| RemoteValidationError\n\t| RemoteHttpError\n\t| RemoteTransportError;\n\n/**\n * Validation errors that originate from a server-side {@link Form}\n * handler calling `invalid()` (SvelteKit's `fail`).\n *\n * @example\n * ```ts\n * const error: RemoteValidationError = {\n *   _tag: \"RemoteValidationError\",\n *   status: 400,\n *   issues: [{ message: \"Required.\", path: [\"email\"] }],\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface RemoteValidationError {\n\treadonly _tag: \"RemoteValidationError\";\n\treadonly issues?: readonly FormIssue[];\n\treadonly body?: unknown;\n\treadonly status: number;\n}\n\n/**\n * HTTP-level errors with a status code and optional response body. Raised\n * when the server explicitly calls SvelteKit's `error(status, body)`.\n *\n * @example\n * ```ts\n * const error: RemoteHttpError = {\n *   _tag: \"RemoteHttpError\",\n *   status: 404,\n *   body: { message: \"Not found\" },\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface RemoteHttpError {\n\treadonly _tag: \"RemoteHttpError\";\n\treadonly status: number;\n\treadonly body?: unknown;\n\treadonly cause?: unknown;\n}\n\n/**\n * Transport-level errors raised by the client adapter when the network\n * request fails or the response cannot be decoded.\n *\n * @example\n * ```ts\n * const error: RemoteTransportError = {\n *   _tag: \"RemoteTransportError\",\n *   cause: new Error(\"Network unavailable\"),\n * };\n * ```\n *\n * @since 2.0.0\n */\nexport interface RemoteTransportError {\n\treadonly _tag: \"RemoteTransportError\";\n\treadonly cause?: unknown;\n\treadonly body?: unknown;\n}\n\nexport interface SerializedRemoteFailureEnvelope {\n\treadonly __svelte_effect_remote__: true;\n\treadonly encoded: string;\n}\n\nconst FormIssuePathSegmentSchema = Schema.Union([Schema.String, Schema.Number]);\n\nconst FormIssueSchema = Schema.Struct({\n\tmessage: Schema.String,\n\tpath: Schema.Array(FormIssuePathSegmentSchema),\n});\n\nconst FormErrorSchema = Schema.Struct({\n\t_tag: Schema.Literal(\"FormError\"),\n\tissues: Schema.Array(FormIssueSchema),\n});\n\nconst SerializedRemoteFailureEnvelopeSchema = Schema.Struct({\n\t__svelte_effect_remote__: Schema.Literal(true),\n\tencoded: Schema.String,\n});\n\nconst RemoteValidationErrorSchema = Schema.Struct({\n\t_tag: Schema.Literal(\"RemoteValidationError\"),\n\tbody: Schema.optional(Schema.Unknown),\n\tissues: Schema.optional(Schema.Array(FormIssueSchema)),\n\tstatus: Schema.Number,\n});\n\nconst RemoteHttpErrorSchema = Schema.Struct({\n\t_tag: Schema.Literal(\"RemoteHttpError\"),\n\tbody: Schema.optional(Schema.Unknown),\n\tcause: Schema.optional(Schema.Unknown),\n\tstatus: Schema.Number,\n});\n\nconst RemoteTransportErrorSchema = Schema.Struct({\n\t_tag: Schema.Literal(\"RemoteTransportError\"),\n\tbody: Schema.optional(Schema.Unknown),\n\tcause: Schema.optional(Schema.Unknown),\n});\n\nconst is_form_error_value = Schema.is(FormErrorSchema);\nconst is_remote_http_error_value = Schema.is(RemoteHttpErrorSchema);\nconst is_remote_transport_error_value = Schema.is(RemoteTransportErrorSchema);\nconst is_remote_validation_error_value = Schema.is(RemoteValidationErrorSchema);\nconst is_serialized_remote_failure_envelope_value = Schema.is(\n\tSerializedRemoteFailureEnvelopeSchema,\n);\n\nexport function create_remote_validation_error(\n\tissues: readonly FormIssue[],\n\tbody?: unknown,\n\tstatus = 400,\n): RemoteValidationError {\n\treturn { _tag: \"RemoteValidationError\", issues, body, status };\n}\n\nexport function create_remote_http_error(\n\tstatus: number,\n\tbody?: unknown,\n\tcause?: unknown,\n): RemoteHttpError {\n\treturn { _tag: \"RemoteHttpError\", status, body, cause };\n}\n\nexport function create_remote_transport_error(\n\tcause: unknown,\n\tbody?: unknown,\n): RemoteTransportError {\n\treturn { _tag: \"RemoteTransportError\", cause, body };\n}\n\nexport function create_serialized_remote_failure_envelope(\n\tencoded: string,\n): SerializedRemoteFailureEnvelope {\n\treturn { __svelte_effect_remote__: true, encoded };\n}\n\nexport function is_serialized_remote_failure_envelope(\n\tvalue: unknown,\n): value is SerializedRemoteFailureEnvelope {\n\treturn is_serialized_remote_failure_envelope_value(value);\n}\n\n/**\n * Checks whether a value is a {@link RemoteValidationError}.\n *\n * @example\n * ```ts\n * if (is_remote_validation_error(error)) {\n *   console.log(error.issues);\n * }\n * ```\n *\n * @since 2.0.0\n * @param value - The value to check.\n * @returns `true` when the value is a remote validation error.\n */\nexport function is_remote_validation_error(value: unknown): value is RemoteValidationError {\n\treturn is_remote_validation_error_value(value);\n}\n\n/**\n * Checks whether a value is a {@link RemoteHttpError}.\n *\n * @example\n * ```ts\n * if (is_remote_http_error(error)) {\n *   console.log(error.status);\n * }\n * ```\n *\n * @since 2.0.0\n * @param value - The value to check.\n * @returns `true` when the value is a remote HTTP error.\n */\nexport function is_remote_http_error(value: unknown): value is RemoteHttpError {\n\treturn is_remote_http_error_value(value);\n}\n\n/**\n * Checks whether a value is a {@link RemoteTransportError}.\n *\n * @example\n * ```ts\n * if (is_remote_transport_error(error)) {\n *   console.error(error.cause);\n * }\n * ```\n *\n * @since 2.0.0\n * @param value - The value to check.\n * @returns `true` when the value is a remote transport error.\n */\nexport function is_remote_transport_error(value: unknown): value is RemoteTransportError {\n\treturn is_remote_transport_error_value(value);\n}\n"],"mappings":";;;;AAKA,MAAa,6BAA6B;;AAG1C,MAAa,uBAAuB,OAAO,IAAI,4CAA4C;AA6C3F,SAAgB,kBAAkB,QAAyC;CAC1E,OAAO;EAAE,MAAM;EAAa;CAAO;AACpC;;;;;;;;;;;;;;;AAgBA,SAAgB,cAAc,OAAoC;CACjE,OAAO,oBAAoB,KAAK;AACjC;AAwFA,MAAM,6BAA6B,OAAO,MAAM,CAAC,OAAO,QAAQ,OAAO,MAAM,CAAC;AAE9E,MAAM,kBAAkB,OAAO,OAAO;CACrC,SAAS,OAAO;CAChB,MAAM,OAAO,MAAM,0BAA0B;AAC9C,CAAC;AAED,MAAM,kBAAkB,OAAO,OAAO;CACrC,MAAM,OAAO,QAAQ,WAAW;CAChC,QAAQ,OAAO,MAAM,eAAe;AACrC,CAAC;AAED,MAAM,wCAAwC,OAAO,OAAO;CAC3D,0BAA0B,OAAO,QAAQ,IAAI;CAC7C,SAAS,OAAO;AACjB,CAAC;AAED,MAAM,8BAA8B,OAAO,OAAO;CACjD,MAAM,OAAO,QAAQ,uBAAuB;CAC5C,MAAM,OAAO,SAAS,OAAO,OAAO;CACpC,QAAQ,OAAO,SAAS,OAAO,MAAM,eAAe,CAAC;CACrD,QAAQ,OAAO;AAChB,CAAC;AAED,MAAM,wBAAwB,OAAO,OAAO;CAC3C,MAAM,OAAO,QAAQ,iBAAiB;CACtC,MAAM,OAAO,SAAS,OAAO,OAAO;CACpC,OAAO,OAAO,SAAS,OAAO,OAAO;CACrC,QAAQ,OAAO;AAChB,CAAC;AAED,MAAM,6BAA6B,OAAO,OAAO;CAChD,MAAM,OAAO,QAAQ,sBAAsB;CAC3C,MAAM,OAAO,SAAS,OAAO,OAAO;CACpC,OAAO,OAAO,SAAS,OAAO,OAAO;AACtC,CAAC;AAED,MAAM,sBAAsB,OAAO,GAAG,eAAe;AACrD,MAAM,6BAA6B,OAAO,GAAG,qBAAqB;AAClE,MAAM,kCAAkC,OAAO,GAAG,0BAA0B;AAC5E,MAAM,mCAAmC,OAAO,GAAG,2BAA2B;AAC9E,MAAM,8CAA8C,OAAO,GAC1D,qCACD;AAEA,SAAgB,+BACf,QACA,MACA,SAAS,KACe;CACxB,OAAO;EAAE,MAAM;EAAyB;EAAQ;EAAM;CAAO;AAC9D;AAEA,SAAgB,yBACf,QACA,MACA,OACkB;CAClB,OAAO;EAAE,MAAM;EAAmB;EAAQ;EAAM;CAAM;AACvD;AAEA,SAAgB,8BACf,OACA,MACuB;CACvB,OAAO;EAAE,MAAM;EAAwB;EAAO;CAAK;AACpD;AAEA,SAAgB,0CACf,SACkC;CAClC,OAAO;EAAE,0BAA0B;EAAM;CAAQ;AAClD;AAEA,SAAgB,sCACf,OAC2C;CAC3C,OAAO,4CAA4C,KAAK;AACzD;;;;;;;;;;;;;;;AAgBA,SAAgB,2BAA2B,OAAgD;CAC1F,OAAO,iCAAiC,KAAK;AAC9C;;;;;;;;;;;;;;;AAgBA,SAAgB,qBAAqB,OAA0C;CAC9E,OAAO,2BAA2B,KAAK;AACxC;;;;;;;;;;;;;;;AAgBA,SAAgB,0BAA0B,OAA+C;CACxF,OAAO,gCAAgC,KAAK;AAC7C"}

package/.dist/runtime/transform.js

@@ -1,19 +1,10 @@
-import { f as PreprocessError, r as AwaitInEffectWorkError } from "../chunks/errors-IJjsUwrE.js";
-import { t as scan_svelte_effect_source } from "../chunks/source-scan-C4PsggID.js";
-import { a as slice_start, c as contains_top_level_await, d as collect_top_level_binding_names, f as has_local_import_binding, i as slice, l as find_yield_star_node, n as validate_rune_yield_usage, o as collect_free_identifiers, p as make_imports, r as create_source_map, s as collect_yield_star_nodes, t as transform_markup_effect, u as is_yield_star_expression } from "../chunks/transform-jNUr65K9.js";
+import { m as PreprocessError, r as AwaitInEffectWorkError } from "../chunks/errors-qhcbUH6o.js";
+import { a as slice_start, c as find_yield_star_node, d as collect_top_level_binding_names, f as has_local_import_binding, i as slice, l as is_yield_star_expression, n as validate_rune_yield_usage, o as collect_yield_star_nodes, p as make_imports, r as create_source_map, s as contains_top_level_await, t as transform_markup_effect, u as collect_free_identifiers } from "../chunks/transform-D7TTlPpK.js";
+import { t as scan_svelte_effect_source } from "../chunks/source-scan-cSawCvsg.js";
 import { contains_top_level_yield_star } from "../detect.js";
 import ts from "typescript";
 import MagicString from "magic-string";
 //#region src/script-transform/runtime-block.ts
-/**
-* Builds the runtime blocks appended to lowered script effect code with
-* explicit runtime import bindings.
-*
-* @since 2.4.2
-* @param blocks - Effect bodies and dependency reads to emit.
-* @param bindings - Runtime binding names available in the generated code.
-* @returns Full `$effect` blocks that fork generated `Effect.gen` programs.
-*/
 function make_runtime_block_with_bindings(blocks, bindings) {
 	return blocks.map((block) => make_runtime_effect_block(block, bindings)).join("\n");
 }
@@ -28,7 +19,7 @@ function make_runtime_effect_block(block, bindings) {
 		`  const ${bindings.program} = ${bindings.effect}.gen(function* () {`,
 		body,
 		"  });",
-		`  const ${bindings.cancel} = ${bindings.untrack}(() => ${bindings.dispatcher_value}.fork(${bindings.program}));`,
+		`  const ${bindings.cancel} = ${bindings.untrack}(() => ${bindings.dispatcher_value}.run_scoped(${bindings.scope}.scope, ${bindings.program}));`,
 		`  import.meta.hot?.dispose(${bindings.cancel});`,
 		`  return ${bindings.cancel};`,
 		"});",
@@ -37,15 +28,6 @@ function make_runtime_effect_block(block, bindings) {
 }
 //#endregion
 //#region src/script-transform/lower.ts
-/**
-* Delegates a statement to the correct lowerer based on syntax kind.
-*
-* @since 2.0.0
-* @param stmt - Statement to lower.
-* @param content - Original source text.
-* @param context - Lowering services for this transform pass.
-* @returns Lowered statement descriptor.
-*/
 function lower_statement(stmt, content, context) {
 	if (ts.isExpressionStatement(stmt)) return lower_expression_statement(stmt, content, context);
 	if (ts.isVariableStatement(stmt)) return lower_variable_statement(stmt, content, context);
@@ -235,11 +217,11 @@ function make_awaited_yield_expression(node, content, hint, context) {
 	return {
 		declaration: `function* ${helper_name}() { return (${wrap_yield_text(yield_text, context)}); }`,
 		expression: [
-			`await ${context.dispatcher_name}().promise({`,
+			`await ${context.dispatcher_name}().with_scope(${context.scope_name}.scope, () => ${context.dispatcher_name}().promise({`,
 			`id: ${JSON.stringify(helper_id)}, `,
 			`deps: ${deps_text}, `,
 			`factory: () => ${helper_name}()`,
-			`})`
+			`}))`
 		].join("")
 	};
 }
@@ -345,6 +327,7 @@ function collect_assignment_target_names(node) {
 */
 function transform_script_effect(content, filename, options = {}) {
 	let temp_counter = 0;
+	const is_server_target = (options.target ?? "client") === "server";
 	const source_file = ts.createSourceFile(filename, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
 	const magic = new MagicString(content);
 	const effect_blocks = [];
@@ -360,13 +343,17 @@ function transform_script_effect(content, filename, options = {}) {
 	const has_effect_import = has_local_import_binding(source_file, "effect", "Effect");
 	const has_dispatcher_import = has_local_import_binding(source_file, "svelte-effect-runtime/internal/generators", "get_dispatcher");
 	const has_untrack_import = has_local_import_binding(source_file, "svelte", "untrack");
+	const has_on_destroy_import = has_local_import_binding(source_file, "svelte", "onDestroy");
 	const reserve_runtime_import = (name) => top_level_binding_names_set.has(name) ? name_allocator.reserve(make_generated_name(name, "")) : name_allocator.reserve(name);
 	const runtime_bindings = {
 		cancel: name_allocator.reserve("__SER___cancel"),
+		component_scope_ref: reserve_runtime_import("ComponentScopeRef"),
 		dispatcher: has_dispatcher_import ? "get_dispatcher" : reserve_runtime_import("get_dispatcher"),
 		dispatcher_value: name_allocator.reserve("__SER___dispatcher"),
 		effect: has_effect_import ? "Effect" : reserve_runtime_import("Effect"),
+		on_destroy: has_on_destroy_import ? "onDestroy" : reserve_runtime_import("onDestroy"),
 		program: name_allocator.reserve("__SER___program"),
+		scope: name_allocator.reserve("__SER___scope"),
 		untrack: has_untrack_import ? "untrack" : reserve_runtime_import("untrack"),
 		yield_success: reserve_runtime_import("YieldSuccess"),
 		yieldable: reserve_runtime_import("ToEffect")
@@ -374,6 +361,7 @@ function transform_script_effect(content, filename, options = {}) {
 	const context = {
 		filename,
 		dispatcher_name: runtime_bindings.dispatcher,
+		scope_name: runtime_bindings.scope,
 		effect_name: runtime_bindings.effect,
 		emit_types,
 		yield_success_name: runtime_bindings.yield_success,
@@ -420,17 +408,20 @@ function transform_script_effect(content, filename, options = {}) {
 		};
 	}
 	/** Phase 3: inject runtime imports after the last user import. */
-	const imports = make_imports(has_effect_import, has_dispatcher_import, has_untrack_import, runtime_bindings, {
+	const imports = make_imports(has_effect_import, has_dispatcher_import, has_untrack_import, has_on_destroy_import, runtime_bindings, {
 		needs_dispatcher: effect_blocks.length > 0 || uses_dispatcher_promise,
 		needs_effect: effect_blocks.length > 0,
 		needs_untrack: effect_blocks.length > 0,
+		needs_on_destroy: !is_server_target,
 		needs_yield_success: uses_yield_success_types,
-		needs_yieldable: effect_blocks.length > 0 || uses_dispatcher_promise
+		needs_yieldable: effect_blocks.length > 0 || uses_dispatcher_promise,
+		needs_scope_ref: true
 	});
 	const last_import = [...source_file.statements].reverse().find(ts.isImportDeclaration);
-	if (imports) if (last_import) magic.appendRight(last_import.end, "\n" + imports);
-	else magic.prepend(imports + "\n");
-	/** Phase 4: append the runtime program and lifecycle wiring. */
+	const injected = [imports, [`const ${runtime_bindings.scope} = new ${runtime_bindings.component_scope_ref}(${runtime_bindings.dispatcher});`, ...!is_server_target ? [`${runtime_bindings.on_destroy}(() => ${runtime_bindings.scope}.dispose());`] : []].join("\n")].filter(Boolean).join("\n");
+	if (last_import) magic.appendRight(last_import.end, "\n" + injected);
+	else magic.prepend(injected + "\n");
+	/** Phase 4: append the runtime program blocks. */
 	if (effect_blocks.length > 0) {
 		const runtime_block = make_runtime_block_with_bindings(effect_blocks, runtime_bindings);
 		magic.append("\n" + runtime_block);
@@ -599,10 +590,14 @@ function transform_svelte_effect(content, filename = "unknown.svelte", options =
 		const effect_attribute = script.effect_attribute;
 		const effect_attribute_start = effect_attribute?.start ?? script.opening_tag_end;
 		const effect_attribute_end = effect_attribute?.end ?? script.opening_tag_end;
-		const result = transform_script_effect(script.text, filename, { emit_types: script.is_typescript });
+		const result = transform_script_effect(script.text, filename, {
+			emit_types: script.is_typescript,
+			target: options.target ?? "client"
+		});
 		combined = content.slice(0, effect_attribute_start) + content.slice(effect_attribute_end, script.opening_tag_end) + result.code + content.slice(script.closing_tag_start);
 	}
-	return { code: transform_markup_effect(combined, filename, { target: options.target }).code };
+	const markup_options = options.target === void 0 ? {} : { target: options.target };
+	return { code: transform_markup_effect(combined, filename, markup_options).code };
 }
 //#endregion
 export { transform_markup_effect, transform_script_effect, transform_svelte_effect };