svelte-effect-runtime 1.6.1 → 2.0.0-beta.1

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

@@ -1,186 +0,0 @@
-/**
- * Marker property name placed on serialized `RemoteFailure` envelopes so the
- * client adapters can recognise server-produced failure payloads.
- *
- * @internal Internal - do not use.
- */
-export declare const EFFECT_REMOTE_ERROR_MARKER = "__svelte_effect_remote__";
-/**
- * Well-known symbol used to attach a payload decoder to a remote function,
- * enabling the client to reconstruct typed domain errors from wire data.
- *
- * @internal Internal - do not use.
- */
-export declare const REMOTE_ERROR_DECODER: unique symbol;
-/**
- * A single validation problem surfaced by a remote form or schema check.
- * Mirrors SvelteKit's `invalid()` issue shape.
- */
-export interface FormIssue {
-    /** Human-readable description of the failure at {@link FormIssue.path}. */
-    readonly message: string;
-    /** Field path (dot or array-index segments) the issue applies to. */
-    readonly path: ReadonlyArray<string | number>;
-}
-/**
- * Typed error produced by `invalid.form(...)` / `invalid.<field>(...)` helpers
- * inside a `Form` handler. Carries the collected `FormIssue`s to surface to
- * the browser.
- */
-export interface FormError<SchemaType = unknown> {
-    /** Discriminator identifying this as a form error. */
-    readonly _tag: "FormError";
-    /** Issues produced by the handler, one per failed field. */
-    readonly issues: ReadonlyArray<FormIssue>;
-    /**
-     * Phantom reference to the originating schema. Used purely for type
-     * inference of field helpers.
-     */
-    readonly _schema?: SchemaType | undefined;
-}
-/**
- * Legacy wrapper around a typed server-side domain error value.
- *
- * @deprecated Tagged remote domain errors are no longer wrapped in
- * `RemoteDomainError`. The user's own tagged error is now placed directly on
- * the Effect error channel so `Effect.catchTag("YourTag", ...)` works without
- * unwrapping. This interface is kept only for backwards compatibility with
- * code that pattern-matched on `_tag === "RemoteDomainError"`.
- */
-export interface RemoteDomainError<ErrorType = unknown> {
-    /** Discriminator identifying this variant of `RemoteFailure`. */
-    readonly _tag: "RemoteDomainError";
-    /** The original typed error value produced on the server. */
-    readonly cause: ErrorType;
-    /** HTTP status code associated with the failure. */
-    readonly status: number;
-}
-/**
- * Remote failure emitted when request validation (schema or form) rejects the
- * payload. Defaults to HTTP `400`, but callers may override the status code
- * when constructing the value.
- */
-export interface RemoteValidationError {
-    /** Discriminator identifying this variant of `RemoteFailure`. */
-    readonly _tag: "RemoteValidationError";
-    /** Raw response body returned alongside the failure, when available. */
-    readonly body?: unknown;
-    /** Validation issues, keyed by field path. */
-    readonly issues: ReadonlyArray<FormIssue>;
-    /** HTTP status code for the validation failure, defaulting to `400`. */
-    readonly status: number;
-}
-/**
- * Remote failure for HTTP-level errors returned by the server that do not map
- * onto a typed domain error or validation failure.
- */
-export interface RemoteHttpError {
-    /** Discriminator identifying this variant of `RemoteFailure`. */
-    readonly _tag: "RemoteHttpError";
-    /** Parsed response body, if any. */
-    readonly body?: unknown;
-    /** Original thrown value captured while handling the response. */
-    readonly cause: unknown;
-    /** HTTP status code reported by the response. */
-    readonly status: number;
-}
-/**
- * Remote failure for transport-level breakages (network errors, decoding
- * failures). Does not carry an HTTP status.
- */
-export interface RemoteTransportError {
-    /** Discriminator identifying this variant of `RemoteFailure`. */
-    readonly _tag: "RemoteTransportError";
-    /** Raw body captured when the transport failure was detected, if any. */
-    readonly body?: unknown;
-    /** Underlying error value - usually a `TypeError` or `DOMException`. */
-    readonly cause: unknown;
-}
-/**
- * Error channel produced by every remote Effect wrapper. A server-side
- * `Effect.fail(MyTaggedError)` surfaces on the client as the raw `ErrorType`,
- * so `Effect.catchTag("MyTag", ...)` narrows directly to your error. The
- * framework-level failure variants (`RemoteValidationError`,
- * `RemoteHttpError`, `RemoteTransportError`) are still included for transport
- * and HTTP failures that the caller didn't model explicitly.
- */
-export type RemoteFailure<ErrorType = unknown> = ErrorType | RemoteValidationError | RemoteHttpError | RemoteTransportError;
-/**
- * Wire shape of a serialised remote failure envelope that the server embeds
- * in its response body.
- *
- * @internal Internal - do not use.
- */
-export interface SerializedRemoteFailureEnvelope {
-    /** Marker flag; always `true`. */
-    readonly [EFFECT_REMOTE_ERROR_MARKER]: true;
-    /** `devalue.stringify`-encoded payload for the failure value. */
-    readonly encoded: string;
-}
-/**
- * Construct a {@link FormError} from one or more {@link FormIssue}s.
- *
- * @internal Internal - do not use.
- */
-export declare function create_form_error<SchemaType = unknown>(...issues: Array<FormIssue>): FormError<SchemaType>;
-/**
- * Build a {@link RemoteDomainError} around a typed server-side error value.
- *
- * @deprecated Remote tagged failures are no longer wrapped - the user's
- * tagged error is forwarded directly on the Effect error channel. This helper
- * is retained for backwards compatibility with downstream code that still
- * constructs `RemoteDomainError` values explicitly.
- *
- * @internal Internal - do not use.
- */
-export declare function create_remote_domain_error<ErrorType = unknown>(cause: ErrorType, status: number): RemoteDomainError<ErrorType>;
-/**
- * Build a {@link RemoteValidationError} from a list of issues.
- *
- * @internal Internal - do not use.
- */
-export declare function create_remote_validation_error(issues: ReadonlyArray<FormIssue>, options?: {
-    body?: unknown;
-    status?: number;
-}): RemoteValidationError;
-/**
- * Build a {@link RemoteHttpError} from an arbitrary thrown value.
- *
- * @internal Internal - do not use.
- */
-export declare function create_remote_http_error(cause: unknown, options?: {
-    body?: unknown;
-    status?: number;
-}): RemoteHttpError;
-/**
- * Build a {@link RemoteTransportError} from an arbitrary thrown value.
- *
- * @internal Internal - do not use.
- */
-export declare function create_remote_transport_error(cause: unknown, body?: unknown): RemoteTransportError;
-/**
- * Wrap a pre-encoded failure payload in the marker envelope the client
- * adapters look for when decoding responses.
- *
- * @internal Internal - do not use.
- */
-export declare function create_serialized_remote_failure_envelope(encoded: string): SerializedRemoteFailureEnvelope;
-/**
- * Type guard for {@link FormError} values.
- *
- * @internal Internal - do not use.
- */
-export declare function is_form_error(value: unknown): value is FormError;
-/**
- * Type guard recognising the marker envelope wrapping an encoded remote
- * failure payload.
- *
- * @internal Internal - do not use.
- */
-export declare function is_serialized_remote_failure_envelope(value: unknown): value is SerializedRemoteFailureEnvelope;
-/**
- * Type guard for individual {@link FormIssue} values.
- *
- * @internal Internal - do not use.
- */
-export declare function is_remote_validation_issue(value: unknown): value is FormIssue;

