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

package/dist/effect-middleware.d.ts

@@ -0,0 +1,116 @@
+import type { ServerFnMeta } from "@tanstack/react-start";
+import type { ValidateSerializableInput } from "@tanstack/router-core";
+import type { Cause, Duration, Effect, Exit, Schema } from "effect";
+import type { HttpServerRequest } from "effect/http";
+import type { ExecutionCapability } from "./execution.ts";
+/**
+ * Server-local diagnostics passed to a configured failure reporter after request
+ * cleanup. Causes can contain private input and application details; only the
+ * projected rejection is eligible for transport to the client.
+ */
+export interface FailureReport {
+    /** Original operation Cause, including any request-scope finalizer failures. */
+    readonly cause: Cause.Cause<unknown>;
+    /** The phase active when the operation failed. */
+    readonly phase: "input" | "execution";
+    /** Proposed client rejection: the approved encoded error or trusted fallback. */
+    readonly failure: unknown;
+    /** An additional fault from inspecting or encoding the original failure. */
+    readonly processingCause?: Cause.Cause<unknown> | undefined;
+    /** TanStack's identity and source metadata for the current server function. */
+    readonly serverFnMeta: ServerFnMeta;
+}
+/**
+ * Application-owned execution and failure policy resolved for a handler call.
+ *
+ * The adapter owns the request Scope; the application owns the runtime and its
+ * disposal. Encoding and reporting run after request cleanup, with application
+ * services and HTTP request metadata still available.
+ *
+ * @template R - Services supplied by the application's runner.
+ * @template RuntimeError - Failures from acquiring the application's runtime.
+ * @template P - Public rejection record produced by the error encoder.
+ */
+export interface EffectConfiguration<R, RuntimeError, P extends object> {
+    /**
+     * Execute in the application environment and return the complete Exit.
+     * Use `Effect.runPromiseExit` for service-free work or a shared
+     * `ManagedRuntime`'s `runPromiseExit`. Custom runners must honor the supplied
+     * abort signal and await finalization before settling.
+     */
+    readonly runPromiseExit: <A, E>(program: Effect.Effect<A, E, R>, options?: Effect.RunOptions) => Promise<Exit.Exit<A, E | RuntimeError>>;
+    /**
+     * Approve and encode a single typed business failure for the client.
+     * Undeclared properties are stripped. Unapproved failures, defects, mixed
+     * Causes, and encoding failures use `fallbackFailure` instead.
+     */
+    readonly publicError?: Schema.ConstraintEncoder<ValidateSerializableInput<unknown, P>, NoInfer<R> | HttpServerRequest.HttpServerRequest>;
+    /**
+     * Replace native `ErrorReporter.report` with an awaited Effect.
+     * Control flow, ordinary invalid input, and pure interruption skip reporting.
+     * Faults or timeouts in this callback leave the business rejection intact and
+     * allow outer framework reporting. Compose native reporting here if desired.
+     */
+    readonly reportFailure?: (report: FailureReport) => Effect.Effect<void, unknown, NoInfer<R> | HttpServerRequest.HttpServerRequest>;
+    /**
+     * Timeout for the `reportFailure` override only.
+     *
+     * @default "5 seconds"
+     */
+    readonly reportTimeout?: Duration.Input;
+}
+/**
+ * Configure the eager safe fallback and lazy application execution policy.
+ *
+ * @template R - Services supplied by the resolved runner.
+ * @template RuntimeError - Failures from acquiring the application's runtime.
+ * @template P - Public rejection record produced by the error encoder.
+ * @template F - Trusted fallback record available before application loading.
+ */
+export interface EffectMiddlewareOptions<R, RuntimeError, P extends object, F extends object> {
+    /**
+     * Trusted, serializable rejection for failures that cannot be exposed.
+     * Keep it independent of lazy application loading and free of private details.
+     * A fresh copy receives server-local diagnostics for each rejection.
+     */
+    readonly fallbackFailure: F & ValidateSerializableInput<unknown, F>;
+    /**
+     * Resolve configuration when the generated handler requests execution.
+     * Native middleware that rejects or replaces the handler does not invoke this
+     * callback. Reuse an application runtime rather than creating one per request.
+     */
+    readonly resolve: () => EffectConfiguration<R, RuntimeError, P> | PromiseLike<EffectConfiguration<R, RuntimeError, P>>;
+}
+/**
+ * Create native Start middleware that supplies Effect execution to server functions.
+ *
+ * Install one owner before authorization and validation middleware. The Vite
+ * plugin's generated handler uses it to decode input and execute business work
+ * in one request Scope, with cancellation tied to the actual HTTP request.
+ * Cleanup completes before native post-handler middleware resumes.
+ *
+ * @param options - Trusted fallback and lazy application configuration.
+ * @returns Function middleware for a configured `createEffectServerFn` builder
+ * or Start's global function-middleware registration.
+ *
+ * @example
+ * ```ts
+ * import { createServerOnlyFn } from "@tanstack/react-start";
+ * import { Effect } from "effect";
+ * import {
+ *   createEffectMiddleware,
+ *   createEffectServerFn as base,
+ * } from "@rc312/tss-effect-serverfn";
+ *
+ * export const createEffectServerFn = base().middleware([
+ *   createEffectMiddleware({
+ *     fallbackFailure: { code: "INTERNAL", message: "Something went wrong" },
+ *     resolve: createServerOnlyFn(() => ({
+ *       runPromiseExit: Effect.runPromiseExit,
+ *     })),
+ *   }),
+ * ]);
+ * ```
+ */
+export declare const createEffectMiddleware: <R, RuntimeError, P extends object, F extends object>(options: EffectMiddlewareOptions<R, RuntimeError, P, F>) => import("@tanstack/react-start").FunctionMiddlewareAfterServer<{}, unknown, undefined, ExecutionCapability<R>, undefined, undefined, undefined>;
+//# sourceMappingURL=effect-middleware.d.ts.map

