@orpc/server 0.0.0-next.e9dc36e → 0.0.0-next.ee0aeaf

package/dist/index.js

@@ -1,11 +1,18 @@
 import {
+  LAZY_LOADER_SYMBOL,
   Procedure,
+  createFlattenLazy,
+  createLazy,
   createProcedureCaller,
+  decorateLazy,
   decorateMiddleware,
   decorateProcedure,
+  isLazy,
   isProcedure,
+  loadLazy,
+  loadProcedure,
   mergeContext
-} from "./chunk-TDFYNRZV.js";
+} from "./chunk-VARUID7X.js";
 
 // src/builder.ts
 import {
@@ -15,9 +22,138 @@ import {
 
 // src/procedure-builder.ts
 import {
-  DecoratedContractProcedure
+  DecoratedContractProcedure as DecoratedContractProcedure2
 } from "@orpc/contract";
 
+// src/router-builder.ts
+import { DecoratedContractProcedure } from "@orpc/contract";
+var LAZY_ROUTER_PREFIX_SYMBOL = Symbol("ORPC_LAZY_ROUTER_PREFIX");
+var RouterBuilder = class _RouterBuilder {
+  constructor(zz$rb) {
+    this.zz$rb = zz$rb;
+    if (zz$rb.prefix && zz$rb.prefix.includes("{")) {
+      throw new Error('Prefix cannot contain "{" for dynamic routing');
+    }
+  }
+  prefix(prefix) {
+    return new _RouterBuilder({
+      ...this.zz$rb,
+      prefix: `${this.zz$rb.prefix ?? ""}${prefix}`
+    });
+  }
+  tags(...tags) {
+    if (!tags.length)
+      return this;
+    return new _RouterBuilder({
+      ...this.zz$rb,
+      tags: [...this.zz$rb.tags ?? [], ...tags]
+    });
+  }
+  use(middleware, mapInput) {
+    const middleware_ = mapInput ? decorateMiddleware(middleware).mapInput(mapInput) : middleware;
+    return new _RouterBuilder({
+      ...this.zz$rb,
+      middlewares: [...this.zz$rb.middlewares || [], middleware_]
+    });
+  }
+  router(router) {
+    const handled = adaptRouter({
+      routerOrChild: router,
+      middlewares: this.zz$rb.middlewares,
+      tags: this.zz$rb.tags,
+      prefix: this.zz$rb.prefix
+    });
+    return handled;
+  }
+  lazy(loader) {
+    const lazy = adaptLazyRouter({
+      current: createLazy(loader),
+      middlewares: this.zz$rb.middlewares,
+      tags: this.zz$rb.tags,
+      prefix: this.zz$rb.prefix
+    });
+    return lazy;
+  }
+};
+function adaptRouter(options) {
+  if (isProcedure(options.routerOrChild)) {
+    return adaptProcedure({
+      ...options,
+      procedure: options.routerOrChild
+    });
+  }
+  if (isLazy(options.routerOrChild)) {
+    return adaptLazyRouter({
+      ...options,
+      current: options.routerOrChild
+    });
+  }
+  const handled = {};
+  for (const key in options.routerOrChild) {
+    handled[key] = adaptRouter({
+      ...options,
+      routerOrChild: options.routerOrChild[key]
+    });
+  }
+  return handled;
+}
+function adaptLazyRouter(options) {
+  const loader = async () => {
+    const current = (await loadLazy(options.current)).default;
+    return {
+      default: adaptRouter({
+        ...options,
+        routerOrChild: current
+      })
+    };
+  };
+  let lazyRouterPrefix = options.prefix;
+  if (LAZY_ROUTER_PREFIX_SYMBOL in options.current && typeof options.current[LAZY_ROUTER_PREFIX_SYMBOL] === "string") {
+    lazyRouterPrefix = `${options.current[LAZY_ROUTER_PREFIX_SYMBOL]}${lazyRouterPrefix ?? ""}`;
+  }
+  const decoratedLazy = Object.assign(decorateLazy(createLazy(loader)), {
+    [LAZY_ROUTER_PREFIX_SYMBOL]: lazyRouterPrefix
+  });
+  const recursive = new Proxy(decoratedLazy, {
+    get(target, key) {
+      if (typeof key !== "string") {
+        return Reflect.get(target, key);
+      }
+      return adaptLazyRouter({
+        ...options,
+        current: createLazy(async () => {
+          const current = (await loadLazy(options.current)).default;
+          return { default: current[key] };
+        })
+      });
+    }
+  });
+  return recursive;
+}
+function adaptProcedure(options) {
+  const builderMiddlewares = options.middlewares ?? [];
+  const procedureMiddlewares = options.procedure.zz$p.middlewares ?? [];
+  const middlewares = [
+    ...builderMiddlewares,
+    ...procedureMiddlewares.filter(
+      (item) => !builderMiddlewares.includes(item)
+    )
+  ];
+  let contract = DecoratedContractProcedure.decorate(
+    options.procedure.zz$p.contract
+  ).pushTag(...options.tags ?? []);
+  if (options.prefix) {
+    contract = contract.prefix(options.prefix);
+  }
+  return decorateProcedure({
+    zz$p: {
+      ...options.procedure.zz$p,
+      contract,
+      middlewares
+    }
+  });
+}
+
 // src/procedure-implementer.ts
 var ProcedureImplementer = class _ProcedureImplementer {
   constructor(zz$pi) {
@@ -39,6 +175,9 @@ var ProcedureImplementer = class _ProcedureImplementer {
       }
     });
   }
+  lazy(loader) {
+    return new RouterBuilder(this.zz$pi).lazy(loader);
+  }
 };
 
 // src/procedure-builder.ts
