@servicenow/sdk-build-plugins 4.1.1 → 4.3.0

package/dist/flow/utils/schema-to-flow-object.js

@@ -0,0 +1,318 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildComplexObjectFromSchema = buildComplexObjectFromSchema;
+exports.getAttributeValue = getAttributeValue;
+exports.parseAttributesToObject = parseAttributesToObject;
+// biome-ignore-all lint/suspicious/noExplicitAny: This file processes dynamic JSON schemas
+const sdk_build_core_1 = require("@servicenow/sdk-build-core");
+const db_1 = require("@servicenow/sdk-core/runtime/db");
+const flow_constants_1 = require("./flow-constants");
+/**
+ * Reverse of `generateSchemaFromObject`.
+ * Takes the `serialized_content` field from a `sys_complex_object` record and
+ * rebuilds a `FlowObject(...)` call-expression shape that can be placed back in
+ * the Fluent source.
+ */
+// ------------------------------------------------------------
+// Schema <-> Column API mappings (inverse of COLUMN_TYPE_TO_SCHEMA_TYPE)
+// ------------------------------------------------------------
+const SCHEMA_TYPE_TO_COLUMN_API = {
+    string: db_1.StringColumn.name,
+    integer: db_1.IntegerColumn.name,
+    number: db_1.DecimalColumn.name,
+    boolean: db_1.BooleanColumn.name,
+    date: db_1.DateTimeColumn.name,
+    glide_date_time: db_1.DateTimeColumn.name,
+    choice: db_1.ChoiceColumn.name,
+    reference: db_1.ReferenceColumn.name,
+};
+/**
+ * Build a `CallExpressionShape` for a simple (non-object) field given its
+ * schema primitive type and associated facets.
+ */
+function buildPrimitiveFieldCallExpr(fieldFacet, source) {
+    const childType = fieldFacet.get('childType').ifDefined()?.asString()?.getValue();
+    const schemaType = childType ?? fieldFacet.get('type')?.asString()?.getValue();
+    const callee = SCHEMA_TYPE_TO_COLUMN_API[schemaType] ?? db_1.StringColumn.name;
+    const additionalProps = {};
+    // Extract referenceTable for ReferenceColumn type
+    const referenceTable = fieldFacet.get('reference')?.ifString()?.getValue();
+    if (referenceTable && schemaType === 'reference') {
+        additionalProps['referenceTable'] = referenceTable;
+    }
+    const isChoiceColumn = callee === db_1.ChoiceColumn.name;
+    const isStringColumn = callee === db_1.StringColumn.name;
+    return new sdk_build_core_1.CallExpressionShape({
+        source,
+        callee,
+        args: [
+            fieldFacet
+                .transform(({ $ }) => ({
+                label: $.from('label', 'childLabel').map((label, child) => (child.isDefined() ? child : label)),
+                mandatory: $.toBoolean().def(false),
+                ...(isStringColumn && {
+                    maxLength: $.from('maxLength', 'childMaxLength')
+                        .map((maxLength, child) => {
+                        const value = child.isDefined() ? child : maxLength;
+                        if (value.isString() && value.getValue() !== '') {
+                            return value.toNumber().getValue();
+                        }
+                        return 0;
+                    })
+                        .def(0),
+                }),
+                default: $.from('defaultValue', 'childDefaultValue')
+                    .map((defaultValue, childDefault) => (childDefault.isDefined() ? childDefault : defaultValue))
+                    .def(''),
+                hint: $.from('hint', 'childHint')
+                    .map((hint, childHint) => (childHint.isDefined() ? childHint : hint))
+                    .def(''),
+                ...(isChoiceColumn && {
+                    choices: $.def({}),
+                    dropdown: $.from('choiceOption')
+                        .map((value) => {
+                        const val = value.getValue();
+                        if (value.if(sdk_build_core_1.UndefinedShape) ||
+                            val === '' ||
+                            value.toNumber().getValue() === flow_constants_1.ChoiceDropdown.DROPDOWN_WITH_NONE) {
+                            return undefined;
+                        }
+                        return db_1.choiceDropdown[flow_constants_1.ChoiceDropdown.DROPDOWN_WITHOUT_NONE];
+                    })
+                        .def(db_1.choiceDropdown[flow_constants_1.ChoiceDropdown.DROPDOWN_WITH_NONE]),
+                }),
+            }))
+                .merge(additionalProps),
+        ],
+    });
+}
+/**
+ * Recursively converts the schema representation for a FlowArray into an
+ * `ObjectShape` that will be supplied as the first argument to a
+ * `FlowArray(...)` call-expression.
+ */
+function buildFlowArrayFromSchema(schemaContent, source, parentTypeFacet, complexObjectSysId, co_type_name) {
+    const rootContent = schemaContent['$COCollectionField'];
+    if (!rootContent) {
+        throw new Error('Invalid complex object schema: $COCollectionField not found');
+    }
+    let rootTypeFacet = parseTypeFacet(source, schemaContent, '$COCollectionField');
+    if (!rootTypeFacet) {
+        rootTypeFacet = parentTypeFacet;
+    }
+    const type = rootTypeFacet.get('type')?.asString()?.getValue();
+    let elementType;
+    if (type === 'array.object') {
+        const childKey = parentTypeFacet.get('childName')?.asString()?.getValue();
+        elementType = buildFlowObjectFromSchema(rootContent[0][childKey], source, rootTypeFacet);
+    }
+    else {
+        elementType = buildPrimitiveFieldCallExpr(parentTypeFacet, source);
+    }
+    return new sdk_build_core_1.CallExpressionShape({
+        source,
+        callee: 'FlowArray',
+        args: [
+            parentTypeFacet.transform(({ $ }) => ({
+                ...(complexObjectSysId ? { $id: $.val(complexObjectSysId) } : {}),
+                ...(co_type_name ? { co_type_name: $.val(co_type_name) } : {}),
+                elementType: $.val(elementType),
+                label: $.def(''),
+                mandatory: $.toBoolean().def(false),
+                hint: $.def(''),
+                maxRows: $.from('maxRows', 'max_rows')
+                    .map((maxRows, max_rows) => {
+                    const value = max_rows.isDefined() ? max_rows : maxRows;
+                    if (value.isString() && value.getValue() !== '') {
+                        return value.toNumber().getValue();
+                    }
+                    return undefined;
+                })
+                    .def(undefined),
+                childName: $,
+            })),
+        ],
+    });
+}
+function buildNestedFlowArrayFromSchema(schemaContent, source, parentTypeFacet) {
+    const type = parentTypeFacet.get('type')?.asString()?.getValue();
+    let elementType;
+    if (type === 'array.object') {
+        // Unwrap the wrapper if present (used for nested array.object)
+        // ServiceNow stores nested array.object elements in two ways:
+        // 1. With $<num>_<fieldName> wrapper (e.g., $0_task)
+        // 2. With the field name itself as wrapper (e.g., tasks inside tasks array)
+        const keys = Object.keys(schemaContent);
+        const wrapperKey = keys.find((k) => /^\$\d+_/.test(k)) ?? keys.find((k) => !k.endsWith('.$field_facets'));
+        const innerContent = wrapperKey ? schemaContent[wrapperKey] : schemaContent;
+        elementType = buildFlowObjectFromSchema(innerContent, source, parentTypeFacet);
+    }
+    else {
+        elementType = buildPrimitiveFieldCallExpr(parentTypeFacet, source);
+    }
+    return new sdk_build_core_1.CallExpressionShape({
+        source,
+        callee: 'FlowArray',
+        args: [
+            parentTypeFacet.transform(({ $ }) => ({
+                elementType: $.val(elementType),
+                label: $.def(''),
+                mandatory: $.toBoolean().def(false),
+                hint: $.def(''),
+                maxRows: $.from('maxRows', 'max_rows')
+                    .map((maxRows, max_rows) => {
+                    const value = max_rows.isDefined() ? max_rows : maxRows;
+                    if (value.isString() && value.getValue() !== '') {
+                        return value.toNumber().getValue();
+                    }
+                    return undefined;
+                })
+                    .def(undefined),
+                childName: $,
+            })),
+        ],
+    });
+}
+/**
+ * Recursively converts the schema representation for a FlowObject into an
+ * `ObjectShape` that will be supplied as the first argument to a
+ * `FlowObject(...)` call-expression.
+ */
+function buildFlowObjectFromSchema(schemaContent, source, parentTypeFacet, complexObjectSysId, co_type_name) {
+    const properties = {};
+    if (typeof schemaContent === 'object') {
+        for (const [key, value] of Object.entries(schemaContent)) {
+            // Skip facet keys – they belong to the previous field name.
+            if (key.endsWith('.$field_facets')) {
+                continue;
+            }
+            const fieldFacet = parseFieldFacet(source, schemaContent, key);
+            if (!fieldFacet) {
+                throw new Error(`Invalid complex object schema: ${key} facet not found`);
+            }
+            if (typeof value === 'string') {
+                // Primitive field
+                properties[key] = buildPrimitiveFieldCallExpr(fieldFacet, source);
+            }
+            else if (typeof value === 'object' && value !== null) {
+                if (Array.isArray(value)) {
+                    // Nested FlowArray
+                    properties[key] = buildNestedFlowArrayFromSchema(value[0], source, fieldFacet);
+                }
+                else {
+                    // Nested FlowObject
+                    properties[key] = buildFlowObjectFromSchema(value, source, fieldFacet);
+                }
+            }
+        }
+    }
+    return new sdk_build_core_1.CallExpressionShape({
+        source,
+        callee: 'FlowObject',
+        args: [
+            parentTypeFacet.transform(({ $ }) => ({
+                ...(complexObjectSysId ? { $id: $.val(complexObjectSysId) } : {}),
+                ...(co_type_name ? { co_type_name: $.val(co_type_name) } : {}),
+                fields: $.val(properties),
+                label: $.from('label', 'childLabel')
+                    .map((label, child) => (child.isDefined() ? child : label))
+                    .def(''),
+                mandatory: $.toBoolean().def(false),
+            })),
+        ],
+    });
+}
+/**
+ * Main entry ‑ convert `serialized_content` JSON → FlowObject or FlowArray call expression.
+ *
+ * @param schema Parsed `serialized_content`.
+ * @param source Optional source node to attach to created shapes.
+ * @param complexObjectSysId The sys_id of the sys_complex_object record (if available)
+ * @param co_type_name The name field from sys_complex_object
+ */
+function buildComplexObjectFromSchema(source, schema, attributes, complexObjectSysId, co_type_name) {
+    const { co_type_name: attrCoTypeName, uiType, ...rest } = attributes;
+    const rootKey = `FlowDesigner:${attrCoTypeName}`;
+    if (!rootKey) {
+        throw new Error(`Invalid complex object schema: ${attrCoTypeName} not found`);
+    }
+    const rootContent = schema[rootKey];
+    let rootTypeFacet = parseTypeFacet(source, schema, rootKey);
+    if (!rootTypeFacet) {
+        throw new Error('Invalid complex object schema: root type facet not found');
+    }
+    rootTypeFacet = rootTypeFacet.merge({
+        type: uiType,
+        ...rest,
+    });
+    // Pass the explicit co_type_name parameter (undefined for deterministic, value for non-deterministic)
+    if (uiType.startsWith('array.')) {
+        return buildFlowArrayFromSchema(rootContent, source, rootTypeFacet, complexObjectSysId, co_type_name);
+    }
+    return buildFlowObjectFromSchema(rootContent, source, rootTypeFacet, complexObjectSysId, co_type_name);
+}
+function parseTypeFacet(source, schema, key) {
+    const facetKey = `${key}.$type_facets`;
+    return parseFacet(source, schema, facetKey);
+}
+function parseFieldFacet(source, schema, key) {
+    const facetKey = `${key}.$field_facets`;
+    return parseFacet(source, schema, facetKey);
+}
+function parseFacet(source, schema, facetKey) {
+    const facet = schema[facetKey]?.SimpleMapFacet;
+    if (!facet) {
+        return undefined;
+    }
+    const choices = schema[facetKey]?.SimpleChoiceFacet;
+    try {
+        const parsed = JSON.parse(facet);
+        const parsedChoices = choices ? JSON.parse(choices)['choice_map_key$'] : {};
+        return new sdk_build_core_1.ObjectShape({
+            source,
+            properties: {
+                type: parsed['uiType'],
+                label: parsed['label'],
+                mandatory: parsed['mandatory'],
+                reference: parsed['reference'],
+                childName: parsed['child_name'],
+                childMaxLength: parsed['child_maxsize'],
+                childHint: parsed['child_hint'],
+                maxLength: parsed['max_length'],
+                maxRows: parsed['max_rows'],
+                childType: parsed['child_type'],
+                childLabel: parsed['child_label'],
+                choiceOption: parsed['choiceOption'],
+                defaultValue: parsed['default_value'],
+                childDefaultValue: parsed['child_defaultValue'],
+                hint: parsed['hint'],
+                choices: Object.keys(parsedChoices).reduce((acc, key) => {
+                    const { label, value, order } = JSON.parse(parsedChoices[key]);
+                    acc[value] = { label, sequence: order };
+                    return acc;
+                }, {}),
+            },
+        });
+    }
+    catch {
+        // Failed to parse facet - returning undefined
+    }
+    return undefined;
+}
+function getAttributeValue(attributesStr, key) {
+    const attributes = parseAttributesToObject(attributesStr);
+    return attributes[key];
+}
+function parseAttributesToObject(attributesStr) {
+    return attributesStr
+        .split(',')
+        .map((p) => p.trim())
+        .reduce((acc, pair) => {
+        const [key, value] = pair.split('=');
+        if (key && value !== undefined) {
+            acc[key] = value;
+        }
+        return acc;
+    }, {});
+}
+//# sourceMappingURL=schema-to-flow-object.js.map

