@thomasfosterau/effect-sveltekit 0.0.0

package/dist/app-runtime.d.ts

@@ -0,0 +1,212 @@
+import { SvelteKitRequestEvent } from "./runtime.js";
+import { Effect, Exit, Fiber, Layer, ManagedRuntime } from "effect";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import { Action, Actions, Handle, HandleFetch, HandleServerError, Load, RequestEvent, ServerInit, ServerLoad } from "@sveltejs/kit";
+
+//#region src/app-runtime.d.ts
+/**
+ * The services provided to every wrapped effect on the server, in addition to
+ * the application's own layer.
+ */
+type SvelteKitServices = HttpClient.HttpClient | SvelteKitRequestEvent;
+/**
+ * A per-request Effect runtime: the application layer's services plus the
+ * per-request {@link SvelteKitServices} (an `HttpClient` backed by the request's
+ * `fetch`, and the {@link SvelteKitRequestEvent}), with the request services
+ * built once for the request and shared.
+ *
+ * A {@link ServerRuntime}'s `handle` hook creates one per request and stores it
+ * on `event.locals` (`App.Locals`). Every other wrapper for the same runtime
+ * (`serverLoad`, `action`, `endpoint`, ...) then runs on it, so a request's
+ * effects share one `HttpClient` and one request scope. Retrieve it from an
+ * event with `ServerRuntime.requestRuntime` to run your own effects.
+ */
+interface RequestRuntime<R = never> {
+  /** Run an effect for this request, returning its `Exit`. */
+  readonly runPromiseExit: <A>(effect: Effect.Effect<A, unknown, R | SvelteKitServices>) => Promise<Exit.Exit<A, unknown>>;
+  /** Run an effect for this request, throwing on failure (passing SvelteKit control flow through). */
+  readonly runPromise: <A>(effect: Effect.Effect<A, unknown, R | SvelteKitServices>) => Promise<A>;
+  /** Fork an effect for this request, returning the running fiber. */
+  readonly runFork: <A>(effect: Effect.Effect<A, unknown, R | SvelteKitServices>) => Fiber.Fiber<A, unknown>;
+}
+/**
+ * A server-side Effect runtime bound to an application layer.
+ *
+ * Produced by {@link makeServerRuntime}. The wrapper methods mirror the
+ * standalone helpers in `@thomasfosterau/effect-sveltekit/server`, but
+ * effects additionally have access to the services `R` of the application
+ * layer.
+ */
+interface ServerRuntime<R = never, E = never> {
+  /** The underlying managed runtime for the application layer. */
+  readonly runtime: ManagedRuntime.ManagedRuntime<R, E>;
+  /**
+   * Wraps an Effect-based function as a SvelteKit server `load`.
+   */
+  readonly serverLoad: <Params extends Record<string, string> = any, ParentData extends Record<string, any> = any, OutputData extends Record<string, any> | void = any, RouteId extends string | null = any>(fn: (event: RequestEvent<Params, RouteId>) => Effect.Effect<OutputData, unknown, R | SvelteKitServices>) => ServerLoad<Params, ParentData, OutputData, RouteId>;
+  /**
+   * Wraps an Effect-based function as a SvelteKit form action.
+   */
+  readonly action: <Params extends Record<string, string> = any, OutputData extends Record<string, any> | void = any, RouteId extends string | null = any>(fn: (event: RequestEvent<Params, RouteId>) => Effect.Effect<OutputData, unknown, R | SvelteKitServices>) => Action<Params, OutputData, RouteId>;
+  /**
+   * Wraps an object of Effect-based form actions.
+   */
+  readonly actions: <Params extends Record<string, string> = any, OutputData extends Record<string, any> | void = any, RouteId extends string | null = any>(actionsMap: Record<string, (event: RequestEvent<Params, RouteId>) => Effect.Effect<OutputData, unknown, R | SvelteKitServices>>) => Actions<Params, OutputData, RouteId>;
+  /**
+   * Wraps an Effect-based function as a SvelteKit `handle` hook.
+   */
+  readonly handle: (fn: (args: Parameters<Handle>[0]) => Effect.Effect<Response, unknown, R | SvelteKitServices>) => Handle;
+  /**
+   * Wraps an Effect-based function as a SvelteKit server `handleFetch` hook,
+   * which intercepts `event.fetch` calls made on the server. The effect runs
+   * with the per-request services on top of the application layer and produces
+   * the `Response` to use.
+   */
+  readonly handleFetch: (fn: (args: Parameters<HandleFetch>[0]) => Effect.Effect<Response, unknown, R | SvelteKitServices>) => HandleFetch;
+  /**
+   * Wraps an Effect-based function as a SvelteKit server `handleError` hook.
+   *
+   * The effect receives the error and the request event, and produces the
+   * shape that SvelteKit exposes to the client (your `App.Error`, or nothing).
+   * It runs with the per-request services on top of the application layer.
+   */
+  readonly handleError: (fn: (args: Parameters<HandleServerError>[0]) => Effect.Effect<Awaited<ReturnType<HandleServerError>>, unknown, R | SvelteKitServices>) => HandleServerError;
+  /**
+   * Wraps an Effect as a SvelteKit server `init` hook, run once before the
+   * server responds to its first request. There is no request event, so the
+   * effect only has access to the application layer's services.
+   */
+  readonly init: (effect: Effect.Effect<void, unknown, R>) => ServerInit;
+  /**
+   * The per-request {@link RequestRuntime} this runtime's `handle` stored on the
+   * event, or `undefined` when `handle` was not used for the request. Use it to
+   * run your own effects on the same per-request runtime (shared `HttpClient`
+   * and request scope) that `serverLoad` / `action` / `endpoint` use.
+   *
+   * @example
+   * ```ts
+   * // anywhere with the request event, e.g. another `handle` in the sequence
+   * const rt = runtime.requestRuntime(event);
+   * await rt?.runPromise(Effect.gen(function* () {
+   *   const user = yield* Auth.currentUser;
+   *   event.locals.user = user;
+   * }));
+   * ```
+   */
+  readonly requestRuntime: (event: RequestEvent) => RequestRuntime<R> | undefined;
+  /**
+   * Wraps an Effect-based function as a SvelteKit `+server.ts` endpoint
+   * handler (`GET`, `POST`, ...).
+   */
+  readonly endpoint: <Params extends Record<string, string> = any, RouteId extends string | null = any>(fn: (event: RequestEvent<Params, RouteId>) => Effect.Effect<Response, unknown, R | SvelteKitServices>) => (event: RequestEvent<Params, RouteId>) => Promise<Response>;
+  /**
+   * Runs an effect for a specific request, providing both the application
+   * layer and the per-request services. Failures (other than SvelteKit
+   * control flow) are thrown as `EffectCauseError`.
+   */
+  readonly runPromise: <A>(event: RequestEvent, effect: Effect.Effect<A, unknown, R | SvelteKitServices>) => Promise<A>;
+  /**
+   * Runs an effect for a specific request and returns the Exit, without
+   * translating failures into thrown errors.
+   */
+  readonly runPromiseExit: <A>(event: RequestEvent, effect: Effect.Effect<A, unknown, R | SvelteKitServices>) => Promise<Exit.Exit<A, unknown>>;
+  /**
+   * Disposes the underlying managed runtime, running the layer's finalizers.
+   * Call this on server shutdown or in tests.
+   */
+  readonly dispose: () => Promise<void>;
+}
+/**
+ * Creates a {@link ServerRuntime} from an application layer.
+ *
+ * The layer is built lazily on first use and shared by all requests for the
+ * lifetime of the server process. Define it once in a server-only module and
+ * import its wrappers from your routes:
+ *
+ * @example
+ * ```ts
+ * // src/lib/server/runtime.ts
+ * import { makeServerRuntime } from '@thomasfosterau/effect-sveltekit/server';
+ * import { Layer } from 'effect';
+ * import { Database } from './database';
+ *
+ * export const runtime = makeServerRuntime(Database.layer);
+ * ```
+ *
+ * ```ts
+ * // src/routes/items/+page.server.ts
+ * import { runtime } from '$lib/server/runtime';
+ * import { Effect } from 'effect';
+ * import { Database } from '$lib/server/database';
+ *
+ * export const load = runtime.serverLoad((event) =>
+ *   Effect.gen(function* () {
+ *     const db = yield* Database;
+ *     return { items: yield* db.listItems() };
+ *   })
+ * );
+ * ```
+ *
+ * Note that the application layer is built outside of any request, so its
+ * services cannot depend on the per-request `SvelteKitRequestEvent` or
+ * `HttpClient`. Request-specific data should be passed to service methods as
+ * arguments instead.
+ */
+declare const makeServerRuntime: <R = never, E = never>(layer?: Layer.Layer<R, E>) => ServerRuntime<R, E>;
+/**
+ * A universal (client + server) Effect runtime bound to an application layer.
+ *
+ * Produced by {@link makeUniversalRuntime}. Because universal `load`
+ * functions also run in the browser, the layer must only use services that
+ * work in both environments.
+ */
+interface UniversalRuntime<R = never, E = never> {
+  /** The underlying managed runtime for the application layer. */
+  readonly runtime: ManagedRuntime.ManagedRuntime<R, E>;
+  /**
+   * Wraps an Effect-based function as a SvelteKit universal `load`.
+   *
+   * The effect gets `HttpClient` (backed by the load event's `fetch`) on both
+   * client and server, plus the services of the application layer.
+   */
+  readonly load: <Params extends Record<string, string> = any, InputData extends Record<string, unknown> | null = any, ParentData extends Record<string, unknown> = any, OutputData extends Record<string, unknown> | void = any, RouteId extends string | null = any>(fn: (event: Parameters<Load<Params, InputData, ParentData, OutputData, RouteId>>[0]) => Effect.Effect<OutputData, unknown, R | HttpClient.HttpClient>) => Load<Params, InputData, ParentData, OutputData, RouteId>;
+  /**
+   * Runs an effect with `HttpClient` backed by the given fetch implementation
+   * plus the application layer.
+   */
+  readonly runPromise: <A>(fetchFn: typeof globalThis.fetch, effect: Effect.Effect<A, unknown, R | HttpClient.HttpClient>) => Promise<A>;
+  /**
+   * Disposes the underlying managed runtime, running the layer's finalizers.
+   */
+  readonly dispose: () => Promise<void>;
+}
+/**
+ * Creates a {@link UniversalRuntime} from an application layer.
+ *
+ * @example
+ * ```ts
+ * // src/lib/runtime.ts
+ * import { makeUniversalRuntime } from '@thomasfosterau/effect-sveltekit';
+ * import { ApiClient } from '$lib/api';
+ *
+ * export const runtime = makeUniversalRuntime(ApiClient.layer);
+ * ```
+ *
+ * ```ts
+ * // src/routes/+page.ts
+ * import { runtime } from '$lib/runtime';
+ * import { Effect } from 'effect';
+ * import { ApiClient } from '$lib/api';
+ *
+ * export const load = runtime.load((event) =>
+ *   Effect.gen(function* () {
+ *     const api = yield* ApiClient;
+ *     return { stories: yield* api.topStories() };
+ *   })
+ * );
+ * ```
+ */
+declare const makeUniversalRuntime: <R = never, E = never>(layer?: Layer.Layer<R, E>) => UniversalRuntime<R, E>;
+//#endregion
+export { RequestRuntime, ServerRuntime, SvelteKitServices, UniversalRuntime, makeServerRuntime, makeUniversalRuntime };
+//# sourceMappingURL=app-runtime.d.ts.map

