svelte-effect-runtime 3.4.4 → 3.4.6

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

@@ -1,5 +1,7 @@
 import type { FormIssue } from "./shared.js";
 import { Cause, Effect } from "effect";
+type SvelteInvalid = (...issues: readonly (FormIssue | string)[]) => never;
+type SvelteError = (status: number, body: unknown) => never;
 /**
  * Runs a user-supplied Effect program through a ManagedRuntime, maps its
  * exit into the shape expected by SvelteKit, and returns the result or
@@ -15,7 +17,7 @@ import { Cause, Effect } from "effect";
  */
 export declare function run_remote_effect<A>(effect: Effect.Effect<A, unknown, unknown>, runtime: {
     runPromise: (e: Effect.Effect<unknown, unknown, unknown>) => Promise<unknown>;
-}, invalid: (status: number, body: unknown) => never, error: (status: number, body: unknown) => never): Promise<A>;
+}, invalid: SvelteInvalid, error: SvelteError): Promise<A>;
 /**
  * Encodes an Effect Cause into a string that the client-side adapter can
  * decode back into a typed `RemoteFailure`.
@@ -43,10 +45,10 @@ export declare function encode_remote_failure(cause: Cause.Cause<unknown>): stri
  * @param invalid - SvelteKit's `invalid` helper bound to the current request.
  * @internal
  */
-export declare function throw_form_error(issues: readonly FormIssue[], invalid: (status: number, body: unknown) => never): never;
+export declare function throw_form_error(issues: readonly FormIssue[], invalid: SvelteInvalid): never;
 /**
- * Remaps low-level SvelteKit errors (e.g. "Cannot use ___ outside a route")
- * into clear, actionable messages.
+ * Remaps SvelteKit's unbranded request-context errors into clear, actionable
+ * messages.
  *
  * @example
  * ```ts
@@ -63,4 +65,5 @@ export declare function throw_form_error(issues: readonly FormIssue[], invalid:
  * @returns A more descriptive error.
  * @internal
  */
-export declare function normalize_remote_helper_error(err: unknown, helper_name: string): globalThis.Error;
+export declare function normalize_remote_helper_error(err: unknown, helper_name: string): Error;
+export {};

package/.dist/remote/server.js

@@ -1,9 +1,11 @@
-import { h as RemoteHelperError, m as RemoteHelperContextError } from "../chunks/errors-0PaWf7Bq.js";
+import { h as RemoteHelperError, m as RemoteHelperContextError } from "../chunks/errors-Dcf0MVbq.js";
 import { create_serialized_remote_failure_envelope } from "./shared.js";
 import { Cause, Effect, Exit } from "effect";
 import { isHttpError, isRedirect, isValidationError } from "@sveltejs/kit";
 import { stringify } from "devalue";
 //#region src/remote/server.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.";
 /**
 * Runs a user-supplied Effect program through a ManagedRuntime, maps its
 * exit into the shape expected by SvelteKit, and returns the result or
@@ -46,7 +48,7 @@ function handle_failure(cause, invalid, error) {
 	*/
 	for (const reason of reasons) if (Cause.isFailReason(reason)) {
 		const failure = reason.error;
-		if (typeof failure === "object" && failure !== null && failure._tag === "FormError") invalid(400, { issues: failure.issues ?? [] });
+		if (typeof failure === "object" && failure !== null && failure._tag === "FormError") invalid(...failure.issues ?? []);
 	}
 	error(500, create_serialized_remote_failure_envelope(encode_remote_failure(cause)));
 }
