@8ms/helpers 1.1.17 → 1.1.20

package/dist/aws/s3/copyFile.d.ts

@@ -0,0 +1,14 @@
+export declare type CopyFileType = {
+    bucket: string;
+    key: string;
+};
+/**
+ * Copy a file from one bucket/path to another bucket/path.
+ */
+declare const copyFile: ({ S3Lib, client, from, to }: {
+    S3Lib: any;
+    client: any;
+    from: CopyFileType;
+    to: CopyFileType;
+}) => Promise<void>;
+export default copyFile;

package/dist/aws/s3/copyFile.js

@@ -0,0 +1,62 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Copy a file from one bucket/path to another bucket/path.
+ */
+var copyFile = function (_a) {
+    var S3Lib = _a.S3Lib, client = _a.client, from = _a.from, to = _a.to;
+    return __awaiter(void 0, void 0, void 0, function () {
+        var CopyObjectCommand;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    CopyObjectCommand = S3Lib.CopyObjectCommand;
+                    return [4 /*yield*/, client.send(new CopyObjectCommand({
+                            Bucket: to.bucket,
+                            CopySource: encodeURIComponent("".concat(from.bucket, "/").concat(from.key)),
+                            Key: to.key,
+                        }))];
+                case 1:
+                    _b.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+};
+exports.default = copyFile;

package/dist/aws/s3/index.d.ts

@@ -1,3 +1,4 @@
+import copyFile from './copyFile';
 import deleteFile from './deleteFile';
 import deleteFiles from './deleteFiles';
 import deleteFolder from './deleteFolder';
@@ -6,10 +7,11 @@ import getPresignedPost from './getPresignedPost';
 import getSignedUrl from './getSignedUrl';
 import listFiles from './listFiles';
 import listFolders from './listFolders';
+import moveFile from './moveFile';
 import readBuffer, { ReadBufferType } from './readBuffer';
 import readFile, { ReadFileType, ReadType } from './readFile';
 import writeFile from './writeFile';
 import writeGlueJsonFile from './writeGlueJsonFile';
 import writePresignedPost from './writePresignedPost';
 export type { ReadType, ReadBufferType, ReadFileType, };
-export { deleteFolder, deleteFile, deleteFiles, getClient, getPresignedPost, getSignedUrl, listFiles, listFolders, readBuffer, readFile, writeFile, writeGlueJsonFile, writePresignedPost, };
+export { copyFile, deleteFolder, deleteFile, deleteFiles, getClient, getPresignedPost, getSignedUrl, listFiles, listFolders, moveFile, readBuffer, readFile, writeFile, writeGlueJsonFile, writePresignedPost, };

package/dist/aws/s3/index.js

@@ -3,7 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.writePresignedPost = exports.writeGlueJsonFile = exports.writeFile = exports.readFile = exports.readBuffer = exports.listFolders = exports.listFiles = exports.getSignedUrl = exports.getPresignedPost = exports.getClient = exports.deleteFiles = exports.deleteFile = exports.deleteFolder = void 0;
+exports.writePresignedPost = exports.writeGlueJsonFile = exports.writeFile = exports.readFile = exports.readBuffer = exports.moveFile = exports.listFolders = exports.listFiles = exports.getSignedUrl = exports.getPresignedPost = exports.getClient = exports.deleteFiles = exports.deleteFile = exports.deleteFolder = exports.copyFile = void 0;
+var copyFile_1 = __importDefault(require("./copyFile"));
+exports.copyFile = copyFile_1.default;
 var deleteFile_1 = __importDefault(require("./deleteFile"));
 exports.deleteFile = deleteFile_1.default;
 var deleteFiles_1 = __importDefault(require("./deleteFiles"));
@@ -20,6 +22,8 @@ var listFiles_1 = __importDefault(require("./listFiles"));
 exports.listFiles = listFiles_1.default;
 var listFolders_1 = __importDefault(require("./listFolders"));
 exports.listFolders = listFolders_1.default;
+var moveFile_1 = __importDefault(require("./moveFile"));
+exports.moveFile = moveFile_1.default;
 var readBuffer_1 = __importDefault(require("./readBuffer"));
 exports.readBuffer = readBuffer_1.default;
 var readFile_1 = __importDefault(require("./readFile"));

package/dist/aws/s3/moveFile.d.ts

@@ -0,0 +1,11 @@
+import { CopyFileType } from './copyFile';
+/**
+ * It's not possible to just move or rename a file, you must copy then delete the old file.
+ */
+declare const moveFile: ({ S3Lib, client, from, to }: {
+    S3Lib: any;
+    client: any;
+    from: CopyFileType;
+    to: CopyFileType;
+}) => Promise<void>;
+export default moveFile;

package/dist/aws/s3/moveFile.js

@@ -0,0 +1,73 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var copyFile_1 = __importDefault(require("./copyFile"));
+var deleteFile_1 = __importDefault(require("./deleteFile"));
+/**
+ * It's not possible to just move or rename a file, you must copy then delete the old file.
+ */
+var moveFile = function (_a) {
+    var S3Lib = _a.S3Lib, client = _a.client, from = _a.from, to = _a.to;
+    return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, (0, copyFile_1.default)({
+                        S3Lib: S3Lib,
+                        client: client,
+                        from: from,
+                        to: to,
+                    })];
+                case 1:
+                    _b.sent();
+                    return [4 /*yield*/, (0, deleteFile_1.default)({
+                            S3Lib: S3Lib,
+                            bucket: from.bucket,
+                            client: client,
+                            key: from.key,
+                        })];
+                case 2:
+                    _b.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+};
+exports.default = moveFile;

package/dist/crypto/getSha256.d.ts

@@ -1,9 +1,5 @@
-/**
- * Encrypt a string using sha256
- * Library: crypto-js
- */
 declare const getSha256: ({ CryptoLib, input }: {
     CryptoLib: any;
-    input: string;
+    input: any;
 }) => string;
 export default getSha256;

package/dist/crypto/getSha256.js

@@ -4,10 +4,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Encrypt a string using sha256
  * Library: crypto-js
  */
+var string_1 = require("../string");
 var getSha256 = function (_a) {
     var CryptoLib = _a.CryptoLib, input = _a.input;
     var SHA256 = CryptoLib.SHA256;
-    return SHA256(input)
+    var inputString = (0, string_1.getString)({ input: input });
+    return SHA256(inputString)
         .toString();
 };
 exports.default = getSha256;

package/dist/date/getDate.d.ts

@@ -1,8 +1,10 @@
 import { DateType } from './date';
+declare type GetDateType = {
+    input: DateType;
+    setMidnight?: boolean;
+};
 /**
  * Convert a (number | string | Date) into a Date object.
  */
-declare const getDate: ({ input }: {
-    input: DateType;
-}) => Date;
+declare const getDate: ({ input, setMidnight }: GetDateType) => Date;
 export default getDate;

package/dist/date/getDate.js

@@ -3,36 +3,47 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-var addHours_1 = __importDefault(require("date-fns/addHours"));
 var parse_1 = __importDefault(require("date-fns/parse"));
-var subHours_1 = __importDefault(require("date-fns/subHours"));
 /**
  * Convert a (number | string | Date) into a Date object.
  */
 var getDate = function (_a) {
-    var input = _a.input;
+    var input = _a.input, _b = _a.setMidnight, setMidnight = _b === void 0 ? true : _b;
     var date;
     if (input instanceof Date) {
         date = new Date(input.valueOf());
     }
-    else if ('string' === typeof input) {
-        var dateString = input.toString() + ' 00:00:00';
-        date = (0, parse_1.default)(dateString, 'yyyy-MM-dd HH:mm:ss', new Date());
+    else if ('string' === typeof input || 'number' === typeof input) {
+        // Convert  the input into string
+        var dateString = input.toString();
+        // 20220412
+        if (8 === dateString.length) {
+            var year = Number(dateString.substring(0, 4));
+            var month = Number(dateString.substring(4, 6));
+            var day = Number(dateString.substring(6, 8));
+            if (year > 999 && month < 13 && day < 32) {
+                date = new Date();
+                date.setUTCFullYear(year);
+                date.setUTCMonth(month - 1);
+                date.setUTCDate(day);
+            }
+        }
+        // 2022-04-12
+        else if (10 === dateString.length) {
+            var dateTimeString = dateString + ' 00:00:00s';
+            date = (0, parse_1.default)(dateTimeString, 'yyyy-MM-dd HH:mm:ss', new Date());
+        }
+        // 2022-04-12 01:01:01
+        else if (19 === dateString.length) {
+            date = (0, parse_1.default)(dateString, 'yyyy-MM-dd HH:mm:ss', new Date());
+        }
+        // Unsure date format, try anything
+        else {
+            date = new Date(dateString);
+        }
     }
-    else if ('number' === typeof input) {
-        var dateString = input.toString() + ' 00:00:00';
-        date = (0, parse_1.default)(dateString, 'yyyyMMdd HH:mm:ss', new Date());
-    }
-    // Behind an hour (going back to DST)
-    if (date.getTimezoneOffset() < 0) {
-        date = (0, addHours_1.default)(date, 1);
-    }
-    // Forward an hour (going into BST)
-    else if (date.getTimezoneOffset() > 0) {
-        date = (0, subHours_1.default)(date, 1);
-    }
-    // Otherwise set to UTC hours
-    else {
+    // Reset to UTC hours
+    if (setMidnight) {
         date.setHours(0, 0, 0, 0);
     }
     return date;

package/dist/date/getExcelDate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Convert an excel date "e.g. 44216" into a JavaScript date object.
+ * https://stackoverflow.com/questions/16229494/converting-excel-date-serial-number-to-date-using-javascript
+ */
+declare const getExcelDate: ({ input }: {
+    input: number;
+}) => Date;
+export default getExcelDate;

package/dist/date/getExcelDate.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Convert an excel date "e.g. 44216" into a JavaScript date object.
+ * https://stackoverflow.com/questions/16229494/converting-excel-date-serial-number-to-date-using-javascript
+ */
+var getExcelDate = function (_a) {
+    var input = _a.input;
+    var utcDates = Math.floor(input - 25569);
+    var utcValue = utcDates * 86400;
+    var dateInfo = new Date(utcValue * 1000);
+    var fractionalDay = input - Math.floor(input) + 0.0000001;
+    var totalSeconds = Math.floor(86400 * fractionalDay);
+    var seconds = totalSeconds % 60;
+    totalSeconds -= seconds;
+    var hours = Math.floor(totalSeconds / (60 * 60));
+    var minutes = Math.floor(totalSeconds / 60) % 60;
+    return new Date(dateInfo.getFullYear(), dateInfo.getMonth(), dateInfo.getDate(), hours, minutes, seconds);
+};
+exports.default = getExcelDate;

package/dist/date/index.d.ts

@@ -8,6 +8,7 @@ import format from './format';
 import getDate from './getDate';
 import getDurationHours from './getDurationHours';
 import getDurationMinutes from './getDurationMinutes';
+import getExcelDate from './getExcelDate';
 import getFinancialYear from './getFinancialYear';
 import getFinancialYearToDate from './getFinancialYearToDate';
 import getFinancialYearWeeks from './getFinancialYearWeeks';
@@ -31,4 +32,4 @@ import { predefinedTimeframes, PredefinedTimeframesType } from './predefinedTime
 import { TimeframeType } from './timeframe';
 import { timeframes } from './timeframes';
 export type { DateType, DurationType, FinancialYearType, FinancialYearWeekType, PredefinedTimeframesType, TimeframeType, };
-export { durations, durationComparisons, predefinedTimeframes, timeframes, format, getDate, getDurationHours, getDurationMinutes, getFinancialYear, getFinancialYearToDate, getFinancialYearWeeks, getLastWeek, getMax, getMin, getMonday, getNumber, getPredefinedTimeframe, getSunday, getThisWeek, getToday, getTwoWeeksAgo, getWeeksAgo, getYesterday, isDateValid, isLastWeek, isThisWeek, parseExcelDate, };
+export { durations, durationComparisons, predefinedTimeframes, timeframes, format, getDate, getDurationHours, getDurationMinutes, getExcelDate, getFinancialYear, getFinancialYearToDate, getFinancialYearWeeks, getLastWeek, getMax, getMin, getMonday, getNumber, getPredefinedTimeframe, getSunday, getThisWeek, getToday, getTwoWeeksAgo, getWeeksAgo, getYesterday, isDateValid, isLastWeek, isThisWeek, parseExcelDate, };

package/dist/date/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseExcelDate = exports.isThisWeek = exports.isLastWeek = exports.isDateValid = exports.getYesterday = exports.getWeeksAgo = exports.getTwoWeeksAgo = exports.getToday = exports.getThisWeek = exports.getSunday = exports.getPredefinedTimeframe = exports.getNumber = exports.getMonday = exports.getMin = exports.getMax = exports.getLastWeek = exports.getFinancialYearWeeks = exports.getFinancialYearToDate = exports.getFinancialYear = exports.getDurationMinutes = exports.getDurationHours = exports.getDate = exports.format = exports.timeframes = exports.predefinedTimeframes = exports.durationComparisons = exports.durations = void 0;
+exports.parseExcelDate = exports.isThisWeek = exports.isLastWeek = exports.isDateValid = exports.getYesterday = exports.getWeeksAgo = exports.getTwoWeeksAgo = exports.getToday = exports.getThisWeek = exports.getSunday = exports.getPredefinedTimeframe = exports.getNumber = exports.getMonday = exports.getMin = exports.getMax = exports.getLastWeek = exports.getFinancialYearWeeks = exports.getFinancialYearToDate = exports.getFinancialYear = exports.getExcelDate = exports.getDurationMinutes = exports.getDurationHours = exports.getDate = exports.format = exports.timeframes = exports.predefinedTimeframes = exports.durationComparisons = exports.durations = void 0;
 var durationComparisons_1 = require("./durationComparisons");
 Object.defineProperty(exports, "durationComparisons", { enumerable: true, get: function () { return durationComparisons_1.durationComparisons; } });
 var durations_1 = require("./durations");
@@ -16,6 +16,8 @@ var getDurationHours_1 = __importDefault(require("./getDurationHours"));
 exports.getDurationHours = getDurationHours_1.default;
 var getDurationMinutes_1 = __importDefault(require("./getDurationMinutes"));
 exports.getDurationMinutes = getDurationMinutes_1.default;
+var getExcelDate_1 = __importDefault(require("./getExcelDate"));
+exports.getExcelDate = getExcelDate_1.default;
 var getFinancialYear_1 = __importDefault(require("./getFinancialYear"));
 exports.getFinancialYear = getFinancialYear_1.default;
 var getFinancialYearToDate_1 = __importDefault(require("./getFinancialYearToDate"));

package/dist/google/sheets/getAssociatedData.d.ts

@@ -0,0 +1,20 @@
+export declare type AssociateDataRequestType = {
+    spreadsheetId: string;
+    ranges: [
+        format: string,
+        defaultRange: string,
+        heading: string,
+        data: string
+    ];
+    dateTimeRender: 'FORMATTED_STRING' | 'SERIAL_NUMBER';
+    valueRender: 'FORMATTED_VALUE' | 'UNFORMATTED_VALUE' | 'FORMULA';
+};
+/**
+ * Make a batch get to Google Sheets to retrieve the data correctly formatted, with default values provided.
+ */
+declare const getAssociatedData: ({ SheetsLib, client, request }: {
+    SheetsLib: any;
+    client: any;
+    request: AssociateDataRequestType;
+}) => Promise<object[]>;
+export default getAssociatedData;

package/dist/google/sheets/getAssociatedData.js

@@ -0,0 +1,100 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var isUndefined_1 = __importDefault(require("lodash/isUndefined"));
+var getBatchData_1 = __importDefault(require("./getBatchData"));
+/**
+ * Make a batch get to Google Sheets to retrieve the data correctly formatted, with default values provided.
+ */
+var getAssociatedData = function (_a) {
+    var SheetsLib = _a.SheetsLib, client = _a.client, request = _a.request;
+    return __awaiter(void 0, void 0, void 0, function () {
+        var apiResponse, template, response, initialRangeLength, i, rowIndex, row, columnIndex, refValue, value;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, (0, getBatchData_1.default)({
+                        SheetsLib: SheetsLib,
+                        client: client,
+                        spreadsheetId: request.spreadsheetId,
+                        ranges: request.ranges,
+                        dateTimeRender: request.dateTimeRender,
+                        valueRender: request.valueRender,
+                    })];
+                case 1:
+                    apiResponse = _b.sent();
+                    template = [];
+                    response = [];
+                    // Missing ranges or too many ranges
+                    if (4 !== apiResponse.valueRanges.length) {
+                        throw new Error("Associated data response length must be 4.");
+                    }
+                    initialRangeLength = apiResponse.valueRanges[0].values[0].length;
+                    // Loop through the headings
+                    for (i = 0; i < initialRangeLength; i++) {
+                        template.push({
+                            format: apiResponse.valueRanges[0].values[0][i],
+                            default: apiResponse.valueRanges[1].values[0][i],
+                            heading: apiResponse.valueRanges[2].values[0][i],
+                            index: i,
+                        });
+                    }
+                    // console.log('template', template);
+                    // Loop through each row of data
+                    if (!(0, isUndefined_1.default)(apiResponse.valueRanges[3].values)) {
+                        for (rowIndex = 0; rowIndex < apiResponse.valueRanges[3].values.length; rowIndex++) {
+                            row = {};
+                            // Loop through each column within the row
+                            for (columnIndex = 0; columnIndex < apiResponse.valueRanges[3].values[rowIndex].length; columnIndex++) {
+                                refValue = apiResponse.valueRanges[3].values[rowIndex][columnIndex];
+                                value = ('' === refValue ? template[columnIndex]['default'] : refValue);
+                                // Add this to our row
+                                row[template[columnIndex]['heading']] = value;
+                            }
+                            // Add the row to our response
+                            response.push(row);
+                        }
+                    }
+                    return [2 /*return*/, response];
+            }
+        });
+    });
+};
+exports.default = getAssociatedData;

