@8ms/helpers 2.3.26 → 2.3.27

package/dist/nextJs/index.d.mts

@@ -0,0 +1,19 @@
+//#region src/nextJs/nextJs.d.ts
+/**
+ * Get the user's remote IP Address
+ */
+declare const getIp: ({
+  req
+}: {
+  req: any;
+}) => string;
+/**
+ * Get the user's User Agent
+ */
+declare const getUserAgent: ({
+  req
+}: {
+  req: any;
+}) => string;
+//#endregion
+export { getIp, getUserAgent };

package/dist/nextJs/index.mjs

@@ -0,0 +1,12 @@
+//#region src/nextJs/nextJs.ts
+/**
+* Get the user's remote IP Address
+*/
+const getIp = ({ req }) => String(req.headers?.["x-real-ip"] || "unset");
+/**
+* Get the user's User Agent
+*/
+const getUserAgent = ({ req }) => String(req.headers["user-agent"] || "unset");
+
+//#endregion
+export { getIp, getUserAgent };

package/dist/number/index.d.mts

@@ -0,0 +1,54 @@
+//#region src/number/format.d.ts
+type FormatProps = {
+  compact?: boolean;
+  input: any;
+  locale?: string;
+  minDp?: number;
+  maxDp?: number;
+};
+/**
+ * Take a given number and format it.
+ */
+declare const format: (props: FormatProps) => string;
+//#endregion
+//#region src/number/formatCurrency.d.ts
+/**
+ * Use the International number formatting to return the currency value.
+ * https://www.freecodecamp.org/news/how-to-format-number-as-currency-in-javascript-one-line-of-code/
+ */
+declare const formatCurrency: (input: any, locale?: string, currency?: string) => string;
+//#endregion
+//#region src/number/getDecimal.d.ts
+/**
+ * Return a decimal number after rounding.
+ */
+declare const getDecimal: (input: any, dp?: number) => number;
+//#endregion
+//#region src/number/getSafeDivide.d.ts
+type GetSafeDivideProps = {
+  defaultValue?: number;
+  dp?: number;
+  divisor: any;
+  numerator: any;
+};
+/**
+ * Shorthand function to divide number, but fallback if the divisor is 0.
+ */
+declare const getSafeDivide: (props: GetSafeDivideProps) => number;
+//#endregion
+//#region src/number/getPercent.d.ts
+declare const getPercent: (numerator: any, divisor: any, dp?: number) => number;
+//#endregion
+//#region src/number/getNumber.d.ts
+/**
+ * Take an input and return a number.
+ */
+declare const getNumber: (input: any, defaultValue?: number) => number;
+//#endregion
+//#region src/number/getPercentIncrease.d.ts
+/**
+ * Formula to work out the percentage increase/decrease.
+ */
+declare const getPercentIncrease: (current: any, comparison: any, defaultValue: number) => number;
+//#endregion
+export { format, formatCurrency, getDecimal, getNumber, getPercent, getPercentIncrease, getSafeDivide };

package/dist/number/index.mjs

