@jacebenson/jsn 4.3.7-dev.35 → 4.3.7-dev.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jacebenson/jsn",
-  "version": "4.3.7-dev.35",
+  "version": "4.3.7-dev.36",
   "description": "A command-line interface for ServiceNow that follows the Unix philosophy: simple, composable, and scriptable.",
   "type": "module",
   "bin": {

package/src/commands/midservers.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import process from 'node:process';
 import { input, password as passwordPrompt, select } from '@inquirer/prompts';
 import { confirmDelete, formatRecordForDisplay, getStringField, interactiveList, canPrompt, assertSafeExactMatch } from '../helpers.js';
 import { FormatAuto } from '../output.js';
@@ -171,6 +172,40 @@ function midDiagnosticsCommand(kind, wrap) {
   };
 }
 
+// Progress for long, otherwise-silent direct-install phases. Human terminals
+// only, and on stderr, so the stdout envelope and --json output stay clean.
+export function directProgress(app) {
+  const human = app.output?.getFormat() === FormatAuto && (canPrompt() || process.stderr.isTTY === true);
+  if (!human) return () => {};
+  const mib = bytes => (Number(bytes || 0) / (1024 * 1024)).toFixed(0);
+  return event => {
+    if (event.phase === 'download-start') {
+      process.stderr.write(`Downloading the official MID ZIP from ServiceNow (about 532 MiB).\n  ${event.archiveURL}\n`);
+    } else if (event.phase === 'download') {
+      const percent = event.total ? ` (${Math.floor((event.received / event.total) * 100)}%)` : '';
+      process.stderr.write(`\r  ${mib(event.received)} MiB${percent} downloaded...`);
+      if (event.done) process.stderr.write('\n');
+    } else if (event.phase === 'extract-start') {
+      process.stderr.write(`Extracting ${event.entries} files into ${event.installDir}...\n`);
+    } else if (event.phase === 'extract-done') {
+      process.stderr.write('Extraction complete. Configuring the MID Server...\n');
+    }
+  };
+}
+
+// A registration wait is minutes of silence otherwise; report elapsed progress.
+export function registrationProgress(app, timeoutMs) {
+  const human = app.output?.getFormat() === FormatAuto && (canPrompt() || process.stderr.isTTY === true);
+  if (!human) return undefined;
+  const seconds = Math.round(timeoutMs / 1000);
+  let lastReport = 0;
+  return elapsedMs => {
+    if (elapsedMs - lastReport < 15000) return;
+    lastReport = elapsedMs;
+    process.stderr.write(`Waiting for ServiceNow to register the MID Server... ${Math.round(elapsedMs / 1000)}s of ${seconds}s\n`);
+  };
+}
+
 async function listAgents(app, argv) {
   const columns = argv.columns
     ? [...new Set(argv.columns.split(',').map(column => column.trim()).filter(Boolean))]
@@ -266,10 +301,11 @@ async function promptMidCredentials(app, argv) {
   }
 }
 
