@servicenow/sdk-build-plugins 4.7.2 → 4.8.1

package/dist/alias/alias-plugin.d.ts

@@ -0,0 +1,2 @@
+import { Plugin } from '@servicenow/sdk-build-core';
+export declare const AliasPlugin: Plugin;

package/dist/alias/alias-plugin.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AliasPlugin = void 0;
+const sdk_build_core_1 = require("@servicenow/sdk-build-core");
+const now_id_plugin_1 = require("../now-id-plugin");
+const SYS_ALIAS = 'sys_alias';
+// Maps developer-facing camelCase connection type labels to ServiceNow platform values
+const CONNECTION_TYPE_MAP = {
+    httpConnection: 'http_connection',
+    jdbcConnection: 'jdbc_connection',
+    basicConnection: 'sys_connection',
+    jmsConnection: 'orch_jms_ds',
+};
+// Reverse map: platform values to camelCase labels (used in toShape)
+const CONNECTION_TYPE_REVERSE_MAP = Object.fromEntries(Object.entries(CONNECTION_TYPE_MAP).map(([label, platform]) => [platform, label]));
+// Default retry policy sys_ids by platform connection type
+// Mirrors ServiceNow client scripts: "Default RetryPolicy onLoad new form" / "Default RetryPolicy onChange Conn-type"
+const DEFAULT_RETRY_POLICY = {
+    http_connection: 'ef751ff07301330025d71afe2ff6a7f9', // Default HTTP Retry Policy
+    jdbc_connection: 'e8ddcb7573331010cbfec9d234f6a7fd', // Default JDBC Retry Policy
+    sys_connection: 'e385484773100010e3a71afe2ff6a709', // Default Basic Connection Retry Policy
+};
+/**
+ * Hints when `connectionType` is set on a credential-only alias.
+ *
+ * Based on sys_alias UI policies:
+ * - "Show / hide connection type" — connectionType is only shown when type='connection'
+ */
+function hintConnectionTypeForCredential(connectionTypeShape, aliasType, diagnostics) {
+    if (aliasType === 'credential' && connectionTypeShape.isDefined()) {
+        diagnostics.warn(connectionTypeShape, `'connectionType' is ignored when type is 'credential'. It only applies to 'connection' type aliases.`);
+    }
+}
+/**
+ * Resolves a developer-facing camelCase connection type to the ServiceNow platform value.
+ * Returns the platform default ('http_connection') if the value is not provided.
+ */
+function resolveConnectionType(connectionTypeShape) {
+    const value = connectionTypeShape.ifString()?.getValue();
+    if (!value) {
+        return 'http_connection';
+    }
+    return CONNECTION_TYPE_MAP[value] ?? 'http_connection';
+}
+/**
+ * Computes the `id` field value for a sys_alias record.
+ * ServiceNow's virtual field calculation: scope + '.' + name (global scope omits prefix).
+ * Without this, the stored 'id' column is empty and Flow Designer's
+ * idISNOTEMPTY filter hides the alias from dropdowns.
+ */
+function computeAliasId(name, scope) {
+    const sanitizedName = name.replace(/[^A-Za-z0-9_]/g, '_');
+    return scope !== 'global' ? `${scope}.${sanitizedName}` : sanitizedName;
+}
+/**
+ * Validates fields related to child aliases.
+ *
+ * Based on sys_alias UI policy "HideEmptyParentField" — the parent field is hidden
+ * in the UI when type='credential'.
+ */
+function validateChildAliasFields(arg, diagnostics) {
+    const parent = arg.get('parent');
+    const type = arg.get('type');
+    // Warn if parent is set for credential-only alias — UI hides the field so it has no effect.
+    if (type?.isString() && type.getValue() === 'credential' && parent?.isDefined()) {
+        diagnostics.warn(parent, `'parent' field is not visible in the UI when type is 'credential'. ` +
+            `Parent aliases are only supported for 'connection' type aliases.`);
+    }
+}
+/**
+ * Validates fields related to 'connection' type alias.
+ *
+ * Based on sys_alias UI policies:
+ * - "Show/Hide Multiple connection flag" — multipleConnections is only shown when type='connection'
+ * - "Show / hide Default Retry Policy field" — retryPolicy is only shown when type='connection'
+ */
+function validateConnectionOnlyFields(arg, aliasType, diagnostics) {
+    if (aliasType === 'credential') {
+        const multipleConnections = arg.get('multipleConnections');
+        if (multipleConnections?.isDefined()) {
+            diagnostics.warn(multipleConnections, `'multipleConnections' is ignored when type is 'credential'. It only applies to 'connection' type aliases.`);
+        }
+        const retryPolicy = arg.get('retryPolicy');
+        if (retryPolicy?.isDefined()) {
+            diagnostics.warn(retryPolicy, `'retryPolicy' is ignored when type is 'credential'. It only applies to 'connection' type aliases.`);
+        }
+    }
+}
+exports.AliasPlugin = sdk_build_core_1.Plugin.create({
+    name: 'AliasPlugin',
+    records: {
+        [SYS_ALIAS]: {
+            toShape(record) {
+                // Resolve connection_type and alias type to determine default retry policy
+                const aliasType = record.get('type').toString().getValue() || 'connection';
+                const connType = record.get('connection_type').toString().getValue() || 'http_connection';
+                // For credential aliases, retry_policy is hidden in the UI and has no effect —
+                // treat whatever value is present as the default so it gets suppressed in Fluent output.
+                const retryPolicyValue = record.get('retry_policy').toString().getValue();
+                const defaultRetryPolicy = aliasType === 'connection' ? (DEFAULT_RETRY_POLICY[connType] ?? '') : retryPolicyValue;
+                const camelCaseConnType = CONNECTION_TYPE_REVERSE_MAP[connType] ?? 'httpConnection';
+                return {
+                    success: true,
+                    value: new sdk_build_core_1.CallExpressionShape({
+                        source: record,
+                        callee: 'Alias',
+                        args: [
+                            record.transform(({ $ }) => ({
+                                $id: $.val(now_id_plugin_1.NowIdShape.from(record)),
+                                name: $,
+                                type: $.def('connection'),
+                                connectionType: $.from('connection_type').val(camelCaseConnType).def('httpConnection'),
+                                description: $.def(''),
+                                parent: $.def(''),
+                                configurationTemplate: $.from('configuration_template').def(''),
+                                retryPolicy: $.from('retry_policy').def(defaultRetryPolicy),
+                                multipleConnections: $.from('multiple_connections').toBoolean().def(false),
+                                protectionPolicy: $.from('sys_policy').def(''),
+                            })),
+                        ],
+                    }),
+                };
+            },
+        },
+    },
+    shapes: [
+        {
+            shape: sdk_build_core_1.CallExpressionShape,
+            fileTypes: ['fluent'],
+            async toRecord(callExpression, { factory, diagnostics, config }) {
+                if (callExpression.getCallee() !== 'Alias') {
+                    return { success: false };
+                }
+                const argRaw = callExpression.getArgument(0);
+                if (!argRaw?.isObject()) {
+                    return { success: false };
+                }
+                const arg = argRaw.asObject();
+                // Validate required 'name' property.
+                // TypeScript enforces `name: string`, but the empty-string check is semantic and
+                // cannot be expressed in the type system.
+                const name = arg.get('name');
+                const nameValue = name.ifString()?.getValue().trim() ?? '';
+                if (nameValue === '') {
+                    diagnostics.error(name.isDefined() ? name : arg, `'name' is required and cannot be empty.`);
+                    return { success: false };
+                }
+                // Resolve type and connectionType
+                const typeShape = arg.get('type');
+                const aliasType = typeShape.ifString()?.getValue() ?? 'connection';
+                const connectionTypeShape = arg.get('connectionType');
+                const resolvedConnectionType = resolveConnectionType(connectionTypeShape);
+                // Cross-field hints
+                hintConnectionTypeForCredential(connectionTypeShape, aliasType, diagnostics);
+                validateChildAliasFields(arg, diagnostics);
+                validateConnectionOnlyFields(arg, aliasType, diagnostics);
+                // Resolve default retry policy (only for connection type)
+                const defaultRetryPolicy = aliasType === 'connection' ? (DEFAULT_RETRY_POLICY[resolvedConnectionType] ?? '') : '';
+                const aliasId = computeAliasId(nameValue, config.scope);
+                // Create the sys_alias record
+                const record = await factory.createRecord({
+                    source: callExpression,
+                    table: SYS_ALIAS,
+                    explicitId: arg.get('$id'),
+                    properties: arg.transform(({ $ }) => ({
+                        name: $,
+                        id: $.val(aliasId),
+                        type: $.def('connection'),
+                        connection_type: $.from('connectionType').val(resolvedConnectionType).def('http_connection'),
+                        description: $.def(''),
+                        parent: $,
+                        configuration_template: $.from('configurationTemplate'),
+                        retry_policy: $.from('retryPolicy').def(defaultRetryPolicy),
+                        multiple_connections: $.from('multipleConnections').def(false),
+                        sys_policy: $.from('protectionPolicy'),
+                    })),
+                });
+                return { success: true, value: record };
+            },
+        },
+    ],
+});
+//# sourceMappingURL=alias-plugin.js.map

