@8ms/helpers 1.42.3 → 1.42.6

package/dist/number/getDivide.cjs

@@ -0,0 +1,17 @@
+const require_number_getNumber = require("./getNumber.cjs");
+const require_number_getDecimal = require("./getDecimal.cjs");
+//#region src/number/getDivide.ts
+/**
+* Shorthand function to divide number, but fallback if the divisor is 0.
+*/
+const getDivide = (props) => {
+	const numeratorInt = require_number_getNumber({ input: props.numerator });
+	const divisorInt = require_number_getNumber({ input: props.divisor });
+	if (0 === divisorInt) return props.defaultValue || 0;
+	return require_number_getDecimal({
+		dp: props?.dp,
+		input: numeratorInt / divisorInt
+	});
+};
+//#endregion
+module.exports = getDivide;

package/dist/number/getDivide.d.cts

@@ -0,0 +1,12 @@
+//#region src/number/getDivide.d.ts
+type GetDivide = {
+  defaultValue?: number;
+  dp?: number;
+  divisor: any;
+  numerator: any;
+};
+/**
+ * Shorthand function to divide number, but fallback if the divisor is 0.
+ */
+declare const getDivide: (props: GetDivide) => number;
+export = getDivide;

package/dist/number/getDivide.d.mts

@@ -0,0 +1,13 @@
+//#region src/number/getDivide.d.ts
+type GetDivide = {
+  defaultValue?: number;
+  dp?: number;
+  divisor: any;
+  numerator: any;
+};
+/**
+ * Shorthand function to divide number, but fallback if the divisor is 0.
+ */
+declare const getDivide: (props: GetDivide) => number;
+//#endregion
+export { getDivide as default };

package/dist/number/getDivide.mjs

@@ -0,0 +1,17 @@
+import getNumber from "./getNumber.mjs";
+import getDecimal from "./getDecimal.mjs";
+//#region src/number/getDivide.ts
+/**
+* Shorthand function to divide number, but fallback if the divisor is 0.
+*/
+const getDivide = (props) => {
+	const numeratorInt = getNumber({ input: props.numerator });
+	const divisorInt = getNumber({ input: props.divisor });
+	if (0 === divisorInt) return props.defaultValue || 0;
+	return getDecimal({
+		dp: props?.dp,
+		input: numeratorInt / divisorInt
+	});
+};
+//#endregion
+export { getDivide as default };

package/dist/number/getNumber.cjs

@@ -0,0 +1,23 @@
+const require_json_isJson = require("../json/isJson.cjs");
+//#region src/number/getNumber.ts
+/**
+* Take an input and return a number.
+*/
+const getNumber = ({ defaultValue = 0, input = "" }) => {
+	const actualDefaultValue = defaultValue || 0;
+	let response = input;
+	if (require_json_isJson({ input })) if ("string" === typeof input) response = JSON.parse(input);
+	else response = input;
+	if ("number" === typeof response) response = response;
+	else if ("string" === typeof response) {
+		response = Number(response);
+		if (isNaN(response)) {
+			const match = RegExp(/^\D*([0-9\.]*)\D*$/, "g").exec(input);
+			if (match.length) response = Number(match[1]);
+		}
+	} else response = Number(response);
+	if (isNaN(response)) response = actualDefaultValue;
+	return response;
+};
+//#endregion
+module.exports = getNumber;

package/dist/number/getNumber.d.cts

@@ -0,0 +1,12 @@
+//#region src/number/getNumber.d.ts
+/**
+ * Take an input and return a number.
+ */
+declare const getNumber: ({
+  defaultValue,
+  input
+}: {
+  defaultValue?: number;
+  input: any;
+}) => number;
+export = getNumber;

package/dist/number/getNumber.d.mts

@@ -0,0 +1,13 @@
+//#region src/number/getNumber.d.ts
+/**
+ * Take an input and return a number.
+ */
+declare const getNumber: ({
+  defaultValue,
+  input
+}: {
+  defaultValue?: number;
+  input: any;
+}) => number;
+//#endregion
+export { getNumber as default };