-export async function waitForMidServerUp(app, name, timeoutMs, intervalMs) {
+export async function waitForMidServerUp(app, name, timeoutMs, intervalMs, onWait) {
   const started = Date.now();
   const fullName = name;
   while (Date.now() - started <= timeoutMs) {
+    onWait?.(Date.now() - started);
     const params = new URLSearchParams({
       sysparm_query: `name=${fullName}`,
       sysparm_limit: '1',
@@ -472,15 +508,24 @@ export function midserversCmd(wrap) {
             const existing = await app.sdk.list(AGENT_TABLE, new URLSearchParams({ sysparm_query: `name=${shortName}`, sysparm_fields: 'sys_id,name', sysparm_limit: '1' }));
             if (existing.length) throw new Error(`MID '${shortName}' already exists in ServiceNow; choose a new name. Existing runtime and record were not changed.`);
             const installation = await installDirectMidServer({
-              instanceURL: app.getEffectiveInstance(), ...credentials, name, directory: argv.directory, runNow: decision === 'start',
+              instanceURL: app.getEffectiveInstance(), ...credentials, name, directory: argv.directory,
+              runNow: decision === 'start', onProgress: directProgress(app),
             });
             if (installation.state === 'prepared') {
               app.ok(installation, { summary: `Prepared native MID '${installation.name}' in ${installation.installDir}; not started or registered. Start with jsn midservers start ${installation.name}${argv.directory ? ' --directory ' + JSON.stringify(installation.installDir) : ''}. Windows start runs in the foreground console; no service is installed.` });
               return;
             }
             let record;
-            try { record = await waitForMidServerUp(app, installation.name, Math.max(1, argv['wait-timeout']), Math.max(500, argv['wait-interval'])); }
+            const directWait = Math.max(1, argv['wait-timeout']);
+            const directInterval = Math.max(500, argv['wait-interval']);
+            const onWait = registrationProgress(app, directWait);
+            const started = Date.now();
+            try {
+              record = await waitForMidServerUp(app, installation.name, directWait, directInterval, onWait);
+              onWait?.(directWait);
+            }
             catch {
+              onWait?.(Math.max(directWait, Date.now() - started));
               app.ok({ ...installation, registration: 'pending', validated: false }, { summary: `Native MID start command completed; registration is pending. Runtime retained for diagnostics at ${installation.installDir}; no forced teardown.` });
               return;
             }

package/src/midserver-direct.js

@@ -71,20 +71,28 @@ function checkParents(directory, platform) {
   }
 }
 
-export async function downloadMidZip(url, archive, fetchImpl = fetch) {
+export async function downloadMidZip(url, archive, fetchImpl = fetch, onProgress) {
   const response = await fetchImpl(url, { redirect: 'error', signal: AbortSignal.timeout(600000) });
   if (!response.ok || !response.body) throw new Error(`MID ZIP download failed (HTTP ${response.status})`);
   const length = Number(response.headers.get('content-length'));
   if (length > MAX_ARCHIVE) throw new Error('MID ZIP exceeds 1 GiB download limit');
+  onProgress?.({ phase: 'download', received: 0, total: Number.isFinite(length) ? length : 0 });
   const fd = fs.openSync(archive, 'wx', 0o600);
   let size = 0;
+  let reported = 0;
+  const step = Math.max(4 * 1024 * 1024, Math.floor((Number.isFinite(length) ? length : MAX_ARCHIVE) / 100));
   try {
     for await (const chunk of response.body) {
       size += chunk.length;
       if (size > MAX_ARCHIVE) throw new Error('MID ZIP exceeds 1 GiB download limit');
       fs.writeSync(fd, chunk);
+      if (onProgress && size - reported >= step) {
+        reported = size;
+        onProgress({ phase: 'download', received: size, total: Number.isFinite(length) ? length : 0 });
+      }
     }
     if (length && size !== length) throw new Error('Incomplete MID ZIP download');
+    onProgress?.({ phase: 'download', received: size, total: size, done: true });
   } finally { fs.closeSync(fd); }
 }
 
@@ -189,7 +197,7 @@ export function removeDirectInstallation(metadata, run = defaultRun) {
 }
 
 export async function installDirectMidServer({ instanceURL, username, password, name, directory, releaseName: suppliedRelease,
-  runNow = false, platform = process.platform, arch = process.arch, fetchImpl = fetch, download = downloadMidZip,
+  runNow = false, platform = process.platform, arch = process.arch, fetchImpl = fetch, download = downloadMidZip, onProgress,
   protect = protectDirectory, run = defaultRun }) {
   const native = detectDirectPlatform(platform, arch);
   if (native === 'linux' && process.getuid?.() === 0) throw new Error('Run direct MID installation as a non-root user');
@@ -216,9 +224,12 @@ export async function installDirectMidServer({ instanceURL, username, password,
   let prepared = false;
   try {
     protect(installDir, native);
-    await download(archiveURL, archive, fetchImpl);
+    onProgress?.({ phase: 'download-start', archiveURL, platform: native, installDir, name: shortName });
+    await download(archiveURL, archive, fetchImpl, onProgress);
     const entries = inspectMidZip(archive);
+    onProgress?.({ phase: 'extract-start', entries: entries.length, installDir });
     await extractMidZip(archive, installDir, entries);
+    onProgress?.({ phase: 'extract-done', entries: entries.length, installDir });
     const agent = path.join(installDir, 'agent');
     for (const filename of ['config.xml', 'conf/wrapper-override.conf', native === 'linux' ? 'bin/mid.sh' : 'bin/mid.bat']) {
       if (!fs.statSync(path.join(agent, filename)).isFile()) throw new Error(`Vendor ZIP missing ${filename}`);