@thomasfosterau/effect-sveltekit 0.5.0 → 0.7.0

package/dist/testing.d.ts

@@ -1,10 +1,11 @@
 import { ErrorTranslator } from "./request-runtime.js";
 import { FormErrorMapper, RunHelpers } from "./internal/remote-run.js";
-import { Effect, Layer } from "effect";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
 import { RequestEvent } from "@sveltejs/kit";
 //#region src/testing.d.ts
 /** Options for {@link TestRequestEvent}. */
-interface TestRequestEventOptions {
+export interface TestRequestEventOptions {
   /**
    * The request URL. Accepts a `string` or a `URL` instance.
    * Defaults to `"http://localhost/"`.
@@ -22,10 +23,10 @@ interface TestRequestEventOptions {
    */
   readonly params?: Record<string, string>;
   /**
-   * Initial `event.locals` value. Defaults to `{}`.
-   * Cast to `App.Locals` — extend it with the properties your handlers need.
+   * Initial `event.locals` value, typed as your app's `App.Locals` (declare its
+   * fields in `src/app.d.ts`). Defaults to `{}`.
    */
-  readonly locals?: Record<string, unknown>;
+  readonly locals?: App.Locals;
   /**
    * Pre-seeded cookies as `{ name: value }` pairs.
    * The backing store supports `get`, `getAll`, `set`, `delete`, and
@@ -36,7 +37,7 @@ interface TestRequestEventOptions {
    * The `event.platform` value, if any.
    * Pass a partial platform object matching the environment the handler targets.
    */
-  readonly platform?: unknown;
+  readonly platform?: App.Platform;
   /**
    * The `fetch` implementation used by `event.fetch`.
    * Defaults to `globalThis.fetch`. Pass a custom function to intercept or
@@ -61,12 +62,12 @@ interface TestRequestEventOptions {
  * });
  * ```
  */
-declare function TestRequestEvent(opts?: TestRequestEventOptions): RequestEvent;
+export declare function TestRequestEvent(opts?: TestRequestEventOptions): RequestEvent;
 /**
  * Options shared by {@link runServerLoad}, {@link runAction}, and
  * {@link runEndpoint}.
  */
-interface TestRunOptions<R> {
+export interface TestRunOptions<R> {
   /**
    * The `Layer` providing the handler effect's required services `R`.
    * Omit when the handler has no service requirements (`R` is `never`).
@@ -82,7 +83,7 @@ interface TestRunOptions<R> {
 /**
  * Options for {@link runRemote}.
  */
-interface RunRemoteOptions<R> {
+export interface RunRemoteOptions<R> {
   /** The `Layer` providing the remote handler's service requirements. */
   readonly layer?: Layer.Layer<R>;
   /**
@@ -118,7 +119,7 @@ interface RunRemoteOptions<R> {
  * expect(data.items).toHaveLength(0);
  * ```
  */
-declare const runServerLoad: <R, A extends Record<string, any> | void = void>(fn: (event: RequestEvent) => Effect.Effect<A, unknown, R>, event: RequestEvent, opts?: TestRunOptions<R>) => Promise<A>;
+export declare const runServerLoad: <R, A extends Record<string, any> | void = void>(fn: (event: RequestEvent) => Effect.Effect<A, unknown, R>, event: RequestEvent, opts?: TestRunOptions<R>) => Promise<A>;
 /**
  * Run an Effect-based form action handler under test.
  *
@@ -131,7 +132,7 @@ declare const runServerLoad: <R, A extends Record<string, any> | void = void>(fn
  * expect((result as any).success).toBe(true);
  * ```
  */
-declare const runAction: <R, A extends Record<string, any> | void = void>(fn: (event: RequestEvent) => Effect.Effect<A, unknown, R>, event: RequestEvent, opts?: TestRunOptions<R>) => Promise<A>;
+export declare const runAction: <R, A extends Record<string, any> | void = void>(fn: (event: RequestEvent) => Effect.Effect<A, unknown, R>, event: RequestEvent, opts?: TestRunOptions<R>) => Promise<A>;
 /**
  * Run an Effect-based `+server.ts` endpoint handler under test.
  *
@@ -144,7 +145,7 @@ declare const runAction: <R, A extends Record<string, any> | void = void>(fn: (e
  * expect(response.status).toBe(200);
  * ```
  */
-declare const runEndpoint: <R>(fn: (event: RequestEvent) => Effect.Effect<Response, unknown, R>, event: RequestEvent, opts?: TestRunOptions<R>) => Promise<Response>;
+export declare const runEndpoint: <R>(fn: (event: RequestEvent) => Effect.Effect<Response, unknown, R>, event: RequestEvent, opts?: TestRunOptions<R>) => Promise<Response>;
 /**
  * Build a `{ run, runForm }` helper pair for directly invoking remote-function
  * Effect handlers under test.
@@ -168,7 +169,7 @@ declare const runEndpoint: <R>(fn: (event: RequestEvent) => Effect.Effect<Respon
  * expect(items).toEqual([]);
  * ```
  */
-declare const runRemote: <R = never>(event: RequestEvent, opts?: RunRemoteOptions<R>) => RunHelpers;
+export declare const runRemote: <R = never>(event: RequestEvent, opts?: RunRemoteOptions<R>) => RunHelpers;
 //#endregion
-export { type FormErrorMapper, type RunHelpers, RunRemoteOptions, TestRequestEvent, TestRequestEventOptions, TestRunOptions, runAction, runEndpoint, runRemote, runServerLoad };
+export type { FormErrorMapper, RunHelpers };
 //# sourceMappingURL=testing.d.ts.map

package/dist/testing.js

@@ -1,28 +1,48 @@
 import { SvelteKit } from "./kit.js";
 import { makeRunHelpers } from "./internal/remote-run.js";
 import { RequestRuntime, makeRuntimeAdapter } from "./request-runtime.js";
-import { Layer } from "effect";
+import "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Rec from "effect/Record";
+import * as Arr from "effect/Array";
+import * as Option from "effect/Option";
 //#region src/testing.ts
-/** Map-backed Cookies implementation for use in {@link TestRequestEvent}. */
+/**
+* In-memory Cookies implementation for use in {@link TestRequestEvent}: an
+* ordered list, so `getAll()` returns cookies in the order they were first set
+* (as SvelteKit's does), and `set` on an existing name replaces it in place.
+*/
 var TestCookies = class {
 	store;
 	constructor(initial = {}) {
-		this.store = new Map(Object.entries(initial));
+		this.store = Arr.map(Rec.toEntries(initial), ([name, value]) => ({
+			name,
+			value
+		}));
 	}
 	get(name, _opts) {
-		return this.store.get(name);
+		return Option.getOrUndefined(Option.map(Arr.findFirst(this.store, (cookie) => cookie.name === name), (cookie) => cookie.value));
 	}
 	getAll(_opts) {
-		return [...this.store.entries()].map(([name, value]) => ({
+		return Arr.map(this.store, ({ name, value }) => ({
 			name,
 			value
 		}));
 	}
 	set(name, value, _opts) {
-		this.store.set(name, value);
+		this.store = Option.match(Arr.findFirstIndex(this.store, (cookie) => cookie.name === name), {
+			onNone: () => Arr.append(this.store, {
+				name,
+				value
+			}),
+			onSome: (index) => Arr.map(this.store, (cookie, i) => i === index ? {
+				name,
+				value
+			} : cookie)
+		});
 	}
 	delete(name, _opts) {
-		this.store.delete(name);
+		this.store = Arr.filter(this.store, (cookie) => cookie.name !== name);
 	}
 	serialize(name, value, _opts) {
 		return `${name}=${encodeURIComponent(value)}`;

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["/**\n * Framework-agnostic test utilities for `@thomasfosterau/effect-sveltekit`.\n *\n * Exports a minimal {@link TestRequestEvent} constructor and plain-async\n * runner helpers ({@link runServerLoad}, {@link runAction},\n * {@link runEndpoint}, {@link runRemote}) so Effect-based SvelteKit handlers\n * can be unit-tested without mocking the SvelteKit module graph or installing\n * `$app/server`.\n *\n * Ships under the `./testing` subpath of `@thomasfosterau/effect-sveltekit`.\n * It has no coupling to Vitest, Jest, or any other test framework — import\n * it from whichever test runner you use.\n *\n * @example\n * ```ts\n * import {\n *   TestRequestEvent,\n *   runServerLoad,\n *   runAction,\n *   runRemote,\n * } from \"@thomasfosterau/effect-sveltekit/testing\";\n * import { Effect } from \"effect\";\n *\n * const event = TestRequestEvent({ params: { id: \"1\" }, locals: { user } });\n *\n * // Test a server load:\n * const data = await runServerLoad(\n *   (event) =>\n *     Effect.gen(function* () {\n *       const db = yield* Database;\n *       return { item: yield* db.findById(event.params.id) };\n *     }),\n *   event,\n *   { layer: TestDatabase.layer },\n * );\n *\n * // Test a remote function handler directly:\n * const { run } = runRemote(event, { layer: TestLayer });\n * const items = await run(listItems());\n * ```\n */\n\nimport type { RequestEvent } from \"@sveltejs/kit\";\nimport { Effect, Layer } from \"effect\";\nimport {\n  makeRuntimeAdapter,\n  RequestRuntime,\n  type ErrorTranslator,\n  type RequestRuntimeProvider,\n} from \"./request-runtime.js\";\nimport { SvelteKit } from \"./kit.js\";\nimport { makeRunHelpers, type FormErrorMapper, type RunHelpers } from \"./internal/remote-run.js\";\n\nexport type { RunHelpers, FormErrorMapper } from \"./internal/remote-run.js\";\n\n// ─── TestCookies ─────────────────────────────────────────────────────────────\n\n/** Map-backed Cookies implementation for use in {@link TestRequestEvent}. */\nclass TestCookies {\n  private readonly store: Map<string, string>;\n\n  constructor(initial: Record<string, string> = {}) {\n    this.store = new Map(Object.entries(initial));\n  }\n\n  get(name: string, _opts?: unknown): string | undefined {\n    return this.store.get(name);\n  }\n\n  getAll(_opts?: unknown): Array<{ name: string; value: string }> {\n    return [...this.store.entries()].map(([name, value]) => ({ name, value }));\n  }\n\n  set(name: string, value: string, _opts?: unknown): void {\n    this.store.set(name, value);\n  }\n\n  delete(name: string, _opts?: unknown): void {\n    this.store.delete(name);\n  }\n\n  serialize(name: string, value: string, _opts?: unknown): string {\n    return `${name}=${encodeURIComponent(value)}`;\n  }\n}\n\n// ─── TestRequestEvent ─────────────────────────────────────────────────────────\n\n/** Options for {@link TestRequestEvent}. */\nexport interface TestRequestEventOptions {\n  /**\n   * The request URL. Accepts a `string` or a `URL` instance.\n   * Defaults to `\"http://localhost/\"`.\n   */\n  readonly url?: string | URL;\n  /** The HTTP method. Defaults to `\"GET\"`. */\n  readonly method?: string;\n  /** Additional HTTP headers added to the underlying `Request`. */\n  readonly headers?: HeadersInit;\n  /** The request body. Only usable with methods that accept a body. */\n  readonly body?: BodyInit | null;\n  /**\n   * Route params (e.g. `{ id: \"123\" }` for a route like `/items/[id]`).\n   * Defaults to `{}`.\n   */\n  readonly params?: Record<string, string>;\n  /**\n   * Initial `event.locals` value. Defaults to `{}`.\n   * Cast to `App.Locals` — extend it with the properties your handlers need.\n   */\n  readonly locals?: Record<string, unknown>;\n  /**\n   * Pre-seeded cookies as `{ name: value }` pairs.\n   * The backing store supports `get`, `getAll`, `set`, `delete`, and\n   * `serialize`; the object is cast to SvelteKit's `Cookies` interface.\n   */\n  readonly cookies?: Record<string, string>;\n  /**\n   * The `event.platform` value, if any.\n   * Pass a partial platform object matching the environment the handler targets.\n   */\n  readonly platform?: unknown;\n  /**\n   * The `fetch` implementation used by `event.fetch`.\n   * Defaults to `globalThis.fetch`. Pass a custom function to intercept or\n   * stub network calls made by the handler.\n   */\n  readonly fetch?: typeof globalThis.fetch;\n}\n\n/**\n * Create a minimal {@link RequestEvent} for use in unit tests.\n *\n * All fields are optional — omit what the handler under test doesn't inspect.\n * Cookies are backed by an in-memory `Map`; mutations (`set`, `delete`) are\n * reflected in subsequent `get`/`getAll` calls on the same event.\n *\n * @example\n * ```ts\n * const event = TestRequestEvent({\n *   url: \"http://localhost/items/42\",\n *   params: { id: \"42\" },\n *   locals: { user: { id: \"u1\", role: \"admin\" } },\n *   cookies: { session: \"tok_test\" },\n * });\n * ```\n */\nexport function TestRequestEvent(opts: TestRequestEventOptions = {}): RequestEvent {\n  const rawUrl = opts.url instanceof URL ? opts.url.toString() : (opts.url ?? \"http://localhost/\");\n  const url = new URL(rawUrl);\n\n  const init: RequestInit = { method: opts.method ?? \"GET\" };\n  if (opts.headers !== undefined) init.headers = opts.headers;\n  if (opts.body !== undefined) init.body = opts.body;\n\n  const request = new Request(url.toString(), init);\n  const cookies = new TestCookies(opts.cookies ?? {});\n  const fetchFn = opts.fetch ?? globalThis.fetch;\n\n  return {\n    request,\n    url,\n    params: (opts.params ?? {}) as any,\n    route: { id: null },\n    fetch: fetchFn,\n    cookies: cookies as any,\n    locals: (opts.locals ?? {}) as any,\n    platform: opts.platform as any,\n    isDataRequest: false,\n    isSubRequest: false,\n    setHeaders: () => {},\n    getClientAddress: () => \"127.0.0.1\",\n  } as unknown as RequestEvent;\n}\n\n// ─── Options ──────────────────────────────────────────────────────────────────\n\n/**\n * Options shared by {@link runServerLoad}, {@link runAction}, and\n * {@link runEndpoint}.\n */\nexport interface TestRunOptions<R> {\n  /**\n   * The `Layer` providing the handler effect's required services `R`.\n   * Omit when the handler has no service requirements (`R` is `never`).\n   */\n  readonly layer?: Layer.Layer<R>;\n  /**\n   * Translate a failed `Cause` at the boundary. Defaults to\n   * {@link SvelteKit.translate} (Kit control-flow through; anything else\n   * becomes an `EffectCauseError`).\n   */\n  readonly translateError?: ErrorTranslator;\n}\n\n/**\n * Options for {@link runRemote}.\n */\nexport interface RunRemoteOptions<R> {\n  /** The `Layer` providing the remote handler's service requirements. */\n  readonly layer?: Layer.Layer<R>;\n  /**\n   * Translate a failed `Cause` at the boundary. Defaults to\n   * {@link SvelteKit.translate}.\n   */\n  readonly translateError?: ErrorTranslator;\n  /**\n   * Map a remote form handler's failure to SvelteKit field issues. Receives\n   * the squashed handler failure and the `{ issue, data }` context. When\n   * provided it is called instead of `translateError` on the form error path.\n   */\n  readonly formError?: FormErrorMapper;\n}\n\n// ─── Internal ─────────────────────────────────────────────────────────────────\n\nconst makeAdapter = <R>(opts: TestRunOptions<R> | undefined) =>\n  makeRuntimeAdapter(RequestRuntime.fromLayer((opts?.layer ?? Layer.empty) as Layer.Layer<R>), {\n    translateError: opts?.translateError ?? SvelteKit.translate,\n  });\n\n// ─── runServerLoad ────────────────────────────────────────────────────────────\n\n/**\n * Run an Effect-based server `load` function under test.\n *\n * Wraps `fn` with `makeRuntimeAdapter` using the provided `opts.layer` (or\n * `Layer.empty` when omitted) and calls the resulting `ServerLoad` with\n * `event`. Errors are translated by `opts.translateError` (defaults to\n * {@link SvelteKit.translate}).\n *\n * @example\n * ```ts\n * const data = await runServerLoad(\n *   (event) => Effect.gen(function* () {\n *     const db = yield* Database;\n *     return { items: yield* db.list() };\n *   }),\n *   TestRequestEvent(),\n *   { layer: TestDatabase.layer },\n * );\n * expect(data.items).toHaveLength(0);\n * ```\n */\nexport const runServerLoad = <R, A extends Record<string, any> | void = void>(\n  fn: (event: RequestEvent) => Effect.Effect<A, unknown, R>,\n  event: RequestEvent,\n  opts?: TestRunOptions<R>,\n): Promise<A> => (makeAdapter(opts).serverLoad(fn) as (e: RequestEvent) => Promise<A>)(event);\n\n// ─── runAction ───────────────────────────────────────────────────────────────\n\n/**\n * Run an Effect-based form action handler under test.\n *\n * @example\n * ```ts\n * const result = await runAction(\n *   (_event) => Effect.succeed({ success: true }),\n *   TestRequestEvent({ method: \"POST\" }),\n * );\n * expect((result as any).success).toBe(true);\n * ```\n */\nexport const runAction = <R, A extends Record<string, any> | void = void>(\n  fn: (event: RequestEvent) => Effect.Effect<A, unknown, R>,\n  event: RequestEvent,\n  opts?: TestRunOptions<R>,\n): Promise<A> => (makeAdapter(opts).action(fn) as (e: RequestEvent) => Promise<A>)(event);\n\n// ─── runEndpoint ──────────────────────────────────────────────────────────────\n\n/**\n * Run an Effect-based `+server.ts` endpoint handler under test.\n *\n * @example\n * ```ts\n * const response = await runEndpoint(\n *   (_event) => Effect.succeed(new Response(JSON.stringify({ ok: true }))),\n *   TestRequestEvent({ url: \"http://localhost/api/ping\" }),\n * );\n * expect(response.status).toBe(200);\n * ```\n */\nexport const runEndpoint = <R>(\n  fn: (event: RequestEvent) => Effect.Effect<Response, unknown, R>,\n  event: RequestEvent,\n  opts?: TestRunOptions<R>,\n): Promise<Response> => Promise.resolve(makeAdapter(opts).endpoint(fn)(event as any));\n\n// ─── runRemote ────────────────────────────────────────────────────────────────\n\n/**\n * Build a `{ run, runForm }` helper pair for directly invoking remote-function\n * Effect handlers under test.\n *\n * Unlike the production `query` / `command` / `form` helpers, which resolve the\n * request event via `$app/server.getRequestEvent()`, this resolves it from the\n * `event` argument you supply — no SvelteKit module-graph mocking required.\n *\n * Use `run` for `query` / `command` handlers and `runForm` for `form` handlers\n * that need the `issue` / `data` context.\n *\n * @example\n * ```ts\n * import { TestRequestEvent, runRemote } from \"@thomasfosterau/effect-sveltekit/testing\";\n *\n * const event = TestRequestEvent();\n * const { run } = runRemote(event, { layer: TestDatabase.layer });\n *\n * // Invoke the underlying Effect directly — no AppServer needed:\n * const items = await run(listItemsEffect());\n * expect(items).toEqual([]);\n * ```\n */\nexport const runRemote = <R = never>(\n  event: RequestEvent,\n  opts?: RunRemoteOptions<R>,\n): RunHelpers => {\n  const translate = opts?.translateError ?? SvelteKit.translate;\n  const layer = (opts?.layer ?? Layer.empty) as Layer.Layer<R>;\n  const provider: RequestRuntimeProvider<R> = RequestRuntime.fromLayer(layer);\n  return makeRunHelpers(\n    () => ({ runExit: (effect) => provider.run(event).runPromiseExit(effect) }),\n    translate,\n    opts?.formError,\n  );\n};\n"],"mappings":";;;;;;AA0DA,IAAM,cAAN,MAAkB;CAChB;CAEA,YAAY,UAAkC,CAAC,GAAG;EAChD,KAAK,QAAQ,IAAI,IAAI,OAAO,QAAQ,OAAO,CAAC;CAC9C;CAEA,IAAI,MAAc,OAAqC;EACrD,OAAO,KAAK,MAAM,IAAI,IAAI;CAC5B;CAEA,OAAO,OAAyD;EAC9D,OAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,YAAY;GAAE;GAAM;EAAM,EAAE;CAC3E;CAEA,IAAI,MAAc,OAAe,OAAuB;EACtD,KAAK,MAAM,IAAI,MAAM,KAAK;CAC5B;CAEA,OAAO,MAAc,OAAuB;EAC1C,KAAK,MAAM,OAAO,IAAI;CACxB;CAEA,UAAU,MAAc,OAAe,OAAyB;EAC9D,OAAO,GAAG,KAAK,GAAG,mBAAmB,KAAK;CAC5C;AACF;;;;;;;;;;;;;;;;;;AA+DA,SAAgB,iBAAiB,OAAgC,CAAC,GAAiB;CACjF,MAAM,SAAS,KAAK,eAAe,MAAM,KAAK,IAAI,SAAS,IAAK,KAAK,OAAO;CAC5E,MAAM,MAAM,IAAI,IAAI,MAAM;CAE1B,MAAM,OAAoB,EAAE,QAAQ,KAAK,UAAU,MAAM;CACzD,IAAI,KAAK,YAAY,KAAA,GAAW,KAAK,UAAU,KAAK;CACpD,IAAI,KAAK,SAAS,KAAA,GAAW,KAAK,OAAO,KAAK;CAE9C,MAAM,UAAU,IAAI,QAAQ,IAAI,SAAS,GAAG,IAAI;CAChD,MAAM,UAAU,IAAI,YAAY,KAAK,WAAW,CAAC,CAAC;CAClD,MAAM,UAAU,KAAK,SAAS,WAAW;CAEzC,OAAO;EACL;EACA;EACA,QAAS,KAAK,UAAU,CAAC;EACzB,OAAO,EAAE,IAAI,KAAK;EAClB,OAAO;EACE;EACT,QAAS,KAAK,UAAU,CAAC;EACzB,UAAU,KAAK;EACf,eAAe;EACf,cAAc;EACd,kBAAkB,CAAC;EACnB,wBAAwB;CAC1B;AACF;AA2CA,MAAM,eAAkB,SACtB,mBAAmB,eAAe,UAAW,MAAM,SAAS,MAAM,KAAwB,GAAG,EAC3F,gBAAgB,MAAM,kBAAkB,UAAU,UACpD,CAAC;;;;;;;;;;;;;;;;;;;;;;AAyBH,MAAa,iBACX,IACA,OACA,SACgB,YAAY,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAqC,KAAK;;;;;;;;;;;;;AAgB5F,MAAa,aACX,IACA,OACA,SACgB,YAAY,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAqC,KAAK;;;;;;;;;;;;;AAgBxF,MAAa,eACX,IACA,OACA,SACsB,QAAQ,QAAQ,YAAY,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,KAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AA2BpF,MAAa,aACX,OACA,SACe;CACf,MAAM,YAAY,MAAM,kBAAkB,UAAU;CACpD,MAAM,QAAS,MAAM,SAAS,MAAM;CACpC,MAAM,WAAsC,eAAe,UAAU,KAAK;CAC1E,OAAO,sBACE,EAAE,UAAU,WAAW,SAAS,IAAI,KAAK,CAAC,CAAC,eAAe,MAAM,EAAE,IACzE,WACA,MAAM,SACR;AACF"}
+{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["/**\n * Framework-agnostic test utilities for `@thomasfosterau/effect-sveltekit`.\n *\n * Exports a minimal {@link TestRequestEvent} constructor and plain-async\n * runner helpers ({@link runServerLoad}, {@link runAction},\n * {@link runEndpoint}, {@link runRemote}) so Effect-based SvelteKit handlers\n * can be unit-tested without mocking the SvelteKit module graph or installing\n * `$app/server`.\n *\n * Ships under the `./testing` subpath of `@thomasfosterau/effect-sveltekit`.\n * It has no coupling to Vitest, Jest, or any other test framework — import\n * it from whichever test runner you use.\n *\n * @example\n * ```ts\n * import {\n *   TestRequestEvent,\n *   runServerLoad,\n *   runAction,\n *   runRemote,\n * } from \"@thomasfosterau/effect-sveltekit/testing\";\n * import { Effect } from \"effect\";\n *\n * const event = TestRequestEvent({ params: { id: \"1\" }, locals: { user } });\n *\n * // Test a server load:\n * const data = await runServerLoad(\n *   (event) =>\n *     Effect.gen(function* () {\n *       const db = yield* Database;\n *       return { item: yield* db.findById(event.params.id) };\n *     }),\n *   event,\n *   { layer: TestDatabase.layer },\n * );\n *\n * // Test a remote function handler directly:\n * const { run } = runRemote(event, { layer: TestLayer });\n * const items = await run(listItems());\n * ```\n */\n\nimport type { Cookies, RequestEvent } from \"@sveltejs/kit\";\nimport * as Effect from \"effect/Effect\";\nimport * as Arr from \"effect/Array\";\nimport * as Layer from \"effect/Layer\";\nimport * as Option from \"effect/Option\";\nimport * as Rec from \"effect/Record\";\nimport {\n  makeRuntimeAdapter,\n  RequestRuntime,\n  type ErrorTranslator,\n  type RequestRuntimeProvider,\n} from \"./request-runtime.js\";\nimport { SvelteKit } from \"./kit.js\";\nimport { makeRunHelpers, type FormErrorMapper, type RunHelpers } from \"./internal/remote-run.js\";\n\nexport type { RunHelpers, FormErrorMapper } from \"./internal/remote-run.js\";\n\n// ─── TestCookies ─────────────────────────────────────────────────────────────\n\ntype CookieParseOptions = Parameters<Cookies[\"get\"]>[1];\ntype CookieSerializeOptions = Parameters<Cookies[\"set\"]>[2];\n\n/** One stored cookie. */\ninterface TestCookie {\n  readonly name: string;\n  readonly value: string;\n}\n\n/**\n * In-memory Cookies implementation for use in {@link TestRequestEvent}: an\n * ordered list, so `getAll()` returns cookies in the order they were first set\n * (as SvelteKit's does), and `set` on an existing name replaces it in place.\n */\nclass TestCookies {\n  private store: ReadonlyArray<TestCookie>;\n\n  constructor(initial: Readonly<Record<string, string>> = {}) {\n    this.store = Arr.map(Rec.toEntries(initial), ([name, value]) => ({ name, value }));\n  }\n\n  get(name: string, _opts?: CookieParseOptions): string | undefined {\n    return Option.getOrUndefined(\n      Option.map(\n        Arr.findFirst(this.store, (cookie) => cookie.name === name),\n        (cookie) => cookie.value,\n      ),\n    );\n  }\n\n  getAll(_opts?: CookieParseOptions): Array<{ name: string; value: string }> {\n    return Arr.map(this.store, ({ name, value }) => ({ name, value }));\n  }\n\n  set(name: string, value: string, _opts?: CookieSerializeOptions): void {\n    this.store = Option.match(\n      Arr.findFirstIndex(this.store, (cookie) => cookie.name === name),\n      {\n        onNone: () => Arr.append(this.store, { name, value }),\n        onSome: (index) =>\n          Arr.map(this.store, (cookie, i) => (i === index ? { name, value } : cookie)),\n      },\n    );\n  }\n\n  delete(name: string, _opts?: CookieSerializeOptions): void {\n    this.store = Arr.filter(this.store, (cookie) => cookie.name !== name);\n  }\n\n  serialize(name: string, value: string, _opts?: CookieSerializeOptions): string {\n    return `${name}=${encodeURIComponent(value)}`;\n  }\n}\n\n// ─── TestRequestEvent ─────────────────────────────────────────────────────────\n\n/** Options for {@link TestRequestEvent}. */\nexport interface TestRequestEventOptions {\n  /**\n   * The request URL. Accepts a `string` or a `URL` instance.\n   * Defaults to `\"http://localhost/\"`.\n   */\n  readonly url?: string | URL;\n  /** The HTTP method. Defaults to `\"GET\"`. */\n  readonly method?: string;\n  /** Additional HTTP headers added to the underlying `Request`. */\n  readonly headers?: HeadersInit;\n  /** The request body. Only usable with methods that accept a body. */\n  readonly body?: BodyInit | null;\n  /**\n   * Route params (e.g. `{ id: \"123\" }` for a route like `/items/[id]`).\n   * Defaults to `{}`.\n   */\n  readonly params?: Record<string, string>;\n  /**\n   * Initial `event.locals` value, typed as your app's `App.Locals` (declare its\n   * fields in `src/app.d.ts`). Defaults to `{}`.\n   */\n  readonly locals?: App.Locals;\n  /**\n   * Pre-seeded cookies as `{ name: value }` pairs.\n   * The backing store supports `get`, `getAll`, `set`, `delete`, and\n   * `serialize`; the object is cast to SvelteKit's `Cookies` interface.\n   */\n  readonly cookies?: Record<string, string>;\n  /**\n   * The `event.platform` value, if any.\n   * Pass a partial platform object matching the environment the handler targets.\n   */\n  readonly platform?: App.Platform;\n  /**\n   * The `fetch` implementation used by `event.fetch`.\n   * Defaults to `globalThis.fetch`. Pass a custom function to intercept or\n   * stub network calls made by the handler.\n   */\n  readonly fetch?: typeof globalThis.fetch;\n}\n\n/**\n * The fields {@link TestRequestEvent} actually provides: a {@link RequestEvent}\n * without `tracing` / `isRemoteRequest`, with Map-backed cookies (no `parse`)\n * and the test's own `locals` / `platform` values.\n */\ntype TestRequestEventFixture = Omit<\n  RequestEvent,\n  \"cookies\" | \"locals\" | \"platform\" | \"tracing\" | \"isRemoteRequest\"\n> & {\n  readonly cookies: Omit<Cookies, \"parse\">;\n  readonly locals: App.Locals;\n  readonly platform: App.Platform | undefined;\n};\n\n/**\n * Create a minimal {@link RequestEvent} for use in unit tests.\n *\n * All fields are optional — omit what the handler under test doesn't inspect.\n * Cookies are backed by an in-memory `Map`; mutations (`set`, `delete`) are\n * reflected in subsequent `get`/`getAll` calls on the same event.\n *\n * @example\n * ```ts\n * const event = TestRequestEvent({\n *   url: \"http://localhost/items/42\",\n *   params: { id: \"42\" },\n *   locals: { user: { id: \"u1\", role: \"admin\" } },\n *   cookies: { session: \"tok_test\" },\n * });\n * ```\n */\nexport function TestRequestEvent(opts: TestRequestEventOptions = {}): RequestEvent {\n  const rawUrl = opts.url instanceof URL ? opts.url.toString() : (opts.url ?? \"http://localhost/\");\n  const url = new URL(rawUrl);\n\n  const init: RequestInit = { method: opts.method ?? \"GET\" };\n  if (opts.headers !== undefined) init.headers = opts.headers;\n  if (opts.body !== undefined) init.body = opts.body;\n\n  const request = new Request(url.toString(), init);\n  const cookies = new TestCookies(opts.cookies ?? {});\n  const fetchFn = opts.fetch ?? globalThis.fetch;\n\n  const fixture: TestRequestEventFixture = {\n    request,\n    url,\n    params: opts.params ?? {},\n    route: { id: null },\n    fetch: fetchFn,\n    cookies,\n    locals: opts.locals ?? {},\n    platform: opts.platform,\n    isDataRequest: false,\n    isSubRequest: false,\n    setHeaders: () => {},\n    getClientAddress: () => \"127.0.0.1\",\n  };\n  // SAFETY: a deliberately partial fixture, as the TSDoc above says: it has\n  // the fields load/action/endpoint/remote handlers read, while `tracing`,\n  // `isRemoteRequest` and `cookies.parse` are absent, and `locals` / `platform`\n  // are whatever the test passed in place of `App.Locals` / `App.Platform`.\n  return fixture as RequestEvent;\n}\n\n// ─── Options ──────────────────────────────────────────────────────────────────\n\n/**\n * Options shared by {@link runServerLoad}, {@link runAction}, and\n * {@link runEndpoint}.\n */\nexport interface TestRunOptions<R> {\n  /**\n   * The `Layer` providing the handler effect's required services `R`.\n   * Omit when the handler has no service requirements (`R` is `never`).\n   */\n  readonly layer?: Layer.Layer<R>;\n  /**\n   * Translate a failed `Cause` at the boundary. Defaults to\n   * {@link SvelteKit.translate} (Kit control-flow through; anything else\n   * becomes an `EffectCauseError`).\n   */\n  readonly translateError?: ErrorTranslator;\n}\n\n/**\n * Options for {@link runRemote}.\n */\nexport interface RunRemoteOptions<R> {\n  /** The `Layer` providing the remote handler's service requirements. */\n  readonly layer?: Layer.Layer<R>;\n  /**\n   * Translate a failed `Cause` at the boundary. Defaults to\n   * {@link SvelteKit.translate}.\n   */\n  readonly translateError?: ErrorTranslator;\n  /**\n   * Map a remote form handler's failure to SvelteKit field issues. Receives\n   * the squashed handler failure and the `{ issue, data }` context. When\n   * provided it is called instead of `translateError` on the form error path.\n   */\n  readonly formError?: FormErrorMapper;\n}\n\n// ─── Internal ─────────────────────────────────────────────────────────────────\n\n// SAFETY: `layer` may be omitted only when the handler needs no services\n// (`R` is `never`, as `TestRunOptions.layer` documents), and then `Layer.empty`\n// provides all of `R`.\nconst makeAdapter = <R>(opts: TestRunOptions<R> | undefined) =>\n  makeRuntimeAdapter(RequestRuntime.fromLayer((opts?.layer ?? Layer.empty) as Layer.Layer<R>), {\n    translateError: opts?.translateError ?? SvelteKit.translate,\n  });\n\n// ─── runServerLoad ────────────────────────────────────────────────────────────\n\n/**\n * Run an Effect-based server `load` function under test.\n *\n * Wraps `fn` with `makeRuntimeAdapter` using the provided `opts.layer` (or\n * `Layer.empty` when omitted) and calls the resulting `ServerLoad` with\n * `event`. Errors are translated by `opts.translateError` (defaults to\n * {@link SvelteKit.translate}).\n *\n * @example\n * ```ts\n * const data = await runServerLoad(\n *   (event) => Effect.gen(function* () {\n *     const db = yield* Database;\n *     return { items: yield* db.list() };\n *   }),\n *   TestRequestEvent(),\n *   { layer: TestDatabase.layer },\n * );\n * expect(data.items).toHaveLength(0);\n * ```\n */\n// SAFETY: the adapter's `serverLoad` handler is an async function that reads\n// only `RequestEvent` fields (`route.id` plus whatever `fn` reads), so it\n// accepts a plain `RequestEvent` and always returns a `Promise`.\nexport const runServerLoad = <R, A extends Record<string, any> | void = void>(\n  fn: (event: RequestEvent) => Effect.Effect<A, unknown, R>,\n  event: RequestEvent,\n  opts?: TestRunOptions<R>,\n): Promise<A> => (makeAdapter(opts).serverLoad(fn) as (e: RequestEvent) => Promise<A>)(event);\n\n// ─── runAction ───────────────────────────────────────────────────────────────\n\n/**\n * Run an Effect-based form action handler under test.\n *\n * @example\n * ```ts\n * const result = await runAction(\n *   (_event) => Effect.succeed({ success: true }),\n *   TestRequestEvent({ method: \"POST\" }),\n * );\n * expect((result as any).success).toBe(true);\n * ```\n */\n// SAFETY: the adapter's `action` handler is an async function over a\n// `RequestEvent`, so it always returns a `Promise` of the action's value.\nexport const runAction = <R, A extends Record<string, any> | void = void>(\n  fn: (event: RequestEvent) => Effect.Effect<A, unknown, R>,\n  event: RequestEvent,\n  opts?: TestRunOptions<R>,\n): Promise<A> => (makeAdapter(opts).action(fn) as (e: RequestEvent) => Promise<A>)(event);\n\n// ─── runEndpoint ──────────────────────────────────────────────────────────────\n\n/**\n * Run an Effect-based `+server.ts` endpoint handler under test.\n *\n * @example\n * ```ts\n * const response = await runEndpoint(\n *   (_event) => Effect.succeed(new Response(JSON.stringify({ ok: true }))),\n *   TestRequestEvent({ url: \"http://localhost/api/ping\" }),\n * );\n * expect(response.status).toBe(200);\n * ```\n */\nexport const runEndpoint = <R>(\n  fn: (event: RequestEvent) => Effect.Effect<Response, unknown, R>,\n  event: RequestEvent,\n  opts?: TestRunOptions<R>,\n): Promise<Response> => Promise.resolve(makeAdapter(opts).endpoint(fn)(event));\n\n// ─── runRemote ────────────────────────────────────────────────────────────────\n\n/**\n * Build a `{ run, runForm }` helper pair for directly invoking remote-function\n * Effect handlers under test.\n *\n * Unlike the production `query` / `command` / `form` helpers, which resolve the\n * request event via `$app/server.getRequestEvent()`, this resolves it from the\n * `event` argument you supply — no SvelteKit module-graph mocking required.\n *\n * Use `run` for `query` / `command` handlers and `runForm` for `form` handlers\n * that need the `issue` / `data` context.\n *\n * @example\n * ```ts\n * import { TestRequestEvent, runRemote } from \"@thomasfosterau/effect-sveltekit/testing\";\n *\n * const event = TestRequestEvent();\n * const { run } = runRemote(event, { layer: TestDatabase.layer });\n *\n * // Invoke the underlying Effect directly — no AppServer needed:\n * const items = await run(listItemsEffect());\n * expect(items).toEqual([]);\n * ```\n */\nexport const runRemote = <R = never>(\n  event: RequestEvent,\n  opts?: RunRemoteOptions<R>,\n): RunHelpers => {\n  const translate = opts?.translateError ?? SvelteKit.translate;\n  // SAFETY: `layer` may be omitted only when the handlers need no services\n  // (`R = never`, the default), and then `Layer.empty` provides all of `R`.\n  const layer = (opts?.layer ?? Layer.empty) as Layer.Layer<R>;\n  const provider: RequestRuntimeProvider<R> = RequestRuntime.fromLayer(layer);\n  return makeRunHelpers(\n    () => ({ runExit: (effect) => provider.run(event).runPromiseExit(effect) }),\n    translate,\n    opts?.formError,\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;AA2EA,IAAM,cAAN,MAAkB;CAChB;CAEA,YAAY,UAA4C,CAAC,GAAG;EAC1D,KAAK,QAAQ,IAAI,IAAI,IAAI,UAAU,OAAO,IAAI,CAAC,MAAM,YAAY;GAAE;GAAM;EAAM,EAAE;CACnF;CAEA,IAAI,MAAc,OAAgD;EAChE,OAAO,OAAO,eACZ,OAAO,IACL,IAAI,UAAU,KAAK,QAAQ,WAAW,OAAO,SAAS,IAAI,IACzD,WAAW,OAAO,KACrB,CACF;CACF;CAEA,OAAO,OAAoE;EACzE,OAAO,IAAI,IAAI,KAAK,QAAQ,EAAE,MAAM,aAAa;GAAE;GAAM;EAAM,EAAE;CACnE;CAEA,IAAI,MAAc,OAAe,OAAsC;EACrE,KAAK,QAAQ,OAAO,MAClB,IAAI,eAAe,KAAK,QAAQ,WAAW,OAAO,SAAS,IAAI,GAC/D;GACE,cAAc,IAAI,OAAO,KAAK,OAAO;IAAE;IAAM;GAAM,CAAC;GACpD,SAAS,UACP,IAAI,IAAI,KAAK,QAAQ,QAAQ,MAAO,MAAM,QAAQ;IAAE;IAAM;GAAM,IAAI,MAAO;EAC/E,CACF;CACF;CAEA,OAAO,MAAc,OAAsC;EACzD,KAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ,WAAW,OAAO,SAAS,IAAI;CACtE;CAEA,UAAU,MAAc,OAAe,OAAwC;EAC7E,OAAO,GAAG,KAAK,GAAG,mBAAmB,KAAK;CAC5C;AACF;;;;;;;;;;;;;;;;;;AA6EA,SAAgB,iBAAiB,OAAgC,CAAC,GAAiB;CACjF,MAAM,SAAS,KAAK,eAAe,MAAM,KAAK,IAAI,SAAS,IAAK,KAAK,OAAO;CAC5E,MAAM,MAAM,IAAI,IAAI,MAAM;CAE1B,MAAM,OAAoB,EAAE,QAAQ,KAAK,UAAU,MAAM;CACzD,IAAI,KAAK,YAAY,KAAA,GAAW,KAAK,UAAU,KAAK;CACpD,IAAI,KAAK,SAAS,KAAA,GAAW,KAAK,OAAO,KAAK;CAE9C,MAAM,UAAU,IAAI,QAAQ,IAAI,SAAS,GAAG,IAAI;CAChD,MAAM,UAAU,IAAI,YAAY,KAAK,WAAW,CAAC,CAAC;CAClD,MAAM,UAAU,KAAK,SAAS,WAAW;CAoBzC,OAAO;EAjBL;EACA;EACA,QAAQ,KAAK,UAAU,CAAC;EACxB,OAAO,EAAE,IAAI,KAAK;EAClB,OAAO;EACP;EACA,QAAQ,KAAK,UAAU,CAAC;EACxB,UAAU,KAAK;EACf,eAAe;EACf,cAAc;EACd,kBAAkB,CAAC;EACnB,wBAAwB;CAMb;AACf;AA8CA,MAAM,eAAkB,SACtB,mBAAmB,eAAe,UAAW,MAAM,SAAS,MAAM,KAAwB,GAAG,EAC3F,gBAAgB,MAAM,kBAAkB,UAAU,UACpD,CAAC;;;;;;;;;;;;;;;;;;;;;;AA4BH,MAAa,iBACX,IACA,OACA,SACgB,YAAY,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAqC,KAAK;;;;;;;;;;;;;AAkB5F,MAAa,aACX,IACA,OACA,SACgB,YAAY,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAqC,KAAK;;;;;;;;;;;;;AAgBxF,MAAa,eACX,IACA,OACA,SACsB,QAAQ,QAAQ,YAAY,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AA2B7E,MAAa,aACX,OACA,SACe;CACf,MAAM,YAAY,MAAM,kBAAkB,UAAU;CAGpD,MAAM,QAAS,MAAM,SAAS,MAAM;CACpC,MAAM,WAAsC,eAAe,UAAU,KAAK;CAC1E,OAAO,sBACE,EAAE,UAAU,WAAW,SAAS,IAAI,KAAK,CAAC,CAAC,eAAe,MAAM,EAAE,IACzE,WACA,MAAM,SACR;AACF"}

package/dist/transport.d.ts

@@ -1,4 +1,4 @@
-import { Schema } from "effect";
+import * as Schema from "effect/Schema";
 import { Transport, Transporter } from "@sveltejs/kit/hooks";
 //#region src/transport.d.ts
 /**
@@ -10,7 +10,7 @@ import { Transport, Transporter } from "@sveltejs/kit/hooks";
  * (e.g. an encoded `0`, `""`, `false`, or `null`) as "not this type" — and is
  * unwrapped again by `decode` on the client.
  */
-declare const transporter: <T, E>(schema: Schema.Codec<T, E>) => Transporter<T, readonly [E]>;
+export declare const transporter: <T, E>(schema: Schema.Codec<T, E>) => Transporter<T, readonly [E]>;
 /**
  * Builds a deliberately-lossy {@link Transporter} for a non-POJO wrapper whose
  * contents should *not* round-trip — the value is detected on the server and
@@ -32,9 +32,9 @@ declare const transporter: <T, E>(schema: Schema.Codec<T, E>) => Transporter<T,
  * });
  * ```
  */
-declare const markerTransporter: <T>(options: MarkerTransporterOptions<T>) => Transporter<T, unknown>;
+export declare const markerTransporter: <T>(options: MarkerTransporterOptions<T>) => Transporter<T, unknown>;
 /** Options for {@link markerTransporter}. */
-interface MarkerTransporterOptions<T> {
+export interface MarkerTransporterOptions<T> {
   /** Detect, on the server, values this transporter handles. */
   readonly guard: (value: unknown) => value is T;
   /** Produce a fresh value on the client (the payload is discarded). */
@@ -46,7 +46,7 @@ interface MarkerTransporterOptions<T> {
   readonly marker?: unknown;
 }
 /** An entry accepted by {@link transport}: an Effect schema or a ready Transporter. */
-type TransportEntry = Schema.Codec<any, any> | Transporter<any, any>;
+export type TransportEntry = Schema.Codec<any, any> | Transporter<any, any>;
 /**
  * Assembles a SvelteKit `transport` object from a record of entries. Each entry
  * is either an Effect {@link Schema.Codec} (wrapped with {@link transporter}) or
@@ -54,7 +54,6 @@ type TransportEntry = Schema.Codec<any, any> | Transporter<any, any>;
  * round-tripping and marker-style values can be mixed. The keys are arbitrary
  * labels (they only need to be stable between server and client).
  */
-declare const transport: (entries: Record<string, TransportEntry>) => Transport;
+export declare const transport: (entries: Record<string, TransportEntry>) => Transport;
 //#endregion
-export { MarkerTransporterOptions, TransportEntry, markerTransporter, transport, transporter };
 //# sourceMappingURL=transport.d.ts.map

package/dist/transport.js

@@ -1,4 +1,5 @@
-import { Schema } from "effect";
+import * as Rec from "effect/Record";
+import * as Schema from "effect/Schema";
 //#region src/transport.ts
 /**
 * Builds a SvelteKit {@link Transporter} from an Effect {@link Schema.Codec}.
@@ -53,11 +54,7 @@ const markerTransporter = (options) => {
 * round-tripping and marker-style values can be mixed. The keys are arbitrary
 * labels (they only need to be stable between server and client).
 */
-const transport = (entries) => {
-	const result = {};
-	for (const [name, entry] of Object.entries(entries)) result[name] = Schema.isSchema(entry) ? transporter(entry) : entry;
-	return result;
-};
+const transport = (entries) => Rec.map(entries, (entry) => Schema.isSchema(entry) ? transporter(entry) : entry);
 //#endregion
 export { markerTransporter, transport, transporter };
 

package/dist/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","names":[],"sources":["../src/transport.ts"],"sourcesContent":["/**\n * Effect Schema ⇄ SvelteKit `transport` hook.\n *\n * SvelteKit's universal [`transport`](https://svelte.dev/docs/kit/hooks#Universal-hooks-transport)\n * hook moves custom (non-POJO) values across the server/client boundary — for\n * data returned from `load` functions and from remote functions. Each entry is\n * a {@link Transporter}: a sync `encode` (server) / `decode` (client) pair,\n * where `encode` returns `false` for values it does not handle.\n *\n * An Effect {@link Schema.Codec} is exactly such a pair. {@link transporter}\n * turns a schema into a `Transporter`, and {@link transport} assembles a whole\n * `transport` object from a record of schemas — so `Option`, `DateTime`,\n * branded types, `Schema.Class` instances, tagged errors, etc. round-trip with\n * no hand-written serialization.\n *\n * ```ts\n * // src/hooks.ts\n * import { Hooks } from \"@thomasfosterau/effect-sveltekit\";\n * import { Schema } from \"effect\";\n *\n * export const transport = Hooks.transport({\n *   Option: Schema.Option(Schema.Number),\n *   Date: Schema.Date,\n * });\n * ```\n */\n\nimport type { Transport, Transporter } from \"@sveltejs/kit/hooks\";\nimport { Schema } from \"effect\";\n\n/**\n * Builds a SvelteKit {@link Transporter} from an Effect {@link Schema.Codec}.\n *\n * The decoded `Type` is detected with `Schema.is`; matching values are encoded\n * with `Schema.encodeSync` and wrapped in a single-element tuple. The wrapper\n * guarantees the encoding is truthy — SvelteKit treats a falsy `encode` result\n * (e.g. an encoded `0`, `\"\"`, `false`, or `null`) as \"not this type\" — and is\n * unwrapped again by `decode` on the client.\n */\nexport const transporter = <T, E>(schema: Schema.Codec<T, E>): Transporter<T, readonly [E]> => {\n  const guard = Schema.is(schema);\n  const encode = Schema.encodeSync(schema);\n  const decode = Schema.decodeSync(schema);\n  return {\n    encode: (value) => (guard(value) ? ([encode(value)] as const) : false),\n    decode: ([data]) => decode(data),\n  };\n};\n\n/**\n * Builds a deliberately-lossy {@link Transporter} for a non-POJO wrapper whose\n * contents should *not* round-trip — the value is detected on the server and\n * reconstructed fresh on the client.\n *\n * Unlike {@link transporter} (which needs a round-tripping {@link Schema.Codec}),\n * this is for values that have no meaningful serialization but still need a\n * `transport` entry so SvelteKit doesn't reject them: `encode` returns a truthy\n * marker for matching values, and `decode` ignores it and produces a fresh value\n * from {@link MarkerTransporterOptions.make}.\n *\n * ```ts\n * // A non-serializable handle reconstructed as a fresh, empty instance:\n * export const transport = Hooks.transport({\n *   Live: Hooks.markerTransporter({\n *     guard: (v): v is LiveHandle => v instanceof LiveHandle,\n *     make: () => LiveHandle.empty(),\n *   }),\n * });\n * ```\n */\nexport const markerTransporter = <T>(\n  options: MarkerTransporterOptions<T>,\n): Transporter<T, unknown> => {\n  const marker = options.marker ?? 1;\n  return {\n    encode: (value) => (options.guard(value) ? marker : false),\n    decode: () => options.make(),\n  };\n};\n\n/** Options for {@link markerTransporter}. */\nexport interface MarkerTransporterOptions<T> {\n  /** Detect, on the server, values this transporter handles. */\n  readonly guard: (value: unknown) => value is T;\n  /** Produce a fresh value on the client (the payload is discarded). */\n  readonly make: () => T;\n  /**\n   * The truthy marker `encode` emits (SvelteKit treats a falsy `encode` result\n   * as \"not this type\"). Defaults to `1`.\n   */\n  readonly marker?: unknown;\n}\n\n/** An entry accepted by {@link transport}: an Effect schema or a ready Transporter. */\nexport type TransportEntry = Schema.Codec<any, any> | Transporter<any, any>;\n\n/**\n * Assembles a SvelteKit `transport` object from a record of entries. Each entry\n * is either an Effect {@link Schema.Codec} (wrapped with {@link transporter}) or\n * a ready {@link Transporter} (e.g. from {@link markerTransporter}), so\n * round-tripping and marker-style values can be mixed. The keys are arbitrary\n * labels (they only need to be stable between server and client).\n */\nexport const transport = (entries: Record<string, TransportEntry>): Transport => {\n  const result: Transport = {};\n  for (const [name, entry] of Object.entries(entries)) {\n    result[name] = Schema.isSchema(entry)\n      ? transporter(entry as Schema.Codec<any, any>)\n      : (entry as Transporter<any, any>);\n  }\n  return result;\n};\n"],"mappings":";;;;;;;;;;;AAuCA,MAAa,eAAqB,WAA6D;CAC7F,MAAM,QAAQ,OAAO,GAAG,MAAM;CAC9B,MAAM,SAAS,OAAO,WAAW,MAAM;CACvC,MAAM,SAAS,OAAO,WAAW,MAAM;CACvC,OAAO;EACL,SAAS,UAAW,MAAM,KAAK,IAAK,CAAC,OAAO,KAAK,CAAC,IAAc;EAChE,SAAS,CAAC,UAAU,OAAO,IAAI;CACjC;AACF;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,qBACX,YAC4B;CAC5B,MAAM,SAAS,QAAQ,UAAU;CACjC,OAAO;EACL,SAAS,UAAW,QAAQ,MAAM,KAAK,IAAI,SAAS;EACpD,cAAc,QAAQ,KAAK;CAC7B;AACF;;;;;;;;AAyBA,MAAa,aAAa,YAAuD;CAC/E,MAAM,SAAoB,CAAC;CAC3B,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,GAChD,OAAO,QAAQ,OAAO,SAAS,KAAK,IAChC,YAAY,KAA+B,IAC1C;CAEP,OAAO;AACT"}
+{"version":3,"file":"transport.js","names":[],"sources":["../src/transport.ts"],"sourcesContent":["/**\n * Effect Schema ⇄ SvelteKit `transport` hook.\n *\n * SvelteKit's universal [`transport`](https://svelte.dev/docs/kit/hooks#Universal-hooks-transport)\n * hook moves custom (non-POJO) values across the server/client boundary — for\n * data returned from `load` functions and from remote functions. Each entry is\n * a {@link Transporter}: a sync `encode` (server) / `decode` (client) pair,\n * where `encode` returns `false` for values it does not handle.\n *\n * An Effect {@link Schema.Codec} is exactly such a pair. {@link transporter}\n * turns a schema into a `Transporter`, and {@link transport} assembles a whole\n * `transport` object from a record of schemas — so `Option`, `DateTime`,\n * branded types, `Schema.Class` instances, tagged errors, etc. round-trip with\n * no hand-written serialization.\n *\n * ```ts\n * // src/hooks.ts\n * import { Hooks } from \"@thomasfosterau/effect-sveltekit\";\n * import { Schema } from \"effect\";\n *\n * export const transport = Hooks.transport({\n *   Option: Schema.Option(Schema.Number),\n *   Date: Schema.Date,\n * });\n * ```\n */\n\nimport type { Transport, Transporter } from \"@sveltejs/kit/hooks\";\nimport * as Rec from \"effect/Record\";\nimport * as Schema from \"effect/Schema\";\n\n/**\n * Builds a SvelteKit {@link Transporter} from an Effect {@link Schema.Codec}.\n *\n * The decoded `Type` is detected with `Schema.is`; matching values are encoded\n * with `Schema.encodeSync` and wrapped in a single-element tuple. The wrapper\n * guarantees the encoding is truthy — SvelteKit treats a falsy `encode` result\n * (e.g. an encoded `0`, `\"\"`, `false`, or `null`) as \"not this type\" — and is\n * unwrapped again by `decode` on the client.\n */\nexport const transporter = <T, E>(schema: Schema.Codec<T, E>): Transporter<T, readonly [E]> => {\n  const guard = Schema.is(schema);\n  const encode = Schema.encodeSync(schema);\n  const decode = Schema.decodeSync(schema);\n  return {\n    encode: (value) => (guard(value) ? ([encode(value)] as const) : false),\n    decode: ([data]) => decode(data),\n  };\n};\n\n/**\n * Builds a deliberately-lossy {@link Transporter} for a non-POJO wrapper whose\n * contents should *not* round-trip — the value is detected on the server and\n * reconstructed fresh on the client.\n *\n * Unlike {@link transporter} (which needs a round-tripping {@link Schema.Codec}),\n * this is for values that have no meaningful serialization but still need a\n * `transport` entry so SvelteKit doesn't reject them: `encode` returns a truthy\n * marker for matching values, and `decode` ignores it and produces a fresh value\n * from {@link MarkerTransporterOptions.make}.\n *\n * ```ts\n * // A non-serializable handle reconstructed as a fresh, empty instance:\n * export const transport = Hooks.transport({\n *   Live: Hooks.markerTransporter({\n *     guard: (v): v is LiveHandle => v instanceof LiveHandle,\n *     make: () => LiveHandle.empty(),\n *   }),\n * });\n * ```\n */\nexport const markerTransporter = <T>(\n  options: MarkerTransporterOptions<T>,\n): Transporter<T, unknown> => {\n  const marker = options.marker ?? 1;\n  return {\n    encode: (value) => (options.guard(value) ? marker : false),\n    decode: () => options.make(),\n  };\n};\n\n/** Options for {@link markerTransporter}. */\nexport interface MarkerTransporterOptions<T> {\n  /** Detect, on the server, values this transporter handles. */\n  readonly guard: (value: unknown) => value is T;\n  /** Produce a fresh value on the client (the payload is discarded). */\n  readonly make: () => T;\n  /**\n   * The truthy marker `encode` emits (SvelteKit treats a falsy `encode` result\n   * as \"not this type\"). Defaults to `1`.\n   */\n  readonly marker?: unknown;\n}\n\n/** An entry accepted by {@link transport}: an Effect schema or a ready Transporter. */\nexport type TransportEntry = Schema.Codec<any, any> | Transporter<any, any>;\n\n/**\n * Assembles a SvelteKit `transport` object from a record of entries. Each entry\n * is either an Effect {@link Schema.Codec} (wrapped with {@link transporter}) or\n * a ready {@link Transporter} (e.g. from {@link markerTransporter}), so\n * round-tripping and marker-style values can be mixed. The keys are arbitrary\n * labels (they only need to be stable between server and client).\n */\nexport const transport = (entries: Record<string, TransportEntry>): Transport =>\n  Rec.map(entries, (entry): Transporter<any, any> =>\n    Schema.isSchema(entry) ? transporter(entry) : entry,\n  );\n"],"mappings":";;;;;;;;;;;;AAwCA,MAAa,eAAqB,WAA6D;CAC7F,MAAM,QAAQ,OAAO,GAAG,MAAM;CAC9B,MAAM,SAAS,OAAO,WAAW,MAAM;CACvC,MAAM,SAAS,OAAO,WAAW,MAAM;CACvC,OAAO;EACL,SAAS,UAAW,MAAM,KAAK,IAAK,CAAC,OAAO,KAAK,CAAC,IAAc;EAChE,SAAS,CAAC,UAAU,OAAO,IAAI;CACjC;AACF;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,qBACX,YAC4B;CAC5B,MAAM,SAAS,QAAQ,UAAU;CACjC,OAAO;EACL,SAAS,UAAW,QAAQ,MAAM,KAAK,IAAI,SAAS;EACpD,cAAc,QAAQ,KAAK;CAC7B;AACF;;;;;;;;AAyBA,MAAa,aAAa,YACxB,IAAI,IAAI,UAAU,UAChB,OAAO,SAAS,KAAK,IAAI,YAAY,KAAK,IAAI,KAChD"}

package/dist/universal.d.ts

@@ -1,6 +1,6 @@
 import { SvelteRouteParams } from "./internal/route-params.js";
 import { UniversalRuntime, makeUniversalRuntime } from "./app-runtime.js";
-import { Effect } from "effect";
+import * as Effect from "effect/Effect";
 import * as HttpClient from "effect/http/HttpClient";
 import { Load } from "@sveltejs/kit";
 //#region src/universal.d.ts
@@ -29,7 +29,7 @@ import { Load } from "@sveltejs/kit";
  * );
  * ```
  */
-declare function load<Params extends SvelteRouteParams = SvelteRouteParams, 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, HttpClient.HttpClient>): Load<Params, InputData, ParentData, OutputData, RouteId>;
+export declare function load<Params extends SvelteRouteParams = SvelteRouteParams, 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, HttpClient.HttpClient>): Load<Params, InputData, ParentData, OutputData, RouteId>;
 //#endregion
-export { type UniversalRuntime, load, makeUniversalRuntime };
+export { type UniversalRuntime, makeUniversalRuntime };
 //# sourceMappingURL=universal.d.ts.map

package/dist/universal.js

@@ -1,6 +1,6 @@
 import { makeUniversalRuntime } from "./app-runtime.js";
 import { defaultUniversalRuntime } from "./internal/default-runtime.js";
-import "effect";
+import "effect/Effect";
 //#region src/universal.ts
 /**
 * Wraps an Effect-based function to work as a SvelteKit universal load function.

package/dist/universal.js.map

@@ -1 +1 @@
-{"version":3,"file":"universal.js","names":["runtime"],"sources":["../src/universal.ts"],"sourcesContent":["import type { Load } from \"@sveltejs/kit\";\nimport { Effect } from \"effect\";\nimport type * as HttpClient from \"effect/http/HttpClient\";\nimport type { SvelteRouteParams } from \"./internal/route-params.js\";\nimport { defaultUniversalRuntime as runtime } from \"./internal/default-runtime.js\";\n\n/**\n * Wraps an Effect-based function to work as a SvelteKit universal load function.\n *\n * The effect has access to `HttpClient` on both the server and the client:\n * it is backed by the load event's `fetch`, so relative URLs and SvelteKit's\n * fetch behaviours (deduplication, cookies forwarding) work as expected.\n *\n * To give effects access to your own application services, create an\n * app-wide runtime with `makeUniversalRuntime` and use its `load` instead.\n *\n * @example\n * ```ts\n * import { load as effectLoad } from '@thomasfosterau/effect-sveltekit';\n * import * as HttpClient from 'effect/http/HttpClient';\n * import { Effect } from 'effect';\n *\n * export const load = effectLoad((event) =>\n *   Effect.gen(function* () {\n *     const client = yield* HttpClient.HttpClient;\n *     const response = yield* client.get(`/api/items/${event.params.id}`);\n *     return { item: yield* response.json };\n *   })\n * );\n * ```\n */\nexport function load<\n  Params extends SvelteRouteParams = SvelteRouteParams,\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, HttpClient.HttpClient>,\n): Load<Params, InputData, ParentData, OutputData, RouteId> {\n  return runtime().load(fn);\n}\n\n/**\n * App-wide runtime: define your application's (universal) Effect services\n * once and share them across every `load` invocation.\n */\nexport { makeUniversalRuntime, type UniversalRuntime } from \"./app-runtime.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,KAOd,IAG0D;CAC1D,OAAOA,wBAAQ,CAAC,CAAC,KAAK,EAAE;AAC1B"}
+{"version":3,"file":"universal.js","names":["runtime"],"sources":["../src/universal.ts"],"sourcesContent":["import type { Load } from \"@sveltejs/kit\";\nimport * as Effect from \"effect/Effect\";\nimport type * as HttpClient from \"effect/http/HttpClient\";\nimport type { SvelteRouteParams } from \"./internal/route-params.js\";\nimport { defaultUniversalRuntime as runtime } from \"./internal/default-runtime.js\";\n\n/**\n * Wraps an Effect-based function to work as a SvelteKit universal load function.\n *\n * The effect has access to `HttpClient` on both the server and the client:\n * it is backed by the load event's `fetch`, so relative URLs and SvelteKit's\n * fetch behaviours (deduplication, cookies forwarding) work as expected.\n *\n * To give effects access to your own application services, create an\n * app-wide runtime with `makeUniversalRuntime` and use its `load` instead.\n *\n * @example\n * ```ts\n * import { load as effectLoad } from '@thomasfosterau/effect-sveltekit';\n * import * as HttpClient from 'effect/http/HttpClient';\n * import { Effect } from 'effect';\n *\n * export const load = effectLoad((event) =>\n *   Effect.gen(function* () {\n *     const client = yield* HttpClient.HttpClient;\n *     const response = yield* client.get(`/api/items/${event.params.id}`);\n *     return { item: yield* response.json };\n *   })\n * );\n * ```\n */\nexport function load<\n  Params extends SvelteRouteParams = SvelteRouteParams,\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, HttpClient.HttpClient>,\n): Load<Params, InputData, ParentData, OutputData, RouteId> {\n  return runtime().load(fn);\n}\n\n/**\n * App-wide runtime: define your application's (universal) Effect services\n * once and share them across every `load` invocation.\n */\nexport { makeUniversalRuntime, type UniversalRuntime } from \"./app-runtime.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,KAOd,IAG0D;CAC1D,OAAOA,wBAAQ,CAAC,CAAC,KAAK,EAAE;AAC1B"}

package/dist/vite.d.ts

@@ -1,9 +1,9 @@
 import { Plugin } from "vite";
 //#region src/vite.d.ts
 /** The SvelteKit route and hook file kinds `effectKit()` can rewrite. */
-type EffectKitFileKind = "pageServer" | "page" | "layoutServer" | "layout" | "server" | "hooks" | "hooksServer" | "hooksClient";
+export type EffectKitFileKind = "pageServer" | "page" | "layoutServer" | "layout" | "server" | "hooks" | "hooksServer" | "hooksClient";
 /** Options for {@link effectKit}. */
-interface EffectKitPluginOptions {
+export interface EffectKitPluginOptions {
   /**
    * Restrict transformation to a subset of SvelteKit file kinds.
    * Defaults to all standard route files.
@@ -37,7 +37,7 @@ interface EffectKitPluginOptions {
  * functions returning Effects, are accepted wherever SvelteKit expects a
  * function-shaped export.
  */
-declare function effectKit(options?: EffectKitPluginOptions): Plugin;
+export declare function effectKit(options?: EffectKitPluginOptions): Plugin;
 //#endregion
-export { EffectKitFileKind, EffectKitPluginOptions, effectKit as default, effectKit };
+export { effectKit as default };
 //# sourceMappingURL=vite.d.ts.map