svelte-effect-runtime 3.4.5 → 3.4.7

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 };

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

@@ -1 +1 @@
-{"version":3,"file":"shared.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/remote/shared.ts"],"sourcesContent":["/**\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 * @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 * @since 2.0.0\n * @internal\n */\nexport const REMOTE_ERROR_DECODER = Symbol.for(\n  \"svelte-effect-runtime/remote-error-decoder\",\n);\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 * @since 2.0.0\n */\nexport interface FormIssue {\n  /** Human-readable validation message. */\n  message: string;\n  /** Path to the offending field as an array of string-or-number keys. */\n  path: (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 * @since 2.0.0\n */\nexport interface FormError<SchemaType = unknown> {\n  readonly _tag: \"FormError\";\n  readonly issues: readonly FormIssue[];\n  /** Phantom type slot for the schema this error was derived from. */\n  readonly _schema?: SchemaType;\n}\n\n/**\n * Creates a {@link FormError} holding the given issues.\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  return { _tag: \"FormError\", issues };\n}\n\n/**\n * Type guard that narrows an unknown value to a {@link FormError}.\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  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as Record<string, unknown>)._tag === \"FormError\"\n  );\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  | ErrorType\n  | RemoteValidationError\n  | RemoteHttpError\n  | RemoteTransportError;\n\n/**\n * Validation errors that originate from a server-side {@link Form}\n * handler calling `invalid()` (SvelteKit's `fail`).\n *\n * @since 2.0.0\n */\nexport interface RemoteValidationError {\n  readonly _tag: \"RemoteValidationError\";\n  readonly issues?: readonly FormIssue[];\n  readonly body?: unknown;\n  readonly 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 * @since 2.0.0\n */\nexport interface RemoteHttpError {\n  readonly _tag: \"RemoteHttpError\";\n  readonly status: number;\n  readonly body?: unknown;\n  readonly 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 * @since 2.0.0\n */\nexport interface RemoteTransportError {\n  readonly _tag: \"RemoteTransportError\";\n  readonly cause?: unknown;\n  readonly 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 * @since 2.0.0\n * @internal\n */\nexport interface SerializedRemoteFailureEnvelope {\n  readonly __svelte_effect_remote__: true;\n  readonly encoded: string;\n}\n\n/** Constructors for structured remote error values. */\n\n/**\n * Creates a {@link RemoteValidationError} from a list of form issues.\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  issues: readonly FormIssue[],\n  body?: unknown,\n  status = 400,\n): RemoteValidationError {\n\n  return { _tag: \"RemoteValidationError\", issues, body, status };\n}\n\n/**\n * Creates a {@link RemoteHttpError} for a given HTTP status.\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  status: number,\n  body?: unknown,\n  cause?: unknown,\n): RemoteHttpError {\n\n  return { _tag: \"RemoteHttpError\", status, body, cause };\n}\n\n/**\n * Creates a {@link RemoteTransportError} for network or decode failures.\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  cause: unknown,\n  body?: unknown,\n): RemoteTransportError {\n\n  return { _tag: \"RemoteTransportError\", cause, body };\n}\n\n/**\n * Wraps a devalue-encoded error string inside a\n * {@link SerializedRemoteFailureEnvelope}.\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  encoded: string,\n): SerializedRemoteFailureEnvelope {\n\n  return { __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 * @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  value: unknown,\n): value is SerializedRemoteFailureEnvelope {\n\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as Record<string, unknown>).__svelte_effect_remote__ === true\n  );\n}\n\n/**\n * Checks whether a value is a {@link RemoteValidationError}.\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(\n  value: unknown,\n): value is RemoteValidationError {\n\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as Record<string, unknown>)._tag === \"RemoteValidationError\"\n  );\n}\n\n/**\n * Checks whether a value is a {@link RemoteHttpError}.\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(\n  value: unknown,\n): value is RemoteHttpError {\n\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as Record<string, unknown>)._tag === \"RemoteHttpError\"\n  );\n}\n\n/**\n * Checks whether a value is a {@link RemoteTransportError}.\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(\n  value: unknown,\n): value is RemoteTransportError {\n\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as Record<string, unknown>)._tag === \"RemoteTransportError\"\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,6BAA6B;;;;;;;;AAS1C,MAAa,uBAAuB,OAAO,IACzC,4CACF;;;;;;;;AAsCA,SAAgB,kBAAkB,QAAyC;CACzE,OAAO;EAAE,MAAM;EAAa;CAAO;AACrC;;;;;;;;AASA,SAAgB,cAAc,OAAoC;CAChE,OACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,SAAS;AAEhD;;;;;;;;;;;;AAoFA,SAAgB,+BACd,QACA,MACA,SAAS,KACc;CAEvB,OAAO;EAAE,MAAM;EAAyB;EAAQ;EAAM;CAAO;AAC/D;;;;;;;;;;;AAYA,SAAgB,yBACd,QACA,MACA,OACiB;CAEjB,OAAO;EAAE,MAAM;EAAmB;EAAQ;EAAM;CAAM;AACxD;;;;;;;;;;AAWA,SAAgB,8BACd,OACA,MACsB;CAEtB,OAAO;EAAE,MAAM;EAAwB;EAAO;CAAK;AACrD;;;;;;;;;;AAWA,SAAgB,0CACd,SACiC;CAEjC,OAAO;EAAE,0BAA0B;EAAM;CAAQ;AACnD;;;;;;;;;;AAYA,SAAgB,sCACd,OAC0C;CAE1C,OACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,6BAA6B;AAEpE;;;;;;;;AASA,SAAgB,2BACd,OACgC;CAEhC,OACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,SAAS;AAEhD;;;;;;;;AASA,SAAgB,qBACd,OAC0B;CAE1B,OACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,SAAS;AAEhD;;;;;;;;AASA,SAAgB,0BACd,OAC+B;CAE/B,OACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,SAAS;AAEhD"}
+{"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"}

package/.dist/runtime/transform.js

@@ -1,8 +1,8 @@
-import { d as PreprocessError, r as AwaitInEffectWorkError } from "../chunks/errors-0PaWf7Bq.js";
-import { a as is_yield_star_expression, c as slice, d as collect_top_level_binding_names, f as has_local_import_binding, i as find_yield_star_node, l as slice_start, n as collect_yield_star_nodes, o as validate_rune_yield_usage, p as make_imports, r as contains_top_level_await, s as create_source_map, t as transform_markup_effect, u as collect_free_identifiers } from "../chunks/transform-Cdsx7ygD.js";
+import { d as PreprocessError, r as AwaitInEffectWorkError } from "../chunks/errors-Dcf0MVbq.js";
+import { a as is_yield_star_expression, c as slice, d as collect_top_level_binding_names, f as has_local_import_binding, i as find_yield_star_node, l as slice_start, n as collect_yield_star_nodes, o as validate_rune_yield_usage, p as make_imports, r as contains_top_level_await, s as create_source_map, t as transform_markup_effect, u as collect_free_identifiers } from "../chunks/transform-CEK6Ccll.js";
 import { contains_top_level_yield_star } from "../detect.js";
-import MagicString from "magic-string";
 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