@servicenow/sdk-build-plugins 4.2.0 → 4.4.0

package/src/flow/utils/flow-variable-processor.ts

@@ -0,0 +1,100 @@
+import type { Diagnostics, Factory, ObjectShape, Record } from '@servicenow/sdk-build-core'
+import { buildVariableRecords } from './flow-io-to-record'
+
+/**
+ * Type of variable table for flow I/O and variables
+ */
+export type VariableTableType = 'sys_hub_flow_input' | 'sys_hub_flow_output' | 'sys_hub_flow_variable'
+
+/**
+ * Parent table type (always sys_hub_flow for flows)
+ */
+export type ParentTableType = 'sys_hub_flow'
+
+/**
+ * Process a flow variable configuration (inputs, outputs, or flow variables)
+ * and generate the corresponding variable records
+ *
+ * @param config - The ObjectShape containing variable definitions
+ * @param varTable - The type of variable table (input, output, or variable)
+ * @param parentRecord - The parent flow record
+ * @param factory - Factory for creating records
+ * @param diagnostics - Diagnostics for error reporting
+ * @returns Array of records (both variable records and complex object records)
+ */
+export async function processVariableConfig(
+    config: ObjectShape | undefined,
+    varTable: VariableTableType,
+    parentRecord: Record,
+    factory: Factory,
+    diagnostics: Diagnostics
+): Promise<Record[]> {
+    if (!config) {
+        return []
+    }
+
+    const { variableRecords, complexObjectRecords } = await buildVariableRecords({
+        variablesConfig: config,
+        parentRecord,
+        factory,
+        diagnostics,
+        parentTable: 'sys_hub_flow' as ParentTableType,
+        varTable,
+    })
+
+    return [...complexObjectRecords, ...variableRecords]
+}
+
+/**
+ * Process flow inputs configuration
+ *
+ * @param inputsConfig - The ObjectShape containing input definitions
+ * @param parentRecord - The parent flow record
+ * @param factory - Factory for creating records
+ * @param diagnostics - Diagnostics for error reporting
+ * @returns Array of input records
+ */
+export async function processFlowInputs(
+    inputsConfig: ObjectShape | undefined,
+    parentRecord: Record,
+    factory: Factory,
+    diagnostics: Diagnostics
+): Promise<Record[]> {
+    return processVariableConfig(inputsConfig, 'sys_hub_flow_input', parentRecord, factory, diagnostics)
+}
+
+/**
+ * Process flow outputs configuration
+ *
+ * @param outputsConfig - The ObjectShape containing output definitions
+ * @param parentRecord - The parent flow record
+ * @param factory - Factory for creating records
+ * @param diagnostics - Diagnostics for error reporting
+ * @returns Array of output records
+ */
+export async function processFlowOutputs(
+    outputsConfig: ObjectShape | undefined,
+    parentRecord: Record,
+    factory: Factory,
+    diagnostics: Diagnostics
+): Promise<Record[]> {
+    return processVariableConfig(outputsConfig, 'sys_hub_flow_output', parentRecord, factory, diagnostics)
+}
+
+/**
+ * Process flow variables configuration
+ *
+ * @param flowVariablesConfig - The ObjectShape containing flow variable definitions
+ * @param parentRecord - The parent flow record
+ * @param factory - Factory for creating records
+ * @param diagnostics - Diagnostics for error reporting
+ * @returns Array of flow variable records
+ */
+export async function processFlowVariables(
+    flowVariablesConfig: ObjectShape | undefined,
+    parentRecord: Record,
+    factory: Factory,
+    diagnostics: Diagnostics
+): Promise<Record[]> {
+    return processVariableConfig(flowVariablesConfig, 'sys_hub_flow_variable', parentRecord, factory, diagnostics)
+}

package/src/flow/utils/label-cache-parser.ts

@@ -0,0 +1,37 @@
+import type { Logger } from '@servicenow/sdk-build-core'
+
+interface LabelCacheEntry {
+    name: string
+    label: string
+    reference?: string
+    reference_display?: string
+    type: string
+    base_type: string
+    parent_table_name?: string
+    column_name?: string
+    usedInstances?: Record<string, string[]>
+    attributes?: Record<string, string>
+}
+
+/**
+ * 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
+ */
+export function createLableCacheNameToTypeMap(labelCacheString: string, logger: Logger): Map<string, string> {
+    const nameToTypeMap = new Map<string, string>()
+
+    try {
+        const entries: LabelCacheEntry[] = 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
+}