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

package/.dist/remote/shared.js

@@ -0,0 +1,161 @@
+//#region src/remote/shared.ts
+/**
+* Shared types, markers, and constructors used by both the client-side remote
+* adapters and the server-side handler runtime. These types define the error
+* protocol that flows across the network boundary.
+*
+* @since 2.0.0
+*/
+/**
+* Well-known marker injected into every serialised remote-failure envelope
+* so the client can reliably distinguish runtime errors from domain values.
+*
+* @since 2.0.0
+* @internal
+*/
+const EFFECT_REMOTE_ERROR_MARKER = "__svelte_effect_remote__";
+/**
+* Well-known symbol used to attach a payload decoder to a remote function
+* so the client's transport layer can decode domain error types.
+*
+* @since 2.0.0
+* @internal
+*/
+const REMOTE_ERROR_DECODER = Symbol.for("svelte-effect-runtime/remote-error-decoder");
+/**
+* Creates a {@link FormError} holding the given issues.
+*
+* @since 2.0.0
+* @param issues - The validation issues to attach.
+* @returns A FormError with the `_tag` set and no schema reference.
+*/
+function create_form_error(issues) {
+	return {
+		_tag: "FormError",
+		issues
+	};
+}
+/**
+* Type guard that narrows an unknown value to a {@link FormError}.
+*
+* @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";
+}
+/** Constructors for structured remote error values. */
+/**
+* Creates a {@link RemoteValidationError} from a list of form issues.
+*
+* @since 2.0.0
+* @param issues - The validation issues reported by the server handler.
+* @param body - Optional response body returned alongside the error.
+* @param status - HTTP status code (defaults to 400).
+* @returns A remote-validation error shape.
+* @internal
+*/
+function create_remote_validation_error(issues, body, status = 400) {
+	return {
+		_tag: "RemoteValidationError",
+		issues,
+		body,
+		status
+	};
+}
+/**
+* Creates a {@link RemoteHttpError} for a given HTTP status.
+*
+* @since 2.0.0
+* @param status - The HTTP status code.
+* @param body - Optional response body.
+* @param cause - Optional underlying cause.
+* @returns A remote HTTP error shape.
+* @internal
+*/
+function create_remote_http_error(status, body, cause) {
+	return {
+		_tag: "RemoteHttpError",
+		status,
+		body,
+		cause
+	};
+}
+/**
+* Creates a {@link RemoteTransportError} for network or decode failures.
+*
+* @since 2.0.0
+* @param cause - The underlying error that caused the transport failure.
+* @param body - Optional response body if one was received.
+* @returns A remote transport error shape.
+* @internal
+*/
+function create_remote_transport_error(cause, body) {
+	return {
+		_tag: "RemoteTransportError",
+		cause,
+		body
+	};
+}
+/**
+* Wraps a devalue-encoded error string inside a
+* {@link SerializedRemoteFailureEnvelope}.
+*
+* @since 2.0.0
+* @param encoded - The devalue-encoded error value.
+* @returns The wire-format envelope.
+* @internal
+*/
+function create_serialized_remote_failure_envelope(encoded) {
+	return {
+		__svelte_effect_remote__: true,
+		encoded
+	};
+}
+/** Type guards for structured remote error values. */
+/**
+* Checks whether a value is a {@link SerializedRemoteFailureEnvelope}.
+*
+* @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;
+}
+/**
+* Checks whether a value is a {@link RemoteValidationError}.
+*
+* @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";
+}
+/**
+* Checks whether a value is a {@link RemoteHttpError}.
+*
+* @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";
+}
+/**
+* Checks whether a value is a {@link RemoteTransportError}.
+*
+* @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";
+}
+//#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 };
+
+//# sourceMappingURL=shared.js.map

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

@@ -0,0 +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,6CACD;;;;;;;;AAsCD,SAAgB,kBAAkB,QAAyC;AACzE,QAAO;EAAE,MAAM;EAAa;EAAQ;;;;;;;;;AAUtC,SAAgB,cAAc,OAAoC;AAChE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,SAAS;;;;;;;;;;;;;AAsFhD,SAAgB,+BACd,QACA,MACA,SAAS,KACc;AAEvB,QAAO;EAAE,MAAM;EAAyB;EAAQ;EAAM;EAAQ;;;;;;;;;;;;AAahE,SAAgB,yBACd,QACA,MACA,OACiB;AAEjB,QAAO;EAAE,MAAM;EAAmB;EAAQ;EAAM;EAAO;;;;;;;;;;;AAYzD,SAAgB,8BACd,OACA,MACsB;AAEtB,QAAO;EAAE,MAAM;EAAwB;EAAO;EAAM;;;;;;;;;;;AAYtD,SAAgB,0CACd,SACiC;AAEjC,QAAO;EAAE,0BAA0B;EAAM;EAAS;;;;;;;;;;;AAapD,SAAgB,sCACd,OAC0C;AAE1C,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,6BAA6B;;;;;;;;;AAWpE,SAAgB,2BACd,OACgC;AAEhC,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,SAAS;;;;;;;;;AAWhD,SAAgB,qBACd,OAC0B;AAE1B,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,SAAS;;;;;;;;;AAWhD,SAAgB,0BACd,OAC+B;AAE/B,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAkC,SAAS"}

package/.dist/runtime/preprocess.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Result returned by the Svelte markup preprocessor hook.
+ *
+ * @since 2.0.0
+ */
+interface MarkupResult {
+    code: string;
+}
+/**
+ * Minimal Svelte preprocessor group shape used by the runtime.
+ *
+ * @since 2.0.0
+ */
+interface PreprocessGroup {
+    name: string;
+    markup(options: {
+        content: string;
+        filename: string;
+    }): MarkupResult;
+}
+/**
+ * Svelte preprocessor that lowers `yield*` in script and markup blocks.
+ *
+ * @example
+ * ```js
+ * import { preprocess } from "svelte-effect-runtime";
+ *
+ * export default {
+ *   preprocess: [preprocess()],
+ * };
+ * ```
+ *
+ * @since 2.0.0
+ * @returns A Svelte preprocessor group with a `markup` hook.
+ */
+export declare function preprocess(): PreprocessGroup;
+export { type BlockRef, type ScriptTransformResult, transform_script_effect, } from "../preprocess.js";
+export { type MarkupTransformResult, transform_markup_effect, } from "../markup/transform.js";

