@servicenow/sdk-build-plugins 4.2.0 → 4.4.0

package/dist/flow/utils/data-pill-shapes.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForEachItemShape = exports.PillTemplateShape = exports.PillShape = void 0;
+const sdk_build_core_1 = require("@servicenow/sdk-build-core");
+class PillShape extends sdk_build_core_1.PropertyAccessShape {
+    uiId;
+    path;
+    type = undefined;
+    parentTableName = undefined;
+    columnName = undefined;
+    reference = undefined;
+    constructor({ source, uiId, path, type }) {
+        super({ source, elements: [uiId, path] });
+        this.uiId = uiId;
+        this.path = path;
+        this.type = type;
+    }
+    setType(type) {
+        this.type = type;
+    }
+    getType() {
+        return this.type;
+    }
+    setParentTableName(parentTableName) {
+        this.parentTableName = parentTableName;
+    }
+    getParentTableName() {
+        return this.parentTableName;
+    }
+    setColumnName(columnName) {
+        this.columnName = columnName;
+    }
+    getColumnName() {
+        return this.columnName;
+    }
+    setReference(reference) {
+        this.reference = reference;
+    }
+    getReference() {
+        return this.reference;
+    }
+    setRootIdentifier(arg0) {
+        this.uiId = arg0;
+    }
+    getRootIdentifier() {
+        return this.uiId;
+    }
+    getValue() {
+        // For schema references (empty path), don't include the dot
+        // e.g., {{flowVariables}} or {{outputs}}
+        // For property access, include the dot
+        // e.g., {{flow_variable.someVar}} or {{trigger.current.sys_id}}
+        const typePart = this.type !== undefined ? `|${this.type}` : '';
+        const metaPart = this.parentTableName || this.columnName || this.reference
+            ? `|meta:${this.parentTableName || ''}:${this.columnName || ''}:${this.reference || ''}`
+            : '';
+        return this.path ? `{{${this.uiId}.${this.path}${typePart}${metaPart}}}` : `{{${this.uiId}}}`;
+    }
+}
+exports.PillShape = PillShape;
+class PillTemplateShape extends sdk_build_core_1.TemplateExpressionShape {
+    parts;
+    constructor({ source, parts }) {
+        super({ source, literalText: '', spans: [] });
+        this.parts = new sdk_build_core_1.ArrayShape({ source, elements: parts });
+    }
+    getParts() {
+        return this.parts;
+    }
+    getValue() {
+        const parts = this.parts.getElements(false);
+        let result = '';
+        for (const part of parts) {
+            const value = part.getValue();
+            if (typeof value === 'string') {
+                // For string literals, add them directly
+                result += value;
+            }
+            else if (value instanceof PillShape) {
+                result += value.getValue();
+            }
+        }
+        return result;
+    }
+}
+exports.PillTemplateShape = PillTemplateShape;
+class ForEachItemShape extends sdk_build_core_1.IdentifierShape {
+    uiId;
+    path;
+    type = undefined;
+    parentTableName = undefined;
+    columnName = undefined;
+    reference = undefined;
+    constructor({ source, uiId, path }) {
+        super({ source, name: uiId });
+        this.uiId = uiId;
+        this.path = path;
+    }
+    setType(type) {
+        this.type = type;
+    }
+    getType() {
+        return this.type;
+    }
+    setParentTableName(parentTableName) {
+        this.parentTableName = parentTableName;
+    }
+    getParentTableName() {
+        return this.parentTableName;
+    }
+    setColumnName(columnName) {
+        this.columnName = columnName;
+    }
+    getColumnName() {
+        return this.columnName;
+    }
+    setReference(reference) {
+        this.reference = reference;
+    }
+    getReference() {
+        return this.reference;
+    }
+    getRootIdentifier() {
+        return this.uiId;
+    }
+    getValue() {
+        const typePart = this.type !== undefined ? `|${this.type}` : '';
+        const metaPart = this.parentTableName || this.columnName || this.reference
+            ? `|meta:${this.parentTableName || ''}:${this.columnName || ''}:${this.reference || ''}`
+            : '';
+        return `{{${this.uiId}.${this.path}${typePart}${metaPart}}}`;
+    }
+}
+exports.ForEachItemShape = ForEachItemShape;
+//# sourceMappingURL=data-pill-shapes.js.map

package/dist/flow/utils/data-pill-shapes.js.map

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

package/dist/flow/utils/datapill-transformer.d.ts

