@servicenow/sdk-build-plugins 4.2.0 → 4.4.0

package/dist/flow/utils/label-cache-parser.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLableCacheNameToTypeMap = createLableCacheNameToTypeMap;
+/**
+ * Creates a map of name to type from a label_cache string
+ * @param labelCacheString - The stringified JSON array from label_cache
+ * @returns Map where key is the name field and value is the type field
+ */
+function createLableCacheNameToTypeMap(labelCacheString, logger) {
+    const nameToTypeMap = new Map();
+    try {
+        const entries = JSON.parse(labelCacheString);
+        for (const entry of entries) {
+            if (entry.name && entry.type) {
+                nameToTypeMap.set(entry.name, entry.type);
+            }
+        }
+    }
+    catch (error) {
+        logger.error('Failed to parse label_cache string:', error);
+    }
+    return nameToTypeMap;
+}
+//# sourceMappingURL=label-cache-parser.js.map

package/dist/flow/utils/label-cache-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-cache-parser.js","sourceRoot":"","sources":["../../../src/flow/utils/label-cache-parser.ts"],"names":[],"mappings":";;AAoBA,sEAgBC;AArBD;;;;GAIG;AACH,SAAgB,6BAA6B,CAAC,gBAAwB,EAAE,MAAc;IAClF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAA;IAE/C,IAAI,CAAC;QACD,MAAM,OAAO,GAAsB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;QAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC3B,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC7C,CAAC;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAA;IAC9D,CAAC;IAED,OAAO,aAAa,CAAA;AACxB,CAAC"}

package/dist/flow/utils/label-cache-processor.d.ts

@@ -0,0 +1,119 @@
+import type { Record } from '@servicenow/sdk-build-core';
+import { CallExpressionShape } from '@servicenow/sdk-build-core';
+/**
+ * Helper function to extract trigger inputs from trigger instance shape
+ * Returns a map of input name to value for use in label cache processing
+ */
+export declare function extractTriggerInputs(triggerInstanceShape: CallExpressionShape | undefined): Map<string, unknown>;
+/**
+ * Helper function to extract trigger output definitions from trigger instance shape
+ * Returns a map of output name to { label, type } for use in label cache processing
+ */
+export declare function extractTriggerOutputs(triggerInstanceShape: CallExpressionShape | undefined): Map<string, {
+    label: string;
+    type: string;
+}>;
+/**
+ * Creates a lookup map from records by element name.
+ * Used to build maps of flow variables, subflow inputs, etc.
+ *
+ * @param records - Array of records to filter and map
+ * @param tableName - Table name to filter by
+ * @returns Map of element names to records
+ */
+export declare function createDefinitionMap(records: Record[], tableName: string): Map<string, Record>;
+/**
+ * Extracts labels from complex object schema and determines field types.
+ * Traverses nested complex object structures to build label paths.
+ */
+export declare function extractLabelsFromComplexObject(segments: string[], coRecord: Record, labelParts: string[]): string | null;
+/**
+ * Extracts forEach metadata from a flow logic instance record.
+ * This includes the step number and table name (if available) for forEach loops.
+ *
+ * @param rec - The flow logic instance record
+ * @param order - The step order number
+ * @param flowVarDefMap - Map of flow variable names to their definition records
+ * @returns Object with stepNumber and tableName
+ */
+export declare function extractForEachMetadata(rec: Record, order: number, flowVarDefMap: Map<string, Record>): {
+    stepNumber: number;
+    tableName: string | null;
+};
+/**
+ * Updates the forEach metadata map if the record is a forEach instance.
+ * Extracts metadata (step number and table name) and adds it to the map.
+ *
+ * @param rec - The flow logic instance record to check
+ * @param order - The step order number
+ * @param flowVarDefMap - Map of flow variable names to their definition records
+ * @param forEachMetadataMap - Map containing forEach metadata
+ * @returns Updated forEachMetadataMap with new forEach metadata if found
+ */
+export declare function updateForEachMetadata(rec: Record, order: number, flowVarDefMap: Map<string, Record>, forEachMetadataMap: Map<string, {
+    stepNumber: number;
+    tableName: string | null;
+}>): Map<string, {
+    stepNumber: number;
+    tableName: string | null;
+}>;
+/**
+ * Extracts data pills from a values structure and tracks their usage.
+ * Data pills are in the format {{dataPillName}} within string values.
+ *
+ * Handles three different table types:
+ * - sys_hub_action_instance_v2: Array of objects with name/value pairs
+ * - sys_hub_flow_logic_instance_v2: Object with keys (inputs, outputsToAssign, etc.) containing arrays
+ * - sys_hub_sub_flow_instance_v2: Handled as needed
+ *
+ * @param valuesData - Values data (array or object depending on table type)
+ * @param stepUuid - UUID of the step where these data pills are used
+ * @param labelCacheMap - Existing label cache map to update (modified in place)
+ * @param tableName - The table name to determine data structure
+ * @returns Updated label cache map with data pill usage tracked
+ */
+export declare function extractDataPillsFromValuesArray(valuesData: any, stepUuid: string, labelCacheMap: Map<string, any>): Map<string, any>;
+/**
+ * Resolves data pill metadata including label parts, variable definition, and type information.
+ * Handles flow variables, subflow inputs, trigger pills, and forEach item pills.
+ */
+export declare function resolveDataPillMetadata(segments: string[], flowVarDefMap: Map<string, Record>, subflowInputDefMap: Map<string, Record>, relatedRecords: Record[], triggerData?: {
+    inputs: Map<string, any>;
+    outputs: Map<string, {
+        label: string;
+        type: string;
+    }>;
+}, forEachMetadataMap?: Map<string, {
+    stepNumber: number;
+    tableName: string | null;
+}>): {
+    labelParts: string[];
+    varDef: Record | undefined;
+    extractedType: string | null;
+};
+/**
+ * Extracts and aggregates label cache data from instance record attributes.
+ * Returns a new map with enriched data pill metadata.
+ */
+export declare function extractLabelCache(flowVarDefMap: Map<string, Record>, subflowInputDefMap: Map<string, Record>, relatedRecords: Record[], existingLabelCacheMap?: Map<string, any>, triggerData?: {
+    inputs: Map<string, any>;
+    outputs: Map<string, {
+        label: string;
+        type: string;
+    }>;
+}, forEachMetadataMap?: Map<string, {
+    stepNumber: number;
+    tableName: string | null;
+}>): Map<string, any>;
+/**
+ * Builds data pill metadata attributes for instance records.
+ * Used by action and subflow instances to track data pill usage.
+ *
+ * This metadata is stored in the instance's attributes field and later enriched in
+ * the flow definition's label_cache with proper labels, types, and references.
+ *
+ * @param dataPillMetadata - Map of data pill metadata collected during instance processing
+ * @param instanceUiId - The UUID of the instance
+ * @returns Array of data pill metadata attributes ready for instance record
+ */
+export declare function buildDataPillAttributes(dataPillMetadata: Map<string, any>, instanceUiId: string): any[];