@8ms/helpers 3.0.22 → 3.0.24

package/dist/lumar/graphql/server/queries/getTotals.d.cts

@@ -6,13 +6,7 @@ type GetTotals = {
   reportTemplateCode: string;
   reportTypeCode: string;
 };
-declare const getTotals: ({
-  crawlId,
-  filter,
-  filterKey,
-  reportTemplateCode,
-  reportTypeCode
-}: GetTotals) => {
+declare const getTotals: ({ crawlId, filter, filterKey, reportTemplateCode, reportTypeCode }: GetTotals) => {
   id: string;
   crawlId: number;
   filter: object;

package/dist/lumar/graphql/server/queries/getTotals.d.mts

@@ -6,13 +6,7 @@ type GetTotals = {
   reportTemplateCode: string;
   reportTypeCode: string;
 };
-declare const getTotals: ({
-  crawlId,
-  filter,
-  filterKey,
-  reportTemplateCode,
-  reportTypeCode
-}: GetTotals) => {
+declare const getTotals: ({ crawlId, filter, filterKey, reportTemplateCode, reportTypeCode }: GetTotals) => {
   id: string;
   crawlId: number;
   filter: object;

package/dist/myTarget/server/myTarget.d.cts

@@ -1,5 +1,4 @@
 import { ApiResponse } from "../../api/api.cjs";
-
 //#region src/myTarget/server/myTarget.d.ts
 /**
  * Make the request to MyTarget API using the access token.

package/dist/myTarget/server/myTarget.d.mts

@@ -1,5 +1,4 @@
 import { ApiResponse } from "../../api/api.mjs";
-
 //#region src/myTarget/server/myTarget.d.ts
 /**
  * Make the request to MyTarget API using the access token.

package/dist/nextAuth/nextAuth.d.cts

@@ -1,5 +1,4 @@
 import { isSessionReady } from "./isSessionReady.cjs";
-
 //#region src/nextAuth/nextAuth.d.ts
 declare const NextAuthState: {
   readonly AUTHENTICATED: "authenticated";

package/dist/nextAuth/nextAuth.d.mts

@@ -1,5 +1,4 @@
 import { isSessionReady } from "./isSessionReady.mjs";
-
 //#region src/nextAuth/nextAuth.d.ts
 declare const NextAuthState: {
   readonly AUTHENTICATED: "authenticated";

package/dist/nextJs/client/LazyLoad.d.cts

@@ -1,6 +1,5 @@
 import { IntersectionOptions } from "react-intersection-observer";
 import React, { ReactNode } from "react";
-
 //#region src/nextJs/client/LazyLoad.d.ts
 type LazyLoadProps = IntersectionOptions & {
   children: ReactNode;

package/dist/nextJs/client/LazyLoad.d.mts

@@ -1,6 +1,5 @@
 import { IntersectionOptions } from "react-intersection-observer";
 import React, { ReactNode } from "react";
-
 //#region src/nextJs/client/LazyLoad.d.ts
 type LazyLoadProps = IntersectionOptions & {
   children: ReactNode;

package/dist/onePassword/server/OnePassword.d.cts

@@ -1,6 +1,5 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.cjs";
 import { Client } from "@1password/sdk";
-
 //#region src/onePassword/server/OnePassword.d.ts
 type OnePasswordConfig = {
   serviceAccountToken: string;

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

@@ -1,6 +1,5 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.mjs";
 import { Client } from "@1password/sdk";
-
 //#region src/onePassword/server/OnePassword.d.ts
 type OnePasswordConfig = {
   serviceAccountToken: string;

package/dist/openAi/server/OpenAi.d.cts

@@ -1,5 +1,4 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.cjs";
-
 //#region src/openAi/server/OpenAi.d.ts
 type OpenAiConfig = {
   apiKey: string;

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

@@ -1,5 +1,4 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.mjs";
-
 //#region src/openAi/server/OpenAi.d.ts
 type OpenAiConfig = {
   apiKey: string;

package/dist/prisma/server/Prisma.d.cts

@@ -1,5 +1,4 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.cjs";
-
 //#region src/prisma/server/Prisma.d.ts
 /**
  * Minimal interface representing a Prisma Client instance.

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

@@ -1,5 +1,4 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.mjs";
-
 //#region src/prisma/server/Prisma.d.ts
 /**
  * Minimal interface representing a Prisma Client instance.

package/dist/snapchat/server/Snapchat.cjs

@@ -10,9 +10,10 @@ var Snapchat = class extends require__class_BaseNamespace.BaseNamespace {
 	init = async (config) => {
 		if (!this.client) {
 			this.config = config;
-			const apiResponse = await require_api_post.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}`);
+			const url = `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}`;
+			const apiResponse = await require_api_post.post(url);
 			if (apiResponse.isSuccess()) this.client = {
-				expires: luxon.DateTime.now().toUnixInteger() + 10800 * 1e3,
+				expires: luxon.DateTime.now().toUnixInteger() + 108e5,
 				refreshToken: apiResponse.getBodyDefaultTo(["data", "access_token"], null)
 			};
 		}

package/dist/snapchat/server/Snapchat.d.cts

@@ -1,5 +1,4 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.cjs";
-
 //#region src/snapchat/server/Snapchat.d.ts
 type SnapchatConfig = {
   clientId: string;

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

@@ -1,5 +1,4 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.mjs";
-
 //#region src/snapchat/server/Snapchat.d.ts
 type SnapchatConfig = {
   clientId: string;

package/dist/snapchat/server/Snapchat.mjs

@@ -9,9 +9,10 @@ var Snapchat = class extends BaseNamespace {
 	init = async (config) => {
 		if (!this.client) {
 			this.config = config;
-			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}`);
+			const url = `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}`;
+			const apiResponse = await post(url);
 			if (apiResponse.isSuccess()) this.client = {
-				expires: DateTime.now().toUnixInteger() + 10800 * 1e3,
+				expires: DateTime.now().toUnixInteger() + 108e5,
 				refreshToken: apiResponse.getBodyDefaultTo(["data", "access_token"], null)
 			};
 		}

package/dist/stream/server/sort.d.cts

@@ -1,5 +1,4 @@
 import { Transform, TransformCallback, TransformOptions } from "node:stream";
-
 //#region src/stream/server/sort.d.ts
 declare class SortStreamer<T> extends Transform {
   private a;

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

@@ -1,5 +1,4 @@
 import { Transform, TransformCallback, TransformOptions } from "node:stream";
-
 //#region src/stream/server/sort.d.ts
 declare class SortStreamer<T> extends Transform {
   private a;

package/dist/swr/client/swr.d.cts

@@ -1,4 +1,5 @@
 import { ApiState } from "../../api/api.cjs";
+import "../../api/index.cjs";
 //#region src/swr/client/swr.d.ts
 type Swr = {
   data: any;

package/dist/swr/client/swr.d.mts

@@ -1,4 +1,5 @@
 import { ApiState } from "../../api/api.mjs";
+import "../../api/index.mjs";
 //#region src/swr/client/swr.d.ts
 type Swr = {
   data: any;

package/dist/upTimeRobot/server/UpTimeRobot.d.cts

@@ -1,5 +1,4 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.cjs";
-
 //#region src/upTimeRobot/server/UpTimeRobot.d.ts
 type UpTimeRobotConfig = {
   apiKey: string;

package/dist/upTimeRobot/server/UpTimeRobot.d.mts

@@ -1,5 +1,4 @@
 import { BaseNamespace } from "../../_class/BaseNamespace.mjs";
-
 //#region src/upTimeRobot/server/UpTimeRobot.d.ts
 type UpTimeRobotConfig = {
   apiKey: string;

package/dist/util/defaultTo.cjs

@@ -11,9 +11,12 @@ const defaultTo = (instance, keys, defaultValue = null) => {
 	let pointer = instance;
 	if ("undefined" === typeof instance || null === pointer) found = false;
 	else keysArray.forEach((key) => {
-		if (found) if (require_lodash_isObject.isObject(pointer)) if ("undefined" === typeof pointer[key] || null === pointer[key]) found = false;
-		else pointer = pointer[key];
-		else found = false;
+		if (found) {
+			if (require_lodash_isObject.isObject(pointer)) {
+				if ("undefined" === typeof pointer[key] || null === pointer[key]) found = false;
+				else pointer = pointer[key];
+			} else found = false;
+		}
 	});
 	return found ? pointer : defaultValue;
 };

package/dist/util/defaultTo.mjs

@@ -10,9 +10,12 @@ const defaultTo = (instance, keys, defaultValue = null) => {
 	let pointer = instance;
 	if ("undefined" === typeof instance || null === pointer) found = false;
 	else keysArray.forEach((key) => {
-		if (found) if (isObject(pointer)) if ("undefined" === typeof pointer[key] || null === pointer[key]) found = false;
-		else pointer = pointer[key];
-		else found = false;
+		if (found) {
+			if (isObject(pointer)) {
+				if ("undefined" === typeof pointer[key] || null === pointer[key]) found = false;
+				else pointer = pointer[key];
+			} else found = false;
+		}
 	});
 	return found ? pointer : defaultValue;
 };

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

@@ -1,5 +1,4 @@
 import { BrotliOptions } from "zlib";
-
 //#region src/util/server/getBrotliCompressed.d.ts
 /**
  * Compress a given input using Brotli.

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

@@ -1,5 +1,4 @@
 import { BrotliOptions } from "zlib";
-
 //#region src/util/server/getBrotliCompressed.d.ts
 /**
  * Compress a given input using Brotli.

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

@@ -1,5 +1,4 @@
 import { BrotliOptions } from "zlib";
-
 //#region src/util/server/getBrotliDecompressed.d.ts
 /**
  * Decompress a given Brotli input into a string.

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

@@ -1,5 +1,4 @@
 import { BrotliOptions } from "zlib";
-
 //#region src/util/server/getBrotliDecompressed.d.ts
 /**
  * Decompress a given Brotli input into a string.

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

@@ -1,5 +1,4 @@
 import { ZlibOptions } from "zlib";
-
 //#region src/util/server/getGzipCompressed.d.ts
 /**
  * Compress a given input using Gzip.

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

@@ -1,5 +1,4 @@
 import { ZlibOptions } from "zlib";
-
 //#region src/util/server/getGzipCompressed.d.ts
 /**
  * Compress a given input using Gzip.

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

@@ -1,5 +1,4 @@
 import { ZlibOptions } from "zlib";
-
 //#region src/util/server/getGzipDecompressed.d.ts
 /**
  * Decompress a given Gzip input into a string.

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

@@ -1,5 +1,4 @@
 import { ZlibOptions } from "zlib";
-
 //#region src/util/server/getGzipDecompressed.d.ts
 /**
  * Decompress a given Gzip input into a string.

package/dist/xlsx/cell.cjs

@@ -0,0 +1,102 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xlsx_column = require("./column.cjs");
+//#region src/xlsx/cell.ts
+/**
+* Parse the 1-based column number out of an Excel cell reference.
+*
+* Examples: "A1" → 1, "B3" → 2, "AA1" → 27.
+*/
+const getCellColNum = (ref) => {
+	const letters = ref.match(/^([A-Z]+)/)?.[1] ?? "A";
+	let colNum = 0;
+	for (const char of letters) colNum = colNum * 26 + (char.charCodeAt(0) - 64);
+	return colNum;
+};
+/**
+* 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.
+*/
+const getCellValue = (value) => {
+	if (null === value || void 0 === value) return "";
+	if ("number" === typeof value) return Number.isFinite(value) ? value : String(value);
+	return value;
+};
+/**
+* Escape the reserved XML characters so a plain string is safe to embed in an
+* attribute value or a text node.
+*/
+const getEscapedXml = (text) => {
+	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+};
+/**
+* Build the raw <c> (cell) XML for a single spreadsheet cell.
+*
+* Numbers use the <v> value element; strings are written as an inline string so
+* there is no shared-strings table to maintain.
+*
+* styleAttr must be either empty or a pre-formatted attribute such as ` s="3"`.
+*/
+const buildCellXml = (ref, value, styleAttr) => {
+	if ("number" === typeof value) return `<c r="${ref}"${styleAttr}><v>${value}</v></c>`;
+	return `<c r="${ref}"${styleAttr} t="inlineStr"><is><t>${getEscapedXml(String(value))}</t></is></c>`;
+};
+/**
+* Insert a <c> snippet into raw row XML, keeping the cells in ascending column
+* order. If a cell with a higher column number already exists the new cell goes
+* before it, otherwise it is appended.
+*/
+const insertCellInRow = (rowContent, ref, cellXml) => {
+	const newCol = getCellColNum(ref);
+	const cellPat = /<c r="([A-Z]+\d+)"(?:[^>]*\/>|[^>]*>[\s\S]*?<\/c>)/g;
+	const cells = [];
+	let match;
+	while (null !== (match = cellPat.exec(rowContent))) cells.push({
+		full: match[0],
+		col: getCellColNum(match[1])
+	});
+	const cellAfter = cells.find((cell) => {
+		return cell.col > newCol;
+	});
+	if (cellAfter) return rowContent.replace(cellAfter.full, () => {
+		return `${cellXml}${cellAfter.full}`;
+	});
+	return rowContent + cellXml;
+};
+/**
+* Set a cell value in raw worksheet XML.
+*
+* - If the cell exists, its content is replaced and its style attribute (s="N")
+*   is preserved, so a template's formatting survives.
+* - 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>.
+*/
+const setCell = (xml, row, col, value) => {
+	const ref = `${require_xlsx_column.getColumLetter(col)}${row}`;
+	const cellPat = new RegExp(`<c r="${ref}"([^>]*?)(?:\\s*/>|>[\\s\\S]*?<\\/c>)`);
+	const cellMatch = cellPat.exec(xml);
+	if (cellMatch) {
+		const style = /\bs="(\d+)"/.exec(cellMatch[1]);
+		const cellXml = buildCellXml(ref, value, style ? ` s="${style[1]}"` : "");
+		return xml.replace(cellPat, () => {
+			return cellXml;
+		});
+	}
+	const rowPat = new RegExp(`(<row[^>]+r="${row}"[^>]*>)([\\s\\S]*?)(<\/row>)`);
+	const rowMatch = rowPat.exec(xml);
+	if (rowMatch) {
+		const content = insertCellInRow(rowMatch[2], ref, buildCellXml(ref, value, ""));
+		return xml.replace(rowPat, () => {
+			return `${rowMatch[1]}${content}${rowMatch[3]}`;
+		});
+	}
+	const newRow = `<row r="${row}">${buildCellXml(ref, value, "")}</row>`;
+	return xml.replace("</sheetData>", () => {
+		return `${newRow}</sheetData>`;
+	});
+};
+//#endregion
+exports.buildCellXml = buildCellXml;
+exports.getCellColNum = getCellColNum;
+exports.getCellValue = getCellValue;
+exports.getEscapedXml = getEscapedXml;
+exports.setCell = setCell;

package/dist/xlsx/cell.d.cts

@@ -0,0 +1,38 @@
+//#region src/xlsx/cell.d.ts
+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;
+/**
+ * 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;
+/**
+ * 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;
+/**
+ * Build the raw <c> (cell) XML for a single spreadsheet cell.
+ *
+ * Numbers use the <v> value element; strings are written as an inline string so
+ * there is no shared-strings table to maintain.
+ *
+ * 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;
+/**
+ * Set a cell value in raw worksheet XML.
+ *
+ * - If the cell exists, its content is replaced and its style attribute (s="N")
+ *   is preserved, so a template's formatting survives.
+ * - 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 };

package/dist/xlsx/cell.d.mts

@@ -0,0 +1,38 @@
+//#region src/xlsx/cell.d.ts
+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;
+/**
+ * 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;
+/**
+ * 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;
+/**
+ * Build the raw <c> (cell) XML for a single spreadsheet cell.
+ *
+ * Numbers use the <v> value element; strings are written as an inline string so
+ * there is no shared-strings table to maintain.
+ *
+ * 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;
+/**
+ * Set a cell value in raw worksheet XML.
+ *
+ * - If the cell exists, its content is replaced and its style attribute (s="N")
+ *   is preserved, so a template's formatting survives.
+ * - 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 };

package/dist/xlsx/cell.mjs

@@ -0,0 +1,97 @@
+import { getColumLetter } from "./column.mjs";
+//#region src/xlsx/cell.ts
+/**
+* Parse the 1-based column number out of an Excel cell reference.
+*
+* Examples: "A1" → 1, "B3" → 2, "AA1" → 27.
+*/
+const getCellColNum = (ref) => {
+	const letters = ref.match(/^([A-Z]+)/)?.[1] ?? "A";
+	let colNum = 0;
+	for (const char of letters) colNum = colNum * 26 + (char.charCodeAt(0) - 64);
+	return colNum;
+};
+/**
+* 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.
+*/
+const getCellValue = (value) => {
+	if (null === value || void 0 === value) return "";
+	if ("number" === typeof value) return Number.isFinite(value) ? value : String(value);
+	return value;
+};
+/**
+* Escape the reserved XML characters so a plain string is safe to embed in an
+* attribute value or a text node.
+*/
+const getEscapedXml = (text) => {
+	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+};
+/**
+* Build the raw <c> (cell) XML for a single spreadsheet cell.
+*
+* Numbers use the <v> value element; strings are written as an inline string so
+* there is no shared-strings table to maintain.
+*
+* styleAttr must be either empty or a pre-formatted attribute such as ` s="3"`.
+*/
+const buildCellXml = (ref, value, styleAttr) => {
+	if ("number" === typeof value) return `<c r="${ref}"${styleAttr}><v>${value}</v></c>`;
+	return `<c r="${ref}"${styleAttr} t="inlineStr"><is><t>${getEscapedXml(String(value))}</t></is></c>`;
+};
+/**
+* Insert a <c> snippet into raw row XML, keeping the cells in ascending column
+* order. If a cell with a higher column number already exists the new cell goes
+* before it, otherwise it is appended.
+*/
+const insertCellInRow = (rowContent, ref, cellXml) => {
+	const newCol = getCellColNum(ref);
+	const cellPat = /<c r="([A-Z]+\d+)"(?:[^>]*\/>|[^>]*>[\s\S]*?<\/c>)/g;
+	const cells = [];
+	let match;
+	while (null !== (match = cellPat.exec(rowContent))) cells.push({
+		full: match[0],
+		col: getCellColNum(match[1])
+	});
+	const cellAfter = cells.find((cell) => {
+		return cell.col > newCol;
+	});
+	if (cellAfter) return rowContent.replace(cellAfter.full, () => {
+		return `${cellXml}${cellAfter.full}`;
+	});
+	return rowContent + cellXml;
+};
+/**
+* Set a cell value in raw worksheet XML.
+*
+* - If the cell exists, its content is replaced and its style attribute (s="N")
+*   is preserved, so a template's formatting survives.
+* - 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>.
+*/
+const setCell = (xml, row, col, value) => {
+	const ref = `${getColumLetter(col)}${row}`;
+	const cellPat = new RegExp(`<c r="${ref}"([^>]*?)(?:\\s*/>|>[\\s\\S]*?<\\/c>)`);
+	const cellMatch = cellPat.exec(xml);
+	if (cellMatch) {
+		const style = /\bs="(\d+)"/.exec(cellMatch[1]);
+		const cellXml = buildCellXml(ref, value, style ? ` s="${style[1]}"` : "");
+		return xml.replace(cellPat, () => {
+			return cellXml;
+		});
+	}
+	const rowPat = new RegExp(`(<row[^>]+r="${row}"[^>]*>)([\\s\\S]*?)(<\/row>)`);
+	const rowMatch = rowPat.exec(xml);
+	if (rowMatch) {
+		const content = insertCellInRow(rowMatch[2], ref, buildCellXml(ref, value, ""));
+		return xml.replace(rowPat, () => {
+			return `${rowMatch[1]}${content}${rowMatch[3]}`;
+		});
+	}
+	const newRow = `<row r="${row}">${buildCellXml(ref, value, "")}</row>`;
+	return xml.replace("</sheetData>", () => {
+		return `${newRow}</sheetData>`;
+	});
+};
+//#endregion
+export { buildCellXml, getCellColNum, getCellValue, getEscapedXml, setCell };

package/dist/xlsx/column.cjs

@@ -0,0 +1,37 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xlsx_cell = require("./cell.cjs");
+//#region src/xlsx/column.ts
+/** Bounds for widths derived from content, so nothing is cramped or absurd. */
+const COLUMN_WIDTH_MIN = 10;
+const COLUMN_WIDTH_MAX = 60;
+/**
+* Convert a 1-based column number to an Excel column letter string.
+*
+* Examples: 1 → "A", 2 → "B", 26 → "Z", 27 → "AA", 28 → "AB".
+*/
+const getColumLetter = (colNum) => {
+	let result = "";
+	let remaining = colNum;
+	while (remaining > 0) {
+		remaining--;
+		result = String.fromCharCode(65 + remaining % 26) + result;
+		remaining = Math.floor(remaining / 26);
+	}
+	return result;
+};
+/**
+* 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.
+*/
+const getColumnWidth = (column, data) => {
+	if (column?.width) return column.width;
+	const longest = data.reduce((widest, row) => {
+		return Math.max(widest, String(require_xlsx_cell.getCellValue(row?.[column.id])).length);
+	}, column.displayName.length);
+	return Math.min(COLUMN_WIDTH_MAX, Math.max(COLUMN_WIDTH_MIN, longest + 2));
+};
+//#endregion
+exports.getColumLetter = getColumLetter;
+exports.getColumnWidth = getColumnWidth;

package/dist/xlsx/column.d.cts

@@ -0,0 +1,23 @@
+import { XlsxCellValue } from "./cell.cjs";
+//#region src/xlsx/column.d.ts
+type XlsxColumn = {
+  id: string;
+  displayName: string;
+  /** Column width in Excel character units. Derived from the content when omitted. */
+  width?: number;
+};
+/**
+ * Convert a 1-based column number to an Excel column letter string.
+ *
+ * Examples: 1 → "A", 2 → "B", 26 → "Z", 27 → "AA", 28 → "AB".
+ */
+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 };