package/dist/effect-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-middleware.d.ts","sourceRoot":"","sources":["../src/effect-middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC;IACtC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5D,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,SAAS,MAAM;IACpE;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,KACxB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAE7C,yBAAyB,CAAC,OAAO,EAAE,CAAC,CAAC,EACrC,OAAO,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,iBAAiB,CACjD,CAAC;IACF;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CACvB,MAAM,EAAE,aAAa,KAClB,MAAM,CAAC,MAAM,CAChB,IAAI,EACJ,OAAO,EACP,OAAO,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,iBAAiB,CACjD,CAAC;IACF;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB,CACtC,CAAC,EACD,YAAY,EACZ,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,GAAG,yBAAyB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACpE;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MACd,mBAAmB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,GACvC,WAAW,CAAC,mBAAmB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;CAC1D;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,sBAAsB,GACjC,CAAC,EACD,YAAY,EACZ,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,WAEP,uBAAuB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,mJAmBtD,CAAC"}

package/dist/effect-middleware.js

@@ -0,0 +1,46 @@
+import { createMiddleware, createServerOnlyFn } from "@tanstack/react-start";
+import { bootstrapFailure } from "./bootstrap.server.js";
+const loadBoundary = createServerOnlyFn(() => import("./boundary.server.js"));
+const makeBootstrapFailure = createServerOnlyFn(bootstrapFailure);
+/**
+ * Create native Start middleware that supplies Effect execution to server functions.
+ *
+ * Install one owner before authorization and validation middleware. The Vite
+ * plugin's generated handler uses it to decode input and execute business work
+ * in one request Scope, with cancellation tied to the actual HTTP request.
+ * Cleanup completes before native post-handler middleware resumes.
+ *
+ * @param options - Trusted fallback and lazy application configuration.
+ * @returns Function middleware for a configured `createEffectServerFn` builder
+ * or Start's global function-middleware registration.
+ *
+ * @example
+ * ```ts
+ * import { createServerOnlyFn } from "@tanstack/react-start";
+ * import { Effect } from "effect";
+ * import {
+ *   createEffectMiddleware,
+ *   createEffectServerFn as base,
+ * } from "@rc312/tss-effect-serverfn";
+ *
+ * export const createEffectServerFn = base().middleware([
+ *   createEffectMiddleware({
+ *     fallbackFailure: { code: "INTERNAL", message: "Something went wrong" },
+ *     resolve: createServerOnlyFn(() => ({
+ *       runPromiseExit: Effect.runPromiseExit,
+ *     })),
+ *   }),
+ * ]);
+ * ```
+ */
+export const createEffectMiddleware = (options) => createMiddleware({ type: "function" }).server(async ({ next, context, method, serverFnMeta }) => {
+    let boundary;
+    try {
+        boundary = await loadBoundary();
+    }
+    catch (error) {
+        throw makeBootstrapFailure(options.fallbackFailure, error);
+    }
+    return boundary.execute(options, { method, serverFnMeta }, context, (execution) => next({ context: execution }));
+});
+//# sourceMappingURL=effect-middleware.js.map

