@temporary-name/server 1.9.3-alpha.2957dbc009ec31fa21575f028b83c96651cba827 → 1.9.3-alpha.305aebe633f301e28426c6b15cdfd58ddf45641c

package/dist/shared/{server.DPD7R7h_.d.mts → server.DXPMDozZ.d.mts}

@@ -1,7 +1,7 @@
-import { Promisable, StandardLazyRequest, HTTPPath } from '@temporary-name/shared';
-import { Meta, Schemas, Route, InferProcedureClientInputs, InferSchemaOutput, EnhanceRouteOptions } from '@temporary-name/contract';
+import { Promisable, HTTPMethod, HTTPPath, OutputStructure, OpenAPI, IsEqual, StandardLazyRequest } from '@temporary-name/shared';
+import * as z from '@temporary-name/zod';
 
-type Context = Record<PropertyKey, any>;
+type Context = object;
 type MergedInitialContext<TInitial extends Context, TAdditional extends Context, TCurrent extends Context> = TInitial & Omit<TAdditional, keyof TCurrent>;
 type MergedCurrentContext<T extends Context, U extends Context> = Omit<T, keyof U> & U;
 type BuildContextWithAuth<TContext extends Context, TAuthContext> = MergedCurrentContext<TContext, {
@@ -9,6 +9,9 @@ type BuildContextWithAuth<TContext extends Context, TAuthContext> = MergedCurren
 }>;
 declare function mergeCurrentContext<T extends Context, U extends Context>(context: T, other: U): MergedCurrentContext<T, U>;
 
