@kubb/core 4.36.1 → 5.0.0-alpha.2

package/dist/{types-D30QAz2y.d.ts → types-B7eZvqwD.d.ts}

@@ -213,7 +213,7 @@ type GetFileProps<TOptions = object> = {
   name: string;
   mode?: KubbFile.Mode;
   extname: KubbFile.Extname;
-  pluginKey: Plugin['key'];
+  pluginName: string;
   options?: TOptions;
 };
 declare function getMode(fileOrFolder: string | undefined | null): KubbFile.Mode;
@@ -234,10 +234,10 @@ declare class PluginManager {
     name,
     mode,
     extname,
-    pluginKey,
+    pluginName,
     options
   }: GetFileProps<TOptions>): KubbFile.File<{
-    pluginKey: Plugin['key'];
+    pluginName: string;
   }>;
   resolvePath: <TOptions = object>(params: ResolvePathParams<TOptions>) => KubbFile.Path;
   resolveName: (params: ResolveNameParams) => string;
@@ -245,11 +245,11 @@ declare class PluginManager {
    * Run a specific hookName for plugin x.
    */
   hookForPlugin<H extends PluginLifecycleHooks>({
-    pluginKey,
+    pluginName,
     hookName,
     parameters
   }: {
-    pluginKey: Plugin['key'];
+    pluginName: string;
     hookName: H;
     parameters: PluginParameter<H>;
   }): Promise<Array<ReturnType<ParseResult<H>> | null>>;
@@ -257,11 +257,11 @@ declare class PluginManager {
    * Run a specific hookName for plugin x.
    */
   hookForPluginSync<H extends PluginLifecycleHooks>({
-    pluginKey,
+    pluginName,
     hookName,
     parameters
   }: {
-    pluginKey: Plugin['key'];
+    pluginName: string;
     hookName: H;
     parameters: PluginParameter<H>;
   }): Array<ReturnType<ParseResult<H>>> | null;
@@ -309,8 +309,8 @@ declare class PluginManager {
     hookName: H;
     parameters?: PluginParameter<H>;
   }): Promise<void>;
-  getPluginByKey(pluginKey: Plugin['key']): Plugin | undefined;
-  getPluginsByKey(hookName: keyof PluginWithLifeCycle, pluginKey: Plugin['key']): Plugin[];
+  getPluginByName(pluginName: string): Plugin | undefined;
+  getPluginsByName(hookName: keyof PluginWithLifeCycle, pluginName: string): Plugin[];
 }
 //#endregion
 //#region src/Kubb.d.ts
@@ -766,7 +766,7 @@ type Config<TInput = Input> = {
 };
 type PluginFactoryOptions<
 /**
- * Name to be used for the plugin, this will also be used for they key.
+ * Name to be used for the plugin.
  */
 TName extends string = string,
 /**
@@ -786,16 +786,11 @@ TContext = unknown,
  */
 TResolvePathOptions extends object = object> = {
   name: TName;
-  /**
-   * Same behavior like what has been done with `QueryKey` in `@tanstack/react-query`
-   */
-  key: PluginKey<TName | string>;
   options: TOptions;
   resolvedOptions: TResolvedOptions;
   context: TContext;
   resolvePathOptions: TResolvePathOptions;
 };
-type PluginKey<TName> = [name: TName, identifier?: string | number];
 type GetPluginFactoryOptions<TPlugin extends UserPlugin> = TPlugin extends UserPlugin<infer X> ? X : never;
 type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
   /**
@@ -827,11 +822,6 @@ type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
    * @example @kubb/typescript
    */
   name: TOptions['name'];
