@jacebenson/jsn 0.0.3

package/src/commands/dev/forms.js

@@ -0,0 +1,313 @@
+import chalk from 'chalk';
+import { getStringField } from '../../helpers.js';
+
+// ─── Helpers ───
+
+function getDisplayValue(record, key) {
+  if (!record || typeof record !== 'object') return '';
+  const val = record[key];
+  if (val == null) return '';
+  if (typeof val === 'string') return val;
+  if (typeof val === 'object') {
+    if (val.display_value != null && val.display_value !== '') return String(val.display_value);
+    if (val.value != null) return String(val.value);
+  }
+  return String(val);
+}
+
+function getIntValue(record, key) {
+  if (!record || typeof record !== 'object') return 0;
+  const val = record[key];
+  if (val == null) return 0;
+  if (typeof val === 'number') return Math.floor(val);
+  if (typeof val === 'string') {
+    const n = parseInt(val, 10);
+    return isNaN(n) ? 0 : n;
+  }
+  if (typeof val === 'object' && val.value != null) {
+    const n = parseInt(val.value, 10);
+    return isNaN(n) ? 0 : n;
+  }
+  return 0;
+}
+
+function getBoolValue(record, key) {
+  if (!record || typeof record !== 'object') return false;
+  const val = record[key];
+  if (typeof val === 'boolean') return val;
+  if (typeof val === 'string') return val === 'true';
+  if (typeof val === 'object' && val.value != null) return String(val.value) === 'true';
+  return false;
+}
+
+// ─── Commands ───
+
+export function formsCmd(wrap) {
+  return {
+    command: 'forms [subcommand]',
+    aliases: ['form', 'f'],
+    describe: 'Manage UI Forms',
+    builder: (yargs) => {
+      return yargs
+        .command({
+          command: 'list <table>',
+          aliases: ['ls'],
+          describe: 'List form views for a table',
+          builder: (y) => y
+            .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
+          handler: wrap(async (argv, app) => {
+            const table = argv.table;
+            const limit = argv.limit || 50;
+
+            const params = new URLSearchParams();
+            params.set('sysparm_limit', String(limit));
+            params.set('sysparm_fields', 'view');
+            params.set('sysparm_group_by', 'view');
+            params.set('sysparm_display_value', 'all');
+            const sysparmQuery = table ? `name=${table}^ORDERBYview` : 'ORDERBYview';
+            params.set('sysparm_query', sysparmQuery);
+
+            const records = await app.sdk.list('sys_ui_section', params);
+
+            const viewMap = new Map();
+            for (const record of records) {
+              const view = getDisplayValue(record, 'view');
+              if (view && !viewMap.has(view)) {
+                viewMap.set(view, true);
+              }
+            }
+
+            const views = Array.from(viewMap.keys()).sort();
+            const defaultViews = views.filter(v => v === 'Default view');
+            const workspaceViews = views.filter(v => v.toLowerCase().includes('workspace'));
+            const otherViews = views.filter(v => !defaultViews.includes(v) && !workspaceViews.includes(v));
+
+            const recordsOut = views.map(v => ({ view: v, table }));
+
+            app.ok({
+              table,
+              count: views.length,
+              default: defaultViews,
+              workspaces: workspaceViews,
+              other: otherViews,
+              records: recordsOut,
+              instance_url: app.getEffectiveInstance(),
+            }, {
+              summary: `${views.length} views for ${table}`,
+              breadcrumbs: [
+                { action: 'show', cmd: `jsn dev forms show ${table} --view "Default view"`, description: 'Show Default view layout' },
+              ],
+            });
+          }),
+        })
+        .command({
+          command: 'show <table>',
+          aliases: ['get'],
+          describe: 'Show form layout',
+          builder: (y) => y
+            .option('view', { type: 'string', default: 'Default view', describe: 'View name' }),
+          handler: wrap(async (argv, app) => {
+            const table = argv.table;
+            const viewName = argv.view;
+
+            // Look up view sys_id
+            let viewSysID = '';
+            const viewParams = new URLSearchParams();
+            viewParams.set('sysparm_limit', '1');
+            viewParams.set('sysparm_fields', 'sys_id');
+            viewParams.set('sysparm_query', `name=${viewName}`);
+            try {
+              const viewRecords = await app.sdk.list('sys_ui_view', viewParams);
+              if (viewRecords.length > 0) {
+                viewSysID = getStringField(viewRecords[0], 'sys_id');
+              }
+            } catch {
+              // ignore
+            }
+
+            if (!viewSysID) {
+              viewParams.set('sysparm_query', `title=${viewName}`);
+              try {
+                const viewRecords = await app.sdk.list('sys_ui_view', viewParams);
+                if (viewRecords.length > 0) {
+                  viewSysID = getStringField(viewRecords[0], 'sys_id');
+                }
+              } catch {
+                // ignore
+              }
+            }
+
+            if (!viewSysID) {
+              viewSysID = viewName;
+            }
+
+            // Fetch sections
+            const params = new URLSearchParams();
+            params.set('sysparm_limit', '100');
+            params.set('sysparm_fields', 'sys_id,name,view,caption,header,order,active,sys_created_on,sys_updated_on');
+            params.set('sysparm_display_value', 'all');
+
+            const parts = [];
+            if (table) parts.push(`name=${table}`);
+            if (viewSysID) parts.push(`view=${viewSysID}`);
+            const sysparmQuery = parts.length > 0 ? `${parts.join('^')}^ORDERBYorder` : 'ORDERBYorder';
+            params.set('sysparm_query', sysparmQuery);
+
+            const records = await app.sdk.list('sys_ui_section', params);
+            if (records.length === 0) {
+              throw new Error(`no form sections found for ${table} with view "${viewName}"`);
+            }
+
+            // Parse sections
+            const sections = records.map(record => ({
+              sys_id: getStringField(record, 'sys_id'),
+              name: getDisplayValue(record, 'name'),
+              view: getDisplayValue(record, 'view'),
+              caption: getDisplayValue(record, 'caption'),
+              header: getDisplayValue(record, 'header'),
+              order: getIntValue(record, 'order'),
+              active: getBoolValue(record, 'active'),
+              createdOn: getDisplayValue(record, 'sys_created_on'),
+              updatedOn: getDisplayValue(record, 'sys_updated_on'),
+            }));
+
+            // Fetch elements for each section
+            const sectionElements = new Map();
+            for (const section of sections) {
+              const elemParams = new URLSearchParams();
+              elemParams.set('sysparm_limit', '100');
+              elemParams.set('sysparm_fields', 'sys_id,sys_ui_section,element,label,type,position,row,col,mandatory,read_only,visible');
+              elemParams.set('sysparm_display_value', 'all');
+              elemParams.set('sysparm_query', `sys_ui_section=${section.sys_id}^ORDERBYposition`);
+
+              try {
+                const elemRecords = await app.sdk.list('sys_ui_element', elemParams);
+                const elements = elemRecords.map(record => ({
+                  sys_id: getStringField(record, 'sys_id'),
+                  section: getStringField(record, 'sys_ui_section'),
+                  name: getDisplayValue(record, 'element'),
+                  label: getDisplayValue(record, 'label'),
+                  elementType: getDisplayValue(record, 'type'),
+                  position: getIntValue(record, 'position'),
+                  row: getIntValue(record, 'row'),
+                  column: getIntValue(record, 'col'),
+                  mandatory: getBoolValue(record, 'mandatory'),
+                  readOnly: getBoolValue(record, 'read_only'),
+                  visible: getBoolValue(record, 'visible'),
+                }));
+                sectionElements.set(section.sys_id, elements);
+              } catch {
+                sectionElements.set(section.sys_id, []);
+              }
+            }
+
+            // Build formatted output
+            const lines = [];
+            lines.push('');
+            lines.push(chalk.bold(chalk.hex('#e8a217')(`${table} (${viewName})`)));
+            lines.push('');
+
+            for (let i = 0; i < sections.length; i++) {
+              const section = sections[i];
+              const elements = sectionElements.get(section.sys_id) || [];
+
+              let sectionTitle = section.caption;
+              if (!sectionTitle && section.header && section.header !== 'false') {
+                sectionTitle = section.header;
+              }
+              if (!sectionTitle) {
+                sectionTitle = `Section ${i + 1}`;
+              }
+
+              lines.push(chalk.bold(chalk.hex('#666666')(`─ ${sectionTitle} ─`)));
+
+              if (elements.length === 0) {
+                lines.push(chalk.hex('#888888')('  (no fields)'));
+                lines.push('');
+                continue;
+              }
+
+              elements.sort((a, b) => a.position - b.position);
+
+              for (const elem of elements) {
+                if (elem.elementType && elem.elementType !== 'field') {
+                  continue;
+                }
+
+                let displayName = elem.name;
+                if (!displayName) displayName = elem.label;
+                if (!displayName) displayName = elem.elementType;
+
+                const indicators = [];
+                if (elem.mandatory) indicators.push('*');
+                if (elem.readOnly) indicators.push('(RO)');
+                const indicatorStr = indicators.length > 0 ? ` ${indicators.join(' ')}` : '';
+
+                lines.push(`  ${chalk.hex('#cccccc')(displayName)}${indicatorStr ? chalk.hex('#888888')(indicatorStr) : ''}`);
+              }
+
+              lines.push('');
+            }
+
+            lines.push('─────');
+            lines.push('');
+            lines.push(chalk.bold(chalk.hex('#e8a217')('Hints:')));
+            lines.push(`  ${`jsn dev forms list ${table}`.padEnd(50)}  ${chalk.hex('#888888')('List all views')}`);
+            lines.push(`  ${`jsn dev columns --table ${table}`.padEnd(50)}  ${chalk.hex('#888888')('View table columns')}`);
+            lines.push('');
+
+            const formatted = lines.join('\n');
+
+            // Build structured data for JSON/quiet mode
+            const sectionsData = sections.map(section => {
+              const elements = (sectionElements.get(section.sys_id) || [])
+                .filter(elem => !elem.elementType || elem.elementType === 'field')
+                .sort((a, b) => a.position - b.position)
+                .map(elem => ({
+                  sys_id: elem.sys_id,
+                  name: elem.name,
+                  label: elem.label,
+                  type: elem.elementType,
+                  position: elem.position,
+                  mandatory: elem.mandatory,
+                  read_only: elem.readOnly,
+                }));
+
+              let sectionTitle = section.caption;
+              if (!sectionTitle && section.header && section.header !== 'false') {
+                sectionTitle = section.header;
+              }
+              if (!sectionTitle) {
+                sectionTitle = 'Section';
+              }
+
+              return {
+                sys_id: section.sys_id,
+                caption: sectionTitle,
+                order: section.order,
+                elements,
+              };
+            });
+
+            app.ok({
+              table,
+              view: viewName,
+              sections: sectionsData,
+              _formatted: formatted,
+              _context: {
+                instance_url: app.getEffectiveInstance(),
+                table: 'sys_ui_section',
+              },
+            }, {
+              summary: `Form: ${table} (${viewName}) - ${sections.length} sections`,
+              breadcrumbs: [
+                { action: 'list', cmd: `jsn dev forms list ${table}`, description: 'List all views' },
+                { action: 'columns', cmd: `jsn dev columns --table ${table}`, description: 'View table columns' },
+              ],
+            });
+          }),
+        });
+    },
+    handler: () => {},
+  };
+}

