@sonisoft/now-sdk-ext-core 2.2.1 → 2.4.0

package/dist/sn/scriptsync/ScriptSyncModels.d.ts

@@ -0,0 +1,55 @@
+export interface ScriptTypeConfig {
+    table: string;
+    label: string;
+    nameField: string;
+    scriptField: string;
+    extension: string;
+}
+export declare const SCRIPT_TYPES: Record<string, ScriptTypeConfig>;
+export interface SyncScriptOptions {
+    scriptName: string;
+    scriptType: string;
+    filePath: string;
+    direction?: 'push' | 'pull';
+}
+export interface SyncResult {
+    scriptName: string;
+    scriptType: string;
+    filePath: string;
+    direction: 'push' | 'pull';
+    success: boolean;
+    sysId?: string;
+    message: string;
+    error?: string;
+    timestamp: string;
+}
+export interface SyncAllOptions {
+    directory: string;
+    scriptTypes?: string[];
+}
+export interface SyncAllResult {
+    directory: string;
+    scriptTypes: string[];
+    totalFiles: number;
+    synced: number;
+    failed: number;
+    scripts: SyncResult[];
+    timestamp: string;
+}
+export interface ParsedFileName {
+    isValid: boolean;
+    scriptName?: string;
+    scriptType?: string;
+}
+export interface ScriptRecord {
+    sys_id: string;
+    name: string;
+    script: string;
+    [key: string]: unknown;
+}
+export interface ScriptRecordResponse {
+    result: ScriptRecord;
+}
+export interface ScriptRecordListResponse {
+    result: ScriptRecord[];
+}

package/dist/sn/scriptsync/ScriptSyncModels.js

@@ -0,0 +1,8 @@
+export const SCRIPT_TYPES = {
+    sys_script_include: { table: 'sys_script_include', label: 'Script Include', nameField: 'name', scriptField: 'script', extension: '.js' },
+    sys_script: { table: 'sys_script', label: 'Business Rule', nameField: 'name', scriptField: 'script', extension: '.js' },
+    sys_ui_script: { table: 'sys_ui_script', label: 'UI Script', nameField: 'name', scriptField: 'script', extension: '.js' },
+    sys_ui_action: { table: 'sys_ui_action', label: 'UI Action', nameField: 'name', scriptField: 'script', extension: '.js' },
+    sys_script_client: { table: 'sys_script_client', label: 'Client Script', nameField: 'name', scriptField: 'script', extension: '.js' },
+};
+//# sourceMappingURL=ScriptSyncModels.js.map

package/dist/sn/scriptsync/ScriptSyncModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScriptSyncModels.js","sourceRoot":"","sources":["../../../src/sn/scriptsync/ScriptSyncModels.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,YAAY,GAAqC;IAC1D,kBAAkB,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;IACxI,UAAU,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;IACvH,aAAa,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;IACzH,aAAa,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;IACzH,iBAAiB,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE;CACxI,CAAC"}

package/dist/sn/scriptsync/ScriptWatcher.d.ts

@@ -0,0 +1,30 @@
+import { ScriptSync } from './ScriptSync.js';
+import { SyncResult } from './ScriptSyncModels.js';
+export interface WatchOptions {
+    directory: string;
+    scriptType?: string;
+    autoSync?: boolean;
+    onSync?: (result: SyncResult) => void;
+}
+/**
+ * ScriptWatcher watches a directory for file changes and automatically
+ * pushes updated scripts to ServiceNow using ScriptSync.
+ */
+export declare class ScriptWatcher {
+    private _logger;
+    private _scriptSync;
+    private _watcher;
+    constructor(scriptSync: ScriptSync);
+    /**
+     * Start watching a directory for file changes.
+     * On 'change' events, auto-pushes the changed file to ServiceNow.
+     * Returns an object with a stop() function to close the watcher.
+     */
+    start(options: WatchOptions): {
+        stop: () => void;
+    };
+    /**
+     * Stop the file watcher.
+     */
+    stop(): void;
+}

