@rc312/tss-effect-serverfn 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ryan Callahan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,127 @@
-# Temporary Holding Version
+# @rc312/tss-effect-serverfn
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Write TanStack Start server functions with **Effect Schemas and Effect handlers**. Call them with Start's normal Promise API.
+
+## Quick start
+
+In an existing **TanStack React Start** app using **Effect 4**:
+
+```sh
+bun add @rc312/tss-effect-serverfn 'effect@^4.1.2'
+```
+
+### 1. Register the Vite plugin
+
+Add `effectServerFns()` **before** `tanstackStart()` in your existing config. Keep your other plugins and your usual Vite dev/build commands.
+
+```ts
+import { effectServerFns } from "@rc312/tss-effect-serverfn/vite";
+// vite.config.ts
+import { tanstackStart } from "@tanstack/react-start/plugin/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [effectServerFns(), tanstackStart()],
+});
+```
+
+### 2. Configure a shared factory
+
+Create this file once. `createEffectMiddleware` runs your Effects and catches failures. This starter needs no application services and returns a safe fallback for unexpected failures.
+
+```ts
+import {
+  createEffectMiddleware,
+  createEffectServerFn as base,
+} from "@rc312/tss-effect-serverfn";
+// src/effect-server-fn.ts
+import { createServerOnlyFn } from "@tanstack/react-start";
+import { Effect } from "effect";
+
+export const createEffectServerFn = base().middleware([
+  createEffectMiddleware({
+    fallbackFailure: { code: "INTERNAL", message: "Internal error" },
+    resolve: createServerOnlyFn(() => ({
+      runPromiseExit: Effect.runPromiseExit,
+    })),
+  }),
+]);
+```
+
+Already have a `ManagedRuntime`? Use its `runPromiseExit` here; see [application services](docs/usage.md#application-services).
+
+### 3. Write a server function
+
+Import the **configured factory from your app**, pass the Schema directly, and return an Effect.
+
+```ts
+// src/greeting.functions.ts
+import { Effect, Schema } from "effect";
+
+import { createEffectServerFn } from "./effect-server-fn";
+
+export const getGreeting = createEffectServerFn({ method: "GET" })
+  .validator(Schema.Struct({ name: Schema.NonEmptyString }))
+  .handler(({ data }) =>
+    Effect.gen(function* greet() {
+      yield* Effect.logInfo("Greeting requested");
+      return { message: `Hello, ${data.name}!` };
+    }).pipe(Effect.annotateLogs({ feature: "greeting" }))
+  );
+```
+
+### 4. Call it
+
+Call the function from a loader, component event handler, or another server function:
+
+```ts
+import { getGreeting } from "./greeting.functions";
+
+const greeting = await getGreeting({ data: { name: "Ada" } });
+// { message: "Hello, Ada!" }
+```
+
+That's the setup. The plugin handles compilation; the middleware handles execution, request cancellation, cleanup, and safe failures.
+
+## Everyday usage
+
+| You want to… | Use |
+| --- | --- |
+| Accept and transform input | `.validator(schema)`; callers pass `Encoded`, handlers receive `Type` |
+| Use application services | Supply `runtime.runPromiseExit` in the shared factory |
+| Add authentication/context | Native `.middleware([authMiddleware])`; read `context` in the handler |
+| Acquire request resources | `Effect.acquireRelease` or `Effect.forkScoped`; Scope is provided |
+| Return an approved business error | Native Schema error + a `publicError` schema in `resolve` |
+| Add logs or traces | Native Effect annotations, `Effect.fn`, and `Effect.withSpan` |
+| Handle router redirects/not-found in components | TanStack's `useServerFn` |
+
+Invalid schema input rejects with `{ code: "INVALID_INPUT", message: "Invalid input" }` and HTTP 400. Other unapproved failures reject with your `fallbackFailure`. Detailed Causes stay on the server.
+
+**Common setup mistakes:**
+
+- Place `effectServerFns()` before `tanstackStart()`, then restart the dev server after changing Vite config.
+- Import your configured factory in endpoints. The package's bare factory needs `createEffectMiddleware`, configured locally as above or through Start's global function middleware.
+- Export configured builders directly, as in step 2. Keep factory calls and method names static so the compiler can find them.
+- Keep runtime initialization and private configuration inside the `createServerOnlyFn` resolver.
+
+## Other Start function utilities
+
+Use Start's native helpers directly from `@tanstack/react-start`:
+
+| Utility | Effect support |
+| --- | --- |
+| `createServerFn` | Use `createEffectServerFn` for raw Schemas and automatically executed Effect handlers. Ordinary native server functions also work alongside it. |
+| `createServerOnlyFn` | Preserves an Effect-returning function; calling it on the client throws. |
+| `createClientOnlyFn` | Preserves an Effect-returning function; calling it on the server throws. |
+| `createIsomorphicFn` | Selects an Effect-returning `.server()` or `.client()` implementation. |
+
+The three environment helpers return lazy Effects for composition. Use `yield*` inside your Effect handler; the handler's runtime executes them. [Examples and execution details →](docs/usage.md#start-function-utilities)
+
+## More
+
+- [Composition examples: pipe, flow, Effect.fn, and combinators](docs/composition.md)
+- [Runnable basic and service examples](examples)
+- [Application services, errors, reporting, and execution details](docs/usage.md)
+- [Workspace development](docs/development.md)
+
+Tested with Effect 4.1.2, React Start 1.169.2, and Vite 8.3.4. Supported peer ranges are in `package.json`.

package/dist/bootstrap.server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Create a safe rejection when the lazy execution boundary cannot be loaded.
+ * This eager path depends only on the provenance registry and never initializes
+ * application services or invokes an application reporter.
+ *
+ * @param template - Trusted fallback available before loading application code.
+ * @param cause - Original module-loading rejection, retained only on the server.
+ * @returns A fresh fallback record eligible for native framework reporting.
+ * @internal
+ */
+export declare const bootstrapFailure: <P extends object>(template: Readonly<P>, cause: unknown) => P;
+//# sourceMappingURL=bootstrap.server.d.ts.map

package/dist/bootstrap.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.server.d.ts","sourceRoot":"","sources":["../src/bootstrap.server.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,YACrC,QAAQ,CAAC,CAAC,CAAC,SACd,OAAO,KACb,CAIF,CAAC"}

package/dist/bootstrap.server.js

@@ -0,0 +1,17 @@
+import { Cause } from "effect";
+import { ownFailure } from "./provenance.server.js";
+/**
+ * Create a safe rejection when the lazy execution boundary cannot be loaded.
+ * This eager path depends only on the provenance registry and never initializes
+ * application services or invokes an application reporter.
+ *
+ * @param template - Trusted fallback available before loading application code.
+ * @param cause - Original module-loading rejection, retained only on the server.
+ * @returns A fresh fallback record eligible for native framework reporting.
+ * @internal
+ */
+export const bootstrapFailure = (template, cause) => {
+    const failure = { ...template };
+    return ownFailure(failure, "native", Cause.fail(cause));
+};
+//# sourceMappingURL=bootstrap.server.js.map

package/dist/bootstrap.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.server.js","sourceRoot":"","sources":["../src/bootstrap.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,QAAqB,EACrB,KAAc,EACX,EAAE;IACL,MAAM,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAEhC,OAAO,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1D,CAAC,CAAC"}

package/dist/boundary.server.d.ts

@@ -0,0 +1,26 @@
+import type { Method } from "@tanstack/react-start";
+import type { EffectMiddlewareOptions, FailureReport } from "./effect-middleware.ts";
+import type { ExecutionCapability } from "./execution.ts";
+interface Operation {
+    readonly method: Method;
+    readonly serverFnMeta: FailureReport["serverFnMeta"];
+}
+/**
+ * Lend a request-local execution capability to the native middleware chain.
+ *
+ * Runtime configuration is resolved only when the generated handler calls `run`.
+ * Decoding and business work share a Scope and operation span; both close before
+ * failure projection and reporting. Request cancellation interrupts that work,
+ * while cleanup and rejection processing are awaited before returning to Start.
+ * The application's runtime remains application-owned.
+ *
+ * @param options - Execution configuration and trusted fallback rejection.
+ * @param operation - Native function metadata used for tracing and reporting.
+ * @param context - Incoming native context, checked for conflicting ownership.
+ * @param continueMiddleware - Continue the native chain with the new capability.
+ * @returns The native middleware result, or a rejection selected by the boundary.
+ * @internal
+ */
+export declare const execute: <R, RuntimeError, P extends object, F extends object, Output>(options: EffectMiddlewareOptions<R, RuntimeError, P, F>, operation: Operation, context: unknown, continueMiddleware: (context: ExecutionCapability<R>) => Promise<Output>) => Promise<Output>;
+export {};
+//# sourceMappingURL=boundary.server.d.ts.map

package/dist/boundary.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.server.d.ts","sourceRoot":"","sources":["../src/boundary.server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAKpD,OAAO,KAAK,EAEV,uBAAuB,EACvB,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAQ1D,UAAU,SAAS;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CACtD;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,OAAO,GAClB,CAAC,EACD,YAAY,EACZ,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAChB,MAAM,WAEG,uBAAuB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,aAC5C,SAAS,WAEX,OAAO,sBACI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KACvE,OAAO,CAAC,MAAM,CAiJhB,CAAC"}

package/dist/boundary.server.js

@@ -0,0 +1,117 @@
+import { getRequest } from "@tanstack/react-start/server";
+import { Cause, Effect, Exit, Predicate } from "effect";
+import { HttpServerRequest } from "effect/http";
+import { executionKey } from "./execution.js";
+import { projectFailure, rejectMiddlewareFailure, rejectRuntimeFailure, } from "./failure.server.js";
+import { ownFailure } from "./provenance.server.js";
+/**
+ * Lend a request-local execution capability to the native middleware chain.
+ *
+ * Runtime configuration is resolved only when the generated handler calls `run`.
+ * Decoding and business work share a Scope and operation span; both close before
+ * failure projection and reporting. Request cancellation interrupts that work,
+ * while cleanup and rejection processing are awaited before returning to Start.
+ * The application's runtime remains application-owned.
+ *
+ * @param options - Execution configuration and trusted fallback rejection.
+ * @param operation - Native function metadata used for tracing and reporting.
+ * @param context - Incoming native context, checked for conflicting ownership.
+ * @param continueMiddleware - Continue the native chain with the new capability.
+ * @returns The native middleware result, or a rejection selected by the boundary.
+ * @internal
+ */
+export const execute = async (options, operation, 
+// oxlint-disable-next-line anti-slop/no-unknown-parameters -- This native framework context is inspected only for conflicting execution ownership.
+context, continueMiddleware) => {
+    const { fallbackFailure } = options;
+    let request;
+    try {
+        request = getRequest();
+        if (Predicate.hasProperty(context, executionKey)) {
+            throw new Error("Multiple Effect middleware owners cannot execute one server function");
+        }
+    }
+    catch (error) {
+        return rejectRuntimeFailure(fallbackFailure, Cause.fail(error));
+    }
+    let phase = "execution";
+    let active = true;
+    const capability = {
+        [executionKey]: {
+            beginExecution: () => {
+                phase = "execution";
+            },
+            beginInput: () => {
+                phase = "input";
+            },
+            async run(program) {
+                if (!active) {
+                    return rejectRuntimeFailure(fallbackFailure, Cause.die(new Error("Effect execution outlived its native handler")));
+                }
+                if (request.signal.aborted) {
+                    return rejectRuntimeFailure(fallbackFailure, Cause.interrupt());
+                }
+                // Resolve lazily: native middleware can reject or replace the handler without acquiring the runtime.
+                let configuration;
+                try {
+                    configuration = await options.resolve();
+                }
+                catch (error) {
+                    return rejectRuntimeFailure(fallbackFailure, Cause.fail(error));
+                }
+                const scopedOperation = Effect.scoped(program).pipe(Effect.withSpan(operation.serverFnMeta.name, {
+                    attributes: {
+                        "rpc.boundary": "server-function",
+                        "rpc.method": operation.method,
+                    },
+                }));
+                const supervisedOperation = Effect.uninterruptibleMask((restore) => Effect.gen(function* superviseOperation() {
+                    // Cancellation interrupts the operation; cleanup and failure projection are awaited.
+                    const operationExit = yield* Effect.exit(restore(scopedOperation));
+                    if (Exit.isSuccess(operationExit)) {
+                        return operationExit;
+                    }
+                    const projectionExit = yield* Effect.exit(projectFailure(operationExit.cause, phase, configuration, fallbackFailure, operation.serverFnMeta));
+                    const rejection = Exit.isSuccess(projectionExit)
+                        ? projectionExit.value
+                        : ownFailure({ ...fallbackFailure }, "native", operationExit.cause);
+                    return Exit.fail(rejection);
+                })).pipe(Effect.provideService(HttpServerRequest.HttpServerRequest, HttpServerRequest.fromWeb(request)));
+                // The outer Exit represents runtime acquisition/execution faults; the inner Exit is the projected operation result.
+                let runtimeExit;
+                try {
+                    runtimeExit = await configuration.runPromiseExit(supervisedOperation, { signal: request.signal });
+                }
+                catch (error) {
+                    return rejectRuntimeFailure(fallbackFailure, Cause.die(error));
+                }
+                if (Exit.isFailure(runtimeExit)) {
+                    return rejectRuntimeFailure(fallbackFailure, runtimeExit.cause);
+                }
+                const operationExit = runtimeExit.value;
+                if (Exit.isFailure(operationExit)) {
+                    throw Cause.squash(operationExit.cause);
+                }
+                return operationExit.value;
+            },
+        },
+    };
+    try {
+        if (request.signal.aborted) {
+            return rejectRuntimeFailure(fallbackFailure, Cause.interrupt());
+        }
+        const output = await continueMiddleware(capability);
+        if (Predicate.hasProperty(output, "result") &&
+            Effect.isEffect(output.result)) {
+            throw new Error("Missing effectServerFns() Vite plugin: the handler returned an unexecuted Effect");
+        }
+        return output;
+    }
+    catch (error) {
+        return rejectMiddlewareFailure(fallbackFailure, error);
+    }
+    finally {
+        active = false;
+    }
+};
+//# sourceMappingURL=boundary.server.js.map

package/dist/boundary.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.server.js","sourceRoot":"","sources":["../src/boundary.server.ts"],"names":[],"mappings":"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"}

package/dist/compiler-runtime.d.ts

@@ -0,0 +1,40 @@
+import { Effect, Schema } from "effect";
+import type { ExecutionCapability } from "./execution.ts";
+/**
+ * Nominal token carrying input decoding across native middleware validation.
+ * The class identity prevents arbitrary user data from impersonating a decoder.
+ */
+declare class PendingInput {
+    readonly decode: Effect.Effect<unknown, Schema.SchemaError, unknown>;
+    constructor(decode: Effect.Effect<unknown, Schema.SchemaError, unknown>);
+}
+/**
+ * Adapt a raw Effect Schema into a deferred validator for generated Start code.
+ *
+ * Constructing the validator or applying it to input does not run decoding.
+ * {@link effectHandler} executes the stored decoder in the same runtime and
+ * Scope as business work, so service requirements and finalizers are preserved.
+ *
+ * @param schema - Endpoint Schema evaluated at the original declaration site.
+ * @returns A native validator that wraps raw input in a pending decoder.
+ * @internal
+ */
+export declare const prepareInput: <S extends Schema.Constraint>(schema: S) => <A>(value: A) => PendingInput;
+/**
+ * Adapt an Effect-returning callback into Start's Promise-based provider handler.
+ *
+ * Pending input is decoded first and written back to the native context. Phase
+ * transitions let the boundary distinguish input errors from business failures.
+ * Callback construction is suspended so synchronous throws become defects.
+ *
+ * @param handler - The original application handler retained by compiler lowering.
+ * @returns A provider callback that delegates execution to the request capability.
+ * @throws {Error} If execution middleware has not supplied a valid capability.
+ * @internal
+ */
+export declare const effectHandler: <C extends {
+    data: unknown;
+    context: ExecutionCapability<never>;
+}, A, E, R>(handler: (context: C) => Effect.Effect<A, E, R>) => (context: C) => Promise<A>;
+export {};
+//# sourceMappingURL=compiler-runtime.d.ts.map

package/dist/compiler-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler-runtime.d.ts","sourceRoot":"","sources":["../src/compiler-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;GAGG;AACH,cAAM,YAAY;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAErE,YAAY,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EAEtE;CACF;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACtB,CAAC,SAAS,MAAM,CAAC,UAAU,UAAU,CAAC,MACtC,CAAC,SAAS,CAAC,iBAGT,CAAC;AAEN;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GACvB,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAA;CAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,WAC/D,CAAC,OAAO,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,eAEvC,CAAC,KAAG,OAAO,CAAC,CAAC,CAuBtB,CAAC"}

package/dist/compiler-runtime.js

@@ -0,0 +1,54 @@
+import { Effect, Predicate, Schema } from "effect";
+import { executionKey } from "./execution.js";
+/**
+ * Nominal token carrying input decoding across native middleware validation.
+ * The class identity prevents arbitrary user data from impersonating a decoder.
+ */
+class PendingInput {
+    decode;
+    constructor(decode) {
+        this.decode = decode;
+    }
+}
+/**
+ * Adapt a raw Effect Schema into a deferred validator for generated Start code.
+ *
+ * Constructing the validator or applying it to input does not run decoding.
+ * {@link effectHandler} executes the stored decoder in the same runtime and
+ * Scope as business work, so service requirements and finalizers are preserved.
+ *
+ * @param schema - Endpoint Schema evaluated at the original declaration site.
+ * @returns A native validator that wraps raw input in a pending decoder.
+ * @internal
+ */
+export const prepareInput = (schema) => (value) => new PendingInput(Effect.suspend(() => Schema.decodeUnknownEffect(schema)(value)));
+/**
+ * Adapt an Effect-returning callback into Start's Promise-based provider handler.
+ *
+ * Pending input is decoded first and written back to the native context. Phase
+ * transitions let the boundary distinguish input errors from business failures.
+ * Callback construction is suspended so synchronous throws become defects.
+ *
+ * @param handler - The original application handler retained by compiler lowering.
+ * @returns A provider callback that delegates execution to the request capability.
+ * @throws {Error} If execution middleware has not supplied a valid capability.
+ * @internal
+ */
+export const effectHandler = (handler) => (context) => {
+    const execution = context.context[executionKey];
+    if (!execution || !Predicate.isFunction(execution.run)) {
+        throw new Error("Effect server functions require createEffectMiddleware");
+    }
+    const program = Effect.gen(function* executeProgram() {
+        if (context.data instanceof PendingInput) {
+            execution.beginInput();
+            // Update the native context so post-handler middleware also sees decoded data.
+            context.data = yield* context.data.decode;
+        }
+        execution.beginExecution();
+        return yield* Effect.suspend(() => handler(context));
+    });
+    // SAFETY: The configured builder checks handler and decoder services; lowering erases that shared environment at this single execution edge.
+    return execution.run(program);
+};
+//# sourceMappingURL=compiler-runtime.js.map

package/dist/compiler-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler-runtime.js","sourceRoot":"","sources":["../src/compiler-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;GAGG;AACH,MAAM,YAAY;IACP,MAAM,CAAsD;IAErE,YAAY,MAA2D;QACrE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GACvB,CAA8B,MAAS,EAAE,EAAE,CAC3C,CAAI,KAAQ,EAAE,EAAE,CACd,IAAI,YAAY,CACd,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAChE,CAAC;AAEN;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GACxB,CACE,OAA+C,EAC/C,EAAE,CACJ,CAAC,OAAU,EAAc,EAAE;IACzB,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhD,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,cAAc;QACjD,IAAI,OAAO,CAAC,IAAI,YAAY,YAAY,EAAE,CAAC;YACzC,SAAS,CAAC,UAAU,EAAE,CAAC;YACvB,+EAA+E;YAC/E,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAC5C,CAAC;QAED,SAAS,CAAC,cAAc,EAAE,CAAC;QAE3B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,6IAA6I;IAC7I,OAAO,SAAS,CAAC,GAAG,CAClB,OAA0D,CAC3D,CAAC;AACJ,CAAC,CAAC"}

package/dist/create-effect-server-fn.d.ts

@@ -0,0 +1,84 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { Fetcher, FunctionMiddlewareWithTypes, Method, Register, ServerFnBuilder, ServerFnCtx, ServerFnOptions, ServerFnStrict, ServerFnStrictOutput } from "@tanstack/react-start";
+import type { ValidateSerializableInput } from "@tanstack/router-core";
+import type { Effect, Schema } from "effect";
+import type { ExecutionCapability, RequestServices } from "./execution.ts";
+/**
+ * Type-only bridge from an Effect Schema to Start's validator inference.
+ * Clients supply encoded input; handlers receive decoded data. Runtime decoding
+ * is supplied by the compiler bridge, not a Standard Schema adapter.
+ */
+type NativeValidator<Input> = Input extends Schema.Constraint ? StandardSchemaV1<Input["Encoded"], Input["Type"]> : undefined;
+type HandlerContext<MethodType, Middlewares, Input> = ServerFnCtx<Register, MethodType, Middlewares, NativeValidator<Input>>;
+type DecodingServices<Input> = Input extends Schema.Constraint ? Input["DecodingServices"] : never;
+type AppendMiddlewares<Current, Next extends NativeMiddlewares> = Current extends readonly unknown[] ? readonly [...Current, ...Next] : Next;
+type SerializableOutput<A, Strict extends ServerFnStrict> = ServerFnStrictOutput<Strict> extends false ? A : A extends Response ? A : ValidateSerializableInput<Register, A>;
+type NativeBuilder<M extends Method, Strict extends ServerFnStrict> = ServerFnBuilder<Register, M, Strict>;
+type NativeMiddlewares = Parameters<NativeBuilder<Method, ServerFnStrict>["middleware"]>[0];
+/**
+ * Enable handlers only when middleware supplies a runtime and all decoding
+ * services. The returned Effect must also satisfy service and wire-output checks.
+ */
+type Handler<M extends Method, Middlewares, Input, Strict extends ServerFnStrict> = HandlerContext<M, Middlewares, Input>["context"] extends ExecutionCapability<infer Services> ? [Exclude<DecodingServices<Input>, Services | RequestServices>] extends [
+    never
+] ? <A, E>(handler: (context: HandlerContext<M, Middlewares, Input>) => Effect.Effect<A, E, Services | RequestServices> & Effect.Effect<SerializableOutput<A, Strict>, unknown, unknown>) => Fetcher<Middlewares, NativeValidator<Input>, A> : never : never;
+type SerializableInput<Input extends Schema.Constraint, M extends Method, Strict extends ServerFnStrict> = Strict extends false | {
+    input: false;
+} ? unknown : [M, Input["Encoded"]] extends ["POST", FormData] ? unknown : Schema.ConstraintCodec<unknown, ValidateSerializableInput<Register, Input["Encoded"]>, unknown, unknown>;
+/**
+ * Start's server-function builder with raw Effect Schemas and Effect handlers.
+ *
+ * Native method, middleware-context, and serialization inference are preserved.
+ * Configured builders remain callable until a validator is attached, following
+ * Start's builder contract.
+ *
+ * @template M - HTTP method used by the server function.
+ * @template Middlewares - Accumulated native middleware and its context types.
+ * @template Input - The attached Effect Schema, or `undefined` before validation.
+ * @template Strict - Start's input/output serialization-check policy.
+ * @template Callable - Whether this builder can configure another endpoint.
+ */
+export type EffectServerFnBuilder<M extends Method = "GET", Middlewares = undefined, Input = undefined, Strict extends ServerFnStrict = true, Callable extends boolean = true> = Omit<NativeBuilder<M, Strict>, "handler" | "validator" | "middleware" | "~types"> & {
+    readonly "~types": FunctionMiddlewareWithTypes<Register, Middlewares, NativeValidator<Input>, undefined, undefined, undefined, undefined>["~types"] & {
+        readonly method: M;
+        readonly strict: Strict;
+        readonly response: undefined;
+    };
+    /**
+     * Return an Effect using decoded data and native middleware context.
+     * The generated client function returns a Promise; remote rejections do not
+     * carry the Effect error channel as a TypeScript rejection type.
+     */
+    readonly handler: Handler<M, Middlewares, Input, Strict>;
+    /** Decode raw input in the handler's application runtime and request Scope. */
+    readonly validator: <NextInput extends Schema.Constraint>(schema: NextInput & SerializableInput<NextInput, M, Strict>) => EffectServerFnBuilder<M, Middlewares, NextInput, Strict, false>;
+    /** Append native middleware, retaining its inferred context and execution services. */
+    readonly middleware: <const Next extends NativeMiddlewares>(middlewares: Next) => EffectServerFnBuilder<M, AppendMiddlewares<Middlewares, Next>, Input, Strict, Callable>;
+} & (Callable extends true ? <NextMethod extends Method = M, NextStrict extends ServerFnStrict = Strict>(options?: ServerFnOptions<NextMethod, NextStrict>) => EffectServerFnBuilder<NextMethod, Middlewares, Input, NextStrict> : unknown);
+/** Factory signature for an Effect-aware native Start server-function builder. */
+export type CreateEffectServerFn = <M extends Method = "GET", Strict extends ServerFnStrict = true>(options?: ServerFnOptions<M, Strict>) => EffectServerFnBuilder<M, undefined, undefined, Strict>;
+/**
+ * Define a Start server function using an Effect Schema and an Effect handler.
+ *
+ * Requires `effectServerFns()` from `@rc312/tss-effect-serverfn/vite`, installed before
+ * `tanstackStart()`, and execution middleware from `createEffectMiddleware`.
+ * This value retains the native `createServerFn` identity; the plugin adapts
+ * validators and handlers before Start performs extraction and RPC generation.
+ *
+ * @param options - Native Start options, including HTTP method and strictness.
+ * @returns A builder whose completed handler exposes Start's Promise client.
+ *
+ * @example
+ * Using the shared factory configured with execution middleware:
+ * ```ts
+ * import { Effect, Schema } from "effect";
+ * import { createEffectServerFn } from "./effect-server-fn";
+ *
+ * export const greet = createEffectServerFn({ method: "GET" })
+ *   .validator(Schema.Struct({ name: Schema.NonEmptyString }))
+ *   .handler(({ data }) => Effect.succeed(`Hello, ${data.name}!`));
+ * ```
+ */
+export declare const createEffectServerFn: CreateEffectServerFn;
+export {};
+//# sourceMappingURL=create-effect-server-fn.d.ts.map

package/dist/create-effect-server-fn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-effect-server-fn.d.ts","sourceRoot":"","sources":["../src/create-effect-server-fn.ts"],"names":[],"mappings":"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"}

package/dist/create-effect-server-fn.js

@@ -0,0 +1,27 @@
+import { createServerFn } from "@tanstack/react-start";
+/**
+ * Define a Start server function using an Effect Schema and an Effect handler.
+ *
+ * Requires `effectServerFns()` from `@rc312/tss-effect-serverfn/vite`, installed before
+ * `tanstackStart()`, and execution middleware from `createEffectMiddleware`.
+ * This value retains the native `createServerFn` identity; the plugin adapts
+ * validators and handlers before Start performs extraction and RPC generation.
+ *
+ * @param options - Native Start options, including HTTP method and strictness.
+ * @returns A builder whose completed handler exposes Start's Promise client.
+ *
+ * @example
+ * Using the shared factory configured with execution middleware:
+ * ```ts
+ * import { Effect, Schema } from "effect";
+ * import { createEffectServerFn } from "./effect-server-fn";
+ *
+ * export const greet = createEffectServerFn({ method: "GET" })
+ *   .validator(Schema.Struct({ name: Schema.NonEmptyString }))
+ *   .handler(({ data }) => Effect.succeed(`Hello, ${data.name}!`));
+ * ```
+ */
+export const createEffectServerFn = 
+// SAFETY: The compiler lowers raw schemas and Effect callbacks before TanStack consumes them.
+createServerFn;
+//# sourceMappingURL=create-effect-server-fn.js.map

package/dist/create-effect-server-fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-effect-server-fn.js","sourceRoot":"","sources":["../src/create-effect-server-fn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2KvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,oBAAoB;AAC/B,8FAA8F;AAC9F,cAA8D,CAAC"}