@bash-app/bash-common 30.247.0 → 30.253.0

package/dist/utils/__tests__/blogUtils.test.js

@@ -0,0 +1,102 @@
+import { describe, expect, test } from "@jest/globals";
+import { DEFAULT_BLOG_IMAGE } from "../../definitions.js";
+import { calculateReadingTime, formatPublishDate, generateBlogDetailUrl, generateExcerpt, generateMetaDescription, generateMetaTitle, getBlogDetailUrl, getBlogImageUrl, highlightSearchTerms, parseBlogUrlParams, processTags, validateBlogContent, } from "../blogUtils.js";
+describe("blogUtils", () => {
+    describe("URL helpers", () => {
+        test("generateBlogDetailUrl with slug", () => {
+            expect(generateBlogDetailUrl("abc123", "my-post")).toBe("/blog/abc123-my-post");
+        });
+        test("generateBlogDetailUrl without slug", () => {
+            expect(generateBlogDetailUrl("abc123")).toBe("/blog/abc123");
+        });
+        test("getBlogDetailUrl prefers explicit slug", () => {
+            expect(getBlogDetailUrl("id1", "saved-slug", "Ignored Title")).toBe("/blog/id1-saved-slug");
+        });
+        test("getBlogDetailUrl generates slug from title when slug missing", () => {
+            expect(getBlogDetailUrl("id1", undefined, "Hello World Party")).toBe("/blog/id1-hello-world-party");
+        });
+        test("getBlogDetailUrl falls back to id-only URL", () => {
+            expect(getBlogDetailUrl("id1")).toBe("/blog/id1");
+        });
+        test("parseBlogUrlParams handles id-only param", () => {
+            expect(parseBlogUrlParams("abc123")).toEqual({ id: "abc123" });
+        });
+        test("parseBlogUrlParams splits id-slug at first hyphen", () => {
+            expect(parseBlogUrlParams("abc123-my-cool-post")).toEqual({
+                id: "abc123",
+                slug: "my-cool-post",
+            });
+        });
+        test("parseBlogUrlParams returns null for empty input", () => {
+            expect(parseBlogUrlParams("")).toBeNull();
+        });
+    });
+    describe("content processing", () => {
+        test("generateExcerpt strips HTML tags", () => {
+            expect(generateExcerpt("<p>Hello <strong>world</strong></p>")).toBe("Hello world");
+        });
+        test("generateExcerpt truncates at word boundary with ellipsis", () => {
+            const long = "word ".repeat(50);
+            const excerpt = generateExcerpt(long, 20);
+            expect(excerpt.endsWith("...")).toBe(true);
+            expect(excerpt.length).toBeLessThanOrEqual(23);
+        });
+        test("calculateReadingTime rounds up by word count", () => {
+            const words = Array.from({ length: 401 }, (_, i) => `w${i}`).join(" ");
+            expect(calculateReadingTime(words)).toBe(3);
+        });
+        test("getBlogImageUrl uses default when missing", () => {
+            expect(getBlogImageUrl(null)).toBe(DEFAULT_BLOG_IMAGE);
+            expect(getBlogImageUrl("https://cdn.example/img.jpg")).toBe("https://cdn.example/img.jpg");
+        });
+    });
+    describe("SEO helpers", () => {
+        test("generateMetaTitle appends site name", () => {
+            expect(generateMetaTitle("My Post")).toBe("My Post | Bash");
+            expect(generateMetaTitle("My Post", "Custom")).toBe("My Post | Custom");
+        });
+        test("generateMetaDescription uses excerpt or fallback", () => {
+            const content = "x".repeat(200);
+            expect(generateMetaDescription(content, "Title")).toContain("...");
+            expect(generateMetaDescription("", "Title")).toContain("Title");
+        });
+    });
+    describe("validateBlogContent", () => {
+        test("accepts valid title and content", () => {
+            expect(validateBlogContent("Good title", "x".repeat(100))).toEqual({ isValid: true, errors: [] });
+        });
+        test("collects validation errors", () => {
+            const result = validateBlogContent("", "short");
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toContain("Title is required");
+            expect(result.errors).toContain("Content must be at least 100 characters");
+        });
+    });
+    describe("processTags", () => {
+        test("splits, trims, lowercases, and caps at 10 tags", () => {
+            const tags = processTags(" Jazz, ROCK , ,Blues, " + "tag,".repeat(15));
+            expect(tags[0]).toBe("jazz");
+            expect(tags[1]).toBe("rock");
+            expect(tags.length).toBeLessThanOrEqual(10);
+        });
+        test("returns empty array for blank input", () => {
+            expect(processTags("")).toEqual([]);
+        });
+    });
+    describe("highlightSearchTerms", () => {
+        test("wraps matches in mark tags case-insensitively", () => {
+            expect(highlightSearchTerms("Hello Bash world", "bash")).toBe("Hello <mark>Bash</mark> world");
+        });
+        test("returns text unchanged when search term empty", () => {
+            expect(highlightSearchTerms("Hello", "")).toBe("Hello");
+        });
+    });
+    describe("formatPublishDate", () => {
+        test("formats Date and ISO string consistently", () => {
+            const date = new Date("2024-06-15T12:00:00Z");
+            expect(formatPublishDate(date)).toMatch(/June/);
+            expect(formatPublishDate("2024-06-15T12:00:00Z")).toMatch(/2024/);
+        });
+    });
+});
+//# sourceMappingURL=blogUtils.test.js.map