@@ -0,0 +1,75 @@
+import { n as getNumber, t as getDecimal } from "../getDecimal-CafxtLhH.mjs";
+
+//#region src/number/format.ts
+/**
+* Take a given number and format it.
+*/
+const format = (props) => {
+	const minDp = props?.minDp ?? 0;
+	const maxDp = props?.maxDp ?? 2;
+	const compact = props?.compact || false;
+	const inputValue = getNumber(props.input);
+	return Intl.NumberFormat(props?.locale || "en-GB", {
+		minimumFractionDigits: minDp,
+		maximumFractionDigits: maxDp,
+		notation: compact ? "compact" : "standard"
+	}).format(inputValue);
+};
+
+//#endregion
+//#region src/number/formatCurrency.ts
+/**
+* Use the International number formatting to return the currency value.
+* https://www.freecodecamp.org/news/how-to-format-number-as-currency-in-javascript-one-line-of-code/
+*/
+const formatCurrency = (input, locale = "en-GB", currency = "GBP") => {
+	const value = Number(input);
+	const currencyClean = currency.toUpperCase().trim();
+	let formatted = new Intl.NumberFormat(locale, {
+		style: "currency",
+		currency: currencyClean
+	}).format(value);
+	if ("USD" === currencyClean) formatted = formatted.replace("US$", "$");
+	return formatted;
+};
+
+//#endregion
+//#region src/number/getSafeDivide.ts
+/**
+* Shorthand function to divide number, but fallback if the divisor is 0.
+*/
+const getSafeDivide = (props) => {
+	const numeratorInt = getNumber(props.numerator);
+	if (numeratorInt === 0) return 0;
+	const divisorInt = getNumber(props.divisor);
+	if (divisorInt === 0 || !Number.isFinite(divisorInt)) return props?.defaultValue ?? 0;
+	return getDecimal(numeratorInt / divisorInt, props?.dp);
+};
+
+//#endregion
+//#region src/number/getPercent.ts
+const getPercent = (numerator, divisor, dp) => {
+	const finalNumerator = Number(numerator);
+	const finalDivisor = Number(divisor);
+	const finalDp = Number(dp || 1);
+	return Number((getSafeDivide({
+		defaultValue: 0,
+		numerator: finalNumerator,
+		divisor: finalDivisor
+	}) * 100).toFixed(finalDp));
+};
+
+//#endregion
+//#region src/number/getPercentIncrease.ts
+/**
+* Formula to work out the percentage increase/decrease.
+*/
+const getPercentIncrease = (current, comparison, defaultValue) => {
+	const currentValue = getNumber(current);
+	const comparisonValue = getNumber(comparison);
+	if (0 === comparisonValue) return defaultValue;
+	return (currentValue - comparisonValue) / comparisonValue * 100;
+};
+
+//#endregion
+export { format, formatCurrency, getDecimal, getNumber, getPercent, getPercentIncrease, getSafeDivide };

package/dist/object/index.d.mts

@@ -0,0 +1,8 @@
+//#region src/object/replaceKeys.d.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/
+ */
+declare const replaceKeys: (instance: any, getNewKey: Function) => object;
+//#endregion
+export { replaceKeys };

package/dist/object/index.mjs

@@ -0,0 +1,22 @@
+//#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.Array.isArray(instance)) {
+		response = [];
+		for (let i = 0; i < instance.length; i++) response[i] = replaceKeys(instance[i], getNewKey);
+	} else if ("object" === typeof instance) {
+		response = {};
+		for (const key in instance) {
+			const newKey = getNewKey(key);
+			response[newKey] = replaceKeys(instance[key], getNewKey);
+		}
+	}
+	return response;
+};
+
+//#endregion
+export { replaceKeys };

package/dist/onePassword/server/index.d.mts

@@ -0,0 +1,24 @@
+import { t as BaseNamespace } from "../../index-DwB8X1lz.mjs";
+import * as _1password_sdk0 from "@1password/sdk";
+import { Client } from "@1password/sdk";
+
+//#region src/onePassword/server/OnePasswordNamespace.d.ts
+declare class OnePasswordNamespace extends BaseNamespace {
+  client: Client;
+  config: OnePasswordConfig;
+  ensureInit: () => Promise<void>;
+  listVaults: () => Promise<_1password_sdk0.VaultOverview[]>;
+  getItem: (vaultId: string, itemId: string) => Promise<_1password_sdk0.Item>;
+  getJsonNote: (vaultId: string, itemId: string) => Promise<any>;
+  listItems: (vaultId: string) => Promise<_1password_sdk0.ItemOverview[]>;
+}
+//#endregion
+//#region src/onePassword/server/onePassword.d.ts
+type OnePasswordConfig = {
+  serviceAccountToken: string;
+  integrationName?: string;
+  integrationVersion?: string;
+};
+declare const onePasswordClient: (key?: string, config?: OnePasswordConfig) => Promise<OnePasswordNamespace>;
+//#endregion
+export { OnePasswordConfig, type OnePasswordNamespace, onePasswordClient };

package/dist/onePassword/server/index.mjs

