@8ms/helpers 3.0.27 → 3.1.0

package/dist/util/isUndefined.mjs

@@ -5,8 +5,7 @@ const undefinedValue = "__!!UNDEFINED!!__";
 * Check to see if a value is undefined.
 */
 const isUndefined = (instance, keys) => {
-	const value = defaultTo(instance, keys, undefinedValue);
-	return undefinedValue === value;
+	return undefinedValue === defaultTo(instance, keys, undefinedValue);
 };
 //#endregion
 export { isUndefined };

package/dist/util/promiseChunks.d.cts

@@ -3,6 +3,5 @@
  * Chunk a queue of promises into controlled chunks to prevent overloading.
  * https://stackoverflow.com/a/53964407
  */
-declare const promiseChunks: (promises: Promise<any>[], size: number, sleepSeconds?: number, callbackFunction?: Function) => Promise<any[]>;
-//#endregion
-export { promiseChunks };
+export declare const promiseChunks: (promises: Promise<any>[], size: number, sleepSeconds?: number, callbackFunction?: Function) => Promise<any[]>;
+//#endregion

package/dist/util/promiseChunks.d.mts

@@ -3,6 +3,5 @@
  * Chunk a queue of promises into controlled chunks to prevent overloading.
  * https://stackoverflow.com/a/53964407
  */
-declare const promiseChunks: (promises: Promise<any>[], size: number, sleepSeconds?: number, callbackFunction?: Function) => Promise<any[]>;
-//#endregion
-export { promiseChunks };
+export declare const promiseChunks: (promises: Promise<any>[], size: number, sleepSeconds?: number, callbackFunction?: Function) => Promise<any[]>;
+//#endregion

package/dist/util/server/getBrotliCompressed.d.cts

@@ -3,6 +3,5 @@ import { BrotliOptions } from "zlib";
 /**
  * Compress a given input using Brotli.
  */
-declare const getBrotliCompressed: (input: any, options?: BrotliOptions) => Promise<unknown>;
-//#endregion
-export { getBrotliCompressed };
+export declare const getBrotliCompressed: (input: any, options?: BrotliOptions) => Promise<unknown>;
+//#endregion

package/dist/util/server/getBrotliCompressed.d.mts

@@ -3,6 +3,5 @@ import { BrotliOptions } from "zlib";
 /**
  * Compress a given input using Brotli.
  */
-declare const getBrotliCompressed: (input: any, options?: BrotliOptions) => Promise<unknown>;
-//#endregion
-export { getBrotliCompressed };
+export declare const getBrotliCompressed: (input: any, options?: BrotliOptions) => Promise<unknown>;
+//#endregion

package/dist/util/server/getBrotliDecompressed.d.cts

@@ -3,6 +3,5 @@ import { BrotliOptions } from "zlib";
 /**
  * Decompress a given Brotli input into a string.
  */
-declare const getBrotliDecompressed: (input: any, options?: BrotliOptions) => Promise<unknown>;
-//#endregion
-export { getBrotliDecompressed };
+export declare const getBrotliDecompressed: (input: any, options?: BrotliOptions) => Promise<unknown>;
+//#endregion

package/dist/util/server/getBrotliDecompressed.d.mts

@@ -3,6 +3,5 @@ import { BrotliOptions } from "zlib";
 /**
  * Decompress a given Brotli input into a string.
  */
-declare const getBrotliDecompressed: (input: any, options?: BrotliOptions) => Promise<unknown>;
-//#endregion
-export { getBrotliDecompressed };
+export declare const getBrotliDecompressed: (input: any, options?: BrotliOptions) => Promise<unknown>;
+//#endregion

package/dist/util/server/getGzipCompressed.d.cts

@@ -3,6 +3,5 @@ import { ZlibOptions } from "zlib";
 /**
  * Compress a given input using Gzip.
  */
-declare const getGzipCompressed: (input: any, options?: ZlibOptions) => Promise<string>;
-//#endregion
-export { getGzipCompressed };
+export declare const getGzipCompressed: (input: any, options?: ZlibOptions) => Promise<string>;
+//#endregion