package/dist/effect-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-middleware.js","sourceRoot":"","sources":["../src/effect-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAM7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAwGzD,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAE9E,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAMpC,OAAuD,EACvD,EAAE,CACF,gBAAgB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,CAC3C,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;IAChD,IAAI,QAAkD,CAAC;IAEvD,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,oBAAoB,CAAI,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CACrB,OAAO,EACP,EAAE,MAAM,EAAE,YAAY,EAAE,EACxB,OAAO,EACP,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAC5C,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/execution.d.ts

@@ -0,0 +1,35 @@
+import type { Effect, Scope } from "effect";
+import type { HttpServerRequest } from "effect/http";
+/**
+ * Native middleware-context key shared by the compiler bridge and runtime owner.
+ * This server-local capability must never be forwarded through `sendContext`.
+ * @internal
+ */
+export declare const executionKey = "@rc312/tss-effect-serverfn/execution";
+/**
+ * Services supplied by the adapter in addition to the application's services.
+ * The Scope covers decoding and business work. The HTTP request provides
+ * metadata; Start has already consumed the RPC body.
+ * @internal
+ */
+export type RequestServices = Scope.Scope | HttpServerRequest.HttpServerRequest;
+/**
+ * Request-local execution contract used by generated handlers.
+ *
+ * Phase notifications occur inside the running Effect immediately before each
+ * stage. Calls to `run` are rejected after the enclosing native middleware ends.
+ *
+ * @template R - Services supplied by the application runtime.
+ * @internal
+ */
+export interface ExecutionCapability<R> {
+    readonly [executionKey]: {
+        /** Run scoped work and await cleanup before resolving or rejecting the Promise. */
+        readonly run: <A, E>(program: Effect.Effect<A, E, R | RequestServices>) => Promise<A>;
+        /** Classify subsequent failures as input-decoding failures. */
+        readonly beginInput: () => void;
+        /** Classify subsequent failures as handler-execution failures. */
+        readonly beginExecution: () => void;
+    };
+}
+//# sourceMappingURL=execution.d.ts.map

package/dist/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,YAAY,yCAAyC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,GAAG,iBAAiB,CAAC,iBAAiB,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE;QACvB,mFAAmF;QACnF,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,KAC9C,OAAO,CAAC,CAAC,CAAC,CAAC;QAChB,+DAA+D;QAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;QAChC,kEAAkE;QAClE,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;KACrC,CAAC;CACH"}

package/dist/execution.js

@@ -0,0 +1,7 @@
+/**
+ * Native middleware-context key shared by the compiler bridge and runtime owner.
+ * This server-local capability must never be forwarded through `sendContext`.
+ * @internal
+ */
+export const executionKey = "@rc312/tss-effect-serverfn/execution";
+//# sourceMappingURL=execution.js.map