package/dist/sn/scriptsync/ScriptWatcher.js

@@ -0,0 +1,74 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { Logger } from "../../util/Logger.js";
+import { ScriptSync } from './ScriptSync.js';
+/**
+ * ScriptWatcher watches a directory for file changes and automatically
+ * pushes updated scripts to ServiceNow using ScriptSync.
+ */
+export class ScriptWatcher {
+    _logger = new Logger("ScriptWatcher");
+    _scriptSync;
+    _watcher = null;
+    constructor(scriptSync) {
+        this._scriptSync = scriptSync;
+    }
+    /**
+     * Start watching a directory for file changes.
+     * On 'change' events, auto-pushes the changed file to ServiceNow.
+     * Returns an object with a stop() function to close the watcher.
+     */
+    start(options) {
+        const { directory, scriptType, autoSync = true, onSync } = options;
+        this._logger.info(`Starting file watcher on directory: ${directory}`);
+        this._watcher = fs.watch(directory, (eventType, filename) => {
+            if (eventType !== 'change' || !filename || !autoSync) {
+                return;
+            }
+            const parsed = ScriptSync.parseFileName(filename);
+            if (!parsed.isValid) {
+                return;
+            }
+            // If scriptType filter is set, only sync matching types
+            if (scriptType && parsed.scriptType !== scriptType) {
+                return;
+            }
+            const filePath = path.join(directory, filename);
+            this._logger.info(`File changed: ${filename}, pushing to ServiceNow...`);
+            this._scriptSync.pushScript({
+                scriptName: parsed.scriptName,
+                scriptType: parsed.scriptType,
+                filePath
+            }).then((result) => {
+                if (onSync) {
+                    onSync(result);
+                }
+                if (result.success) {
+                    this._logger.info(`Auto-sync succeeded for ${filename}`);
+                }
+                else {
+                    this._logger.error(`Auto-sync failed for ${filename}: ${result.error || result.message}`);
+                }
+            }).catch((error) => {
+                this._logger.error(`Auto-sync error for ${filename}: ${error.message}`);
+            });
+        });
+        const self = this;
+        return {
+            stop: () => {
+                self.stop();
+            }
+        };
+    }
+    /**
+     * Stop the file watcher.
+     */
+    stop() {
+        if (this._watcher) {
+            this._logger.info('Stopping file watcher');
+            this._watcher.close();
+            this._watcher = null;
+        }
+    }
+}
+//# sourceMappingURL=ScriptWatcher.js.map

package/dist/sn/scriptsync/ScriptWatcher.js.map

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

package/dist/sn/task/TaskModels.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Models for task convenience operations against ServiceNow tables.
+ */
+/**
+ * Options for adding a comment or work note to a task record.
+ */
+export interface AddCommentOptions {
+    /** The table name (e.g., "incident", "change_request") */
+    table: string;
+    /** The sys_id of the record to add the comment to */
+    recordSysId: string;
+    /** The comment text */
+    comment: string;
+    /** When true, adds a work note instead of a customer-visible comment. Defaults to false. */
+    isWorkNote?: boolean;
+}
+/**
+ * Options for assigning a task to a user or group.
+ */
+export interface AssignTaskOptions {
+    /** The table name (e.g., "incident", "sc_task") */
+    table: string;
+    /** The sys_id of the record to assign */
+    recordSysId: string;
+    /** The sys_id or user_name of the user to assign to */
+    assignedTo: string;
+    /** Optional sys_id of the assignment group */
+    assignmentGroup?: string;
+}
+/**
+ * Options for resolving an incident.
+ */
+export interface ResolveIncidentOptions {
+    /** The sys_id of the incident to resolve */
+    sysId: string;
+    /** Resolution notes describing how the incident was resolved */
+    resolutionNotes: string;
+    /** The close code (e.g., "Solved (Work Around)", "Solved (Permanently)") */
+    closeCode?: string;
+}
+/**
+ * Options for closing an incident.
+ */
+export interface CloseIncidentOptions {
+    /** The sys_id of the incident to close */
+    sysId: string;
+    /** Close notes describing why the incident is being closed */
+    closeNotes: string;
+    /** The close code (e.g., "Solved (Work Around)", "Solved (Permanently)") */
+    closeCode?: string;
+}
+/**
+ * Options for approving a change request.
+ */
+export interface ApproveChangeOptions {
+    /** The sys_id of the change request to approve */
+    sysId: string;
+    /** Optional comments to include with the approval */
+    comments?: string;
+}
+/**
+ * A task record from ServiceNow.
+ */
+export interface TaskRecord {
+    /** System ID of the record */
+    sys_id: string;
+    /** The task number (e.g., "INC0010001") */
+    number?: string;
+    /** The task state */
+    state?: string;
+    /** Additional fields */
+    [key: string]: unknown;
+}
+/**
+ * Response containing a single task record.
+ */
+export interface TaskRecordResponse {
+    result: TaskRecord;
+}
+/**
+ * Response containing a list of task records.
+ */
+export interface TaskRecordListResponse {
+    result: TaskRecord[];
+}