package/src/commands/dev/lists.js

@@ -0,0 +1,233 @@
+import chalk from 'chalk';
+import { getStringField } from '../../helpers.js';
+
+// ─── Helpers ───
+
+function getDisplayValue(record, key) {
+  if (!record || typeof record !== 'object') return '';
+  const val = record[key];
+  if (val == null) return '';
+  if (typeof val === 'string') return val;
+  if (typeof val === 'object') {
+    if (val.display_value != null && val.display_value !== '') return String(val.display_value);
+    if (val.value != null) return String(val.value);
+  }
+  return String(val);
+}
+
+function getIntValue(record, key) {
+  if (!record || typeof record !== 'object') return 0;
+  const val = record[key];
+  if (val == null) return 0;
+  if (typeof val === 'number') return Math.floor(val);
+  if (typeof val === 'string') {
+    const n = parseInt(val, 10);
+    return isNaN(n) ? 0 : n;
+  }
+  if (typeof val === 'object' && val.value != null) {
+    const n = parseInt(val.value, 10);
+    return isNaN(n) ? 0 : n;
+  }
+  return 0;
+}
+
+// ─── Commands ───
+
+export function listsCmd(wrap) {
+  return {
+    command: 'lists [subcommand]',
+    aliases: ['list-layout', 'l'],
+    describe: 'Manage UI List layouts',
+    builder: (yargs) => {
+      return yargs
+        .command({
+          command: 'list <table>',
+          aliases: ['ls'],
+          describe: 'List list views for a table',
+          builder: (y) => y
+            .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
+          handler: wrap(async (argv, app) => {
+            const table = argv.table;
+            const limit = argv.limit || 50;
+
+            const params = new URLSearchParams();
+            params.set('sysparm_limit', String(limit));
+            params.set('sysparm_fields', 'view');
+            params.set('sysparm_group_by', 'view');
+            params.set('sysparm_display_value', 'all');
+            const sysparmQuery = table ? `name=${table}^ORDERBYview` : 'ORDERBYview';
+            params.set('sysparm_query', sysparmQuery);
+
+            const records = await app.sdk.list('sys_ui_list', params);
+
+            const viewMap = new Map();
+            for (const record of records) {
+              const view = getDisplayValue(record, 'view');
+              if (view && !viewMap.has(view)) {
+                viewMap.set(view, true);
+              }
+            }
+
+            const views = Array.from(viewMap.keys()).sort();
+            const defaultViews = views.filter(v => v === 'Default view');
+            const workspaceViews = views.filter(v => v.toLowerCase().includes('workspace'));
+            const otherViews = views.filter(v => !defaultViews.includes(v) && !workspaceViews.includes(v));
+
+            const recordsOut = views.map(v => ({ view: v, table }));
+
+            app.ok({
+              table,
+              count: views.length,
+              default: defaultViews,
+              workspaces: workspaceViews,
+              other: otherViews,
+              records: recordsOut,
+              instance_url: app.getEffectiveInstance(),
+            }, {
+              summary: `${views.length} list views for ${table}`,
+              breadcrumbs: [
+                { action: 'show', cmd: `jsn dev lists show ${table} --view "Default view"`, description: 'Show Default view columns' },
+              ],
+            });
+          }),
+        })
+        .command({
+          command: 'show <table>',
+          aliases: ['get'],
+          describe: 'Show list layout',
+          builder: (y) => y
+            .option('view', { type: 'string', default: 'Default view', describe: 'View name' }),
+          handler: wrap(async (argv, app) => {
+            const table = argv.table;
+            const viewName = argv.view;
+
+            // Look up view sys_id
+            let viewSysID = '';
+            const viewParams = new URLSearchParams();
+            viewParams.set('sysparm_limit', '1');
+            viewParams.set('sysparm_fields', 'sys_id');
+            viewParams.set('sysparm_query', `name=${viewName}`);
+            try {
+              const viewRecords = await app.sdk.list('sys_ui_view', viewParams);
+              if (viewRecords.length > 0) {
+                viewSysID = getStringField(viewRecords[0], 'sys_id');
+              }
+            } catch {
+              // ignore
+            }
+
+            if (!viewSysID) {
+              viewParams.set('sysparm_query', `title=${viewName}`);
+              try {
+                const viewRecords = await app.sdk.list('sys_ui_view', viewParams);
+                if (viewRecords.length > 0) {
+                  viewSysID = getStringField(viewRecords[0], 'sys_id');
+                }
+              } catch {
+                // ignore
+              }
+            }
+
+            if (!viewSysID) {
+              viewSysID = viewName;
+            }
+
+            // Fetch list layouts
+            const params = new URLSearchParams();
+            params.set('sysparm_limit', '10');
+            params.set('sysparm_fields', 'sys_id,name,view,parent,active,sys_created_on,sys_updated_on');
+            params.set('sysparm_display_value', 'all');
+
+            const parts = [];
+            if (table) parts.push(`name=${table}`);
+            if (viewSysID) parts.push(`view=${viewSysID}`);
+            const sysparmQuery = parts.length > 0 ? `${parts.join('^')}^ORDERBYsys_created_on` : 'ORDERBYsys_created_on';
+            params.set('sysparm_query', sysparmQuery);
+
+            const records = await app.sdk.list('sys_ui_list', params);
+            if (records.length === 0) {
+              throw new Error(`no list layout found for ${table} with view "${viewName}"`);
+            }
+
+            const mainLayout = records[0];
+            const layoutSysID = getStringField(mainLayout, 'sys_id');
+
+            // Fetch elements (columns) for the list
+            const elemParams = new URLSearchParams();
+            elemParams.set('sysparm_limit', '100');
+            elemParams.set('sysparm_fields', 'sys_id,list_id,element,position,type');
+            elemParams.set('sysparm_display_value', 'all');
+            elemParams.set('sysparm_query', `list_id=${layoutSysID}^ORDERBYposition`);
+
+            const elemRecords = await app.sdk.list('sys_ui_list_element', elemParams);
+
+            const elements = elemRecords.map(record => ({
+              sys_id: getStringField(record, 'sys_id'),
+              listID: getStringField(record, 'list_id'),
+              element: getDisplayValue(record, 'element'),
+              position: getIntValue(record, 'position'),
+              type: getDisplayValue(record, 'type'),
+            }));
+
+            elements.sort((a, b) => a.position - b.position);
+
+            // Build formatted output
+            const lines = [];
+            lines.push('');
+            lines.push(chalk.bold(chalk.hex('#e8a217')(`${table} (${viewName})`)));
+            lines.push('');
+
+            lines.push(chalk.bold(chalk.hex('#666666')('─ List Columns ─')));
+            if (elements.length === 0) {
+              lines.push(chalk.hex('#888888')('  (no columns defined)'));
+            } else {
+              for (let i = 0; i < elements.length; i++) {
+                const elem = elements[i];
+                lines.push(`  ${chalk.hex('#666666')(`${String(i + 1).padStart(2)}.`)}  ${chalk.hex('#cccccc')(elem.element)}`);
+              }
+            }
+            lines.push('');
+
+            lines.push('─────');
+            lines.push('');
+            lines.push(chalk.bold(chalk.hex('#e8a217')('Hints:')));
+            lines.push(`  ${`jsn dev lists list ${table}`.padEnd(50)}  ${chalk.hex('#888888')('List all views')}`);
+            lines.push(`  ${`jsn dev forms show ${table} --view "${viewName}"`.padEnd(50)}  ${chalk.hex('#888888')('Show form layout')}`);
+            lines.push('');
+
+            const formatted = lines.join('\n');
+
+            // Build structured data for JSON/quiet mode
+            const columnsData = elements.map(elem => {
+              const col = {
+                element: elem.element,
+                position: elem.position,
+              };
+              if (elem.type) {
+                col.type = elem.type;
+              }
+              return col;
+            });
+
+            app.ok({
+              table,
+              view: viewName,
+              columns: columnsData,
+              _formatted: formatted,
+              _context: {
+                instance_url: app.getEffectiveInstance(),
+                table: 'sys_ui_list',
+              },
+            }, {
+              summary: `List: ${table} (${viewName}) - ${elements.length} columns`,
+              breadcrumbs: [
+                { action: 'list', cmd: `jsn dev lists list ${table}`, description: 'List all views' },
+                { action: 'form', cmd: `jsn dev forms show ${table} --view "${viewName}"`, description: 'Show form layout' },
+              ],
+            });
+          }),
+        });
+    },
+    handler: () => {},
+  };
+}

