@kubb/plugin-mcp 5.0.0-alpha.3 → 5.0.0-alpha.31

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.
@@ -1,503 +0,0 @@
1
- import { t as __name } from "./chunk--u3MIqq1.js";
2
- import { n as PluginMcp } from "./types-CblxgOvZ.js";
3
- import { Adapter, AsyncEventEmitter, Config, FileMetaBase, Group, KubbEvents, Output, Plugin, PluginFactoryOptions, PluginManager, ResolveNameParams } from "@kubb/core";
4
- import { Fabric } from "@kubb/react-fabric";
5
- import { KubbFile } from "@kubb/fabric-core/types";
6
- import { FabricReactNode } from "@kubb/react-fabric/types";
7
- import { OperationNode, SchemaNode } from "@kubb/ast/types";
8
- import { HttpMethod, Oas, Operation, SchemaObject, contentType } from "@kubb/oas";
9
-
10
- //#region ../plugin-oas/src/types.d.ts
11
- type GetOasOptions = {
12
- validate?: boolean;
13
- };
14
- type Context$2 = {
15
- getOas(options?: GetOasOptions): Promise<Oas>;
16
- getBaseURL(): Promise<string | undefined>;
17
- };
18
- declare global {
19
- namespace Kubb {
20
- interface PluginContext extends Context$2 {}
21
- }
22
- }
23
- /**
24
- * `propertyName` is the ref name + resolved with the nameResolver
25
- * @example import { Pet } from './Pet'
26
- *
27
- * `originalName` is the original name used(in PascalCase), only used to remove duplicates
28
- *
29
- * `pluginName` can be used to override the current plugin being used, handy when you want to import a type/schema out of another plugin
30
- * @example import a type(plugin-ts) for a mock file(swagger-faker)
31
- */
32
- type Ref = {
33
- propertyName: string;
34
- originalName: string;
35
- path: KubbFile.Path;
36
- pluginName?: string;
37
- };
38
- type Refs = Record<string, Ref>;
39
- type OperationSchema = {
40
- /**
41
- * Converted name, contains already `PathParams`, `QueryParams`, ...
42
- */
43
- name: string;
44
- schema: SchemaObject;
45
- operation?: Operation;
46
- /**
47
- * OperationName in PascalCase, only being used in OperationGenerator
48
- */
49
- operationName: string;
50
- description?: string;
51
- statusCode?: number;
52
- keys?: string[];
53
- keysToOmit?: string[];
54
- withData?: boolean;
55
- };
56
- type OperationSchemas = {
57
- pathParams?: OperationSchema & {
58
- keysToOmit?: never;
59
- };
60
- queryParams?: OperationSchema & {
61
- keysToOmit?: never;
62
- };
63
- headerParams?: OperationSchema & {
64
- keysToOmit?: never;
65
- };
66
- request?: OperationSchema;
67
- response: OperationSchema;
68
- responses: Array<OperationSchema>;
69
- statusCodes?: Array<OperationSchema>;
70
- errors?: Array<OperationSchema>;
71
- };
72
- type ByTag = {
73
- type: 'tag';
74
- pattern: string | RegExp;
75
- };
76
- type ByOperationId = {
77
- type: 'operationId';
78
- pattern: string | RegExp;
79
- };
80
- type ByPath = {
81
- type: 'path';
82
- pattern: string | RegExp;
83
- };
84
- type ByMethod = {
85
- type: 'method';
86
- pattern: HttpMethod | RegExp;
87
- };
88
- type BySchemaName = {
89
- type: 'schemaName';
90
- pattern: string | RegExp;
91
- };
92
- type ByContentType = {
93
- type: 'contentType';
94
- pattern: string | RegExp;
95
- };
96
- type Exclude = ByTag | ByOperationId | ByPath | ByMethod | ByContentType;
97
- type Include = ByTag | ByOperationId | ByPath | ByMethod | ByContentType;
98
- type Override<TOptions> = (ByTag | ByOperationId | ByPath | ByMethod | BySchemaName | ByContentType) & {
99
- options: Partial<TOptions>;
100
- };
101
- //#endregion
102
- //#region ../plugin-oas/src/OperationGenerator.d.ts
103
- type Context$1<TOptions, TPluginOptions extends PluginFactoryOptions> = {
104
- fabric: Fabric;
105
- oas: Oas;
106
- exclude: Array<Exclude> | undefined;
107
- include: Array<Include> | undefined;
108
- override: Array<Override<TOptions>> | undefined;
109
- contentType: contentType | undefined;
110
- pluginManager: PluginManager;
111
- events?: AsyncEventEmitter<KubbEvents>;
112
- /**
113
- * Current plugin
114
- */
115
- plugin: Plugin<TPluginOptions>;
116
- mode: KubbFile.Mode;
117
- UNSTABLE_NAMING?: true;
118
- };
119
- declare class OperationGenerator<TPluginOptions extends PluginFactoryOptions = PluginFactoryOptions, TFileMeta extends FileMetaBase = FileMetaBase> {
120
- #private;
121
- constructor(options: TPluginOptions['resolvedOptions'], context: Context$1<TPluginOptions['resolvedOptions'], TPluginOptions>);
122
- get options(): TPluginOptions['resolvedOptions'];
123
- set options(options: TPluginOptions['resolvedOptions']);
124
- get context(): Context$1<TPluginOptions['resolvedOptions'], TPluginOptions>;
125
- getOptions(operation: Operation, method: HttpMethod): Partial<TPluginOptions['resolvedOptions']>;
126
- getSchemas(operation: Operation, {
127
- resolveName
128
- }?: {
129
- resolveName?: (name: string) => string;
130
- }): OperationSchemas;
131
- getOperations(): Promise<Array<{
132
- path: string;
133
- method: HttpMethod;
134
- operation: Operation;
135
- }>>;
136
- build(...generators: Array<Generator<TPluginOptions, Version>>): Promise<Array<KubbFile.File<TFileMeta>>>;
137
- }
138
- //#endregion
139
- //#region ../plugin-oas/src/SchemaMapper.d.ts
140
- type SchemaKeywordMapper = {
141
- object: {
142
- keyword: 'object';
143
- args: {
144
- properties: {
145
- [x: string]: Schema[];
146
- };
147
- additionalProperties: Schema[];
148
- patternProperties?: Record<string, Schema[]>;
149
- strict?: boolean;
150
- };
151
- };
152
- url: {
153
- keyword: 'url';
154
- };
155
- readOnly: {
156
- keyword: 'readOnly';
157
- };
158
- writeOnly: {
159
- keyword: 'writeOnly';
160
- };
161
- uuid: {
162
- keyword: 'uuid';
163
- };
164
- email: {
165
- keyword: 'email';
166
- };
167
- firstName: {
168
- keyword: 'firstName';
169
- };
170
- lastName: {
171
- keyword: 'lastName';
172
- };
173
- phone: {
174
- keyword: 'phone';
175
- };
176
- password: {
177
- keyword: 'password';
178
- };
179
- date: {
180
- keyword: 'date';
181
- args: {
182
- type?: 'date' | 'string';
183
- };
184
- };
185
- time: {
186
- keyword: 'time';
187
- args: {
188
- type?: 'date' | 'string';
189
- };
190
- };
191
- datetime: {
192
- keyword: 'datetime';
193
- args: {
194
- offset?: boolean;
195
- local?: boolean;
196
- };
197
- };
198
- tuple: {
199
- keyword: 'tuple';
200
- args: {
201
- items: Schema[];
202
- min?: number;
203
- max?: number;
204
- rest?: Schema;
205
- };
206
- };
207
- array: {
208
- keyword: 'array';
209
- args: {
210
- items: Schema[];
211
- min?: number;
212
- max?: number;
213
- unique?: boolean;
214
- };
215
- };
216
- enum: {
217
- keyword: 'enum';
218
- args: {
219
- name: string;
220
- typeName: string;
221
- asConst: boolean;
222
- items: Array<{
223
- name: string | number;
224
- format: 'string' | 'number' | 'boolean';
225
- value?: string | number | boolean;
226
- }>;
227
- };
228
- };
229
- and: {
230
- keyword: 'and';
231
- args: Schema[];
232
- };
233
- const: {
234
- keyword: 'const';
235
- args: {
236
- name: string | number;
237
- format: 'string' | 'number' | 'boolean';
238
- value?: string | number | boolean;
239
- };
240
- };
241
- union: {
242
- keyword: 'union';
243
- args: Schema[];
244
- };
245
- ref: {
246
- keyword: 'ref';
247
- args: {
248
- name: string;
249
- $ref: string;
250
- /**
251
- * Full qualified path.
252
- */
253
- path: KubbFile.Path;
254
- /**
255
- * When true `File.Import` is used.
256
- * When false a reference is used inside the current file.
257
- */
258
- isImportable: boolean;
259
- };
260
- };
261
- matches: {
262
- keyword: 'matches';
263
- args?: string;
264
- };
265
- boolean: {
266
- keyword: 'boolean';
267
- };
268
- default: {
269
- keyword: 'default';
270
- args: string | number | boolean;
271
- };
272
- string: {
273
- keyword: 'string';
274
- };
275
- integer: {
276
- keyword: 'integer';
277
- };
278
- bigint: {
279
- keyword: 'bigint';
280
- };
281
- number: {
282
- keyword: 'number';
283
- };
284
- max: {
285
- keyword: 'max';
286
- args: number;
287
- };
288
- min: {
289
- keyword: 'min';
290
- args: number;
291
- };
292
- exclusiveMaximum: {
293
- keyword: 'exclusiveMaximum';
294
- args: number;
295
- };
296
- exclusiveMinimum: {
297
- keyword: 'exclusiveMinimum';
298
- args: number;
299
- };
300
- describe: {
301
- keyword: 'describe';
302
- args: string;
303
- };
304
- example: {
305
- keyword: 'example';
306
- args: string;
307
- };
308
- deprecated: {
309
- keyword: 'deprecated';
310
- };
311
- optional: {
312
- keyword: 'optional';
313
- };
314
- undefined: {
315
- keyword: 'undefined';
316
- };
317
- nullish: {
318
- keyword: 'nullish';
319
- };
320
- nullable: {
321
- keyword: 'nullable';
322
- };
323
- null: {
324
- keyword: 'null';
325
- };
326
- any: {
327
- keyword: 'any';
328
- };
329
- unknown: {
330
- keyword: 'unknown';
331
- };
332
- void: {
333
- keyword: 'void';
334
- };
335
- blob: {
336
- keyword: 'blob';
337
- };
338
- schema: {
339
- keyword: 'schema';
340
- args: {
341
- type: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
342
- format?: string;
343
- };
344
- };
345
- name: {
346
- keyword: 'name';
347
- args: string;
348
- };
349
- catchall: {
350
- keyword: 'catchall';
351
- };
352
- interface: {
353
- keyword: 'interface';
354
- };
355
- };
356
- type Schema = {
357
- keyword: string;
358
- } | SchemaKeywordMapper[keyof SchemaKeywordMapper];
359
- //#endregion
360
- //#region ../plugin-oas/src/SchemaGenerator.d.ts
361
- type Context<TOptions, TPluginOptions extends PluginFactoryOptions> = {
362
- fabric: Fabric;
363
- oas: Oas;
364
- pluginManager: PluginManager;
365
- events?: AsyncEventEmitter<KubbEvents>;
366
- /**
367
- * Current plugin
368
- */
369
- plugin: Plugin<TPluginOptions>;
370
- mode: KubbFile.Mode;
371
- include?: Array<'schemas' | 'responses' | 'requestBodies'>;
372
- override: Array<Override<TOptions>> | undefined;
373
- contentType?: contentType;
374
- output?: string;
375
- };
376
- type SchemaGeneratorOptions = {
377
- dateType: false | 'string' | 'stringOffset' | 'stringLocal' | 'date';
378
- integerType?: 'number' | 'bigint';
379
- unknownType: 'any' | 'unknown' | 'void';
380
- emptySchemaType: 'any' | 'unknown' | 'void';
381
- enumType?: 'enum' | 'asConst' | 'asPascalConst' | 'constEnum' | 'literal' | 'inlineLiteral';
382
- enumSuffix?: string;
383
- /**
384
- * @deprecated Will be removed in v5. Use `collisionDetection: true` instead to prevent enum name collisions.
385
- * When `collisionDetection` is enabled, the rootName-based approach eliminates the need for numeric suffixes.
386
- * @internal
387
- */
388
- usedEnumNames?: Record<string, number>;
389
- mapper?: Record<string, string>;
390
- typed?: boolean;
391
- transformers: {
392
- /**
393
- * Customize the names based on the type that is provided by the plugin.
394
- */
395
- name?: (name: ResolveNameParams['name'], type?: ResolveNameParams['type']) => string;
396
- /**
397
- * Receive schema and name(propertyName) and return Schema array.
398
- * Return `undefined` to fall through to default schema generation.
399
- * @beta
400
- */
401
- schema?: (schemaProps: SchemaProps$1, defaultSchemas: Schema[]) => Array<Schema> | undefined;
402
- };
403
- };
404
- type SchemaProps$1 = {
405
- schema: SchemaObject | null;
406
- name: string | null;
407
- parentName: string | null;
408
- rootName?: string | null;
409
- };
410
- declare class SchemaGenerator<TOptions extends SchemaGeneratorOptions = SchemaGeneratorOptions, TPluginOptions extends PluginFactoryOptions = PluginFactoryOptions, TFileMeta extends FileMetaBase = FileMetaBase> {
411
- #private;
412
- constructor(options: TOptions, context: Context<TOptions, TPluginOptions>);
413
- get options(): TOptions;
414
- set options(options: TOptions);
415
- get context(): Context<TOptions, TPluginOptions>;
416
- refs: Refs;
417
- /**
418
- * Creates a type node from a given schema.
419
- * Delegates to getBaseTypeFromSchema internally and
420
- * optionally adds a union with null.
421
- */
422
- parse(props: SchemaProps$1): Schema[];
423
- static deepSearch<T extends keyof SchemaKeywordMapper>(tree: Schema[] | undefined, keyword: T): Array<SchemaKeywordMapper[T]>;
424
- static find<T extends keyof SchemaKeywordMapper>(tree: Schema[] | undefined, keyword: T): SchemaKeywordMapper[T] | undefined;
425
- static combineObjects(tree: Schema[] | undefined): Schema[];
426
- build(...generators: Array<Generator<TPluginOptions, Version>>): Promise<Array<KubbFile.File<TFileMeta>>>;
427
- }
428
- //#endregion
429
- //#region ../plugin-oas/src/generators/createGenerator.d.ts
430
- type CoreGenerator<TOptions extends PluginFactoryOptions, TVersion extends Version> = {
431
- name: string;
432
- type: 'core';
433
- version: TVersion;
434
- operations: (props: OperationsProps<TOptions, TVersion>) => Promise<KubbFile.File[]>;
435
- operation: (props: OperationProps<TOptions, TVersion>) => Promise<KubbFile.File[]>;
436
- schema: (props: SchemaProps<TOptions, TVersion>) => Promise<KubbFile.File[]>;
437
- };
438
- //#endregion
439
- //#region ../plugin-oas/src/generators/types.d.ts
440
- type Version = '1' | '2';
441
- type OperationsV1Props<TOptions extends PluginFactoryOptions> = {
442
- config: Config;
443
- generator: Omit<OperationGenerator<TOptions>, 'build'>;
444
- plugin: Plugin<TOptions>;
445
- operations: Array<Operation>;
446
- };
447
- type OperationsV2Props<TOptions extends PluginFactoryOptions> = {
448
- config: Config;
449
- adapter: Adapter;
450
- options: Plugin<TOptions>['options'];
451
- nodes: Array<OperationNode>;
452
- };
453
- type OperationV1Props<TOptions extends PluginFactoryOptions> = {
454
- config: Config;
455
- generator: Omit<OperationGenerator<TOptions>, 'build'>;
456
- plugin: Plugin<TOptions>;
457
- operation: Operation;
458
- };
459
- type OperationV2Props<TOptions extends PluginFactoryOptions> = {
460
- config: Config;
461
- adapter: Adapter;
462
- options: Plugin<TOptions>['options'];
463
- node: OperationNode;
464
- };
465
- type OperationsProps<TOptions extends PluginFactoryOptions, TVersion extends Version = '1'> = TVersion extends '2' ? OperationsV2Props<TOptions> : OperationsV1Props<TOptions>;
466
- type OperationProps<TOptions extends PluginFactoryOptions, TVersion extends Version = '1'> = TVersion extends '2' ? OperationV2Props<TOptions> : OperationV1Props<TOptions>;
467
- type SchemaV1Props<TOptions extends PluginFactoryOptions> = {
468
- config: Config;
469
- generator: Omit<SchemaGenerator<SchemaGeneratorOptions, TOptions>, 'build'>;
470
- plugin: Plugin<TOptions>;
471
- schema: {
472
- name: string;
473
- tree: Array<Schema>;
474
- value: SchemaObject;
475
- };
476
- };
477
- type SchemaV2Props<TOptions extends PluginFactoryOptions> = {
478
- config: Config;
479
- options: Plugin<TOptions>['options'];
480
- node: SchemaNode;
481
- adapter: Adapter;
482
- };
483
- type SchemaProps<TOptions extends PluginFactoryOptions, TVersion extends Version = '1'> = TVersion extends '2' ? SchemaV2Props<TOptions> : SchemaV1Props<TOptions>;
484
- type Generator<TOptions extends PluginFactoryOptions, TVersion extends Version = Version> = CoreGenerator<TOptions, TVersion> | ReactGenerator<TOptions, TVersion>;
485
- //#endregion
486
- //#region ../plugin-oas/src/generators/createReactGenerator.d.ts
487
- type ReactGenerator<TOptions extends PluginFactoryOptions, TVersion extends Version> = {
488
- name: string;
489
- type: 'react';
490
- version: TVersion;
491
- Operations: (props: OperationsProps<TOptions, TVersion>) => FabricReactNode;
492
- Operation: (props: OperationProps<TOptions, TVersion>) => FabricReactNode;
493
- Schema: (props: SchemaProps<TOptions, TVersion>) => FabricReactNode;
494
- };
495
- //#endregion
496
- //#region src/generators/mcpGenerator.d.ts
497
- declare const mcpGenerator: ReactGenerator<PluginMcp, "1">;
498
- //#endregion
499
- //#region src/generators/serverGenerator.d.ts
500
- declare const serverGenerator: ReactGenerator<PluginMcp, "1">;
501
- //#endregion
502
- export { mcpGenerator, serverGenerator };
503
- //# sourceMappingURL=generators.d.ts.map
@@ -1,2 +0,0 @@
1
- import { n as mcpGenerator, t as serverGenerator } from "./generators-BFPqVSmg.js";
2
- export { mcpGenerator, serverGenerator };
@@ -1,64 +0,0 @@
1
- import { t as __name } from "./chunk--u3MIqq1.js";
2
- import { Group, Output, PluginFactoryOptions, ResolveNameParams } from "@kubb/core";
3
- import { ClientImportPath, PluginClient } from "@kubb/plugin-client";
4
- import { Exclude, Include, Override, ResolvePathOptions } from "@kubb/plugin-oas";
5
- import { Generator } from "@kubb/plugin-oas/generators";
6
- import { Oas, contentType } from "@kubb/oas";
7
-
8
- //#region src/types.d.ts
9
- type Options = {
10
- /**
11
- * Specify the export location for the files and define the behavior of the output
12
- * @default { path: 'mcp', barrelType: 'named' }
13
- */
14
- output?: Output<Oas>;
15
- /**
16
- * Define which contentType should be used.
17
- * By default, the first JSON valid mediaType is used
18
- */
19
- contentType?: contentType;
20
- client?: ClientImportPath & Pick<PluginClient['options'], 'clientType' | 'dataReturnType' | 'baseURL' | 'bundle' | 'paramsCasing'>;
21
- /**
22
- * Transform parameter names to a specific casing format.
23
- * When set to 'camelcase', parameter names in path, query, and header params will be transformed to camelCase.
24
- * This should match the paramsCasing setting used in @kubb/plugin-ts.
25
- * @default undefined
26
- */
27
- paramsCasing?: 'camelcase';
28
- /**
29
- * Group the mcp requests based on the provided name.
30
- */
31
- group?: Group;
32
- /**
33
- * Array containing exclude parameters to exclude/skip tags/operations/methods/paths.
34
- */
35
- exclude?: Array<Exclude>;
36
- /**
37
- * Array containing include parameters to include tags/operations/methods/paths.
38
- */
39
- include?: Array<Include>;
40
- /**
41
- * Array containing override parameters to override `options` based on tags/operations/methods/paths.
42
- */
43
- override?: Array<Override<ResolvedOptions>>;
44
- transformers?: {
45
- /**
46
- * Customize the names based on the type that is provided by the plugin.
47
- */
48
- name?: (name: ResolveNameParams['name'], type?: ResolveNameParams['type']) => string;
49
- };
50
- /**
51
- * Define some generators next to the Mcp generators.
52
- */
53
- generators?: Array<Generator<PluginMcp>>;
54
- };
55
- type ResolvedOptions = {
56
- output: Output<Oas>;
57
- group: Options['group'];
58
- client: Pick<PluginClient['options'], 'client' | 'clientType' | 'dataReturnType' | 'importPath' | 'baseURL' | 'bundle' | 'paramsCasing'>;
59
- paramsCasing: Options['paramsCasing'];
60
- };
61
- type PluginMcp = PluginFactoryOptions<'plugin-mcp', Options, ResolvedOptions, never, ResolvePathOptions>;
62
- //#endregion
63
- export { PluginMcp as n, Options as t };
64
- //# sourceMappingURL=types-CblxgOvZ.d.ts.map
@@ -1 +0,0 @@
1
- export { Server } from './Server.tsx'
@@ -1,2 +0,0 @@
1
- export { mcpGenerator } from './mcpGenerator.tsx'
2
- export { serverGenerator } from './serverGenerator.tsx'