@n8n/expression-runtime 0.3.0 → 0.4.0

package/dist/cjs/extensions/extend.js

@@ -0,0 +1,149 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "luxon", "./array-extensions", "./boolean-extensions", "./date-extensions", "./expression-extension-error", "./number-extensions", "./object-extensions", "./string-extensions", "./utils"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.EXTENSION_OBJECTS = void 0;
+    exports.extend = extend;
+    exports.extendOptional = extendOptional;
+    const luxon_1 = require("luxon");
+    const array_extensions_1 = require("./array-extensions");
+    const boolean_extensions_1 = require("./boolean-extensions");
+    const date_extensions_1 = require("./date-extensions");
+    const expression_extension_error_1 = require("./expression-extension-error");
+    const number_extensions_1 = require("./number-extensions");
+    const object_extensions_1 = require("./object-extensions");
+    const string_extensions_1 = require("./string-extensions");
+    const utils_1 = require("./utils");
+    function isEmpty(value) {
+        return value === null || value === undefined || !value;
+    }
+    function isNotEmpty(value) {
+        return !isEmpty(value);
+    }
+    exports.EXTENSION_OBJECTS = [
+        array_extensions_1.arrayExtensions,
+        date_extensions_1.dateExtensions,
+        number_extensions_1.numberExtensions,
+        object_extensions_1.objectExtensions,
+        string_extensions_1.stringExtensions,
+        boolean_extensions_1.booleanExtensions,
+    ];
+    // eslint-disable-next-line @typescript-eslint/no-restricted-types
+    const genericExtensions = {
+        isEmpty,
+        isNotEmpty,
+    };
+    function isDate(input) {
+        if (typeof input !== 'string' || !input.length) {
+            return false;
+        }
+        if (!/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{3}Z/.test(input)) {
+            return false;
+        }
+        const d = new Date(input);
+        return d instanceof Date && !isNaN(d.valueOf()) && d.toISOString() === input;
+    }
+    function findExtendedFunction(input, functionName) {
+        // eslint-disable-next-line @typescript-eslint/no-restricted-types
+        let foundFunction;
+        if (Array.isArray(input)) {
+            foundFunction = array_extensions_1.arrayExtensions.functions[functionName];
+        }
+        else if (isDate(input) && functionName !== 'toDate' && functionName !== 'toDateTime') {
+            // If it's a string date (from $json), convert it to a Date object,
+            // unless that function is `toDate`, since `toDate` does something
+            // very different on date objects
+            input = new Date(input);
+            foundFunction = date_extensions_1.dateExtensions.functions[functionName];
+        }
+        else if (typeof input === 'string') {
+            foundFunction = string_extensions_1.stringExtensions.functions[functionName];
+        }
+        else if (typeof input === 'number') {
+            foundFunction = number_extensions_1.numberExtensions.functions[functionName];
+        }
+        else if (input && (luxon_1.DateTime.isDateTime(input) || input instanceof Date)) {
+            foundFunction = date_extensions_1.dateExtensions.functions[functionName];
+        }
+        else if (input !== null && typeof input === 'object') {
+            foundFunction = object_extensions_1.objectExtensions.functions[functionName];
+        }
+        else if (typeof input === 'boolean') {
+            foundFunction = boolean_extensions_1.booleanExtensions.functions[functionName];
+        }
+        // Look for generic or builtin
+        if (!foundFunction) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const inputAny = input;
+            // This is likely a builtin we're implementing for another type
+            // (e.g. toLocaleString). We'll return that instead
+            if (inputAny && functionName && typeof inputAny[functionName] === 'function') {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+                return { type: 'native', function: inputAny[functionName] };
+            }
+            // Use a generic version if available
+            foundFunction = genericExtensions[functionName];
+        }
+        if (!foundFunction) {
+            return undefined;
+        }
+        return { type: 'extended', function: foundFunction };
+    }
+    /**
+     * Extender function injected by expression extension plugin to allow calls to extensions.
+     *
+     * ```ts
+     * extend(input, "functionName", [...args]);
+     * ```
+     */
+    function extend(input, functionName, args) {
+        const foundFunction = findExtendedFunction(input, functionName);
+        // No type specific or generic function found. Check to see if
+        // any types have a function with that name. Then throw an error
+        // letting the user know the available types.
+        if (!foundFunction) {
+            (0, utils_1.checkIfValueDefinedOrThrow)(input, functionName);
+            const haveFunction = exports.EXTENSION_OBJECTS.filter((v) => functionName in v.functions);
+            if (!haveFunction.length) {
+                // This shouldn't really be possible but we should cover it anyway
+                throw new expression_extension_error_1.ExpressionExtensionError(`Unknown expression function: ${functionName}`);
+            }
+            if (haveFunction.length > 1) {
+                const lastType = `"${haveFunction.pop().typeName}"`;
+                const typeNames = `${haveFunction.map((v) => `"${v.typeName}"`).join(', ')}, and ${lastType}`;
+                throw new expression_extension_error_1.ExpressionExtensionError(`${functionName}() is only callable on types ${typeNames}`);
+            }
+            else {
+                throw new expression_extension_error_1.ExpressionExtensionError(`${functionName}() is only callable on type "${haveFunction[0].typeName}"`);
+            }
+        }
+        if (foundFunction.type === 'native') {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            return foundFunction.function.apply(input, args);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return foundFunction.function(input, args);
+    }
+    function extendOptional(input, functionName) {
+        const foundFunction = findExtendedFunction(input, functionName);
+        if (!foundFunction) {
+            return undefined;
+        }
+        if (foundFunction.type === 'native') {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            return foundFunction.function.bind(input);
+        }
+        return (...args) => {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            return foundFunction.function(input, args);
+        };
+    }
+});
+//# sourceMappingURL=extend.js.map