package/dist/app-runtime.js

@@ -0,0 +1,173 @@
+import { SvelteKitRequestEvent } from "./runtime.js";
+import { causeToThrowable } from "./internal/error.js";
+import { Effect, Exit, Layer, ManagedRuntime, Scope } from "effect";
+import * as FetchHttpClient from "effect/unstable/http/FetchHttpClient";
+//#region src/app-runtime.ts
+/**
+* Symbol under which a {@link ServerRuntime}'s `handle` stores the per-request
+* {@link RequestRuntime} on `event.locals`. `Symbol.for` so the key is stable
+* across module instances.
+*/
+const RequestRuntimeKey = Symbol.for("@thomasfosterau/effect-sveltekit/requestRuntime");
+/** Read the per-request runtime entry an event carries, if any. */
+const requestRuntimeEntry = (event) => event.locals?.[RequestRuntimeKey];
+/** Layer with the per-request services for a server-side request. */
+const requestLayer = (event) => Layer.merge(FetchHttpClient.layer.pipe(Layer.provide(Layer.succeed(FetchHttpClient.Fetch, event.fetch))), Layer.succeed(SvelteKitRequestEvent, event));
+/** Layer providing `HttpClient` backed by an arbitrary fetch implementation. */
+const fetchLayer = (fetchFn) => FetchHttpClient.layer.pipe(Layer.provide(Layer.succeed(FetchHttpClient.Fetch, fetchFn)));
+/** Settle an exit the way SvelteKit expects: return the value or throw. */
+const settle = (exit) => Exit.match(exit, {
+	onFailure: (cause) => {
+		throw causeToThrowable(cause);
+	},
+	onSuccess: (value) => value
+});
+/**
+* Creates a {@link ServerRuntime} from an application layer.
+*
+* The layer is built lazily on first use and shared by all requests for the
+* lifetime of the server process. Define it once in a server-only module and
+* import its wrappers from your routes:
+*
+* @example
+* ```ts
+* // src/lib/server/runtime.ts
+* import { makeServerRuntime } from '@thomasfosterau/effect-sveltekit/server';
+* import { Layer } from 'effect';
+* import { Database } from './database';
+*
+* export const runtime = makeServerRuntime(Database.layer);
+* ```
+*
+* ```ts
+* // src/routes/items/+page.server.ts
+* import { runtime } from '$lib/server/runtime';
+* import { Effect } from 'effect';
+* import { Database } from '$lib/server/database';
+*
+* export const load = runtime.serverLoad((event) =>
+*   Effect.gen(function* () {
+*     const db = yield* Database;
+*     return { items: yield* db.listItems() };
+*   })
+* );
+* ```
+*
+* Note that the application layer is built outside of any request, so its
+* services cannot depend on the per-request `SvelteKitRequestEvent` or
+* `HttpClient`. Request-specific data should be passed to service methods as
+* arguments instead.
+*/
+const makeServerRuntime = (layer) => {
+	const runtime = ManagedRuntime.make(layer ?? Layer.empty);
+	const owner = {};
+	/** A {@link RequestRuntime} that provides the prebuilt request services. */
+	const makeRequestRuntime = (requestServices) => {
+		const provide = (effect) => Effect.provideContext(effect, requestServices);
+		return {
+			runPromiseExit: (effect) => runtime.runPromiseExit(provide(effect)),
+			runPromise: (effect) => runtime.runPromiseExit(provide(effect)).then(settle),
+			runFork: (effect) => runtime.runFork(provide(effect))
+		};
+	};
+	/** The per-request runtime for this runtime carried by the event, if any. */
+	const requestRuntimeOf = (event) => {
+		const entry = requestRuntimeEntry(event);
+		return entry?.owner === owner ? entry.runtime : void 0;
+	};
+	const runExit = (event, effect) => {
+		const requestRuntime = requestRuntimeOf(event);
+		if (requestRuntime !== void 0) return requestRuntime.runPromiseExit(effect);
+		const provided = Effect.provide(effect, requestLayer(event));
+		return runtime.runPromiseExit(provided);
+	};
+	const run = (event, effect) => runExit(event, effect).then(settle);
+	const action = (fn) => (event) => run(event, fn(event));
+	/**
+	* The `handle` hook: build a per-request runtime, store it on `event.locals`
+	* so every other wrapper (and the user's own code) runs on it, run the user's
+	* effect, then close the request scope.
+	*/
+	const handle = (fn) => async (input) => {
+		const { event } = input;
+		const scope = Scope.makeUnsafe();
+		const entry = {
+			owner,
+			runtime: makeRequestRuntime(await runtime.runPromise(Layer.buildWithScope(requestLayer(event), scope)))
+		};
+		event.locals[RequestRuntimeKey] = entry;
+		try {
+			return await entry.runtime.runPromise(fn(input));
+		} finally {
+			await runtime.runPromise(Scope.close(scope, Exit.void));
+		}
+	};
+	return {
+		runtime,
+		serverLoad: (fn) => (event) => run(event, fn(event)),
+		action,
+		actions: (actionsMap) => {
+			const wrapped = {};
+			for (const [key, fn] of Object.entries(actionsMap)) wrapped[key] = action(fn);
+			return wrapped;
+		},
+		handle,
+		handleFetch: (fn) => (args) => run(args.event, fn(args)),
+		handleError: (fn) => (args) => run(args.event, fn(args)),
+		init: (effect) => async () => {
+			settle(await runtime.runPromiseExit(effect));
+		},
+		requestRuntime: requestRuntimeOf,
+		endpoint: (fn) => (event) => run(event, fn(event)),
+		runPromise: run,
+		runPromiseExit: runExit,
+		dispose: () => runtime.dispose()
+	};
+};
+/**
+* Creates a {@link UniversalRuntime} from an application layer.
+*
+* @example
+* ```ts
+* // src/lib/runtime.ts
+* import { makeUniversalRuntime } from '@thomasfosterau/effect-sveltekit';
+* import { ApiClient } from '$lib/api';
+*
+* export const runtime = makeUniversalRuntime(ApiClient.layer);
+* ```
+*
+* ```ts
+* // src/routes/+page.ts
+* import { runtime } from '$lib/runtime';
+* import { Effect } from 'effect';
+* import { ApiClient } from '$lib/api';
+*
+* export const load = runtime.load((event) =>
+*   Effect.gen(function* () {
+*     const api = yield* ApiClient;
+*     return { stories: yield* api.topStories() };
+*   })
+* );
+* ```
+*/
+const makeUniversalRuntime = (layer) => {
+	const runtime = ManagedRuntime.make(layer ?? Layer.empty);
+	const run = (fetchFn, effect, event) => {
+		const services = event ? requestLayer(event) : fetchLayer(fetchFn);
+		const provided = Effect.provide(effect, services);
+		return runtime.runPromiseExit(provided).then(settle);
+	};
+	return {
+		runtime,
+		load: (fn) => (event) => {
+			const serverEvent = event.request ? event : void 0;
+			return run(event.fetch, fn(event), serverEvent);
+		},
+		runPromise: (fetchFn, effect) => run(fetchFn, effect),
+		dispose: () => runtime.dispose()
+	};
+};
+//#endregion
+export { makeServerRuntime, makeUniversalRuntime };
+
+//# sourceMappingURL=app-runtime.js.map

