Dev

.github/workflows/ci.yml

@@ -29,4 +29,24 @@ jobs:
         run: npm ci
 
       - name: Run tests
-        run: npm run tests
+        run: npm test
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run lint
+        run: npm run lint

.github/workflows/release.yml

@@ -23,7 +23,7 @@ jobs:
         run: npm ci
 
       - name: Run tests
-        run: npm run tests
+        run: npm test
 
   publish:
     name: Publish to npm

CHANGELOG.md

@@ -10,6 +10,22 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) — versioning
 
 ---
 
+## [4.0.0] — 2026-07-08
+
+### Breaking Changes
+
+- **Cloud mode now sends the `X-APIForge-Key` header instead of `X-API-Key`**, matching the saas-api rename (CDC §8.4.1). Cloud ingest against the current APIForge API **requires** this version — 3.x and earlier send the old header and are rejected with `401`. The header is internal to the SDK, so no code change is needed on your side beyond upgrading.
+
+### Migration guide
+
+```bash
+npm install apiforgejs@^4.0.0
+```
+
+No configuration change is required — the header is set internally by `CloudTransport`. Upgrade any service running the SDK in cloud mode.
+
+---
+
 ## [3.0.0] — 2026-06-04
 
 ### Breaking Changes

eslint.config.js

@@ -0,0 +1,22 @@
+'use strict';
+
+const js = require('@eslint/js');
+const globals = require('globals');
+
+module.exports = [
+  js.configs.recommended,
+  {
+    languageOptions: {
+      ecmaVersion: 2023,
+      sourceType: 'commonjs',
+      globals: globals.node,
+    },
+    rules: {
+      'no-unused-vars': ['warn', { args: 'none', caughtErrors: 'none' }],
+      'no-empty': ['error', { allowEmptyCatch: true }],
+    },
+  },
+  {
+    ignores: ['node_modules/', 'src/ui.html'],
+  },
+];