@@ -52,7 +191,7 @@ var ProcedureBuilder = class _ProcedureBuilder {
   route(opts) {
     return new _ProcedureBuilder({
       ...this.zz$pb,
-      contract: DecoratedContractProcedure.decorate(this.zz$pb.contract).route(
+      contract: DecoratedContractProcedure2.decorate(this.zz$pb.contract).route(
         opts
       )
     });
@@ -60,7 +199,7 @@ var ProcedureBuilder = class _ProcedureBuilder {
   input(schema, example) {
     return new _ProcedureBuilder({
       ...this.zz$pb,
-      contract: DecoratedContractProcedure.decorate(this.zz$pb.contract).input(
+      contract: DecoratedContractProcedure2.decorate(this.zz$pb.contract).input(
         schema,
         example
       )
@@ -69,7 +208,7 @@ var ProcedureBuilder = class _ProcedureBuilder {
   output(schema, example) {
     return new _ProcedureBuilder({
       ...this.zz$pb,
-      contract: DecoratedContractProcedure.decorate(this.zz$pb.contract).output(
+      contract: DecoratedContractProcedure2.decorate(this.zz$pb.contract).output(
         schema,
         example
       )
@@ -101,75 +240,24 @@ var ProcedureBuilder = class _ProcedureBuilder {
   }
 };
 
-// src/router-builder.ts
-import { DecoratedContractProcedure as DecoratedContractProcedure2 } from "@orpc/contract";
-var RouterBuilder = class _RouterBuilder {
-  constructor(zz$rb) {
-    this.zz$rb = zz$rb;
-  }
-  prefix(prefix) {
-    return new _RouterBuilder({
-      ...this.zz$rb,
-      prefix: `${this.zz$rb.prefix ?? ""}${prefix}`
-    });
-  }
-  tags(...tags) {
-    if (!tags.length)
-      return this;
-    return new _RouterBuilder({
-      ...this.zz$rb,
-      tags: [...this.zz$rb.tags ?? [], ...tags]
-    });
-  }
-  use(middleware, mapInput) {
-    const middleware_ = mapInput ? decorateMiddleware(middleware).mapInput(mapInput) : middleware;
-    return new _RouterBuilder({
-      ...this.zz$rb,
-      middlewares: [...this.zz$rb.middlewares || [], middleware_]
-    });
-  }
-  router(router) {
-    const handled = {};
-    for (const key in router) {
-      const item = router[key];
-      if (isProcedure(item)) {
-        const builderMiddlewares = this.zz$rb.middlewares ?? [];
-        const itemMiddlewares = item.zz$p.middlewares ?? [];
-        const middlewares = [
-          ...builderMiddlewares,
-          ...itemMiddlewares.filter(
-            (item2) => !builderMiddlewares.includes(item2)
-          )
-        ];
-        const contract = DecoratedContractProcedure2.decorate(
-          item.zz$p.contract
-        ).addTags(...this.zz$rb.tags ?? []);
-        handled[key] = decorateProcedure({
-          zz$p: {
-            ...item.zz$p,
-            contract: this.zz$rb.prefix ? contract.prefix(this.zz$rb.prefix) : contract,
-            middlewares
-          }
-        });
-      } else {
-        handled[key] = this.router(item);
-      }
-    }
-    return handled;
-  }
-};
-
 // src/router-implementer.ts
-import {
-  isContractProcedure
-} from "@orpc/contract";
+import { isContractProcedure } from "@orpc/contract";
+var ROUTER_CONTRACT_SYMBOL = Symbol("ORPC_ROUTER_CONTRACT");
 var RouterImplementer = class {
   constructor(zz$ri) {
     this.zz$ri = zz$ri;
   }
   router(router) {
-    assertRouterImplementation(this.zz$ri.contract, router);
-    return router;
+    return Object.assign(new RouterBuilder({}).router(router), {
+      [ROUTER_CONTRACT_SYMBOL]: this.zz$ri.contract
+    });
+  }
+  lazy(loader) {
+    const lazy = createLazy(loader);
+    const decorated = decorateLazy(lazy);
+    return Object.assign(decorated, {
+      [ROUTER_CONTRACT_SYMBOL]: this.zz$ri.contract
+    });
   }
 };
 function chainRouterImplementer(contract, middlewares) {
@@ -188,37 +276,6 @@ function chainRouterImplementer(contract, middlewares) {
   const implementer = new RouterImplementer({ contract });
   return Object.assign(implementer, result);
 }
-function assertRouterImplementation(contract, router, path = []) {
-  for (const key in contract) {
-    const currentPath = [...path, key];
-    const contractItem = contract[key];
-    const routerItem = router[key];
-    if (!routerItem) {
-      throw new Error(
-        `Missing implementation for procedure at [${currentPath.join(".")}]`
-      );
-    }
-    if (isContractProcedure(contractItem)) {
-      if (isProcedure(routerItem)) {
-        if (routerItem.zz$p.contract !== contractItem) {
-          throw new Error(
-            `Mismatch implementation for procedure at [${currentPath.join(".")}]`
-          );
-        }
-      } else {
-        throw new Error(
-          `Mismatch implementation for procedure at [${currentPath.join(".")}]`
-        );
-      }
-    } else {
-      assertRouterImplementation(
-        contractItem,
-        routerItem,
-        currentPath
-      );
-    }
-  }
-}
 
 // src/builder.ts
 var Builder = class _Builder {
@@ -241,11 +298,11 @@ var Builder = class _Builder {
   /**
    * Convert to ContractProcedureBuilder
    */
-  route(opts) {
+  route(route) {
     return new ProcedureBuilder({
       middlewares: this.zz$b.middlewares,
       contract: new ContractProcedure({
-        ...opts,
+        route,
         InputSchema: void 0,
         OutputSchema: void 0
       })
@@ -327,48 +384,36 @@ var Builder = class _Builder {
   router(router) {
     return new RouterBuilder(this.zz$b).router(router);
   }
-};
-
-// src/router.ts
-import {
-  isContractProcedure as isContractProcedure3
-} from "@orpc/contract";
-function toContractRouter(router) {
-  const contract = {};
-  for (const key in router) {
-    const item = router[key];
-    if (isContractProcedure3(item)) {
-      contract[key] = item;
-    } else if (isProcedure(item)) {
-      contract[key] = item.zz$p.contract;
-    } else {
-      contract[key] = toContractRouter(item);
-    }
+  lazy(loader) {
+    return new RouterBuilder(this.zz$b).lazy(loader);
   }
-  return contract;
-}
+};
 
 // src/router-caller.ts
 function createRouterCaller(options) {
-  const caller = {};
-  for (const key in options.router) {
-    const path = [...options.basePath ?? [], key];
-    const item = options.router[key];
-    if (isProcedure(item)) {
-      caller[key] = createProcedureCaller({
-        procedure: item,
-        context: options.context,
-        path
-      });
-    } else {
-      caller[key] = createRouterCaller({
-        router: item,
-        context: options.context,
-        basePath: path
+  return createRouterCallerInternal(options);
+}
+function createRouterCallerInternal(options) {
+  const procedureCaller = isLazy(options.router) || isProcedure(options.router) ? createProcedureCaller({
+    ...options,
+    procedure: options.router,
+    context: options.context,
+    path: options.basePath
+  }) : {};
+  const recursive = new Proxy(procedureCaller, {
+    get(target, key) {
+      if (typeof key !== "string") {
+        return Reflect.get(target, key);
+      }
+      const next = options.router[key];
+      return createRouterCallerInternal({
+        ...options,
+        router: next,
+        basePath: [...options.basePath ?? [], key]
       });
     }
-  }
-  return caller;
+  });
+  return recursive;
 }
 
 // src/index.ts
@@ -376,19 +421,27 @@ export * from "@orpc/shared/error";
 var os = new Builder();
 export {
   Builder,
+  LAZY_LOADER_SYMBOL,
+  LAZY_ROUTER_PREFIX_SYMBOL,
   Procedure,
   ProcedureBuilder,
   ProcedureImplementer,
+  ROUTER_CONTRACT_SYMBOL,
+  RouterBuilder,
   RouterImplementer,
-  assertRouterImplementation,
   chainRouterImplementer,
+  createFlattenLazy,
+  createLazy,
   createProcedureCaller,
   createRouterCaller,
+  decorateLazy,
   decorateMiddleware,
   decorateProcedure,
+  isLazy,
   isProcedure,
+  loadLazy,
+  loadProcedure,
   mergeContext,
-  os,
-  toContractRouter
+  os
 };
 //# sourceMappingURL=index.js.map

package/dist/src/builder.d.ts

@@ -1,9 +1,11 @@
+import type { ANY_CONTRACT_PROCEDURE, ContractRouter, HTTPPath, RouteOptions, Schema, SchemaInput, SchemaOutput } from '@orpc/contract';
 import type { IsEqual } from '@orpc/shared';
+import type { DecoratedLazy } from './lazy';
+import type { DecoratedProcedure, Procedure, ProcedureFunc } from './procedure';
 import type { HandledRouter, Router } from './router';
 import type { Context, MergeContext } from './types';
-import { ContractProcedure, type ContractRouter, type HTTPPath, type RouteOptions, type Schema, type SchemaInput, type SchemaOutput } from '@orpc/contract';
+import { ContractProcedure } from '@orpc/contract';
 import { type DecoratedMiddleware, type MapInputMiddleware, type Middleware } from './middleware';
-import { type DecoratedProcedure, type ProcedureFunc } from './procedure';
 import { ProcedureBuilder } from './procedure-builder';
 import { ProcedureImplementer } from './procedure-implementer';
 import { RouterBuilder } from './router-builder';
@@ -24,7 +26,7 @@ export declare class Builder<TContext extends Context, TExtraContext extends Con
     /**
      * Convert to ContractProcedureBuilder
      */
-    route(opts: RouteOptions): ProcedureBuilder<TContext, TExtraContext, undefined, undefined>;
+    route(route: RouteOptions): ProcedureBuilder<TContext, TExtraContext, undefined, undefined>;
     input<USchema extends Schema = undefined>(schema: USchema, example?: SchemaInput<USchema>): ProcedureBuilder<TContext, TExtraContext, USchema, undefined>;
     output<USchema extends Schema = undefined>(schema: USchema, example?: SchemaOutput<USchema>): ProcedureBuilder<TContext, TExtraContext, undefined, USchema>;
     /**
@@ -34,7 +36,7 @@ export declare class Builder<TContext extends Context, TExtraContext extends Con
     /**
      * Convert to ProcedureImplementer | RouterBuilder
      */
-    contract<UContract extends ContractProcedure<any, any> | ContractRouter>(contract: UContract): UContract extends ContractProcedure<infer UInputSchema, infer UOutputSchema> ? ProcedureImplementer<TContext, TExtraContext, UInputSchema, UOutputSchema> : UContract extends ContractRouter ? ChainedRouterImplementer<TContext, UContract, TExtraContext> : never;
+    contract<UContract extends ANY_CONTRACT_PROCEDURE | ContractRouter>(contract: UContract): UContract extends ContractProcedure<infer UInputSchema, infer UOutputSchema> ? ProcedureImplementer<TContext, TExtraContext, UInputSchema, UOutputSchema> : UContract extends ContractRouter ? ChainedRouterImplementer<TContext, UContract, TExtraContext> : never;
     /**
      * Create ExtendedMiddleware
      */
@@ -45,5 +47,8 @@ export declare class Builder<TContext extends Context, TExtraContext extends Con
      * Create DecoratedRouter
      */
     router<URouter extends Router<TContext>>(router: URouter): HandledRouter<URouter>;
+    lazy<U extends Router<TContext> | Procedure<TContext, any, any, any, any>>(loader: () => Promise<{
+        default: U;
+    }>): DecoratedLazy<U>;
 }
 //# sourceMappingURL=builder.d.ts.map

package/dist/src/fetch/handle.d.ts

@@ -0,0 +1,7 @@
+import type { Router } from '../router';
+import type { FetchHandler, FetchHandlerOptions } from './types';
+export type HandleFetchRequestOptions<TRouter extends Router<any>> = FetchHandlerOptions<TRouter> & {
+    handlers: readonly [FetchHandler, ...FetchHandler[]];
+};
+export declare function handleFetchRequest<TRouter extends Router<any>>(options: HandleFetchRequestOptions<TRouter>): Promise<Response>;
+//# sourceMappingURL=handle.d.ts.map

package/dist/src/fetch/handler.d.ts

@@ -0,0 +1,3 @@
+import type { FetchHandler } from './types';
+export declare function createORPCHandler(): FetchHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/src/fetch/index.d.ts

@@ -0,0 +1,4 @@
+export * from './handle';
+export * from './handler';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/fetch/types.d.ts

@@ -0,0 +1,28 @@
+import type { Hooks, PartialOnUndefinedDeep, Value } from '@orpc/shared';
+import type { Router } from '../router';
+import type { CallerOptions } from '../types';
+export type FetchHandlerOptions<TRouter extends Router<any>> = {
+    /**
+     * The `router` used for handling the request and routing,
+     *
+     */
+    router: TRouter;
+    /**
+     * The request need to be handled.
+     */
+    request: Request;
+    /**
+     * Remove the prefix from the request path.
+     *
+     * @example /orpc
+     * @example /api
+     */
+    prefix?: string;
+} & PartialOnUndefinedDeep<{
+    /**
+     * The context used to handle the request.
+     */
+    context: Value<TRouter extends Router<infer UContext> ? UContext : never>;
+}> & CallerOptions & Hooks<Request, Response, TRouter extends Router<infer UContext> ? UContext : never, CallerOptions>;
+export type FetchHandler = <TRouter extends Router<any>>(options: FetchHandlerOptions<TRouter>) => Promise<Response | undefined>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/index.d.ts

@@ -1,11 +1,13 @@
 import { Builder } from './builder';
 export * from './builder';
+export * from './lazy';
 export * from './middleware';
 export * from './procedure';
 export * from './procedure-builder';
 export * from './procedure-caller';
 export * from './procedure-implementer';
 export * from './router';
+export * from './router-builder';
 export * from './router-caller';
 export * from './router-implementer';
 export * from './types';

package/dist/src/lazy.d.ts

@@ -0,0 +1,23 @@
+import type { Procedure } from './procedure';
+import type { ProcedureCaller } from './procedure-caller';
+export declare const LAZY_LOADER_SYMBOL: unique symbol;
+export interface Lazy<T> {
+    [LAZY_LOADER_SYMBOL]: () => Promise<{
+        default: T;
+    }>;
+}
+export type ANY_LAZY = Lazy<any>;
+export declare function createLazy<T>(loader: () => Promise<{
+    default: T;
+}>): Lazy<T>;
+export declare function loadLazy<T>(lazy: Lazy<T>): Promise<{
+    default: T;
+}>;
+export declare function isLazy(item: unknown): item is ANY_LAZY;
+export type FlattenLazy<T> = T extends Lazy<infer U> ? FlattenLazy<U> : Lazy<T>;
+export declare function createFlattenLazy<T>(lazy: Lazy<T>): FlattenLazy<T>;
+export type DecoratedLazy<T> = T extends Lazy<infer U> ? DecoratedLazy<U> : (T extends Procedure<infer UContext, any, any, any, any> ? Lazy<T> & (undefined extends UContext ? ProcedureCaller<T> : unknown) : T extends Record<any, any> ? {
+    [K in keyof T]: DecoratedLazy<T[K]>;
+} /** Notice: this still a lazy, but type not work when I & Lazy<T>, maybe it's a bug, should improve */ : Lazy<T>);
+export declare function decorateLazy<T>(lazy: Lazy<T>): DecoratedLazy<T>;
+//# sourceMappingURL=lazy.d.ts.map

package/dist/src/procedure-caller.d.ts

@@ -1,19 +1,26 @@
 import type { SchemaInput, SchemaOutput } from '@orpc/contract';
-import type { Procedure } from './procedure';
-import { type Value } from '@orpc/shared';
-export interface CreateProcedureCallerOptions<TProcedure extends Procedure<any, any, any, any, any>> {
-    procedure: TProcedure;
-    /**
-     * The context used when calling the procedure.
-     */
-    context: Value<TProcedure extends Procedure<infer UContext, any, any, any, any> ? UContext : never>;
+import type { Hooks, PartialOnUndefinedDeep, Value } from '@orpc/shared';
+import type { Lazy } from './lazy';
+import type { ANY_LAZY_PROCEDURE, ANY_PROCEDURE, Procedure } from './procedure';
+import type { Caller } from './types';
+export type CreateProcedureCallerOptions<T extends ANY_PROCEDURE | ANY_LAZY_PROCEDURE> = T extends Procedure<infer UContext, any, any, infer UOutputSchema, infer UFuncOutput> | Lazy<Procedure<infer UContext, any, any, infer UOutputSchema, infer UFuncOutput>> ? {
+    procedure: T;
     /**
      * This is helpful for logging and analytics.
      *
      * @internal
      */
     path?: string[];
-}
-export type ProcedureCaller<TProcedure extends Procedure<any, any, any, any, any>> = TProcedure extends Procedure<any, any, infer UInputSchema, infer UOutputSchema, infer UFuncOutput> ? (...input: [input: SchemaInput<UInputSchema> | FormData] | (undefined extends SchemaInput<UInputSchema> ? [] : never)) => Promise<SchemaOutput<UOutputSchema, UFuncOutput>> : never;
-export declare function createProcedureCaller<TProcedure extends Procedure<any, any, any, any, any>>(options: CreateProcedureCallerOptions<TProcedure>): ProcedureCaller<TProcedure>;
+} & PartialOnUndefinedDeep<{
+    /**
+     * The context used when calling the procedure.
+     */
+    context: Value<UContext>;
+}> & Hooks<unknown, SchemaOutput<UOutputSchema, UFuncOutput>, UContext, {
+    path: string[];
+    procedure: ANY_PROCEDURE;
+}> : never;
+export type ProcedureCaller<TProcedure extends ANY_PROCEDURE | ANY_LAZY_PROCEDURE> = TProcedure extends Procedure<any, any, infer UInputSchema, infer UOutputSchema, infer UFuncOutput> | Lazy<Procedure<any, any, infer UInputSchema, infer UOutputSchema, infer UFuncOutput>> ? Caller<SchemaInput<UInputSchema>, SchemaOutput<UOutputSchema, UFuncOutput>> : never;
+export declare function createProcedureCaller<TProcedure extends ANY_PROCEDURE | ANY_LAZY_PROCEDURE>(options: CreateProcedureCallerOptions<TProcedure>): ProcedureCaller<TProcedure>;
+export declare function loadProcedure(procedure: ANY_PROCEDURE | ANY_LAZY_PROCEDURE): Promise<ANY_PROCEDURE>;
 //# sourceMappingURL=procedure-caller.d.ts.map

package/dist/src/procedure-implementer.d.ts

@@ -1,7 +1,8 @@
 import type { ContractProcedure, Schema, SchemaInput, SchemaOutput } from '@orpc/contract';
+import type { DecoratedLazy } from './lazy';
+import type { DecoratedProcedure, Procedure, ProcedureFunc } from './procedure';
 import type { Context, MergeContext } from './types';
 import { type MapInputMiddleware, type Middleware } from './middleware';
-import { type DecoratedProcedure, type ProcedureFunc } from './procedure';
 export declare class ProcedureImplementer<TContext extends Context, TExtraContext extends Context, TInputSchema extends Schema, TOutputSchema extends Schema> {
     zz$pi: {
         contract: ContractProcedure<TInputSchema, TOutputSchema>;
@@ -14,5 +15,8 @@ export declare class ProcedureImplementer<TContext extends Context, TExtraContex
     use<UExtraContext extends Partial<MergeContext<Context, MergeContext<TContext, TExtraContext>>> | undefined = undefined>(middleware: Middleware<MergeContext<TContext, TExtraContext>, UExtraContext, SchemaOutput<TInputSchema>, SchemaInput<TOutputSchema>>): ProcedureImplementer<TContext, MergeContext<TExtraContext, UExtraContext>, TInputSchema, TOutputSchema>;
     use<UExtraContext extends Partial<MergeContext<Context, MergeContext<TContext, TExtraContext>>> | undefined = undefined, UMappedInput = unknown>(middleware: Middleware<MergeContext<TContext, TExtraContext>, UExtraContext, UMappedInput, SchemaInput<TOutputSchema>>, mapInput: MapInputMiddleware<SchemaOutput<TInputSchema>, UMappedInput>): ProcedureImplementer<TContext, MergeContext<TExtraContext, UExtraContext>, TInputSchema, TOutputSchema>;
     func<UFuncOutput extends SchemaOutput<TOutputSchema>>(func: ProcedureFunc<TContext, TExtraContext, TInputSchema, TOutputSchema, UFuncOutput>): DecoratedProcedure<TContext, TExtraContext, TInputSchema, TOutputSchema, UFuncOutput>;
+    lazy<U extends Procedure<TContext, TExtraContext, TInputSchema, TOutputSchema, SchemaOutput<TOutputSchema>>>(loader: () => Promise<{
+        default: U;
+    }>): DecoratedLazy<U>;
 }
 //# sourceMappingURL=procedure-implementer.d.ts.map

package/dist/src/procedure.d.ts

@@ -1,4 +1,5 @@
 import type { Promisable } from '@orpc/shared';
+import type { Lazy } from './lazy';
 import type { ProcedureCaller } from './procedure-caller';
 import type { Context, MergeContext, Meta } from './types';
 import { type ContractProcedure, type HTTPPath, type RouteOptions, type Schema, type SchemaInput, type SchemaOutput } from '@orpc/contract';
@@ -15,6 +16,9 @@ export declare class Procedure<TContext extends Context, TExtraContext extends C
         func: ProcedureFunc<TContext, TExtraContext, TInputSchema, TOutputSchema, TFuncOutput>;
     });
 }
+export type ANY_PROCEDURE = Procedure<any, any, any, any, any>;
+export type WELL_DEFINED_PROCEDURE = Procedure<Context, Context, Schema, Schema, unknown>;
+export type ANY_LAZY_PROCEDURE = Lazy<ANY_PROCEDURE>;
 export type DecoratedProcedure<TContext extends Context, TExtraContext extends Context, TInputSchema extends Schema, TOutputSchema extends Schema, TFuncOutput extends SchemaOutput<TOutputSchema>> = Procedure<TContext, TExtraContext, TInputSchema, TOutputSchema, TFuncOutput> & {
     prefix: (prefix: HTTPPath) => DecoratedProcedure<TContext, TExtraContext, TInputSchema, TOutputSchema, TFuncOutput>;
     route: (opts: RouteOptions) => DecoratedProcedure<TContext, TExtraContext, TInputSchema, TOutputSchema, TFuncOutput>;
@@ -24,6 +28,5 @@ export interface ProcedureFunc<TContext extends Context, TExtraContext extends C
     (input: SchemaOutput<TInputSchema>, context: MergeContext<TContext, TExtraContext>, meta: Meta): Promisable<SchemaInput<TOutputSchema, TOutput>>;
 }
 export declare function decorateProcedure<TContext extends Context, TExtraContext extends Context, TInputSchema extends Schema, TOutputSchema extends Schema, TFuncOutput extends SchemaOutput<TOutputSchema>>(procedure: Procedure<TContext, TExtraContext, TInputSchema, TOutputSchema, TFuncOutput>): DecoratedProcedure<TContext, TExtraContext, TInputSchema, TOutputSchema, TFuncOutput>;
-export type WELL_DEFINED_PROCEDURE = Procedure<Context, Context, Schema, Schema, unknown>;
-export declare function isProcedure(item: unknown): item is WELL_DEFINED_PROCEDURE;
+export declare function isProcedure(item: unknown): item is ANY_PROCEDURE;
 //# sourceMappingURL=procedure.d.ts.map

package/dist/src/router-builder.d.ts

@@ -1,7 +1,9 @@
+import type { DecoratedLazy } from './lazy';
 import type { HandledRouter, Router } from './router';
 import type { Context, MergeContext } from './types';
 import { type HTTPPath } from '@orpc/contract';
 import { type MapInputMiddleware, type Middleware } from './middleware';
+export declare const LAZY_ROUTER_PREFIX_SYMBOL: unique symbol;
 export declare class RouterBuilder<TContext extends Context, TExtraContext extends Context> {
     zz$rb: {
         prefix?: HTTPPath;
@@ -18,5 +20,8 @@ export declare class RouterBuilder<TContext extends Context, TExtraContext exten
     use<UExtraContext extends Partial<MergeContext<Context, MergeContext<TContext, TExtraContext>>> | undefined = undefined>(middleware: Middleware<MergeContext<TContext, TExtraContext>, UExtraContext, unknown, unknown>): RouterBuilder<TContext, MergeContext<TExtraContext, UExtraContext>>;
     use<UExtraContext extends Partial<MergeContext<Context, MergeContext<TContext, TExtraContext>>> | undefined = undefined, UMappedInput = unknown>(middleware: Middleware<MergeContext<TContext, TExtraContext>, UExtraContext, UMappedInput, unknown>, mapInput: MapInputMiddleware<unknown, UMappedInput>): RouterBuilder<TContext, MergeContext<TExtraContext, UExtraContext>>;
     router<URouter extends Router<TContext>>(router: URouter): HandledRouter<URouter>;
+    lazy<U extends Router<TContext>>(loader: () => Promise<{
+        default: U;
+    }>): DecoratedLazy<U>;
 }
 //# sourceMappingURL=router-builder.d.ts.map