@sonisoft/now-sdk-ext-core 6.7.0 → 6.9.0

package/dist/sn/updateset/WorkingSetManager.js

@@ -0,0 +1,275 @@
+import { SessionManager } from '../../comm/http/SessionManager.js';
+import { BackgroundScriptExecutor } from '../BackgroundScriptExecutor.js';
+import { MetadataReader } from '../metadata/internal/MetadataReader.js';
+import { WorkingSetError } from './WorkingSetModels.js';
+const ID = /^[a-f0-9]{32}$/;
+const MARKER = 'NEX_WORKING_SET_RESULT=';
+/**
+ * Update-set lifecycle for changes in any application, including installed Store applications and
+ * Global: create a set that really belongs to the application, make it the user's working set in
+ * every later session, move one capture into it, complete it, and restore the previous working set.
+ *
+ * Every step reads its outcome back and throws {@link WorkingSetError} rather than report success
+ * it did not observe. Only creating a set and saving the working-set preferences run as background
+ * scripts: the Table API drops sys_update_set.application, and no API persists apps.current_app.
+ */
+export class WorkingSetManager {
+    _instance;
+    _request;
+    _reader;
+    constructor(_instance) {
+        this._instance = _instance;
+        this._request = SessionManager.getInstance().getRequest(_instance);
+        this._reader = new MetadataReader(this._request);
+    }
+    /** The authenticated user's current application and update set. */
+    async getWorkingSet() {
+        const user = await this.user();
+        const rows = await this._reader.rows('sys_user_preference', `user=${user}^nameINapps.current_app,sys_update_set`, 'sys_id,user,name,value');
+        const value = (name) => {
+            const values = [...new Set(rows.filter(row => row.user === user && row.name === name).map(row => row.value))];
+            if (values.length > 1)
+                throw new WorkingSetError('evidence_unavailable');
+            return values[0] ?? '';
+        };
+        return { application: value('apps.current_app'), updateSet: value('sys_update_set') };
+    }
+    /** Read one update set. */
+    async getUpdateSet(sysId) {
+        if (!ID.test(sysId ?? ''))
+            throw new WorkingSetError('invalid_input');
+        const row = await this._reader.exact('sys_update_set', sysId, 'name,state,application,is_default');
+        if (!row)
+            throw new WorkingSetError('update_set_not_found');
+        return summary(row);
+    }
+    /** Create an In progress set whose application is verified to be the requested one. */
+    async createUpdateSet(options) {
+        const name = options?.name?.trim() ?? '';
+        if (!name || name.length > 80 || /\p{Cc}/u.test(name) || /\p{Cc}/u.test(options.description ?? ''))
+            throw new WorkingSetError('invalid_input');
+        const application = await this.application(options.application);
+        // The duplicate check runs with addQuery inside the script: the caller's name never becomes encoded-query text,
+        // where '^' would split it and a javascript: term would run on the server.
+        const created = await this.script(`
+            var open = new GlideRecord('sys_update_set');
+            open.addQuery('name', P.name);
+            open.addQuery('application', P.application);
+            open.addQuery('state', 'in progress');
+            open.setLimit(1);
+            open.query();
+            if (open.hasNext()) { out({ exists: true }); return; }
+            var set = new GlideRecord('sys_update_set');
+            set.initialize();
+            set.setValue('name', P.name);
+            set.setValue('state', 'in progress');
+            set.setValue('application', P.application);
+            if (P.description) set.setValue('description', P.description);
+            var id = set.insert();
+            out({ sys_id: id ? '' + id : '' });`, { name, application, description: options.description ?? '' });
+        if (created.exists === true)
+            throw new WorkingSetError('update_set_exists');
+        const createdId = typeof created.sys_id === 'string' ? created.sys_id : '';
+        if (!ID.test(createdId))
+            throw new WorkingSetError('create_not_applied');
+        const set = await this.getUpdateSet(createdId);
+        if (set.application !== application || set.state !== 'in progress' || set.name !== name) {
+            throw new WorkingSetError('application_not_applied', { updateSet: set.sysId, application: set.application });
+        }
+        return set;
+    }
+    /**
+     * Make an In progress set the user's working set in every later session: apps.current_app,
+     * sys_update_set and updateSetForScope<application> are saved and read back. A Default is
+     * refused unless `allowDefault` (for restoring a previous context only).
+     */
+    async useUpdateSet(sysId, options = {}) {
+        const set = await this.getUpdateSet(sysId);
+        if (set.state !== 'in progress')
+            throw new WorkingSetError('update_set_closed', { updateSet: set.sysId, state: set.state });
+        if (set.isDefault && !options.allowDefault)
+            throw new WorkingSetError('default_update_set', { updateSet: set.sysId });
+        const previous = await this.getWorkingSet();
+        try {
+            return { previous, current: await this.persist(set.application, set.sysId), updateSet: set };
+        }
+        catch (error) {
+            // The preferences may already have changed: the caller needs the pair to put back.
+            if (error instanceof WorkingSetError)
+                throw new WorkingSetError(error.code, { ...error.detail, previous });
+            throw new WorkingSetError('working_set_not_applied', { updateSet: set.sysId, previous });
+        }
+    }
+    /**
+     * Put back a working set returned by {@link useUpdateSet}. When its set has closed since, the
+     * application's single In progress Default is used instead and reported as the fallback.
+     */
+    async restoreWorkingSet(previous) {
+        // A user with no saved preference reads back as '': the platform's own default is Global and its Default set.
+        const requested = previous?.application === '' ? 'global' : previous?.application;
+        const application = requested === 'global' || ID.test(requested ?? '') ? requested : undefined;
+        const updateSet = previous?.updateSet ?? '';
+        if (!application || (updateSet !== '' && !ID.test(updateSet)))
+            throw new WorkingSetError('invalid_input');
+        let set;
+        if (updateSet) {
+            try {
+                set = await this.getUpdateSet(updateSet);
+            }
+            catch (error) {
+                if (!(error instanceof WorkingSetError && error.code === 'update_set_not_found'))
+                    throw error;
+            }
+        }
+        if (set && set.application !== application)
+            throw new WorkingSetError('scope_mismatch', { application, updateSet: set.sysId });
+        if (set?.state === 'in progress')
+            return { restored: await this.persist(application, set.sysId) };
+        const defaults = await this._reader.rows('sys_update_set', `application=${application}^is_default=true^state=in progress`, 'sys_id,application');
+        if (defaults.length !== 1 || defaults[0].application !== application)
+            throw new WorkingSetError('no_single_default', { application });
+        return { restored: await this.persist(application, defaults[0].sys_id), fallback: 'application_default' };
+    }
+    /**
+     * Move one capture between two In progress sets of the same application, as the platform's
+     * "Handle updates moving between sets" rule allows, and read the move back. Refused before the
+     * move when the scopes differ, the target is a Default, the target already holds a capture of
+     * the same record, or a newer capture of the same record exists elsewhere.
+     */
+    async moveCapture(options) {
+        const { capture, sourceSet, targetSet } = options ?? {};
+        if (![capture, sourceSet, targetSet].every(id => ID.test(id ?? '')) || sourceSet === targetSet)
+            throw new WorkingSetError('invalid_input');
+        if (/[^\p{L}\p{N} .,:;()/_-]/u.test(options.reason ?? '') || !options.reason?.trim())
+            throw new WorkingSetError('invalid_input');
+        const row = await this._reader.exact('sys_update_xml', capture, 'name,update_set,application,sys_recorded_at,comments');
+        if (!row || row.update_set !== sourceSet)
+            throw new WorkingSetError('capture_not_in_source', { capture });
+        const [source, target] = [await this.getUpdateSet(sourceSet), await this.getUpdateSet(targetSet)];
+        if (source.state !== 'in progress' || target.state !== 'in progress')
+            throw new WorkingSetError('update_set_closed', { updateSet: source.state !== 'in progress' ? source.sysId : target.sysId });
+        if (target.isDefault)
+            throw new WorkingSetError('default_update_set', { updateSet: target.sysId });
+        if (target.application !== row.application)
+            throw new WorkingSetError('scope_mismatch', { application: row.application, updateSet: target.sysId });
+        const same = await this._reader.rows('sys_update_xml', `name=${row.name}`, 'sys_id,name,update_set,sys_recorded_at');
+        if (same.some(other => other.name !== row.name))
+            throw new WorkingSetError('evidence_unavailable');
+        if (same.some(other => other.update_set === targetSet))
+            throw new WorkingSetError('duplicate_capture', { updateSet: targetSet });
+        if (same.some(other => other.sys_id !== capture && other.sys_recorded_at >= row.sys_recorded_at))
+            throw new WorkingSetError('newer_capture_exists', { capture });
+        const comments = [row.comments, `Moved to ${target.name}: ${options.reason.trim()}`].filter(Boolean).join('\n');
+        const response = await this._request.put({ path: `/api/now/table/sys_update_xml/${capture}`, method: 'PUT',
+            headers: { 'Content-Type': 'application/json', Accept: 'application/json' }, query: { sysparm_fields: 'sys_id' },
+            body: null, json: { update_set: targetSet, comments } });
+        const after = await this._reader.exact('sys_update_xml', capture, 'update_set,application');
+        if (after?.update_set !== targetSet)
+            throw new WorkingSetError('move_not_applied', { capture, status: response?.status });
+        return { capture, name: row.name, application: row.application, from: source, to: target };
+    }
+    /**
+     * Mark a set Complete after checking that it holds exactly `expectedCaptures` rows, all of the
+     * set's own application, one per record, and that no other user is working in it. Reads the
+     * state back. The caller restores its own working set afterwards ({@link restoreWorkingSet}).
+     */
+    async completeUpdateSet(sysId, options) {
+        if (!Number.isSafeInteger(options?.expectedCaptures) || options.expectedCaptures < 0)
+            throw new WorkingSetError('invalid_input');
+        const set = await this.getUpdateSet(sysId);
+        if (set.state !== 'in progress')
+            throw new WorkingSetError('update_set_closed', { updateSet: set.sysId, state: set.state });
+        if (set.isDefault)
+            throw new WorkingSetError('default_update_set', { updateSet: set.sysId });
+        const rows = await this._reader.rows('sys_update_xml', `update_set=${sysId}`, 'sys_id,name,update_set,application');
+        if (rows.some(row => row.update_set !== sysId))
+            throw new WorkingSetError('evidence_unavailable');
+        if (rows.length !== options.expectedCaptures)
+            throw new WorkingSetError('capture_count_mismatch', { expected: options.expectedCaptures, actual: rows.length });
+        const strays = rows.filter(row => row.application !== set.application);
+        if (strays.length)
+            throw new WorkingSetError('mixed_scope_capture', { captures: strays.map(row => row.sys_id) });
+        const names = rows.map(row => row.name);
+        if (new Set(names).size !== names.length)
+            throw new WorkingSetError('duplicate_capture', { updateSet: sysId });
+        const user = await this.user();
+        // Another user's current set, or the set remembered for the application, both still capture into it.
+        const users = await this._reader.rows('sys_user_preference', `name=sys_update_set^ORnameSTARTSWITHupdateSetForScope^value=${sysId}`, 'sys_id,user,name,value');
+        if (users.some(row => row.user !== user))
+            throw new WorkingSetError('update_set_in_use', { updateSet: sysId });
+        await this._request.put({ path: `/api/now/table/sys_update_set/${sysId}`, method: 'PUT',
+            headers: { 'Content-Type': 'application/json', Accept: 'application/json' }, query: { sysparm_fields: 'sys_id' },
+            body: null, json: { state: 'complete' } });
+        const completed = await this.getUpdateSet(sysId);
+        if (completed.state !== 'complete')
+            throw new WorkingSetError('complete_not_applied', { updateSet: sysId, state: completed.state });
+        // A capture that arrived between the checks and the state change is in the completed set: say so.
+        const final = await this._reader.rows('sys_update_xml', `update_set=${sysId}`, 'sys_id,update_set');
+        if (final.length !== rows.length || final.some(row => !rows.some(checked => checked.sys_id === row.sys_id))) {
+            throw new WorkingSetError('capture_count_mismatch', { updateSet: sysId, state: completed.state, expected: rows.length, actual: final.length });
+        }
+        return completed;
+    }
+    async user() {
+        const users = await this._reader.rows('sys_user', 'sys_id=javascript:gs.getUserID()', 'sys_id');
+        if (users.length !== 1 || !ID.test(users[0].sys_id))
+            throw new WorkingSetError('evidence_unavailable');
+        return users[0].sys_id;
+    }
+    /** The value a set of this application carries in sys_update_set.application. */
+    async application(ref) {
+        if (ref === 'global')
+            return 'global';
+        if (!ID.test(ref ?? '') && !/^[a-z0-9_]{1,40}$/i.test(ref ?? ''))
+            throw new WorkingSetError('invalid_input');
+        // A scope name must resolve to exactly one active application; scope strings are not unique.
+        const scopes = ID.test(ref) ? await this._reader.rows('sys_scope', `sys_id=${ref}`, 'sys_id,scope')
+            : await this._reader.rows('sys_scope', `scope=${ref}^active=true`, 'sys_id,scope');
+        if (scopes.length !== 1)
+            throw new WorkingSetError(scopes.length ? 'invalid_input' : 'application_not_found', ID.test(ref) ? { application: ref } : undefined);
+        return scopes[0].scope === 'global' ? 'global' : scopes[0].sys_id;
+    }
+    async persist(application, updateSet) {
+        await this.script(`
+            gs.getUser().savePreference('apps.current_app', P.application);
+            gs.setCurrentApplicationId(P.application);
+            new GlideUpdateSet().set(P.updateSet);
+            out({ ok: true });`, { application, updateSet });
+        const after = await this.getWorkingSet();
+        const user = await this.user();
+        const scoped = await this._reader.rows('sys_user_preference', `user=${user}^name=updateSetForScope${application}`, 'sys_id,user,name,value');
+        if (after.application !== application || after.updateSet !== updateSet || !scoped.length || scoped.some(row => row.value !== updateSet)) {
+            throw new WorkingSetError('working_set_not_applied', { application: after.application, updateSet: after.updateSet });
+        }
+        return after;
+    }
+    /** Run a global background script with JSON parameters `P`; `out(value)` returns one JSON result. */
+    async script(body, params) {
+        const literal = JSON.stringify(params).replace(/[\u2028\u2029<>]/g, c => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+        const script = `(function () {
+            var P = ${literal};
+            function out(value) { gs.print('${MARKER}' + JSON.stringify(value)); }
+            ${body}
+        })();`;
+        const result = await new BackgroundScriptExecutor(this._instance, 'global').executeScript(script, 'global', this._instance);
+        const lines = [...(result.scriptResults ?? []).map(line => line.line), ...(result.consoleResult ?? [])];
+        const line = lines.map(decode).find(text => text.includes(MARKER));
+        if (!line)
+            throw new WorkingSetError('script_result_unavailable');
+        try {
+            return JSON.parse(line.slice(line.indexOf(MARKER) + MARKER.length));
+        }
+        catch {
+            throw new WorkingSetError('script_result_unavailable');
+        }
+    }
+}
+function decode(text) {
+    return String(text ?? '').replace(/<BR\/?>/gi, '').replace(/&quot;/g, '"').replace(/&#39;/g, "'")
+        .replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&').trim();
+}
+function summary(row) {
+    return { sysId: row.sys_id, name: row.name, state: row.state, application: row.application,
+        isDefault: row.is_default === 'true' || row.is_default === '1' };
+}
+//# sourceMappingURL=WorkingSetManager.js.map

package/dist/sn/updateset/WorkingSetManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkingSetManager.js","sourceRoot":"","sources":["../../../src/sn/updateset/WorkingSetManager.ts"],"names":[],"mappings":"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"}

package/dist/sn/updateset/WorkingSetModels.d.ts

@@ -0,0 +1,77 @@
+/** The user's working set: apps.current_app and sys_update_set. `global` or a sys_scope sys_id. */
+export interface WorkingSet {
+    application: string;
+    updateSet: string;
+}
+export interface UpdateSetSummary {
+    sysId: string;
+    name: string;
+    state: string;
+    /** sys_update_set.application: `global`, or the application's sys_scope sys_id. */
+    application: string;
+    isDefault: boolean;
+}
+export interface CreateScopedUpdateSetOptions {
+    /**
+     * `global`, the sys_scope sys_id of any application (including an installed Store application),
+     * or a scope name that resolves to exactly one active application.
+     */
+    application: string;
+    /** At most 80 characters. A second In progress set with the same name in the application is refused. */
+    name: string;
+    description?: string;
+}
+export interface UseUpdateSetOptions {
+    /** Permit an application's Default set. Only for restoring a previous context: never develop in a Default. */
+    allowDefault?: boolean;
+}
+export interface UseUpdateSetResult {
+    /** Pass to restoreWorkingSet when the work is done. */
+    previous: WorkingSet;
+    current: WorkingSet;
+    updateSet: UpdateSetSummary;
+}
+export interface RestoreWorkingSetResult {
+    restored: WorkingSet;
+    /** The previous set had closed; the application's Default was made current instead. */
+    fallback?: 'application_default';
+}
+export interface MoveCaptureOptions {
+    /** sys_update_xml sys_id. */
+    capture: string;
+    sourceSet: string;
+    targetSet: string;
+    /** Appended to the capture's comments. Letters, digits and simple punctuation only. */
+    reason: string;
+}
+export interface MoveCaptureResult {
+    capture: string;
+    name: string;
+    application: string;
+    from: UpdateSetSummary;
+    to: UpdateSetSummary;
+}
+export interface CompleteUpdateSetOptions {
+    /** The number of captures the caller expects in the set. Completion is refused on any other count. */
+    expectedCaptures: number;
+}
+export type WorkingSetErrorCode = 'invalid_input' | 'evidence_unavailable' | 'update_set_not_found' | 'update_set_exists' | 'application_not_found' | 'create_not_applied' | 'application_not_applied' | 'update_set_closed' | 'default_update_set' | 'working_set_not_applied' | 'no_single_default' | 'capture_not_in_source' | 'scope_mismatch' | 'duplicate_capture' | 'newer_capture_exists' | 'move_not_applied' | 'capture_count_mismatch' | 'mixed_scope_capture' | 'update_set_in_use' | 'complete_not_applied' | 'script_result_unavailable';
+/** Identifiers and counts that explain a refusal; never names, descriptions or payloads. */
+export interface WorkingSetErrorDetail {
+    updateSet?: string;
+    application?: string;
+    capture?: string;
+    captures?: string[];
+    state?: string;
+    expected?: number;
+    actual?: number;
+    status?: number;
+    /** The working set before a change that did not read back: pass it to restoreWorkingSet. */
+    previous?: WorkingSet;
+}
+/** An update-set lifecycle step was refused, or its outcome did not read back as required. */
+export declare class WorkingSetError extends Error {
+    readonly code: WorkingSetErrorCode;
+    readonly detail?: WorkingSetErrorDetail;
+    constructor(code: WorkingSetErrorCode, detail?: WorkingSetErrorDetail);
+}

package/dist/sn/updateset/WorkingSetModels.js

@@ -0,0 +1,12 @@
+/** An update-set lifecycle step was refused, or its outcome did not read back as required. */
+export class WorkingSetError extends Error {
+    code;
+    detail;
+    constructor(code, detail) {
+        super(`Update set operation failed: ${code}`);
+        this.code = code;
+        this.detail = detail;
+        this.name = 'WorkingSetError';
+    }
+}
+//# sourceMappingURL=WorkingSetModels.js.map

package/dist/sn/updateset/WorkingSetModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkingSetModels.js","sourceRoot":"","sources":["../../../src/sn/updateset/WorkingSetModels.ts"],"names":[],"mappings":"AA8EA,8FAA8F;AAC9F,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACH;IAA2C;IAA9E,YAAmC,IAAyB,EAAkB,MAA8B;QACxG,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QADf,SAAI,GAAJ,IAAI,CAAqB;QAAkB,WAAM,GAAN,MAAM,CAAwB;QAExG,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonisoft/now-sdk-ext-core",
-  "version": "6.7.0",
+  "version": "6.9.0",
   "description": "Comprehensive TypeScript library extending ServiceNow SDK with application management, ATF testing, real-time log monitoring, AMB event subscriptions, and automation tools",
   "keywords": [
     "servicenow",