@intercom/cli 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 View it from the CLI with `intercom changelog`.
 
+## [0.14.0] - 2026-09-02
+
+### Added
+
+- `intercom fin workflows upload --verify` compares the workflow the server saved against the file just uploaded and exits non-zero listing any field that did not survive the round-trip, matching `fin procedures upload --verify`.
+
+### Fixed
+
+- `--verify` combined with `--dry-run` on a `fin procedures upload` no longer fails: dry-run sends no request, so there is nothing saved to compare against and the verification step is skipped.
+
+## [0.13.0] - 2026-09-01
+
+### Changed
+
+- Workspaces created with `intercom auth signup` are now opted into the narrower `public-fin-cli` capability instead of the broad internal Fin SDK one. New workspaces get exactly the endpoints the CLI uses; existing workspaces are unaffected.
+
 ## [0.12.0] - 2026-08-26
 
 ### Added

package/dist/index.js

@@ -964,7 +964,7 @@ async function signup(options) {
     email_submission: {},
     sign_up_locale: "en",
     new_app_feature_flags: [
-      "fin-sdk",
+      "public-fin-cli",
       "messenger-public-api"
     ]
   };
@@ -3075,7 +3075,7 @@ back missing or changed is reported.`
     }
     const result = await client.postFormData("/fin-sdk/upload", formData);
     render(result, opts, () => formatJson(result));
-    if (opts.verify) {
+    if (opts.verify && !isDryRun()) {
       verifySaved(filePath, fileContent.toString("utf8"), result);
     }
   });
@@ -3570,17 +3570,23 @@ shows which version that is).`
       console.log(text.replace(/\n+$/, ""));
     }
   });
-  workflows.command("upload <file>").description('Upload a workflow YAML file (creates if id is "new", updates if numeric)').option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+  workflows.command("upload <file>").description('Upload a workflow YAML file (creates if id is "new", updates if numeric)').option("--verify", "Fail if the saved workflow differs from the file uploaded").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
     "after",
     `
 Examples:
   $ intercom fin workflows upload ./welcome.yaml
   $ intercom fin workflows get wf-42 > local.yaml; vim local.yaml; intercom fin workflows upload local.yaml
   $ intercom fin workflows upload ./new.yaml --json | jq .visual_builder_url
+  $ intercom fin workflows upload ./welcome.yaml --verify
 
 The YAML file's id field determines whether this creates or updates:
   id: "new"   \u2192 creates a new workflow
-  id: <int>   \u2192 updates the existing workflow with that id`
+  id: <int>   \u2192 updates the existing workflow with that id
+
+--verify compares the workflow the server saved against the file just uploaded
+and exits non-zero listing any field that did not survive the round-trip. Fields
+the server adds (ids, defaults) are ignored; only content that was sent and came
+back missing or changed is reported.`
   ).action(async function(filePath) {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
@@ -3600,6 +3606,9 @@ The YAML file's id field determines whether this creates or updates:
         "Visual Builder URL": result.visual_builder_url != null ? String(result.visual_builder_url) : void 0
       })
     );
+    if (opts.verify && !isDryRun()) {
+      verifySaved2(filePath, fileContent, result);
+    }
   });
   workflows.command("enable <id>").description("Set a workflow's state to live").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
     "after",
@@ -3715,6 +3724,37 @@ async function getVersionYaml2(client, id, versionId) {
   }
   return typeof content === "string" ? content : stringifyYaml3(content);
 }
+function withoutExpectedChanges(sent) {
+  if (sent == null || typeof sent !== "object" || Array.isArray(sent)) {
+    return sent;
+  }
+  const rest = { ...sent };
+  delete rest.type;
+  delete rest.version;
+  if (String(rest.id ?? "").toLowerCase() === "new") {
+    delete rest.id;
+  }
+  return rest;
+}
+function verifySaved2(filePath, sentYaml, result) {
+  if (typeof result.new_file_content !== "string") {
+    throw new CLIError("Cannot verify: the server did not return the saved workflow");
+  }
+  const drift = findDrift(
+    withoutExpectedChanges(parseYaml3(sentYaml)),
+    parseYaml3(result.new_file_content)
+  );
+  if (drift.length === 0) {
+    console.error(`Verified: the saved workflow matches ${filePath}`);
+    return;
+  }
+  for (const path of drift) {
+    console.error(`  ${path}`);
+  }
+  throw new CLIError(
+    `${drift.length} field(s) did not survive the upload (listed above). Compare with \`intercom fin workflows get ${result.id ?? "<id>"}\`.`
+  );
+}
 
 // src/commands/fin/simulations.ts
 import { readFile as readFile5 } from "fs/promises";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intercom/cli",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "CLI tool for managing Intercom workspaces",
   "type": "module",
   "packageManager": "pnpm@10.23.0",