package/dist/number/getNumber.mjs

@@ -0,0 +1,23 @@
+import isJson from "../json/isJson.mjs";
+//#region src/number/getNumber.ts
+/**
+* Take an input and return a number.
+*/
+const getNumber = ({ defaultValue = 0, input = "" }) => {
+	const actualDefaultValue = defaultValue || 0;
+	let response = input;
+	if (isJson({ input })) if ("string" === typeof input) response = JSON.parse(input);
+	else response = input;
+	if ("number" === typeof response) response = response;
+	else if ("string" === typeof response) {
+		response = Number(response);
+		if (isNaN(response)) {
+			const match = RegExp(/^\D*([0-9\.]*)\D*$/, "g").exec(input);
+			if (match.length) response = Number(match[1]);
+		}
+	} else response = Number(response);
+	if (isNaN(response)) response = actualDefaultValue;
+	return response;
+};
+//#endregion
+export { getNumber as default };

package/dist/number/getPercentIncrease.cjs

@@ -0,0 +1,13 @@
+const require_number_getNumber = require("./getNumber.cjs");
+//#region src/number/getPercentIncrease.ts
+/**
+* Formula to work out the percentage increase/decrease.
+*/
+const getPercentageIncrease = ({ comparison, current, defaultValue }) => {
+	const currentValue = require_number_getNumber({ input: current });
+	const comparisonValue = require_number_getNumber({ input: comparison });
+	if (0 === comparisonValue) return defaultValue;
+	return (currentValue - comparisonValue) / comparisonValue * 100;
+};
+//#endregion
+module.exports = getPercentageIncrease;

package/dist/number/getPercentIncrease.d.cts

@@ -0,0 +1,15 @@
+//#region src/number/getPercentIncrease.d.ts
+type GetPercentageIncrease = {
+  comparison: any;
+  current: any;
+  defaultValue: number;
+};
+/**
+ * Formula to work out the percentage increase/decrease.
+ */
+declare const getPercentageIncrease: ({
+  comparison,
+  current,
+  defaultValue
+}: GetPercentageIncrease) => number;
+export = getPercentageIncrease;

package/dist/number/getPercentIncrease.d.mts

@@ -0,0 +1,16 @@
+//#region src/number/getPercentIncrease.d.ts
+type GetPercentageIncrease = {
+  comparison: any;
+  current: any;
+  defaultValue: number;
+};
+/**
+ * Formula to work out the percentage increase/decrease.
+ */
+declare const getPercentageIncrease: ({
+  comparison,
+  current,
+  defaultValue
+}: GetPercentageIncrease) => number;
+//#endregion
+export { getPercentageIncrease as default };

package/dist/number/getPercentIncrease.mjs

@@ -0,0 +1,13 @@
+import getNumber from "./getNumber.mjs";
+//#region src/number/getPercentIncrease.ts
+/**
+* Formula to work out the percentage increase/decrease.
+*/
+const getPercentageIncrease = ({ comparison, current, defaultValue }) => {
+	const currentValue = getNumber({ input: current });
+	const comparisonValue = getNumber({ input: comparison });
+	if (0 === comparisonValue) return defaultValue;
+	return (currentValue - comparisonValue) / comparisonValue * 100;
+};
+//#endregion
+export { getPercentageIncrease as default };

package/dist/object/replaceKeys.cjs

@@ -0,0 +1,27 @@
+//#region src/object/replaceKeys.ts
+/**
+* Iteratively replace all the keys in an object.
+* https://www.techighness.com/post/replace-all-keys-of-deeply-nested-objects-or-array-of-objects/
+*/
+const replaceKeys = ({ instance, getNewKey }) => {
+	let response = instance;
+	if (Array.isArray(instance)) {
+		response = [];
+		for (let i = 0; i < instance.length; i++) response[i] = replaceKeys({
+			instance: instance[i],
+			getNewKey
+		});
+	} else if ("object" === typeof instance) {
+		response = {};
+		for (const key in instance) {
+			const newKey = getNewKey(key);
+			response[newKey] = replaceKeys({
+				instance: instance[key],
+				getNewKey
+			});
+		}
+	}
+	return response;
+};
+//#endregion
+module.exports = replaceKeys;