package/dist/utils/__tests__/blogUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blogUtils.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/blogUtils.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/__tests__/dateTimeUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dateTimeUtils.test.d.ts.map

package/dist/utils/__tests__/dateTimeUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateTimeUtils.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/dateTimeUtils.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/dateTimeUtils.test.js

@@ -0,0 +1,180 @@
+/**
+ * dateTimeUtils — parsing, comparison, and normalization helpers.
+ * Pin UTC normalization and comparison semantics with fixed instants.
+ */
+import { DateTime } from "luxon";
+import { describe, expect, test, beforeEach, afterEach, jest } from "@jest/globals";
+import { getLocalTimezoneName, ensureIsDateTime, normalizeDate, normalizeDates, dateWithinDateRange, findLatestDateTime, isDateTimeLaterThanNow, areDateTimesEqual, compareDateTime, parseTimeString, timestampMinutesFromNow, } from "../dateTimeUtils.js";
+describe("getLocalTimezoneName", () => {
+    test("returns a non-empty timezone string", () => {
+        const tz = getLocalTimezoneName();
+        expect(typeof tz).toBe("string");
+        expect(tz.length).toBeGreaterThan(0);
+    });
+});
+describe("ensureIsDateTime", () => {
+    test("returns undefined for null/undefined", () => {
+        expect(ensureIsDateTime(null)).toBeUndefined();
+        expect(ensureIsDateTime(undefined)).toBeUndefined();
+    });
+    test("returns Date for Date input", () => {
+        const d = new Date("2026-03-07T12:00:00Z");
+        expect(ensureIsDateTime(d)).toBe(d);
+    });
+    test("parses ISO string to Date", () => {
+        const result = ensureIsDateTime("2026-03-07T12:00:00Z");
+        expect(result).toBeInstanceOf(Date);
+        expect(result?.toISOString()).toBe("2026-03-07T12:00:00.000Z");
+    });
+});
+describe("normalizeDate", () => {
+    test("returns undefined for null/undefined", () => {
+        expect(normalizeDate(null)).toBeUndefined();
+        expect(normalizeDate(undefined)).toBeUndefined();
+    });
+    test("returns undefined for invalid date", () => {
+        const spy = jest.spyOn(console, "error").mockImplementation(() => { });
+        expect(normalizeDate("not-a-date")).toBeUndefined();
+        expect(spy).toHaveBeenCalled();
+        spy.mockRestore();
+    });
+    test("normalizes to UTC start of minute", () => {
+        const input = new Date("2026-03-07T12:34:56.789Z");
+        const result = normalizeDate(input);
+        expect(result).toEqual(DateTime.fromJSDate(input).toUTC().startOf("minute").toJSDate());
+    });
+    test("accepts ISO string input", () => {
+        const result = normalizeDate("2026-03-07T12:34:56.789Z");
+        expect(result?.getUTCSeconds()).toBe(0);
+        expect(result?.getUTCMilliseconds()).toBe(0);
+    });
+});
+describe("normalizeDates", () => {
+    test("filters out invalid dates", () => {
+        const spy = jest.spyOn(console, "error").mockImplementation(() => { });
+        const results = normalizeDates([
+            "2026-03-07T12:00:00Z",
+            null,
+            "bad",
+            "2026-03-08T12:00:00Z",
+        ]);
+        expect(results).toHaveLength(2);
+        spy.mockRestore();
+    });
+});
+describe("compareDateTime", () => {
+    test("returns 0 when both dates are null/undefined", () => {
+        expect(compareDateTime(null, null)).toBe(0);
+        expect(compareDateTime(undefined, undefined)).toBe(0);
+    });
+    test("null date1 is treated as earlier", () => {
+        const d = new Date("2026-03-07T12:00:00Z");
+        expect(compareDateTime(null, d)).toBe(-1);
+    });
+    test("null date2 is treated as earlier than date1", () => {
+        const d = new Date("2026-03-07T12:00:00Z");
+        expect(compareDateTime(d, null)).toBe(1);
+    });
+    test("compares Date objects", () => {
+        const earlier = new Date("2026-03-07T10:00:00Z");
+        const later = new Date("2026-03-07T12:00:00Z");
+        expect(compareDateTime(later, earlier)).toBe(1);
+        expect(compareDateTime(earlier, later)).toBe(-1);
+        expect(compareDateTime(earlier, earlier)).toBe(0);
+    });
+    test("compares ISO strings", () => {
+        expect(compareDateTime("2026-03-07T12:00:00Z", "2026-03-07T10:00:00Z")).toBe(1);
+        expect(compareDateTime("2026-03-07T10:00:00Z", "2026-03-07T12:00:00Z")).toBe(-1);
+    });
+});
+describe("areDateTimesEqual", () => {
+    test("returns true for equal instants", () => {
+        const d = new Date("2026-03-07T12:00:00Z");
+        expect(areDateTimesEqual(d, d)).toBe(true);
+        expect(areDateTimesEqual("2026-03-07T12:00:00Z", d)).toBe(true);
+    });
+    test("returns false for different instants", () => {
+        expect(areDateTimesEqual("2026-03-07T12:00:00Z", "2026-03-07T10:00:00Z")).toBe(false);
+    });
+});
+describe("findLatestDateTime", () => {
+    test("returns the later date", () => {
+        const earlier = "2026-03-07T10:00:00Z";
+        const later = "2026-03-07T12:00:00Z";
+        expect(findLatestDateTime(earlier, later)?.toISOString()).toBe(new Date(later).toISOString());
+        expect(findLatestDateTime(later, earlier)?.toISOString()).toBe(new Date(later).toISOString());
+    });
+});
+describe("isDateTimeLaterThanNow", () => {
+    beforeEach(() => {
+        jest.useFakeTimers();
+        jest.setSystemTime(new Date("2026-03-07T12:00:00Z"));
+    });
+    afterEach(() => {
+        jest.useRealTimers();
+    });
+    test("returns true for future dates", () => {
+        expect(isDateTimeLaterThanNow("2026-03-07T13:00:00Z")).toBe(true);
+    });
+    test("returns false for past dates", () => {
+        expect(isDateTimeLaterThanNow("2026-03-07T11:00:00Z")).toBe(false);
+    });
+});
+describe("dateWithinDateRange", () => {
+    test("returns true when date is within inclusive start, exclusive end", () => {
+        const inRange = dateWithinDateRange("2026-03-07T15:00:00Z", {
+            startDate: new Date("2026-03-07T00:00:00Z"),
+            endDate: new Date("2026-03-08T00:00:00Z"),
+        });
+        expect(inRange).toBe(true);
+    });
+    test("returns false when date is on or after end day", () => {
+        const onEndDay = dateWithinDateRange("2026-03-08T12:00:00Z", {
+            startDate: new Date("2026-03-07T00:00:00Z"),
+            endDate: new Date("2026-03-08T00:00:00Z"),
+        });
+        expect(onEndDay).toBe(false);
+    });
+    test("defaults to today when range is undefined", () => {
+        jest.useFakeTimers();
+        jest.setSystemTime(new Date("2026-03-07T15:00:00Z"));
+        expect(dateWithinDateRange("2026-03-07T16:00:00Z", undefined)).toBe(true);
+        expect(dateWithinDateRange("2026-03-09T12:00:00Z", undefined)).toBe(false);
+        jest.useRealTimers();
+    });
+});
+describe("parseTimeString", () => {
+    test("parses 10:30 AM", () => {
+        expect(parseTimeString("10:30 AM")).toEqual({ hours: 10, minutes: 30, ampm: "AM" });
+    });
+    test("parses 10:30 PM as 24h hours", () => {
+        expect(parseTimeString("10:30 PM")).toEqual({ hours: 22, minutes: 30, ampm: "PM" });
+    });
+    test("parses 12:00 PM", () => {
+        expect(parseTimeString("12:00 PM")).toEqual({ hours: 12, minutes: 0, ampm: "PM" });
+    });
+    test("parses 1:05 AM", () => {
+        expect(parseTimeString("1:05 AM")).toEqual({ hours: 1, minutes: 5, ampm: "AM" });
+    });
+    test("returns null for invalid formats", () => {
+        expect(parseTimeString("")).toBeNull();
+        expect(parseTimeString("25:00 AM")).toBeNull();
+        expect(parseTimeString("10:60 AM")).toBeNull();
+        expect(parseTimeString("10:30")).toBeNull();
+        expect(parseTimeString("noon")).toBeNull();
+    });
+});
+describe("timestampMinutesFromNow", () => {
+    beforeEach(() => {
+        jest.useFakeTimers();
+        jest.setSystemTime(new Date("2026-03-07T12:00:00Z"));
+    });
+    afterEach(() => {
+        jest.useRealTimers();
+    });
+    test("returns unix seconds floored for N minutes ahead", () => {
+        const expected = Math.floor(DateTime.fromJSDate(new Date("2026-03-07T12:00:00Z")).plus({ minutes: 30 }).toSeconds());
+        expect(timestampMinutesFromNow(30)).toBe(expected);
+    });
+});
+//# sourceMappingURL=dateTimeUtils.test.js.map

package/dist/utils/__tests__/dateTimeUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateTimeUtils.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/dateTimeUtils.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/__tests__/discountEngine/discountCalculator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=discountCalculator.test.d.ts.map

package/dist/utils/__tests__/discountEngine/discountCalculator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discountCalculator.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/__tests__/discountEngine/discountCalculator.test.ts"],"names":[],"mappings":""}