package/src/commands/dev/logs.js

@@ -0,0 +1,51 @@
+import { formatRecordForDisplay } from '../../helpers.js';
+
+export function logsCmd(wrap) {
+  return {
+    command: 'logs [subcommand]',
+    aliases: ['log'],
+    describe: 'Query system logs',
+    builder: (yargs) => {
+      return yargs
+        .command({
+          command: 'list',
+          aliases: ['ls'],
+          describe: 'List system logs',
+          builder: (y) => y
+            .option('query', { type: 'string', describe: 'Encoded query string' })
+            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns' })
+            .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
+          handler: wrap(async (argv, app) => {
+            const columns = argv.columns ? argv.columns.split(',') : ['level', 'message', 'source', 'created'];
+            const params = new URLSearchParams();
+            params.set('sysparm_limit', String(argv.limit));
+            params.set('sysparm_display_value', 'all');
+            params.set('sysparm_fields', ['sys_id', ...columns].join(','));
+            const q = argv.query ? argv.query + '^ORDERBYDESCsys_created_on' : 'ORDERBYDESCsys_created_on';
+            params.set('sysparm_query', q);
+            const records = await app.sdk.list('syslog', params);
+            app.ok({
+              table: 'syslog',
+              count: records.length,
+              columns,
+              records: records.map(r => formatRecordForDisplay(r, columns)),
+              context: { instance_url: app.getEffectiveInstance() },
+            }, { summary: `${records.length} log entry(s)` });
+          }),
+        })
+        .command({
+          command: 'show <sys_id>',
+          aliases: ['get'],
+          describe: 'Show a log entry by sys_id',
+          handler: wrap(async (argv, app) => {
+            const record = await app.sdk.get('syslog', argv.sys_id);
+            if (!record) {
+              throw new Error(`Log entry not found: ${argv.sys_id}`);
+            }
+            app.ok(record, { summary: `Log entry ${argv.sys_id}` });
+          }),
+        });
+    },
+    handler: () => {},
+  };
+}