package/dist/cjs/extensions/extend.js.map

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

package/dist/cjs/extensions/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/extensions/extensions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC;AAGD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG;IAAE,GAAG,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IACnD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC7B,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/cjs/extensions/extensions.js

@@ -0,0 +1,13 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});
+//# sourceMappingURL=extensions.js.map

package/dist/cjs/extensions/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../../src/extensions/extensions.ts"],"names":[],"mappings":""}

package/dist/cjs/extensions/number-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-extensions.d.ts","sourceRoot":"","sources":["../../../src/extensions/number-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA2DjD,KAAK,cAAc,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC;AAClD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,cAAc,CAAC,YA4BpE;yBA5Be,UAAU;;;;;;;;;;;;;;;;;;;;AA4L1B,eAAO,MAAM,gBAAgB,EAAE,YAgB9B,CAAC"}

package/dist/cjs/extensions/number-extensions.js

@@ -0,0 +1,235 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "luxon", "./expression-extension-error"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.numberExtensions = void 0;
+    exports.toDateTime = toDateTime;
+    const luxon_1 = require("luxon");
+    const expression_extension_error_1 = require("./expression-extension-error");
+    function format(value, extraArgs) {
+        const [locales = 'en-US', config = {}] = extraArgs;
+        return new Intl.NumberFormat(locales, config).format(value);
+    }
+    function isEven(value) {
+        if (!Number.isInteger(value)) {
+            throw new expression_extension_error_1.ExpressionExtensionError('isEven() is only callable on integers');
+        }
+        return value % 2 === 0;
+    }
+    function isOdd(value) {
+        if (!Number.isInteger(value)) {
+            throw new expression_extension_error_1.ExpressionExtensionError('isOdd() is only callable on integers');
+        }
+        return Math.abs(value) % 2 === 1;
+    }
+    function floor(value) {
+        return Math.floor(value);
+    }
+    function ceil(value) {
+        return Math.ceil(value);
+    }
+    function abs(value) {
+        return Math.abs(value);
+    }
+    function isInteger(value) {
+        return Number.isInteger(value);
+    }
+    function round(value, extraArgs) {
+        const [decimalPlaces = 0] = extraArgs;
+        return +value.toFixed(decimalPlaces);
+    }
+    function toBoolean(value) {
+        return value !== 0;
+    }
+    function toInt(value) {
+        return round(value, []);
+    }
+    function toFloat(value) {
+        return value;
+    }
+    function toDateTime(value, extraArgs) {
+        const [valueFormat = 'ms'] = extraArgs;
+        if (!['ms', 's', 'us', 'excel'].includes(valueFormat)) {
+            throw new expression_extension_error_1.ExpressionExtensionError(`Unsupported format '${String(valueFormat)}'. toDateTime() supports 'ms', 's', 'us' and 'excel'.`);
+        }
+        switch (valueFormat) {
+            // Excel format is days since 1900
+            // There is a bug where 1900 is incorrectly treated as a leap year
+            case 'excel': {
+                const DAYS_BETWEEN_1900_1970 = 25567;
+                const DAYS_LEAP_YEAR_BUG_ADJUST = 2;
+                const SECONDS_IN_DAY = 86_400;
+                return luxon_1.DateTime.fromSeconds((value - (DAYS_BETWEEN_1900_1970 + DAYS_LEAP_YEAR_BUG_ADJUST)) * SECONDS_IN_DAY);
+            }
+            case 's':
+                return luxon_1.DateTime.fromSeconds(value);
+            case 'us':
+                return luxon_1.DateTime.fromMillis(value / 1000);
+            case 'ms':
+            default:
+                return luxon_1.DateTime.fromMillis(value);
+        }
+    }
+    ceil.doc = {
+        name: 'ceil',
+        description: 'Rounds the number up to the next whole number',
+        examples: [{ example: '(1.234).ceil()', evaluated: '2' }],
+        returnType: 'number',
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-ceil',
+    };
+    floor.doc = {
+        name: 'floor',
+        description: 'Rounds the number down to the nearest whole number',
+        examples: [{ example: '(1.234).floor()', evaluated: '1' }],
+        returnType: 'number',
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-floor',
+    };
+    isEven.doc = {
+        name: 'isEven',
+        description: "Returns <code>true</code> if the number is even or <code>false</code> if not. Throws an error if the number isn't a whole number.",
+        examples: [
+            { example: '(33).isEven()', evaluated: 'false' },
+            { example: '(42).isEven()', evaluated: 'true' },
+        ],
+        returnType: 'boolean',
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-isEven',
+    };
+    isOdd.doc = {
+        name: 'isOdd',
+        description: "Returns <code>true</code> if the number is odd or <code>false</code> if not. Throws an error if the number isn't a whole number.",
+        examples: [
+            { example: '(33).isOdd()', evaluated: 'true' },
+            { example: '(42).isOdd()', evaluated: 'false' },
+        ],
+        returnType: 'boolean',
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-isOdd',
+    };
+    format.doc = {
+        name: 'format',
+        description: 'Returns a formatted string representing the number. Useful for formatting for a specific language or currency. The same as <a target="_blank" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat"><code>Intl.NumberFormat()</code></a>.',
+        examples: [
+            { example: "(123456.789).format('de-DE')", evaluated: '123.456,789' },
+            {
+                example: "(123456.789).format('de-DE', {'style': 'currency', 'currency': 'EUR'})",
+                evaluated: '123.456,79 €',
+            },
+        ],
+        returnType: 'string',
+        args: [
+            {
+                name: 'locale',
+                optional: true,
+                description: 'A <a target="_blank" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl#locales_argument">locale tag</a> for formatting the number, e.g. <code>fr-FR</code>, <code>en-GB</code>, <code>pr-BR</code>',
+                default: '"en-US"',
+                type: 'string',
+            },
+            {
+                name: 'options',
+                optional: true,
+                description: 'Configuration options for number formatting. <a target="_blank" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat" target="_blank">More info</a>',
+                type: 'object',
+            },
+        ],
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-format',
+    };
+    round.doc = {
+        name: 'round',
+        description: 'Rounds the number to the nearest integer (or decimal place)',
+        examples: [
+            { example: '(1.256).round()', evaluated: '1' },
+            { example: '(1.256).round(1)', evaluated: '1.3' },
+            { example: '(1.256).round(2)', evaluated: '1.26' },
+        ],
+        returnType: 'number',
+        args: [
+            {
+                name: 'decimalPlaces',
+                optional: true,
+                description: 'The number of decimal places to round to',
+                default: '0',
+                type: 'number',
+            },
+        ],
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-round',
+    };
+    toBoolean.doc = {
+        name: 'toBoolean',
+        description: 'Returns <code>false</code> for <code>0</code> and <code>true</code> for any other number (including negative numbers).',
+        examples: [
+            { example: '(12).toBoolean()', evaluated: 'true' },
+            { example: '(0).toBoolean()', evaluated: 'false' },
+            { example: '(-1.3).toBoolean()', evaluated: 'true' },
+        ],
+        section: 'cast',
+        returnType: 'boolean',
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-toBoolean',
+    };
+    toDateTime.doc = {
+        name: 'toDateTime',
+        description: 'Converts a numerical timestamp into a <a target="_blank" href="https://moment.github.io/luxon/api-docs/">Luxon</a> DateTime. The format of the timestamp must be specified if it\'s not in milliseconds. Uses the timezone specified in workflow settings if available; otherwise, it defaults to the timezone set for the instance.',
+        examples: [
+            { example: "(1708695471).toDateTime('s')", evaluated: '2024-02-23T14:37:51.000+01:00' },
+            { example: "(1708695471000).toDateTime('ms')", evaluated: '2024-02-23T14:37:51.000+01:00' },
+            { example: "(1708695471000000).toDateTime('us')", evaluated: '2024-02-23T14:37:51.000+01:00' },
+            { example: "(45345).toDateTime('excel')", evaluated: '2024-02-23T01:00:00.000+01:00' },
+        ],
+        section: 'cast',
+        returnType: 'DateTime',
+        args: [
+            {
+                name: 'format',
+                optional: true,
+                description: 'The type of timestamp to convert. Options are <code>ms</code> (for Unix timestamp in milliseconds), <code>s</code> (for Unix timestamp in seconds), <code>us</code> (for Unix timestamp in microseconds) or <code>excel</code> (for days since 1900).',
+                default: '"ms"',
+                type: 'string',
+            },
+        ],
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-toDateTime',
+    };
+    abs.doc = {
+        name: 'abs',
+        description: "Returns the number's absolute value, i.e. removes any minus sign",
+        examples: [
+            { example: '(-1.7).abs()', evaluated: '1.7' },
+            { example: '(1.7).abs()', evaluated: '1.7' },
+        ],
+        returnType: 'number',
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-abs',
+    };
+    isInteger.doc = {
+        name: 'isInteger',
+        description: 'Returns <code>true</code> if the number is a whole number',
+        examples: [
+            { example: '(4).isInteger()', evaluated: 'true' },
+            { example: '(4.12).isInteger()', evaluated: 'false' },
+            { example: '(-4).isInteger()', evaluated: 'true' },
+        ],
+        returnType: 'boolean',
+        docURL: 'https://docs.n8n.io/code/builtin/data-transformation-functions/numbers/#number-isInteger',
+    };
+    exports.numberExtensions = {
+        typeName: 'Number',
+        functions: {
+            ceil,
+            floor,
+            format,
+            round,
+            abs,
+            isInteger,
+            isEven,
+            isOdd,
+            toBoolean,
+            toInt,
+            toFloat,
+            toDateTime,
+        },
+    };
+});
+//# sourceMappingURL=number-extensions.js.map

package/dist/cjs/extensions/number-extensions.js.map

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

package/dist/cjs/extensions/object-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-extensions.d.ts","sourceRoot":"","sources":["../../../src/extensions/object-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAmEjD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB7C;yBAjBe,OAAO;;;;;;;;;;;;AAmBvB,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,UAEtC;yBAFe,SAAS;;;;;;;;;;;;AAIzB,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,UAEzC;yBAFe,YAAY;;;;;;;;;;;;AAI5B,wBAAgB,KAAK,cAEpB;AAED,wBAAgB,OAAO,cAEtB;AAED,wBAAgB,SAAS,cAExB;AAED,wBAAgB,UAAU,cAEzB;AA+LD,eAAO,MAAM,gBAAgB,EAAE,YAmB9B,CAAC"}