package/.dist/runtime/preprocess.js

@@ -0,0 +1,54 @@
+import { t as transform_markup_effect } from "../chunks/transform-BtlxgJrg.js";
+import { t as transform_script_effect } from "../chunks/preprocess-BZyUYWY7.js";
+//#region src/runtime/preprocess.ts
+/**
+* Svelte preprocessor that lowers `yield*` in script and markup blocks.
+*
+* @example
+* ```js
+* import { preprocess } from "svelte-effect-runtime";
+*
+* export default {
+*   preprocess: [preprocess()],
+* };
+* ```
+*
+* @since 2.0.0
+* @returns A Svelte preprocessor group with a `markup` hook.
+*/
+function preprocess() {
+	return {
+		name: "svelte-effect-runtime",
+		markup({ content, filename }) {
+			const script = find_script(content);
+			let combined = content;
+			if (script?.has_effect) {
+				const result = transform_script_effect(script.text, filename);
+				combined = content.slice(0, script.effect_attr_start) + content.slice(script.effect_attr_end, script.open_end) + result.code + content.slice(script.close_start);
+			}
+			return { code: transform_markup_effect(combined, filename).code };
+		}
+	};
+}
+function find_script(content) {
+	for (const match of content.matchAll(/<script\b([^>]*)>([\s\S]*?)<\/script\s*>/gi)) {
+		if (match.index === void 0 || /\bmodule\b/.test(match[1] ?? "")) continue;
+		const attrs = match[1] ?? "";
+		const effect_match = /\s+effect(?:\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]+))?/.exec(attrs);
+		const open_end = match.index + match[0].indexOf(">") + 1;
+		const attr_start = effect_match?.index ?? attrs.length;
+		const attr_end = attr_start + (effect_match?.[0].length ?? 0);
+		return {
+			text: match[2],
+			open_end,
+			close_start: match.index + match[0].lastIndexOf("<"),
+			has_effect: effect_match !== null,
+			effect_attr_start: match.index + 7 + attr_start,
+			effect_attr_end: match.index + 7 + attr_end
+		};
+	}
+}
+//#endregion
+export { preprocess, transform_markup_effect, transform_script_effect };
+
+//# sourceMappingURL=preprocess.js.map