package/dist/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,sCAAsC,CAAC"}

package/dist/failure.server.d.ts

@@ -0,0 +1,44 @@
+import { Cause, Effect } from "effect";
+import type { HttpServerRequest } from "effect/http";
+import type { EffectConfiguration } from "./effect-middleware.ts";
+/**
+ * Reject a configuration or runtime failure without invoking application policy.
+ * Runtime faults are never approved by the business-error schema, even when
+ * they resemble a public error or native redirect.
+ *
+ * @param fallback - Trusted rejection record to copy for an unexpected failure.
+ * @param cause - Original failure retained in the server-local registry.
+ * @throws {unknown} The squashed interruption, or a fresh fallback with native reporting ownership.
+ * @internal
+ */
+export declare const rejectRuntimeFailure: <F extends object, E>(fallback: F, cause: Cause.Cause<E>) => never;
+/**
+ * Handle a rejection escaping the native middleware chain.
+ * Recognized control flow and already-owned rejections retain their identity.
+ * Other values, including objects whose inspection throws, receive the trusted
+ * fallback without loading the application runtime.
+ *
+ * @param fallback - Trusted rejection record for unrecognized failures.
+ * @param error - Value thrown by native middleware or the generated handler.
+ * @throws {unknown} The recognized rejection or a registered fallback record.
+ * @internal
+ */
+export declare const rejectMiddlewareFailure: <F extends object>(fallback: F, error: unknown) => never;
+/**
+ * Project a completed operation's Cause into a client rejection and report it.
+ *
+ * Pure interruption and native control flow pass through without reporting.
+ * Ordinary decoder failures become `INVALID_INPUT` with HTTP 400. Only a single
+ * execution failure can be approved by the public-error encoder; other failures
+ * use the trusted fallback. Diagnostics stay attached by server-local identity.
+ *
+ * The caller must close the operation Scope before running this Effect and
+ * contain any defect in projection itself. Encoder/reporter services come from
+ * the application runtime and HTTP request, not the closed operation Scope.
+ *
+ * @returns An Effect yielding the rejection value for the Promise boundary to
+ * throw. The original Cause is preserved separately from the client payload.
+ * @internal
+ */
+export declare const projectFailure: <R, RuntimeError, P extends object, F extends object>(cause: Cause.Cause<unknown>, phase: "execution" | "input", configuration: EffectConfiguration<R, RuntimeError, P>, fallback: F, serverFnMeta: import("@tanstack/react-start").ServerFnMeta) => Effect.Effect<unknown, never, R | HttpServerRequest.HttpServerRequest>;
+//# sourceMappingURL=failure.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"failure.server.d.ts","sourceRoot":"","sources":["../src/failure.server.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,EACL,MAAM,EAMP,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,wBAAwB,CAAC;AAiChC;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,YAC5C,CAAC,SACJ,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KACpB,KAMF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,MAAM,YAC5C,CAAC,SACJ,OAAO,KACb,KAcF,CAAC;AAiDF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,GACzB,CAAC,EACD,YAAY,EACZ,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,uQAwFhB,CAAC"}

package/dist/failure.server.js

