@jam-comments/server-utilities 5.3.0 → 5.5.0

package/dist/cjs/index.js

@@ -1,17 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.logError = exports.log = exports.removeFalseyValues = exports.deleteTempDirectory = exports.fetchAll = exports.markupFetcher = exports.TEMP_DIRECTORY = void 0;
-const path_1 = __importDefault(require("path"));
-exports.TEMP_DIRECTORY = path_1.default.join(process.cwd(), "_temp_jc");
+exports.logError = exports.log = exports.fetchAll = exports.markupFetcher = void 0;
 var markupFetcher_1 = require("./markupFetcher");
 Object.defineProperty(exports, "markupFetcher", { enumerable: true, get: function () { return markupFetcher_1.markupFetcher; } });
 Object.defineProperty(exports, "fetchAll", { enumerable: true, get: function () { return markupFetcher_1.fetchAll; } });
-var utils_1 = require("./utils");
-Object.defineProperty(exports, "deleteTempDirectory", { enumerable: true, get: function () { return utils_1.deleteTempDirectory; } });
-Object.defineProperty(exports, "removeFalseyValues", { enumerable: true, get: function () { return utils_1.removeFalseyValues; } });
 var log_1 = require("./log");
 Object.defineProperty(exports, "log", { enumerable: true, get: function () { return log_1.log; } });
 Object.defineProperty(exports, "logError", { enumerable: true, get: function () { return log_1.logError; } });

package/dist/cjs/markupFetcher.js

@@ -1,4 +1,27 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchAll = fetchAll;
 exports.batchMarkupFetcher = batchMarkupFetcher;
@@ -7,9 +30,11 @@ exports.makeMarkupRequest = makeMarkupRequest;
 exports.markupFetcher = markupFetcher;
 const injectSchema_1 = require("./injectSchema");
 const utils_1 = require("./utils");