package/dist/google/sheets/getBatchData.d.ts

@@ -0,0 +1,20 @@
+declare type BatchRangeResponse = {
+    spreadsheetId: string;
+    valueRanges: {
+        range: string;
+        majorDimension: 'rows' | 'dimension';
+        values: [
+            any[]
+        ];
+    }[];
+};
+declare type BatchDataRequestType = {
+    SheetsLib: any;
+    client: any;
+    spreadsheetId: string;
+    ranges: string[];
+    dateTimeRender?: string;
+    valueRender?: string;
+};
+declare const getBatchData: ({ SheetsLib, client, spreadsheetId, ranges, dateTimeRender, valueRender, }: BatchDataRequestType) => Promise<BatchRangeResponse>;
+export default getBatchData;

package/dist/google/sheets/getBatchData.js

@@ -0,0 +1,64 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var getBatchData = function (_a) {
+    var SheetsLib = _a.SheetsLib, client = _a.client, spreadsheetId = _a.spreadsheetId, ranges = _a.ranges, _b = _a.dateTimeRender, dateTimeRender = _b === void 0 ? 'FORMATTED_STRING' : _b, _c = _a.valueRender, valueRender = _c === void 0 ? 'UNFORMATTED_VALUE' : _c;
+    return __awaiter(void 0, void 0, void 0, function () {
+        var request, data;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    request = {
+                        auth: client,
+                        dateTimeRenderOption: dateTimeRender,
+                        ranges: ranges,
+                        spreadsheetId: spreadsheetId,
+                        valueRenderOption: valueRender,
+                    };
+                    return [4 /*yield*/, SheetsLib.sheets('v4')
+                            .spreadsheets
+                            .values
+                            .batchGet(request)];
+                case 1:
+                    data = (_d.sent()).data;
+                    return [2 /*return*/, data];
+            }
+        });
+    });
+};
+exports.default = getBatchData;

