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"> {
  dto?: OperationDtoMap<...>;          // per-slot DTO overrides: create/update/patch/query/item/list
  allowed?: QueryAllowed<Entity>; // filterable/sortable/selectable field allowlists
  operations?: Partial<Record<StandardOperationId, OperationConfig<Entity> | boolean>>;
}

• dto — override any of the bare-verb DTO slots (create, update, patch, query, item, list). 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.