package/dist/object/replaceKeys.d.cts

@@ -0,0 +1,14 @@
+//#region src/object/replaceKeys.d.ts
+type ReplaceKeys = {
+  instance: any;
+  getNewKey: Function;
+};
+/**
+ * Iteratively replace all the keys in an object.
+ * https://www.techighness.com/post/replace-all-keys-of-deeply-nested-objects-or-array-of-objects/
+ */
+declare const replaceKeys: ({
+  instance,
+  getNewKey
+}: ReplaceKeys) => object;
+export = replaceKeys;

package/dist/object/replaceKeys.d.mts

@@ -0,0 +1,15 @@
+//#region src/object/replaceKeys.d.ts
+type ReplaceKeys = {
+  instance: any;
+  getNewKey: Function;
+};
+/**
+ * Iteratively replace all the keys in an object.
+ * https://www.techighness.com/post/replace-all-keys-of-deeply-nested-objects-or-array-of-objects/
+ */
+declare const replaceKeys: ({
+  instance,
+  getNewKey
+}: ReplaceKeys) => object;
+//#endregion
+export { replaceKeys as default };

package/dist/object/replaceKeys.mjs

@@ -0,0 +1,27 @@
+//#region src/object/replaceKeys.ts
+/**
+* Iteratively replace all the keys in an object.
+* https://www.techighness.com/post/replace-all-keys-of-deeply-nested-objects-or-array-of-objects/
+*/
+const replaceKeys = ({ instance, getNewKey }) => {
+	let response = instance;
+	if (Array.isArray(instance)) {
+		response = [];
+		for (let i = 0; i < instance.length; i++) response[i] = replaceKeys({
+			instance: instance[i],
+			getNewKey
+		});
+	} else if ("object" === typeof instance) {
+		response = {};
+		for (const key in instance) {
+			const newKey = getNewKey(key);
+			response[newKey] = replaceKeys({
+				instance: instance[key],
+				getNewKey
+			});
+		}
+	}
+	return response;
+};
+//#endregion
+export { replaceKeys as default };

package/dist/prisma/getDecimal.cjs

@@ -0,0 +1,19 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_number_getDecimal = require("../number/getDecimal.cjs");
+let lodash_isArray_js = require("lodash/isArray.js");
+lodash_isArray_js = require_runtime.__toESM(lodash_isArray_js);
+//#region src/prisma/getDecimal.ts
+/**
+* Fetch the number from a prisma decimal (comes through as an object).
+*/
+const getDecimal = (props) => {
+	let numberString = "";
+	if ((0, lodash_isArray_js.default)(props?.input?.d)) numberString = props.input.absoluteValue();
+	else numberString = props?.input.toString();
+	return require_number_getDecimal({
+		input: numberString,
+		dp: props?.dp
+	});
+};
+//#endregion
+module.exports = getDecimal;

package/dist/prisma/getDecimal.d.cts

@@ -0,0 +1,10 @@
+//#region src/prisma/getDecimal.d.ts
+type GetDecimal = {
+  input: any;
+  dp?: number;
+};
+/**
+ * Fetch the number from a prisma decimal (comes through as an object).
+ */
+declare const getDecimal: (props: GetDecimal) => number;
+export = getDecimal;

package/dist/prisma/getDecimal.d.mts

@@ -0,0 +1,11 @@
+//#region src/prisma/getDecimal.d.ts
+type GetDecimal = {
+  input: any;
+  dp?: number;
+};
+/**
+ * Fetch the number from a prisma decimal (comes through as an object).
+ */
+declare const getDecimal: (props: GetDecimal) => number;
+//#endregion
+export { getDecimal as default };

