@sonisoft/now-sdk-ext-core 6.1.0 → 6.3.0

package/dist/sn/flow/FlowModels.d.ts

@@ -260,6 +260,184 @@ export interface ProcessFlowTestPayload {
     outputMap: Record<string, string>;
     runOnThread: boolean;
 }
+/**
+ * Artifact types whose design-time definition can be retrieved.
+ *
+ * Flows and subflows are served by the same endpoint and are distinguished by
+ * the `type` field ServiceNow reports in the payload; actions are served by the
+ * action-type endpoints.
+ */
+export type FlowDesignArtifactType = 'flow' | 'subflow';
+/**
+ * Stable, machine-readable reason for a definition retrieval failure.
+ *
+ * The ProcessFlow design-time routes are observed Workflow Studio APIs rather
+ * than a documented public REST contract, so callers should branch on this
+ * rather than on message text.
+ */
+export type FlowDefinitionFailureReason = 
+/** The supplied identifier was blank or was not a 32-character hex sys_id. */
+'invalid_identifier'
+/** The artifact exists but is not the type the called operation retrieves. */
+ | 'type_mismatch'
+/** ServiceNow reported no such artifact (or returned an empty payload for it). */
+ | 'not_found'
+/** The session is not permitted to read the artifact. */
+ | 'permission_denied'
+/** ServiceNow answered, but its response carried an error code/message. */
+ | 'api_error'
+/** ServiceNow answered with a body that did not match the expected wrapper. */
+ | 'malformed_response'
+/** The request itself failed (transport error, or an unclassified HTTP status). */
+ | 'request_failed';
+/** Options common to every design-time definition retrieval. */
+export interface FlowDefinitionOptions {
+    /**
+     * Scope sys_id or scope name sent as `sysparm_transaction_scope`.
+     * Optional; ServiceNow resolves the artifact's own scope when omitted.
+     */
+    scope?: string;
+}
+/**
+ * Light, stable projection of a flow/subflow definition.
+ *
+ * Deliberately small: the full payload stays available and untouched on
+ * `definition`, because ServiceNow evolves that schema between families and
+ * normalising it here would make family upgrades breaking.
+ */
+export interface FlowArtifactSummary {
+    /** sys_id of the flow or subflow */
+    sysId: string;
+    /** Display name */
+    name: string;
+    /** Internal (scriptable) name */
+    internalName: string;
+    /** Description text, empty string when unset */
+    description: string;
+    /** Scope sys_id */
+    scope: string;
+    /** Scope name, e.g. "global" */
+    scopeName: string;
+    /** Publication status, e.g. "published", "draft" */
+    status: string;
+    /** Whether the artifact is active */
+    active: boolean;
+    /** Number of trigger instances (always 0 for a subflow) */
+    triggerCount: number;
+    /** Number of action instances */
+    actionCount: number;
+    /** Number of nested subflow instances */
+    subflowCount: number;
+    /** Number of flow logic instances (if/else, for-each, etc.) */
+    flowLogicCount: number;
+    /** Number of declared inputs */
+    inputCount: number;
+    /** Number of declared outputs */
+    outputCount: number;
+}
+/** Result of retrieving a flow or subflow design-time definition. */
+export interface FlowArtifactDefinitionResult {
+    /** Whether the definition was retrieved */
+    success: boolean;
+    /** The sys_id that was requested (trimmed) */
+    sysId: string;
+    /**
+     * Artifact type as reported by ServiceNow, when it is one this library
+     * recognises. Never inferred from the operation that was called.
+     */
+    artifactType?: FlowDesignArtifactType;
+    /**
+     * Raw `type` value ServiceNow reported. Populated whenever the response
+     * carried one, including values this library does not recognise.
+     */
+    reportedType?: string;
+    /**
+     * The complete, JSON-serializable definition payload exactly as ServiceNow
+     * returned it. Pass straight to `JSON.stringify`.
+     */
+    definition?: Record<string, unknown>;
+    /** Convenience projection of the most commonly used definition fields */
+    summary?: FlowArtifactSummary;
+    /** Actionable failure description; never contains a response body */
+    errorMessage?: string;
+    /** Machine-readable failure classification */
+    failureReason?: FlowDefinitionFailureReason;
+    /** Numeric error code reported by the processflow API, when present */
+    errorCode?: number;
+}
+/** Light projection of one step instance within an action definition. */
+export interface ActionStepSummary {
+    /** sys_id of the step instance */
+    stepId: string;
+    /** Execution order as reported by ServiceNow */
+    order: number;
+    /** Step label, e.g. "Script step" */
+    label: string;
+    /** Step type name, e.g. "Script" */
+    stepTypeName: string;
+    /** sys_id of the step type */
+    stepTypeId: string;
+}
+/** Light, stable projection of an action definition. */
+export interface ActionDefinitionSummary {
+    /** sys_id of the action type */
+    sysId: string;
+    /** Display name */
+    name: string;
+    /** Internal (scriptable) name */
+    internalName: string;
+    /** Description text, empty string when unset */
+    description: string;
+    /** Scope sys_id */
+    scope: string;
+    /** Scope name, e.g. "global" */
+    scopeName: string;
+    /** Publication state, e.g. "published", "draft" */
+    state: string;
+    /** Whether the action is active */
+    active: boolean;
+    /** Number of declared inputs */
+    inputCount: number;
+    /** Number of declared outputs */
+    outputCount: number;
+    /** Number of step instances */
+    stepCount: number;
+    /** Ordered step projections, ascending by `order` */
+    steps: ActionStepSummary[];
+}
+/**
+ * Result of retrieving a complete action design-time definition.
+ *
+ * A complete action needs two reads — metadata and step instances — so both are
+ * returned through this one contract. `success` is true only when both parts
+ * were retrieved.
+ */
+export interface ActionDefinitionResult {
+    /** Whether the complete definition was retrieved */
+    success: boolean;
+    /** The sys_id that was requested (trimmed) */
+    sysId: string;
+    /** Always 'action' on success; absent on failure */
+    artifactType?: 'action';
+    /**
+     * Raw action-type metadata exactly as ServiceNow returned it
+     * (`GET /api/now/processflow/action/action_types/{id}`).
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Raw step instances exactly as ServiceNow returned them
+     * (`GET .../step_instances`), sorted ascending by `order`.
+     */
+    steps?: Array<Record<string, unknown>>;
+    /** Convenience projection of metadata plus ordered steps */
+    summary?: ActionDefinitionSummary;
+    /** Actionable failure description; never contains a response body */
+    errorMessage?: string;
+    /** Machine-readable failure classification */
+    failureReason?: FlowDefinitionFailureReason;
+    /** Numeric error code reported by the processflow API, when present */
+    errorCode?: number;
+}
 /**
  * Options for copying a flow into a target scoped application via the ProcessFlow REST API.
  */

