@kubb/core 5.0.0-alpha.5 → 5.0.0-alpha.50

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.
Files changed (71) hide show
  1. package/README.md +3 -2
  2. package/dist/PluginDriver-DtwggkXg.cjs +1082 -0
  3. package/dist/PluginDriver-DtwggkXg.cjs.map +1 -0
  4. package/dist/PluginDriver-mXeqWp-U.js +979 -0
  5. package/dist/PluginDriver-mXeqWp-U.js.map +1 -0
  6. package/dist/index.cjs +1013 -1829
  7. package/dist/index.cjs.map +1 -1
  8. package/dist/index.d.ts +274 -265
  9. package/dist/index.js +1003 -1799
  10. package/dist/index.js.map +1 -1
  11. package/dist/mocks.cjs +138 -0
  12. package/dist/mocks.cjs.map +1 -0
  13. package/dist/mocks.d.ts +74 -0
  14. package/dist/mocks.js +133 -0
  15. package/dist/mocks.js.map +1 -0
  16. package/dist/types-DfEv9d_c.d.ts +1721 -0
  17. package/package.json +51 -57
  18. package/src/FileManager.ts +133 -0
  19. package/src/FileProcessor.ts +86 -0
  20. package/src/Kubb.ts +154 -101
  21. package/src/PluginDriver.ts +418 -0
  22. package/src/constants.ts +43 -47
  23. package/src/createAdapter.ts +25 -0
  24. package/src/createKubb.ts +614 -0
  25. package/src/createRenderer.ts +57 -0
  26. package/src/createStorage.ts +58 -0
  27. package/src/defineGenerator.ts +88 -100
  28. package/src/defineLogger.ts +13 -3
  29. package/src/defineParser.ts +45 -0
  30. package/src/definePlugin.ts +68 -7
  31. package/src/defineResolver.ts +501 -0
  32. package/src/devtools.ts +14 -14
  33. package/src/index.ts +12 -17
  34. package/src/mocks.ts +171 -0
  35. package/src/renderNode.ts +35 -0
  36. package/src/storages/fsStorage.ts +40 -11
  37. package/src/storages/memoryStorage.ts +4 -3
  38. package/src/types.ts +575 -205
  39. package/src/utils/TreeNode.ts +47 -9
  40. package/src/utils/diagnostics.ts +4 -1
  41. package/src/utils/getBarrelFiles.ts +94 -16
  42. package/src/utils/isInputPath.ts +10 -0
  43. package/src/utils/packageJSON.ts +99 -0
  44. package/dist/PluginManager-vZodFEMe.d.ts +0 -1056
  45. package/dist/chunk-ByKO4r7w.cjs +0 -38
  46. package/dist/hooks.cjs +0 -60
  47. package/dist/hooks.cjs.map +0 -1
  48. package/dist/hooks.d.ts +0 -56
  49. package/dist/hooks.js +0 -56
  50. package/dist/hooks.js.map +0 -1
  51. package/src/BarrelManager.ts +0 -74
  52. package/src/PackageManager.ts +0 -180
  53. package/src/PluginManager.ts +0 -667
  54. package/src/PromiseManager.ts +0 -40
  55. package/src/build.ts +0 -419
  56. package/src/config.ts +0 -56
  57. package/src/defineAdapter.ts +0 -22
  58. package/src/defineStorage.ts +0 -56
  59. package/src/errors.ts +0 -1
  60. package/src/hooks/index.ts +0 -4
  61. package/src/hooks/useKubb.ts +0 -46
  62. package/src/hooks/useMode.ts +0 -11
  63. package/src/hooks/usePlugin.ts +0 -11
  64. package/src/hooks/usePluginManager.ts +0 -11
  65. package/src/utils/FunctionParams.ts +0 -155
  66. package/src/utils/executeStrategies.ts +0 -81
  67. package/src/utils/formatters.ts +0 -56
  68. package/src/utils/getConfigs.ts +0 -30
  69. package/src/utils/getPlugins.ts +0 -23
  70. package/src/utils/linters.ts +0 -25
  71. package/src/utils/resolveOptions.ts +0 -93
