@orpc/openapi 0.0.0-next.4a2200e → 0.0.0-next.4a7a06a

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -49,6 +49,7 @@ You can find the full documentation [here](https://orpc.unnoq.com).
49
49
  - [@orpc/contract](https://www.npmjs.com/package/@orpc/contract): Build your API contract.
50
50
  - [@orpc/server](https://www.npmjs.com/package/@orpc/server): Build your API or implement API contract.
51
51
  - [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume your API on the client with type-safety.
52
+ - [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with NestJS.
52
53
  - [@orpc/react](https://www.npmjs.com/package/@orpc/react): Utilities for integrating oRPC with React and React Server Actions.
53
54
  - [@orpc/react-query](https://www.npmjs.com/package/@orpc/react-query): Integration with [React Query](https://tanstack.com/query/latest/docs/framework/react/overview).
54
55
  - [@orpc/vue-query](https://www.npmjs.com/package/@orpc/vue-query): Integration with [Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview).
@@ -8,7 +8,7 @@ import '@orpc/server/standard';
8
8
  * OpenAPI Handler for Fetch Server
9
9
  *
10
10
  * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-handler OpenAPI Handler Docs}
11
- * @see {@link https://orpc.unnoq.com/docs/integrations/fetch-server Fetch Server Integration Docs}
11
+ * @see {@link https://orpc.unnoq.com/docs/adapters/http HTTP Adapter Docs}
12
12
  */
13
13
  declare class OpenAPIHandler<T extends Context> extends FetchHandler<T> {
14
14
  constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T> & FetchHandlerOptions<T>>);
@@ -8,7 +8,7 @@ import '@orpc/server/standard';
8
8
  * OpenAPI Handler for Fetch Server
9
9
  *
10
10
  * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-handler OpenAPI Handler Docs}
11
- * @see {@link https://orpc.unnoq.com/docs/integrations/fetch-server Fetch Server Integration Docs}
11
+ * @see {@link https://orpc.unnoq.com/docs/adapters/http HTTP Adapter Docs}
12
12
  */
13
13
  declare class OpenAPIHandler<T extends Context> extends FetchHandler<T> {
14
14
  constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T> & FetchHandlerOptions<T>>);
@@ -8,7 +8,7 @@ import '@orpc/server/standard';
8
8
  * OpenAPI Handler for Node Server
9
9
  *
10
10
  * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-handler OpenAPI Handler Docs}
11
- * @see {@link https://orpc.unnoq.com/docs/integrations/node Node Integration Docs}
11
+ * @see {@link https://orpc.unnoq.com/docs/adapters/http HTTP Adapter Docs}
12
12
  */
13
13
  declare class OpenAPIHandler<T extends Context> extends NodeHttpHandler<T> {
14
14
  constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T> & NodeHttpHandlerOptions<T>>);
@@ -8,7 +8,7 @@ import '@orpc/server/standard';
8
8
  * OpenAPI Handler for Node Server
9
9
  *
10
10
  * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-handler OpenAPI Handler Docs}
11
- * @see {@link https://orpc.unnoq.com/docs/integrations/node Node Integration Docs}
11
+ * @see {@link https://orpc.unnoq.com/docs/adapters/http HTTP Adapter Docs}
12
12
  */
13
13
  declare class OpenAPIHandler<T extends Context> extends NodeHttpHandler<T> {
14
14
  constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T> & NodeHttpHandlerOptions<T>>);
package/dist/index.d.mts CHANGED
@@ -1,12 +1,14 @@
1
- import { AnyContractProcedure, AnySchema, AnyContractRouter } from '@orpc/contract';
1
+ import { AnyContractProcedure } from '@orpc/contract';
2
2
  import { OpenAPIV3_1 } from 'openapi-types';
3
3
  export { OpenAPIV3_1 as OpenAPI } from 'openapi-types';
4
- import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
5
- import { AnyRouter } from '@orpc/server';
6
- import { Promisable } from '@orpc/shared';
7
- import { JSONSchema } from 'json-schema-typed/draft-2020-12';
8
- export { JSONSchema, Format as JSONSchemaFormat } from 'json-schema-typed/draft-2020-12';
4
+ export { d as CompositeSchemaConverter, C as ConditionalSchemaConverter, b as OpenAPIGenerator, a as OpenAPIGeneratorGenerateOptions, O as OpenAPIGeneratorOptions, S as SchemaConvertOptions, c as SchemaConverter } from './shared/openapi.DP97kr00.mjs';
9
5
  import { HTTPPath, HTTPMethod } from '@orpc/client';
6
+ import { JSONSchema } from 'json-schema-typed/draft-2020-12';
7
+ export { JSONSchema, ContentEncoding as JSONSchemaContentEncoding, Format as JSONSchemaFormat } from 'json-schema-typed/draft-2020-12';
8
+ import { JsonifiedClient } from '@orpc/openapi-client';
9
+ import { AnyRouter, ClientContext, Lazyable, CreateProcedureClientOptions, InferRouterInitialContext, Schema, ErrorMap, Meta, RouterClient } from '@orpc/server';
10
+ import { MaybeOptionalOptions } from '@orpc/shared';
11
+ import '@orpc/openapi-client/standard';
10
12
 
11
13
  type OverrideOperationValue = Partial<OpenAPIV3_1.OperationObject> | ((current: OpenAPIV3_1.OperationObject, procedure: AnyContractProcedure) => OpenAPIV3_1.OperationObject);
12
14
  /**
@@ -36,42 +38,6 @@ type FileSchema = JSONSchema & {
36
38
  */
37
39
  declare const LOGIC_KEYWORDS: string[];
38
40
 
39
- interface SchemaConvertOptions {
40
- strategy: 'input' | 'output';
41
- }
42
- interface SchemaConverter {
43
- convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<[required: boolean, jsonSchema: JSONSchema]>;
44
- }
45
- interface ConditionalSchemaConverter extends SchemaConverter {
46
- condition(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<boolean>;
47
- }
48
- declare class CompositeSchemaConverter implements SchemaConverter {
49
- private readonly converters;
50
- constructor(converters: ConditionalSchemaConverter[]);
51
- convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promise<[required: boolean, jsonSchema: JSONSchema]>;
52
- }
53
-
54
- interface OpenAPIGeneratorOptions extends StandardOpenAPIJsonSerializerOptions {
55
- schemaConverters?: ConditionalSchemaConverter[];
56
- }
57
- /**
58
- * The generator that converts oRPC routers/contracts to OpenAPI specifications.
59
- *
60
- * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification OpenAPI Specification Docs}
61
- */
62
- declare class OpenAPIGenerator {
63
- #private;
64
- private readonly serializer;
65
- private readonly converter;
66
- constructor(options?: OpenAPIGeneratorOptions);
67
- /**
68
- * Generates OpenAPI specifications from oRPC routers/contracts.
69
- *
70
- * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification OpenAPI Specification Docs}
71
- */
72
- generate(router: AnyContractRouter | AnyRouter, base: Omit<OpenAPIV3_1.Document, 'openapi'>): Promise<OpenAPIV3_1.Document>;
73
- }
74
-
75
41
  /**
76
42
  * @internal
77
43
  */
@@ -101,6 +67,8 @@ declare function checkParamsSchema(schema: ObjectSchema, params: string[]): bool
101
67
  */
102
68
  declare function toOpenAPISchema(schema: JSONSchema): OpenAPIV3_1.SchemaObject & object;
103
69
 
70
+ declare function createJsonifiedRouterClient<T extends AnyRouter, TClientContext extends ClientContext>(router: Lazyable<T | undefined>, ...rest: MaybeOptionalOptions<CreateProcedureClientOptions<InferRouterInitialContext<T>, Schema<unknown, unknown>, ErrorMap, Meta, TClientContext>>): JsonifiedClient<RouterClient<T, TClientContext>>;
71
+
104
72
  /**
105
73
  *@internal
106
74
  */
@@ -127,5 +95,5 @@ declare const oo: {
127
95
  spec: typeof customOpenAPIOperation;
128
96
  };
129
97
 
130
- export { CompositeSchemaConverter, LOGIC_KEYWORDS, OpenAPIGenerator, applyCustomOpenAPIOperation, applySchemaOptionality, checkParamsSchema, customOpenAPIOperation, filterSchemaBranches, getCustomOpenAPIOperation, isAnySchema, isFileSchema, isObjectSchema, oo, separateObjectSchema, toOpenAPIContent, toOpenAPIEventIteratorContent, toOpenAPIMethod, toOpenAPIParameters, toOpenAPIPath, toOpenAPISchema };
131
- export type { ConditionalSchemaConverter, FileSchema, ObjectSchema, OpenAPIGeneratorOptions, OverrideOperationValue, SchemaConvertOptions, SchemaConverter };
98
+ export { LOGIC_KEYWORDS, applyCustomOpenAPIOperation, applySchemaOptionality, checkParamsSchema, createJsonifiedRouterClient, customOpenAPIOperation, filterSchemaBranches, getCustomOpenAPIOperation, isAnySchema, isFileSchema, isObjectSchema, oo, separateObjectSchema, toOpenAPIContent, toOpenAPIEventIteratorContent, toOpenAPIMethod, toOpenAPIParameters, toOpenAPIPath, toOpenAPISchema };
99
+ export type { FileSchema, ObjectSchema, OverrideOperationValue };
package/dist/index.d.ts CHANGED
@@ -1,12 +1,14 @@
1
- import { AnyContractProcedure, AnySchema, AnyContractRouter } from '@orpc/contract';
1
+ import { AnyContractProcedure } from '@orpc/contract';
2
2
  import { OpenAPIV3_1 } from 'openapi-types';
3
3
  export { OpenAPIV3_1 as OpenAPI } from 'openapi-types';
4
- import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
5
- import { AnyRouter } from '@orpc/server';
6
- import { Promisable } from '@orpc/shared';
7
- import { JSONSchema } from 'json-schema-typed/draft-2020-12';
8
- export { JSONSchema, Format as JSONSchemaFormat } from 'json-schema-typed/draft-2020-12';
4
+ export { d as CompositeSchemaConverter, C as ConditionalSchemaConverter, b as OpenAPIGenerator, a as OpenAPIGeneratorGenerateOptions, O as OpenAPIGeneratorOptions, S as SchemaConvertOptions, c as SchemaConverter } from './shared/openapi.DP97kr00.js';
9
5
  import { HTTPPath, HTTPMethod } from '@orpc/client';
6
+ import { JSONSchema } from 'json-schema-typed/draft-2020-12';
7
+ export { JSONSchema, ContentEncoding as JSONSchemaContentEncoding, Format as JSONSchemaFormat } from 'json-schema-typed/draft-2020-12';
8
+ import { JsonifiedClient } from '@orpc/openapi-client';
9
+ import { AnyRouter, ClientContext, Lazyable, CreateProcedureClientOptions, InferRouterInitialContext, Schema, ErrorMap, Meta, RouterClient } from '@orpc/server';
10
+ import { MaybeOptionalOptions } from '@orpc/shared';
11
+ import '@orpc/openapi-client/standard';
10
12
 
11
13
  type OverrideOperationValue = Partial<OpenAPIV3_1.OperationObject> | ((current: OpenAPIV3_1.OperationObject, procedure: AnyContractProcedure) => OpenAPIV3_1.OperationObject);
12
14
  /**
@@ -36,42 +38,6 @@ type FileSchema = JSONSchema & {
36
38
  */
37
39
  declare const LOGIC_KEYWORDS: string[];
38
40
 
39
- interface SchemaConvertOptions {
40
- strategy: 'input' | 'output';
41
- }
42
- interface SchemaConverter {
43
- convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<[required: boolean, jsonSchema: JSONSchema]>;
44
- }
45
- interface ConditionalSchemaConverter extends SchemaConverter {
46
- condition(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<boolean>;
47
- }
48
- declare class CompositeSchemaConverter implements SchemaConverter {
49
- private readonly converters;
50
- constructor(converters: ConditionalSchemaConverter[]);
51
- convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promise<[required: boolean, jsonSchema: JSONSchema]>;
52
- }
53
-
54
- interface OpenAPIGeneratorOptions extends StandardOpenAPIJsonSerializerOptions {
55
- schemaConverters?: ConditionalSchemaConverter[];
56
- }
57
- /**
58
- * The generator that converts oRPC routers/contracts to OpenAPI specifications.
59
- *
60
- * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification OpenAPI Specification Docs}
61
- */
62
- declare class OpenAPIGenerator {
63
- #private;
64
- private readonly serializer;
65
- private readonly converter;
66
- constructor(options?: OpenAPIGeneratorOptions);
67
- /**
68
- * Generates OpenAPI specifications from oRPC routers/contracts.
69
- *
70
- * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification OpenAPI Specification Docs}
71
- */
72
- generate(router: AnyContractRouter | AnyRouter, base: Omit<OpenAPIV3_1.Document, 'openapi'>): Promise<OpenAPIV3_1.Document>;
73
- }
74
-
75
41
  /**
76
42
  * @internal
77
43
  */
@@ -101,6 +67,8 @@ declare function checkParamsSchema(schema: ObjectSchema, params: string[]): bool
101
67
  */
102
68
  declare function toOpenAPISchema(schema: JSONSchema): OpenAPIV3_1.SchemaObject & object;
103
69
 
70
+ declare function createJsonifiedRouterClient<T extends AnyRouter, TClientContext extends ClientContext>(router: Lazyable<T | undefined>, ...rest: MaybeOptionalOptions<CreateProcedureClientOptions<InferRouterInitialContext<T>, Schema<unknown, unknown>, ErrorMap, Meta, TClientContext>>): JsonifiedClient<RouterClient<T, TClientContext>>;
71
+
104
72
  /**
105
73
  *@internal
106
74
  */
@@ -127,5 +95,5 @@ declare const oo: {
127
95
  spec: typeof customOpenAPIOperation;
128
96
  };
129
97
 
130
- export { CompositeSchemaConverter, LOGIC_KEYWORDS, OpenAPIGenerator, applyCustomOpenAPIOperation, applySchemaOptionality, checkParamsSchema, customOpenAPIOperation, filterSchemaBranches, getCustomOpenAPIOperation, isAnySchema, isFileSchema, isObjectSchema, oo, separateObjectSchema, toOpenAPIContent, toOpenAPIEventIteratorContent, toOpenAPIMethod, toOpenAPIParameters, toOpenAPIPath, toOpenAPISchema };
131
- export type { ConditionalSchemaConverter, FileSchema, ObjectSchema, OpenAPIGeneratorOptions, OverrideOperationValue, SchemaConvertOptions, SchemaConverter };
98
+ export { LOGIC_KEYWORDS, applyCustomOpenAPIOperation, applySchemaOptionality, checkParamsSchema, createJsonifiedRouterClient, customOpenAPIOperation, filterSchemaBranches, getCustomOpenAPIOperation, isAnySchema, isFileSchema, isObjectSchema, oo, separateObjectSchema, toOpenAPIContent, toOpenAPIEventIteratorContent, toOpenAPIMethod, toOpenAPIParameters, toOpenAPIPath, toOpenAPISchema };
99
+ export type { FileSchema, ObjectSchema, OverrideOperationValue };