kavo-decorator

@Kavo() reference

@Kavo(Entity, config?) (packages/frameworks/nest/src/kavo.decorator.ts) is a class decorator that builds the entity's operation registry at class-decoration time and generates one Nest route per enabled entry:

@Kavo(UserEntity)
@Controller("users")
export class UserController {}

The bound DefaultKavoService<Entity> arrives later, via property injection at onModuleInit (KavoBinder) — not through the constructor. Reach it with boundKavoService(this), never constructor injection, inside a @Kavo-decorated class.

Full detail: docs/internals/architecture/10-nestjs-integration.md.

Generated routes

restoreOne/purgeOne are off by default and turned on by config (delete: { strategy: "soft" } enables restore; operations: { purgeOne: true } enables purge) — decoration time has no ORM metadata to auto-detect them from.

config — the second argument (EntityConfig<Entity>)

interface EntityConfig<Entity, CreateDto, UpdateDto, PatchDto, QueryDto, ItemDto, ListDto>
  extends Omit<DeepPartial<KavoSettings>, "operations"> {
  schema?: EntitySchema<...>;          // { input: { create/update/patch/query }, output: { item/list } }; class or validator per slot
  allowed?: QueryAllowed<Entity>; // filterable/sortable/selectable field allowlists
  operations?: Partial<Record<StandardOperationId, OperationConfig<Entity> | boolean>>;
}

• schema — configure any of the bare-verb slots (input.create/update/ patch/query, output.item/list) with a DTO class or a validator. Omitted slots derive from the entity.
• allowed — see below.
• operations.<id> — false disables the operation (no route, no service method reachable); true enables one that is off by default (purgeOne, restoreOne). The long form, { enabled?, handler?, meta? }, additionally lets you swap the OperationHandler or supply route meta (method, path, successStatus, or enabled: false to keep it service-only).
• Settings keys (pagination, limits, search, errors, relations, delete, bulk) inherited from DeepPartial<KavoSettings> override the global default for this entity only — see the global-config skill for the precedence chain these merge through, and the sections below for what relations configures.