@onivoro/isomorphic-common 0.1.1 → 0.2.1

package/cjs/jest.config.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable */
+exports.default = {
+    displayName: 'isomorphic-common',
+    preset: '../../jest.preset.js',
+    globals: {},
+    testEnvironment: 'node',
+    transform: {
+        '^.+\\.[tj]sx?$': [
+            'ts-jest',
+            {
+                tsconfig: '<rootDir>/tsconfig.spec.json',
+            },
+        ],
+    },
+    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx'],
+    coverageDirectory: '../../coverage/libs/isomorphic-common',
+};

package/cjs/src/index.js

@@ -0,0 +1,45 @@
+"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("./lib/constants/millis-per-day.constant"), exports);
+__exportStar(require("./lib/constants/millis-per-hour.constant"), exports);
+__exportStar(require("./lib/constants/millis-per-minute.constant"), exports);
+__exportStar(require("./lib/functions/add-offset.function"), exports);
+__exportStar(require("./lib/functions/camel-case.function"), exports);
+__exportStar(require("./lib/functions/convert-object-to-literal.function"), exports);
+__exportStar(require("./lib/functions/from-boolean-string.function"), exports);
+__exportStar(require("./lib/functions/from-calendar-date.function"), exports);
+__exportStar(require("./lib/functions/from-csv-string.function"), exports);
+__exportStar(require("./lib/functions/kebab-case.function"), exports);
+__exportStar(require("./lib/functions/parse-bool.function"), exports);
+__exportStar(require("./lib/functions/properties-to-array.function"), exports);
+__exportStar(require("./lib/functions/sanitize-filename.function"), exports);
+__exportStar(require("./lib/functions/snake-case.function"), exports);
+__exportStar(require("./lib/functions/subtract-offset.function"), exports);
+__exportStar(require("./lib/functions/to-boolean-string.function"), exports);
+__exportStar(require("./lib/functions/to-calendar-date.function"), exports);
+__exportStar(require("./lib/functions/to-csv-string.function"), exports);
+__exportStar(require("./lib/functions/to-decimal-base.function"), exports);
+__exportStar(require("./lib/functions/to-dollars-and-cents.function"), exports);
+__exportStar(require("./lib/functions/to-unique-array.function"), exports);
+__exportStar(require("./lib/functions/to-words.function"), exports);
+__exportStar(require("./lib/functions/try-parse-date.function"), exports);
+__exportStar(require("./lib/functions/unicode-words.const"), exports);
+__exportStar(require("./lib/functions/upper-first.function"), exports);
+__exportStar(require("./lib/functions/words.function"), exports);
+__exportStar(require("./lib/interfaces/axios-wrapped-nest-exception.interface"), exports);
+__exportStar(require("./lib/interfaces/entity-provider.interface"), exports);
+__exportStar(require("./lib/interfaces/keys-of.type"), exports);

package/cjs/src/lib/constants/millis-per-day.constant.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MILLIS_PER_DAY = void 0;
+const millis_per_hour_constant_1 = require("./millis-per-hour.constant");
+exports.MILLIS_PER_DAY = millis_per_hour_constant_1.MILLIS_PER_HOUR * 24;

package/cjs/src/lib/constants/millis-per-hour.constant.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MILLIS_PER_HOUR = void 0;
+const millis_per_minute_constant_1 = require("./millis-per-minute.constant");
+exports.MILLIS_PER_HOUR = millis_per_minute_constant_1.MILLIS_PER_MINUTE * 60;

package/cjs/src/lib/constants/millis-per-minute.constant.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MILLIS_PER_MINUTE = void 0;
+exports.MILLIS_PER_MINUTE = 1000 * 60;

package/cjs/src/lib/functions/add-offset.function.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addOffset = void 0;
+const millis_per_minute_constant_1 = require("../constants/millis-per-minute.constant");
+const try_parse_date_function_1 = require("./try-parse-date.function");
+function addOffset(input) {
+    const parsed = (0, try_parse_date_function_1.tryParseDate)(input);
+    if (!parsed) {
+        return;
+    }
+    const offset = (parsed).getTimezoneOffset();
+    return new Date(parsed.valueOf() + offset * millis_per_minute_constant_1.MILLIS_PER_MINUTE);
+}
+exports.addOffset = addOffset;