package/dist/alias/alias-plugin.js.map

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

package/dist/alias/alias-template-plugin.d.ts

@@ -0,0 +1,2 @@
+import { Plugin } from '@servicenow/sdk-build-core';
+export declare const AliasTemplatePlugin: Plugin;

package/dist/alias/alias-template-plugin.js

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AliasTemplatePlugin = void 0;
+const sdk_build_core_1 = require("@servicenow/sdk-build-core");
+const now_id_plugin_1 = require("../now-id-plugin");
+const now_include_plugin_1 = require("../now-include-plugin");
+const server_module_plugin_1 = require("../server-module-plugin");
+const utils_1 = require("../utils");
+const DEFAULT_POST_PROCESS_SCRIPT = `(function execute(aliasId, connectionSysId, jsonDefaultData, jsonDynamicData) {
+   // aliasId: sys_id of the alias record
+   // connectionSysId: sys_id of the connection record created by using the default and dynamic data
+   // jsonDefaultData (String): The default JSON template data from template table
+   // e.g. var jsonDefaultParsed = JSON.parse(jsonDefaultData);
+   //      gs.info("default connection url = " + jsonDefaultParsed["connection"]["connection_url"]);
+   // jsonDynamicData (String): User input based on the key/values defined in "Dynamic Data"
+   // e.g. var jsonDynamicParsed = JSON.parse(jsonDynamicData);
+   //      gs.info("dynamic connection url = " + jsonDynamicParsed["connection.connection_url"]);
+})(aliasId, connectionSysId, jsonDefaultData, jsonDynamicData);
+`;
+const DEFAULT_PRE_EDIT_SCRIPT = `(function execute(aliasId, connectionSysId, jsonDefaultData, jsonDynamicData) {
+   // aliasId: sys_id of the alias record.
+   // connectionSysId: sys_id of the connection record created by using the default and dynamic data.
+   // jsonDefaultData (String): The default JSON template data from template table.
+   // e.g. var jsonDefaultParsed = JSON.parse(jsonDefaultData);
+   //      gs.info("default connection url = " + jsonDefaultParsed["connection"]["connection_url"]);
+   // jsonDynamicData (String): Current values of Connection and Credential fields (except Password fields) based on the key-value pairs defined in "Dynamic Data".
+   // e.g. var jsonDynamicParsed = JSON.parse(jsonDynamicData);
+   //      gs.info("dynamic connection url = " + jsonDynamicParsed["connection.connection_url"]);
+
+   //returns array of objects. Each object has name-value pairs for populating additional fields values in connections dashboard in the edit view.
+   //In this example script, additionalField1, additionalField2 are additional fields.
+   //Here we define calcAdditionalField1(), calcAdditionalField2() functions in the script
+   //to calculate current values for additionalField1, additionalField2.
+
+   //return [{
+   //         name: "additionalField1"
+   //         value: calcAdditionalField1(),
+   //    },
+   //    {
+   //         name: "additionalField2"
+   //         value: calcAdditionalField2(),
+   //    }
+   //];
+
+   return [];
+})(aliasId, connectionSysId, jsonDefaultData, jsonDynamicData);
+`;
+const DEFAULT_ON_EDIT_SCRIPT = `(function execute(aliasId, connectionSysId, jsonDefaultData, jsonDynamicData) {
+   // aliasId: sys_id of the alias record
+   // connectionSysId: sys_id of the connection record created by using the default and dynamic data
+   // jsonDefaultData (String): The default JSON template data from template table
+   // e.g. var jsonDefaultParsed = JSON.parse(jsonDefaultData);
+   //      gs.info("default connection url = " + jsonDefaultParsed["connection"]["connection_url"]);
+   // jsonDynamicData (String): User input based on the key/values defined in "Dynamic Data"
+   // e.g. var jsonDynamicParsed = JSON.parse(jsonDynamicData);
+   //      gs.info("dynamic connection url = " + jsonDynamicParsed["connection.connection_url"]);
+})(aliasId, connectionSysId, jsonDefaultData, jsonDynamicData);
+`;
+function camelToSnake(key) {
+    return key.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+function snakeToCamel(key) {
+    return key.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+// Only these keys differ between DB (snake_case) and Fluent API (camelCase).
+// All other keys — including arbitrary user-defined values in open [key: string]: unknown
+// sections — are left unchanged to avoid corrupting non-SDK field names.
+const DB_SNAKE_KEYS = new Set([
+    'connection_fields',
+    'credential_fields',
+    'additional_fields',
+    'use_mid',
+    'connection_url',
+    'default_group',
+]);
+const FLUENT_CAMEL_KEYS = new Set([
+    'connectionFields',
+    'credentialFields',
+    'additionalFields',
+    'useMid',
+    'connectionUrl',
+    'defaultGroup',
+]);
+function convertKeys(obj, converter, definedKeys) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => convertKeys(item, converter, definedKeys));
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const newKey = definedKeys.has(key) ? converter(key) : key;
+        result[newKey] = convertKeys(value, converter, definedKeys);
+    }
+    return result;
+}
+/**
+ * Parse JSON string from DB and convert snake_case keys to camelCase (DB → Fluent)
+ * Used in toShape for dynamicDataSchema and defaultDataTemplate
+ */
+function parseDbJson(v) {
+    const parsed = v?.ifNotEmpty()?.parseJson();
+    if (!parsed) {
+        return undefined;
+    }
+    const db = parsed.getValue();
+    if (db === undefined || db === null) {
+        return undefined;
+    }
+    return convertKeys(db, snakeToCamel, DB_SNAKE_KEYS);
+}
+/**
+ * Convert camelCase keys to snake_case and stringify to JSON (Fluent → DB)
+ * Used in toRecord for dynamicDataSchema and defaultDataTemplate
+ */
+function serializeFluentJson(v) {
+    if (v === undefined || v === null) {
+        return undefined;
+    }
+    return JSON.stringify(convertKeys(v, camelToSnake, FLUENT_CAMEL_KEYS), null, 2);
+}
+/**
+ * Helper function to handle ModuleFunctionShape transformation for alias template scripts
+ * Converts module function references to function call strings with proper parameters
+ */
+function mapScriptWithModuleSupport(v) {
+    return (v
+        .if(server_module_plugin_1.ModuleFunctionShape)
+        ?.toString((n) => `${n}({{PARAMS}})`, ['aliasId', 'connectionSysId', 'jsonDefaultData', 'jsonDynamicData']) ?? v);
+}
+exports.AliasTemplatePlugin = sdk_build_core_1.Plugin.create({
+    name: 'AliasTemplatePlugin',
+    records: {
+        sys_alias_templates: {
+            async toShape(record, { transform }) {
+                // Only call NowIncludeShape.fromRecord for non-empty, non-default script fields.
+                // Scripts that match the default are omitted so round-trips stay clean.
+                const preEditScriptField = record.get('pre_edit_script').ifString()?.ifNotEmpty();
+                const onEditScriptField = record.get('on_edit_script').ifString()?.ifNotEmpty();
+                const postProcessScriptField = record.get('post_process_script').ifString()?.ifNotEmpty();
+                const preEditScript = preEditScriptField && preEditScriptField.getValue().trim() !== DEFAULT_PRE_EDIT_SCRIPT.trim()
+                    ? await now_include_plugin_1.NowIncludeShape.fromRecord(record, preEditScriptField, transform)
+                    : undefined;
+                const onEditScript = onEditScriptField && onEditScriptField.getValue().trim() !== DEFAULT_ON_EDIT_SCRIPT.trim()
+                    ? await now_include_plugin_1.NowIncludeShape.fromRecord(record, onEditScriptField, transform)
+                    : undefined;
+                const postProcessScript = postProcessScriptField &&
+                    postProcessScriptField.getValue().trim() !== DEFAULT_POST_PROCESS_SCRIPT.trim()
+                    ? await now_include_plugin_1.NowIncludeShape.fromRecord(record, postProcessScriptField, transform)
+                    : undefined;
+                return {
+                    success: true,
+                    value: new sdk_build_core_1.CallExpressionShape({
+                        source: record,
+                        callee: 'AliasTemplate',
+                        args: [
+                            record.transform(({ $ }) => ({
+                                $id: $.val(now_id_plugin_1.NowIdShape.from(record)),
+                                name: $,
+                                // JSON strings stored in DB → typed objects in Fluent code
+                                // Only defined SDK keys are converted from snake_case to camelCase
+                                dynamicDataSchema: $.from('dynamic_data_schema').map((v) => parseDbJson(v.ifString())),
+                                defaultDataTemplate: $.from('default_data_template').map((v) => parseDbJson(v.ifString())),
+                                // Script fields via NowIncludeShape for IDE file support
+                                preEditScript: $.val(preEditScript),
+                                onEditScript: $.val(onEditScript),
+                                postProcessScript: $.val(postProcessScript),
+                                // Reference field — omit when empty
+                                testAction: $.from('test_action').def(''),
+                            })),
+                        ],
+                    }),
+                };
+            },
+        },
+    },
+    shapes: [
+        {
+            shape: sdk_build_core_1.CallExpressionShape,
+            fileTypes: ['fluent'],
+            async toRecord(callExpression, { factory, config, diagnostics }) {
+                if (callExpression.getCallee() !== 'AliasTemplate') {
+                    return { success: false };
+                }
+                const arg = callExpression.getArgument(0).asObject();
+                // Check for unresolved script references
+                if (arg.get('preEditScript').isUnresolved()) {
+                    diagnostics.error(arg.get('preEditScript').getOriginalNode(), `Unable to resolve the preEditScript reference, ensure the imported module is within the ${config.serverModulesDir} directory.`);
+                }
+                if (arg.get('onEditScript').isUnresolved()) {
+                    diagnostics.error(arg.get('onEditScript').getOriginalNode(), `Unable to resolve the onEditScript reference, ensure the imported module is within the ${config.serverModulesDir} directory.`);
+                }
+                if (arg.get('postProcessScript').isUnresolved()) {
+                    diagnostics.error(arg.get('postProcessScript').getOriginalNode(), `Unable to resolve the postProcessScript reference, ensure the imported module is within the ${config.serverModulesDir} directory.`);
+                }
+                return {
+                    success: true,
+                    value: await factory.createRecord({
+                        source: callExpression,
+                        table: 'sys_alias_templates',
+                        explicitId: arg.get('$id'),
+                        properties: arg.transform(({ $ }) => ({
+                            name: $,
+                            // Typed objects in Fluent code → JSON strings for DB
+                            // Only defined SDK keys are converted from camelCase to snake_case
+                            dynamic_data_schema: $.from('dynamicDataSchema').map((v) => serializeFluentJson(v.ifDefined() ? v.getValue() : undefined)),
+                            default_data_template: $.from('defaultDataTemplate').map((v) => serializeFluentJson(v.ifDefined() ? v.getValue() : undefined)),
+                            // Script fields — CDATA wraps both inline strings and Now.include() content
+                            // Support for app_modules via ModuleFunctionShape
+                            pre_edit_script: $.from('preEditScript')
+                                .map(mapScriptWithModuleSupport)
+                                .toCdata()
+                                .def(DEFAULT_PRE_EDIT_SCRIPT),
+                            on_edit_script: $.from('onEditScript')
+                                .map(mapScriptWithModuleSupport)
+                                .toCdata()
+                                .def(DEFAULT_ON_EDIT_SCRIPT),
+                            post_process_script: $.from('postProcessScript')
+                                .map(mapScriptWithModuleSupport)
+                                .toCdata()
+                                .def(DEFAULT_POST_PROCESS_SCRIPT),
+                            // Reference field — extract sys_id from Record ref or plain string
+                            test_action: $.from('testAction').map((v) => (0, utils_1.toReference)(v)),
+                        })),
+                    }),
+                };
+            },
+        },
+    ],
+});
+//# sourceMappingURL=alias-template-plugin.js.map

