@servicenow/sdk-build-plugins 4.2.0 → 4.4.0

package/dist/flow/constants/flow-plugin-constants.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Constants used across flow plugin implementations
+ */
+/**
+ * Default parameter name for flow arrow functions when none can be extracted
+ */
+export declare const DEFAULT_PARAM_NAME = "_params";
+/**
+ * Default flow priority level
+ */
+export declare const FLOW_PRIORITY_DEFAULT = "MEDIUM";
+/**
+ * Default user context for flow execution
+ */
+export declare const RUN_AS_DEFAULT = "system";
+/**
+ * Default access level for flows
+ */
+export declare const ACCESS_DEFAULT = "public";
+/**
+ * Source identifier for Fluent-generated flows
+ */
+export declare const GENERATION_SOURCE = "fluent";
+/**
+ * Separator used in parallel instance ordering (e.g., "1➛2")
+ */
+export declare const PARALLEL_ORDER_SEPARATOR = "\u279B";
+/**
+ * Default empty string value
+ */
+export declare const EMPTY_STRING = "";
+/**
+ * Default boolean string values
+ */
+export declare const BOOLEAN_FALSE_STRING = "false";
+export declare const BOOLEAN_TRUE_STRING = "true";
+/**
+ * Flow status constants
+ */
+export declare const FLOW_STATUS_DRAFT = "draft";
+/**
+ * Flow version for Fluent flows
+ */
+export declare const FLOW_VERSION = "2";
+/**
+ * Flow types
+ */
+export declare const FLOW_TYPE_FLOW = "flow";
+export declare const FLOW_TYPE_SUBFLOW = "subflow";
+/**
+ * Display value maps for trigger input transformations
+ * Used to convert internal values to user-friendly display values
+ */
+/**
+ * Day of week value to display name mapping
+ * Maps numeric day values (1-7) to their string representations
+ */
+export declare const DAY_OF_WEEK_DISPLAY_MAP: Record<string, string>;

package/dist/flow/constants/flow-plugin-constants.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Constants used across flow plugin implementations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DAY_OF_WEEK_DISPLAY_MAP = exports.FLOW_TYPE_SUBFLOW = exports.FLOW_TYPE_FLOW = exports.FLOW_VERSION = exports.FLOW_STATUS_DRAFT = exports.BOOLEAN_TRUE_STRING = exports.BOOLEAN_FALSE_STRING = exports.EMPTY_STRING = exports.PARALLEL_ORDER_SEPARATOR = exports.GENERATION_SOURCE = exports.ACCESS_DEFAULT = exports.RUN_AS_DEFAULT = exports.FLOW_PRIORITY_DEFAULT = exports.DEFAULT_PARAM_NAME = void 0;
+/**
+ * Default parameter name for flow arrow functions when none can be extracted
+ */
+exports.DEFAULT_PARAM_NAME = '_params';
+/**
+ * Default flow priority level
+ */
+exports.FLOW_PRIORITY_DEFAULT = 'MEDIUM';
+/**
+ * Default user context for flow execution
+ */
+exports.RUN_AS_DEFAULT = 'system';
+/**
+ * Default access level for flows
+ */
+exports.ACCESS_DEFAULT = 'public';
+/**
+ * Source identifier for Fluent-generated flows
+ */
+exports.GENERATION_SOURCE = 'fluent';
+/**
+ * Separator used in parallel instance ordering (e.g., "1➛2")
+ */
+exports.PARALLEL_ORDER_SEPARATOR = '➛';
+/**
+ * Default empty string value
+ */
+exports.EMPTY_STRING = '';
+/**
+ * Default boolean string values
+ */
+exports.BOOLEAN_FALSE_STRING = 'false';
+exports.BOOLEAN_TRUE_STRING = 'true';
+/**
+ * Flow status constants
+ */
+exports.FLOW_STATUS_DRAFT = 'draft';
+/**
+ * Flow version for Fluent flows
+ */
+exports.FLOW_VERSION = '2';
+/**
+ * Flow types
+ */
+exports.FLOW_TYPE_FLOW = 'flow';
+exports.FLOW_TYPE_SUBFLOW = 'subflow';
+/**
+ * Display value maps for trigger input transformations
+ * Used to convert internal values to user-friendly display values
+ */
+/**
+ * Day of week value to display name mapping
+ * Maps numeric day values (1-7) to their string representations
+ */
+exports.DAY_OF_WEEK_DISPLAY_MAP = {
+    '1': 'Monday',
+    '2': 'Tuesday',
+    '3': 'Wednesday',
+    '4': 'Thursday',
+    '5': 'Friday',
+    '6': 'Saturday',
+    '7': 'Sunday',
+};
+//# sourceMappingURL=flow-plugin-constants.js.map

