@farhantallei/excel 1.0.0

package/README.md

@@ -0,0 +1,182 @@
+# @farhantallei/excel
+
+> Type-safe, declarative Excel (XLSX) export for Node.js server environments.
+
+Build Excel files using a clean configuration object — with typed columns, formatting, and row mapping. Designed for server-side execution only.
+
+---
+
+## Features
+
+- ✅ Declarative worksheet configuration
+- ✅ Fully type-safe (TypeScript-first)
+- ✅ Column metadata (width, type, format)
+- ✅ Generic row mapping
+- ✅ Server-only safe (no browser XLSX usage)
+- ✅ Zero global state
+- ✅ Clean separation of concerns
+- ✅ JSON import from Excel  
+
+---
+
+## Installation
+
+```bash
+npm install @farhantallei/excel
+# or
+yarn add @farhantallei/excel
+```
+
+---
+
+## Usage
+
+### Quick Start (Export)
+
+```ts
+import { exportToExcel } from "@farhantallei/excel"
+
+const blob = await exportToExcel({
+  sheetName: "Users",
+  header: ["No", "Name", "Active"],
+  columns: [
+    { width: 50, type: "number" },
+    { width: 200, type: "string" },
+    { width: 100, type: "string" },
+  ],
+  data: users,
+  mapRow: (user, index) => [
+    index + 1,
+    user.name,
+    user.active ? "Yes" : "No",
+  ],
+})
+```
+
+#### Send to Client (Next.js Example)
+
+```ts
+// Server Action / Route Handler
+return new Response(blob, {
+  headers: {
+    "Content-Type":
+      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    "Content-Disposition": 'attachment; filename="users.xlsx"',
+  },
+})
+```
+
+### Import Excel → JSON
+
+```ts
+import { readExcelToJson } from "@farhantallei/excel"
+
+const data = await readExcelToJson<User>(file)
+```
+
+#### Optional sheet selection:
+
+```ts
+await readExcelToJson<User>(file, {
+  sheetName: "Users",
+})
+```
+
+---
+
+## API
+
+### `exportToExcel<T>(config)`
+
+Generate an Excel `Blob` from a declarative configuration.
+
+#### Config
+
+```ts
+{
+  sheetName: string
+  header: string[]
+  columns: {
+    width?: number
+    type?: "string" | "number" | "date"
+    format?: string
+  }[]
+  data: T[]
+  mapRow: (item: T, index: number) => unknown[]
+}
+```
+
+#### Returns
+
+```ts
+Promise<Blob>
+```
+
+### `readExcelToJson<T>(file, options?)`
+
+Read an Excel file and convert the first (or specified) worksheet into JSON.
+
+#### Options
+
+```ts
+{
+  sheetName?: string
+}
+```
+
+#### Returns
+
+```ts
+Promise<T[]>
+```
+
+### Error Handling
+
+* `APIError` – Standardized error class for HTTP requests
+
+```ts
+try {
+  await fetcher("/users")({ method: "GET" })
+} catch (err) {
+  if (err instanceof APIError) {
+    console.error(err.status, err.message)
+  }
+}
+```
+
+---
+
+## ⚠️ Environment Constraint
+
+This library is server-side only.
+
+It must be executed in:
+
+- Node.js
+- Next.js Server Actions
+- Next.js Route Handlers
+- Any server runtime
+
+It **must not** be used in the browser, as `xlsx` is not browser-compatible in this setup.
+
+---
+
+## 🏗 Design Principles
+
+- No global state mutation
+- No external I/O
+- XLSX logic fully encapsulated
+- Caller provides only configuration
+- Strict TypeScript compatibility
+
+---
+
+## Contributing
+
+PRs and issues are welcome. please fork the repository, create a feature branch, ensure all tests and type checks pass, and submit a pull request.
+
+---
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,116 @@
+'use strict';
+
+var XLSX3 = require('xlsx');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var XLSX3__default = /*#__PURE__*/_interopDefault(XLSX3);
+
+// src/index.ts
+function buildSheet(config) {
+  const { header, headerRows, data, mapRow, footerRows } = config;
+  const rows = [];
+  if (headerRows && headerRows.length > 0) {
+    for (let i = 0; i < headerRows.length; i++) {
+      const row = headerRows[i];
+      if (row) rows.push(row);
+    }
+  } else if (header && header.length > 0) {
+    rows.push(header);
+  }
+  for (let i = 0; i < data.length; i++) {
+    const item = data[i];
+    if (item) rows.push(mapRow(item, i));
+  }
+  if (footerRows && footerRows.length > 0) {
+    for (let i = 0; i < footerRows.length; i++) {
+      const footerRow = footerRows[i];
+      if (footerRow) rows.push(footerRow);
+    }
+  }
+  const ws = XLSX3__default.default.utils.aoa_to_sheet(rows);
+  if (config.merges?.length) {
+    ws["!merges"] = config.merges;
+  }
+  const totalRows = rows.length;
+  const headerRowCount = config.headerRowCount ?? (config.headerRows ? config.headerRows.length : 1);
+  return { ws, totalRows, headerRowCount };
+}
+function applyColumnConfig({
+  ws,
+  columns,
+  totalRows,
+  headerRowCount
+}) {
+  ws["!cols"] = columns.map((col) => ({ wpx: col.width ?? 100 }));
+  for (let colIndex = 0; colIndex < columns.length; colIndex++) {
+    const col = columns[colIndex];
+    if (!col) continue;
+    if (!col.type && !col.format) continue;
+    const colLetter = XLSX3__default.default.utils.encode_col(colIndex);
+    for (let row = headerRowCount; row < totalRows; row++) {
+      const cellAddress = `${colLetter}${row + 1}`;
+      const cell = ws[cellAddress];
+      if (!cell) continue;
+      switch (col.type) {
+        case "number":
+          if (typeof cell.v === "number") {
+            cell.t = "n";
+            cell.z = col.format || "#,##0";
+          }
+          break;
+        case "date": {
+          const dt = new Date(cell.v);
+          if (!Number.isNaN(dt.getTime())) {
+            cell.t = "d";
+            cell.v = dt;
+          }
+          break;
+        }
+        default:
+          cell.t = "s";
+      }
+      if (col.format) {
+        cell.z = col.format;
+      }
+    }
+  }
+}
+function writeToBlob(ws, sheetName) {
+  const wb = XLSX3__default.default.utils.book_new();
+  XLSX3__default.default.utils.book_append_sheet(wb, ws, sheetName);
+  const wbout = XLSX3__default.default.write(wb, { bookType: "xlsx", type: "array" });
+  return new Blob([wbout], {
+    type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+  });
+}
+
+// src/index.ts
+function exportToExcel(config) {
+  const { ws, totalRows, headerRowCount } = buildSheet(config);
+  applyColumnConfig({
+    ws,
+    columns: config.columns,
+    totalRows,
+    headerRowCount
+  });
+  return writeToBlob(ws, config.sheetName);
+}
+async function readExcelToJson(file) {
+  const arrayBuffer = await file.arrayBuffer();
+  const workbook = XLSX3__default.default.read(arrayBuffer, { type: "array" });
+  const sheetName = workbook.SheetNames[0];
+  if (!sheetName) {
+    throw new Error("The Excel file does not contain any worksheets.");
+  }
+  const worksheet = workbook.Sheets[sheetName];
+  if (!worksheet) {
+    throw new Error(`Worksheet "${sheetName}" could not be found.`);
+  }
+  return XLSX3__default.default.utils.sheet_to_json(worksheet, { defval: "" });
+}
+
+exports.exportToExcel = exportToExcel;
+exports.readExcelToJson = readExcelToJson;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builder.ts","../src/formatter.ts","../src/writer.ts","../src/index.ts"],"names":["XLSX"],"mappings":"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","file":"index.cjs","sourcesContent":["import XLSX from \"xlsx\"\n\nimport type { ExcelExportConfig } from \"./types\"\n\nexport function buildSheet<T>(config: ExcelExportConfig<T>) {\n\tconst { header, headerRows, data, mapRow, footerRows } = config\n\n\tconst rows: (string | number | Date | null)[][] = []\n\n\tif (headerRows && headerRows.length > 0) {\n\t\tfor (let i = 0; i < headerRows.length; i++) {\n\t\t\tconst row = headerRows[i]\n\t\t\tif (row) rows.push(row)\n\t\t}\n\t} else if (header && header.length > 0) {\n\t\trows.push(header)\n\t}\n\n\tfor (let i = 0; i < data.length; i++) {\n\t\tconst item = data[i]\n\t\tif (item) rows.push(mapRow(item, i))\n\t}\n\n\tif (footerRows && footerRows.length > 0) {\n\t\tfor (let i = 0; i < footerRows.length; i++) {\n\t\t\tconst footerRow = footerRows[i]\n\t\t\tif (footerRow) rows.push(footerRow)\n\t\t}\n\t}\n\n\tconst ws = XLSX.utils.aoa_to_sheet(rows)\n\n\tif (config.merges?.length) {\n\t\tws[\"!merges\"] = config.merges\n\t}\n\n\tconst totalRows = rows.length\n\n\tconst headerRowCount =\n\t\tconfig.headerRowCount ?? (config.headerRows ? config.headerRows.length : 1)\n\n\treturn { ws, totalRows, headerRowCount }\n}\n","import XLSX from \"xlsx\"\n\nimport type { ColumnConfig } from \"./types\"\n\ninterface ApplyProps {\n\tws: XLSX.WorkSheet\n\tcolumns: ColumnConfig[]\n\ttotalRows: number\n\theaderRowCount: number\n}\n\nexport function applyColumnConfig({\n\tws,\n\tcolumns,\n\ttotalRows,\n\theaderRowCount,\n}: ApplyProps) {\n\tws[\"!cols\"] = columns.map((col) => ({ wpx: col.width ?? 100 }))\n\n\tfor (let colIndex = 0; colIndex < columns.length; colIndex++) {\n\t\tconst col = columns[colIndex]\n\t\tif (!col) continue\n\t\tif (!col.type && !col.format) continue\n\n\t\tconst colLetter = XLSX.utils.encode_col(colIndex)\n\n\t\tfor (let row = headerRowCount; row < totalRows; row++) {\n\t\t\tconst cellAddress = `${colLetter}${row + 1}`\n\t\t\tconst cell = ws[cellAddress]\n\t\t\tif (!cell) continue\n\n\t\t\tswitch (col.type) {\n\t\t\t\tcase \"number\":\n\t\t\t\t\tif (typeof cell.v === \"number\") {\n\t\t\t\t\t\tcell.t = \"n\"\n\t\t\t\t\t\tcell.z = col.format || \"#,##0\"\n\t\t\t\t\t}\n\t\t\t\t\tbreak\n\n\t\t\t\tcase \"date\": {\n\t\t\t\t\tconst dt = new Date(cell.v)\n\t\t\t\t\tif (!Number.isNaN(dt.getTime())) {\n\t\t\t\t\t\tcell.t = \"d\"\n\t\t\t\t\t\tcell.v = dt\n\t\t\t\t\t}\n\t\t\t\t\tbreak\n\t\t\t\t}\n\n\t\t\t\tdefault:\n\t\t\t\t\tcell.t = \"s\"\n\t\t\t}\n\n\t\t\tif (col.format) {\n\t\t\t\tcell.z = col.format\n\t\t\t}\n\t\t}\n\t}\n}\n","import XLSX from \"xlsx\"\n\nexport function writeToBlob(ws: XLSX.WorkSheet, sheetName: string) {\n\tconst wb = XLSX.utils.book_new()\n\tXLSX.utils.book_append_sheet(wb, ws, sheetName)\n\n\tconst wbout = XLSX.write(wb, { bookType: \"xlsx\", type: \"array\" })\n\n\treturn new Blob([wbout], {\n\t\ttype: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n\t})\n}\n","import XLSX from \"xlsx\"\n\nimport { buildSheet } from \"./builder\"\nimport { applyColumnConfig } from \"./formatter\"\nimport type { ExcelExportConfig } from \"./types\"\nimport { writeToBlob } from \"./writer\"\n\n/**\n * Generate an Excel file (XLSX) from a declarative configuration.\n *\n * This function builds a worksheet using the provided header, data, and row mapping\n * defined in the configuration object. Each column can define metadata such as\n * data type (string/number/date), column width, and optional custom formatting.\n * Once the worksheet is constructed, the function returns a downloadable XLSX `Blob`.\n *\n * ! Environment Constraint:\n * - This function must be executed in a server-side environment\n *   as `xlsx` is not browser-compatible.\n * - The output is a `Blob` that can safely be sent to the client for download.\n *\n * Guarantees:\n * - No global state is modified.\n * - No external I/O is performed beyond internal workbook operations.\n * - All XLSX logic is fully encapsulated; the caller only provides configuration.\n *\n * @typeParam T - The type of each item in the `data` array.\n *\n * @param config - Excel export configuration.\n *  - `sheetName`: The name of the worksheet.\n *  - `header`: Column order for the first row of the Excel file.\n *  - `columns`: Column metadata (width/type/format).\n *  - `data`: Raw data to be mapped into Excel rows.\n *  - `mapRow`: A function that maps each data item into an array of cell values (aligned with the header).\n *\n * @returns A downloadable Excel `Blob`.\n *\n * @example\n * const blob = await exportToExcel({\n *   sheetName: \"Master Banner\",\n *   header: [\"No\", \"Title\", \"Status\"],\n *   columns: [\n *     { width: 35, type: \"number\" },\n *     { width: 300, type: \"string\" },\n *     { width: 100, type: \"string\" },\n *   ],\n *   data: banners,\n *   mapRow: (item, idx) => [idx + 1, item.title, item.active ? \"Active\" : \"Inactive\"],\n * })\n *\n * // on the client\n * const url = URL.createObjectURL(blob)\n * downloadFile(url, \"master-banner.xlsx\")\n */\nexport function exportToExcel<T = unknown>(config: ExcelExportConfig<T>) {\n\tconst { ws, totalRows, headerRowCount } = buildSheet(config)\n\n\tapplyColumnConfig({\n\t\tws,\n\t\tcolumns: config.columns,\n\t\ttotalRows,\n\t\theaderRowCount,\n\t})\n\n\treturn writeToBlob(ws, config.sheetName)\n}\n\nexport async function readExcelToJson<T>(file: File): Promise<T[]> {\n\tconst arrayBuffer = await file.arrayBuffer()\n\tconst workbook = XLSX.read(arrayBuffer, { type: \"array\" })\n\tconst sheetName = workbook.SheetNames[0]\n\tif (!sheetName) {\n\t\tthrow new Error(\"The Excel file does not contain any worksheets.\")\n\t}\n\tconst worksheet = workbook.Sheets[sheetName]\n\tif (!worksheet) {\n\t\tthrow new Error(`Worksheet \"${sheetName}\" could not be found.`)\n\t}\n\treturn XLSX.utils.sheet_to_json(worksheet, { defval: \"\" })\n}\n\nexport type { ExcelExportConfig }\n"]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+import { ExcelExportConfig } from './types.cjs';
+
+/**
+ * Generate an Excel file (XLSX) from a declarative configuration.
+ *
+ * This function builds a worksheet using the provided header, data, and row mapping
+ * defined in the configuration object. Each column can define metadata such as
+ * data type (string/number/date), column width, and optional custom formatting.
+ * Once the worksheet is constructed, the function returns a downloadable XLSX `Blob`.
+ *
+ * ! Environment Constraint:
+ * - This function must be executed in a server-side environment
+ *   as `xlsx` is not browser-compatible.
+ * - The output is a `Blob` that can safely be sent to the client for download.
+ *
+ * Guarantees:
+ * - No global state is modified.
+ * - No external I/O is performed beyond internal workbook operations.
+ * - All XLSX logic is fully encapsulated; the caller only provides configuration.
+ *
+ * @typeParam T - The type of each item in the `data` array.
+ *
+ * @param config - Excel export configuration.
+ *  - `sheetName`: The name of the worksheet.
+ *  - `header`: Column order for the first row of the Excel file.
+ *  - `columns`: Column metadata (width/type/format).
+ *  - `data`: Raw data to be mapped into Excel rows.
+ *  - `mapRow`: A function that maps each data item into an array of cell values (aligned with the header).
+ *
+ * @returns A downloadable Excel `Blob`.
+ *
+ * @example
+ * const blob = await exportToExcel({
+ *   sheetName: "Master Banner",
+ *   header: ["No", "Title", "Status"],
+ *   columns: [
+ *     { width: 35, type: "number" },
+ *     { width: 300, type: "string" },
+ *     { width: 100, type: "string" },
+ *   ],
+ *   data: banners,
+ *   mapRow: (item, idx) => [idx + 1, item.title, item.active ? "Active" : "Inactive"],
+ * })
+ *
+ * // on the client
+ * const url = URL.createObjectURL(blob)
+ * downloadFile(url, "master-banner.xlsx")
+ */
+declare function exportToExcel<T = unknown>(config: ExcelExportConfig<T>): Blob;
+declare function readExcelToJson<T>(file: File): Promise<T[]>;
+
+export { ExcelExportConfig, exportToExcel, readExcelToJson };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { ExcelExportConfig } from './types.js';
+
+/**
+ * Generate an Excel file (XLSX) from a declarative configuration.
+ *
+ * This function builds a worksheet using the provided header, data, and row mapping
+ * defined in the configuration object. Each column can define metadata such as
+ * data type (string/number/date), column width, and optional custom formatting.
+ * Once the worksheet is constructed, the function returns a downloadable XLSX `Blob`.
+ *
+ * ! Environment Constraint:
+ * - This function must be executed in a server-side environment
+ *   as `xlsx` is not browser-compatible.
+ * - The output is a `Blob` that can safely be sent to the client for download.
+ *
+ * Guarantees:
+ * - No global state is modified.
+ * - No external I/O is performed beyond internal workbook operations.
+ * - All XLSX logic is fully encapsulated; the caller only provides configuration.
+ *
+ * @typeParam T - The type of each item in the `data` array.
+ *
+ * @param config - Excel export configuration.
+ *  - `sheetName`: The name of the worksheet.
+ *  - `header`: Column order for the first row of the Excel file.
+ *  - `columns`: Column metadata (width/type/format).
+ *  - `data`: Raw data to be mapped into Excel rows.
+ *  - `mapRow`: A function that maps each data item into an array of cell values (aligned with the header).
+ *
+ * @returns A downloadable Excel `Blob`.
+ *
+ * @example
+ * const blob = await exportToExcel({
+ *   sheetName: "Master Banner",
+ *   header: ["No", "Title", "Status"],
+ *   columns: [
+ *     { width: 35, type: "number" },
+ *     { width: 300, type: "string" },
+ *     { width: 100, type: "string" },
+ *   ],
+ *   data: banners,
+ *   mapRow: (item, idx) => [idx + 1, item.title, item.active ? "Active" : "Inactive"],
+ * })
+ *
+ * // on the client
+ * const url = URL.createObjectURL(blob)
+ * downloadFile(url, "master-banner.xlsx")
+ */
+declare function exportToExcel<T = unknown>(config: ExcelExportConfig<T>): Blob;
+declare function readExcelToJson<T>(file: File): Promise<T[]>;
+
+export { ExcelExportConfig, exportToExcel, readExcelToJson };

