@scalar/types 0.11.0 → 0.12.1
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/CHANGELOG.md +22 -0
- package/dist/api-reference/api-reference-configuration.d.ts +1 -0
- package/dist/api-reference/api-reference-configuration.d.ts.map +1 -1
- package/dist/api-reference/api-reference-configuration.js +16 -0
- package/dist/api-reference/types.d.ts +11 -1
- package/dist/api-reference/types.d.ts.map +1 -1
- package/dist/asyncapi/3.1/index.d.ts +2 -0
- package/dist/asyncapi/3.1/index.d.ts.map +1 -0
- package/dist/asyncapi/3.1/index.generated.d.ts +753 -0
- package/dist/asyncapi/3.1/index.generated.d.ts.map +1 -0
- package/dist/asyncapi/3.1/index.generated.js +6 -0
- package/dist/asyncapi/3.1/index.js +1 -0
- package/dist/extensions/document/index.d.ts +222 -0
- package/dist/extensions/document/index.d.ts.map +1 -0
- package/dist/extensions/document/index.js +6 -0
- package/dist/extensions/example/index.d.ts +18 -0
- package/dist/extensions/example/index.d.ts.map +1 -0
- package/dist/extensions/example/index.js +6 -0
- package/dist/extensions/general/index.d.ts +90 -0
- package/dist/extensions/general/index.d.ts.map +1 -0
- package/dist/extensions/general/index.js +6 -0
- package/dist/extensions/index.d.ts +16 -0
- package/dist/extensions/index.d.ts.map +1 -0
- package/dist/extensions/index.js +6 -0
- package/dist/extensions/operation/index.d.ts +136 -0
- package/dist/extensions/operation/index.d.ts.map +1 -0
- package/dist/extensions/operation/index.js +6 -0
- package/dist/extensions/parameter/index.d.ts +18 -0
- package/dist/extensions/parameter/index.d.ts.map +1 -0
- package/dist/extensions/parameter/index.js +6 -0
- package/dist/extensions/schema/index.d.ts +75 -0
- package/dist/extensions/schema/index.d.ts.map +1 -0
- package/dist/extensions/schema/index.js +6 -0
- package/dist/extensions/security/index.d.ts +139 -0
- package/dist/extensions/security/index.d.ts.map +1 -0
- package/dist/extensions/security/index.js +6 -0
- package/dist/extensions/server/index.d.ts +18 -0
- package/dist/extensions/server/index.d.ts.map +1 -0
- package/dist/extensions/server/index.js +6 -0
- package/dist/extensions/tag/index.d.ts +55 -0
- package/dist/extensions/tag/index.d.ts.map +1 -0
- package/dist/extensions/tag/index.js +6 -0
- package/dist/extensions/workspace/index.d.ts +44 -0
- package/dist/extensions/workspace/index.d.ts.map +1 -0
- package/dist/extensions/workspace/index.js +6 -0
- package/dist/openapi/3.1/index.d.ts +4 -0
- package/dist/openapi/3.1/index.d.ts.map +1 -0
- package/dist/openapi/3.1/index.generated.d.ts +1199 -0
- package/dist/openapi/3.1/index.generated.d.ts.map +1 -0
- package/dist/openapi/3.1/index.generated.js +6 -0
- package/dist/openapi/3.1/index.js +1 -0
- package/package.json +66 -1
|
@@ -0,0 +1,753 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* This file is autogenerated. Do not edit it.
|
|
3
|
+
*
|
|
4
|
+
* Generated at: 2026-05-21T18:41:31.917Z
|
|
5
|
+
*/
|
|
6
|
+
export type AsyncApiContactObject = {
|
|
7
|
+
/** The identifying name of the contact person/organization. */
|
|
8
|
+
name?: string;
|
|
9
|
+
/** The URL pointing to the contact information. This MUST be in the form of an absolute URL. */
|
|
10
|
+
url?: string;
|
|
11
|
+
/** The email address of the contact person/organization. */
|
|
12
|
+
email?: string;
|
|
13
|
+
};
|
|
14
|
+
export type AsyncApiLicenseObject = {
|
|
15
|
+
/** REQUIRED. The license name used for the API. */
|
|
16
|
+
name: string;
|
|
17
|
+
/** A URL to the license used for the API. This MUST be in the form of an absolute URL. */
|
|
18
|
+
url?: string;
|
|
19
|
+
};
|
|
20
|
+
/** JSON Reference for AsyncAPI components. */
|
|
21
|
+
export type AsyncApiReferenceObject = {
|
|
22
|
+
/** REQUIRED. The reference string. */
|
|
23
|
+
$ref: string;
|
|
24
|
+
};
|
|
25
|
+
export type ReferenceObjectExtensions = {
|
|
26
|
+
/** Indicates the current status of the reference resolution. Can be either 'loading' while fetching the reference or 'error' if the resolution failed. */
|
|
27
|
+
$status?: 'loading' | 'error';
|
|
28
|
+
/** Indicates whether this reference should be resolved globally across all documents, rather than just within the current document context. */
|
|
29
|
+
$global?: boolean;
|
|
30
|
+
};
|
|
31
|
+
export type AsyncApiExternalDocumentationObject = {
|
|
32
|
+
/** A short description of the target documentation. CommonMark syntax MAY be used for rich text representation. */
|
|
33
|
+
description?: string;
|
|
34
|
+
/** REQUIRED. The URL for the target documentation. This MUST be in the form of an absolute URL. */
|
|
35
|
+
url: string;
|
|
36
|
+
};
|
|
37
|
+
export type AsyncApiTagObject = {
|
|
38
|
+
/** REQUIRED. The name of the tag. */
|
|
39
|
+
name: string;
|
|
40
|
+
/** A short description for the tag. CommonMark syntax MAY be used for rich text representation. */
|
|
41
|
+
description?: string;
|
|
42
|
+
externalDocs?: AsyncApiExternalDocumentationObject | (AsyncApiReferenceObject & {
|
|
43
|
+
'$ref-value': AsyncApiExternalDocumentationObject;
|
|
44
|
+
} & ReferenceObjectExtensions);
|
|
45
|
+
};
|
|
46
|
+
/** A list of Tag Objects (entries MAY be Reference Objects). */
|
|
47
|
+
export type AsyncApiTagsObject = (AsyncApiTagObject | (AsyncApiReferenceObject & {
|
|
48
|
+
'$ref-value': AsyncApiTagObject;
|
|
49
|
+
} & ReferenceObjectExtensions))[];
|
|
50
|
+
export type AsyncApiInfoObject = {
|
|
51
|
+
/** REQUIRED. The title of the application. */
|
|
52
|
+
title: string;
|
|
53
|
+
/** REQUIRED. Provides the version of the application API (not to be confused with the AsyncAPI Specification version). */
|
|
54
|
+
version: string;
|
|
55
|
+
/** A short description of the application. CommonMark syntax MAY be used for rich text representation. */
|
|
56
|
+
description?: string;
|
|
57
|
+
/** A URL to the Terms of Service for the API (absolute URL). */
|
|
58
|
+
termsOfService?: string;
|
|
59
|
+
contact?: AsyncApiContactObject;
|
|
60
|
+
license?: AsyncApiLicenseObject | (AsyncApiReferenceObject & {
|
|
61
|
+
'$ref-value': AsyncApiLicenseObject;
|
|
62
|
+
} & ReferenceObjectExtensions);
|
|
63
|
+
/** A list of Tag Objects (entries MAY be Reference Objects). */
|
|
64
|
+
tags?: AsyncApiTagsObject;
|
|
65
|
+
externalDocs?: AsyncApiExternalDocumentationObject | (AsyncApiReferenceObject & {
|
|
66
|
+
'$ref-value': AsyncApiExternalDocumentationObject;
|
|
67
|
+
} & ReferenceObjectExtensions);
|
|
68
|
+
};
|
|
69
|
+
export type AsyncApiServerVariableObject = {
|
|
70
|
+
/** An enumeration of string values for substitution. */
|
|
71
|
+
enum?: string[];
|
|
72
|
+
/** The default value to use for substitution, and to send, if an alternate value is not supplied. */
|
|
73
|
+
default?: string;
|
|
74
|
+
/** An optional description for the server variable. CommonMark syntax MAY be used for rich text representation. */
|
|
75
|
+
description?: string;
|
|
76
|
+
/** Examples of the server variable. */
|
|
77
|
+
examples?: string[];
|
|
78
|
+
};
|
|
79
|
+
export type AsyncApiOAuthFlowObject = {
|
|
80
|
+
/** REQUIRED for implicit and authorizationCode flows. The authorization URL (absolute URL). */
|
|
81
|
+
authorizationUrl?: string;
|
|
82
|
+
/** REQUIRED for password, clientCredentials, and authorizationCode flows. The token URL (absolute URL). */
|
|
83
|
+
tokenUrl?: string;
|
|
84
|
+
/** The URL to be used for obtaining refresh tokens. This MUST be in the form of an absolute URL. */
|
|
85
|
+
refreshUrl?: string;
|
|
86
|
+
/** REQUIRED for OAuth2 flows. Map of scope name to a short description. */
|
|
87
|
+
availableScopes?: Record<string, string>;
|
|
88
|
+
};
|
|
89
|
+
export type AsyncApiOAuthFlowsObject = {
|
|
90
|
+
implicit?: AsyncApiOAuthFlowObject | (AsyncApiReferenceObject & {
|
|
91
|
+
'$ref-value': AsyncApiOAuthFlowObject;
|
|
92
|
+
} & ReferenceObjectExtensions);
|
|
93
|
+
password?: AsyncApiOAuthFlowObject | (AsyncApiReferenceObject & {
|
|
94
|
+
'$ref-value': AsyncApiOAuthFlowObject;
|
|
95
|
+
} & ReferenceObjectExtensions);
|
|
96
|
+
clientCredentials?: AsyncApiOAuthFlowObject | (AsyncApiReferenceObject & {
|
|
97
|
+
'$ref-value': AsyncApiOAuthFlowObject;
|
|
98
|
+
} & ReferenceObjectExtensions);
|
|
99
|
+
authorizationCode?: AsyncApiOAuthFlowObject | (AsyncApiReferenceObject & {
|
|
100
|
+
'$ref-value': AsyncApiOAuthFlowObject;
|
|
101
|
+
} & ReferenceObjectExtensions);
|
|
102
|
+
};
|
|
103
|
+
export type AsyncApiSecuritySchemeObject = {
|
|
104
|
+
/** REQUIRED. Security scheme type: userPassword, apiKey, X509, symmetricEncryption, asymmetricEncryption, httpApiKey, http, oauth2, openIdConnect, plain, scramSha256, scramSha512, gssapi. */
|
|
105
|
+
type: 'userPassword' | 'apiKey' | 'X509' | 'symmetricEncryption' | 'asymmetricEncryption' | 'httpApiKey' | 'http' | 'oauth2' | 'openIdConnect' | 'plain' | 'scramSha256' | 'scramSha512' | 'gssapi';
|
|
106
|
+
/** A short description for security scheme. CommonMark syntax MAY be used for rich text representation. */
|
|
107
|
+
description?: string;
|
|
108
|
+
/** REQUIRED for httpApiKey. The name of the header, query or cookie parameter. */
|
|
109
|
+
name?: string;
|
|
110
|
+
/** REQUIRED for apiKey and httpApiKey. Location of the API key: user, password, query, header, or cookie. */
|
|
111
|
+
in?: 'user' | 'password' | 'query' | 'header' | 'cookie';
|
|
112
|
+
/** REQUIRED for http. The name of the HTTP Authorization scheme to be used in the Authorization header. */
|
|
113
|
+
scheme?: string;
|
|
114
|
+
/** A hint to the client to identify how the bearer token is formatted. */
|
|
115
|
+
bearerFormat?: string;
|
|
116
|
+
flows?: AsyncApiOAuthFlowsObject | (AsyncApiReferenceObject & {
|
|
117
|
+
'$ref-value': AsyncApiOAuthFlowsObject;
|
|
118
|
+
} & ReferenceObjectExtensions);
|
|
119
|
+
/** REQUIRED for openIdConnect. OpenId Connect URL to discover OAuth2 configuration values (absolute URL). */
|
|
120
|
+
openIdConnectUrl?: string;
|
|
121
|
+
/** List of the needed scope names for oauth2 and openIdConnect. */
|
|
122
|
+
scopes?: string[];
|
|
123
|
+
};
|
|
124
|
+
/** JSON Schema Draft 07 compatible schema (boolean true/false or object); see AsyncAPI Schema Object. */
|
|
125
|
+
export type AsyncApiSchemaObject = unknown;
|
|
126
|
+
export type AsyncApiSchemaJsonShape = true | false | AsyncApiSchemaObject;
|
|
127
|
+
/** AsyncAPI WebSocket binding for handshake method, query, and headers. */
|
|
128
|
+
export type AsyncApiWsBindingObject = {
|
|
129
|
+
/** HTTP method used when establishing the WebSocket connection (typically GET). */
|
|
130
|
+
method?: 'GET' | 'POST';
|
|
131
|
+
/** Schema Object describing WebSocket handshake query parameters (type object with properties). May be a Reference Object. */
|
|
132
|
+
query?: AsyncApiSchemaJsonShape | (AsyncApiReferenceObject & {
|
|
133
|
+
'$ref-value': AsyncApiSchemaJsonShape;
|
|
134
|
+
} & ReferenceObjectExtensions);
|
|
135
|
+
/** Schema Object describing HTTP headers sent during the WebSocket handshake (type object with properties). May be a Reference Object. */
|
|
136
|
+
headers?: AsyncApiSchemaJsonShape | (AsyncApiReferenceObject & {
|
|
137
|
+
'$ref-value': AsyncApiSchemaJsonShape;
|
|
138
|
+
} & ReferenceObjectExtensions);
|
|
139
|
+
/** Version of the WebSocket binding. When omitted, "latest" is assumed per the binding spec. */
|
|
140
|
+
bindingVersion?: string;
|
|
141
|
+
};
|
|
142
|
+
/** Map describing protocol-specific definitions for a server (AsyncAPI 3.1.0). */
|
|
143
|
+
export type AsyncApiServerBindingsObject = {
|
|
144
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
145
|
+
http?: unknown;
|
|
146
|
+
/** AsyncAPI WebSocket binding for handshake method, query, and headers. */
|
|
147
|
+
ws?: AsyncApiWsBindingObject;
|
|
148
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
149
|
+
kafka?: unknown;
|
|
150
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
151
|
+
anypointmq?: unknown;
|
|
152
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
153
|
+
amqp?: unknown;
|
|
154
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
155
|
+
amqp1?: unknown;
|
|
156
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
157
|
+
mqtt?: unknown;
|
|
158
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
159
|
+
mqtt5?: unknown;
|
|
160
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
161
|
+
nats?: unknown;
|
|
162
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
163
|
+
jms?: unknown;
|
|
164
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
165
|
+
sns?: unknown;
|
|
166
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
167
|
+
solace?: unknown;
|
|
168
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
169
|
+
sqs?: unknown;
|
|
170
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
171
|
+
stomp?: unknown;
|
|
172
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
173
|
+
redis?: unknown;
|
|
174
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
175
|
+
mercure?: unknown;
|
|
176
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
177
|
+
ibmmq?: unknown;
|
|
178
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
179
|
+
googlepubsub?: unknown;
|
|
180
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
181
|
+
pulsar?: unknown;
|
|
182
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
183
|
+
ros2?: unknown;
|
|
184
|
+
};
|
|
185
|
+
export type AsyncApiServerObject = {
|
|
186
|
+
/** REQUIRED. The server host name. It MAY include the port. Supports Server Variables in {braces}. */
|
|
187
|
+
host: string;
|
|
188
|
+
/** REQUIRED. The protocol this server supports for connection. */
|
|
189
|
+
protocol: string;
|
|
190
|
+
/** The version of the protocol used for connection (for example 0-9-1 for AMQP). */
|
|
191
|
+
protocolVersion?: string;
|
|
192
|
+
/** The path to a resource in the host. Supports Server Variables in {braces}. */
|
|
193
|
+
pathname?: string;
|
|
194
|
+
/** An optional string describing the server. CommonMark syntax MAY be used for rich text representation. */
|
|
195
|
+
description?: string;
|
|
196
|
+
/** A human-friendly title for the server. */
|
|
197
|
+
title?: string;
|
|
198
|
+
/** A short summary of the server. */
|
|
199
|
+
summary?: string;
|
|
200
|
+
/** Map between a variable name and its Server Variable Object or Reference Object. */
|
|
201
|
+
variables?: Record<string, AsyncApiServerVariableObject | (AsyncApiReferenceObject & {
|
|
202
|
+
'$ref-value': AsyncApiServerVariableObject;
|
|
203
|
+
} & ReferenceObjectExtensions)>;
|
|
204
|
+
/** Alternative security schemes for this server; only one of the security scheme objects need to be satisfied. */
|
|
205
|
+
security?: (AsyncApiSecuritySchemeObject | (AsyncApiReferenceObject & {
|
|
206
|
+
'$ref-value': AsyncApiSecuritySchemeObject;
|
|
207
|
+
} & ReferenceObjectExtensions))[];
|
|
208
|
+
/** A list of Tag Objects (entries MAY be Reference Objects). */
|
|
209
|
+
tags?: AsyncApiTagsObject;
|
|
210
|
+
externalDocs?: AsyncApiExternalDocumentationObject | (AsyncApiReferenceObject & {
|
|
211
|
+
'$ref-value': AsyncApiExternalDocumentationObject;
|
|
212
|
+
} & ReferenceObjectExtensions);
|
|
213
|
+
bindings?: AsyncApiServerBindingsObject | (AsyncApiReferenceObject & {
|
|
214
|
+
'$ref-value': AsyncApiServerBindingsObject;
|
|
215
|
+
} & ReferenceObjectExtensions);
|
|
216
|
+
};
|
|
217
|
+
/** Map of server name to Server Object or Reference Object. */
|
|
218
|
+
export type AsyncApiServersObject = Record<string, AsyncApiServerObject | (AsyncApiReferenceObject & {
|
|
219
|
+
'$ref-value': AsyncApiServerObject;
|
|
220
|
+
} & ReferenceObjectExtensions)>;
|
|
221
|
+
export type AsyncApiMultiFormatSchemaObject = {
|
|
222
|
+
/** Media type identifying the schema format. When omitted, defaults to the AsyncAPI JSON Schema vocabulary for the document version. */
|
|
223
|
+
schemaFormat?: string;
|
|
224
|
+
/** REQUIRED. Schema definition in the format given by schemaFormat. */
|
|
225
|
+
schema: unknown;
|
|
226
|
+
};
|
|
227
|
+
export type AsyncApiMultiFormatSchemaOrSchemaObject = AsyncApiMultiFormatSchemaObject | AsyncApiSchemaJsonShape;
|
|
228
|
+
export type AsyncApiCorrelationIdObject = {
|
|
229
|
+
/** An optional description of the identifier. CommonMark syntax MAY be used for rich text representation. */
|
|
230
|
+
description?: string;
|
|
231
|
+
/** REQUIRED. A runtime expression that specifies the location of the correlation ID. */
|
|
232
|
+
location: string;
|
|
233
|
+
};
|
|
234
|
+
/** Map describing protocol-specific definitions for a message (AsyncAPI 3.1.0). */
|
|
235
|
+
export type AsyncApiMessageBindingsObject = {
|
|
236
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
237
|
+
http?: unknown;
|
|
238
|
+
/** AsyncAPI WebSocket binding for handshake method, query, and headers. */
|
|
239
|
+
ws?: AsyncApiWsBindingObject;
|
|
240
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
241
|
+
kafka?: unknown;
|
|
242
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
243
|
+
anypointmq?: unknown;
|
|
244
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
245
|
+
amqp?: unknown;
|
|
246
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
247
|
+
amqp1?: unknown;
|
|
248
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
249
|
+
mqtt?: unknown;
|
|
250
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
251
|
+
mqtt5?: unknown;
|
|
252
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
253
|
+
nats?: unknown;
|
|
254
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
255
|
+
jms?: unknown;
|
|
256
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
257
|
+
sns?: unknown;
|
|
258
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
259
|
+
solace?: unknown;
|
|
260
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
261
|
+
sqs?: unknown;
|
|
262
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
263
|
+
stomp?: unknown;
|
|
264
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
265
|
+
redis?: unknown;
|
|
266
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
267
|
+
mercure?: unknown;
|
|
268
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
269
|
+
ibmmq?: unknown;
|
|
270
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
271
|
+
googlepubsub?: unknown;
|
|
272
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
273
|
+
pulsar?: unknown;
|
|
274
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
275
|
+
ros2?: unknown;
|
|
276
|
+
};
|
|
277
|
+
export type AsyncApiMessageExampleObject = {
|
|
278
|
+
/** Example headers; MUST validate against the Message Object headers field when present. */
|
|
279
|
+
headers?: Record<string, unknown>;
|
|
280
|
+
/** Example payload; MUST validate against the Message Object payload field when present. */
|
|
281
|
+
payload?: unknown;
|
|
282
|
+
/** A machine-friendly name. */
|
|
283
|
+
name?: string;
|
|
284
|
+
/** A short summary of what the example is about. */
|
|
285
|
+
summary?: string;
|
|
286
|
+
};
|
|
287
|
+
export type AsyncApiMessageTraitObject = {
|
|
288
|
+
headers?: AsyncApiMultiFormatSchemaOrSchemaObject | (AsyncApiReferenceObject & {
|
|
289
|
+
'$ref-value': AsyncApiMultiFormatSchemaOrSchemaObject;
|
|
290
|
+
} & ReferenceObjectExtensions);
|
|
291
|
+
correlationId?: AsyncApiCorrelationIdObject | (AsyncApiReferenceObject & {
|
|
292
|
+
'$ref-value': AsyncApiCorrelationIdObject;
|
|
293
|
+
} & ReferenceObjectExtensions);
|
|
294
|
+
/** The content type to use when encoding/decoding a message payload (for example application/json). */
|
|
295
|
+
contentType?: string;
|
|
296
|
+
/** A machine-friendly name for the message. */
|
|
297
|
+
name?: string;
|
|
298
|
+
/** A human-friendly title for the message. */
|
|
299
|
+
title?: string;
|
|
300
|
+
/** A short summary of what the message is about. */
|
|
301
|
+
summary?: string;
|
|
302
|
+
/** A verbose explanation of the message. CommonMark syntax MAY be used for rich text representation. */
|
|
303
|
+
description?: string;
|
|
304
|
+
/** A list of Tag Objects (entries MAY be Reference Objects). */
|
|
305
|
+
tags?: AsyncApiTagsObject;
|
|
306
|
+
externalDocs?: AsyncApiExternalDocumentationObject | (AsyncApiReferenceObject & {
|
|
307
|
+
'$ref-value': AsyncApiExternalDocumentationObject;
|
|
308
|
+
} & ReferenceObjectExtensions);
|
|
309
|
+
bindings?: AsyncApiMessageBindingsObject | (AsyncApiReferenceObject & {
|
|
310
|
+
'$ref-value': AsyncApiMessageBindingsObject;
|
|
311
|
+
} & ReferenceObjectExtensions);
|
|
312
|
+
examples?: (AsyncApiMessageExampleObject | (AsyncApiReferenceObject & {
|
|
313
|
+
'$ref-value': AsyncApiMessageExampleObject;
|
|
314
|
+
} & ReferenceObjectExtensions))[];
|
|
315
|
+
};
|
|
316
|
+
export type AsyncApiMessageObject = {
|
|
317
|
+
headers?: AsyncApiMultiFormatSchemaOrSchemaObject | (AsyncApiReferenceObject & {
|
|
318
|
+
'$ref-value': AsyncApiMultiFormatSchemaOrSchemaObject;
|
|
319
|
+
} & ReferenceObjectExtensions);
|
|
320
|
+
payload?: AsyncApiMultiFormatSchemaOrSchemaObject | (AsyncApiReferenceObject & {
|
|
321
|
+
'$ref-value': AsyncApiMultiFormatSchemaOrSchemaObject;
|
|
322
|
+
} & ReferenceObjectExtensions);
|
|
323
|
+
correlationId?: AsyncApiCorrelationIdObject | (AsyncApiReferenceObject & {
|
|
324
|
+
'$ref-value': AsyncApiCorrelationIdObject;
|
|
325
|
+
} & ReferenceObjectExtensions);
|
|
326
|
+
/** The content type to use when encoding/decoding a message payload (for example application/json). */
|
|
327
|
+
contentType?: string;
|
|
328
|
+
/** A machine-friendly name for the message. */
|
|
329
|
+
name?: string;
|
|
330
|
+
/** A human-friendly title for the message. */
|
|
331
|
+
title?: string;
|
|
332
|
+
/** A short summary of what the message is about. */
|
|
333
|
+
summary?: string;
|
|
334
|
+
/** A verbose explanation of the message. CommonMark syntax MAY be used for rich text representation. */
|
|
335
|
+
description?: string;
|
|
336
|
+
/** A list of Tag Objects (entries MAY be Reference Objects). */
|
|
337
|
+
tags?: AsyncApiTagsObject;
|
|
338
|
+
externalDocs?: AsyncApiExternalDocumentationObject | (AsyncApiReferenceObject & {
|
|
339
|
+
'$ref-value': AsyncApiExternalDocumentationObject;
|
|
340
|
+
} & ReferenceObjectExtensions);
|
|
341
|
+
bindings?: AsyncApiMessageBindingsObject | (AsyncApiReferenceObject & {
|
|
342
|
+
'$ref-value': AsyncApiMessageBindingsObject;
|
|
343
|
+
} & ReferenceObjectExtensions);
|
|
344
|
+
examples?: (AsyncApiMessageExampleObject | (AsyncApiReferenceObject & {
|
|
345
|
+
'$ref-value': AsyncApiMessageExampleObject;
|
|
346
|
+
} & ReferenceObjectExtensions))[];
|
|
347
|
+
traits?: (AsyncApiMessageTraitObject | (AsyncApiReferenceObject & {
|
|
348
|
+
'$ref-value': AsyncApiMessageTraitObject;
|
|
349
|
+
} & ReferenceObjectExtensions))[];
|
|
350
|
+
};
|
|
351
|
+
/** Map of messageId to Message Object or Reference Object. */
|
|
352
|
+
export type AsyncApiMessagesObject = Record<string, AsyncApiMessageObject | (AsyncApiReferenceObject & {
|
|
353
|
+
'$ref-value': AsyncApiMessageObject;
|
|
354
|
+
} & ReferenceObjectExtensions)>;
|
|
355
|
+
export type AsyncApiParameterObject = {
|
|
356
|
+
/** An enumeration of string values for substitution. */
|
|
357
|
+
enum?: string[];
|
|
358
|
+
/** The default value to use for substitution, and to send, if an alternate value is not supplied. */
|
|
359
|
+
default?: string;
|
|
360
|
+
/** An optional description for the parameter. CommonMark syntax MAY be used for rich text representation. */
|
|
361
|
+
description?: string;
|
|
362
|
+
/** Examples of the parameter value. */
|
|
363
|
+
examples?: string[];
|
|
364
|
+
/** A runtime expression that specifies the location of the parameter value. */
|
|
365
|
+
location?: string;
|
|
366
|
+
};
|
|
367
|
+
/** Map of parameter name to Parameter Object or Reference Object. */
|
|
368
|
+
export type AsyncApiParametersObject = Record<string, AsyncApiParameterObject | (AsyncApiReferenceObject & {
|
|
369
|
+
'$ref-value': AsyncApiParameterObject;
|
|
370
|
+
} & ReferenceObjectExtensions)>;
|
|
371
|
+
/** Map describing protocol-specific definitions for a channel (AsyncAPI 3.1.0). */
|
|
372
|
+
export type AsyncApiChannelBindingsObject = {
|
|
373
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
374
|
+
http?: unknown;
|
|
375
|
+
/** AsyncAPI WebSocket binding for handshake method, query, and headers. */
|
|
376
|
+
ws?: AsyncApiWsBindingObject;
|
|
377
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
378
|
+
kafka?: unknown;
|
|
379
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
380
|
+
anypointmq?: unknown;
|
|
381
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
382
|
+
amqp?: unknown;
|
|
383
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
384
|
+
amqp1?: unknown;
|
|
385
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
386
|
+
mqtt?: unknown;
|
|
387
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
388
|
+
mqtt5?: unknown;
|
|
389
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
390
|
+
nats?: unknown;
|
|
391
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
392
|
+
jms?: unknown;
|
|
393
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
394
|
+
sns?: unknown;
|
|
395
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
396
|
+
solace?: unknown;
|
|
397
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
398
|
+
sqs?: unknown;
|
|
399
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
400
|
+
stomp?: unknown;
|
|
401
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
402
|
+
redis?: unknown;
|
|
403
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
404
|
+
mercure?: unknown;
|
|
405
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
406
|
+
ibmmq?: unknown;
|
|
407
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
408
|
+
googlepubsub?: unknown;
|
|
409
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
410
|
+
pulsar?: unknown;
|
|
411
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
412
|
+
ros2?: unknown;
|
|
413
|
+
};
|
|
414
|
+
export type AsyncApiChannelObject = {
|
|
415
|
+
/** Channel address or null when unknown. */
|
|
416
|
+
address?: string | null;
|
|
417
|
+
/** Map of messageId to Message Object or Reference Object. */
|
|
418
|
+
messages?: AsyncApiMessagesObject;
|
|
419
|
+
/** A human-friendly title for the channel. */
|
|
420
|
+
title?: string;
|
|
421
|
+
/** A short summary of the channel. */
|
|
422
|
+
summary?: string;
|
|
423
|
+
/** An optional description of this channel. CommonMark syntax MAY be used for rich text representation. */
|
|
424
|
+
description?: string;
|
|
425
|
+
/** References to Server definitions where this channel is available (Reference Objects only in the raw document). */
|
|
426
|
+
servers?: (AsyncApiReferenceObject & {
|
|
427
|
+
'$ref-value': AsyncApiServerObject | (AsyncApiReferenceObject & {
|
|
428
|
+
'$ref-value': AsyncApiServerObject;
|
|
429
|
+
} & ReferenceObjectExtensions);
|
|
430
|
+
} & ReferenceObjectExtensions)[];
|
|
431
|
+
/** Map of parameter name to Parameter Object or Reference Object. */
|
|
432
|
+
parameters?: AsyncApiParametersObject;
|
|
433
|
+
/** A list of Tag Objects (entries MAY be Reference Objects). */
|
|
434
|
+
tags?: AsyncApiTagsObject;
|
|
435
|
+
externalDocs?: AsyncApiExternalDocumentationObject | (AsyncApiReferenceObject & {
|
|
436
|
+
'$ref-value': AsyncApiExternalDocumentationObject;
|
|
437
|
+
} & ReferenceObjectExtensions);
|
|
438
|
+
bindings?: AsyncApiChannelBindingsObject | (AsyncApiReferenceObject & {
|
|
439
|
+
'$ref-value': AsyncApiChannelBindingsObject;
|
|
440
|
+
} & ReferenceObjectExtensions);
|
|
441
|
+
};
|
|
442
|
+
/** Map of channelId to Channel Object or Reference Object. */
|
|
443
|
+
export type AsyncApiChannelsObject = Record<string, AsyncApiChannelObject | (AsyncApiReferenceObject & {
|
|
444
|
+
'$ref-value': AsyncApiChannelObject;
|
|
445
|
+
} & ReferenceObjectExtensions)>;
|
|
446
|
+
/** Map describing protocol-specific definitions for an operation (AsyncAPI 3.1.0). */
|
|
447
|
+
export type AsyncApiOperationBindingsObject = {
|
|
448
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
449
|
+
http?: unknown;
|
|
450
|
+
/** AsyncAPI WebSocket binding for handshake method, query, and headers. */
|
|
451
|
+
ws?: AsyncApiWsBindingObject;
|
|
452
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
453
|
+
kafka?: unknown;
|
|
454
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
455
|
+
anypointmq?: unknown;
|
|
456
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
457
|
+
amqp?: unknown;
|
|
458
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
459
|
+
amqp1?: unknown;
|
|
460
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
461
|
+
mqtt?: unknown;
|
|
462
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
463
|
+
mqtt5?: unknown;
|
|
464
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
465
|
+
nats?: unknown;
|
|
466
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
467
|
+
jms?: unknown;
|
|
468
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
469
|
+
sns?: unknown;
|
|
470
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
471
|
+
solace?: unknown;
|
|
472
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
473
|
+
sqs?: unknown;
|
|
474
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
475
|
+
stomp?: unknown;
|
|
476
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
477
|
+
redis?: unknown;
|
|
478
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
479
|
+
mercure?: unknown;
|
|
480
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
481
|
+
ibmmq?: unknown;
|
|
482
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
483
|
+
googlepubsub?: unknown;
|
|
484
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
485
|
+
pulsar?: unknown;
|
|
486
|
+
/** Protocol-specific binding definition (see AsyncAPI protocol bindings). */
|
|
487
|
+
ros2?: unknown;
|
|
488
|
+
};
|
|
489
|
+
export type AsyncApiOperationTraitObject = {
|
|
490
|
+
/** A human-friendly title for the operation. */
|
|
491
|
+
title?: string;
|
|
492
|
+
/** A short summary of what the operation is about. */
|
|
493
|
+
summary?: string;
|
|
494
|
+
/** A verbose explanation of the operation. CommonMark syntax MAY be used for rich text representation. */
|
|
495
|
+
description?: string;
|
|
496
|
+
/** Security schemes for this operation. Only one of the security scheme objects MUST be satisfied. */
|
|
497
|
+
security?: (AsyncApiSecuritySchemeObject | (AsyncApiReferenceObject & {
|
|
498
|
+
'$ref-value': AsyncApiSecuritySchemeObject;
|
|
499
|
+
} & ReferenceObjectExtensions))[];
|
|
500
|
+
/** A list of Tag Objects (entries MAY be Reference Objects). */
|
|
501
|
+
tags?: AsyncApiTagsObject;
|
|
502
|
+
externalDocs?: AsyncApiExternalDocumentationObject | (AsyncApiReferenceObject & {
|
|
503
|
+
'$ref-value': AsyncApiExternalDocumentationObject;
|
|
504
|
+
} & ReferenceObjectExtensions);
|
|
505
|
+
bindings?: AsyncApiOperationBindingsObject | (AsyncApiReferenceObject & {
|
|
506
|
+
'$ref-value': AsyncApiOperationBindingsObject;
|
|
507
|
+
} & ReferenceObjectExtensions);
|
|
508
|
+
};
|
|
509
|
+
export type AsyncApiOperationReplyAddressObject = {
|
|
510
|
+
/** An optional description of the address. CommonMark syntax MAY be used for rich text representation. */
|
|
511
|
+
description?: string;
|
|
512
|
+
/** REQUIRED. A runtime expression that specifies the location of the reply address. */
|
|
513
|
+
location: string;
|
|
514
|
+
};
|
|
515
|
+
export type AsyncApiOperationReplyObject = {
|
|
516
|
+
address?: AsyncApiOperationReplyAddressObject | (AsyncApiReferenceObject & {
|
|
517
|
+
'$ref-value': AsyncApiOperationReplyAddressObject;
|
|
518
|
+
} & ReferenceObjectExtensions);
|
|
519
|
+
channel?: AsyncApiReferenceObject & {
|
|
520
|
+
'$ref-value': AsyncApiChannelObject | (AsyncApiReferenceObject & {
|
|
521
|
+
'$ref-value': AsyncApiChannelObject;
|
|
522
|
+
} & ReferenceObjectExtensions);
|
|
523
|
+
} & ReferenceObjectExtensions;
|
|
524
|
+
/** List of $ref pointers to Message Objects used as reply payloads (Reference Objects only in the raw document). */
|
|
525
|
+
messages?: (AsyncApiReferenceObject & {
|
|
526
|
+
'$ref-value': AsyncApiMessageObject | (AsyncApiReferenceObject & {
|
|
527
|
+
'$ref-value': AsyncApiMessageObject;
|
|
528
|
+
} & ReferenceObjectExtensions);
|
|
529
|
+
} & ReferenceObjectExtensions)[];
|
|
530
|
+
};
|
|
531
|
+
export type AsyncApiOperationObject = {
|
|
532
|
+
/** REQUIRED. send when the application sends to the channel; receive when it receives from the channel. */
|
|
533
|
+
action: 'send' | 'receive';
|
|
534
|
+
channel: AsyncApiReferenceObject & {
|
|
535
|
+
'$ref-value': AsyncApiChannelObject | (AsyncApiReferenceObject & {
|
|
536
|
+
'$ref-value': AsyncApiChannelObject;
|
|
537
|
+
} & ReferenceObjectExtensions);
|
|
538
|
+
} & ReferenceObjectExtensions;
|
|
539
|
+
/** A human-friendly title for the operation. */
|
|
540
|
+
title?: string;
|
|
541
|
+
/** A short summary of what the operation is about. */
|
|
542
|
+
summary?: string;
|
|
543
|
+
/** A verbose explanation of the operation. CommonMark syntax MAY be used for rich text representation. */
|
|
544
|
+
description?: string;
|
|
545
|
+
/** Security schemes for this operation. Only one of the security scheme objects MUST be satisfied. */
|
|
546
|
+
security?: (AsyncApiSecuritySchemeObject | (AsyncApiReferenceObject & {
|
|
547
|
+
'$ref-value': AsyncApiSecuritySchemeObject;
|
|
548
|
+
} & ReferenceObjectExtensions))[];
|
|
549
|
+
/** A list of Tag Objects (entries MAY be Reference Objects). */
|
|
550
|
+
tags?: AsyncApiTagsObject;
|
|
551
|
+
externalDocs?: AsyncApiExternalDocumentationObject | (AsyncApiReferenceObject & {
|
|
552
|
+
'$ref-value': AsyncApiExternalDocumentationObject;
|
|
553
|
+
} & ReferenceObjectExtensions);
|
|
554
|
+
bindings?: AsyncApiOperationBindingsObject | (AsyncApiReferenceObject & {
|
|
555
|
+
'$ref-value': AsyncApiOperationBindingsObject;
|
|
556
|
+
} & ReferenceObjectExtensions);
|
|
557
|
+
traits?: (AsyncApiOperationTraitObject | (AsyncApiReferenceObject & {
|
|
558
|
+
'$ref-value': AsyncApiOperationTraitObject;
|
|
559
|
+
} & ReferenceObjectExtensions))[];
|
|
560
|
+
/** Subset of channel messages as Reference Objects only. Omit to include all channel messages; use [] for none. */
|
|
561
|
+
messages?: (AsyncApiReferenceObject & {
|
|
562
|
+
'$ref-value': AsyncApiMessageObject | (AsyncApiReferenceObject & {
|
|
563
|
+
'$ref-value': AsyncApiMessageObject;
|
|
564
|
+
} & ReferenceObjectExtensions);
|
|
565
|
+
} & ReferenceObjectExtensions)[];
|
|
566
|
+
reply?: AsyncApiOperationReplyObject | (AsyncApiReferenceObject & {
|
|
567
|
+
'$ref-value': AsyncApiOperationReplyObject;
|
|
568
|
+
} & ReferenceObjectExtensions);
|
|
569
|
+
};
|
|
570
|
+
/** Map of operationId to Operation Object or Reference Object. */
|
|
571
|
+
export type AsyncApiOperationsObject = Record<string, AsyncApiOperationObject | (AsyncApiReferenceObject & {
|
|
572
|
+
'$ref-value': AsyncApiOperationObject;
|
|
573
|
+
} & ReferenceObjectExtensions)>;
|
|
574
|
+
/** Reusable objects. Definitions here have no effect unless referenced from outside components. */
|
|
575
|
+
export type AsyncApiComponentsObject = {
|
|
576
|
+
/** Reusable Multi Format Schema, Schema Object, or Reference Object. */
|
|
577
|
+
schemas?: Record<string, AsyncApiMultiFormatSchemaOrSchemaObject | (AsyncApiReferenceObject & {
|
|
578
|
+
'$ref-value': AsyncApiMultiFormatSchemaOrSchemaObject;
|
|
579
|
+
} & ReferenceObjectExtensions)>;
|
|
580
|
+
servers?: Record<string, AsyncApiServerObject | (AsyncApiReferenceObject & {
|
|
581
|
+
'$ref-value': AsyncApiServerObject;
|
|
582
|
+
} & ReferenceObjectExtensions)>;
|
|
583
|
+
channels?: Record<string, AsyncApiChannelObject | (AsyncApiReferenceObject & {
|
|
584
|
+
'$ref-value': AsyncApiChannelObject;
|
|
585
|
+
} & ReferenceObjectExtensions)>;
|
|
586
|
+
operations?: Record<string, AsyncApiOperationObject | (AsyncApiReferenceObject & {
|
|
587
|
+
'$ref-value': AsyncApiOperationObject;
|
|
588
|
+
} & ReferenceObjectExtensions)>;
|
|
589
|
+
messages?: Record<string, AsyncApiMessageObject | (AsyncApiReferenceObject & {
|
|
590
|
+
'$ref-value': AsyncApiMessageObject;
|
|
591
|
+
} & ReferenceObjectExtensions)>;
|
|
592
|
+
securitySchemes?: Record<string, AsyncApiSecuritySchemeObject | (AsyncApiReferenceObject & {
|
|
593
|
+
'$ref-value': AsyncApiSecuritySchemeObject;
|
|
594
|
+
} & ReferenceObjectExtensions)>;
|
|
595
|
+
serverVariables?: Record<string, AsyncApiServerVariableObject | (AsyncApiReferenceObject & {
|
|
596
|
+
'$ref-value': AsyncApiServerVariableObject;
|
|
597
|
+
} & ReferenceObjectExtensions)>;
|
|
598
|
+
parameters?: Record<string, AsyncApiParameterObject | (AsyncApiReferenceObject & {
|
|
599
|
+
'$ref-value': AsyncApiParameterObject;
|
|
600
|
+
} & ReferenceObjectExtensions)>;
|
|
601
|
+
correlationIds?: Record<string, AsyncApiCorrelationIdObject | (AsyncApiReferenceObject & {
|
|
602
|
+
'$ref-value': AsyncApiCorrelationIdObject;
|
|
603
|
+
} & ReferenceObjectExtensions)>;
|
|
604
|
+
replies?: Record<string, AsyncApiOperationReplyObject | (AsyncApiReferenceObject & {
|
|
605
|
+
'$ref-value': AsyncApiOperationReplyObject;
|
|
606
|
+
} & ReferenceObjectExtensions)>;
|
|
607
|
+
replyAddresses?: Record<string, AsyncApiOperationReplyAddressObject | (AsyncApiReferenceObject & {
|
|
608
|
+
'$ref-value': AsyncApiOperationReplyAddressObject;
|
|
609
|
+
} & ReferenceObjectExtensions)>;
|
|
610
|
+
externalDocs?: Record<string, AsyncApiExternalDocumentationObject | (AsyncApiReferenceObject & {
|
|
611
|
+
'$ref-value': AsyncApiExternalDocumentationObject;
|
|
612
|
+
} & ReferenceObjectExtensions)>;
|
|
613
|
+
tags?: Record<string, AsyncApiTagObject | (AsyncApiReferenceObject & {
|
|
614
|
+
'$ref-value': AsyncApiTagObject;
|
|
615
|
+
} & ReferenceObjectExtensions)>;
|
|
616
|
+
operationTraits?: Record<string, AsyncApiOperationTraitObject | (AsyncApiReferenceObject & {
|
|
617
|
+
'$ref-value': AsyncApiOperationTraitObject;
|
|
618
|
+
} & ReferenceObjectExtensions)>;
|
|
619
|
+
messageTraits?: Record<string, AsyncApiMessageTraitObject | (AsyncApiReferenceObject & {
|
|
620
|
+
'$ref-value': AsyncApiMessageTraitObject;
|
|
621
|
+
} & ReferenceObjectExtensions)>;
|
|
622
|
+
serverBindings?: Record<string, AsyncApiServerBindingsObject | (AsyncApiReferenceObject & {
|
|
623
|
+
'$ref-value': AsyncApiServerBindingsObject;
|
|
624
|
+
} & ReferenceObjectExtensions)>;
|
|
625
|
+
channelBindings?: Record<string, AsyncApiChannelBindingsObject | (AsyncApiReferenceObject & {
|
|
626
|
+
'$ref-value': AsyncApiChannelBindingsObject;
|
|
627
|
+
} & ReferenceObjectExtensions)>;
|
|
628
|
+
operationBindings?: Record<string, AsyncApiOperationBindingsObject | (AsyncApiReferenceObject & {
|
|
629
|
+
'$ref-value': AsyncApiOperationBindingsObject;
|
|
630
|
+
} & ReferenceObjectExtensions)>;
|
|
631
|
+
messageBindings?: Record<string, AsyncApiMessageBindingsObject | (AsyncApiReferenceObject & {
|
|
632
|
+
'$ref-value': AsyncApiMessageBindingsObject;
|
|
633
|
+
} & ReferenceObjectExtensions)>;
|
|
634
|
+
};
|
|
635
|
+
/** Root AsyncAPI 3.1.0 document combining resource listing and API declaration. */
|
|
636
|
+
export type AsyncApiDocumentCore = {
|
|
637
|
+
/** REQUIRED. AsyncAPI Specification version (major.minor.patch). Patch MAY include a hyphen suffix. */
|
|
638
|
+
asyncapi: string;
|
|
639
|
+
/** Identifier of the application the AsyncAPI document is defining (URI, RFC3986). */
|
|
640
|
+
id?: string;
|
|
641
|
+
info: AsyncApiInfoObject;
|
|
642
|
+
/** Map of server name to Server Object or Reference Object. */
|
|
643
|
+
servers?: AsyncApiServersObject;
|
|
644
|
+
/** Default content type when encoding/decoding a message payload (for example application/json). */
|
|
645
|
+
defaultContentType?: string;
|
|
646
|
+
/** Map of channelId to Channel Object or Reference Object. */
|
|
647
|
+
channels?: AsyncApiChannelsObject;
|
|
648
|
+
/** Map of operationId to Operation Object or Reference Object. */
|
|
649
|
+
operations?: AsyncApiOperationsObject;
|
|
650
|
+
components?: AsyncApiComponentsObject | (AsyncApiReferenceObject & {
|
|
651
|
+
'$ref-value': AsyncApiComponentsObject;
|
|
652
|
+
} & ReferenceObjectExtensions);
|
|
653
|
+
};
|
|
654
|
+
/**
|
|
655
|
+
* Original AsyncAPI Specification version of the source document before ingestion.
|
|
656
|
+
*
|
|
657
|
+
* @example
|
|
658
|
+
* ```yaml
|
|
659
|
+
* x-original-aas-version: "3.0.0"
|
|
660
|
+
* ```
|
|
661
|
+
*/
|
|
662
|
+
export type XOriginalAasVersion = {
|
|
663
|
+
/** Original AsyncAPI Specification version the document was loaded with. */
|
|
664
|
+
'x-original-aas-version'?: string;
|
|
665
|
+
};
|
|
666
|
+
/** Client-side navigation tree persisted on the document. Matches `TraversedDocumentObjectRef` in strict OpenAPI schemas. */
|
|
667
|
+
export type XScalarNavigation = {
|
|
668
|
+
/** Serialized client navigation tree (`TraversedDocument`) for this API description */
|
|
669
|
+
'x-scalar-navigation'?: any;
|
|
670
|
+
};
|
|
671
|
+
/**
|
|
672
|
+
* Original document source URL when the API description was loaded from an external source.
|
|
673
|
+
*
|
|
674
|
+
* @example
|
|
675
|
+
* ```yaml
|
|
676
|
+
* x-scalar-original-source-url: https://example.com/openapi.yaml
|
|
677
|
+
* ```
|
|
678
|
+
*/
|
|
679
|
+
export type XScalarOriginalSourceUrl = {
|
|
680
|
+
/** Original document source URL when loaded from an external source */
|
|
681
|
+
'x-scalar-original-source-url'?: string;
|
|
682
|
+
};
|
|
683
|
+
/**
|
|
684
|
+
* Tracks the original document hash when loading from an external source. Used to detect modifications since last save.
|
|
685
|
+
*
|
|
686
|
+
* @example
|
|
687
|
+
* ```yaml
|
|
688
|
+
* x-scalar-original-document-hash: "abc123"
|
|
689
|
+
* ```
|
|
690
|
+
*/
|
|
691
|
+
export type XScalarOriginalDocumentHash = {
|
|
692
|
+
/** Hash of the document as originally loaded from an external source */
|
|
693
|
+
'x-scalar-original-document-hash': string;
|
|
694
|
+
};
|
|
695
|
+
/**
|
|
696
|
+
* Tracks whether the document has been modified since it was last saved.
|
|
697
|
+
*
|
|
698
|
+
* @example
|
|
699
|
+
* ```yaml
|
|
700
|
+
* x-scalar-is-dirty: true
|
|
701
|
+
* ```
|
|
702
|
+
*/
|
|
703
|
+
export type XScalarIsDirty = {
|
|
704
|
+
/** When true, the document has unsaved changes */
|
|
705
|
+
'x-scalar-is-dirty'?: boolean;
|
|
706
|
+
};
|
|
707
|
+
/**
|
|
708
|
+
* Whether the document is in watch mode (reloads when the source file changes).
|
|
709
|
+
*
|
|
710
|
+
* @example
|
|
711
|
+
* ```yaml
|
|
712
|
+
* x-scalar-watch-mode: true
|
|
713
|
+
* ```
|
|
714
|
+
*/
|
|
715
|
+
export type XScalarWatchMode = {
|
|
716
|
+
/** When true, the document is watched for external file changes */
|
|
717
|
+
'x-scalar-watch-mode'?: boolean;
|
|
718
|
+
};
|
|
719
|
+
/** Registry meta namespace and slug */
|
|
720
|
+
export type XScalarRegistryMetaInner = {
|
|
721
|
+
/** The namespace under which this registry meta is scoped. */
|
|
722
|
+
namespace: string;
|
|
723
|
+
/** A unique slug identifier for this registry meta within the namespace. */
|
|
724
|
+
slug: string;
|
|
725
|
+
/** The version of the registry meta. */
|
|
726
|
+
version: string;
|
|
727
|
+
/** Last known commit hash of this document. Is going to be used to track if the document has been modified since it was last saved. */
|
|
728
|
+
commitHash?: string;
|
|
729
|
+
/** Registry commit hash that the cached `hasConflict` flag was computed against. When the registry advertises a different hash later, the cached result is stale and the conflict check must be re-run. */
|
|
730
|
+
conflictCheckedAgainstHash?: string;
|
|
731
|
+
/** Cached outcome of the last conflict check, valid only while `conflictCheckedAgainstHash` matches the registry current hash for this version. */
|
|
732
|
+
hasConflict?: boolean;
|
|
733
|
+
};
|
|
734
|
+
/**
|
|
735
|
+
* Registry sync metadata for a document published to Scalar Registry.
|
|
736
|
+
*
|
|
737
|
+
* @example
|
|
738
|
+
* ```yaml
|
|
739
|
+
* x-scalar-registry-meta:
|
|
740
|
+
* namespace: acme
|
|
741
|
+
* slug: public-api
|
|
742
|
+
* version: "1.0.0"
|
|
743
|
+
* ```
|
|
744
|
+
*/
|
|
745
|
+
export type XScalarRegistryMeta = {
|
|
746
|
+
/** Registry meta namespace and slug */
|
|
747
|
+
'x-scalar-registry-meta'?: XScalarRegistryMetaInner;
|
|
748
|
+
};
|
|
749
|
+
/** AsyncAPI document-level Scalar extensions shared with workspace tooling. */
|
|
750
|
+
export type AsyncApiExtensions = XOriginalAasVersion & XScalarNavigation & XScalarOriginalSourceUrl & XScalarOriginalDocumentHash & XScalarIsDirty & XScalarWatchMode & XScalarRegistryMeta;
|
|
751
|
+
/** Root AsyncAPI 3.1.0 document including Scalar workspace extensions (AsyncApiExtensionsSchema). */
|
|
752
|
+
export type AsyncApiDocument = AsyncApiDocumentCore & AsyncApiExtensions;
|
|
753
|
+
//# sourceMappingURL=index.generated.d.ts.map
|