@n8n/expression-runtime 0.2.0 → 0.3.0

package/dist/extensions/extend.js

@@ -0,0 +1,134 @@
+import { DateTime } from 'luxon';
+import { arrayExtensions } from './array-extensions';
+import { booleanExtensions } from './boolean-extensions';
+import { dateExtensions } from './date-extensions';
+import { ExpressionExtensionError } from './expression-extension-error';
+import { numberExtensions } from './number-extensions';
+import { objectExtensions } from './object-extensions';
+import { stringExtensions } from './string-extensions';
+import { checkIfValueDefinedOrThrow } from './utils';
+function isEmpty(value) {
+    return value === null || value === undefined || !value;
+}
+function isNotEmpty(value) {
+    return !isEmpty(value);
+}
+export const EXTENSION_OBJECTS = [
+    arrayExtensions,
+    dateExtensions,
+    numberExtensions,
+    objectExtensions,
+    stringExtensions,
+    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 = 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 = dateExtensions.functions[functionName];
+    }
+    else if (typeof input === 'string') {
+        foundFunction = stringExtensions.functions[functionName];
+    }
+    else if (typeof input === 'number') {
+        foundFunction = numberExtensions.functions[functionName];
+    }
+    else if (input && (DateTime.isDateTime(input) || input instanceof Date)) {
+        foundFunction = dateExtensions.functions[functionName];
+    }
+    else if (input !== null && typeof input === 'object') {
+        foundFunction = objectExtensions.functions[functionName];
+    }
+    else if (typeof input === 'boolean') {
+        foundFunction = 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]);
+ * ```
+ */
+export 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) {
+        checkIfValueDefinedOrThrow(input, functionName);
+        const haveFunction = 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 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 ExpressionExtensionError(`${functionName}() is only callable on types ${typeNames}`);
+        }
+        else {
+            throw new 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);
+}
+export 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/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/extensions/extensions.d.ts

@@ -0,0 +1,43 @@
+export interface ExtensionMap {
+    typeName: string;
+    functions: Record<string, Extension>;
+}
+export type Extension = Function & {
+    doc?: DocMetadata;
+};
+export type NativeDoc = {
+    typeName: string;
+    properties?: Record<string, {
+        doc?: DocMetadata;
+    }>;
+    functions: Record<string, {
+        doc?: DocMetadata;
+    }>;
+};
+export type DocMetadataArgument = {
+    name: string;
+    type?: string;
+    optional?: boolean;
+    variadic?: boolean;
+    description?: string;
+    default?: string;
+    args?: DocMetadataArgument[];
+};
+export type DocMetadataExample = {
+    example: string;
+    evaluated?: string;
+    description?: string;
+};
+export type DocMetadata = {
+    name: string;
+    returnType: string;
+    description?: string;
+    section?: string;
+    hidden?: boolean;
+    aliases?: string[];
+    aliasMode?: 'prefix' | 'exact';
+    args?: DocMetadataArgument[];
+    examples?: DocMetadataExample[];
+    docURL?: string;
+};
+//# sourceMappingURL=extensions.d.ts.map

package/dist/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/extensions/extensions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extensions.js.map

package/dist/extensions/extensions.js.map

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

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

@@ -0,0 +1,27 @@
+import { DateTime } from 'luxon';
+import type { ExtensionMap } from './extensions';
+type DateTimeFormat = 'ms' | 's' | 'us' | 'excel';
+export declare function toDateTime(value: number, extraArgs: [DateTimeFormat]): DateTime;
+export declare namespace toDateTime {
+    var doc: {
+        name: string;
+        description: string;
+        examples: {
+            example: string;
+            evaluated: string;
+        }[];
+        section: string;
+        returnType: string;
+        args: {
+            name: string;
+            optional: boolean;
+            description: string;
+            default: string;
+            type: string;
+        }[];
+        docURL: string;
+    };
+}
+export declare const numberExtensions: ExtensionMap;
+export {};
+//# sourceMappingURL=number-extensions.d.ts.map

package/dist/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/extensions/number-extensions.js

@@ -0,0 +1,221 @@
+import { DateTime } from 'luxon';
+import { ExpressionExtensionError } from './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 ExpressionExtensionError('isEven() is only callable on integers');
+    }
+    return value % 2 === 0;
+}
+function isOdd(value) {
+    if (!Number.isInteger(value)) {
+        throw new 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;
+}
+export function toDateTime(value, extraArgs) {
+    const [valueFormat = 'ms'] = extraArgs;
+    if (!['ms', 's', 'us', 'excel'].includes(valueFormat)) {
+        throw new 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 DateTime.fromSeconds((value - (DAYS_BETWEEN_1900_1970 + DAYS_LEAP_YEAR_BUG_ADJUST)) * SECONDS_IN_DAY);
+        }
+        case 's':
+            return DateTime.fromSeconds(value);
+        case 'us':
+            return DateTime.fromMillis(value / 1000);
+        case 'ms':
+        default:
+            return 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',
+};
+export const numberExtensions = {
+    typeName: 'Number',
+    functions: {
+        ceil,
+        floor,
+        format,
+        round,
+        abs,
+        isInteger,
+        isEven,
+        isOdd,
+        toBoolean,
+        toInt,
+        toFloat,
+        toDateTime,
+    },
+};
+//# sourceMappingURL=number-extensions.js.map

package/dist/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/extensions/object-extensions.d.ts

@@ -0,0 +1,46 @@
+import type { ExtensionMap } from './extensions';
+export declare function compact(value: object): object;
+export declare namespace compact {
+    var doc: {
+        name: string;
+        description: string;
+        examples: {
+            example: string;
+            evaluated: string;
+        }[];
+        returnType: string;
+        docURL: string;
+    };
+}
+export declare function urlEncode(value: object): string;
+export declare namespace urlEncode {
+    var doc: {
+        name: string;
+        description: string;
+        examples: {
+            example: string;
+            evaluated: string;
+        }[];
+        returnType: string;
+        docURL: string;
+    };
+}
+export declare function toJsonString(value: object): string;
+export declare namespace toJsonString {
+    var doc: {
+        name: string;
+        description: string;
+        examples: {
+            example: string;
+            evaluated: string;
+        }[];
+        docURL: string;
+        returnType: string;
+    };
+}
+export declare function toInt(): undefined;
+export declare function toFloat(): undefined;
+export declare function toBoolean(): undefined;
+export declare function toDateTime(): undefined;
+export declare const objectExtensions: ExtensionMap;
+//# sourceMappingURL=object-extensions.d.ts.map

package/dist/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"}