package/.dist/runtime/preprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocess.js","names":[],"sources":["../../../modules/svelte-effect-runtime/src/runtime/preprocess.ts"],"sourcesContent":["import { transform_markup_effect } from \"$/markup/transform.ts\";\nimport { transform_script_effect } from \"$/preprocess.ts\";\n\n/**\n * Result returned by the Svelte markup preprocessor hook.\n *\n * @since 2.0.0\n */\ninterface MarkupResult {\n  code: string;\n}\n\n/**\n * Minimal Svelte preprocessor group shape used by the runtime.\n *\n * @since 2.0.0\n */\ninterface PreprocessGroup {\n  name: string;\n  markup(options: { content: string; filename: string }): MarkupResult;\n}\n\n/**\n * Svelte preprocessor that lowers `yield*` in script and markup blocks.\n *\n * @example\n * ```js\n * import { preprocess } from \"svelte-effect-runtime\";\n *\n * export default {\n *   preprocess: [preprocess()],\n * };\n * ```\n *\n * @since 2.0.0\n * @returns A Svelte preprocessor group with a `markup` hook.\n */\nexport function preprocess(): PreprocessGroup {\n  return {\n    name: \"svelte-effect-runtime\",\n\n    markup({ content, filename }: { content: string; filename: string }) {\n      const script = find_script(content);\n\n      let combined = content;\n\n      if (script?.has_effect) {\n        const result = transform_script_effect(script.text, filename);\n\n        combined = content.slice(0, script.effect_attr_start) +\n          content.slice(script.effect_attr_end, script.open_end) +\n          result.code +\n          content.slice(script.close_start);\n      }\n\n      const result = transform_markup_effect(combined, filename);\n\n      return { code: result.code };\n    },\n  };\n}\n\nfunction find_script(content: string):\n  | {\n    text: string;\n    open_end: number;\n    close_start: number;\n    has_effect: boolean;\n    effect_attr_start: number;\n    effect_attr_end: number;\n  }\n  | undefined {\n  const pattern = /<script\\b([^>]*)>([\\s\\S]*?)<\\/script\\s*>/gi;\n\n  for (const match of content.matchAll(pattern)) {\n    if (match.index === undefined || /\\bmodule\\b/.test(match[1] ?? \"\")) {\n      continue;\n    }\n\n    const attrs = match[1] ?? \"\";\n    const effect_match = /\\s+effect(?:\\s*=\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s>]+))?/\n      .exec(attrs);\n    const open_end = match.index + match[0].indexOf(\">\") + 1;\n    const attr_start = effect_match?.index ?? attrs.length;\n    const attr_end = attr_start + (effect_match?.[0].length ?? 0);\n\n    return {\n      text: match[2],\n      open_end,\n      close_start: match.index + match[0].lastIndexOf(\"<\"),\n      has_effect: effect_match !== null,\n      effect_attr_start: match.index + \"<script\".length + attr_start,\n      effect_attr_end: match.index + \"<script\".length + attr_end,\n    };\n  }\n\n  return undefined;\n}\n\nexport {\n  type BlockRef,\n  type ScriptTransformResult,\n  transform_script_effect,\n} from \"$/preprocess.ts\";\n\nexport {\n  type MarkupTransformResult,\n  transform_markup_effect,\n} from \"$/markup/transform.ts\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqCA,SAAgB,aAA8B;AAC5C,QAAO;EACL,MAAM;EAEN,OAAO,EAAE,SAAS,YAAmD;GACnE,MAAM,SAAS,YAAY,QAAQ;GAEnC,IAAI,WAAW;AAEf,OAAI,QAAQ,YAAY;IACtB,MAAM,SAAS,wBAAwB,OAAO,MAAM,SAAS;AAE7D,eAAW,QAAQ,MAAM,GAAG,OAAO,kBAAkB,GACnD,QAAQ,MAAM,OAAO,iBAAiB,OAAO,SAAS,GACtD,OAAO,OACP,QAAQ,MAAM,OAAO,YAAY;;AAKrC,UAAO,EAAE,MAFM,wBAAwB,UAAU,SAAS,CAEpC,MAAM;;EAE/B;;AAGH,SAAS,YAAY,SASP;AAGZ,MAAK,MAAM,SAAS,QAAQ,SAFZ,6CAE6B,EAAE;AAC7C,MAAI,MAAM,UAAU,KAAA,KAAa,aAAa,KAAK,MAAM,MAAM,GAAG,CAChE;EAGF,MAAM,QAAQ,MAAM,MAAM;EAC1B,MAAM,eAAe,mDAClB,KAAK,MAAM;EACd,MAAM,WAAW,MAAM,QAAQ,MAAM,GAAG,QAAQ,IAAI,GAAG;EACvD,MAAM,aAAa,cAAc,SAAS,MAAM;EAChD,MAAM,WAAW,cAAc,eAAe,GAAG,UAAU;AAE3D,SAAO;GACL,MAAM,MAAM;GACZ;GACA,aAAa,MAAM,QAAQ,MAAM,GAAG,YAAY,IAAI;GACpD,YAAY,iBAAiB;GAC7B,mBAAmB,MAAM,QAAQ,IAAmB;GACpD,iBAAiB,MAAM,QAAQ,IAAmB;GACnD"}