package/dist/internal/remote-shared.js

@@ -1,122 +0,0 @@
-//#region internal/remote-shared.ts
-/**
-* Marker property name placed on serialized `RemoteFailure` envelopes so the
-* client adapters can recognise server-produced failure payloads.
-*
-* @internal Internal - do not use.
-*/
-const EFFECT_REMOTE_ERROR_MARKER = "__svelte_effect_remote__";
-/**
-* Well-known symbol used to attach a payload decoder to a remote function,
-* enabling the client to reconstruct typed domain errors from wire data.
-*
-* @internal Internal - do not use.
-*/
-const REMOTE_ERROR_DECODER = Symbol.for("svelte-effect-runtime/remote-error-decoder");
-/**
-* Construct a {@link FormError} from one or more {@link FormIssue}s.
-*
-* @internal Internal - do not use.
-*/
-function create_form_error(...issues) {
-	return {
-		_tag: "FormError",
-		issues
-	};
-}
-/**
-* Build a {@link RemoteDomainError} around a typed server-side error value.
-*
-* @deprecated Remote tagged failures are no longer wrapped - the user's
-* tagged error is forwarded directly on the Effect error channel. This helper
-* is retained for backwards compatibility with downstream code that still
-* constructs `RemoteDomainError` values explicitly.
-*
-* @internal Internal - do not use.
-*/
-function create_remote_domain_error(cause, status) {
-	return {
-		_tag: "RemoteDomainError",
-		cause,
-		status
-	};
-}
-/**
-* Build a {@link RemoteValidationError} from a list of issues.
-*
-* @internal Internal - do not use.
-*/
-function create_remote_validation_error(issues, options = {}) {
-	return {
-		_tag: "RemoteValidationError",
-		body: options.body,
-		issues,
-		status: options.status ?? 400
-	};
-}
-/**
-* Build a {@link RemoteHttpError} from an arbitrary thrown value.
-*
-* @internal Internal - do not use.
-*/
-function create_remote_http_error(cause, options = {}) {
-	return {
-		_tag: "RemoteHttpError",
-		body: options.body,
-		cause,
-		status: options.status ?? 500
-	};
-}
-/**
-* Build a {@link RemoteTransportError} from an arbitrary thrown value.
-*
-* @internal Internal - do not use.
-*/
-function create_remote_transport_error(cause, body) {
-	return {
-		_tag: "RemoteTransportError",
-		body,
-		cause
-	};
-}
-/**
-* Wrap a pre-encoded failure payload in the marker envelope the client
-* adapters look for when decoding responses.
-*
-* @internal Internal - do not use.
-*/
-function create_serialized_remote_failure_envelope(encoded) {
-	return {
-		[EFFECT_REMOTE_ERROR_MARKER]: true,
-		encoded
-	};
-}
-/**
-* Type guard for {@link FormError} values.
-*
-* @internal Internal - do not use.
-*/
-function is_form_error(value) {
-	return Boolean(value && typeof value === "object" && value._tag === "FormError" && Array.isArray(value.issues));
-}
-/**
-* Type guard recognising the marker envelope wrapping an encoded remote
-* failure payload.
-*
-* @internal Internal - do not use.
-*/
-function is_serialized_remote_failure_envelope(value) {
-	return Boolean(value && typeof value === "object" && "__svelte_effect_remote__" in value && value["__svelte_effect_remote__"] === true && typeof value.encoded === "string");
-}
-/**
-* Type guard for individual {@link FormIssue} values.
-*
-* @internal Internal - do not use.
-*/
-function is_remote_validation_issue(value) {
-	return Boolean(value && typeof value === "object" && typeof value.message === "string" && Array.isArray(value.path));
-}
-//#endregion
-export { EFFECT_REMOTE_ERROR_MARKER, REMOTE_ERROR_DECODER, create_form_error, create_remote_domain_error, create_remote_http_error, create_remote_transport_error, create_remote_validation_error, create_serialized_remote_failure_envelope, is_form_error, is_remote_validation_issue, is_serialized_remote_failure_envelope };
-
-//# sourceMappingURL=remote-shared.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"remote-shared.js","names":[],"sources":["../../../modules/svelte-effect-runtime/internal/remote-shared.ts"],"sourcesContent":["/**\n * Marker property name placed on serialized `RemoteFailure` envelopes so the\n * client adapters can recognise server-produced failure payloads.\n *\n * @internal Internal - do not use.\n */\nexport const EFFECT_REMOTE_ERROR_MARKER = \"__svelte_effect_remote__\";\n/**\n * Well-known symbol used to attach a payload decoder to a remote function,\n * enabling the client to reconstruct typed domain errors from wire data.\n *\n * @internal Internal - do not use.\n */\nexport const REMOTE_ERROR_DECODER = Symbol.for(\n  \"svelte-effect-runtime/remote-error-decoder\",\n);\n\n/**\n * A single validation problem surfaced by a remote form or schema check.\n * Mirrors SvelteKit's `invalid()` issue shape.\n */\nexport interface FormIssue {\n  /** Human-readable description of the failure at {@link FormIssue.path}. */\n  readonly message: string;\n  /** Field path (dot or array-index segments) the issue applies to. */\n  readonly path: ReadonlyArray<string | number>;\n}\n\n/**\n * Typed error produced by `invalid.form(...)` / `invalid.<field>(...)` helpers\n * inside a `Form` handler. Carries the collected `FormIssue`s to surface to\n * the browser.\n */\nexport interface FormError<SchemaType = unknown> {\n  /** Discriminator identifying this as a form error. */\n  readonly _tag: \"FormError\";\n  /** Issues produced by the handler, one per failed field. */\n  readonly issues: ReadonlyArray<FormIssue>;\n  /**\n   * Phantom reference to the originating schema. Used purely for type\n   * inference of field helpers.\n   */\n  readonly _schema?: SchemaType | undefined;\n}\n\n/**\n * Legacy wrapper around a typed server-side domain error value.\n *\n * @deprecated Tagged remote domain errors are no longer wrapped in\n * `RemoteDomainError`. The user's own tagged error is now placed directly on\n * the Effect error channel so `Effect.catchTag(\"YourTag\", ...)` works without\n * unwrapping. This interface is kept only for backwards compatibility with\n * code that pattern-matched on `_tag === \"RemoteDomainError\"`.\n */\nexport interface RemoteDomainError<ErrorType = unknown> {\n  /** Discriminator identifying this variant of `RemoteFailure`. */\n  readonly _tag: \"RemoteDomainError\";\n  /** The original typed error value produced on the server. */\n  readonly cause: ErrorType;\n  /** HTTP status code associated with the failure. */\n  readonly status: number;\n}\n\n/**\n * Remote failure emitted when request validation (schema or form) rejects the\n * payload. Defaults to HTTP `400`, but callers may override the status code\n * when constructing the value.\n */\nexport interface RemoteValidationError {\n  /** Discriminator identifying this variant of `RemoteFailure`. */\n  readonly _tag: \"RemoteValidationError\";\n  /** Raw response body returned alongside the failure, when available. */\n  readonly body?: unknown;\n  /** Validation issues, keyed by field path. */\n  readonly issues: ReadonlyArray<FormIssue>;\n  /** HTTP status code for the validation failure, defaulting to `400`. */\n  readonly status: number;\n}\n\n/**\n * Remote failure for HTTP-level errors returned by the server that do not map\n * onto a typed domain error or validation failure.\n */\nexport interface RemoteHttpError {\n  /** Discriminator identifying this variant of `RemoteFailure`. */\n  readonly _tag: \"RemoteHttpError\";\n  /** Parsed response body, if any. */\n  readonly body?: unknown;\n  /** Original thrown value captured while handling the response. */\n  readonly cause: unknown;\n  /** HTTP status code reported by the response. */\n  readonly status: number;\n}\n\n/**\n * Remote failure for transport-level breakages (network errors, decoding\n * failures). Does not carry an HTTP status.\n */\nexport interface RemoteTransportError {\n  /** Discriminator identifying this variant of `RemoteFailure`. */\n  readonly _tag: \"RemoteTransportError\";\n  /** Raw body captured when the transport failure was detected, if any. */\n  readonly body?: unknown;\n  /** Underlying error value - usually a `TypeError` or `DOMException`. */\n  readonly cause: unknown;\n}\n\n/**\n * Error channel produced by every remote Effect wrapper. A server-side\n * `Effect.fail(MyTaggedError)` surfaces on the client as the raw `ErrorType`,\n * so `Effect.catchTag(\"MyTag\", ...)` narrows directly to your error. The\n * framework-level failure variants (`RemoteValidationError`,\n * `RemoteHttpError`, `RemoteTransportError`) are still included for transport\n * and HTTP failures that the caller didn't model explicitly.\n */\nexport type RemoteFailure<ErrorType = unknown> =\n  | ErrorType\n  | RemoteValidationError\n  | RemoteHttpError\n  | RemoteTransportError;\n\n/**\n * Wire shape of a serialised remote failure envelope that the server embeds\n * in its response body.\n *\n * @internal Internal - do not use.\n */\nexport interface SerializedRemoteFailureEnvelope {\n  /** Marker flag; always `true`. */\n  readonly [EFFECT_REMOTE_ERROR_MARKER]: true;\n  /** `devalue.stringify`-encoded payload for the failure value. */\n  readonly encoded: string;\n}\n\n/**\n * Construct a {@link FormError} from one or more {@link FormIssue}s.\n *\n * @internal Internal - do not use.\n */\nexport function create_form_error<SchemaType = unknown>(\n  ...issues: Array<FormIssue>\n): FormError<SchemaType> {\n  return {\n    _tag: \"FormError\",\n    issues,\n  };\n}\n\n/**\n * Build a {@link RemoteDomainError} around a typed server-side error value.\n *\n * @deprecated Remote tagged failures are no longer wrapped - the user's\n * tagged error is forwarded directly on the Effect error channel. This helper\n * is retained for backwards compatibility with downstream code that still\n * constructs `RemoteDomainError` values explicitly.\n *\n * @internal Internal - do not use.\n */\nexport function create_remote_domain_error<ErrorType = unknown>(\n  cause: ErrorType,\n  status: number,\n): RemoteDomainError<ErrorType> {\n  return {\n    _tag: \"RemoteDomainError\",\n    cause,\n    status,\n  };\n}\n\n/**\n * Build a {@link RemoteValidationError} from a list of issues.\n *\n * @internal Internal - do not use.\n */\nexport function create_remote_validation_error(\n  issues: ReadonlyArray<FormIssue>,\n  options: {\n    body?: unknown;\n    status?: number;\n  } = {},\n): RemoteValidationError {\n  return {\n    _tag: \"RemoteValidationError\",\n    body: options.body,\n    issues,\n    status: options.status ?? 400,\n  };\n}\n\n/**\n * Build a {@link RemoteHttpError} from an arbitrary thrown value.\n *\n * @internal Internal - do not use.\n */\nexport function create_remote_http_error(\n  cause: unknown,\n  options: {\n    body?: unknown;\n    status?: number;\n  } = {},\n): RemoteHttpError {\n  return {\n    _tag: \"RemoteHttpError\",\n    body: options.body,\n    cause,\n    status: options.status ?? 500,\n  };\n}\n\n/**\n * Build a {@link RemoteTransportError} from an arbitrary thrown value.\n *\n * @internal Internal - do not use.\n */\nexport function create_remote_transport_error(\n  cause: unknown,\n  body?: unknown,\n): RemoteTransportError {\n  return {\n    _tag: \"RemoteTransportError\",\n    body,\n    cause,\n  };\n}\n\n/**\n * Wrap a pre-encoded failure payload in the marker envelope the client\n * adapters look for when decoding responses.\n *\n * @internal Internal - do not use.\n */\nexport function create_serialized_remote_failure_envelope(\n  encoded: string,\n): SerializedRemoteFailureEnvelope {\n  return {\n    [EFFECT_REMOTE_ERROR_MARKER]: true,\n    encoded,\n  };\n}\n\n/**\n * Type guard for {@link FormError} values.\n *\n * @internal Internal - do not use.\n */\nexport function is_form_error(value: unknown): value is FormError {\n  return Boolean(\n    value &&\n      typeof value === \"object\" &&\n      (value as { _tag?: unknown })._tag === \"FormError\" &&\n      Array.isArray((value as { issues?: unknown }).issues),\n  );\n}\n\n/**\n * Type guard recognising the marker envelope wrapping an encoded remote\n * failure payload.\n *\n * @internal Internal - do not use.\n */\nexport function is_serialized_remote_failure_envelope(\n  value: unknown,\n): value is SerializedRemoteFailureEnvelope {\n  return Boolean(\n    value &&\n      typeof value === \"object\" &&\n      EFFECT_REMOTE_ERROR_MARKER in value &&\n      (value as Record<string, unknown>)[EFFECT_REMOTE_ERROR_MARKER] === true &&\n      typeof (value as { encoded?: unknown }).encoded === \"string\",\n  );\n}\n\n/**\n * Type guard for individual {@link FormIssue} values.\n *\n * @internal Internal - do not use.\n */\nexport function is_remote_validation_issue(\n  value: unknown,\n): value is FormIssue {\n  return Boolean(\n    value &&\n      typeof value === \"object\" &&\n      typeof (value as { message?: unknown }).message === \"string\" &&\n      Array.isArray((value as { path?: unknown }).path),\n  );\n}\n"],"mappings":";;;;;;;AAMA,MAAa,6BAA6B;;;;;;;AAO1C,MAAa,uBAAuB,OAAO,IACzC,6CACD;;;;;;AA4HD,SAAgB,kBACd,GAAG,QACoB;AACvB,QAAO;EACL,MAAM;EACN;EACD;;;;;;;;;;;;AAaH,SAAgB,2BACd,OACA,QAC8B;AAC9B,QAAO;EACL,MAAM;EACN;EACA;EACD;;;;;;;AAQH,SAAgB,+BACd,QACA,UAGI,EAAE,EACiB;AACvB,QAAO;EACL,MAAM;EACN,MAAM,QAAQ;EACd;EACA,QAAQ,QAAQ,UAAU;EAC3B;;;;;;;AAQH,SAAgB,yBACd,OACA,UAGI,EAAE,EACW;AACjB,QAAO;EACL,MAAM;EACN,MAAM,QAAQ;EACd;EACA,QAAQ,QAAQ,UAAU;EAC3B;;;;;;;AAQH,SAAgB,8BACd,OACA,MACsB;AACtB,QAAO;EACL,MAAM;EACN;EACA;EACD;;;;;;;;AASH,SAAgB,0CACd,SACiC;AACjC,QAAO;GACJ,6BAA6B;EAC9B;EACD;;;;;;;AAQH,SAAgB,cAAc,OAAoC;AAChE,QAAO,QACL,SACE,OAAO,UAAU,YAChB,MAA6B,SAAS,eACvC,MAAM,QAAS,MAA+B,OAAO,CACxD;;;;;;;;AASH,SAAgB,sCACd,OAC0C;AAC1C,QAAO,QACL,SACE,OAAO,UAAU,YAAA,8BACa,SAC7B,MAAA,gCAAkE,QACnE,OAAQ,MAAgC,YAAY,SACvD;;;;;;;AAQH,SAAgB,2BACd,OACoB;AACpB,QAAO,QACL,SACE,OAAO,UAAU,YACjB,OAAQ,MAAgC,YAAY,YACpD,MAAM,QAAS,MAA6B,KAAK,CACpD"}

package/dist/internal/transform.d.ts

@@ -1,18 +0,0 @@
-import { type SourceMap } from "magic-string";
-import type { EffectPreprocessOptions } from "../preprocess.js";
-interface TransformEffectScriptOptions extends EffectPreprocessOptions {
-    filename: string;
-}
-interface TransformEffectScriptResult {
-    code: string;
-    map: SourceMap;
-    relocations: Array<TransformRelocation>;
-}
-interface TransformRelocation {
-    originalStart: number;
-    originalEnd: number;
-    generatedStart: number;
-    generatedEnd: number;
-}
-export declare function transformEffectScript(content: string, options: TransformEffectScriptOptions): TransformEffectScriptResult;
-export {};