package/dist/sn/task/TaskModels.js

@@ -0,0 +1,5 @@
+/**
+ * Models for task convenience operations against ServiceNow tables.
+ */
+export {};
+//# sourceMappingURL=TaskModels.js.map

package/dist/sn/task/TaskModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskModels.js","sourceRoot":"","sources":["../../../src/sn/task/TaskModels.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/sn/task/TaskOperations.d.ts

@@ -0,0 +1,63 @@
+import { ServiceNowInstance } from "../ServiceNowInstance.js";
+import { AddCommentOptions, AssignTaskOptions, ResolveIncidentOptions, CloseIncidentOptions, ApproveChangeOptions, TaskRecord } from './TaskModels.js';
+/**
+ * Provides convenience operations for common task-related actions in ServiceNow,
+ * such as adding comments, assigning tasks, resolving/closing incidents,
+ * and approving change requests.
+ */
+export declare class TaskOperations {
+    private _logger;
+    private _req;
+    private _tableAPI;
+    private _instance;
+    constructor(instance: ServiceNowInstance);
+    /**
+     * Add a comment or work note to a task record.
+     *
+     * @param options The comment options including table, record sys_id, and comment text
+     * @returns The updated task record
+     * @throws Error if the API call fails
+     */
+    addComment(options: AddCommentOptions): Promise<TaskRecord>;
+    /**
+     * Assign a task record to a user and optionally to an assignment group.
+     *
+     * @param options The assignment options
+     * @returns The updated task record
+     * @throws Error if the API call fails
+     */
+    assignTask(options: AssignTaskOptions): Promise<TaskRecord>;
+    /**
+     * Resolve an incident by setting its state to 6 (Resolved).
+     *
+     * @param options The resolve options including sys_id and resolution notes
+     * @returns The updated incident record
+     * @throws Error if the API call fails
+     */
+    resolveIncident(options: ResolveIncidentOptions): Promise<TaskRecord>;
+    /**
+     * Close an incident by setting its state to 7 (Closed).
+     *
+     * @param options The close options including sys_id and close notes
+     * @returns The updated incident record
+     * @throws Error if the API call fails
+     */
+    closeIncident(options: CloseIncidentOptions): Promise<TaskRecord>;
+    /**
+     * Approve a change request by setting its approval field to 'approved'.
+     *
+     * @param options The approval options including sys_id and optional comments
+     * @returns The updated change request record
+     * @throws Error if the API call fails
+     */
+    approveChange(options: ApproveChangeOptions): Promise<TaskRecord>;
+    /**
+     * Find a task record by its number field (e.g., "INC0010001").
+     *
+     * @param table The table to search in
+     * @param number The task number to find
+     * @returns The matching TaskRecord, or null if not found
+     * @throws Error if the API call fails
+     */
+    findByNumber(table: string, number: string): Promise<TaskRecord | null>;
+}

