Cursor rule

1---
2description: TypeScript conventions for @contentstack/utils (src and tests)
3globs:
4  - src/**/*.ts
5  - __test__/**/*.ts
6alwaysApply: false
7---
8 
9# TypeScript — `@contentstack/utils`
10 
11## Tooling
12 
13- **TypeScript ~4.9** (`package.json`, `tsconfig.json`).
14- **Bundler output:** `tsc` emits to `dist/lib` with declarations in `dist/types`; **Rollup** produces `dist/index.es.js` (`rollup.config.js`).
15- **Strict mode** is on with **`strictNullChecks: false`** — new code should still minimize unnecessary null/undefined gaps when touching APIs.
16 
17## Layout
18 
19- **Library code:** `src/**/*.ts` only (`tsconfig.json` `include`); **tests** are under `__test__/` (excluded from `tsc` program but type-checked via Jest/tsconfig paths).
20- **Public exports:** Maintain **`src/index.ts`** as the single export surface unless intentionally adding secondary entry points.
21 
22## Style and lint
23 
24- Match existing naming (PascalCase types, camelCase functions, existing file layout under `Models/`, `nodes/`, `helper/`, `options/`).
25- **ESLint** flat config: `eslint.config.js` — `@typescript-eslint` recommended for `__test__`; source files use `js.configs.recommended` baseline.
26- **Prettier:** `npm run format` scopes `src/**/*.ts`; keep formatting consistent when editing tests too.
27 
28## JSON / assets
29 
30- **`src/assets/regions.json`:** Consumed by `src/endpoints.ts`; populated by **`npm run download-regions`** during `prebuild`. Do not assume the file is committed (see root `.gitignore`).
31 
32## Logging
33 
34- No shared logger dependency; avoid introducing `console` noise in library paths unless consistent with nearby code.
35