package/dist/prisma/getDecimal.mjs

@@ -0,0 +1,17 @@
+import getDecimal$1 from "../number/getDecimal.mjs";
+import isArray from "lodash/isArray.js";
+//#region src/prisma/getDecimal.ts
+/**
+* Fetch the number from a prisma decimal (comes through as an object).
+*/
+const getDecimal = (props) => {
+	let numberString = "";
+	if (isArray(props?.input?.d)) numberString = props.input.absoluteValue();
+	else numberString = props?.input.toString();
+	return getDecimal$1({
+		input: numberString,
+		dp: props?.dp
+	});
+};
+//#endregion
+export { getDecimal as default };

package/dist/prisma/initClient.cjs

@@ -0,0 +1,24 @@
+//#region src/prisma/initClient.ts
+global.prisma = null;
+const initClient = (props = {}) => {
+	if (!global.prisma) {
+		const { PrismaClient } = require("@prisma/client");
+		let adapter = null;
+		if (true === props?.planetScale) {
+			const { Client } = require("@planetscale/database");
+			const client = new Client({ url: process.env.DATABASE_URL });
+			const { PrismaPlanetScale } = require("@prisma/adapter-planetscale");
+			adapter = new PrismaPlanetScale(client);
+		}
+		if (true === props?.debug) global.prisma = new PrismaClient({
+			adapter,
+			log: [{
+				emit: "event",
+				level: "query"
+			}]
+		});
+		else global.prisma = new PrismaClient({ adapter });
+	}
+};
+//#endregion
+module.exports = initClient;

package/dist/prisma/initClient.d.cts

@@ -0,0 +1,7 @@
+//#region src/prisma/initClient.d.ts
+type InitClient = {
+  debug?: boolean;
+  planetScale?: boolean;
+};
+declare const initClient: (props?: InitClient) => void;
+export = initClient;

package/dist/prisma/initClient.d.mts

@@ -0,0 +1,8 @@
+//#region src/prisma/initClient.d.ts
+type InitClient = {
+  debug?: boolean;
+  planetScale?: boolean;
+};
+declare const initClient: (props?: InitClient) => void;
+//#endregion
+export { initClient as default };

package/dist/prisma/initClient.mjs

@@ -0,0 +1,25 @@
+import { __require } from "../_virtual/_rolldown/runtime.mjs";
+//#region src/prisma/initClient.ts
+global.prisma = null;
+const initClient = (props = {}) => {
+	if (!global.prisma) {
+		const { PrismaClient } = __require("@prisma/client");
+		let adapter = null;
+		if (true === props?.planetScale) {
+			const { Client } = __require("@planetscale/database");
+			const client = new Client({ url: process.env.DATABASE_URL });
+			const { PrismaPlanetScale } = __require("@prisma/adapter-planetscale");
+			adapter = new PrismaPlanetScale(client);
+		}
+		if (true === props?.debug) global.prisma = new PrismaClient({
+			adapter,
+			log: [{
+				emit: "event",
+				level: "query"
+			}]
+		});
+		else global.prisma = new PrismaClient({ adapter });
+	}
+};
+//#endregion
+export { initClient as default };

package/dist/snapchat/getAccessToken.cjs