package/cjs/src/lib/functions/add-offset.function.spec.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const add_offset_function_1 = require("./add-offset.function");
+describe('addOffset', () => {
+    describe('GIVEN input is partial or full ISO8601', () => {
+        it.each([
+            '2023-12-23',
+            '2023-12-23T00:00:00.000',
+        ])('%j', (input) => {
+            expect((0, add_offset_function_1.addOffset)(input)).toMatchSnapshot();
+        });
+    });
+});

package/cjs/src/lib/functions/camel-case.function.js

@@ -0,0 +1,31 @@
+"use strict";
+// https://github.com/lodash/lodash/blob/main/src/camelCase.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.camelCase = void 0;
+const to_string_function_1 = require("./to-string.function");
+const upper_first_function_1 = require("./upper-first.function");
+const words_function_1 = require("./words.function");
+/**
+ * Converts `string` to [camel case](https://en.wikipedia.org/wiki/CamelCase).
+ *
+ * @since 3.0.0
+ * @category String
+ * @param {string} [string=''] The string to convert.
+ * @returns {string} Returns the camel cased string.
+ * @see lowerCase, kebabCase, snakeCase, startCase, upperCase, upperFirst
+ * @example
+ *
+ * camelCase('Foo Bar')
+ * // => 'fooBar'
+ *
+ * camelCase('--foo-bar--')
+ * // => 'fooBar'
+ *
+ * camelCase('__FOO_BAR__')
+ * // => 'fooBar'
+ */
+const camelCase = (string) => (0, words_function_1.words)((0, to_string_function_1.toString)(string).replace(/['\u2019]/g, '')).reduce((result, word, index) => {
+    word = word.toLowerCase();
+    return result + (index ? (0, upper_first_function_1.upperFirst)(word) : word);
+}, '');
+exports.camelCase = camelCase;

package/cjs/src/lib/functions/convert-object-to-literal.function.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertObjectToLiteral = void 0;
+function convertObjectToLiteral(literalFn, delimiter, keyValuePairs) {
+    return Object.entries(keyValuePairs)
+        .filter(([, v]) => !!v || v === 0 || v === false)
+        .map(([k, v]) => literalFn(k, v?.toString?.()))
+        .join(delimiter);
+}
+exports.convertObjectToLiteral = convertObjectToLiteral;

package/cjs/src/lib/functions/convert-object-to-literal.function.spec.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const convert_object_to_literal_function_1 = require("./convert-object-to-literal.function");
+const qty = 337;
+const price = 100;
+const product = 'flux-capacitor';
+describe(__filename, () => {
+    it.each([[(k, v) => `${k}=${v}`, ' AND ', { qty, price, product }]])('converts an object to a string', (literalFn, delimiter, obj) => {
+        expect((0, convert_object_to_literal_function_1.convertObjectToLiteral)(literalFn, delimiter, obj)).toMatchSnapshot();
+    });
+});

package/cjs/src/lib/functions/from-boolean-string.function.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromBooleanString = void 0;
+function fromBooleanString(value) {
+    return value === 'true';
+}
+exports.fromBooleanString = fromBooleanString;

package/cjs/src/lib/functions/from-calendar-date.function.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromCalendarDate = void 0;
+const add_offset_function_1 = require("./add-offset.function");
+function fromCalendarDate(input) {
+    return (0, add_offset_function_1.addOffset)(input) || null;
+}
+exports.fromCalendarDate = fromCalendarDate;

package/cjs/src/lib/functions/from-calendar-date.function.spec.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const from_calendar_date_function_1 = require("./from-calendar-date.function");
+describe('fromCalendarDate', () => {
+    describe('GIVEN input is partial or full ISO8601', () => {
+        it.each([
+            '2023-12-23',
+        ])('%j', (input) => {
+            expect((0, from_calendar_date_function_1.fromCalendarDate)(input)).toMatchSnapshot();
+        });
+    });
+});

package/cjs/src/lib/functions/from-csv-string.function.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromCsvString = void 0;
+function fromCsvString(value) {
+    return value ? value.split(',').map((v) => v.trim()) : [];
+}
+exports.fromCsvString = fromCsvString;

package/cjs/src/lib/functions/get-tag.function.js

@@ -0,0 +1,12 @@
+"use strict";
+// https://github.com/lodash/lodash/blob/main/src/.internal/getTag.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTag = void 0;
+const toString = Object.prototype.toString;
+function getTag(value) {
+    if (value == null) {
+        return value === undefined ? '[object Undefined]' : '[object Null]';
+    }
+    return toString.call(value);
+}
+exports.getTag = getTag;

package/cjs/src/lib/functions/is-symbol.function.js

@@ -0,0 +1,11 @@
+"use strict";
+// https://github.com/lodash/lodash/blob/main/src/isSymbol.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSymbol = void 0;
+const get_tag_function_1 = require("./get-tag.function");
+function isSymbol(value) {
+    const type = typeof value;
+    return (type === 'symbol' ||
+        (type === 'object' && value != null && (0, get_tag_function_1.getTag)(value) === '[object Symbol]'));
+}
+exports.isSymbol = isSymbol;

package/cjs/src/lib/functions/kebab-case.function.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kebabCase = void 0;
+const snake_case_function_1 = require("./snake-case.function");
+function kebabCase(string) {
+    return (0, snake_case_function_1.snakeCase)(string).replace(/_/g, '-');
+}
+exports.kebabCase = kebabCase;

package/cjs/src/lib/functions/parse-bool.function.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBool = void 0;
+function parseBool(asc) {
+    return asc ? asc === true || asc === 'true' : false;
+}
+exports.parseBool = parseBool;

package/cjs/src/lib/functions/properties-to-array.function.js

@@ -0,0 +1,19 @@
+"use strict";
+// credit https://stackoverflow.com/questions/15690706/recursively-looping-through-an-object-to-build-a-property-list/53620876#53620876
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.propertiesToArray = void 0;
+function propertiesToArray(obj) {
+    const isObject = val => val && typeof val === 'object' && !Array.isArray(val);
+    const addDelimiter = (a, b) => a ? `${a}.${b}` : b;
+    const paths = (obj = {}, head = '') => {
+        return Object.entries(obj)
+            .reduce((product, [key, value]) => {
+            let fullPath = addDelimiter(head, key);
+            return isObject(value) ?
+                product.concat(paths(value, fullPath))
+                : product.concat(fullPath);
+        }, []);
+    };
+    return paths(obj);
+}
+exports.propertiesToArray = propertiesToArray;

package/cjs/src/lib/functions/sanitize-filename.function.js

@@ -0,0 +1,11 @@
+"use strict";
+/* eslint-disable no-control-regex */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeFilename = void 0;
+const _ = '_';
+const asciiReplacementRegX = /\/|\?|:|\\|{|\^|'|\}|%|`|]|>|\[|~|<|#|\||"|!|\*/g;
+const unicodeReplacementRegX = /[^\u0000-\u007F]/g;
+function sanitizeFilename(filename) {
+    return filename.replace(unicodeReplacementRegX, _).replace(asciiReplacementRegX, _).replace(/_+/g, _).trim();
+}
+exports.sanitizeFilename = sanitizeFilename;

package/cjs/src/lib/functions/snake-case.function.js

@@ -0,0 +1,32 @@
+"use strict";
+// source https://github.com/lodash/lodash/blob/master/snakeCase.js
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snakeCase = void 0;
+const words_function_1 = require("./words.function");
+/**
+ * Converts `string` to
+ * [snake case](https://en.wikipedia.org/wiki/Snake_case).
+ *
+ * @since 3.0.0
+ * @category String
+ * @param {string} [string=''] The string to convert.
+ * @returns {string} Returns the snake cased string.
+ * @see camelCase, lowerCase, kebabCase, startCase, upperCase, upperFirst
+ * @example
+ *
+ * snakeCase('Foo Bar')
+ * // => 'foo_bar'
+ *
+ * snakeCase('fooBar')
+ * // => 'foo_bar'
+ *
+ * snakeCase('--FOO-BAR--')
+ * // => 'foo_bar'
+ *
+ * snakeCase('foo2bar')
+ * // => 'foo_2_bar'
+ */
+function snakeCase(string) {
+    return ((0, words_function_1.words)(string.replace(/['\u2019]/g, '')).reduce((result, word, index) => (result + (index ? '_' : '') + word.toLowerCase()), ''));
+}
+exports.snakeCase = snakeCase;

package/cjs/src/lib/functions/subtract-offset.function.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subtractOffset = void 0;
+const millis_per_minute_constant_1 = require("../constants/millis-per-minute.constant");
+const try_parse_date_function_1 = require("./try-parse-date.function");
+function subtractOffset(input) {
+    const parsed = (0, try_parse_date_function_1.tryParseDate)(input);
+    if (!parsed) {
+        return;
+    }
+    const offset = (parsed).getTimezoneOffset();
+    return new Date(parsed.valueOf() - offset * millis_per_minute_constant_1.MILLIS_PER_MINUTE);
+}
+exports.subtractOffset = subtractOffset;

package/cjs/src/lib/functions/subtract-offset.function.spec.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const subtract_offset_function_1 = require("./subtract-offset.function");
+describe('subtractOffset', () => {
+    describe('GIVEN input is partial or full ISO8601', () => {
+        it.each([
+            '2023-12-23',
+            '2023-12-23T00:00:00.000',
+        ])('%j', (input) => {
+            expect((0, subtract_offset_function_1.subtractOffset)(input)).toMatchSnapshot();
+        });
+    });
+});

package/cjs/src/lib/functions/to-boolean-string.function.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBooleanString = void 0;
+function toBooleanString(val) {
+    return (!!(val || false)).toString();
+}
+exports.toBooleanString = toBooleanString;

package/cjs/src/lib/functions/to-calendar-date.function.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCalendarDate = void 0;
+const subtract_offset_function_1 = require("./subtract-offset.function");
+function toCalendarDate(input) {
+    const parsed = (0, subtract_offset_function_1.subtractOffset)(input);
+    if (!parsed) {
+        return;
+    }
+    return parsed?.toISOString().split('T')[0];
+}
+exports.toCalendarDate = toCalendarDate;

package/cjs/src/lib/functions/to-csv-string.function.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCsvString = void 0;
+function toCsvString(val) {
+    return (val || []).join(',');
+}
+exports.toCsvString = toCsvString;

package/cjs/src/lib/functions/to-decimal-base.function.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toDecimalBase = void 0;
+function toDecimalBase(n, base = 16) {
+    const digits = n.toString().split('');
+    let answer = 0;
+    digits.reverse().forEach(function (d, i) {
+        let actualNumber = Number(d);
+        if (!actualNumber && actualNumber !== 0) {
+            const codeAt = d.charCodeAt(0);
+            if (codeAt >= 97) {
+                actualNumber = codeAt - 87;
+            }
+            else {
+                actualNumber = codeAt - 55;
+            }
+        }
+        answer = answer + actualNumber * Math.pow(base, i);
+    });
+    return answer;
+}
+exports.toDecimalBase = toDecimalBase;

package/cjs/src/lib/functions/to-dollars-and-cents.function.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toDollarsAndCents = void 0;
+const to_words_function_1 = require("./to-words.function");
+function toDollarsAndCents(number) {
+    const num = Number(number);
+    const decimal = (Math.round((num % 1) * 100)) / 100;
+    const int = num - decimal;
+    const dollars = `${(0, to_words_function_1.toWords)(int)} dollars`;
+    if (!decimal) {
+        return dollars;
+    }
+    return `${dollars} and ${(0, to_words_function_1.toWords)(decimal * 100)} cents`;
+}
+exports.toDollarsAndCents = toDollarsAndCents;

package/cjs/src/lib/functions/to-dollars-and-cents.function.spec.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const to_dollars_and_cents_function_1 = require("./to-dollars-and-cents.function");
+describe('toDollarsAndCents', () => {
+    it('worx', () => {
+        expect((0, to_dollars_and_cents_function_1.toDollarsAndCents)(337.33)).toMatchSnapshot();
+    });
+});

package/cjs/src/lib/functions/to-string.function.js

@@ -0,0 +1,26 @@
+"use strict";
+// https://github.com/lodash/lodash/blob/main/src/toString.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toString = void 0;
+const is_symbol_function_1 = require("./is-symbol.function");
+/** Used as references for various `Number` constants. */
+const INFINITY = 1 / 0;
+function toString(value) {
+    if (value == null) {
+        return '';
+    }
+    // Exit early for strings to avoid a performance hit in some environments.
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        // Recursively convert values (susceptible to call stack limits).
+        return `${value.map((other) => (other == null ? other : toString(other)))}`;
+    }
+    if ((0, is_symbol_function_1.isSymbol)(value)) {
+        return value.toString();
+    }
+    const result = `${value}`;
+    return result === '0' && 1 / value === -INFINITY ? '-0' : result;
+}
+exports.toString = toString;

package/cjs/src/lib/functions/to-unique-array.function.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toUniqueArray = void 0;
+function toUniqueArray(elements) {
+    return Array.from(new Set(elements));
+}
+exports.toUniqueArray = toUniqueArray;

package/cjs/src/lib/functions/to-unique-array.function.spec.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const to_unique_array_function_1 = require("./to-unique-array.function");
+describe('toUniqueArray', () => {
+    it.each([
+        [
+            [1, 2, 3],
+            [1, 2, 3],
+        ],
+        [[1, 1, 1], [1]],
+    ])('GIVEN array of numbers: %j, returns a unique array without duplicate elements', (array, expected) => {
+        expect((0, to_unique_array_function_1.toUniqueArray)(array)).toEqual(expected);
+    });
+    it.each([
+        [
+            ['one', 'two', 'three'],
+            ['one', 'two', 'three'],
+        ],
+        [['one', 'one', 'one'], ['one']],
+    ])('GIVEN array of strings: %j, returns a unique array without duplicate elements', (array, expected) => {
+        expect((0, to_unique_array_function_1.toUniqueArray)(array)).toEqual(expected);
+    });
+    it.each([
+        [
+            ['one', 'two', 'three', undefined, undefined],
+            ['one', 'two', 'three', undefined],
+        ],
+        [
+            ['one', 'one', 'one', null, null],
+            ['one', null],
+        ],
+    ])('GIVEN array with falsey values: %j, returns a unique array without duplicate elements including falsey values', (array, expected) => {
+        expect((0, to_unique_array_function_1.toUniqueArray)(array)).toEqual(expected);
+    });
+});

package/cjs/src/lib/functions/to-words.function.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toWords = void 0;
+const MAX_SAFE_INTEGER = 9007199254740991;
+const TEN = 10;
+const ONE_HUNDRED = 100;
+const ONE_THOUSAND = 1000;
+const ONE_MILLION = 1000000;
+const ONE_BILLION = 1000000000;
+const ONE_TRILLION = 1000000000000;
+const ONE_QUADRILLION = 1000000000000000;
+const MAX = MAX_SAFE_INTEGER + 1;
+const LESS_THAN_TWENTY = [
+    'zero', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten',
+    'eleven', 'twelve', 'thirteen', 'fourteen', 'fifteen', 'sixteen', 'seventeen', 'eighteen', 'nineteen'
+];
+const TENTHS_LESS_THAN_HUNDRED = [
+    'zero', 'ten', 'twenty', 'thirty', 'forty', 'fifty', 'sixty', 'seventy', 'eighty', 'ninety'
+];
+function toWords(number) {
+    let words;
+    const num = parseInt(number, 10);
+    if (!isFinite(num)) {
+        throw new TypeError('Not a finite number: ' + number + ' (' + typeof number + ')');
+    }
+    if (!isSafeNumber(num)) {
+        throw new RangeError('Input is not a safe number, it\'s either too large or too small.');
+    }
+    words = generateWords(num);
+    return words;
+}
+exports.toWords = toWords;
+function generateWords(number, words) {
+    let remainder, word;
+    if (number === 0) {
+        return !words ? 'zero' : words.join(' ').replace(/,$/, '');
+    }
+    if (!words) {
+        words = [];
+    }
+    if (number < 0) {
+        words.push('minus');
+        number = Math.abs(number);
+    }
+    if (number < 20) {
+        remainder = 0;
+        word = LESS_THAN_TWENTY[number];
+    }
+    else if (number < ONE_HUNDRED) {
+        remainder = number % TEN;
+        word = TENTHS_LESS_THAN_HUNDRED[Math.floor(number / TEN)];
+        if (remainder) {
+            word += '-' + LESS_THAN_TWENTY[remainder];
+            remainder = 0;
+        }
+    }
+    else if (number < ONE_THOUSAND) {
+        remainder = number % ONE_HUNDRED;
+        word = generateWords(Math.floor(number / ONE_HUNDRED)) + ' hundred';
+    }
+    else if (number < ONE_MILLION) {
+        remainder = number % ONE_THOUSAND;
+        word = generateWords(Math.floor(number / ONE_THOUSAND)) + ' thousand,';
+    }
+    else if (number < ONE_BILLION) {
+        remainder = number % ONE_MILLION;
+        word = generateWords(Math.floor(number / ONE_MILLION)) + ' million,';
+    }
+    else if (number < ONE_TRILLION) {
+        remainder = number % ONE_BILLION;
+        word = generateWords(Math.floor(number / ONE_BILLION)) + ' billion,';
+    }
+    else if (number < ONE_QUADRILLION) {
+        remainder = number % ONE_TRILLION;
+        word = generateWords(Math.floor(number / ONE_TRILLION)) + ' trillion,';
+    }
+    else if (number <= MAX) {
+        remainder = number % ONE_QUADRILLION;
+        word = generateWords(Math.floor(number / ONE_QUADRILLION)) +
+            ' quadrillion,';
+    }
+    words.push(word);
+    return generateWords(remainder, words);
+}
+function isFinite(value) {
+    return !(typeof value !== 'number' || value !== value || value === Infinity || value === -Infinity);
+}
+function isSafeNumber(value) {
+    return typeof value === 'number' && Math.abs(value) <= MAX_SAFE_INTEGER;
+}

package/cjs/src/lib/functions/to-words.function.spec.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const to_words_function_1 = require("./to-words.function");
+describe('toWords', () => {
+    it('worx', () => {
+        expect((0, to_words_function_1.toWords)(337)).toMatchSnapshot();
+    });
+});

package/cjs/src/lib/functions/try-parse-date.function.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryParseDate = void 0;
+function tryParseDate(input) {
+    if (!input) {
+        return;
+    }
+    if (input instanceof Date) {
+        return input;
+    }
+    const date = new Date(input);
+    if (date == 'Invalid Date') {
+        return;
+    }
+    return date;
+}
+exports.tryParseDate = tryParseDate;

package/cjs/src/lib/functions/try-parse-date.function.spec.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const try_parse_date_function_1 = require("./try-parse-date.function");
+describe('tryParseDate', () => {
+    describe('GIVEN input is partial or full ISO8601', () => {
+        it.each([
+            '2023-12-23',
+            '2023-12-23T00:00:00.000',
+        ])('%j', (input) => {
+            expect((0, try_parse_date_function_1.tryParseDate)(input)).toMatchSnapshot();
+        });
+    });
+});