Cursor rule

1---
2description: "Contentstack CDA SDK patterns in src/core (Content Delivery API)"
3globs: ["src/**/*.js"]
4alwaysApply: false
5---
6 
7# Contentstack CDA SDK (`src/core/`)
8 
9This package implements the **Content Delivery API (CDA)** read client, not the Content Management API (CMA).
10 
11## Stack & config
12 
13- **`Contentstack.Stack(options)`** (`src/core/stack.js`) — **`api_key`**, **`delivery_token`**, **`environment`**; optional **`region`**, **`branch`**, **`host`**, **`live_preview`**, **`plugins`**, **`fetchOptions`** (timeout, retries, `retryCondition`, `logHandler`, etc.).
14- Default CDN paths and version come from **`config.js`** at the repo root; regional hosts follow existing `stack.js` logic (e.g. `{region}-cdn.contentstack.com`).
15 
16## HTTP & errors
17 
18- Requests are built in **`src/core/lib/request.js`**: query serialization, **`fetch`**, default retries on **408** / **429** (configurable), plugin hooks **`onRequest`** / **`onResponse`**.
19- Failed responses reject with objects carrying **`error_message`**, **`error_code`**, **`errors`**, **`status`**, **`statusText`** when JSON parsing succeeds — keep new code compatible with this shape.
20 
21## Modules
22 
23- **Entry, Query, Assets, Taxonomy, Result**, etc. live under **`src/core/modules/`** — follow neighboring patterns for chaining, parameters, and URL assembly.
24- **Cache**: policies and providers under **`src/core/cache.js`** and **`src/core/cache-provider/`**.
25 
26## Live preview
27 
28- When **`live_preview.enable`** is true, **`management_token`** vs **`preview_token`** affect host selection — mirror existing `stack.js` behavior and tests under **`test/live-preview/`**.
29 
30## Runtime targets
31 
32- **`src/runtime/node|web|react-native|nativescript/`** supply **`http`** and **`localstorage`** — changes that affect networking or storage must consider **all** bundled targets.
33 
34## Docs
35 
36- Align behavior with the official [Content Delivery API](https://www.contentstack.com/docs/developers/apis/content-delivery-api/) documentation.
37