svelte-effect-runtime 3.0.2 → 3.1.0

package/.dist/errors.d.ts

@@ -0,0 +1,544 @@
+/**
+ * Base class for runtime-authored errors. The class gives every local failure
+ * a stable JavaScript error name while preserving the technical message that
+ * reaches Vite, SvelteKit, and test output.
+ *
+ * @example
+ * ```ts
+ * throw new RuntimeError("Invariant violated.");
+ * ```
+ *
+ * @since 2.4.0
+ * @param message - Technical diagnostic message describing the failed runtime
+ *   invariant.
+ * @returns A runtime-authored Error instance.
+ */
+export declare class RuntimeError extends Error {
+    constructor(message: string);
+}
+/**
+ * Formats a runtime-owned error message with a stable screaming-case code.
+ *
+ * @example
+ * ```ts
+ * throw new Error(make_error_message("DISPATCHER_DISPOSED", "Dispatcher has been disposed"));
+ * ```
+ *
+ * @since 2.0.0
+ * @param code - Stable screaming-case identifier for the error category.
+ * @param message - Human-readable error message without the leading code.
+ * @returns The complete error message prefixed with the stable code.
+ */
+export declare function make_error_message(code: string, message: string): string;
+/**
+ * Base error class for all preprocessor errors emitted during script and
+ * markup transformation. Carries the source filename so error messages can
+ * reference the affected file.
+ *
+ * @example
+ * ```ts
+ * throw new PreprocessError("Component.svelte: invalid transform input.", "Component.svelte");
+ * ```
+ *
+ * @since 2.0.0
+ * @param message - Technical diagnostic message for the transform failure.
+ * @param filename - Source filename that triggered the transform failure.
+ * @returns A preprocessor Error instance with source file context.
+ */
+export declare class PreprocessError extends RuntimeError {
+    /**
+     * The source filename that triggered this error.
+     *
+     * @since 2.0.0
+     */
+    readonly filename: string;
+    constructor(message: string, filename: string);
+}
+/**
+ * Thrown when a statement mixes JavaScript `await` with Effect `yield*` work
+ * that must be lowered into an `Effect.gen` program.
+ *
+ * @example
+ * ```ts
+ * throw new AwaitInEffectWorkError("Component.svelte", "const value = await load();");
+ * ```
+ *
+ * @since 2.0.0
+ * @param filename - Source filename containing the unsupported statement.
+ * @param statement_text - Full source text for the statement containing
+ *   mixed async work.
+ * @returns A preprocessor Error instance with statement context.
+ */
+export declare class AwaitInEffectWorkError extends PreprocessError {
+    /**
+     * The full text of the problematic statement containing mixed async work.
+     *
+     * @since 2.0.0
+     */
+    readonly statement_text: string;
+    constructor(filename: string, statement_text: string);
+}
+/**
+ * Thrown when async Effect work appears inside a Svelte rune position that
+ * must stay synchronous.
+ *
+ * @example
+ * ```ts
+ * throw new AsyncEffectInSyncRuneError("$derived", "$derived(yield* load())", "Component.svelte");
+ * ```
+ *
+ * @since 2.0.0
+ * @param rune_name - Name of the Svelte rune containing the unsupported async
+ *   Effect work.
+ * @param expression_text - Full source text for the rune expression.
+ * @param filename - Source filename containing the unsupported rune.
+ * @returns A preprocessor Error instance with rune source context.
+ */
+export declare class AsyncEffectInSyncRuneError extends PreprocessError {
+    /**
+     * The name of the rune that contained async Effect work.
+     *
+     * @since 2.0.0
+     */
+    readonly rune_name: string;
+    /**
+     * The full text of the expression that triggered the error.
+     *
+     * @since 2.0.0
+     */
+    readonly expression_text: string;
+    constructor(rune_name: string, expression_text: string, filename: string);
+}
+/**
+ * Thrown when async Effect work appears inside a non-generator callback nested
+ * in a markup event handler.
+ *
+ * @example
+ * ```ts
+ * throw new AsyncEffectInEventCallbackError(
+ *   "Component.svelte",
+ *   "Effect.try(() => yield* save())",
+ * );
+ * ```
+ *
+ * @since 2.0.0
+ * @param filename - Source filename containing the invalid event handler.
+ * @param expression_text - Event handler expression that contains the nested
+ *   unsupported async Effect work.
+ * @returns A preprocessor Error instance with event expression context.
+ */
+export declare class AsyncEffectInEventCallbackError extends PreprocessError {
+    /**
+     * The full text of the problematic event handler body.
+     *
+     * @since 2.0.0
+     */
+    readonly expression_text: string;
+    constructor(filename: string, expression_text: string);
+}
+/**
+ * Thrown when an event handler callback contains the old raw `yield*`
+ * shorthand. Effectful event handlers must put `yield*` directly in the event
+ * attribute so the callback boundary is generated by the markup runtime.
+ *
+ * @example
+ * ```ts
+ * throw new YieldStarInEventCallbackError("Component.svelte", "() => yield* save()");
+ * ```
+ *
+ * @since 2.0.0
+ * @param filename - Svelte component filename used to identify where the
+ *   invalid event handler callback was found.
+ * @param expression_text - Original event handler callback text that contained
+ *   `yield*` and should be rewritten as a direct event Effect expression.
+ * @returns A preprocessor Error instance with event callback context.
+ */
+export declare class YieldStarInEventCallbackError extends PreprocessError {
+    /**
+     * The full text of the problematic event handler callback.
+     *
+     * @since 2.0.0
+     */
+    readonly expression_text: string;
+    constructor(filename: string, expression_text: string);
+}
+/**
+ * Thrown when async Effect work appears in a markup position SER cannot lower
+ * safely.
+ *
+ * @example
+ * ```ts
+ * throw new UnsupportedMarkupEffectPositionError(
+ *   "Component.svelte",
+ *   "value={yield* load()}",
+ * );
+ * ```
+ *
+ * @since 2.4.2
+ * @param filename - Source filename containing the unsupported markup.
+ * @param expression_text - The unsupported markup expression text.
+ * @returns A preprocessor Error instance with markup source context.
+ */
+export declare class UnsupportedMarkupEffectPositionError extends PreprocessError {
+    /**
+     * The unsupported markup expression text.
+     *
+     * @since 2.4.2
+     */
+    readonly expression_text: string;
+    constructor(filename: string, expression_text: string);
+}
+/**
+ * Thrown when the request-scoped SvelteKit event context is read outside a
+ * remote handler.
+ *
+ * @example
+ * ```ts
+ * throw new RequestEventUnavailableError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing missing request context.
+ */
+export declare class RequestEventUnavailableError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked Query declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedQueryHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid Query overload usage.
+ */
+export declare class UncheckedQueryHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a batch Query declaration omits the batch handler.
+ *
+ * @example
+ * ```ts
+ * throw new BatchQueryHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid batch Query overload usage.
+ */
+export declare class BatchQueryHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked live Query declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedLiveQueryHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid live Query overload usage.
+ */
+export declare class UncheckedLiveQueryHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked Command declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedCommandHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid Command overload usage.
+ */
+export declare class UncheckedCommandHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked Form declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedFormHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid Form overload usage.
+ */
+export declare class UncheckedFormHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when an unchecked Prerender declaration omits the handler.
+ *
+ * @example
+ * ```ts
+ * throw new UncheckedPrerenderHandlerMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the invalid Prerender overload usage.
+ */
+export declare class UncheckedPrerenderHandlerMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a live query handler resolves to a value that cannot be streamed.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidLiveQueryReturnError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing the expected live query return protocol.
+ */
+export declare class InvalidLiveQueryReturnError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a dispatcher operation is requested after disposal.
+ *
+ * @example
+ * ```ts
+ * throw new DispatcherDisposedError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing an invalid dispatcher lifecycle transition.
+ */
+export declare class DispatcherDisposedError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a generated or native remote query export is not callable.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidQueryFactoryError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing an invalid query adapter input.
+ */
+export declare class InvalidQueryFactoryError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a generated or native remote live query export is not callable.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidLiveQueryFactoryError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing an invalid live query adapter input.
+ */
+export declare class InvalidLiveQueryFactoryError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a generated or native remote command export is not callable.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidCommandFactoryError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing an invalid command adapter input.
+ */
+export declare class InvalidCommandFactoryError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when the client-side form adapter cannot derive a remote endpoint.
+ *
+ * @example
+ * ```ts
+ * throw new RemoteFormEndpointMissingError();
+ * ```
+ *
+ * @since 2.4.0
+ * @returns An Error describing missing form transport metadata.
+ */
+export declare class RemoteFormEndpointMissingError extends RuntimeError {
+    constructor();
+}
+/**
+ * Thrown when a remote form response envelope is not an object with a response
+ * type.
+ *
+ * @example
+ * ```ts
+ * throw new InvalidRemoteFormResponseError(envelope);
+ * ```
+ *
+ * @since 2.4.0
+ * @param envelope - Raw response envelope returned by the remote form endpoint.
+ * @returns An Error describing malformed form response data.
+ */
+export declare class InvalidRemoteFormResponseError extends RuntimeError {
+    /**
+     * Raw response envelope returned by the remote form endpoint.
+     *
+     * @since 2.4.0
+     */
+    readonly envelope: unknown;
+    constructor(envelope?: unknown);
+}
+/**
+ * Thrown when a remote form response has a well-formed envelope but an
+ * unsupported response type or payload slot.
+ *
+ * @example
+ * ```ts
+ * throw new UnsupportedRemoteFormResponseError(envelope);
+ * ```
+ *
+ * @since 2.4.0
+ * @param envelope - Raw response envelope returned by the remote form endpoint.
+ * @returns An Error describing unsupported form response data.
+ */
+export declare class UnsupportedRemoteFormResponseError extends RuntimeError {
+    /**
+     * Raw response envelope returned by the remote form endpoint.
+     *
+     * @since 2.4.0
+     */
+    readonly envelope: unknown;
+    constructor(envelope?: unknown);
+}
+/**
+ * Thrown when a serialized remote failure envelope cannot be decoded.
+ *
+ * @example
+ * ```ts
+ * throw new RemoteErrorDecodeError(raw);
+ * ```
+ *
+ * @since 2.4.0
+ * @param raw - Raw serialized remote failure payload that failed decoding.
+ * @returns An Error describing a malformed remote failure payload.
+ */
+export declare class RemoteErrorDecodeError extends RuntimeError {
+    /**
+     * Raw serialized remote failure payload that failed decoding.
+     *
+     * @since 2.4.0
+     */
+    readonly raw: unknown;
+    constructor(raw?: unknown);
+}
+/**
+ * Thrown when a root server-only helper is imported without Vite rewriting.
+ *
+ * @example
+ * ```ts
+ * throw new ServerOnlyImportError("Query");
+ * ```
+ *
+ * @since 2.4.0
+ * @param export_name - Name of the server-only root export that was invoked.
+ * @returns An Error describing a missing server rewrite.
+ */
+export declare class ServerOnlyImportError extends RuntimeError {
+    /**
+     * Name of the server-only root export that was invoked.
+     *
+     * @since 2.4.0
+     */
+    readonly export_name: string;
+    constructor(export_name: string);
+}
+/**
+ * Thrown when the publish-time `$app/server` shim executes outside SvelteKit.
+ *
+ * @example
+ * ```ts
+ * throw new SvelteKitServerExportUnavailableError("query");
+ * ```
+ *
+ * @since 2.4.0
+ * @param export_name - Name of the `$app/server` export that was invoked.
+ * @returns An Error describing an unavailable SvelteKit virtual module export.
+ */
+export declare class SvelteKitServerExportUnavailableError extends RuntimeError {
+    /**
+     * Name of the `$app/server` export that was invoked.
+     *
+     * @since 2.4.0
+     */
+    readonly export_name: string;
+    constructor(export_name: string);
+}
+/**
+ * Thrown when a SvelteKit remote helper reports that it was called outside the
+ * route-scoped remote module context.
+ *
+ * @example
+ * ```ts
+ * throw new RemoteHelperContextError("Query");
+ * ```
+ *
+ * @since 2.4.0
+ * @param helper_name - SER helper name that triggered the context failure.
+ * @returns An Error describing the required `.remote.ts` placement.
+ */
+export declare class RemoteHelperContextError extends RuntimeError {
+    /**
+     * SER helper name that triggered the context failure.
+     *
+     * @since 2.4.0
+     */
+    readonly helper_name: string;
+    constructor(helper_name: string);
+}
+/**
+ * Thrown when a SvelteKit remote helper normalizes a non-Error thrown value.
+ *
+ * @example
+ * ```ts
+ * throw new RemoteHelperError("raw failure");
+ * ```
+ *
+ * @since 2.4.0
+ * @param value - Non-Error value thrown while creating a remote helper.
+ * @returns An Error preserving the remote helper failure value.
+ */
+export declare class RemoteHelperError extends RuntimeError {
+    /**
+     * Non-Error value that was normalized.
+     *
+     * @since 2.4.0
+     */
+    readonly value: unknown;
+    constructor(value: unknown);
+}
+/**
+ * Thrown when a non-Error value must be normalized into an Error instance.
+ *
+ * @example
+ * ```ts
+ * throw new UnknownRuntimeError("raw failure");
+ * ```
+ *
+ * @since 2.4.0
+ * @param value - Non-Error value that needs Error normalization.
+ * @returns An Error preserving the string representation of an unknown value.
+ */
+export declare class UnknownRuntimeError extends RuntimeError {
+    /**
+     * Non-Error value that was normalized.
+     *
+     * @since 2.4.0
+     */
+    readonly value: unknown;
+    constructor(value: unknown);
+}

package/.dist/internal/generators.js

@@ -1,4 +1,4 @@
-import { t as get_dispatcher } from "../chunks/dispatcher-FCsx1Hlh.js";
+import { t as get_dispatcher } from "../chunks/dispatcher-CLSN-Cxn.js";
 import { value } from "../markup/value.js";
 import { promise } from "../markup/promise.js";
 import { run } from "../markup/run.js";

package/.dist/internal/remote-client.js

@@ -1,2 +1,2 @@
-import { i as create_remote_command_adapter, n as create_remote_query_adapter, r as create_remote_form_adapter, t as create_remote_live_query_adapter } from "../chunks/client-Cruhk6Oo.js";
+import { i as create_remote_command_adapter, n as create_remote_query_adapter, r as create_remote_form_adapter, t as create_remote_live_query_adapter } from "../chunks/client-DRjQiULJ.js";
 export { create_remote_command_adapter, create_remote_form_adapter, create_remote_live_query_adapter, create_remote_query_adapter };

package/.dist/markup/promise.js

@@ -1,4 +1,4 @@
-import { t as get_dispatcher } from "../chunks/dispatcher-FCsx1Hlh.js";
+import { t as get_dispatcher } from "../chunks/dispatcher-CLSN-Cxn.js";
 //#region src/markup/promise.ts
 /**
 * Runtime helper emitted by the markup transform for

package/.dist/markup/run.js

@@ -1,4 +1,4 @@
-import { t as get_dispatcher } from "../chunks/dispatcher-FCsx1Hlh.js";
+import { t as get_dispatcher } from "../chunks/dispatcher-CLSN-Cxn.js";
 import { Effect } from "effect";
 //#region src/markup/run.ts
 /**

package/.dist/markup/transform.js

@@ -1,2 +1,2 @@
-import { t as transform_markup_effect } from "../chunks/transform-BTStPHku.js";
+import { t as transform_markup_effect } from "../chunks/transform-B7_CCcvq.js";
 export { transform_markup_effect };

package/.dist/markup/value.js

@@ -1,4 +1,4 @@
-import { t as get_dispatcher } from "../chunks/dispatcher-FCsx1Hlh.js";
+import { t as get_dispatcher } from "../chunks/dispatcher-CLSN-Cxn.js";
 //#region src/markup/value.ts
 /**
 * Runtime helper emitted by the markup transform for `{yield* expr}`

package/.dist/mod.d.ts

@@ -171,6 +171,7 @@ export declare const RequestEvent: Context.Reference<RequestEventShape>;
 export declare const get_server_runtime_or_throw: () => ManagedRuntime.ManagedRuntime<unknown, never>;
 /** Re-export error types users need for typed catch handlers. */
 export type { FormError, FormIssue, RemoteFailure, RemoteHttpError, RemoteTransportError, RemoteValidationError, } from "./remote/shared.js";
+export { AsyncEffectInEventCallbackError, AsyncEffectInSyncRuneError, AwaitInEffectWorkError, BatchQueryHandlerMissingError, DispatcherDisposedError, InvalidCommandFactoryError, InvalidLiveQueryFactoryError, InvalidLiveQueryReturnError, InvalidQueryFactoryError, InvalidRemoteFormResponseError, PreprocessError, RemoteErrorDecodeError, RemoteFormEndpointMissingError, RemoteHelperContextError, RemoteHelperError, RequestEventUnavailableError, RuntimeError, ServerOnlyImportError, SvelteKitServerExportUnavailableError, UncheckedCommandHandlerMissingError, UncheckedFormHandlerMissingError, UncheckedLiveQueryHandlerMissingError, UncheckedPrerenderHandlerMissingError, UncheckedQueryHandlerMissingError, UnknownRuntimeError, UnsupportedMarkupEffectPositionError, UnsupportedRemoteFormResponseError, YieldStarInEventCallbackError, } from "./errors.js";
 export { is_form_error, is_remote_http_error, is_remote_transport_error, is_remote_validation_error, } from "./remote/shared.js";
 /** Re-export app setup helpers so users can import them from root. */
 export { effect, type EffectOptions } from "./vite.js";

package/.dist/mod.js

@@ -1,4 +1,5 @@
-import { t as Dispatcher } from "./chunks/dispatcher-CgCdn6bj.js";
+import { C as UncheckedPrerenderHandlerMissingError, D as UnsupportedRemoteFormResponseError, E as UnsupportedMarkupEffectPositionError, O as YieldStarInEventCallbackError, S as UncheckedLiveQueryHandlerMissingError, T as UnknownRuntimeError, _ as RuntimeError, a as DispatcherDisposedError, b as UncheckedCommandHandlerMissingError, c as InvalidLiveQueryReturnError, d as PreprocessError, f as RemoteErrorDecodeError, g as RequestEventUnavailableError, h as RemoteHelperError, i as BatchQueryHandlerMissingError, l as InvalidQueryFactoryError, m as RemoteHelperContextError, n as AsyncEffectInSyncRuneError, o as InvalidCommandFactoryError, p as RemoteFormEndpointMissingError, r as AwaitInEffectWorkError, s as InvalidLiveQueryFactoryError, t as AsyncEffectInEventCallbackError, u as InvalidRemoteFormResponseError, v as ServerOnlyImportError, w as UncheckedQueryHandlerMissingError, x as UncheckedFormHandlerMissingError, y as SvelteKitServerExportUnavailableError } from "./chunks/errors-DppSJ83S.js";
+import { t as Dispatcher } from "./chunks/dispatcher-CZvLODNK.js";
 import { is_form_error, is_remote_http_error, is_remote_transport_error, is_remote_validation_error } from "./remote/shared.js";
 import { effect } from "./vite.js";
 //#region src/mod.ts
@@ -187,9 +188,9 @@ function make_server_only_function(name) {
 	};
 }
 function make_server_only_error(name) {
-	return new globalThis.Error(`[SERVER_ONLY_IMPORT]: ${name} is only available in SvelteKit server files. Ensure the SER Vite plugin is enabled so root imports are rewritten to \`svelte-effect-runtime/server\` before evaluation.`);
+	return new ServerOnlyImportError(name);
 }
 //#endregion
