@onivoro/isomorphic-common 0.1.1 → 0.2.1

package/cjs/src/lib/functions/unicode-words.const.js

@@ -0,0 +1,69 @@
+"use strict";
+// source https://github.com/lodash/lodash/blob/master/.internal/unicodeWords.js
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unicodeWords = void 0;
+/** Used to compose unicode character classes. */
+const rsAstralRange = '\\ud800-\\udfff';
+const rsComboMarksRange = '\\u0300-\\u036f';
+const reComboHalfMarksRange = '\\ufe20-\\ufe2f';
+const rsComboSymbolsRange = '\\u20d0-\\u20ff';
+const rsComboMarksExtendedRange = '\\u1ab0-\\u1aff';
+const rsComboMarksSupplementRange = '\\u1dc0-\\u1dff';
+const rsComboRange = rsComboMarksRange + reComboHalfMarksRange + rsComboSymbolsRange + rsComboMarksExtendedRange + rsComboMarksSupplementRange;
+const rsDingbatRange = '\\u2700-\\u27bf';
+const rsLowerRange = 'a-z\\xdf-\\xf6\\xf8-\\xff';
+const rsMathOpRange = '\\xac\\xb1\\xd7\\xf7';
+const rsNonCharRange = '\\x00-\\x2f\\x3a-\\x40\\x5b-\\x60\\x7b-\\xbf';
+const rsPunctuationRange = '\\u2000-\\u206f';
+const rsSpaceRange = ' \\t\\x0b\\f\\xa0\\ufeff\\n\\r\\u2028\\u2029\\u1680\\u180e\\u2000\\u2001\\u2002\\u2003\\u2004\\u2005\\u2006\\u2007\\u2008\\u2009\\u200a\\u202f\\u205f\\u3000';
+const rsUpperRange = 'A-Z\\xc0-\\xd6\\xd8-\\xde';
+const rsVarRange = '\\ufe0e\\ufe0f';
+const rsBreakRange = rsMathOpRange + rsNonCharRange + rsPunctuationRange + rsSpaceRange;
+/** Used to compose unicode capture groups. */
+const rsApos = "['\u2019]";
+const rsBreak = `[${rsBreakRange}]`;
+const rsCombo = `[${rsComboRange}]`;
+const rsDigit = '\\d';
+const rsDingbat = `[${rsDingbatRange}]`;
+const rsLower = `[${rsLowerRange}]`;
+const rsMisc = `[^${rsAstralRange}${rsBreakRange + rsDigit + rsDingbatRange + rsLowerRange + rsUpperRange}]`;
+const rsFitz = '\\ud83c[\\udffb-\\udfff]';
+const rsModifier = `(?:${rsCombo}|${rsFitz})`;
+const rsNonAstral = `[^${rsAstralRange}]`;
+const rsRegional = '(?:\\ud83c[\\udde6-\\uddff]){2}';
+const rsSurrPair = '[\\ud800-\\udbff][\\udc00-\\udfff]';
+const rsUpper = `[${rsUpperRange}]`;
+const rsZWJ = '\\u200d';
+/** Used to compose unicode regexes. */
+const rsMiscLower = `(?:${rsLower}|${rsMisc})`;
+const rsMiscUpper = `(?:${rsUpper}|${rsMisc})`;
+const rsOptContrLower = `(?:${rsApos}(?:d|ll|m|re|s|t|ve))?`;
+const rsOptContrUpper = `(?:${rsApos}(?:D|LL|M|RE|S|T|VE))?`;
+const reOptMod = `${rsModifier}?`;
+const rsOptVar = `[${rsVarRange}]?`;
+const rsOptJoin = `(?:${rsZWJ}(?:${[rsNonAstral, rsRegional, rsSurrPair].join('|')})${rsOptVar + reOptMod})*`;
+const rsOrdLower = '\\d*(?:1st|2nd|3rd|(?![123])\\dth)(?=\\b|[A-Z_])';
+const rsOrdUpper = '\\d*(?:1ST|2ND|3RD|(?![123])\\dTH)(?=\\b|[a-z_])';
+const rsSeq = rsOptVar + reOptMod + rsOptJoin;
+const rsEmoji = `(?:${[rsDingbat, rsRegional, rsSurrPair].join('|')})${rsSeq}`;
+const reUnicodeWords = RegExp([
+    `${rsUpper}?${rsLower}+${rsOptContrLower}(?=${[rsBreak, rsUpper, '$'].join('|')})`,
+    `${rsMiscUpper}+${rsOptContrUpper}(?=${[rsBreak, rsUpper + rsMiscLower, '$'].join('|')})`,
+    `${rsUpper}?${rsMiscLower}+${rsOptContrLower}`,
+    `${rsUpper}+${rsOptContrUpper}`,
+    rsOrdUpper,
+    rsOrdLower,
+    `${rsDigit}+`,
+    rsEmoji
+].join('|'), 'g');
+/**
+ * Splits a Unicode `string` into an array of its words.
+ *
+ * @private
+ * @param {string} The string to inspect.
+ * @returns {Array} Returns the words of `string`.
+ */
+function unicodeWords(string) {
+    return string.match(reUnicodeWords);
+}
+exports.unicodeWords = unicodeWords;

package/cjs/src/lib/functions/upper-first.function.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upperFirst = void 0;
+function upperFirst(string) {
+    if (!string) {
+        return string;
+    }
+    return string
+        .split('')
+        .map((curr, i) => curr[!i ? 'toUpperCase' : 'toLowerCase']())
+        .join('');
+}
+exports.upperFirst = upperFirst;

package/cjs/src/lib/functions/upper-first.function.spec.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const upper_first_function_1 = require("./upper-first.function");
+describe('upperFirst', () => {
+    it.each([
+        'asdf',
+        'XCVB'
+    ])('GIVEN %j, does what u expect', (input) => {
+        expect((0, upper_first_function_1.upperFirst)(input)).toMatchSnapshot();
+    });
+    it.each([
+        null, undefined, 0, false
+    ])('GIVEN falsey input %j, does what u expect', (input) => {
+        expect((0, upper_first_function_1.upperFirst)(input)).toMatchSnapshot();
+    });
+});

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

@@ -0,0 +1,35 @@
+"use strict";
+// source https://github.com/lodash/lodash/blob/master/words.js
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.words = void 0;
+const unicode_words_const_1 = require("./unicode-words.const");
+const hasUnicodeWord = RegExp.prototype.test.bind(/[a-z][A-Z]|[A-Z]{2}[a-z]|[0-9][a-zA-Z]|[a-zA-Z][0-9]|[^a-zA-Z0-9 ]/);
+/** Used to match words composed of alphanumeric characters. */
+const reAsciiWord = /[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g;
+function asciiWords(string) {
+    return string.match(reAsciiWord);
+}
+/**
+ * Splits `string` into an array of its words.
+ *
+ * @since 3.0.0
+ * @category String
+ * @param {string} [string=''] The string to inspect.
+ * @param {RegExp|string} [pattern] The pattern to match words.
+ * @returns {Array} Returns the words of `string`.
+ * @example
+ *
+ * words('fred, barney, & pebbles')
+ * // => ['fred', 'barney', 'pebbles']
+ *
+ * words('fred, barney, & pebbles', /[^, ]+/g)
+ * // => ['fred', 'barney', '&', 'pebbles']
+ */
+function words(string, pattern) {
+    if (pattern === undefined) {
+        const result = hasUnicodeWord(string) ? (0, unicode_words_const_1.unicodeWords)(string) : asciiWords(string);
+        return result || [];
+    }
+    return string.match(pattern) || [];
+}
+exports.words = words;

package/cjs/src/lib/interfaces/axios-wrapped-nest-exception.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/src/lib/interfaces/entity-provider.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/src/lib/interfaces/keys-of.type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist

@@ -0,0 +1,22 @@
+{
+  "name": "@onivoro/isomorphic-common",
+  "version": "0.2.1",
+  "module": "esm/index.js",
+  "type": "module",
+  "main": "cjs/index.js",
+  "scripts": {
+    "esb": "npx esbuild src/index.ts --bundle --platform=node --target=node16.20.2 > dist/index.cjs.js",
+    "ts": "npx tsc --module es2022 --outDir esm/ && echo '{\"type\": \"module\"}' > esm/package.json",
+    "push": "npm run ts && cp package.json dist && npm publish --access public"
+  },
+  "exports": {
+    ".": {
+      "require": "./cjs/index.js",
+      "import": "./esm/index.js"
+    }
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "typescript": "^5.3.3"
+  }
+}

package/esm/jest.config.js

@@ -0,0 +1,17 @@
+/* eslint-disable */
+export 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/esm/package.json

@@ -0,0 +1 @@
+{"type": "module"}

package/esm/src/index.js

@@ -0,0 +1,29 @@
+export * from './lib/constants/millis-per-day.constant';
+export * from './lib/constants/millis-per-hour.constant';
+export * from './lib/constants/millis-per-minute.constant';
+export * from './lib/functions/add-offset.function';
+export * from './lib/functions/camel-case.function';
+export * from './lib/functions/convert-object-to-literal.function';
+export * from './lib/functions/from-boolean-string.function';
+export * from './lib/functions/from-calendar-date.function';
+export * from './lib/functions/from-csv-string.function';
+export * from './lib/functions/kebab-case.function';
+export * from './lib/functions/parse-bool.function';
+export * from './lib/functions/properties-to-array.function';
+export * from './lib/functions/sanitize-filename.function';
+export * from './lib/functions/snake-case.function';
+export * from './lib/functions/subtract-offset.function';
+export * from './lib/functions/to-boolean-string.function';
+export * from './lib/functions/to-calendar-date.function';
+export * from './lib/functions/to-csv-string.function';
+export * from './lib/functions/to-decimal-base.function';
+export * from './lib/functions/to-dollars-and-cents.function';
+export * from './lib/functions/to-unique-array.function';
+export * from './lib/functions/to-words.function';
+export * from './lib/functions/try-parse-date.function';
+export * from './lib/functions/unicode-words.const';
+export * from './lib/functions/upper-first.function';
+export * from './lib/functions/words.function';
+export * from './lib/interfaces/axios-wrapped-nest-exception.interface';
+export * from './lib/interfaces/entity-provider.interface';
+export * from './lib/interfaces/keys-of.type';

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

@@ -0,0 +1,2 @@
+import { MILLIS_PER_HOUR } from "./millis-per-hour.constant";
+export const MILLIS_PER_DAY = MILLIS_PER_HOUR * 24;

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

@@ -0,0 +1,2 @@
+import { MILLIS_PER_MINUTE } from "./millis-per-minute.constant";
+export const MILLIS_PER_HOUR = MILLIS_PER_MINUTE * 60;

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

@@ -0,0 +1 @@
+export const MILLIS_PER_MINUTE = 1000 * 60;

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

@@ -0,0 +1,10 @@
+import { MILLIS_PER_MINUTE } from '../constants/millis-per-minute.constant';
+import { tryParseDate } from './try-parse-date.function';
+export function addOffset(input) {
+    const parsed = tryParseDate(input);
+    if (!parsed) {
+        return;
+    }
+    const offset = (parsed).getTimezoneOffset();
+    return new Date(parsed.valueOf() + offset * MILLIS_PER_MINUTE);
+}

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

@@ -0,0 +1,11 @@
+import { addOffset } from './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(addOffset(input)).toMatchSnapshot();
+        });
+    });
+});

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

@@ -0,0 +1,27 @@
+// https://github.com/lodash/lodash/blob/main/src/camelCase.ts
+import { toString } from './to-string.function';
+import { upperFirst } from './upper-first.function';
+import { words } from './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'
+ */
+export const camelCase = (string) => words(toString(string).replace(/['\u2019]/g, '')).reduce((result, word, index) => {
+    word = word.toLowerCase();
+    return result + (index ? upperFirst(word) : word);
+}, '');

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

@@ -0,0 +1,6 @@
+export 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);
+}

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

@@ -0,0 +1,9 @@
+import { convertObjectToLiteral } from './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(convertObjectToLiteral(literalFn, delimiter, obj)).toMatchSnapshot();
+    });
+});

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

@@ -0,0 +1,3 @@
+export function fromBooleanString(value) {
+    return value === 'true';
+}

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

@@ -0,0 +1,4 @@
+import { addOffset } from "./add-offset.function";
+export function fromCalendarDate(input) {
+    return addOffset(input) || null;
+}

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

@@ -0,0 +1,10 @@
+import { fromCalendarDate } from './from-calendar-date.function';
+describe('fromCalendarDate', () => {
+    describe('GIVEN input is partial or full ISO8601', () => {
+        it.each([
+            '2023-12-23',
+        ])('%j', (input) => {
+            expect(fromCalendarDate(input)).toMatchSnapshot();
+        });
+    });
+});

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

@@ -0,0 +1,3 @@
+export function fromCsvString(value) {
+    return value ? value.split(',').map((v) => v.trim()) : [];
+}

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

