@orpc/contract 2.0.0-beta.24 → 2.0.0-beta.26

package/dist/index.d.mts

@@ -10,22 +10,101 @@ type MergedErrorMap<T1 extends ErrorMap, T2 extends ErrorMap> = keyof T1 extends
 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>;
 
+/**
+ * The contract builder variant returned after `.input` is called.
+ * It is already a complete procedure contract that can still be refined.
+ *
+ * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+ */
 interface ProcedureContractBuilderWithInput<TInputSchema extends AnySchema, TErrorMap extends ErrorMap> extends ProcedureContract<TInputSchema, InitialOutputSchema, TErrorMap> {
+    /**
+     * Applies metadata plugins to contracts built from this builder.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#metadata | Procedure Contract - Metadata}
+     */
     meta(...plugins: MetaPlugin<TInputSchema, InitialOutputSchema, TErrorMap>[]): ProcedureContractBuilderWithInput<TInputSchema, TErrorMap>;
+    /**
+     * Defines typesafe errors that implementations of this contract can throw.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#typesafe-errors | Procedure Contract - Typesafe Errors}
+     */
     errors<T extends ErrorMap>(errors: T): ProcedureContractBuilderWithInput<TInputSchema, MergedErrorMap<TErrorMap, T>>;
+    /**
+     * Adds an additional input schema, merged with the previously defined one.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#multiple-schemas | Procedure Contract - Multiple Schemas}
+     */
     input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInput<MergedSchema<T, TInputSchema>, TErrorMap>;
+    /**
+     * Defines the output schema used to validate and type the procedure output.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+     */
     output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<TInputSchema, T, TErrorMap>;
 }
+/**
+ * The contract builder variant returned after `.output` is called.
+ * It is already a complete procedure contract that can still be refined.
+ *
+ * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+ */
 interface ProcedureContractBuilderWithOutput<TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> extends ProcedureContract<InitialInputSchema, TOutputSchema, TErrorMap> {
+    /**
+     * Applies metadata plugins to contracts built from this builder.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#metadata | Procedure Contract - Metadata}
+     */
     meta(...plugins: MetaPlugin<InitialInputSchema, TOutputSchema, TErrorMap>[]): ProcedureContractBuilderWithOutput<TOutputSchema, TErrorMap>;
+    /**
+     * Defines typesafe errors that implementations of this contract can throw.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#typesafe-errors | Procedure Contract - Typesafe Errors}
+     */
     errors<T extends ErrorMap>(errors: T): ProcedureContractBuilderWithOutput<TOutputSchema, MergedErrorMap<TErrorMap, T>>;
+    /**
+     * Defines the input schema used to validate and type the procedure input.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+     */
     input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<T, TOutputSchema, TErrorMap>;
+    /**
+     * Adds an additional output schema, merged with the previously defined one.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#multiple-schemas | Procedure Contract - Multiple Schemas}
+     */
     output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithOutput<MergedSchema<T, TOutputSchema>, TErrorMap>;
 }
+/**
+ * The contract builder variant returned after both `.input` and `.output`
+ * are called. It is already a complete procedure contract that can still be
+ * refined.
+ *
+ * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+ */
 interface ProcedureContractBuilderWithInputOutput<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> extends ProcedureContract<TInputSchema, TOutputSchema, TErrorMap> {
+    /**
+     * Applies metadata plugins to contracts built from this builder.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#metadata | Procedure Contract - Metadata}
+     */
     meta(...plugins: MetaPlugin<TInputSchema, TOutputSchema, TErrorMap>[]): ProcedureContractBuilderWithInputOutput<TInputSchema, TOutputSchema, TErrorMap>;
+    /**
+     * Defines typesafe errors that implementations of this contract can throw.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#typesafe-errors | Procedure Contract - Typesafe Errors}
+     */
     errors<T extends ErrorMap>(errors: T): ProcedureContractBuilderWithInputOutput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, T>>;
+    /**
+     * Adds an additional input schema, merged with the previously defined one.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#multiple-schemas | Procedure Contract - Multiple Schemas}
+     */
     input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<MergedSchema<T, TInputSchema>, TOutputSchema, TErrorMap>;
+    /**
+     * Adds an additional output schema, merged with the previously defined one.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#multiple-schemas | Procedure Contract - Multiple Schemas}
+     */
     output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<TInputSchema, MergedSchema<T, TOutputSchema>, TErrorMap>;
 }
 