package/dist/util/server/getGzipCompressed.d.mts

@@ -3,6 +3,5 @@ import { ZlibOptions } from "zlib";
 /**
  * Compress a given input using Gzip.
  */
-declare const getGzipCompressed: (input: any, options?: ZlibOptions) => Promise<string>;
-//#endregion
-export { getGzipCompressed };
+export declare const getGzipCompressed: (input: any, options?: ZlibOptions) => Promise<string>;
+//#endregion

package/dist/util/server/getGzipDecompressed.d.cts

@@ -3,6 +3,5 @@ import { ZlibOptions } from "zlib";
 /**
  * Decompress a given Gzip input into a string.
  */
-declare const getGzipDecompressed: (input: any, options?: ZlibOptions) => Promise<unknown>;
-//#endregion
-export { getGzipDecompressed };
+export declare const getGzipDecompressed: (input: any, options?: ZlibOptions) => Promise<unknown>;
+//#endregion

package/dist/util/server/getGzipDecompressed.d.mts

@@ -3,6 +3,5 @@ import { ZlibOptions } from "zlib";
 /**
  * Decompress a given Gzip input into a string.
  */
-declare const getGzipDecompressed: (input: any, options?: ZlibOptions) => Promise<unknown>;
-//#endregion
-export { getGzipDecompressed };
+export declare const getGzipDecompressed: (input: any, options?: ZlibOptions) => Promise<unknown>;
+//#endregion

package/dist/util/sleep.d.cts

@@ -1,4 +1,3 @@
 //#region src/util/sleep.d.ts
-declare const sleep: (seconds: number) => Promise<void>;
-//#endregion
-export { sleep };
+export declare const sleep: (seconds: number) => Promise<void>;
+//#endregion

package/dist/util/sleep.d.mts

@@ -1,4 +1,3 @@
 //#region src/util/sleep.d.ts
-declare const sleep: (seconds: number) => Promise<void>;
-//#endregion
-export { sleep };
+export declare const sleep: (seconds: number) => Promise<void>;
+//#endregion

package/dist/util/sort.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/util/sort.ts
+const sort = {
+	ASC: "ASC",
+	DESC: "DESC"
+};
+//#endregion
+exports.sort = sort;

package/dist/util/sort.d.cts

@@ -0,0 +1,7 @@
+//#region src/util/sort.d.ts
+export declare const sort: {
+  readonly ASC: "ASC";
+  readonly DESC: "DESC";
+};
+export type Sort = typeof sort[keyof typeof sort];
+//#endregion

package/dist/util/sort.d.mts

@@ -0,0 +1,7 @@
+//#region src/util/sort.d.ts
+export declare const sort: {
+  readonly ASC: "ASC";
+  readonly DESC: "DESC";
+};
+export type Sort = typeof sort[keyof typeof sort];
+//#endregion

package/dist/util/sort.mjs

@@ -0,0 +1,7 @@
+//#region src/util/sort.ts
+const sort = {
+	ASC: "ASC",
+	DESC: "DESC"
+};
+//#endregion
+export { sort };

package/dist/webWorker/index.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_webWorker_webWorkerState = require("./webWorkerState.cjs");
-exports.WebWorkerState = require_webWorker_webWorkerState.WebWorkerState;
+exports.webWorkerState = require_webWorker_webWorkerState.webWorkerState;

package/dist/webWorker/index.d.cts

@@ -1,2 +1,2 @@
-import { WebWorkerState } from "./webWorkerState.cjs";
-export { WebWorkerState };
+import { WebWorkerState, webWorkerState } from "./webWorkerState.cjs";
+export { WebWorkerState, webWorkerState };

package/dist/webWorker/index.d.mts

@@ -1,2 +1,2 @@
-import { WebWorkerState } from "./webWorkerState.mjs";
-export { WebWorkerState };
+import { WebWorkerState, webWorkerState } from "./webWorkerState.mjs";
+export { WebWorkerState, webWorkerState };

package/dist/webWorker/index.mjs

