@orpc/contract 1.14.6 → 2.0.0-beta.2

package/dist/index.d.ts

@@ -1,328 +1,181 @@
-import { HTTPPath, HTTPMethod, ClientContext, Client } from '@orpc/client';
-export { HTTPMethod, HTTPPath, ORPCError } from '@orpc/client';
-import { E as ErrorMap, a as EnhanceRouteOptions, A as AnyContractRouter, C as ContractProcedure, M as MergedErrorMap, b as AnySchema, c as Meta, R as Route, d as ContractRouter, e as ContractProcedureDef, S as Schema, I as InputStructure, O as OutputStructure, f as InferSchemaInput, g as InferSchemaOutput, h as ErrorFromErrorMap, i as SchemaIssue } from './shared/contract.TuRtB1Ca.js';
-export { o as AnyContractProcedure, k as ErrorMapItem, z as InferContractRouterErrorMap, x as InferContractRouterInputs, B as InferContractRouterMeta, y as InferContractRouterOutputs, l as ORPCErrorFromErrorMap, T as TypeRest, j as ValidationError, V as ValidationErrorOptions, w as enhanceRoute, p as isContractProcedure, m as mergeErrorMap, n as mergeMeta, s as mergePrefix, q as mergeRoute, t as mergeTags, r as prefixRoute, D as type, u as unshiftTagRoute, v as validateORPCError } from './shared/contract.TuRtB1Ca.js';
-import { AsyncIteratorClass } from '@orpc/shared';
-export { AsyncIteratorClass, Registry, ThrowableError } from '@orpc/shared';
-export { OpenAPIV3_1 as OpenAPI } from 'openapi-types';
+import { E as ErrorMap, A as AnySchema, P as ProcedureContract, M as MetaPlugin, a as MergedSchema, b as Meta, c as AnyMetaPlugin, R as RouterContract, d as AnyProcedureContract, S as Schema, I as InferSchemaInput, e as InferSchemaOutput, O as ORPCErrorFromErrorMap, f as SchemaIssue } from './shared/contract.Do92aRJ4.js';
+export { g as ErrorMapItem, H as HIDDEN_META_PLUGINS_SYMBOL, h as InferRouterContractError, i as InferRouterContractErrorMap, j as InferRouterContractErrors, k as InferRouterContractInputs, l as InferRouterContractOutputs, m as MetaPluginDefinition, n as ProcedureContractDefinition, V as ValidationError, o as ValidationErrorOptions, p as getHiddenMetaPlugins, s as setHiddenMetaPlugins } from './shared/contract.Do92aRJ4.js';
+import { AnyORPCError, ClientContext, Client, ClientRest, ThrowableError as ThrowableError$1, ORPCClientOptions, ClientLink } from '@orpc/client';
+import { ThrowableError, PromiseWithError, AsyncIteratorClass, Promisable, IsEqual } from '@orpc/shared';
+export { Registry, ThrowableError } from '@orpc/shared';
 import '@standard-schema/spec';
 