@@ -0,0 +1,50 @@
+import { BaseNamespace } from "../../_class/index.mjs";
+
+//#region src/onePassword/server/OnePasswordNamespace.ts
+var OnePasswordNamespace = class extends BaseNamespace {
+	ensureInit = async () => {
+		if (!this.client) try {
+			const { createClient } = await import("@1password/sdk");
+			this.client = await createClient({
+				auth: this.config.serviceAccountToken,
+				integrationName: this.config.integrationName || "8MS Helper TS",
+				integrationVersion: this.config.integrationVersion || "v1.0.0"
+			});
+		} catch (e) {
+			throw new Error("1Password SDK not installed");
+		}
+	};
+	listVaults = async () => {
+		await this.ensureInit();
+		return this.client.vaults.list();
+	};
+	getItem = async (vaultId, itemId) => {
+		await this.ensureInit();
+		return this.client.items.get(vaultId, itemId);
+	};
+	getJsonNote = async (vaultId, itemId) => {
+		let response = null;
+		const item = await this.getItem(vaultId, itemId);
+		if (item && "undefined" !== typeof item.notes) response = JSON.parse(item.notes);
+		return response;
+	};
+	listItems = async (vaultId) => {
+		await this.ensureInit();
+		return this.client.items.list(vaultId);
+	};
+};
+
+//#endregion
+//#region src/onePassword/server/onePassword.ts
+const onePasswordNamespaces = /* @__PURE__ */ new Map();
+const onePasswordClient = async (key = "default", config) => {
+	if (onePasswordNamespaces.has(key)) return onePasswordNamespaces.get(key);
+	if (!config) if (key === "default") config = { serviceAccountToken: process.env.ONEPASSWORD_SERVICE_TOKEN };
+	else throw new Error(`Config required for namespace '${key}'`);
+	const namespace = new OnePasswordNamespace(key, config);
+	onePasswordNamespaces.set(key, namespace);
+	return namespace;
+};
+
+//#endregion
+export { OnePasswordNamespace, onePasswordClient };

package/dist/openAi/server/index.d.mts

@@ -0,0 +1,20 @@
+import { t as BaseNamespace } from "../../index-DwB8X1lz.mjs";
+
+//#region src/openAi/server/OpenAiNamespace.d.ts
+declare class OpenAiNamespace extends BaseNamespace {
+  client: boolean;
+  config: OpenAiConfig;
+  /**
+   * Renew the access token as it expires every 3 hours.
+   */
+  ensureInit: () => Promise<void>;
+  completion: (prompt: string, temperature?: number, maxTokens?: number, model?: string) => Promise<any>;
+}
+//#endregion
+//#region src/openAi/server/openAi.d.ts
+type OpenAiConfig = {
+  apiKey: string;
+};
+declare const openAiClient: (key?: string, config?: OpenAiConfig, vaultId?: string, itemId?: string) => Promise<OpenAiNamespace>;
+//#endregion
+export { OpenAiConfig, type OpenAiNamespace, openAiClient };

package/dist/openAi/server/index.mjs

@@ -0,0 +1,46 @@
+import { BaseNamespace } from "../../_class/index.mjs";
+import "../../api-DGKJDAfb.mjs";
+import { post } from "../../axios/index.mjs";
+import { onePasswordClient } from "../../onePassword/server/index.mjs";
+
+//#region src/openAi/server/OpenAiNamespace.ts
+var OpenAiNamespace = class extends BaseNamespace {
+	/**
+	* Renew the access token as it expires every 3 hours.
+	*/
+	ensureInit = async () => {
+		if (!this.client) this.client = true;
+	};
+	completion = async (prompt, temperature = 1, maxTokens = null, model = "gpt-3.5-turbo") => {
+		let response = null;
+		const apiResponse = await post(`https://api.openai.com/v1/chat/completions`, {
+			max_tokens: maxTokens,
+			model,
+			messages: [{
+				role: "user",
+				content: prompt
+			}],
+			temperature: 1
+		}, { headers: { Authorization: `Bearer ${this.config.apiKey}` } });
+		if (apiResponse.isSuccess()) response = apiResponse.getBody();
+		return response;
+	};
+};
+
+//#endregion
+//#region src/openAi/server/openAi.ts
+const openAiNamespaces = /* @__PURE__ */ new Map();
+const openAiClient = async (key = "default", config, vaultId, itemId) => {
+	if (openAiNamespaces.has(key)) return openAiNamespaces.get(key);
+	let instanceConfig;
+	if (config) instanceConfig = config;
+	else if (vaultId && itemId) instanceConfig = await (await onePasswordClient()).getJsonNote(vaultId, itemId);
+	else if (process.env.OPEN_AI_VAULT_ID && process.env.OPEN_AI_ITEM_ID) instanceConfig = await (await onePasswordClient()).getJsonNote(process.env.OPEN_AI_VAULT_ID, process.env.OPEN_AI_ITEM_ID);
+	else throw new Error(`Config required for namespace '${key}'`);
+	const namespace = new OpenAiNamespace(key, instanceConfig);
+	openAiNamespaces.set(key, namespace);
+	return namespace;
+};
+
+//#endregion
+export { OpenAiNamespace, openAiClient };