package/dist/google/sheets/index.d.ts

@@ -1,3 +1,6 @@
 import getAuth from './getAuth';
+import getAssociatedData from './getAssociatedData';
+import getBatchData from './getBatchData';
+import isCellNa from './isCellNa';
 export type {};
-export { getAuth, };
+export { getAssociatedData, getAuth, getBatchData, isCellNa, };

package/dist/google/sheets/index.js

@@ -3,6 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAuth = void 0;
+exports.isCellNa = exports.getBatchData = exports.getAuth = exports.getAssociatedData = void 0;
 var getAuth_1 = __importDefault(require("./getAuth"));
 exports.getAuth = getAuth_1.default;
+var getAssociatedData_1 = __importDefault(require("./getAssociatedData"));
+exports.getAssociatedData = getAssociatedData_1.default;
+var getBatchData_1 = __importDefault(require("./getBatchData"));
+exports.getBatchData = getBatchData_1.default;
+var isCellNa_1 = __importDefault(require("./isCellNa"));
+exports.isCellNa = isCellNa_1.default;

package/dist/google/sheets/isCellNa.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Noticed sometimes Google Sheets can struggle with import XML resulting to N/A values.
+ */
+declare const isCellNa: ({ input }: {
+    input: any;
+}) => boolean;
+export default isCellNa;