package/dist/alias/alias-template-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-template-plugin.js","sourceRoot":"","sources":["../../src/alias/alias-template-plugin.ts"],"names":[],"mappings":";;;AAAA,+DAAsG;AACtG,oDAA6C;AAC7C,8DAAuD;AACvD,kEAA6D;AAC7D,oCAAsC;AAEtC,MAAM,2BAA2B,GAAG;;;;;;;;;;CAUnC,CAAA;AACD,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B/B,CAAA;AACD,MAAM,sBAAsB,GAAG;;;;;;;;;;CAU9B,CAAA;AAED,SAAS,YAAY,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;AACxE,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;AACxE,CAAC;AAED,6EAA6E;AAC7E,0FAA0F;AAC1F,yEAAyE;AACzE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC1B,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,SAAS;IACT,gBAAgB;IAChB,eAAe;CAClB,CAAC,CAAA;AACF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAC9B,kBAAkB;IAClB,kBAAkB;IAClB,kBAAkB;IAClB,QAAQ;IACR,eAAe;IACf,cAAc;CACjB,CAAC,CAAA;AAEF,SAAS,WAAW,CAAC,GAAY,EAAE,SAAkC,EAAE,WAAwB;IAC3F,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,GAAG,CAAA;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAA;IACvE,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QAC1D,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,CAA0B;IAC3C,MAAM,MAAM,GAAG,CAAC,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,CAAA;IAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,SAAS,CAAA;IACpB,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC5B,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,SAAS,CAAA;IACpB,CAAC;IACD,OAAO,WAAW,CAAC,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAA;AACvD,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,CAAU;IACnC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,SAAS,CAAA;IACpB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AACnF,CAAC;AAED;;;GAGG;AACH,SAAS,0BAA0B,CAAC,CAAQ;IACxC,OAAO,CACH,CAAC;SACI,EAAE,CAAC,0CAAmB,CAAC;QACxB,EAAE,QAAQ,CACN,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,EACjC,CAAC,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CACvE,IAAI,CAAC,CACb,CAAA;AACL,CAAC;AAEY,QAAA,mBAAmB,GAAG,uBAAM,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE;QACL,mBAAmB,EAAE;YACjB,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE;gBAC/B,iFAAiF;gBACjF,wEAAwE;gBACxE,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAA;gBACjF,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAA;gBAC/E,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAA;gBAEzF,MAAM,aAAa,GACf,kBAAkB,IAAI,kBAAkB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,uBAAuB,CAAC,IAAI,EAAE;oBACzF,CAAC,CAAC,MAAM,oCAAe,CAAC,UAAU,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,CAAC;oBACzE,CAAC,CAAC,SAAS,CAAA;gBACnB,MAAM,YAAY,GACd,iBAAiB,IAAI,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,sBAAsB,CAAC,IAAI,EAAE;oBACtF,CAAC,CAAC,MAAM,oCAAe,CAAC,UAAU,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,CAAC;oBACxE,CAAC,CAAC,SAAS,CAAA;gBACnB,MAAM,iBAAiB,GACnB,sBAAsB;oBACtB,sBAAsB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,2BAA2B,CAAC,IAAI,EAAE;oBAC3E,CAAC,CAAC,MAAM,oCAAe,CAAC,UAAU,CAAC,MAAM,EAAE,sBAAsB,EAAE,SAAS,CAAC;oBAC7E,CAAC,CAAC,SAAS,CAAA;gBAEnB,OAAO;oBACH,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,IAAI,oCAAmB,CAAC;wBAC3B,MAAM,EAAE,MAAM;wBACd,MAAM,EAAE,eAAe;wBACvB,IAAI,EAAE;4BACF,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gCACzB,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,0BAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gCACnC,IAAI,EAAE,CAAC;gCAEP,2DAA2D;gCAC3D,mEAAmE;gCACnE,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;gCACtF,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3D,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAC5B;gCAED,yDAAyD;gCACzD,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;gCACnC,YAAY,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;gCACjC,iBAAiB,EAAE,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC;gCAE3C,oCAAoC;gCACpC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;6BAC5C,CAAC,CAAC;yBACN;qBACJ,CAAC;iBACL,CAAA;YACL,CAAC;SACJ;KACJ;IACD,MAAM,EAAE;QACJ;YACI,KAAK,EAAE,oCAAmB;YAC1B,SAAS,EAAE,CAAC,QAAQ,CAAC;YACrB,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE;gBAC3D,IAAI,cAAc,CAAC,SAAS,EAAE,KAAK,eAAe,EAAE,CAAC;oBACjD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;gBAC7B,CAAC;gBAED,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;gBAEpD,yCAAyC;gBACzC,IAAI,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC;oBAC1C,WAAW,CAAC,KAAK,CACb,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,eAAe,EAAE,EAC1C,2FAA2F,MAAM,CAAC,gBAAgB,aAAa,CAClI,CAAA;gBACL,CAAC;gBACD,IAAI,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC;oBACzC,WAAW,CAAC,KAAK,CACb,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,eAAe,EAAE,EACzC,0FAA0F,MAAM,CAAC,gBAAgB,aAAa,CACjI,CAAA;gBACL,CAAC;gBACD,IAAI,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC;oBAC9C,WAAW,CAAC,KAAK,CACb,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,eAAe,EAAE,EAC9C,+FAA+F,MAAM,CAAC,gBAAgB,aAAa,CACtI,CAAA;gBACL,CAAC;gBAED,OAAO;oBACH,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC;wBAC9B,MAAM,EAAE,cAAc;wBACtB,KAAK,EAAE,qBAAqB;wBAC5B,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;wBAC1B,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;4BAClC,IAAI,EAAE,CAAC;4BAEP,qDAAqD;4BACrD,mEAAmE;4BACnE,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACvD,mBAAmB,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAChE;4BACD,qBAAqB,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3D,mBAAmB,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAChE;4BAED,4EAA4E;4BAC5E,kDAAkD;4BAClD,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;iCACnC,GAAG,CAAC,0BAA0B,CAAC;iCAC/B,OAAO,EAAE;iCACT,GAAG,CAAC,uBAAuB,CAAC;4BACjC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;iCACjC,GAAG,CAAC,0BAA0B,CAAC;iCAC/B,OAAO,EAAE;iCACT,GAAG,CAAC,sBAAsB,CAAC;4BAChC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;iCAC3C,GAAG,CAAC,0BAA0B,CAAC;iCAC/B,OAAO,EAAE;iCACT,GAAG,CAAC,2BAA2B,CAAC;4BAErC,mEAAmE;4BACnE,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,CAAC,CAAC,CAAC;yBAC/D,CAAC,CAAC;qBACN,CAAC;iBACL,CAAA;YACL,CAAC;SACJ;KACJ;CACJ,CAAC,CAAA"}

