dce-commonkit 4.4.0

package/lib/helpers/compareArraysByProp.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Test file for the compareArraysByProp helper
+ * @author Gabe Abrams
+ */
+export {};

package/lib/helpers/compareArraysByProp.test.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Test file for the compareArraysByProp helper
+ * @author Gabe Abrams
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import main helper
+var compareArraysByProp_1 = __importDefault(require("./compareArraysByProp"));
+describe('compareArraysByProp', function () {
+    it('should return true for two empty arrays', function () {
+        var result = (0, compareArraysByProp_1.default)([], [], 'id');
+        expect(result).toEqual(true);
+    });
+    it('should return true for two arrays with the same objects in the same order', function () {
+        var a = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
+        var b = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
+        var result = (0, compareArraysByProp_1.default)(a, b, 'id');
+        expect(result).toEqual(true);
+    });
+    it('should return true for two arrays with the same objects in a different order', function () {
+        var a = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
+        var b = [{ id: 3, name: 'Charlie' }, { id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+        var result = (0, compareArraysByProp_1.default)(a, b, 'id');
+        expect(result).toEqual(true);
+    });
+    it('should return false for two arrays with different objects', function () {
+        var a = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
+        var b = [{ id: 4, name: 'Dave' }, { id: 5, name: 'Eve' }, { id: 6, name: 'Frank' }];
+        var result = (0, compareArraysByProp_1.default)(a, b, 'id');
+        expect(result).toEqual(false);
+    });
+    it('should return false for two arrays with different objects and some shared objects', function () {
+        var a = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }];
+        var b = [{ id: 2, name: 'Bob' }, { id: 3, name: 'Charlie' }, { id: 4, name: 'Dave' }];
+        var result = (0, compareArraysByProp_1.default)(a, b, 'id');
+        expect(result).toEqual(false);
+    });
+    it('should return true for two arrays with the same objects with multiple properties', function () {
+        var a = [
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+        ];
+        var b = [
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+        ];
+        var result = (0, compareArraysByProp_1.default)(a, b, 'id');
+        expect(result).toEqual(true);
+    });
+    it('should return true for two arrays with the same objects with multiple properties in a different order', function () {
+        var a = [
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+        ];
+        var b = [
+            { id: 3, name: 'Charlie', age: 35 },
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+        ];
+        var result = (0, compareArraysByProp_1.default)(a, b, 'id');
+        expect(result).toEqual(true);
+    });
+    it('should return false for two arrays with different objects with multiple properties', function () {
+        var a = [
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+        ];
+        var b = [
+            { id: 4, name: 'Dave', age: 40 },
+            { id: 5, name: 'Eve', age: 45 },
+            { id: 6, name: 'Frank', age: 50 },
+        ];
+        var result = (0, compareArraysByProp_1.default)(a, b, 'id');
+        expect(result).toEqual(false);
+    });
+    it('should return false for two arrays with different objects with multiple properties and some shared objects', function () {
+        var a = [
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+        ];
+        var b = [
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+            { id: 4, name: 'Dave', age: 40 },
+        ];
+        var result = (0, compareArraysByProp_1.default)(a, b, 'id');
+        expect(result).toEqual(false);
+    });
+    it('should return true for two arrays with the same objects with multiple properties and multiple props', function () {
+        var a = [
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+        ];
+        var b = [
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+        ];
+        var result = (0, compareArraysByProp_1.default)(a, b, ['id', 'name']);
+        expect(result).toEqual(true);
+    });
+    it('should return true for two arrays with the same objects with multiple properties and multiple props in a different order', function () {
+        var a = [
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+        ];
+        var b = [
+            { id: 3, name: 'Charlie', age: 35 },
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+        ];
+        var result = (0, compareArraysByProp_1.default)(a, b, ['id', 'name']);
+        expect(result).toEqual(true);
+    });
+    it('should return false for two arrays with different objects with multiple properties and multiple props', function () {
+        var a = [
+            { id: 1, name: 'Alice', age: 25 },
+            { id: 2, name: 'Bob', age: 30 },
+            { id: 3, name: 'Charlie', age: 35 },
+        ];
+        var b = [
+            { id: 1, name: 'Bob', age: 40 },
+            { id: 2, name: 'Alice', age: 45 },
+            { id: 3, name: 'Charlie', age: 50 },
+        ];
+        var result = (0, compareArraysByProp_1.default)(a, b, ['id', 'name']);
+        expect(result).toEqual(false);
+    });
+});
+//# sourceMappingURL=compareArraysByProp.test.js.map