@@ -0,0 +1,161 @@
+/* oxlint-disable anti-slop/no-unknown-parameters -- This boundary classifies arbitrary thrown values; parsing them first would lose native control flow and error identity. */
+import { setResponseStatus } from "@tanstack/react-start/server";
+import { isNotFound, isRedirect } from "@tanstack/router-core";
+import { Cause, Effect, ErrorReporter, Exit, Option, Predicate, Schema, } from "effect";
+import { getServerFnFailureDisposition, ownFailure, } from "./provenance.server.js";
+const isControlFlow = (value) => value instanceof Response || isRedirect(value) || isNotFound(value);
+/**
+ * Extract a typed failure only when it is the Cause's sole reason.
+ * Mixed Causes, defects, and interruption cannot qualify as a public business
+ * error. `Some(undefined)` still represents a real typed failure.
+ */
+const getSingleFailure = (cause) => {
+    const reason = cause.reasons.length === 1 ? cause.reasons[0] : undefined;
+    return reason && Cause.isFailReason(reason)
+        ? Option.some(reason.error)
+        : Option.none();
+};
+const isOwnedFailure = (value) => getServerFnFailureDisposition(value) !== undefined;
+const suppressInterruption = (cause) => {
+    const rejection = Cause.squash(cause);
+    return Predicate.isObject(rejection)
+        ? ownFailure(rejection, "suppress", cause)
+        : rejection;
+};
+/**
+ * Reject a configuration or runtime failure without invoking application policy.
+ * Runtime faults are never approved by the business-error schema, even when
+ * they resemble a public error or native redirect.
+ *
+ * @param fallback - Trusted rejection record to copy for an unexpected failure.
+ * @param cause - Original failure retained in the server-local registry.
+ * @throws {unknown} The squashed interruption, or a fresh fallback with native reporting ownership.
+ * @internal
+ */
+export const rejectRuntimeFailure = (fallback, cause) => {
+    if (Cause.hasInterruptsOnly(cause)) {
+        throw suppressInterruption(cause);
+    }
+    throw ownFailure({ ...fallback }, "native", cause);
+};
+/**
+ * Handle a rejection escaping the native middleware chain.
+ * Recognized control flow and already-owned rejections retain their identity.
+ * Other values, including objects whose inspection throws, receive the trusted
+ * fallback without loading the application runtime.
+ *
+ * @param fallback - Trusted rejection record for unrecognized failures.
+ * @param error - Value thrown by native middleware or the generated handler.
+ * @throws {unknown} The recognized rejection or a registered fallback record.
+ * @internal
+ */
+export const rejectMiddlewareFailure = (fallback, error) => {
+    let passthrough = false;
+    try {
+        passthrough = isControlFlow(error) || isOwnedFailure(error);
+    }
+    catch {
+        // Inspection faults remain private.
+    }
+    if (passthrough) {
+        throw error;
+    }
+    return rejectRuntimeFailure(fallback, Cause.fail(error));
+};
+/**
+ * Await the selected reporter and determine who owns further reporting.
+ * An explicit override replaces native reporting and its ignore policy. The
+ * override is interruptible and timeout-bounded even during masked rejection
+ * processing. Reporter failures leave ownership with the outer framework.
+ *
+ * @returns An Effect yielding `boundary` after handling, `suppress` for a native
+ * ignore annotation, or `native` when outer framework reporting is still needed.
+ */
+const reportFailure = Effect.fnUntraced(function* reportFailure(report, configuration, ignoredByNativeReporter) {
+    const { reportFailure: override, reportTimeout } = configuration;
+    if (override) {
+        const reportingExit = yield* Effect.exit(Effect.suspend(() => override(report)).pipe(Effect.interruptible, Effect.timeout(reportTimeout ?? "5 seconds")));
+        return Exit.isSuccess(reportingExit) ? "boundary" : "native";
+    }
+    const reporters = yield* ErrorReporter.CurrentErrorReporters;
+    const reportingExit = yield* Effect.exit(ErrorReporter.report(report.cause));
+    if (ignoredByNativeReporter) {
+        return "suppress";
+    }
+    return Exit.isSuccess(reportingExit) && reporters.size > 0
+        ? "boundary"
+        : "native";
+});
+/**
+ * Project a completed operation's Cause into a client rejection and report it.
+ *
+ * Pure interruption and native control flow pass through without reporting.
+ * Ordinary decoder failures become `INVALID_INPUT` with HTTP 400. Only a single
+ * execution failure can be approved by the public-error encoder; other failures
+ * use the trusted fallback. Diagnostics stay attached by server-local identity.
+ *
+ * The caller must close the operation Scope before running this Effect and
+ * contain any defect in projection itself. Encoder/reporter services come from
+ * the application runtime and HTTP request, not the closed operation Scope.
+ *
+ * @returns An Effect yielding the rejection value for the Promise boundary to
+ * throw. The original Cause is preserved separately from the client payload.
+ * @internal
+ */
+export const projectFailure = Effect.fnUntraced(function* projectFailure(cause, phase, configuration, fallback, serverFnMeta) {
+    if (Cause.hasInterruptsOnly(cause)) {
+        return suppressInterruption(cause);
+    }
+    let failure = { ...fallback };
+    let processingCause;
+    const inspectionExit = yield* Effect.exit(Effect.sync(() => {
+        const single = getSingleFailure(cause);
+        return Option.isSome(single)
+            ? {
+                ignored: ErrorReporter.isIgnored(single.value),
+                invalidInput: phase === "input" && Schema.isSchemaError(single.value),
+                passthrough: isControlFlow(single.value) || isOwnedFailure(single.value),
+                value: single.value,
+            }
+            : undefined;
+    }));
+    if (Exit.isFailure(inspectionExit)) {
+        processingCause = inspectionExit.cause;
+    }
+    else if (inspectionExit.value) {
+        const single = inspectionExit.value;
+        if (single.passthrough) {
+            return single.value;
+        }
+        if (single.invalidInput) {
+            yield* Effect.sync(() => setResponseStatus(400));
+            return ownFailure({ code: "INVALID_INPUT", message: "Invalid input" }, "suppress", cause);
+        }
+        const { publicError } = configuration;
+        if (phase === "execution" && publicError) {
+            const encodingExit = yield* Effect.exit(Effect.suspend(() => Schema.encodeUnknownEffect(publicError, {
+                onExcessProperty: "ignore",
+            })(single.value)));
+            if (Exit.isSuccess(encodingExit)) {
+                failure = encodingExit.value;
+            }
+            else {
+                processingCause = encodingExit.cause;
+            }
+        }
+    }
+    const report = {
+        cause,
+        failure,
+        phase,
+        processingCause,
+        serverFnMeta,
+    };
+    const ignored = Exit.isSuccess(inspectionExit) && inspectionExit.value?.ignored === true;
+    const disposition = yield* reportFailure(report, configuration, ignored);
+    if (Predicate.isObject(failure)) {
+        return ownFailure({ ...failure }, disposition, cause);
+    }
+    return ownFailure({ ...fallback }, "native", cause);
+});
+//# sourceMappingURL=failure.server.js.map