package/dist/index.js

@@ -0,0 +1,109 @@
+import XLSX3 from 'xlsx';
+
+// src/index.ts
+function buildSheet(config) {
+  const { header, headerRows, data, mapRow, footerRows } = config;
+  const rows = [];
+  if (headerRows && headerRows.length > 0) {
+    for (let i = 0; i < headerRows.length; i++) {
+      const row = headerRows[i];
+      if (row) rows.push(row);
+    }
+  } else if (header && header.length > 0) {
+    rows.push(header);
+  }
+  for (let i = 0; i < data.length; i++) {
+    const item = data[i];
+    if (item) rows.push(mapRow(item, i));
+  }
+  if (footerRows && footerRows.length > 0) {
+    for (let i = 0; i < footerRows.length; i++) {
+      const footerRow = footerRows[i];
+      if (footerRow) rows.push(footerRow);
+    }
+  }
+  const ws = XLSX3.utils.aoa_to_sheet(rows);
+  if (config.merges?.length) {
+    ws["!merges"] = config.merges;
+  }
+  const totalRows = rows.length;
+  const headerRowCount = config.headerRowCount ?? (config.headerRows ? config.headerRows.length : 1);
+  return { ws, totalRows, headerRowCount };
+}
+function applyColumnConfig({
+  ws,
+  columns,
+  totalRows,
+  headerRowCount
+}) {
+  ws["!cols"] = columns.map((col) => ({ wpx: col.width ?? 100 }));
+  for (let colIndex = 0; colIndex < columns.length; colIndex++) {
+    const col = columns[colIndex];
+    if (!col) continue;
+    if (!col.type && !col.format) continue;
+    const colLetter = XLSX3.utils.encode_col(colIndex);
+    for (let row = headerRowCount; row < totalRows; row++) {
+      const cellAddress = `${colLetter}${row + 1}`;
+      const cell = ws[cellAddress];
+      if (!cell) continue;
+      switch (col.type) {
+        case "number":
+          if (typeof cell.v === "number") {
+            cell.t = "n";
+            cell.z = col.format || "#,##0";
+          }
+          break;
+        case "date": {
+          const dt = new Date(cell.v);
+          if (!Number.isNaN(dt.getTime())) {
+            cell.t = "d";
+            cell.v = dt;
+          }
+          break;
+        }
+        default:
+          cell.t = "s";
+      }
+      if (col.format) {
+        cell.z = col.format;
+      }
+    }
+  }
+}
+function writeToBlob(ws, sheetName) {
+  const wb = XLSX3.utils.book_new();
+  XLSX3.utils.book_append_sheet(wb, ws, sheetName);
+  const wbout = XLSX3.write(wb, { bookType: "xlsx", type: "array" });
+  return new Blob([wbout], {
+    type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+  });
+}
+
+// src/index.ts
+function exportToExcel(config) {
+  const { ws, totalRows, headerRowCount } = buildSheet(config);
+  applyColumnConfig({
+    ws,
+    columns: config.columns,
+    totalRows,
+    headerRowCount
+  });
+  return writeToBlob(ws, config.sheetName);
+}
+async function readExcelToJson(file) {
+  const arrayBuffer = await file.arrayBuffer();
+  const workbook = XLSX3.read(arrayBuffer, { type: "array" });
+  const sheetName = workbook.SheetNames[0];
+  if (!sheetName) {
+    throw new Error("The Excel file does not contain any worksheets.");
+  }
+  const worksheet = workbook.Sheets[sheetName];
+  if (!worksheet) {
+    throw new Error(`Worksheet "${sheetName}" could not be found.`);
+  }
+  return XLSX3.utils.sheet_to_json(worksheet, { defval: "" });
+}
+
+export { exportToExcel, readExcelToJson };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builder.ts","../src/formatter.ts","../src/writer.ts","../src/index.ts"],"names":["XLSX"],"mappings":";;;AAIO,SAAS,WAAc,MAAA,EAA8B;AAC3D,EAAA,MAAM,EAAE,MAAA,EAAQ,UAAA,EAAY,IAAA,EAAM,MAAA,EAAQ,YAAW,GAAI,MAAA;AAEzD,EAAA,MAAM,OAA4C,EAAC;AAEnD,EAAA,IAAI,UAAA,IAAc,UAAA,CAAW,MAAA,GAAS,CAAA,EAAG;AACxC,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,UAAA,CAAW,QAAQ,CAAA,EAAA,EAAK;AAC3C,MAAA,MAAM,GAAA,GAAM,WAAW,CAAC,CAAA;AACxB,MAAA,IAAI,GAAA,EAAK,IAAA,CAAK,IAAA,CAAK,GAAG,CAAA;AAAA,IACvB;AAAA,EACD,CAAA,MAAA,IAAW,MAAA,IAAU,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG;AACvC,IAAA,IAAA,CAAK,KAAK,MAAM,CAAA;AAAA,EACjB;AAEA,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AACrC,IAAA,MAAM,IAAA,GAAO,KAAK,CAAC,CAAA;AACnB,IAAA,IAAI,MAAM,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,IAAA,EAAM,CAAC,CAAC,CAAA;AAAA,EACpC;AAEA,EAAA,IAAI,UAAA,IAAc,UAAA,CAAW,MAAA,GAAS,CAAA,EAAG;AACxC,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,UAAA,CAAW,QAAQ,CAAA,EAAA,EAAK;AAC3C,MAAA,MAAM,SAAA,GAAY,WAAW,CAAC,CAAA;AAC9B,MAAA,IAAI,SAAA,EAAW,IAAA,CAAK,IAAA,CAAK,SAAS,CAAA;AAAA,IACnC;AAAA,EACD;AAEA,EAAA,MAAM,EAAA,GAAKA,KAAA,CAAK,KAAA,CAAM,YAAA,CAAa,IAAI,CAAA;AAEvC,EAAA,IAAI,MAAA,CAAO,QAAQ,MAAA,EAAQ;AAC1B,IAAA,EAAA,CAAG,SAAS,IAAI,MAAA,CAAO,MAAA;AAAA,EACxB;AAEA,EAAA,MAAM,YAAY,IAAA,CAAK,MAAA;AAEvB,EAAA,MAAM,iBACL,MAAA,CAAO,cAAA,KAAmB,OAAO,UAAA,GAAa,MAAA,CAAO,WAAW,MAAA,GAAS,CAAA,CAAA;AAE1E,EAAA,OAAO,EAAE,EAAA,EAAI,SAAA,EAAW,cAAA,EAAe;AACxC;AC/BO,SAAS,iBAAA,CAAkB;AAAA,EACjC,EAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA,EACA;AACD,CAAA,EAAe;AACd,EAAA,EAAA,CAAG,OAAO,CAAA,GAAI,OAAA,CAAQ,GAAA,CAAI,CAAC,GAAA,MAAS,EAAE,GAAA,EAAK,GAAA,CAAI,KAAA,IAAS,GAAA,EAAI,CAAE,CAAA;AAE9D,EAAA,KAAA,IAAS,QAAA,GAAW,CAAA,EAAG,QAAA,GAAW,OAAA,CAAQ,QAAQ,QAAA,EAAA,EAAY;AAC7D,IAAA,MAAM,GAAA,GAAM,QAAQ,QAAQ,CAAA;AAC5B,IAAA,IAAI,CAAC,GAAA,EAAK;AACV,IAAA,IAAI,CAAC,GAAA,CAAI,IAAA,IAAQ,CAAC,IAAI,MAAA,EAAQ;AAE9B,IAAA,MAAM,SAAA,GAAYA,KAAAA,CAAK,KAAA,CAAM,UAAA,CAAW,QAAQ,CAAA;AAEhD,IAAA,KAAA,IAAS,GAAA,GAAM,cAAA,EAAgB,GAAA,GAAM,SAAA,EAAW,GAAA,EAAA,EAAO;AACtD,MAAA,MAAM,WAAA,GAAc,CAAA,EAAG,SAAS,CAAA,EAAG,MAAM,CAAC,CAAA,CAAA;AAC1C,MAAA,MAAM,IAAA,GAAO,GAAG,WAAW,CAAA;AAC3B,MAAA,IAAI,CAAC,IAAA,EAAM;AAEX,MAAA,QAAQ,IAAI,IAAA;AAAM,QACjB,KAAK,QAAA;AACJ,UAAA,IAAI,OAAO,IAAA,CAAK,CAAA,KAAM,QAAA,EAAU;AAC/B,YAAA,IAAA,CAAK,CAAA,GAAI,GAAA;AACT,YAAA,IAAA,CAAK,CAAA,GAAI,IAAI,MAAA,IAAU,OAAA;AAAA,UACxB;AACA,UAAA;AAAA,QAED,KAAK,MAAA,EAAQ;AACZ,UAAA,MAAM,EAAA,GAAK,IAAI,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA;AAC1B,UAAA,IAAI,CAAC,MAAA,CAAO,KAAA,CAAM,EAAA,CAAG,OAAA,EAAS,CAAA,EAAG;AAChC,YAAA,IAAA,CAAK,CAAA,GAAI,GAAA;AACT,YAAA,IAAA,CAAK,CAAA,GAAI,EAAA;AAAA,UACV;AACA,UAAA;AAAA,QACD;AAAA,QAEA;AACC,UAAA,IAAA,CAAK,CAAA,GAAI,GAAA;AAAA;AAGX,MAAA,IAAI,IAAI,MAAA,EAAQ;AACf,QAAA,IAAA,CAAK,IAAI,GAAA,CAAI,MAAA;AAAA,MACd;AAAA,IACD;AAAA,EACD;AACD;ACvDO,SAAS,WAAA,CAAY,IAAoB,SAAA,EAAmB;AAClE,EAAA,MAAM,EAAA,GAAKA,KAAAA,CAAK,KAAA,CAAM,QAAA,EAAS;AAC/B,EAAAA,KAAAA,CAAK,KAAA,CAAM,iBAAA,CAAkB,EAAA,EAAI,IAAI,SAAS,CAAA;AAE9C,EAAA,MAAM,KAAA,GAAQA,MAAK,KAAA,CAAM,EAAA,EAAI,EAAE,QAAA,EAAU,MAAA,EAAQ,IAAA,EAAM,OAAA,EAAS,CAAA;AAEhE,EAAA,OAAO,IAAI,IAAA,CAAK,CAAC,KAAK,CAAA,EAAG;AAAA,IACxB,IAAA,EAAM;AAAA,GACN,CAAA;AACF;;;AC0CO,SAAS,cAA2B,MAAA,EAA8B;AACxE,EAAA,MAAM,EAAE,EAAA,EAAI,SAAA,EAAW,cAAA,EAAe,GAAI,WAAW,MAAM,CAAA;AAE3D,EAAA,iBAAA,CAAkB;AAAA,IACjB,EAAA;AAAA,IACA,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,SAAA;AAAA,IACA;AAAA,GACA,CAAA;AAED,EAAA,OAAO,WAAA,CAAY,EAAA,EAAI,MAAA,CAAO,SAAS,CAAA;AACxC;AAEA,eAAsB,gBAAmB,IAAA,EAA0B;AAClE,EAAA,MAAM,WAAA,GAAc,MAAM,IAAA,CAAK,WAAA,EAAY;AAC3C,EAAA,MAAM,WAAWA,KAAAA,CAAK,IAAA,CAAK,aAAa,EAAE,IAAA,EAAM,SAAS,CAAA;AACzD,EAAA,MAAM,SAAA,GAAY,QAAA,CAAS,UAAA,CAAW,CAAC,CAAA;AACvC,EAAA,IAAI,CAAC,SAAA,EAAW;AACf,IAAA,MAAM,IAAI,MAAM,iDAAiD,CAAA;AAAA,EAClE;AACA,EAAA,MAAM,SAAA,GAAY,QAAA,CAAS,MAAA,CAAO,SAAS,CAAA;AAC3C,EAAA,IAAI,CAAC,SAAA,EAAW;AACf,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,WAAA,EAAc,SAAS,CAAA,qBAAA,CAAuB,CAAA;AAAA,EAC/D;AACA,EAAA,OAAOA,MAAK,KAAA,CAAM,aAAA,CAAc,WAAW,EAAE,MAAA,EAAQ,IAAI,CAAA;AAC1D","file":"index.js","sourcesContent":["import XLSX from \"xlsx\"\n\nimport type { ExcelExportConfig } from \"./types\"\n\nexport function buildSheet<T>(config: ExcelExportConfig<T>) {\n\tconst { header, headerRows, data, mapRow, footerRows } = config\n\n\tconst rows: (string | number | Date | null)[][] = []\n\n\tif (headerRows && headerRows.length > 0) {\n\t\tfor (let i = 0; i < headerRows.length; i++) {\n\t\t\tconst row = headerRows[i]\n\t\t\tif (row) rows.push(row)\n\t\t}\n\t} else if (header && header.length > 0) {\n\t\trows.push(header)\n\t}\n\n\tfor (let i = 0; i < data.length; i++) {\n\t\tconst item = data[i]\n\t\tif (item) rows.push(mapRow(item, i))\n\t}\n\n\tif (footerRows && footerRows.length > 0) {\n\t\tfor (let i = 0; i < footerRows.length; i++) {\n\t\t\tconst footerRow = footerRows[i]\n\t\t\tif (footerRow) rows.push(footerRow)\n\t\t}\n\t}\n\n\tconst ws = XLSX.utils.aoa_to_sheet(rows)\n\n\tif (config.merges?.length) {\n\t\tws[\"!merges\"] = config.merges\n\t}\n\n\tconst totalRows = rows.length\n\n\tconst headerRowCount =\n\t\tconfig.headerRowCount ?? (config.headerRows ? config.headerRows.length : 1)\n\n\treturn { ws, totalRows, headerRowCount }\n}\n","import XLSX from \"xlsx\"\n\nimport type { ColumnConfig } from \"./types\"\n\ninterface ApplyProps {\n\tws: XLSX.WorkSheet\n\tcolumns: ColumnConfig[]\n\ttotalRows: number\n\theaderRowCount: number\n}\n\nexport function applyColumnConfig({\n\tws,\n\tcolumns,\n\ttotalRows,\n\theaderRowCount,\n}: ApplyProps) {\n\tws[\"!cols\"] = columns.map((col) => ({ wpx: col.width ?? 100 }))\n\n\tfor (let colIndex = 0; colIndex < columns.length; colIndex++) {\n\t\tconst col = columns[colIndex]\n\t\tif (!col) continue\n\t\tif (!col.type && !col.format) continue\n\n\t\tconst colLetter = XLSX.utils.encode_col(colIndex)\n\n\t\tfor (let row = headerRowCount; row < totalRows; row++) {\n\t\t\tconst cellAddress = `${colLetter}${row + 1}`\n\t\t\tconst cell = ws[cellAddress]\n\t\t\tif (!cell) continue\n\n\t\t\tswitch (col.type) {\n\t\t\t\tcase \"number\":\n\t\t\t\t\tif (typeof cell.v === \"number\") {\n\t\t\t\t\t\tcell.t = \"n\"\n\t\t\t\t\t\tcell.z = col.format || \"#,##0\"\n\t\t\t\t\t}\n\t\t\t\t\tbreak\n\n\t\t\t\tcase \"date\": {\n\t\t\t\t\tconst dt = new Date(cell.v)\n\t\t\t\t\tif (!Number.isNaN(dt.getTime())) {\n\t\t\t\t\t\tcell.t = \"d\"\n\t\t\t\t\t\tcell.v = dt\n\t\t\t\t\t}\n\t\t\t\t\tbreak\n\t\t\t\t}\n\n\t\t\t\tdefault:\n\t\t\t\t\tcell.t = \"s\"\n\t\t\t}\n\n\t\t\tif (col.format) {\n\t\t\t\tcell.z = col.format\n\t\t\t}\n\t\t}\n\t}\n}\n","import XLSX from \"xlsx\"\n\nexport function writeToBlob(ws: XLSX.WorkSheet, sheetName: string) {\n\tconst wb = XLSX.utils.book_new()\n\tXLSX.utils.book_append_sheet(wb, ws, sheetName)\n\n\tconst wbout = XLSX.write(wb, { bookType: \"xlsx\", type: \"array\" })\n\n\treturn new Blob([wbout], {\n\t\ttype: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n\t})\n}\n","import XLSX from \"xlsx\"\n\nimport { buildSheet } from \"./builder\"\nimport { applyColumnConfig } from \"./formatter\"\nimport type { ExcelExportConfig } from \"./types\"\nimport { writeToBlob } from \"./writer\"\n\n/**\n * Generate an Excel file (XLSX) from a declarative configuration.\n *\n * This function builds a worksheet using the provided header, data, and row mapping\n * defined in the configuration object. Each column can define metadata such as\n * data type (string/number/date), column width, and optional custom formatting.\n * Once the worksheet is constructed, the function returns a downloadable XLSX `Blob`.\n *\n * ! Environment Constraint:\n * - This function must be executed in a server-side environment\n *   as `xlsx` is not browser-compatible.\n * - The output is a `Blob` that can safely be sent to the client for download.\n *\n * Guarantees:\n * - No global state is modified.\n * - No external I/O is performed beyond internal workbook operations.\n * - All XLSX logic is fully encapsulated; the caller only provides configuration.\n *\n * @typeParam T - The type of each item in the `data` array.\n *\n * @param config - Excel export configuration.\n *  - `sheetName`: The name of the worksheet.\n *  - `header`: Column order for the first row of the Excel file.\n *  - `columns`: Column metadata (width/type/format).\n *  - `data`: Raw data to be mapped into Excel rows.\n *  - `mapRow`: A function that maps each data item into an array of cell values (aligned with the header).\n *\n * @returns A downloadable Excel `Blob`.\n *\n * @example\n * const blob = await exportToExcel({\n *   sheetName: \"Master Banner\",\n *   header: [\"No\", \"Title\", \"Status\"],\n *   columns: [\n *     { width: 35, type: \"number\" },\n *     { width: 300, type: \"string\" },\n *     { width: 100, type: \"string\" },\n *   ],\n *   data: banners,\n *   mapRow: (item, idx) => [idx + 1, item.title, item.active ? \"Active\" : \"Inactive\"],\n * })\n *\n * // on the client\n * const url = URL.createObjectURL(blob)\n * downloadFile(url, \"master-banner.xlsx\")\n */\nexport function exportToExcel<T = unknown>(config: ExcelExportConfig<T>) {\n\tconst { ws, totalRows, headerRowCount } = buildSheet(config)\n\n\tapplyColumnConfig({\n\t\tws,\n\t\tcolumns: config.columns,\n\t\ttotalRows,\n\t\theaderRowCount,\n\t})\n\n\treturn writeToBlob(ws, config.sheetName)\n}\n\nexport async function readExcelToJson<T>(file: File): Promise<T[]> {\n\tconst arrayBuffer = await file.arrayBuffer()\n\tconst workbook = XLSX.read(arrayBuffer, { type: \"array\" })\n\tconst sheetName = workbook.SheetNames[0]\n\tif (!sheetName) {\n\t\tthrow new Error(\"The Excel file does not contain any worksheets.\")\n\t}\n\tconst worksheet = workbook.Sheets[sheetName]\n\tif (!worksheet) {\n\t\tthrow new Error(`Worksheet \"${sheetName}\" could not be found.`)\n\t}\n\treturn XLSX.utils.sheet_to_json(worksheet, { defval: \"\" })\n}\n\nexport type { ExcelExportConfig }\n"]}