package/.dist/server/effects.d.ts

@@ -0,0 +1,49 @@
+import { Effect } from "effect";
+import type { RequestEvent as RequestEventShape } from "./runtime.js";
+import type { EffectLike, EffectRemoteLiveSource } from "./types.js";
+type ResolvedLiveSource<A> = AsyncIterable<A> | AsyncIterator<A> | Iterable<A> | Iterator<A>;
+type LiveHandlerResult<A> = EffectLike<EffectRemoteLiveSource<A>> | EffectRemoteLiveSource<A>;
+/**
+ * Checks whether a value is an Effect generator return object.
+ *
+ * @since 2.0.0
+ * @param value - Value to inspect.
+ * @returns Whether the value should be wrapped with `Effect.gen`.
+ */
+export declare function is_generator_result<A>(value: unknown): value is Effect.gen.Return<A, unknown, unknown>;
+/**
+ * Normalizes an Effect-like handler return value into an Effect.
+ *
+ * @since 2.0.0
+ * @param value - Effect or generator return value.
+ * @returns Normalized Effect.
+ */
+export declare function to_effect<A>(value: EffectLike<A>): Effect.Effect<A, unknown, unknown>;
+/**
+ * Checks whether a value is a live query source SvelteKit can consume.
+ *
+ * @since 2.0.0
+ * @param value - Value to inspect.
+ * @returns Whether the value is an Effect Stream or native iterable source.
+ */
+export declare function is_live_source<A>(value: unknown): value is EffectRemoteLiveSource<A>;
+/**
+ * Runs and normalizes a live query handler result with request services
+ * available to Effect Streams.
+ *
+ * @since 2.0.0
+ * @param value - Live query source or Effect that resolves to one.
+ * @param event - SvelteKit request event for this remote call.
+ * @returns Promise resolving with a source SvelteKit can stream.
+ */
+export declare function run_live_handler_source<A>(value: LiveHandlerResult<A>, event: RequestEventShape): Promise<ResolvedLiveSource<A>>;
+/**
+ * Runs a remote handler Effect with the current request event provided.
+ *
+ * @since 2.0.0
+ * @param value - Handler return value.
+ * @param event - SvelteKit request event for this remote call.
+ * @returns Promise resolving with the handler output.
+ */
+export declare function run_handler_effect<A>(value: EffectLike<A>, event: RequestEventShape): Promise<A>;
+export {};

