中文
← Errors

F_SYSTEM_UNKNOWN_HANDLER

Unknown registered handler

A class registered with the application does not carry any func command or error-handler metadata.

Updated 2 weeks ago

Reproduction

Plain classes cannot be placed directly in FuncModule.commands:

src/app.module.ts
import { FuncModule, run } from 'func'

class PlainClass {}

@FuncModule({ commands: [PlainClass] })
class AppModule {}

run(AppModule)

What this error means

The registration list contains a class that func cannot classify as a named command, major command, missing-command handler, or global error handler. The details.handlers array contains the class names that failed validation.

How to fix it

Add the appropriate func decorator to every registered command class, such as @Command(), @CommandMajor(), @CommandMissing(), or @CatchAll(). If the class is a reusable dependency instead of a command, mark it with @Service() and move it to FuncModule.services.