-async function fetchAll({ tz = undefined, domain, apiKey, baseUrl = "https://go.jamcomments.com", environment = (0, utils_1.getEnvironment)(), copy = {}, }, platform, fetchImplementation = fetch, batchMarkupFetcherImpl = batchMarkupFetcher) {
+const BASE_URL = "https://go.jamcomments.com";
+async function fetchAll({ tz = undefined, dateFormat = undefined, domain, apiKey, baseUrl = BASE_URL, environment = (0, utils_1.getEnvironment)(), copy = {}, }, platform, fetchImplementation = fetch, batchMarkupFetcherImpl = batchMarkupFetcher) {
+    const { createTempDirectory, deleteTempDirectory, saveFile } = await Promise.resolve().then(() => __importStar(require("./nodeUtils")));
     const fetchBatchMarkup = batchMarkupFetcherImpl(platform, fetchImplementation);
-    (0, utils_1.createTempDirectory)();
+    await createTempDirectory();
     let shouldKeepFetching = true;
     let page = 1;
     console.log("Fetching comments from JamComments! This might take a sec.");
@@ -22,11 +47,12 @@ async function fetchAll({ tz = undefined, domain, apiKey, baseUrl = "https://go.
                 environment,
                 page,
                 tz,
+                dateFormat,
                 copy,
             });
             console.log(`Checking for comment data. Batch: ${current_page}/${last_page}`);
             const saveMarkupPromises = items.map((item) => {
-                return (0, utils_1.saveFile)(item.path, item.markup);
+                return saveFile(item.path, item.markup);
             });
             await Promise.all(saveMarkupPromises);
             if (current_page === last_page) {
@@ -38,21 +64,21 @@ async function fetchAll({ tz = undefined, domain, apiKey, baseUrl = "https://go.
         }
     }
     catch (error) {
-        (0, utils_1.deleteTempDirectory)();
+        await deleteTempDirectory();
         throw error;
     }
 }
 function batchMarkupFetcher(platform, fetchImplementation = fetch) {
-    return async ({ tz = undefined, domain, apiKey, baseUrl = "https://go.jamcomments.com", environment = (0, utils_1.getEnvironment)(), page = 1, copy = {}, }) => {
-        const response = await makeMarkupRequest({ tz, domain, apiKey, baseUrl, environment, page, copy }, "/api/v3/markup/all", fetchImplementation, platform);
+    return async ({ tz, copy, domain, apiKey, dateFormat, baseUrl = BASE_URL, environment = (0, utils_1.getEnvironment)(), page = 1, }) => {
+        const response = await makeMarkupRequest({ tz, domain, apiKey, baseUrl, environment, page, copy, dateFormat }, "/api/v3/markup/all", fetchImplementation, platform);
         return response.json();
     };
 }
-async function fetchFreshMarkup({ tz = undefined, path, domain, apiKey, baseUrl = "https://go.jamcomments.com", environment = (0, utils_1.getEnvironment)(), copy = {}, }, fetchImplementation = fetch, platform) {
-    const response = await makeMarkupRequest({ tz, path, domain, apiKey, baseUrl, environment, copy }, "/api/v3/markup", fetchImplementation, platform);
+async function fetchFreshMarkup({ tz, path, copy, domain, apiKey, dateFormat, baseUrl = BASE_URL, environment = (0, utils_1.getEnvironment)(), }, fetchImplementation = fetch, platform) {
+    const response = await makeMarkupRequest({ tz, path, domain, apiKey, baseUrl, environment, copy, dateFormat }, "/api/v3/markup", fetchImplementation, platform);
     return response.text();
 }
-async function makeMarkupRequest({ tz = undefined, path = undefined, domain, apiKey, baseUrl = "https://go.jamcomments.com", environment = (0, utils_1.getEnvironment)(), page = undefined, copy = {}, }, baseServicePath, fetchImplementation = fetch, platform) {
+async function makeMarkupRequest({ tz, path, page, domain, apiKey, dateFormat, copy = {}, baseUrl = BASE_URL, environment = (0, utils_1.getEnvironment)(), }, baseServicePath, fetchImplementation = fetch, platform) {
     const trimmedTimezone = tz?.trim();
     if (trimmedTimezone && !(0, utils_1.isValidTimezone)(trimmedTimezone)) {
         throw new Error(`The timezone passed to JamComments is invalid: ${trimmedTimezone}`);
@@ -69,6 +95,9 @@ async function makeMarkupRequest({ tz = undefined, path = undefined, domain, api
     if (trimmedTimezone) {
         params.set("tz", trimmedTimezone);
     }
+    if (dateFormat) {
+        params.set("date_format", dateFormat);
+    }
     if (environment !== "production") {
         params.set("stub", "true");
     }
@@ -93,17 +122,21 @@ async function makeMarkupRequest({ tz = undefined, path = undefined, domain, api
     return response;
 }
 function markupFetcher(platform, fetchImplementation = fetch) {
-    return async ({ tz = undefined, path, domain, apiKey, schema, baseUrl = "https://go.jamcomments.com", environment = (0, utils_1.getEnvironment)(), copy = {}, }) => {
+    return async ({ tz = undefined, path, domain, apiKey, schema, dateFormat, baseUrl = BASE_URL, environment = (0, utils_1.getEnvironment)(), copy = {}, }) => {
         path = path || "/";
-        const savedFile = (() => {
-            if (!(0, utils_1.tempDirectoryExists)()) {
+        const savedFile = await (async () => {
+            if (typeof process === "undefined") {
+                return null;
+            }
+            const { tempDirectoryExists, readFile, getEmptyMarkup } = await Promise.resolve().then(() => __importStar(require("./nodeUtils")));
+            if (!(await tempDirectoryExists())) {
                 return null;
             }
-            return (0, utils_1.readFile)(path) || (0, utils_1.getEmptyMarkup)();
+            return (await readFile(path)) || getEmptyMarkup();
         })();
         const markup = savedFile
             ? savedFile
-            : await fetchFreshMarkup({ tz, path, domain, apiKey, baseUrl, environment, copy }, fetchImplementation, platform);
+            : await fetchFreshMarkup({ tz, path, domain, apiKey, baseUrl, environment, copy, dateFormat }, fetchImplementation, platform);
         if (schema) {
             const preparedSchema = typeof schema !== "string" ? JSON.stringify(schema) : schema;
             const parsedSchema = (0, utils_1.parseJson)(preparedSchema);

package/dist/cjs/markupFetcher.test.js

@@ -27,7 +27,7 @@ const vitest_1 = require("vitest");
 const injectSchema = __importStar(require("./injectSchema"));
 const fetcherExports = __importStar(require("./markupFetcher"));
 const node_test_1 = require("node:test");
-const utilsExports = __importStar(require("./utils"));
+const utilsExports = __importStar(require("./nodeUtils"));
 const { deleteTempDirectory } = utilsExports;
 const { markupFetcher, batchMarkupFetcher } = fetcherExports;
 (0, vitest_1.beforeEach)(() => {
@@ -67,6 +67,8 @@ const { markupFetcher, batchMarkupFetcher } = fetcherExports;
             domain: "test.com",
             apiKey: "123abc",
             baseUrl: "https://go.jamcomments.com",
+            copy: {},
+            dateFormat: undefined,
             environment: "production",
             page: 1,
             tz: undefined,
@@ -120,6 +122,8 @@ const { markupFetcher, batchMarkupFetcher } = fetcherExports;
             domain: "test.com",
             apiKey: "123abc",
             baseUrl: "https://go.jamcomments.com",
+            copy: {},
+            dateFormat: undefined,
             environment: "production",
             page: 1,
             tz: undefined,
@@ -129,6 +133,8 @@ const { markupFetcher, batchMarkupFetcher } = fetcherExports;
             domain: "test.com",
             apiKey: "123abc",
             baseUrl: "https://go.jamcomments.com",
+            copy: {},
+            dateFormat: undefined,
             environment: "production",
             page: 2,
             tz: undefined,
@@ -157,7 +163,7 @@ const { markupFetcher, batchMarkupFetcher } = fetcherExports;
         }
         (0, vitest_1.expect)(deleteTempDirectorySpy).toHaveBeenCalledOnce();
     });
-    vitest_1.it.only("handles copy overrides", async () => {
+    (0, vitest_1.it)("handles copy overrides", async () => {
         const saveFileSpy = vitest_1.vi.spyOn(utilsExports, "saveFile");
         const mockBatchFetcher = vitest_1.vi.fn().mockReturnValue({
             data: [
@@ -201,6 +207,42 @@ const { markupFetcher, batchMarkupFetcher } = fetcherExports;
         });
         (0, vitest_1.expect)(saveFileSpy).toHaveBeenCalledTimes(2);
     });
+    (0, vitest_1.it)("allows you to pass a custom date format", async () => {
+        const mockBatchFetcher = vitest_1.vi.fn().mockReturnValue({
+            data: [
+                { path: "/test", markup: "markup1" },
+                { path: "/test2", markup: "markup2" },
+            ],
+            meta: {
+                current_page: 1,
+                from: 1,
+                last_page: 1,
+                path: "/test",
+                per_page: 10,
+                to: 2,
+                total: 2,
+            },
+        });
+        const batchMarkupFetcherMock = vitest_1.vi.fn().mockImplementation((a, b) => {
+            return mockBatchFetcher;
+        });
+        await fetcherExports.fetchAll({
+            domain: "test.com",
+            apiKey: "123abc",
+            environment: "production",
+            dateFormat: "yyyy-MM-dd",
+        }, "test_platform", vitest_1.vi.fn(), batchMarkupFetcherMock);
+        (0, vitest_1.expect)(mockBatchFetcher).toHaveBeenCalledWith({
+            domain: "test.com",
+            apiKey: "123abc",
+            baseUrl: "https://go.jamcomments.com",
+            copy: {},
+            dateFormat: "yyyy-MM-dd",
+            environment: "production",
+            page: 1,
+            tz: undefined,
+        });
+    });
 });
 (0, vitest_1.describe)("batchMarkupFetcher", () => {
     (0, vitest_1.it)("constructs fetch request correctly", async () => {
@@ -419,6 +461,24 @@ const { markupFetcher, batchMarkupFetcher } = fetcherExports;
         (0, vitest_1.expect)(fetchMock).toHaveBeenCalledWith("https://go.jamcomments.com/api/v3/markup?domain=test.com&path=%2F&copy_confirmation_message=custom+confirmation+message&copy_submit_button=custom+submit+button", vitest_1.expect.anything());
         (0, vitest_1.expect)(result).toEqual("results!");
     });
+    (0, vitest_1.it)("passes date format string", async () => {
+        const fetchMock = vitest_1.vi.fn().mockImplementation(() => {
+            return {
+                status: 200,
+                ok: true,
+                text: () => "results!",
+            };
+        });
+        const fetcher = markupFetcher("test", fetchMock);
+        await fetcher({
+            path: null,
+            domain: "test.com",
+            apiKey: "123abc",
+            environment: "production",
+            dateFormat: "yyyy-MM-dd",
+        });
+        (0, vitest_1.expect)(fetchMock).toHaveBeenCalledWith("https://go.jamcomments.com/api/v3/markup?domain=test.com&path=%2F&date_format=yyyy-MM-dd", vitest_1.expect.anything());
+    });
     (0, vitest_1.it)("response isn't ok", async () => {
         const fetchMock = vitest_1.vi.fn().mockImplementation(() => {
             return {
@@ -438,7 +498,7 @@ const { markupFetcher, batchMarkupFetcher } = fetcherExports;
         (0, vitest_1.it)("makes fresh request when temp directory does not exist", async () => {
             const tempDirectoryExistsSpy = vitest_1.vi
                 .spyOn(utilsExports, "tempDirectoryExists")
-                .mockReturnValue(false);
+                .mockReturnValue(Promise.resolve(false));
             const readFileSpy = vitest_1.vi.spyOn(utilsExports, "readFile");
             const fetchMock = vitest_1.vi.fn().mockImplementation(() => {
                 return {
@@ -462,10 +522,10 @@ const { markupFetcher, batchMarkupFetcher } = fetcherExports;
         (0, vitest_1.it)("uses saved markup when it exists", async () => {
             const tempDirectoryExistsSpy = vitest_1.vi
                 .spyOn(utilsExports, "tempDirectoryExists")
-                .mockReturnValue(true);
+                .mockReturnValue(Promise.resolve(true));
             const readFileSpy = vitest_1.vi
                 .spyOn(utilsExports, "readFile")
-                .mockReturnValue("saved markup");
+                .mockReturnValue(Promise.resolve("saved markup"));
             const fetchMock = vitest_1.vi.fn();
             const fetcher = markupFetcher("test", fetchMock);
             const result = await fetcher({
@@ -482,13 +542,13 @@ const { markupFetcher, batchMarkupFetcher } = fetcherExports;
         (0, vitest_1.it)("uses the EMPTY template when there's no saved file for a post", async () => {
             const tempDirectoryExistsSpy = vitest_1.vi
                 .spyOn(utilsExports, "tempDirectoryExists")
-                .mockReturnValue(true);
+                .mockReturnValue(Promise.resolve(true));
             const readFileSpy = vitest_1.vi
                 .spyOn(utilsExports, "readFile")
                 .mockReturnValue(null);
             const getEmptyMarkupSpy = vitest_1.vi
                 .spyOn(utilsExports, "getEmptyMarkup")
-                .mockReturnValue("<!-- EMPTY -->");
+                .mockReturnValue(Promise.resolve("<!-- EMPTY -->"));
             const fetchMock = vitest_1.vi.fn();
             const fetcher = markupFetcher("test", fetchMock);
             const result = await fetcher({

package/dist/cjs/nodeUtils.js

@@ -0,0 +1,74 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTempDirectory = getTempDirectory;
+exports.deleteTempDirectory = deleteTempDirectory;
+exports.createTempDirectory = createTempDirectory;
+exports.readFile = readFile;
+exports.getEmptyMarkup = getEmptyMarkup;
+exports.tempDirectoryExists = tempDirectoryExists;
+exports.saveFile = saveFile;
+const fs_1 = require("fs");
+const utils_1 = require("./utils");
+async function getTempDirectory() {
+    const path = await Promise.resolve().then(() => __importStar(require("path")));
+    return path.join(process.cwd(), "_temp_jc");
+}
+async function deleteTempDirectory() {
+    const tempDirectory = await getTempDirectory();
+    if ((0, fs_1.existsSync)(tempDirectory)) {
+        (0, fs_1.rmdirSync)(tempDirectory, { recursive: true });
+    }
+}
+async function createTempDirectory(mkdirSyncImpl = fs_1.mkdirSync, existsSyncImpl = fs_1.existsSync) {
+    const tempDirectory = await getTempDirectory();
+    if (!(await tempDirectoryExists(existsSyncImpl))) {
+        mkdirSyncImpl(tempDirectory);
+    }
+}
+async function readFile(name, readFileSyncImpl = fs_1.readFileSync) {
+    const fileName = (0, utils_1.toSavedFileName)(name);
+    try {
+        return readFileSyncImpl(`${await getTempDirectory()}/${fileName}`, "utf8");
+    }
+    catch (error) {
+        return null;
+    }
+}
+function getEmptyMarkup() {
+    return readFile("EMPTY");
+}
+async function tempDirectoryExists(existsSyncImpl = fs_1.existsSync) {
+    return existsSyncImpl(await getTempDirectory());
+}
+async function saveFile(name, data, writeFileImpl = fs_1.writeFile) {
+    const fileName = (0, utils_1.toSavedFileName)(name);
+    const tempDirectory = await getTempDirectory();
+    return new Promise(async (resolve) => {
+        writeFileImpl(`${tempDirectory}/${fileName}`, data, () => {
+            resolve();
+        });
+    });
+}

package/dist/cjs/nodeUtils.test.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const nodeUtils_1 = require("./nodeUtils");
+(0, vitest_1.describe)("createTempDirectory()", () => {
+    (0, vitest_1.it)("creates temp directory fresh", async () => {
+        const tempDirectory = await (0, nodeUtils_1.getTempDirectory)();
+        const mkdirSyncMock = vitest_1.vi.fn();
+        const existsSyncMock = vitest_1.vi.fn().mockReturnValue(false);
+        await new Promise((resolve) => {
+            (0, vitest_1.expect)(async () => {
+                await (0, nodeUtils_1.createTempDirectory)(mkdirSyncMock, existsSyncMock);
+                resolve();
+            }).not.toThrow();
+        });
+        (0, vitest_1.expect)(mkdirSyncMock).toHaveBeenCalledWith(tempDirectory);
+    });
+    (0, vitest_1.it)("does not throw error when it already exists", () => {
+        const mkdirSyncMock = vitest_1.vi.fn().mockImplementation(() => {
+            throw new Error("Directory already exists");
+        });
+        const existsSyncMock = vitest_1.vi.fn().mockReturnValue(true);
+        (0, vitest_1.expect)(() => (0, nodeUtils_1.createTempDirectory)(mkdirSyncMock, existsSyncMock)).not.toThrow();
+        (0, vitest_1.expect)(mkdirSyncMock).not.toHaveBeenCalledWith();
+    });
+});
+(0, vitest_1.describe)("readFile()", () => {
+    (0, vitest_1.it)("reads the file", async () => {
+        const readFileSyncMock = vitest_1.vi.fn().mockReturnValue("file contents");
+        const tempDirectory = await (0, nodeUtils_1.getTempDirectory)();
+        (0, vitest_1.expect)(await (0, nodeUtils_1.readFile)("hey/there", readFileSyncMock)).toEqual("file contents");
+        (0, vitest_1.expect)(readFileSyncMock).toHaveBeenCalledWith(`${tempDirectory}/hey::there`, "utf8");
+    });
+    (0, vitest_1.it)("returns null when file doesn't exist", async () => {
+        const readFileSyncMock = vitest_1.vi.fn().mockImplementation(() => {
+            throw new Error("File not found");
+        });
+        (0, vitest_1.expect)(await (0, nodeUtils_1.readFile)("hey/there", readFileSyncMock)).toEqual(null);
+    });
+});
+(0, vitest_1.describe)("saveFile()", () => {
+    (0, vitest_1.it)("saves the file", async () => {
+        const writeFileMock = vitest_1.vi.fn().mockImplementation((file, data, cb) => cb());
+        const tempDirectory = await (0, nodeUtils_1.getTempDirectory)();
+        await (0, nodeUtils_1.saveFile)("hey/there", "file contents", writeFileMock);
+        (0, vitest_1.expect)(writeFileMock).toHaveBeenCalledWith(`${tempDirectory}/hey::there`, "file contents", vitest_1.expect.any(Function));
+    });
+});

package/dist/cjs/utils.js

@@ -4,16 +4,8 @@ exports.isValidTimezone = isValidTimezone;
 exports.getEnvironment = getEnvironment;
 exports.parseJson = parseJson;
 exports.unescapeHTML = unescapeHTML;
-exports.deleteTempDirectory = deleteTempDirectory;
-exports.createTempDirectory = createTempDirectory;
 exports.toSavedFileName = toSavedFileName;
-exports.readFile = readFile;
-exports.getEmptyMarkup = getEmptyMarkup;
-exports.tempDirectoryExists = tempDirectoryExists;
-exports.saveFile = saveFile;
 exports.removeFalseyValues = removeFalseyValues;
-const fs_1 = require("fs");
-const _1 = require(".");
 function isValidTimezone(tz) {
     try {
         Intl.DateTimeFormat(undefined, { timeZone: tz });
@@ -70,42 +62,9 @@ function unescapeHTML(str) {
         }
     });
 }
-function deleteTempDirectory() {
-    if ((0, fs_1.existsSync)(_1.TEMP_DIRECTORY)) {
-        (0, fs_1.rmdirSync)(_1.TEMP_DIRECTORY, { recursive: true });
-    }
-}
-function createTempDirectory(mkdirSyncImpl = fs_1.mkdirSync, existsSyncImpl = fs_1.existsSync) {
-    if (!tempDirectoryExists(existsSyncImpl)) {
-        mkdirSyncImpl(_1.TEMP_DIRECTORY);
-    }
-}
 function toSavedFileName(name) {
     return name.replace(/^\//, "").replace(/\//g, "::");
 }
-function readFile(name, readFileSyncImpl = fs_1.readFileSync) {
-    const fileName = toSavedFileName(name);
-    try {
-        return readFileSyncImpl(`${_1.TEMP_DIRECTORY}/${fileName}`, "utf8");
-    }
-    catch (error) {
-        return null;
-    }
-}
-function getEmptyMarkup() {
-    return readFile("EMPTY");
-}
-function tempDirectoryExists(existsSyncImpl = fs_1.existsSync) {
-    return existsSyncImpl(_1.TEMP_DIRECTORY);
-}
-function saveFile(name, data, writeFileImpl = fs_1.writeFile) {
-    const fileName = toSavedFileName(name);
-    return new Promise((resolve) => {
-        writeFileImpl(`${_1.TEMP_DIRECTORY}/${fileName}`, data, () => {
-            resolve();
-        });
-    });
-}
 function removeFalseyValues(obj) {
     const filteredItems = Object.entries(obj).filter(([, value]) => value);
     return Object.fromEntries(filteredItems);

package/dist/cjs/utils.test.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const vitest_1 = require("vitest");
 const utils_1 = require("./utils");
-const _1 = require(".");
 const env = process.env;
 (0, vitest_1.beforeEach)(() => {
     vitest_1.vi.resetModules();
@@ -45,48 +44,11 @@ const env = process.env;
         });
     });
 });
-(0, vitest_1.describe)("createTempDirectory()", () => {
-    (0, vitest_1.it)("creates temp directory fresh", () => {
-        const mkdirSyncMock = vitest_1.vi.fn();
-        const existsSyncMock = vitest_1.vi.fn().mockReturnValue(false);
-        (0, vitest_1.expect)(() => (0, utils_1.createTempDirectory)(mkdirSyncMock, existsSyncMock)).not.toThrow();
-        (0, vitest_1.expect)(mkdirSyncMock).toHaveBeenCalledWith(_1.TEMP_DIRECTORY);
-    });
-    (0, vitest_1.it)("does not throw error when it already exists", () => {
-        const mkdirSyncMock = vitest_1.vi.fn().mockImplementation(() => {
-            throw new Error("Directory already exists");
-        });
-        const existsSyncMock = vitest_1.vi.fn().mockReturnValue(true);
-        (0, vitest_1.expect)(() => (0, utils_1.createTempDirectory)(mkdirSyncMock, existsSyncMock)).not.toThrow();
-        (0, vitest_1.expect)(mkdirSyncMock).not.toHaveBeenCalledWith();
-    });
-});
 (0, vitest_1.describe)("toSavedFileName()", () => {
     (0, vitest_1.it)("replaces slashes with double colons", () => {
         (0, vitest_1.expect)((0, utils_1.toSavedFileName)("/hey/there")).toEqual("hey::there");
     });
 });
-(0, vitest_1.describe)("readFile()", () => {
-    (0, vitest_1.it)("reads the file", () => {
-        const readFileSyncMock = vitest_1.vi.fn().mockReturnValue("file contents");
-        (0, vitest_1.expect)((0, utils_1.readFile)("hey/there", readFileSyncMock)).toEqual("file contents");
-        (0, vitest_1.expect)(readFileSyncMock).toHaveBeenCalledWith(`${_1.TEMP_DIRECTORY}/hey::there`, "utf8");
-    });
-    (0, vitest_1.it)("returns null when file doesn't exist", () => {
-        const readFileSyncMock = vitest_1.vi.fn().mockImplementation(() => {
-            throw new Error("File not found");
-        });
-        (0, vitest_1.expect)((0, utils_1.readFile)("hey/there", readFileSyncMock)).toEqual(null);
-    });
-});
-(0, vitest_1.describe)("saveFile()", () => {
-    (0, vitest_1.it)("saves the file", async () => {
-        const writeFileMock = vitest_1.vi.fn();
-        const result = (0, utils_1.saveFile)("hey/there", "file contents", writeFileMock);
-        (0, vitest_1.expect)(writeFileMock).toHaveBeenCalledWith(`${_1.TEMP_DIRECTORY}/hey::there`, "file contents", vitest_1.expect.any(Function));
-        (0, vitest_1.expect)(result).toBeInstanceOf(Promise);
-    });
-});
 (0, vitest_1.describe)("removeFalseyValues()", () => {
     (0, vitest_1.it)("should remove falsey values", () => {
         (0, vitest_1.expect)((0, utils_1.removeFalseyValues)({ a: 1, b: 0, d: null, e: "" })).toEqual({

package/dist/esm/index.js

@@ -1,5 +1,2 @@
-import path from "path";
-export const TEMP_DIRECTORY = path.join(process.cwd(), "_temp_jc");
 export { markupFetcher, fetchAll } from "./markupFetcher";
-export { deleteTempDirectory, removeFalseyValues } from "./utils";
 export { log, logError } from "./log";

package/dist/esm/markupFetcher.js

@@ -1,8 +1,10 @@
 import { injectSchema } from "./injectSchema";
-import { createTempDirectory, deleteTempDirectory, getEmptyMarkup, getEnvironment, isValidTimezone, parseJson, readFile, saveFile, tempDirectoryExists, } from "./utils";
-export async function fetchAll({ tz = undefined, domain, apiKey, baseUrl = "https://go.jamcomments.com", environment = getEnvironment(), copy = {}, }, platform, fetchImplementation = fetch, batchMarkupFetcherImpl = batchMarkupFetcher) {
+import { getEnvironment, isValidTimezone, parseJson } from "./utils";
+const BASE_URL = "https://go.jamcomments.com";
+export async function fetchAll({ tz = undefined, dateFormat = undefined, domain, apiKey, baseUrl = BASE_URL, environment = getEnvironment(), copy = {}, }, platform, fetchImplementation = fetch, batchMarkupFetcherImpl = batchMarkupFetcher) {
+    const { createTempDirectory, deleteTempDirectory, saveFile } = await import("./nodeUtils");
     const fetchBatchMarkup = batchMarkupFetcherImpl(platform, fetchImplementation);
-    createTempDirectory();
+    await createTempDirectory();
     let shouldKeepFetching = true;
     let page = 1;
     console.log("Fetching comments from JamComments! This might take a sec.");
@@ -15,6 +17,7 @@ export async function fetchAll({ tz = undefined, domain, apiKey, baseUrl = "http
                 environment,
                 page,
                 tz,
+                dateFormat,
                 copy,
             });
             console.log(`Checking for comment data. Batch: ${current_page}/${last_page}`);
@@ -31,21 +34,21 @@ export async function fetchAll({ tz = undefined, domain, apiKey, baseUrl = "http
         }
     }
     catch (error) {
-        deleteTempDirectory();
+        await deleteTempDirectory();
         throw error;
     }
 }
 export function batchMarkupFetcher(platform, fetchImplementation = fetch) {
-    return async ({ tz = undefined, domain, apiKey, baseUrl = "https://go.jamcomments.com", environment = getEnvironment(), page = 1, copy = {}, }) => {
-        const response = await makeMarkupRequest({ tz, domain, apiKey, baseUrl, environment, page, copy }, "/api/v3/markup/all", fetchImplementation, platform);
+    return async ({ tz, copy, domain, apiKey, dateFormat, baseUrl = BASE_URL, environment = getEnvironment(), page = 1, }) => {
+        const response = await makeMarkupRequest({ tz, domain, apiKey, baseUrl, environment, page, copy, dateFormat }, "/api/v3/markup/all", fetchImplementation, platform);
         return response.json();
     };
 }
-export async function fetchFreshMarkup({ tz = undefined, path, domain, apiKey, baseUrl = "https://go.jamcomments.com", environment = getEnvironment(), copy = {}, }, fetchImplementation = fetch, platform) {
-    const response = await makeMarkupRequest({ tz, path, domain, apiKey, baseUrl, environment, copy }, "/api/v3/markup", fetchImplementation, platform);
+export async function fetchFreshMarkup({ tz, path, copy, domain, apiKey, dateFormat, baseUrl = BASE_URL, environment = getEnvironment(), }, fetchImplementation = fetch, platform) {
+    const response = await makeMarkupRequest({ tz, path, domain, apiKey, baseUrl, environment, copy, dateFormat }, "/api/v3/markup", fetchImplementation, platform);
     return response.text();
 }
-export async function makeMarkupRequest({ tz = undefined, path = undefined, domain, apiKey, baseUrl = "https://go.jamcomments.com", environment = getEnvironment(), page = undefined, copy = {}, }, baseServicePath, fetchImplementation = fetch, platform) {
+export async function makeMarkupRequest({ tz, path, page, domain, apiKey, dateFormat, copy = {}, baseUrl = BASE_URL, environment = getEnvironment(), }, baseServicePath, fetchImplementation = fetch, platform) {
     const trimmedTimezone = tz?.trim();
     if (trimmedTimezone && !isValidTimezone(trimmedTimezone)) {
         throw new Error(`The timezone passed to JamComments is invalid: ${trimmedTimezone}`);
@@ -62,6 +65,9 @@ export async function makeMarkupRequest({ tz = undefined, path = undefined, doma
     if (trimmedTimezone) {
         params.set("tz", trimmedTimezone);
     }
+    if (dateFormat) {
+        params.set("date_format", dateFormat);
+    }
     if (environment !== "production") {
         params.set("stub", "true");
     }
@@ -86,17 +92,21 @@ export async function makeMarkupRequest({ tz = undefined, path = undefined, doma
     return response;
 }
 export function markupFetcher(platform, fetchImplementation = fetch) {
-    return async ({ tz = undefined, path, domain, apiKey, schema, baseUrl = "https://go.jamcomments.com", environment = getEnvironment(), copy = {}, }) => {
+    return async ({ tz = undefined, path, domain, apiKey, schema, dateFormat, baseUrl = BASE_URL, environment = getEnvironment(), copy = {}, }) => {
         path = path || "/";
-        const savedFile = (() => {
-            if (!tempDirectoryExists()) {
+        const savedFile = await (async () => {
+            if (typeof process === "undefined") {
+                return null;
+            }
+            const { tempDirectoryExists, readFile, getEmptyMarkup } = await import("./nodeUtils");
+            if (!(await tempDirectoryExists())) {
                 return null;
             }
-            return readFile(path) || getEmptyMarkup();
+            return (await readFile(path)) || getEmptyMarkup();
         })();
         const markup = savedFile
             ? savedFile
-            : await fetchFreshMarkup({ tz, path, domain, apiKey, baseUrl, environment, copy }, fetchImplementation, platform);
+            : await fetchFreshMarkup({ tz, path, domain, apiKey, baseUrl, environment, copy, dateFormat }, fetchImplementation, platform);
         if (schema) {
             const preparedSchema = typeof schema !== "string" ? JSON.stringify(schema) : schema;
             const parsedSchema = parseJson(preparedSchema);

package/dist/esm/markupFetcher.test.js

@@ -2,7 +2,7 @@ import { beforeEach, describe, expect, it, vi } from "vitest";
 import * as injectSchema from "./injectSchema";
 import * as fetcherExports from "./markupFetcher";
 import { afterEach } from "node:test";
-import * as utilsExports from "./utils";
+import * as utilsExports from "./nodeUtils";
 const { deleteTempDirectory } = utilsExports;
 const { markupFetcher, batchMarkupFetcher } = fetcherExports;
 beforeEach(() => {
@@ -42,6 +42,8 @@ describe("fetchAll()", () => {
             domain: "test.com",
             apiKey: "123abc",
             baseUrl: "https://go.jamcomments.com",
+            copy: {},
+            dateFormat: undefined,
             environment: "production",
             page: 1,
             tz: undefined,
@@ -95,6 +97,8 @@ describe("fetchAll()", () => {
             domain: "test.com",
             apiKey: "123abc",
             baseUrl: "https://go.jamcomments.com",
+            copy: {},
+            dateFormat: undefined,
             environment: "production",
             page: 1,
             tz: undefined,
@@ -104,6 +108,8 @@ describe("fetchAll()", () => {
             domain: "test.com",
             apiKey: "123abc",
             baseUrl: "https://go.jamcomments.com",
+            copy: {},
+            dateFormat: undefined,
             environment: "production",
             page: 2,
             tz: undefined,
@@ -132,7 +138,7 @@ describe("fetchAll()", () => {
         }
         expect(deleteTempDirectorySpy).toHaveBeenCalledOnce();
     });
-    it.only("handles copy overrides", async () => {
+    it("handles copy overrides", async () => {
         const saveFileSpy = vi.spyOn(utilsExports, "saveFile");
         const mockBatchFetcher = vi.fn().mockReturnValue({
             data: [
@@ -176,6 +182,42 @@ describe("fetchAll()", () => {
         });
         expect(saveFileSpy).toHaveBeenCalledTimes(2);
     });
+    it("allows you to pass a custom date format", async () => {
+        const mockBatchFetcher = vi.fn().mockReturnValue({
+            data: [
+                { path: "/test", markup: "markup1" },
+                { path: "/test2", markup: "markup2" },
+            ],
+            meta: {
+                current_page: 1,
+                from: 1,
+                last_page: 1,
+                path: "/test",
+                per_page: 10,
+                to: 2,
+                total: 2,
+            },
+        });
+        const batchMarkupFetcherMock = vi.fn().mockImplementation((a, b) => {
+            return mockBatchFetcher;
+        });
+        await fetcherExports.fetchAll({
+            domain: "test.com",
+            apiKey: "123abc",
+            environment: "production",
+            dateFormat: "yyyy-MM-dd",
+        }, "test_platform", vi.fn(), batchMarkupFetcherMock);
+        expect(mockBatchFetcher).toHaveBeenCalledWith({
+            domain: "test.com",
+            apiKey: "123abc",
+            baseUrl: "https://go.jamcomments.com",
+            copy: {},
+            dateFormat: "yyyy-MM-dd",
+            environment: "production",
+            page: 1,
+            tz: undefined,
+        });
+    });
 });
 describe("batchMarkupFetcher", () => {
     it("constructs fetch request correctly", async () => {
@@ -394,6 +436,24 @@ describe("markupFetcher", () => {
         expect(fetchMock).toHaveBeenCalledWith("https://go.jamcomments.com/api/v3/markup?domain=test.com&path=%2F&copy_confirmation_message=custom+confirmation+message&copy_submit_button=custom+submit+button", expect.anything());
         expect(result).toEqual("results!");
     });
+    it("passes date format string", async () => {
+        const fetchMock = vi.fn().mockImplementation(() => {
+            return {
+                status: 200,
+                ok: true,
+                text: () => "results!",
+            };
+        });
+        const fetcher = markupFetcher("test", fetchMock);
+        await fetcher({
+            path: null,
+            domain: "test.com",
+            apiKey: "123abc",
+            environment: "production",
+            dateFormat: "yyyy-MM-dd",
+        });
+        expect(fetchMock).toHaveBeenCalledWith("https://go.jamcomments.com/api/v3/markup?domain=test.com&path=%2F&date_format=yyyy-MM-dd", expect.anything());
+    });
     it("response isn't ok", async () => {
         const fetchMock = vi.fn().mockImplementation(() => {
             return {
@@ -413,7 +473,7 @@ describe("markupFetcher", () => {
         it("makes fresh request when temp directory does not exist", async () => {
             const tempDirectoryExistsSpy = vi
                 .spyOn(utilsExports, "tempDirectoryExists")
-                .mockReturnValue(false);
+                .mockReturnValue(Promise.resolve(false));
             const readFileSpy = vi.spyOn(utilsExports, "readFile");
             const fetchMock = vi.fn().mockImplementation(() => {
                 return {
@@ -437,10 +497,10 @@ describe("markupFetcher", () => {
         it("uses saved markup when it exists", async () => {
             const tempDirectoryExistsSpy = vi
                 .spyOn(utilsExports, "tempDirectoryExists")
-                .mockReturnValue(true);
+                .mockReturnValue(Promise.resolve(true));
             const readFileSpy = vi
                 .spyOn(utilsExports, "readFile")
-                .mockReturnValue("saved markup");
+                .mockReturnValue(Promise.resolve("saved markup"));
             const fetchMock = vi.fn();
             const fetcher = markupFetcher("test", fetchMock);
             const result = await fetcher({
@@ -457,13 +517,13 @@ describe("markupFetcher", () => {
         it("uses the EMPTY template when there's no saved file for a post", async () => {
             const tempDirectoryExistsSpy = vi
                 .spyOn(utilsExports, "tempDirectoryExists")
-                .mockReturnValue(true);
+                .mockReturnValue(Promise.resolve(true));
             const readFileSpy = vi
                 .spyOn(utilsExports, "readFile")
                 .mockReturnValue(null);
             const getEmptyMarkupSpy = vi
                 .spyOn(utilsExports, "getEmptyMarkup")
-                .mockReturnValue("<!-- EMPTY -->");
+                .mockReturnValue(Promise.resolve("<!-- EMPTY -->"));
             const fetchMock = vi.fn();
             const fetcher = markupFetcher("test", fetchMock);
             const result = await fetcher({

package/dist/esm/nodeUtils.js

@@ -0,0 +1,42 @@
+import { existsSync, mkdirSync, readFileSync, rmdirSync, writeFile } from "fs";
+import { toSavedFileName } from "./utils";
+export async function getTempDirectory() {
+    const path = await import("path");
+    return path.join(process.cwd(), "_temp_jc");
+}
+export async function deleteTempDirectory() {
+    const tempDirectory = await getTempDirectory();
+    if (existsSync(tempDirectory)) {
+        rmdirSync(tempDirectory, { recursive: true });
+    }
+}
+export async function createTempDirectory(mkdirSyncImpl = mkdirSync, existsSyncImpl = existsSync) {
+    const tempDirectory = await getTempDirectory();
+    if (!(await tempDirectoryExists(existsSyncImpl))) {
+        mkdirSyncImpl(tempDirectory);
+    }
+}
+export async function readFile(name, readFileSyncImpl = readFileSync) {
+    const fileName = toSavedFileName(name);
+    try {
+        return readFileSyncImpl(`${await getTempDirectory()}/${fileName}`, "utf8");
+    }
+    catch (error) {
+        return null;
+    }
+}
+export function getEmptyMarkup() {
+    return readFile("EMPTY");
+}
+export async function tempDirectoryExists(existsSyncImpl = existsSync) {
+    return existsSyncImpl(await getTempDirectory());
+}
+export async function saveFile(name, data, writeFileImpl = writeFile) {
+    const fileName = toSavedFileName(name);
+    const tempDirectory = await getTempDirectory();
+    return new Promise(async (resolve) => {
+        writeFileImpl(`${tempDirectory}/${fileName}`, data, () => {
+            resolve();
+        });
+    });
+}

package/dist/esm/nodeUtils.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it, vi } from "vitest";
+import { createTempDirectory, getTempDirectory, readFile, saveFile, } from "./nodeUtils";
+describe("createTempDirectory()", () => {
+    it("creates temp directory fresh", async () => {
+        const tempDirectory = await getTempDirectory();
+        const mkdirSyncMock = vi.fn();
+        const existsSyncMock = vi.fn().mockReturnValue(false);
+        await new Promise((resolve) => {
+            expect(async () => {
+                await createTempDirectory(mkdirSyncMock, existsSyncMock);
+                resolve();
+            }).not.toThrow();
+        });
+        expect(mkdirSyncMock).toHaveBeenCalledWith(tempDirectory);
+    });
+    it("does not throw error when it already exists", () => {
+        const mkdirSyncMock = vi.fn().mockImplementation(() => {
+            throw new Error("Directory already exists");
+        });
+        const existsSyncMock = vi.fn().mockReturnValue(true);
+        expect(() => createTempDirectory(mkdirSyncMock, existsSyncMock)).not.toThrow();
+        expect(mkdirSyncMock).not.toHaveBeenCalledWith();
+    });
+});
+describe("readFile()", () => {
+    it("reads the file", async () => {
+        const readFileSyncMock = vi.fn().mockReturnValue("file contents");
+        const tempDirectory = await getTempDirectory();
+        expect(await readFile("hey/there", readFileSyncMock)).toEqual("file contents");
+        expect(readFileSyncMock).toHaveBeenCalledWith(`${tempDirectory}/hey::there`, "utf8");
+    });
+    it("returns null when file doesn't exist", async () => {
+        const readFileSyncMock = vi.fn().mockImplementation(() => {
+            throw new Error("File not found");
+        });
+        expect(await readFile("hey/there", readFileSyncMock)).toEqual(null);
+    });
+});
+describe("saveFile()", () => {
+    it("saves the file", async () => {
+        const writeFileMock = vi.fn().mockImplementation((file, data, cb) => cb());
+        const tempDirectory = await getTempDirectory();
+        await saveFile("hey/there", "file contents", writeFileMock);
+        expect(writeFileMock).toHaveBeenCalledWith(`${tempDirectory}/hey::there`, "file contents", expect.any(Function));
+    });
+});

package/dist/esm/utils.js

@@ -1,5 +1,3 @@
-import { existsSync, mkdirSync, readFileSync, rmdirSync, writeFile } from "fs";
-import { TEMP_DIRECTORY } from ".";
 export function isValidTimezone(tz) {
     try {
         Intl.DateTimeFormat(undefined, { timeZone: tz });
@@ -56,42 +54,9 @@ export function unescapeHTML(str) {
         }
     });
 }
-export function deleteTempDirectory() {
-    if (existsSync(TEMP_DIRECTORY)) {
-        rmdirSync(TEMP_DIRECTORY, { recursive: true });
-    }
-}
-export function createTempDirectory(mkdirSyncImpl = mkdirSync, existsSyncImpl = existsSync) {
-    if (!tempDirectoryExists(existsSyncImpl)) {
-        mkdirSyncImpl(TEMP_DIRECTORY);
-    }
-}
 export function toSavedFileName(name) {
     return name.replace(/^\//, "").replace(/\//g, "::");
 }
-export function readFile(name, readFileSyncImpl = readFileSync) {
-    const fileName = toSavedFileName(name);
-    try {
-        return readFileSyncImpl(`${TEMP_DIRECTORY}/${fileName}`, "utf8");
-    }
-    catch (error) {
-        return null;
-    }
-}
-export function getEmptyMarkup() {
-    return readFile("EMPTY");
-}
-export function tempDirectoryExists(existsSyncImpl = existsSync) {
-    return existsSyncImpl(TEMP_DIRECTORY);
-}
-export function saveFile(name, data, writeFileImpl = writeFile) {
-    const fileName = toSavedFileName(name);
-    return new Promise((resolve) => {
-        writeFileImpl(`${TEMP_DIRECTORY}/${fileName}`, data, () => {
-            resolve();
-        });
-    });
-}
 export function removeFalseyValues(obj) {
     const filteredItems = Object.entries(obj).filter(([, value]) => value);
     return Object.fromEntries(filteredItems);

package/dist/esm/utils.test.js

@@ -1,6 +1,5 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
-import { getEnvironment, createTempDirectory, toSavedFileName, readFile, saveFile, removeFalseyValues, } from "./utils";
-import { TEMP_DIRECTORY } from ".";
+import { getEnvironment, removeFalseyValues, toSavedFileName } from "./utils";
 const env = process.env;
 beforeEach(() => {
     vi.resetModules();
@@ -43,48 +42,11 @@ describe("getEnvironment()", () => {
         });
     });
 });
-describe("createTempDirectory()", () => {
-    it("creates temp directory fresh", () => {
-        const mkdirSyncMock = vi.fn();
-        const existsSyncMock = vi.fn().mockReturnValue(false);
-        expect(() => createTempDirectory(mkdirSyncMock, existsSyncMock)).not.toThrow();
-        expect(mkdirSyncMock).toHaveBeenCalledWith(TEMP_DIRECTORY);
-    });
-    it("does not throw error when it already exists", () => {
-        const mkdirSyncMock = vi.fn().mockImplementation(() => {
-            throw new Error("Directory already exists");
-        });
-        const existsSyncMock = vi.fn().mockReturnValue(true);
-        expect(() => createTempDirectory(mkdirSyncMock, existsSyncMock)).not.toThrow();
-        expect(mkdirSyncMock).not.toHaveBeenCalledWith();
-    });
-});
 describe("toSavedFileName()", () => {
     it("replaces slashes with double colons", () => {
         expect(toSavedFileName("/hey/there")).toEqual("hey::there");
     });
 });
-describe("readFile()", () => {
-    it("reads the file", () => {
-        const readFileSyncMock = vi.fn().mockReturnValue("file contents");
-        expect(readFile("hey/there", readFileSyncMock)).toEqual("file contents");
-        expect(readFileSyncMock).toHaveBeenCalledWith(`${TEMP_DIRECTORY}/hey::there`, "utf8");
-    });
-    it("returns null when file doesn't exist", () => {
-        const readFileSyncMock = vi.fn().mockImplementation(() => {
-            throw new Error("File not found");
-        });
-        expect(readFile("hey/there", readFileSyncMock)).toEqual(null);
-    });
-});
-describe("saveFile()", () => {
-    it("saves the file", async () => {
-        const writeFileMock = vi.fn();
-        const result = saveFile("hey/there", "file contents", writeFileMock);
-        expect(writeFileMock).toHaveBeenCalledWith(`${TEMP_DIRECTORY}/hey::there`, "file contents", expect.any(Function));
-        expect(result).toBeInstanceOf(Promise);
-    });
-});
 describe("removeFalseyValues()", () => {
     it("should remove falsey values", () => {
         expect(removeFalseyValues({ a: 1, b: 0, d: null, e: "" })).toEqual({

package/dist/types/index.d.ts

@@ -1,5 +1,3 @@
 export type { CustomCopy } from "./markupFetcher";
-export declare const TEMP_DIRECTORY: string;
 export { markupFetcher, fetchAll } from "./markupFetcher";
-export { deleteTempDirectory, removeFalseyValues } from "./utils";
 export { log, logError } from "./log";

package/dist/types/markupFetcher.d.ts

@@ -17,6 +17,7 @@ export interface IFetchData {
     tz?: string;
     baseUrl?: string;
     environment?: string;
+    dateFormat?: string;
     copy?: {
         copy_confirmation_message?: string;
         copy_submit_button?: string;
@@ -47,9 +48,9 @@ interface IBatchResponse {
         total: number;
     };
 }
-export declare function fetchAll({ tz, domain, apiKey, baseUrl, environment, copy, }: IBatchFetchData, platform: string, fetchImplementation?: any, batchMarkupFetcherImpl?: any): Promise<void>;
+export declare function fetchAll({ tz, dateFormat, domain, apiKey, baseUrl, environment, copy, }: IBatchFetchData, platform: string, fetchImplementation?: any, batchMarkupFetcherImpl?: any): Promise<void>;
 export declare function batchMarkupFetcher(platform: string, fetchImplementation?: typeof fetch): (args: IBatchFetchData) => Promise<IBatchResponse>;
-export declare function fetchFreshMarkup({ tz, path, domain, apiKey, baseUrl, environment, copy, }: IFetchData, fetchImplementation: typeof fetch, platform: string): Promise<string>;
-export declare function makeMarkupRequest<T extends Partial<IBatchFetchData & IFetchData>>({ tz, path, domain, apiKey, baseUrl, environment, page, copy, }: T, baseServicePath: string, fetchImplementation: typeof fetch, platform: string): Promise<Response>;
+export declare function fetchFreshMarkup({ tz, path, copy, domain, apiKey, dateFormat, baseUrl, environment, }: IFetchData, fetchImplementation: typeof fetch, platform: string): Promise<string>;
+export declare function makeMarkupRequest<T extends Partial<IBatchFetchData & IFetchData>>({ tz, path, page, domain, apiKey, dateFormat, copy, baseUrl, environment, }: T, baseServicePath: string, fetchImplementation: typeof fetch, platform: string): Promise<Response>;
 export declare function markupFetcher(platform: string, fetchImplementation?: typeof fetch): (args: IFetchData) => Promise<string>;
 export {};

package/dist/types/nodeUtils.d.ts

@@ -0,0 +1,8 @@
+import { existsSync, mkdirSync, readFileSync } from "fs";
+export declare function getTempDirectory(): Promise<string>;
+export declare function deleteTempDirectory(): Promise<void>;
+export declare function createTempDirectory(mkdirSyncImpl?: typeof mkdirSync, existsSyncImpl?: typeof existsSync): Promise<void>;
+export declare function readFile(name: any, readFileSyncImpl?: typeof readFileSync): Promise<string>;
+export declare function getEmptyMarkup(): Promise<string>;
+export declare function tempDirectoryExists(existsSyncImpl?: typeof existsSync): Promise<boolean>;
+export declare function saveFile(name: string, data: string, writeFileImpl?: any): Promise<void>;

package/dist/types/nodeUtils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/utils.d.ts

@@ -1,13 +1,6 @@
-import { existsSync, mkdirSync, readFileSync } from "fs";
 export declare function isValidTimezone(tz: string): boolean;
 export declare function getEnvironment(): string;
 export declare function parseJson(json: string): any;
 export declare function unescapeHTML(str: any): any;
-export declare function deleteTempDirectory(): void;
-export declare function createTempDirectory(mkdirSyncImpl?: typeof mkdirSync, existsSyncImpl?: typeof existsSync): void;
 export declare function toSavedFileName(name: string): string;
-export declare function readFile(name: any, readFileSyncImpl?: typeof readFileSync): string;
-export declare function getEmptyMarkup(): string;
-export declare function tempDirectoryExists(existsSyncImpl?: typeof existsSync): boolean;
-export declare function saveFile(name: string, data: string, writeFileImpl?: any): Promise<void>;
 export declare function removeFalseyValues<T>(obj: T): Partial<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jam-comments/server-utilities",
-  "version": "5.3.0",
+  "version": "5.5.0",
   "description": "Various JavaScript utilities for JamComments.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -24,9 +24,9 @@
   "devDependencies": {
     "@types/node": "^20.14.11",
     "prettier": "^3.3.3",
-    "typescript": "^5.5.3",
+    "typescript": "^5.5.4",
     "vite": "^5.3.4",
-    "vitest": "^2.0.3"
+    "vitest": "^2.0.4"
   },
   "publishConfig": {
     "access": "public"