bump-cli 2.10.0 → 2.10.1

package/README.md

@@ -16,7 +16,7 @@ Using [OpenAPI](https://github.com/OAI/OpenAPI-Specification) (v3.x and v2.0) or
 - Validate an API document before publishing to your documentation.
 - [Publish an API document](#the-deploy-command) to your Bump.sh documentation or hubs.
 - [Compare two API documents](#the-diff-command) to generate a human-readable diff from your API definition.
-Under the hood, it uses the API of [developers.bump.sh](https://developers.bump.sh). And is built with the [`oclif`](https://oclif.io) framework in Typescript.
+Under the hood, it uses the workspace API of [developers.bump.sh](https://developers.bump.sh/doc/workspace/). And is built with the [`oclif`](https://oclif.io) framework in Typescript.
 
 Using [Flower](https://docs.bump.sh/help/mcp-servers/specification-support/flower-support/) or [Arazzo](https://docs.bump.sh/arazzo/v1.0/), you can:
 
@@ -83,7 +83,7 @@ npx bump --help
 
 ### Can I install Bump.sh CLI without using NodeJS?
 
-Unfortunately, at the moment we only support the Node environment. However, you can download a standalone package directly from the [latest Github release](https://github.com/bump-sh/cli/releases) assets which you can run as a standalone binary. Or you can push your documentation using [our API](https://developers.bump.sh/) (advanced usage only).
+Unfortunately, at the moment we only support the Node environment. However, you can download a standalone package directly from the [latest Github release](https://github.com/bump-sh/cli/releases) assets which you can run as a standalone binary. Or you can push your documentation using [our API](https://developers.bump.sh/doc/workspace/) (advanced usage only).
 
 ## Usage
 
@@ -284,7 +284,7 @@ bump preview path/to/file.json
 You can also preview a document available via a URL:
 
 ```shell
-bump preview https://developers.bump.sh/source.yaml
+bump preview https://developers.bump.sh/doc/workspace/source.yaml
 ```
 
 #### Live preview
@@ -384,7 +384,7 @@ For example to generate a preview:
   > Your preview is visible at: https://bump.sh/preview/42
   ```
 
-Please note that even if CLI is running locally, by default requests are sent to [Bump.sh API](https://developers.bump.sh/).
+Please note that even if CLI is running locally, by default requests are sent to [Bump.sh API](https://developers.bump.sh/doc/workspace/).
 
 If you have a local version of the Bump.sh API, you can run CLI 100% in local environment
 by setting the environment variable `BUMP_HOST`:

package/dist/api/index.js

@@ -12,7 +12,7 @@ class BumpApi {
         headers: this.authorizationHeader(token),
     });
     postDiff = (body) => this.client.post('/diffs', body);
-    postMCPServerDeploy = (mcpServerIdOrSlug, body, token) => this.client.post(`/mcp_servers/${mcpServerIdOrSlug}/deploy`, body, {
+    postMCPServerDeploy = (mcpServerIdOrSlug, body, token) => this.client.post(`/mcp-servers/${mcpServerIdOrSlug}/deploy`, body, {
         headers: this.authorizationHeader(token),
     });
     postPreview = (body) => this.client.post('/previews', body);

package/dist/api/models.d.ts

@@ -34,6 +34,7 @@ export interface VersionRequest {
     unpublished?: boolean;
 }
 export interface VersionResponse {
+    doc_name: string;
     doc_public_url?: string;
     id: string;
 }
@@ -75,4 +76,5 @@ export interface WorkflowVersionRequest {
 export interface WorkflowVersionResponse {
     id: string;
     mcp_server_id: string;
+    mcp_server_name: string;
 }

package/dist/commands/deploy.js

@@ -110,23 +110,25 @@ ${chalk.dim('$ bump deploy FILE --mcp-server <your_mcp_server_id_or_slug> --toke
     async deploySingleFile(api, dryRun, documentation, token, hub, autoCreate, documentationName, branch, overlay, temporary) {
         ux.action.status = `...a new version to your ${documentation} documentation`;
         const response = await new CoreDeploy(this.bump).run(api, dryRun, documentation, token, hub, autoCreate, documentationName, branch, overlay, temporary);
+        const docName = response?.doc_name || documentation;
         if (dryRun) {
             ux.stdout(ux.colorize('green', 'Definition is valid'));
         }
         else if (response) {
-            process.stdout.write(ux.colorize('green', `Your ${documentation} documentation...`));
+            process.stdout.write(ux.colorize('green', `Your ${docName} documentation...`));
             ux.stdout(ux.colorize('green', `has received a new ${temporary ? 'preview' : 'deployment'} which will soon be ready at:`));
             ux.stdout(ux.colorize('underline', response.doc_public_url));
         }
         else {
-            ux.warn(`Your ${documentation} documentation has not changed`);
+            ux.warn(`Your ${docName} documentation has not changed`);
         }
     }
     async deploySingleWorkflowFile(workflowDefinition, mcpServer, token) {
         ux.action.status = `...a new workflow definition to your ${mcpServer} MCP server`;
         const response = await new CoreWorkflowDeploy(this.bump).run(workflowDefinition, mcpServer, token);
+        const mcpServerName = response?.mcp_server_name || mcpServer;
         if (response) {
-            process.stdout.write(ux.colorize('green', `Your ${mcpServer} MCP server...`));
+            process.stdout.write(ux.colorize('green', `Your ${mcpServerName} MCP server...`));
             ux.stdout(ux.colorize('green', `has received a new workflow definition which will soon be ready.`));
         }
         else {

package/dist/core/diff.d.ts

@@ -1,6 +1,9 @@
 import { Config } from '@oclif/core';
 import { BumpApi } from '../api/index.js';
 import { DiffResponse, VersionResponse, WithDiff } from '../api/models.js';
+export interface DiffResult extends DiffResponse {
+    doc_name?: string;
+}
 export declare class Diff {
     static readonly TIMEOUT = 120;
     private _bump;
@@ -11,14 +14,14 @@ export declare class Diff {
     createDiff(file1: string, file2: string, expires: string | undefined, overlays1?: string[] | undefined, overlays2?: string[] | undefined): Promise<DiffResponse | undefined>;
     createVersion(file: string, documentation: string, token: string, hub: string | undefined, branch_name: string | undefined, previous_version_id?: string | undefined, overlays?: string[] | undefined): Promise<VersionResponse | undefined>;
     d(formatter: any, ...args: any[]): void;
-    extractDiff(versionWithDiff: VersionResponse & WithDiff): DiffResponse;
+    extractDiff(versionWithDiff: VersionResponse & WithDiff): DiffResult;
     isVersion(result: DiffResponse | VersionResponse): result is VersionResponse;
     isVersionWithDiff(result: DiffResponse | (VersionResponse & WithDiff)): result is VersionResponse & WithDiff;
     pollingDelay(): Promise<void>;
-    run(file1: string, file2: string | undefined, documentation: string | undefined, hub: string | undefined, branch: string | undefined, token: string | undefined, format: string, expires?: string | undefined, overlays1?: string[] | undefined, overlays2?: string[] | undefined): Promise<DiffResponse | undefined>;
-    waitResult(result: DiffResponse | VersionResponse, token: string | undefined, opts: {
+    run(file1: string, file2: string | undefined, documentation: string | undefined, hub: string | undefined, branch: string | undefined, token: string | undefined, format: string, expires?: string | undefined, overlays1?: string[] | undefined, overlays2?: string[] | undefined): Promise<DiffResult | undefined>;
+    waitResult(apiResponse: DiffResponse | VersionResponse, token: string | undefined, opts: {
         format: string;
         timeout: number;
-    }): Promise<DiffResponse>;
+    }): Promise<DiffResult>;
     private delay;
 }

package/dist/core/diff.js

@@ -82,6 +82,7 @@ export class Diff {
         return {
             breaking: versionWithDiff.diff_breaking,
             details: versionWithDiff.diff_details,
+            doc_name: versionWithDiff.doc_name,
             id: versionWithDiff.id,
             markdown: versionWithDiff.diff_markdown,
             public_url: versionWithDiff.diff_public_url,
@@ -122,35 +123,34 @@ export class Diff {
         }
         return undefined;
     }
-    async waitResult(result, token, opts) {
-        const pollingResponse = await (this.isVersion(result) && token
-            ? this.bumpClient.getVersion(result.id, token)
-            : this.bumpClient.getDiff(result.id, opts.format));
+    async waitResult(apiResponse, token, opts) {
+        let diffResult = { id: apiResponse.id };
+        const pollingResponse = await (this.isVersion(apiResponse) && token
+            ? this.bumpClient.getVersion(apiResponse.id, token)
+            : this.bumpClient.getDiff(apiResponse.id, opts.format));
         if (opts.timeout <= 0) {
             throw new CLIError('We were unable to compute your documentation diff. Sorry about that. Please try again later. If the error persists, please contact support at https://bump.sh.');
         }
         switch (pollingResponse.status) {
             case 200: {
-                let diff = pollingResponse.data;
-                if (this.isVersionWithDiff(diff)) {
-                    diff = this.extractDiff(diff);
-                }
+                const diff = pollingResponse.data;
+                diffResult = this.isVersionWithDiff(diff) ? this.extractDiff(diff) : diff;
                 this.d('Received diff:');
-                this.d(diff);
-                return diff;
+                this.d(diffResult);
+                return diffResult;
                 break;
             }
             case 202: {
                 this.d('Waiting 1 sec before next poll');
                 await this.pollingDelay();
-                return this.waitResult(result, token, {
+                return this.waitResult(apiResponse, token, {
                     format: opts.format,
                     timeout: opts.timeout - 1,
                 });
                 break;
             }
         }
-        return {};
+        return diffResult;
     }
     async delay(ms) {
         return new Promise((resolve) => {

package/dist/core/overlay.d.ts

@@ -4,6 +4,7 @@ export declare class Overlay {
     run(spec: APIDefinition, overlay: OpenAPIOverlay): APIDefinition;
     private executeAction;
     private humanName;
+    private mergeWithEnumDedup;
     private pathEntryToKey;
     private remove;
     private update;

package/dist/core/overlay.js

@@ -98,6 +98,18 @@ export class Overlay {
     humanName(action) {
         return action.description ? `Action '${action.description}'` : 'Action';
     }
+    // Deep merge objects using a module (built-in spread operator is only shallow)
+    mergeWithEnumDedup(target, update) {
+        const merger = mergician({
+            afterEach(options) {
+                if (options.key === 'enum' && Array.isArray(options.mergeVal)) {
+                    return [...new Set(options.mergeVal)];
+                }
+            },
+            appendArrays: true,
+        });
+        return merger(target, update);
+    }
     // The last path entry (e.g. "'price']" or '0]') contains a final
     // ']' so we need to remove it AND we need to replace single quotes
     // to double quotes AND FINALLY parse the element to transform the
@@ -118,13 +130,11 @@ export class Overlay {
     }
     update(spec, parent, update, property_or_index) {
         try {
-            // Deep merge objects using a module (built-in spread operator is only shallow)
-            const merger = mergician({ appendArrays: true, dedupArrays: true });
             if (property_or_index === '$') {
                 // You can't actually merge an update on a root object
                 // target with the jsonpathly lib, this is just us merging
                 // the given update with the whole spec.
-                spec = merger(spec, update);
+                spec = this.mergeWithEnumDedup(spec, update);
             }
             else if (property_or_index !== undefined) {
                 const targetObject = parent[property_or_index];
@@ -132,7 +142,7 @@ export class Overlay {
                     parent[property_or_index] =
                         Array.isArray(targetObject) && Array.isArray(update)
                             ? [...targetObject, ...update]
-                            : merger(targetObject, update);
+                            : this.mergeWithEnumDedup(targetObject, update);
                 }
                 else {
                     parent[property_or_index] = update;

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export declare const COMMANDS: {
     overlay: typeof Overlay;
     preview: typeof Preview;
 };
-export { DiffResponse, PreviewResponse, VersionResponse, WithDiff } from './api/models.js';
+export { PreviewResponse, VersionResponse, WithDiff } from './api/models.js';
 export { default as Deploy } from './commands/deploy.js';
 export { default as Preview } from './commands/preview.js';
 export * as Diff from './core/diff.js';

package/oclif.manifest.json

@@ -11,11 +11,11 @@
       },
       "description": "Create a new version of your documentation from the given file or URL.",
       "examples": [
-        "Deploy a new version of an existing documentation\n\n$ bump deploy FILE --doc <your_doc_id_or_slug> --token <your_doc_token>\n* Let's deploy on Bump.sh... done\n* Your new documentation version will soon be ready\n",
-        "Deploy a new version of an existing documentation attached to a hub\n\n$ bump deploy FILE --doc <doc_slug> --hub <your_hub_id_or_slug> --token <your_doc_token>\n* Let's deploy on Bump.sh... done\n* Your new documentation version will soon be ready\n",
-        "Deploy a whole directory of API definitions files to a hub\n\n$ bump deploy DIR --filename-pattern *-{slug}-api --hub <hub_slug> --token <hub_token>\nWe've found 2 valid API definitions to deploy\n└─ DIR\n   └─ source-my-service-api.yml (OpenAPI spec version 3.1.0)\n   └─ source-my-jobs-service-api.yml (AsyncAPI spec version 2.6.0)\n\nLet's deploy those documentations to your <hub_slug> hub on Bump.sh\n\n* Your new documentation version will soon be ready\nLet's deploy a new version to your my-service documentation on Bump.sh... done\n\n* Your new documentation version will soon be ready\nLet's deploy a new version to your my-jobs-service documentation on Bump.sh... done\n",
-        "Validate a new documentation version before deploying it\n\n$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_token>\n* Let's validate on Bump.sh... done\n* Definition is valid\n",
-        "Deploy a new workflow document of an existing MCP server\n\n$ bump deploy FILE --mcp-server <your_mcp_server_id_or_slug> --token <your_organization_token>\n* Let's deploy on Bump.sh... done\n* Your <your_mcp_server_id_or_slug> MCP server... has received a new workflow definition which will soon be ready.\n"
+        "Deploy a new version of \u001b[4man existing documentation\u001b[24m\n\n\u001b[2m$ bump deploy FILE --doc <your_doc_id_or_slug> --token <your_doc_token>\u001b[22m\n* Let's deploy on Bump.sh... done\n* Your new documentation version will soon be ready\n",
+        "Deploy a new version of \u001b[4man existing documentation attached to a hub\u001b[24m\n\n\u001b[2m$ bump deploy FILE --doc <doc_slug> --hub <your_hub_id_or_slug> --token <your_doc_token>\u001b[22m\n* Let's deploy on Bump.sh... done\n* Your new documentation version will soon be ready\n",
+        "Deploy a whole directory of \u001b[4mAPI definitions files to a hub\u001b[24m\n\n\u001b[2m$ bump deploy DIR --filename-pattern *-{slug}-api --hub <hub_slug> --token <hub_token>\u001b[22m\nWe've found 2 valid API definitions to deploy\n└─ DIR\n   └─ source-my-service-api.yml (OpenAPI spec version 3.1.0)\n   └─ source-my-jobs-service-api.yml (AsyncAPI spec version 2.6.0)\n\nLet's deploy those documentations to your <hub_slug> hub on Bump.sh\n\n* Your new documentation version will soon be ready\nLet's deploy a new version to your my-service documentation on Bump.sh... done\n\n* Your new documentation version will soon be ready\nLet's deploy a new version to your my-jobs-service documentation on Bump.sh... done\n",
+        "\u001b[4mValidate a new documentation version\u001b[24m before deploying it\n\n\u001b[2m$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_token>\u001b[22m\n* Let's validate on Bump.sh... done\n* Definition is valid\n",
+        "Deploy a new workflow document of \u001b[4man existing MCP server\u001b[24m\n\n\u001b[2m$ bump deploy FILE --mcp-server <your_mcp_server_id_or_slug> --token <your_organization_token>\u001b[22m\n* Let's deploy on Bump.sh... done\n* Your <your_mcp_server_id_or_slug> MCP server... has received a new workflow definition which will soon be ready.\n"
       ],
       "flags": {
         "auto-create": {
@@ -113,7 +113,6 @@
           "description": "Documentation, Hub or Organization token. Can be provided via BUMP_TOKEN environment variable",
           "name": "token",
           "required": true,
-          "default": "99f52837852249b328c0a00249f846a3",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -215,7 +214,6 @@
           "description": "Documentation, Hub or Organization token. Can be provided via BUMP_TOKEN environment variable",
           "name": "token",
           "required": false,
-          "default": "99f52837852249b328c0a00249f846a3",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -245,7 +243,7 @@
       },
       "description": "Apply an OpenAPI specified overlay to your API definition.",
       "examples": [
-        "Apply the OVERLAY_FILE to the existing DEFINITION_FILE. The resulting\ndefinition is output on stdout meaning you can redirect it to a new\nfile.\n\n$ bump overlay DEFINITION_FILE OVERLAY_FILE > destination/file.json\n* Let's apply the overlay to the main definition... done\n"
+        "Apply the OVERLAY_FILE to the existing DEFINITION_FILE. The resulting\ndefinition is output on stdout meaning you can redirect it to a new\nfile.\n\n\u001b[2m$ bump overlay DEFINITION_FILE OVERLAY_FILE > destination/file.json\u001b[22m\n* Let's apply the overlay to the main definition... done\n"
       ],
       "flags": {
         "out": {
@@ -303,5 +301,5 @@
       "strict": true
     }
   },
-  "version": "2.10.0"
+  "version": "2.10.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bump-cli",
-  "description": "The Bump CLI is used to interact with your API documentation hosted on Bump.sh by using the API of developers.bump.sh",
-  "version": "2.10.0",
+  "description": "The Bump CLI is used to interact with your API documentation hosted on Bump.sh by using the APIs of developers.bump.sh",
+  "version": "2.10.1",
   "author": "Paul Bonaud <paulr@bump.sh>",
   "bin": {
     "bump": "./bin/run.js"
@@ -16,7 +16,7 @@
     "@types/mocha": "^10",
     "@types/node": "^25",
     "@types/sinon": "^21.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.13.0",
+    "@typescript-eslint/eslint-plugin": "^8.61.1",
     "chai": "^6.2.2",
     "eslint": "^8",
     "eslint-config-oclif": "^5",