From 670a4968fe9276af6a7c68cf0407e45268e08a52 Mon Sep 17 00:00:00 2001
From: Alex Caza <alex@alexcaza.com>
Date: Mon, 11 Mar 2024 20:26:45 -0400
Subject: [PATCH 1/7] Improve typing (#95)

* Add error for unsupported data format

* Add AcceptedData union type and FormattedData newtype

* Implement new types

Also extracts logic from formatData into easier to understand functions

* Fix helpers tests to comply with newtype

* Properly quote "null" values in main test

* Add null value test to e2e test

* Add test case for replacing undefined

* Fix formatting of test
---
 integration/index.html        |   2 +
 lib/__specs__/helpers.spec.ts |  24 +++----
 lib/__specs__/main.spec.ts    |  57 +++++++++++++++-
 lib/errors.ts                 |   7 ++
 lib/generator.ts              |  17 ++++-
 lib/helpers.ts                | 120 ++++++++++++++++++++++++----------
 lib/types.ts                  |   7 ++
 7 files changed, 185 insertions(+), 49 deletions(-)

diff --git a/integration/index.html b/integration/index.html
index c2ee300..68c3154 100644
--- a/integration/index.html
+++ b/integration/index.html
@@ -25,12 +25,14 @@
           date: "2023-09-01",
           percentage: 0.4,
           quoted: '"Pickles"',
+          nullish: null,
         },
         {
           name: "Keiko",
           date: "2023-09-01",
           percentage: 0.9,
           quoted: '"Cactus"',
+          nullish: "test",
         },
       ];
 
diff --git a/lib/__specs__/helpers.spec.ts b/lib/__specs__/helpers.spec.ts
index aaee34a..95d800c 100644
--- a/lib/__specs__/helpers.spec.ts
+++ b/lib/__specs__/helpers.spec.ts
@@ -12,7 +12,7 @@ import {
   thread,
 } from "../helpers.ts";
 import { byteOrderMark, endOfLine, mkConfig } from "../config.ts";