@@ -0,0 +1,110 @@
+import { CallExpressionShape, type IdentifierShape, type Record, Shape, VariableStatementShape, ObjectShape, type Diagnostics, type Logger } from '@servicenow/sdk-build-core';
+import { ArrowFunctionShape } from '../../arrow-function-plugin';
+/**
+ * Result of datapill transformation
+ */
+export interface DatapillTransformResult {
+    shape: Shape;
+    propsChanged: boolean;
+}
+/**
+ * Information about a flow instance shape for processing
+ */
+export interface FlowInstanceShapeInfo {
+    callExpression: CallExpressionShape;
+    variableStatement: VariableStatementShape | CallExpressionShape;
+}
+export declare const uuidToRecordMap: Map<string, Record>;
+/**
+ * Build a map of UUID to variable identifiers from instance records and shapes
+ * This map is used to transform UUID-based datapills into property access expressions
+ * Uses ui_id from records (not $id from config) because datapills reference ui_id
+ *
+ * @param recordToShapeMap - Map of instance records to their corresponding shapes
+ * @returns Map of UUID strings (ui_id) to IdentifierShapes
+ */
+export declare function buildUuidToIdentifierMap(recordToShapeMap: Map<Record, Shape>): Map<string, IdentifierShape>;
+/**
+ * Extract CallExpression and VariableStatement from an instance shape
+ * Handles both VariableStatementShape (for Action/Subflow) and bare CallExpressionShape (for flow logic)
+ *
+ * @param instanceShape - The shape to extract from
+ * @returns Object containing callExpression and variableStatement
+ */
+export declare function extractInstanceShapeInfo(instanceShape: Shape): FlowInstanceShapeInfo;
+/**
+ * Rebuild a CallExpressionShape with transformed properties
+ * Creates a new CallExpression with the transformed props and cleaned config
+ *
+ * @param originalCallExpression - The original CallExpression
+ * @param transformedProps - The transformed properties object
+ * @param configShape - The config shape (possibly cleaned)
+ * @param record - The source record for shape creation
+ * @returns New CallExpressionShape with transformed properties
+ */
+export declare function rebuildCallExpressionWithDatapills(originalCallExpression: CallExpressionShape, transformedProps: {
+    [key: string]: Shape;
+}, configShape: Shape, record: Record): CallExpressionShape;
+/**
+ * Rebuild an instance shape (VariableStatement or CallExpression) with transformed datapills
+ *
+ * @param instanceShape - The original instance shape
+ * @param newCallExpression - The new CallExpression with transformed properties
+ * @param instanceShapeInfo - Information extracted from the instance shape
+ * @returns Rebuilt VariableStatementShape or the new CallExpression
+ */
+export declare function rebuildInstanceWithDatapills(instanceShape: Shape, newCallExpression: CallExpressionShape, instanceShapeInfo: FlowInstanceShapeInfo): Shape;
+/**
+ * Check if a callee string represents a flow logic call
+ * @param callee - The callee string (e.g., 'wfa.flowLogic.if', 'wfa.action')
+ * @returns true if the callee is a flow logic call
+ */
+export declare function isFlowLogicCallee(callee: string): boolean;
+/**
+ * Check if a flow logic type has a body (arrow function)
+ * @param callee - The flow logic callee (e.g., 'wfa.flowLogic.if')
+ * @returns true if the flow logic has a body
+ */
+export declare function flowLogicHasBody(callee: string): boolean;
+/**
+ * Extract arrow function bodies from a flow logic call expression
+ * Different flow logic types have bodies in different positions:
+ * - If/ElseIf/Else: Single body at argument 1
+ * - ForEach: Body at argument 2 (arg 0 is items, arg 1 is config)
+ * - TryCatch: Object with 'try' and 'catch' properties containing arrow functions
+ * - DoInParallel: Variadic functions starting from argument 1
+ *
+ * @param callExpression - The flow logic call expression
+ * @param callee - The flow logic callee
+ * @returns Array of arrow function shapes
+ */
+export declare function extractFlowLogicBodies(callExpression: CallExpressionShape, callee: string): ArrowFunctionShape[];
+/**
+ * Rebuild a flow logic call expression with transformed config and bodies
+ * @param callExpression - Original call expression
+ * @param transformedConfig - Transformed config object
+ * @param transformedBodies - Transformed arrow function bodies
+ * @param callee - The flow logic callee
+ * @param record - The source record
+ * @returns Rebuilt CallExpressionShape
+ */
+export declare function rebuildFlowLogicWithDatapills(callExpression: CallExpressionShape, transformedConfig: ObjectShape, transformedBodies: ArrowFunctionShape[], callee: string, record: Record, transformedItemsArg?: Shape): CallExpressionShape;
+/**
+ * Type for config cleanup callback function
+ * Used to clean up Action/Subflow configs after transformation
+ */
+export type ConfigCleanupCallback = (configShape: Shape, instanceSource: Shape) => Shape;
+/**
+ * Recursively process an instance shape (Action, Subflow, or Flow Logic) to transform datapills
+ * This is the main entry point for datapill transformation that handles all instance types
+ *
+ * @param instanceShape - The instance shape to process (VariableStatementShape or CallExpressionShape)
+ * @param uuidToIdentifierMap - Map of UUID to variable identifiers for UUID-based datapills
+ * @param record - The source record for shape creation
+ * @param diagnostics - Diagnostics for error reporting
+ * @param paramName - Parameter name for semantic datapills (e.g., 'params')
+ * @param processShapeForDatapills - Recursive helper to process nested structures (objects/arrays)
+ * @param cleanupConfig - Optional callback to clean up Action/Subflow configs
+ * @returns DatapillTransformResult with transformed shape and change tracking
+ */
+export declare function processInstanceForDatapills(instanceShape: Shape, uuidToIdentifierMap: Map<string, IdentifierShape>, record: Record, diagnostics: Diagnostics, paramName: string, logger: Logger, processShapeForDatapills: (value: Shape, uuidToIdentifierMap: Map<string, IdentifierShape>, source: Record, diagnostics: Diagnostics, logger: Logger, parameterName?: string) => DatapillTransformResult, cleanupConfig?: ConfigCleanupCallback): DatapillTransformResult;