@atom8n/n8n-workflow 2.2.0

package/dist/esm/extensions/extended-functions.d.ts

@@ -0,0 +1,28 @@
+declare function ifEmpty<T, V>(value: V, defaultValue: T): T | (V & {});
+declare namespace ifEmpty {
+    var doc: {
+        name: string;
+        description: string;
+        returnType: string;
+        args: {
+            name: string;
+            type: string;
+        }[];
+        docURL: string;
+    };
+}
+export declare const extendedFunctions: {
+    min: (...values: number[]) => number;
+    max: (...values: number[]) => number;
+    not: (value: unknown) => boolean;
+    average: (...args: number[]) => number;
+    numberList: (start: number, end: number) => number[];
+    zip: (keys: unknown[], values: unknown[]) => unknown;
+    $min: (...values: number[]) => number;
+    $max: (...values: number[]) => number;
+    $average: (...args: number[]) => number;
+    $not: (value: unknown) => boolean;
+    $ifEmpty: typeof ifEmpty;
+};
+export {};
+//# sourceMappingURL=extended-functions.d.ts.map

package/dist/esm/extensions/extended-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended-functions.d.ts","sourceRoot":"","sources":["../../../src/extensions/extended-functions.ts"],"names":[],"mappings":"AA0CA,iBAAS,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,gBAgB/C;kBAhBQ,OAAO;;;;;;;;;;;;AA8BhB,eAAO,MAAM,iBAAiB;;;iBAlCV,OAAO,KAAG,OAAO;uBAJX,MAAM,EAAE;wBA3BP,MAAM,OAAO,MAAM,KAAG,MAAM,EAAE;gBAgBtC,OAAO,EAAE,UAAU,OAAO,EAAE,KAAG,OAAO;;;wBAW/B,MAAM,EAAE;kBAId,OAAO,KAAG,OAAO;;CA8CpC,CAAC"}

package/dist/esm/extensions/extended-functions.js

@@ -0,0 +1,76 @@
+import { average as aAverage } from './array-extensions';
+import { ExpressionExtensionError } from '../errors/expression-extension.error';
+import { ExpressionError } from '../errors/expression.error';
+const min = Math.min;
+const max = Math.max;
+const numberList = (start, end) => {
+    const size = Math.abs(start - end) + 1;
+    const arr = new Array(size);
+    let curr = start;
+    for (let i = 0; i < size; i++) {
+        if (start < end) {
+            arr[i] = curr++;
+        }
+        else {
+            arr[i] = curr--;
+        }
+    }
+    return arr;
+};
+const zip = (keys, values) => {
+    if (keys.length !== values.length) {
+        throw new ExpressionExtensionError('keys and values not of equal length');
+    }
+    return keys.reduce((p, c, i) => {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
+        p[c] = values[i];
+        return p;
+    }, {});
+};
+const average = (...args) => {
+    return aAverage(args);
+};
+const not = (value) => {
+    return !value;
+};
+function ifEmpty(value, defaultValue) {
+    if (arguments.length !== 2) {
+        throw new ExpressionError('expected two arguments (value, defaultValue) for this function');
+    }
+    if (value === undefined || value === null || value === '') {
+        return defaultValue;
+    }
+    if (typeof value === 'object') {
+        if (Array.isArray(value) && !value.length) {
+            return defaultValue;
+        }
+        if (!Object.keys(value).length) {
+            return defaultValue;
+        }
+    }
+    return value;
+}
+ifEmpty.doc = {
+    name: 'ifEmpty',
+    description: 'Returns the default value if the value is empty. Empty values are undefined, null, empty strings, arrays without elements and objects without keys.',
+    returnType: 'any',
+    args: [
+        { name: 'value', type: 'any' },
+        { name: 'defaultValue', type: 'any' },
+    ],
+    docURL: 'https://docs.n8n.io/code/builtin/convenience',
+};
+export const extendedFunctions = {
+    min,
+    max,
+    not,
+    average,
+    numberList,
+    zip,
+    $min: min,
+    $max: max,
+    $average: average,
+    $not: not,
+    $ifEmpty: ifEmpty,
+};
+//# sourceMappingURL=extended-functions.js.map

package/dist/esm/extensions/extended-functions.js.map

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

package/dist/esm/extensions/extensions.d.ts

@@ -0,0 +1,52 @@
+import type { Completion } from '@codemirror/autocomplete';
+export type Alias = {
+    label: string;
+    info?: string;
+    mode?: 'prefix' | 'exact';
+};
+export interface AliasCompletion extends Completion {
+    alias?: Alias[];
+}
+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/esm/extensions/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/extensions/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,MAAM,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,CAAC;AAChF,MAAM,WAAW,eAAgB,SAAQ,UAAU;IAClD,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;CAChB;AAED,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/esm/extensions/extensions.js

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

package/dist/esm/extensions/extensions.js.map

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

package/dist/esm/extensions/index.d.ts

@@ -0,0 +1,4 @@
+export { extend, extendOptional, hasExpressionExtension, hasNativeMethod, extendTransform, EXTENSION_OBJECTS as ExpressionExtensions, } from './expression-extension';
+export type { DocMetadata, NativeDoc, Extension, DocMetadataArgument, DocMetadataExample, } from './extensions';
+export type { Alias, AliasCompletion, } from './extensions';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,MAAM,EACN,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,iBAAiB,IAAI,oBAAoB,GACzC,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACX,WAAW,EACX,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACX,KAAK,EACL,eAAe,GACf,MAAM,cAAc,CAAC"}

package/dist/esm/extensions/index.js

@@ -0,0 +1,2 @@
+export { extend, extendOptional, hasExpressionExtension, hasNativeMethod, extendTransform, EXTENSION_OBJECTS as ExpressionExtensions, } from './expression-extension';
+//# sourceMappingURL=index.js.map

package/dist/esm/extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,MAAM,EACN,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,iBAAiB,IAAI,oBAAoB,GACzC,MAAM,wBAAwB,CAAC"}

package/dist/esm/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/esm/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":"AACA,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/esm/extensions/number-extensions.js

@@ -0,0 +1,222 @@
+// @vitest-environment jsdom
+import { DateTime } from 'luxon';
+import { ExpressionExtensionError } from '../errors/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/esm/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/esm/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/esm/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"}