-  /**
-   * Internal key used when a developer uses more than one of the same plugin
-   * @private
-   */
-  key: TOptions['key'];
   /**
    * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin is executed after these plugins.
    * Can be used to validate dependent plugins.
@@ -876,7 +866,7 @@ type PluginLifecycle<TOptions extends PluginFactoryOptions = PluginFactoryOption
 type PluginLifecycleHooks = keyof PluginLifecycle;
 type PluginParameter<H extends PluginLifecycleHooks> = Parameters<Required<PluginLifecycle>[H]>;
 type ResolvePathParams<TOptions = object> = {
-  pluginKey?: Plugin['key'];
+  pluginName?: string;
   baseName: KubbFile.BaseName;
   mode?: KubbFile.Mode;
   /**
@@ -886,7 +876,7 @@ type ResolvePathParams<TOptions = object> = {
 };
 type ResolveNameParams = {
   name: string;
-  pluginKey?: Plugin['key'];
+  pluginName?: string;
   /**
    * Specifies the type of entity being named.
    * - 'file' customizes the name of the created file (uses camelCase).
@@ -987,5 +977,5 @@ type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
 };
 type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Omit<Logger<TOptions>, 'logLevel'>;
 //#endregion
-export { UserPlugin as A, AsyncEventEmitter as B, Printer as C, UnknownUserPlugin as D, ResolvePathParams as E, DefineStorage as F, defineStorage as I, formatters as L, KubbEvents as M, PluginManager as N, UserConfig as O, getMode as P, linters as R, PluginWithLifeCycle as S, ResolveNameParams as T, URLPath as V, PluginFactoryOptions as _, Config as a, PluginLifecycleHooks as b, Group as c, Logger as d, LoggerContext as f, PluginContext as g, Plugin as h, BarrelType as i, UserPluginWithLifeCycle as j, UserLogger as k, InputData as l, Output as m, AdapterFactoryOptions as n, DevtoolsOptions as o, LoggerOptions as p, AdapterSource as r, GetPluginFactoryOptions as s, Adapter as t, InputPath as u, PluginKey as v, PrinterFactoryOptions as w, PluginParameter as x, PluginLifecycle as y, logLevel as z };
-//# sourceMappingURL=types-D30QAz2y.d.ts.map
+export { UserPluginWithLifeCycle as A, URLPath as B, PrinterFactoryOptions as C, UserConfig as D, UnknownUserPlugin as E, defineStorage as F, formatters as I, linters as L, PluginManager as M, getMode as N, UserLogger as O, DefineStorage as P, logLevel as R, Printer as S, ResolvePathParams as T, PluginFactoryOptions as _, Config as a, PluginParameter as b, Group as c, Logger as d, LoggerContext as f, PluginContext as g, Plugin as h, BarrelType as i, KubbEvents as j, UserPlugin as k, InputData as l, Output as m, AdapterFactoryOptions as n, DevtoolsOptions as o, LoggerOptions as p, AdapterSource as r, GetPluginFactoryOptions as s, Adapter as t, InputPath as u, PluginLifecycle as v, ResolveNameParams as w, PluginWithLifeCycle as x, PluginLifecycleHooks as y, AsyncEventEmitter as z };
+//# sourceMappingURL=types-B7eZvqwD.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "4.36.1",
+  "version": "5.0.0-alpha.2",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
     "typescript",
@@ -71,7 +71,7 @@
     "remeda": "^2.33.6",
     "semver": "^7.7.4",
     "tinyexec": "^1.0.4",
-    "@kubb/ast": "4.36.1"
+    "@kubb/ast": "5.0.0-alpha.2"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1",
@@ -83,7 +83,7 @@
     "@kubb/react-fabric": "0.13.3"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "publishConfig": {
     "access": "public",

package/src/PluginManager.ts

@@ -51,7 +51,7 @@ type GetFileProps<TOptions = object> = {
   name: string
   mode?: KubbFile.Mode
   extname: KubbFile.Extname
-  pluginKey: Plugin['key']
+  pluginName: string
   options?: TOptions
 }
 
@@ -158,19 +158,19 @@ export class PluginManager {
     return this.#getSortedPlugins()
   }
 
-  getFile<TOptions = object>({ name, mode, extname, pluginKey, options }: GetFileProps<TOptions>): KubbFile.File<{ pluginKey: Plugin['key'] }> {
+  getFile<TOptions = object>({ name, mode, extname, pluginName, options }: GetFileProps<TOptions>): KubbFile.File<{ pluginName: string }> {
     const baseName = `${name}${extname}` as const
-    const path = this.resolvePath({ baseName, mode, pluginKey, options })
+    const path = this.resolvePath({ baseName, mode, pluginName, options })
 
     if (!path) {
-      throw new Error(`Filepath should be defined for resolvedName "${name}" and pluginKey [${JSON.stringify(pluginKey)}]`)
+      throw new Error(`Filepath should be defined for resolvedName "${name}" and pluginName "${pluginName}"`)
     }
 
     return {
       path,
       baseName,
       meta: {
-        pluginKey,
+        pluginName,
       },
       sources: [],
       imports: [],
@@ -182,9 +182,9 @@ export class PluginManager {
     const root = path.resolve(this.config.root, this.config.output.path)
     const defaultPath = path.resolve(root, params.baseName)
 
-    if (params.pluginKey) {
+    if (params.pluginName) {
       const paths = this.hookForPluginSync({
-        pluginKey: params.pluginKey,
+        pluginName: params.pluginName,
         hookName: 'resolvePath',
         parameters: [params.baseName, params.mode, params.options as object],
       })
@@ -201,9 +201,9 @@ export class PluginManager {
   }
   //TODO refactor by using the order of plugins and the cache of the fileManager instead of guessing and recreating the name/path
   resolveName = (params: ResolveNameParams): string => {
-    if (params.pluginKey) {
+    if (params.pluginName) {
       const names = this.hookForPluginSync({
-        pluginKey: params.pluginKey,
+        pluginName: params.pluginName,
         hookName: 'resolveName',
         parameters: [params.name.trim(), params.type],
       })
@@ -225,15 +225,15 @@ export class PluginManager {
    * Run a specific hookName for plugin x.
    */
   async hookForPlugin<H extends PluginLifecycleHooks>({
-    pluginKey,
+    pluginName,
     hookName,
     parameters,
   }: {
-    pluginKey: Plugin['key']
+    pluginName: string
     hookName: H
     parameters: PluginParameter<H>
   }): Promise<Array<ReturnType<ParseResult<H>> | null>> {
-    const plugins = this.getPluginsByKey(hookName, pluginKey)
+    const plugins = this.getPluginsByName(hookName, pluginName)
 
     this.events.emit('plugins:hook:progress:start', {
       hookName,
@@ -264,15 +264,15 @@ export class PluginManager {
    */
 
   hookForPluginSync<H extends PluginLifecycleHooks>({
-    pluginKey,
+    pluginName,
     hookName,
     parameters,
   }: {
-    pluginKey: Plugin['key']
+    pluginName: string
     hookName: H
     parameters: PluginParameter<H>
   }): Array<ReturnType<ParseResult<H>>> | null {
-    const plugins = this.getPluginsByKey(hookName, pluginKey)
+    const plugins = this.getPluginsByName(hookName, pluginName)
 
     const result = plugins
       .map((plugin) => {
@@ -476,41 +476,21 @@ export class PluginManager {
       })
   }
 
-  getPluginByKey(pluginKey: Plugin['key']): Plugin | undefined {
+  getPluginByName(pluginName: string): Plugin | undefined {
     const plugins = [...this.#plugins]
-    const [searchPluginName] = pluginKey
 
-    return plugins.find((item) => {
-      const [name] = item.key
-
-      return name === searchPluginName
-    })
+    return plugins.find((item) => item.name === pluginName)
   }
 
-  getPluginsByKey(hookName: keyof PluginWithLifeCycle, pluginKey: Plugin['key']): Plugin[] {
+  getPluginsByName(hookName: keyof PluginWithLifeCycle, pluginName: string): Plugin[] {
     const plugins = [...this.plugins]
-    const [searchPluginName, searchIdentifier] = pluginKey
-
-    const pluginByPluginName = plugins
-      .filter((plugin) => hookName in plugin)
-      .filter((item) => {
-        const [name, identifier] = item.key
-
-        const identifierCheck = identifier?.toString() === searchIdentifier?.toString()
-        const nameCheck = name === searchPluginName
 
-        if (searchIdentifier) {
-          return identifierCheck && nameCheck
-        }
-
-        return nameCheck
-      })
+    const pluginByPluginName = plugins.filter((plugin) => hookName in plugin).filter((item) => item.name === pluginName)
 
     if (!pluginByPluginName?.length) {
       // fallback on the core plugin when there is no match
 
       const corePlugin = plugins.find((plugin) => plugin.name === CORE_PLUGIN_NAME && hookName in plugin)
-      // Removed noisy debug logs for missing hooks - these are expected behavior, not errors
 
       return corePlugin ? [corePlugin] : []
     }
@@ -657,20 +637,16 @@ export class PluginManager {
 
     setUniqueName(plugin.name, usedPluginNames)
 
-    // Emit warning if this is a duplicate plugin (will be removed in v5)
     const usageCount = usedPluginNames[plugin.name]
     if (usageCount && usageCount > 1) {
-      this.events.emit(
-        'warn',
-        `Multiple instances of plugin "${plugin.name}" detected. This behavior is deprecated and will be removed in v5.`,
-        `Plugin key: [${plugin.name}, ${usageCount}]`,
+      throw new ValidationPluginError(
+        `Duplicate plugin "${plugin.name}" detected. Each plugin can only be used once. Use a different configuration instead of adding multiple instances of the same plugin.`,
       )
     }
 
     return {
       install() {},
       ...plugin,
-      key: [plugin.name, usedPluginNames[plugin.name]].filter(Boolean) as [typeof plugin.name, string],
     } as unknown as Plugin
   }
 }

package/src/build.ts

@@ -246,7 +246,7 @@ export async function safeBuild(options: BuildOptions, overrides?: SetupResult):
 
         await events.emit('debug', {
           date: timestamp,
-          logs: ['Installing plugin...', `  • Plugin Key: [${plugin.key.join(', ')}]`],
+          logs: ['Installing plugin...', `  • Plugin Name: ${plugin.name}`],
         })
 
         await installer(context)
@@ -275,7 +275,7 @@ export async function safeBuild(options: BuildOptions, overrides?: SetupResult):
           date: errorTimestamp,
           logs: [
             '✗ Plugin installation failed',
-            `  • Plugin Key: ${JSON.stringify(plugin.key)}`,
+            `  • Plugin Name: ${plugin.name}`,
             `  • Error: ${error.constructor.name} - ${error.message}`,
             '  • Stack Trace:',
             error.stack || 'No stack trace available',
@@ -361,9 +361,9 @@ type BuildBarrelExportsParams = {
 }
 
 function buildBarrelExports({ barrelFiles, rootDir, existingExports, config, pluginManager }: BuildBarrelExportsParams): KubbFile.Export[] {
-  const pluginKeyMap = new Map<string, Plugin>()
+  const pluginNameMap = new Map<string, Plugin>()
   for (const plugin of pluginManager.plugins) {
-    pluginKeyMap.set(JSON.stringify(plugin.key), plugin)
+    pluginNameMap.set(plugin.name, plugin)
   }
 
   return barrelFiles.flatMap((file) => {
@@ -375,7 +375,7 @@ function buildBarrelExports({ barrelFiles, rootDir, existingExports, config, plu
       }
 
       const meta = file.meta as FileMetaBase | undefined
-      const plugin = meta?.pluginKey ? pluginKeyMap.get(JSON.stringify(meta.pluginKey)) : undefined
+      const plugin = meta?.pluginName ? pluginNameMap.get(meta.pluginName) : undefined
       const pluginOptions = plugin?.options as { output?: Output<unknown> } | undefined
 
       if (!pluginOptions || pluginOptions.output?.barrelType === false) {

package/src/types.ts

@@ -255,7 +255,7 @@ export type Config<TInput = Input> = {
 
 export type PluginFactoryOptions<
   /**
-   * Name to be used for the plugin, this will also be used for they key.
+   * Name to be used for the plugin.
    */
   TName extends string = string,
   /**
@@ -276,18 +276,12 @@ export type PluginFactoryOptions<
   TResolvePathOptions extends object = object,
 > = {
   name: TName
-  /**
-   * Same behavior like what has been done with `QueryKey` in `@tanstack/react-query`
-   */
-  key: PluginKey<TName | string>
   options: TOptions
   resolvedOptions: TResolvedOptions
   context: TContext
   resolvePathOptions: TResolvePathOptions
 }
 
-export type PluginKey<TName> = [name: TName, identifier?: string | number]
-
 export type GetPluginFactoryOptions<TPlugin extends UserPlugin> = TPlugin extends UserPlugin<infer X> ? X : never
 
 export type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions> = {
@@ -323,11 +317,6 @@ export type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
    * @example @kubb/typescript
    */
   name: TOptions['name']
-  /**
-   * Internal key used when a developer uses more than one of the same plugin
-   * @private
-   */
-  key: TOptions['key']
   /**
    * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin is executed after these plugins.
    * Can be used to validate dependent plugins.
@@ -378,7 +367,7 @@ export type PluginLifecycleHooks = keyof PluginLifecycle
 export type PluginParameter<H extends PluginLifecycleHooks> = Parameters<Required<PluginLifecycle>[H]>
 
 export type ResolvePathParams<TOptions = object> = {
-  pluginKey?: Plugin['key']
+  pluginName?: string
   baseName: KubbFile.BaseName
   mode?: KubbFile.Mode
   /**
@@ -389,7 +378,7 @@ export type ResolvePathParams<TOptions = object> = {
 
 export type ResolveNameParams = {
   name: string
-  pluginKey?: Plugin['key']
+  pluginName?: string
   /**
    * Specifies the type of entity being named.
    * - 'file' customizes the name of the created file (uses camelCase).

package/src/utils/getBarrelFiles.ts

@@ -1,10 +1,10 @@
 import { join } from 'node:path'
 import type { KubbFile } from '@kubb/fabric-core/types'
 import { BarrelManager } from '../BarrelManager.ts'
-import type { BarrelType, Plugin } from '../types.ts'
+import type { BarrelType } from '../types.ts'
 
 export type FileMetaBase = {
-  pluginKey?: Plugin['key']
+  pluginName?: string
 }
 
 type AddIndexesProps = {