@@ -62,13 +64,10 @@ function handle_failure(cause, invalid, error) {
 function encode_remote_failure(cause) {
 	const reasons = get_cause_reasons(cause);
 	for (const reason of reasons) if (Cause.isFailReason(reason)) {
-		const failure = reason.error;
-		const encoded = stringify_failure(failure);
+		const encoded = stringify_failure(to_public_remote_failure(reason.error));
 		if (encoded !== void 0) return encoded;
-		const serializable_encoded = stringify_failure(to_serializable_failure(failure));
-		if (serializable_encoded !== void 0) return serializable_encoded;
 	}
-	return stringify({ message: "[UNKNOWN_REMOTE_FAILURE]: Unknown error" });
+	return stringify_unknown_remote_failure();
 }
 function get_cause_reasons(cause) {
 	return cause.reasons ?? [];
@@ -83,13 +82,18 @@ function stringify_failure(value) {
 		return;
 	}
 }
-function to_serializable_failure(value, seen = /* @__PURE__ */ new WeakSet()) {
+function to_public_remote_failure(value) {
+	if (!has_public_remote_failure_tag(value)) return create_unknown_remote_failure();
+	return to_serializable_public_failure(value) ?? create_unknown_remote_failure();
+}
+function to_serializable_public_failure(value, seen = /* @__PURE__ */ new WeakSet()) {
 	if (typeof value === "function" || typeof value === "symbol") return;
 	if (!is_object_like(value)) return value;
 	if (stringify_failure(value) !== void 0) return value;
+	if (is_internal_object(value)) return;
 	if (seen.has(value)) return;
 	seen.add(value);
-	const serializable = Array.isArray(value) ? value.map((item) => to_serializable_failure(item, seen)) : to_plain_record(value, seen);
+	const serializable = Array.isArray(value) ? value.map((item) => to_serializable_public_failure(item, seen)) : to_plain_record(value, seen);
 	seen.delete(value);
 	return serializable;
 }
@@ -98,7 +102,7 @@ function to_plain_record(value, seen) {
 	const record = {};
 	for (const [key, descriptor] of Object.entries(descriptors)) {
 		if (key === "stack" || !("value" in descriptor)) continue;
-		record[key] = to_serializable_failure(descriptor.value, seen);
+		record[key] = to_serializable_public_failure(descriptor.value, seen);
 	}
 	if (value instanceof Error && !("message" in record)) record.message = value.message;
 	return record;
@@ -106,6 +110,22 @@ function to_plain_record(value, seen) {
 function is_object_like(value) {
 	return typeof value === "object" && value !== null;
 }
+function has_public_remote_failure_tag(value) {
+	return is_object_like(value) && typeof value._tag === "string";
+}
+function is_internal_object(value) {
+	return !Array.isArray(value) && !is_plain_record(value) && !has_public_remote_failure_tag(value);
+}
+function is_plain_record(value) {
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+}
+function create_unknown_remote_failure() {
+	return { message: "[UNKNOWN_REMOTE_FAILURE]: Unknown error" };
+}
+function stringify_unknown_remote_failure() {
+	return stringify(create_unknown_remote_failure());
+}
 /**
 * Throws a SvelteKit `invalid` response from a {@link FormError}, calling
 * through to the request-scoped `invalid` helper.
@@ -124,11 +144,11 @@ function is_object_like(value) {
 * @internal
 */
 function throw_form_error(issues, invalid) {
-	invalid(400, { issues });
+	invalid(...issues);
 }
 /**
-* Remaps low-level SvelteKit errors (e.g. "Cannot use ___ outside a route")
-* into clear, actionable messages.
+* Remaps SvelteKit's unbranded request-context errors into clear, actionable
+* messages.
 *
 * @example
 * ```ts
@@ -146,10 +166,13 @@ function throw_form_error(issues, invalid) {
 * @internal
 */
 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 RemoteHelperContextError(helper_name);
+	if (is_sveltekit_remote_context_error(err)) return new RemoteHelperContextError(helper_name);
 	return err instanceof Error ? err : new RemoteHelperError(err);
 }
+function is_sveltekit_remote_context_error(err) {
+	if (!(err instanceof Error)) return false;
+	return err.message.startsWith(request_event_context_error_start) || err.message === request_store_context_error;
+}
 //#endregion
 export { encode_remote_failure, normalize_remote_helper_error, run_remote_effect, throw_form_error };
 

package/.dist/remote/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/remote/server.ts"],"sourcesContent":["import { create_serialized_remote_failure_envelope } from \"$/remote/shared.ts\";\nimport type { FormIssue } from \"$/remote/shared.ts\";\nimport { RemoteHelperContextError, RemoteHelperError } from \"$/errors.ts\";\nimport { isHttpError, isRedirect, isValidationError } from \"@sveltejs/kit\";\nimport { Cause, Effect, Exit } from \"effect\";\nimport { stringify } from \"devalue\";\n\ntype CauseReason = {\n  readonly _tag: string;\n  readonly defect?: unknown;\n  readonly error?: unknown;\n};\n\n/**\n * Runs a user-supplied Effect program through a ManagedRuntime, maps its\n * exit into the shape expected by SvelteKit, and returns the result or\n * throws a SvelteKit-compatible error.\n *\n * @since 2.0.0\n * @param effect - The Effect program to execute.\n * @param runtime - The server-side ManagedRuntime.\n * @param invalid - SvelteKit's `invalid` helper (bound per-request).\n * @param error - SvelteKit's `error` helper.\n * @returns A Promise that resolves with the effect's success value.\n * @internal\n */\nexport async function run_remote_effect<A>(\n  effect: Effect.Effect<A, unknown, unknown>,\n  runtime: {\n    runPromise: (\n      e: Effect.Effect<unknown, unknown, unknown>,\n    ) => Promise<unknown>;\n  },\n  invalid: (status: number, body: unknown) => never,\n  error: (status: number, body: unknown) => never,\n): Promise<A> {\n  const exit: Exit.Exit<A, unknown> = await runtime.runPromise(\n    Effect.exit(effect) as Effect.Effect<unknown, unknown, unknown>,\n  ) as Exit.Exit<A, unknown>;\n\n  if (Exit.isSuccess(exit)) {\n    return exit.value;\n  }\n\n  handle_failure(exit.cause, invalid, error);\n}\n\n/**\n * Inspects the Effect Cause for failures and either throws a form\n * validation error (via SvelteKit's `invalid`) or encodes the error\n * and throws it via SvelteKit's `error`.\n */\nfunction handle_failure(\n  cause: Cause.Cause<unknown>,\n  invalid: (status: number, body: unknown) => never,\n  error: (status: number, body: unknown) => never,\n): never {\n  const reasons = get_cause_reasons(cause);\n\n  /**\n   * Phase 1 — let SvelteKit's thrown control-flow sentinels escape.\n   */\n  for (const reason of reasons) {\n    if (!Cause.isDieReason(reason as never)) {\n      continue;\n    }\n\n    const defect = reason.defect;\n\n    if (is_sveltekit_control_flow(defect)) {\n      throw defect;\n    }\n  }\n\n  /**\n   * Phase 2 — let cancellation escape without becoming a remote failure.\n   */\n  if (Cause.hasInterruptsOnly(cause)) {\n    throw Cause.squash(cause);\n  }\n\n  /**\n   * Phase 3 — preserve typed form validation failures.\n   */\n  for (const reason of reasons) {\n    if (Cause.isFailReason(reason as never)) {\n      const failure = reason.error;\n      if (\n        typeof failure === \"object\" &&\n        failure !== null &&\n        (failure as Record<string, unknown>)._tag === \"FormError\"\n      ) {\n        const issues = (failure as { issues?: readonly FormIssue[] }).issues ??\n          [];\n        invalid(400, { issues });\n      }\n    }\n  }\n\n  /**\n   * Phase 4 — encode all other failures for the remote client.\n   */\n  const encoded = encode_remote_failure(cause);\n  const envelope = create_serialized_remote_failure_envelope(encoded);\n\n  error(500, envelope);\n}\n\n/**\n * Encodes an Effect Cause into a string that the client-side adapter can\n * decode back into a typed `RemoteFailure`.\n *\n * @since 2.0.0\n * @param cause - The Effect Cause from a failed execution.\n * @returns A devalue-encoded string representing the serialised failure.\n * @internal\n */\nexport function encode_remote_failure(cause: Cause.Cause<unknown>): string {\n  const reasons = get_cause_reasons(cause);\n\n  for (const reason of reasons) {\n    if (Cause.isFailReason(reason as never)) {\n      const failure = reason.error;\n\n      const encoded = stringify_failure(failure);\n\n      if (encoded !== undefined) {\n        return encoded;\n      }\n\n      const serializable_failure = to_serializable_failure(failure);\n      const serializable_encoded = stringify_failure(serializable_failure);\n\n      if (serializable_encoded !== undefined) {\n        return serializable_encoded;\n      }\n    }\n  }\n\n  return stringify({ message: \"[UNKNOWN_REMOTE_FAILURE]: Unknown error\" });\n}\n\nfunction get_cause_reasons(\n  cause: Cause.Cause<unknown>,\n): readonly CauseReason[] {\n  const reasons = (cause as unknown as { reasons?: readonly CauseReason[] })\n    .reasons;\n\n  return reasons ?? [];\n}\n\nfunction is_sveltekit_control_flow(value: unknown): boolean {\n  return isRedirect(value) || isHttpError(value) || isValidationError(value);\n}\n\nfunction stringify_failure(value: unknown): string | undefined {\n  try {\n    return stringify(value);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction to_serializable_failure(\n  value: unknown,\n  seen = new WeakSet<object>(),\n): unknown {\n  if (typeof value === \"function\" || typeof value === \"symbol\") {\n    return undefined;\n  }\n\n  if (!is_object_like(value)) {\n    return value;\n  }\n\n  if (stringify_failure(value) !== undefined) {\n    return value;\n  }\n\n  if (seen.has(value)) {\n    return undefined;\n  }\n\n  seen.add(value);\n\n  const serializable = Array.isArray(value)\n    ? value.map((item) => to_serializable_failure(item, seen))\n    : to_plain_record(value, seen);\n\n  seen.delete(value);\n\n  return serializable;\n}\n\nfunction to_plain_record(\n  value: object,\n  seen: WeakSet<object>,\n): Record<string, unknown> {\n  const descriptors = Object.getOwnPropertyDescriptors(value);\n  const record: Record<string, unknown> = {};\n\n  for (const [key, descriptor] of Object.entries(descriptors)) {\n    if (key === \"stack\" || !(\"value\" in descriptor)) {\n      continue;\n    }\n\n    record[key] = to_serializable_failure(descriptor.value, seen);\n  }\n\n  if (value instanceof Error && !(\"message\" in record)) {\n    record.message = value.message;\n  }\n\n  return record;\n}\n\nfunction is_object_like(value: unknown): value is object {\n  return typeof value === \"object\" && value !== null;\n}\n\n/**\n * Throws a SvelteKit `invalid` response from a {@link FormError}, calling\n * through to the request-scoped `invalid` helper.\n *\n * @example\n * ```ts\n * throw_form_error(\n *   [{ message: \"Name is required\", path: [\"name\"] }],\n *   invalid,\n * );\n * ```\n *\n * @since 2.0.0\n * @param issues - The list of form validation issues.\n * @param invalid - SvelteKit's `invalid` helper bound to the current request.\n * @internal\n */\nexport function throw_form_error(\n  issues: readonly FormIssue[],\n  invalid: (status: number, body: unknown) => never,\n): never {\n  invalid(400, { issues });\n}\n\n/**\n * Remaps low-level SvelteKit errors (e.g. \"Cannot use ___ outside a route\")\n * into clear, actionable messages.\n *\n * @example\n * ```ts\n * try {\n *   return native_query(handler);\n * } catch (err) {\n *   throw normalize_remote_helper_error(err, \"Query\");\n * }\n * ```\n *\n * @since 2.0.0\n * @param err - The error thrown by SvelteKit's native functions.\n * @param helper_name - Name of the helper that triggered the error.\n * @returns A more descriptive error.\n * @internal\n */\nexport function normalize_remote_helper_error(\n  err: unknown,\n  helper_name: string,\n): globalThis.Error {\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (message.includes(\"Cannot use\") || message.includes(\"outside a route\")) {\n    return new RemoteHelperContextError(helper_name);\n  }\n\n  return err instanceof Error ? err : new RemoteHelperError(err);\n}\n"],"mappings":"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"}
+{"version":3,"file":"server.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/remote/server.ts"],"sourcesContent":["import { create_serialized_remote_failure_envelope } from \"$/remote/shared.ts\";\nimport type { FormIssue } from \"$/remote/shared.ts\";\nimport { RemoteHelperContextError, RemoteHelperError } from \"$/errors.ts\";\nimport { isHttpError, isRedirect, isValidationError } from \"@sveltejs/kit\";\nimport { Cause, Effect, Exit } from \"effect\";\nimport { stringify } from \"devalue\";\n\ntype CauseReason = {\n\treadonly _tag: string;\n\treadonly defect?: unknown;\n\treadonly error?: unknown;\n};\n\ntype SvelteInvalid = (...issues: readonly (FormIssue | string)[]) => never;\n\ntype SvelteError = (status: number, body: unknown) => never;\n\nconst request_event_context_error_start =\n\t\"Can only read the current request event inside functions invoked during `handle`\";\n\nconst request_store_context_error = \"Could not get the request store.\";\n\n/**\n * Runs a user-supplied Effect program through a ManagedRuntime, maps its\n * exit into the shape expected by SvelteKit, and returns the result or\n * throws a SvelteKit-compatible error.\n *\n * @since 2.0.0\n * @param effect - The Effect program to execute.\n * @param runtime - The server-side ManagedRuntime.\n * @param invalid - SvelteKit's `invalid` helper (bound per-request).\n * @param error - SvelteKit's `error` helper.\n * @returns A Promise that resolves with the effect's success value.\n * @internal\n */\nexport async function run_remote_effect<A>(\n\teffect: Effect.Effect<A, unknown, unknown>,\n\truntime: {\n\t\trunPromise: (e: Effect.Effect<unknown, unknown, unknown>) => Promise<unknown>;\n\t},\n\tinvalid: SvelteInvalid,\n\terror: SvelteError,\n): Promise<A> {\n\tconst exit: Exit.Exit<A, unknown> = (await runtime.runPromise(\n\t\tEffect.exit(effect) as Effect.Effect<unknown, unknown, unknown>,\n\t)) as Exit.Exit<A, unknown>;\n\n\tif (Exit.isSuccess(exit)) {\n\t\treturn exit.value;\n\t}\n\n\thandle_failure(exit.cause, invalid, error);\n}\n\n/**\n * Inspects the Effect Cause for failures and either throws a form\n * validation error (via SvelteKit's `invalid`) or encodes the error\n * and throws it via SvelteKit's `error`.\n */\nfunction handle_failure(\n\tcause: Cause.Cause<unknown>,\n\tinvalid: SvelteInvalid,\n\terror: SvelteError,\n): never {\n\tconst reasons = get_cause_reasons(cause);\n\n\t/**\n\t * Phase 1 — let SvelteKit's thrown control-flow sentinels escape.\n\t */\n\tfor (const reason of reasons) {\n\t\tif (!Cause.isDieReason(reason as never)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst defect = reason.defect;\n\n\t\tif (is_sveltekit_control_flow(defect)) {\n\t\t\tthrow defect;\n\t\t}\n\t}\n\n\t/**\n\t * Phase 2 — let cancellation escape without becoming a remote failure.\n\t */\n\tif (Cause.hasInterruptsOnly(cause)) {\n\t\tthrow Cause.squash(cause);\n\t}\n\n\t/**\n\t * Phase 3 — preserve typed form validation failures.\n\t */\n\tfor (const reason of reasons) {\n\t\tif (Cause.isFailReason(reason as never)) {\n\t\t\tconst failure = reason.error;\n\t\t\tif (\n\t\t\t\ttypeof failure === \"object\" &&\n\t\t\t\tfailure !== null &&\n\t\t\t\t(failure as Record<string, unknown>)._tag === \"FormError\"\n\t\t\t) {\n\t\t\t\tconst issues = (failure as { issues?: readonly FormIssue[] }).issues ?? [];\n\t\t\t\tinvalid(...issues);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Phase 4 — encode all other failures for the remote client.\n\t */\n\tconst encoded = encode_remote_failure(cause);\n\tconst envelope = create_serialized_remote_failure_envelope(encoded);\n\n\terror(500, envelope);\n}\n\n/**\n * Encodes an Effect Cause into a string that the client-side adapter can\n * decode back into a typed `RemoteFailure`.\n *\n * @since 2.0.0\n * @param cause - The Effect Cause from a failed execution.\n * @returns A devalue-encoded string representing the serialised failure.\n * @internal\n */\nexport function encode_remote_failure(cause: Cause.Cause<unknown>): string {\n\tconst reasons = get_cause_reasons(cause);\n\n\tfor (const reason of reasons) {\n\t\tif (Cause.isFailReason(reason as never)) {\n\t\t\tconst failure = to_public_remote_failure(reason.error);\n\t\t\tconst encoded = stringify_failure(failure);\n\n\t\t\tif (encoded !== undefined) {\n\t\t\t\treturn encoded;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn stringify_unknown_remote_failure();\n}\n\nfunction get_cause_reasons(cause: Cause.Cause<unknown>): readonly CauseReason[] {\n\tconst reasons = (cause as unknown as { reasons?: readonly CauseReason[] }).reasons;\n\n\treturn reasons ?? [];\n}\n\nfunction is_sveltekit_control_flow(value: unknown): boolean {\n\treturn isRedirect(value) || isHttpError(value) || isValidationError(value);\n}\n\nfunction stringify_failure(value: unknown): string | undefined {\n\ttry {\n\t\treturn stringify(value);\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction to_public_remote_failure(value: unknown): unknown {\n\tif (!has_public_remote_failure_tag(value)) {\n\t\treturn create_unknown_remote_failure();\n\t}\n\n\tconst serializable_failure = to_serializable_public_failure(value);\n\n\treturn serializable_failure ?? create_unknown_remote_failure();\n}\n\nfunction to_serializable_public_failure(value: unknown, seen = new WeakSet<object>()): unknown {\n\tif (typeof value === \"function\" || typeof value === \"symbol\") {\n\t\treturn undefined;\n\t}\n\n\tif (!is_object_like(value)) {\n\t\treturn value;\n\t}\n\n\tif (stringify_failure(value) !== undefined) {\n\t\treturn value;\n\t}\n\n\tif (is_internal_object(value)) {\n\t\treturn undefined;\n\t}\n\n\tif (seen.has(value)) {\n\t\treturn undefined;\n\t}\n\n\tseen.add(value);\n\n\tconst serializable = Array.isArray(value)\n\t\t? value.map((item) => to_serializable_public_failure(item, seen))\n\t\t: to_plain_record(value, seen);\n\n\tseen.delete(value);\n\n\treturn serializable;\n}\n\nfunction to_plain_record(value: object, seen: WeakSet<object>): Record<string, unknown> {\n\tconst descriptors = Object.getOwnPropertyDescriptors(value);\n\tconst record: Record<string, unknown> = {};\n\n\tfor (const [key, descriptor] of Object.entries(descriptors)) {\n\t\tif (key === \"stack\" || !(\"value\" in descriptor)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\trecord[key] = to_serializable_public_failure(descriptor.value, seen);\n\t}\n\n\tif (value instanceof Error && !(\"message\" in record)) {\n\t\trecord.message = value.message;\n\t}\n\n\treturn record;\n}\n\nfunction is_object_like(value: unknown): value is object {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction has_public_remote_failure_tag(value: unknown): boolean {\n\treturn is_object_like(value) && typeof (value as { _tag?: unknown })._tag === \"string\";\n}\n\nfunction is_internal_object(value: object): boolean {\n\treturn (\n\t\t!Array.isArray(value) && !is_plain_record(value) && !has_public_remote_failure_tag(value)\n\t);\n}\n\nfunction is_plain_record(value: object): boolean {\n\tconst prototype = Object.getPrototypeOf(value);\n\n\treturn prototype === Object.prototype || prototype === null;\n}\n\nfunction create_unknown_remote_failure(): { readonly message: string } {\n\treturn { message: \"[UNKNOWN_REMOTE_FAILURE]: Unknown error\" };\n}\n\nfunction stringify_unknown_remote_failure(): string {\n\treturn stringify(create_unknown_remote_failure());\n}\n\n/**\n * Throws a SvelteKit `invalid` response from a {@link FormError}, calling\n * through to the request-scoped `invalid` helper.\n *\n * @example\n * ```ts\n * throw_form_error(\n *   [{ message: \"Name is required\", path: [\"name\"] }],\n *   invalid,\n * );\n * ```\n *\n * @since 2.0.0\n * @param issues - The list of form validation issues.\n * @param invalid - SvelteKit's `invalid` helper bound to the current request.\n * @internal\n */\nexport function throw_form_error(issues: readonly FormIssue[], invalid: SvelteInvalid): never {\n\tinvalid(...issues);\n}\n\n/**\n * Remaps SvelteKit's unbranded request-context errors into clear, actionable\n * messages.\n *\n * @example\n * ```ts\n * try {\n *   return native_query(handler);\n * } catch (err) {\n *   throw normalize_remote_helper_error(err, \"Query\");\n * }\n * ```\n *\n * @since 2.0.0\n * @param err - The error thrown by SvelteKit's native functions.\n * @param helper_name - Name of the helper that triggered the error.\n * @returns A more descriptive error.\n * @internal\n */\nexport function normalize_remote_helper_error(err: unknown, helper_name: string): Error {\n\tif (is_sveltekit_remote_context_error(err)) {\n\t\treturn new RemoteHelperContextError(helper_name);\n\t}\n\n\treturn err instanceof Error ? err : new RemoteHelperError(err);\n}\n\nfunction is_sveltekit_remote_context_error(err: unknown): err is Error {\n\tif (!(err instanceof Error)) {\n\t\treturn false;\n\t}\n\n\treturn (\n\t\terr.message.startsWith(request_event_context_error_start) ||\n\t\terr.message === request_store_context_error\n\t);\n}\n"],"mappings":";;;;;;AAiBA,MAAM,oCACL;AAED,MAAM,8BAA8B;;;;;;;;;;;;;;AAepC,eAAsB,kBACrB,QACA,SAGA,SACA,OACa;CACb,MAAM,OAA+B,MAAM,QAAQ,WAClD,OAAO,KAAK,MAAM,CACnB;CAEA,IAAI,KAAK,UAAU,IAAI,GACtB,OAAO,KAAK;CAGb,eAAe,KAAK,OAAO,SAAS,KAAK;AAC1C;;;;;;AAOA,SAAS,eACR,OACA,SACA,OACQ;CACR,MAAM,UAAU,kBAAkB,KAAK;;;;CAKvC,KAAK,MAAM,UAAU,SAAS;EAC7B,IAAI,CAAC,MAAM,YAAY,MAAe,GACrC;EAGD,MAAM,SAAS,OAAO;EAEtB,IAAI,0BAA0B,MAAM,GACnC,MAAM;CAER;;;;CAKA,IAAI,MAAM,kBAAkB,KAAK,GAChC,MAAM,MAAM,OAAO,KAAK;;;;CAMzB,KAAK,MAAM,UAAU,SACpB,IAAI,MAAM,aAAa,MAAe,GAAG;EACxC,MAAM,UAAU,OAAO;EACvB,IACC,OAAO,YAAY,YACnB,YAAY,QACX,QAAoC,SAAS,aAG9C,QAAQ,GADQ,QAA8C,UAAU,CAAC,CACxD;CAEnB;CASD,MAAM,KAFW,0CADD,sBAAsB,KAC2B,CAE/C,CAAC;AACpB;;;;;;;;;;AAWA,SAAgB,sBAAsB,OAAqC;CAC1E,MAAM,UAAU,kBAAkB,KAAK;CAEvC,KAAK,MAAM,UAAU,SACpB,IAAI,MAAM,aAAa,MAAe,GAAG;EAExC,MAAM,UAAU,kBADA,yBAAyB,OAAO,KACR,CAAC;EAEzC,IAAI,YAAY,KAAA,GACf,OAAO;CAET;CAGD,OAAO,iCAAiC;AACzC;AAEA,SAAS,kBAAkB,OAAqD;CAG/E,OAFiB,MAA0D,WAEzD,CAAC;AACpB;AAEA,SAAS,0BAA0B,OAAyB;CAC3D,OAAO,WAAW,KAAK,KAAK,YAAY,KAAK,KAAK,kBAAkB,KAAK;AAC1E;AAEA,SAAS,kBAAkB,OAAoC;CAC9D,IAAI;EACH,OAAO,UAAU,KAAK;CACvB,QAAQ;EACP;CACD;AACD;AAEA,SAAS,yBAAyB,OAAyB;CAC1D,IAAI,CAAC,8BAA8B,KAAK,GACvC,OAAO,8BAA8B;CAKtC,OAF6B,+BAA+B,KAElC,KAAK,8BAA8B;AAC9D;AAEA,SAAS,+BAA+B,OAAgB,uBAAO,IAAI,QAAgB,GAAY;CAC9F,IAAI,OAAO,UAAU,cAAc,OAAO,UAAU,UACnD;CAGD,IAAI,CAAC,eAAe,KAAK,GACxB,OAAO;CAGR,IAAI,kBAAkB,KAAK,MAAM,KAAA,GAChC,OAAO;CAGR,IAAI,mBAAmB,KAAK,GAC3B;CAGD,IAAI,KAAK,IAAI,KAAK,GACjB;CAGD,KAAK,IAAI,KAAK;CAEd,MAAM,eAAe,MAAM,QAAQ,KAAK,IACrC,MAAM,KAAK,SAAS,+BAA+B,MAAM,IAAI,CAAC,IAC9D,gBAAgB,OAAO,IAAI;CAE9B,KAAK,OAAO,KAAK;CAEjB,OAAO;AACR;AAEA,SAAS,gBAAgB,OAAe,MAAgD;CACvF,MAAM,cAAc,OAAO,0BAA0B,KAAK;CAC1D,MAAM,SAAkC,CAAC;CAEzC,KAAK,MAAM,CAAC,KAAK,eAAe,OAAO,QAAQ,WAAW,GAAG;EAC5D,IAAI,QAAQ,WAAW,EAAE,WAAW,aACnC;EAGD,OAAO,OAAO,+BAA+B,WAAW,OAAO,IAAI;CACpE;CAEA,IAAI,iBAAiB,SAAS,EAAE,aAAa,SAC5C,OAAO,UAAU,MAAM;CAGxB,OAAO;AACR;AAEA,SAAS,eAAe,OAAiC;CACxD,OAAO,OAAO,UAAU,YAAY,UAAU;AAC/C;AAEA,SAAS,8BAA8B,OAAyB;CAC/D,OAAO,eAAe,KAAK,KAAK,OAAQ,MAA6B,SAAS;AAC/E;AAEA,SAAS,mBAAmB,OAAwB;CACnD,OACC,CAAC,MAAM,QAAQ,KAAK,KAAK,CAAC,gBAAgB,KAAK,KAAK,CAAC,8BAA8B,KAAK;AAE1F;AAEA,SAAS,gBAAgB,OAAwB;CAChD,MAAM,YAAY,OAAO,eAAe,KAAK;CAE7C,OAAO,cAAc,OAAO,aAAa,cAAc;AACxD;AAEA,SAAS,gCAA8D;CACtE,OAAO,EAAE,SAAS,0CAA0C;AAC7D;AAEA,SAAS,mCAA2C;CACnD,OAAO,UAAU,8BAA8B,CAAC;AACjD;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,iBAAiB,QAA8B,SAA+B;CAC7F,QAAQ,GAAG,MAAM;AAClB;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,8BAA8B,KAAc,aAA4B;CACvF,IAAI,kCAAkC,GAAG,GACxC,OAAO,IAAI,yBAAyB,WAAW;CAGhD,OAAO,eAAe,QAAQ,MAAM,IAAI,kBAAkB,GAAG;AAC9D;AAEA,SAAS,kCAAkC,KAA4B;CACtE,IAAI,EAAE,eAAe,QACpB,OAAO;CAGR,OACC,IAAI,QAAQ,WAAW,iCAAiC,KACxD,IAAI,YAAY;AAElB"}

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