package/.dist/server/factories.d.ts

@@ -0,0 +1,97 @@
+import { prerender as native_prerender } from "$app/server";
+import type { RemoteFormInput } from "@sveltejs/kit";
+import { type Schema } from "effect";
+import type { EffectLike, EffectRemoteBatchHandler, EffectRemoteCommand, EffectRemoteForm, EffectRemoteLiveQueryFunction, EffectRemoteLiveSource, EffectRemoteQueryFunction, PrerenderOptions, RemoteFormHandler, RemoteHandler, SchemaInput } from "./types.js";
+type FormSchemaInput<S> = SchemaInput<S> extends RemoteFormInput ? SchemaInput<S> : never;
+type RemoteLiveHandler<Input = unknown, A = unknown> = EffectLike<EffectRemoteLiveSource<A>> | EffectRemoteLiveSource<A> | ((input: Input) => EffectLike<EffectRemoteLiveSource<A>> | EffectRemoteLiveSource<A>);
+interface QueryFactory {
+    <A>(validate_or_handler: EffectLike<A> | RemoteHandler<void, A>): EffectRemoteQueryFunction<void, A>;
+    <Input, A>(validate_or_handler: "unchecked", maybe_handler: RemoteHandler<Input, A>): EffectRemoteQueryFunction<Input, A>;
+    <S extends Schema.Schema<unknown>, A>(validate_or_handler: S, maybe_handler: RemoteHandler<SchemaInput<S>, A>): EffectRemoteQueryFunction<SchemaInput<S>, A>;
+    readonly batch: typeof QueryBatch;
+    readonly live: typeof QueryLive;
+}
+/**
+ * Factory for a batched read-only remote query function.
+ *
+ * @since 2.0.0
+ * @param validate_or_handler - A schema or `"unchecked"` sentinel.
+ * @param maybe_handler - Handler receiving validated inputs as one batch.
+ * @returns A SvelteKit batch query function.
+ */
+declare function QueryBatch<Input, A>(validate_or_handler: "unchecked", maybe_handler: EffectRemoteBatchHandler<Input, A>): EffectRemoteQueryFunction<Input, A>;
+declare function QueryBatch<S extends Schema.Schema<unknown>, A>(validate_or_handler: S, maybe_handler: EffectRemoteBatchHandler<SchemaInput<S>, A>): EffectRemoteQueryFunction<SchemaInput<S>, A>;
+/**
+ * Factory for a live remote query function.
+ *
+ * @since 2.0.0
+ * @param validate_or_handler - A schema, `"unchecked"`, or no-arg live handler.
+ * @param maybe_handler - Handler used when a validator is supplied.
+ * @returns A SvelteKit live query function.
+ */
+declare function QueryLive<A>(validate_or_handler: RemoteLiveHandler<void, A>): EffectRemoteLiveQueryFunction<void, A>;
+declare function QueryLive<Input, A>(validate_or_handler: "unchecked", maybe_handler: RemoteLiveHandler<Input, A>): EffectRemoteLiveQueryFunction<Input, A>;
+declare function QueryLive<S extends Schema.Schema<unknown>, A>(validate_or_handler: S, maybe_handler: RemoteLiveHandler<SchemaInput<S>, A>): EffectRemoteLiveQueryFunction<SchemaInput<S>, A>;
+/**
+ * Factory for read-only remote query functions.
+ *
+ * @example
+ * ```ts
+ * export const getUser = Query(Schema.Struct({ id: Schema.String }), (input) =>
+ *   Effect.succeed(input.id)
+ * );
+ *
+ * export const getUserBatch = Query.batch(Schema.String, (ids) =>
+ *   Effect.succeed((id) => ids.includes(id))
+ * );
+ * ```
+ *
+ * @since 2.0.0
+ */
+export declare const Query: QueryFactory;
+/**
+ * Factory for a write-oriented remote command function.
+ *
+ * @since 2.0.0
+ * @param validate_or_handler - A schema, `"unchecked"`, or no-arg handler.
+ * @param maybe_handler - Handler used when a validator is supplied.
+ * @returns A SvelteKit command function.
+ */
+export declare function Command<A>(validate_or_handler: EffectLike<A> | RemoteHandler<void, A>): EffectRemoteCommand<void, A>;
+export declare function Command<Input, A>(validate_or_handler: "unchecked", maybe_handler: RemoteHandler<Input, A>): EffectRemoteCommand<Input, A>;
+export declare function Command<S extends Schema.Schema<unknown>, A>(validate_or_handler: S, maybe_handler: RemoteHandler<SchemaInput<S>, A>): EffectRemoteCommand<SchemaInput<S>, A>;
+/**
+ * Factory for a remote form handler.
+ *
+ * @example
+ * ```ts
+ * export const SignIn = Form(signInSchema, ({ data, invalid }) =>
+ *   Effect.gen(function* () {
+ *     if (!data.email.includes("@")) {
+ *       return yield* invalid.email("Use an email address.");
+ *     }
+ *
+ *     return { email: data.email };
+ *   })
+ * );
+ * ```
+ *
+ * @since 2.0.0
+ * @param validate_or_handler - A schema, `"unchecked"`, or no-arg handler.
+ * @param maybe_handler - Handler used when a validator is supplied.
+ * @returns A SvelteKit form function.
+ */
+export declare function Form<A>(validate_or_handler: EffectLike<A> | RemoteFormHandler<void, A>): EffectRemoteForm<void, A>;
+export declare function Form<Input extends RemoteFormInput, A>(validate_or_handler: "unchecked", maybe_handler: RemoteFormHandler<Input, A>): EffectRemoteForm<Input, A>;
+export declare function Form<S extends Schema.Schema<unknown>, A>(validate_or_handler: S, maybe_handler: RemoteFormHandler<FormSchemaInput<S>, A>): EffectRemoteForm<FormSchemaInput<S>, A>;
+/**
+ * Factory for a prerenderable remote function.
+ *
+ * @since 2.0.0
+ * @param validate_or_handler - A schema, `"unchecked"`, or no-arg handler.
+ * @param maybe_handler_or_options - Handler or prerender options.
+ * @param maybe_options - Prerender options used with a validator.
+ * @returns A SvelteKit prerender function.
+ */
+export declare function Prerender(validate_or_handler: unknown, maybe_handler_or_options?: RemoteHandler | PrerenderOptions, maybe_options?: PrerenderOptions): ReturnType<typeof native_prerender>;
+export {};