package/dist/sn/task/TaskOperations.js

@@ -0,0 +1,195 @@
+import { Logger } from "../../util/Logger.js";
+import { ServiceNowRequest } from "../../comm/http/ServiceNowRequest.js";
+import { TableAPIRequest } from "../../comm/http/TableAPIRequest.js";
+/**
+ * Provides convenience operations for common task-related actions in ServiceNow,
+ * such as adding comments, assigning tasks, resolving/closing incidents,
+ * and approving change requests.
+ */
+export class TaskOperations {
+    _logger = new Logger("TaskOperations");
+    _req;
+    _tableAPI;
+    _instance;
+    constructor(instance) {
+        this._instance = instance;
+        this._req = new ServiceNowRequest(instance);
+        this._tableAPI = new TableAPIRequest(instance);
+    }
+    /**
+     * Add a comment or work note to a task record.
+     *
+     * @param options The comment options including table, record sys_id, and comment text
+     * @returns The updated task record
+     * @throws Error if the API call fails
+     */
+    async addComment(options) {
+        if (!options.table || options.table.trim().length === 0) {
+            throw new Error('Table name is required');
+        }
+        if (!options.recordSysId || options.recordSysId.trim().length === 0) {
+            throw new Error('Record sys_id is required');
+        }
+        if (!options.comment || options.comment.trim().length === 0) {
+            throw new Error('Comment text is required');
+        }
+        const fieldName = options.isWorkNote ? 'work_notes' : 'comments';
+        this._logger.info(`Adding ${fieldName} to ${options.table}/${options.recordSysId}`);
+        const body = {
+            [fieldName]: options.comment
+        };
+        const response = await this._tableAPI.put(options.table, options.recordSysId, body);
+        if (response && response.status === 200 && response.bodyObject?.result) {
+            this._logger.info(`Successfully added ${fieldName} to ${options.table}/${options.recordSysId}`);
+            return response.bodyObject.result;
+        }
+        throw new Error(`Failed to add ${fieldName} to ${options.table}/${options.recordSysId}. Status: ${response?.status ?? 'unknown'}`);
+    }
+    /**
+     * Assign a task record to a user and optionally to an assignment group.
+     *
+     * @param options The assignment options
+     * @returns The updated task record
+     * @throws Error if the API call fails
+     */
+    async assignTask(options) {
+        if (!options.table || options.table.trim().length === 0) {
+            throw new Error('Table name is required');
+        }
+        if (!options.recordSysId || options.recordSysId.trim().length === 0) {
+            throw new Error('Record sys_id is required');
+        }
+        if (!options.assignedTo || options.assignedTo.trim().length === 0) {
+            throw new Error('Assigned to value is required');
+        }
+        this._logger.info(`Assigning ${options.table}/${options.recordSysId} to ${options.assignedTo}`);
+        const body = {
+            assigned_to: options.assignedTo
+        };
+        if (options.assignmentGroup) {
+            body.assignment_group = options.assignmentGroup;
+        }
+        const response = await this._tableAPI.put(options.table, options.recordSysId, body);
+        if (response && response.status === 200 && response.bodyObject?.result) {
+            this._logger.info(`Successfully assigned ${options.table}/${options.recordSysId}`);
+            return response.bodyObject.result;
+        }
+        throw new Error(`Failed to assign ${options.table}/${options.recordSysId}. Status: ${response?.status ?? 'unknown'}`);
+    }
+    /**
+     * Resolve an incident by setting its state to 6 (Resolved).
+     *
+     * @param options The resolve options including sys_id and resolution notes
+     * @returns The updated incident record
+     * @throws Error if the API call fails
+     */
+    async resolveIncident(options) {
+        if (!options.sysId || options.sysId.trim().length === 0) {
+            throw new Error('Incident sys_id is required');
+        }
+        if (!options.resolutionNotes || options.resolutionNotes.trim().length === 0) {
+            throw new Error('Resolution notes are required');
+        }
+        this._logger.info(`Resolving incident ${options.sysId}`);
+        const body = {
+            state: '6',
+            close_notes: options.resolutionNotes
+        };
+        if (options.closeCode) {
+            body.close_code = options.closeCode;
+        }
+        const response = await this._tableAPI.put('incident', options.sysId, body);
+        if (response && response.status === 200 && response.bodyObject?.result) {
+            this._logger.info(`Successfully resolved incident ${options.sysId}`);
+            return response.bodyObject.result;
+        }
+        throw new Error(`Failed to resolve incident ${options.sysId}. Status: ${response?.status ?? 'unknown'}`);
+    }
+    /**
+     * Close an incident by setting its state to 7 (Closed).
+     *
+     * @param options The close options including sys_id and close notes
+     * @returns The updated incident record
+     * @throws Error if the API call fails
+     */
+    async closeIncident(options) {
+        if (!options.sysId || options.sysId.trim().length === 0) {
+            throw new Error('Incident sys_id is required');
+        }
+        if (!options.closeNotes || options.closeNotes.trim().length === 0) {
+            throw new Error('Close notes are required');
+        }
+        this._logger.info(`Closing incident ${options.sysId}`);
+        const body = {
+            state: '7',
+            close_notes: options.closeNotes
+        };
+        if (options.closeCode) {
+            body.close_code = options.closeCode;
+        }
+        const response = await this._tableAPI.put('incident', options.sysId, body);
+        if (response && response.status === 200 && response.bodyObject?.result) {
+            this._logger.info(`Successfully closed incident ${options.sysId}`);
+            return response.bodyObject.result;
+        }
+        throw new Error(`Failed to close incident ${options.sysId}. Status: ${response?.status ?? 'unknown'}`);
+    }
+    /**
+     * Approve a change request by setting its approval field to 'approved'.
+     *
+     * @param options The approval options including sys_id and optional comments
+     * @returns The updated change request record
+     * @throws Error if the API call fails
+     */
+    async approveChange(options) {
+        if (!options.sysId || options.sysId.trim().length === 0) {
+            throw new Error('Change request sys_id is required');
+        }
+        this._logger.info(`Approving change request ${options.sysId}`);
+        const body = {
+            approval: 'approved'
+        };
+        if (options.comments) {
+            body.comments = options.comments;
+        }
+        const response = await this._tableAPI.put('change_request', options.sysId, body);
+        if (response && response.status === 200 && response.bodyObject?.result) {
+            this._logger.info(`Successfully approved change request ${options.sysId}`);
+            return response.bodyObject.result;
+        }
+        throw new Error(`Failed to approve change request ${options.sysId}. Status: ${response?.status ?? 'unknown'}`);
+    }
+    /**
+     * Find a task record by its number field (e.g., "INC0010001").
+     *
+     * @param table The table to search in
+     * @param number The task number to find
+     * @returns The matching TaskRecord, or null if not found
+     * @throws Error if the API call fails
+     */
+    async findByNumber(table, number) {
+        if (!table || table.trim().length === 0) {
+            throw new Error('Table name is required');
+        }
+        if (!number || number.trim().length === 0) {
+            throw new Error('Task number is required');
+        }
+        this._logger.info(`Finding ${table} record with number=${number}`);
+        const query = {
+            sysparm_query: `number=${number}`,
+            sysparm_limit: 1
+        };
+        const response = await this._tableAPI.get(table, query);
+        if (response && response.status === 200 && response.bodyObject?.result) {
+            const results = response.bodyObject.result;
+            if (results.length > 0) {
+                this._logger.info(`Found ${table} record: ${results[0].sys_id}`);
+                return results[0];
+            }
+            this._logger.info(`No ${table} record found with number=${number}`);
+            return null;
+        }
+        throw new Error(`Failed to query ${table} for number=${number}. Status: ${response?.status ?? 'unknown'}`);
+    }
+}
+//# sourceMappingURL=TaskOperations.js.map