@@ -0,0 +1,29 @@
+const require_aws_ssm_getParameter = require("../aws/ssm/getParameter.cjs");
+const require_axios_post = require("../axios/post.cjs");
+//#region src/snapchat/getAccessToken.ts
+global.snapchatAccessToken = null;
+/**
+* Renew the access token as it expires every 3 hours.
+*/
+const getAccessToken = async ({ force, parameterName }) => {
+	if (!global.snapchatAccessToken || force) {
+		const parameter = await require_aws_ssm_getParameter({
+			name: parameterName,
+			withDecryption: true,
+			isJson: true
+		});
+		let url = `https://accounts.snapchat.com/login/oauth2/access_token`;
+		url += `?client_id=${parameter.clientId}`;
+		url += `&client_secret=${parameter.clientSecret}`;
+		url += `&grant_type=refresh_token`;
+		url += `&refresh_token=${parameter.refreshToken}`;
+		const apiResponse = await require_axios_post({ url });
+		if (apiResponse.isSuccess()) global.snapchatAccessToken = apiResponse.getBodyDefaultTo({
+			defaultValue: null,
+			keys: ["data", "access_token"]
+		});
+	}
+	return global.snapchatAccessToken;
+};
+//#endregion
+module.exports = getAccessToken;

package/dist/snapchat/getAccessToken.d.cts

@@ -0,0 +1,13 @@
+//#region src/snapchat/getAccessToken.d.ts
+type GetAccessToken = {
+  force?: boolean;
+  parameterName: string;
+};
+/**
+ * Renew the access token as it expires every 3 hours.
+ */
+declare const getAccessToken: ({
+  force,
+  parameterName
+}: GetAccessToken) => Promise<void>;
+export = getAccessToken;

package/dist/snapchat/getAccessToken.d.mts

@@ -0,0 +1,14 @@
+//#region src/snapchat/getAccessToken.d.ts
+type GetAccessToken = {
+  force?: boolean;
+  parameterName: string;
+};
+/**
+ * Renew the access token as it expires every 3 hours.
+ */
+declare const getAccessToken: ({
+  force,
+  parameterName
+}: GetAccessToken) => Promise<void>;
+//#endregion
+export { getAccessToken as default };

package/dist/snapchat/getAccessToken.mjs

@@ -0,0 +1,29 @@
+import getParameter from "../aws/ssm/getParameter.mjs";
+import post from "../axios/post.mjs";
+//#region src/snapchat/getAccessToken.ts
+global.snapchatAccessToken = null;
+/**
+* Renew the access token as it expires every 3 hours.
+*/
+const getAccessToken = async ({ force, parameterName }) => {
+	if (!global.snapchatAccessToken || force) {
+		const parameter = await getParameter({
+			name: parameterName,
+			withDecryption: true,
+			isJson: true
+		});
+		let url = `https://accounts.snapchat.com/login/oauth2/access_token`;
+		url += `?client_id=${parameter.clientId}`;
+		url += `&client_secret=${parameter.clientSecret}`;
+		url += `&grant_type=refresh_token`;
+		url += `&refresh_token=${parameter.refreshToken}`;
+		const apiResponse = await post({ url });
+		if (apiResponse.isSuccess()) global.snapchatAccessToken = apiResponse.getBodyDefaultTo({
+			defaultValue: null,
+			keys: ["data", "access_token"]
+		});
+	}
+	return global.snapchatAccessToken;
+};
+//#endregion
+export { getAccessToken as default };

package/dist/sorting/byNumberAscending.cjs

@@ -0,0 +1,13 @@
+//#region src/sorting/byNumberAscending.ts
+/**
+* Take two values, ensure they are numbers and return the sorting value.
+*/
+const byNumberAscending = ({ valueA, valueB }) => {
+	let valueAClean = Number(valueA);
+	let valueBClean = Number(valueB);
+	if (valueAClean > valueBClean) return 1;
+	if (valueBClean > valueAClean) return -1;
+	return 0;
+};
+//#endregion
+module.exports = byNumberAscending;

package/dist/sorting/byNumberAscending.d.cts

@@ -0,0 +1,12 @@
+//#region src/sorting/byNumberAscending.d.ts
+/**
+ * Take two values, ensure they are numbers and return the sorting value.
+ */
+declare const byNumberAscending: ({
+  valueA,
+  valueB
+}: {
+  valueA: any;
+  valueB: any;
+}) => number;
+export = byNumberAscending;