package/dist/prisma/index.d.mts

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

package/dist/prisma/index.mjs

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

package/dist/prisma/server/index.d.mts

@@ -0,0 +1,31 @@
+import { t as BaseNamespace } from "../../index-DwB8X1lz.mjs";
+
+//#region src/prisma/server/PrismaNamespace.d.ts
+declare class PrismaNamespace extends BaseNamespace {
+  client: PrismaClientLike;
+  config: PrismaConfig;
+  ensureInit: () => Promise<void>;
+}
+//#endregion
+//#region src/prisma/server/prisma.d.ts
+type PrismaConfig = {
+  url: string;
+  isDebug: boolean;
+  isPlanetScale: boolean;
+  isMysql: boolean;
+  isPostgres: boolean;
+};
+/**
+ * Minimal interface representing a Prisma Client instance.
+ * Consumers of this library will have their own generated PrismaClient
+ * that satisfies this interface.
+ */
+interface PrismaClientLike {
+  $connect(): Promise<void>;
+  $disconnect(): Promise<void>;
+  $transaction(...args: any[]): Promise<any>;
+  [key: string]: any;
+}
+declare const prismaClient: (key?: string, config?: PrismaConfig) => Promise<PrismaNamespace>;
+//#endregion
+export { PrismaClientLike, PrismaConfig, PrismaNamespace, prismaClient };

package/dist/prisma/server/index.mjs

@@ -0,0 +1,64 @@
+import { getError } from "../../util/index.mjs";
+import { BaseNamespace } from "../../_class/index.mjs";
+
+//#region src/prisma/server/PrismaNamespace.ts
+var PrismaNamespace = class extends BaseNamespace {
+	ensureInit = async () => {
+		if (!this.client) {
+			let adapter = null;
+			if (this.config.isPlanetScale) try {
+				const { PrismaPlanetScale } = await import("@prisma/adapter-planetscale");
+				adapter = new PrismaPlanetScale({ url: this.config.url });
+			} catch (e) {
+				throw new Error(`PlanetScale adapter not installed - ${getError(e)}`);
+			}
+			if (this.config.isMysql) try {
+				const { PrismaMariaDb } = await import("@prisma/adapter-mariadb");
+				adapter = new PrismaMariaDb(this.config.url);
+			} catch (e) {
+				throw new Error(`MariaDB adapter not installed - ${getError(e)}`);
+			}
+			if (this.config.isPostgres) try {
+				const { PrismaPg } = await import("@prisma/adapter-pg");
+				adapter = new PrismaPg({ connectionString: process.env.DATABASE_URL });
+			} catch (e) {
+				throw new Error(`Postgres adapter not installed - ${getError(e)}`);
+			}
+			try {
+				const { PrismaClient } = await import("@prisma/client");
+				if (this.config.isDebug) this.client = new PrismaClient({
+					adapter,
+					log: [{
+						emit: "event",
+						level: "query"
+					}]
+				});
+				else this.client = new PrismaClient({ adapter });
+			} catch (e) {
+				throw new Error(`Prisma Client not installed - ${getError(e)}`);
+			}
+		}
+	};
+};
+
+//#endregion
+//#region src/prisma/server/prisma.ts
+const prismaNamespaces = /* @__PURE__ */ new Map();
+const prismaClient = async (key = "default", config) => {
+	if (prismaNamespaces.has(key)) return prismaNamespaces.get(key);
+	if (!config) if (key === "default") config = {
+		url: process.env.DATABASE_URL,
+		isDebug: "true" === process.env.DATABASE_IS_DEBUG,
+		isPlanetScale: "true" === process.env.DATABASE_IS_PLANETSCALE,
+		isMysql: "true" === process.env.DATABASE_IS_MYSQL,
+		isPostgres: "true" === process.env.DATABASE_IS_POSTGRES
+	};
+	else throw new Error(`Config required for namespace '${key}'`);
+	const namespace = new PrismaNamespace(key, config);
+	await namespace.ensureInit();
+	prismaNamespaces.set(key, namespace);
+	return namespace;
+};
+
+//#endregion
+export { PrismaNamespace, prismaClient };