package/lib/helpers/compareArraysByProp.test.js.map

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

package/lib/helpers/extractProp.d.ts

@@ -0,0 +1,12 @@
+/**
+ * For every element in an array, extract the value of a prop
+ *   (e.g. for all user objects, extract their ages and put that into a new
+ *   ages array)
+ * @author Gabe Abrams
+ * @param arr the array of objects to operate on
+ * @param prop the property to extract from each object
+ * @returns new array containing the corresponding values, in order, of each
+ *   object in the original array
+ */
+declare const extractProp: (arr: any[], prop: string) => any[];
+export default extractProp;

package/lib/helpers/extractProp.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * For every element in an array, extract the value of a prop
+ *   (e.g. for all user objects, extract their ages and put that into a new
+ *   ages array)
+ * @author Gabe Abrams
+ * @param arr the array of objects to operate on
+ * @param prop the property to extract from each object
+ * @returns new array containing the corresponding values, in order, of each
+ *   object in the original array
+ */
+var extractProp = function (arr, prop) {
+    return arr.map(function (item) {
+        return item[prop];
+    });
+};
+exports.default = extractProp;
+//# sourceMappingURL=extractProp.js.map

package/lib/helpers/extractProp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractProp.js","sourceRoot":"","sources":["../../src/helpers/extractProp.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;GASG;AACH,IAAM,WAAW,GAAG,UAAC,GAAU,EAAE,IAAY;IAC3C,OAAO,GAAG,CAAC,GAAG,CAAC,UAAC,IAAI;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,kBAAe,WAAW,CAAC"}

package/lib/helpers/extractProp.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Test file for the extractProp helper
+ * @author Gabe Abrams
+ */
+export {};

package/lib/helpers/extractProp.test.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Test file for the extractProp helper
+ * @author Gabe Abrams
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import main helper
+var extractProp_1 = __importDefault(require("./extractProp"));
+describe('extractProp', function () {
+    it('should return an empty array if the input array is empty', function () {
+        var result = (0, extractProp_1.default)([], 'age');
+        expect(result).toEqual([]);
+    });
+    it('should extract the correct property from each object in the array', function () {
+        var users = [
+            { name: 'Alice', age: 25 },
+            { name: 'Bob', age: 30 },
+            { name: 'Charlie', age: 35 },
+        ];
+        var result = (0, extractProp_1.default)(users, 'age');
+        expect(result).toEqual([25, 30, 35]);
+    });
+    it('should return undefined for objects that do not have the specified property', function () {
+        var users = [
+            { name: 'Alice', age: 25 },
+            { name: 'Bob' },
+            { name: 'Charlie', age: 35 },
+        ];
+        var result = (0, extractProp_1.default)(users, 'age');
+        expect(result).toEqual([25, undefined, 35]);
+    });
+});
+//# sourceMappingURL=extractProp.test.js.map

package/lib/helpers/extractProp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractProp.test.js","sourceRoot":"","sources":["../../src/helpers/extractProp.test.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,qBAAqB;AACrB,8DAAwC;AAExC,QAAQ,CAAC,aAAa,EAAE;IACtB,EAAE,CAAC,0DAA0D,EAAE;QAC7D,IAAM,MAAM,GAAG,IAAA,qBAAW,EAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE;QACtE,IAAM,KAAK,GAAG;YACZ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;YAC1B,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;YACxB,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE;SAC7B,CAAC;QACF,IAAM,MAAM,GAAG,IAAA,qBAAW,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE;QAChF,IAAM,KAAK,GAAG;YACZ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;YAC1B,EAAE,IAAI,EAAE,KAAK,EAAE;YACf,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE;SAC7B,CAAC;QACF,IAAM,MAAM,GAAG,IAAA,qBAAW,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/helpers/floorToNumDecimals.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Round a number (floor) to a certain number of decimals
+ * @author Gabe Abrams
+ * @param num the number to round
+ * @param numDecimals the number of decimals to round to
+ * @returns rounded number
+ */
+declare const floorToNumDecimals: (num: number, numDecimals: number) => number;
+export default floorToNumDecimals;