package/dist/google/sheets/isCellNa.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Noticed sometimes Google Sheets can struggle with import XML resulting to N/A values.
+ */
+var isCellNa = function (_a) {
+    var input = _a.input;
+    return '#N/A' === input;
+};
+exports.default = isCellNa;

package/dist/string/getString.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Convert into string.
+ */
+declare const getString: ({ input }: {
+    input: any;
+}) => string;
+export default getString;

package/dist/string/getString.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var isArray_1 = __importDefault(require("lodash/isArray"));
+var isDate_1 = __importDefault(require("lodash/isDate"));
+var isNumber_1 = __importDefault(require("lodash/isNumber"));
+var isObject_1 = __importDefault(require("lodash/isObject"));
+var isString_1 = __importDefault(require("lodash/isString"));
+var date_1 = require("../date");
+/**
+ * Convert into string.
+ */
+var getString = function (_a) {
+    var input = _a.input;
+    var string = '';
+    // Already a string
+    if ((0, isString_1.default)(input)) {
+        string = input;
+    }
+    // Convert a number into a date
+    else if ((0, isNumber_1.default)(input)) {
+        string = input.toString();
+    }
+    // Object or array to JSON
+    else if ((0, isObject_1.default)(input) || (0, isArray_1.default)(input)) {
+        string = JSON.stringify(input);
+    }
+    // Date
+    else if ((0, isDate_1.default)(input)) {
+        string = (0, date_1.getNumber)({ input: input })
+            .toString();
+    }
+    return string;
+};
+exports.default = getString;

