@jacebenson/jsn 3.0.6 → 3.1.1

package/src/commands/dev/_generic.js

@@ -2,8 +2,7 @@
 
 import { formatRecordForDisplay, getStringField, isHexString, parseDataArg } from '../../helpers.js';
 import { getCurrentUser, getCurrentApplication } from '../../context.js';
-import readline from 'node:readline';
-import search from '@inquirer/search';
+import { paginatedSearch } from '../../paginated-search.js';
 import { isTTY, FormatAuto } from '../../output.js';
 
 function vowelArticle(word) {
@@ -16,13 +15,13 @@ function buildHints(name, singular, readOnly) {
   if (!readOnly) {
     crumbs.push({
       action: 'create',
-      cmd: `jsn dev ${name} create --name ... --label "..."`,
+      cmd: `jsn ${name} create --name ... --label "..."`,
       description: `Create ${vowelArticle(singular)} ${singular}`,
     });
   }
   crumbs.push({
     action: 'show',
-    cmd: `jsn dev ${name} show <name_or_sys_id>`,
+    cmd: `jsn ${name} show <name_or_sys_id>`,
     description: `Show ${singular} details`,
   });
   return crumbs;
@@ -81,15 +80,16 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
   const singular = toSingular(name, opts.singular);
   const readOnly = opts.readOnly || false;
   const scopeValidation = opts.scopeValidation || false;
+  const extraQuery = opts.extraQuery || '';
   const showSummary = opts.showSummary || ((record, id) => `${singular.charAt(0).toUpperCase() + singular.slice(1)}: ${getStringField(record, 'name') || id}`);
   const showBreadcrumbs = opts.showBreadcrumbs || ((record, id) => {
     const crumbs = [
-      { action: 'list', cmd: `jsn dev ${name} list`, description: `Back to all ${name}` },
+      { action: 'list', cmd: `jsn ${name} list`, description: `Back to all ${name}` },
     ];
     if (!readOnly) {
       crumbs.unshift(
-        { action: 'delete', cmd: `jsn dev ${name} delete ${id}`, description: `Delete this ${singular}` },
-        { action: 'update', cmd: `jsn dev ${name} update ${id} --data '{...}'`, description: `Update this ${singular}` }
+        { action: 'delete', cmd: `jsn ${name} delete ${id}`, description: `Delete this ${singular}` },
+        { action: 'update', cmd: `jsn ${name} update ${id} --data '{...}'`, description: `Update this ${singular}` }
       );
     }
     return crumbs;
@@ -104,71 +104,58 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
         builder: (y) => y
           .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true^priority=1")' })
           .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "name,label,super_class")' })
-          .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' }),
+          .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
         handler: wrap(async (argv, app) => {
           const query = argv.query || '';
           const columns = argv.columns ? argv.columns.split(',') : defaultColumns;
           const limit = argv.limit;
 
-          // Interactive picker in TTY with auto format and no explicit query
+          // Interactive picker with pagination
           const interactive = isTTY(process.stdout) && isTTY(process.stdin);
           if (interactive && app.output.getFormat() === FormatAuto && !query) {
-            const pickerColumns = ['sys_id', 'name', ...columns.filter(c => c !== 'name' && c !== 'sys_id')];
-            const pickerParams = new URLSearchParams();
-            pickerParams.set('sysparm_limit', String(limit));
-            pickerParams.set('sysparm_display_value', 'all');
-            pickerParams.set('sysparm_fields', pickerColumns.join(','));
-            pickerParams.set('sysparm_query', 'ORDERBYDESCsys_updated_on');
+            // Get total count
+            let totalCount = 0;
+            try {
+              totalCount = await app.sdk.aggregateCount(table, extraQuery || '');
+            } catch { /* non-critical */ }
 
-            const pickerRecords = await app.sdk.list(table, pickerParams);
-            if (pickerRecords.length === 0) {
-              app.ok({
-                table,
-                count: 0,
-                columns: pickerColumns,
-                records: [],
-                pagination: { limit, offset: 0 },
-                context: { instance_url: app.getEffectiveInstance() },
-              }, {
-                summary: `0 ${name}(s)`,
-                breadcrumbs: buildHints(name, singular, readOnly),
+            const source = async (term, offset, { signal } = {}) => {
+              const params = new URLSearchParams();
+              params.set('sysparm_limit', String(limit));
+              params.set('sysparm_display_value', 'all');
+              params.set('sysparm_fields', ['sys_id', 'name', 'sys_scope'].join(','));
+              if (term) {
+                params.set('sysparm_query', `nameLIKE${term}^ORDERBYDESCsys_updated_on`);
+              } else {
+                params.set('sysparm_query', (extraQuery ? extraQuery + '^' : '') + 'ORDERBYDESCsys_updated_on');
+                params.set('sysparm_offset', String(offset));
+              }
+              const records = await app.sdk.list(table, params);
+              return records.map(r => {
+                const recordName = getStringField(r, 'name') || getStringField(r, 'sys_id');
+                const scope = getStringField(r, 'sys_scope') || '';
+                let label = recordName;
+                if (scope && scope !== 'global') label += ` [${scope}]`;
+                return { name: label, value: recordName };
               });
-              return;
-            }
+            };
 
-            const choices = pickerRecords.map(r => {
-              const recordName = getStringField(r, 'name') || getStringField(r, 'sys_id');
-              const scope = getStringField(r, 'sys_scope') || '';
-              let label = recordName;
-              if (scope && scope !== 'global') label += ` [${scope}]`;
-              return { name: label, value: recordName };
+            const selectedName = await paginatedSearch({
+              message: `Select ${vowelArticle(singular)} ${singular}`,
+              pageSize: 10,
+              totalCount,
+              source,
             });
 
-            let selectedName;
-            try {
-              selectedName = await search({
-                message: `Select ${vowelArticle(singular)} ${singular}:`,
-                source: async (input) => {
-                  if (!input) return choices;
-                  const term = input.toLowerCase();
-                  return choices.filter(c => c.name.toLowerCase().includes(term));
-                },
-              });
-            } catch (err) {
-              if (err.name === 'ExitPromptError' || (err.message && err.message.includes('force closed'))) {
-                return;
-              }
-              throw err;
-            }
-
             if (selectedName) {
+              const recordName = typeof selectedName === 'object' ? selectedName.value : selectedName;
               const showParams = new URLSearchParams();
-              showParams.set('sysparm_query', `name=${selectedName}`);
+              showParams.set('sysparm_query', `name=${recordName}`);
               showParams.set('sysparm_display_value', 'all');
               showParams.set('sysparm_limit', '1');
               const showRecords = await app.sdk.list(table, showParams);
               if (showRecords.length === 0) {
-                throw new Error(`${singular} not found: ${selectedName}`);
+                throw new Error(`${singular} not found: ${recordName}`);
               }
               const record = showRecords[0];
               record._context = { instance_url: app.getEffectiveInstance(), table };
@@ -176,10 +163,10 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
                 await opts.onShow(record, app);
               }
               app.ok(record, {
-                summary: `${singular.charAt(0).toUpperCase() + singular.slice(1)}: ${selectedName}`,
+                summary: `${singular.charAt(0).toUpperCase() + singular.slice(1)}: ${recordName}`,
                 breadcrumbs: [
-                  ...(readOnly ? [] : [{ action: 'update', cmd: `jsn dev ${name} update ${selectedName} --data '{...}'`, description: `Update this ${singular}` }]),
-                  { action: 'list', cmd: `jsn dev ${name} list`, description: `Back to all ${name}` },
+                  ...(readOnly ? [] : [{ action: 'update', cmd: `jsn ${name} update ${recordName} --data '{...}'`, description: `Update this ${singular}` }]),
+                  { action: 'list', cmd: `jsn ${name} list`, description: `Back to all ${name}` },
                 ],
               });
             }
@@ -191,7 +178,8 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
           params.set('sysparm_limit', String(limit));
           params.set('sysparm_display_value', 'all');
           params.set('sysparm_fields', ['sys_id', ...columns].join(','));
-          const q = query ? query + '^ORDERBYDESCsys_updated_on' : 'ORDERBYDESCsys_updated_on';
+          const baseQ = extraQuery ? extraQuery + '^' : '';
+          const q = query ? query + '^ORDERBYDESCsys_updated_on' : (baseQ + 'ORDERBYDESCsys_updated_on');
           params.set('sysparm_query', q);
           const records = await app.sdk.list(table, params);
           app.ok({
@@ -256,7 +244,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
             app.ok(record, {
               summary: `Created ${singular}`,
               breadcrumbs: [
-                { action: 'show', cmd: `jsn dev ${name} show ${getStringField(record, 'name') || getStringField(record, 'sys_id')}`, description: `View the new ${singular}` },
+                { action: 'show', cmd: `jsn ${name} show ${getStringField(record, 'name') || getStringField(record, 'sys_id')}`, description: `View the new ${singular}` },
               ],
             });
           }),
@@ -284,7 +272,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
             if (scopeValidation) {
               const scopeErr = await checkScope(app.sdk, recordScope);
               if (scopeErr) {
-                throw new Error(`record is in scope '${scopeErr.recordScope}', but your current scope is '${scopeErr.currentScope}'. Switch scope first: jsn dev scopes set ${scopeErr.recordScope}`);
+                throw new Error(`record is in scope '${scopeErr.recordScope}', but your current scope is '${scopeErr.currentScope}'. Switch scope first: jsn scopes set ${scopeErr.recordScope}`);
               }
             }
 
@@ -315,7 +303,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
             if (scopeValidation) {
               const scopeErr = await checkScope(app.sdk, recordScope);
               if (scopeErr) {
-                throw new Error(`record is in scope '${scopeErr.recordScope}', but your current scope is '${scopeErr.currentScope}'. Switch scope first: jsn dev scopes set ${scopeErr.recordScope}`);
+                throw new Error(`record is in scope '${scopeErr.recordScope}', but your current scope is '${scopeErr.currentScope}'. Switch scope first: jsn scopes set ${scopeErr.recordScope}`);
               }
             }
 
@@ -358,7 +346,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
         console.log('  update      Update a record');
         console.log('  delete      Delete a record');
       }
-      console.log(`\nRun "jsn dev ${name} <command> --help" for details.`);
+      console.log(`\nRun "jsn ${name} <command> --help" for details.`);
     },
   };
 }

package/src/commands/dev/_simple.js

@@ -97,4 +97,31 @@ export const securitytypesCmd = (wrap) => buildDevCmd('securitytypes', 'sys_secu
 export const uxscriptsCmd = (wrap) => buildDevCmd('uxscripts', 'sys_ux_lib_source_script', ['uxscript', 'ux'], ['name', 'active', 'sys_scope'], wrap, { singular: 'UX script', scopeValidation: true });
 export const aliasesCmd = (wrap) => buildDevCmd('aliases', 'sys_alias', ['alias', 'als'], ['name', 'table', 'sys_scope'], wrap, { singular: 'alias', scopeValidation: true });
 export const catalogscriptsCmd = (wrap) => buildDevCmd('catalogscripts', 'catalog_script_client', ['catalogscript', 'cs'], ['name', 'table', 'active', 'sys_scope'], wrap, { singular: 'catalog script', scopeValidation: true });
+
+// ── Automation: Async ──
+export const scriptactionsCmd = (wrap) => buildDevCmd('scriptactions', 'sysevent_script_action', ['scriptaction'], ['name', 'active', 'sys_scope'], wrap, { singular: 'script action', scopeValidation: true });
+export const scheduledjobsCmd = (wrap) => buildDevCmd('scheduledjobs', 'sysauto_script', ['scheduledjob'], ['name', 'active', 'run_type', 'sys_scope'], wrap, { singular: 'scheduled job', scopeValidation: true });
+export const asyncrulesCmd = (wrap) => buildDevCmd('asyncrules', 'sys_script', ['asyncrule'], ['name', 'collection', 'active', 'order', 'sys_scope'], wrap, { singular: 'async business rule', scopeValidation: true, extraQuery: 'order>=1000' });
+export const triggersCmd = (wrap) => buildDevCmd('triggers', 'sysevent_register', ['trigger'], ['name', 'event_name', 'active', 'sys_scope'], wrap, { singular: 'event trigger', scopeValidation: true });
+
+// ── Automation: In Memory ──
+export const workflowsCmd = (wrap) => buildDevCmd('workflows', 'wf_workflow', ['workflow'], ['name', 'table', 'active', 'sys_scope'], wrap, { singular: 'workflow', scopeValidation: true, readOnly: true });
+export const decisiontablesCmd = (wrap) => buildDevCmd('decisiontables', 'sys_decision', ['decisiontable'], ['name', 'active', 'sys_scope'], wrap, { singular: 'decision table', scopeValidation: true, readOnly: true });
+export const assignmentsCmd = (wrap) => buildDevCmd('assignments', 'sysrule_assignment', ['assignment'], ['name', 'active', 'sys_scope'], wrap, { singular: 'assignment rule', scopeValidation: true, readOnly: true });
+
+// ── Automation: Inbound ──
+export const emailCmd = (wrap) => buildDevCmd('email', 'sysevent_email_action', ['emails'], ['name', 'active', 'event_name', 'sys_scope'], wrap, { singular: 'inbound email action', scopeValidation: true });
+
+// ── Automation: Outbound ──
+export const restmessageCmd = (wrap) => buildDevCmd('restmessage', 'sys_rest_message', ['rm', 'restmsg'], ['name', 'endpoint', 'active', 'sys_scope'], wrap, { singular: 'REST message', scopeValidation: true });
+export const restmethodsCmd = (wrap) => buildDevCmd('restmethods', 'sys_rest_message_fn', ['restmethod'], ['name', 'http_method', 'active', 'sys_scope'], wrap, { singular: 'REST method', scopeValidation: true });
+export const soapmessagesCmd = (wrap) => buildDevCmd('soapmessages', 'sys_soap_message', ['soapmsg'], ['name', 'active', 'sys_scope'], wrap, { singular: 'SOAP message', scopeValidation: true });
+export const soapfunctionsCmd = (wrap) => buildDevCmd('soapfunctions', 'sys_soap_message_function', ['soapfunc'], ['name', 'active', 'sys_scope'], wrap, { singular: 'SOAP function', scopeValidation: true });
+
+// ── UX: Core UI ──
+export const uimacrosCmd = (wrap) => buildDevCmd('uimacros', 'sys_ui_macro', ['uimacro'], ['name', 'active', 'sys_scope'], wrap, { singular: 'UI macro', scopeValidation: true });
+
+// ── UX: Workspaces ──
+export const uxlistsCmd = (wrap) => buildDevCmd('uxlists', 'sys_ux_list', ['uxlist'], ['name', 'active', 'sys_scope'], wrap, { singular: 'workspace list', scopeValidation: true, readOnly: true });
+export const uxapplicabilityCmd = (wrap) => buildDevCmd('uxapplicability', 'sys_ux_applicability_m2m', ['uxapp'], ['name', 'active', 'sys_scope'], wrap, { singular: 'workspace applicability', scopeValidation: true, readOnly: true });
 export const cataloguipoliciesCmd = (wrap) => buildDevCmd('cataloguipolicies', 'catalog_ui_policy', ['cataloguipolicy', 'cup'], ['short_description', 'table', 'active', 'sys_scope'], wrap, { singular: 'catalog UI policy', scopeValidation: true });

package/src/commands/dev/b4rules.js

@@ -0,0 +1,5 @@
+import { buildDevCmd } from './_generic.js';
+
+// Before-query business rules — applies filters to GlideRecord queries before they execute.
+// These are sys_script records with order < 100.
+export const b4rulesCmd = (wrap) => buildDevCmd('b4rules', 'sys_script', ['b4rule'], ['name', 'collection', 'active', 'order', 'sys_scope'], wrap, { singular: 'before-query business rule', scopeValidation: true, extraQuery: 'order<100' });

package/src/commands/dev/eval.js

@@ -45,7 +45,7 @@ export function evalCmd(wrap) {
         summary: 'Script executed' + warning,
         breadcrumbs: [{
           action: 'eval',
-          cmd: 'jsn dev eval --script \'...\'',
+          cmd: 'jsn eval --script \'...\'',
           description: 'Execute a background script on the ServiceNow instance',
         }],
       });

package/src/commands/dev/flows.js

@@ -14,22 +14,24 @@ export function flowsCmd(wrap) {
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
             .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
-            .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' }),
+            .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
+            app.requireInstance();
             const columns = argv.columns ? argv.columns.split(',') : ['name', 'active', 'description', 'sys_created_by', 'sys_updated_on'];
             const query = argv.query || '';
 
             // Interactive picker
             const picked = await interactiveList({
               app, table: 'sys_hub_flow', singular: 'flow', columns, limit: argv.limit, query, labelField: 'name',
-              formatLabel: r => `${getStringField(r, 'name')} ${getStringField(r, 'active') === 'true' ? '' : '[inactive]'}`,
+              formatLabel: r => `${getStringField(r, 'active') === 'true' ? '🟢' : '🔴'} ${getStringField(r, 'name')}`,
             });
+            if (picked === undefined) return; // user cancelled
             if (picked) {
               const inspection = await app.sdk.inspectFlow(getStringField(picked, 'sys_id'));
               const formatted = formatFlowInspection(inspection, app.getEffectiveInstance());
               return app.ok({ ...inspection, _formatted: formatted }, {
                 summary: `Flow: ${inspection.flow.name}`,
-                breadcrumbs: [{ action: 'list', cmd: 'jsn dev flows list', description: 'Back to all flows' }],
+                breadcrumbs: [{ action: 'list', cmd: 'jsn flows list', description: 'Back to all flows' }],
               });
             }
 
@@ -61,7 +63,7 @@ export function flowsCmd(wrap) {
             app.ok(data, {
               summary: `Flow: ${inspection.flow.name}`,
               breadcrumbs: [
-                { action: 'list', cmd: 'jsn dev flows list', description: 'Back to all flows' },
+                { action: 'list', cmd: 'jsn flows list', description: 'Back to all flows' },
               ],
             });
           }),
@@ -73,7 +75,7 @@ export function flowsCmd(wrap) {
             .option('data', { type: 'string', describe: 'JSON data for the flow' }),
           handler: wrap(async (_argv, _app) => {
             throw new Error('Flow creation requires the Flow Designer GraphQL API - not yet implemented.\n'
-              + 'Use the ServiceNow web UI to create flows, then use "jsn dev flows list" to view them.');
+              + 'Use the ServiceNow web UI to create flows, then use "jsn flows list" to view them.');
           }),
         })
         .command({
@@ -83,7 +85,7 @@ export function flowsCmd(wrap) {
             .option('data', { type: 'string', describe: 'JSON data to update' }),
           handler: wrap(async (_argv, _app) => {
             throw new Error('Flow updates require the Flow Designer GraphQL API - not yet implemented.\n'
-              + 'Use the ServiceNow web UI to update flows, then use "jsn dev flows list" to view them.');
+              + 'Use the ServiceNow web UI to update flows, then use "jsn flows list" to view them.');
           }),
         })
         .command({
@@ -95,7 +97,22 @@ export function flowsCmd(wrap) {
           }),
         });
     },
-    handler: () => {},
+    handler: () => {
+      console.log('Manage Flow Designer flows from the sys_hub_flow table.');
+      console.log('');
+      console.log('Available subcommands:');
+      console.log('  list                  List flows');
+      console.log('  show <identifier>     Show flow details by name or sys_id');
+      console.log('  create                Create a new flow (not yet implemented)');
+      console.log('  update <identifier>   Update a flow (not yet implemented)');
+      console.log('  delete <identifier>   Delete a flow (not yet implemented)');
+      console.log('');
+      console.log('Run "jsn flows <command> --help" for details.');
+      console.log('');
+      console.log('Note: Flow inspection detail varies. V2 flows (with payload)');
+      console.log('show full action inputs and conditions. Subflows and V1 flows');
+      console.log('show step names only.');
+    },
   };
 }
 
@@ -168,7 +185,13 @@ function formatFlowInspection(inspection, instanceURL) {
   lines.push('');
   lines.push('⚡ FLOW STRUCTURE');
   lines.push('─'.repeat(50));
-  lines.push(...formatFlowStructure(inspection));
+  const structureLines = formatFlowStructure(inspection);
+  lines.push(...structureLines);
+  // Note limitation for V1/subflows without payload detail
+  if (!inspection.payload || Object.keys(inspection.payload).length === 0) {
+    lines.push('');
+    lines.push('  (step detail limited — this flow lacks a V2 payload)');
+  }
 
   lines.push('');
   return lines.join('\n') + '\n';