Cursor rule

1---
2description: "JavaScript/TypeScript conventions for src, webpack, and index.d.ts"
3globs:
4  - "src/**/*.js"
5  - "webpack/**/*.js"
6  - "index.d.ts"
7alwaysApply: false
8---
9 
10# JavaScript & types (this repo)
11 
12## Runtime & modules
13 
14- **Source** is **ES modules** under `src/` (`import` / `export`). Webpack resolves aliases such as **`runtime/http.js`** per target (`webpack/webpack.*.js`).
15- **`index.d.ts`** is the public TypeScript surface for npm consumers; keep it aligned with `src/core/` JSDoc and exports.
16 
17## Style & tooling
18 
19- **ESLint** uses **`eslint-config-standard`** and **`@babel/eslint-parser`**. This repo **requires semicolons** and related rules in **`.eslintrc.js`** — match existing `src/core/` style rather than semicolon-free Standard.
20- **Environment**: ESLint `es2020`, `node`, `browser`, `jest`.
21 
22## Patterns
23 
24- Use **JSDoc** (`@description`, `@param`, `@returns`, `@example`) on **public** API consistent with `src/core/contentstack.js` and `src/core/stack.js`.
25- **Dependencies**: **`@contentstack/utils`** is exposed on the main class; follow existing import paths (including `.js` suffixes where the codebase uses them in ESM files).
26 
27## Logging
28 
29- Avoid noisy logging in library code except via existing **`fetchOptions.logHandler`** / **`fetchOptions.debug`** patterns in `src/core/lib/request.js` and `stack.js`.
30- Never log full **delivery_token**, **preview_token**, **management_token**, or API keys.
31