@jacebenson/jsn 4.0.3 → 4.0.4

package/src/commands/dev.js

@@ -15,6 +15,7 @@ import { formsCmd } from './dev/forms.js';
 import { listsCmd } from './dev/lists.js';
 import { updateSetsCmd } from './dev/updatesets.js';
 import { scopesCmd } from './dev/scopes.js';
+import { domainsCmd } from './dev/domains.js';
 import { evalCmd } from './dev/eval.js';
 import { restCmd } from './dev/rest.js';
 import { logsCmd } from './dev/logs.js';
@@ -47,6 +48,7 @@ export function devCmd(wrap) {
         .command(rolesCmd(wrap))
         .command(updateSetsCmd(wrap))
         .command(scopesCmd(wrap))
+        .command(domainsCmd(wrap))
         .command(propertiesCmd(wrap))
         .command(relationshipsCmd(wrap))
         .command(appmodulesCmd(wrap))
@@ -61,6 +63,19 @@ export function devCmd(wrap) {
         .command(evalCmd(wrap))
         .command(restCmd(wrap));
     },
-    handler: () => {},
+    handler: (argv) => {
+      if (argv._[1]) return; // a subcommand ran — its own handler handled it
+      console.log('Manage ServiceNow development artifacts.');
+      console.log('');
+      console.log('Most dev commands are also available at the top level:');
+      console.log('  flows, actions, rules, clientscripts, uiactions, uipolicies,');
+      console.log('  tables, columns, forms, lists, import, sppages, spwidgets,');
+      console.log('  uipages, appmenu, scrapi, acls, roles, properties,');
+      console.log('  relationships, appmodules, listcontrols, views, privileges,');
+      console.log('  uxscripts, aliases, catalogscripts, cataloguipolicies, logs,');
+      console.log('  updatesets, scopes, eval, rest');
+      console.log('');
+      console.log('Run "jsn dev <command> --help" or "jsn <command> --help" for details.');
+    },
   };
 }

package/src/commands/records.js