package/dist/alias/index.d.ts

@@ -0,0 +1,3 @@
+export * from './alias-plugin';
+export * from './retry-policy-plugin';
+export * from './alias-template-plugin';

package/dist/alias/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./alias-plugin"), exports);
+__exportStar(require("./retry-policy-plugin"), exports);
+__exportStar(require("./alias-template-plugin"), exports);
+//# sourceMappingURL=index.js.map

package/dist/alias/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/alias/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA8B;AAC9B,wDAAqC;AACrC,0DAAuC"}

package/dist/alias/retry-policy-plugin.d.ts

@@ -0,0 +1,2 @@
+import { Plugin } from '@servicenow/sdk-build-core';
+export declare const RetryPolicyPlugin: Plugin;

package/dist/alias/retry-policy-plugin.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryPolicyPlugin = void 0;
+const sdk_build_core_1 = require("@servicenow/sdk-build-core");
+const now_id_plugin_1 = require("../now-id-plugin");
+const SYS_RETRY_POLICY = 'sys_retry_policy';
+const DEFAULT_CONNECTION_TYPE = 'http_retry_conditions';
+const DEFAULT_RETRY_STRATEGY = 'fixed_time_interval';
+const MAX_ELAPSED_TIME_SECONDS = 86400;
+const DEFAULT_RESTRICT_TO = 'http_method,status_code,error,response_body,response_headers';
+exports.RetryPolicyPlugin = sdk_build_core_1.Plugin.create({
+    name: 'RetryPolicyPlugin',
+    records: {
+        [SYS_RETRY_POLICY]: {
+            async toShape(record) {
+                const restrictToRaw = record.get('restrict_to')?.ifString()?.getValue();
+                const restrictToArray = restrictToRaw === undefined || restrictToRaw === DEFAULT_RESTRICT_TO
+                    ? undefined
+                    : restrictToRaw === ''
+                        ? []
+                        : restrictToRaw
+                            .split(',')
+                            .map((s) => s.trim())
+                            .filter(Boolean);
+                return {
+                    success: true,
+                    value: new sdk_build_core_1.CallExpressionShape({
+                        source: record,
+                        callee: 'RetryPolicy',
+                        args: [
+                            record.transform(({ $ }) => ({
+                                $id: $.val(now_id_plugin_1.NowIdShape.from(record)),
+                                name: $.def(''),
+                                connectionType: $.from('connection_type').def(DEFAULT_CONNECTION_TYPE),
+                                retryStrategy: $.from('retry_strategy').def(DEFAULT_RETRY_STRATEGY),
+                                count: $.map((v) => v.ifString()?.ifNotEmpty()?.toNumber()),
+                                interval: $.map((v) => v.ifString()?.ifNotEmpty()?.toNumber()),
+                                maxElapsedTime: $.from('max_elapsed_time').map((v) => v.ifString()?.ifNotEmpty()?.toNumber()),
+                                condition: $.def(''),
+                                restrictTo: $.val(restrictToArray),
+                                protectionPolicy: $.from('sys_policy').def(''),
+                            })),
+                        ],
+                    }),
+                };
+            },
+        },
+    },
+    shapes: [
+        {
+            shape: sdk_build_core_1.CallExpressionShape,
+            fileTypes: ['fluent'],
+            async toRecord(callExpression, { factory, diagnostics }) {
+                if (callExpression.getCallee() !== 'RetryPolicy') {
+                    return { success: false };
+                }
+                const arg = callExpression.getArgument(0).asObject();
+                // Runtime validation for maxElapsedTime upper bound (TypeScript cannot enforce numeric ranges)
+                const maxElapsedTimeShape = arg.get('maxElapsedTime');
+                const maxElapsedTime = maxElapsedTimeShape.ifNumber()?.getValue();
+                if (maxElapsedTime !== undefined && maxElapsedTime > MAX_ELAPSED_TIME_SECONDS) {
+                    diagnostics.error(maxElapsedTimeShape, `maxElapsedTime must not exceed ${MAX_ELAPSED_TIME_SECONDS} seconds (24 hours). Received: ${maxElapsedTime}.`);
+                }
+                const countShape = arg.get('count');
+                const count = countShape.ifNumber()?.getValue();
+                if (count !== undefined && !Number.isInteger(count)) {
+                    diagnostics.error(countShape, `count must be an integer. Received: ${count}.`);
+                }
+                const intervalShape = arg.get('interval');
+                const interval = intervalShape.ifNumber()?.getValue();
+                if (interval !== undefined && !Number.isInteger(interval)) {
+                    diagnostics.error(intervalShape, `interval must be an integer. Received: ${interval}.`);
+                }
+                // Convert restrictTo string[] → comma-separated string for the DB
+                const restrictToShape = arg.get('restrictTo');
+                const restrictToArrayShape = restrictToShape.ifArray();
+                const restrictToCsv = restrictToArrayShape
+                    ? restrictToArrayShape
+                        .getElements()
+                        .map((el) => el.ifString()?.getValue() ?? '')
+                        .filter(Boolean)
+                        .join(',')
+                    : DEFAULT_RESTRICT_TO;
+                // Validate condition only references fields in restrictTo
+                const allowedFields = (restrictToCsv || DEFAULT_RESTRICT_TO).split(',');
+                const conditionShape = arg.get('condition');
+                const conditionValue = conditionShape.ifString()?.ifNotEmpty()?.getValue();
+                if (conditionValue) {
+                    for (const part of conditionValue.split('^')) {
+                        const fieldPart = part.startsWith('OR') ? part.slice(2) : part;
+                        if (!allowedFields.some((field) => fieldPart.startsWith(field))) {
+                            const fieldName = fieldPart.match(/^[a-z_]+/)?.[0] ?? fieldPart;
+                            diagnostics.error(conditionShape, `Condition references field '${fieldName}' which is not in restrictTo. Allowed fields: ${allowedFields.join(', ')}.`);
+                            break;
+                        }
+                    }
+                }
+                const record = await factory.createRecord({
+                    source: callExpression,
+                    table: SYS_RETRY_POLICY,
+                    explicitId: arg.get('$id'),
+                    properties: arg.transform(({ $ }) => ({
+                        name: $.def(''),
+                        connection_type: $.from('connectionType').def(DEFAULT_CONNECTION_TYPE),
+                        retry_strategy: $.from('retryStrategy').def(DEFAULT_RETRY_STRATEGY),
+                        count: $,
+                        interval: $,
+                        max_elapsed_time: $.from('maxElapsedTime'),
+                        condition: $.def(''),
+                        restrict_to: $.val(restrictToCsv),
+                        sys_policy: $.from('protectionPolicy').def(''),
+                    })),
+                });
+                return { success: true, value: record };
+            },
+        },
+    ],
+});
+//# sourceMappingURL=retry-policy-plugin.js.map

package/dist/alias/retry-policy-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy-plugin.js","sourceRoot":"","sources":["../../src/alias/retry-policy-plugin.ts"],"names":[],"mappings":"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"}

package/dist/arrow-function-plugin.d.ts

@@ -16,6 +16,7 @@ export declare class ArrowFunctionShape extends Shape {
     getStatements(): Shape[];
     getStatement(index: number): Shape;
     getReturnValue(): Shape | undefined;
+    isImplicitReturn(): boolean;
     getCode(): string;
 }
 export declare const ArrowFunctionPlugin: Plugin;