@sonisoft/now-sdk-ext-core 6.6.3 → 6.8.0

package/dist/sn/workflow/WorkflowGraphML.js

@@ -0,0 +1,162 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+import { XMLParser } from "fast-xml-parser";
+/**
+ * GraphML as spoken by the Workflow Editor's diagram processor
+ * (`com.glideapp.workflow.ui.WorkflowDiagramProcessor`).
+ *
+ * - `<graph id>` is the wf_workflow_version sys_id; its `<data>` children are version
+ *   properties and permissions (`can_checkout`, `published`, …) plus one
+ *   `activity_<definition sys_id>` entry per activity type in the palette.
+ * - `<node>` is a wf_activity. Careful: its `name` is the activity TYPE ("Timer") and
+ *   its `description` is the activity's own name.
+ * - `<port>` is a wf_condition (an exit) on a node.
+ * - `<edge>` is a wf_transition; `source_port` is the condition it leaves from.
+ */
+const parser = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: "",
+    textNodeName: "#text",
+    parseTagValue: false,
+    parseAttributeValue: false,
+    trimValues: false,
+    isArray: (name) => ["graph", "node", "port", "edge", "data"].includes(name),
+});
+/**
+ * Parse a diagram processor response (`<xml …><graphml>…</graphml></xml>`).
+ *
+ * @returns The graph when the response carries one, and any reported messages
+ */
+export function parseDiagramResponse(xml) {
+    const doc = parser.parse(xml);
+    const root = doc?.xml ?? {};
+    const messages = {};
+    const text = (key) => {
+        const value = root[key];
+        if (value === undefined)
+            return undefined;
+        const raw = typeof value === "object" ? (value["#text"] ?? "") : String(value);
+        return String(raw).trim();
+    };
+    if (text("validation_critical") !== undefined)
+        messages.validationCritical = text("validation_critical");
+    if (text("validation_warning") !== undefined)
+        messages.validationWarning = text("validation_warning");
+    if (text("duplicate_name") !== undefined)
+        messages.duplicateName = text("duplicate_name");
+    if (text("different_domain") !== undefined)
+        messages.differentDomain = text("different_domain");
+    const graphEl = root.graphml?.graph?.[0];
+    return { graph: graphEl ? toGraph(graphEl) : undefined, messages, root };
+}
+function dataMap(el) {
+    const out = {};
+    for (const d of (el.data ?? [])) {
+        if (d?.key === undefined)
+            continue;
+        out[String(d.key)] = d["#text"] === undefined ? "" : String(d["#text"]);
+    }
+    return out;
+}
+function num(value) {
+    if (value === undefined || value === "")
+        return undefined;
+    const n = Number(value);
+    return Number.isFinite(n) ? n : undefined;
+}
+function toGraph(el) {
+    const all = dataMap(el);
+    const properties = {};
+    const activityTypes = {};
+    for (const [key, value] of Object.entries(all)) {
+        if (/^activity_[0-9a-f]{32}$/i.test(key))
+            activityTypes[key.slice("activity_".length)] = value;
+        else
+            properties[key] = value;
+    }
+    const nodes = (el.node ?? []).map(n => {
+        const d = dataMap(n);
+        const node = {
+            id: String(n.id),
+            name: d.description ?? "",
+            typeName: d.name ?? "",
+            activityDefinition: d.activity_definition ?? "",
+            x: num(d.x),
+            y: num(d.y),
+            width: num(d.width),
+            height: num(d.height),
+            stage: d.stage || undefined,
+            parent: d.parent || undefined,
+            isParent: d.is_parent === "true",
+            deletable: d.deleteable !== "false",
+        };
+        return node;
+    });
+    const ports = (el.port ?? []).map(p => {
+        const d = dataMap(p);
+        return {
+            id: String(p.id),
+            node: String(p.node),
+            name: d.name ?? "",
+            order: num(d.order) ?? 0,
+            error: d.error === "true",
+            event: d.event === "true",
+        };
+    });
+    const edges = (el.edge ?? []).map(e => ({
+        id: String(e.id),
+        source: String(e.source),
+        sourcePort: String(e.source_port ?? ""),
+        target: String(e.target),
+    }));
+    const bool = (key) => properties[key] === "true";
+    return {
+        id: String(el.id ?? ""),
+        workflowSysId: properties.workflow ?? "",
+        name: properties.name ?? "",
+        table: properties.table ?? "",
+        published: bool("published"),
+        active: bool("active"),
+        readOnly: bool("read_only"),
+        canCheckout: bool("can_checkout"),
+        canForceCheckout: bool("can_force_checkout"),
+        canPublish: bool("can_publish"),
+        canDelete: bool("can_delete"),
+        statusDisplay: properties.status_display ?? "",
+        fullSequences: properties.full_sequences ? properties.full_sequences.split(",").filter(Boolean) : [],
+        properties,
+        activityTypes,
+        nodes,
+        ports,
+        edges,
+    };
+}
+/**
+ * Serialize minimal GraphML for a processor write: the graph id plus the elements being
+ * changed. The processor needs nothing else — the editor's copy of every graph property
+ * and palette entry is ignored.
+ */
+export function serializeGraph(versionSysId, content) {
+    const parts = [];
+    for (const node of content.nodes ?? []) {
+        const data = [];
+        if (node.x !== undefined)
+            data.push(`<data key="x">${Math.round(node.x)}</data>`);
+        if (node.y !== undefined)
+            data.push(`<data key="y">${Math.round(node.y)}</data>`);
+        parts.push(`<node id="${attr(node.id)}">${data.join("")}</node>`);
+    }
+    for (const edge of content.edges ?? []) {
+        parts.push(`<edge id="${attr(edge.id)}" source="${attr(edge.source)}" source_port="${attr(edge.sourcePort)}" target="${attr(edge.target)}"/>`);
+    }
+    return `<graphml><graph id="${attr(versionSysId)}">${parts.join("")}</graph></graphml>`;
+}
+function attr(value) {
+    return String(value)
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+//# sourceMappingURL=WorkflowGraphML.js.map

package/dist/sn/workflow/WorkflowGraphML.js.map

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

package/dist/sn/workflow/WorkflowManager.d.ts

@@ -1,10 +1,21 @@
 import { ServiceNowInstance } from "../ServiceNowInstance.js";
-import { CreateWorkflowOptions, CreateWorkflowResult, CreateWorkflowVersionOptions, CreateWorkflowVersionResult, CreateActivityOptions, CreateActivityResult, CreateTransitionOptions, CreateTransitionResult, CreateConditionOptions, CreateConditionResult, PublishWorkflowOptions, CompleteWorkflowSpec, CompleteWorkflowResult } from './WorkflowModels.js';
+import { FluentGeneratorOptions } from "./WorkflowFluentGenerator.js";
+import { WorkflowFlowConversion } from "./WorkflowConversionModels.js";
+import { CreateWorkflowOptions, CreateWorkflowResult, CreateWorkflowVersionOptions, CreateWorkflowVersionResult, CreateActivityOptions, CreateActivityResult, CreateTransitionOptions, CreateTransitionResult, CreateConditionOptions, CreateConditionResult, PublishWorkflowOptions, CompleteWorkflowSpec, CompleteWorkflowResult, ActivityDefinitionDetail, ActivityDefinitionSummary, ActivityPosition, ActivityUsage, AddActivityOptions, AddActivityResult, AddConditionOptions, AddTransitionOptions, CheckoutOptions, CheckoutResult, ExportWorkflowOptions, FindWorkflowsOptions, GetActivityDefinitionOptions, GetActivityUsageOptions, GetWorkflowDefinitionOptions, ListActivityDefinitionsOptions, NewWorkflowOptions, NewWorkflowResult, PublishOptions, PublishResult, RemoveActivityOptions, UpdateActivityOptions, UpdateConditionOptions, UpdateWorkflowPropertiesOptions, WorkflowDefinition, WorkflowExport, WorkflowGraph, WorkflowSummary, WorkflowValidationReport, WorkflowVersionSummary } from './WorkflowModels.js';
 /**
- * Manages ServiceNow workflow lifecycle operations including creating workflows,
- * versions, activities, transitions, conditions, and publishing.
- * Also provides a high-level orchestration method to create a complete workflow
- * from a single specification.
+ * Manages legacy ServiceNow workflows (the Workflow Editor's wf_* records).
+ *
+ * Two families of methods live here:
+ *
+ * - **Editor-parity methods** (`newWorkflow`, `checkout`, `addActivity`, `publish`, …)
+ *   drive the same server endpoints the Workflow Editor uses — its diagram processor for
+ *   structure and lifecycle, and the classic `wf_activity` form for activity
+ *   configuration — so checkout's deep copy, publish's validation and version swap, and
+ *   activity variables (`sys_variable_value`) all behave exactly as they do in the UI.
+ *   Editing methods require a draft checked out to the current user.
+ * - **Record methods** (`createWorkflow`, `createActivity`, …, `createCompleteWorkflow`)
+ *   insert wf_* records directly through the Table API. They predate the editor-parity
+ *   methods and are kept for compatibility.
  */
 export declare class WorkflowManager {
     private static readonly WF_WORKFLOW;
@@ -12,10 +23,16 @@ export declare class WorkflowManager {
     private static readonly WF_ACTIVITY;
     private static readonly WF_TRANSITION;
     private static readonly WF_CONDITION;
+    /** The form view the Workflow Editor uses for activity dialogs. */
+    private static readonly ACTIVITY_VIEW;
     private _logger;
     private _req;
     private _tableAPI;
     private _instance;
+    private _diagram;
+    private _forms;
+    private _variables;
+    private _currentUser?;
     constructor(instance: ServiceNowInstance);
     /**
      * Create a new workflow record.
@@ -58,7 +75,11 @@ export declare class WorkflowManager {
      */
     createCondition(options: CreateConditionOptions): Promise<CreateConditionResult>;
     /**
-     * Publish a workflow version by setting published=true and the start activity.
+     * Set a workflow version's start activity and publish it.
+     *
+     * Publishes through the Workflow Editor's publish (without its validation prompt, as
+     * this method never validated), so the version swap, path computation and update-set
+     * capture match a publish from the editor. Use {@link publish} for validation.
      *
      * @param options Publish options including version sys_id and start activity sys_id
      * @throws Error if the API call fails
@@ -78,4 +99,213 @@ export declare class WorkflowManager {
      * @throws Error if any step fails
      */
     createCompleteWorkflow(spec: CompleteWorkflowSpec, onProgress?: (message: string) => void): Promise<CompleteWorkflowResult>;
+    /**
+     * Find workflows, with the state of their published and checked-out versions.
+     */
+    findWorkflows(options?: FindWorkflowsOptions): Promise<WorkflowSummary[]>;
+    /**
+     * Resolve a workflow by name, wf_workflow sys_id, or the sys_id of any of its versions.
+     *
+     * @throws InvalidParameterException when nothing or more than one workflow matches
+     */
+    resolveWorkflow(nameOrSysId: string): Promise<WorkflowSummary>;
+    /**
+     * List a workflow's versions, newest first.
+     */
+    getWorkflowVersions(workflowSysId: string): Promise<WorkflowVersionSummary[]>;
+    /**
+     * Read everything that makes up a workflow version: activities with their variables
+     * and exits, transitions and stages.
+     */
+    getWorkflowDefinition(versionSysId: string, options?: GetWorkflowDefinitionOptions): Promise<WorkflowDefinition>;
+    /**
+     * Read a version's diagram as the Workflow Editor sees it.
+     */
+    getWorkflowGraph(versionSysId: string): Promise<WorkflowGraph>;
+    /**
+     * List activity types — core activities and, unless excluded, Activity Designer ones.
+     */
+    listActivityDefinitions(options?: ListActivityDefinitionsOptions): Promise<ActivityDefinitionSummary[]>;
+    /**
+     * Describe an activity type as the instance defines it: its own description, the
+     * variables its activities carry (types, defaults, choices, hints) or — for Activity
+     * Designer types — its inputs and outputs, and the exits a new activity starts with.
+     * With `includeScript`, also its implementation, which shows how each variable is used
+     * and which results drive the exits.
+     *
+     * @param nameOrSysId Definition sys_id or exact name (e.g. "Timer")
+     */
+    getActivityDefinition(nameOrSysId: string, options?: GetActivityDefinitionOptions): Promise<ActivityDefinitionDetail>;
+    /**
+     * Learn how an activity type is configured on this instance: samples activities of the
+     * type in published workflows and reports, per variable (or Activity Designer input),
+     * how often it is set and its most common values. Use it to follow the instance's own
+     * conventions — which fields approvals reference, how task values are templated, … .
+     *
+     * @param nameOrSysId Definition sys_id or exact name
+     */
+    getActivityUsage(nameOrSysId: string, options?: GetActivityUsageOptions): Promise<ActivityUsage>;
+    /**
+     * Export one workflow version as a complete, self-contained definition: the workflow
+     * and version properties, inputs, stages, every activity with its type, labelled
+     * variables (defaults marked) and exits, the transitions, the activity types it uses
+     * (described from the instance, including whether they pause the workflow), display
+     * names for referenced records, the subflows it calls, and what uses it.
+     *
+     * @param workflow Workflow name or sys_id, or a version sys_id (exported as is)
+     */
+    exportWorkflow(workflow: string, options?: ExportWorkflowOptions): Promise<WorkflowExport>;
+    /**
+     * Plan the move of a workflow version to Flow Designer and write a Fluent (now-sdk)
+     * skeleton for it. Read-only: it exports the version and works from the export (see
+     * {@link planFlowConversion} and {@link generateFluentFlow} to work from a saved export).
+     *
+     * @param workflow Workflow name or sys_id, or a version sys_id
+     */
+    convertToFlow(workflow: string, options?: ExportWorkflowOptions & FluentGeneratorOptions): Promise<WorkflowFlowConversion>;
+    /**
+     * Run the Workflow Editor's validation ("Validate Workflow") without publishing.
+     */
+    validateWorkflow(versionSysId: string): Promise<WorkflowValidationReport>;
+    /**
+     * Create a workflow the way the Workflow Editor's "New Workflow" does: a version with
+     * Begin and End activities joined by a transition, checked out to the current user.
+     *
+     * @throws InvalidParameterException when a workflow with this name already exists
+     */
+    newWorkflow(options: NewWorkflowOptions): Promise<NewWorkflowResult>;
+    /**
+     * Check a workflow out for editing. Like the editor, this creates a draft version —
+     * a full copy of the published one — checked out to the current user. If the
+     * current user already has a draft, that draft is returned.
+     *
+     * @param workflow Workflow name, wf_workflow sys_id or a version sys_id
+     * @throws Error when another user has it checked out (unless `force`)
+     */
+    checkout(workflow: string, options?: CheckoutOptions): Promise<CheckoutResult>;
+    /**
+     * The draft version of a workflow that the current user has checked out.
+     *
+     * @param workflow Workflow name, wf_workflow sys_id or a version sys_id
+     * @throws Error when the workflow is not checked out, or is checked out by someone else
+     */
+    getDraftVersion(workflow: string): Promise<string>;
+    /**
+     * Publish a checked-out draft, as the editor's Publish does: validate, publish, and
+     * retire the previously published version. The instance records the whole workflow
+     * in the current update set.
+     *
+     * @throws WorkflowValidationError when validation finds critical problems, or
+     *         warnings without `allowWarnings`
+     */
+    publish(versionSysId: string, options?: PublishOptions): Promise<PublishResult>;
+    /**
+     * Throw away a checked-out draft, keeping the published version.
+     *
+     * @throws Error when the draft is the workflow's only version (use deleteWorkflow)
+     */
+    discardCheckout(versionSysId: string): Promise<void>;
+    /**
+     * Delete a workflow and every version of it.
+     *
+     * @param workflow Workflow name, wf_workflow sys_id or a version sys_id
+     */
+    deleteWorkflow(workflow: string): Promise<void>;
+    /**
+     * Activate or deactivate a workflow (the editor's Set Active / Set Inactive).
+     *
+     * @param versionSysId The published version
+     */
+    setWorkflowActive(versionSysId: string, active: boolean): Promise<void>;
+    /**
+     * Change a draft's workflow properties.
+     */
+    updateWorkflowProperties(versionSysId: string, options: UpdateWorkflowPropertiesOptions): Promise<void>;
+    /**
+     * Add an activity to a checked-out draft, configured with variables, and optionally
+     * wire it in. The activity is created through the editor's activity form, so its
+     * variables are written and its default exits are created exactly as in the UI.
+     */
+    addActivity(versionSysId: string, options: AddActivityOptions): Promise<AddActivityResult>;
+    /**
+     * Change an activity on a checked-out draft. Variables you do not pass keep their values.
+     */
+    updateActivity(activitySysId: string, options: UpdateActivityOptions): Promise<void>;
+    /**
+     * Remove an activity (with its exits and variables) from a checked-out draft.
+     */
+    removeActivity(activitySysId: string, options?: RemoveActivityOptions): Promise<void>;
+    /**
+     * Reposition activities on checked-out drafts.
+     */
+    moveActivities(positions: ActivityPosition[]): Promise<void>;
+    /**
+     * Add a transition on a checked-out draft.
+     *
+     * @returns The new transition's sys_id
+     */
+    addTransition(options: AddTransitionOptions): Promise<string>;
+    /**
+     * Point an existing transition at a different activity on a checked-out draft.
+     */
+    retargetTransition(transitionSysId: string, toActivitySysId: string): Promise<void>;
+    /**
+     * Remove a transition from a checked-out draft.
+     */
+    removeTransition(transitionSysId: string): Promise<void>;
+    /**
+     * Add an exit to an activity on a checked-out draft.
+     *
+     * @returns The new condition's sys_id
+     */
+    addCondition(options: AddConditionOptions): Promise<string>;
+    /**
+     * Change an exit on a checked-out draft.
+     */
+    updateCondition(conditionSysId: string, options: UpdateConditionOptions): Promise<void>;
+    /**
+     * Remove an exit, and the transitions leaving from it, from a checked-out draft.
+     */
+    removeCondition(conditionSysId: string): Promise<void>;
+    private createActivityThroughForm;
+    private summarize;
+    private readVersion;
+    /**
+     * Editing is only allowed on an unpublished draft checked out to the current user —
+     * the same rule the editor enforces (and the wf_condition ACLs require a checkout).
+     */
+    private requireDraft;
+    private readActivity;
+    private readTransition;
+    private readCondition;
+    private readConditions;
+    private readVariableValues;
+    private resolveActivityDefinition;
+    private resolveStage;
+    /**
+     * Pick an exit by name or sys_id. With no reference, a single exit is unambiguous;
+     * for several, `firstWhenAmbiguous` takes the first in order (what the editor does
+     * when you drop onto a line), otherwise the caller must choose.
+     */
+    private pickExit;
+    private defaultPosition;
+    /**
+     * The version to read for a workflow reference: a version sys_id as is; otherwise the
+     * current user's draft and/or the published version, as asked.
+     */
+    private resolveVersionToRead;
+    /**
+     * Whether a core activity type can pause the workflow, read from its handler script:
+     * it sets `activity.state` / `executing.state` to `'waiting'`, itself or in a handler it
+     * extends. Some only wait conditionally (tasks honour `wait_for_completion`).
+     */
+    private typeWaits;
+    /** Display names for sys_ids, grouped by table. Unknown tables or records are skipped. */
+    private displayNames;
+    private findingsOrEmpty;
+    private currentUserSysId;
+    private read;
+    private count;
+    private request;
+    private requireSysId;
 }