-export { ClientRuntime, Command, Error, Form, Prerender, Query, Redirect, RequestEvent, ServerRuntime, effect, get_server_runtime_or_throw, is_form_error, is_remote_http_error, is_remote_transport_error, is_remote_validation_error };
+export { AsyncEffectInEventCallbackError, AsyncEffectInSyncRuneError, AwaitInEffectWorkError, BatchQueryHandlerMissingError, ClientRuntime, Command, DispatcherDisposedError, Error, Form, InvalidCommandFactoryError, InvalidLiveQueryFactoryError, InvalidLiveQueryReturnError, InvalidQueryFactoryError, InvalidRemoteFormResponseError, PreprocessError, Prerender, Query, Redirect, RemoteErrorDecodeError, RemoteFormEndpointMissingError, RemoteHelperContextError, RemoteHelperError, RequestEvent, RequestEventUnavailableError, RuntimeError, ServerOnlyImportError, ServerRuntime, SvelteKitServerExportUnavailableError, UncheckedCommandHandlerMissingError, UncheckedFormHandlerMissingError, UncheckedLiveQueryHandlerMissingError, UncheckedPrerenderHandlerMissingError, UncheckedQueryHandlerMissingError, UnknownRuntimeError, UnsupportedMarkupEffectPositionError, UnsupportedRemoteFormResponseError, YieldStarInEventCallbackError, effect, get_server_runtime_or_throw, is_form_error, is_remote_http_error, is_remote_transport_error, is_remote_validation_error };
 
 //# sourceMappingURL=mod.js.map