@@ -1,2 +1,2 @@
-import { WebWorkerState } from "./webWorkerState.mjs";
-export { WebWorkerState };
+import { webWorkerState } from "./webWorkerState.mjs";
+export { webWorkerState };

package/dist/webWorker/webWorkerState.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/webWorker/webWorkerState.ts
-const WebWorkerState = {
+const webWorkerState = {
 	IDLE: "IDLE",
 	CANCELLED: "CANCELLED",
 	PENDING: "PENDING",
@@ -8,4 +8,4 @@ const WebWorkerState = {
 	SUCCESS: "SUCCESS"
 };
 //#endregion
-exports.WebWorkerState = WebWorkerState;
+exports.webWorkerState = webWorkerState;

package/dist/webWorker/webWorkerState.d.cts

@@ -1,11 +1,10 @@
 //#region src/webWorker/webWorkerState.d.ts
-declare const WebWorkerState: {
+export declare const webWorkerState: {
   IDLE: string;
   CANCELLED: string;
   PENDING: string;
   ERROR: string;
   SUCCESS: string;
 };
-type WebWorkerState = typeof WebWorkerState[keyof typeof WebWorkerState];
-//#endregion
-export { WebWorkerState };
+export type WebWorkerState = typeof webWorkerState[keyof typeof webWorkerState];
+//#endregion

package/dist/webWorker/webWorkerState.d.mts

@@ -1,11 +1,10 @@
 //#region src/webWorker/webWorkerState.d.ts
-declare const WebWorkerState: {
+export declare const webWorkerState: {
   IDLE: string;
   CANCELLED: string;
   PENDING: string;
   ERROR: string;
   SUCCESS: string;
 };
-type WebWorkerState = typeof WebWorkerState[keyof typeof WebWorkerState];
-//#endregion
-export { WebWorkerState };
+export type WebWorkerState = typeof webWorkerState[keyof typeof webWorkerState];
+//#endregion

package/dist/webWorker/webWorkerState.mjs

@@ -1,5 +1,5 @@
 //#region src/webWorker/webWorkerState.ts
-const WebWorkerState = {
+const webWorkerState = {
 	IDLE: "IDLE",
 	CANCELLED: "CANCELLED",
 	PENDING: "PENDING",
@@ -7,4 +7,4 @@ const WebWorkerState = {
 	SUCCESS: "SUCCESS"
 };
 //#endregion
-export { WebWorkerState };
+export { webWorkerState };

package/dist/xlsx/cell.d.cts

@@ -1,21 +1,21 @@
 //#region src/xlsx/cell.d.ts
-type XlsxCellValue = string | number | null | undefined;
+export type XlsxCellValue = string | number | null | undefined;
 /**
  * Parse the 1-based column number out of an Excel cell reference.
  *
  * Examples: "A1" → 1, "B3" → 2, "AA1" → 27.
  */
-declare const getCellColNum: (ref: string) => number;
+export declare const getCellColNum: (ref: string) => number;
 /**
  * Excel only understands finite numbers inside a <v> element — NaN or Infinity
  * produce a file it offers to "repair". Those fall back to text instead.
  */
-declare const getCellValue: (value: XlsxCellValue) => string | number;
+export declare const getCellValue: (value: XlsxCellValue) => string | number;
 /**
  * Escape the reserved XML characters so a plain string is safe to embed in an
  * attribute value or a text node.
  */
-declare const getEscapedXml: (text: string) => string;
+export declare const getEscapedXml: (text: string) => string;
 /**
  * Build the raw <c> (cell) XML for a single spreadsheet cell.
  *
@@ -24,7 +24,7 @@ declare const getEscapedXml: (text: string) => string;
  *
  * styleAttr must be either empty or a pre-formatted attribute such as ` s="3"`.
  */
-declare const buildCellXml: (ref: string, value: string | number, styleAttr: string) => string;
+export declare const buildCellXml: (ref: string, value: string | number, styleAttr: string) => string;
 /**
  * Set a cell value in raw worksheet XML.
  *
@@ -33,6 +33,5 @@ declare const buildCellXml: (ref: string, value: string | number, styleAttr: str
  * - If the row exists but the cell does not, the cell is inserted in column order.
  * - If neither exists, a new row is appended before </sheetData>.
  */
-declare const setCell: (xml: string, row: number, col: number, value: string | number) => string;
-//#endregion
-export { XlsxCellValue, buildCellXml, getCellColNum, getCellValue, getEscapedXml, setCell };
+export declare const setCell: (xml: string, row: number, col: number, value: string | number) => string;
+//#endregion

package/dist/xlsx/cell.d.mts

@@ -1,21 +1,21 @@
 //#region src/xlsx/cell.d.ts
-type XlsxCellValue = string | number | null | undefined;
+export type XlsxCellValue = string | number | null | undefined;
 /**
  * Parse the 1-based column number out of an Excel cell reference.
  *
  * Examples: "A1" → 1, "B3" → 2, "AA1" → 27.
  */
-declare const getCellColNum: (ref: string) => number;
+export declare const getCellColNum: (ref: string) => number;
 /**
  * Excel only understands finite numbers inside a <v> element — NaN or Infinity
  * produce a file it offers to "repair". Those fall back to text instead.
  */
-declare const getCellValue: (value: XlsxCellValue) => string | number;
+export declare const getCellValue: (value: XlsxCellValue) => string | number;
 /**
  * Escape the reserved XML characters so a plain string is safe to embed in an
  * attribute value or a text node.
  */
-declare const getEscapedXml: (text: string) => string;
+export declare const getEscapedXml: (text: string) => string;
 /**
  * Build the raw <c> (cell) XML for a single spreadsheet cell.
  *
@@ -24,7 +24,7 @@ declare const getEscapedXml: (text: string) => string;
  *
  * styleAttr must be either empty or a pre-formatted attribute such as ` s="3"`.
  */
-declare const buildCellXml: (ref: string, value: string | number, styleAttr: string) => string;
+export declare const buildCellXml: (ref: string, value: string | number, styleAttr: string) => string;
 /**
  * Set a cell value in raw worksheet XML.
  *
@@ -33,6 +33,5 @@ declare const buildCellXml: (ref: string, value: string | number, styleAttr: str
  * - If the row exists but the cell does not, the cell is inserted in column order.
  * - If neither exists, a new row is appended before </sheetData>.
  */
-declare const setCell: (xml: string, row: number, col: number, value: string | number) => string;
-//#endregion
-export { XlsxCellValue, buildCellXml, getCellColNum, getCellValue, getEscapedXml, setCell };
+export declare const setCell: (xml: string, row: number, col: number, value: string | number) => string;
+//#endregion

package/dist/xlsx/column.d.cts

@@ -1,6 +1,6 @@
 import { XlsxCellValue } from "./cell.cjs";
 //#region src/xlsx/column.d.ts
-type XlsxColumn = {
+export type XlsxColumn = {
   id: string;
   displayName: string;
   /** Column width in Excel character units. Derived from the content when omitted. */
@@ -11,13 +11,12 @@ type XlsxColumn = {
  *
  * Examples: 1 → "A", 2 → "B", 26 → "Z", 27 → "AA", 28 → "AB".
  */
-declare const getColumLetter: (colNum: number) => string;
+export declare const getColumLetter: (colNum: number) => string;
 /**
  * Width in Excel character units, taken from the widest value in the column
  * (header included) and clamped. Heading lines are excluded on purpose: they sit
  * in column A and overflow into the empty cells beside them, so letting them
  * drive the width would stretch the first column for no benefit.
  */
-declare const getColumnWidth: (column: XlsxColumn, data: Record<string, XlsxCellValue>[]) => number;
-//#endregion
-export { XlsxColumn, getColumLetter, getColumnWidth };
+export declare const getColumnWidth: (column: XlsxColumn, data: Record<string, XlsxCellValue>[]) => number;
+//#endregion

package/dist/xlsx/column.d.mts

@@ -1,6 +1,6 @@
 import { XlsxCellValue } from "./cell.mjs";
 //#region src/xlsx/column.d.ts
-type XlsxColumn = {
+export type XlsxColumn = {
   id: string;
   displayName: string;
   /** Column width in Excel character units. Derived from the content when omitted. */
@@ -11,13 +11,12 @@ type XlsxColumn = {
  *
  * Examples: 1 → "A", 2 → "B", 26 → "Z", 27 → "AA", 28 → "AB".
  */
-declare const getColumLetter: (colNum: number) => string;
+export declare const getColumLetter: (colNum: number) => string;
 /**
  * Width in Excel character units, taken from the widest value in the column
  * (header included) and clamped. Heading lines are excluded on purpose: they sit
  * in column A and overflow into the empty cells beside them, so letting them
  * drive the width would stretch the first column for no benefit.
  */
-declare const getColumnWidth: (column: XlsxColumn, data: Record<string, XlsxCellValue>[]) => number;
-//#endregion
-export { XlsxColumn, getColumLetter, getColumnWidth };
+export declare const getColumnWidth: (column: XlsxColumn, data: Record<string, XlsxCellValue>[]) => number;
+//#endregion

package/dist/xlsx/createXlsx.d.cts

@@ -8,11 +8,10 @@ import { XlsxSheet } from "./sheet.cjs";
  * row reads values by column `id` — so key order in the source objects does not
  * matter and a missing key becomes an empty cell.
  */
-declare const createXlsx: (sheets: XlsxSheet[]) => Promise<Blob>;
+export declare const createXlsx: (sheets: XlsxSheet[]) => Promise<Blob>;
 /**
  * As createXlsx, but returns raw bytes instead of a Blob — for server-side
  * callers that need to stream or write the workbook rather than download it.
  */
-declare const createXlsxBytes: (sheets: XlsxSheet[]) => Promise<Uint8Array>;
-//#endregion
-export { createXlsx, createXlsxBytes };
+export declare const createXlsxBytes: (sheets: XlsxSheet[]) => Promise<Uint8Array>;
+//#endregion

package/dist/xlsx/createXlsx.d.mts

@@ -8,11 +8,10 @@ import { XlsxSheet } from "./sheet.mjs";
  * row reads values by column `id` — so key order in the source objects does not
  * matter and a missing key becomes an empty cell.
  */
-declare const createXlsx: (sheets: XlsxSheet[]) => Promise<Blob>;
+export declare const createXlsx: (sheets: XlsxSheet[]) => Promise<Blob>;
 /**
  * As createXlsx, but returns raw bytes instead of a Blob — for server-side
  * callers that need to stream or write the workbook rather than download it.
  */
-declare const createXlsxBytes: (sheets: XlsxSheet[]) => Promise<Uint8Array>;
-//#endregion
-export { createXlsx, createXlsxBytes };
+export declare const createXlsxBytes: (sheets: XlsxSheet[]) => Promise<Uint8Array>;
+//#endregion

package/dist/xlsx/modifyXlsx.d.cts

@@ -1,5 +1,5 @@
 //#region src/xlsx/modifyXlsx.d.ts
-type XlsxSheetModifier = {
+export type XlsxSheetModifier = {
   /** 1-indexed sheet number inside the ZIP (sheet1.xml, sheet2.xml, …). */
   index: number;
   modify: (xml: string) => string;
@@ -19,6 +19,5 @@ type XlsxSheetModifier = {
  * @param sheets   One entry per sheet to touch, keyed by its 1-indexed position.
  * @param logo     Optional PNG bytes, embedded into sheets with `addLogo`.
  */
-declare const modifyXlsx: (template: Uint8Array, sheets: XlsxSheetModifier[], logo?: Uint8Array) => Promise<Uint8Array>;
-//#endregion
-export { XlsxSheetModifier, modifyXlsx };
+export declare const modifyXlsx: (template: Uint8Array, sheets: XlsxSheetModifier[], logo?: Uint8Array) => Promise<Uint8Array>;
+//#endregion

package/dist/xlsx/modifyXlsx.d.mts

@@ -1,5 +1,5 @@
 //#region src/xlsx/modifyXlsx.d.ts
-type XlsxSheetModifier = {
+export type XlsxSheetModifier = {
   /** 1-indexed sheet number inside the ZIP (sheet1.xml, sheet2.xml, …). */
   index: number;
   modify: (xml: string) => string;
@@ -19,6 +19,5 @@ type XlsxSheetModifier = {
  * @param sheets   One entry per sheet to touch, keyed by its 1-indexed position.
  * @param logo     Optional PNG bytes, embedded into sheets with `addLogo`.
  */
-declare const modifyXlsx: (template: Uint8Array, sheets: XlsxSheetModifier[], logo?: Uint8Array) => Promise<Uint8Array>;
-//#endregion
-export { XlsxSheetModifier, modifyXlsx };
+export declare const modifyXlsx: (template: Uint8Array, sheets: XlsxSheetModifier[], logo?: Uint8Array) => Promise<Uint8Array>;
+//#endregion

package/dist/xlsx/sheet.d.cts

@@ -1,7 +1,7 @@
 import { XlsxCellValue } from "./cell.cjs";
 import { XlsxColumn } from "./column.cjs";
 //#region src/xlsx/sheet.d.ts
-type XlsxSheet = {
+export type XlsxSheet = {
   name: string;
   columns: XlsxColumn[];
   data: Record<string, XlsxCellValue>[];
@@ -18,12 +18,11 @@ type XlsxSheet = {
  *
  * Uniqueness is handled separately, since that needs the whole set.
  */
-declare const getSanitisedSheetName: (name: string) => string;
+export declare const getSanitisedSheetName: (name: string) => string;
 /**
  * Sanitise every sheet name and break collisions with _2, _3, … while staying
  * inside the 31 character limit. Excel rejects duplicate names outright, so this
  * cannot be left to chance once sheets are generated from data.
  */
-declare const getUniqueSheetNames: (sheets: XlsxSheet[]) => string[];
-//#endregion
-export { XlsxSheet, getSanitisedSheetName, getUniqueSheetNames };
+export declare const getUniqueSheetNames: (sheets: XlsxSheet[]) => string[];
+//#endregion

package/dist/xlsx/sheet.d.mts

@@ -1,7 +1,7 @@
 import { XlsxCellValue } from "./cell.mjs";
 import { XlsxColumn } from "./column.mjs";
 //#region src/xlsx/sheet.d.ts
-type XlsxSheet = {
+export type XlsxSheet = {
   name: string;
   columns: XlsxColumn[];
   data: Record<string, XlsxCellValue>[];
@@ -18,12 +18,11 @@ type XlsxSheet = {
  *
  * Uniqueness is handled separately, since that needs the whole set.
  */
-declare const getSanitisedSheetName: (name: string) => string;
+export declare const getSanitisedSheetName: (name: string) => string;
 /**
  * Sanitise every sheet name and break collisions with _2, _3, … while staying
  * inside the 31 character limit. Excel rejects duplicate names outright, so this
  * cannot be left to chance once sheets are generated from data.
  */
-declare const getUniqueSheetNames: (sheets: XlsxSheet[]) => string[];
-//#endregion
-export { XlsxSheet, getSanitisedSheetName, getUniqueSheetNames };
+export declare const getUniqueSheetNames: (sheets: XlsxSheet[]) => string[];
+//#endregion

package/dist/xml/server/getXml.d.cts

@@ -1,4 +1,3 @@
 //#region src/xml/server/getXml.d.ts
-declare const getXml: (url: string) => Promise<string>;
-//#endregion
-export { getXml };
+export declare const getXml: (url: string) => Promise<string>;
+//#endregion

package/dist/xml/server/getXml.d.mts

@@ -1,4 +1,3 @@
 //#region src/xml/server/getXml.d.ts
-declare const getXml: (url: string) => Promise<string>;
-//#endregion
-export { getXml };
+export declare const getXml: (url: string) => Promise<string>;
+//#endregion