package/dist/types.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}

package/dist/types.d.cts

@@ -0,0 +1,28 @@
+interface CellMergeRange {
+    s: {
+        r: number;
+        c: number;
+    };
+    e: {
+        r: number;
+        c: number;
+    };
+}
+interface ColumnConfig {
+    width?: number;
+    type?: "string" | "number" | "date";
+    format?: string;
+}
+interface ExcelExportConfig<T = unknown> {
+    sheetName: string;
+    header?: string[];
+    headerRows?: (string | null)[][];
+    footerRows?: (string | number | Date | null)[][];
+    headerRowCount?: number;
+    columns: ColumnConfig[];
+    data: T[];
+    mapRow: (item: T, index: number) => (string | number | Date | null)[];
+    merges?: CellMergeRange[];
+}
+
+export type { CellMergeRange, ColumnConfig, ExcelExportConfig };

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+interface CellMergeRange {
+    s: {
+        r: number;
+        c: number;
+    };
+    e: {
+        r: number;
+        c: number;
+    };
+}
+interface ColumnConfig {
+    width?: number;
+    type?: "string" | "number" | "date";
+    format?: string;
+}
+interface ExcelExportConfig<T = unknown> {
+    sheetName: string;
+    header?: string[];
+    headerRows?: (string | null)[][];
+    footerRows?: (string | number | Date | null)[][];
+    headerRowCount?: number;
+    columns: ColumnConfig[];
+    data: T[];
+    mapRow: (item: T, index: number) => (string | number | Date | null)[];
+    merges?: CellMergeRange[];
+}
+
+export type { CellMergeRange, ColumnConfig, ExcelExportConfig };

