Cursor rule

1---
2description: Jest tests, mocks, reports, and environments for @contentstack/utils
3globs:
4  - __test__/**/*.ts
5alwaysApply: false
6---
7 
8# Testing — `@contentstack/utils`
9 
10## Framework
11 
12- **Jest 29** with **`ts-jest`** preset (`jest.config.ts`).
13- **Environment:** **`jsdom`** (suitable for HTML string assertions and DOM-related behavior).
14 
15## Discovery and naming
16 
17- **Pattern:** `**/__test__/**/?(*.)+(spec|test).[jt]s?(x)` — this repo uses `*.test.ts` under **`__test__/`**.
18- **Mocks / fixtures:** `__test__/mock/*.ts` — follow existing mock naming (`*-mock.ts`).
19 
20## Coverage and reports
21 
22- **Coverage** is collected from `src/**` excluding `src/index.ts` (`collectCoverageFrom`).
23- Outputs: **`reports/coverage/`**, **`reports/html/`** (jest-html-reporters), **`reports/junit/`** (jest-junit), **`reports/report.json`** (from `npm test` script).
24 
25## Running tests
26 
27| Command | Behavior |
28|---------|----------|
29| `npm test` | Runs **`pretest` → build** then Jest (CI-aligned). |
30| `npm run test:debug` | Watch mode, `--runInBand`. |
31 
32## Integration / live tests
33 
34- **None** in this repo. No `.env` or stack credentials required for **`npm test`**.
35 
36## Build dependency
37 
38- **`npm test` always builds first** (`pretest`). Ensure **`src/assets/regions.json`** exists or can be downloaded so `endpoints` tests pass.
39