package/.dist/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","names":[],"sources":["../../modules/svelte-effect-runtime/src/mod.ts"],"sourcesContent":["import { Dispatcher as InternalDispatcher } from \"$/dispatcher.ts\";\nimport type {\n  ErrorEffectFactory,\n  RedirectEffectFactory,\n} from \"$/server/control-flow.ts\";\nimport type { RequestEvent as RequestEventShape } from \"$/server/runtime.ts\";\nimport type {\n  CommandFactory,\n  FormFactory,\n  PrerenderFactory,\n  QueryFactory,\n  ServerRuntimeFactory,\n} from \"$/server/types.ts\";\nimport type { Context, Layer, ManagedRuntime } from \"effect\";\n\n/**\n * Public API surface for `svelte-effect-runtime`.\n *\n * Call {@link ClientRuntime.make} in `hooks.client.ts`, call\n * {@link ServerRuntime.make} in `hooks.server.ts`, and let the Vite plugin\n * route server-only helpers to the server entrypoint automatically.\n *\n * @module\n */\n\n/**\n * Client-side runtime singleton. Call `ClientRuntime.make(layer?)` once\n * in `hooks.client.ts` to provide services to every component's effect\n * blocks.\n *\n * If never called, a default empty-layer runtime is created lazily on\n * the first `yield*` expression.\n *\n * @example\n * ```ts\n * import { ClientRuntime } from \"svelte-effect-runtime\";\n * import { Db } from \"./db.ts\";\n *\n * ClientRuntime.make(Db.Live);\n * ```\n *\n * @since 2.0.0\n */\nexport class ClientRuntime {\n  /**\n   * Build and cache the client-side dispatcher runtime.\n   *\n   * @since 2.0.0\n   * @param layer - Optional Effect layer to provide to the runtime.\n   */\n  static make<R = never>(layer?: Layer.Layer<R>): void {\n    InternalDispatcher.make(layer);\n  }\n}\n\n/**\n * Server-side runtime singleton export. In SvelteKit server files the Vite\n * plugin rewrites root imports to `svelte-effect-runtime/server`, so this\n * name resolves to the real server implementation before it is evaluated.\n *\n * @example\n * ```ts\n * import { ServerRuntime } from \"svelte-effect-runtime\";\n *\n * ServerRuntime.make();\n * ```\n *\n * @since 2.0.0\n */\nexport const ServerRuntime: ServerRuntimeFactory = make_server_only_class(\n  \"ServerRuntime\",\n) as never;\n\n/**\n * Remote query factory export for `.remote.ts` files imported from the root\n * entrypoint. The Vite plugin rewrites it to the real server implementation.\n *\n * @example\n * ```ts\n * import { Query } from \"svelte-effect-runtime\";\n *\n * export const GetPosts = Query(Effect.succeed([]));\n * ```\n *\n * @since 2.0.0\n */\nexport const Query: QueryFactory = Object.assign(\n  make_server_only_function(\"Query\"),\n  {\n    batch: make_server_only_function(\"Query.batch\"),\n    live: make_server_only_function(\"Query.live\"),\n  },\n) as never;\n\n/**\n * Remote command factory export for `.remote.ts` files imported from the root\n * entrypoint. The Vite plugin rewrites it to the real server implementation.\n *\n * @example\n * ```ts\n * import { Command } from \"svelte-effect-runtime\";\n *\n * export const SavePost = Command(Schema.String, (id) => Effect.succeed(id));\n * ```\n *\n * @since 2.0.0\n */\nexport const Command: CommandFactory = make_server_only_function(\n  \"Command\",\n) as never;\n\n/**\n * SvelteKit HTTP error control-flow export for `.remote.ts` files imported\n * from the root entrypoint. The Vite plugin rewrites it to the real server\n * implementation.\n *\n * @example\n * ```ts\n * import { Error } from \"svelte-effect-runtime\";\n *\n * return yield* Error(\"NotFound\", \"Post not found\");\n * ```\n *\n * @since 2.3.0\n */\nexport const Error: ErrorEffectFactory = make_server_only_function(\n  \"Error\",\n) as never;\n\n/**\n * Remote form factory export for `.remote.ts` files imported from the root\n * entrypoint. The Vite plugin rewrites it to the real server implementation.\n *\n * @example\n * ```ts\n * import { Form } from \"svelte-effect-runtime\";\n *\n * export const CreatePost = Form(PostInput, ({ data }) => Effect.succeed(data));\n * ```\n *\n * @since 2.0.0\n */\nexport const Form: FormFactory = make_server_only_function(\n  \"Form\",\n) as never;\n\n/**\n * Remote prerender factory export for `.remote.ts` files imported from the\n * root entrypoint. The Vite plugin rewrites it to the real server\n * implementation.\n *\n * @example\n * ```ts\n * import { Prerender } from \"svelte-effect-runtime\";\n *\n * export const GetBuildInfo = Prerender(() => Effect.succeed(\"ready\"));\n * ```\n *\n * @since 2.0.0\n */\nexport const Prerender: PrerenderFactory = make_server_only_function(\n  \"Prerender\",\n) as never;\n\n/**\n * SvelteKit redirect control-flow export for `.remote.ts` files imported from\n * the root entrypoint. The Vite plugin rewrites it to the real server\n * implementation.\n *\n * @example\n * ```ts\n * import { Redirect } from \"svelte-effect-runtime\";\n *\n * return yield* Redirect(\"SeeOther\", \"/posts\");\n * ```\n *\n * @since 2.3.0\n */\nexport const Redirect: RedirectEffectFactory = make_server_only_function(\n  \"Redirect\",\n) as never;\n\n/**\n * Current SvelteKit request event service export for `.remote.ts` files\n * imported from the root entrypoint. The Vite plugin rewrites it to the real\n * server implementation.\n *\n * @example\n * ```ts\n * import { RequestEvent } from \"svelte-effect-runtime\";\n *\n * const event = yield* RequestEvent;\n * ```\n *\n * @since 2.0.0\n */\nexport const RequestEvent: Context.Reference<RequestEventShape> =\n  make_server_only_function(\"RequestEvent\") as never;\n\n/**\n * Returns the active server runtime when imported from a server file. The Vite\n * plugin rewrites root imports to the real server implementation.\n *\n * @example\n * ```ts\n * import { get_server_runtime_or_throw } from \"svelte-effect-runtime\";\n *\n * const runtime = get_server_runtime_or_throw();\n * ```\n *\n * @since 2.0.0\n */\nexport const get_server_runtime_or_throw: () => ManagedRuntime.ManagedRuntime<\n  unknown,\n  never\n> = make_server_only_function(\"get_server_runtime_or_throw\") as never;\n\n/** Re-export error types users need for typed catch handlers. */\nexport type {\n  FormError,\n  FormIssue,\n  RemoteFailure,\n  RemoteHttpError,\n  RemoteTransportError,\n  RemoteValidationError,\n} from \"$/remote/shared.ts\";\n\nexport {\n  is_form_error,\n  is_remote_http_error,\n  is_remote_transport_error,\n  is_remote_validation_error,\n} from \"$/remote/shared.ts\";\n\n/** Re-export app setup helpers so users can import them from root. */\nexport { effect, type EffectOptions } from \"$/vite.ts\";\n\n/** Re-export server helper types from the root entrypoint. */\nexport type {\n  ErrorEffectFactory,\n  ErrorStatus,\n  ErrorStatusName,\n  RedirectEffectFactory,\n  RedirectStatus,\n  RedirectStatusName,\n} from \"$/server/control-flow.ts\";\n\n/** Re-export server helper types from the root entrypoint. */\nexport type {\n  CommandFactory,\n  EffectLike,\n  EffectRemoteBatchHandler,\n  EffectRemoteCommand,\n  EffectRemoteForm,\n  EffectRemoteFunction,\n  EffectRemoteLiveQuery,\n  EffectRemoteLiveQueryFunction,\n  EffectRemoteLiveQueryResource,\n  EffectRemoteLiveSource,\n  EffectRemoteQuery,\n  EffectRemoteQueryFunction,\n  FormFactory,\n  FormInvalid,\n  PrerenderFactory,\n  PrerenderOptions,\n  QueryBatchFactory,\n  QueryFactory,\n  QueryLiveFactory,\n  RemoteFormHandler,\n  RemoteHandler,\n  RemoteLiveHandler,\n  SchemaEncodedInput,\n  SchemaInput,\n  ServerRuntimeFactory,\n  StandardSchema,\n  StandardSchemaInput,\n  StandardSchemaOutput,\n} from \"$/server/types.ts\";\n\nfunction make_server_only_class(name: string): unknown {\n  return class ServerOnlyRuntime {\n    static make(): never {\n      throw make_server_only_error(name);\n    }\n  };\n}\n\nfunction make_server_only_function(\n  name: string,\n): (...args: unknown[]) => never {\n  return (..._args: unknown[]): never => {\n    throw make_server_only_error(name);\n  };\n}\n\nfunction make_server_only_error(name: string): globalThis.Error {\n  return new globalThis.Error(\n    `[SERVER_ONLY_IMPORT]: ${name} is only available in SvelteKit server files. ` +\n      `Ensure the SER Vite plugin is enabled so root imports are rewritten ` +\n      `to \\`svelte-effect-runtime/server\\` before evaluation.`,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,IAAa,gBAAb,MAA2B;;;;;;;CAOzB,OAAO,KAAgB,OAA8B;EACnD,WAAmB,KAAK,KAAK;CAC/B;AACF;;;;;;;;;;;;;;;AAgBA,MAAa,gBAAsC,uBACjD,eACF;;;;;;;;;;;;;;AAeA,MAAa,QAAsB,OAAO,OACxC,0BAA0B,OAAO,GACjC;CACE,OAAO,0BAA0B,aAAa;CAC9C,MAAM,0BAA0B,YAAY;AAC9C,CACF;;;;;;;;;;;;;;AAeA,MAAa,UAA0B,0BACrC,SACF;;;;;;;;;;;;;;;AAgBA,MAAa,QAA4B,0BACvC,OACF;;;;;;;;;;;;;;AAeA,MAAa,OAAoB,0BAC/B,MACF;;;;;;;;;;;;;;;AAgBA,MAAa,YAA8B,0BACzC,WACF;;;;;;;;;;;;;;;AAgBA,MAAa,WAAkC,0BAC7C,UACF;;;;;;;;;;;;;;;AAgBA,MAAa,eACX,0BAA0B,cAAc;;;;;;;;;;;;;;AAe1C,MAAa,8BAGT,0BAA0B,6BAA6B;AAgE3D,SAAS,uBAAuB,MAAuB;CACrD,OAAO,MAAM,kBAAkB;EAC7B,OAAO,OAAc;GACnB,MAAM,uBAAuB,IAAI;EACnC;CACF;AACF;AAEA,SAAS,0BACP,MAC+B;CAC/B,QAAQ,GAAG,UAA4B;EACrC,MAAM,uBAAuB,IAAI;CACnC;AACF;AAEA,SAAS,uBAAuB,MAAgC;CAC9D,OAAO,IAAI,WAAW,MACpB,yBAAyB,KAAK,yKAGhC;AACF"}
+{"version":3,"file":"mod.js","names":[],"sources":["../../modules/svelte-effect-runtime/src/mod.ts"],"sourcesContent":["import { Dispatcher as InternalDispatcher } from \"$/dispatcher.ts\";\nimport { ServerOnlyImportError } from \"$/errors.ts\";\nimport type {\n  ErrorEffectFactory,\n  RedirectEffectFactory,\n} from \"$/server/control-flow.ts\";\nimport type { RequestEvent as RequestEventShape } from \"$/server/runtime.ts\";\nimport type {\n  CommandFactory,\n  FormFactory,\n  PrerenderFactory,\n  QueryFactory,\n  ServerRuntimeFactory,\n} from \"$/server/types.ts\";\nimport type { Context, Layer, ManagedRuntime } from \"effect\";\n\n/**\n * Public API surface for `svelte-effect-runtime`.\n *\n * Call {@link ClientRuntime.make} in `hooks.client.ts`, call\n * {@link ServerRuntime.make} in `hooks.server.ts`, and let the Vite plugin\n * route server-only helpers to the server entrypoint automatically.\n *\n * @module\n */\n\n/**\n * Client-side runtime singleton. Call `ClientRuntime.make(layer?)` once\n * in `hooks.client.ts` to provide services to every component's effect\n * blocks.\n *\n * If never called, a default empty-layer runtime is created lazily on\n * the first `yield*` expression.\n *\n * @example\n * ```ts\n * import { ClientRuntime } from \"svelte-effect-runtime\";\n * import { Db } from \"./db.ts\";\n *\n * ClientRuntime.make(Db.Live);\n * ```\n *\n * @since 2.0.0\n */\nexport class ClientRuntime {\n  /**\n   * Build and cache the client-side dispatcher runtime.\n   *\n   * @since 2.0.0\n   * @param layer - Optional Effect layer to provide to the runtime.\n   */\n  static make<R = never>(layer?: Layer.Layer<R>): void {\n    InternalDispatcher.make(layer);\n  }\n}\n\n/**\n * Server-side runtime singleton export. In SvelteKit server files the Vite\n * plugin rewrites root imports to `svelte-effect-runtime/server`, so this\n * name resolves to the real server implementation before it is evaluated.\n *\n * @example\n * ```ts\n * import { ServerRuntime } from \"svelte-effect-runtime\";\n *\n * ServerRuntime.make();\n * ```\n *\n * @since 2.0.0\n */\nexport const ServerRuntime: ServerRuntimeFactory = make_server_only_class(\n  \"ServerRuntime\",\n) as never;\n\n/**\n * Remote query factory export for `.remote.ts` files imported from the root\n * entrypoint. The Vite plugin rewrites it to the real server implementation.\n *\n * @example\n * ```ts\n * import { Query } from \"svelte-effect-runtime\";\n *\n * export const GetPosts = Query(Effect.succeed([]));\n * ```\n *\n * @since 2.0.0\n */\nexport const Query: QueryFactory = Object.assign(\n  make_server_only_function(\"Query\"),\n  {\n    batch: make_server_only_function(\"Query.batch\"),\n    live: make_server_only_function(\"Query.live\"),\n  },\n) as never;\n\n/**\n * Remote command factory export for `.remote.ts` files imported from the root\n * entrypoint. The Vite plugin rewrites it to the real server implementation.\n *\n * @example\n * ```ts\n * import { Command } from \"svelte-effect-runtime\";\n *\n * export const SavePost = Command(Schema.String, (id) => Effect.succeed(id));\n * ```\n *\n * @since 2.0.0\n */\nexport const Command: CommandFactory = make_server_only_function(\n  \"Command\",\n) as never;\n\n/**\n * SvelteKit HTTP error control-flow export for `.remote.ts` files imported\n * from the root entrypoint. The Vite plugin rewrites it to the real server\n * implementation.\n *\n * @example\n * ```ts\n * import { Error } from \"svelte-effect-runtime\";\n *\n * return yield* Error(\"NotFound\", \"Post not found\");\n * ```\n *\n * @since 2.3.0\n */\nexport const Error: ErrorEffectFactory = make_server_only_function(\n  \"Error\",\n) as never;\n\n/**\n * Remote form factory export for `.remote.ts` files imported from the root\n * entrypoint. The Vite plugin rewrites it to the real server implementation.\n *\n * @example\n * ```ts\n * import { Form } from \"svelte-effect-runtime\";\n *\n * export const CreatePost = Form(PostInput, ({ data }) => Effect.succeed(data));\n * ```\n *\n * @since 2.0.0\n */\nexport const Form: FormFactory = make_server_only_function(\n  \"Form\",\n) as never;\n\n/**\n * Remote prerender factory export for `.remote.ts` files imported from the\n * root entrypoint. The Vite plugin rewrites it to the real server\n * implementation.\n *\n * @example\n * ```ts\n * import { Prerender } from \"svelte-effect-runtime\";\n *\n * export const GetBuildInfo = Prerender(() => Effect.succeed(\"ready\"));\n * ```\n *\n * @since 2.0.0\n */\nexport const Prerender: PrerenderFactory = make_server_only_function(\n  \"Prerender\",\n) as never;\n\n/**\n * SvelteKit redirect control-flow export for `.remote.ts` files imported from\n * the root entrypoint. The Vite plugin rewrites it to the real server\n * implementation.\n *\n * @example\n * ```ts\n * import { Redirect } from \"svelte-effect-runtime\";\n *\n * return yield* Redirect(\"SeeOther\", \"/posts\");\n * ```\n *\n * @since 2.3.0\n */\nexport const Redirect: RedirectEffectFactory = make_server_only_function(\n  \"Redirect\",\n) as never;\n\n/**\n * Current SvelteKit request event service export for `.remote.ts` files\n * imported from the root entrypoint. The Vite plugin rewrites it to the real\n * server implementation.\n *\n * @example\n * ```ts\n * import { RequestEvent } from \"svelte-effect-runtime\";\n *\n * const event = yield* RequestEvent;\n * ```\n *\n * @since 2.0.0\n */\nexport const RequestEvent: Context.Reference<RequestEventShape> =\n  make_server_only_function(\"RequestEvent\") as never;\n\n/**\n * Returns the active server runtime when imported from a server file. The Vite\n * plugin rewrites root imports to the real server implementation.\n *\n * @example\n * ```ts\n * import { get_server_runtime_or_throw } from \"svelte-effect-runtime\";\n *\n * const runtime = get_server_runtime_or_throw();\n * ```\n *\n * @since 2.0.0\n */\nexport const get_server_runtime_or_throw: () => ManagedRuntime.ManagedRuntime<\n  unknown,\n  never\n> = make_server_only_function(\"get_server_runtime_or_throw\") as never;\n\n/** Re-export error types users need for typed catch handlers. */\nexport type {\n  FormError,\n  FormIssue,\n  RemoteFailure,\n  RemoteHttpError,\n  RemoteTransportError,\n  RemoteValidationError,\n} from \"$/remote/shared.ts\";\n\nexport {\n  AsyncEffectInEventCallbackError,\n  AsyncEffectInSyncRuneError,\n  AwaitInEffectWorkError,\n  BatchQueryHandlerMissingError,\n  DispatcherDisposedError,\n  InvalidCommandFactoryError,\n  InvalidLiveQueryFactoryError,\n  InvalidLiveQueryReturnError,\n  InvalidQueryFactoryError,\n  InvalidRemoteFormResponseError,\n  PreprocessError,\n  RemoteErrorDecodeError,\n  RemoteFormEndpointMissingError,\n  RemoteHelperContextError,\n  RemoteHelperError,\n  RequestEventUnavailableError,\n  RuntimeError,\n  ServerOnlyImportError,\n  SvelteKitServerExportUnavailableError,\n  UncheckedCommandHandlerMissingError,\n  UncheckedFormHandlerMissingError,\n  UncheckedLiveQueryHandlerMissingError,\n  UncheckedPrerenderHandlerMissingError,\n  UncheckedQueryHandlerMissingError,\n  UnknownRuntimeError,\n  UnsupportedMarkupEffectPositionError,\n  UnsupportedRemoteFormResponseError,\n  YieldStarInEventCallbackError,\n} from \"$/errors.ts\";\n\nexport {\n  is_form_error,\n  is_remote_http_error,\n  is_remote_transport_error,\n  is_remote_validation_error,\n} from \"$/remote/shared.ts\";\n\n/** Re-export app setup helpers so users can import them from root. */\nexport { effect, type EffectOptions } from \"$/vite.ts\";\n\n/** Re-export server helper types from the root entrypoint. */\nexport type {\n  ErrorEffectFactory,\n  ErrorStatus,\n  ErrorStatusName,\n  RedirectEffectFactory,\n  RedirectStatus,\n  RedirectStatusName,\n} from \"$/server/control-flow.ts\";\n\n/** Re-export server helper types from the root entrypoint. */\nexport type {\n  CommandFactory,\n  EffectLike,\n  EffectRemoteBatchHandler,\n  EffectRemoteCommand,\n  EffectRemoteForm,\n  EffectRemoteFunction,\n  EffectRemoteLiveQuery,\n  EffectRemoteLiveQueryFunction,\n  EffectRemoteLiveQueryResource,\n  EffectRemoteLiveSource,\n  EffectRemoteQuery,\n  EffectRemoteQueryFunction,\n  FormFactory,\n  FormInvalid,\n  PrerenderFactory,\n  PrerenderOptions,\n  QueryBatchFactory,\n  QueryFactory,\n  QueryLiveFactory,\n  RemoteFormHandler,\n  RemoteHandler,\n  RemoteLiveHandler,\n  SchemaEncodedInput,\n  SchemaInput,\n  ServerRuntimeFactory,\n  StandardSchema,\n  StandardSchemaInput,\n  StandardSchemaOutput,\n} from \"$/server/types.ts\";\n\nfunction make_server_only_class(name: string): unknown {\n  return class ServerOnlyRuntime {\n    static make(): never {\n      throw make_server_only_error(name);\n    }\n  };\n}\n\nfunction make_server_only_function(\n  name: string,\n): (...args: unknown[]) => never {\n  return (..._args: unknown[]): never => {\n    throw make_server_only_error(name);\n  };\n}\n\nfunction make_server_only_error(name: string): globalThis.Error {\n  return new ServerOnlyImportError(name);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,IAAa,gBAAb,MAA2B;;;;;;;CAOzB,OAAO,KAAgB,OAA8B;EACnD,WAAmB,KAAK,KAAK;CAC/B;AACF;;;;;;;;;;;;;;;AAgBA,MAAa,gBAAsC,uBACjD,eACF;;;;;;;;;;;;;;AAeA,MAAa,QAAsB,OAAO,OACxC,0BAA0B,OAAO,GACjC;CACE,OAAO,0BAA0B,aAAa;CAC9C,MAAM,0BAA0B,YAAY;AAC9C,CACF;;;;;;;;;;;;;;AAeA,MAAa,UAA0B,0BACrC,SACF;;;;;;;;;;;;;;;AAgBA,MAAa,QAA4B,0BACvC,OACF;;;;;;;;;;;;;;AAeA,MAAa,OAAoB,0BAC/B,MACF;;;;;;;;;;;;;;;AAgBA,MAAa,YAA8B,0BACzC,WACF;;;;;;;;;;;;;;;AAgBA,MAAa,WAAkC,0BAC7C,UACF;;;;;;;;;;;;;;;AAgBA,MAAa,eACX,0BAA0B,cAAc;;;;;;;;;;;;;;AAe1C,MAAa,8BAGT,0BAA0B,6BAA6B;AA+F3D,SAAS,uBAAuB,MAAuB;CACrD,OAAO,MAAM,kBAAkB;EAC7B,OAAO,OAAc;GACnB,MAAM,uBAAuB,IAAI;EACnC;CACF;AACF;AAEA,SAAS,0BACP,MAC+B;CAC/B,QAAQ,GAAG,UAA4B;EACrC,MAAM,uBAAuB,IAAI;CACnC;AACF;AAEA,SAAS,uBAAuB,MAAgC;CAC9D,OAAO,IAAI,sBAAsB,IAAI;AACvC"}

package/.dist/remote/client.js

@@ -1,2 +1,2 @@
-import { i as create_remote_command_adapter, n as create_remote_query_adapter, r as create_remote_form_adapter, t as create_remote_live_query_adapter } from "../chunks/client-Cruhk6Oo.js";
+import { i as create_remote_command_adapter, n as create_remote_query_adapter, r as create_remote_form_adapter, t as create_remote_live_query_adapter } from "../chunks/client-DRjQiULJ.js";
 export { create_remote_command_adapter, create_remote_form_adapter, create_remote_live_query_adapter, create_remote_query_adapter };

package/.dist/remote/server.js

@@ -1,3 +1,4 @@
+import { h as RemoteHelperError, m as RemoteHelperContextError } from "../chunks/errors-DppSJ83S.js";
 import { create_serialized_remote_failure_envelope } from "./shared.js";
 import { Cause, Effect, Exit } from "effect";
 import { isHttpError, isRedirect, isValidationError } from "@sveltejs/kit";
@@ -146,8 +147,8 @@ function throw_form_error(issues, invalid) {
 */
 function normalize_remote_helper_error(err, helper_name) {
 	const message = err instanceof Error ? err.message : String(err);
-	if (message.includes("Cannot use") || message.includes("outside a route")) return new globalThis.Error(`[REMOTE_HELPER_CONTEXT]: ${helper_name} was called outside a .remote.ts file. Ensure the file is named \`*.remote.ts\` and is located in a route directory.`);
-	return err instanceof Error ? err : new globalThis.Error(`[REMOTE_HELPER_ERROR]: ${message}`);
+	if (message.includes("Cannot use") || message.includes("outside a route")) return new RemoteHelperContextError(helper_name);
+	return err instanceof Error ? err : new RemoteHelperError(err);
 }
 //#endregion
 export { encode_remote_failure, normalize_remote_helper_error, run_remote_effect, throw_form_error };