package/src/commands/dev/rest.js

@@ -0,0 +1,64 @@
+export function restCmd(wrap) {
+  return {
+    command: 'rest [endpoint]',
+    describe: 'Make raw REST API calls',
+    builder: (yargs) => {
+      return yargs
+        .option('method', {
+          alias: 'X',
+          type: 'string',
+          default: 'GET',
+          describe: 'HTTP method (GET, POST, PUT, DELETE, PATCH)',
+        })
+        .option('data', {
+          alias: 'd',
+          type: 'string',
+          describe: 'Request body data (JSON string)',
+        })
+        .option('table', {
+          alias: 't',
+          type: 'string',
+          describe: 'Table name shorthand for api/now/table/{table}',
+        })
+        .option('query', {
+          type: 'string',
+          describe: 'Query parameters string',
+        });
+    },
+    handler: wrap(async (argv, app) => {
+      const validMethods = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'];
+      const method = (argv.method || 'GET').toUpperCase();
+
+      if (!validMethods.includes(method)) {
+        throw new Error(`Invalid HTTP method: ${method} (must be GET, POST, PUT, DELETE, or PATCH)`);
+      }
+
+      let endpoint;
+      if (argv.table) {
+        endpoint = `api/now/table/${argv.table}`;
+        if (argv.endpoint) {
+          endpoint = `${endpoint}/${argv.endpoint}`;
+        }
+      } else if (argv.endpoint) {
+        endpoint = argv.endpoint;
+      } else {
+        throw new Error('Either provide an endpoint argument or use --table flag');
+      }
+
+      // Trim leading slash from endpoint
+      endpoint = endpoint.replace(/^\/+/, '');
+
+      const instance = app.getEffectiveInstance();
+      const query = argv.query ? `?${argv.query}` : '';
+      const url = `${instance}/${endpoint}${query}`;
+
+      const requestOptions = { method };
+      if (argv.data) {
+        requestOptions.body = argv.data;
+      }
+
+      const result = await app.sdk.request(url, requestOptions);
+      app.ok(result, { summary: `${method} ${endpoint}` });
+    }),
+  };
+}