package/.dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export { Command, Form, Prerender, Query } from "./factories.js";
+export { get_server_runtime_or_throw, RequestEvent, ServerRuntime, } from "./runtime.js";
+export type { EffectLike, EffectRemoteBatchHandler, EffectRemoteCommand, EffectRemoteForm, EffectRemoteFunction, EffectRemoteLiveQuery, EffectRemoteLiveQueryFunction, EffectRemoteLiveSource, EffectRemoteQuery, EffectRemoteQueryFunction, FormInvalid, CommandFactory, FormFactory, PrerenderOptions, PrerenderFactory, QueryBatchFactory, QueryFactory, QueryLiveFactory, RemoteLiveHandler, RemoteFormHandler, RemoteHandler, SchemaInput, ServerRuntimeFactory, StandardSchema, } from "./types.js";

package/.dist/server/invalid.d.ts

@@ -0,0 +1,9 @@
+import type { FormInvalid } from "./types.js";
+/**
+ * Creates a path-aware proxy for remote form validation failures.
+ *
+ * @since 2.0.0
+ * @param path - Current nested form path.
+ * @returns Callable invalid proxy for this path.
+ */
+export declare function make_invalid_proxy(path?: readonly (string | number)[]): FormInvalid;

package/.dist/server/runtime.d.ts