package/lib/helpers/floorToNumDecimals.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Round a number (floor) to a certain number of decimals
+ * @author Gabe Abrams
+ * @param num the number to round
+ * @param numDecimals the number of decimals to round to
+ * @returns rounded number
+ */
+var floorToNumDecimals = function (num, numDecimals) {
+    var rounder = Math.pow(10, numDecimals);
+    return (Math.floor(num * rounder) / rounder);
+};
+exports.default = floorToNumDecimals;
+//# sourceMappingURL=floorToNumDecimals.js.map

package/lib/helpers/floorToNumDecimals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floorToNumDecimals.js","sourceRoot":"","sources":["../../src/helpers/floorToNumDecimals.ts"],"names":[],"mappings":";;AAAA;;;;;;GAMG;AACH,IAAM,kBAAkB,GAAG,UAAC,GAAW,EAAE,WAAmB;IAC1D,IAAM,OAAO,GAAG,SAAA,EAAE,EAAI,WAAW,CAAA,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,kBAAe,kBAAkB,CAAC"}

package/lib/helpers/floorToNumDecimals.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Test file for the floorToNumDecimals helper
+ * @author Gabe Abrams
+ */
+export {};

package/lib/helpers/floorToNumDecimals.test.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Test file for the floorToNumDecimals helper
+ * @author Gabe Abrams
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import main function
+var floorToNumDecimals_1 = __importDefault(require("./floorToNumDecimals"));
+describe('floorToNumDecimals', function () {
+    it('should return 0 for 0 with 0 decimals', function () {
+        var result = (0, floorToNumDecimals_1.default)(0, 0);
+        expect(result).toEqual(0);
+    });
+    it('should return 1 for 1 with 0 decimals', function () {
+        var result = (0, floorToNumDecimals_1.default)(1, 0);
+        expect(result).toEqual(1);
+    });
+    it('should return 1.23 for 1.234 with 2 decimals', function () {
+        var result = (0, floorToNumDecimals_1.default)(1.234, 2);
+        expect(result).toEqual(1.23);
+    });
+    it('should return -1.24 for -1.234 with 2 decimals', function () {
+        var result = (0, floorToNumDecimals_1.default)(-1.234, 2);
+        expect(result).toEqual(-1.24);
+    });
+    it('should return 1234 for 1234 with 0 decimals', function () {
+        var result = (0, floorToNumDecimals_1.default)(1234, 0);
+        expect(result).toEqual(1234);
+    });
+    it('should return 0.001 for 0.00123 with 3 decimals', function () {
+        var result = (0, floorToNumDecimals_1.default)(0.00123, 3);
+        expect(result).toEqual(0.001);
+    });
+});
+//# sourceMappingURL=floorToNumDecimals.test.js.map

package/lib/helpers/floorToNumDecimals.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floorToNumDecimals.test.js","sourceRoot":"","sources":["../../src/helpers/floorToNumDecimals.test.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,uBAAuB;AACvB,4EAAsD;AAEtD,QAAQ,CAAC,oBAAoB,EAAE;IAC7B,EAAE,CAAC,uCAAuC,EAAE;QAC1C,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE;QAC1C,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE;QACjD,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE;QACnD,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE;QAChD,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE;QACpD,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/helpers/forceNumIntoBounds.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Force a number to stay within specific bounds
+ * @author Gabe Abrams
+ * @param num the number to move into the bounds
+ * @param min the minimum number in the bound
+ * @param max the maximum number in the bound
+ * @returns bounded number
+ */
+declare const forceNumIntoBounds: (num: number, min: number, max: number) => number;
+export default forceNumIntoBounds;

package/lib/helpers/forceNumIntoBounds.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Force a number to stay within specific bounds
+ * @author Gabe Abrams
+ * @param num the number to move into the bounds
+ * @param min the minimum number in the bound
+ * @param max the maximum number in the bound
+ * @returns bounded number
+ */
+var forceNumIntoBounds = function (num, min, max) {
+    return Math.max(min, Math.min(max, num));
+};
+exports.default = forceNumIntoBounds;
+//# sourceMappingURL=forceNumIntoBounds.js.map