package/dist/flow/constants/flow-plugin-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-plugin-constants.js","sourceRoot":"","sources":["../../../src/flow/constants/flow-plugin-constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACU,QAAA,kBAAkB,GAAG,SAAS,CAAA;AAE3C;;GAEG;AACU,QAAA,qBAAqB,GAAG,QAAQ,CAAA;AAE7C;;GAEG;AACU,QAAA,cAAc,GAAG,QAAQ,CAAA;AAEtC;;GAEG;AACU,QAAA,cAAc,GAAG,QAAQ,CAAA;AAEtC;;GAEG;AACU,QAAA,iBAAiB,GAAG,QAAQ,CAAA;AAEzC;;GAEG;AACU,QAAA,wBAAwB,GAAG,GAAG,CAAA;AAE3C;;GAEG;AACU,QAAA,YAAY,GAAG,EAAE,CAAA;AAE9B;;GAEG;AACU,QAAA,oBAAoB,GAAG,OAAO,CAAA;AAC9B,QAAA,mBAAmB,GAAG,MAAM,CAAA;AAEzC;;GAEG;AACU,QAAA,iBAAiB,GAAG,OAAO,CAAA;AAExC;;GAEG;AACU,QAAA,YAAY,GAAG,GAAG,CAAA;AAE/B;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAA;AACvB,QAAA,iBAAiB,GAAG,SAAS,CAAA;AAE1C;;;GAGG;AAEH;;;GAGG;AACU,QAAA,uBAAuB,GAA2B;IAC3D,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,QAAQ;CAChB,CAAA"}

package/dist/flow/flow-logic/flow-logic-constants.d.ts

@@ -0,0 +1,38 @@
+export declare const FLOW_LOGIC_PREFIX = "wfa.flowLogic.";
+export declare enum FLOW_LOGIC {
+    IF = "wfa.flowLogic.if",
+    ELSEIF = "wfa.flowLogic.elseIf",
+    ELSE = "wfa.flowLogic.else",
+    GOBACKTO = "wfa.flowLogic.goBackTo",
+    WAIT_FOR_A_DURATION = "wfa.flowLogic.waitForADuration",
+    EXITLOOP = "wfa.flowLogic.exitLoop",
+    ENDFLOW = "wfa.flowLogic.endFlow",
+    SKIP_ITERATION = "wfa.flowLogic.skipIteration",
+    FOR_EACH = "wfa.flowLogic.forEach",
+    TRY_CATCH = "wfa.flowLogic.tryCatch",
+    DO_IN_PARALLEL = "wfa.flowLogic.doInParallel",
+    SET_FLOW_VARIABLES = "wfa.flowLogic.setFlowVariables",
+    ASSIGN_SUBFLOW_OUTPUTS = "wfa.flowLogic.assignSubflowOutputs"
+}
+export declare const NAME_MAP: {
+    [key: string]: string;
+};
+export declare const DURATION_TYPE_PROPS: {
+    [key: string]: Set<string>;
+};
+export declare const WAIT_FOR_A_DURATION_INPUT_DESCRIPTORS: {
+    id: string;
+    name: string;
+    value: string;
+    displayValue: string;
+    children: never[];
+    scriptActive: boolean;
+}[];
+export declare const FLOW_LOGIC_SYS_ID_MAP: {
+    [K in FLOW_LOGIC]?: string;
+};
+export declare namespace FlowLogicSysId {
+    function getLogicId(logic: FLOW_LOGIC): string | undefined;
+    function getLogicName(logicId: string): FLOW_LOGIC | undefined;
+}
+export declare const DO_IN_PARALLEL_BLOCK_SYS_ID = "a1168de173311300b61e66476bf6a7d0";