-declare function getContractRouter(router: AnyContractRouter, path: readonly string[]): AnyContractRouter | undefined;
-type EnhancedContractRouter<T extends AnyContractRouter, TErrorMap extends ErrorMap> = T extends ContractProcedure<infer UInputSchema, infer UOutputSchema, infer UErrors, infer UMeta> ? ContractProcedure<UInputSchema, UOutputSchema, MergedErrorMap<TErrorMap, UErrors>, UMeta> : {
-    [K in keyof T]: T[K] extends AnyContractRouter ? EnhancedContractRouter<T[K], TErrorMap> : never;
-};
-interface EnhanceContractRouterOptions<TErrorMap extends ErrorMap> extends EnhanceRouteOptions {
-    errorMap: TErrorMap;
+type MergedErrorMap<T1 extends ErrorMap, T2 extends ErrorMap> = keyof T1 extends never | keyof T2 ? T2 : Omit<T1, keyof T2> & T2;
+declare function mergeErrorMap<T1 extends ErrorMap = object, T2 extends ErrorMap = object>(errorMap1: T1 | undefined, errorMap2: T2 | undefined): MergedErrorMap<T1, T2>;
+declare function reconcileORPCError(map: ErrorMap, error: AnyORPCError): Promise<AnyORPCError>;
+
+interface ProcedureContractBuilderWithInput<TInputSchema extends AnySchema, TErrorMap extends ErrorMap> extends ProcedureContract<TInputSchema, InitialOutputSchema, TErrorMap> {
+    meta(...plugins: MetaPlugin<TInputSchema, InitialOutputSchema, TErrorMap>[]): ProcedureContractBuilderWithInput<TInputSchema, TErrorMap>;
+    errors<T extends ErrorMap>(errors: T): ProcedureContractBuilderWithInput<TInputSchema, MergedErrorMap<TErrorMap, T>>;
+    input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInput<MergedSchema<T, TInputSchema>, TErrorMap>;
+    output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<TInputSchema, T, TErrorMap>;
 }
-declare function enhanceContractRouter<T extends AnyContractRouter, TErrorMap extends ErrorMap>(router: T, options: EnhanceContractRouterOptions<TErrorMap>): EnhancedContractRouter<T, TErrorMap>;
-/**
- * Minify a contract router into a smaller object.
- *
- * You should export the result to a JSON file. On the client side, you can import this JSON file and use it as a contract router.
- * This reduces the size of the contract and helps prevent leaking internal details of the router to the client.
- *
- * @see {@link https://orpc.dev/docs/contract-first/router-to-contract#minify-export-the-contract-router-for-the-client Router to Contract Docs}
- */
-declare function minifyContractRouter(router: AnyContractRouter): AnyContractRouter;
-type PopulatedContractRouterPaths<T extends AnyContractRouter> = T extends ContractProcedure<infer UInputSchema, infer UOutputSchema, infer UErrors, infer UMeta> ? ContractProcedure<UInputSchema, UOutputSchema, UErrors, UMeta> : {
-    [K in keyof T]: T[K] extends AnyContractRouter ? PopulatedContractRouterPaths<T[K]> : never;
+interface ProcedureContractBuilderWithOutput<TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> extends ProcedureContract<InitialInputSchema, TOutputSchema, TErrorMap> {
+    meta(...plugins: MetaPlugin<InitialInputSchema, TOutputSchema, TErrorMap>[]): ProcedureContractBuilderWithOutput<TOutputSchema, TErrorMap>;
+    errors<T extends ErrorMap>(errors: T): ProcedureContractBuilderWithOutput<TOutputSchema, MergedErrorMap<TErrorMap, T>>;
+    input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<T, TOutputSchema, TErrorMap>;
+    output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithOutput<MergedSchema<T, TOutputSchema>, TErrorMap>;
+}
+interface ProcedureContractBuilderWithInputOutput<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> extends ProcedureContract<TInputSchema, TOutputSchema, TErrorMap> {
+    meta(...plugins: MetaPlugin<TInputSchema, TOutputSchema, TErrorMap>[]): ProcedureContractBuilderWithInputOutput<TInputSchema, TOutputSchema, TErrorMap>;
+    errors<T extends ErrorMap>(errors: T): ProcedureContractBuilderWithInputOutput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, T>>;
+    input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<MergedSchema<T, TInputSchema>, TOutputSchema, TErrorMap>;
+    output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<TInputSchema, MergedSchema<T, TOutputSchema>, TErrorMap>;
+}
+
+type AugmentedContractRouter<T extends RouterContract, TErrorMap extends ErrorMap> = T extends ProcedureContract<infer $InputSchema, infer $OutputSchema, infer $Errors> ? ProcedureContract<$InputSchema, $OutputSchema, MergedErrorMap<TErrorMap, $Errors>> : {
+    [K in keyof T]: T[K] extends RouterContract ? AugmentedContractRouter<T[K], TErrorMap> : never;
 };
-interface PopulateContractRouterPathsOptions {
-    path?: readonly string[];
+interface AugmentContractRouterOptions<TErrorMap extends ErrorMap> {
+    meta: Meta;
+    metaPlugins?: AnyMetaPlugin[] | undefined;
+    errorMap: TErrorMap;
 }
 /**
- * Automatically populates missing route paths using the router's nested keys.
- *
- * Constructs paths by joining router keys with `/`.
- * Useful for NestJS integration that require explicit route paths.
- *
- * @see {@link https://orpc.dev/docs/openapi/integrations/implement-contract-in-nest#define-your-contract NestJS Implement Contract Docs}
+ * Add capabilities without changing identity of the router contract
  */
-declare function populateContractRouterPaths<T extends AnyContractRouter>(router: T, options?: PopulateContractRouterPathsOptions): PopulatedContractRouterPaths<T>;
+declare function augmentContractRouter<T extends RouterContract, TErrorMap extends ErrorMap>(router: T, options: AugmentContractRouterOptions<TErrorMap>): AugmentedContractRouter<T, TErrorMap>;
+declare function getRouterContract(router: RouterContract, path: readonly string[]): RouterContract | undefined;
+declare function getProcedureContractOrThrow(router: RouterContract, path: readonly string[]): AnyProcedureContract;
+declare function minifyRouterContract(router: RouterContract): RouterContract;
 
-interface ContractProcedureBuilder<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
-    /**
-     * Adds type-safe custom errors to the contract.
-     * The provided errors are spared-merged with any existing errors in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
-     */
-    errors<U extends ErrorMap>(errors: U): ContractProcedureBuilder<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
-    /**
-     * Sets or updates the metadata for the contract.
-     * The provided metadata is spared-merged with any existing metadata in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/metadata Metadata Docs}
-     */
-    meta(meta: TMeta): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Sets or updates the route definition for the contract.
-     * The provided route is spared-merged with any existing route in the contract.
-     * This option is typically relevant when integrating with OpenAPI.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}
-     * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
-     */
-    route(route: Route): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Defines the input validation schema for the contract.
-     *
-     * @see {@link https://orpc.dev/docs/procedure#input-output-validation Input Validation Docs}
-     */
-    input<U extends AnySchema>(schema: U): ContractProcedureBuilderWithInput<U, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Defines the output validation schema for the contract.
-     *
-     * @see {@link https://orpc.dev/docs/procedure#input-output-validation Output Validation Docs}
-     */
-    output<U extends AnySchema>(schema: U): ContractProcedureBuilderWithOutput<TInputSchema, U, TErrorMap, TMeta>;
-}
-interface ContractProcedureBuilderWithInput<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
-    /**
-     * Adds type-safe custom errors to the contract.
-     * The provided errors are spared-merged with any existing errors in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
-     */
-    errors<U extends ErrorMap>(errors: U): ContractProcedureBuilderWithInput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
-    /**
-     * Sets or updates the metadata for the contract.
-     * The provided metadata is spared-merged with any existing metadata in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/metadata Metadata Docs}
-     */
-    meta(meta: TMeta): ContractProcedureBuilderWithInput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Sets or updates the route definition for the contract.
-     * The provided route is spared-merged with any existing route in the contract.
-     * This option is typically relevant when integrating with OpenAPI.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}
-     * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
-     */
-    route(route: Route): ContractProcedureBuilderWithInput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Defines the output validation schema for the contract.
-     *
-     * @see {@link https://orpc.dev/docs/procedure#input-output-validation Output Validation Docs}
-     */
-    output<U extends AnySchema>(schema: U): ContractProcedureBuilderWithInputOutput<TInputSchema, U, TErrorMap, TMeta>;
-}
-interface ContractProcedureBuilderWithOutput<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
-    /**
-     * Adds type-safe custom errors to the contract.
-     * The provided errors are spared-merged with any existing errors in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
-     */
-    errors<U extends ErrorMap>(errors: U): ContractProcedureBuilderWithOutput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
-    /**
-     * Sets or updates the metadata for the contract.
-     * The provided metadata is spared-merged with any existing metadata in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/metadata Metadata Docs}
-     */
-    meta(meta: TMeta): ContractProcedureBuilderWithOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Sets or updates the route definition for the contract.
-     * The provided route is spared-merged with any existing route in the contract.
-     * This option is typically relevant when integrating with OpenAPI.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}
-     * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
-     */
-    route(route: Route): ContractProcedureBuilderWithOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Defines the input validation schema for the contract.
-     *
-     * @see {@link https://orpc.dev/docs/procedure#input-output-validation Input Validation Docs}
-     */
-    input<U extends AnySchema>(schema: U): ContractProcedureBuilderWithInputOutput<U, TOutputSchema, TErrorMap, TMeta>;
-}
-interface ContractProcedureBuilderWithInputOutput<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
-    /**
-     * Adds type-safe custom errors to the contract.
-     * The provided errors are spared-merged with any existing errors in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
-     */
-    errors<U extends ErrorMap>(errors: U): ContractProcedureBuilderWithInputOutput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
-    /**
-     * Sets or updates the metadata for the contract.
-     * The provided metadata is spared-merged with any existing metadata in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/metadata Metadata Docs}
-     */
-    meta(meta: TMeta): ContractProcedureBuilderWithInputOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Sets or updates the route definition for the contract.
-     * The provided route is spared-merged with any existing route in the contract.
-     * This option is typically relevant when integrating with OpenAPI.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}
-     * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
-     */
-    route(route: Route): ContractProcedureBuilderWithInputOutput<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-}
-interface ContractRouterBuilder<TErrorMap extends ErrorMap, TMeta extends Meta> {
-    /**
-     * This property holds the defined options for the contract router.
-     */
-    '~orpc': EnhanceContractRouterOptions<TErrorMap>;
-    /**
-     * Adds type-safe custom errors to the contract.
-     * The provided errors are spared-merged with any existing errors in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
-     */
-    'errors'<U extends ErrorMap>(errors: U): ContractRouterBuilder<MergedErrorMap<TErrorMap, U>, TMeta>;
-    /**
-     * Prefixes all procedures in the contract router.
-     * The provided prefix is post-appended to any existing router prefix.
-     *
-     * @note This option does not affect procedures that do not define a path in their route definition.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/routing#route-prefixes OpenAPI Route Prefixes Docs}
-     */
-    'prefix'(prefix: HTTPPath): ContractRouterBuilder<TErrorMap, TMeta>;
-    /**
-     * Adds tags to all procedures in the contract router.
-     * This helpful when you want to group procedures together in the OpenAPI specification.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
-     */
-    'tag'(...tags: string[]): ContractRouterBuilder<TErrorMap, TMeta>;
-    /**
-     * Applies all of the previously defined options to the specified contract router.
-     *
-     * @see {@link https://orpc.dev/docs/router#extending-router Extending Router Docs}
-     */
-    'router'<T extends ContractRouter<TMeta>>(router: T): EnhancedContractRouter<T, TErrorMap>;
+type InitialInputSchema = Schema<void, unknown>;
+type InitialOutputSchema = Schema<unknown>;
+declare class ContractBuilder<TErrorMap extends ErrorMap> extends ProcedureContract<InitialInputSchema, InitialOutputSchema, TErrorMap> {
+    /**
+     * Private constructor to prevent direct instantiation.
+     * Use the static `create` method to initialize a new instance with a safe initial definition.
+     */
+    private constructor();
+    static create(): ContractBuilder<object>;
+    meta(...plugins: MetaPlugin<InitialInputSchema, InitialOutputSchema, TErrorMap>[]): ContractBuilder<TErrorMap>;
+    errors<T extends ErrorMap>(errors: T): ContractBuilder<MergedErrorMap<TErrorMap, T>>;
+    input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInput<T, TErrorMap>;
+    output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithOutput<T, TErrorMap>;
+    router<T extends RouterContract>(router: T): AugmentedContractRouter<T, TErrorMap>;
 }
+declare const oc: ContractBuilder<object>;
+
+type ProcedureContractClient<TClientContext extends ClientContext, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> = Client<TClientContext, InferSchemaInput<TInputSchema>, InferSchemaOutput<TOutputSchema>, ORPCErrorFromErrorMap<TErrorMap> | ThrowableError>;
 
-interface ContractBuilderDef<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedureDef<TInputSchema, TOutputSchema, TErrorMap, TMeta>, EnhanceContractRouterOptions<TErrorMap> {
+type RouterContractClient<TRouter extends RouterContract, TClientContext extends ClientContext = object> = TRouter extends ProcedureContract<infer UInputSchema, infer UOutputSchema, infer UErrorMap> ? ProcedureContractClient<TClientContext, UInputSchema, UOutputSchema, UErrorMap> : {
+    [K in keyof TRouter]: TRouter[K] extends RouterContract ? RouterContractClient<TRouter[K], TClientContext> : never;
+};
+
+interface ContractCaller<TClientContext extends ClientContext> {
+    <TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap>(procedure: ProcedureContract<TInputSchema, TOutputSchema, TErrorMap>, ...rest: ClientRest<TClientContext, InferSchemaInput<TInputSchema>>): PromiseWithError<InferSchemaOutput<TOutputSchema>, ORPCErrorFromErrorMap<TErrorMap> | ThrowableError$1>;
 }
-declare class ContractBuilder<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta> extends ContractProcedure<TInputSchema, TOutputSchema, TErrorMap, TMeta> {
-    /**
-     * This property holds the defined options for the contract.
-     */
-    '~orpc': ContractBuilderDef<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    constructor(def: ContractBuilderDef<TInputSchema, TOutputSchema, TErrorMap, TMeta>);
-    /**
-     * Sets or overrides the initial meta.
-     *
-     * @see {@link https://orpc.dev/docs/metadata Metadata Docs}
-     */
-    $meta<U extends Meta>(initialMeta: U): ContractBuilder<TInputSchema, TOutputSchema, TErrorMap, U & Record<never, never>>;
-    /**
-     * Sets or overrides the initial route.
-     * This option is typically relevant when integrating with OpenAPI.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}
-     * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
-     */
-    $route(initialRoute: Route): ContractBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Sets or overrides the initial input schema.
-     *
-     * @see {@link https://orpc.dev/docs/procedure#initial-configuration Initial Procedure Configuration Docs}
-     */
-    $input<U extends AnySchema>(initialInputSchema?: U): ContractBuilder<U, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Adds type-safe custom errors to the contract.
-     * The provided errors are spared-merged with any existing errors in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
-     */
-    errors<U extends ErrorMap>(errors: U): ContractBuilder<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, U>, TMeta>;
-    /**
-     * Sets or updates the metadata for the contract.
-     * The provided metadata is spared-merged with any existing metadata in the contract.
-     *
-     * @see {@link https://orpc.dev/docs/metadata Metadata Docs}
-     */
-    meta(meta: TMeta): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Sets or updates the route definition for the contract.
-     * The provided route is spared-merged with any existing route in the contract.
-     * This option is typically relevant when integrating with OpenAPI.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/routing OpenAPI Routing Docs}
-     * @see {@link https://orpc.dev/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
-     */
-    route(route: Route): ContractProcedureBuilder<TInputSchema, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Defines the input validation schema for the contract.
-     *
-     * @see {@link https://orpc.dev/docs/procedure#input-output-validation Input Validation Docs}
-     */
-    input<U extends AnySchema>(schema: U): ContractProcedureBuilderWithInput<U, TOutputSchema, TErrorMap, TMeta>;
-    /**
-     * Defines the output validation schema for the contract.
-     *
-     * @see {@link https://orpc.dev/docs/procedure#input-output-validation Output Validation Docs}
-     */
-    output<U extends AnySchema>(schema: U): ContractProcedureBuilderWithOutput<TInputSchema, U, TErrorMap, TMeta>;
+interface ContractCallerOptions<TClientContext extends ClientContext> extends Pick<ORPCClientOptions<RouterContractClient<RouterContract, TClientContext>>, 'interceptors' | 'scoped'> {
     /**
-     * Prefixes all procedures in the contract router.
-     * The provided prefix is post-appended to any existing router prefix.
-     *
-     * @note This option does not affect procedures that do not define a path in their route definition.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/routing#route-prefixes OpenAPI Route Prefixes Docs}
+     * An optional reference to the root router-contract.
+     * When provided, the caller will automatically register the called procedure-contract
+     * into the router at the path defined by `meta.path`.
      */
-    prefix(prefix: HTTPPath): ContractRouterBuilder<TErrorMap, TMeta>;
-    /**
-     * Adds tags to all procedures in the contract router.
-     * This helpful when you want to group procedures together in the OpenAPI specification.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
-     */
-    tag(...tags: string[]): ContractRouterBuilder<TErrorMap, TMeta>;
-    /**
-     * Applies all of the previously defined options to the specified contract router.
-     *
-     * @see {@link https://orpc.dev/docs/router#extending-router Extending Router Docs}
-     */
-    router<T extends ContractRouter<TMeta>>(router: T): EnhancedContractRouter<T, TErrorMap>;
+    contractRef?: undefined | RouterContract;
 }
-declare const oc: ContractBuilder<Schema<unknown, unknown>, Schema<unknown, unknown>, Record<never, never>, Record<never, never>>;
-
-interface ContractConfig {
-    defaultMethod: HTTPMethod;
-    defaultSuccessStatus: number;
-    defaultSuccessDescription: string;
-    defaultInputStructure: InputStructure;
-    defaultOutputStructure: OutputStructure;
-}
-declare function fallbackContractConfig<T extends keyof ContractConfig>(key: T, value: ContractConfig[T] | undefined): ContractConfig[T];
+declare function createContractCaller<TClientContext extends ClientContext>(link: ClientLink<TClientContext>, options?: ContractCallerOptions<TClientContext>): ContractCaller<TClientContext>;
 
 interface EventIteratorSchemaDetails {
-    yields: AnySchema;
-    returns?: AnySchema;
+    yieldSchema: AnySchema;
+    returnSchema?: AnySchema;
 }
 /**
  * Define schema for an event iterator.
  *
  * @see {@link https://orpc.dev/docs/event-iterator#validate-event-iterator Validate Event Iterator Docs}
  */
-declare function eventIterator<TYieldIn, TYieldOut, TReturnIn = unknown, TReturnOut = unknown>(yields: Schema<TYieldIn, TYieldOut>, returns?: Schema<TReturnIn, TReturnOut>): Schema<AsyncIteratorObject<TYieldIn, TReturnIn, void>, AsyncIteratorClass<TYieldOut, TReturnOut, void>>;
+declare function eventIterator<TYieldIn, TYieldOut, TReturnIn = unknown, TReturnOut = unknown>(yieldSchema: Schema<TYieldIn, TYieldOut>, returnSchema?: Schema<TReturnIn, TReturnOut>): Schema<AsyncIteratorObject<TYieldIn, TReturnIn, void>, AsyncIteratorClass<TYieldOut, TReturnOut, void>>;
 declare function getEventIteratorSchemaDetails(schema: AnySchema | undefined): undefined | EventIteratorSchemaDetails;
 
+interface PathMetaPlugin<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> extends MetaPlugin<TInputSchema, TOutputSchema, TErrorMap> {
+    name: '~path';
+}
+declare const meta: {
+    path<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap>(path: string[]): PathMetaPlugin<TInputSchema, TOutputSchema, TErrorMap>;
+};
+declare function getPathMeta(procedureOrLazy: {
+    '~orpc': {
+        meta: Meta;
+    };
+}): string[] | undefined;
+
+declare function resolveMetaPlugins<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap>(baseMeta: Meta, existingPlugins: MetaPlugin<TInputSchema, TOutputSchema, TErrorMap>[] | undefined, incomingPlugins: MetaPlugin<TInputSchema, TOutputSchema, TErrorMap>[] | undefined): [meta: Meta, plugins: MetaPlugin<TInputSchema, TOutputSchema, TErrorMap>[]];
 /**
- * Help RPCLink automatically send requests using the specified HTTP method in the contract.
+ * Quickly defines a meta plugin factory and reader.
+ *
+ * @example Mark a procedure as requiring authentication and read it in middleware.
+ * ```ts
+ * interface AuthMeta {
+ *   required?: boolean
+ *   scope?: 'user' | 'admin'
+ * }
+ *
+ * const [authMeta, getAuthMeta] = defineMeta(
+ *   'auth',
+ *   (incoming: AuthMeta, current) => ({ ...current, ...incoming }),
+ * )
+ *
+ * const deletePostContract = oc
+ *   .meta(authMeta({ required: true, scope: 'admin' }))
+ *   .input(z.object({ postId: z.string() }))
+ *   .output(z.object({ success: z.boolean() }))
+ *
+ * const authMiddleware = os.middleware(async ({ context, procedure, next }) => {
+ *   const auth = getAuthMeta(procedure)
  *
- * @see {@link https://orpc.dev/docs/client/rpc-link#custom-request-method RPCLink Custom Request Method}
+ *   if (auth?.required && !context.user) {
+ *     throw new ORPCError('UNAUTHORIZED')
+ *   }
+ *
+ *   if (auth?.scope === 'admin' && !context.user?.isAdmin) {
+ *     throw new ORPCError('FORBIDDEN')
+ *   }
+ *
+ *   return next()
+ * })
+ * ```
+ *
+ * @param name - Unique key for storing this meta entry.
+ * @param merge - Merges the existing value (or `undefined`) with the incoming value when applied multiple times.
+ *
+ * @returns A `[metaPlugin, getMeta]` tuple:
+ *   - `metaPlugin(metadata)` - Attaches metadata to a procedure under `name`.
+ *   - `getMeta(procedureOrLazy)` - Retrieves the metadata, or `undefined` if not set.
  */
-declare function inferRPCMethodFromContractRouter(contract: AnyContractRouter): (options: unknown, path: readonly string[]) => Exclude<HTTPMethod, 'HEAD'>;
-
-type ContractProcedureClient<TClientContext extends ClientContext, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> = Client<TClientContext, InferSchemaInput<TInputSchema>, InferSchemaOutput<TOutputSchema>, ErrorFromErrorMap<TErrorMap>>;
-
-type ContractRouterClient<TRouter extends AnyContractRouter, TClientContext extends ClientContext = Record<never, never>> = TRouter extends ContractProcedure<infer UInputSchema, infer UOutputSchema, infer UErrorMap, any> ? ContractProcedureClient<TClientContext, UInputSchema, UOutputSchema, UErrorMap> : {
-    [K in keyof TRouter]: TRouter[K] extends AnyContractRouter ? ContractRouterClient<TRouter[K], TClientContext> : never;
-};
+declare function defineMeta<TName extends string, TData>(name: TName, merge: (incoming: TData, current: TData | undefined) => TData): [
+    metaPlugin: (meta: TData) => AnyMetaPlugin & {
+        name: TName;
+    },
+    getMeta: (procedureOrLazy: {
+        '~orpc': {
+            meta: Meta;
+        };
+    }) => TData | undefined
+];
 
+type TypeRest<TInput, TOutput> = [map: (input: TInput) => Promisable<TOutput>] | (IsEqual<TInput, TOutput> extends true ? [] : never);
+/**
+ * Create a schema for things can be trust without validation.
+ * You can optionally pass a map function for mapping
+ *
+ * @example
+ * ```ts
+ * const normal = type<number>()
+ * const withMap = type<number, string>(input => input.toString())
+ *```
+ *
+ * @see {@link https://orpc.dev/docs/procedure#type-utility Type Utility Docs}
+ */
+declare function type<TInput, TOutput = TInput>(...[map]: TypeRest<TInput, TOutput>): Schema<TInput, TOutput>;
+/**
+ * Check if the given issue is following the standard-schema issue format.
+ */
 declare function isSchemaIssue(issue: unknown): issue is SchemaIssue;
 
-export { AnyContractRouter, AnySchema, ContractBuilder, ContractProcedure, ContractProcedureDef, ContractRouter, EnhanceRouteOptions, ErrorFromErrorMap, ErrorMap, InferSchemaInput, InferSchemaOutput, InputStructure, MergedErrorMap, Meta, OutputStructure, Route, Schema, SchemaIssue, enhanceContractRouter, eventIterator, fallbackContractConfig, getContractRouter, getEventIteratorSchemaDetails, inferRPCMethodFromContractRouter, isSchemaIssue, minifyContractRouter, oc, populateContractRouterPaths };
-export type { ContractBuilderDef, ContractConfig, ContractProcedureBuilder, ContractProcedureBuilderWithInput, ContractProcedureBuilderWithInputOutput, ContractProcedureBuilderWithOutput, ContractProcedureClient, ContractRouterBuilder, ContractRouterClient, EnhanceContractRouterOptions, EnhancedContractRouter, EventIteratorSchemaDetails, PopulateContractRouterPathsOptions, PopulatedContractRouterPaths };
+export { AnyMetaPlugin, AnyProcedureContract, AnySchema, ContractBuilder, ErrorMap, InferSchemaInput, InferSchemaOutput, MergedSchema, Meta, MetaPlugin, ORPCErrorFromErrorMap, ProcedureContract, RouterContract, Schema, SchemaIssue, augmentContractRouter, createContractCaller, defineMeta, eventIterator, getEventIteratorSchemaDetails, getPathMeta, getProcedureContractOrThrow, getRouterContract, isSchemaIssue, mergeErrorMap, meta, minifyRouterContract, oc, reconcileORPCError, resolveMetaPlugins, type };
+export type { AugmentContractRouterOptions, AugmentedContractRouter, ContractCaller, ContractCallerOptions, EventIteratorSchemaDetails, InitialInputSchema, InitialOutputSchema, MergedErrorMap, PathMetaPlugin, ProcedureContractBuilderWithInput, ProcedureContractBuilderWithInputOutput, ProcedureContractBuilderWithOutput, ProcedureContractClient, RouterContractClient, TypeRest };