package/dist/sn/task/TaskOperations.js.map

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

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

@@ -0,0 +1,78 @@
+import { ServiceNowInstance } from "../ServiceNowInstance.js";
+import { SetUpdateSetOptions, ListUpdateSetsOptions, CreateUpdateSetOptions, MoveRecordsOptions, MoveRecordsResult, CloneUpdateSetResult, InspectUpdateSetResult, UpdateSetRecord } from './UpdateSetModels.js';
+/**
+ * UpdateSetManager provides operations for managing ServiceNow update sets.
+ * Supports setting/getting the current update set, listing, creating,
+ * moving records between update sets, cloning, and inspecting update sets.
+ */
+export declare class UpdateSetManager {
+    private static readonly UI_UPDATESET_PATH;
+    private static readonly UI_PREF_UPDATESET_PATH;
+    private static readonly UPDATE_SET_TABLE;
+    private static readonly UPDATE_XML_TABLE;
+    private _logger;
+    private _req;
+    private _tableAPI;
+    private _instance;
+    constructor(instance: ServiceNowInstance);
+    /**
+     * Set the current update set for the session.
+     * Uses PUT /api/now/ui/concoursepicker/updateset
+     *
+     * @param options The update set name and sysId to set as current
+     * @throws Error if name or sysId is empty or if the API call fails
+     */
+    setCurrentUpdateSet(options: SetUpdateSetOptions): Promise<void>;
+    /**
+     * Get the current update set from the session preferences.
+     * Uses GET /api/now/ui/preferences/sys_update_set
+     *
+     * @returns The current update set record or null if not set
+     */
+    getCurrentUpdateSet(): Promise<UpdateSetRecord | null>;
+    /**
+     * List update sets from the sys_update_set table.
+     * Uses Table API GET on sys_update_set.
+     *
+     * @param options Optional query, limit, and fields options
+     * @returns Array of UpdateSetRecord
+     */
+    listUpdateSets(options?: ListUpdateSetsOptions): Promise<UpdateSetRecord[]>;
+    /**
+     * Create a new update set.
+     * Uses Table API POST on sys_update_set.
+     *
+     * @param options The update set name and optional description, application, state
+     * @returns The created UpdateSetRecord
+     * @throws Error if name is empty or if the API call fails
+     */
+    createUpdateSet(options: CreateUpdateSetOptions): Promise<UpdateSetRecord>;
+    /**
+     * Move records to a target update set.
+     * Queries sys_update_xml records based on options and updates each to the target update set.
+     *
+     * @param targetUpdateSetId The sys_id of the target update set
+     * @param options Options for selecting which records to move
+     * @returns Result summary of the move operation
+     * @throws Error if targetUpdateSetId is empty or no selection criteria provided
+     */
+    moveRecordsToUpdateSet(targetUpdateSetId: string, options?: MoveRecordsOptions): Promise<MoveRecordsResult>;
+    /**
+     * Clone an update set by creating a new update set and copying all sys_update_xml records.
+     *
+     * @param sourceUpdateSetId The sys_id of the source update set to clone
+     * @param newName The name for the new cloned update set
+     * @param onProgress Optional callback for progress updates
+     * @returns Result of the clone operation
+     * @throws Error if sourceUpdateSetId or newName is empty
+     */
+    cloneUpdateSet(sourceUpdateSetId: string, newName: string, onProgress?: (message: string) => void): Promise<CloneUpdateSetResult>;
+    /**
+     * Inspect an update set by querying its sys_update_xml records and grouping by type.
+     *
+     * @param updateSetSysId The sys_id of the update set to inspect
+     * @returns Inspection result with grouped components
+     * @throws Error if updateSetSysId is empty or the update set is not found
+     */
+    inspectUpdateSet(updateSetSysId: string): Promise<InspectUpdateSetResult>;
+}