package/dist/app-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-runtime.js","names":[],"sources":["../src/app-runtime.ts"],"sourcesContent":["/**\n * App-wide Effect runtimes for SvelteKit.\n *\n * `makeServerRuntime` / `makeUniversalRuntime` let an application define its\n * Effect services (database clients, API wrappers, config, ...) as a single\n * `Layer`, built once per server process and shared by every request, instead\n * of being rebuilt for each `load` / `action` / endpoint invocation.\n *\n * Per-request services — the {@link SvelteKitRequestEvent} and an `HttpClient`\n * backed by the event's `fetch` — are provided on top of the shared runtime\n * for each call, so SvelteKit's fetch behaviours (cookie forwarding, request\n * deduplication, relative URLs) keep working as expected.\n */\n\nimport type {\n  Action,\n  Actions,\n  Handle,\n  HandleFetch,\n  HandleServerError,\n  Load,\n  RequestEvent,\n  ServerInit,\n  ServerLoad,\n} from \"@sveltejs/kit\";\nimport { Context, Effect, type Fiber, Exit, Layer, ManagedRuntime, Scope } from \"effect\";\nimport * as FetchHttpClient from \"effect/unstable/http/FetchHttpClient\";\nimport type * as HttpClient from \"effect/unstable/http/HttpClient\";\nimport { SvelteKitRequestEvent } from \"./runtime.js\";\nimport { causeToThrowable } from \"./internal/error.js\";\n\n/**\n * The services provided to every wrapped effect on the server, in addition to\n * the application's own layer.\n */\nexport type SvelteKitServices = HttpClient.HttpClient | SvelteKitRequestEvent;\n\n/**\n * A per-request Effect runtime: the application layer's services plus the\n * per-request {@link SvelteKitServices} (an `HttpClient` backed by the request's\n * `fetch`, and the {@link SvelteKitRequestEvent}), with the request services\n * built once for the request and shared.\n *\n * A {@link ServerRuntime}'s `handle` hook creates one per request and stores it\n * on `event.locals` (`App.Locals`). Every other wrapper for the same runtime\n * (`serverLoad`, `action`, `endpoint`, ...) then runs on it, so a request's\n * effects share one `HttpClient` and one request scope. Retrieve it from an\n * event with `ServerRuntime.requestRuntime` to run your own effects.\n */\nexport interface RequestRuntime<R = never> {\n  /** Run an effect for this request, returning its `Exit`. */\n  readonly runPromiseExit: <A>(\n    effect: Effect.Effect<A, unknown, R | SvelteKitServices>,\n  ) => Promise<Exit.Exit<A, unknown>>;\n  /** Run an effect for this request, throwing on failure (passing SvelteKit control flow through). */\n  readonly runPromise: <A>(effect: Effect.Effect<A, unknown, R | SvelteKitServices>) => Promise<A>;\n  /** Fork an effect for this request, returning the running fiber. */\n  readonly runFork: <A>(\n    effect: Effect.Effect<A, unknown, R | SvelteKitServices>,\n  ) => Fiber.Fiber<A, unknown>;\n}\n\n/**\n * Symbol under which a {@link ServerRuntime}'s `handle` stores the per-request\n * {@link RequestRuntime} on `event.locals`. `Symbol.for` so the key is stable\n * across module instances.\n */\nconst RequestRuntimeKey: unique symbol = Symbol.for(\n  \"@thomasfosterau/effect-sveltekit/requestRuntime\",\n);\n\n/**\n * The locals entry: the per-request runtime tagged with the `ServerRuntime`\n * that created it, so a different runtime's wrappers ignore it (and fall back\n * to building request services themselves) rather than running on the wrong\n * application layer.\n */\ninterface RequestRuntimeEntry {\n  readonly owner: object;\n  readonly runtime: RequestRuntime<any>;\n}\n\n/** Read the per-request runtime entry an event carries, if any. */\nconst requestRuntimeEntry = (event: RequestEvent): RequestRuntimeEntry | undefined =>\n  (event.locals as Record<PropertyKey, unknown> | undefined)?.[RequestRuntimeKey] as\n    | RequestRuntimeEntry\n    | undefined;\n\n/** Layer with the per-request services for a server-side request. */\nconst requestLayer = (event: RequestEvent): Layer.Layer<SvelteKitServices> =>\n  Layer.merge(\n    FetchHttpClient.layer.pipe(Layer.provide(Layer.succeed(FetchHttpClient.Fetch, event.fetch))),\n    Layer.succeed(SvelteKitRequestEvent, event),\n  );\n\n/** Layer providing `HttpClient` backed by an arbitrary fetch implementation. */\nconst fetchLayer = (fetchFn: typeof globalThis.fetch): Layer.Layer<HttpClient.HttpClient> =>\n  FetchHttpClient.layer.pipe(Layer.provide(Layer.succeed(FetchHttpClient.Fetch, fetchFn)));\n\n/** Settle an exit the way SvelteKit expects: return the value or throw. */\nconst settle = <A>(exit: Exit.Exit<A, unknown>): A =>\n  Exit.match(exit, {\n    onFailure: (cause) => {\n      throw causeToThrowable(cause);\n    },\n    onSuccess: (value) => value,\n  });\n\n/**\n * A server-side Effect runtime bound to an application layer.\n *\n * Produced by {@link makeServerRuntime}. The wrapper methods mirror the\n * standalone helpers in `@thomasfosterau/effect-sveltekit/server`, but\n * effects additionally have access to the services `R` of the application\n * layer.\n */\nexport interface ServerRuntime<R = never, E = never> {\n  /** The underlying managed runtime for the application layer. */\n  readonly runtime: ManagedRuntime.ManagedRuntime<R, E>;\n\n  /**\n   * Wraps an Effect-based function as a SvelteKit server `load`.\n   */\n  readonly serverLoad: <\n    Params extends Record<string, string> = any,\n    ParentData extends Record<string, any> = any,\n    OutputData extends Record<string, any> | void = any,\n    RouteId extends string | null = any,\n  >(\n    fn: (\n      event: RequestEvent<Params, RouteId>,\n    ) => Effect.Effect<OutputData, unknown, R | SvelteKitServices>,\n  ) => ServerLoad<Params, ParentData, OutputData, RouteId>;\n\n  /**\n   * Wraps an Effect-based function as a SvelteKit form action.\n   */\n  readonly action: <\n    Params extends Record<string, string> = any,\n    OutputData extends Record<string, any> | void = any,\n    RouteId extends string | null = any,\n  >(\n    fn: (\n      event: RequestEvent<Params, RouteId>,\n    ) => Effect.Effect<OutputData, unknown, R | SvelteKitServices>,\n  ) => Action<Params, OutputData, RouteId>;\n\n  /**\n   * Wraps an object of Effect-based form actions.\n   */\n  readonly actions: <\n    Params extends Record<string, string> = any,\n    OutputData extends Record<string, any> | void = any,\n    RouteId extends string | null = any,\n  >(\n    actionsMap: Record<\n      string,\n      (\n        event: RequestEvent<Params, RouteId>,\n      ) => Effect.Effect<OutputData, unknown, R | SvelteKitServices>\n    >,\n  ) => Actions<Params, OutputData, RouteId>;\n\n  /**\n   * Wraps an Effect-based function as a SvelteKit `handle` hook.\n   */\n  readonly handle: (\n    fn: (args: Parameters<Handle>[0]) => Effect.Effect<Response, unknown, R | SvelteKitServices>,\n  ) => Handle;\n\n  /**\n   * Wraps an Effect-based function as a SvelteKit server `handleFetch` hook,\n   * which intercepts `event.fetch` calls made on the server. The effect runs\n   * with the per-request services on top of the application layer and produces\n   * the `Response` to use.\n   */\n  readonly handleFetch: (\n    fn: (\n      args: Parameters<HandleFetch>[0],\n    ) => Effect.Effect<Response, unknown, R | SvelteKitServices>,\n  ) => HandleFetch;\n\n  /**\n   * Wraps an Effect-based function as a SvelteKit server `handleError` hook.\n   *\n   * The effect receives the error and the request event, and produces the\n   * shape that SvelteKit exposes to the client (your `App.Error`, or nothing).\n   * It runs with the per-request services on top of the application layer.\n   */\n  readonly handleError: (\n    fn: (\n      args: Parameters<HandleServerError>[0],\n    ) => Effect.Effect<Awaited<ReturnType<HandleServerError>>, unknown, R | SvelteKitServices>,\n  ) => HandleServerError;\n\n  /**\n   * Wraps an Effect as a SvelteKit server `init` hook, run once before the\n   * server responds to its first request. There is no request event, so the\n   * effect only has access to the application layer's services.\n   */\n  readonly init: (effect: Effect.Effect<void, unknown, R>) => ServerInit;\n\n  /**\n   * The per-request {@link RequestRuntime} this runtime's `handle` stored on the\n   * event, or `undefined` when `handle` was not used for the request. Use it to\n   * run your own effects on the same per-request runtime (shared `HttpClient`\n   * and request scope) that `serverLoad` / `action` / `endpoint` use.\n   *\n   * @example\n   * ```ts\n   * // anywhere with the request event, e.g. another `handle` in the sequence\n   * const rt = runtime.requestRuntime(event);\n   * await rt?.runPromise(Effect.gen(function* () {\n   *   const user = yield* Auth.currentUser;\n   *   event.locals.user = user;\n   * }));\n   * ```\n   */\n  readonly requestRuntime: (event: RequestEvent) => RequestRuntime<R> | undefined;\n\n  /**\n   * Wraps an Effect-based function as a SvelteKit `+server.ts` endpoint\n   * handler (`GET`, `POST`, ...).\n   */\n  readonly endpoint: <\n    Params extends Record<string, string> = any,\n    RouteId extends string | null = any,\n  >(\n    fn: (\n      event: RequestEvent<Params, RouteId>,\n    ) => Effect.Effect<Response, unknown, R | SvelteKitServices>,\n  ) => (event: RequestEvent<Params, RouteId>) => Promise<Response>;\n\n  /**\n   * Runs an effect for a specific request, providing both the application\n   * layer and the per-request services. Failures (other than SvelteKit\n   * control flow) are thrown as `EffectCauseError`.\n   */\n  readonly runPromise: <A>(\n    event: RequestEvent,\n    effect: Effect.Effect<A, unknown, R | SvelteKitServices>,\n  ) => Promise<A>;\n\n  /**\n   * Runs an effect for a specific request and returns the Exit, without\n   * translating failures into thrown errors.\n   */\n  readonly runPromiseExit: <A>(\n    event: RequestEvent,\n    effect: Effect.Effect<A, unknown, R | SvelteKitServices>,\n  ) => Promise<Exit.Exit<A, unknown>>;\n\n  /**\n   * Disposes the underlying managed runtime, running the layer's finalizers.\n   * Call this on server shutdown or in tests.\n   */\n  readonly dispose: () => Promise<void>;\n}\n\n/**\n * Creates a {@link ServerRuntime} from an application layer.\n *\n * The layer is built lazily on first use and shared by all requests for the\n * lifetime of the server process. Define it once in a server-only module and\n * import its wrappers from your routes:\n *\n * @example\n * ```ts\n * // src/lib/server/runtime.ts\n * import { makeServerRuntime } from '@thomasfosterau/effect-sveltekit/server';\n * import { Layer } from 'effect';\n * import { Database } from './database';\n *\n * export const runtime = makeServerRuntime(Database.layer);\n * ```\n *\n * ```ts\n * // src/routes/items/+page.server.ts\n * import { runtime } from '$lib/server/runtime';\n * import { Effect } from 'effect';\n * import { Database } from '$lib/server/database';\n *\n * export const load = runtime.serverLoad((event) =>\n *   Effect.gen(function* () {\n *     const db = yield* Database;\n *     return { items: yield* db.listItems() };\n *   })\n * );\n * ```\n *\n * Note that the application layer is built outside of any request, so its\n * services cannot depend on the per-request `SvelteKitRequestEvent` or\n * `HttpClient`. Request-specific data should be passed to service methods as\n * arguments instead.\n */\nexport const makeServerRuntime = <R = never, E = never>(\n  layer?: Layer.Layer<R, E>,\n): ServerRuntime<R, E> => {\n  const runtime = ManagedRuntime.make((layer ?? Layer.empty) as Layer.Layer<R, E>);\n\n  // Identity token tagging the per-request runtimes this runtime creates, so a\n  // different runtime's wrappers don't run on the wrong application layer.\n  const owner = {};\n\n  /** A {@link RequestRuntime} that provides the prebuilt request services. */\n  const makeRequestRuntime = (\n    requestServices: Context.Context<SvelteKitServices>,\n  ): RequestRuntime<R> => {\n    const provide = <A>(effect: Effect.Effect<A, unknown, R | SvelteKitServices>) =>\n      Effect.provideContext(effect, requestServices) as Effect.Effect<A, unknown, R>;\n    return {\n      runPromiseExit: (effect) =>\n        runtime.runPromiseExit(provide(effect)) as Promise<Exit.Exit<any, unknown>>,\n      runPromise: (effect) => runtime.runPromiseExit(provide(effect)).then(settle),\n      runFork: (effect) => runtime.runFork(provide(effect)) as Fiber.Fiber<any, unknown>,\n    };\n  };\n\n  /** The per-request runtime for this runtime carried by the event, if any. */\n  const requestRuntimeOf = (event: RequestEvent): RequestRuntime<R> | undefined => {\n    const entry = requestRuntimeEntry(event);\n    return entry?.owner === owner ? (entry.runtime as RequestRuntime<R>) : undefined;\n  };\n\n  const runExit = <A>(\n    event: RequestEvent,\n    effect: Effect.Effect<A, unknown, R | SvelteKitServices>,\n  ): Promise<Exit.Exit<A, unknown>> => {\n    // Reuse the per-request runtime `handle` installed, if any; otherwise build\n    // the per-request services for this single call.\n    const requestRuntime = requestRuntimeOf(event);\n    if (requestRuntime !== undefined) return requestRuntime.runPromiseExit(effect);\n    const provided = Effect.provide(effect, requestLayer(event)) as Effect.Effect<A, unknown, R>;\n    return runtime.runPromiseExit(provided) as Promise<Exit.Exit<A, unknown>>;\n  };\n\n  const run = <A>(\n    event: RequestEvent,\n    effect: Effect.Effect<A, unknown, R | SvelteKitServices>,\n  ): Promise<A> => runExit(event, effect).then(settle);\n\n  const action: ServerRuntime<R, E>[\"action\"] = (fn) => (event) => run(event, fn(event));\n\n  /**\n   * The `handle` hook: build a per-request runtime, store it on `event.locals`\n   * so every other wrapper (and the user's own code) runs on it, run the user's\n   * effect, then close the request scope.\n   */\n  const handle: ServerRuntime<R, E>[\"handle\"] = (fn) => async (input) => {\n    const { event } = input;\n    const scope = Scope.makeUnsafe();\n    const requestServices = (await runtime.runPromise(\n      Layer.buildWithScope(requestLayer(event), scope),\n    )) as Context.Context<SvelteKitServices>;\n\n    const entry: RequestRuntimeEntry = { owner, runtime: makeRequestRuntime(requestServices) };\n    (event.locals as Record<PropertyKey, unknown>)[RequestRuntimeKey] = entry;\n\n    try {\n      return await (entry.runtime as RequestRuntime<R>).runPromise(fn(input));\n    } finally {\n      await runtime.runPromise(Scope.close(scope, Exit.void));\n    }\n  };\n\n  return {\n    runtime,\n    serverLoad: (fn) => (event) => run(event, fn(event)),\n    action,\n    actions: (actionsMap) => {\n      const wrapped: Record<string, Action<any, any, any>> = {};\n      for (const [key, fn] of Object.entries(actionsMap)) {\n        wrapped[key] = action(fn);\n      }\n      return wrapped as never;\n    },\n    handle,\n    handleFetch: (fn) => (args) => run(args.event, fn(args)),\n    handleError: (fn) => (args) => run(args.event, fn(args)),\n    init: (effect) => async () => {\n      // `init` runs outside of any request, so it executes directly on the\n      // application runtime without the per-request layer.\n      settle(await runtime.runPromiseExit(effect));\n    },\n    requestRuntime: requestRuntimeOf,\n    endpoint: (fn) => (event) => run(event, fn(event)),\n    runPromise: run,\n    runPromiseExit: runExit,\n    dispose: () => runtime.dispose(),\n  };\n};\n\n/**\n * A universal (client + server) Effect runtime bound to an application layer.\n *\n * Produced by {@link makeUniversalRuntime}. Because universal `load`\n * functions also run in the browser, the layer must only use services that\n * work in both environments.\n */\nexport interface UniversalRuntime<R = never, E = never> {\n  /** The underlying managed runtime for the application layer. */\n  readonly runtime: ManagedRuntime.ManagedRuntime<R, E>;\n\n  /**\n   * Wraps an Effect-based function as a SvelteKit universal `load`.\n   *\n   * The effect gets `HttpClient` (backed by the load event's `fetch`) on both\n   * client and server, plus the services of the application layer.\n   */\n  readonly load: <\n    Params extends Record<string, string> = any,\n    InputData extends Record<string, unknown> | null = any,\n    ParentData extends Record<string, unknown> = any,\n    OutputData extends Record<string, unknown> | void = any,\n    RouteId extends string | null = any,\n  >(\n    fn: (\n      event: Parameters<Load<Params, InputData, ParentData, OutputData, RouteId>>[0],\n    ) => Effect.Effect<OutputData, unknown, R | HttpClient.HttpClient>,\n  ) => Load<Params, InputData, ParentData, OutputData, RouteId>;\n\n  /**\n   * Runs an effect with `HttpClient` backed by the given fetch implementation\n   * plus the application layer.\n   */\n  readonly runPromise: <A>(\n    fetchFn: typeof globalThis.fetch,\n    effect: Effect.Effect<A, unknown, R | HttpClient.HttpClient>,\n  ) => Promise<A>;\n\n  /**\n   * Disposes the underlying managed runtime, running the layer's finalizers.\n   */\n  readonly dispose: () => Promise<void>;\n}\n\n/**\n * Creates a {@link UniversalRuntime} from an application layer.\n *\n * @example\n * ```ts\n * // src/lib/runtime.ts\n * import { makeUniversalRuntime } from '@thomasfosterau/effect-sveltekit';\n * import { ApiClient } from '$lib/api';\n *\n * export const runtime = makeUniversalRuntime(ApiClient.layer);\n * ```\n *\n * ```ts\n * // src/routes/+page.ts\n * import { runtime } from '$lib/runtime';\n * import { Effect } from 'effect';\n * import { ApiClient } from '$lib/api';\n *\n * export const load = runtime.load((event) =>\n *   Effect.gen(function* () {\n *     const api = yield* ApiClient;\n *     return { stories: yield* api.topStories() };\n *   })\n * );\n * ```\n */\nexport const makeUniversalRuntime = <R = never, E = never>(\n  layer?: Layer.Layer<R, E>,\n): UniversalRuntime<R, E> => {\n  const runtime = ManagedRuntime.make((layer ?? Layer.empty) as Layer.Layer<R, E>);\n\n  const run = <A>(\n    fetchFn: typeof globalThis.fetch,\n    effect: Effect.Effect<A, unknown, R | HttpClient.HttpClient>,\n    event?: RequestEvent,\n  ): Promise<A> => {\n    // On the server the full request layer (HttpClient + SvelteKitRequestEvent)\n    // is available; on the client only HttpClient backed by the event's fetch.\n    const services = event ? requestLayer(event) : fetchLayer(fetchFn);\n    const provided = Effect.provide(effect, services) as Effect.Effect<A, unknown, R>;\n    return runtime.runPromiseExit(provided).then(settle);\n  };\n\n  return {\n    runtime,\n    load: (fn) => (event) => {\n      const serverEvent = (event as { request?: unknown }).request\n        ? (event as unknown as RequestEvent)\n        : undefined;\n      return run(event.fetch, fn(event), serverEvent);\n    },\n    runPromise: (fetchFn, effect) => run(fetchFn, effect),\n    dispose: () => runtime.dispose(),\n  };\n};\n"],"mappings":"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"}