package/dist/types.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/package.json

@@ -0,0 +1,72 @@
+{
+	"name": "@farhantallei/excel",
+	"version": "1.0.0",
+	"license": "MIT",
+	"description": "Declarative and type-safe Excel (XLSX) export for Node.js.",
+	"keywords": [
+		"excel",
+		"xlsx",
+		"excel-export",
+		"xlsx-export",
+		"typescript",
+		"type-safe",
+		"nodejs",
+		"server-only",
+		"spreadsheet",
+		"excel-generator",
+		"excel-builder",
+		"data-export",
+		"tabular-data"
+	],
+	"author": {
+		"name": "Farhan Pradana Tallei",
+		"email": "farhan.pradana55@gmail.com"
+	},
+	"module": "dist/index.js",
+	"type": "module",
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"build": "tsup --config tsup.config.ts",
+		"lint": "biome check",
+		"format": "biome check --write --unsafe",
+		"publint": "publint",
+		"typecheck": "tsc --noEmit",
+		"test": "bun test",
+		"prepare": "bun run build"
+	},
+	"files": [
+		"dist"
+	],
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org/",
+		"access": "public"
+	},
+	"homepage": "https://github.com/farhantallei/excel",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
+		},
+		"./types": {
+			"types": "./dist/types.d.ts"
+		}
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.15",
+		"@types/bun": "latest",
+		"publint": "^0.3.17",
+		"tsup": "^8.5.1"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	},
+	"dependencies": {
+		"xlsx": "^0.18.5"
+	}
+}