package/dist/sorting/byNumberAscending.d.mts

@@ -0,0 +1,13 @@
+//#region src/sorting/byNumberAscending.d.ts
+/**
+ * Take two values, ensure they are numbers and return the sorting value.
+ */
+declare const byNumberAscending: ({
+  valueA,
+  valueB
+}: {
+  valueA: any;
+  valueB: any;
+}) => number;
+//#endregion
+export { byNumberAscending as default };

package/dist/sorting/byNumberAscending.mjs

@@ -0,0 +1,13 @@
+//#region src/sorting/byNumberAscending.ts
+/**
+* Take two values, ensure they are numbers and return the sorting value.
+*/
+const byNumberAscending = ({ valueA, valueB }) => {
+	let valueAClean = Number(valueA);
+	let valueBClean = Number(valueB);
+	if (valueAClean > valueBClean) return 1;
+	if (valueBClean > valueAClean) return -1;
+	return 0;
+};
+//#endregion
+export { byNumberAscending as default };

package/dist/sorting/byNumberDescending.cjs

@@ -0,0 +1,13 @@
+//#region src/sorting/byNumberDescending.ts
+/**
+* Take two values, ensure they are numbers and return the sorting value.
+*/
+const byNumberDescending = ({ valueA, valueB }) => {
+	let valueAClean = Number(valueA);
+	let valueBClean = Number(valueB);
+	if (valueAClean > valueBClean) return -1;
+	if (valueBClean > valueAClean) return 1;
+	return 0;
+};
+//#endregion
+module.exports = byNumberDescending;

package/dist/sorting/byNumberDescending.d.cts

@@ -0,0 +1,12 @@
+//#region src/sorting/byNumberDescending.d.ts
+/**
+ * Take two values, ensure they are numbers and return the sorting value.
+ */
+declare const byNumberDescending: ({
+  valueA,
+  valueB
+}: {
+  valueA: any;
+  valueB: any;
+}) => number;
+export = byNumberDescending;

package/dist/sorting/byNumberDescending.d.mts

@@ -0,0 +1,13 @@
+//#region src/sorting/byNumberDescending.d.ts
+/**
+ * Take two values, ensure they are numbers and return the sorting value.
+ */
+declare const byNumberDescending: ({
+  valueA,
+  valueB
+}: {
+  valueA: any;
+  valueB: any;
+}) => number;
+//#endregion
+export { byNumberDescending as default };

package/dist/sorting/byNumberDescending.mjs

@@ -0,0 +1,13 @@
+//#region src/sorting/byNumberDescending.ts
+/**
+* Take two values, ensure they are numbers and return the sorting value.
+*/
+const byNumberDescending = ({ valueA, valueB }) => {
+	let valueAClean = Number(valueA);
+	let valueBClean = Number(valueB);
+	if (valueAClean > valueBClean) return -1;
+	if (valueBClean > valueAClean) return 1;
+	return 0;
+};
+//#endregion
+export { byNumberDescending as default };

package/dist/sorting/byStringAscending.cjs

@@ -0,0 +1,13 @@
+//#region src/sorting/byStringAscending.ts
+/**
+* Take two values, clean the strings and return the sorting value.
+*/
+const byStringAscending = ({ valueA, valueB }) => {
+	let valueAClean = valueA.trim().toLowerCase();
+	let valueBClean = valueB.trim().toLowerCase();
+	if (valueAClean > valueBClean) return 1;
+	if (valueBClean > valueAClean) return -1;
+	return 0;
+};
+//#endregion
+module.exports = byStringAscending;

package/dist/sorting/byStringAscending.d.cts

@@ -0,0 +1,12 @@
+//#region src/sorting/byStringAscending.d.ts
+/**
+ * Take two values, clean the strings and return the sorting value.
+ */
+declare const byStringAscending: ({
+  valueA,
+  valueB
+}: {
+  valueA: any;
+  valueB: any;
+}) => number;
+export = byStringAscending;