package/dist/sn/transaction/ClusterTransactionManager.d.ts

@@ -0,0 +1,24 @@
+import { ServiceNowInstance } from "../ServiceNowInstance.js";
+import { ClusterTransaction, GetTransactionsOptions, KillTransactionOptions, KillTransactionResult } from "./ClusterTransactionModels.js";
+export declare class ClusterTransactionManager {
+    private _req;
+    private _killActionSysId?;
+    private _xmlParser;
+    constructor(instance: ServiceNowInstance);
+    getTransactions(options?: GetTransactionsOptions): Promise<ClusterTransaction[]>;
+    killTransaction(sysId: string, options?: KillTransactionOptions): Promise<KillTransactionResult>;
+    private waitForCollection;
+    private parseProgress;
+    private readTransactionList;
+    private parseTransactionList;
+    private resolveKillActionSysId;
+    private canExecuteAction;
+    private validateActionSysId;
+    private responseText;
+    private requireNonNegativeNumber;
+    private requirePositiveInteger;
+    private delay;
+    private throwIfAborted;
+    private sanitizeError;
+    private cellText;
+}

package/dist/sn/transaction/ClusterTransactionManager.js

@@ -0,0 +1,264 @@
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+/* eslint-disable @typescript-eslint/no-unsafe-call */
+import { XMLParser } from "fast-xml-parser";
+import { DOMParser } from "@xmldom/xmldom";
+import { ServiceNowRequest } from "../../comm/http/ServiceNowRequest.js";
+import { InvalidParameterException } from "../../exception/InvalidParameterException.js";
+import { READ_ONLY } from "../../policy/PolicyTypes.js";
+import { redactMessage, stripSecretsFromError } from "../../util/redact.js";
+const SYS_ID = /^[0-9a-f]{32}$/i;
+const TRANSACTION_FIELDS = [
+    "node_id", "user", "age", "url", "type", "foreground", "thread", "state",
+    "query_count", "acl_time", "br_count", "br_time", "business_rule", "db_time", "event_count",
+];
+export class ClusterTransactionManager {
+    _req;
+    _killActionSysId;
+    _xmlParser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: "" });
+    constructor(instance) {
+        this._req = new ServiceNowRequest(instance);
+    }
+    async getTransactions(options = {}) {
+        const pollIntervalMs = this.requireNonNegativeNumber(options.pollIntervalMs, 1000, "pollIntervalMs");
+        const timeoutMs = this.requireNonNegativeNumber(options.timeoutMs, 60000, "timeoutMs");
+        const limit = this.requirePositiveInteger(options.limit, 1000, "limit");
+        try {
+            this.throwIfAborted(options.signal);
+            const initialize = await this._req.get({
+                method: "GET", path: "/loading_transactions.do", headers: null,
+                query: null, body: null, requires: READ_ONLY, responseFormat: "text",
+            });
+            const page = this.responseText(initialize.data);
+            const executionMatch = /\bvar\s+executionID\s*=\s*(['"])(.*?)\1\s*;/.exec(page);
+            if (!executionMatch) {
+                throw new Error("Could not parse the collection execution id from /loading_transactions.do");
+            }
+            const executionId = executionMatch[2];
+            if (executionId && executionId !== "null") {
+                if (!SYS_ID.test(executionId)) {
+                    throw new Error("The collection execution id from /loading_transactions.do was invalid");
+                }
+                await this.waitForCollection(executionId, pollIntervalMs, timeoutMs, options.signal);
+            }
+            return await this.readTransactionList(options.query, limit);
+        }
+        catch (error) {
+            throw this.sanitizeError(error);
+        }
+    }
+    async killTransaction(sysId, options = {}) {
+        if (typeof sysId !== "string" || !SYS_ID.test(sysId.trim())) {
+            throw new InvalidParameterException("A transaction sysId must be a 32-character hexadecimal value");
+        }
+        const transactionSysId = sysId.trim();
+        try {
+            const actionSysId = options.killActionSysId
+                ? this.validateActionSysId(options.killActionSysId)
+                : await this.resolveKillActionSysId();
+            const security = await this._req.post({
+                method: "POST", path: "/xmlhttp.do", headers: null, query: null, body: null,
+                requires: READ_ONLY, responseFormat: "text",
+                fields: {
+                    sysparm_processor: "AJAXActionSecurity", sysparm_scope: "global",
+                    sys_target: "v_cluster_transaction", sys_action: actionSysId,
+                    sysparm_checked_items: transactionSysId, sysparm_target: "v_cluster_transaction",
+                    sysparm_synch: "true",
+                },
+            });
+            if (!this.canExecuteAction(this.responseText(security.data), actionSysId, transactionSysId)) {
+                throw new Error("The Kill action is unavailable or was not authorized for the selected transaction");
+            }
+            const session = await this._req.getUserSession();
+            if (!session?.userToken) {
+                throw new Error("An authenticated ServiceNow session token is required to kill a transaction");
+            }
+            const result = await this._req.post({
+                method: "POST", path: "/v_cluster_transaction_list.do", headers: null,
+                query: null, body: null,
+                fields: {
+                    sys_target: "v_cluster_transaction", sys_action: actionSysId,
+                    sys_is_list: "true", sysparm_checked_items: transactionSysId,
+                    sysparm_ck: session.userToken, sysparm_query: "",
+                    sysparm_referring_url: "v_cluster_transaction_list.do",
+                },
+            });
+            const body = this.responseText(result.data);
+            if (/login\.do|Security constraints prevent access/i.test(body)) {
+                throw new Error("ServiceNow did not accept the transaction kill request");
+            }
+            return { accepted: true, sysId: transactionSysId };
+        }
+        catch (error) {
+            throw this.sanitizeError(error);
+        }
+    }
+    async waitForCollection(executionId, pollIntervalMs, timeoutMs, signal) {
+        const startedAt = Date.now();
+        let last = {};
+        while (true) {
+            this.throwIfAborted(signal);
+            if (Date.now() - startedAt >= timeoutMs) {
+                throw new Error(`Transaction collection timed out after ${timeoutMs} ms (last state ${last.state ?? "unknown"}, ${last.percent_complete ?? "unknown"}%)`);
+            }
+            const response = await this._req.post({
+                method: "POST", path: "/xmlhttp.do", headers: null, query: null, body: null,
+                requires: READ_ONLY,
+                fields: {
+                    sysparm_processor: "AJAXProgressStatusChecker", sysparm_name: "getStatus",
+                    sysparm_scope: "global", sysparm_execution_id: executionId,
+                },
+            });
+            last = this.parseProgress(this.responseText(response.data));
+            if (last.state === "2")
+                return;
+            if (last.state !== "0" && last.state !== "1") {
+                const detail = last.detail_message || last.message || "no platform detail was provided";
+                throw new Error(`Transaction collection failed: ${detail}`);
+            }
+            await this.delay(pollIntervalMs, signal);
+        }
+    }
+    parseProgress(xml) {
+        try {
+            const parsed = this._xmlParser.parse(xml);
+            const answer = parsed?.xml?.answer;
+            if (typeof answer !== "string")
+                throw new Error();
+            const status = JSON.parse(answer);
+            if (!status || typeof status !== "object" || typeof status.state !== "string")
+                throw new Error();
+            return status;
+        }
+        catch {
+            throw new Error("Could not parse the AJAXProgressStatusChecker response");
+        }
+    }
+    async readTransactionList(query, limit) {
+        // A live Table API probe was unavailable during implementation, so use the captured,
+        // stable list-2 structure. Keeping this behind one method preserves the planned seam.
+        const response = await this._req.get({
+            method: "GET", path: "/v_cluster_transaction_list.do", headers: null, body: null,
+            requires: READ_ONLY, responseFormat: "text",
+            query: { sysparm_query: query ?? "", sysparm_limit: limit },
+        });
+        return this.parseTransactionList(this.responseText(response.data), limit);
+    }
+    parseTransactionList(html, limit) {
+        try {
+            const columns = [...html.matchAll(/<th\b[^>]*\bname=["']([^"']+)["'][^>]*\bglide_type=["'][^"']*["'][^>]*>/gi)]
+                .map((match) => match[1])
+                .filter((name) => TRANSACTION_FIELDS.includes(name));
+            if (columns.length !== TRANSACTION_FIELDS.length || !TRANSACTION_FIELDS.every((field) => columns.includes(field))) {
+                throw new Error();
+            }
+            const records = [];
+            const rows = html.matchAll(/<tr\b[^>]*\bsys_id=["']([0-9a-f]{32})["'][^>]*>([\s\S]*?)<\/tr>/gi);
+            for (const row of rows) {
+                const cells = [...row[2].matchAll(/<td\b[^>]*>([\s\S]*?)<\/td>/gi)]
+                    .map((cell) => this.cellText(cell[1]));
+                // List-2 rows surround the data with selection/icon and trailing spacer cells.
+                const dataCells = cells.length === columns.length ? cells : cells.slice(2, 2 + columns.length);
+                if (dataCells.length !== columns.length)
+                    throw new Error();
+                const record = { sys_id: row[1] };
+                columns.forEach((column, index) => { record[column] = dataCells[index] ?? ""; });
+                records.push(record);
+                if (records.length >= limit)
+                    break;
+            }
+            return records;
+        }
+        catch {
+            throw new Error("Could not parse /v_cluster_transaction_list.do transaction rows");
+        }
+    }
+    async resolveKillActionSysId() {
+        if (this._killActionSysId)
+            return this._killActionSysId;
+        const response = await this._req.get({
+            method: "GET", path: "/api/now/table/sys_ui_action", headers: { Accept: "application/json" },
+            body: null,
+            query: {
+                sysparm_query: "table=v_cluster_transaction^active=true^name=Kill",
+                sysparm_fields: "sys_id,name", sysparm_limit: 2, sysparm_display_value: "false",
+            },
+        });
+        const candidates = (response.bodyObject ?? response.data)?.result;
+        if (!Array.isArray(candidates) || candidates.length !== 1 || !SYS_ID.test(candidates[0].sys_id)) {
+            const names = Array.isArray(candidates) ? candidates.map((candidate) => candidate.name).filter(Boolean) : [];
+            const detail = names.length ? ` Candidates: ${names.join(", ")}.` : "";
+            throw new Error(`Could not uniquely resolve the Kill UI action.${detail} Supply killActionSysId to override it.`);
+        }
+        this._killActionSysId = candidates[0].sys_id;
+        return this._killActionSysId;
+    }
+    canExecuteAction(xml, actionSysId, transactionSysId) {
+        try {
+            const parsed = this._xmlParser.parse(xml);
+            const action = parsed?.xml?.[`action_${actionSysId}`];
+            const keys = Array.isArray(action?.key) ? action.key : action?.key ? [action.key] : [];
+            return keys.some((key) => String(key.can_execute) === "true" && key.sys_id === transactionSysId);
+        }
+        catch {
+            return false;
+        }
+    }
+    validateActionSysId(value) {
+        const actionSysId = typeof value === "string" ? value.trim() : "";
+        if (!SYS_ID.test(actionSysId)) {
+            throw new InvalidParameterException("killActionSysId must be a 32-character hexadecimal value");
+        }
+        return actionSysId;
+    }
+    responseText(data) {
+        if (typeof data === "string")
+            return data;
+        if (data instanceof String)
+            return data.toString();
+        throw new Error("ServiceNow returned an unexpected response type");
+    }
+    requireNonNegativeNumber(value, fallback, name) {
+        const result = value ?? fallback;
+        if (!Number.isFinite(result) || result < 0)
+            throw new InvalidParameterException(`${name} must be a non-negative number`);
+        return result;
+    }
+    requirePositiveInteger(value, fallback, name) {
+        const result = value ?? fallback;
+        if (!Number.isInteger(result) || result <= 0)
+            throw new InvalidParameterException(`${name} must be a positive integer`);
+        return result;
+    }
+    delay(ms, signal) {
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                clearTimeout(timer);
+                reject(new Error("Transaction collection was aborted"));
+            };
+            const timer = setTimeout(() => {
+                signal?.removeEventListener("abort", onAbort);
+                resolve();
+            }, ms);
+            signal?.addEventListener("abort", onAbort, { once: true });
+        });
+    }
+    throwIfAborted(signal) {
+        if (signal?.aborted)
+            throw new Error("Transaction collection was aborted");
+    }
+    sanitizeError(error) {
+        if (error instanceof Error)
+            error.message = redactMessage(error.message);
+        return stripSecretsFromError(error);
+    }
+    cellText(value) {
+        const document = new DOMParser().parseFromString(`<root>${value.replace(/&nbsp;/gi, "&#160;")}</root>`, "application/xml");
+        if (document.getElementsByTagName("parsererror").length > 0) {
+            throw new Error("Could not parse a transaction list cell");
+        }
+        return document.documentElement.textContent?.trim() ?? "";
+    }
+}
+//# sourceMappingURL=ClusterTransactionManager.js.map

