@servicenow/sdk-build-plugins 4.8.0 → 4.8.1

package/src/flow/utils/flow-shapes.ts

@@ -12,6 +12,25 @@ import type { ApprovalRulesType, ApprovalDueDateType } from '@servicenow/sdk-cor
 import { approvalRulesJsonToString, approvalRulesStringToJson } from './approval-rules-processor'
 import { APPROVAL_RULES_API_NAME, APPROVAL_DUE_DATE_API_NAME } from './flow-constants'
 
+/**
+ * Safely extracts a sysId string from a shape that may be either a plain StringShape
+ * or a FK-resolved Record. After build+install the SDK resolves FK fields to Record
+ * objects, so calling .asString() directly would throw.
+ */
+export function getRefSysId(shape: Shape | undefined): string | undefined {
+    if (!shape) {
+        return undefined
+    }
+    const str = shape.ifString()?.getValue()
+    if (str !== undefined) {
+        return str
+    }
+    if (shape instanceof Record) {
+        return shape.getId().getValue()
+    }
+    return undefined
+}
+
 /**
  * Abstract base class for all flow definition instances.
  * Extends CallExpressionShape to provide common functionality for flow constructs.

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

@@ -7,9 +7,9 @@ import { buildVariableRecords } from './flow-io-to-record'
 export type VariableTableType = 'sys_hub_flow_input' | 'sys_hub_flow_output' | 'sys_hub_flow_variable'
 
 /**
- * Parent table type (always sys_hub_flow for flows)
+ * Parent table type for flow variable/IO records
  */
-export type ParentTableType = 'sys_hub_flow'
+export type ParentTableType = 'sys_hub_flow' | 'sys_hub_flow_snapshot'
 
 /**
  * Process a flow variable configuration (inputs, outputs, or flow variables)
@@ -27,7 +27,8 @@ export async function processVariableConfig(
     varTable: VariableTableType,
     parentRecord: Record,
     factory: Factory,
-    diagnostics: Diagnostics
+    diagnostics: Diagnostics,
+    parentTable: ParentTableType = 'sys_hub_flow'
 ): Promise<Record[]> {
     if (!config) {
         return []
@@ -38,7 +39,7 @@ export async function processVariableConfig(
         parentRecord,
         factory,
         diagnostics,
-        parentTable: 'sys_hub_flow' as ParentTableType,
+        parentTable,
         varTable,
     })
 
@@ -58,9 +59,10 @@ export async function processFlowInputs(
     inputsConfig: ObjectShape | undefined,
     parentRecord: Record,
     factory: Factory,
-    diagnostics: Diagnostics
+    diagnostics: Diagnostics,
+    parentTable: ParentTableType = 'sys_hub_flow'
 ): Promise<Record[]> {
-    return processVariableConfig(inputsConfig, 'sys_hub_flow_input', parentRecord, factory, diagnostics)
+    return processVariableConfig(inputsConfig, 'sys_hub_flow_input', parentRecord, factory, diagnostics, parentTable)
 }
 
 /**
@@ -76,9 +78,10 @@ export async function processFlowOutputs(
     outputsConfig: ObjectShape | undefined,
     parentRecord: Record,
     factory: Factory,
-    diagnostics: Diagnostics
+    diagnostics: Diagnostics,
+    parentTable: ParentTableType = 'sys_hub_flow'
 ): Promise<Record[]> {
-    return processVariableConfig(outputsConfig, 'sys_hub_flow_output', parentRecord, factory, diagnostics)
+    return processVariableConfig(outputsConfig, 'sys_hub_flow_output', parentRecord, factory, diagnostics, parentTable)
 }
 
 /**
@@ -94,7 +97,15 @@ export async function processFlowVariables(
     flowVariablesConfig: ObjectShape | undefined,
     parentRecord: Record,
     factory: Factory,
-    diagnostics: Diagnostics
+    diagnostics: Diagnostics,
+    parentTable: ParentTableType = 'sys_hub_flow'
 ): Promise<Record[]> {
-    return processVariableConfig(flowVariablesConfig, 'sys_hub_flow_variable', parentRecord, factory, diagnostics)
+    return processVariableConfig(
+        flowVariablesConfig,
+        'sys_hub_flow_variable',
+        parentRecord,
+        factory,
+        diagnostics,
+        parentTable
+    )
 }

package/src/index.ts

@@ -83,4 +83,4 @@ export {
     DO_IN_PARALLEL_BLOCK_SYS_ID,
     TRY_CATCH_CATCH_SYS_ID,
 } from './flow/flow-logic/flow-logic-constants'
-export { FlowActivationTask } from './flow/post-install'
+export { FlowActivationTask, getRecordIdsByTable } from './flow/post-install'