@@ -0,0 +1,66 @@
+import { Context, Layer, ManagedRuntime } from "effect";
+/**
+ * Subset of SvelteKit's `RequestEvent` that remote handlers typically access.
+ *
+ * @since 2.0.0
+ */
+export interface RequestEvent {
+    readonly url: URL;
+    readonly request: Request;
+    readonly cookies: {
+        get(name: string): string | undefined;
+        set(name: string, value: string, opts?: Record<string, unknown>): void;
+        delete(name: string, opts?: Record<string, unknown>): void;
+        serialize(name: string, value: string, opts?: Record<string, unknown>): string;
+    };
+    readonly locals: Record<string, unknown>;
+    readonly params: Record<string, string>;
+    readonly route: {
+        id: string | null;
+    };
+    readonly platform?: unknown;
+    readonly getClientAddress: () => string;
+}
+/**
+ * SvelteKit's `RequestEvent` exposed as an Effect {@link Context.Tag}.
+ *
+ * @example
+ * ```ts
+ * const event = yield* RequestEvent;
+ * ```
+ *
+ * @since 2.0.0
+ */
+export declare const RequestEvent: Context.Reference<RequestEvent>;
+/**
+ * Builder for the server-side Effect runtime.
+ *
+ * @example
+ * ```ts
+ * ServerRuntime.make(Db.Live);
+ * ```
+ *
+ * @since 2.0.0
+ */
+export declare class ServerRuntime {
+    /**
+     * Build and cache the server-side `ManagedRuntime`.
+     *
+     * @since 2.0.0
+     * @param layer - Optional Effect layer to provide to the runtime.
+     * @returns The configured ManagedRuntime.
+     */
+    static make<R = never>(layer?: Layer.Layer<R>): ManagedRuntime.ManagedRuntime<R, never>;
+}
+/**
+ * Returns the active server runtime, creating a default one if needed.
+ *
+ * @example
+ * ```ts
+ * const runtime = get_server_runtime_or_throw();
+ * ```
+ *
+ * @since 2.0.0
+ * @returns The current ManagedRuntime instance.
+ */
+export declare function get_server_runtime_or_throw(): ManagedRuntime.ManagedRuntime<unknown, never>;

package/.dist/server/schema.d.ts

@@ -0,0 +1,42 @@
+import { Schema } from "effect";
+import type { RemoteHandler, StandardSchema } from "./types.js";
+/**
+ * Checks whether a value is the string sentinel for unchecked remotes.
+ *
+ * @since 2.0.0
+ * @param value - Value to inspect.
+ * @returns Whether the value is `"unchecked"`.
+ */
+export declare function is_unchecked(value: unknown): value is "unchecked";
+/**
+ * Checks whether a value is a remote handler function.
+ *
+ * @since 2.0.0
+ * @param value - Value to inspect.
+ * @returns Whether the value is callable as a handler.
+ */
+export declare function is_handler(value: unknown): value is RemoteHandler;
+/**
+ * Checks whether a value implements the Standard Schema contract.
+ *
+ * @since 2.0.0
+ * @param value - Value to inspect.
+ * @returns Whether the value is a Standard Schema.
+ */
+export declare function is_standard_schema(value: unknown): value is StandardSchema;
+/**
+ * Checks whether a value looks like an Effect Schema.
+ *
+ * @since 2.0.0
+ * @param value - Value to inspect.
+ * @returns Whether the value should be converted to Standard Schema.
+ */
+export declare function is_effect_schema(value: unknown): value is Schema.Schema<unknown>;
+/**
+ * Converts Effect Schema inputs to Standard Schema for SvelteKit.
+ *
+ * @since 2.0.0
+ * @param value - Schema or handler input.
+ * @returns Original value or Standard Schema view of an Effect Schema.
+ */
+export declare function normalize_validator(value: unknown): unknown;