@@ -54,24 +133,72 @@ declare function getProcedureContractOrThrow(router: RouterContract, path: reado
  */
 declare function minifyRouterContract(router: RouterContract): RouterContract;
 
+/**
+ * The input schema type used before `.input` is called.
+ * Input is `void` for better compatibility with third-party libraries,
+ * such as TanStack Query, which allow calling mutations without input.
+ */
 type InitialInputSchema = Schema<void, unknown>;
+/**
+ * The output schema type used before `.output` is called.
+ */
 type InitialOutputSchema = Schema<unknown>;
+/**
+ * The contract builder behind `oc`. Chain its methods to define procedure
+ * contracts — metadata, errors, and input/output schemas — without any
+ * business logic.
+ *
+ * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+ */
 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();
+    /**
+     * Creates a fresh contract builder with an empty definition.
+     * Prefer the exported `oc` instance over calling this directly.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+     */
     static create(): ContractBuilder<object>;
+    /**
+     * Applies metadata plugins to contracts built from this builder.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#metadata | Procedure Contract - Metadata}
+     */
     meta(...plugins: MetaPlugin<InitialInputSchema, InitialOutputSchema, TErrorMap>[]): ContractBuilder<TErrorMap>;
+    /**
+     * Defines typesafe errors that implementations of this contract can throw.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#typesafe-errors | Procedure Contract - Typesafe Errors}
+     */
     errors<T extends ErrorMap>(errors: T): ContractBuilder<MergedErrorMap<TErrorMap, T>>;
+    /**
+     * Defines the input schema used to validate and type the procedure input.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+     */
     input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInput<T, TErrorMap>;
+    /**
+     * Defines the output schema used to validate and type the procedure output.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+     */
     output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithOutput<T, TErrorMap>;
+    /**
+     * Applies the builder's errors and metadata to every procedure contract in
+     * the given router contract.
+     *
+     * @see {@link https://orpc.dev/docs/contract/router#extending-router | Router Contract - Extending Router}
+     */
     router<T extends RouterContract>(router: T): AugmentedContractRouter<T, TErrorMap>;
 }
 /**
- * The contract builder — the entry point for defining procedure and router contracts
- * (input/output schemas, errors, and metadata) without any business logic.
+ * The oRPC contract builder. Chain methods like `.input`, `.errors`, and
+ * `.output` to define procedure contracts, then compose them into router
+ * contracts.
  *
  * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
  */