package/lib/helpers/forceNumIntoBounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forceNumIntoBounds.js","sourceRoot":"","sources":["../../src/helpers/forceNumIntoBounds.ts"],"names":[],"mappings":";;AAAA;;;;;;;GAOG;AACH,IAAM,kBAAkB,GAAG,UAAC,GAAW,EAAE,GAAW,EAAE,GAAW;IAC/D,OAAO,IAAI,CAAC,GAAG,CACb,GAAG,EACH,IAAI,CAAC,GAAG,CACN,GAAG,EACH,GAAG,CACJ,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,kBAAkB,CAAC"}

package/lib/helpers/forceNumIntoBounds.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Test file for the forceNumIntoBounds helper
+ * @author Gabe Abrams
+ */
+export {};

package/lib/helpers/forceNumIntoBounds.test.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Test file for the forceNumIntoBounds helper
+ * @author Gabe Abrams
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import main helper
+var forceNumIntoBounds_1 = __importDefault(require("./forceNumIntoBounds"));
+describe('forceNumIntoBounds', function () {
+    it('should return the number if it is within the bounds', function () {
+        var result = (0, forceNumIntoBounds_1.default)(5, 0, 10);
+        expect(result).toEqual(5);
+    });
+    it('should return the minimum bound if the number is less than the minimum', function () {
+        var result = (0, forceNumIntoBounds_1.default)(-5, 0, 10);
+        expect(result).toEqual(0);
+    });
+    it('should return the maximum bound if the number is greater than the maximum', function () {
+        var result = (0, forceNumIntoBounds_1.default)(15, 0, 10);
+        expect(result).toEqual(10);
+    });
+    it('should return the minimum bound if the number is equal to the minimum', function () {
+        var result = (0, forceNumIntoBounds_1.default)(0, 0, 10);
+        expect(result).toEqual(0);
+    });
+    it('should return the maximum bound if the number is equal to the maximum', function () {
+        var result = (0, forceNumIntoBounds_1.default)(10, 0, 10);
+        expect(result).toEqual(10);
+    });
+});
+//# sourceMappingURL=forceNumIntoBounds.test.js.map

package/lib/helpers/forceNumIntoBounds.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forceNumIntoBounds.test.js","sourceRoot":"","sources":["../../src/helpers/forceNumIntoBounds.test.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,qBAAqB;AACrB,4EAAsD;AAEtD,QAAQ,CAAC,oBAAoB,EAAE;IAC7B,EAAE,CAAC,qDAAqD,EAAE;QACxD,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE;QAC3E,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE;QAC9E,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE;QAC1E,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE;QAC1E,IAAM,MAAM,GAAG,IAAA,4BAAkB,EAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/helpers/genCSV.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generate a CSV file
+ * @author Gabe Abrams
+ * @param data list of row data in the form of json objects
+ * @param columns list of columns to include in the csv where each column is an object with:
+ * - title: the column title
+ * - param: the key in the data object to use for this column
+ * - textIfUndefined: optional text to use if the value is undefined (defaults to empty string)
+ * @returns multiline csv string
+ */
+declare const genCSV: (data: {
+    [k: string]: any;
+}[], columns: {
+    title: string;
+    param: string;
+    textIfUndefined?: string;
+}[]) => string;
+export default genCSV;