package/dist/client/Hooks.d.ts

@@ -0,0 +1,48 @@
+import { Effect } from "effect";
+import { ClientInit, HandleClientError } from "@sveltejs/kit";
+
+//#region src/client/Hooks.d.ts
+declare namespace Hooks_d_exports {
+  export { handleError, init };
+}
+/**
+ * Wraps an Effect-based function as the SvelteKit client
+ * [`handleError`](https://svelte.dev/docs/kit/hooks#Shared-hooks-handleError)
+ * hook, which runs when an unexpected error is thrown while navigating in the
+ * browser. The effect receives the error and navigation event and produces the
+ * shape exposed to the page (your `App.Error`, or nothing).
+ *
+ * @example
+ * ```ts
+ * // src/hooks.client.ts
+ * import { Hooks } from '@thomasfosterau/effect-sveltekit/client';
+ * import { Effect } from 'effect';
+ *
+ * export const handleError = Hooks.handleError(({ error, event }) =>
+ *   Effect.gen(function* () {
+ *     yield* Effect.logError(`navigation to ${event.url.pathname} failed`, error);
+ *     return { message: 'Something went wrong' };
+ *   })
+ * );
+ * ```
+ */
+declare function handleError(fn: (args: Parameters<HandleClientError>[0]) => Effect.Effect<Awaited<ReturnType<HandleClientError>>, unknown>): HandleClientError;
+/**
+ * Wraps an Effect as the SvelteKit client
+ * [`init`](https://svelte.dev/docs/kit/hooks#Shared-hooks-init) hook, which
+ * runs once when the app starts in the browser. The effect runs on a bare
+ * Effect runtime.
+ *
+ * @example
+ * ```ts
+ * // src/hooks.client.ts
+ * import { Hooks } from '@thomasfosterau/effect-sveltekit/client';
+ * import { Effect } from 'effect';
+ *
+ * export const init = Hooks.init(Effect.logInfo('client app started'));
+ * ```
+ */
+declare function init(effect: Effect.Effect<void, unknown>): ClientInit;
+//#endregion
+export { Hooks_d_exports };
+//# sourceMappingURL=Hooks.d.ts.map