package/dist/flow/utils/schema-to-flow-object.js.map

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

package/dist/flow/utils/utils.d.ts

@@ -0,0 +1,117 @@
+import { CallExpressionShape, type Database, type Diagnostics, type IdentifierShape, type Logger, type ObjectShape, type PropertyAccessShape, type Record, type Shape, type TemplateExpressionShape, type Transform, ts } from '@servicenow/sdk-build-core';
+import { PillShape } from '../utils/data-pill-shapes';
+export declare function sysIdToUuid(id: string): string;
+export declare function uuidToSysId(id: string): string;
+/**
+ * Get the identifier name from an original source (TypeScript node)
+ * Searches for a VariableDeclaration ancestor and extracts the identifier name
+ *
+ * @param originalSource - The original TypeScript source node
+ * @returns The identifier name if found, undefined otherwise
+ */
+export declare function getIdentifierFromSource(originalSource: unknown): string | undefined;
+/**
+ * Get the identifier name for an action/subflow instance from its original source
+ * Only checks if this node is DIRECTLY wrapped in a VariableDeclaration (not any ancestor)
+ * This prevents scope collisions where inner actions inherit parent Subflow/Flow variable names
+ *
+ * Use this specifically for preserving action/subflow variable names during transform
+ *
+ * @param originalSource - The original source to extract the identifier from
+ * @returns The identifier name if found, undefined otherwise
+ */
+export declare function getDirectVariableIdentifier(originalSource: unknown): string | undefined;
+/**
+ * Get the identifier name from a record's original source
+ * Convenience wrapper around getIdentifierFromSource for Record types
+ *
+ * @param record - The record to extract the identifier from
+ * @returns The identifier name if found, undefined otherwise
+ */
+export declare function getIdentifierFromRecord(record: Record): string | undefined;
+/**
+ * Get the identifier name from a shape's original source
+ * Convenience wrapper around getIdentifierFromSource for Shape types
+ *
+ * @param shape - The shape to extract the identifier from
+ * @returns The identifier name if found, undefined otherwise
+ */
+export declare function getIdentifierFromShape(shape: Shape): string | undefined;
+/**
+ * Set of allowed FlowValueType helper function names for flow variable validation
+ *
+ * @constant {Set<string>}
+ * @example
+ * ```typescript
+ * // Supported types: StringColumn, IntegerColumn, DecimalColumn, ReferenceColumn,
+ * // DateTimeColumn, BooleanColumn, GenericColumn, FlowObject, FlowArray
+ * if (ALLOWED_VARIABLE_CALLEES.has('StringColumn')) {
+ *   // StringColumn is supported
+ * }
+ * ```
+ */
+export declare const ALLOWED_VARIABLE_CALLEES: Set<string>;
+export declare const ALLOWED_VARIABLE_CALLEES_IN_FLOW_OBJECT: Set<string>;
+/**
+ * Validates a single flow variable call expression for type safety and correctness
+ *
+ * @param variableCall - The CallExpressionShape representing the variable definition
+ * @param path - The path/name of the variable for error reporting
+ * @param diagnostics - Diagnostics object for reporting validation errors
+ *
+ * @example
+ * ```typescript
+ * // Validates allowed types, GenericColumn columnType (json/float only),
+ * // and recursively validates FlowArray/FlowObject structures
+ * validateFlowVariableCall(StringColumn({ label: 'Name' }), 'flow_variables.userName', diagnostics)
+ * ```
+ */
+export declare function validateFlowVariableCall(variableCall: CallExpressionShape, path: string, diagnostics: Diagnostics): void;
+/**
+ * Recursively validates FlowObject fields for nested FlowArray violations and other type validations
+ *
+ * @param flowObjectCall - The CallExpressionShape representing the FlowObject definition
+ * @param path - The path/name of the variable for error reporting
+ * @param diagnostics - Diagnostics object for reporting validation errors
+ *
+ * @example
+ * ```typescript
+ * // Validates all field types are allowed, recursively validates nested
+ * // FlowArray/FlowObject structures, and checks GenericColumn columnType
+ * FlowObject({ fields: { name: StringColumn({...}), data: FlowArray({...}) } })
+ * ```
+ */
+export declare function validateFlowObjectFields(flowObjectCall: CallExpressionShape, path: string, diagnostics: Diagnostics): void;
+/**
+ * Recursively searches ancestors of a node to find a CallExpression
+ * with any of the given callee names.
+ *
+ * @param node - The starting node
+ * @param calleeNames - One or more function names to match against
+ * @returns The CallExpression if found, otherwise undefined
+ */
+export declare function findAncestorByCalleeName(node: ts.Node | undefined, ...calleeNames: string[]): ts.CallExpression | undefined;
+/**
+ * Resolves a data pill shape by transforming it and handling trigger pills
+ * @param shape - The shape to resolve (PropertyAccessShape, TemplateExpressionShape, or IdentifierShape)
+ * @param transform - The transform instance
+ * @returns The resolved value or the original shape value if not a data pill
+ */
+export declare function resolveDataPillShape(shape: PillShape | PropertyAccessShape | TemplateExpressionShape | IdentifierShape, transform: Transform): Promise<unknown>;
+/**
+ * Function to get the record by transforming the FDInstanceShape
+ * @param shape - The shape to transform (VariableStatementShape, CallExpressionShape)
+ * @param transform - The transform instance
+ * @returns The instance record of the FDInstanceShape
+ */
+export declare function getRecordFromFlowInstaceShape(shape: Shape, transform: Transform): Promise<Record | undefined>;
+export declare function checkForUnsupportedFlowDescendants(descendants: Database, record: Record, logger: Logger): boolean;
+export declare const getCoreActionIdentifier: (sysId: string) => string | undefined;
+/**
+ * Extracts the order value from a record for sorting purposes.
+ * Converts the 'order' field to a number, defaulting to 0 if not present or invalid.
+ *
+ * @param record - The record containing the order field
+ * @returns The numeric order value
+ */
+export declare function getOrder(x: ObjectShape): number;