package/dist/sn/transaction/ClusterTransactionManager.js.map

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

package/dist/sn/transaction/ClusterTransactionModels.d.ts

@@ -0,0 +1,35 @@
+/** One active transaction, as collected from a cluster node. */
+export interface ClusterTransaction {
+    sys_id: string;
+    node_id: string;
+    user: string;
+    age: string;
+    url: string;
+    type: string;
+    foreground: string;
+    thread: string;
+    /** The transaction state, unrelated to the collection progress state. */
+    state: string;
+    query_count: string;
+    acl_time: string;
+    br_count: string;
+    br_time: string;
+    business_rule: string;
+    db_time: string;
+    event_count: string;
+}
+export interface GetTransactionsOptions {
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    query?: string;
+    limit?: number;
+    signal?: AbortSignal;
+}
+export interface KillTransactionOptions {
+    /** Override for instances whose Kill UI action cannot be resolved automatically. */
+    killActionSysId?: string;
+}
+export interface KillTransactionResult {
+    accepted: boolean;
+    sysId: string;
+}

package/dist/sn/transaction/ClusterTransactionModels.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ClusterTransactionModels.js.map

package/dist/sn/transaction/ClusterTransactionModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterTransactionModels.js","sourceRoot":"","sources":["../../../src/sn/transaction/ClusterTransactionModels.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonisoft/now-sdk-ext-core",
-  "version": "6.1.0",
+  "version": "6.3.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",