+type Meta = Record<string, any>;
+declare function mergeMeta<T extends Meta>(meta1: T, meta2: T): T;
+
 type MiddlewareResult<TOutContext extends Context, TOutput> = Promisable<{
     output: TOutput;
     context: TOutContext;
@@ -19,7 +22,7 @@ interface MiddlewareNextFn<TOutput> {
     }): MiddlewareResult<U, TOutput>;
 }
 interface MiddlewareOutputFn<TOutput> {
-    (output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
+    (output: TOutput): MiddlewareResult<{}, TOutput>;
 }
 interface MiddlewareOptions<TInContext extends Context, TOutput, TMeta extends Meta> extends ProcedureHandlerOptions<TInContext, TMeta> {
     next: MiddlewareNextFn<TOutput>;
@@ -36,9 +39,151 @@ type AnyMiddleware = Middleware<any, any, any, any, any>;
 interface MapInputMiddleware<TInput, TMappedInput> {
     (input: TInput): TMappedInput;
 }
-declare function middlewareOutputFn<TOutput>(output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
+declare function middlewareOutputFn<TOutput>(output: TOutput): MiddlewareResult<{}, TOutput>;
+
+interface Route {
+    /**
+     * The HTTP method of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
+     */
+    method?: HTTPMethod;
+    /**
+     * The HTTP path of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
+     */
+    path?: HTTPPath;
+    /**
+     * The operation ID of the endpoint.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @default Concatenation of router segments
+     */
+    operationId?: string;
+    /**
+     * The summary of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     */
+    summary?: string;
+    /**
+     * The description of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     */
+    description?: string;
+    /**
+     * Marks the procedure as deprecated.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     */
+    deprecated?: boolean;
+    /**
+     * The tags of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     */
+    tags?: readonly string[];
+    /**
+     * The status code of the response when the procedure is successful.
+     * The status code must be in the 200-399 range.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
+     * @default 200
+     */
+    successStatus?: number;
+    /**
+     * The description of the response when the procedure is successful.
+     *  This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     * @default 'OK'
+     */
+    successDescription?: string;
+    /**
+     * Determines how the response should be structured based on the output.
+     *
+     * @option 'compact'
+     * The output data is directly returned as the response body.
+     *
+     * @option 'detailed'
+     * Return an object with optional properties:
+     * - `status`: The response status (must be in 200-399 range) if not set fallback to `successStatus`.
+     * - `headers`: Custom headers to merge with the response headers (`Record<string, string | string[] | undefined>`)
+     * - `body`: The response body.
+     *
+     * Example:
+     * ```ts
+     * const output = {
+     *   status: 201,
+     *   headers: { 'x-custom-header': 'value' },
+     *   body: { message: 'Hello, world!' },
+     * };
+     * ```
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
+     * @default 'compact'
+     */
+    outputStructure?: OutputStructure;
+    /**
+     * Override entire auto-generated OpenAPI Operation Object Specification.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata Operation Metadata Docs}
+     */
+    spec?: OpenAPI.OperationObject | ((current: OpenAPI.OperationObject) => OpenAPI.OperationObject);
+}
+interface EnhanceRouteOptions {
+    prefix?: HTTPPath;
+    tags?: readonly string[];
+}
+
+type Schema<TInput, TOutput> = z.core.$ZodType<TOutput, TInput>;
+type AnySchema = z.core.$ZodType<any, any>;
+type AnyShape = Readonly<Record<string, AnySchema>>;
+type UnionToIntersection<T extends readonly object[]> = T extends readonly [infer First, ...infer Rest] ? First & (Rest extends readonly object[] ? UnionToIntersection<Rest> : {}) : {};
+type WrapShape<U extends AnySchema | AnyShape> = U extends AnySchema ? U : U extends AnyShape ? z.KrustyObject<U, z.core.$strip> : never;
+type SchemaIssue = z.core.$ZodIssue;
+type InferSchemaInput<T extends AnySchema> = z.input<T>;
+type InferSchemaOutput<T extends AnySchema> = z.output<T>;
+type InferHandlerInputs<TSchemas extends Schemas> = {
+    path: InferSchemaOutput<TSchemas['pathSchema']>;
+    query: InferSchemaOutput<TSchemas['querySchema']>;
+    body: InferSchemaOutput<TSchemas['bodySchema']>;
+};
+type InferProcedureClientInputs<TSchemas extends Schemas> = {
+    path: InferSchemaInput<TSchemas['pathSchema']>;
+    query: InferSchemaInput<TSchemas['querySchema']>;
+    body: InferSchemaInput<TSchemas['bodySchema']>;
+};
+type TypeRest<TInput, TOutput> = [map: (input: TInput) => Promisable<TOutput>] | (IsEqual<TInput, TOutput> extends true ? [] : never);
+interface Schemas {
+    pathSchema: AnySchema;
+    querySchema: AnySchema;
+    bodySchema: AnySchema;
+    outputSchema: AnySchema;
+}
+declare const initialSchemas: {
+    pathSchema: z.KrustyObject<{}, z.core.$strict, z.KrustyInternals<string>>;
+    querySchema: z.KrustyObject<{}, z.core.$strict, z.KrustyInternals<string>>;
+    bodySchema: z.KrustyObject<{}, z.core.$strict, z.KrustyInternals<string>>;
+    outputSchema: z.KrustyUnknown<z.KrustyInternals<string>>;
+};
+type InitialSchemas = typeof initialSchemas;
+type MergedSchemas<T1 extends Schemas, T2 extends Partial<Schemas>> = {
+    pathSchema: T2['pathSchema'] extends AnySchema ? T2['pathSchema'] : T1['pathSchema'];
+    querySchema: T2['querySchema'] extends AnySchema ? T2['querySchema'] : T1['querySchema'];
+    bodySchema: T2['bodySchema'] extends AnySchema ? T2['bodySchema'] : T1['bodySchema'];
+    outputSchema: T2['outputSchema'] extends AnySchema ? T2['outputSchema'] : T1['outputSchema'];
+};
 
-type DefaultProcedureHandlerOptions = ProcedureHandlerOptions<Context, Meta>;
 interface ProcedureHandlerOptions<TCurrentContext extends Context, TMeta extends Meta> {
     context: TCurrentContext;
     path: readonly string[];
@@ -54,16 +199,16 @@ interface ProcedureHandler<TCurrentContext extends Context, TInput extends {
 }, THandlerOutput, TMeta extends Meta> {
     (input: TInput, opt: ProcedureHandlerOptions<TCurrentContext, TMeta>): Promisable<THandlerOutput>;
 }
-interface ContractDef<TInitialContext extends Context, TSchemas extends Schemas, TMeta extends Meta> {
+interface ContractDef<TSchemas extends Schemas, TMeta extends Meta> {
     meta: TMeta;
     route: Route;
     schemas: TSchemas;
-    middlewares: readonly Middleware<TInitialContext, any, any, any, any>[];
-    authConfigs: TypedAuthConfig[];
+    middlewares: readonly AnyMiddleware[];
+    authConfigs: AnyAuthConfig[];
     inputValidationIndex: number;
     outputValidationIndex: number;
 }
-type AnyContractDef = ContractDef<Context, Schemas, Meta>;
+type AnyContractDef = ContractDef<Schemas, Meta>;
 declare class Contract<TDef extends AnyContractDef = AnyContractDef> {
     /**
      * This property holds the defined options.
@@ -71,8 +216,9 @@ declare class Contract<TDef extends AnyContractDef = AnyContractDef> {
     '~orpc': TDef;
     constructor(def: TDef);
 }
-interface ProcedureDef<TInitialContext extends Context, TCurrentContext extends Context, TSchemas extends Schemas, TMeta extends Meta> extends ContractDef<TInitialContext, TSchemas, TMeta> {
+interface ProcedureDef<TInitialContext extends Context, TCurrentContext extends Context, TSchemas extends Schemas, TMeta extends Meta> extends ContractDef<TSchemas, TMeta> {
     handler: ProcedureHandler<TCurrentContext, any, any, any>;
+    '~~DO_NOT_USE_initialContextHack'?: (type: TInitialContext) => unknown;
 }
 /**
  * This class represents a procedure.
@@ -85,22 +231,38 @@ type AnyProcedure = Procedure<any, any, Schemas, any>;
 declare function isProcedure(item: unknown): item is AnyProcedure;
 
 type ValidatedAuthContext = {};
-interface BasicAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> {
+interface BaseAuthConfig {
+    oasDescription?: string;
+    oasName?: string;
+}
+interface BasicAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> extends BaseAuthConfig {
     tokenPrefix?: string;
     validate: (username: string, password: string, options: ProcedureHandlerOptions<TCurrentContext, TMeta>) => Promisable<TAuthContext>;
 }
-interface TokenAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> {
+interface BearerAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> extends TokenAuthConfig<TAuthContext, TCurrentContext, TMeta> {
+    oasBearerFormat?: string;
+}
+interface TokenAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> extends BaseAuthConfig {
     tokenPrefix?: string;
     validate: (token: string, options: ProcedureHandlerOptions<TCurrentContext, TMeta>) => Promisable<TAuthContext>;
 }
 interface NamedTokenAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> extends TokenAuthConfig<TAuthContext, TCurrentContext, TMeta> {
     name: string;
 }
-type AuthType = 'header' | 'query' | 'cookie' | 'bearer' | 'basic' | 'none';
-type AuthConfig<TAuthType extends AuthType, TAuthContext extends ValidatedAuthContext = ValidatedAuthContext, TCurrentContext extends Context = Context, TMeta extends Meta = Meta> = TAuthType extends 'basic' ? BasicAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'bearer' ? TokenAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'header' ? NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'query' ? NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'cookie' ? NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'none' ? {} : never;
-type TypedAuthConfig<TAuthType extends AuthType = AuthType> = {
-    type: TAuthType;
-} & AuthConfig<TAuthType, object>;
+type AnyAuthConfig = AuthConfig<any, any, any>;
+type AuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> = ({
+    type: 'basic';
+} & BasicAuthConfig<TAuthContext, TCurrentContext, TMeta>) | ({
+    type: 'bearer';
+} & BearerAuthConfig<TAuthContext, TCurrentContext, TMeta>) | ({
+    type: 'header';
+} & NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta>) | ({
+    type: 'query';
+} & NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta>) | ({
+    type: 'cookie';
+} & NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta>) | {
+    type: 'none';
+};
 
 type ContractRouter = Contract | {
     [k: string]: ContractRouter;
@@ -222,5 +384,5 @@ declare function unlazy<T extends Lazyable<any>>(lazied: T): Promise<{
     default: T extends Lazy<infer U> ? U : T;
 }>;
 
-export { traverseContractProcedures as $, isProcedure as H, Procedure as P, getRouter as S, createAccessibleLazyRouter as U, enhanceRouter as W, Contract as a, resolveContractProcedures as a0, unlazyRouter as a2, mergeCurrentContext as m, LAZY_SYMBOL as n, lazyInternal as p, lazy as q, isLazy as r, getLazyMeta as s, unlazy as u, middlewareOutputFn as y };
-export type { AuthType as A, BuildContextWithAuth as B, Context as C, DefaultProcedureHandlerOptions as D, EnhanceRouterOptions as E, AnyContractDef as F, ProcedureDef as G, InferRouterInitialContext as I, ContractRouter as J, InferRouterInitialContexts as K, Lazyable as L, Middleware as M, InferRouterCurrentContexts as N, InferRouterInputs as O, InferRouterOutputs as Q, Router as R, AccessibleLazyRouter as T, ValidatedAuthContext as V, TraverseContractProceduresOptions as X, TraverseContractProcedureCallbackOptions as Y, ContractProcedureCallbackOptions as Z, LazyTraverseContractProceduresOptions as _, UnlaziedRouter as a1, MergedInitialContext as b, MergedCurrentContext as c, AuthConfig as d, ProcedureHandler as e, EnhancedRouter as f, MapInputMiddleware as g, ContractDef as h, AnyMiddleware as i, Lazy as j, AnyProcedure as k, AnyRouter as l, LazyMeta as o, MiddlewareResult as t, MiddlewareNextFn as v, MiddlewareOutputFn as w, MiddlewareOptions as x, ProcedureHandlerOptions as z };
+export { lazy as D, isLazy as F, getLazyMeta as G, unlazy as H, mergeMeta as J, Procedure as P, middlewareOutputFn as T, isProcedure as _, getRouter as a4, createAccessibleLazyRouter as a6, enhanceRouter as a7, traverseContractProcedures as ac, resolveContractProcedures as ad, unlazyRouter as af, initialSchemas as ah, Contract as b, mergeCurrentContext as w, LAZY_SYMBOL as x, lazyInternal as z };
+export type { ContractRouter as $, AnyShape as A, BuildContextWithAuth as B, Context as C, EnhanceRouterOptions as E, InferProcedureClientInputs as I, MiddlewareResult as K, Lazyable as L, Meta as M, MiddlewareNextFn as N, MiddlewareOutputFn as O, MiddlewareOptions as Q, Route as R, Schemas as S, UnionToIntersection as U, ValidatedAuthContext as V, WrapShape as W, ProcedureHandlerOptions as X, AnyContractDef as Y, ProcedureDef as Z, InferSchemaOutput as a, InferRouterInitialContexts as a0, InferRouterCurrentContexts as a1, InferRouterInputs as a2, InferRouterOutputs as a3, AccessibleLazyRouter as a5, TraverseContractProceduresOptions as a8, TraverseContractProcedureCallbackOptions as a9, ContractProcedureCallbackOptions as aa, LazyTraverseContractProceduresOptions as ab, UnlaziedRouter as ae, TypeRest as ag, InitialSchemas as ai, MergedSchemas as c, AnySchema as d, Middleware as e, MergedCurrentContext as f, MergedInitialContext as g, AuthConfig as h, ProcedureHandler as i, InferHandlerInputs as j, InferSchemaInput as k, Router as l, EnhancedRouter as m, MapInputMiddleware as n, ContractDef as o, SchemaIssue as p, Schema as q, AnyMiddleware as r, Lazy as s, AnyProcedure as t, AnyRouter as u, InferRouterInitialContext as v, LazyMeta as y };

package/dist/shared/{server.DPD7R7h_.d.ts → server.DXPMDozZ.d.ts}

@@ -1,7 +1,7 @@
-import { Promisable, StandardLazyRequest, HTTPPath } from '@temporary-name/shared';
-import { Meta, Schemas, Route, InferProcedureClientInputs, InferSchemaOutput, EnhanceRouteOptions } from '@temporary-name/contract';
+import { Promisable, HTTPMethod, HTTPPath, OutputStructure, OpenAPI, IsEqual, StandardLazyRequest } from '@temporary-name/shared';
+import * as z from '@temporary-name/zod';
 
-type Context = Record<PropertyKey, any>;
+type Context = object;
 type MergedInitialContext<TInitial extends Context, TAdditional extends Context, TCurrent extends Context> = TInitial & Omit<TAdditional, keyof TCurrent>;
 type MergedCurrentContext<T extends Context, U extends Context> = Omit<T, keyof U> & U;
 type BuildContextWithAuth<TContext extends Context, TAuthContext> = MergedCurrentContext<TContext, {
@@ -9,6 +9,9 @@ type BuildContextWithAuth<TContext extends Context, TAuthContext> = MergedCurren
 }>;
 declare function mergeCurrentContext<T extends Context, U extends Context>(context: T, other: U): MergedCurrentContext<T, U>;
 
+type Meta = Record<string, any>;
+declare function mergeMeta<T extends Meta>(meta1: T, meta2: T): T;
+
 type MiddlewareResult<TOutContext extends Context, TOutput> = Promisable<{
     output: TOutput;
     context: TOutContext;
@@ -19,7 +22,7 @@ interface MiddlewareNextFn<TOutput> {
     }): MiddlewareResult<U, TOutput>;
 }
 interface MiddlewareOutputFn<TOutput> {
-    (output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
+    (output: TOutput): MiddlewareResult<{}, TOutput>;
 }
 interface MiddlewareOptions<TInContext extends Context, TOutput, TMeta extends Meta> extends ProcedureHandlerOptions<TInContext, TMeta> {
     next: MiddlewareNextFn<TOutput>;
@@ -36,9 +39,151 @@ type AnyMiddleware = Middleware<any, any, any, any, any>;
 interface MapInputMiddleware<TInput, TMappedInput> {
     (input: TInput): TMappedInput;
 }
-declare function middlewareOutputFn<TOutput>(output: TOutput): MiddlewareResult<Record<never, never>, TOutput>;
+declare function middlewareOutputFn<TOutput>(output: TOutput): MiddlewareResult<{}, TOutput>;
+
+interface Route {
+    /**
+     * The HTTP method of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
+     */
+    method?: HTTPMethod;
+    /**
+     * The HTTP path of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
+     */
+    path?: HTTPPath;
+    /**
+     * The operation ID of the endpoint.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @default Concatenation of router segments
+     */
+    operationId?: string;
+    /**
+     * The summary of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     */
+    summary?: string;
+    /**
+     * The description of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     */
+    description?: string;
+    /**
+     * Marks the procedure as deprecated.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     */
+    deprecated?: boolean;
+    /**
+     * The tags of the procedure.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     */
+    tags?: readonly string[];
+    /**
+     * The status code of the response when the procedure is successful.
+     * The status code must be in the 200-399 range.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
+     * @default 200
+     */
+    successStatus?: number;
+    /**
+     * The description of the response when the procedure is successful.
+     *  This option is typically relevant when integrating with OpenAPI.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
+     * @default 'OK'
+     */
+    successDescription?: string;
+    /**
+     * Determines how the response should be structured based on the output.
+     *
+     * @option 'compact'
+     * The output data is directly returned as the response body.
+     *
+     * @option 'detailed'
+     * Return an object with optional properties:
+     * - `status`: The response status (must be in 200-399 range) if not set fallback to `successStatus`.
+     * - `headers`: Custom headers to merge with the response headers (`Record<string, string | string[] | undefined>`)
+     * - `body`: The response body.
+     *
+     * Example:
+     * ```ts
+     * const output = {
+     *   status: 201,
+     *   headers: { 'x-custom-header': 'value' },
+     *   body: { message: 'Hello, world!' },
+     * };
+     * ```
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
+     * @default 'compact'
+     */
+    outputStructure?: OutputStructure;
+    /**
+     * Override entire auto-generated OpenAPI Operation Object Specification.
+     *
+     * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata Operation Metadata Docs}
+     */
+    spec?: OpenAPI.OperationObject | ((current: OpenAPI.OperationObject) => OpenAPI.OperationObject);
+}
+interface EnhanceRouteOptions {
+    prefix?: HTTPPath;
+    tags?: readonly string[];
+}
+
+type Schema<TInput, TOutput> = z.core.$ZodType<TOutput, TInput>;
+type AnySchema = z.core.$ZodType<any, any>;
+type AnyShape = Readonly<Record<string, AnySchema>>;
+type UnionToIntersection<T extends readonly object[]> = T extends readonly [infer First, ...infer Rest] ? First & (Rest extends readonly object[] ? UnionToIntersection<Rest> : {}) : {};
+type WrapShape<U extends AnySchema | AnyShape> = U extends AnySchema ? U : U extends AnyShape ? z.KrustyObject<U, z.core.$strip> : never;
+type SchemaIssue = z.core.$ZodIssue;
+type InferSchemaInput<T extends AnySchema> = z.input<T>;
+type InferSchemaOutput<T extends AnySchema> = z.output<T>;
+type InferHandlerInputs<TSchemas extends Schemas> = {
+    path: InferSchemaOutput<TSchemas['pathSchema']>;
+    query: InferSchemaOutput<TSchemas['querySchema']>;
+    body: InferSchemaOutput<TSchemas['bodySchema']>;
+};
+type InferProcedureClientInputs<TSchemas extends Schemas> = {
+    path: InferSchemaInput<TSchemas['pathSchema']>;
+    query: InferSchemaInput<TSchemas['querySchema']>;
+    body: InferSchemaInput<TSchemas['bodySchema']>;
+};
+type TypeRest<TInput, TOutput> = [map: (input: TInput) => Promisable<TOutput>] | (IsEqual<TInput, TOutput> extends true ? [] : never);
+interface Schemas {
+    pathSchema: AnySchema;
+    querySchema: AnySchema;
+    bodySchema: AnySchema;
+    outputSchema: AnySchema;
+}
+declare const initialSchemas: {
+    pathSchema: z.KrustyObject<{}, z.core.$strict, z.KrustyInternals<string>>;
+    querySchema: z.KrustyObject<{}, z.core.$strict, z.KrustyInternals<string>>;
+    bodySchema: z.KrustyObject<{}, z.core.$strict, z.KrustyInternals<string>>;
+    outputSchema: z.KrustyUnknown<z.KrustyInternals<string>>;
+};
+type InitialSchemas = typeof initialSchemas;
+type MergedSchemas<T1 extends Schemas, T2 extends Partial<Schemas>> = {
+    pathSchema: T2['pathSchema'] extends AnySchema ? T2['pathSchema'] : T1['pathSchema'];
+    querySchema: T2['querySchema'] extends AnySchema ? T2['querySchema'] : T1['querySchema'];
+    bodySchema: T2['bodySchema'] extends AnySchema ? T2['bodySchema'] : T1['bodySchema'];
+    outputSchema: T2['outputSchema'] extends AnySchema ? T2['outputSchema'] : T1['outputSchema'];
+};
 
-type DefaultProcedureHandlerOptions = ProcedureHandlerOptions<Context, Meta>;
 interface ProcedureHandlerOptions<TCurrentContext extends Context, TMeta extends Meta> {
     context: TCurrentContext;
     path: readonly string[];
@@ -54,16 +199,16 @@ interface ProcedureHandler<TCurrentContext extends Context, TInput extends {
 }, THandlerOutput, TMeta extends Meta> {
     (input: TInput, opt: ProcedureHandlerOptions<TCurrentContext, TMeta>): Promisable<THandlerOutput>;
 }
-interface ContractDef<TInitialContext extends Context, TSchemas extends Schemas, TMeta extends Meta> {
+interface ContractDef<TSchemas extends Schemas, TMeta extends Meta> {
     meta: TMeta;
     route: Route;
     schemas: TSchemas;
-    middlewares: readonly Middleware<TInitialContext, any, any, any, any>[];
-    authConfigs: TypedAuthConfig[];
+    middlewares: readonly AnyMiddleware[];
+    authConfigs: AnyAuthConfig[];
     inputValidationIndex: number;
     outputValidationIndex: number;
 }
-type AnyContractDef = ContractDef<Context, Schemas, Meta>;
+type AnyContractDef = ContractDef<Schemas, Meta>;
 declare class Contract<TDef extends AnyContractDef = AnyContractDef> {
     /**
      * This property holds the defined options.
@@ -71,8 +216,9 @@ declare class Contract<TDef extends AnyContractDef = AnyContractDef> {
     '~orpc': TDef;
     constructor(def: TDef);
 }
-interface ProcedureDef<TInitialContext extends Context, TCurrentContext extends Context, TSchemas extends Schemas, TMeta extends Meta> extends ContractDef<TInitialContext, TSchemas, TMeta> {
+interface ProcedureDef<TInitialContext extends Context, TCurrentContext extends Context, TSchemas extends Schemas, TMeta extends Meta> extends ContractDef<TSchemas, TMeta> {
     handler: ProcedureHandler<TCurrentContext, any, any, any>;
+    '~~DO_NOT_USE_initialContextHack'?: (type: TInitialContext) => unknown;
 }
 /**
  * This class represents a procedure.
@@ -85,22 +231,38 @@ type AnyProcedure = Procedure<any, any, Schemas, any>;
 declare function isProcedure(item: unknown): item is AnyProcedure;
 
 type ValidatedAuthContext = {};
-interface BasicAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> {
+interface BaseAuthConfig {
+    oasDescription?: string;
+    oasName?: string;
+}
+interface BasicAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> extends BaseAuthConfig {
     tokenPrefix?: string;
     validate: (username: string, password: string, options: ProcedureHandlerOptions<TCurrentContext, TMeta>) => Promisable<TAuthContext>;
 }
-interface TokenAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> {
+interface BearerAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> extends TokenAuthConfig<TAuthContext, TCurrentContext, TMeta> {
+    oasBearerFormat?: string;
+}
+interface TokenAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> extends BaseAuthConfig {
     tokenPrefix?: string;
     validate: (token: string, options: ProcedureHandlerOptions<TCurrentContext, TMeta>) => Promisable<TAuthContext>;
 }
 interface NamedTokenAuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> extends TokenAuthConfig<TAuthContext, TCurrentContext, TMeta> {
     name: string;
 }
-type AuthType = 'header' | 'query' | 'cookie' | 'bearer' | 'basic' | 'none';
-type AuthConfig<TAuthType extends AuthType, TAuthContext extends ValidatedAuthContext = ValidatedAuthContext, TCurrentContext extends Context = Context, TMeta extends Meta = Meta> = TAuthType extends 'basic' ? BasicAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'bearer' ? TokenAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'header' ? NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'query' ? NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'cookie' ? NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta> : TAuthType extends 'none' ? {} : never;
-type TypedAuthConfig<TAuthType extends AuthType = AuthType> = {
-    type: TAuthType;
-} & AuthConfig<TAuthType, object>;
+type AnyAuthConfig = AuthConfig<any, any, any>;
+type AuthConfig<TAuthContext extends ValidatedAuthContext, TCurrentContext extends Context, TMeta extends Meta> = ({
+    type: 'basic';
+} & BasicAuthConfig<TAuthContext, TCurrentContext, TMeta>) | ({
+    type: 'bearer';
+} & BearerAuthConfig<TAuthContext, TCurrentContext, TMeta>) | ({
+    type: 'header';
+} & NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta>) | ({
+    type: 'query';
+} & NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta>) | ({
+    type: 'cookie';
+} & NamedTokenAuthConfig<TAuthContext, TCurrentContext, TMeta>) | {
+    type: 'none';
+};
 
 type ContractRouter = Contract | {
     [k: string]: ContractRouter;
@@ -222,5 +384,5 @@ declare function unlazy<T extends Lazyable<any>>(lazied: T): Promise<{
     default: T extends Lazy<infer U> ? U : T;
 }>;
 
-export { traverseContractProcedures as $, isProcedure as H, Procedure as P, getRouter as S, createAccessibleLazyRouter as U, enhanceRouter as W, Contract as a, resolveContractProcedures as a0, unlazyRouter as a2, mergeCurrentContext as m, LAZY_SYMBOL as n, lazyInternal as p, lazy as q, isLazy as r, getLazyMeta as s, unlazy as u, middlewareOutputFn as y };
-export type { AuthType as A, BuildContextWithAuth as B, Context as C, DefaultProcedureHandlerOptions as D, EnhanceRouterOptions as E, AnyContractDef as F, ProcedureDef as G, InferRouterInitialContext as I, ContractRouter as J, InferRouterInitialContexts as K, Lazyable as L, Middleware as M, InferRouterCurrentContexts as N, InferRouterInputs as O, InferRouterOutputs as Q, Router as R, AccessibleLazyRouter as T, ValidatedAuthContext as V, TraverseContractProceduresOptions as X, TraverseContractProcedureCallbackOptions as Y, ContractProcedureCallbackOptions as Z, LazyTraverseContractProceduresOptions as _, UnlaziedRouter as a1, MergedInitialContext as b, MergedCurrentContext as c, AuthConfig as d, ProcedureHandler as e, EnhancedRouter as f, MapInputMiddleware as g, ContractDef as h, AnyMiddleware as i, Lazy as j, AnyProcedure as k, AnyRouter as l, LazyMeta as o, MiddlewareResult as t, MiddlewareNextFn as v, MiddlewareOutputFn as w, MiddlewareOptions as x, ProcedureHandlerOptions as z };
+export { lazy as D, isLazy as F, getLazyMeta as G, unlazy as H, mergeMeta as J, Procedure as P, middlewareOutputFn as T, isProcedure as _, getRouter as a4, createAccessibleLazyRouter as a6, enhanceRouter as a7, traverseContractProcedures as ac, resolveContractProcedures as ad, unlazyRouter as af, initialSchemas as ah, Contract as b, mergeCurrentContext as w, LAZY_SYMBOL as x, lazyInternal as z };
+export type { ContractRouter as $, AnyShape as A, BuildContextWithAuth as B, Context as C, EnhanceRouterOptions as E, InferProcedureClientInputs as I, MiddlewareResult as K, Lazyable as L, Meta as M, MiddlewareNextFn as N, MiddlewareOutputFn as O, MiddlewareOptions as Q, Route as R, Schemas as S, UnionToIntersection as U, ValidatedAuthContext as V, WrapShape as W, ProcedureHandlerOptions as X, AnyContractDef as Y, ProcedureDef as Z, InferSchemaOutput as a, InferRouterInitialContexts as a0, InferRouterCurrentContexts as a1, InferRouterInputs as a2, InferRouterOutputs as a3, AccessibleLazyRouter as a5, TraverseContractProceduresOptions as a8, TraverseContractProcedureCallbackOptions as a9, ContractProcedureCallbackOptions as aa, LazyTraverseContractProceduresOptions as ab, UnlaziedRouter as ae, TypeRest as ag, InitialSchemas as ai, MergedSchemas as c, AnySchema as d, Middleware as e, MergedCurrentContext as f, MergedInitialContext as g, AuthConfig as h, ProcedureHandler as i, InferHandlerInputs as j, InferSchemaInput as k, Router as l, EnhancedRouter as m, MapInputMiddleware as n, ContractDef as o, SchemaIssue as p, Schema as q, AnyMiddleware as r, Lazy as s, AnyProcedure as t, AnyRouter as u, InferRouterInitialContext as v, LazyMeta as y };