package/dist/string/index.d.ts

@@ -1,5 +1,6 @@
 import formatCapitalise from './formatCapitalise';
 import getCleanFolder from './getCleanFolder';
+import getString from './getString';
 import getStringFromStream from './getStringFromStream';
 export type {};
-export { formatCapitalise, getCleanFolder, getStringFromStream, };
+export { formatCapitalise, getCleanFolder, getString, getStringFromStream, };

package/dist/string/index.js

@@ -3,10 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getStringFromStream = exports.getCleanFolder = exports.formatCapitalise = void 0;
+exports.getStringFromStream = exports.getString = exports.getCleanFolder = exports.formatCapitalise = void 0;
 var formatCapitalise_1 = __importDefault(require("./formatCapitalise"));
 exports.formatCapitalise = formatCapitalise_1.default;
 var getCleanFolder_1 = __importDefault(require("./getCleanFolder"));
 exports.getCleanFolder = getCleanFolder_1.default;
+var getString_1 = __importDefault(require("./getString"));
+exports.getString = getString_1.default;
 var getStringFromStream_1 = __importDefault(require("./getStringFromStream"));
 exports.getStringFromStream = getStringFromStream_1.default;

package/dist/string/toProperCase.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Return a string "With Proper Casing".
+ */
+declare const toProperCase: ({ input }: {
+    input: any;
+}) => string;
+export default toProperCase;

package/dist/string/toProperCase.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var getString_1 = __importDefault(require("./getString"));
+/**
+ * Return a string "With Proper Casing".
+ */
+var toProperCase = function (_a) {
+    var input = _a.input;
+    var preparedInput = (0, getString_1.default)({ input: input });
+    var clean = preparedInput.split('_')
+        .join(' ');
+    return clean.replace(/\w\S*/g, function (word) { return word.charAt(0)
+        .toUpperCase() + word.substr(1)
+        .toLowerCase(); });
+};
+exports.default = toProperCase;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@8ms/helpers",
-  "version": "1.1.17",
+  "version": "1.1.20",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/8millionstories-organisation/8ms-helpers-ts.git"
@@ -25,6 +25,7 @@
     "@types/node": "17.0.23",
     "babel-jest": "27.5.1",
     "crypto-js": "4.1.1",
+    "date-fns-tz": "1.3.3",
     "jest": "27.5.1",
     "ts-node": "10.7.0",
     "tslib": "2.3.1",