effect-orpc 0.1.0 → 0.1.2

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   fallbackConfig,
   lazy as lazy2
 } from "@orpc/server";
-import { Cause as Cause2, Effect, Exit } from "effect";
+import { Cause as Cause2, Effect, Exit, FiberRefs } from "effect";
 
 // src/effect-enhance-router.ts
 import {
@@ -601,8 +601,13 @@ var EffectBuilder = class _EffectBuilder {
           captureStackTrace
         });
         const parentFiberRefs = getCurrentFiberRefs();
-        const effectWithRefs = parentFiberRefs ? Effect.setFiberRefs(parentFiberRefs).pipe(
-          Effect.andThen(tracedEffect)
+        const effectWithRefs = parentFiberRefs ? Effect.fiberIdWith(
+          (fiberId) => Effect.flatMap(
+            Effect.getFiberRefs,
+            (fiberRefs) => Effect.setFiberRefs(
+              FiberRefs.joinAs(fiberRefs, fiberId, parentFiberRefs)
+            ).pipe(Effect.andThen(tracedEffect))
+          )
         ) : tracedEffect;
         const exit = await runtime.runPromiseExit(effectWithRefs, {
           signal: opts.signal

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/effect-builder.ts","../src/effect-enhance-router.ts","../src/effect-procedure.ts","../src/tagged-error.ts"],"sourcesContent":["import type {\n  AnySchema,\n  ContractRouter,\n  ErrorMap,\n  HTTPPath,\n  InferSchemaOutput,\n  Meta,\n  Route,\n  Schema,\n} from \"@orpc/contract\";\nimport type {\n  AnyMiddleware,\n  BuilderConfig,\n  BuilderDef,\n  Context,\n  Lazy,\n  MapInputMiddleware,\n  MergedCurrentContext,\n  MergedInitialContext,\n  Middleware,\n  ProcedureHandler,\n  ProcedureHandlerOptions,\n  Router,\n} from \"@orpc/server\";\nimport type { IntersectPick } from \"@orpc/shared\";\nimport type { ManagedRuntime } from \"effect\";\n\nimport {\n  mergeMeta,\n  mergePrefix,\n  mergeRoute,\n  mergeTags,\n  ORPCError,\n} from \"@orpc/contract\";\nimport {\n  addMiddleware,\n  Builder,\n  decorateMiddleware,\n  fallbackConfig,\n  lazy,\n} from \"@orpc/server\";\nimport { Cause, Effect, Exit } from \"effect\";\n\nimport type {\n  EffectErrorConstructorMap,\n  EffectErrorMap,\n  MergedEffectErrorMap,\n} from \"./tagged-error\";\nimport type {\n  AnyBuilderLike,\n  EffectBuilderDef,\n  EffectErrorMapToErrorMap,\n  EffectProcedureBuilderWithInput,\n  EffectProcedureBuilderWithOutput,\n  EffectProcedureHandler,\n  EffectRouterBuilder,\n  EnhancedEffectRouter,\n  InferBuilderCurrentContext,\n  InferBuilderErrorMap,\n  InferBuilderInitialContext,\n  InferBuilderInputSchema,\n  InferBuilderMeta,\n  InferBuilderOutputSchema,\n} from \"./types\";\n\nimport { enhanceEffectRouter } from \"./effect-enhance-router\";\nimport { EffectDecoratedProcedure } from \"./effect-procedure\";\nimport { getCurrentFiberRefs } from \"./fiber-context-bridge\";\nimport {\n  createEffectErrorConstructorMap,\n  effectErrorMapToErrorMap,\n  isORPCTaggedError,\n} from \"./tagged-error\";\n\n/**\n * Captures the stack trace at the call site for better error reporting in spans.\n * This is called at procedure definition time to capture where the procedure was defined.\n *\n * @returns A function that lazily extracts the relevant stack frame\n */\nexport function addSpanStackTrace(): () => string | undefined {\n  const ErrorConstructor = Error as typeof Error & {\n    stackTraceLimit?: number;\n  };\n  const limit = ErrorConstructor.stackTraceLimit;\n  ErrorConstructor.stackTraceLimit = 3;\n  const traceError = new Error();\n  ErrorConstructor.stackTraceLimit = limit;\n  let cache: false | string = false;\n  return () => {\n    if (cache !== false) {\n      return cache;\n    }\n    if (traceError.stack !== undefined) {\n      const stack = traceError.stack.split(\"\\n\");\n      if (stack[3] !== undefined) {\n        cache = stack[3].trim();\n        return cache;\n      }\n    }\n  };\n}\n\n/**\n * Effect-native procedure builder that wraps an oRPC Builder instance\n * and adds Effect-specific capabilities while preserving Effect error\n * and requirements types.\n */\nexport class EffectBuilder<\n  TInitialContext extends Context,\n  TCurrentContext extends Context,\n  TInputSchema extends AnySchema,\n  TOutputSchema extends AnySchema,\n  TEffectErrorMap extends EffectErrorMap,\n  TMeta extends Meta,\n  TRequirementsProvided,\n  TRuntimeError,\n> {\n  /**\n   * This property holds the defined options and the effect-specific properties.\n   */\n  declare \"~effect\": EffectBuilderDef<\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n  declare \"~orpc\": BuilderDef<\n    TInputSchema,\n    TOutputSchema,\n    EffectErrorMapToErrorMap<TEffectErrorMap>,\n    TMeta\n  >;\n\n  constructor(\n    def: EffectBuilderDef<\n      TInputSchema,\n      TOutputSchema,\n      TEffectErrorMap,\n      TMeta,\n      TRequirementsProvided,\n      TRuntimeError\n    >,\n  ) {\n    const { runtime, spanConfig, effectErrorMap, ...orpcDef } = def;\n    this[\"~orpc\"] = orpcDef;\n    this[\"~effect\"] = { runtime, spanConfig, effectErrorMap, ...orpcDef };\n  }\n\n  /**\n   * Sets or overrides the config.\n   *\n   * @see {@link https://orpc.dev/docs/client/server-side#middlewares-order Middlewares Order Docs}\n   * @see {@link https://orpc.dev/docs/best-practices/dedupe-middleware#configuration Dedupe Middleware Docs}\n   */\n  $config(\n    config: BuilderConfig,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    const inputValidationCount =\n      this[\"~effect\"].inputValidationIndex -\n      fallbackConfig(\n        \"initialInputValidationIndex\",\n        this[\"~effect\"].config.initialInputValidationIndex,\n      );\n    const outputValidationCount =\n      this[\"~effect\"].outputValidationIndex -\n      fallbackConfig(\n        \"initialOutputValidationIndex\",\n        this[\"~effect\"].config.initialOutputValidationIndex,\n      );\n\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      config,\n      dedupeLeadingMiddlewares: fallbackConfig(\n        \"dedupeLeadingMiddlewares\",\n        config.dedupeLeadingMiddlewares,\n      ),\n      inputValidationIndex:\n        fallbackConfig(\n          \"initialInputValidationIndex\",\n          config.initialInputValidationIndex,\n        ) + inputValidationCount,\n      outputValidationIndex:\n        fallbackConfig(\n          \"initialOutputValidationIndex\",\n          config.initialOutputValidationIndex,\n        ) + outputValidationCount,\n    });\n  }\n\n  /**\n   * Set or override the initial context.\n   *\n   * @see {@link https://orpc.dev/docs/context Context Docs}\n   */\n  $context<U extends Context>(): EffectBuilder<\n    U & Record<never, never>,\n    U,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    /**\n     * We need `& Record<never, never>` to deal with `has no properties in common with type` error\n     */\n\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      middlewares: [],\n      inputValidationIndex: fallbackConfig(\n        \"initialInputValidationIndex\",\n        this[\"~effect\"].config.initialInputValidationIndex,\n      ),\n      outputValidationIndex: fallbackConfig(\n        \"initialOutputValidationIndex\",\n        this[\"~effect\"].config.initialOutputValidationIndex,\n      ),\n    });\n  }\n\n  /**\n   * Sets or overrides the initial meta.\n   *\n   * @see {@link https://orpc.dev/docs/metadata Metadata Docs}\n   */\n  $meta<U extends Meta>(\n    initialMeta: U,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    U & Record<never, never>,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    /**\n     * We need `& Record<never, never>` to deal with `has no properties in common with type` error\n     */\n\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      meta: initialMeta,\n    });\n  }\n\n  /**\n   * Sets or overrides the initial route.\n   * This option is typically relevant when integrating with OpenAPI.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}\n   * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}\n   */\n  $route(\n    initialRoute: Route,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      route: initialRoute,\n    });\n  }\n\n  /**\n   * Sets or overrides the initial input schema.\n   *\n   * @see {@link https://orpc.dev/docs/procedure#initial-configuration Initial Procedure Configuration Docs}\n   */\n  $input<U extends AnySchema>(\n    initialInputSchema?: U,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    U,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      inputSchema: initialInputSchema,\n    });\n  }\n\n  /**\n   * Adds type-safe custom errors.\n   * Supports both traditional oRPC error definitions and ORPCTaggedError classes.\n   *\n   * @example\n   * ```ts\n   * // Traditional format\n   * builder.errors({ BAD_REQUEST: { status: 400, message: 'Bad request' } })\n   *\n   * // Tagged error class\n   * builder.errors({ USER_NOT_FOUND: UserNotFoundError })\n   *\n   * // Mixed\n   * builder.errors({\n   *   BAD_REQUEST: { status: 400 },\n   *   USER_NOT_FOUND: UserNotFoundError,\n   * })\n   * ```\n   *\n   * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}\n   */\n  errors<U extends EffectErrorMap>(\n    errors: U,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    MergedEffectErrorMap<TEffectErrorMap, U>,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    const newEffectErrorMap: MergedEffectErrorMap<TEffectErrorMap, U> = {\n      ...this[\"~effect\"].effectErrorMap,\n      ...errors,\n    };\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      errorMap: effectErrorMapToErrorMap(newEffectErrorMap),\n      effectErrorMap: newEffectErrorMap,\n    });\n  }\n\n  /**\n   * Uses a middleware to modify the context or improve the pipeline.\n   *\n   * @info Supports both normal middleware and inline middleware implementations.\n   * @note The current context must be satisfy middleware dependent-context\n   * @see {@link https://orpc.dev/docs/middleware Middleware Docs}\n   */\n  use<\n    UOutContext extends IntersectPick<TCurrentContext, UOutContext>,\n    UInContext extends Context = TCurrentContext,\n  >(\n    middleware: Middleware<\n      UInContext | TCurrentContext,\n      UOutContext,\n      InferSchemaOutput<TInputSchema>,\n      unknown,\n      EffectErrorConstructorMap<TEffectErrorMap>,\n      TMeta\n    >,\n  ): EffectBuilder<\n    MergedInitialContext<TInitialContext, UInContext, TCurrentContext>,\n    MergedCurrentContext<TCurrentContext, UOutContext>,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n\n  use(\n    middleware: AnyMiddleware,\n    mapInput?: MapInputMiddleware<any, any>,\n  ): EffectBuilder<any, any, any, any, any, any, any, any> {\n    const mapped = mapInput\n      ? decorateMiddleware(middleware).mapInput(mapInput)\n      : middleware;\n\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      middlewares: addMiddleware(this[\"~effect\"].middlewares, mapped),\n    });\n  }\n\n  /**\n   * Sets or updates the metadata.\n   * The provided metadata is spared-merged with any existing metadata.\n   *\n   * @see {@link https://orpc.dev/docs/metadata Metadata Docs}\n   */\n  meta(\n    meta: TMeta,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      meta: mergeMeta(this[\"~effect\"].meta, meta),\n    });\n  }\n\n  /**\n   * Sets or updates the route definition.\n   * The provided route is spared-merged with any existing route.\n   * This option is typically relevant when integrating with OpenAPI.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}\n   * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}\n   */\n  route(\n    route: Route,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      route: mergeRoute(this[\"~effect\"].route, route),\n    });\n  }\n\n  /**\n   * Defines the input validation schema.\n   *\n   * @see {@link https://orpc.dev/docs/procedure#input-output-validation Input Validation Docs}\n   */\n  input<USchema extends AnySchema>(\n    schema: USchema,\n  ): EffectProcedureBuilderWithInput<\n    TInitialContext,\n    TCurrentContext,\n    USchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      inputSchema: schema,\n      inputValidationIndex:\n        fallbackConfig(\n          \"initialInputValidationIndex\",\n          this[\"~effect\"].config.initialInputValidationIndex,\n        ) + this[\"~effect\"].middlewares.length,\n      // we cast to any because EffectProcedureBuilderWithInput is expecting\n      // use() input type to be defined, and EffectBuilder types its use() input\n      // to unknown to allow any middleware to be passed\n      // ---\n      // note: the original implentation of the builder also uses any for the same reason\n    }) as any;\n  }\n\n  /**\n   * Defines the output validation schema.\n   *\n   * @see {@link https://orpc.dev/docs/procedure#input-output-validation Output Validation Docs}\n   */\n  output<USchema extends AnySchema>(\n    schema: USchema,\n  ): EffectProcedureBuilderWithOutput<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    USchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    // We cast to any because EffectProcedureBuilderWithOutput narrows\n    // handler/effect output typing based on the declared output schema.\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      outputSchema: schema,\n      outputValidationIndex:\n        fallbackConfig(\n          \"initialOutputValidationIndex\",\n          this[\"~effect\"].config.initialOutputValidationIndex,\n        ) + this[\"~effect\"].middlewares.length,\n    }) as any;\n  }\n\n  /**\n   * Adds a traceable span to the procedure for telemetry.\n   * The span name is used for Effect tracing via `Effect.withSpan`.\n   * Stack trace is captured at the call site for better error reporting.\n   *\n   * @param spanName - The name of the span for telemetry (e.g., 'users.getUser')\n   * @returns An EffectBuilder with span tracing configured\n   *\n   * @example\n   * ```ts\n   * const getUser = effectOs\n   *   .input(z.object({ id: z.string() }))\n   *   .traced('users.getUser')\n   *   .effect(function* ({ input }) {\n   *     const userService = yield* UserService\n   *     return yield* userService.findById(input.id)\n   *   })\n   * ```\n   */\n  traced(\n    spanName: string,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      spanConfig: {\n        name: spanName,\n        captureStackTrace: addSpanStackTrace(),\n      },\n    });\n  }\n\n  handler<UFuncOutput>(\n    handler: ProcedureHandler<\n      TCurrentContext,\n      InferSchemaOutput<TInputSchema>,\n      UFuncOutput,\n      EffectErrorMapToErrorMap<TEffectErrorMap>,\n      TMeta\n    >,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    Schema<UFuncOutput, UFuncOutput>,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      handler,\n    });\n  }\n\n  /**\n   * Defines the handler of the procedure using an Effect.\n   * The Effect is executed using the ManagedRuntime provided during builder creation.\n   * The effect is automatically wrapped with `Effect.withSpan`.\n   *\n   * @see {@link https://orpc.dev/docs/procedure Procedure Docs}\n   */\n  effect<UFuncOutput>(\n    effectFn: EffectProcedureHandler<\n      TCurrentContext,\n      TInputSchema,\n      UFuncOutput,\n      TEffectErrorMap,\n      TRequirementsProvided,\n      TMeta\n    >,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    Schema<UFuncOutput, UFuncOutput>,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    const { runtime, spanConfig } = this[\"~effect\"];\n    // Capture stack trace at definition time for default tracing\n    const defaultCaptureStackTrace = addSpanStackTrace();\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      handler: async (opts) => {\n        const effectOpts: ProcedureHandlerOptions<\n          TCurrentContext,\n          InferSchemaOutput<TInputSchema>,\n          EffectErrorConstructorMap<TEffectErrorMap>,\n          TMeta\n        > = {\n          context: opts.context,\n          input: opts.input,\n          path: opts.path,\n          procedure: opts.procedure,\n          signal: opts.signal,\n          lastEventId: opts.lastEventId,\n          errors: createEffectErrorConstructorMap(\n            this[\"~effect\"].effectErrorMap,\n          ),\n        };\n        const spanName = spanConfig?.name ?? opts.path.join(\".\");\n        const captureStackTrace =\n          spanConfig?.captureStackTrace ?? defaultCaptureStackTrace;\n        const resolver = Effect.fnUntraced(effectFn);\n        const tracedEffect = Effect.withSpan(resolver(effectOpts), spanName, {\n          captureStackTrace,\n        });\n        const parentFiberRefs = getCurrentFiberRefs();\n        const effectWithRefs = parentFiberRefs\n          ? Effect.setFiberRefs(parentFiberRefs).pipe(\n              Effect.andThen(tracedEffect),\n            )\n          : tracedEffect;\n        const exit = await runtime.runPromiseExit(effectWithRefs, {\n          signal: opts.signal,\n        });\n\n        if (Exit.isFailure(exit)) {\n          throw Cause.match(exit.cause, {\n            onDie(defect) {\n              return new ORPCError(\"INTERNAL_SERVER_ERROR\", {\n                cause: defect,\n              });\n            },\n            onFail(error) {\n              if (isORPCTaggedError(error)) {\n                return error.toORPCError();\n              }\n              if (error instanceof ORPCError) {\n                return error;\n              }\n              return new ORPCError(\"INTERNAL_SERVER_ERROR\", {\n                cause: error,\n              });\n            },\n            onInterrupt(fiberId) {\n              return new ORPCError(\"INTERNAL_SERVER_ERROR\", {\n                cause: new Error(`${fiberId} Interrupted`),\n              });\n            },\n            onSequential(left) {\n              return left;\n            },\n            onEmpty: new ORPCError(\"INTERNAL_SERVER_ERROR\", {\n              cause: new Error(\"Unknown error\"),\n            }),\n            onParallel(left) {\n              return left;\n            },\n          });\n        }\n\n        return exit.value;\n      },\n    });\n  }\n\n  /**\n   * Prefixes all procedures in the router.\n   * The provided prefix is post-appended to any existing router prefix.\n   *\n   * @note This option does not affect procedures that do not define a path in their route definition.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/routing#route-prefixes OpenAPI Route Prefixes Docs}\n   */\n  prefix(\n    prefix: HTTPPath,\n  ): EffectRouterBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      prefix: mergePrefix(this[\"~effect\"].prefix, prefix),\n    }) as any;\n  }\n\n  /**\n   * Adds tags to all procedures in the router.\n   * This helpful when you want to group procedures together in the OpenAPI specification.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}\n   */\n  tag(\n    ...tags: string[]\n  ): EffectRouterBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      tags: mergeTags(this[\"~effect\"].tags, tags),\n    }) as any;\n  }\n\n  /**\n   * Applies all of the previously defined options to the specified router.\n   *\n   * @see {@link https://orpc.dev/docs/router#extending-router Extending Router Docs}\n   */\n  router<U extends Router<ContractRouter<TMeta>, TCurrentContext>>(\n    router: U,\n  ): EnhancedEffectRouter<\n    U,\n    TInitialContext,\n    TCurrentContext,\n    TEffectErrorMap\n  > {\n    return enhanceEffectRouter(router, {\n      ...this[\"~effect\"],\n    }) as any; // Type instantiation is excessively deep and possibly infinite\n  }\n\n  /**\n   * Create a lazy router\n   * And applies all of the previously defined options to the specified router.\n   *\n   * @see {@link https://orpc.dev/docs/router#extending-router Extending Router Docs}\n   */\n  lazy<U extends Router<ContractRouter<TMeta>, TCurrentContext>>(\n    loader: () => Promise<{ default: U }>,\n  ): EnhancedEffectRouter<\n    Lazy<U>,\n    TInitialContext,\n    TCurrentContext,\n    TEffectErrorMap\n  > {\n    return enhanceEffectRouter(lazy(loader), {\n      ...this[\"~effect\"],\n    }) as any; // Type instantiation is excessively deep and possibly infinite\n  }\n}\n\n/**\n * Creates an Effect-aware procedure builder with the specified ManagedRuntime.\n * Uses the default `os` builder from `@orpc/server`.\n *\n * @param runtime - The ManagedRuntime that provides services for Effect procedures\n * @returns An EffectBuilder instance for creating Effect-native procedures\n *\n * @example\n * ```ts\n * import { makeEffectORPC } from '@orpc/effect'\n * import { Effect, Layer, ManagedRuntime } from 'effect'\n *\n * const runtime = ManagedRuntime.make(Layer.empty)\n * const effectOs = makeEffectORPC(runtime)\n *\n * const hello = effectOs.effect(() => Effect.succeed('Hello!'))\n * ```\n */\nexport function makeEffectORPC<TRequirementsProvided, TRuntimeError>(\n  runtime: ManagedRuntime.ManagedRuntime<TRequirementsProvided, TRuntimeError>,\n): EffectBuilder<\n  Context,\n  Context,\n  Schema<unknown, unknown>,\n  Schema<unknown, unknown>,\n  Record<never, never>,\n  Record<never, never>,\n  TRequirementsProvided,\n  TRuntimeError\n>;\n\n/**\n * Creates an Effect-aware procedure builder by wrapping an existing oRPC Builder\n * with the specified ManagedRuntime.\n *\n * @param runtime - The ManagedRuntime that provides services for Effect procedures\n * @param builder - The oRPC Builder instance to wrap (e.g., a customized `os`)\n * @returns An EffectBuilder instance that extends the original builder with Effect support\n *\n * @example\n * ```ts\n * import { makeEffectORPC } from '@orpc/effect'\n * import { os } from '@orpc/server'\n * import { Effect, Layer, ManagedRuntime } from 'effect'\n *\n * // Create a customized builder\n * const authedOs = os.use(authMiddleware)\n *\n * // Wrap it with Effect support\n * const runtime = ManagedRuntime.make(UserServiceLive)\n * const effectOs = makeEffectORPC(runtime, authedOs)\n *\n * const getUser = effectOs\n *   .input(z.object({ id: z.string() }))\n *   .effect(\n *     Effect.fn(function* ({ input }) {\n *       const userService = yield* UserService\n *       return yield* userService.findById(input.id)\n *     })\n *   )\n * ```\n */\nexport function makeEffectORPC<\n  TBuilder extends AnyBuilderLike<\n    TInputSchema,\n    TOutputSchema,\n    TErrorMap,\n    TMeta\n  >,\n  TInputSchema extends AnySchema,\n  TOutputSchema extends AnySchema,\n  TErrorMap extends ErrorMap,\n  TMeta extends Meta,\n  TRequirementsProvided,\n  TRuntimeError,\n>(\n  runtime: ManagedRuntime.ManagedRuntime<TRequirementsProvided, TRuntimeError>,\n  builder: TBuilder,\n): EffectBuilder<\n  InferBuilderInitialContext<TBuilder>,\n  InferBuilderCurrentContext<TBuilder>,\n  InferBuilderInputSchema<TBuilder>,\n  InferBuilderOutputSchema<TBuilder>,\n  InferBuilderErrorMap<TBuilder>,\n  InferBuilderMeta<TBuilder>,\n  TRequirementsProvided,\n  TRuntimeError\n>;\n\nexport function makeEffectORPC<TRequirementsProvided, TRuntimeError>(\n  runtime: ManagedRuntime.ManagedRuntime<TRequirementsProvided, TRuntimeError>,\n  builder?: AnyBuilderLike,\n): EffectBuilder<\n  any,\n  any,\n  any,\n  any,\n  any,\n  any,\n  TRequirementsProvided,\n  TRuntimeError\n> {\n  const resolvedBuilder = builder ?? emptyBuilder();\n  return new EffectBuilder({\n    ...resolvedBuilder[\"~orpc\"],\n    errorMap: effectErrorMapToErrorMap(resolvedBuilder[\"~orpc\"].errorMap),\n    effectErrorMap: resolvedBuilder[\"~orpc\"].errorMap,\n    runtime,\n  });\n}\n\nfunction emptyBuilder(): AnyBuilderLike {\n  return new Builder({\n    config: {},\n    route: {},\n    meta: {},\n    errorMap: {},\n    inputValidationIndex: fallbackConfig(\"initialInputValidationIndex\"),\n    outputValidationIndex: fallbackConfig(\"initialOutputValidationIndex\"),\n    middlewares: [],\n    dedupeLeadingMiddlewares: true,\n  });\n}\n","import type { ManagedRuntime } from \"effect/ManagedRuntime\";\n\nimport {\n  enhanceRoute,\n  mergePrefix,\n  type EnhanceRouteOptions,\n} from \"@orpc/contract\";\nimport {\n  createAccessibleLazyRouter,\n  getLazyMeta,\n  isLazy,\n  isProcedure,\n  lazy,\n  mergeMiddlewares,\n  unlazy,\n  type AnyMiddleware,\n  type AnyRouter,\n  type Context,\n  type Lazyable,\n} from \"@orpc/server\";\n\nimport type { EffectErrorMapToErrorMap, EnhancedEffectRouter } from \"./types\";\n\nimport { EffectProcedure } from \"./effect-procedure\";\nimport { effectErrorMapToErrorMap, type EffectErrorMap } from \"./tagged-error\";\n\ninterface EnhanceEffectRouterOptions<\n  TEffectErrorMap extends EffectErrorMap,\n  TRequirementsProvided,\n  TRuntimeError,\n> extends EnhanceRouteOptions {\n  middlewares: readonly AnyMiddleware[];\n  errorMap: TEffectErrorMap;\n  dedupeLeadingMiddlewares: boolean;\n  runtime: ManagedRuntime<TRequirementsProvided, TRuntimeError>;\n}\n\nexport function enhanceEffectRouter<\n  T extends Lazyable<AnyRouter>,\n  TInitialContext extends Context,\n  TCurrentContext extends Context,\n  TEffectErrorMap extends EffectErrorMap,\n  TRequirementsProvided,\n  TRuntimeError,\n>(\n  router: T,\n  options: EnhanceEffectRouterOptions<\n    TEffectErrorMap,\n    TRequirementsProvided,\n    TRuntimeError\n  >,\n): EnhancedEffectRouter<T, TInitialContext, TCurrentContext, TEffectErrorMap> {\n  if (isLazy(router)) {\n    const laziedMeta = getLazyMeta(router);\n    const enhancedPrefix = laziedMeta?.prefix\n      ? mergePrefix(options.prefix, laziedMeta?.prefix)\n      : options.prefix;\n\n    const enhanced = lazy(\n      async () => {\n        const { default: unlaziedRouter } = await unlazy(router);\n        const enhanced = enhanceEffectRouter(unlaziedRouter, options);\n        return unlazy(enhanced);\n      },\n      {\n        ...laziedMeta,\n        prefix: enhancedPrefix,\n      },\n    );\n\n    const accessible = createAccessibleLazyRouter(enhanced);\n\n    return accessible as any;\n  }\n\n  if (isProcedure(router)) {\n    const newMiddlewares = mergeMiddlewares(\n      options.middlewares,\n      router[\"~orpc\"].middlewares,\n      { dedupeLeading: options.dedupeLeadingMiddlewares },\n    );\n    const newMiddlewareAdded =\n      newMiddlewares.length - router[\"~orpc\"].middlewares.length;\n\n    const effectErrorMap = {\n      ...options.errorMap,\n      ...router[\"~orpc\"].errorMap,\n    };\n    const errorMap: EffectErrorMapToErrorMap<typeof effectErrorMap> =\n      effectErrorMapToErrorMap(effectErrorMap);\n    const enhanced = new EffectProcedure({\n      ...router[\"~orpc\"],\n      route: enhanceRoute(router[\"~orpc\"].route, options),\n      effectErrorMap,\n      errorMap: errorMap as EffectErrorMapToErrorMap<typeof effectErrorMap>,\n      middlewares: newMiddlewares,\n      inputValidationIndex:\n        router[\"~orpc\"].inputValidationIndex + newMiddlewareAdded,\n      outputValidationIndex:\n        router[\"~orpc\"].outputValidationIndex + newMiddlewareAdded,\n      runtime: options.runtime,\n    });\n\n    return enhanced as any;\n  }\n\n  const enhanced = {} as Record<string, any>;\n\n  for (const key in router) {\n    enhanced[key] = enhanceEffectRouter(router[key]!, options);\n  }\n\n  return enhanced as any;\n}\n","import type { ClientContext } from \"@orpc/client\";\nimport type {\n  AnySchema,\n  InferSchemaInput,\n  InferSchemaOutput,\n  Meta,\n  Route,\n} from \"@orpc/contract\";\nimport type {\n  AnyMiddleware,\n  Context,\n  CreateProcedureClientOptions,\n  MapInputMiddleware,\n  MergedCurrentContext,\n  MergedInitialContext,\n  Middleware,\n  ProcedureActionableClient,\n  ProcedureClient,\n  ProcedureDef,\n} from \"@orpc/server\";\nimport type { IntersectPick, MaybeOptionalOptions } from \"@orpc/shared\";\n\nimport { mergeMeta, mergeRoute } from \"@orpc/contract\";\nimport {\n  addMiddleware,\n  createActionableClient,\n  createProcedureClient,\n  decorateMiddleware,\n  Procedure,\n} from \"@orpc/server\";\n\nimport type {\n  EffectErrorConstructorMap,\n  EffectErrorMap,\n  MergedEffectErrorMap,\n} from \"./tagged-error\";\nimport type { EffectErrorMapToErrorMap, EffectProcedureDef } from \"./types\";\n\nimport { effectErrorMapToErrorMap } from \"./tagged-error\";\n\nexport class EffectProcedure<\n  TInitialContext extends Context,\n  TCurrentContext extends Context,\n  TInputSchema extends AnySchema,\n  TOutputSchema extends AnySchema,\n  TEffectErrorMap extends EffectErrorMap,\n  TMeta extends Meta,\n  TRequirementsProvided,\n  TRuntimeError,\n> extends Procedure<\n  TInitialContext,\n  TCurrentContext,\n  TInputSchema,\n  TOutputSchema,\n  EffectErrorMapToErrorMap<TEffectErrorMap>,\n  TMeta\n> {\n  /**\n   * This property holds the defined options and the effect-specific properties.\n   */\n  declare \"~effect\": EffectProcedureDef<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n  /**\n   * This property holds the defined options.\n   */\n  declare \"~orpc\": ProcedureDef<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    EffectErrorMapToErrorMap<TEffectErrorMap>,\n    TMeta\n  >;\n\n  constructor(\n    def: EffectProcedureDef<\n      TInitialContext,\n      TCurrentContext,\n      TInputSchema,\n      TOutputSchema,\n      TEffectErrorMap,\n      TMeta,\n      TRequirementsProvided,\n      TRuntimeError\n    >,\n  ) {\n    super(def);\n    this[\"~effect\"] = def;\n  }\n}\n\n/**\n * An Effect-native decorated procedure that preserves Effect error and requirements types.\n *\n * This class extends Procedure with additional type parameters for Effect-specific\n * type information, allowing full type inference of Effect errors and requirements.\n */\nexport class EffectDecoratedProcedure<\n  TInitialContext extends Context,\n  TCurrentContext extends Context,\n  TInputSchema extends AnySchema,\n  TOutputSchema extends AnySchema,\n  TEffectErrorMap extends EffectErrorMap,\n  TMeta extends Meta,\n  TRequirementsProvided,\n  TRuntimeError,\n> extends EffectProcedure<\n  TInitialContext,\n  TCurrentContext,\n  TInputSchema,\n  TOutputSchema,\n  TEffectErrorMap,\n  TMeta,\n  TRequirementsProvided,\n  TRuntimeError\n> {\n  /**\n   * This property holds the defined options and the effect-specific properties.\n   */\n  declare \"~effect\": EffectProcedureDef<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n  declare \"~orpc\": ProcedureDef<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    EffectErrorMapToErrorMap<TEffectErrorMap>,\n    TMeta\n  >;\n\n  constructor(\n    def: EffectProcedureDef<\n      TInitialContext,\n      TCurrentContext,\n      TInputSchema,\n      TOutputSchema,\n      TEffectErrorMap,\n      TMeta,\n      TRequirementsProvided,\n      TRuntimeError\n    >,\n  ) {\n    super(def);\n    this[\"~effect\"] = def;\n  }\n\n  /**\n   * Adds type-safe custom errors.\n   * Supports both traditional oRPC error definitions and ORPCTaggedError classes.\n   *\n   * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}\n   */\n  errors<U extends EffectErrorMap>(\n    errors: U,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    MergedEffectErrorMap<TEffectErrorMap, U>,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    const newEffectErrorMap: MergedEffectErrorMap<TEffectErrorMap, U> = {\n      ...this[\"~effect\"].effectErrorMap,\n      ...errors,\n    };\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      effectErrorMap: newEffectErrorMap,\n      errorMap: effectErrorMapToErrorMap(newEffectErrorMap),\n    });\n  }\n\n  /**\n   * Sets or updates the metadata.\n   * The provided metadata is spared-merged with any existing metadata.\n   *\n   * @see {@link https://orpc.dev/docs/metadata Metadata Docs}\n   */\n  meta(\n    meta: TMeta,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      meta: mergeMeta(this[\"~effect\"].meta, meta),\n    });\n  }\n\n  /**\n   * Sets or updates the route definition.\n   * The provided route is spared-merged with any existing route.\n   * This option is typically relevant when integrating with OpenAPI.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}\n   * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}\n   */\n  route(\n    route: Route,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      route: mergeRoute(this[\"~effect\"].route, route),\n    });\n  }\n\n  /**\n   * Uses a middleware to modify the context or improve the pipeline.\n   *\n   * @info Supports both normal middleware and inline middleware implementations.\n   * @info Pass second argument to map the input.\n   * @note The current context must be satisfy middleware dependent-context\n   * @see {@link https://orpc.dev/docs/middleware Middleware Docs}\n   */\n  use<\n    UOutContext extends IntersectPick<TCurrentContext, UOutContext>,\n    UInContext extends Context = TCurrentContext,\n  >(\n    middleware: Middleware<\n      UInContext | TCurrentContext,\n      UOutContext,\n      InferSchemaOutput<TInputSchema>,\n      InferSchemaInput<TOutputSchema>,\n      EffectErrorConstructorMap<TEffectErrorMap>,\n      TMeta\n    >,\n  ): EffectDecoratedProcedure<\n    MergedInitialContext<TInitialContext, UInContext, TCurrentContext>,\n    MergedCurrentContext<TCurrentContext, UOutContext>,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n\n  /**\n   * Uses a middleware to modify the context or improve the pipeline.\n   *\n   * @info Supports both normal middleware and inline middleware implementations.\n   * @info Pass second argument to map the input.\n   * @note The current context must be satisfy middleware dependent-context\n   * @see {@link https://orpc.dev/docs/middleware Middleware Docs}\n   */\n  use<\n    UOutContext extends IntersectPick<TCurrentContext, UOutContext>,\n    UInput,\n    UInContext extends Context = TCurrentContext,\n  >(\n    middleware: Middleware<\n      UInContext | TCurrentContext,\n      UOutContext,\n      UInput,\n      InferSchemaInput<TOutputSchema>,\n      EffectErrorConstructorMap<TEffectErrorMap>,\n      TMeta\n    >,\n    mapInput: MapInputMiddleware<InferSchemaOutput<TInputSchema>, UInput>,\n  ): EffectDecoratedProcedure<\n    MergedInitialContext<TInitialContext, UInContext, TCurrentContext>,\n    MergedCurrentContext<TCurrentContext, UOutContext>,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n\n  use(\n    middleware: AnyMiddleware,\n    mapInput?: MapInputMiddleware<any, any>,\n  ): EffectDecoratedProcedure<any, any, any, any, any, any, any, any> {\n    const mapped = mapInput\n      ? decorateMiddleware(middleware).mapInput(mapInput)\n      : middleware;\n\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      middlewares: addMiddleware(this[\"~effect\"].middlewares, mapped),\n    });\n  }\n\n  /**\n   * Make this procedure callable (works like a function while still being a procedure).\n   *\n   * @see {@link https://orpc.dev/docs/client/server-side Server-side Client Docs}\n   */\n  callable<TClientContext extends ClientContext>(\n    ...rest: MaybeOptionalOptions<\n      CreateProcedureClientOptions<\n        TInitialContext,\n        TOutputSchema,\n        EffectErrorMapToErrorMap<TEffectErrorMap>,\n        TMeta,\n        TClientContext\n      >\n    >\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > &\n    ProcedureClient<\n      TClientContext,\n      TInputSchema,\n      TOutputSchema,\n      EffectErrorMapToErrorMap<TEffectErrorMap>\n    > {\n    const client: ProcedureClient<\n      TClientContext,\n      TInputSchema,\n      TOutputSchema,\n      EffectErrorMapToErrorMap<TEffectErrorMap>\n    > = createProcedureClient(this, ...rest);\n\n    return new Proxy(client, {\n      get: (target, key) => {\n        return Reflect.has(this, key)\n          ? Reflect.get(this, key)\n          : Reflect.get(target, key);\n      },\n      has: (target, key) => {\n        return Reflect.has(this, key) || Reflect.has(target, key);\n      },\n    }) as any;\n  }\n\n  /**\n   * Make this procedure compatible with server action.\n   *\n   * @see {@link https://orpc.dev/docs/server-action Server Action Docs}\n   */\n  actionable(\n    ...rest: MaybeOptionalOptions<\n      CreateProcedureClientOptions<\n        TInitialContext,\n        TOutputSchema,\n        EffectErrorMapToErrorMap<TEffectErrorMap>,\n        TMeta,\n        Record<never, never>\n      >\n    >\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > &\n    ProcedureActionableClient<\n      TInputSchema,\n      TOutputSchema,\n      EffectErrorMapToErrorMap<TEffectErrorMap>\n    > {\n    const action: ProcedureActionableClient<\n      TInputSchema,\n      TOutputSchema,\n      EffectErrorMapToErrorMap<TEffectErrorMap>\n    > = createActionableClient(createProcedureClient(this, ...rest));\n\n    return new Proxy(action, {\n      get: (target, key) => {\n        return Reflect.has(this, key)\n          ? Reflect.get(this, key)\n          : Reflect.get(target, key);\n      },\n      has: (target, key) => {\n        return Reflect.has(this, key) || Reflect.has(target, key);\n      },\n    }) as any;\n  }\n}\n","import type {\n  ORPCErrorCode,\n  ORPCErrorJSON,\n  ORPCErrorOptions,\n} from \"@orpc/client\";\nimport type {\n  AnySchema,\n  ErrorMap,\n  ErrorMapItem,\n  InferSchemaOutput,\n} from \"@orpc/contract\";\nimport type { ORPCErrorConstructorMap } from \"@orpc/server\";\nimport type { MaybeOptionalOptions } from \"@orpc/shared\";\nimport type { Pipeable } from \"effect\";\n\nimport {\n  fallbackORPCErrorMessage,\n  fallbackORPCErrorStatus,\n  isORPCErrorStatus,\n  ORPCError,\n} from \"@orpc/client\";\nimport { resolveMaybeOptionalOptions } from \"@orpc/shared\";\nimport * as Cause from \"effect/Cause\";\nimport * as Data from \"effect/Data\";\n\nimport type { EffectErrorMapToErrorMap } from \"./types\";\n\n/**\n * Symbol to access the underlying ORPCError instance\n */\nexport const ORPCErrorSymbol: unique symbol = Symbol.for(\n  \"@orpc/effect/ORPCTaggedError\",\n);\n\n/**\n * Instance type for ORPCTaggedError that combines YieldableError with ORPCError properties\n */\nexport interface ORPCTaggedErrorInstance<\n  TTag extends string,\n  TCode extends ORPCErrorCode,\n  TSchema extends AnySchema = AnySchema,\n>\n  extends Cause.YieldableError, Pipeable.Pipeable {\n  readonly _tag: TTag;\n  readonly code: TCode;\n  readonly status: number;\n  readonly schema: TSchema;\n  readonly data: InferSchemaOutput<TSchema>;\n  readonly defined: boolean;\n  readonly [ORPCErrorSymbol]: ORPCError<TCode, InferSchemaOutput<TSchema>>;\n\n  toJSON(): ORPCErrorJSON<TCode, InferSchemaOutput<TSchema>> & { _tag: TTag };\n  toORPCError(): ORPCError<TCode, InferSchemaOutput<TSchema>>;\n}\n\n/**\n * Options for creating an ORPCTaggedError\n */\nexport type ORPCTaggedErrorOptions<TData> = Omit<\n  ORPCErrorOptions<TData>,\n  \"defined\"\n> & { defined?: boolean };\n\n/**\n * Constructor type for ORPCTaggedError classes\n */\nexport interface ORPCTaggedErrorClass<\n  TTag extends string,\n  TCode extends ORPCErrorCode,\n  TSchema extends AnySchema = AnySchema,\n> {\n  readonly _tag: TTag;\n  readonly code: TCode;\n  new (\n    ...args: MaybeOptionalOptions<\n      ORPCTaggedErrorOptions<InferSchemaOutput<TSchema>>\n    >\n  ): ORPCTaggedErrorInstance<TTag, TCode, TSchema>;\n}\n\n/**\n * Type helper to infer the ORPCError type from an ORPCTaggedError\n */\nexport type InferORPCError<T> =\n  T extends ORPCTaggedErrorInstance<string, infer TCode, infer TSchema>\n    ? ORPCError<TCode, InferSchemaOutput<TSchema>>\n    : never;\n\n/**\n * Any ORPCTaggedErrorClass\n * Uses `...args: any[]` for the constructor to accept any tagged error class,\n * regardless of whether TData requires options to be provided.\n */\nexport type AnyORPCTaggedErrorClass = {\n  readonly _tag: string;\n  readonly code: ORPCErrorCode;\n  new (\n    ...args: any[]\n  ): ORPCTaggedErrorInstance<string, ORPCErrorCode, AnySchema>;\n};\n\n/**\n * Check if a value is an ORPCTaggedErrorClass (constructor)\n */\nexport function isORPCTaggedErrorClass(\n  value: unknown,\n): value is AnyORPCTaggedErrorClass {\n  return (\n    typeof value === \"function\" &&\n    \"_tag\" in value &&\n    \"code\" in value &&\n    typeof value._tag === \"string\" &&\n    typeof value.code === \"string\"\n  );\n}\n\n/**\n * Check if a value is an ORPCTaggedError instance\n */\nexport function isORPCTaggedError(\n  value: unknown,\n): value is ORPCTaggedErrorInstance<string, ORPCErrorCode, AnySchema> {\n  return (\n    typeof value === \"object\" && value !== null && ORPCErrorSymbol in value\n  );\n}\n\n/**\n * Converts a PascalCase or camelCase string to CONSTANT_CASE.\n * e.g., \"UserNotFoundError\" -> \"USER_NOT_FOUND_ERROR\"\n */\nfunction toConstantCase<T extends string>(str: T): ToConstantCase<T> {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1_$2\")\n    .replace(/([A-Z])([A-Z][a-z])/g, \"$1_$2\")\n    .toUpperCase() as ToConstantCase<T>;\n}\n/**\n * Checks if a character is an uppercase letter (A-Z)\n */\ntype IsUpperLetter<C extends string> =\n  C extends Uppercase<C>\n    ? C extends Lowercase<C>\n      ? false // Not a letter (number, special char)\n      : true\n    : false;\n\n/**\n * Checks if a character is a lowercase letter (a-z)\n */\ntype IsLowerLetter<C extends string> =\n  C extends Lowercase<C>\n    ? C extends Uppercase<C>\n      ? false // Not a letter (number, special char)\n      : true\n    : false;\n\n/**\n * Converts PascalCase or camelCase to CONSTANT_CASE.\n * Handles consecutive uppercase letters correctly.\n *\n * @example\n * type T1 = ToConstantCase<\"ABCCode\">; // \"ABC_CODE\"\n * type T2 = ToConstantCase<\"UserCode\">; // \"USER_CODE\"\n * type T3 = ToConstantCase<\"XMLHttpRequest\">; // \"XML_HTTP_REQUEST\"\n */\ntype ToConstantCase<\n  S extends string,\n  Acc extends string = \"\",\n  PrevChar extends string = \"\",\n  InUpperSequence extends boolean = false,\n> = S extends `${infer Head}${infer Tail}`\n  ? IsUpperLetter<Head> extends true\n    ? Acc extends \"\"\n      ? // First character - no underscore\n        ToConstantCase<Tail, Head, Head, false>\n      : PrevChar extends \"\"\n        ? // Shouldn't happen, but handle gracefully\n          ToConstantCase<Tail, Head, Head, false>\n        : IsUpperLetter<PrevChar> extends true\n          ? // We're in an uppercase sequence\n            Tail extends `${infer Next}${infer _}`\n            ? IsLowerLetter<Next> extends true\n              ? // Next char is lowercase, so Head starts a new word - insert underscore\n                ToConstantCase<Tail, `${Acc}_${Head}`, Head, false>\n              : // Next char is uppercase or non-letter - continue sequence\n                ToConstantCase<Tail, `${Acc}${Head}`, Head, true>\n            : // Tail is empty - just append\n              ToConstantCase<Tail, `${Acc}${Head}`, Head, true>\n          : // Transition from lowercase to uppercase - insert underscore\n            ToConstantCase<Tail, `${Acc}_${Head}`, Head, false>\n    : IsLowerLetter<Head> extends true\n      ? InUpperSequence extends true\n        ? // End of uppercase sequence (2+) - insert underscore before lowercase\n          ToConstantCase<Tail, `${Acc}_${Uppercase<Head>}`, Head, false>\n        : // Single uppercase or no uppercase - no underscore\n          ToConstantCase<Tail, `${Acc}${Uppercase<Head>}`, Head, false>\n      : // Non-letter character - reset sequence\n        ToConstantCase<Tail, `${Acc}${Head}`, Head, false>\n  : Acc;\n\n/**\n * Converts a tag name to an error code in CONSTANT_CASE.\n */\nexport type TagToCode<TTag extends string> = ToConstantCase<TTag>;\n\n/**\n * Creates a tagged error class that combines Effect's YieldableError with ORPCError.\n *\n * This allows you to create errors that:\n * - Can be yielded in Effect generators (`yield* myError`)\n * - Have all ORPCError properties (code, status, data, defined)\n * - Can be converted to a plain ORPCError for oRPC handlers\n *\n * The returned factory function takes:\n * - `tag` - The unique tag for this error type (used for discriminated unions)\n * - `codeOrOptions` - Optional ORPC error code or options. If omitted, code defaults to CONSTANT_CASE of tag\n * - `defaultOptions` - Optional default options for status and message (when code is provided)\n *\n * @example\n * ```ts\n * import { ORPCTaggedError } from '@orpc/effect'\n * import { Effect } from 'effect'\n *\n * // Define a custom error (code defaults to 'USER_NOT_FOUND_ERROR')\n * class UserNotFoundError extends ORPCTaggedError<UserNotFoundError>()('UserNotFoundError') {}\n *\n * // With explicit code\n * class NotFoundError extends ORPCTaggedError<NotFoundError>()('NotFoundError', 'NOT_FOUND') {}\n *\n * // Use in an Effect\n * const getUser = (id: string) => Effect.gen(function* () {\n *   const user = yield* findUser(id)\n *   if (!user) {\n *     return yield* new UserNotFoundError({ data: { userId: id } })\n *   }\n *   return user\n * })\n *\n * // With custom data type\n * class ValidationError extends ORPCTaggedError<ValidationError, { fields: string[] }>()('ValidationError', 'BAD_REQUEST') {}\n *\n * // With options only (code defaults to 'VALIDATION_ERROR')\n * class ValidationError2 extends ORPCTaggedError<ValidationError2, { fields: string[] }>()(\n *   'ValidationError2',\n *   { message: 'Validation failed' }\n * ) {}\n * ```\n */\nexport function ORPCTaggedError<\n  TTag extends string,\n  TSchema extends AnySchema = AnySchema,\n  TCode extends ORPCErrorCode = ToConstantCase<TTag>,\n>(\n  tag: TTag,\n  props?: {\n    schema?: TSchema;\n    status?: number;\n    message?: string;\n    code?: TCode;\n  },\n): ORPCTaggedErrorClass<TTag, TCode, TSchema> {\n  const code: TCode = props?.code ?? (toConstantCase(tag) as any);\n  class ORPCTaggedErrorBase\n    extends Data.TaggedError(tag)\n    implements ORPCTaggedErrorInstance<TTag, TCode, TSchema>\n  {\n    readonly status: number;\n    readonly defined: boolean;\n    readonly data: InferSchemaOutput<TSchema>;\n    readonly code: TCode = code;\n    readonly schema = props?.schema as TSchema;\n    readonly [ORPCErrorSymbol]: ORPCError<TCode, InferSchemaOutput<TSchema>>;\n\n    constructor(\n      ...rest: MaybeOptionalOptions<\n        ORPCTaggedErrorOptions<InferSchemaOutput<TSchema>>\n      >\n    ) {\n      super();\n\n      const opts = resolveMaybeOptionalOptions(rest);\n      const status = opts.status ?? props?.status;\n\n      if (status !== undefined && !isORPCErrorStatus(status)) {\n        throw new globalThis.Error(\n          \"[ORPCTaggedError] Invalid error status code.\",\n        );\n      }\n\n      this.status = fallbackORPCErrorStatus(code, status);\n      this.defined = opts.defined ?? true;\n      this.data = opts.data as InferSchemaOutput<TSchema>;\n      this.message = fallbackORPCErrorMessage(\n        this.code,\n        opts.message ?? props?.message,\n      );\n      this.cause = opts.cause;\n\n      this[ORPCErrorSymbol] = new ORPCError<TCode, InferSchemaOutput<TSchema>>(\n        this.code,\n        {\n          status: this.status,\n          message: this.message,\n          data: this.data,\n          defined: this.defined,\n          cause: this.cause,\n        },\n      );\n    }\n\n    /**\n     * Converts this error to a plain ORPCError.\n     * Useful when you need to return from an oRPC handler.\n     */\n    toORPCError(): ORPCError<TCode, InferSchemaOutput<TSchema>> {\n      return this[ORPCErrorSymbol];\n    }\n\n    override toJSON(): ORPCErrorJSON<TCode, InferSchemaOutput<TSchema>> & {\n      _tag: TTag;\n    } {\n      return {\n        _tag: this._tag,\n        defined: this[ORPCErrorSymbol].defined,\n        code: this[ORPCErrorSymbol].code,\n        status: this[ORPCErrorSymbol].status,\n        message: this[ORPCErrorSymbol].message,\n        data: this[ORPCErrorSymbol].data,\n      };\n    }\n  }\n\n  return Object.assign(ORPCTaggedErrorBase, {\n    _tag: tag,\n    code,\n  } as const);\n}\n\n/**\n * Converts an ORPCTaggedError to a plain ORPCError.\n * Useful in handlers that need to throw ORPCError.\n *\n * @example\n * ```ts\n * const handler = effectOs.effect(function* () {\n *   const result = yield* someOperation.pipe(\n *     Effect.catchTag('UserNotFoundError', (e) =>\n *       Effect.fail(toORPCError(e))\n *     )\n *   )\n *   return result\n * })\n * ```\n */\nexport function toORPCError<\n  TCode extends ORPCErrorCode,\n  TSchema extends AnySchema = AnySchema,\n>(\n  error: ORPCTaggedErrorInstance<string, TCode, TSchema>,\n): ORPCError<TCode, InferSchemaOutput<TSchema>> {\n  return error[ORPCErrorSymbol];\n}\n\n// ============================================================================\n// Extended Error Map Types for Effect\n// ============================================================================\n\n/**\n * An item in the EffectErrorMap - can be either a traditional ErrorMapItem or an ORPCTaggedErrorClass\n */\nexport type EffectErrorMapItem =\n  | ErrorMapItem<AnySchema>\n  | AnyORPCTaggedErrorClass;\n\nexport type ORPCTaggedErrorClassToErrorMapItem<T> =\n  T extends ORPCTaggedErrorClass<any, any, infer TData>\n    ? {\n        status?: number;\n        message?: string;\n        data?: TData;\n      }\n    : never;\n\n/**\n * Extended error map that supports both traditional oRPC errors and ORPCTaggedError classes.\n *\n * @example\n * ```ts\n * const errorMap = {\n *   // Traditional format\n *   BAD_REQUEST: { status: 400, message: 'Bad request' },\n *\n *   // Tagged error class reference\n *   USER_NOT_FOUND: UserNotFoundError,\n * } satisfies EffectErrorMap\n * ```\n */\nexport type EffectErrorMap = {\n  [key in ORPCErrorCode]?: EffectErrorMapItem;\n};\n\n/**\n * Merges two EffectErrorMaps, with the second map taking precedence.\n */\nexport type MergedEffectErrorMap<\n  T1 extends EffectErrorMap,\n  T2 extends EffectErrorMap,\n> = Omit<T1, keyof T2> & T2;\n\n/**\n * Extracts the instance type from an EffectErrorMapItem\n */\nexport type EffectErrorMapItemToInstance<\n  TCode extends ORPCErrorCode,\n  T extends EffectErrorMapItem,\n> = T extends AnyORPCTaggedErrorClass\n  ? InstanceType<T>\n  : T extends { data?: infer TData }\n    ? ORPCError<TCode, TData>\n    : ORPCError<TCode, unknown>;\n\n/**\n * Converts an EffectErrorMap to a union of error instances.\n */\nexport type EffectErrorMapToUnion<T extends EffectErrorMap> = {\n  [K in keyof T]: K extends ORPCErrorCode\n    ? T[K] extends EffectErrorMapItem\n      ? EffectErrorMapItemToInstance<K, T[K]>\n      : never\n    : never;\n}[keyof T];\n\n/**\n * Constructor map for EffectErrorMap - provides typed error constructors for handlers.\n */\nexport type EffectErrorConstructorMap<T extends EffectErrorMap> =\n  ORPCErrorConstructorMap<EffectErrorMapToErrorMap<T>>;\n\n/**\n * Creates an error constructor map from an EffectErrorMap.\n * Tagged error classes are passed through directly.\n * Traditional error items become ORPCError factory functions.\n */\nexport function createEffectErrorConstructorMap<T extends EffectErrorMap>(\n  errors: T | undefined,\n): EffectErrorConstructorMap<T> {\n  const target = errors ?? ({} as T);\n  const proxy = new Proxy(target, {\n    get(proxyTarget, code) {\n      if (typeof code !== \"string\") {\n        return Reflect.get(proxyTarget, code);\n      }\n\n      const config = target[code];\n\n      // If it's a tagged error class, create a class constructor function\n      if (isORPCTaggedErrorClass(config)) {\n        return (\n          ...opts: MaybeOptionalOptions<ORPCTaggedErrorOptions<unknown>>\n        ) => new config(...opts);\n      }\n\n      // Otherwise, create a factory function for ORPCError\n      return (\n        ...rest: MaybeOptionalOptions<\n          Omit<ORPCErrorOptions<unknown>, \"defined\" | \"status\">\n        >\n      ) => {\n        const options = resolveMaybeOptionalOptions(rest);\n        return new ORPCError(code, {\n          defined: Boolean(config),\n          status: config?.status,\n          message: options.message ?? config?.message,\n          data: options.data,\n          cause: options.cause,\n        });\n      };\n    },\n  });\n\n  return proxy as EffectErrorConstructorMap<T>;\n}\n\n/**\n * Converts an EffectErrorMap to a standard oRPC ErrorMap for interop.\n * Tagged error classes are converted to their equivalent ErrorMapItem format.\n */\nexport function effectErrorMapToErrorMap<T extends EffectErrorMap>(\n  errorMap: T | undefined,\n): EffectErrorMapToErrorMap<T> {\n  const result: ErrorMap = {};\n\n  if (!errorMap) {\n    return result as ErrorMap & EffectErrorMapToErrorMap<T>;\n  }\n\n  for (const [code, ClassOrErrorItem] of Object.entries(errorMap)) {\n    if (!ClassOrErrorItem) {\n      continue;\n    }\n\n    if (isORPCTaggedErrorClass(ClassOrErrorItem)) {\n      const classInstance = new ClassOrErrorItem();\n      result[classInstance.code] = {\n        status: classInstance.status,\n        message: classInstance.message,\n        data: classInstance.schema,\n      };\n    } else {\n      result[code] = ClassOrErrorItem;\n    }\n  }\n\n  return result as ErrorMap & EffectErrorMapToErrorMap<T>;\n}\n"],"mappings":"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","names":["mergeMeta","mergePrefix","mergeRoute","ORPCError","addMiddleware","decorateMiddleware","lazy","Cause","enhanced","decorateMiddleware","addMiddleware","mergeMeta","mergeRoute","Cause","ORPCError","mergePrefix","lazy"]}
+{"version":3,"sources":["../src/effect-builder.ts","../src/effect-enhance-router.ts","../src/effect-procedure.ts","../src/tagged-error.ts"],"sourcesContent":["import type {\n  AnySchema,\n  ContractRouter,\n  ErrorMap,\n  HTTPPath,\n  InferSchemaOutput,\n  Meta,\n  Route,\n  Schema,\n} from \"@orpc/contract\";\nimport type {\n  AnyMiddleware,\n  BuilderConfig,\n  BuilderDef,\n  Context,\n  Lazy,\n  MapInputMiddleware,\n  MergedCurrentContext,\n  MergedInitialContext,\n  Middleware,\n  ProcedureHandler,\n  ProcedureHandlerOptions,\n  Router,\n} from \"@orpc/server\";\nimport type { IntersectPick } from \"@orpc/shared\";\nimport type { ManagedRuntime } from \"effect\";\n\nimport {\n  mergeMeta,\n  mergePrefix,\n  mergeRoute,\n  mergeTags,\n  ORPCError,\n} from \"@orpc/contract\";\nimport {\n  addMiddleware,\n  Builder,\n  decorateMiddleware,\n  fallbackConfig,\n  lazy,\n} from \"@orpc/server\";\nimport { Cause, Effect, Exit, FiberRefs } from \"effect\";\n\nimport type {\n  EffectErrorConstructorMap,\n  EffectErrorMap,\n  MergedEffectErrorMap,\n} from \"./tagged-error\";\nimport type {\n  AnyBuilderLike,\n  EffectBuilderDef,\n  EffectErrorMapToErrorMap,\n  EffectProcedureBuilderWithInput,\n  EffectProcedureBuilderWithOutput,\n  EffectProcedureHandler,\n  EffectRouterBuilder,\n  EnhancedEffectRouter,\n  InferBuilderCurrentContext,\n  InferBuilderErrorMap,\n  InferBuilderInitialContext,\n  InferBuilderInputSchema,\n  InferBuilderMeta,\n  InferBuilderOutputSchema,\n} from \"./types\";\n\nimport { enhanceEffectRouter } from \"./effect-enhance-router\";\nimport { EffectDecoratedProcedure } from \"./effect-procedure\";\nimport { getCurrentFiberRefs } from \"./fiber-context-bridge\";\nimport {\n  createEffectErrorConstructorMap,\n  effectErrorMapToErrorMap,\n  isORPCTaggedError,\n} from \"./tagged-error\";\n\n/**\n * Captures the stack trace at the call site for better error reporting in spans.\n * This is called at procedure definition time to capture where the procedure was defined.\n *\n * @returns A function that lazily extracts the relevant stack frame\n */\nexport function addSpanStackTrace(): () => string | undefined {\n  const ErrorConstructor = Error as typeof Error & {\n    stackTraceLimit?: number;\n  };\n  const limit = ErrorConstructor.stackTraceLimit;\n  ErrorConstructor.stackTraceLimit = 3;\n  const traceError = new Error();\n  ErrorConstructor.stackTraceLimit = limit;\n  let cache: false | string = false;\n  return () => {\n    if (cache !== false) {\n      return cache;\n    }\n    if (traceError.stack !== undefined) {\n      const stack = traceError.stack.split(\"\\n\");\n      if (stack[3] !== undefined) {\n        cache = stack[3].trim();\n        return cache;\n      }\n    }\n  };\n}\n\n/**\n * Effect-native procedure builder that wraps an oRPC Builder instance\n * and adds Effect-specific capabilities while preserving Effect error\n * and requirements types.\n */\nexport class EffectBuilder<\n  TInitialContext extends Context,\n  TCurrentContext extends Context,\n  TInputSchema extends AnySchema,\n  TOutputSchema extends AnySchema,\n  TEffectErrorMap extends EffectErrorMap,\n  TMeta extends Meta,\n  TRequirementsProvided,\n  TRuntimeError,\n> {\n  /**\n   * This property holds the defined options and the effect-specific properties.\n   */\n  declare \"~effect\": EffectBuilderDef<\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n  declare \"~orpc\": BuilderDef<\n    TInputSchema,\n    TOutputSchema,\n    EffectErrorMapToErrorMap<TEffectErrorMap>,\n    TMeta\n  >;\n\n  constructor(\n    def: EffectBuilderDef<\n      TInputSchema,\n      TOutputSchema,\n      TEffectErrorMap,\n      TMeta,\n      TRequirementsProvided,\n      TRuntimeError\n    >,\n  ) {\n    const { runtime, spanConfig, effectErrorMap, ...orpcDef } = def;\n    this[\"~orpc\"] = orpcDef;\n    this[\"~effect\"] = { runtime, spanConfig, effectErrorMap, ...orpcDef };\n  }\n\n  /**\n   * Sets or overrides the config.\n   *\n   * @see {@link https://orpc.dev/docs/client/server-side#middlewares-order Middlewares Order Docs}\n   * @see {@link https://orpc.dev/docs/best-practices/dedupe-middleware#configuration Dedupe Middleware Docs}\n   */\n  $config(\n    config: BuilderConfig,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    const inputValidationCount =\n      this[\"~effect\"].inputValidationIndex -\n      fallbackConfig(\n        \"initialInputValidationIndex\",\n        this[\"~effect\"].config.initialInputValidationIndex,\n      );\n    const outputValidationCount =\n      this[\"~effect\"].outputValidationIndex -\n      fallbackConfig(\n        \"initialOutputValidationIndex\",\n        this[\"~effect\"].config.initialOutputValidationIndex,\n      );\n\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      config,\n      dedupeLeadingMiddlewares: fallbackConfig(\n        \"dedupeLeadingMiddlewares\",\n        config.dedupeLeadingMiddlewares,\n      ),\n      inputValidationIndex:\n        fallbackConfig(\n          \"initialInputValidationIndex\",\n          config.initialInputValidationIndex,\n        ) + inputValidationCount,\n      outputValidationIndex:\n        fallbackConfig(\n          \"initialOutputValidationIndex\",\n          config.initialOutputValidationIndex,\n        ) + outputValidationCount,\n    });\n  }\n\n  /**\n   * Set or override the initial context.\n   *\n   * @see {@link https://orpc.dev/docs/context Context Docs}\n   */\n  $context<U extends Context>(): EffectBuilder<\n    U & Record<never, never>,\n    U,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    /**\n     * We need `& Record<never, never>` to deal with `has no properties in common with type` error\n     */\n\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      middlewares: [],\n      inputValidationIndex: fallbackConfig(\n        \"initialInputValidationIndex\",\n        this[\"~effect\"].config.initialInputValidationIndex,\n      ),\n      outputValidationIndex: fallbackConfig(\n        \"initialOutputValidationIndex\",\n        this[\"~effect\"].config.initialOutputValidationIndex,\n      ),\n    });\n  }\n\n  /**\n   * Sets or overrides the initial meta.\n   *\n   * @see {@link https://orpc.dev/docs/metadata Metadata Docs}\n   */\n  $meta<U extends Meta>(\n    initialMeta: U,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    U & Record<never, never>,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    /**\n     * We need `& Record<never, never>` to deal with `has no properties in common with type` error\n     */\n\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      meta: initialMeta,\n    });\n  }\n\n  /**\n   * Sets or overrides the initial route.\n   * This option is typically relevant when integrating with OpenAPI.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}\n   * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}\n   */\n  $route(\n    initialRoute: Route,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      route: initialRoute,\n    });\n  }\n\n  /**\n   * Sets or overrides the initial input schema.\n   *\n   * @see {@link https://orpc.dev/docs/procedure#initial-configuration Initial Procedure Configuration Docs}\n   */\n  $input<U extends AnySchema>(\n    initialInputSchema?: U,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    U,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      inputSchema: initialInputSchema,\n    });\n  }\n\n  /**\n   * Adds type-safe custom errors.\n   * Supports both traditional oRPC error definitions and ORPCTaggedError classes.\n   *\n   * @example\n   * ```ts\n   * // Traditional format\n   * builder.errors({ BAD_REQUEST: { status: 400, message: 'Bad request' } })\n   *\n   * // Tagged error class\n   * builder.errors({ USER_NOT_FOUND: UserNotFoundError })\n   *\n   * // Mixed\n   * builder.errors({\n   *   BAD_REQUEST: { status: 400 },\n   *   USER_NOT_FOUND: UserNotFoundError,\n   * })\n   * ```\n   *\n   * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}\n   */\n  errors<U extends EffectErrorMap>(\n    errors: U,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    MergedEffectErrorMap<TEffectErrorMap, U>,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    const newEffectErrorMap: MergedEffectErrorMap<TEffectErrorMap, U> = {\n      ...this[\"~effect\"].effectErrorMap,\n      ...errors,\n    };\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      errorMap: effectErrorMapToErrorMap(newEffectErrorMap),\n      effectErrorMap: newEffectErrorMap,\n    });\n  }\n\n  /**\n   * Uses a middleware to modify the context or improve the pipeline.\n   *\n   * @info Supports both normal middleware and inline middleware implementations.\n   * @note The current context must be satisfy middleware dependent-context\n   * @see {@link https://orpc.dev/docs/middleware Middleware Docs}\n   */\n  use<\n    UOutContext extends IntersectPick<TCurrentContext, UOutContext>,\n    UInContext extends Context = TCurrentContext,\n  >(\n    middleware: Middleware<\n      UInContext | TCurrentContext,\n      UOutContext,\n      InferSchemaOutput<TInputSchema>,\n      unknown,\n      EffectErrorConstructorMap<TEffectErrorMap>,\n      TMeta\n    >,\n  ): EffectBuilder<\n    MergedInitialContext<TInitialContext, UInContext, TCurrentContext>,\n    MergedCurrentContext<TCurrentContext, UOutContext>,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n\n  use(\n    middleware: AnyMiddleware,\n    mapInput?: MapInputMiddleware<any, any>,\n  ): EffectBuilder<any, any, any, any, any, any, any, any> {\n    const mapped = mapInput\n      ? decorateMiddleware(middleware).mapInput(mapInput)\n      : middleware;\n\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      middlewares: addMiddleware(this[\"~effect\"].middlewares, mapped),\n    });\n  }\n\n  /**\n   * Sets or updates the metadata.\n   * The provided metadata is spared-merged with any existing metadata.\n   *\n   * @see {@link https://orpc.dev/docs/metadata Metadata Docs}\n   */\n  meta(\n    meta: TMeta,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      meta: mergeMeta(this[\"~effect\"].meta, meta),\n    });\n  }\n\n  /**\n   * Sets or updates the route definition.\n   * The provided route is spared-merged with any existing route.\n   * This option is typically relevant when integrating with OpenAPI.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}\n   * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}\n   */\n  route(\n    route: Route,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      route: mergeRoute(this[\"~effect\"].route, route),\n    });\n  }\n\n  /**\n   * Defines the input validation schema.\n   *\n   * @see {@link https://orpc.dev/docs/procedure#input-output-validation Input Validation Docs}\n   */\n  input<USchema extends AnySchema>(\n    schema: USchema,\n  ): EffectProcedureBuilderWithInput<\n    TInitialContext,\n    TCurrentContext,\n    USchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      inputSchema: schema,\n      inputValidationIndex:\n        fallbackConfig(\n          \"initialInputValidationIndex\",\n          this[\"~effect\"].config.initialInputValidationIndex,\n        ) + this[\"~effect\"].middlewares.length,\n      // we cast to any because EffectProcedureBuilderWithInput is expecting\n      // use() input type to be defined, and EffectBuilder types its use() input\n      // to unknown to allow any middleware to be passed\n      // ---\n      // note: the original implentation of the builder also uses any for the same reason\n    }) as any;\n  }\n\n  /**\n   * Defines the output validation schema.\n   *\n   * @see {@link https://orpc.dev/docs/procedure#input-output-validation Output Validation Docs}\n   */\n  output<USchema extends AnySchema>(\n    schema: USchema,\n  ): EffectProcedureBuilderWithOutput<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    USchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    // We cast to any because EffectProcedureBuilderWithOutput narrows\n    // handler/effect output typing based on the declared output schema.\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      outputSchema: schema,\n      outputValidationIndex:\n        fallbackConfig(\n          \"initialOutputValidationIndex\",\n          this[\"~effect\"].config.initialOutputValidationIndex,\n        ) + this[\"~effect\"].middlewares.length,\n    }) as any;\n  }\n\n  /**\n   * Adds a traceable span to the procedure for telemetry.\n   * The span name is used for Effect tracing via `Effect.withSpan`.\n   * Stack trace is captured at the call site for better error reporting.\n   *\n   * @param spanName - The name of the span for telemetry (e.g., 'users.getUser')\n   * @returns An EffectBuilder with span tracing configured\n   *\n   * @example\n   * ```ts\n   * const getUser = effectOs\n   *   .input(z.object({ id: z.string() }))\n   *   .traced('users.getUser')\n   *   .effect(function* ({ input }) {\n   *     const userService = yield* UserService\n   *     return yield* userService.findById(input.id)\n   *   })\n   * ```\n   */\n  traced(\n    spanName: string,\n  ): EffectBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      spanConfig: {\n        name: spanName,\n        captureStackTrace: addSpanStackTrace(),\n      },\n    });\n  }\n\n  handler<UFuncOutput>(\n    handler: ProcedureHandler<\n      TCurrentContext,\n      InferSchemaOutput<TInputSchema>,\n      UFuncOutput,\n      EffectErrorMapToErrorMap<TEffectErrorMap>,\n      TMeta\n    >,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    Schema<UFuncOutput, UFuncOutput>,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      handler,\n    });\n  }\n\n  /**\n   * Defines the handler of the procedure using an Effect.\n   * The Effect is executed using the ManagedRuntime provided during builder creation.\n   * The effect is automatically wrapped with `Effect.withSpan`.\n   *\n   * @see {@link https://orpc.dev/docs/procedure Procedure Docs}\n   */\n  effect<UFuncOutput>(\n    effectFn: EffectProcedureHandler<\n      TCurrentContext,\n      TInputSchema,\n      UFuncOutput,\n      TEffectErrorMap,\n      TRequirementsProvided,\n      TMeta\n    >,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    Schema<UFuncOutput, UFuncOutput>,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    const { runtime, spanConfig } = this[\"~effect\"];\n    // Capture stack trace at definition time for default tracing\n    const defaultCaptureStackTrace = addSpanStackTrace();\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      handler: async (opts) => {\n        const effectOpts: ProcedureHandlerOptions<\n          TCurrentContext,\n          InferSchemaOutput<TInputSchema>,\n          EffectErrorConstructorMap<TEffectErrorMap>,\n          TMeta\n        > = {\n          context: opts.context,\n          input: opts.input,\n          path: opts.path,\n          procedure: opts.procedure,\n          signal: opts.signal,\n          lastEventId: opts.lastEventId,\n          errors: createEffectErrorConstructorMap(\n            this[\"~effect\"].effectErrorMap,\n          ),\n        };\n        const spanName = spanConfig?.name ?? opts.path.join(\".\");\n        const captureStackTrace =\n          spanConfig?.captureStackTrace ?? defaultCaptureStackTrace;\n        const resolver = Effect.fnUntraced(effectFn);\n        const tracedEffect = Effect.withSpan(resolver(effectOpts), spanName, {\n          captureStackTrace,\n        });\n        const parentFiberRefs = getCurrentFiberRefs();\n        const effectWithRefs = parentFiberRefs\n          ? Effect.fiberIdWith((fiberId) =>\n              Effect.flatMap(Effect.getFiberRefs, (fiberRefs) =>\n                Effect.setFiberRefs(\n                  FiberRefs.joinAs(fiberRefs, fiberId, parentFiberRefs),\n                ).pipe(Effect.andThen(tracedEffect)),\n              ),\n            )\n          : tracedEffect;\n        const exit = await runtime.runPromiseExit(effectWithRefs, {\n          signal: opts.signal,\n        });\n\n        if (Exit.isFailure(exit)) {\n          throw Cause.match(exit.cause, {\n            onDie(defect) {\n              return new ORPCError(\"INTERNAL_SERVER_ERROR\", {\n                cause: defect,\n              });\n            },\n            onFail(error) {\n              if (isORPCTaggedError(error)) {\n                return error.toORPCError();\n              }\n              if (error instanceof ORPCError) {\n                return error;\n              }\n              return new ORPCError(\"INTERNAL_SERVER_ERROR\", {\n                cause: error,\n              });\n            },\n            onInterrupt(fiberId) {\n              return new ORPCError(\"INTERNAL_SERVER_ERROR\", {\n                cause: new Error(`${fiberId} Interrupted`),\n              });\n            },\n            onSequential(left) {\n              return left;\n            },\n            onEmpty: new ORPCError(\"INTERNAL_SERVER_ERROR\", {\n              cause: new Error(\"Unknown error\"),\n            }),\n            onParallel(left) {\n              return left;\n            },\n          });\n        }\n\n        return exit.value;\n      },\n    });\n  }\n\n  /**\n   * Prefixes all procedures in the router.\n   * The provided prefix is post-appended to any existing router prefix.\n   *\n   * @note This option does not affect procedures that do not define a path in their route definition.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/routing#route-prefixes OpenAPI Route Prefixes Docs}\n   */\n  prefix(\n    prefix: HTTPPath,\n  ): EffectRouterBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      prefix: mergePrefix(this[\"~effect\"].prefix, prefix),\n    }) as any;\n  }\n\n  /**\n   * Adds tags to all procedures in the router.\n   * This helpful when you want to group procedures together in the OpenAPI specification.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}\n   */\n  tag(\n    ...tags: string[]\n  ): EffectRouterBuilder<\n    TInitialContext,\n    TCurrentContext,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectBuilder({\n      ...this[\"~effect\"],\n      tags: mergeTags(this[\"~effect\"].tags, tags),\n    }) as any;\n  }\n\n  /**\n   * Applies all of the previously defined options to the specified router.\n   *\n   * @see {@link https://orpc.dev/docs/router#extending-router Extending Router Docs}\n   */\n  router<U extends Router<ContractRouter<TMeta>, TCurrentContext>>(\n    router: U,\n  ): EnhancedEffectRouter<\n    U,\n    TInitialContext,\n    TCurrentContext,\n    TEffectErrorMap\n  > {\n    return enhanceEffectRouter(router, {\n      ...this[\"~effect\"],\n    }) as any; // Type instantiation is excessively deep and possibly infinite\n  }\n\n  /**\n   * Create a lazy router\n   * And applies all of the previously defined options to the specified router.\n   *\n   * @see {@link https://orpc.dev/docs/router#extending-router Extending Router Docs}\n   */\n  lazy<U extends Router<ContractRouter<TMeta>, TCurrentContext>>(\n    loader: () => Promise<{ default: U }>,\n  ): EnhancedEffectRouter<\n    Lazy<U>,\n    TInitialContext,\n    TCurrentContext,\n    TEffectErrorMap\n  > {\n    return enhanceEffectRouter(lazy(loader), {\n      ...this[\"~effect\"],\n    }) as any; // Type instantiation is excessively deep and possibly infinite\n  }\n}\n\n/**\n * Creates an Effect-aware procedure builder with the specified ManagedRuntime.\n * Uses the default `os` builder from `@orpc/server`.\n *\n * @param runtime - The ManagedRuntime that provides services for Effect procedures\n * @returns An EffectBuilder instance for creating Effect-native procedures\n *\n * @example\n * ```ts\n * import { makeEffectORPC } from '@orpc/effect'\n * import { Effect, Layer, ManagedRuntime } from 'effect'\n *\n * const runtime = ManagedRuntime.make(Layer.empty)\n * const effectOs = makeEffectORPC(runtime)\n *\n * const hello = effectOs.effect(() => Effect.succeed('Hello!'))\n * ```\n */\nexport function makeEffectORPC<TRequirementsProvided, TRuntimeError>(\n  runtime: ManagedRuntime.ManagedRuntime<TRequirementsProvided, TRuntimeError>,\n): EffectBuilder<\n  Context,\n  Context,\n  Schema<unknown, unknown>,\n  Schema<unknown, unknown>,\n  Record<never, never>,\n  Record<never, never>,\n  TRequirementsProvided,\n  TRuntimeError\n>;\n\n/**\n * Creates an Effect-aware procedure builder by wrapping an existing oRPC Builder\n * with the specified ManagedRuntime.\n *\n * @param runtime - The ManagedRuntime that provides services for Effect procedures\n * @param builder - The oRPC Builder instance to wrap (e.g., a customized `os`)\n * @returns An EffectBuilder instance that extends the original builder with Effect support\n *\n * @example\n * ```ts\n * import { makeEffectORPC } from '@orpc/effect'\n * import { os } from '@orpc/server'\n * import { Effect, Layer, ManagedRuntime } from 'effect'\n *\n * // Create a customized builder\n * const authedOs = os.use(authMiddleware)\n *\n * // Wrap it with Effect support\n * const runtime = ManagedRuntime.make(UserServiceLive)\n * const effectOs = makeEffectORPC(runtime, authedOs)\n *\n * const getUser = effectOs\n *   .input(z.object({ id: z.string() }))\n *   .effect(\n *     Effect.fn(function* ({ input }) {\n *       const userService = yield* UserService\n *       return yield* userService.findById(input.id)\n *     })\n *   )\n * ```\n */\nexport function makeEffectORPC<\n  TBuilder extends AnyBuilderLike<\n    TInputSchema,\n    TOutputSchema,\n    TErrorMap,\n    TMeta\n  >,\n  TInputSchema extends AnySchema,\n  TOutputSchema extends AnySchema,\n  TErrorMap extends ErrorMap,\n  TMeta extends Meta,\n  TRequirementsProvided,\n  TRuntimeError,\n>(\n  runtime: ManagedRuntime.ManagedRuntime<TRequirementsProvided, TRuntimeError>,\n  builder: TBuilder,\n): EffectBuilder<\n  InferBuilderInitialContext<TBuilder>,\n  InferBuilderCurrentContext<TBuilder>,\n  InferBuilderInputSchema<TBuilder>,\n  InferBuilderOutputSchema<TBuilder>,\n  InferBuilderErrorMap<TBuilder>,\n  InferBuilderMeta<TBuilder>,\n  TRequirementsProvided,\n  TRuntimeError\n>;\n\nexport function makeEffectORPC<TRequirementsProvided, TRuntimeError>(\n  runtime: ManagedRuntime.ManagedRuntime<TRequirementsProvided, TRuntimeError>,\n  builder?: AnyBuilderLike,\n): EffectBuilder<\n  any,\n  any,\n  any,\n  any,\n  any,\n  any,\n  TRequirementsProvided,\n  TRuntimeError\n> {\n  const resolvedBuilder = builder ?? emptyBuilder();\n  return new EffectBuilder({\n    ...resolvedBuilder[\"~orpc\"],\n    errorMap: effectErrorMapToErrorMap(resolvedBuilder[\"~orpc\"].errorMap),\n    effectErrorMap: resolvedBuilder[\"~orpc\"].errorMap,\n    runtime,\n  });\n}\n\nfunction emptyBuilder(): AnyBuilderLike {\n  return new Builder({\n    config: {},\n    route: {},\n    meta: {},\n    errorMap: {},\n    inputValidationIndex: fallbackConfig(\"initialInputValidationIndex\"),\n    outputValidationIndex: fallbackConfig(\"initialOutputValidationIndex\"),\n    middlewares: [],\n    dedupeLeadingMiddlewares: true,\n  });\n}\n","import type { ManagedRuntime } from \"effect/ManagedRuntime\";\n\nimport {\n  enhanceRoute,\n  mergePrefix,\n  type EnhanceRouteOptions,\n} from \"@orpc/contract\";\nimport {\n  createAccessibleLazyRouter,\n  getLazyMeta,\n  isLazy,\n  isProcedure,\n  lazy,\n  mergeMiddlewares,\n  unlazy,\n  type AnyMiddleware,\n  type AnyRouter,\n  type Context,\n  type Lazyable,\n} from \"@orpc/server\";\n\nimport type { EffectErrorMapToErrorMap, EnhancedEffectRouter } from \"./types\";\n\nimport { EffectProcedure } from \"./effect-procedure\";\nimport { effectErrorMapToErrorMap, type EffectErrorMap } from \"./tagged-error\";\n\ninterface EnhanceEffectRouterOptions<\n  TEffectErrorMap extends EffectErrorMap,\n  TRequirementsProvided,\n  TRuntimeError,\n> extends EnhanceRouteOptions {\n  middlewares: readonly AnyMiddleware[];\n  errorMap: TEffectErrorMap;\n  dedupeLeadingMiddlewares: boolean;\n  runtime: ManagedRuntime<TRequirementsProvided, TRuntimeError>;\n}\n\nexport function enhanceEffectRouter<\n  T extends Lazyable<AnyRouter>,\n  TInitialContext extends Context,\n  TCurrentContext extends Context,\n  TEffectErrorMap extends EffectErrorMap,\n  TRequirementsProvided,\n  TRuntimeError,\n>(\n  router: T,\n  options: EnhanceEffectRouterOptions<\n    TEffectErrorMap,\n    TRequirementsProvided,\n    TRuntimeError\n  >,\n): EnhancedEffectRouter<T, TInitialContext, TCurrentContext, TEffectErrorMap> {\n  if (isLazy(router)) {\n    const laziedMeta = getLazyMeta(router);\n    const enhancedPrefix = laziedMeta?.prefix\n      ? mergePrefix(options.prefix, laziedMeta?.prefix)\n      : options.prefix;\n\n    const enhanced = lazy(\n      async () => {\n        const { default: unlaziedRouter } = await unlazy(router);\n        const enhanced = enhanceEffectRouter(unlaziedRouter, options);\n        return unlazy(enhanced);\n      },\n      {\n        ...laziedMeta,\n        prefix: enhancedPrefix,\n      },\n    );\n\n    const accessible = createAccessibleLazyRouter(enhanced);\n\n    return accessible as any;\n  }\n\n  if (isProcedure(router)) {\n    const newMiddlewares = mergeMiddlewares(\n      options.middlewares,\n      router[\"~orpc\"].middlewares,\n      { dedupeLeading: options.dedupeLeadingMiddlewares },\n    );\n    const newMiddlewareAdded =\n      newMiddlewares.length - router[\"~orpc\"].middlewares.length;\n\n    const effectErrorMap = {\n      ...options.errorMap,\n      ...router[\"~orpc\"].errorMap,\n    };\n    const errorMap: EffectErrorMapToErrorMap<typeof effectErrorMap> =\n      effectErrorMapToErrorMap(effectErrorMap);\n    const enhanced = new EffectProcedure({\n      ...router[\"~orpc\"],\n      route: enhanceRoute(router[\"~orpc\"].route, options),\n      effectErrorMap,\n      errorMap: errorMap as EffectErrorMapToErrorMap<typeof effectErrorMap>,\n      middlewares: newMiddlewares,\n      inputValidationIndex:\n        router[\"~orpc\"].inputValidationIndex + newMiddlewareAdded,\n      outputValidationIndex:\n        router[\"~orpc\"].outputValidationIndex + newMiddlewareAdded,\n      runtime: options.runtime,\n    });\n\n    return enhanced as any;\n  }\n\n  const enhanced = {} as Record<string, any>;\n\n  for (const key in router) {\n    enhanced[key] = enhanceEffectRouter(router[key]!, options);\n  }\n\n  return enhanced as any;\n}\n","import type { ClientContext } from \"@orpc/client\";\nimport type {\n  AnySchema,\n  InferSchemaInput,\n  InferSchemaOutput,\n  Meta,\n  Route,\n} from \"@orpc/contract\";\nimport type {\n  AnyMiddleware,\n  Context,\n  CreateProcedureClientOptions,\n  MapInputMiddleware,\n  MergedCurrentContext,\n  MergedInitialContext,\n  Middleware,\n  ProcedureActionableClient,\n  ProcedureClient,\n  ProcedureDef,\n} from \"@orpc/server\";\nimport type { IntersectPick, MaybeOptionalOptions } from \"@orpc/shared\";\n\nimport { mergeMeta, mergeRoute } from \"@orpc/contract\";\nimport {\n  addMiddleware,\n  createActionableClient,\n  createProcedureClient,\n  decorateMiddleware,\n  Procedure,\n} from \"@orpc/server\";\n\nimport type {\n  EffectErrorConstructorMap,\n  EffectErrorMap,\n  MergedEffectErrorMap,\n} from \"./tagged-error\";\nimport type { EffectErrorMapToErrorMap, EffectProcedureDef } from \"./types\";\n\nimport { effectErrorMapToErrorMap } from \"./tagged-error\";\n\nexport class EffectProcedure<\n  TInitialContext extends Context,\n  TCurrentContext extends Context,\n  TInputSchema extends AnySchema,\n  TOutputSchema extends AnySchema,\n  TEffectErrorMap extends EffectErrorMap,\n  TMeta extends Meta,\n  TRequirementsProvided,\n  TRuntimeError,\n> extends Procedure<\n  TInitialContext,\n  TCurrentContext,\n  TInputSchema,\n  TOutputSchema,\n  EffectErrorMapToErrorMap<TEffectErrorMap>,\n  TMeta\n> {\n  /**\n   * This property holds the defined options and the effect-specific properties.\n   */\n  declare \"~effect\": EffectProcedureDef<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n  /**\n   * This property holds the defined options.\n   */\n  declare \"~orpc\": ProcedureDef<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    EffectErrorMapToErrorMap<TEffectErrorMap>,\n    TMeta\n  >;\n\n  constructor(\n    def: EffectProcedureDef<\n      TInitialContext,\n      TCurrentContext,\n      TInputSchema,\n      TOutputSchema,\n      TEffectErrorMap,\n      TMeta,\n      TRequirementsProvided,\n      TRuntimeError\n    >,\n  ) {\n    super(def);\n    this[\"~effect\"] = def;\n  }\n}\n\n/**\n * An Effect-native decorated procedure that preserves Effect error and requirements types.\n *\n * This class extends Procedure with additional type parameters for Effect-specific\n * type information, allowing full type inference of Effect errors and requirements.\n */\nexport class EffectDecoratedProcedure<\n  TInitialContext extends Context,\n  TCurrentContext extends Context,\n  TInputSchema extends AnySchema,\n  TOutputSchema extends AnySchema,\n  TEffectErrorMap extends EffectErrorMap,\n  TMeta extends Meta,\n  TRequirementsProvided,\n  TRuntimeError,\n> extends EffectProcedure<\n  TInitialContext,\n  TCurrentContext,\n  TInputSchema,\n  TOutputSchema,\n  TEffectErrorMap,\n  TMeta,\n  TRequirementsProvided,\n  TRuntimeError\n> {\n  /**\n   * This property holds the defined options and the effect-specific properties.\n   */\n  declare \"~effect\": EffectProcedureDef<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n  declare \"~orpc\": ProcedureDef<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    EffectErrorMapToErrorMap<TEffectErrorMap>,\n    TMeta\n  >;\n\n  constructor(\n    def: EffectProcedureDef<\n      TInitialContext,\n      TCurrentContext,\n      TInputSchema,\n      TOutputSchema,\n      TEffectErrorMap,\n      TMeta,\n      TRequirementsProvided,\n      TRuntimeError\n    >,\n  ) {\n    super(def);\n    this[\"~effect\"] = def;\n  }\n\n  /**\n   * Adds type-safe custom errors.\n   * Supports both traditional oRPC error definitions and ORPCTaggedError classes.\n   *\n   * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}\n   */\n  errors<U extends EffectErrorMap>(\n    errors: U,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    MergedEffectErrorMap<TEffectErrorMap, U>,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    const newEffectErrorMap: MergedEffectErrorMap<TEffectErrorMap, U> = {\n      ...this[\"~effect\"].effectErrorMap,\n      ...errors,\n    };\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      effectErrorMap: newEffectErrorMap,\n      errorMap: effectErrorMapToErrorMap(newEffectErrorMap),\n    });\n  }\n\n  /**\n   * Sets or updates the metadata.\n   * The provided metadata is spared-merged with any existing metadata.\n   *\n   * @see {@link https://orpc.dev/docs/metadata Metadata Docs}\n   */\n  meta(\n    meta: TMeta,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      meta: mergeMeta(this[\"~effect\"].meta, meta),\n    });\n  }\n\n  /**\n   * Sets or updates the route definition.\n   * The provided route is spared-merged with any existing route.\n   * This option is typically relevant when integrating with OpenAPI.\n   *\n   * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}\n   * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}\n   */\n  route(\n    route: Route,\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > {\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      route: mergeRoute(this[\"~effect\"].route, route),\n    });\n  }\n\n  /**\n   * Uses a middleware to modify the context or improve the pipeline.\n   *\n   * @info Supports both normal middleware and inline middleware implementations.\n   * @info Pass second argument to map the input.\n   * @note The current context must be satisfy middleware dependent-context\n   * @see {@link https://orpc.dev/docs/middleware Middleware Docs}\n   */\n  use<\n    UOutContext extends IntersectPick<TCurrentContext, UOutContext>,\n    UInContext extends Context = TCurrentContext,\n  >(\n    middleware: Middleware<\n      UInContext | TCurrentContext,\n      UOutContext,\n      InferSchemaOutput<TInputSchema>,\n      InferSchemaInput<TOutputSchema>,\n      EffectErrorConstructorMap<TEffectErrorMap>,\n      TMeta\n    >,\n  ): EffectDecoratedProcedure<\n    MergedInitialContext<TInitialContext, UInContext, TCurrentContext>,\n    MergedCurrentContext<TCurrentContext, UOutContext>,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n\n  /**\n   * Uses a middleware to modify the context or improve the pipeline.\n   *\n   * @info Supports both normal middleware and inline middleware implementations.\n   * @info Pass second argument to map the input.\n   * @note The current context must be satisfy middleware dependent-context\n   * @see {@link https://orpc.dev/docs/middleware Middleware Docs}\n   */\n  use<\n    UOutContext extends IntersectPick<TCurrentContext, UOutContext>,\n    UInput,\n    UInContext extends Context = TCurrentContext,\n  >(\n    middleware: Middleware<\n      UInContext | TCurrentContext,\n      UOutContext,\n      UInput,\n      InferSchemaInput<TOutputSchema>,\n      EffectErrorConstructorMap<TEffectErrorMap>,\n      TMeta\n    >,\n    mapInput: MapInputMiddleware<InferSchemaOutput<TInputSchema>, UInput>,\n  ): EffectDecoratedProcedure<\n    MergedInitialContext<TInitialContext, UInContext, TCurrentContext>,\n    MergedCurrentContext<TCurrentContext, UOutContext>,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  >;\n\n  use(\n    middleware: AnyMiddleware,\n    mapInput?: MapInputMiddleware<any, any>,\n  ): EffectDecoratedProcedure<any, any, any, any, any, any, any, any> {\n    const mapped = mapInput\n      ? decorateMiddleware(middleware).mapInput(mapInput)\n      : middleware;\n\n    return new EffectDecoratedProcedure({\n      ...this[\"~effect\"],\n      middlewares: addMiddleware(this[\"~effect\"].middlewares, mapped),\n    });\n  }\n\n  /**\n   * Make this procedure callable (works like a function while still being a procedure).\n   *\n   * @see {@link https://orpc.dev/docs/client/server-side Server-side Client Docs}\n   */\n  callable<TClientContext extends ClientContext>(\n    ...rest: MaybeOptionalOptions<\n      CreateProcedureClientOptions<\n        TInitialContext,\n        TOutputSchema,\n        EffectErrorMapToErrorMap<TEffectErrorMap>,\n        TMeta,\n        TClientContext\n      >\n    >\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > &\n    ProcedureClient<\n      TClientContext,\n      TInputSchema,\n      TOutputSchema,\n      EffectErrorMapToErrorMap<TEffectErrorMap>\n    > {\n    const client: ProcedureClient<\n      TClientContext,\n      TInputSchema,\n      TOutputSchema,\n      EffectErrorMapToErrorMap<TEffectErrorMap>\n    > = createProcedureClient(this, ...rest);\n\n    return new Proxy(client, {\n      get: (target, key) => {\n        return Reflect.has(this, key)\n          ? Reflect.get(this, key)\n          : Reflect.get(target, key);\n      },\n      has: (target, key) => {\n        return Reflect.has(this, key) || Reflect.has(target, key);\n      },\n    }) as any;\n  }\n\n  /**\n   * Make this procedure compatible with server action.\n   *\n   * @see {@link https://orpc.dev/docs/server-action Server Action Docs}\n   */\n  actionable(\n    ...rest: MaybeOptionalOptions<\n      CreateProcedureClientOptions<\n        TInitialContext,\n        TOutputSchema,\n        EffectErrorMapToErrorMap<TEffectErrorMap>,\n        TMeta,\n        Record<never, never>\n      >\n    >\n  ): EffectDecoratedProcedure<\n    TInitialContext,\n    TCurrentContext,\n    TInputSchema,\n    TOutputSchema,\n    TEffectErrorMap,\n    TMeta,\n    TRequirementsProvided,\n    TRuntimeError\n  > &\n    ProcedureActionableClient<\n      TInputSchema,\n      TOutputSchema,\n      EffectErrorMapToErrorMap<TEffectErrorMap>\n    > {\n    const action: ProcedureActionableClient<\n      TInputSchema,\n      TOutputSchema,\n      EffectErrorMapToErrorMap<TEffectErrorMap>\n    > = createActionableClient(createProcedureClient(this, ...rest));\n\n    return new Proxy(action, {\n      get: (target, key) => {\n        return Reflect.has(this, key)\n          ? Reflect.get(this, key)\n          : Reflect.get(target, key);\n      },\n      has: (target, key) => {\n        return Reflect.has(this, key) || Reflect.has(target, key);\n      },\n    }) as any;\n  }\n}\n","import type {\n  ORPCErrorCode,\n  ORPCErrorJSON,\n  ORPCErrorOptions,\n} from \"@orpc/client\";\nimport type {\n  AnySchema,\n  ErrorMap,\n  ErrorMapItem,\n  InferSchemaOutput,\n} from \"@orpc/contract\";\nimport type { ORPCErrorConstructorMap } from \"@orpc/server\";\nimport type { MaybeOptionalOptions } from \"@orpc/shared\";\nimport type { Pipeable } from \"effect\";\n\nimport {\n  fallbackORPCErrorMessage,\n  fallbackORPCErrorStatus,\n  isORPCErrorStatus,\n  ORPCError,\n} from \"@orpc/client\";\nimport { resolveMaybeOptionalOptions } from \"@orpc/shared\";\nimport * as Cause from \"effect/Cause\";\nimport * as Data from \"effect/Data\";\n\nimport type { EffectErrorMapToErrorMap } from \"./types\";\n\n/**\n * Symbol to access the underlying ORPCError instance\n */\nexport const ORPCErrorSymbol: unique symbol = Symbol.for(\n  \"@orpc/effect/ORPCTaggedError\",\n);\n\n/**\n * Instance type for ORPCTaggedError that combines YieldableError with ORPCError properties\n */\nexport interface ORPCTaggedErrorInstance<\n  TTag extends string,\n  TCode extends ORPCErrorCode,\n  TSchema extends AnySchema = AnySchema,\n>\n  extends Cause.YieldableError, Pipeable.Pipeable {\n  readonly _tag: TTag;\n  readonly code: TCode;\n  readonly status: number;\n  readonly schema: TSchema;\n  readonly data: InferSchemaOutput<TSchema>;\n  readonly defined: boolean;\n  readonly [ORPCErrorSymbol]: ORPCError<TCode, InferSchemaOutput<TSchema>>;\n\n  toJSON(): ORPCErrorJSON<TCode, InferSchemaOutput<TSchema>> & { _tag: TTag };\n  toORPCError(): ORPCError<TCode, InferSchemaOutput<TSchema>>;\n}\n\n/**\n * Options for creating an ORPCTaggedError\n */\nexport type ORPCTaggedErrorOptions<TData> = Omit<\n  ORPCErrorOptions<TData>,\n  \"defined\"\n> & { defined?: boolean };\n\n/**\n * Constructor type for ORPCTaggedError classes\n */\nexport interface ORPCTaggedErrorClass<\n  TTag extends string,\n  TCode extends ORPCErrorCode,\n  TSchema extends AnySchema = AnySchema,\n> {\n  readonly _tag: TTag;\n  readonly code: TCode;\n  new (\n    ...args: MaybeOptionalOptions<\n      ORPCTaggedErrorOptions<InferSchemaOutput<TSchema>>\n    >\n  ): ORPCTaggedErrorInstance<TTag, TCode, TSchema>;\n}\n\n/**\n * Type helper to infer the ORPCError type from an ORPCTaggedError\n */\nexport type InferORPCError<T> =\n  T extends ORPCTaggedErrorInstance<string, infer TCode, infer TSchema>\n    ? ORPCError<TCode, InferSchemaOutput<TSchema>>\n    : never;\n\n/**\n * Any ORPCTaggedErrorClass\n * Uses `...args: any[]` for the constructor to accept any tagged error class,\n * regardless of whether TData requires options to be provided.\n */\nexport type AnyORPCTaggedErrorClass = {\n  readonly _tag: string;\n  readonly code: ORPCErrorCode;\n  new (\n    ...args: any[]\n  ): ORPCTaggedErrorInstance<string, ORPCErrorCode, AnySchema>;\n};\n\n/**\n * Check if a value is an ORPCTaggedErrorClass (constructor)\n */\nexport function isORPCTaggedErrorClass(\n  value: unknown,\n): value is AnyORPCTaggedErrorClass {\n  return (\n    typeof value === \"function\" &&\n    \"_tag\" in value &&\n    \"code\" in value &&\n    typeof value._tag === \"string\" &&\n    typeof value.code === \"string\"\n  );\n}\n\n/**\n * Check if a value is an ORPCTaggedError instance\n */\nexport function isORPCTaggedError(\n  value: unknown,\n): value is ORPCTaggedErrorInstance<string, ORPCErrorCode, AnySchema> {\n  return (\n    typeof value === \"object\" && value !== null && ORPCErrorSymbol in value\n  );\n}\n\n/**\n * Converts a PascalCase or camelCase string to CONSTANT_CASE.\n * e.g., \"UserNotFoundError\" -> \"USER_NOT_FOUND_ERROR\"\n */\nfunction toConstantCase<T extends string>(str: T): ToConstantCase<T> {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1_$2\")\n    .replace(/([A-Z])([A-Z][a-z])/g, \"$1_$2\")\n    .toUpperCase() as ToConstantCase<T>;\n}\n/**\n * Checks if a character is an uppercase letter (A-Z)\n */\ntype IsUpperLetter<C extends string> =\n  C extends Uppercase<C>\n    ? C extends Lowercase<C>\n      ? false // Not a letter (number, special char)\n      : true\n    : false;\n\n/**\n * Checks if a character is a lowercase letter (a-z)\n */\ntype IsLowerLetter<C extends string> =\n  C extends Lowercase<C>\n    ? C extends Uppercase<C>\n      ? false // Not a letter (number, special char)\n      : true\n    : false;\n\n/**\n * Converts PascalCase or camelCase to CONSTANT_CASE.\n * Handles consecutive uppercase letters correctly.\n *\n * @example\n * type T1 = ToConstantCase<\"ABCCode\">; // \"ABC_CODE\"\n * type T2 = ToConstantCase<\"UserCode\">; // \"USER_CODE\"\n * type T3 = ToConstantCase<\"XMLHttpRequest\">; // \"XML_HTTP_REQUEST\"\n */\ntype ToConstantCase<\n  S extends string,\n  Acc extends string = \"\",\n  PrevChar extends string = \"\",\n  InUpperSequence extends boolean = false,\n> = S extends `${infer Head}${infer Tail}`\n  ? IsUpperLetter<Head> extends true\n    ? Acc extends \"\"\n      ? // First character - no underscore\n        ToConstantCase<Tail, Head, Head, false>\n      : PrevChar extends \"\"\n        ? // Shouldn't happen, but handle gracefully\n          ToConstantCase<Tail, Head, Head, false>\n        : IsUpperLetter<PrevChar> extends true\n          ? // We're in an uppercase sequence\n            Tail extends `${infer Next}${infer _}`\n            ? IsLowerLetter<Next> extends true\n              ? // Next char is lowercase, so Head starts a new word - insert underscore\n                ToConstantCase<Tail, `${Acc}_${Head}`, Head, false>\n              : // Next char is uppercase or non-letter - continue sequence\n                ToConstantCase<Tail, `${Acc}${Head}`, Head, true>\n            : // Tail is empty - just append\n              ToConstantCase<Tail, `${Acc}${Head}`, Head, true>\n          : // Transition from lowercase to uppercase - insert underscore\n            ToConstantCase<Tail, `${Acc}_${Head}`, Head, false>\n    : IsLowerLetter<Head> extends true\n      ? InUpperSequence extends true\n        ? // End of uppercase sequence (2+) - insert underscore before lowercase\n          ToConstantCase<Tail, `${Acc}_${Uppercase<Head>}`, Head, false>\n        : // Single uppercase or no uppercase - no underscore\n          ToConstantCase<Tail, `${Acc}${Uppercase<Head>}`, Head, false>\n      : // Non-letter character - reset sequence\n        ToConstantCase<Tail, `${Acc}${Head}`, Head, false>\n  : Acc;\n\n/**\n * Converts a tag name to an error code in CONSTANT_CASE.\n */\nexport type TagToCode<TTag extends string> = ToConstantCase<TTag>;\n\n/**\n * Creates a tagged error class that combines Effect's YieldableError with ORPCError.\n *\n * This allows you to create errors that:\n * - Can be yielded in Effect generators (`yield* myError`)\n * - Have all ORPCError properties (code, status, data, defined)\n * - Can be converted to a plain ORPCError for oRPC handlers\n *\n * The returned factory function takes:\n * - `tag` - The unique tag for this error type (used for discriminated unions)\n * - `codeOrOptions` - Optional ORPC error code or options. If omitted, code defaults to CONSTANT_CASE of tag\n * - `defaultOptions` - Optional default options for status and message (when code is provided)\n *\n * @example\n * ```ts\n * import { ORPCTaggedError } from '@orpc/effect'\n * import { Effect } from 'effect'\n *\n * // Define a custom error (code defaults to 'USER_NOT_FOUND_ERROR')\n * class UserNotFoundError extends ORPCTaggedError<UserNotFoundError>()('UserNotFoundError') {}\n *\n * // With explicit code\n * class NotFoundError extends ORPCTaggedError<NotFoundError>()('NotFoundError', 'NOT_FOUND') {}\n *\n * // Use in an Effect\n * const getUser = (id: string) => Effect.gen(function* () {\n *   const user = yield* findUser(id)\n *   if (!user) {\n *     return yield* new UserNotFoundError({ data: { userId: id } })\n *   }\n *   return user\n * })\n *\n * // With custom data type\n * class ValidationError extends ORPCTaggedError<ValidationError, { fields: string[] }>()('ValidationError', 'BAD_REQUEST') {}\n *\n * // With options only (code defaults to 'VALIDATION_ERROR')\n * class ValidationError2 extends ORPCTaggedError<ValidationError2, { fields: string[] }>()(\n *   'ValidationError2',\n *   { message: 'Validation failed' }\n * ) {}\n * ```\n */\nexport function ORPCTaggedError<\n  TTag extends string,\n  TSchema extends AnySchema = AnySchema,\n  TCode extends ORPCErrorCode = ToConstantCase<TTag>,\n>(\n  tag: TTag,\n  props?: {\n    schema?: TSchema;\n    status?: number;\n    message?: string;\n    code?: TCode;\n  },\n): ORPCTaggedErrorClass<TTag, TCode, TSchema> {\n  const code: TCode = props?.code ?? (toConstantCase(tag) as any);\n  class ORPCTaggedErrorBase\n    extends Data.TaggedError(tag)\n    implements ORPCTaggedErrorInstance<TTag, TCode, TSchema>\n  {\n    readonly status: number;\n    readonly defined: boolean;\n    readonly data: InferSchemaOutput<TSchema>;\n    readonly code: TCode = code;\n    readonly schema = props?.schema as TSchema;\n    readonly [ORPCErrorSymbol]: ORPCError<TCode, InferSchemaOutput<TSchema>>;\n\n    constructor(\n      ...rest: MaybeOptionalOptions<\n        ORPCTaggedErrorOptions<InferSchemaOutput<TSchema>>\n      >\n    ) {\n      super();\n\n      const opts = resolveMaybeOptionalOptions(rest);\n      const status = opts.status ?? props?.status;\n\n      if (status !== undefined && !isORPCErrorStatus(status)) {\n        throw new globalThis.Error(\n          \"[ORPCTaggedError] Invalid error status code.\",\n        );\n      }\n\n      this.status = fallbackORPCErrorStatus(code, status);\n      this.defined = opts.defined ?? true;\n      this.data = opts.data as InferSchemaOutput<TSchema>;\n      this.message = fallbackORPCErrorMessage(\n        this.code,\n        opts.message ?? props?.message,\n      );\n      this.cause = opts.cause;\n\n      this[ORPCErrorSymbol] = new ORPCError<TCode, InferSchemaOutput<TSchema>>(\n        this.code,\n        {\n          status: this.status,\n          message: this.message,\n          data: this.data,\n          defined: this.defined,\n          cause: this.cause,\n        },\n      );\n    }\n\n    /**\n     * Converts this error to a plain ORPCError.\n     * Useful when you need to return from an oRPC handler.\n     */\n    toORPCError(): ORPCError<TCode, InferSchemaOutput<TSchema>> {\n      return this[ORPCErrorSymbol];\n    }\n\n    override toJSON(): ORPCErrorJSON<TCode, InferSchemaOutput<TSchema>> & {\n      _tag: TTag;\n    } {\n      return {\n        _tag: this._tag,\n        defined: this[ORPCErrorSymbol].defined,\n        code: this[ORPCErrorSymbol].code,\n        status: this[ORPCErrorSymbol].status,\n        message: this[ORPCErrorSymbol].message,\n        data: this[ORPCErrorSymbol].data,\n      };\n    }\n  }\n\n  return Object.assign(ORPCTaggedErrorBase, {\n    _tag: tag,\n    code,\n  } as const);\n}\n\n/**\n * Converts an ORPCTaggedError to a plain ORPCError.\n * Useful in handlers that need to throw ORPCError.\n *\n * @example\n * ```ts\n * const handler = effectOs.effect(function* () {\n *   const result = yield* someOperation.pipe(\n *     Effect.catchTag('UserNotFoundError', (e) =>\n *       Effect.fail(toORPCError(e))\n *     )\n *   )\n *   return result\n * })\n * ```\n */\nexport function toORPCError<\n  TCode extends ORPCErrorCode,\n  TSchema extends AnySchema = AnySchema,\n>(\n  error: ORPCTaggedErrorInstance<string, TCode, TSchema>,\n): ORPCError<TCode, InferSchemaOutput<TSchema>> {\n  return error[ORPCErrorSymbol];\n}\n\n// ============================================================================\n// Extended Error Map Types for Effect\n// ============================================================================\n\n/**\n * An item in the EffectErrorMap - can be either a traditional ErrorMapItem or an ORPCTaggedErrorClass\n */\nexport type EffectErrorMapItem =\n  | ErrorMapItem<AnySchema>\n  | AnyORPCTaggedErrorClass;\n\nexport type ORPCTaggedErrorClassToErrorMapItem<T> =\n  T extends ORPCTaggedErrorClass<any, any, infer TData>\n    ? {\n        status?: number;\n        message?: string;\n        data?: TData;\n      }\n    : never;\n\n/**\n * Extended error map that supports both traditional oRPC errors and ORPCTaggedError classes.\n *\n * @example\n * ```ts\n * const errorMap = {\n *   // Traditional format\n *   BAD_REQUEST: { status: 400, message: 'Bad request' },\n *\n *   // Tagged error class reference\n *   USER_NOT_FOUND: UserNotFoundError,\n * } satisfies EffectErrorMap\n * ```\n */\nexport type EffectErrorMap = {\n  [key in ORPCErrorCode]?: EffectErrorMapItem;\n};\n\n/**\n * Merges two EffectErrorMaps, with the second map taking precedence.\n */\nexport type MergedEffectErrorMap<\n  T1 extends EffectErrorMap,\n  T2 extends EffectErrorMap,\n> = Omit<T1, keyof T2> & T2;\n\n/**\n * Extracts the instance type from an EffectErrorMapItem\n */\nexport type EffectErrorMapItemToInstance<\n  TCode extends ORPCErrorCode,\n  T extends EffectErrorMapItem,\n> = T extends AnyORPCTaggedErrorClass\n  ? InstanceType<T>\n  : T extends { data?: infer TData }\n    ? ORPCError<TCode, TData>\n    : ORPCError<TCode, unknown>;\n\n/**\n * Converts an EffectErrorMap to a union of error instances.\n */\nexport type EffectErrorMapToUnion<T extends EffectErrorMap> = {\n  [K in keyof T]: K extends ORPCErrorCode\n    ? T[K] extends EffectErrorMapItem\n      ? EffectErrorMapItemToInstance<K, T[K]>\n      : never\n    : never;\n}[keyof T];\n\n/**\n * Constructor map for EffectErrorMap - provides typed error constructors for handlers.\n */\nexport type EffectErrorConstructorMap<T extends EffectErrorMap> =\n  ORPCErrorConstructorMap<EffectErrorMapToErrorMap<T>>;\n\n/**\n * Creates an error constructor map from an EffectErrorMap.\n * Tagged error classes are passed through directly.\n * Traditional error items become ORPCError factory functions.\n */\nexport function createEffectErrorConstructorMap<T extends EffectErrorMap>(\n  errors: T | undefined,\n): EffectErrorConstructorMap<T> {\n  const target = errors ?? ({} as T);\n  const proxy = new Proxy(target, {\n    get(proxyTarget, code) {\n      if (typeof code !== \"string\") {\n        return Reflect.get(proxyTarget, code);\n      }\n\n      const config = target[code];\n\n      // If it's a tagged error class, create a class constructor function\n      if (isORPCTaggedErrorClass(config)) {\n        return (\n          ...opts: MaybeOptionalOptions<ORPCTaggedErrorOptions<unknown>>\n        ) => new config(...opts);\n      }\n\n      // Otherwise, create a factory function for ORPCError\n      return (\n        ...rest: MaybeOptionalOptions<\n          Omit<ORPCErrorOptions<unknown>, \"defined\" | \"status\">\n        >\n      ) => {\n        const options = resolveMaybeOptionalOptions(rest);\n        return new ORPCError(code, {\n          defined: Boolean(config),\n          status: config?.status,\n          message: options.message ?? config?.message,\n          data: options.data,\n          cause: options.cause,\n        });\n      };\n    },\n  });\n\n  return proxy as EffectErrorConstructorMap<T>;\n}\n\n/**\n * Converts an EffectErrorMap to a standard oRPC ErrorMap for interop.\n * Tagged error classes are converted to their equivalent ErrorMapItem format.\n */\nexport function effectErrorMapToErrorMap<T extends EffectErrorMap>(\n  errorMap: T | undefined,\n): EffectErrorMapToErrorMap<T> {\n  const result: ErrorMap = {};\n\n  if (!errorMap) {\n    return result as ErrorMap & EffectErrorMapToErrorMap<T>;\n  }\n\n  for (const [code, ClassOrErrorItem] of Object.entries(errorMap)) {\n    if (!ClassOrErrorItem) {\n      continue;\n    }\n\n    if (isORPCTaggedErrorClass(ClassOrErrorItem)) {\n      const classInstance = new ClassOrErrorItem();\n      result[classInstance.code] = {\n        status: classInstance.status,\n        message: classInstance.message,\n        data: classInstance.schema,\n      };\n    } else {\n      result[code] = ClassOrErrorItem;\n    }\n  }\n\n  return result as ErrorMap & EffectErrorMapToErrorMap<T>;\n}\n"],"mappings":"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","names":["mergeMeta","mergePrefix","mergeRoute","ORPCError","addMiddleware","decorateMiddleware","lazy","Cause","enhanced","decorateMiddleware","addMiddleware","mergeMeta","mergeRoute","Cause","ORPCError","mergePrefix","lazy"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-orpc",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "keywords": [
     "effect",
     "orpc",

package/src/effect-builder.ts

@@ -39,7 +39,7 @@ import {
   fallbackConfig,
   lazy,
 } from "@orpc/server";
-import { Cause, Effect, Exit } from "effect";
+import { Cause, Effect, Exit, FiberRefs } from "effect";
 
 import type {
   EffectErrorConstructorMap,
@@ -630,8 +630,12 @@ export class EffectBuilder<
         });
         const parentFiberRefs = getCurrentFiberRefs();
         const effectWithRefs = parentFiberRefs
-          ? Effect.setFiberRefs(parentFiberRefs).pipe(
-              Effect.andThen(tracedEffect),
+          ? Effect.fiberIdWith((fiberId) =>
+              Effect.flatMap(Effect.getFiberRefs, (fiberRefs) =>
+                Effect.setFiberRefs(
+                  FiberRefs.joinAs(fiberRefs, fiberId, parentFiberRefs),
+                ).pipe(Effect.andThen(tracedEffect)),
+              ),
             )
           : tracedEffect;
         const exit = await runtime.runPromiseExit(effectWithRefs, {

package/src/tests/effect-builder.test.ts

@@ -130,7 +130,6 @@ describe("effectBuilder", () => {
   });
 
   it(".effect", () => {
-    // oxlint-disable-next-line require-yield
     const effectFn = vi.fn(function* () {
       return { result: "test" };
     });
@@ -142,7 +141,6 @@ describe("effectBuilder", () => {
   });
 
   it(".effect runs effect with runtime", async () => {
-    // oxlint-disable-next-line require-yield
     const effectFn = vi.fn(function* ({ input }: { input: any }) {
       return { output: `processed-${input}` };
     });
@@ -214,6 +212,52 @@ describe("effectBuilder", () => {
 
     expect(result).toBe("req-123");
   });
+
+  it(".effect merges context FiberRefs with runtime FiberRefs, prioritizing context FiberRefs", async () => {
+    const requestIdRef = FiberRef.unsafeMake("missing");
+
+    class Counter extends Effect.Tag("Counter")<
+      Counter,
+      { increment: (n: number) => Effect.Effect<number> }
+    >() {}
+
+    const CounterLive = Layer.succeed(Counter, {
+      increment: (n: number) => Effect.succeed(n + 1),
+    });
+    const serviceRuntime = ManagedRuntime.make(CounterLive);
+    const effectBuilder = makeEffectORPC(serviceRuntime);
+    const procedure = effectBuilder.input(z.number()).effect(function* ({
+      input,
+    }) {
+      const requestId = yield* FiberRef.get(requestIdRef);
+      const value = yield* Counter.increment(input as number);
+
+      return { requestId, value };
+    });
+
+    try {
+      const result = await Effect.runPromise(
+        Effect.gen(function* () {
+          yield* FiberRef.set(requestIdRef, "req-123");
+          return yield* withFiberContext(() =>
+            procedure["~effect"].handler({
+              context: {},
+              input: 5,
+              path: ["test"],
+              procedure: procedure as any,
+              signal: undefined,
+              lastEventId: undefined,
+              errors: {},
+            }),
+          );
+        }),
+      );
+
+      expect(result).toEqual({ requestId: "req-123", value: 6 });
+    } finally {
+      await serviceRuntime.dispose();
+    }
+  });
 });
 
 describe("makeEffectORPC factory", () => {
@@ -247,7 +291,6 @@ describe("makeEffectORPC factory", () => {
   it("creates working procedure with default os", async () => {
     const effectBuilder = makeEffectORPC(runtime);
 
-    // oxlint-disable-next-line require-yield
     const procedure = effectBuilder.effect(function* () {
       return "hello";
     });
@@ -297,7 +340,6 @@ describe("makeEffectORPC factory", () => {
       .route({ path: "/test" })
       .input(z.object({ id: z.string() }))
       .output(z.object({ name: z.string() }))
-      // oxlint-disable-next-line require-yield
       .effect(function* () {
         return { name: "test" };
       });
@@ -384,7 +426,6 @@ describe(".traced", () => {
     const procedure = effectBuilder
       .input(z.object({ id: z.string() }))
       .traced("users.getUser")
-      // oxlint-disable-next-line require-yield
       .effect(function* () {
         return { name: "test" };
       });
@@ -399,7 +440,6 @@ describe(".traced", () => {
     const procedure = effectBuilder
       .input(z.object({ id: z.string() }))
       .traced("users.getUser")
-      // oxlint-disable-next-line require-yield
       .effect(function* ({ input }) {
         return { id: input.id, name: "Alice" };
       });
@@ -461,7 +501,6 @@ describe("default tracing (without .traced())", () => {
     // No .traced() call - should still work and use path as span name
     const procedure = effectBuilder
       .input(z.object({ id: z.string() }))
-      // oxlint-disable-next-line require-yield
       .effect(function* ({ input }) {
         return { id: input.id, name: "Bob" };
       });
@@ -483,7 +522,6 @@ describe("default tracing (without .traced())", () => {
     const effectBuilder = makeEffectORPC(runtime);
 
     // Without .traced(), the span name should be derived from path
-    // oxlint-disable-next-line require-yield
     const procedure = effectBuilder.effect(function* () {
       return "hello";
     });
@@ -505,14 +543,11 @@ describe("default tracing (without .traced())", () => {
   it("default tracing works with Effect.fn generator", async () => {
     const effectBuilder = makeEffectORPC(runtime);
 
-    const procedure = effectBuilder.effect(
-      // oxlint-disable-next-line require-yield
-      function* () {
-        const x = 5;
-        const y = 10;
-        return x * y;
-      },
-    );
+    const procedure = effectBuilder.effect(function* () {
+      const x = 5;
+      const y = 10;
+      return x * y;
+    });
 
     const result = await procedure["~effect"].handler({
       context: {},
@@ -579,7 +614,6 @@ describe("default tracing (without .traced())", () => {
       .output(declaredOutputSchema)
       .effect(
         // @ts-expect-error input().output() should constrain the effect return type
-        // oxlint-disable-next-line require-yield
         function* () {
           return { count: 1 };
         },
@@ -588,7 +622,6 @@ describe("default tracing (without .traced())", () => {
     const procedure = makeEffectORPC(runtime)
       .output(declaredOutputSchema)
       // @ts-expect-error output() should constrain the effect return type
-      // oxlint-disable-next-line require-yield
       .effect(function* () {
         return { count: 1 };
       });

package/src/tests/effect-error-map.test.ts

@@ -233,7 +233,6 @@ describe("effectBuilder with EffectErrorMap", () => {
         BAD_REQUEST: { status: 400 },
       })
       .input(z.object({ id: z.string() }))
-      // oxlint-disable-next-line require-yield
       .effect(function* ({ input, errors }) {
         // errors.USER_NOT_FOUND_ERROR is the class
         expect(errors.USER_NOT_FOUND_ERROR).toBe(UserNotFoundError);
@@ -255,7 +254,6 @@ describe("effectBuilder with EffectErrorMap", () => {
         USER_NOT_FOUND_ERROR: UserNotFoundError,
       })
       .input(z.object({ id: z.string() }))
-      // oxlint-disable-next-line require-yield
       .effect(function* ({ input, errors }) {
         if (input.id === "not-found") {
           return yield* Effect.fail(
@@ -299,7 +297,6 @@ describe("effectDecoratedProcedure.errors()", () => {
   it("should support adding errors to procedure", () => {
     const procedure = effectOs
       .input(z.object({ id: z.string() }))
-      // oxlint-disable-next-line require-yield
       .effect(function* ({ input }) {
         return { id: input.id };
       })
@@ -314,7 +311,6 @@ describe("effectDecoratedProcedure.errors()", () => {
     const procedure = effectOs
       .errors({ BAD_REQUEST: { status: 400 } })
       .input(z.object({ id: z.string() }))
-      // oxlint-disable-next-line require-yield
       .effect(function* ({ input }) {
         return { id: input.id };
       })

package/README.md

@@ -1,385 +0,0 @@
-# effect-orpc
-
-A type-safe integration between [oRPC](https://orpc.dev/) and [Effect](https://effect.website/), enabling Effect-native procedures with full service injection support, OpenTelemetry tracing support and typesafe Effect errors support.
-
-Inspired by [effect-trpc](https://github.com/mikearnaldi/effect-trpc).
-
-## Features
-
-- **Effect-native procedures** - Write oRPC procedures using generators with `yield*` syntax
-- **Type-safe service injection** - Use `ManagedRuntime<R>` to provide services to procedures with compile-time safety
-- **Tagged errors** - Create Effect-native error classes with `ORPCTaggedError` that integrate with oRPC's error handling
-- **Full oRPC compatibility** - Mix Effect procedures with standard oRPC procedures in the same router
-- **Telemetry support with automatic tracing** - Procedures are automatically traced with OpenTelemetry-compatible spans. Customize span names with `.traced()`.
-- **Builder pattern preserved** - oRPC builder methods (`.errors()`, `.meta()`, `.route()`, `.input()`, `.output()`, `.use()`) work seamlessly
-
-## Installation
-
-```bash
-npm install effect-orpc
-# or
-pnpm add effect-orpc
-# or
-bun add effect-orpc
-```
-
-`makeEffectORPC` stays on the main `effect-orpc` entrypoint. Only import
-`withFiberContext` from `effect-orpc/node`.
-
-The reason for the separate `/node` entrypoint is that `withFiberContext` relies
-on Node/Bun's `AsyncLocalStorage` from `node:async_hooks` to carry Effect
-`FiberRef` state across framework async boundaries. The main package stays
-runtime-agnostic.
-
-Runnable demos live in the repository's `examples/` directory.
-
-## Demo
-
-```ts
-import { os } from "@orpc/server";
-import { Effect, ManagedRuntime } from "effect";
-import { makeEffectORPC, ORPCTaggedError } from "effect-orpc";
-
-interface User {
-  id: number;
-  name: string;
-}
-
-let users: User[] = [
-  { id: 1, name: "John Doe" },
-  { id: 2, name: "Jane Doe" },
-  { id: 3, name: "James Dane" },
-];
-
-// Authenticated os with initial context & errors set
-const authedOs = os
-  .errors({ UNAUTHORIZED: { status: 401 } })
-  .$context<{ userId?: number }>()
-  .use(({ context, errors, next }) => {
-    if (context.userId === undefined) throw errors.UNAUTHORIZED();
-    return next({ context: { ...context, userId: context.userId } });
-  });
-
-// Define your services
-class UsersRepo extends Effect.Service<UsersRepo>()("UsersRepo", {
-  accessors: true,
-  sync: () => ({
-    get: (id: number) => users.find((u) => u.id === id),
-  }),
-}) {}
-
-// Special yieldable oRPC error class
-class UserNotFoundError extends ORPCTaggedError("UserNotFoundError", {
-  status: 404,
-}) {}
-
-// Create runtime with your services
-const runtime = ManagedRuntime.make(UsersRepo.Default);
-// Create Effect-aware oRPC builder from an other (optional) base oRPC builder and provide tagged errors
-const effectOs = makeEffectORPC(runtime, authedOs).errors({
-  UserNotFoundError,
-});
-
-// Create the router with mixed procedures
-export const router = {
-  health: os.handler(() => "ok"),
-  users: {
-    me: effectOs.effect(function* ({ context: { userId } }) {
-      const user = yield* UsersRepo.get(userId);
-      if (!user) {
-        return yield* new UserNotFoundError();
-      }
-      return user;
-    }),
-  },
-};
-
-export type Router = typeof router;
-```
-
-## Request-Scoped Fiber Context
-
-If you run `effect-orpc` inside a framework such as Hono, the handler executes
-through the runtime boundary and will not automatically inherit request-local
-`FiberRef` state from outer middleware. Import `makeEffectORPC` from the main
-package, and wrap the framework continuation with `withFiberContext` from
-`effect-orpc/node` to preserve request-scoped logs, tracing annotations, and
-other fiber-local state.
-
-```ts
-import { Hono } from "hono";
-import { Effect, ManagedRuntime } from "effect";
-import { makeEffectORPC } from "effect-orpc";
-import { withFiberContext } from "effect-orpc/node";
-
-const runtime = ManagedRuntime.make(AppLive);
-const effectOs = makeEffectORPC(runtime);
-const app = new Hono();
-
-app.use("*", async (c, next) => {
-  await Effect.runPromise(
-    Effect.gen(function* () {
-      yield* Effect.annotateLogsScoped({
-        requestId: c.get("requestId"),
-      });
-
-      yield* withFiberContext(() => next());
-    }),
-  );
-});
-```
-
-If you do not need framework-to-handler fiber propagation, you do not need the
-`/node` entrypoint at all.
-
-## Type Safety
-
-The wrapper enforces that Effect procedures only use services provided by the `ManagedRuntime`. If you try to use a service that isn't in the runtime, you'll get a compile-time error:
-
-```ts
-import { Context, Effect, Layer, ManagedRuntime } from "effect";
-import { makeEffectORPC } from "effect-orpc";
-
-class ProvidedService extends Context.Tag("ProvidedService")<
-  ProvidedService,
-  { doSomething: () => Effect.Effect<string> }
->() {}
-
-class MissingService extends Context.Tag("MissingService")<
-  MissingService,
-  { doSomething: () => Effect.Effect<string> }
->() {}
-
-const runtime = ManagedRuntime.make(
-  Layer.succeed(ProvidedService, {
-    doSomething: () => Effect.succeed("ok"),
-  }),
-);
-
-const effectOs = makeEffectORPC(runtime);
-
-// ✅ This compiles - ProvidedService is in the runtime
-const works = effectOs.effect(function* () {
-  const service = yield* ProvidedService;
-  return yield* service.doSomething();
-});
-
-// ❌ This fails to compile - MissingService is not in the runtime
-const fails = effectOs.effect(function* () {
-  const service = yield* MissingService; // Type error!
-  return yield* service.doSomething();
-});
-```
-
-## Error Handling
-
-`ORPCTaggedError` lets you create Effect-native error classes that integrate seamlessly with oRPC. These errors:
-
-- Can be yielded in Effect generators (`yield* new MyError()` or `yield* Effect.fail(errors.MyError)`)
-- Can be used in Effect builder's `.errors()` maps for type-safe error handling alongside regular oRPC errors
-- Automatically convert to ORPCError when thrown
-
-Make sure the tagged error class is passed to the effect `.errors()` to be able to yield the error class directly and make the client recognize it as defined.
-
-```ts
-const getUser = effectOs
-  // Mixed error maps
-  .errors({
-    // Regular oRPC error
-    NOT_FOUND: {
-      message: "User not found",
-      data: z.object({ id: z.string() }),
-    },
-    // Effect oRPC tagged error
-    UserNotFoundError,
-    // Note: The key of an oRPC error is not used as the error code
-    // So the following will only change the key of the error when accessing it
-    // from the errors object passed to the handler, but not the actual error code itself.
-    // To change the error's code, please see the next section on creating tagged errors.
-    USER_NOT_FOUND: UserNotFoundError,
-    // ^^^ same code as the `UserNotFoundError` error key, defined at the class level
-  })
-  .effect(function* ({ input, errors }) {
-    const user = yield* UsersRepo.findById(input.id);
-    if (!user) {
-      return yield* new UserNotFoundError();
-      // or return `yield* Effect.fail(errors.USER_NOT_FOUND())`
-    }
-    return user;
-  });
-```
-
-### Creating Tagged Errors
-
-```ts
-import { ORPCTaggedError } from "effect-orpc";
-
-// Basic tagged error - code defaults to 'USER_NOT_FOUND' (CONSTANT_CASE of tag)
-class UserNotFound extends ORPCTaggedError("UserNotFound") {}
-
-// With explicit code
-class NotFound extends ORPCTaggedError("NotFound", { code: "NOT_FOUND" }) {}
-
-// With default options (code defaults to 'VALIDATION_ERROR') (CONSTANT_CASE of tag)
-class ValidationError extends ORPCTaggedError("ValidationError", {
-  status: 400,
-  message: "Validation failed",
-}) {}
-
-// With all options
-class ForbiddenError extends ORPCTaggedError("ForbiddenError", {
-  code: "FORBIDDEN",
-  status: 403,
-  message: "Access denied",
-  schema: z.object({
-    reason: z.string(),
-  }),
-}) {}
-
-// With typed data using Standard Schema
-class UserNotFoundWithData extends ORPCTaggedError("UserNotFoundWithData", {
-  schema: z.object({ userId: z.string() }),
-}) {}
-```
-
-## Traceable Spans
-
-All Effect procedures are automatically traced with `Effect.withSpan`. By default, the span name is the procedure path (e.g., `users.getUser`):
-
-```ts
-// Router structure determines span names automatically
-const router = {
-  users: {
-    // Span name: "users.get"
-    get: effectOs.input(z.object({ id: z.string() })).effect(function* ({
-      input,
-    }) {
-      const userService = yield* UserService;
-      return yield* userService.findById(input.id);
-    }),
-    // Span name: "users.create"
-    create: effectOs.input(z.object({ name: z.string() })).effect(function* ({
-      input,
-    }) {
-      const userService = yield* UserService;
-      return yield* userService.create(input.name);
-    }),
-  },
-};
-```
-
-Use `.traced()` to override the default span name:
-
-```ts
-const getUser = effectOs
-  .input(z.object({ id: z.string() }))
-  .traced("custom.span.name") // Override the default path-based name
-  .effect(function* ({ input }) {
-    const userService = yield* UserService;
-    return yield* userService.findById(input.id);
-  });
-```
-
-### Enabling OpenTelemetry
-
-To enable tracing, include the OpenTelemetry layer in your runtime:
-
-```ts
-import { NodeSdk } from "@effect/opentelemetry";
-import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { SimpleSpanProcessor } from "@opentelemetry/sdk-trace-base";
-
-const TracingLive = NodeSdk.layer(
-  Effect.sync(() => ({
-    resource: { serviceName: "my-service" },
-    spanProcessor: [new SimpleSpanProcessor(new OTLPTraceExporter())],
-  })),
-);
-
-const AppLive = Layer.mergeAll(UserServiceLive, TracingLive);
-
-const runtime = ManagedRuntime.make(AppLive);
-const effectOs = makeEffectORPC(runtime);
-```
-
-### Error Stack Traces
-
-When an Effect procedure fails, the span includes a properly formatted stack trace pointing to the definition site:
-
-```
-MyCustomError: Something went wrong
-    at <anonymous> (/app/src/procedures.ts:42:28)
-    at users.getById (/app/src/procedures.ts:41:35)
-```
-
-## API Reference
-
-### `makeEffectORPC(runtime, builder?)`
-
-Creates an Effect-aware procedure builder.
-
-- `runtime` - A `ManagedRuntime<R, E>` instance that provides services for Effect procedures
-- `builder` (optional) - An oRPC Builder instance to wrap. Defaults to `os` from `@orpc/server`
-
-Returns an `EffectBuilder` instance.
-
-```ts
-// With default builder
-const effectOs = makeEffectORPC(runtime);
-
-// With customized builder
-const effectAuthedOs = makeEffectORPC(runtime, authedBuilder);
-```
-
-### `EffectBuilder`
-
-Wraps an oRPC Builder with Effect support. Available methods:
-
-| Method              | Description                                                                     |
-| ------------------- | ------------------------------------------------------------------------------- |
-| `.$config(config)`  | Set or override the builder config                                              |
-| `.$context<U>()`    | Set or override the initial context type                                        |
-| `.$meta(meta)`      | Set or override the initial metadata                                            |
-| `.$route(route)`    | Set or override the initial route configuration                                 |
-| `.$input(schema)`   | Set or override the initial input schema                                        |
-| `.errors(map)`      | Add type-safe custom errors                                                     |
-| `.meta(meta)`       | Set procedure metadata (merged with existing)                                   |
-| `.route(route)`     | Configure OpenAPI route (merged with existing)                                  |
-| `.input(schema)`    | Define input validation schema                                                  |
-| `.output(schema)`   | Define output validation schema                                                 |
-| `.use(middleware)`  | Add middleware                                                                  |
-| `.traced(name)`     | Add a traceable span for telemetry (optional, defaults to the procedure's path) |
-| `.handler(handler)` | Define a non-Effect handler (standard oRPC handler)                             |
-| `.effect(handler)`  | Define the Effect handler                                                       |
-| `.prefix(prefix)`   | Prefix all procedures in the router (for OpenAPI)                               |
-| `.tag(...tags)`     | Add tags to all procedures in the router (for OpenAPI)                          |
-| `.router(router)`   | Apply all options to a router                                                   |
-| `.lazy(loader)`     | Create and apply options to a lazy-loaded router                                |
-
-### `EffectDecoratedProcedure`
-
-The result of calling `.effect()`. Extends standard oRPC `DecoratedProcedure` with Effect type preservation.
-
-| Method                  | Description                                   |
-| ----------------------- | --------------------------------------------- |
-| `.errors(map)`          | Add more custom errors                        |
-| `.meta(meta)`           | Update metadata (merged with existing)        |
-| `.route(route)`         | Update route configuration (merged)           |
-| `.use(middleware)`      | Add middleware                                |
-| `.callable(options?)`   | Make procedure directly invocable             |
-| `.actionable(options?)` | Make procedure compatible with server actions |
-
-### `ORPCTaggedError(tag, options?)`
-
-Factory function to create Effect-native tagged error classes.
-
-The options is an optional object containing:
-
-- `schema?` - Optional Standard Schema for the error's data payload (e.g., `z.object({ userId: z.string() })`)
-- `code?` - Optional ORPCErrorCode, defaults to CONSTANT_CASE of the tag (e.g., `UserNotFoundError` → `USER_NOT_FOUND_ERROR`).
-- `status?` - Sets the default status of the error
-- `message` - Sets the default message of the error
-
-## License
-
-MIT