package/dist/server-Bwy4JI8Z.mjs

@@ -0,0 +1,33 @@
+import { defaultTo } from "./util/index.mjs";
+import { onePasswordClient } from "./onePassword/server/index.mjs";
+
+//#region src/aws/server/isResponse200.ts
+/**
+* Was the API response a 200?
+*/
+const isResponse200 = (apiResponse) => {
+	let response = false;
+	if (200 === defaultTo(apiResponse, ["$metadata", "httpStatusCode"], 0)) response = true;
+	return response;
+};
+
+//#endregion
+//#region src/aws/server/aws.ts
+const getConfig = async (key, config, vaultId, itemId) => {
+	let response;
+	if (config) response = config;
+	else if (vaultId && itemId) response = await (await onePasswordClient()).getJsonNote(vaultId, itemId);
+	else if (process.env.AWS_VAULT_ID && process.env.AWS_ITEM_ID) response = await (await onePasswordClient()).getJsonNote(process.env.AWS_VAULT_ID, process.env.AWS_ITEM_ID);
+	else if (process.env.AWS_ACCESS_KEY_ID && process.env.AWS_REGION && process.env.AWS_SECRET_ACCESS_KEY) response = {
+		region: process.env.AWS_REGION,
+		credentials: {
+			accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+			secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
+		}
+	};
+	else throw new Error(`Config required for namespace '${key}'`);
+	return response;
+};
+
+//#endregion
+export { isResponse200 as n, getConfig as t };

package/dist/snapchat/server/index.d.mts

@@ -0,0 +1,25 @@
+import { t as BaseNamespace } from "../../index-DwB8X1lz.mjs";
+
+//#region src/snapchat/server/SnapchatNamespace.d.ts
+type Client = {
+  expires: number;
+  refreshToken: string;
+};
+declare class SnapchatNamespace extends BaseNamespace {
+  client: Client;
+  config: SnapchatConfig;
+  /**
+   * Renew the access token as it expires every 3 hours.
+   */
+  ensureInit: () => Promise<void>;
+}
+//#endregion
+//#region src/snapchat/server/snapchat.d.ts
+type SnapchatConfig = {
+  clientId: string;
+  clientSecret: string;
+  refreshToken: string;
+};
+declare const snapchatClient: (key?: string, config?: SnapchatConfig, vaultId?: string, itemId?: string) => Promise<SnapchatNamespace>;
+//#endregion
+export { SnapchatConfig, SnapchatNamespace, snapchatClient };

package/dist/snapchat/server/index.mjs

@@ -0,0 +1,39 @@
+import { BaseNamespace } from "../../_class/index.mjs";
+import "../../api-DGKJDAfb.mjs";
+import { post } from "../../axios/index.mjs";
+import { onePasswordClient } from "../../onePassword/server/index.mjs";
+import { DateTime } from "luxon";
+
+//#region src/snapchat/server/SnapchatNamespace.ts
+var SnapchatNamespace = class extends BaseNamespace {
+	/**
+	* Renew the access token as it expires every 3 hours.
+	*/
+	ensureInit = async () => {
+		if (!this.client) {
+			const apiResponse = await post(`https://accounts.snapchat.com/login/oauth2/access_token?client_id=${this.config.clientId}&client_secret=${this.config.clientSecret}&grant_type=refresh_token&refresh_token=${this.config.refreshToken}`);
+			if (apiResponse.isSuccess()) this.client = {
+				expires: DateTime.now().toUnixInteger() + 10800 * 1e3,
+				refreshToken: apiResponse.getBodyDefaultTo(["data", "access_token"], null)
+			};
+		}
+	};
+};
+
+//#endregion
+//#region src/snapchat/server/snapchat.ts
+const snapchatNamespaces = /* @__PURE__ */ new Map();
+const snapchatClient = async (key = "default", config, vaultId, itemId) => {
+	if (snapchatNamespaces.has(key)) return snapchatNamespaces.get(key);
+	let instanceConfig;
+	if (config) instanceConfig = config;
+	else if (vaultId && itemId) instanceConfig = await (await onePasswordClient()).getJsonNote(vaultId, itemId);
+	else if (process.env.SNAPCHAT_VAULT_ID && process.env.SNAPCHAT_ITEM_ID) instanceConfig = await (await onePasswordClient()).getJsonNote(process.env.SNAPCHAT_VAULT_ID, process.env.SNAPCHAT_ITEM_ID);
+	else throw new Error(`Config required for namespace '${key}'`);
+	const namespace = new SnapchatNamespace(key, instanceConfig);
+	snapchatNamespaces.set(key, namespace);
+	return namespace;
+};
+
+//#endregion
+export { SnapchatNamespace, snapchatClient };

package/dist/sorting/index.d.mts

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

package/dist/sorting/index.mjs

@@ -0,0 +1,50 @@
+//#region src/sorting/byNumberAscending.ts
+/**
+* Take two values, ensure they are numbers and return the sorting value.
+*/
+const byNumberAscending = (valueA, valueB) => {
+	const a = Number(valueA);
+	const b = Number(valueB);
+	if (isNaN(a) && isNaN(b)) return 0;
+	if (isNaN(a)) return 1;
+	if (isNaN(b)) return -1;
+	return a - b;
+};
+
+//#endregion
+//#region src/sorting/byNumberDescending.ts
+/**
+* Take two values, ensure they are numbers and return the sorting value.
+*/
+const byNumberDescending = (valueA, valueB) => {
+	const a = Number(valueA);
+	const b = Number(valueB);
+	if (isNaN(a) && isNaN(b)) return 0;
+	if (isNaN(a)) return 1;
+	if (isNaN(b)) return -1;
+	return b - a;
+};
+
+//#endregion
+//#region src/sorting/byStringAscending.ts
+/**
+* Take two values, clean the strings and return the sorting value.
+*/
+const byStringAscending = (valueA, valueB) => {
+	const valueAClean = valueA.toString().trim().toLowerCase();
+	const valueBClean = valueB.toString().trim().toLowerCase();
+	return valueAClean.localeCompare(valueBClean);
+};
+
+//#endregion
+//#region src/sorting/byStringDescending.ts
+/**
+* Take two values, clean the strings and return the sorting value.
+*/
+const byStringDescending = (valueA, valueB) => {
+	const valueAClean = valueA.toString().trim().toLowerCase();
+	return valueB.toString().trim().toLowerCase().localeCompare(valueAClean);
+};
+
+//#endregion
+export { byNumberAscending, byNumberDescending, byStringAscending, byStringDescending };

package/dist/stream/server/index.d.mts

@@ -0,0 +1,15 @@
+//#region src/stream/server/sort.d.ts
+declare const Transform: any;
+/**
+ * Batch sort stream without overloading the memory limit.
+ * https://www.npmjs.com/package/fast-stream-sort
+ */
+declare class SortStreamer extends Transform {
+  constructor(options: any, comp: any);
+  _transform(data: any, _: any, callback: any): void;
+  _flush(): void;
+  fullflush(): void;
+}
+declare const sort: (comp: any, options: any) => SortStreamer;
+//#endregion
+export { sort };