package/dist/client/Hooks.js

@@ -0,0 +1,61 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { causeToThrowable } from "../internal/error.js";
+import { Effect, Exit } from "effect";
+//#region src/client/Hooks.ts
+var Hooks_exports = /* @__PURE__ */ __exportAll({
+	handleError: () => handleError,
+	init: () => init
+});
+/** Run a bare Effect (no request context) and settle it the way a hook expects. */
+const runBareHook = async (effect) => Exit.match(await Effect.runPromiseExit(effect), {
+	onFailure: (cause) => {
+		throw causeToThrowable(cause);
+	},
+	onSuccess: (value) => value
+});
+/**
+* Wraps an Effect-based function as the SvelteKit client
+* [`handleError`](https://svelte.dev/docs/kit/hooks#Shared-hooks-handleError)
+* hook, which runs when an unexpected error is thrown while navigating in the
+* browser. The effect receives the error and navigation event and produces the
+* shape exposed to the page (your `App.Error`, or nothing).
+*
+* @example
+* ```ts
+* // src/hooks.client.ts
+* import { Hooks } from '@thomasfosterau/effect-sveltekit/client';
+* import { Effect } from 'effect';
+*
+* export const handleError = Hooks.handleError(({ error, event }) =>
+*   Effect.gen(function* () {
+*     yield* Effect.logError(`navigation to ${event.url.pathname} failed`, error);
+*     return { message: 'Something went wrong' };
+*   })
+* );
+* ```
+*/
+function handleError(fn) {
+	return (args) => runBareHook(fn(args));
+}
+/**
+* Wraps an Effect as the SvelteKit client
+* [`init`](https://svelte.dev/docs/kit/hooks#Shared-hooks-init) hook, which
+* runs once when the app starts in the browser. The effect runs on a bare
+* Effect runtime.
+*
+* @example
+* ```ts
+* // src/hooks.client.ts
+* import { Hooks } from '@thomasfosterau/effect-sveltekit/client';
+* import { Effect } from 'effect';
+*
+* export const init = Hooks.init(Effect.logInfo('client app started'));
+* ```
+*/
+function init(effect) {
+	return () => runBareHook(effect);
+}
+//#endregion
+export { Hooks_exports };
+
+//# sourceMappingURL=Hooks.js.map