package/dist/failure.server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { type CreateEffectServerFn, createEffectServerFn, type EffectServerFnBuilder, } from "./create-effect-server-fn.ts";
+export { type EffectConfiguration, type EffectMiddlewareOptions, createEffectMiddleware, type FailureReport, } from "./effect-middleware.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,qBAAqB,GAC3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,sBAAsB,EACtB,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createEffectServerFn, } from "./create-effect-server-fn.js";
+export { createEffectMiddleware, } from "./effect-middleware.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,GAErB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAGL,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC"}

package/dist/provenance.server.d.ts

@@ -0,0 +1,54 @@
+import type { Cause } from "effect";
+/**
+ * Reporting ownership for one rejection identity: suppress all capture, mark
+ * boundary handling, or leave reporting to the native framework.
+ */
+type Disposition = "suppress" | "boundary" | "native";
+/**
+ * Register diagnostics and reporting ownership without mutating a rejection.
+ * Registration resets event acceptance for this identity. Boundary-created
+ * rejections use fresh records so separate requests are deduplicated separately.
+ *
+ * @param failure - Object used as the actual rejection identity.
+ * @param disposition - Whether reporting is suppressed, handled, or delegated.
+ * @param cause - Original diagnostic Cause; never added to the wire payload.
+ * @returns The same object, suitable for returning or throwing.
+ * @internal
+ */
+export declare const ownFailure: <P extends object>(failure: P, disposition: Disposition, cause?: Cause.Cause<unknown>) => P;
+/**
+ * Read the reporting policy for a rejection recognized by this server process.
+ *
+ * `capture` indicates whether an error event is allowed. `handled` indicates
+ * that the boundary handled or suppressed reporting, so outer middleware should
+ * not initiate another capture. This lookup does not consume event acceptance.
+ *
+ * @param error - The original rejection object, not a deserialized copy.
+ * @returns A policy snapshot, or `undefined` for an unrecognized value.
+ */
+export declare const getServerFnFailureDisposition: <E>(error: E) => {
+    capture: boolean;
+    handled: boolean;
+} | undefined;
+/**
+ * Retrieve the original diagnostic Cause associated with a rejection.
+ * Includes bootstrap and runtime failures as well as business/cleanup failures.
+ * The Cause can contain private data and must remain server-local.
+ *
+ * @param error - The original rejection identity observed on the server.
+ * @returns Its registered Cause, or `undefined` when none is available.
+ */
+export declare const getServerFnFailureCause: <E>(error: E) => Cause.Cause<unknown> | undefined;
+/**
+ * Accept at most one error-delivery event for a registered rejection identity.
+ * Use in a reporter's `beforeSend`-style hook, including events initiated by the
+ * boundary itself. Unlike the disposition lookup, this call consumes acceptance.
+ * Unrelated errors retain native reporting behavior.
+ *
+ * @param error - The original exception associated with the delivery event.
+ * @returns `false` for suppressed or already-accepted registered failures;
+ * `true` for the first allowed event or any unrecognized value.
+ */
+export declare const acceptServerFnErrorEvent: <E>(error: E) => boolean;
+export {};
+//# sourceMappingURL=provenance.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.server.d.ts","sourceRoot":"","sources":["../src/provenance.server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;GAGG;AACH,KAAK,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AA+BtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,WAChC,CAAC,eACG,WAAW,UAChB,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAC3B,CAYF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,GAAI,CAAC,SAAS,CAAC;;;aASxD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAChC,CAAC,KACP,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,SAA0C,CAAC;AAErE;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,CAAC,YAcnD,CAAC"}

