@orpc/openapi 0.0.0-next.ef3ba82 → 0.0.0-next.fd1db03
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/dist/chunk-KNYXLM77.js +107 -0
- package/dist/fetch.js +590 -597
- package/dist/index.js +389 -4329
- package/dist/src/fetch/bracket-notation.d.ts +84 -0
- package/dist/src/fetch/index.d.ts +10 -3
- package/dist/src/fetch/input-structure-compact.d.ts +6 -0
- package/dist/src/fetch/input-structure-detailed.d.ts +11 -0
- package/dist/src/fetch/openapi-handler-server.d.ts +7 -0
- package/dist/src/fetch/openapi-handler-serverless.d.ts +7 -0
- package/dist/src/fetch/openapi-handler.d.ts +33 -0
- package/dist/src/fetch/openapi-payload-codec.d.ts +15 -0
- package/dist/src/fetch/openapi-procedure-matcher.d.ts +19 -0
- package/dist/src/fetch/schema-coercer.d.ts +10 -0
- package/dist/src/index.d.ts +11 -1
- package/dist/src/json-serializer.d.ts +5 -0
- package/dist/src/openapi-content-builder.d.ts +10 -0
- package/dist/src/openapi-error.d.ts +3 -0
- package/dist/src/openapi-generator.d.ts +56 -0
- package/dist/src/openapi-input-structure-parser.d.ts +22 -0
- package/dist/src/openapi-output-structure-parser.d.ts +18 -0
- package/dist/src/openapi-parameters-builder.d.ts +12 -0
- package/dist/src/openapi-path-parser.d.ts +8 -0
- package/dist/src/openapi.d.ts +3 -0
- package/dist/src/schema-converter.d.ts +16 -0
- package/dist/src/schema-utils.d.ts +11 -0
- package/dist/src/schema.d.ts +12 -0
- package/dist/src/utils.d.ts +18 -0
- package/package.json +14 -10
- package/dist/src/fetch/base-handler.d.ts +0 -14
- package/dist/src/fetch/server-handler.d.ts +0 -2
- package/dist/src/fetch/serverless-handler.d.ts +0 -2
- package/dist/src/generator.d.ts +0 -23
- package/dist/src/zod-to-json-schema.d.ts +0 -42
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Serialize an object or array into a list of [key, value] pairs.
|
|
3
|
+
* The key will express by using bracket-notation.
|
|
4
|
+
*
|
|
5
|
+
* Notice: This way cannot express the empty object or array.
|
|
6
|
+
*
|
|
7
|
+
* @example
|
|
8
|
+
* ```ts
|
|
9
|
+
* const payload = {
|
|
10
|
+
* name: 'John Doe',
|
|
11
|
+
* pets: ['dog', 'cat'],
|
|
12
|
+
* }
|
|
13
|
+
*
|
|
14
|
+
* const entities = serialize(payload)
|
|
15
|
+
*
|
|
16
|
+
* expect(entities).toEqual([
|
|
17
|
+
* ['name', 'John Doe'],
|
|
18
|
+
* ['name[pets][0]', 'dog'],
|
|
19
|
+
* ['name[pets][1]', 'cat'],
|
|
20
|
+
* ])
|
|
21
|
+
* ```
|
|
22
|
+
*/
|
|
23
|
+
export declare function serialize(payload: unknown, parentKey?: string): [string, unknown][];
|
|
24
|
+
/**
|
|
25
|
+
* Deserialize a list of [key, value] pairs into an object or array.
|
|
26
|
+
* The key is expressed by using bracket-notation.
|
|
27
|
+
*
|
|
28
|
+
* @example
|
|
29
|
+
* ```ts
|
|
30
|
+
* const entities = [
|
|
31
|
+
* ['name', 'John Doe'],
|
|
32
|
+
* ['name[pets][0]', 'dog'],
|
|
33
|
+
* ['name[pets][1]', 'cat'],
|
|
34
|
+
* ['name[dogs][]', 'hello'],
|
|
35
|
+
* ['name[dogs][]', 'kitty'],
|
|
36
|
+
* ]
|
|
37
|
+
*
|
|
38
|
+
* const payload = deserialize(entities)
|
|
39
|
+
*
|
|
40
|
+
* expect(payload).toEqual({
|
|
41
|
+
* name: 'John Doe',
|
|
42
|
+
* pets: { 0: 'dog', 1: 'cat' },
|
|
43
|
+
* dogs: ['hello', 'kitty'],
|
|
44
|
+
* })
|
|
45
|
+
* ```
|
|
46
|
+
*/
|
|
47
|
+
export declare function deserialize(entities: readonly (readonly [string, unknown])[]): Record<string, unknown> | unknown[] | undefined;
|
|
48
|
+
/**
|
|
49
|
+
* Escape the `[`, `]`, and `\` chars in a path segment.
|
|
50
|
+
*
|
|
51
|
+
* @example
|
|
52
|
+
* ```ts
|
|
53
|
+
* expect(escapeSegment('name[pets')).toEqual('name\\[pets')
|
|
54
|
+
* ```
|
|
55
|
+
*/
|
|
56
|
+
export declare function escapeSegment(segment: string): string;
|
|
57
|
+
/**
|
|
58
|
+
* Convert an array of path segments into a path string using bracket-notation.
|
|
59
|
+
*
|
|
60
|
+
* For the special char `[`, `]`, and `\` will be escaped by adding `\` at start.
|
|
61
|
+
*
|
|
62
|
+
* @example
|
|
63
|
+
* ```ts
|
|
64
|
+
* expect(stringifyPath(['name', 'pets', '0'])).toEqual('name[pets][0]')
|
|
65
|
+
* ```
|
|
66
|
+
*/
|
|
67
|
+
export declare function stringifyPath(path: readonly [string, ...string[]]): string;
|
|
68
|
+
/**
|
|
69
|
+
* Convert a path string using bracket-notation into an array of path segments.
|
|
70
|
+
*
|
|
71
|
+
* For the special char `[`, `]`, and `\` you should escape by adding `\` at start.
|
|
72
|
+
* It only treats a pair `[${string}]` as a path segment.
|
|
73
|
+
* If missing or escape it will bypass and treat as normal string.
|
|
74
|
+
*
|
|
75
|
+
* @example
|
|
76
|
+
* ```ts
|
|
77
|
+
* expect(parsePath('name[pets][0]')).toEqual(['name', 'pets', '0'])
|
|
78
|
+
* expect(parsePath('name[pets][0')).toEqual(['name', 'pets', '[0'])
|
|
79
|
+
* expect(parsePath('name[pets[0]')).toEqual(['name', 'pets[0')
|
|
80
|
+
* expect(parsePath('name\\[pets][0]')).toEqual(['name[pets]', '0'])
|
|
81
|
+
* ```
|
|
82
|
+
*/
|
|
83
|
+
export declare function parsePath(path: string): [string, ...string[]];
|
|
84
|
+
//# sourceMappingURL=bracket-notation.d.ts.map
|
|
@@ -1,3 +1,10 @@
|
|
|
1
|
-
export * from './
|
|
2
|
-
export * from './
|
|
3
|
-
export * from './
|
|
1
|
+
export * from './bracket-notation';
|
|
2
|
+
export * from './input-structure-compact';
|
|
3
|
+
export * from './input-structure-detailed';
|
|
4
|
+
export * from './openapi-handler';
|
|
5
|
+
export * from './openapi-handler-server';
|
|
6
|
+
export * from './openapi-handler-serverless';
|
|
7
|
+
export * from './openapi-payload-codec';
|
|
8
|
+
export * from './openapi-procedure-matcher';
|
|
9
|
+
export * from './schema-coercer';
|
|
10
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { Params } from 'hono/router';
|
|
2
|
+
export declare class InputStructureCompact {
|
|
3
|
+
build(params: Params, payload: unknown): unknown;
|
|
4
|
+
}
|
|
5
|
+
export type PublicInputStructureCompact = Pick<InputStructureCompact, keyof InputStructureCompact>;
|
|
6
|
+
//# sourceMappingURL=input-structure-compact.d.ts.map
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { Params } from 'hono/router';
|
|
2
|
+
export declare class InputStructureDetailed {
|
|
3
|
+
build(params: Params, query: unknown, headers: unknown, body: unknown): {
|
|
4
|
+
params: Params;
|
|
5
|
+
query: unknown;
|
|
6
|
+
headers: unknown;
|
|
7
|
+
body: unknown;
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
export type PublicInputStructureDetailed = Pick<InputStructureDetailed, keyof InputStructureDetailed>;
|
|
11
|
+
//# sourceMappingURL=input-structure-detailed.d.ts.map
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { Context, Router } from '@orpc/server';
|
|
2
|
+
import type { OpenAPIHandlerOptions } from './openapi-handler';
|
|
3
|
+
import { OpenAPIHandler } from './openapi-handler';
|
|
4
|
+
export declare class OpenAPIServerHandler<T extends Context> extends OpenAPIHandler<T> {
|
|
5
|
+
constructor(router: Router<T, any>, options?: NoInfer<OpenAPIHandlerOptions<T>>);
|
|
6
|
+
}
|
|
7
|
+
//# sourceMappingURL=openapi-handler-server.d.ts.map
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { Context, Router } from '@orpc/server';
|
|
2
|
+
import type { OpenAPIHandlerOptions } from './openapi-handler';
|
|
3
|
+
import { OpenAPIHandler } from './openapi-handler';
|
|
4
|
+
export declare class OpenAPIServerlessHandler<T extends Context> extends OpenAPIHandler<T> {
|
|
5
|
+
constructor(router: Router<T, any>, options?: NoInfer<OpenAPIHandlerOptions<T>>);
|
|
6
|
+
}
|
|
7
|
+
//# sourceMappingURL=openapi-handler-serverless.d.ts.map
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { Context, Router, WithSignal } from '@orpc/server';
|
|
2
|
+
import type { ConditionalFetchHandler, FetchOptions } from '@orpc/server/fetch';
|
|
3
|
+
import type { PublicInputStructureCompact } from './input-structure-compact';
|
|
4
|
+
import { type Hooks } from '@orpc/shared';
|
|
5
|
+
import { type PublicJSONSerializer } from '../json-serializer';
|
|
6
|
+
import { type PublicInputStructureDetailed } from './input-structure-detailed';
|
|
7
|
+
import { type PublicOpenAPIPayloadCodec } from './openapi-payload-codec';
|
|
8
|
+
import { type Hono, type PublicOpenAPIProcedureMatcher } from './openapi-procedure-matcher';
|
|
9
|
+
import { type SchemaCoercer } from './schema-coercer';
|
|
10
|
+
export type OpenAPIHandlerOptions<T extends Context> = Hooks<Request, Response, T, WithSignal> & {
|
|
11
|
+
jsonSerializer?: PublicJSONSerializer;
|
|
12
|
+
procedureMatcher?: PublicOpenAPIProcedureMatcher;
|
|
13
|
+
payloadCodec?: PublicOpenAPIPayloadCodec;
|
|
14
|
+
inputBuilderSimple?: PublicInputStructureCompact;
|
|
15
|
+
inputBuilderFull?: PublicInputStructureDetailed;
|
|
16
|
+
schemaCoercers?: SchemaCoercer[];
|
|
17
|
+
};
|
|
18
|
+
export declare class OpenAPIHandler<T extends Context> implements ConditionalFetchHandler<T> {
|
|
19
|
+
private readonly options?;
|
|
20
|
+
private readonly procedureMatcher;
|
|
21
|
+
private readonly payloadCodec;
|
|
22
|
+
private readonly inputStructureCompact;
|
|
23
|
+
private readonly inputStructureDetailed;
|
|
24
|
+
private readonly compositeSchemaCoercer;
|
|
25
|
+
constructor(hono: Hono, router: Router<T, any>, options?: NoInfer<OpenAPIHandlerOptions<T>> | undefined);
|
|
26
|
+
condition(request: Request): boolean;
|
|
27
|
+
fetch(request: Request, ...[options]: [options: FetchOptions<T>] | (undefined extends T ? [] : never)): Promise<Response>;
|
|
28
|
+
private decodeInput;
|
|
29
|
+
private encodeOutput;
|
|
30
|
+
private assertDetailedOutput;
|
|
31
|
+
private convertToORPCError;
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=openapi-handler.d.ts.map
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { PublicJSONSerializer } from '../json-serializer';
|
|
2
|
+
export declare class OpenAPIPayloadCodec {
|
|
3
|
+
private readonly jsonSerializer;
|
|
4
|
+
constructor(jsonSerializer: PublicJSONSerializer);
|
|
5
|
+
encode(payload: unknown, accept: string | undefined): {
|
|
6
|
+
body: FormData | Blob | string | undefined;
|
|
7
|
+
headers?: Headers;
|
|
8
|
+
};
|
|
9
|
+
private encodeAsJSON;
|
|
10
|
+
private encodeAsFormData;
|
|
11
|
+
private encodeAsURLSearchParams;
|
|
12
|
+
decode(re: Request | Response | Headers | URLSearchParams | FormData): Promise<unknown>;
|
|
13
|
+
}
|
|
14
|
+
export type PublicOpenAPIPayloadCodec = Pick<OpenAPIPayloadCodec, keyof OpenAPIPayloadCodec>;
|
|
15
|
+
//# sourceMappingURL=openapi-payload-codec.d.ts.map
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { Router as BaseHono, Params } from 'hono/router';
|
|
2
|
+
import { type ANY_PROCEDURE, type ANY_ROUTER } from '@orpc/server';
|
|
3
|
+
export type Hono = BaseHono<[string, string[]]>;
|
|
4
|
+
export declare class OpenAPIProcedureMatcher {
|
|
5
|
+
private readonly hono;
|
|
6
|
+
private readonly router;
|
|
7
|
+
private pendingRouters;
|
|
8
|
+
constructor(hono: Hono, router: ANY_ROUTER);
|
|
9
|
+
match(method: string, pathname: string): Promise<{
|
|
10
|
+
path: string[];
|
|
11
|
+
procedure: ANY_PROCEDURE;
|
|
12
|
+
params: Params;
|
|
13
|
+
} | undefined>;
|
|
14
|
+
private add;
|
|
15
|
+
private handlePendingRouters;
|
|
16
|
+
private convertOpenAPIPathToRouterPath;
|
|
17
|
+
}
|
|
18
|
+
export type PublicOpenAPIProcedureMatcher = Pick<OpenAPIProcedureMatcher, keyof OpenAPIProcedureMatcher>;
|
|
19
|
+
//# sourceMappingURL=openapi-procedure-matcher.d.ts.map
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { Schema } from '@orpc/contract';
|
|
2
|
+
export interface SchemaCoercer {
|
|
3
|
+
coerce: (schema: Schema, value: unknown) => unknown;
|
|
4
|
+
}
|
|
5
|
+
export declare class CompositeSchemaCoercer implements SchemaCoercer {
|
|
6
|
+
private readonly coercers;
|
|
7
|
+
constructor(coercers: SchemaCoercer[]);
|
|
8
|
+
coerce(schema: Schema, value: unknown): unknown;
|
|
9
|
+
}
|
|
10
|
+
//# sourceMappingURL=schema-coercer.d.ts.map
|
package/dist/src/index.d.ts
CHANGED
|
@@ -1,2 +1,12 @@
|
|
|
1
1
|
/** unnoq */
|
|
2
|
-
export * from './
|
|
2
|
+
export * from './json-serializer';
|
|
3
|
+
export * from './openapi';
|
|
4
|
+
export * from './openapi-content-builder';
|
|
5
|
+
export * from './openapi-generator';
|
|
6
|
+
export * from './openapi-parameters-builder';
|
|
7
|
+
export * from './openapi-path-parser';
|
|
8
|
+
export * from './schema';
|
|
9
|
+
export * from './schema-converter';
|
|
10
|
+
export * from './schema-utils';
|
|
11
|
+
export * from './utils';
|
|
12
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { OpenAPI } from './openapi';
|
|
2
|
+
import type { JSONSchema } from './schema';
|
|
3
|
+
import type { PublicSchemaUtils } from './schema-utils';
|
|
4
|
+
export declare class OpenAPIContentBuilder {
|
|
5
|
+
private readonly schemaUtils;
|
|
6
|
+
constructor(schemaUtils: PublicSchemaUtils);
|
|
7
|
+
build(jsonSchema: JSONSchema.JSONSchema, options?: Partial<OpenAPI.MediaTypeObject>): OpenAPI.ContentObject;
|
|
8
|
+
}
|
|
9
|
+
export type PublicOpenAPIContentBuilder = Pick<OpenAPIContentBuilder, keyof OpenAPIContentBuilder>;
|
|
10
|
+
//# sourceMappingURL=openapi-content-builder.d.ts.map
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import type { ContractRouter } from '@orpc/contract';
|
|
2
|
+
import type { ANY_ROUTER } from '@orpc/server';
|
|
3
|
+
import type { PublicOpenAPIInputStructureParser } from './openapi-input-structure-parser';
|
|
4
|
+
import type { PublicOpenAPIOutputStructureParser } from './openapi-output-structure-parser';
|
|
5
|
+
import type { PublicOpenAPIPathParser } from './openapi-path-parser';
|
|
6
|
+
import type { SchemaConverter } from './schema-converter';
|
|
7
|
+
import { type PublicJSONSerializer } from './json-serializer';
|
|
8
|
+
import { type OpenAPI } from './openapi';
|
|
9
|
+
import { type PublicOpenAPIContentBuilder } from './openapi-content-builder';
|
|
10
|
+
import { type PublicOpenAPIParametersBuilder } from './openapi-parameters-builder';
|
|
11
|
+
import { type PublicSchemaUtils } from './schema-utils';
|
|
12
|
+
export interface OpenAPIGeneratorOptions {
|
|
13
|
+
contentBuilder?: PublicOpenAPIContentBuilder;
|
|
14
|
+
parametersBuilder?: PublicOpenAPIParametersBuilder;
|
|
15
|
+
schemaConverters?: SchemaConverter[];
|
|
16
|
+
schemaUtils?: PublicSchemaUtils;
|
|
17
|
+
jsonSerializer?: PublicJSONSerializer;
|
|
18
|
+
pathParser?: PublicOpenAPIPathParser;
|
|
19
|
+
inputStructureParser?: PublicOpenAPIInputStructureParser;
|
|
20
|
+
outputStructureParser?: PublicOpenAPIOutputStructureParser;
|
|
21
|
+
/**
|
|
22
|
+
* Throw error when you missing define tag definition on OpenAPI root tags
|
|
23
|
+
*
|
|
24
|
+
* Example: if procedure has tags ['foo', 'bar'], and OpenAPI root tags is ['foo'], then error will be thrown
|
|
25
|
+
* Because OpenAPI root tags is missing 'bar' tag
|
|
26
|
+
*
|
|
27
|
+
* @default false
|
|
28
|
+
*/
|
|
29
|
+
considerMissingTagDefinitionAsError?: boolean;
|
|
30
|
+
/**
|
|
31
|
+
* Weather ignore procedures that has no path defined.
|
|
32
|
+
*
|
|
33
|
+
* @default false
|
|
34
|
+
*/
|
|
35
|
+
ignoreUndefinedPathProcedures?: boolean;
|
|
36
|
+
/**
|
|
37
|
+
* Throw error when you have error in OpenAPI generator
|
|
38
|
+
*
|
|
39
|
+
* @default false
|
|
40
|
+
*/
|
|
41
|
+
throwOnError?: boolean;
|
|
42
|
+
}
|
|
43
|
+
export declare class OpenAPIGenerator {
|
|
44
|
+
private readonly options?;
|
|
45
|
+
private readonly contentBuilder;
|
|
46
|
+
private readonly parametersBuilder;
|
|
47
|
+
private readonly schemaConverter;
|
|
48
|
+
private readonly schemaUtils;
|
|
49
|
+
private readonly jsonSerializer;
|
|
50
|
+
private readonly pathParser;
|
|
51
|
+
private readonly inputStructureParser;
|
|
52
|
+
private readonly outputStructureParser;
|
|
53
|
+
constructor(options?: OpenAPIGeneratorOptions | undefined);
|
|
54
|
+
generate(router: ContractRouter | ANY_ROUTER, doc: Omit<OpenAPI.OpenAPIObject, 'openapi'>): Promise<OpenAPI.OpenAPIObject>;
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=openapi-generator.d.ts.map
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { ANY_CONTRACT_PROCEDURE } from '@orpc/contract';
|
|
2
|
+
import type { PublicOpenAPIPathParser } from './openapi-path-parser';
|
|
3
|
+
import type { JSONSchema, ObjectSchema } from './schema';
|
|
4
|
+
import type { SchemaConverter } from './schema-converter';
|
|
5
|
+
import type { PublicSchemaUtils } from './schema-utils';
|
|
6
|
+
export interface OpenAPIInputStructureParseResult {
|
|
7
|
+
paramsSchema: ObjectSchema | undefined;
|
|
8
|
+
querySchema: ObjectSchema | undefined;
|
|
9
|
+
headersSchema: ObjectSchema | undefined;
|
|
10
|
+
bodySchema: JSONSchema.JSONSchema | undefined;
|
|
11
|
+
}
|
|
12
|
+
export declare class OpenAPIInputStructureParser {
|
|
13
|
+
private readonly schemaConverter;
|
|
14
|
+
private readonly schemaUtils;
|
|
15
|
+
private readonly pathParser;
|
|
16
|
+
constructor(schemaConverter: SchemaConverter, schemaUtils: PublicSchemaUtils, pathParser: PublicOpenAPIPathParser);
|
|
17
|
+
parse(contract: ANY_CONTRACT_PROCEDURE, structure: 'compact' | 'detailed'): OpenAPIInputStructureParseResult;
|
|
18
|
+
private parseDetailedSchema;
|
|
19
|
+
private parseCompactSchema;
|
|
20
|
+
}
|
|
21
|
+
export type PublicOpenAPIInputStructureParser = Pick<OpenAPIInputStructureParser, keyof OpenAPIInputStructureParser>;
|
|
22
|
+
//# sourceMappingURL=openapi-input-structure-parser.d.ts.map
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { ANY_CONTRACT_PROCEDURE } from '@orpc/contract';
|
|
2
|
+
import type { JSONSchema, ObjectSchema } from './schema';
|
|
3
|
+
import type { SchemaConverter } from './schema-converter';
|
|
4
|
+
import type { PublicSchemaUtils } from './schema-utils';
|
|
5
|
+
export interface OpenAPIOutputStructureParseResult {
|
|
6
|
+
headersSchema: ObjectSchema | undefined;
|
|
7
|
+
bodySchema: JSONSchema.JSONSchema | undefined;
|
|
8
|
+
}
|
|
9
|
+
export declare class OpenAPIOutputStructureParser {
|
|
10
|
+
private readonly schemaConverter;
|
|
11
|
+
private readonly schemaUtils;
|
|
12
|
+
constructor(schemaConverter: SchemaConverter, schemaUtils: PublicSchemaUtils);
|
|
13
|
+
parse(contract: ANY_CONTRACT_PROCEDURE, structure: 'compact' | 'detailed'): OpenAPIOutputStructureParseResult;
|
|
14
|
+
private parseDetailedSchema;
|
|
15
|
+
private parseCompactSchema;
|
|
16
|
+
}
|
|
17
|
+
export type PublicOpenAPIOutputStructureParser = Pick<OpenAPIOutputStructureParser, keyof OpenAPIOutputStructureParser>;
|
|
18
|
+
//# sourceMappingURL=openapi-output-structure-parser.d.ts.map
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { OpenAPI } from './openapi';
|
|
2
|
+
import type { JSONSchema } from './schema';
|
|
3
|
+
export declare class OpenAPIParametersBuilder {
|
|
4
|
+
build(paramIn: OpenAPI.ParameterObject['in'], jsonSchema: JSONSchema.JSONSchema & {
|
|
5
|
+
type: 'object';
|
|
6
|
+
} & object, options?: Pick<OpenAPI.ParameterObject, 'example' | 'style' | 'required'>): OpenAPI.ParameterObject[];
|
|
7
|
+
buildHeadersObject(jsonSchema: JSONSchema.JSONSchema & {
|
|
8
|
+
type: 'object';
|
|
9
|
+
} & object, options?: Pick<OpenAPI.ParameterObject, 'example' | 'style' | 'required'>): OpenAPI.HeadersObject;
|
|
10
|
+
}
|
|
11
|
+
export type PublicOpenAPIParametersBuilder = Pick<OpenAPIParametersBuilder, keyof OpenAPIParametersBuilder>;
|
|
12
|
+
//# sourceMappingURL=openapi-parameters-builder.d.ts.map
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { Schema } from '@orpc/contract';
|
|
2
|
+
import type { JSONSchema } from './schema';
|
|
3
|
+
export interface SchemaConvertOptions {
|
|
4
|
+
strategy: 'input' | 'output';
|
|
5
|
+
}
|
|
6
|
+
export interface SchemaConverter {
|
|
7
|
+
condition: (schema: Schema, options: SchemaConvertOptions) => boolean;
|
|
8
|
+
convert: (schema: Schema, options: SchemaConvertOptions) => JSONSchema.JSONSchema;
|
|
9
|
+
}
|
|
10
|
+
export declare class CompositeSchemaConverter implements SchemaConverter {
|
|
11
|
+
private readonly converters;
|
|
12
|
+
constructor(converters: SchemaConverter[]);
|
|
13
|
+
condition(): boolean;
|
|
14
|
+
convert(schema: Schema, options: SchemaConvertOptions): JSONSchema.JSONSchema;
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=schema-converter.d.ts.map
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { type FileSchema, type JSONSchema, type ObjectSchema } from './schema';
|
|
2
|
+
export declare class SchemaUtils {
|
|
3
|
+
isFileSchema(schema: JSONSchema.JSONSchema): schema is FileSchema;
|
|
4
|
+
isObjectSchema(schema: JSONSchema.JSONSchema): schema is ObjectSchema;
|
|
5
|
+
isAnySchema(schema: JSONSchema.JSONSchema): boolean;
|
|
6
|
+
isUndefinableSchema(schema: JSONSchema.JSONSchema): boolean;
|
|
7
|
+
separateObjectSchema(schema: ObjectSchema, separatedProperties: string[]): [matched: ObjectSchema, rest: ObjectSchema];
|
|
8
|
+
filterSchemaBranches(schema: JSONSchema.JSONSchema, check: (schema: JSONSchema.JSONSchema) => boolean, matches?: JSONSchema.JSONSchema[]): [matches: JSONSchema.JSONSchema[], rest: JSONSchema.JSONSchema | undefined];
|
|
9
|
+
}
|
|
10
|
+
export type PublicSchemaUtils = Pick<SchemaUtils, keyof SchemaUtils>;
|
|
11
|
+
//# sourceMappingURL=schema-utils.d.ts.map
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import * as JSONSchema from 'json-schema-typed/draft-2020-12';
|
|
2
|
+
export { Format as JSONSchemaFormat } from 'json-schema-typed/draft-2020-12';
|
|
3
|
+
export { JSONSchema };
|
|
4
|
+
export type ObjectSchema = JSONSchema.JSONSchema & {
|
|
5
|
+
type: 'object';
|
|
6
|
+
} & object;
|
|
7
|
+
export type FileSchema = JSONSchema.JSONSchema & {
|
|
8
|
+
type: 'string';
|
|
9
|
+
contentMediaType: string;
|
|
10
|
+
} & object;
|
|
11
|
+
export declare const NON_LOGIC_KEYWORDS: ("$anchor" | "$comment" | "$defs" | "$dynamicAnchor" | "$dynamicRef" | "$id" | "$schema" | "$vocabulary" | "contentEncoding" | "contentMediaType" | "default" | "definitions" | "deprecated" | "description" | "examples" | "format" | "readOnly" | "title" | "writeOnly")[];
|
|
12
|
+
//# sourceMappingURL=schema.d.ts.map
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { ContractRouter, HTTPPath, WELL_CONTRACT_PROCEDURE } from '@orpc/contract';
|
|
2
|
+
import type { ANY_PROCEDURE, ANY_ROUTER, Lazy } from '@orpc/server';
|
|
3
|
+
export interface EachLeafOptions {
|
|
4
|
+
router: ContractRouter | ANY_ROUTER;
|
|
5
|
+
path: string[];
|
|
6
|
+
}
|
|
7
|
+
export interface EachLeafCallbackOptions {
|
|
8
|
+
contract: WELL_CONTRACT_PROCEDURE;
|
|
9
|
+
path: string[];
|
|
10
|
+
}
|
|
11
|
+
export interface EachContractLeafResultItem {
|
|
12
|
+
router: Lazy<ANY_PROCEDURE> | Lazy<Record<string, ANY_ROUTER> | ANY_PROCEDURE>;
|
|
13
|
+
path: string[];
|
|
14
|
+
}
|
|
15
|
+
export declare function forEachContractProcedure(options: EachLeafOptions, callback: (options: EachLeafCallbackOptions) => void, result?: EachContractLeafResultItem[], isCurrentRouterContract?: boolean): EachContractLeafResultItem[];
|
|
16
|
+
export declare function forEachAllContractProcedure(router: ContractRouter | ANY_ROUTER, callback: (options: EachLeafCallbackOptions) => void): Promise<void>;
|
|
17
|
+
export declare function standardizeHTTPPath(path: HTTPPath): HTTPPath;
|
|
18
|
+
//# sourceMappingURL=utils.d.ts.map
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@orpc/openapi",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "0.0.0-next.
|
|
4
|
+
"version": "0.0.0-next.fd1db03",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"homepage": "https://orpc.unnoq.com",
|
|
7
7
|
"repository": {
|
|
@@ -29,26 +29,30 @@
|
|
|
29
29
|
}
|
|
30
30
|
},
|
|
31
31
|
"files": [
|
|
32
|
-
"
|
|
32
|
+
"!**/*.map",
|
|
33
|
+
"!**/*.tsbuildinfo",
|
|
33
34
|
"dist"
|
|
34
35
|
],
|
|
35
36
|
"dependencies": {
|
|
37
|
+
"@standard-schema/spec": "1.0.0-beta.4",
|
|
38
|
+
"@types/content-disposition": "^0.5.8",
|
|
39
|
+
"content-disposition": "^0.5.4",
|
|
36
40
|
"escape-string-regexp": "^5.0.0",
|
|
41
|
+
"fast-content-type-parse": "^2.0.0",
|
|
42
|
+
"hono": "^4.6.12",
|
|
37
43
|
"json-schema-typed": "^8.0.1",
|
|
38
44
|
"openapi3-ts": "^4.4.0",
|
|
39
|
-
"
|
|
40
|
-
"@orpc/
|
|
41
|
-
"@orpc/
|
|
42
|
-
"@orpc/
|
|
43
|
-
"@orpc/transformer": "0.0.0-next.ef3ba82"
|
|
45
|
+
"wildcard-match": "^5.1.3",
|
|
46
|
+
"@orpc/shared": "0.0.0-next.fd1db03",
|
|
47
|
+
"@orpc/server": "0.0.0-next.fd1db03",
|
|
48
|
+
"@orpc/contract": "0.0.0-next.fd1db03"
|
|
44
49
|
},
|
|
45
50
|
"devDependencies": {
|
|
46
51
|
"@readme/openapi-parser": "^2.6.0",
|
|
47
|
-
"
|
|
48
|
-
"zod": "^3.23.8"
|
|
52
|
+
"zod": "^3.24.1"
|
|
49
53
|
},
|
|
50
54
|
"scripts": {
|
|
51
|
-
"build": "tsup --clean --entry.index=src/index.ts --entry.fetch=src/fetch/index.ts --format=esm --onSuccess='tsc -b --noCheck'",
|
|
55
|
+
"build": "tsup --clean --sourcemap --entry.index=src/index.ts --entry.fetch=src/fetch/index.ts --format=esm --onSuccess='tsc -b --noCheck'",
|
|
52
56
|
"build:watch": "pnpm run build --watch",
|
|
53
57
|
"type:check": "tsc -b"
|
|
54
58
|
}
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
import type { HTTPPath } from '@orpc/contract';
|
|
2
|
-
import type { FetchHandler } from '@orpc/server/fetch';
|
|
3
|
-
import type { Router as HonoRouter } from 'hono/router';
|
|
4
|
-
import { type Procedure, type Router } from '@orpc/server';
|
|
5
|
-
export type ResolveRouter = (router: Router<any>, method: string, pathname: string) => {
|
|
6
|
-
path: string[];
|
|
7
|
-
procedure: Procedure<any, any, any, any, any>;
|
|
8
|
-
params: Record<string, string>;
|
|
9
|
-
} | undefined;
|
|
10
|
-
type Routing = HonoRouter<[string[], Procedure<any, any, any, any, any>]>;
|
|
11
|
-
export declare function createOpenAPIHandler(createHonoRouter: () => Routing): FetchHandler;
|
|
12
|
-
export declare function createResolveRouter(createHonoRouter: () => Routing): ResolveRouter;
|
|
13
|
-
export declare function openAPIPathToRouterPath(path: HTTPPath): string;
|
|
14
|
-
export {};
|
package/dist/src/generator.d.ts
DELETED
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
import { type ContractRouter } from '@orpc/contract';
|
|
2
|
-
import { type Router } from '@orpc/server';
|
|
3
|
-
import { type OpenAPIObject } from 'openapi3-ts/oas31';
|
|
4
|
-
export interface GenerateOpenAPIOptions {
|
|
5
|
-
/**
|
|
6
|
-
* Throw error when you missing define tag definition on OpenAPI root tags
|
|
7
|
-
*
|
|
8
|
-
* Example: if procedure has tags ['foo', 'bar'], and OpenAPI root tags is ['foo'], then error will be thrown
|
|
9
|
-
* Because OpenAPI root tags is missing 'bar' tag
|
|
10
|
-
*
|
|
11
|
-
* @default false
|
|
12
|
-
*/
|
|
13
|
-
throwOnMissingTagDefinition?: boolean;
|
|
14
|
-
/**
|
|
15
|
-
* Weather ignore procedures that has no path defined.
|
|
16
|
-
*
|
|
17
|
-
* @default false
|
|
18
|
-
*/
|
|
19
|
-
ignoreUndefinedPathProcedures?: boolean;
|
|
20
|
-
}
|
|
21
|
-
export declare function generateOpenAPI(opts: {
|
|
22
|
-
router: ContractRouter | Router<any>;
|
|
23
|
-
} & Omit<OpenAPIObject, 'openapi'>, options?: GenerateOpenAPIOptions): OpenAPIObject;
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
import { type JSONSchema } from 'json-schema-typed/draft-2020-12';
|
|
2
|
-
import { type ZodTypeAny } from 'zod';
|
|
3
|
-
export declare const NON_LOGIC_KEYWORDS: ("$anchor" | "$comment" | "$defs" | "$dynamicAnchor" | "$dynamicRef" | "$id" | "$schema" | "$vocabulary" | "contentEncoding" | "contentMediaType" | "default" | "definitions" | "deprecated" | "description" | "examples" | "format" | "readOnly" | "title" | "writeOnly")[];
|
|
4
|
-
export declare const UNSUPPORTED_JSON_SCHEMA: {
|
|
5
|
-
not: {};
|
|
6
|
-
};
|
|
7
|
-
export declare const UNDEFINED_JSON_SCHEMA: {
|
|
8
|
-
const: string;
|
|
9
|
-
};
|
|
10
|
-
export interface ZodToJsonSchemaOptions {
|
|
11
|
-
/**
|
|
12
|
-
* Max depth of lazy type, if it exceeds.
|
|
13
|
-
*
|
|
14
|
-
* Used `{}` when reach max depth
|
|
15
|
-
*
|
|
16
|
-
* @default 5
|
|
17
|
-
*/
|
|
18
|
-
maxLazyDepth?: number;
|
|
19
|
-
/**
|
|
20
|
-
* The length used to track the depth of lazy type
|
|
21
|
-
*
|
|
22
|
-
* @internal
|
|
23
|
-
*/
|
|
24
|
-
lazyDepth?: number;
|
|
25
|
-
/**
|
|
26
|
-
* The expected json schema for input or output zod schema
|
|
27
|
-
*
|
|
28
|
-
* @default input
|
|
29
|
-
*/
|
|
30
|
-
mode?: 'input' | 'output';
|
|
31
|
-
/**
|
|
32
|
-
* Track if current level schema is handled custom json schema to prevent recursive
|
|
33
|
-
*
|
|
34
|
-
* @internal
|
|
35
|
-
*/
|
|
36
|
-
isHandledCustomJSONSchema?: boolean;
|
|
37
|
-
}
|
|
38
|
-
export declare function zodToJsonSchema(schema: ZodTypeAny, options?: ZodToJsonSchemaOptions): Exclude<JSONSchema, boolean>;
|
|
39
|
-
export declare function extractJSONSchema(schema: JSONSchema, check: (schema: JSONSchema) => boolean, matches?: JSONSchema[]): {
|
|
40
|
-
schema: JSONSchema | undefined;
|
|
41
|
-
matches: JSONSchema[];
|
|
42
|
-
};
|