@indigoai-us/hq-cli 5.231.0 → 5.231.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [5.231.1] — 2026-09-27
+
+### Fixed
+
+- `hq crm entity upsert` checks CRM settings first and prints the enable hint without sending a write when CRM is disabled.
+
 ## [5.231.0] — 2026-09-27
 
 ### Added

package/dist/commands/crm.js

@@ -19,6 +19,54 @@ const CRM_ENTITY_TYPES = [
     "invoice",
     "company",
 ];
+const CRM_SETTINGS_PRECHECK_TIMEOUT_MS = 3_000;
+const CRM_DISABLED_HINT_PREFIX = "CRM is not enabled for this company. Enable it first: ";
+function printCrmDisabledHint(companySlug) {
+    console.error(chalk.red(CRM_DISABLED_HINT_PREFIX +
+        `hq company settings set --company ${companySlug} --crm-enabled true`));
+    process.exit(1);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * CRM settings are a best-effort precheck. Only an explicit false prevents the
+ * write; unavailable or malformed settings leave hq-pro authoritative.
+ */
+async function crmIsExplicitlyDisabled(token, companyUid) {
+    try {
+        const response = await vaultApiFetch({
+            token,
+            path: "/company-settings",
+            query: { companyUid },
+            signal: AbortSignal.timeout(CRM_SETTINGS_PRECHECK_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            console.error(chalk.red(`CRM settings precheck returned HTTP ${response.status}; continuing to let the server decide.`));
+            return false;
+        }
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch (err) {
+            const errorName = err instanceof Error ? err.name : "unknown error";
+            console.error(chalk.red(`CRM settings precheck returned invalid JSON (${errorName}); continuing to let the server decide.`));
+            return false;
+        }
+        if (!isRecord(body))
+            return false;
+        const settings = isRecord(body.companySettings)
+            ? body.companySettings
+            : body;
+        return settings.crmEnabled === false;
+    }
+    catch (err) {
+        const errorName = err instanceof Error ? err.name : "unknown error";
+        console.error(chalk.red(`CRM settings precheck failed (${errorName}); continuing to let the server decide.`));
+        return false;
+    }
+}
 /**
  * Read the `--json <file|->` payload: a single entity object or an array of
  * entities. `-` reads from stdin. Returns the entities array (always
@@ -127,6 +175,9 @@ export function registerCrmCommand(program) {
             }
             const token = await ensureCognitoToken();
             const companyUid = await getEntityUid(token, { companySlug });
+            if (await crmIsExplicitlyDisabled(token, companyUid)) {
+                printCrmDisabledHint(companySlug);
+            }
             const res = await vaultApiFetch({
                 token,
                 path: "/crm/entities",
@@ -137,9 +188,7 @@ export function registerCrmCommand(program) {
                 const body = (await res.json().catch(() => ({})));
                 // CrmDisabledError surfaces as a 403 with a helpful message.
                 if (res.status === 403 && body.code === "CRM_DISABLED") {
-                    console.error(chalk.red("CRM is not enabled for this company. Enable it first: " +
-                        `hq company settings set --company ${companySlug} --crm-enabled true`));
-                    process.exit(1);
+                    printCrmDisabledHint(companySlug);
                 }
                 console.error(chalk.red(`Failed to upsert entities: ${body.error ?? res.statusText}`));
                 process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.231.0",
+  "version": "5.231.1",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {