kickjs-write-controller-test
Use when adding a Vitest test that exercises an HTTP route or DI graph.
Informations de source
- Dépôt
- forinda/tasky
- Dernière activité de la source
- 6 août 2026 à 16:02
- Langue détectée de SKILL.md
- anglais
- Étoiles
- 0
- Forks
- 1
Options d'installation
Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.
Vérifiez les fichiers source
Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.
Affichage de SKILL.md
SKILL.md
Instructions source · Aperçu en lecture seule- name
- kickjs-write-controller-test
- description
- Use when adding a Vitest test that exercises an HTTP route or DI graph.
<!-- Generated by `kick g agents` for adero-api. Edits are overwritten on the next refresh; keep customisation in a SKILL.local.md alongside. -->
**Template** (copy/paste, adjust):
```ts
import { describe, it, expect, beforeEach } from 'vitest'
import { Container } from '@forinda/kickjs'
import { createTestApp } from '@forinda/kickjs-testing'
beforeEach(() => {
Container.reset() // isolated DI per test
})
describe('UserController', () => {
it('returns users', async () => {
const app = await createTestApp([UserModule])
const res = await app.get('/api/v1/users')
expect(res.status).toBe(200)
})
})
```
**Typed handler signature** — pair with `kick typegen` so `ctx.body` / `params` / `query` are typed by the route's Zod schema:
```ts
@Post('/', { body: createTodoSchema })
async create(ctx: Ctx<KickRoutes.TodoController['create']>) {
// ctx.body is typed from createTodoSchema; ctx.params from the route.
// Returning (vs ctx.created) lets typegen infer the response type.
return reply(201, await this.service.create(ctx.body))
}
```
**Red flags**:
- `new Container()` — wrong; use `Container.reset()` in `beforeEach` or `Container.create()` for fully isolated graphs.
- `Container.getInstance().reset()` — wrong; same fix.
- Sharing a container instance across `it()` blocks — leaks registrations between tests.
- Injecting a `Scope.REQUEST` service into a `SINGLETON` — container throws at resolve. Singletons must resolve request-scoped services explicitly per call.
- Calling `getRequestValue<string>('traceId')` — the generic slot is the **key** type, not the value type; widens key and bypasses typed lookup.
- Asserting on `res.body.requestId` when `requestId()` middleware isn't mounted in the test app — value will be `undefined`.
- Using `Scope.REQUEST` services in a test without mounting `requestScopeMiddleware()` — `getRequestValue` silently returns `undefined`; `getRequestStore` throws.
**Nuances**:
- `@Inject` and `@Autowired` are interchangeable — same runtime, same types; pick by readability.
- `@Value('MISSING_KEY')` with no default **throws on property access**, not at construction — tests that exercise the getter will surface the missing-env issue.
Voir sur GitHub