@@ -0,0 +1,8 @@
+// https://github.com/lodash/lodash/blob/main/src/.internal/getTag.ts
+const toString = Object.prototype.toString;
+export function getTag(value) {
+    if (value == null) {
+        return value === undefined ? '[object Undefined]' : '[object Null]';
+    }
+    return toString.call(value);
+}

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

@@ -0,0 +1,7 @@
+// https://github.com/lodash/lodash/blob/main/src/isSymbol.ts
+import { getTag } from './get-tag.function';
+export function isSymbol(value) {
+    const type = typeof value;
+    return (type === 'symbol' ||
+        (type === 'object' && value != null && getTag(value) === '[object Symbol]'));
+}

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

@@ -0,0 +1,4 @@
+import { snakeCase } from "./snake-case.function";
+export function kebabCase(string) {
+    return snakeCase(string).replace(/_/g, '-');
+}

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

@@ -0,0 +1,3 @@
+export function parseBool(asc) {
+    return asc ? asc === true || asc === 'true' : false;
+}

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

@@ -0,0 +1,15 @@
+// credit https://stackoverflow.com/questions/15690706/recursively-looping-through-an-object-to-build-a-property-list/53620876#53620876
+export 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);
+}

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

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

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

@@ -0,0 +1,28 @@
+// source https://github.com/lodash/lodash/blob/master/snakeCase.js
+import { words } from "./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'
+ */
+export function snakeCase(string) {
+    return (words(string.replace(/['\u2019]/g, '')).reduce((result, word, index) => (result + (index ? '_' : '') + word.toLowerCase()), ''));
+}

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

@@ -0,0 +1,10 @@
+import { MILLIS_PER_MINUTE } from '../constants/millis-per-minute.constant';
+import { tryParseDate } from './try-parse-date.function';
+export function subtractOffset(input) {
+    const parsed = tryParseDate(input);
+    if (!parsed) {
+        return;
+    }
+    const offset = (parsed).getTimezoneOffset();
+    return new Date(parsed.valueOf() - offset * MILLIS_PER_MINUTE);
+}

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

@@ -0,0 +1,11 @@
+import { subtractOffset } from './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(subtractOffset(input)).toMatchSnapshot();
+        });
+    });
+});

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

@@ -0,0 +1,3 @@
+export function toBooleanString(val) {
+    return (!!(val || false)).toString();
+}

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

@@ -0,0 +1,8 @@
+import { subtractOffset } from "./subtract-offset.function";
+export function toCalendarDate(input) {
+    const parsed = subtractOffset(input);
+    if (!parsed) {
+        return;
+    }
+    return parsed?.toISOString().split('T')[0];
+}

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

@@ -0,0 +1,3 @@
+export function toCsvString(val) {
+    return (val || []).join(',');
+}

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

@@ -0,0 +1,18 @@
+export 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;
+}

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

@@ -0,0 +1,11 @@
+import { toWords } from "./to-words.function";
+export function toDollarsAndCents(number) {
+    const num = Number(number);
+    const decimal = (Math.round((num % 1) * 100)) / 100;
+    const int = num - decimal;
+    const dollars = `${toWords(int)} dollars`;
+    if (!decimal) {
+        return dollars;
+    }
+    return `${dollars} and ${toWords(decimal * 100)} cents`;
+}

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

@@ -0,0 +1,6 @@
+import { toDollarsAndCents } from './to-dollars-and-cents.function';
+describe('toDollarsAndCents', () => {
+    it('worx', () => {
+        expect(toDollarsAndCents(337.33)).toMatchSnapshot();
+    });
+});

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

@@ -0,0 +1,22 @@
+// https://github.com/lodash/lodash/blob/main/src/toString.ts
+import { isSymbol } from './is-symbol.function';
+/** Used as references for various `Number` constants. */
+const INFINITY = 1 / 0;
+export 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 (isSymbol(value)) {
+        return value.toString();
+    }
+    const result = `${value}`;
+    return result === '0' && 1 / value === -INFINITY ? '-0' : result;
+}

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

@@ -0,0 +1,3 @@
+export function toUniqueArray(elements) {
+    return Array.from(new Set(elements));
+}

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

@@ -0,0 +1,33 @@
+import { toUniqueArray } from './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(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(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(toUniqueArray(array)).toEqual(expected);
+    });
+});