@klevar/portal-cli 0.1.3 → 0.1.4

package/dist/bin/klevar-portal.js

@@ -1,5 +1,22 @@
 #!/usr/bin/env node
-// @ts-expect-error legacy JavaScript execution engine is copied during post-build.
-await import('../lib/legacy-runner.js');
+try {
+    // @ts-expect-error legacy JavaScript execution engine is copied during post-build.
+    await import('../lib/legacy-runner.js');
+}
+catch (err) {
+    if (err &&
+        typeof err === 'object' &&
+        'message' in err &&
+        typeof err.message === 'string' &&
+        err.message.startsWith('CLI_EXIT_')) {
+        process.exitCode =
+            'code' in err && typeof err.code === 'number'
+                ? err.code
+                : Number(err.message.replace('CLI_EXIT_', '')) || 1;
+    }
+    else {
+        throw err;
+    }
+}
 export {};
 //# sourceMappingURL=klevar-portal.js.map

package/dist/bin/klevar-portal.js.map

@@ -1 +1 @@
-{"version":3,"file":"klevar-portal.js","sourceRoot":"","sources":["../../bin/klevar-portal.ts"],"names":[],"mappings":";AAEA,mFAAmF;AACnF,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"klevar-portal.js","sourceRoot":"","sources":["../../bin/klevar-portal.ts"],"names":[],"mappings":";AAEA,IAAI,CAAC;IACH,mFAAmF;IACnF,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAC1C,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,IACE,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,SAAS,IAAI,GAAG;QAChB,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,EACnC,CAAC;QACD,OAAO,CAAC,QAAQ;YACd,MAAM,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAC3C,CAAC,CAAC,GAAG,CAAC,IAAI;gBACV,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/lib/legacy-runner.js

@@ -25,6 +25,18 @@ import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { COMMANDS } from '../commands/index.js';
 
+class CliExit extends Error {
+  constructor(code = 1) {
+    super(`CLI_EXIT_${code}`);
+    this.code = code;
+  }
+}
+
+function exitGracefully(code = 1) {
+  process.exitCode = code;
+  throw new CliExit(code);
+}
+
 // ── Credential Loading ──────────────────────────────────────────
 
 function loadEnvFile(filePath) {
@@ -58,7 +70,7 @@ function requireApiKey() {
   if (!API_KEY) {
     console.error('Error: PORTAL_API_KEY is required');
     console.error('Set it via env var or create ~/.klevar/portal.env');
-    process.exit(2);
+    exitGracefully(2);
   }
 }
 
@@ -66,7 +78,7 @@ function requirePortalToken() {
   if (!PORTAL_TOKEN) {
     console.error('Error: PORTAL_TOKEN is required for portal commands');
     console.error('Set it via env var, --portal-token, or ~/.klevar/portal.env');
-    process.exit(2);
+    exitGracefully(2);
   }
 }
 
@@ -113,7 +125,7 @@ async function api(method, path, body, auth = 'apiKey') {
   if (!res.ok) {
     const err = await res.json().catch(() => ({ error: { message: res.statusText } }));
     printApiError(res.status, err);
-    process.exit(1);
+    exitGracefully(1);
   }
 
   if (res.status === 204) return null;
@@ -137,7 +149,7 @@ async function apiDownload(path, outputPath, auth = 'apiKey') {
   if (!res.ok) {
     const err = await res.json().catch(() => ({ error: { message: res.statusText } }));
     printApiError(res.status, err);
-    process.exit(1);
+    exitGracefully(1);
   }
 
   const contentType = res.headers.get('content-type') || '';
@@ -158,7 +170,7 @@ async function apiDownload(path, outputPath, auth = 'apiKey') {
 
   if (!outputPath) {
     console.error('Error: --output is required when the API returns PDF bytes');
-    process.exit(1);
+    exitGracefully(1);
   }
 
   const bytes = Buffer.from(await res.arrayBuffer());
@@ -170,7 +182,7 @@ async function downloadPublicUrl(url, outputPath) {
   const res = await fetch(url);
   if (!res.ok) {
     console.error(`Error ${res.status}: failed to download signed URL`);
-    process.exit(1);
+    exitGracefully(1);
   }
   const bytes = Buffer.from(await res.arrayBuffer());
   writeFileSync(outputPath, bytes);
@@ -209,7 +221,7 @@ async function apiMultipart(method, path, fields, filePaths) {
   if (!res.ok) {
     const err = await res.json().catch(() => ({ error: { message: res.statusText } }));
     printApiError(res.status, err);
-    process.exit(1);
+    exitGracefully(1);
   }
   if (res.status === 204) return null;
   return res.json();
@@ -613,7 +625,7 @@ if (!resource || resource === 'help' || resource === '--help') {
   }
   console.log(`\nConfig: PORTAL_API_URL, PORTAL_API_KEY, PORTAL_TOKEN (or ~/.klevar/portal.env)`);
   console.log(`Target: ${BASE_URL}`);
-  process.exit(0);
+  exitGracefully(0);
 }
 
 // Resolve command key — handle single-word commands (e.g. "search <term>")
@@ -637,7 +649,7 @@ if (!cmd && COMMANDS[resource]) {
 if (!cmd) {
   console.error(`Unknown command: ${commandKey}`);
   console.error(`Run 'klevar-portal help' for available commands.`);
-  process.exit(1);
+  exitGracefully(1);
 }
 
 // Parse remaining args
@@ -659,7 +671,7 @@ if (pathParams.length > 0) {
     if (!value) {
       const ordinal = index === 0 ? 'an ID argument' : `argument ${index + 1} for :${paramName}`;
       console.error(`Command '${commandKey}' requires ${ordinal}.`);
-      process.exit(1);
+      exitGracefully(1);
     }
     path = path.replace(`:${paramName}`, value);
   });
@@ -708,14 +720,14 @@ if (commandKey === 'search') {
   const q = [id, ...positional.slice(1)].filter(Boolean).join(' ');
   if (!q) {
     console.error('Usage: search <term>');
-    process.exit(1);
+    exitGracefully(1);
   }
   const data = await api('GET', `/api/admin/search?q=${encodeURIComponent(q)}`);
   const hasResults = data.projects.length + data.tasks.length + data.updates.length > 0;
 
   if (!hasResults) {
     console.log(`No results for "${q}"`);
-    process.exit(0);
+    exitGracefully(0);
   }
 
   console.log(`\nSearch: "${q}"`);
@@ -750,7 +762,7 @@ if (commandKey === 'search') {
     console.log('\nUpdates: (none)');
   }
 
-  process.exit(0);
+  exitGracefully(0);
 }
 
 // ── Milestone Commands (custom logic: fetch → modify → PATCH) ──
@@ -759,7 +771,7 @@ if (cmd.method === 'CUSTOM' && resource === 'milestones') {
   const projectId = id;
   if (!projectId) {
     console.error('Usage: milestones <action> <projectId> [--name "..."] or [index]');
-    process.exit(1);
+    exitGracefully(1);
   }
 
   // Fetch current project
@@ -777,23 +789,23 @@ if (cmd.method === 'CUSTOM' && resource === 'milestones') {
         console.log(`  ${i + 1}. ${icon} ${m.name} [${m.status}]`);
       });
     }
-    process.exit(0);
+    exitGracefully(0);
   }
 
   if (action === 'add') {
     const name = flags.name || positional[1];
-    if (!name) { console.error('Usage: milestones add <projectId> --name "Milestone name"'); process.exit(1); }
+    if (!name) { console.error('Usage: milestones add <projectId> --name "Milestone name"'); exitGracefully(1); }
     milestones.push({ name, status: 'pending' });
     await api('PATCH', `/api/admin/projects/${projectId}`, { milestonesJson: milestones });
     console.log(`Added milestone: ${name} (${milestones.length} total)`);
-    process.exit(0);
+    exitGracefully(0);
   }
 
   if (action === 'done' || action === 'undo' || action === 'remove') {
     const idx = parseInt(positional[1] || flags.index, 10) - 1;
     if (isNaN(idx) || idx < 0 || idx >= milestones.length) {
       console.error(`Invalid index. Use 1-${milestones.length}.`);
-      process.exit(1);
+      exitGracefully(1);
     }
     if (action === 'done') {
       milestones[idx].status = 'done';
@@ -808,11 +820,11 @@ if (cmd.method === 'CUSTOM' && resource === 'milestones') {
       await api('PATCH', `/api/admin/projects/${projectId}`, { milestonesJson: milestones });
       console.log(`Removed: ${removed[0].name} (${milestones.length} remaining)`);
     }
-    process.exit(0);
+    exitGracefully(0);
   }
 
   console.error(`Unknown milestone action: ${action}`);
-  process.exit(1);
+  exitGracefully(1);
 }
 
 // ── File Upload (multipart) ──
@@ -826,12 +838,12 @@ if (cmd.supportsFiles && flags.file) {
   if (!fields.visibility) fields.visibility = 'client';
   const data = await apiMultipart(cmd.method, path, fields, filePaths);
   formatOutput(data, commandKey);
-  process.exit(0);
+  exitGracefully(0);
 }
 
 if (cmd.method === 'DOWNLOAD') {
   await apiDownload(path, flags.output, cmd.auth);
-  process.exit(0);
+  exitGracefully(0);
 }
 
 // Execute

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klevar/portal-cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "First-class npm CLI for the Klevar Client Management Portal",
   "type": "module",
   "bin": {