@cloudbeat/atlas-cli 0.1.0 → 0.3.0

package/README.md

@@ -245,3 +245,9 @@ To avoid repeating yourself:
 atlas config set project SKT
 atlas config set url https://atlas.cloudbeat.io
 ```
+
+## Compatibility
+
+Works with any Atlas instance. From 0.3.0 the CLI talks to a new API path, and
+falls back automatically when it finds an older instance that does not serve it —
+so you do not need to match versions between the CLI and your Atlas server.

package/dist/api.js

@@ -8,6 +8,9 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const config_1 = require("./config");
 const ui_1 = require("./ui");
+/** Where the control-plane API lives today, and where it used to live. */
+const API_PREFIX = '/app/api';
+const LEGACY_API_PREFIX = '/admin/api';
 // ── Client ───────────────────────────────────────────────────────────────────
 class AtlasApi {
     url;
@@ -22,6 +25,33 @@ class AtlasApi {
     get baseUrl() {
         return this.url;
     }
+    /**
+     * The control-plane API prefix.
+     *
+     * It moved from /admin/api to /app/api when the browser UI moved to /app.
+     * Servers keep serving the old prefix so CLIs released before that keep
+     * working; this handles the other direction — a current CLI pointed at an
+     * Atlas that predates the move. The first 404 under the new prefix switches
+     * to the old one for the life of the process, so there is no extra round
+     * trip against an up-to-date server.
+     */
+    prefix = API_PREFIX;
+    prefixResolved = false;
+    get api() {
+        return this.prefix;
+    }
+    /** Fetch that retries once under the legacy prefix if the route is absent. */
+    async fetchApi(routePath, init) {
+        const res = await fetch(`${this.url}${routePath}`, init);
+        if (res.status === 404 && !this.prefixResolved && routePath.startsWith(API_PREFIX)) {
+            this.prefix = LEGACY_API_PREFIX;
+            this.prefixResolved = true;
+            const legacy = routePath.replace(API_PREFIX, LEGACY_API_PREFIX);
+            return { res: await fetch(`${this.url}${legacy}`, init), routePath: legacy };
+        }
+        this.prefixResolved = true;
+        return { res, routePath };
+    }
     authHeaders() {
         if (!this.token) {
             throw new ui_1.CliError('Not authenticated. Run `atlas login`, or set ATLAS_TOKEN to an API token.', ui_1.EXIT.USAGE);
@@ -34,9 +64,9 @@ class AtlasApi {
         const headers = auth ? this.authHeaders() : {};
         if (opts.body !== undefined)
             headers['Content-Type'] = 'application/json';
-        let res;
+        let attempt;
         try {
-            res = await fetch(`${this.url}${routePath}`, {
+            attempt = await this.fetchApi(routePath, {
                 method,
                 headers,
                 body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
@@ -45,7 +75,7 @@ class AtlasApi {
         catch (err) {
             throw new ui_1.CliError(`Cannot reach ${this.url}: ${err.message}`, ui_1.EXIT.ERROR);
         }
-        return this.parse(method, routePath, res);
+        return this.parse(method, attempt.routePath, attempt.res);
     }
     async parse(method, routePath, res) {
         const text = await res.text();
@@ -67,9 +97,11 @@ class AtlasApi {
     }
     // ── auth ──────────────────────────────────────────────────────────────────
     async login(username, password) {
-        let res;
+        // Usually the very first call a CLI makes, so this is where the prefix
+        // normally gets resolved against an older server.
+        let attempt;
         try {
-            res = await fetch(`${this.url}/admin/api/auth/login`, {
+            attempt = await this.fetchApi(`${this.api}/auth/login`, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({ username, password }),
@@ -78,14 +110,14 @@ class AtlasApi {
         catch (err) {
             throw new ui_1.CliError(`Cannot reach ${this.url}: ${err.message}`, ui_1.EXIT.ERROR);
         }
-        return this.parse('POST', '/admin/api/auth/login', res);
+        return this.parse('POST', attempt.routePath, attempt.res);
     }
     async me() {
-        return this.request('GET', '/admin/api/auth/me');
+        return this.request('GET', `${this.api}/auth/me`);
     }
     // ── projects & files ──────────────────────────────────────────────────────
     async projects() {
-        return this.request('GET', '/admin/api/projects');
+        return this.request('GET', `${this.api}/projects`);
     }
     /** Projects are addressed by name on the CLI; the API wants the id. */
     async projectByName(name) {
@@ -98,7 +130,7 @@ class AtlasApi {
         return hit;
     }
     async files(projectId) {
-        return this.request('GET', `/admin/api/projects/${projectId}/files`);
+        return this.request('GET', `${this.api}/projects/${projectId}/files`);
     }
     async uploadFiles(projectId, paths) {
         const form = new FormData();
@@ -110,7 +142,7 @@ class AtlasApi {
         }
         let res;
         try {
-            res = await fetch(`${this.url}/admin/api/projects/${projectId}/files`, {
+            res = await fetch(`${this.url}${this.api}/projects/${projectId}/files`, {
                 method: 'POST',
                 headers: this.authHeaders(), // no Content-Type: fetch sets the multipart boundary
                 body: form,
@@ -119,33 +151,33 @@ class AtlasApi {
         catch (err) {
             throw new ui_1.CliError(`Upload failed: ${err.message}`, ui_1.EXIT.ERROR);
         }
-        return this.parse('POST', `/admin/api/projects/${projectId}/files`, res);
+        return this.parse('POST', `${this.api}/projects/${projectId}/files`, res);
     }
     async downloadFile(projectId, filename) {
-        const res = await fetch(`${this.url}/admin/api/projects/${projectId}/files/${encodeURIComponent(filename)}/download`, { headers: this.authHeaders() });
+        const res = await fetch(`${this.url}${this.api}/projects/${projectId}/files/${encodeURIComponent(filename)}/download`, { headers: this.authHeaders() });
         if (!res.ok)
             throw new ui_1.CliError(`Download failed: ${res.status} ${res.statusText}`, ui_1.EXIT.ERROR);
         return Buffer.from(await res.arrayBuffer());
     }
     async deleteFile(projectId, filename) {
-        await this.request('DELETE', `/admin/api/projects/${projectId}/files/${encodeURIComponent(filename)}`);
+        await this.request('DELETE', `${this.api}/projects/${projectId}/files/${encodeURIComponent(filename)}`);
     }
     // ── fleet ─────────────────────────────────────────────────────────────────
     async servers() {
-        return this.request('GET', '/admin/api/servers');
+        return this.request('GET', `${this.api}/servers`);
     }
     async clusters() {
-        return this.request('GET', '/admin/api/clusters');
+        return this.request('GET', `${this.api}/clusters`);
     }
     // ── runs ──────────────────────────────────────────────────────────────────
     async run(projectId, body) {
-        return this.request('POST', `/admin/api/projects/${projectId}/run`, { body });
+        return this.request('POST', `${this.api}/projects/${projectId}/run`, { body });
     }
     async queueEntry(queueId) {
-        return this.request('GET', `/admin/api/tests/queue/${queueId}`);
+        return this.request('GET', `${this.api}/tests/queue/${queueId}`);
     }
     async stop(testId) {
-        return this.request('POST', `/admin/api/tests/${encodeURIComponent(testId)}/stop`, { body: {} });
+        return this.request('POST', `${this.api}/tests/${encodeURIComponent(testId)}/stop`, { body: {} });
     }
     // ── results (public dashboard API) ─────────────────────────────────────────
     async summary(testId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbeat/atlas-cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Atlas CLI — run JMeter load tests from CI and record scenarios",
   "main": "dist/cli.js",
   "bin": {