@@ -303,4 +430,4 @@ declare function type<TInput, TOutput = TInput>(...[map]: TypeRest<TInput, TOutp
 declare function isSchemaIssue(issue: unknown): issue is SchemaIssue;
 
 export { AnyProcedureContract as AnyContractProcedure, RouterContract as AnyContractRouter, AnyMetaPlugin, AnyProcedureContract, AnySchema, ContractBuilder, ErrorMap, ErrorMapItem, InferSchemaInput, InferSchemaOutput, MergedSchema, Meta, MetaPlugin, ORPCErrorFromErrorMap, ProcedureContract, RouterContract, Schema, SchemaIssue, asyncIteratorObject, augmentContractRouter, createContractClientFactory, createORPCErrorConstructorMap, defineMeta, error, asyncIteratorObject as eventIterator, getAsyncIteratorObjectSchemaDetails, getRouterContract as getContractRouter, getPathMeta, getProcedureContractOrThrow, getRouterContract, isSchemaIssue, mergeErrorMap, meta, minifyRouterContract as minifyContractRouter, minifyRouterContract, oc, reconcileORPCError, resolveBasePathMeta, resolveMetaPlugins, type };
-export type { AsyncIteratorObjectSchemaDetails, AugmentContractRouterOptions, AugmentedContractRouter, ContractClientFactory, ContractClientFactoryOptions, InitialInputSchema, InitialOutputSchema, MergedErrorMap, ORPCErrorConstructorMap, ORPCErrorConstructorMapItem, ORPCErrorConstructorMapItemOptions, ORPCErrorFactory, ORPCErrorFactoryOptions, PathMetaPlugin, ProcedureContractBuilderWithInput, ProcedureContractBuilderWithInputOutput, ProcedureContractBuilderWithOutput, ProcedureContractClient, RouterContractClient, TypeRest };
+export type { AsyncIteratorObjectSchemaDetails, AugmentContractRouterOptions, AugmentedContractRouter, ContractClientFactory, ContractClientFactoryOptions, RouterContractClient as ContractRouterClient, InitialInputSchema, InitialOutputSchema, MergedErrorMap, ORPCErrorConstructorMap, ORPCErrorConstructorMapItem, ORPCErrorConstructorMapItemOptions, ORPCErrorFactory, ORPCErrorFactoryOptions, PathMetaPlugin, ProcedureContractBuilderWithInput, ProcedureContractBuilderWithInputOutput, ProcedureContractBuilderWithOutput, ProcedureContractClient, RouterContractClient, TypeRest };

package/dist/index.d.ts

@@ -10,22 +10,101 @@ type MergedErrorMap<T1 extends ErrorMap, T2 extends ErrorMap> = keyof T1 extends
 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>;
 
+/**
+ * The contract builder variant returned after `.input` is called.
+ * It is already a complete procedure contract that can still be refined.
+ *
+ * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+ */
 interface ProcedureContractBuilderWithInput<TInputSchema extends AnySchema, TErrorMap extends ErrorMap> extends ProcedureContract<TInputSchema, InitialOutputSchema, TErrorMap> {
+    /**
+     * Applies metadata plugins to contracts built from this builder.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#metadata | Procedure Contract - Metadata}
+     */
     meta(...plugins: MetaPlugin<TInputSchema, InitialOutputSchema, TErrorMap>[]): ProcedureContractBuilderWithInput<TInputSchema, TErrorMap>;
+    /**
+     * Defines typesafe errors that implementations of this contract can throw.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#typesafe-errors | Procedure Contract - Typesafe Errors}
+     */
     errors<T extends ErrorMap>(errors: T): ProcedureContractBuilderWithInput<TInputSchema, MergedErrorMap<TErrorMap, T>>;
+    /**
+     * Adds an additional input schema, merged with the previously defined one.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#multiple-schemas | Procedure Contract - Multiple Schemas}
+     */
     input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInput<MergedSchema<T, TInputSchema>, TErrorMap>;
+    /**
+     * Defines the output schema used to validate and type the procedure output.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+     */
     output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<TInputSchema, T, TErrorMap>;
 }
+/**
+ * The contract builder variant returned after `.output` is called.
+ * It is already a complete procedure contract that can still be refined.
+ *
+ * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+ */
 interface ProcedureContractBuilderWithOutput<TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> extends ProcedureContract<InitialInputSchema, TOutputSchema, TErrorMap> {
+    /**
+     * Applies metadata plugins to contracts built from this builder.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#metadata | Procedure Contract - Metadata}
+     */
     meta(...plugins: MetaPlugin<InitialInputSchema, TOutputSchema, TErrorMap>[]): ProcedureContractBuilderWithOutput<TOutputSchema, TErrorMap>;
+    /**
+     * Defines typesafe errors that implementations of this contract can throw.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#typesafe-errors | Procedure Contract - Typesafe Errors}
+     */
     errors<T extends ErrorMap>(errors: T): ProcedureContractBuilderWithOutput<TOutputSchema, MergedErrorMap<TErrorMap, T>>;
+    /**
+     * Defines the input schema used to validate and type the procedure input.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+     */
     input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<T, TOutputSchema, TErrorMap>;
+    /**
+     * Adds an additional output schema, merged with the previously defined one.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#multiple-schemas | Procedure Contract - Multiple Schemas}
+     */
     output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithOutput<MergedSchema<T, TOutputSchema>, TErrorMap>;
 }
+/**
+ * The contract builder variant returned after both `.input` and `.output`
+ * are called. It is already a complete procedure contract that can still be
+ * refined.
+ *
+ * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+ */
 interface ProcedureContractBuilderWithInputOutput<TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> extends ProcedureContract<TInputSchema, TOutputSchema, TErrorMap> {
+    /**
+     * Applies metadata plugins to contracts built from this builder.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#metadata | Procedure Contract - Metadata}
+     */
     meta(...plugins: MetaPlugin<TInputSchema, TOutputSchema, TErrorMap>[]): ProcedureContractBuilderWithInputOutput<TInputSchema, TOutputSchema, TErrorMap>;
+    /**
+     * Defines typesafe errors that implementations of this contract can throw.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#typesafe-errors | Procedure Contract - Typesafe Errors}
+     */
     errors<T extends ErrorMap>(errors: T): ProcedureContractBuilderWithInputOutput<TInputSchema, TOutputSchema, MergedErrorMap<TErrorMap, T>>;
+    /**
+     * Adds an additional input schema, merged with the previously defined one.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#multiple-schemas | Procedure Contract - Multiple Schemas}
+     */
     input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<MergedSchema<T, TInputSchema>, TOutputSchema, TErrorMap>;
+    /**
+     * Adds an additional output schema, merged with the previously defined one.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#multiple-schemas | Procedure Contract - Multiple Schemas}
+     */
     output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInputOutput<TInputSchema, MergedSchema<T, TOutputSchema>, TErrorMap>;
 }
 
@@ -54,24 +133,72 @@ declare function getProcedureContractOrThrow(router: RouterContract, path: reado
  */
 declare function minifyRouterContract(router: RouterContract): RouterContract;
 
+/**
+ * The input schema type used before `.input` is called.
+ * Input is `void` for better compatibility with third-party libraries,
+ * such as TanStack Query, which allow calling mutations without input.
+ */
 type InitialInputSchema = Schema<void, unknown>;
+/**
+ * The output schema type used before `.output` is called.
+ */
 type InitialOutputSchema = Schema<unknown>;
+/**
+ * The contract builder behind `oc`. Chain its methods to define procedure
+ * contracts — metadata, errors, and input/output schemas — without any
+ * business logic.
+ *
+ * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+ */
 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();
+    /**
+     * Creates a fresh contract builder with an empty definition.
+     * Prefer the exported `oc` instance over calling this directly.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+     */
     static create(): ContractBuilder<object>;
+    /**
+     * Applies metadata plugins to contracts built from this builder.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#metadata | Procedure Contract - Metadata}
+     */
     meta(...plugins: MetaPlugin<InitialInputSchema, InitialOutputSchema, TErrorMap>[]): ContractBuilder<TErrorMap>;
+    /**
+     * Defines typesafe errors that implementations of this contract can throw.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#typesafe-errors | Procedure Contract - Typesafe Errors}
+     */
     errors<T extends ErrorMap>(errors: T): ContractBuilder<MergedErrorMap<TErrorMap, T>>;
+    /**
+     * Defines the input schema used to validate and type the procedure input.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+     */
     input<T extends AnySchema>(schema: T): ProcedureContractBuilderWithInput<T, TErrorMap>;
+    /**
+     * Defines the output schema used to validate and type the procedure output.
+     *
+     * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+     */
     output<T extends AnySchema>(schema: T): ProcedureContractBuilderWithOutput<T, TErrorMap>;
+    /**
+     * Applies the builder's errors and metadata to every procedure contract in
+     * the given router contract.
+     *
+     * @see {@link https://orpc.dev/docs/contract/router#extending-router | Router Contract - Extending Router}
+     */
     router<T extends RouterContract>(router: T): AugmentedContractRouter<T, TErrorMap>;
 }
 /**
- * The contract builder — the entry point for defining procedure and router contracts
- * (input/output schemas, errors, and metadata) without any business logic.
+ * The oRPC contract builder. Chain methods like `.input`, `.errors`, and
+ * `.output` to define procedure contracts, then compose them into router
+ * contracts.
  *
  * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
  */
@@ -303,4 +430,4 @@ declare function type<TInput, TOutput = TInput>(...[map]: TypeRest<TInput, TOutp
 declare function isSchemaIssue(issue: unknown): issue is SchemaIssue;
 
 export { AnyProcedureContract as AnyContractProcedure, RouterContract as AnyContractRouter, AnyMetaPlugin, AnyProcedureContract, AnySchema, ContractBuilder, ErrorMap, ErrorMapItem, InferSchemaInput, InferSchemaOutput, MergedSchema, Meta, MetaPlugin, ORPCErrorFromErrorMap, ProcedureContract, RouterContract, Schema, SchemaIssue, asyncIteratorObject, augmentContractRouter, createContractClientFactory, createORPCErrorConstructorMap, defineMeta, error, asyncIteratorObject as eventIterator, getAsyncIteratorObjectSchemaDetails, getRouterContract as getContractRouter, getPathMeta, getProcedureContractOrThrow, getRouterContract, isSchemaIssue, mergeErrorMap, meta, minifyRouterContract as minifyContractRouter, minifyRouterContract, oc, reconcileORPCError, resolveBasePathMeta, resolveMetaPlugins, type };
-export type { AsyncIteratorObjectSchemaDetails, AugmentContractRouterOptions, AugmentedContractRouter, ContractClientFactory, ContractClientFactoryOptions, InitialInputSchema, InitialOutputSchema, MergedErrorMap, ORPCErrorConstructorMap, ORPCErrorConstructorMapItem, ORPCErrorConstructorMapItemOptions, ORPCErrorFactory, ORPCErrorFactoryOptions, PathMetaPlugin, ProcedureContractBuilderWithInput, ProcedureContractBuilderWithInputOutput, ProcedureContractBuilderWithOutput, ProcedureContractClient, RouterContractClient, TypeRest };
+export type { AsyncIteratorObjectSchemaDetails, AugmentContractRouterOptions, AugmentedContractRouter, ContractClientFactory, ContractClientFactoryOptions, RouterContractClient as ContractRouterClient, InitialInputSchema, InitialOutputSchema, MergedErrorMap, ORPCErrorConstructorMap, ORPCErrorConstructorMapItem, ORPCErrorConstructorMapItemOptions, ORPCErrorFactory, ORPCErrorFactoryOptions, PathMetaPlugin, ProcedureContractBuilderWithInput, ProcedureContractBuilderWithInputOutput, ProcedureContractBuilderWithOutput, ProcedureContractClient, RouterContractClient, TypeRest };

package/dist/index.mjs

@@ -22,12 +22,23 @@ class ContractBuilder extends ProcedureContract {
   constructor(definition) {
     super(definition);
   }
+  /**
+   * Creates a fresh contract builder with an empty definition.
+   * Prefer the exported `oc` instance over calling this directly.
+   *
+   * @see {@link https://orpc.dev/docs/contract/procedure | Procedure Contract}
+   */
   static create() {
     return new ContractBuilder({
       errorMap: {},
       meta: {}
     });
   }
+  /**
+   * Applies metadata plugins to contracts built from this builder.
+   *
+   * @see {@link https://orpc.dev/docs/contract/procedure#metadata | Procedure Contract - Metadata}
+   */
   meta(...plugins) {
     const [meta, metaPlugins] = resolveMetaPlugins(
       this["~orpc"].meta,
@@ -40,6 +51,11 @@ class ContractBuilder extends ProcedureContract {
       metaPlugins
     });
   }
+  /**
+   * Defines typesafe errors that implementations of this contract can throw.
+   *
+   * @see {@link https://orpc.dev/docs/contract/procedure#typesafe-errors | Procedure Contract - Typesafe Errors}
+   */
   errors(errors) {
     let result = new ContractBuilder({
       ...this["~orpc"],
@@ -51,6 +67,11 @@ class ContractBuilder extends ProcedureContract {
     }
     return result;
   }
+  /**
+   * Defines the input schema used to validate and type the procedure input.
+   *
+   * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+   */
   input(schema) {
     let result = new ContractBuilder({
       ...this["~orpc"],
@@ -62,6 +83,11 @@ class ContractBuilder extends ProcedureContract {
     }
     return result;
   }
+  /**
+   * Defines the output schema used to validate and type the procedure output.
+   *
+   * @see {@link https://orpc.dev/docs/contract/procedure#inputoutput-validation | Procedure Contract - Input/Output Validation}
+   */
   output(schema) {
     let result = new ContractBuilder({
       ...this["~orpc"],
@@ -73,6 +99,12 @@ class ContractBuilder extends ProcedureContract {
     }
     return result;
   }
+  /**
+   * Applies the builder's errors and metadata to every procedure contract in
+   * the given router contract.
+   *
+   * @see {@link https://orpc.dev/docs/contract/router#extending-router | Router Contract - Extending Router}
+   */
   router(router) {
     return augmentContractRouter(router, this["~orpc"]);
   }

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@orpc/contract",
   "type": "module",
-  "version": "2.0.0-beta.24",
+  "version": "2.0.0-beta.26",
   "license": "MIT",
+  "funding": "https://github.com/sponsors/dinwwwh",
   "homepage": "https://orpc.dev",
   "repository": {
     "type": "git",
@@ -31,8 +32,8 @@
   ],
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
-    "@orpc/client": "2.0.0-beta.24",
-    "@orpc/shared": "2.0.0-beta.24"
+    "@orpc/client": "2.0.0-beta.26",
+    "@orpc/shared": "2.0.0-beta.26"
   },
   "devDependencies": {
     "arktype": "^2.2.1",