@jacebenson/jsn 4.0.2 → 4.0.4

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

@@ -107,9 +107,11 @@ const DATA_COMMANDS = [
 ];
 
 const CONFIG_COMMANDS = [
-  { name: 'auth', desc: 'Authentication (login, status, switch, refresh, logout, remove)' },
+  { name: 'setup', desc: 'Set up and manage instances (interactive: add, switch, remove, modify)' },
+  { 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 = [
@@ -152,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);

package/suppress-warnings.cjs

@@ -1,13 +0,0 @@
-// Suppresses the node:sqlite ExperimentalWarning on Node 22.x.
-// Loaded via NODE_OPTIONS=--require before the main ESM entry point.
-
-const original = process.emitWarning;
-process.emitWarning = function emitWarning(warning, ...args) {
-  const message = typeof warning === 'string'
-    ? warning
-    : (warning?.message || '');
-  if (message.includes('SQLite')) {
-    return;
-  }
-  return original.apply(this, [warning, ...args]);
-};