package/dist/mocks.cjs ADDED
@@ -0,0 +1,138 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_PluginDriver = require("./PluginDriver-DtwggkXg.cjs");
3
+ let node_path = require("node:path");
4
+ let _kubb_ast = require("@kubb/ast");
5
+ //#region src/mocks.ts
6
+ /**
7
+ * Creates a minimal `PluginDriver` mock suitable for unit tests.
8
+ */
9
+ function createMockedPluginDriver(options = {}) {
10
+ return {
11
+ config: options?.config ?? {
12
+ root: ".",
13
+ output: { path: "./path" }
14
+ },
15
+ getPlugin(_pluginName) {
16
+ return options?.plugin;
17
+ },
18
+ getResolver: (_pluginName) => options?.plugin?.resolver,
19
+ fileManager: new require_PluginDriver.FileManager()
20
+ };
21
+ }
22
+ /**
23
+ * Creates a minimal `Adapter` mock suitable for unit tests.
24
+ *
25
+ * - `parse` returns an empty `InputNode` by default; override via `options.parse`.
26
+ * - `getImports` returns `[]` by default (single-file mode, no cross-file imports).
27
+ */
28
+ function createMockedAdapter(options = {}) {
29
+ return {
30
+ name: options.name ?? "oas",
31
+ options: options.resolvedOptions ?? {},
32
+ inputNode: options.inputNode ?? null,
33
+ parse: options.parse ?? (async () => ({
34
+ kind: "Input",
35
+ schemas: [],
36
+ operations: []
37
+ })),
38
+ getImports: options.getImports ?? ((_node, _resolve) => [])
39
+ };
40
+ }
41
+ /**
42
+ * Creates a minimal plugin mock suitable for unit tests.
43
+ *
44
+ * @example
45
+ * const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })
46
+ */
47
+ function createMockedPlugin(params) {
48
+ return {
49
+ name: params.name,
50
+ options: params.options,
51
+ resolver: params.resolver,
52
+ transformer: params.transformer,
53
+ dependencies: params.dependencies,
54
+ hooks: {}
55
+ };
56
+ }
57
+ function createMockedPluginContext(opts) {
58
+ const root = (0, node_path.resolve)(opts.config.root, opts.config.output.path);
59
+ return {
60
+ config: opts.config,
61
+ root,
62
+ getMode: (output) => require_PluginDriver.PluginDriver.getMode((0, node_path.resolve)(root, output.path)),
63
+ adapter: opts.adapter,
64
+ resolver: opts.resolver,
65
+ plugin: opts.plugin,
66
+ driver: opts.driver,
67
+ getResolver: (name) => opts.driver.getResolver(name),
68
+ inputNode: {
69
+ kind: "Input",
70
+ schemas: [],
71
+ operations: []
72
+ },
73
+ addFile: async (...files) => opts.driver.fileManager.add(...files),
74
+ upsertFile: async (...files) => opts.driver.fileManager.upsert(...files),
75
+ hooks: opts.driver.hooks ?? {},
76
+ warn: (msg) => console.warn(msg),
77
+ error: (msg) => console.error(msg),
78
+ info: (msg) => console.info(msg),
79
+ openInStudio: async () => {}
80
+ };
81
+ }
82
+ /**
83
+ * Renders a generator's `schema` method in a test context.
84
+ *
85
+ * @example
86
+ * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
87
+ * await matchFiles(driver.fileManager.files)
88
+ */
89
+ async function renderGeneratorSchema(generator, node, opts) {
90
+ if (!generator.schema) return;
91
+ const context = createMockedPluginContext(opts);
92
+ const transformedNode = opts.plugin.transformer ? (0, _kubb_ast.transform)(node, opts.plugin.transformer) : node;
93
+ await require_PluginDriver.applyHookResult(await generator.schema(transformedNode, {
94
+ ...context,
95
+ options: opts.options
96
+ }), opts.driver, generator.renderer ?? void 0);
97
+ }
98
+ /**
99
+ * Renders a generator's `operation` method in a test context.
100
+ *
101
+ * @example
102
+ * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
103
+ * await matchFiles(driver.fileManager.files)
104
+ */
105
+ async function renderGeneratorOperation(generator, node, opts) {
106
+ if (!generator.operation) return;
107
+ const context = createMockedPluginContext(opts);
108
+ const transformedNode = opts.plugin.transformer ? (0, _kubb_ast.transform)(node, opts.plugin.transformer) : node;
109
+ await require_PluginDriver.applyHookResult(await generator.operation(transformedNode, {
110
+ ...context,
111
+ options: opts.options
112
+ }), opts.driver, generator.renderer ?? void 0);
113
+ }
114
+ /**
115
+ * Renders a generator's `operations` method in a test context.
116
+ *
117
+ * @example
118
+ * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })
119
+ * await matchFiles(driver.fileManager.files)
120
+ */
121
+ async function renderGeneratorOperations(generator, nodes, opts) {
122
+ if (!generator.operations) return;
123
+ const context = createMockedPluginContext(opts);
124
+ const transformedNodes = opts.plugin.transformer ? nodes.map((n) => (0, _kubb_ast.transform)(n, opts.plugin.transformer)) : nodes;
125
+ await require_PluginDriver.applyHookResult(await generator.operations(transformedNodes, {
126
+ ...context,
127
+ options: opts.options
128
+ }), opts.driver, generator.renderer ?? void 0);
129
+ }
130
+ //#endregion
131
+ exports.createMockedAdapter = createMockedAdapter;
132
+ exports.createMockedPlugin = createMockedPlugin;
133
+ exports.createMockedPluginDriver = createMockedPluginDriver;
134
+ exports.renderGeneratorOperation = renderGeneratorOperation;
135
+ exports.renderGeneratorOperations = renderGeneratorOperations;
136
+ exports.renderGeneratorSchema = renderGeneratorSchema;
137
+
138
+ //# sourceMappingURL=mocks.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mocks.cjs","names":["FileManager","PluginDriver","applyHookResult"],"sources":["../src/mocks.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { FileNode, OperationNode, SchemaNode, Visitor } from '@kubb/ast'\nimport { transform } from '@kubb/ast'\nimport { FileManager } from './FileManager.ts'\nimport { PluginDriver } from './PluginDriver.ts'\nimport { applyHookResult } from './renderNode.ts'\nimport type { Adapter, AdapterFactoryOptions, Config, Generator, GeneratorContext, NormalizedPlugin, PluginFactoryOptions } from './types.ts'\n\n/**\n * Creates a minimal `PluginDriver` mock suitable for unit tests.\n */\nexport function createMockedPluginDriver(options: { name?: string; plugin?: NormalizedPlugin; config?: Config } = {}): PluginDriver {\n return {\n config: options?.config ?? {\n root: '.',\n output: {\n path: './path',\n },\n },\n getPlugin(_pluginName: string): NormalizedPlugin | undefined {\n return options?.plugin\n },\n getResolver: (_pluginName: string) => options?.plugin?.resolver,\n fileManager: new FileManager(),\n } as unknown as PluginDriver\n}\n\n/**\n * Creates a minimal `Adapter` mock suitable for unit tests.\n *\n * - `parse` returns an empty `InputNode` by default; override via `options.parse`.\n * - `getImports` returns `[]` by default (single-file mode, no cross-file imports).\n */\nexport function createMockedAdapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions>(\n options: {\n name?: TOptions['name']\n resolvedOptions?: TOptions['resolvedOptions']\n inputNode?: Adapter<TOptions>['inputNode']\n parse?: Adapter<TOptions>['parse']\n getImports?: Adapter<TOptions>['getImports']\n } = {},\n): Adapter<TOptions> {\n return {\n name: (options.name ?? 'oas') as TOptions['name'],\n options: (options.resolvedOptions ?? {}) as TOptions['resolvedOptions'],\n inputNode: options.inputNode ?? null,\n parse: options.parse ?? (async () => ({ kind: 'Input' as const, schemas: [], operations: [] })),\n getImports: options.getImports ?? ((_node: SchemaNode, _resolve: (schemaName: string) => { name: string; path: string }) => []),\n } as Adapter<TOptions>\n}\n\n/**\n * Creates a minimal plugin mock suitable for unit tests.\n *\n * @example\n * const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })\n */\nexport function createMockedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(params: {\n name: TOptions['name']\n options: TOptions['resolvedOptions']\n resolver?: TOptions['resolver']\n transformer?: Visitor\n dependencies?: Array<string>\n}): NormalizedPlugin<TOptions> {\n return {\n name: params.name,\n options: params.options,\n resolver: params.resolver,\n transformer: params.transformer,\n dependencies: params.dependencies,\n hooks: {},\n } as unknown as NormalizedPlugin<TOptions>\n}\n\ntype RenderGeneratorOptions<TOptions extends PluginFactoryOptions> = {\n config: Config\n adapter: Adapter\n driver: PluginDriver\n plugin: NormalizedPlugin<TOptions>\n options: TOptions['resolvedOptions']\n resolver: TOptions['resolver']\n}\n\nfunction createMockedPluginContext<TOptions extends PluginFactoryOptions>(opts: RenderGeneratorOptions<TOptions>): Omit<GeneratorContext<TOptions>, 'options'> {\n const root = resolve(opts.config.root, opts.config.output.path)\n\n return {\n config: opts.config,\n root,\n getMode: (output: { path: string }) => PluginDriver.getMode(resolve(root, output.path)),\n adapter: opts.adapter,\n resolver: opts.resolver,\n plugin: opts.plugin,\n driver: opts.driver,\n getResolver: (name: string) => opts.driver.getResolver(name),\n inputNode: { kind: 'Input', schemas: [], operations: [] },\n addFile: async (...files: Array<FileNode>) => opts.driver.fileManager.add(...files),\n upsertFile: async (...files: Array<FileNode>) => opts.driver.fileManager.upsert(...files),\n hooks: opts.driver.hooks ?? ({} as never),\n warn: (msg: string) => console.warn(msg),\n error: (msg: string) => console.error(msg),\n info: (msg: string) => console.info(msg),\n openInStudio: async () => {},\n } as unknown as Omit<GeneratorContext<TOptions>, 'options'>\n}\n\n/**\n * Renders a generator's `schema` method in a test context.\n *\n * @example\n * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n */\nexport async function renderGeneratorSchema<TOptions extends PluginFactoryOptions>(\n generator: Generator<TOptions>,\n node: SchemaNode,\n opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n if (!generator.schema) return\n const context = createMockedPluginContext(opts)\n const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n const result = await generator.schema(transformedNode, {\n ...context,\n options: opts.options,\n })\n await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n\n/**\n * Renders a generator's `operation` method in a test context.\n *\n * @example\n * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n */\nexport async function renderGeneratorOperation<TOptions extends PluginFactoryOptions>(\n generator: Generator<TOptions>,\n node: OperationNode,\n opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n if (!generator.operation) return\n const context = createMockedPluginContext(opts)\n const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n const result = await generator.operation(transformedNode, {\n ...context,\n options: opts.options,\n })\n await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n\n/**\n * Renders a generator's `operations` method in a test context.\n *\n * @example\n * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n */\nexport async function renderGeneratorOperations<TOptions extends PluginFactoryOptions>(\n generator: Generator<TOptions>,\n nodes: Array<OperationNode>,\n opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n if (!generator.operations) return\n const context = createMockedPluginContext(opts)\n const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer!)) : nodes\n const result = await generator.operations(transformedNodes, {\n ...context,\n options: opts.options,\n })\n await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n"],"mappings":"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"}
@@ -0,0 +1,74 @@
1
+ import { t as __name } from "./chunk--u3MIqq1.js";
2
+ import { C as PluginFactoryOptions, G as Generator, V as PluginDriver, b as NormalizedPlugin, n as AdapterFactoryOptions, o as Config, t as Adapter } from "./types-DfEv9d_c.js";
3
+ import { OperationNode, SchemaNode, Visitor } from "@kubb/ast";
4
+
5
+ //#region src/mocks.d.ts
6
+ /**
7
+ * Creates a minimal `PluginDriver` mock suitable for unit tests.
8
+ */
9
+ declare function createMockedPluginDriver(options?: {
10
+ name?: string;
11
+ plugin?: NormalizedPlugin;
12
+ config?: Config;
13
+ }): PluginDriver;
14
+ /**
15
+ * Creates a minimal `Adapter` mock suitable for unit tests.
16
+ *
17
+ * - `parse` returns an empty `InputNode` by default; override via `options.parse`.
18
+ * - `getImports` returns `[]` by default (single-file mode, no cross-file imports).
19
+ */
20
+ declare function createMockedAdapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions>(options?: {
21
+ name?: TOptions['name'];
22
+ resolvedOptions?: TOptions['resolvedOptions'];
23
+ inputNode?: Adapter<TOptions>['inputNode'];
24
+ parse?: Adapter<TOptions>['parse'];
25
+ getImports?: Adapter<TOptions>['getImports'];
26
+ }): Adapter<TOptions>;
27
+ /**
28
+ * Creates a minimal plugin mock suitable for unit tests.
29
+ *
30
+ * @example
31
+ * const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })
32
+ */
33
+ declare function createMockedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(params: {
34
+ name: TOptions['name'];
35
+ options: TOptions['resolvedOptions'];
36
+ resolver?: TOptions['resolver'];
37
+ transformer?: Visitor;
38
+ dependencies?: Array<string>;
39
+ }): NormalizedPlugin<TOptions>;
40
+ type RenderGeneratorOptions<TOptions extends PluginFactoryOptions> = {
41
+ config: Config;
42
+ adapter: Adapter;
43
+ driver: PluginDriver;
44
+ plugin: NormalizedPlugin<TOptions>;
45
+ options: TOptions['resolvedOptions'];
46
+ resolver: TOptions['resolver'];
47
+ };
48
+ /**
49
+ * Renders a generator's `schema` method in a test context.
50
+ *
51
+ * @example
52
+ * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
53
+ * await matchFiles(driver.fileManager.files)
54
+ */
55
+ declare function renderGeneratorSchema<TOptions extends PluginFactoryOptions>(generator: Generator<TOptions>, node: SchemaNode, opts: RenderGeneratorOptions<TOptions>): Promise<void>;
56
+ /**
57
+ * Renders a generator's `operation` method in a test context.
58
+ *
59
+ * @example
60
+ * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
61
+ * await matchFiles(driver.fileManager.files)
62
+ */
63
+ declare function renderGeneratorOperation<TOptions extends PluginFactoryOptions>(generator: Generator<TOptions>, node: OperationNode, opts: RenderGeneratorOptions<TOptions>): Promise<void>;
64
+ /**
65
+ * Renders a generator's `operations` method in a test context.
66
+ *
67
+ * @example
68
+ * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })
69
+ * await matchFiles(driver.fileManager.files)
70
+ */
71
+ declare function renderGeneratorOperations<TOptions extends PluginFactoryOptions>(generator: Generator<TOptions>, nodes: Array<OperationNode>, opts: RenderGeneratorOptions<TOptions>): Promise<void>;
72
+ //#endregion
73
+ export { createMockedAdapter, createMockedPlugin, createMockedPluginDriver, renderGeneratorOperation, renderGeneratorOperations, renderGeneratorSchema };
74
+ //# sourceMappingURL=mocks.d.ts.map
package/dist/mocks.js ADDED
@@ -0,0 +1,133 @@
1
+ import "./chunk--u3MIqq1.js";
2
+ import { n as applyHookResult, r as FileManager, t as PluginDriver } from "./PluginDriver-mXeqWp-U.js";
3
+ import { resolve } from "node:path";
4
+ import { transform } from "@kubb/ast";
5
+ //#region src/mocks.ts
6
+ /**
7
+ * Creates a minimal `PluginDriver` mock suitable for unit tests.
8
+ */
9
+ function createMockedPluginDriver(options = {}) {
10
+ return {
11
+ config: options?.config ?? {
12
+ root: ".",
13
+ output: { path: "./path" }
14
+ },
15
+ getPlugin(_pluginName) {
16
+ return options?.plugin;
17
+ },
18
+ getResolver: (_pluginName) => options?.plugin?.resolver,
19
+ fileManager: new FileManager()
20
+ };
21
+ }
22
+ /**
23
+ * Creates a minimal `Adapter` mock suitable for unit tests.
24
+ *
25
+ * - `parse` returns an empty `InputNode` by default; override via `options.parse`.
26
+ * - `getImports` returns `[]` by default (single-file mode, no cross-file imports).
27
+ */
28
+ function createMockedAdapter(options = {}) {
29
+ return {
30
+ name: options.name ?? "oas",
31
+ options: options.resolvedOptions ?? {},
32
+ inputNode: options.inputNode ?? null,
33
+ parse: options.parse ?? (async () => ({
34
+ kind: "Input",
35
+ schemas: [],
36
+ operations: []
37
+ })),
38
+ getImports: options.getImports ?? ((_node, _resolve) => [])
39
+ };
40
+ }
41
+ /**
42
+ * Creates a minimal plugin mock suitable for unit tests.
43
+ *
44
+ * @example
45
+ * const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })
46
+ */
47
+ function createMockedPlugin(params) {
48
+ return {
49
+ name: params.name,
50
+ options: params.options,
51
+ resolver: params.resolver,
52
+ transformer: params.transformer,
53
+ dependencies: params.dependencies,
54
+ hooks: {}
55
+ };
56
+ }
57
+ function createMockedPluginContext(opts) {
58
+ const root = resolve(opts.config.root, opts.config.output.path);
59
+ return {
60
+ config: opts.config,
61
+ root,
62
+ getMode: (output) => PluginDriver.getMode(resolve(root, output.path)),
63
+ adapter: opts.adapter,
64
+ resolver: opts.resolver,
65
+ plugin: opts.plugin,
66
+ driver: opts.driver,
67
+ getResolver: (name) => opts.driver.getResolver(name),
68
+ inputNode: {
69
+ kind: "Input",
70
+ schemas: [],
71
+ operations: []
72
+ },
73
+ addFile: async (...files) => opts.driver.fileManager.add(...files),
74
+ upsertFile: async (...files) => opts.driver.fileManager.upsert(...files),
75
+ hooks: opts.driver.hooks ?? {},
76
+ warn: (msg) => console.warn(msg),
77
+ error: (msg) => console.error(msg),
78
+ info: (msg) => console.info(msg),
79
+ openInStudio: async () => {}
80
+ };
81
+ }
82
+ /**
83
+ * Renders a generator's `schema` method in a test context.
84
+ *
85
+ * @example
86
+ * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
87
+ * await matchFiles(driver.fileManager.files)
88
+ */
89
+ async function renderGeneratorSchema(generator, node, opts) {
90
+ if (!generator.schema) return;
91
+ const context = createMockedPluginContext(opts);
92
+ const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node;
93
+ await applyHookResult(await generator.schema(transformedNode, {
94
+ ...context,
95
+ options: opts.options
96
+ }), opts.driver, generator.renderer ?? void 0);
97
+ }
98
+ /**
99
+ * Renders a generator's `operation` method in a test context.
100
+ *
101
+ * @example
102
+ * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })
103
+ * await matchFiles(driver.fileManager.files)
104
+ */
105
+ async function renderGeneratorOperation(generator, node, opts) {
106
+ if (!generator.operation) return;
107
+ const context = createMockedPluginContext(opts);
108
+ const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node;
109
+ await applyHookResult(await generator.operation(transformedNode, {
110
+ ...context,
111
+ options: opts.options
112
+ }), opts.driver, generator.renderer ?? void 0);
113
+ }
114
+ /**
115
+ * Renders a generator's `operations` method in a test context.
116
+ *
117
+ * @example
118
+ * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })
119
+ * await matchFiles(driver.fileManager.files)
120
+ */
121
+ async function renderGeneratorOperations(generator, nodes, opts) {
122
+ if (!generator.operations) return;
123
+ const context = createMockedPluginContext(opts);
124
+ const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer)) : nodes;
125
+ await applyHookResult(await generator.operations(transformedNodes, {
126
+ ...context,
127
+ options: opts.options
128
+ }), opts.driver, generator.renderer ?? void 0);
129
+ }
130
+ //#endregion
131
+ export { createMockedAdapter, createMockedPlugin, createMockedPluginDriver, renderGeneratorOperation, renderGeneratorOperations, renderGeneratorSchema };
132
+
133
+ //# sourceMappingURL=mocks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mocks.js","names":[],"sources":["../src/mocks.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { FileNode, OperationNode, SchemaNode, Visitor } from '@kubb/ast'\nimport { transform } from '@kubb/ast'\nimport { FileManager } from './FileManager.ts'\nimport { PluginDriver } from './PluginDriver.ts'\nimport { applyHookResult } from './renderNode.ts'\nimport type { Adapter, AdapterFactoryOptions, Config, Generator, GeneratorContext, NormalizedPlugin, PluginFactoryOptions } from './types.ts'\n\n/**\n * Creates a minimal `PluginDriver` mock suitable for unit tests.\n */\nexport function createMockedPluginDriver(options: { name?: string; plugin?: NormalizedPlugin; config?: Config } = {}): PluginDriver {\n return {\n config: options?.config ?? {\n root: '.',\n output: {\n path: './path',\n },\n },\n getPlugin(_pluginName: string): NormalizedPlugin | undefined {\n return options?.plugin\n },\n getResolver: (_pluginName: string) => options?.plugin?.resolver,\n fileManager: new FileManager(),\n } as unknown as PluginDriver\n}\n\n/**\n * Creates a minimal `Adapter` mock suitable for unit tests.\n *\n * - `parse` returns an empty `InputNode` by default; override via `options.parse`.\n * - `getImports` returns `[]` by default (single-file mode, no cross-file imports).\n */\nexport function createMockedAdapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions>(\n options: {\n name?: TOptions['name']\n resolvedOptions?: TOptions['resolvedOptions']\n inputNode?: Adapter<TOptions>['inputNode']\n parse?: Adapter<TOptions>['parse']\n getImports?: Adapter<TOptions>['getImports']\n } = {},\n): Adapter<TOptions> {\n return {\n name: (options.name ?? 'oas') as TOptions['name'],\n options: (options.resolvedOptions ?? {}) as TOptions['resolvedOptions'],\n inputNode: options.inputNode ?? null,\n parse: options.parse ?? (async () => ({ kind: 'Input' as const, schemas: [], operations: [] })),\n getImports: options.getImports ?? ((_node: SchemaNode, _resolve: (schemaName: string) => { name: string; path: string }) => []),\n } as Adapter<TOptions>\n}\n\n/**\n * Creates a minimal plugin mock suitable for unit tests.\n *\n * @example\n * const plugin = createMockedPlugin<PluginTs>({ name: '@kubb/plugin-ts', options })\n */\nexport function createMockedPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>(params: {\n name: TOptions['name']\n options: TOptions['resolvedOptions']\n resolver?: TOptions['resolver']\n transformer?: Visitor\n dependencies?: Array<string>\n}): NormalizedPlugin<TOptions> {\n return {\n name: params.name,\n options: params.options,\n resolver: params.resolver,\n transformer: params.transformer,\n dependencies: params.dependencies,\n hooks: {},\n } as unknown as NormalizedPlugin<TOptions>\n}\n\ntype RenderGeneratorOptions<TOptions extends PluginFactoryOptions> = {\n config: Config\n adapter: Adapter\n driver: PluginDriver\n plugin: NormalizedPlugin<TOptions>\n options: TOptions['resolvedOptions']\n resolver: TOptions['resolver']\n}\n\nfunction createMockedPluginContext<TOptions extends PluginFactoryOptions>(opts: RenderGeneratorOptions<TOptions>): Omit<GeneratorContext<TOptions>, 'options'> {\n const root = resolve(opts.config.root, opts.config.output.path)\n\n return {\n config: opts.config,\n root,\n getMode: (output: { path: string }) => PluginDriver.getMode(resolve(root, output.path)),\n adapter: opts.adapter,\n resolver: opts.resolver,\n plugin: opts.plugin,\n driver: opts.driver,\n getResolver: (name: string) => opts.driver.getResolver(name),\n inputNode: { kind: 'Input', schemas: [], operations: [] },\n addFile: async (...files: Array<FileNode>) => opts.driver.fileManager.add(...files),\n upsertFile: async (...files: Array<FileNode>) => opts.driver.fileManager.upsert(...files),\n hooks: opts.driver.hooks ?? ({} as never),\n warn: (msg: string) => console.warn(msg),\n error: (msg: string) => console.error(msg),\n info: (msg: string) => console.info(msg),\n openInStudio: async () => {},\n } as unknown as Omit<GeneratorContext<TOptions>, 'options'>\n}\n\n/**\n * Renders a generator's `schema` method in a test context.\n *\n * @example\n * await renderGeneratorSchema(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n */\nexport async function renderGeneratorSchema<TOptions extends PluginFactoryOptions>(\n generator: Generator<TOptions>,\n node: SchemaNode,\n opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n if (!generator.schema) return\n const context = createMockedPluginContext(opts)\n const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n const result = await generator.schema(transformedNode, {\n ...context,\n options: opts.options,\n })\n await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n\n/**\n * Renders a generator's `operation` method in a test context.\n *\n * @example\n * await renderGeneratorOperation(typeGenerator, node, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n */\nexport async function renderGeneratorOperation<TOptions extends PluginFactoryOptions>(\n generator: Generator<TOptions>,\n node: OperationNode,\n opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n if (!generator.operation) return\n const context = createMockedPluginContext(opts)\n const transformedNode = opts.plugin.transformer ? transform(node, opts.plugin.transformer) : node\n const result = await generator.operation(transformedNode, {\n ...context,\n options: opts.options,\n })\n await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n\n/**\n * Renders a generator's `operations` method in a test context.\n *\n * @example\n * await renderGeneratorOperations(classClientGenerator, nodes, { config, adapter, driver, plugin, options, resolver })\n * await matchFiles(driver.fileManager.files)\n */\nexport async function renderGeneratorOperations<TOptions extends PluginFactoryOptions>(\n generator: Generator<TOptions>,\n nodes: Array<OperationNode>,\n opts: RenderGeneratorOptions<TOptions>,\n): Promise<void> {\n if (!generator.operations) return\n const context = createMockedPluginContext(opts)\n const transformedNodes = opts.plugin.transformer ? nodes.map((n) => transform(n, opts.plugin.transformer!)) : nodes\n const result = await generator.operations(transformedNodes, {\n ...context,\n options: opts.options,\n })\n await applyHookResult(result, opts.driver, generator.renderer ?? undefined)\n}\n"],"mappings":";;;;;;;;AAWA,SAAgB,yBAAyB,UAAyE,EAAE,EAAgB;AAClI,QAAO;EACL,QAAQ,SAAS,UAAU;GACzB,MAAM;GACN,QAAQ,EACN,MAAM,UACP;GACF;EACD,UAAU,aAAmD;AAC3D,UAAO,SAAS;;EAElB,cAAc,gBAAwB,SAAS,QAAQ;EACvD,aAAa,IAAI,aAAa;EAC/B;;;;;;;;AASH,SAAgB,oBACd,UAMI,EAAE,EACa;AACnB,QAAO;EACL,MAAO,QAAQ,QAAQ;EACvB,SAAU,QAAQ,mBAAmB,EAAE;EACvC,WAAW,QAAQ,aAAa;EAChC,OAAO,QAAQ,UAAU,aAAa;GAAE,MAAM;GAAkB,SAAS,EAAE;GAAE,YAAY,EAAE;GAAE;EAC7F,YAAY,QAAQ,gBAAgB,OAAmB,aAAqE,EAAE;EAC/H;;;;;;;;AASH,SAAgB,mBAAiF,QAMlE;AAC7B,QAAO;EACL,MAAM,OAAO;EACb,SAAS,OAAO;EAChB,UAAU,OAAO;EACjB,aAAa,OAAO;EACpB,cAAc,OAAO;EACrB,OAAO,EAAE;EACV;;AAYH,SAAS,0BAAiE,MAAqF;CAC7J,MAAM,OAAO,QAAQ,KAAK,OAAO,MAAM,KAAK,OAAO,OAAO,KAAK;AAE/D,QAAO;EACL,QAAQ,KAAK;EACb;EACA,UAAU,WAA6B,aAAa,QAAQ,QAAQ,MAAM,OAAO,KAAK,CAAC;EACvF,SAAS,KAAK;EACd,UAAU,KAAK;EACf,QAAQ,KAAK;EACb,QAAQ,KAAK;EACb,cAAc,SAAiB,KAAK,OAAO,YAAY,KAAK;EAC5D,WAAW;GAAE,MAAM;GAAS,SAAS,EAAE;GAAE,YAAY,EAAE;GAAE;EACzD,SAAS,OAAO,GAAG,UAA2B,KAAK,OAAO,YAAY,IAAI,GAAG,MAAM;EACnF,YAAY,OAAO,GAAG,UAA2B,KAAK,OAAO,YAAY,OAAO,GAAG,MAAM;EACzF,OAAO,KAAK,OAAO,SAAU,EAAE;EAC/B,OAAO,QAAgB,QAAQ,KAAK,IAAI;EACxC,QAAQ,QAAgB,QAAQ,MAAM,IAAI;EAC1C,OAAO,QAAgB,QAAQ,KAAK,IAAI;EACxC,cAAc,YAAY;EAC3B;;;;;;;;;AAUH,eAAsB,sBACpB,WACA,MACA,MACe;AACf,KAAI,CAAC,UAAU,OAAQ;CACvB,MAAM,UAAU,0BAA0B,KAAK;CAC/C,MAAM,kBAAkB,KAAK,OAAO,cAAc,UAAU,MAAM,KAAK,OAAO,YAAY,GAAG;AAK7F,OAAM,gBAJS,MAAM,UAAU,OAAO,iBAAiB;EACrD,GAAG;EACH,SAAS,KAAK;EACf,CAAC,EAC4B,KAAK,QAAQ,UAAU,YAAY,KAAA,EAAU;;;;;;;;;AAU7E,eAAsB,yBACpB,WACA,MACA,MACe;AACf,KAAI,CAAC,UAAU,UAAW;CAC1B,MAAM,UAAU,0BAA0B,KAAK;CAC/C,MAAM,kBAAkB,KAAK,OAAO,cAAc,UAAU,MAAM,KAAK,OAAO,YAAY,GAAG;AAK7F,OAAM,gBAJS,MAAM,UAAU,UAAU,iBAAiB;EACxD,GAAG;EACH,SAAS,KAAK;EACf,CAAC,EAC4B,KAAK,QAAQ,UAAU,YAAY,KAAA,EAAU;;;;;;;;;AAU7E,eAAsB,0BACpB,WACA,OACA,MACe;AACf,KAAI,CAAC,UAAU,WAAY;CAC3B,MAAM,UAAU,0BAA0B,KAAK;CAC/C,MAAM,mBAAmB,KAAK,OAAO,cAAc,MAAM,KAAK,MAAM,UAAU,GAAG,KAAK,OAAO,YAAa,CAAC,GAAG;AAK9G,OAAM,gBAJS,MAAM,UAAU,WAAW,kBAAkB;EAC1D,GAAG;EACH,SAAS,KAAK;EACf,CAAC,EAC4B,KAAK,QAAQ,UAAU,YAAY,KAAA,EAAU"}