@adkit/cli 1.12.24 → 1.12.25

package/dist/cli.js

@@ -80,6 +80,7 @@ var CliError = class extends Error {
   suggestion;
   instructions;
   actionUrl;
+  notice;
   constructor(code, message, suggestion) {
     super(message);
     this.code = code;
@@ -90,16 +91,17 @@ var CliError = class extends Error {
 // src/client.ts
 var noticePrinted = false;
 function printServerNotice(response) {
-  if (noticePrinted) return;
   const encoded = response.headers.get("x-adkit-notice");
-  if (!encoded) return;
-  noticePrinted = true;
+  if (!encoded) return void 0;
   const text = decodeURIComponent(encoded);
+  if (noticePrinted) return text;
+  noticePrinted = true;
   const dim = "\x1B[2m";
   const yellow = "\x1B[33m";
   const reset = "\x1B[0m";
   process.stderr.write(`${yellow}${dim}[AdKit notice] ${text}${reset}
 `);
+  return text;
 }
 function isErrorResponse(value) {
   return value != null && typeof value === "object";
@@ -204,7 +206,7 @@ var AdkitClient = class {
       const detail = code ?? (err instanceof Error ? err.message : String(err));
       throw new CliError("NETWORK_ERROR", `Cannot reach ${target} (${detail})`, "Verify your network connection");
     }
-    printServerNotice(response);
+    const serverNotice = printServerNotice(response);
     if (response.status === 204) return void 0;
     if (!response.ok) {
       let serverMessage = "";
@@ -229,27 +231,40 @@ var AdkitClient = class {
         const fallbackMsg = response.status >= 500 ? `Server error (HTTP ${String(response.status)})` : `Request failed (HTTP ${String(response.status)})`;
         const errorMsg = appendErrorDetail(dataMessage || serverMessage || fallbackMsg, batchSummary);
         const suggestion2 = buildMetaDsaSuggestion(structured.code) ?? buildRetrySuggestion(retryable, retryAfterSeconds) ?? buildAuthSuggestion(structured.code);
-        const error = new CliError(structured.code, errorMsg, suggestion2);
-        error.instructions = structured.instructions;
-        error.actionUrl = structured.actionUrl;
-        throw error;
+        const error2 = new CliError(structured.code, errorMsg, suggestion2);
+        error2.instructions = structured.instructions;
+        error2.actionUrl = structured.actionUrl;
+        error2.notice = serverNotice;
+        throw error2;
+      }
+      if (response.status === 401) {
+        const error2 = new CliError("INVALID_API_KEY", `Invalid or expired API key${serverMessage ? ` \u2014 ${serverMessage}` : ""}`, "Run: adkit setup");
+        error2.notice = serverNotice;
+        throw error2;
       }
-      if (response.status === 401) throw new CliError("INVALID_API_KEY", `Invalid or expired API key${serverMessage ? ` \u2014 ${serverMessage}` : ""}`, "Run: adkit setup");
       if (response.status === 429) {
         const waitMsg = buildRetrySuggestion(true, retryAfterSeconds) ?? "Wait a moment before retrying";
-        throw new CliError("RATE_LIMITED", appendErrorDetail(serverMessage || "Rate limit exceeded", batchSummary), waitMsg);
+        const error2 = new CliError("RATE_LIMITED", appendErrorDetail(serverMessage || "Rate limit exceeded", batchSummary), waitMsg);
+        error2.notice = serverNotice;
+        throw error2;
       }
       if (response.status === 404) {
         const fallback = `Not found: ${method} ${path3} \u2014 the resource may have been deleted or the ID is wrong`;
-        throw new CliError("NOT_FOUND", appendErrorDetail(serverMessage || fallback, batchSummary), "Check the resource ID");
+        const error2 = new CliError("NOT_FOUND", appendErrorDetail(serverMessage || fallback, batchSummary), "Check the resource ID");
+        error2.notice = serverNotice;
+        throw error2;
       }
       if (response.status >= 500) {
         const errorMsg = appendErrorDetail(dataMessage || serverMessage || `Server error (HTTP ${String(response.status)})`, batchSummary);
         const suggestion2 = buildRetrySuggestion(retryable, retryAfterSeconds);
-        throw new CliError("SERVER_ERROR", errorMsg, suggestion2);
+        const error2 = new CliError("SERVER_ERROR", errorMsg, suggestion2);
+        error2.notice = serverNotice;
+        throw error2;
       }
       const suggestion = buildRetrySuggestion(retryable, retryAfterSeconds);
-      throw new CliError("SERVER_ERROR", appendErrorDetail(serverMessage || `Request failed (HTTP ${String(response.status)})`, batchSummary), suggestion);
+      const error = new CliError("SERVER_ERROR", appendErrorDetail(serverMessage || `Request failed (HTTP ${String(response.status)})`, batchSummary), suggestion);
+      error.notice = serverNotice;
+      throw error;
     }
     return response.json();
   }
@@ -3529,8 +3544,8 @@ async function requestMultipart(client, pathName, formData) {
     try {
       const json = await response.json();
       if (isErrorResponse2(json)) {
-        serverMessage = json.statusMessage ?? json.message ?? "";
         dataMessage = json.data?.message ?? "";
+        serverMessage = dataMessage || json.message || json.statusMessage || "";
         retryable = json.data?.retryable;
         retryAfterSeconds = json.data?.retryAfterSeconds ?? void 0;
       }
@@ -3885,11 +3900,23 @@ function toGoogleSearchTermDisplayRows(row) {
 import { createRequire } from "node:module";
 
 // src/update-check.ts
-import { writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
 import { join as join2 } from "node:path";
 var CACHE_PATH = join2(CONFIG_DIR, "update-check.json");
 var FETCH_TIMEOUT_MS = 3e3;
 var REGISTRY_URL = "https://registry.npmjs.org/@adkit/cli/latest";
+function readCache() {
+  try {
+    const raw = readFileSync4(CACHE_PATH, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object") return void 0;
+    const cache = parsed;
+    if (typeof cache.lastCheck !== "number" || typeof cache.latestVersion !== "string") return void 0;
+    return { lastCheck: cache.lastCheck, latestVersion: cache.latestVersion };
+  } catch {
+    return void 0;
+  }
+}
 function writeCache(data) {
   try {
     const cacheJson = JSON.stringify(data);
@@ -3939,7 +3966,8 @@ function isNewer(latest, current) {
   return false;
 }
 function startUpdateCheck(currentVersion) {
-  const pending = fetch(REGISTRY_URL, {
+  const cached = readCache();
+  void fetch(REGISTRY_URL, {
     signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
   }).then(async (res) => {
     if (!res.ok) return null;
@@ -3955,12 +3983,11 @@ function startUpdateCheck(currentVersion) {
     return null;
   }).catch(() => null);
   return () => {
-    void pending.then((latest) => {
-      if (latest && isNewer(latest, currentVersion)) {
-        const updateNotice = formatUpdateNotice(currentVersion, latest);
-        process.stderr.write(updateNotice);
-      }
-    });
+    const latest = cached?.latestVersion;
+    if (latest && isNewer(latest, currentVersion)) {
+      const updateNotice = formatUpdateNotice(currentVersion, latest);
+      process.stderr.write(updateNotice);
+    }
   };
 }
 
@@ -6783,7 +6810,8 @@ async function selfUpdate(currentVersion) {
     else console.log(`Updated: ${currentVersion} \u2192 ${newVersion}`);
   } catch {
     console.error("Update failed. Try manually: npm install -g @adkit/cli@latest");
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
 }
 async function main() {
@@ -6835,18 +6863,18 @@ async function main() {
       const manageTarget = args[1];
       if (flags.help && !manageTarget) {
         showHelp("manage", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (!manageTarget) {
         showHelp("manage", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (manageTarget === "drafts") {
         const action2 = args[2];
         const restArgs2 = args.slice(3);
         if (flags.help) {
           showHelp("drafts", flags.help === "full");
-          process.exit(0);
+          return;
         }
         const client2 = requireClient(flags);
         let data2;
@@ -6878,7 +6906,7 @@ async function main() {
       if (manageTarget === "platform-api-requests") {
         if (flags.help) {
           showHelp("platform-api-requests", flags.help === "full");
-          process.exit(0);
+          return;
         }
         const client2 = requireClient(flags);
         const data2 = await sendRawRequest(client2, flags);
@@ -6892,13 +6920,13 @@ async function main() {
       const restArgs = args.slice(4);
       if (flags.help) {
         const helpCandidates = [action ? `${platform2} ${entity} ${action}` : void 0, entity ? `${platform2} ${entity}` : void 0, platform2];
-        for (const helpKey of helpCandidates) if (helpKey && showHelp(helpKey, flags.help === "full")) process.exit(0);
+        for (const helpKey of helpCandidates) if (helpKey && showHelp(helpKey, flags.help === "full")) return;
         printHelp(USAGE);
-        process.exit(0);
+        return;
       }
       if (!entity) {
         showHelp(platform2, flags.help === "full");
-        process.exit(0);
+        return;
       }
       const client = requireClient(flags);
       let data;
@@ -6940,7 +6968,7 @@ async function main() {
           case "campaigns": {
             if (!action) {
               showHelp("meta campaigns", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -6967,7 +6995,7 @@ async function main() {
           case "adsets": {
             if (!action) {
               showHelp("meta adsets", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -6994,7 +7022,7 @@ async function main() {
           case "ads": {
             if (!action) {
               showHelp("meta ads", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7029,7 +7057,7 @@ async function main() {
           case "lead-forms": {
             if (!action) {
               showHelp("meta lead-forms", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7115,7 +7143,7 @@ async function main() {
           case "assets": {
             if (!action) {
               showHelp("google assets", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7143,7 +7171,7 @@ async function main() {
           case "media": {
             if (!action || flags.help) {
               showHelp("google media", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "upload":
@@ -7157,7 +7185,7 @@ async function main() {
           case "campaigns": {
             if (!action) {
               showHelp("google campaigns", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7182,7 +7210,7 @@ async function main() {
           case "ad-groups": {
             if (!action) {
               showHelp("google ad-groups", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7207,7 +7235,7 @@ async function main() {
           case "ads": {
             if (!action) {
               showHelp("google ads", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7234,7 +7262,7 @@ async function main() {
           case "keywords": {
             if (!action) {
               showHelp("google keywords", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7254,7 +7282,7 @@ async function main() {
                 const negativesAction = restArgs[0];
                 if (!negativesAction || flags.help) {
                   showHelp("google keywords negatives", flags.help === "full");
-                  process.exit(0);
+                  return;
                 }
                 switch (negativesAction) {
                   case "list":
@@ -7276,7 +7304,7 @@ async function main() {
                 const negativeListsAction = restArgs[0];
                 if (!negativeListsAction || flags.help) {
                   showHelp("google keywords negative-lists", flags.help === "full");
-                  process.exit(0);
+                  return;
                 }
                 const negativeListArgs = restArgs.slice(1);
                 switch (negativeListsAction) {
@@ -7330,7 +7358,7 @@ async function main() {
           case "conversions": {
             if (!action || flags.help) {
               showHelp("google conversions", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "upload":
@@ -7396,7 +7424,7 @@ async function main() {
           case "media": {
             if (!action || flags.help) {
               showHelp("tiktok media", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7414,7 +7442,7 @@ async function main() {
           case "campaigns": {
             if (!action) {
               showHelp("tiktok campaigns", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7436,7 +7464,7 @@ async function main() {
           case "ad-groups": {
             if (!action) {
               showHelp("tiktok ad-groups", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7458,7 +7486,7 @@ async function main() {
           case "ads": {
             if (!action) {
               showHelp("tiktok ads", flags.help === "full");
-              process.exit(0);
+              return;
             }
             switch (action) {
               case "list":
@@ -7522,17 +7550,17 @@ async function main() {
       const libraryTarget = args[1];
       if (flags.help && !libraryTarget) {
         showHelp("library", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (!libraryTarget) {
         showHelp("library", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (libraryTarget === "advertisers") {
         const action = args[2];
         if (flags.help || !action) {
           showHelp("library advertisers", flags.help === "full");
-          process.exit(0);
+          return;
         }
         const client = requireClient(flags);
         if (action === "add") {
@@ -7553,7 +7581,8 @@ async function main() {
           const query = args.slice(3).join(" ");
           if (!query) {
             console.error("Usage: adkit library advertisers search <query>");
-            process.exit(1);
+            process.exitCode = 1;
+            return;
           }
           flags.search = query;
           const data = await listAdvertisers(client, [], flags);
@@ -7610,7 +7639,7 @@ ${pageInfo}`);
         const action = args[2];
         if (flags.help) {
           showHelp("library ads", flags.help === "full");
-          process.exit(0);
+          return;
         }
         const client = requireClient(flags);
         if (action && action !== "list") {
@@ -7621,7 +7650,7 @@ ${pageInfo}`);
           const hasFilters = ["platform", "status", "format", "min-days", "max-days", "language", "min-score", "min-spend", "query", "search", "advertiser", "ids", "sort"].some((f) => typeof flags[f] === "string");
           if (!action && !hasFilters) {
             showHelp("library ads", flags.help === "full");
-            process.exit(0);
+            return;
           }
           const data = await listLibraryAds(client, args.slice(3), flags);
           if (wantsJson(flags)) printResult(data, flags, "No ads found. Try adjusting your filters.");
@@ -7654,11 +7683,11 @@ ${pageInfo}`);
       const studioTarget = args[1];
       if (flags.help && !studioTarget) {
         showHelp("studio", flags.help === "full");
-        process.exit(0);
+        return;
       }
       if (!studioTarget) {
         showHelp("studio", flags.help === "full");
-        process.exit(0);
+        return;
       }
       let data;
       let emptyHint;
@@ -7668,7 +7697,7 @@ ${pageInfo}`);
           const restArgs = args.slice(3);
           if (flags.help) {
             showHelp("studio ads", flags.help === "full");
-            process.exit(0);
+            return;
           }
           const client = requireClient(flags);
           switch (action) {
@@ -7699,7 +7728,7 @@ ${pageInfo}`);
           const restArgs = args.slice(3);
           if (flags.help) {
             showHelp("studio media", flags.help === "full");
-            process.exit(0);
+            return;
           }
           const client = requireClient(flags);
           switch (action) {
@@ -7731,7 +7760,7 @@ ${pageInfo}`);
         case "share":
           if (flags.help) {
             showHelp("studio share", flags.help === "full");
-            process.exit(0);
+            return;
           }
           data = await shareAd(requireClient(flags), args.slice(2), flags);
           break;
@@ -7745,7 +7774,7 @@ ${pageInfo}`);
       const action = args[1];
       if (flags.help) {
         showHelp("projects", flags.help === "full");
-        process.exit(0);
+        return;
       }
       const client = requireClient(flags, { projectOptional: true });
       switch (action) {
@@ -7808,6 +7837,7 @@ ${pageInfo}`);
           ...err.instructions && { instructions: err.instructions },
           ...err.actionUrl && { actionUrl: err.actionUrl },
           ...err.suggestion && { suggestion: err.suggestion },
+          ...err.notice && { notice: err.notice },
           ...shouldNudgeFeedback && { hint: "If this error is unexpected, report it using: adkit feedback" }
         });
         console.error(errorPayload);
@@ -7835,7 +7865,8 @@ ${pageInfo}`);
       INVALID_API_KEY: 4,
       NOT_AUTHENTICATED: 4
     };
-    process.exit(err instanceof CliError ? EXIT_CODES[err.code] ?? 1 : 1);
+    process.exitCode = err instanceof CliError ? EXIT_CODES[err.code] ?? 1 : 1;
+    return;
   } finally {
     if (args[0] !== "update") printUpdateNotice();
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.12.24",
+  "version": "1.12.25",
   "description": "The Ads CLI for AI agents — manage Meta & Google ad campaigns, browse the ad library, and generate creatives from your terminal.",
   "keywords": [
     "ads cli",