package/dist/provenance.server.js

@@ -0,0 +1,87 @@
+import { Predicate } from "effect";
+const makeRegistry = () => ({
+    failures: new WeakMap(),
+});
+/**
+ * Identity-based diagnostics shared by adapters and reporting hooks.
+ * Weak keys avoid retaining completed failures; Vite's HMR data keeps in-flight
+ * rejections recognizable when this module is replaced.
+ */
+const registry = (() => {
+    if (import.meta.hot) {
+        import.meta.hot.data.effectServerFnProvenance ??= makeRegistry();
+        return import.meta.hot.data.effectServerFnProvenance;
+    }
+    return makeRegistry();
+})();
+// oxlint-disable-next-line anti-slop/no-unknown-parameters -- Lookup accepts arbitrary rejection values and narrows before touching the identity registry.
+const getFailureState = (error) => Predicate.isObject(error) ? registry.failures.get(error) : undefined;
+/**
+ * Register diagnostics and reporting ownership without mutating a rejection.
+ * Registration resets event acceptance for this identity. Boundary-created
+ * rejections use fresh records so separate requests are deduplicated separately.
+ *
+ * @param failure - Object used as the actual rejection identity.
+ * @param disposition - Whether reporting is suppressed, handled, or delegated.
+ * @param cause - Original diagnostic Cause; never added to the wire payload.
+ * @returns The same object, suitable for returning or throwing.
+ * @internal
+ */
+export const ownFailure = (failure, disposition, cause) => {
+    const state = {
+        accepted: false,
+        disposition,
+    };
+    registry.failures.set(failure, cause === undefined ? state : { ...state, cause });
+    return failure;
+};
+/**
+ * Read the reporting policy for a rejection recognized by this server process.
+ *
+ * `capture` indicates whether an error event is allowed. `handled` indicates
+ * that the boundary handled or suppressed reporting, so outer middleware should
+ * not initiate another capture. This lookup does not consume event acceptance.
+ *
+ * @param error - The original rejection object, not a deserialized copy.
+ * @returns A policy snapshot, or `undefined` for an unrecognized value.
+ */
+export const getServerFnFailureDisposition = (error) => {
+    const state = getFailureState(error);
+    return state
+        ? {
+            capture: state.disposition !== "suppress",
+            handled: state.disposition !== "native",
+        }
+        : undefined;
+};
+/**
+ * Retrieve the original diagnostic Cause associated with a rejection.
+ * Includes bootstrap and runtime failures as well as business/cleanup failures.
+ * The Cause can contain private data and must remain server-local.
+ *
+ * @param error - The original rejection identity observed on the server.
+ * @returns Its registered Cause, or `undefined` when none is available.
+ */
+export const getServerFnFailureCause = (error) => getFailureState(error)?.cause;
+/**
+ * Accept at most one error-delivery event for a registered rejection identity.
+ * Use in a reporter's `beforeSend`-style hook, including events initiated by the
+ * boundary itself. Unlike the disposition lookup, this call consumes acceptance.
+ * Unrelated errors retain native reporting behavior.
+ *
+ * @param error - The original exception associated with the delivery event.
+ * @returns `false` for suppressed or already-accepted registered failures;
+ * `true` for the first allowed event or any unrecognized value.
+ */
+export const acceptServerFnErrorEvent = (error) => {
+    const state = getFailureState(error);
+    if (!state) {
+        return true;
+    }
+    if (state.disposition === "suppress" || state.accepted) {
+        return false;
+    }
+    state.accepted = true;
+    return true;
+};
+//# sourceMappingURL=provenance.server.js.map

package/dist/provenance.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.server.js","sourceRoot":"","sources":["../src/provenance.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAenC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,CAAC;IAC1B,QAAQ,EAAE,IAAI,OAAO,EAAwB;CAC9C,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,QAAQ,GAAoC,CAAC,GAAG,EAAE;IACtD,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,KAAK,YAAY,EAAE,CAAC;QAEjE,OAAO,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC;IACvD,CAAC;IAED,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC,CAAC,EAAE,CAAC;AAEL,2JAA2J;AAC3J,MAAM,eAAe,GAAG,CAAC,KAAc,EAAE,EAAE,CACzC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAAU,EACV,WAAwB,EACxB,KAA4B,EACzB,EAAE;IACL,MAAM,KAAK,GAAG;QACZ,QAAQ,EAAE,KAAK;QACf,WAAW;KACZ,CAAC;IAEF,QAAQ,CAAC,QAAQ,CAAC,GAAG,CACnB,OAAO,EACP,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAClD,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAI,KAAQ,EAAE,EAAE;IAC3D,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO,KAAK;QACV,CAAC,CAAC;YACE,OAAO,EAAE,KAAK,CAAC,WAAW,KAAK,UAAU;YACzC,OAAO,EAAE,KAAK,CAAC,WAAW,KAAK,QAAQ;SACxC;QACH,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,KAAQ,EAC0B,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAI,KAAQ,EAAE,EAAE;IACtD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAErC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAEtB,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import "@tanstack/react-start/server-only";
+export { acceptServerFnErrorEvent, getServerFnFailureCause, getServerFnFailureDisposition, } from "./provenance.server.ts";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,mCAAmC,CAAC;AAE3C,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC"}

package/dist/server.js

@@ -0,0 +1,3 @@
+import "@tanstack/react-start/server-only";
+export { acceptServerFnErrorEvent, getServerFnFailureCause, getServerFnFailureDisposition, } from "./provenance.server.js";
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,mCAAmC,CAAC;AAE3C,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC"}