package/dist/client/Hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hooks.js","names":[],"sources":["../../src/client/Hooks.ts"],"sourcesContent":["/**\n * Effect wrappers for SvelteKit's client-side hooks (`src/hooks.client.ts`),\n * exposed as the `Hooks` namespace of `@thomasfosterau/effect-sveltekit/client`.\n *\n * These mirror the server hook helpers in `../server/Hooks.ts`, but run on the\n * client: there is no request context, so each effect runs on a bare Effect\n * runtime. For application services, run the effect through your own runtime\n * instead. Kept free of `$app/*` imports so it stays importable (and testable)\n * outside of a SvelteKit app.\n *\n * @example\n * ```ts\n * // src/hooks.client.ts\n * import { Hooks } from '@thomasfosterau/effect-sveltekit/client';\n * import { Effect } from 'effect';\n *\n * export const handleError = Hooks.handleError(({ error, event }) =>\n *   Effect.as(Effect.logError(`navigation to ${event.url.pathname} failed`, error), {\n *     message: 'Something went wrong',\n *   })\n * );\n * ```\n */\n\nimport type { ClientInit, HandleClientError } from \"@sveltejs/kit\";\nimport { Effect, Exit } from \"effect\";\nimport { causeToThrowable } from \"../internal/error.js\";\n\n/** Run a bare Effect (no request context) and settle it the way a hook expects. */\nconst runBareHook = async <A>(effect: Effect.Effect<A, unknown>): Promise<A> =>\n  Exit.match(await Effect.runPromiseExit(effect), {\n    onFailure: (cause) => {\n      throw causeToThrowable(cause);\n    },\n    onSuccess: (value) => value,\n  });\n\n/**\n * Wraps an Effect-based function as the SvelteKit client\n * [`handleError`](https://svelte.dev/docs/kit/hooks#Shared-hooks-handleError)\n * hook, which runs when an unexpected error is thrown while navigating in the\n * browser. The effect receives the error and navigation event and produces the\n * shape exposed to the page (your `App.Error`, or nothing).\n *\n * @example\n * ```ts\n * // src/hooks.client.ts\n * import { Hooks } from '@thomasfosterau/effect-sveltekit/client';\n * import { Effect } from 'effect';\n *\n * export const handleError = Hooks.handleError(({ error, event }) =>\n *   Effect.gen(function* () {\n *     yield* Effect.logError(`navigation to ${event.url.pathname} failed`, error);\n *     return { message: 'Something went wrong' };\n *   })\n * );\n * ```\n */\nexport function handleError(\n  fn: (\n    args: Parameters<HandleClientError>[0],\n  ) => Effect.Effect<Awaited<ReturnType<HandleClientError>>, unknown>,\n): HandleClientError {\n  return (args) => runBareHook(fn(args));\n}\n\n/**\n * Wraps an Effect as the SvelteKit client\n * [`init`](https://svelte.dev/docs/kit/hooks#Shared-hooks-init) hook, which\n * runs once when the app starts in the browser. The effect runs on a bare\n * Effect runtime.\n *\n * @example\n * ```ts\n * // src/hooks.client.ts\n * import { Hooks } from '@thomasfosterau/effect-sveltekit/client';\n * import { Effect } from 'effect';\n *\n * export const init = Hooks.init(Effect.logInfo('client app started'));\n * ```\n */\nexport function init(effect: Effect.Effect<void, unknown>): ClientInit {\n  return () => runBareHook(effect);\n}\n"],"mappings":";;;;;;;;;AA6BA,MAAM,cAAc,OAAU,WAC5B,KAAK,MAAM,MAAM,OAAO,eAAe,MAAM,GAAG;CAC9C,YAAY,UAAU;EACpB,MAAM,iBAAiB,KAAK;CAC9B;CACA,YAAY,UAAU;AACxB,CAAC;;;;;;;;;;;;;;;;;;;;;;AAuBH,SAAgB,YACd,IAGmB;CACnB,QAAQ,SAAS,YAAY,GAAG,IAAI,CAAC;AACvC;;;;;;;;;;;;;;;;AAiBA,SAAgB,KAAK,QAAkD;CACrE,aAAa,YAAY,MAAM;AACjC"}

