@insignia-education/api-sdk-js 0.9.24 → 0.9.25

package/.nvmrc

@@ -0,0 +1 @@
+24

package/AGENTS.md

@@ -0,0 +1,54 @@
+# Insignia Education — API SDK (JavaScript)
+
+## Requirements
+- Node 24 LTS (`nvm use 24`)
+
+## Quick start
+```bash
+nvm use 24
+npm install
+npm test       # runs Jest test suite
+npm run lint   # ESLint
+```
+
+## What this is
+A zero-dependency JavaScript SDK that wraps the Insignia Education API (`/api/v1`).
+Consumed by `insignia-education/front` via `@insignia-education/api-sdk-js`.
+
+## Structure
+```
+src/
+├── index.js            ← main export
+├── api/v1/
+│   ├── index.js        ← InsigniaApiV1 class (root client)
+│   ├── Auth.js         ← /auth endpoints
+│   ├── Courses.js      ← /courses endpoints
+│   ├── Users.js        ← /users endpoints
+│   └── ...             ← one file per API resource
+```
+
+## Usage pattern
+```js
+import InsigniaApiV1 from '@insignia-education/api-sdk-js/api/v1';
+const api = new InsigniaApiV1('http://localhost:8000');
+
+api.auth.login({ email, password });
+api.courses.get(null, { page: 1 });
+api.users.cashReceivers();
+```
+
+## Conventions
+- One class per API resource
+- Methods match HTTP verbs: `get`, `post`, `put`, `patch`, `delete`
+- No external runtime dependencies — only Node built-ins
+- ESM modules (`"type": "module"`)
+
+## Adding a new resource
+1. Create `src/api/v1/ResourceName.js` with a class that receives the client
+2. Register it in `src/api/v1/index.js`
+3. Write tests in `src/api/v1/__tests__/ResourceName.test.js`
+
+## Never do
+- Don't add runtime dependencies
+- Don't change the constructor signature of `InsigniaApiV1`
+- Don't hardcode API base URLs — always receive from constructor

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insignia-education/api-sdk-js",
-  "version": "0.9.24",
+  "version": "0.9.25",
   "description": "JavaScript SDK for the Insignia Education API",
   "main": "index.js",
   "type": "module",
@@ -20,7 +20,7 @@
   "author": "Insignia Education",
   "license": "MIT",
   "engines": {
-    "node": ">=25.5.0"
+    "node": ">=24"
   },
   "bugs": {
     "url": "https://github.com/insignia-education/api-sdk-js/issues"

package/src/Client.js

@@ -76,6 +76,12 @@ export default class InsigniaClient {
         if (body !== null) options.body = JSON.stringify(body);
         const response = await fetch(`${this.#baseUrl}${path}`, options);
         this.#storeCookies(response);
+        if (!response.ok) {
+            const err = new Error(`HTTP ${response.status}`);
+            err.status = response.status;
+            try { err.data = await this.#parseResponse(response); } catch (_) {}
+            throw err;
+        }
         const data = await this.#parseResponse(response);
         return data?.success ? data.response : data;
     }