-import { mkCsvOutput, mkCsvRow, unpack } from "../types.ts";
+import { mkCsvOutput, mkCsvRow, mkFormattedData, unpack } from "../types.ts";
 
 describe("Helpers", () => {
   describe("thread", () => {
@@ -119,7 +119,9 @@ describe("Helpers", () => {
     it("should add item to row", () => {
       const config = mkConfig({});
       const input = mkCsvRow("test,one,two,");
-      const output = asString(buildRow(config)(input, "house"));
+      const output = asString(
+        buildRow(config)(input, mkFormattedData("house")),
+      );
 
       expect(output).toBe("test,one,two,house,");
     });
@@ -208,7 +210,7 @@ describe("Helpers", () => {
         decimalSeparator: "locale",
       });
       const formatted = formatData(config, 0.6);
-      expect(formatted).toEqual((0.6).toLocaleString());
+      expect(formatted).toEqual(mkFormattedData((0.6).toLocaleString()));
     });
 
     it("should use custom decimal separator if set", () => {
@@ -216,24 +218,24 @@ describe("Helpers", () => {
         decimalSeparator: "|",
       });
       const formatted = formatData(config, 0.6);
-      expect(formatted).toEqual("0|6");
+      expect(formatted).toEqual(mkFormattedData("0|6"));
     });
 
     it("should properly quote strings that may conflict with generation", () => {
       // Default case should quote stings
       let config = mkConfig({});
       const defaultQuote = formatData(config, "test");
-      expect(defaultQuote).toEqual('"test"');
+      expect(defaultQuote).toEqual(mkFormattedData('"test"'));
 
       // Use custom quote strings
       config = mkConfig({ quoteCharacter: "^" });
       const customQuotes = formatData(config, "test");
-      expect(customQuotes).toEqual("^test^");
+      expect(customQuotes).toEqual(mkFormattedData("^test^"));
 
       // Disable quoting strings
       config = mkConfig({ quoteStrings: false });
       const disableQuotes = formatData(config, "test");
-      expect(disableQuotes).toEqual("test");
+      expect(disableQuotes).toEqual(mkFormattedData("test"));
     });
 
     describe("force quote problem characters", () => {
@@ -241,22 +243,22 @@ describe("Helpers", () => {
         // Quote field separator
         let config = mkConfig({ quoteStrings: false });
         const customQuote = formatData(config, ",");
-        expect(customQuote).toEqual('","');
+        expect(customQuote).toEqual(mkFormattedData('","'));
 
         // Wrap new line
         config = mkConfig({ quoteStrings: false });
         const wrapNewLine = formatData(config, "test\n");
-        expect(wrapNewLine).toEqual('"test\n"');
+        expect(wrapNewLine).toEqual(mkFormattedData('"test\n"'));
 
         // Wrap carrage return
         config = mkConfig({ quoteStrings: false });
         const wrapCR = formatData(config, "test\r");
-        expect(wrapCR).toEqual('"test\r"');
+        expect(wrapCR).toEqual(mkFormattedData('"test\r"'));
 
         // Force quote with custom character
         config = mkConfig({ quoteStrings: false, quoteCharacter: "|" });
         const wrapCRWithCustom = formatData(config, "test\r");
-        expect(wrapCRWithCustom).toEqual("|test\r|");
+        expect(wrapCRWithCustom).toEqual(mkFormattedData("|test\r|"));
       });
     });
   });
diff --git a/lib/__specs__/main.spec.ts b/lib/__specs__/main.spec.ts
index 060c931..0df4056 100644
--- a/lib/__specs__/main.spec.ts
+++ b/lib/__specs__/main.spec.ts
@@ -147,7 +147,7 @@ describe("ExportToCsv", () => {
       ]),
     );
 
-    expect(output).toBe('"non-null","nullish"\r\n24,null\r\n');
+    expect(output).toBe('"non-null","nullish"\r\n24,"null"\r\n');
   });
 
   it("should convert undefined to empty string by default", () => {
@@ -175,6 +175,32 @@ describe("ExportToCsv", () => {
     );
   });
 
+  it("should replace undefined with specified value", () => {
+    const options: ConfigOptions = {
+      filename: "Test Csv 2",
+      useBom: false,
+      showColumnHeaders: true,
+      useKeysAsHeaders: true,
+      replaceUndefinedWith: "TEST",
+    };
+
+    const output = asString(
+      generateCsv(options)([
+        {
+          car: "toyota",
+          color: "blue",
+        },
+        {
+          car: "chevrolet",
+        },
+      ]),
+    );
+
+    expect(output).toBe(
+      '"car","color"\r\n"toyota","blue"\r\n"chevrolet","TEST"\r\n',
+    );
+  });
+
   it("should handle varying data shapes by manually setting column headers", () => {
     const options: ConfigOptions = {
       filename: "Test Csv 2",
@@ -375,7 +401,7 @@ describe("ExportToCsv As A Text File", () => {
       ]),
     );
 
-    expect(output).toBe('"non-null","nullish"\r\n24,null\r\n');
+    expect(output).toBe('"non-null","nullish"\r\n24,"null"\r\n');
   });
 
   it("should convert undefined to empty string by default", () => {
@@ -404,6 +430,33 @@ describe("ExportToCsv As A Text File", () => {
     );
   });
 
+  it("should replace undefined with specified value", () => {
+    const options: ConfigOptions = {
+      filename: "Test Csv 2",
+      useTextFile: true,
+      useBom: false,
+      showColumnHeaders: true,
+      useKeysAsHeaders: true,
+      replaceUndefinedWith: "TEST",
+    };
+
+    const output = asString(
+      generateCsv(options)([
+        {
+          car: "toyota",
+          color: "blue",
+        },
+        {
+          car: "chevrolet",
+        },
+      ]),
+    );
+
+    expect(output).toBe(
+      '"car","color"\r\n"toyota","blue"\r\n"chevrolet","TEST"\r\n',
+    );
+  });
+
   it("should handle varying data shapes by manually setting column headers", () => {
     const options: ConfigOptions = {
       filename: "Test Csv 2",
diff --git a/lib/errors.ts b/lib/errors.ts
index 9d6fe69..89317a9 100644
--- a/lib/errors.ts
+++ b/lib/errors.ts
@@ -18,3 +18,10 @@ export class CsvDownloadEnvironmentError extends Error {
     this.name = "CsvDownloadEnvironmentError";
   }
 }
+
+export class UnsupportedDataFormatError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "UnsupportedDataFormatError";
+  }
+}
diff --git a/lib/generator.ts b/lib/generator.ts
index 86a5d0e..01571b0 100644
--- a/lib/generator.ts
+++ b/lib/generator.ts
@@ -5,7 +5,14 @@
 import { mkConfig } from "./config.ts";
 import { CsvDownloadEnvironmentError, CsvGenerationError } from "./errors.ts";
 import { addBOM, addBody, addHeaders, addTitle, thread } from "./helpers.ts";
-import { CsvOutput, ConfigOptions, IO, mkCsvOutput, unpack } from "./types.ts";
+import {
+  CsvOutput,
+  ConfigOptions,
+  IO,
+  mkCsvOutput,
+  unpack,
+  AcceptedData,
+} from "./types.ts";
 
 /**
  *
@@ -19,7 +26,13 @@ import { CsvOutput, ConfigOptions, IO, mkCsvOutput, unpack } from "./types.ts";
  */
 export const generateCsv =
   (config: ConfigOptions) =>
-  <T extends { [k: string | number]: unknown }>(data: Array<T>): CsvOutput => {
+  <
+    T extends {
+      [k: string | number]: AcceptedData;
+    },
+  >(
+    data: Array<T>,
+  ): CsvOutput => {
     const withDefaults = mkConfig(config);
     const headers = withDefaults.useKeysAsHeaders
       ? Object.keys(data[0])
diff --git a/lib/helpers.ts b/lib/helpers.ts
index 8b45468..7665dfc 100644
--- a/lib/helpers.ts
+++ b/lib/helpers.ts
@@ -1,16 +1,19 @@
 import { byteOrderMark, endOfLine } from "./config.ts";
-import { EmptyHeadersError } from "./errors.ts";
+import { EmptyHeadersError, UnsupportedDataFormatError } from "./errors.ts";
 import {
+  AcceptedData,
   ColumnHeader,
   ConfigOptions,
   CsvOutput,
   CsvRow,
+  FormattedData,
   HeaderDisplayLabel,
   HeaderKey,
   Newtype,
   WithDefaults,
   mkCsvOutput,
   mkCsvRow,
+  mkFormattedData,
   mkHeaderDisplayLabel,
   mkHeaderKey,
   pack,
@@ -51,8 +54,8 @@ export const addEndOfLine =
 
 export const buildRow =
   (config: WithDefaults<ConfigOptions>) =>
-  (row: CsvRow, data: string): CsvRow =>
-    addFieldSeparator(config)(mkCsvRow(row + data));
+  (row: CsvRow, data: FormattedData): CsvRow =>
+    addFieldSeparator(config)(mkCsvRow(unpack(row) + unpack(data)));
 
 export const addFieldSeparator =
   (config: WithDefaults<ConfigOptions>) =>
@@ -75,7 +78,7 @@ export const addHeaders =
     let row = mkCsvRow("");
     for (let keyPos = 0; keyPos < headers.length; keyPos++) {
       const header = getHeaderDisplayLabel(headers[keyPos]);
-      row = buildRow(config)(row, formatData(config, header));
+      row = buildRow(config)(row, formatData(config, unpack(header)));
     }
 
     row = mkCsvRow(unpack(row).slice(0, -1));
@@ -83,7 +86,7 @@ export const addHeaders =
   };
 
 export const addBody =
-  <T extends Array<{ [k: string]: unknown }>>(
+  <T extends Array<{ [k: string]: AcceptedData }>>(
     config: WithDefaults<ConfigOptions>,
     headers: Array<ColumnHeader>,
     bodyData: T,
@@ -94,10 +97,7 @@ export const addBody =
       let row = mkCsvRow("");
       for (let keyPos = 0; keyPos < headers.length; keyPos++) {
         const header = getHeaderKey(headers[keyPos]);
-        const data =
-          typeof bodyData[i][unpack(header)] === "undefined"
-            ? config.replaceUndefinedWith
-            : bodyData[i][unpack(header)];
+        const data = bodyData[i][unpack(header)];
         row = buildRow(config)(row, formatData(config, data));
       }
 
@@ -118,42 +118,94 @@ export const addBody =
  */
 export const asString = unpack<Newtype<any, string>>;
 
-const isFloat = (input: any): boolean =>
+const isFloat = (input: boolean | string | number): boolean =>
   +input === input && (!isFinite(input) || Boolean(input % 1));
 
-export const formatData = (config: ConfigOptions, data: any): string => {
-  if (config.decimalSeparator === "locale" && isFloat(data)) {
-    return data.toLocaleString();
+const formatNumber = (config: ConfigOptions, data: number): FormattedData => {
+  if (isFloat(data)) {
+    if (config.decimalSeparator === "locale") {
+      return mkFormattedData(data.toLocaleString());
+    }
+    if (config.decimalSeparator) {
+      return mkFormattedData(
+        data.toString().replace(".", config.decimalSeparator),
+      );
+    }
   }
 
-  if (config.decimalSeparator !== "." && isFloat(data)) {
-    return data.toString().replace(".", config.decimalSeparator);
+  return mkFormattedData(data.toString());
+};
+
+const formatString = (config: ConfigOptions, data: string): FormattedData => {
+  let val = data;
+  if (
+    config.quoteStrings ||
+    (config.fieldSeparator && data.indexOf(config.fieldSeparator) > -1) ||
+    (config.quoteCharacter && data.indexOf(config.quoteCharacter) > -1) ||
+    data.indexOf("\n") > -1 ||
+    data.indexOf("\r") > -1
+  ) {
+    val =
+      config.quoteCharacter +
+      escapeDoubleQuotes(data, config.quoteCharacter) +
+      config.quoteCharacter;
+  }
+  return mkFormattedData(val);
+};
+
+const formatBoolean = (config: ConfigOptions, data: boolean): FormattedData => {
+  // Convert to string to use as lookup in config
+  const asStr = data ? "true" : "false";
+  // Return the custom boolean display. We expect the callsite to validate
+  // that `boolDisplay` is set.
+  return mkFormattedData(config.boolDisplay![asStr]);
+};
+
+const formatNullish = (
+  config: ConfigOptions,
+  data: null | undefined,
+): FormattedData => {
+  if (
+    typeof data === "undefined" &&
+    config.replaceUndefinedWith !== undefined
+  ) {
+    // Coerce whatever was passed to a string
+    return formatString(config, config.replaceUndefinedWith + "");
+  }
+
+  if (data === null) {
+    return formatString(config, "null");
+  }
+
+  return formatString(config, "");
+};
+
+export const formatData = (
+  config: ConfigOptions,
+  data: AcceptedData,
+): FormattedData => {
+  if (typeof data === "number") {
+    return formatNumber(config, data);
   }
 
   if (typeof data === "string") {
-    let val = data;
-    if (
-      config.quoteStrings ||
-      (config.fieldSeparator && data.indexOf(config.fieldSeparator) > -1) ||
-      (config.quoteCharacter && data.indexOf(config.quoteCharacter) > -1) ||
-      data.indexOf("\n") > -1 ||
-      data.indexOf("\r") > -1
-    ) {
-      val =
-        config.quoteCharacter +
-        escapeDoubleQuotes(data, config.quoteCharacter) +
-        config.quoteCharacter;
-    }
-    return val;
+    return formatString(config, data);
   }
 
   if (typeof data === "boolean" && config.boolDisplay) {
-    // Convert to string to use as lookup in config
-    const asStr = data ? "true" : "false";
-    // Return the custom boolean display if set
-    return config.boolDisplay[asStr];
+    return formatBoolean(config, data);
   }
-  return data;
+
+  if (data === null || typeof data === "undefined") {
+    return formatNullish(config, data);
+  }
+
+  throw new UnsupportedDataFormatError(
+    `
+    typeof ${typeof data} isn't supported. Only number, string, boolean, null and undefined are supported.
+    Please convert the data in your object to one of those before generating the CSV.
+    `,
+  );
 };
 
 /**
diff --git a/lib/types.ts b/lib/types.ts
index 07f1fee..8690173 100644
--- a/lib/types.ts
+++ b/lib/types.ts
@@ -31,6 +31,12 @@ export type HeaderDisplayLabel = Newtype<
   string
 >;
 
+export type AcceptedData = number | string | boolean | null | undefined;
+export type FormattedData = Newtype<
+  { readonly FormattedData: unique symbol },
+  string
+>;
+
 export type CsvOutput = Newtype<{ readonly CsvOutput: unique symbol }, string>;
 
 export type CsvRow = Newtype<{ readonly CsvRow: unique symbol }, string>;
@@ -43,6 +49,7 @@ export const pack = <T extends Newtype<any, any>>(value: T["_A"]): T =>
 export const unpack = <T extends Newtype<any, any>>(newtype: T): T["_A"] =>
   newtype as any as T["_A"];
 
+export const mkFormattedData = pack<FormattedData>;
 export const mkCsvOutput = pack<CsvOutput>;
 export const mkCsvRow = pack<CsvRow>;
 export const mkHeaderKey = pack<HeaderKey>;

From f248dbea25d7cf6b3317f4e03d55788cdd5916fe Mon Sep 17 00:00:00 2001
From: Alex Caza <alex@alexcaza.com>
Date: Tue, 9 Apr 2024 20:37:42 -0400
Subject: [PATCH 2/7] Add test case for fieldSeparator in main tests (#97)

* Remove duplicate tests for text export

It overs no real extra coverage as text export is functionally the same. The only difference is in the file extension, which is covered with the integration tests.

* Add main test for fieldSeparator

* Bump playwright version
---
 bun.lockb                  | Bin 21651 -> 22029 bytes
 flake.lock                 |  12 +-
 lib/__specs__/main.spec.ts | 228 ++-----------------------------------
 package.json               |   2 +-
 4 files changed, 19 insertions(+), 223 deletions(-)

diff --git a/bun.lockb b/bun.lockb
index fd261c7b3752e563f8ab2b2436842118ff597dde..b4dce7dfd2220d09bcdf03216e6adf808cadb0ee 100755
GIT binary patch
delta 2427
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

delta 2109
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
JLDcF~{{qxeZe;)f

diff --git a/flake.lock b/flake.lock
index c2b76b9..35cfdb9 100644
--- a/flake.lock
+++ b/flake.lock
@@ -5,11 +5,11 @@
         "systems": "systems"
       },
       "locked": {
-        "lastModified": 1709126324,
-        "narHash": "sha256-q6EQdSeUZOG26WelxqkmR7kArjgWCdw5sfJVHPH/7j8=",
+        "lastModified": 1710146030,
+        "narHash": "sha256-SZ5L6eA7HJ/nmkzGG7/ISclqe6oZdOZTNoesiInkXPQ=",
         "owner": "numtide",
         "repo": "flake-utils",
-        "rev": "d465f4819400de7c8d874d50b982301f28a84605",
+        "rev": "b1d9ab70662946ef0850d488da1c9019f3a9752a",
         "type": "github"
       },
       "original": {
@@ -20,11 +20,11 @@
     },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1708984720,
-        "narHash": "sha256-gJctErLbXx4QZBBbGp78PxtOOzsDaQ+yw1ylNQBuSUY=",
+        "lastModified": 1709961763,
+        "narHash": "sha256-6H95HGJHhEZtyYA3rIQpvamMKAGoa8Yh2rFV29QnuGw=",
         "owner": "nixos",
         "repo": "nixpkgs",
-        "rev": "13aff9b34cc32e59d35c62ac9356e4a41198a538",
+        "rev": "3030f185ba6a4bf4f18b87f345f104e6a6961f34",
         "type": "github"
       },
       "original": {
diff --git a/lib/__specs__/main.spec.ts b/lib/__specs__/main.spec.ts
index 0df4056..32877a8 100644
--- a/lib/__specs__/main.spec.ts
+++ b/lib/__specs__/main.spec.ts
@@ -43,6 +43,18 @@ describe("ExportToCsv", () => {
     expect(typeof string === "string").toBeTruthy();
   });
 
+  it("should use fieldSeparator if supplied", () => {
+    const options: ConfigOptions = {
+      title: "Test Csv",
+      useBom: false,
+      useKeysAsHeaders: true,
+      fieldSeparator: ";",
+    };
+
+    const string = asString(generateCsv(options)([{ test: "hello" }]));
+    expect(string).toEqual('"test"\r\n"hello"\r\n');
+  });
+
   it("should use keys of first object in collection as headers", () => {
     const options: ConfigOptions = {
       title: "Test Csv",
@@ -300,219 +312,3 @@ describe("ExportToCsv", () => {
     expect(firstLine).toBe("Test Csv 2\r");
   });
 });
-
-describe("ExportToCsv As A Text File", () => {
-  it("should create a comma seperated string", () => {
-    const options: ConfigOptions = {
-      title: "Test Csv 1",
-      useTextFile: true,
-      useBom: true,
-      showColumnHeaders: true,
-      useKeysAsHeaders: true,
-    };
-
-    const string = asString(generateCsv(options)(mockData));
-    expect(typeof string === "string").toBeTruthy();
-  });
-
-  it("should use keys of first object in collection as headers", () => {
-    const options: ConfigOptions = {
-      filename: "Test Csv 2",
-      useTextFile: true,
-      useBom: true,
-      showColumnHeaders: true,
-      useKeysAsHeaders: true,
-    };
-
-    const output = asString(generateCsv(options)(mockData));
-
-    const firstLine = output.split("\n")[0];
-    const keys = firstLine.split(",").map((s: string) => s.trim());
-
-    expect(keys).toEqual([
-      '"name"',
-      '"age"',
-      '"average"',
-      '"approved"',
-      '"description"',
-      '"quotedNumber"',
-    ]);
-  });
-
-  it("should only use columns in columnHeaders", () => {
-    const options: ConfigOptions = {
-      filename: "Test Csv 2",
-      useTextFile: true,
-      useBom: true,
-      showColumnHeaders: true,
-      columnHeaders: ["name", "age"],
-    };
-
-    const output = asString(generateCsv(options)(mockData));
-
-    const firstLine = output.split("\n")[0];
-    const keys = firstLine.split(",").map((s: string) => s.trim());
-
-    expect(keys).toEqual(['"name"', '"age"']);
-  });
-
-  it("should allow only headers to be generated", () => {
-    const options: ConfigOptions = {
-      filename: "Test Csv 2",
-      useTextFile: true,
-      useBom: false,
-      showColumnHeaders: true,
-      columnHeaders: ["name", "age"],
-    };
-
-    const output = asString(generateCsv(options)([]));
-
-    expect(output).toEqual('"name","age"\r\n');
-  });
-
-  it("should throw when no data supplied", () => {
-    const options: ConfigOptions = {
-      filename: "Test Csv 2",
-      useTextFile: true,
-      useBom: false,
-      showColumnHeaders: false,
-    };
-
-    expect(() => {
-      generateCsv(options)([]);
-    }).toThrow();
-  });
-
-  it("should allow null values", () => {
-    const options: ConfigOptions = {
-      filename: "Test Csv 2",
-      useTextFile: true,
-      useBom: false,
-      showColumnHeaders: true,
-      useKeysAsHeaders: true,
-    };
-
-    const output = asString(
-      generateCsv(options)([
-        {
-          "non-null": 24,
-          nullish: null,
-        },
-      ]),
-    );
-
-    expect(output).toBe('"non-null","nullish"\r\n24,"null"\r\n');
-  });
-
-  it("should convert undefined to empty string by default", () => {
-    const options: ConfigOptions = {
-      filename: "Test Csv 2",
-      useTextFile: true,
-      useBom: false,
-      showColumnHeaders: true,
-      useKeysAsHeaders: true,
-    };
-
-    const output = asString(
-      generateCsv(options)([
-        {
-          car: "toyota",
-          color: "blue",
-        },
-        {
-          car: "chevrolet",
-        },
-      ]),
-    );
-
-    expect(output).toBe(
-      '"car","color"\r\n"toyota","blue"\r\n"chevrolet",""\r\n',
-    );
-  });
-
-  it("should replace undefined with specified value", () => {
-    const options: ConfigOptions = {
-      filename: "Test Csv 2",
-      useTextFile: true,
-      useBom: false,
-      showColumnHeaders: true,
-      useKeysAsHeaders: true,
-      replaceUndefinedWith: "TEST",
-    };
-
-    const output = asString(
-      generateCsv(options)([
-        {
-          car: "toyota",
-          color: "blue",
-        },
-        {
-          car: "chevrolet",
-        },
-      ]),
-    );
-
-    expect(output).toBe(
-      '"car","color"\r\n"toyota","blue"\r\n"chevrolet","TEST"\r\n',
-    );
-  });
-
-  it("should handle varying data shapes by manually setting column headers", () => {
-    const options: ConfigOptions = {
-      filename: "Test Csv 2",
-      useTextFile: true,
-      useBom: false,
-      showColumnHeaders: true,
-      columnHeaders: ["car", "color", "town"],
-    };
-
-    const output = asString(
-      generateCsv(options)([
-        {
-          car: "toyota",
-          color: "blue",
-        },
-        {
-          car: "chevrolet",
-        },
-        {
-          town: "montreal",
-        },
-      ]),
-    );
-
-    expect(output).toBe(
-      '"car","color","town"\r\n"toyota","blue",""\r\n"chevrolet","",""\r\n"","","montreal"\r\n',
-    );
-  });
-
-  it("should properly quote headers", () => {
-    const options: ConfigOptions = {
-      filename: "Test Csv 2",
-      useTextFile: true,
-      useBom: false,
-      showColumnHeaders: true,
-      columnHeaders: ["name", "age"],
-    };
-
-    const output = asString(generateCsv(options)(mockData));
-    const firstLine = output.split("\n")[0];
-
-    expect(firstLine).toBe('"name","age"\r');
-  });
-
-  it("should put the title on the first line", () => {
-    const options: ConfigOptions = {
-      title: "Test Csv 2",
-      showTitle: true,
-      useBom: false,
-      showColumnHeaders: true,
-      columnHeaders: ["name", "age"],
-    };
-
-    const output = asString(generateCsv(options)(mockData));
-    const firstLine = output.split("\n")[0];
-
-    expect(firstLine).toBe("Test Csv 2\r");
-  });
-});
diff --git a/package.json b/package.json
index ab5f934..a14716b 100644
--- a/package.json
+++ b/package.json
@@ -39,7 +39,7 @@
   },
   "homepage": "https://github.com/alexcaza/export-to-csv#readme",
   "devDependencies": {
-    "@playwright/test": "^1.37.1",
+    "@playwright/test": "1.42.1",
     "bun-types": "^1.0.28",
     "http-server": "^14.1.1",
     "prettier": "3.0.3",

From d1e3a44d0d149090e0eaba1fde096e376e4b56da Mon Sep 17 00:00:00 2001
From: Alex Caza <alex@alexcaza.com>
Date: Fri, 12 Apr 2024 19:14:07 -0400
Subject: [PATCH 3/7] Pin playwright version to v1.40.0 (#98)

* Bump playwright version

* Fix lockfile
---
 bun.lockb    | Bin 22029 -> 22029 bytes
 package.json |   2 +-
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/bun.lockb b/bun.lockb
index b4dce7dfd2220d09bcdf03216e6adf808cadb0ee..04888e93ab10660a50d850049ea92ad2adbca7e6 100755
GIT binary patch
delta 361
zcmeBO!`Qoqae|&gnoRlT?GtsU-OI@1JeAY+{K$IV!*68L&r1p3e=>h{;f;-c+XNXk
zCL6M7Pc{$|fwBsOLclEj&1XceF>XF3a#_T|_UgV#b#meNlk8_0MqFujP<v>&;A)lq
z#F%}B>sOaNDm$g4P>^)N<nik2g}-FZ6fgVqZqDz%#3e=(LT9aA%_-+J`L3pfL$l(6
zMvh0kf79-_zC3KUDt}*B<DVPrgm!mn)ZOU0W1%G(wf|4r%DL?PYcGo0Je@gT<%Dhn
zNADI9drjT#w<qz&Pd3#maH#t<?_f}-<a4P{ca@f$tLk$N3SOvjQL=R}|CtOGUf#}q
z8*iVQaKJIr&{Xt#&x-cEnPSu9%$!;i-zyum8UJ?p3-qk`=092&g_sTW3^re|6=jnJ
zG8h=n^D{62QNu*1|F3pi-+Ir)XsBlbQo`i2P+)R`kJ99$A<`f{lOKn4gXzN1IRJ%>
BocI6$

delta 363
zcmeBO!`Qoqae|)0-^u-pfAV`7NNhN{=k9vVRfpQeDz0!XzsCEgUCHh6e~yiQ+XNZ4
zCU4Z&o@^i_0%a8lg@9T5o6m?`W88d7<g$o^)cWk1dKI$_y#Mb%vq!AgLPol-qB{5C
zd+$|3k50Xc2^Wx?!W14q=fl)%!biRBRh-*cw#%QXVct=^ZINwQjW*-tyP6UXc07!i
ztIc>P#F$En{f@B}ewv~qQ&6S$OVjksg|lxbsr=}T@$%B^pBYs7J*e)|+Y()`2S?=Y
z>WV#5TfB2~3ct~0Q>_Ar*)qS*p3IoU^`!b%>Avelf0U=O)X%e=ArTlFa=&5so%1{T
z8&6MVa^L!0t83N9C4V(ORQOE%nP0nWoo-!h^BUEf$%ZWAoBwEC6k;~gGu(W^R+LQ^
z$Y5YN&(FXBL=6+2{=eF7ed|3FqoJM&NC}h6LIFmj$&H>$laGZ+fpkrN9MTP@3q$7s
E0H_|Dn*aa+

diff --git a/package.json b/package.json
index a14716b..0b5d159 100644
--- a/package.json
+++ b/package.json
@@ -39,7 +39,7 @@
   },
   "homepage": "https://github.com/alexcaza/export-to-csv#readme",
   "devDependencies": {
-    "@playwright/test": "1.42.1",
+    "@playwright/test": "1.40.0",
     "bun-types": "^1.0.28",
     "http-server": "^14.1.1",
     "prettier": "3.0.3",

From 26155ff6345ee127c146b0fc49ffc9c9918f5438 Mon Sep 17 00:00:00 2001
From: Alex Caza <alex@alexcaza.com>
Date: Fri, 12 Apr 2024 19:15:12 -0400
Subject: [PATCH 4/7] Update bug_report.md (#99)

* Update bug_report.md

* Fix formatting
---
 .github/ISSUE_TEMPLATE/bug_report.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 02c567e..1e14e79 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -23,6 +23,12 @@ A clear and concise description of what you expected to happen.
 **Screenshots**
 If applicable, add screenshots to help explain your problem.
 
+**Package versions:**
+
+- Typescript: [5.0]
+- export-to-csv: [1.2.4]
+- runtime: [e.g. node 20 or bun 1.1]
+
 **Desktop (please complete the following information):**
 
 - OS: [e.g. iOS]

From 1c9214927be4abb2e96b7a68214b6f030e43bd91 Mon Sep 17 00:00:00 2001
From: Alex Caza <alex@alexcaza.com>
Date: Tue, 23 Apr 2024 10:13:48 -0400
Subject: [PATCH 5/7] Add tests to ensure spaces in headers and values are
 allowed (#102)

---
 integration/index.html     |  3 +++
 lib/__specs__/main.spec.ts | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+)

diff --git a/integration/index.html b/integration/index.html
index 68c3154..091ac12 100644
--- a/integration/index.html
+++ b/integration/index.html
@@ -26,6 +26,7 @@
           percentage: 0.4,
           quoted: '"Pickles"',
           nullish: null,
+          "string with spaces as header": "value with spaces",
         },
         {
           name: "Keiko",
@@ -33,6 +34,7 @@
           percentage: 0.9,
           quoted: '"Cactus"',
           nullish: "test",
+          "string with spaces as header": "more spaces",
         },
       ];
 
@@ -56,6 +58,7 @@
       );
     </script>
   </head>
+
   <body>
     <h1>Export to CSV testing</h1>
     <button id="csv">Download as CSV</button>
diff --git a/lib/__specs__/main.spec.ts b/lib/__specs__/main.spec.ts
index 32877a8..0256fa5 100644
--- a/lib/__specs__/main.spec.ts
+++ b/lib/__specs__/main.spec.ts
@@ -43,6 +43,38 @@ describe("ExportToCsv", () => {
     expect(typeof string === "string").toBeTruthy();
   });
 
+  it("should allow keys with spaces", () => {
+    const mockDataOne = [
+      {
+        "Hello world": "test",
+        "this is another string with many spaces": 10,
+      },
+    ];
+
+    const optionsOne = mkConfig({ useBom: false, useKeysAsHeaders: true });
+    const stringOne = asString(generateCsv(optionsOne)(mockDataOne));
+    expect(stringOne).toEqual(
+      '"Hello world","this is another string with many spaces"\r\n"test",10\r\n',
+    );
+
+    const mockDataTwo = [
+      {
+        "Hello world": "test",
+        "this is another string with many spaces": 10,
+      },
+    ];
+
+    const optionsTwo = mkConfig({
+      useBom: false,
+      showColumnHeaders: true,
+      columnHeaders: ["Hello world", "this is another string with many spaces"],
+    });
+    const stringTwo = asString(generateCsv(optionsTwo)(mockDataTwo));
+    expect(stringTwo).toEqual(
+      '"Hello world","this is another string with many spaces"\r\n"test",10\r\n',
+    );
+  });
+
   it("should use fieldSeparator if supplied", () => {
     const options: ConfigOptions = {
       title: "Test Csv",

From d906164972139468d9d6c95db198050d9243d3a8 Mon Sep 17 00:00:00 2001
From: Alex Caza <alex@alexcaza.com>
Date: Mon, 29 Apr 2024 16:28:07 -0400
Subject: [PATCH 6/7] As blob feature (#103)

* Update lockfile

bun.lockb was referring to incorrect playwright version.

* Add asBlob method

Useful for cases where you need to have a Blob object. Like downloading using browser extension APIs.
---
 bun.lockb                  | Bin 22029 -> 24230 bytes
 flake.lock                 |   6 +++---
 lib/__specs__/main.spec.ts |  22 +++++++++++++++++++++-
 lib/generator.ts           |  35 ++++++++++++++++++++++++++---------
 4 files changed, 50 insertions(+), 13 deletions(-)

diff --git a/bun.lockb b/bun.lockb
index 04888e93ab10660a50d850049ea92ad2adbca7e6..546ee7ed3294816fc8b36595b55b281065c668db 100755
GIT binary patch
delta 6999
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
YJWxS|6ZJNRdb*(zk+#5XMq~x~U-|j%Hvj+t

delta 5529
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
Rq7u2DWW;f5c$Ku1^KX_6MQi{7

diff --git a/flake.lock b/flake.lock
index 35cfdb9..6fb2579 100644
--- a/flake.lock
+++ b/flake.lock
@@ -20,11 +20,11 @@
     },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1709961763,
-        "narHash": "sha256-6H95HGJHhEZtyYA3rIQpvamMKAGoa8Yh2rFV29QnuGw=",
+        "lastModified": 1714253743,
+        "narHash": "sha256-mdTQw2XlariysyScCv2tTE45QSU9v/ezLcHJ22f0Nxc=",
         "owner": "nixos",
         "repo": "nixpkgs",
-        "rev": "3030f185ba6a4bf4f18b87f345f104e6a6961f34",
+        "rev": "58a1abdbae3217ca6b702f03d3b35125d88a2994",
         "type": "github"
       },
       "original": {
diff --git a/lib/__specs__/main.spec.ts b/lib/__specs__/main.spec.ts
index 0256fa5..b4373fa 100644
--- a/lib/__specs__/main.spec.ts
+++ b/lib/__specs__/main.spec.ts
@@ -1,6 +1,6 @@
 import { describe, it, expect } from "bun:test";
 import { mkConfig } from "../config.ts";
-import { generateCsv } from "../generator.ts";
+import { asBlob, generateCsv } from "../generator.ts";
 import { ConfigOptions } from "../types.ts";
 import { asString } from "../helpers.ts";
 
@@ -343,4 +343,24 @@ describe("ExportToCsv", () => {
 
     expect(firstLine).toBe("Test Csv 2\r");
   });
+
+  describe("asBlob", () => {
+    it("should construct a valid blob based on options", async () => {
+      const options: ConfigOptions = {
+        title: "Test Csv 2",
+        showTitle: true,
+        useBom: false,
+        showColumnHeaders: true,
+        columnHeaders: ["name", "age"],
+      };
+
+      const output = generateCsv(options)(mockData);
+      const blob = asBlob(options)(output);
+      const text = await blob.text();
+
+      expect(blob.type).toBe("text/csv;charset=utf8;");
+      expect(text.split("\n")[0]).toBe("Test Csv 2\r");
+      expect(blob.size).toBe(65);
+    });
+  });
 });
diff --git a/lib/generator.ts b/lib/generator.ts
index 01571b0..8f0c7f4 100644
--- a/lib/generator.ts
+++ b/lib/generator.ts
@@ -56,6 +56,26 @@ export const generateCsv =
     return output;
   };
 
+/**
+ * Returns the Blob representation of the CsvOutput generated
+ * by `generateCsv`. This is useful if you need to access the
+ * data for downloading in other contexts; like browser extensions.
+ */
+export const asBlob =
+  (config: ConfigOptions) =>
+  (csvOutput: CsvOutput): Blob => {
+    const withDefaults = mkConfig(config);
+    const data = unpack(csvOutput);
+
+    // Create blob from CsvOutput either as text or csv file.
+    const fileType = withDefaults.useTextFile ? "plain" : "csv";
+    const blob = new Blob([data], {
+      type: `text/${fileType};charset=utf8;`,
+    });
+
+    return blob;
+  };
+
 /**
  *
  * **Only supported in browser environment.**
@@ -77,20 +97,17 @@ export const download =
       );
     }
 
-    const withDefaults = mkConfig(config);
-    const data = unpack(csvOutput);
-
     // Create blob from CsvOutput either as text or csv file.
-    const fileType = withDefaults.useTextFile ? "plain" : "csv";
+    const blob = asBlob(config)(csvOutput);
+
+    const withDefaults = mkConfig(config);
     const fileExtension = withDefaults.useTextFile ? "txt" : "csv";
-    let blob = new Blob([data], {
-      type: `text/${fileType};charset=utf8;`,
-    });
+    const fileName = `${withDefaults.filename}.${fileExtension}`;
 
     // Create link element in the browser and set the download
     // attribute to the blob that was created.
-    let link = document.createElement("a");
-    link.download = `${withDefaults.filename}.${fileExtension}`;
+    const link = document.createElement("a");
+    link.download = fileName;
     link.href = URL.createObjectURL(blob);
 
     // Ensure the link isn't visible to the user or cause layout shifts.

From 51c8d10415c4f95fc456c4f74aabb8bb4ec1edeb Mon Sep 17 00:00:00 2001
From: Alex Caza <alex@alexcaza.com>
Date: Mon, 29 Apr 2024 16:37:47 -0400
Subject: [PATCH 7/7] v1.3.0 prep (#104)

* Update lockfile

bun.lockb was referring to incorrect playwright version.

* Add asBlob method

Useful for cases where you need to have a Blob object. Like downloading using browser extension APIs.

* Bump version

* Add documentation for `asBlob`

* Add clarifying comment

* Format markdown
---
 README.md    | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 package.json |  2 +-
 2 files changed, 49 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4b0bb9d..a8c72c5 100644
--- a/README.md
+++ b/README.md
@@ -135,6 +135,54 @@ const csvOutputWithNewLine = addNewLine(asString(csvOutput));
 
 The reason the `CsvOutput` type exists is to prevent accidentally passing in a string which wasn't formatted by `generateCsv` to the `download` function.
 
+### Using `generateCsv` output as a `Blob`
+
+A case for this would be using browser extension download methods _instead of_ the supplied `download` function. There may be scenarios where using a `Blob` might be more ergonomic.
+
+```typescript
+import { mkConfig, generateCsv, asBlob } from "export-to-csv";
+
+// mkConfig merges your options with the defaults
+// and returns WithDefaults<ConfigOptions>
+const csvConfig = mkConfig({ useKeysAsHeaders: true });
+
+const mockData = [
+  {
+    name: "Rouky",
+    date: "2023-09-01",
+    percentage: 0.4,
+    quoted: '"Pickles"',
+  },
+  {
+    name: "Keiko",
+    date: "2023-09-01",
+    percentage: 0.9,
+    quoted: '"Cactus"',
+  },
+];
+
+// Converts your Array<Object> to a CsvOutput string based on the configs
+const csv = generateCsv(csvConfig)(mockData);
+
+// Generate the Blob from the CsvOutput
+const blob = asBlob(csvConfig)(csv);
+
+// Requires URL to be available (web workers or client scripts only)
+const url = URL.createObjectURL(blob);
+
+// Assuming there's a button with an id of csv in the DOM
+const csvBtn = document.querySelector("#csv");
+
+csvBtn.addEventListener("click", () => {
+  // Use Chrome's downloads API for extensions
+  chrome.downloads.download({
+    url,
+    body: csv,
+    filename: "chrome-extension-output.csv",
+  });
+});
+```
+
 ## API
 
 | Option              | Default                          | Type                                                   | Description                                                                                                                                                                                                                                                                                                                               |
diff --git a/package.json b/package.json
index 0b5d159..ada173a 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "export-to-csv",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "Easily create CSV data from json collection",
   "type": "module",
   "repository": {