package/dist/client.d.ts

@@ -0,0 +1,6 @@
+import { Navigation_d_exports } from "./Navigation.js";
+import { State_d_exports } from "./State.js";
+import { Remote_d_exports } from "./Remote.js";
+import { useRemoteQuery } from "./remote-reactive.js";
+import { Hooks_d_exports } from "./client/Hooks.js";
+export { Hooks_d_exports as Hooks, Navigation_d_exports as Navigation, Remote_d_exports as Remote, State_d_exports as State, useRemoteQuery };

package/dist/client.js

@@ -0,0 +1,6 @@
+import { Remote_exports } from "./Remote.js";
+import { Navigation_exports } from "./Navigation.js";
+import { State_exports } from "./State.js";
+import { useRemoteQuery } from "./remote-reactive.js";
+import { Hooks_exports } from "./client/Hooks.js";
+export { Hooks_exports as Hooks, Navigation_exports as Navigation, Remote_exports as Remote, State_exports as State, useRemoteQuery };

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+import { ConfigProvider, Layer } from "effect";
+
+//#region src/config.d.ts
+/**
+ * Creates a {@link ConfigProvider} backed by a SvelteKit env record (e.g. the
+ * `env` export of `$env/dynamic/private`, or `import.meta.env`-style objects).
+ */
+declare const sveltekitConfigProvider: (env: Record<string, string | undefined>) => ConfigProvider.ConfigProvider;
+/**
+ * Creates a `Layer` that installs {@link sveltekitConfigProvider} as the
+ * ambient config provider. Provide it to a server/universal runtime so the
+ * application layer's `Config` reads resolve from SvelteKit's environment.
+ */
+declare const sveltekitConfig: (env: Record<string, string | undefined>) => Layer.Layer<never>;
+//#endregion
+export { sveltekitConfig, sveltekitConfigProvider };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -0,0 +1,51 @@
+import { ConfigProvider } from "effect";
+//#region src/config.ts
+/**
+* SvelteKit `$env` ⇄ Effect `Config`.
+*
+* Effect services read configuration through {@link Config} / a
+* {@link ConfigProvider}, while SvelteKit exposes configuration through its
+* `$env/static/*` and `$env/dynamic/*` virtual modules. These helpers bridge
+* the two: pass a SvelteKit env record and get back a `ConfigProvider` (or a
+* `Layer` that installs it), so any `Config.string("DATABASE_URL")` resolves
+* from SvelteKit's environment.
+*
+* ```ts
+* // src/lib/server/runtime.ts
+* import { env } from "$env/dynamic/private";
+* import { sveltekitConfig } from "@thomasfosterau/effect-sveltekit/server";
+* import { makeServerRuntime } from "@thomasfosterau/effect-sveltekit/server";
+* import { Layer } from "effect";
+* import { Database } from "./database";
+*
+* export const runtime = makeServerRuntime(
+*   // Database.layer reads Config.string("DATABASE_URL"), now backed by $env
+*   Database.layer.pipe(Layer.provide(sveltekitConfig(env))),
+* );
+* ```
+*
+* `ConfigProvider.fromEnv` joins/splits path segments on `_`, so nested config
+* (`Config.string("HOST").pipe(...nested("DATABASE"))`) resolves a
+* `DATABASE_HOST` env var just like it does from `process.env`.
+*/
+/** Drop `undefined` values so the record satisfies `ConfigProvider.fromEnv`. */
+const definedEntries = (env) => {
+	const out = {};
+	for (const [key, value] of Object.entries(env)) if (value !== void 0) out[key] = value;
+	return out;
+};
+/**
+* Creates a {@link ConfigProvider} backed by a SvelteKit env record (e.g. the
+* `env` export of `$env/dynamic/private`, or `import.meta.env`-style objects).
+*/
+const sveltekitConfigProvider = (env) => ConfigProvider.fromEnv({ env: definedEntries(env) });
+/**
+* Creates a `Layer` that installs {@link sveltekitConfigProvider} as the
+* ambient config provider. Provide it to a server/universal runtime so the
+* application layer's `Config` reads resolve from SvelteKit's environment.
+*/
+const sveltekitConfig = (env) => ConfigProvider.layer(sveltekitConfigProvider(env));
+//#endregion
+export { sveltekitConfig, sveltekitConfigProvider };
+
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["/**\n * SvelteKit `$env` ⇄ Effect `Config`.\n *\n * Effect services read configuration through {@link Config} / a\n * {@link ConfigProvider}, while SvelteKit exposes configuration through its\n * `$env/static/*` and `$env/dynamic/*` virtual modules. These helpers bridge\n * the two: pass a SvelteKit env record and get back a `ConfigProvider` (or a\n * `Layer` that installs it), so any `Config.string(\"DATABASE_URL\")` resolves\n * from SvelteKit's environment.\n *\n * ```ts\n * // src/lib/server/runtime.ts\n * import { env } from \"$env/dynamic/private\";\n * import { sveltekitConfig } from \"@thomasfosterau/effect-sveltekit/server\";\n * import { makeServerRuntime } from \"@thomasfosterau/effect-sveltekit/server\";\n * import { Layer } from \"effect\";\n * import { Database } from \"./database\";\n *\n * export const runtime = makeServerRuntime(\n *   // Database.layer reads Config.string(\"DATABASE_URL\"), now backed by $env\n *   Database.layer.pipe(Layer.provide(sveltekitConfig(env))),\n * );\n * ```\n *\n * `ConfigProvider.fromEnv` joins/splits path segments on `_`, so nested config\n * (`Config.string(\"HOST\").pipe(...nested(\"DATABASE\"))`) resolves a\n * `DATABASE_HOST` env var just like it does from `process.env`.\n */\n\nimport { ConfigProvider, type Layer } from \"effect\";\n\n/** Drop `undefined` values so the record satisfies `ConfigProvider.fromEnv`. */\nconst definedEntries = (env: Record<string, string | undefined>): Record<string, string> => {\n  const out: Record<string, string> = {};\n  for (const [key, value] of Object.entries(env)) {\n    if (value !== undefined) out[key] = value;\n  }\n  return out;\n};\n\n/**\n * Creates a {@link ConfigProvider} backed by a SvelteKit env record (e.g. the\n * `env` export of `$env/dynamic/private`, or `import.meta.env`-style objects).\n */\nexport const sveltekitConfigProvider = (\n  env: Record<string, string | undefined>,\n): ConfigProvider.ConfigProvider => ConfigProvider.fromEnv({ env: definedEntries(env) });\n\n/**\n * Creates a `Layer` that installs {@link sveltekitConfigProvider} as the\n * ambient config provider. Provide it to a server/universal runtime so the\n * application layer's `Config` reads resolve from SvelteKit's environment.\n */\nexport const sveltekitConfig = (env: Record<string, string | undefined>): Layer.Layer<never> =>\n  ConfigProvider.layer(sveltekitConfigProvider(env));\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,MAAM,kBAAkB,QAAoE;CAC1F,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,GAAG,GAC3C,IAAI,UAAU,KAAA,GAAW,IAAI,OAAO;CAEtC,OAAO;AACT;;;;;AAMA,MAAa,2BACX,QACkC,eAAe,QAAQ,EAAE,KAAK,eAAe,GAAG,EAAE,CAAC;;;;;;AAOvF,MAAa,mBAAmB,QAC9B,eAAe,MAAM,wBAAwB,GAAG,CAAC"}