@kubb/core 4.11.3 → 4.12.0

package/src/build.ts

@@ -1,27 +1,22 @@
-import { join, relative, resolve } from 'node:path'
+import { join, resolve } from 'node:path'
 import { performance } from 'node:perf_hooks'
 import type { KubbFile } from '@kubb/fabric-core/types'
 import type { Fabric } from '@kubb/react-fabric'
 import { createFabric } from '@kubb/react-fabric'
 import { typescriptParser } from '@kubb/react-fabric/parsers'
 import { fsPlugin } from '@kubb/react-fabric/plugins'
-import pc from 'picocolors'
 import { isDeepEqual } from 'remeda'
 import { isInputPath } from './config.ts'
 import { clean, exists, getRelativePath, write } from './fs/index.ts'
-import type { Logger } from './logger.ts'
-import { createLogger } from './logger.ts'
 import { PluginManager } from './PluginManager.ts'
-import type { Config, Output, Plugin, UserConfig } from './types.ts'
+import type { Config, KubbEvents, Output, Plugin, UserConfig } from './types.ts'
+import { AsyncEventEmitter } from './utils/AsyncEventEmitter.ts'
 import { getDiagnosticInfo } from './utils/diagnostics.ts'
 import { URLPath } from './utils/URLPath.ts'
 
 type BuildOptions = {
   config: UserConfig
-  /**
-   * @default Logger without the spinner
-   */
-  logger?: Logger
+  events?: AsyncEventEmitter<KubbEvents>
 }
 
 type BuildOutput = {
@@ -34,23 +29,22 @@ type BuildOutput = {
 }
 
 type SetupResult = {
-  logger: Logger
+  events: AsyncEventEmitter<KubbEvents>
   fabric: Fabric
   pluginManager: PluginManager
 }
 
 export async function setup(options: BuildOptions): Promise<SetupResult> {
-  const { config: userConfig, logger = createLogger() } = options
+  const { config: userConfig, events = new AsyncEventEmitter<KubbEvents>() } = options
 
   const diagnosticInfo = getDiagnosticInfo()
 
   if (Array.isArray(userConfig.input)) {
-    console.warn(pc.yellow('This feature is still under development — use with caution'))
+    await events.emit('warn', 'This feature is still under development — use with caution')
   }
 
-  logger.emit('debug', {
+  await events.emit('debug', {
     date: new Date(),
-    category: 'setup',
     logs: [
       'Configuration:',
       `  • Name: ${userConfig.name || 'unnamed'}`,
@@ -72,9 +66,8 @@ export async function setup(options: BuildOptions): Promise<SetupResult> {
     if (isInputPath(userConfig) && !new URLPath(userConfig.input.path).isURL) {
       await exists(userConfig.input.path)
 
-      logger.emit('debug', {
+      await events.emit('debug', {
         date: new Date(),
-        category: 'setup',
         logs: [`✓ Input file validated: ${userConfig.input.path}`],
       })
     }
@@ -107,9 +100,8 @@ export async function setup(options: BuildOptions): Promise<SetupResult> {
   }
 
   if (definedConfig.output.clean) {
-    logger.emit('debug', {
+    await events.emit('debug', {
       date: new Date(),
-      category: 'setup',
       logs: ['Cleaning output directories', `  • Output: ${definedConfig.output.path}`, '  • Cache: .kubb'],
     })
     await clean(definedConfig.output.path)
@@ -120,36 +112,33 @@ export async function setup(options: BuildOptions): Promise<SetupResult> {
   fabric.use(fsPlugin, { dryRun: !definedConfig.output.write })
   fabric.use(typescriptParser)
 
-  fabric.context.on('process:start', ({ files }) => {
-    logger.emit('progress_start', { id: 'files', size: files.length, message: 'Writing files ...' })
-    logger.emit('debug', {
+  fabric.context.on('files:processing:start', (files) => {
+    events.emit('files:processing:start', files)
+    events.emit('debug', {
       date: new Date(),
-      category: 'file',
       logs: [`Writing ${files.length} files...`],
     })
   })
 
-  fabric.context.on('process:progress', async ({ file, source }) => {
-    const message = file ? `Writing ${relative(definedConfig.root, file.path)}` : ''
-    logger.emit('progressed', { id: 'files', message })
+  fabric.context.on('file:processing:update', async (params) => {
+    const { file, source } = params
+    await events.emit('file:processing:update', { ...params, config: definedConfig, source })
 
     if (source) {
       await write(file.path, source, { sanity: false })
     }
   })
 
-  fabric.context.on('process:end', () => {
-    logger.emit('progress_stop', { id: 'files' })
-    logger.emit('debug', {
+  fabric.context.on('files:processing:end', async (files) => {
+    await events.emit('files:processing:end', files)
+    await events.emit('debug', {
       date: new Date(),
-      category: 'file',
       logs: ['✓ File write process completed'],
     })
   })
 
-  logger.emit('debug', {
+  await events.emit('debug', {
     date: new Date(),
-    category: 'setup',
     logs: [
       '✓ Fabric initialized',
       `  • File writing: ${definedConfig.output.write ? 'enabled' : 'disabled (dry-run)'}`,
@@ -157,78 +146,14 @@ export async function setup(options: BuildOptions): Promise<SetupResult> {
     ],
   })
 
-  const pluginManager = new PluginManager(definedConfig, { fabric, logger, concurrency: 5 })
-
-  pluginManager.on('executing', ({ plugin, hookName, strategy, parameters }) => {
-    logger.emit('debug', {
-      date: new Date(),
-      category: 'hook',
-      pluginName: plugin.name,
-      logs: [`Executing hook: ${hookName}`, `  • Strategy: ${strategy}`, '  • Parameters:', JSON.stringify(parameters, null, 2)],
-    })
-  })
-
-  pluginManager.on('executed', ({ plugin, hookName, duration, parameters }) => {
-    let message = ''
-    if (hookName === 'resolvePath') {
-      const [path] = parameters || []
-      message = `Resolving path '${path}'`
-    }
-
-    if (hookName === 'resolveName') {
-      const [name, type] = parameters || []
-      message = `Resolving name '${name}' and type '${type}'`
-    }
-
-    logger.emit('progressed', {
-      id: hookName,
-      message: `${plugin.name}: ${message}`,
-    })
-    logger.emit('debug', {
-      date: new Date(),
-      category: 'hook',
-      pluginName: plugin.name,
-      logs: [`✓ Completed in ${duration}ms`],
-    })
-  })
-
-  pluginManager.on('progress_start', ({ hookName, plugins }) => {
-    logger.emit('progress_start', { id: hookName, size: plugins.length, message: 'Running plugins...' })
-  })
-
-  pluginManager.on('progress_stop', ({ hookName }) => {
-    logger.emit('progress_stop', { id: hookName })
-  })
-
-  pluginManager.on('error', (error, { plugin, strategy, duration, parameters, hookName }) => {
-    const text = `${error.message} (plugin: ${plugin?.name || 'unknown'}, hook: ${hookName || 'unknown'})`
-
-    logger.emit('error', text, error)
-
-    logger.emit('debug', {
-      date: new Date(),
-      category: 'error',
-      pluginName: plugin.name,
-      logs: [
-        `✗ Hook '${hookName}' failed after ${duration}ms`,
-        `  • Strategy: ${strategy}`,
-        `  • Error: ${error.constructor.name} - ${error.message}`,
-        '  • Stack Trace:',
-        error.stack || 'No stack trace available',
-        '  • Parameters:',
-        JSON.stringify(parameters, null, 2),
-      ],
-    })
-  })
-
-  logger.emit('debug', {
-    date: new Date(),
-    category: 'setup',
-    logs: ['✓ PluginManager initialized', '  • Concurrency: 5', `  • Total plugins: ${pluginManager.plugins.length}`],
+  const pluginManager = new PluginManager(definedConfig, {
+    fabric,
+    events,
+    concurrency: 5,
   })
 
   return {
-    logger,
+    events,
     fabric,
     pluginManager,
   }
@@ -252,7 +177,7 @@ export async function build(options: BuildOptions, overrides?: SetupResult): Pro
 }
 
 export async function safeBuild(options: BuildOptions, overrides?: SetupResult): Promise<BuildOutput> {
-  const { fabric, pluginManager, logger } = overrides ? overrides : await setup(options)
+  const { fabric, pluginManager, events } = overrides ? overrides : await setup(options)
 
   const failedPlugins = new Set<{ plugin: Plugin; error: Error }>()
   const pluginTimings = new Map<string, number>()
@@ -268,18 +193,10 @@ export async function safeBuild(options: BuildOptions, overrides?: SetupResult):
         const startTime = performance.now()
         const timestamp = new Date()
 
-        // Start plugin group
-        logger.emit('debug', {
-          date: timestamp,
-          pluginGroupMarker: 'start',
-          pluginName: plugin.name,
-          logs: [],
-        })
+        await events.emit('plugin:start', plugin)
 
-        logger.emit('debug', {
+        await events.emit('debug', {
           date: timestamp,
-          category: 'plugin',
-          pluginName: plugin.name,
           logs: ['Installing plugin...', `  • Plugin Key: ${JSON.stringify(plugin.key)}`],
         })
 
@@ -288,28 +205,18 @@ export async function safeBuild(options: BuildOptions, overrides?: SetupResult):
         const duration = Math.round(performance.now() - startTime)
         pluginTimings.set(plugin.name, duration)
 
-        logger.emit('debug', {
-          date: new Date(),
-          category: 'plugin',
-          pluginName: plugin.name,
-          logs: [`✓ Plugin installed successfully (${duration}ms)`],
-        })
+        await events.emit('plugin:end', plugin, duration)
 
-        // End plugin group
-        logger.emit('debug', {
+        await events.emit('debug', {
           date: new Date(),
-          pluginGroupMarker: 'end',
-          pluginName: plugin.name,
-          logs: [],
+          logs: [`✓ Plugin installed successfully (${duration}ms)`],
         })
       } catch (e) {
         const error = e as Error
         const errorTimestamp = new Date()
 
-        logger.emit('debug', {
+        await events.emit('debug', {
           date: errorTimestamp,
-          category: 'error',
-          pluginName: plugin.name,
           logs: [
             '✗ Plugin installation failed',
             `  • Plugin Key: ${JSON.stringify(plugin.key)}`,
@@ -319,14 +226,6 @@ export async function safeBuild(options: BuildOptions, overrides?: SetupResult):
           ],
         })
 
-        // End plugin group even on error
-        logger.emit('debug', {
-          date: errorTimestamp,
-          pluginGroupMarker: 'end',
-          pluginName: plugin.name,
-          logs: [],
-        })
-
         failedPlugins.add({ plugin, error })
       }
     }
@@ -335,7 +234,7 @@ export async function safeBuild(options: BuildOptions, overrides?: SetupResult):
       const root = resolve(config.root)
       const rootPath = resolve(root, config.output.path, 'index.ts')
 
-      logger.emit('debug', {
+      await events.emit('debug', {
         date: new Date(),
         logs: ['Generating barrel file', `  • Type: ${config.output.barrelType}`, `  • Path: ${rootPath}`],
       })
@@ -344,7 +243,7 @@ export async function safeBuild(options: BuildOptions, overrides?: SetupResult):
         return file.sources.some((source) => source.isIndexable)
       })
 
-      logger.emit('debug', {
+      await events.emit('debug', {
         date: new Date(),
         logs: [`Found ${barrelFiles.length} indexable files for barrel export`],
       })
@@ -367,7 +266,9 @@ export async function safeBuild(options: BuildOptions, overrides?: SetupResult):
                   const meta = file.meta as any
                   return isDeepEqual(item.key, meta?.pluginKey)
                 })
-                const pluginOptions = plugin?.options as { output?: Output<any> }
+                const pluginOptions = plugin?.options as {
+                  output?: Output<any>
+                }
 
                 if (!pluginOptions || pluginOptions?.output?.barrelType === false) {
                   return undefined
@@ -388,9 +289,8 @@ export async function safeBuild(options: BuildOptions, overrides?: SetupResult):
 
       await fabric.upsertFile(rootFile)
 
-      logger.emit('debug', {
+      await events.emit('debug', {
         date: new Date(),
-        category: 'file',
         logs: [`✓ Generated barrel file (${rootFile.exports?.length || 0} exports)`],
       })
     }

package/src/defineLogger.ts

@@ -0,0 +1,7 @@
+import type { Logger, LoggerOptions, UserLogger } from './types.ts'
+
+export function defineLogger<Options extends LoggerOptions = LoggerOptions>(logger: UserLogger<Options>): Logger<Options> {
+  return {
+    ...logger,
+  }
+}

package/src/index.ts

@@ -1,10 +1,11 @@
 export { BaseGenerator } from './BaseGenerator.ts'
 export { build, build as default, safeBuild, setup } from './build.ts'
 export { type CLIOptions, defineConfig, isInputPath } from './config.ts'
+export { defineLogger } from './defineLogger.ts'
 export { definePlugin } from './definePlugin.ts'
 export { PackageManager } from './PackageManager.ts'
 export { getMode, PluginManager } from './PluginManager.ts'
 export { PromiseManager } from './PromiseManager.ts'
-export type * from './types.ts'
+export * from './types.ts'
 export type { FileMetaBase } from './utils/getBarrelFiles.ts'
 export { getBarrelFiles } from './utils/getBarrelFiles.ts'

package/src/types.ts

@@ -1,7 +1,8 @@
 import type { KubbFile } from '@kubb/fabric-core/types'
 import type { Fabric } from '@kubb/react-fabric'
-import type { Logger } from './logger.ts'
+import type { KubbEvents } from './Kubb.ts'
 import type { PluginManager } from './PluginManager.ts'
+import type { AsyncEventEmitter } from './utils/AsyncEventEmitter.ts'
 import type { PossiblePromise } from './utils/types.ts'
 
 declare global {
@@ -299,7 +300,7 @@ export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryO
    * merging multiple sources into the same output file
    */
   upsertFile: (...file: Array<KubbFile.File>) => Promise<void>
-  logger: Logger
+  events: AsyncEventEmitter<KubbEvents>
   mode: KubbFile.Mode
   /**
    * Current plugin
@@ -343,3 +344,35 @@ export type Group = {
    */
   name?: (context: GroupContext) => string
 }
+
+export const LogLevel = {
+  silent: Number.NEGATIVE_INFINITY,
+  error: 0,
+  warn: 1,
+  info: 3,
+  verbose: 4,
+  debug: 5,
+} as const
+
+export type LoggerOptions = {
+  /**
+   * @default 3
+   */
+  logLevel: (typeof LogLevel)[keyof typeof LogLevel]
+}
+
+/**
+ * Shared context passed to all plugins, parsers, and Fabric internals.
+ */
+export interface LoggerContext extends AsyncEventEmitter<KubbEvents> {}
+
+type Install<TOptions = unknown> = (context: LoggerContext, options?: TOptions) => void | Promise<void>
+
+export type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
+  name: string
+  install: Install<TOptions>
+}
+
+export type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Omit<Logger<TOptions>, 'logLevel'>
+
+export type { KubbEvents } from './Kubb.ts'

package/src/utils/getBarrelFiles.ts

@@ -1,7 +1,6 @@
 import { join } from 'node:path'
 import type { KubbFile } from '@kubb/fabric-core/types'
 import { BarrelManager } from '../BarrelManager.ts'
-import type { Logger } from '../logger.ts'
 import type { BarrelType, Plugin } from '../types.ts'
 
 export type FileMetaBase = {
@@ -24,7 +23,6 @@ type AddIndexesProps = {
     output: string
     exportAs: string
   }
-  logger?: Logger
 
   meta?: FileMetaBase
 }
@@ -33,25 +31,24 @@ function trimExtName(text: string): string {
   return text.replace(/\.[^/.]+$/, '')
 }
 
-export async function getBarrelFiles(
-  files: Array<KubbFile.ResolvedFile>,
-  { type, meta = {}, root, output, logger }: AddIndexesProps,
-): Promise<KubbFile.File[]> {
+export async function getBarrelFiles(files: Array<KubbFile.ResolvedFile>, { type, meta = {}, root, output }: AddIndexesProps): Promise<KubbFile.File[]> {
   if (!type || type === 'propagate') {
     return []
   }
 
-  const barrelManager = new BarrelManager({ logger })
+  const barrelManager = new BarrelManager({})
 
   const pathToBuildFrom = join(root, output.path)
 
   if (trimExtName(pathToBuildFrom).endsWith('index')) {
-    logger?.emit('warning', 'Output has the same fileName as the barrelFiles, please disable barrel generation')
-
     return []
   }
 
-  const barrelFiles = barrelManager.getFiles({ files, root: pathToBuildFrom, meta })
+  const barrelFiles = barrelManager.getFiles({
+    files,
+    root: pathToBuildFrom,
+    meta,
+  })
 
   if (type === 'all') {
     return barrelFiles.map((file) => {

package/src/utils/index.ts

@@ -1,3 +1,4 @@
+export { AsyncEventEmitter } from './AsyncEventEmitter.ts'
 export { buildJSDoc } from './buildJSDoc.ts'
 export { Cache } from './Cache.ts'
 export type { FunctionParamsAST } from './FunctionParams.ts'

package/dist/EventEmitter-BwU6Ixxt.cjs

@@ -1,31 +0,0 @@
-const require_chunk = require('./chunk-CbDLau6x.cjs');
-let node_events = require("node:events");
-
-//#region src/utils/EventEmitter.ts
-var EventEmitter = class {
-	constructor() {
-		this.#emitter.setMaxListeners(100);
-	}
-	#emitter = new node_events.EventEmitter();
-	emit(eventName, ...eventArg) {
-		this.#emitter.emit(eventName, ...eventArg);
-	}
-	on(eventName, handler) {
-		this.#emitter.on(eventName, handler);
-	}
-	off(eventName, handler) {
-		this.#emitter.off(eventName, handler);
-	}
-	removeAll() {
-		this.#emitter.removeAllListeners();
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'EventEmitter', {
-  enumerable: true,
-  get: function () {
-    return EventEmitter;
-  }
-});
-//# sourceMappingURL=EventEmitter-BwU6Ixxt.cjs.map

package/dist/EventEmitter-BwU6Ixxt.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"EventEmitter-BwU6Ixxt.cjs","names":["#emitter","NodeEventEmitter"],"sources":["../src/utils/EventEmitter.ts"],"sourcesContent":["import { EventEmitter as NodeEventEmitter } from 'node:events'\n\nexport class EventEmitter<TEvents extends Record<string, any>> {\n  constructor() {\n    this.#emitter.setMaxListeners(100)\n  }\n  #emitter = new NodeEventEmitter()\n\n  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArg: TEvents[TEventName]): void {\n    this.#emitter.emit(eventName, ...(eventArg as any))\n  }\n\n  on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: (...eventArg: TEvents[TEventName]) => void): void {\n    this.#emitter.on(eventName, handler as any)\n  }\n\n  off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: (...eventArg: TEvents[TEventName]) => void): void {\n    this.#emitter.off(eventName, handler as any)\n  }\n  removeAll(): void {\n    this.#emitter.removeAllListeners()\n  }\n}\n"],"mappings":";;;;AAEA,IAAa,eAAb,MAA+D;CAC7D,cAAc;AACZ,QAAKA,QAAS,gBAAgB,IAAI;;CAEpC,WAAW,IAAIC,0BAAkB;CAEjC,KAAgD,WAAuB,GAAG,UAAqC;AAC7G,QAAKD,QAAS,KAAK,WAAW,GAAI,SAAiB;;CAGrD,GAA8C,WAAuB,SAA2D;AAC9H,QAAKA,QAAS,GAAG,WAAW,QAAe;;CAG7C,IAA+C,WAAuB,SAA2D;AAC/H,QAAKA,QAAS,IAAI,WAAW,QAAe;;CAE9C,YAAkB;AAChB,QAAKA,QAAS,oBAAoB"}

package/dist/EventEmitter-DlzW04T3.js

@@ -1,25 +0,0 @@
-import { EventEmitter } from "node:events";
-
-//#region src/utils/EventEmitter.ts
-var EventEmitter$1 = class {
-	constructor() {
-		this.#emitter.setMaxListeners(100);
-	}
-	#emitter = new EventEmitter();
-	emit(eventName, ...eventArg) {
-		this.#emitter.emit(eventName, ...eventArg);
-	}
-	on(eventName, handler) {
-		this.#emitter.on(eventName, handler);
-	}
-	off(eventName, handler) {
-		this.#emitter.off(eventName, handler);
-	}
-	removeAll() {
-		this.#emitter.removeAllListeners();
-	}
-};
-
-//#endregion
-export { EventEmitter$1 as t };
-//# sourceMappingURL=EventEmitter-DlzW04T3.js.map

package/dist/EventEmitter-DlzW04T3.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"EventEmitter-DlzW04T3.js","names":["EventEmitter","#emitter","NodeEventEmitter"],"sources":["../src/utils/EventEmitter.ts"],"sourcesContent":["import { EventEmitter as NodeEventEmitter } from 'node:events'\n\nexport class EventEmitter<TEvents extends Record<string, any>> {\n  constructor() {\n    this.#emitter.setMaxListeners(100)\n  }\n  #emitter = new NodeEventEmitter()\n\n  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArg: TEvents[TEventName]): void {\n    this.#emitter.emit(eventName, ...(eventArg as any))\n  }\n\n  on<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: (...eventArg: TEvents[TEventName]) => void): void {\n    this.#emitter.on(eventName, handler as any)\n  }\n\n  off<TEventName extends keyof TEvents & string>(eventName: TEventName, handler: (...eventArg: TEvents[TEventName]) => void): void {\n    this.#emitter.off(eventName, handler as any)\n  }\n  removeAll(): void {\n    this.#emitter.removeAllListeners()\n  }\n}\n"],"mappings":";;;AAEA,IAAaA,iBAAb,MAA+D;CAC7D,cAAc;AACZ,QAAKC,QAAS,gBAAgB,IAAI;;CAEpC,WAAW,IAAIC,cAAkB;CAEjC,KAAgD,WAAuB,GAAG,UAAqC;AAC7G,QAAKD,QAAS,KAAK,WAAW,GAAI,SAAiB;;CAGrD,GAA8C,WAAuB,SAA2D;AAC9H,QAAKA,QAAS,GAAG,WAAW,QAAe;;CAG7C,IAA+C,WAAuB,SAA2D;AAC/H,QAAKA,QAAS,IAAI,WAAW,QAAe;;CAE9C,YAAkB;AAChB,QAAKA,QAAS,oBAAoB"}

package/dist/chunk-CbDLau6x.cjs

@@ -1,34 +0,0 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});