package/dist/flow/flow-logic/flow-logic-constants.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DO_IN_PARALLEL_BLOCK_SYS_ID = exports.FlowLogicSysId = exports.FLOW_LOGIC_SYS_ID_MAP = exports.WAIT_FOR_A_DURATION_INPUT_DESCRIPTORS = exports.DURATION_TYPE_PROPS = exports.NAME_MAP = exports.FLOW_LOGIC = exports.FLOW_LOGIC_PREFIX = void 0;
+exports.FLOW_LOGIC_PREFIX = 'wfa.flowLogic.';
+var FLOW_LOGIC;
+(function (FLOW_LOGIC) {
+    FLOW_LOGIC["IF"] = "wfa.flowLogic.if";
+    FLOW_LOGIC["ELSEIF"] = "wfa.flowLogic.elseIf";
+    FLOW_LOGIC["ELSE"] = "wfa.flowLogic.else";
+    FLOW_LOGIC["GOBACKTO"] = "wfa.flowLogic.goBackTo";
+    FLOW_LOGIC["WAIT_FOR_A_DURATION"] = "wfa.flowLogic.waitForADuration";
+    FLOW_LOGIC["EXITLOOP"] = "wfa.flowLogic.exitLoop";
+    FLOW_LOGIC["ENDFLOW"] = "wfa.flowLogic.endFlow";
+    FLOW_LOGIC["SKIP_ITERATION"] = "wfa.flowLogic.skipIteration";
+    FLOW_LOGIC["FOR_EACH"] = "wfa.flowLogic.forEach";
+    FLOW_LOGIC["TRY_CATCH"] = "wfa.flowLogic.tryCatch";
+    FLOW_LOGIC["DO_IN_PARALLEL"] = "wfa.flowLogic.doInParallel";
+    FLOW_LOGIC["SET_FLOW_VARIABLES"] = "wfa.flowLogic.setFlowVariables";
+    FLOW_LOGIC["ASSIGN_SUBFLOW_OUTPUTS"] = "wfa.flowLogic.assignSubflowOutputs";
+})(FLOW_LOGIC || (exports.FLOW_LOGIC = FLOW_LOGIC = {}));
+exports.NAME_MAP = {
+    duration_type: 'durationType',
+    timer_duration: 'duration',
+    timer_schedule: 'schedule',
+    timer_relative_duration_operator: 'relativeOperator',
+    timer_relative_duration_datetime: 'relativeDatetime',
+    timer_percentage: 'percentage',
+    percentage_timer_input_datetime: 'percentageDatetime',
+};
+exports.DURATION_TYPE_PROPS = {
+    explicit_duration: new Set(['durationType', 'duration', 'schedule']),
+    relative_duration: new Set(['durationType', 'duration', 'schedule', 'relativeOperator', 'relativeDatetime']),
+    percentage_duration: new Set(['durationType', 'schedule', 'percentage', 'percentageDatetime']),
+};
+exports.WAIT_FOR_A_DURATION_INPUT_DESCRIPTORS = [
+    {
+        id: '4973581473031300b61e66476bf6a785',
+        name: 'duration_type',
+        value: '',
+        displayValue: '',
+        children: [],
+        scriptActive: false,
+    },
+    {
+        id: 'bf1d6161b736230034c6ce69ee11a920',
+        name: 'percentage_timer_input_datetime',
+        value: '',
+        displayValue: '',
+        children: [],
+        scriptActive: false,
+    },
+    {
+        id: '8033309c5376230034c6ddeeff7b12e1',
+        name: 'timer_percentage',
+        value: '',
+        displayValue: '',
+        children: [],
+        scriptActive: false,
+    },
+    {
+        id: 'ef145c1473031300b61e66476bf6a7be',
+        name: 'timer_duration',
+        value: '',
+        displayValue: '',
+        children: [],
+        scriptActive: false,
+    },
+    {
+        id: 'dca4105473031300b61e66476bf6a726',
+        name: 'timer_relative_duration_operator',
+        value: '',
+        displayValue: '',
+        children: [],
+        scriptActive: false,
+    },
+    {
+        id: '1f25d05473031300b61e66476bf6a773',
+        name: 'timer_relative_duration_datetime',
+        value: '',
+        displayValue: '',
+        children: [],
+        scriptActive: false,
+    },
+    {
+        id: 'fb55145473031300b61e66476bf6a762',
+        name: 'timer_schedule',
+        value: '',
+        displayValue: '',
+        children: [],
+        scriptActive: false,
+    },
+];
+exports.FLOW_LOGIC_SYS_ID_MAP = {
+    [FLOW_LOGIC.IF]: 'af4e1945c3e232002841b63b12d3ae3e',
+    [FLOW_LOGIC.ELSE]: '1f781bf3c32232002841b63b12d3aee6',
+    [FLOW_LOGIC.ELSEIF]: '666e5545c3e232002841b63b12d3ae99',
+    // [FLOW_LOGIC.GOBACKTO]: '59ea75fd77502110b2b4ddd9cf5a99ef',
+    [FLOW_LOGIC.WAIT_FOR_A_DURATION]: 'fdb2541473031300b61e66476bf6a70e',
+    [FLOW_LOGIC.EXITLOOP]: '7444b31c37063110ac85cdd734924bff',
+    [FLOW_LOGIC.ENDFLOW]: 'd176605ea76103004f27b0d2187901c7',
+    [FLOW_LOGIC.SKIP_ITERATION]: '48de1b5837063110ac85cdd734924b15',
+    [FLOW_LOGIC.FOR_EACH]: '098e1dc5c3e232002841b63b12d3ae33',
+    [FLOW_LOGIC.SET_FLOW_VARIABLES]: '4f787d1e0f9b0010ecf0cc52ff767ea0',
+    [FLOW_LOGIC.ASSIGN_SUBFLOW_OUTPUTS]: 'df4e1945c3e232002841b63b12d3ae3e',
+};
+var FlowLogicSysId;
+(function (FlowLogicSysId) {
+    function getLogicId(logic) {
+        return exports.FLOW_LOGIC_SYS_ID_MAP[logic];
+    }
+    FlowLogicSysId.getLogicId = getLogicId;
+    function getLogicName(logicId) {
+        return Object.keys(exports.FLOW_LOGIC_SYS_ID_MAP).find((key) => exports.FLOW_LOGIC_SYS_ID_MAP[key] === logicId);
+    }
+    FlowLogicSysId.getLogicName = getLogicName;
+})(FlowLogicSysId || (exports.FlowLogicSysId = FlowLogicSysId = {}));
+exports.DO_IN_PARALLEL_BLOCK_SYS_ID = 'a1168de173311300b61e66476bf6a7d0';
+//# sourceMappingURL=flow-logic-constants.js.map

package/dist/flow/flow-logic/flow-logic-constants.js.map

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

package/dist/flow/flow-logic/flow-logic-diagnostics.d.ts

@@ -0,0 +1,19 @@
+import type { FlowLogicInstanceShape } from './flow-logic-shapes';
+import { ts, type Diagnostics } from '@servicenow/sdk-build-core';
+/**
+ * Main validation function for flow logic instances.
+ * Validates placement rules and context requirements for different flow logic types.
+ *
+ * @param expr - The flow logic instance shape to validate
+ * @returns Error message if validation fails, undefined if valid
+ */
+export declare function validateFlowLogic(expr: FlowLogicInstanceShape, diagnostics: Diagnostics): string | undefined;
+/**
+ * Validates sibling relationships for conditional flow logic (If/Else/ElseIf).
+ * Ensures proper chaining and structure of conditional blocks.
+ *
+ * @param expr - The flow logic instance shape
+ * @param sibling - The sibling CallExpression to validate against
+ * @returns Error message if sibling relationship is invalid, undefined if valid
+ */
+export declare function validateSibling(expr: FlowLogicInstanceShape, sibling: ts.CallExpression | undefined): string | undefined;