@@ -21,7 +21,7 @@ function getDefaultColumns(table) {
 
 export function recordsCmd(wrap) {
   return {
-    command: 'records <subcommand>',
+    command: 'records [subcommand]',
     describe: 'Query and manage records in any table (e.g. "records list --table incident --query priority=1")',
     builder: (yargs) => {
       return yargs
@@ -208,7 +208,8 @@ export function recordsCmd(wrap) {
         })
 
     },
-    handler: () => {
+    handler: (argv) => {
+      if (argv._[1]) return; // a subcommand ran — its own handler handled it
       console.log('Query and manage records in any ServiceNow table.');
       console.log('');
       console.log('Available subcommands:');

package/src/context.js

@@ -1,5 +1,7 @@
 // ServiceNow runtime context: current user, scope, update set
 
+import { getStringField } from './helpers.js';
+
 export async function getCurrentUser(sdk) {
   const params = new URLSearchParams();
   params.set('sysparm_query', 'user_name=javascript:gs.getUserName()');
@@ -22,24 +24,24 @@ export async function getCurrentApplication(sdk, userSysID) {
   params.set('sysparm_limit', '1');
   params.set('sysparm_fields', 'value');
   const records = await sdk.list('sys_user_preference', params);
-  if (records.length === 0) return { scope: 'global' };
+  if (records.length === 0) return { scope: 'global', appSysId: '' };
   const val = records[0].value?.value || records[0].value;
-  if (!val) return { scope: 'global' };
+  if (!val) return { scope: 'global', appSysId: '' };
 
   // Try to resolve sys_id to scope name
   try {
     const app = await sdk.get('sys_scope', val);
-    if (app) return { scope: app.scope || 'global' };
+    if (app) return { scope: app.scope || 'global', appSysId: val };
   } catch {
     // fallback
   }
   try {
     const app2 = await sdk.get('sys_app', val);
-    if (app2) return { scope: app2.scope || 'global' };
+    if (app2) return { scope: app2.scope || 'global', appSysId: val };
   } catch {
     // fallback
   }
-  return { scope: val };
+  return { scope: val, appSysId: val };
 }
 
 export async function getCurrentUpdateSet(sdk, userSysID) {
@@ -60,3 +62,48 @@ export async function getCurrentUpdateSet(sdk, userSysID) {
   }
   return { name: val, sys_id: val };
 }
+
+/**
+ * Find-or-create a sys_user_preference and set its value. Shared by the
+ * scope/update-set "set" commands and create auto-set (was copy-pasted 3x).
+ */
+async function setUserPreference(sdk, userSysID, name, value) {
+  const params = new URLSearchParams();
+  params.set('sysparm_query', `user=${userSysID}^name=${name}`);
+  params.set('sysparm_limit', '1');
+  params.set('sysparm_fields', 'sys_id');
+  const prefs = await sdk.list('sys_user_preference', params);
+  if (prefs.length > 0) {
+    await sdk.update('sys_user_preference', getStringField(prefs[0], 'sys_id'), { value });
+  } else {
+    await sdk.create('sys_user_preference', {
+      user: userSysID,
+      name,
+      value,
+      type: 'string',
+    });
+  }
+}
+
+/** Resolve the current user's sys_id (throws if it can't be determined). */
+export async function requireCurrentUserSysId(sdk) {
+  const user = await sdk.list('sys_user', new URLSearchParams({
+    sysparm_query: 'user_name=javascript:gs.getUserName()',
+    sysparm_limit: '1',
+    sysparm_fields: 'sys_id',
+  }));
+  if (user.length === 0) {
+    throw new Error('Could not determine current user');
+  }
+  return getStringField(user[0], 'sys_id');
+}
+
+/** Set the current application scope via the apps.current_app preference. */
+export async function setCurrentApplication(sdk, userSysID, scopeSysID) {
+  await setUserPreference(sdk, userSysID, 'apps.current_app', scopeSysID);
+}
+
+/** Set the current update set via the sys_update_set preference. */
+export async function setCurrentUpdateSet(sdk, userSysID, updateSetSysID) {
+  await setUserPreference(sdk, userSysID, 'sys_update_set', updateSetSysID);
+}

package/src/help.js

@@ -111,6 +111,7 @@ const CONFIG_COMMANDS = [
   { name: 'auth', desc: 'Authentication (login, refresh, status)' },
   { name: 'updatesets', desc: 'Update sets (set, create, export)' },
   { name: 'scopes', desc: 'Application scopes' },
+  { name: 'domains', desc: 'Domains (domain separation)' },
 ];
 
 const DEVELOPER_COMMANDS = [
@@ -153,8 +154,21 @@ LEARN MORE
   Use "jsn <command> --help" for more information about a command.`;
 }
 
-export function renderHelp() {
-  const sections = Object.entries(COMMAND_GROUPS).map(([name, cmds]) => renderGroup(name, cmds));
+export function renderHelp(config) {
+  // Domain separation is an optional plugin — only advertise `domains`
+  // when the active profile's capability probe found it installed.
+  const activeName = config?.activeProfile || config?.defaultProfile;
+  const hasDS = !!(activeName && config?.profiles?.[activeName]?.domain_separation);
+  const configCmds = hasDS
+    ? CONFIG_COMMANDS
+    : CONFIG_COMMANDS.filter((c) => !c.name || c.name !== 'domains');
+
+  const COMMAND_GROUPS_LOCAL = {
+    ...COMMAND_GROUPS,
+    'CONFIGURATION': configCmds,
+  };
+
+  const sections = Object.entries(COMMAND_GROUPS_LOCAL).map(([name, cmds]) => renderGroup(name, cmds));
 
   return [
     'Usage: jsn <command> [options]',

package/src/mutations.js

@@ -75,11 +75,20 @@ export const MUTATION_COMMANDS = [
   ['scopes', 'set'],
   ['dev', 'scopes', 'create'],
   ['dev', 'scopes', 'set'],
-  // Update sets: create + set (root + dev forms)
+  // Domains: set writes the profile config (root + dev forms)
+  ['domains', 'set'],
+  ['dev', 'domains', 'set'],
+  // Update sets: create, set, complete, ignore, parent (root + dev forms)
   ['updatesets', 'create'],
   ['updatesets', 'set'],
+  ['updatesets', 'complete'],
+  ['updatesets', 'ignore'],
+  ['updatesets', 'parent'],
   ['dev', 'updatesets', 'create'],
   ['dev', 'updatesets', 'set'],
+  ['dev', 'updatesets', 'complete'],
+  ['dev', 'updatesets', 'ignore'],
+  ['dev', 'updatesets', 'parent'],
 ];
 
 /**

package/src/sdk.js

@@ -11,6 +11,7 @@ export class SDKClient {
     this.baseURL = baseURL.replace(/\/$/, '');
     this.authProvider = authProvider;
     this.timeout = opts.timeout || DEFAULT_TIMEOUT;
+    this.domain = opts.domain || '';
   }
 
   async _setAuth(req) {
@@ -53,6 +54,9 @@ export class SDKClient {
       if (opts.body && typeof opts.body === 'string') {
         req.headers.set('Content-Type', 'application/json');
       }
+      if (this.domain) {
+        req.headers.set('X-Now-Domain', this.domain);
+      }
       await this._setAuth(req);
 
       const resp = await fetch(req);