package/lib/helpers/genCSV.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Escape a CSV cell if needed
+ * @author Gabe Abrams
+ * @param text the cell contents
+ * @returns escaped cell text
+ */
+var escapeCellText = function (text) {
+    if (!String(text).includes(',')
+        && !String(text).includes('"')) {
+        // No need to escape
+        return String(text);
+    }
+    // Perform escape
+    return "\"".concat(String(text).replace(/"/g, '""'), "\"");
+};
+/**
+ * Generate a CSV file
+ * @author Gabe Abrams
+ * @param data list of row data in the form of json objects
+ * @param columns list of columns to include in the csv where each column is an object with:
+ * - title: the column title
+ * - param: the key in the data object to use for this column
+ * - textIfUndefined: optional text to use if the value is undefined (defaults to empty string)
+ * @returns multiline csv string
+ */
+var genCSV = function (data, columns) {
+    var csv = '';
+    // Add header
+    csv += (columns
+        .map(function (column) {
+        return escapeCellText(column.title);
+    })
+        .join(','));
+    // Add each row
+    data.forEach(function (datum) {
+        csv += '\n';
+        csv += (columns
+            .map(function (column) {
+            var _a;
+            var contents;
+            var cell = datum[column.param];
+            if (typeof cell === 'string'
+                || typeof cell === 'number'
+                || typeof cell === 'boolean') {
+                contents = String(cell);
+            }
+            else if (cell === null) {
+                contents = '';
+            }
+            else if (typeof cell === 'undefined') {
+                contents = ((_a = column.textIfUndefined) !== null && _a !== void 0 ? _a : '');
+            }
+            else if (typeof cell === 'object') {
+                contents = JSON.stringify(cell);
+            }
+            else {
+                contents = '';
+            }
+            return escapeCellText(contents);
+        })
+            .join(','));
+    });
+    // Return
+    return csv;
+};
+exports.default = genCSV;
+//# sourceMappingURL=genCSV.js.map

package/lib/helpers/genCSV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genCSV.js","sourceRoot":"","sources":["../../src/helpers/genCSV.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,IAAM,cAAc,GAAG,UAAC,IAAY;IAClC,IACE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;WACxB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAC9B,CAAC;QACD,oBAAoB;QACpB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,iBAAiB;IACjB,OAAO,YAAI,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAG,CAAC;AACjD,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,IAAM,MAAM,GAAG,UACb,IAEG,EACH,OAIG;IAEH,IAAI,GAAG,GAAG,EAAE,CAAC;IAEb,aAAa;IACb,GAAG,IAAI,CACL,OAAO;SACJ,GAAG,CAAC,UAAC,MAAM;QACV,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;IAEF,eAAe;IACf,IAAI,CAAC,OAAO,CAAC,UAAC,KAAK;QACjB,GAAG,IAAI,IAAI,CAAC;QACZ,GAAG,IAAI,CACL,OAAO;aACJ,GAAG,CAAC,UAAC,MAAM;;YACV,IAAI,QAAgB,CAAC;YACrB,IAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjC,IACE,OAAO,IAAI,KAAK,QAAQ;mBACrB,OAAO,IAAI,KAAK,QAAQ;mBACxB,OAAO,IAAI,KAAK,SAAS,EAC5B,CAAC;gBACD,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;iBAAM,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACzB,QAAQ,GAAG,EAAE,CAAC;YAChB,CAAC;iBAAM,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;gBACvC,QAAQ,GAAG,CACT,MAAA,MAAM,CAAC,eAAe,mCACnB,EAAE,CACN,CAAC;YACJ,CAAC;iBAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,EAAE,CAAC;YAChB,CAAC;YACD,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;aACD,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,SAAS;IACT,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,kBAAe,MAAM,CAAC"}

package/lib/helpers/genCSV.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Test file for the genCSV helper
+ * @author Gabe Abrams
+ */
+export {};

package/lib/helpers/genCSV.test.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Test file for the genCSV helper
+ * @author Gabe Abrams
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import main helper
+var genCSV_1 = __importDefault(require("./genCSV"));
+describe('genCSV', function () {
+    it('should return an empty string for empty data', function () {
+        var result = (0, genCSV_1.default)([], []);
+        expect(result).toEqual('');
+    });
+    it('should generate a CSV with the correct headers and data', function () {
+        var columns = [
+            { title: 'Name', param: 'name' },
+            { title: 'Age', param: 'age' },
+            { title: 'Email', param: 'email' },
+        ];
+        var data = [
+            { name: 'Alice', age: 25, email: 'alice@example.com' },
+            { name: 'Bob', age: 30, email: 'bob@example.com' },
+            { name: 'Charlie', age: 35, email: 'charlie@example.com' },
+        ];
+        var expected = 'Name,Age,Email\nAlice,25,alice@example.com\nBob,30,bob@example.com\nCharlie,35,charlie@example.com';
+        var result = (0, genCSV_1.default)(data, columns);
+        expect(result).toEqual(expected);
+    });
+    it('should handle undefined and null values correctly', function () {
+        var columns = [
+            { title: 'Name', param: 'name' },
+            { title: 'Age', param: 'age' },
+            { title: 'Email', param: 'email' },
+        ];
+        var data = [
+            { name: 'Alice', age: undefined, email: null },
+            { name: 'Bob', age: null, email: 'bob@example.com' },
+            { name: 'Charlie', age: 35, email: undefined },
+        ];
+        var expected = 'Name,Age,Email\nAlice,,\nBob,,bob@example.com\nCharlie,35,';
+        var result = (0, genCSV_1.default)(data, columns);
+        expect(result).toEqual(expected);
+    });
+    it('should handle objects in cells correctly', function () {
+        var columns = [
+            { title: 'Name', param: 'name' },
+            { title: 'Data', param: 'data' },
+        ];
+        var data = [
+            { name: 'Alice', data: { foo: 'bar' } },
+            { name: 'Bob', data: [1, 2, 3] },
+            { name: 'Charlie', data: null },
+        ];
+        var expected = 'Name,Data\nAlice,"{""foo"":""bar""}"\nBob,"[1,2,3]"\nCharlie,';
+        var result = (0, genCSV_1.default)(data, columns);
+        expect(result).toEqual(expected);
+    });
+    it('should use textIfUndefined for undefined values', function () {
+        var columns = [
+            { title: 'Name', param: 'name' },
+            { title: 'Age', param: 'age', textIfUndefined: 'N/A' },
+        ];
+        var data = [
+            { name: 'Alice', age: undefined },
+            { name: 'Bob', age: 30 },
+        ];
+        var expected = 'Name,Age\nAlice,N/A\nBob,30';
+        var result = (0, genCSV_1.default)(data, columns);
+        expect(result).toEqual(expected);
+    });
+});
+//# sourceMappingURL=genCSV.test.js.map

package/lib/helpers/genCSV.test.js.map

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

package/lib/helpers/genCommaList.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Given an array of strings, create a single comma-separated string that includes
+ * 'and' as well as an oxford comma.
+ *   Ex: ['apples'] => 'apples'
+ *   Ex: ['apples', 'bananas'] => 'apples and bananas'
+ *   Ex: ['apples', 'bananas', 'grapes'] => 'apples, bananas, and grapes'
+ * @author Austen Money
+ * @param list an array of elements to be made into a single comma-separated string.
+ * @returns a comma-separated string.
+ */
+declare const genCommaList: (list: string[]) => string;
+export default genCommaList;

package/lib/helpers/genCommaList.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Given an array of strings, create a single comma-separated string that includes
+ * 'and' as well as an oxford comma.
+ *   Ex: ['apples'] => 'apples'
+ *   Ex: ['apples', 'bananas'] => 'apples and bananas'
+ *   Ex: ['apples', 'bananas', 'grapes'] => 'apples, bananas, and grapes'
+ * @author Austen Money
+ * @param list an array of elements to be made into a single comma-separated string.
+ * @returns a comma-separated string.
+ */
+var genCommaList = function (list) {
+    var length = list.length;
+    return (length < 2
+        ? list.join('')
+        : "".concat(list.slice(0, length - 1).join(', ')).concat(length < 3 ? ' and ' : ', and ').concat(list[length - 1]));
+};
+exports.default = genCommaList;
+//# sourceMappingURL=genCommaList.js.map

package/lib/helpers/genCommaList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genCommaList.js","sourceRoot":"","sources":["../../src/helpers/genCommaList.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;GASG;AACH,IAAM,YAAY,GAAG,UAAC,IAAc;IAC1B,IAAA,MAAM,GAAK,IAAI,OAAT,CAAU;IAExB,OAAO,CACL,MAAM,GAAG,CAAC;QACR,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACf,CAAC,CAAC,UAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,SAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAE,CACnG,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,YAAY,CAAC"}

package/lib/helpers/genCommaList.test.d.ts

@@ -0,0 +1 @@
+export {};