@@ -9,6 +9,13 @@
  * 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
  */
@@ -17,6 +24,11 @@ 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
  */
@@ -26,6 +38,14 @@ export declare const REMOTE_ERROR_DECODER: unique symbol;
  * A single field-level or form-level validation issue reported by a
  * {@link Form} handler.
  *
+ * @example
+ * ```ts
+ * const issue: FormIssue = {
+ *   message: "Use an email address.",
+ *   path: ["email"],
+ * };
+ * ```
+ *
  * @since 2.0.0
  */
 export interface FormIssue {
@@ -39,6 +59,14 @@ export interface FormIssue {
  * failures. The `issues` array is forwarded to SvelteKit's `invalid()`
  * helper on the server and surfaced as `FormError` on the client.
  *
+ * @example
+ * ```ts
+ * const error: FormError = {
+ *   _tag: "FormError",
+ *   issues: [{ message: "Required.", path: ["email"] }],
+ * };
+ * ```
+ *
  * @since 2.0.0
  */
 export interface FormError<SchemaType = unknown> {
@@ -50,6 +78,13 @@ export interface FormError<SchemaType = unknown> {
 /**
  * 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.
@@ -58,6 +93,13 @@ export declare function create_form_error(issues: readonly FormIssue[]): FormErr
 /**
  * Type guard that narrows an unknown value to a {@link FormError}.
  *
+ * @example
+ * ```ts
+ * if (is_form_error(error)) {
+ *   console.log(error.issues);
+ * }
+ * ```
+ *
  * @since 2.0.0
  * @param value - The value to check.
  * @returns `true` when the value is a FormError.
@@ -81,6 +123,15 @@ export type RemoteFailure<ErrorType> = ErrorType | RemoteValidationError | Remot
  * Validation errors that originate from a server-side {@link Form}
  * handler calling `invalid()` (SvelteKit's `fail`).
  *
+ * @example
+ * ```ts
+ * const error: RemoteValidationError = {
+ *   _tag: "RemoteValidationError",
+ *   status: 400,
+ *   issues: [{ message: "Required.", path: ["email"] }],
+ * };
+ * ```
+ *
  * @since 2.0.0
  */
 export interface RemoteValidationError {
@@ -93,6 +144,15 @@ export interface RemoteValidationError {
  * HTTP-level errors with a status code and optional response body. Raised
  * when the server explicitly calls SvelteKit's `error(status, body)`.
  *
+ * @example
+ * ```ts
+ * const error: RemoteHttpError = {
+ *   _tag: "RemoteHttpError",
+ *   status: 404,
+ *   body: { message: "Not found" },
+ * };
+ * ```
+ *
  * @since 2.0.0
  */
 export interface RemoteHttpError {
@@ -105,6 +165,14 @@ export interface RemoteHttpError {
  * Transport-level errors raised by the client adapter when the network
  * request fails or the response cannot be decoded.
  *
+ * @example
+ * ```ts
+ * const error: RemoteTransportError = {
+ *   _tag: "RemoteTransportError",
+ *   cause: new Error("Network unavailable"),
+ * };
+ * ```
+ *
  * @since 2.0.0
  */
 export interface RemoteTransportError {
@@ -116,6 +184,14 @@ export interface RemoteTransportError {
  * 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
  */
@@ -127,6 +203,13 @@ export interface SerializedRemoteFailureEnvelope {
 /**
  * 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.
@@ -138,6 +221,11 @@ export declare function create_remote_validation_error(issues: readonly FormIssu
 /**
  * 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.
@@ -149,6 +237,11 @@ export declare function create_remote_http_error(status: number, body?: unknown,
 /**
  * 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.
@@ -160,6 +253,11 @@ export declare function create_remote_transport_error(cause: unknown, body?: unk
  * 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.
@@ -170,6 +268,13 @@ export declare function create_serialized_remote_failure_envelope(encoded: strin
 /**
  * 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.
@@ -179,6 +284,13 @@ export declare function is_serialized_remote_failure_envelope(value: unknown): v
 /**
  * Checks whether a value is a {@link RemoteValidationError}.
  *
+ * @example
+ * ```ts
+ * if (is_remote_validation_error(error)) {
+ *   console.log(error.issues);
+ * }
+ * ```
+ *
  * @since 2.0.0
  * @param value - The value to check.
  * @returns `true` when the value is a remote validation error.
@@ -187,6 +299,13 @@ export declare function is_remote_validation_error(value: unknown): value is Rem
 /**
  * Checks whether a value is a {@link RemoteHttpError}.
  *
+ * @example
+ * ```ts
+ * if (is_remote_http_error(error)) {
+ *   console.log(error.status);
+ * }
+ * ```
+ *
  * @since 2.0.0
  * @param value - The value to check.
  * @returns `true` when the value is a remote HTTP error.
@@ -195,6 +314,13 @@ export declare function is_remote_http_error(value: unknown): value is RemoteHtt
 /**
  * Checks whether a value is a {@link RemoteTransportError}.
  *
+ * @example
+ * ```ts
+ * if (is_remote_transport_error(error)) {
+ *   console.error(error.cause);
+ * }
+ * ```
+ *
  * @since 2.0.0
  * @param value - The value to check.
  * @returns `true` when the value is a remote transport error.

package/.dist/remote/shared.js

@@ -1,3 +1,4 @@
+import { Schema } from "effect";
 //#region src/remote/shared.ts
 /**
 * Shared types, markers, and constructors used by both the client-side remote
@@ -10,6 +11,13 @@
 * 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
 */
@@ -18,6 +26,11 @@ 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
 */
@@ -25,6 +38,13 @@ const REMOTE_ERROR_DECODER = Symbol.for("svelte-effect-runtime/remote-error-deco
 /**
 * 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.
@@ -38,17 +58,66 @@ function create_form_error(issues) {
 /**
 * Type guard that narrows an unknown value to a {@link FormError}.
 *
+* @example
+* ```ts
+* if (is_form_error(error)) {
+*   console.log(error.issues);
+* }
+* ```
+*
 * @since 2.0.0
 * @param value - The value to check.
 * @returns `true` when the value is a FormError.
 */
 function is_form_error(value) {
-	return typeof value === "object" && value !== null && value._tag === "FormError";
+	return is_form_error_value(value);
 }
+const FormIssuePathSegmentSchema = Schema.Union([Schema.String, Schema.Number]);
+const FormIssueSchema = Schema.Struct({
+	message: Schema.String,
+	path: Schema.Array(FormIssuePathSegmentSchema)
+});
+const FormErrorSchema = Schema.Struct({
+	_tag: Schema.Literal("FormError"),
+	issues: Schema.Array(FormIssueSchema)
+});
+const SerializedRemoteFailureEnvelopeSchema = Schema.Struct({
+	__svelte_effect_remote__: Schema.Literal(true),
+	encoded: Schema.String
+});
+const RemoteValidationErrorSchema = Schema.Struct({
+	_tag: Schema.Literal("RemoteValidationError"),
+	body: Schema.optional(Schema.Unknown),
+	issues: Schema.optional(Schema.Array(FormIssueSchema)),
+	status: Schema.Number
+});
+const RemoteHttpErrorSchema = Schema.Struct({
+	_tag: Schema.Literal("RemoteHttpError"),
+	body: Schema.optional(Schema.Unknown),
+	cause: Schema.optional(Schema.Unknown),
+	status: Schema.Number
+});
+const RemoteTransportErrorSchema = Schema.Struct({
+	_tag: Schema.Literal("RemoteTransportError"),
+	body: Schema.optional(Schema.Unknown),
+	cause: Schema.optional(Schema.Unknown)
+});
+const is_form_error_value = Schema.is(FormErrorSchema);
+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.
@@ -67,6 +136,11 @@ function create_remote_validation_error(issues, body, status = 400) {
 /**
 * 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.
@@ -85,6 +159,11 @@ function create_remote_http_error(status, body, 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.
@@ -102,6 +181,11 @@ function create_remote_transport_error(cause, 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.
@@ -117,43 +201,71 @@ function create_serialized_remote_failure_envelope(encoded) {
 /**
 * 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 typeof value === "object" && value !== null && value.__svelte_effect_remote__ === true;
+	return is_serialized_remote_failure_envelope_value(value);
 }
 /**
 * Checks whether a value is a {@link RemoteValidationError}.
 *
+* @example
+* ```ts
+* if (is_remote_validation_error(error)) {
+*   console.log(error.issues);
+* }
+* ```
+*
 * @since 2.0.0
 * @param value - The value to check.
 * @returns `true` when the value is a remote validation error.
 */
 function is_remote_validation_error(value) {
-	return typeof value === "object" && value !== null && value._tag === "RemoteValidationError";
+	return is_remote_validation_error_value(value);
 }
 /**
 * Checks whether a value is a {@link RemoteHttpError}.
 *
+* @example
+* ```ts
+* if (is_remote_http_error(error)) {
+*   console.log(error.status);
+* }
+* ```
+*
 * @since 2.0.0
 * @param value - The value to check.
 * @returns `true` when the value is a remote HTTP error.
 */
 function is_remote_http_error(value) {
-	return typeof value === "object" && value !== null && value._tag === "RemoteHttpError";
+	return is_remote_http_error_value(value);
 }
 /**
 * Checks whether a value is a {@link RemoteTransportError}.
 *
+* @example
+* ```ts
+* if (is_remote_transport_error(error)) {
+*   console.error(error.cause);
+* }
+* ```
+*
 * @since 2.0.0
 * @param value - The value to check.
 * @returns `true` when the value is a remote transport error.
 */
 function is_remote_transport_error(value) {
-	return typeof value === "object" && value !== null && value._tag === "RemoteTransportError";
+	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 };