@xapp/stentor-chat-widget 1.95.2 → 1.97.0

package/lib/__clientTheme.d.ts

@@ -0,0 +1,12 @@
+type WidgetTheme = any;
+export declare function parseRgb(colorString: string): {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+} | null;
+export declare function invertColorRgb(rgb: string, bw?: boolean): string;
+export declare function invertColorHEX(hex: string, bw?: boolean): string;
+export declare function invertColor(color: string, bw?: boolean): string;
+export declare function buildDefaultChatTheme(primaryColor: string, secondaryColor?: string): WidgetTheme;
+export {};

package/lib/__clientTheme.js

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRgb = parseRgb;
+exports.invertColorRgb = invertColorRgb;
+exports.invertColorHEX = invertColorHEX;
+exports.invertColor = invertColor;
+exports.buildDefaultChatTheme = buildDefaultChatTheme;
+function padZero(str, len = 2) { const zeros = new Array(len).join("0"); return (zeros + str).slice(-len); }
+function parseRgb(colorString) {
+    const rgbaRegex = /^rgba?\((\d+),\s*(\d+),\s*(\d+),\s*([\d.]+)\)$/;
+    const rgbRegex = /^rgb?\((\d+),\s*(\d+),\s*(\d+)\)$/;
+    let match;
+    // eslint-disable-next-line no-cond-assign
+    if (match = colorString.match(rgbaRegex)) {
+        const r = parseInt(match[1]);
+        const g = parseInt(match[2]);
+        const b = parseInt(match[3]);
+        const a = parseFloat(match[4]);
+        return { r, g, b, a };
+        // eslint-disable-next-line no-cond-assign
+    }
+    else if (match = colorString.match(rgbRegex)) {
+        const r = parseInt(match[1]);
+        const g = parseInt(match[2]);
+        const b = parseInt(match[3]);
+        return { r, g, b };
+    }
+    else {
+        return null;
+    }
+}
+function invertColorRgb(rgb, bw) {
+    const rgba = parseRgb(rgb);
+    if (!rgba) {
+        return rgb;
+    }
+    const { r, g, b } = rgba;
+    if (bw) {
+        // http://stackoverflow.com/a/3943023/112731
+        return r * 0.299 + g * 0.587 + b * 0.114 > 186 ? "rgba(0, 0, 0, 1)" : "rgba(255, 255, 255, 1)";
+    }
+    return `rgba(${255 - r}, ${255 - g}, ${255 - b}, 1)`;
+}
+function invertColorHEX(hex, bw) {
+    if (!hex) {
+        return undefined;
+    }
+    if (hex.indexOf("#") === 0) {
+        hex = hex.slice(1);
+    }
+    // convert 3-digit hex to 6-digits.
+    if (hex.length === 3) {
+        hex = hex[0] + hex[0] + hex[1] + hex[1] + hex[2] + hex[2];
+    }
+    if (hex.length !== 6) {
+        throw new Error("Invalid HEX color.");
+    }
+    const r = parseInt(hex.slice(0, 2), 16);
+    const g = parseInt(hex.slice(2, 4), 16);
+    const b = parseInt(hex.slice(4, 6), 16);
+    if (bw) {
+        // http://stackoverflow.com/a/3943023/112731
+        return r * 0.299 + g * 0.587 + b * 0.114 > 186 ? "#000000" : "#FFFFFF";
+    }
+    // pad each with zeros and return
+    return "#" + padZero((255 - r).toString(16)) + padZero((255 - g).toString(16)) + padZero((255 - b).toString(16));
+}
+function invertColor(color, bw) {
+    return color.startsWith("#") ? invertColorHEX(color, bw) : invertColorRgb(color, bw);
+}
+function buildDefaultChatTheme(primaryColor, secondaryColor) {
+    const fontFamily = "RobotoRegular";
+    if (!secondaryColor) {
+        secondaryColor = invertColor(primaryColor, true);
+    }
+    return {
+        zIndex: "10000",
+        border: {
+            color: primaryColor,
+            radius: "10px",
+        },
+        carousel: {
+            button: {
+                color: primaryColor,
+            },
+            subtitle: {
+                color: "#979797",
+                fontFamily,
+                fontSize: "12px",
+                fontStyle: "normal",
+                fontWeight: "normal",
+            },
+            title: {
+                color: "#000",
+                fontFamily,
+                fontSize: "14px",
+                fontStyle: "normal",
+                fontWeight: "bold",
+            },
+        },
+        chatButton: {
+            background: primaryColor,
+            margin: {
+                bottom: "10px",
+                left: "10px",
+                right: "10px",
+                top: "10px",
+            },
+        },
+        content: {
+            background: "#ffffff",
+        },
+        cta: {
+            background: "#e1e2e1",
+            text: {
+                // Use a dark color that contrasts well with the light grey background
+                // instead of primaryColor which may not have sufficient contrast
+                color: "#333333",
+                fontFamily,
+                fontSize: "14px",
+            },
+        },
+        footer: {
+            background: primaryColor,
+            border: {
+                color: primaryColor,
+                radius: "0px",
+                width: "0px",
+            },
+            branding: {
+                text: {
+                    color: "#ffffff",
+                    fontFamily,
+                    fontSize: "14px",
+                    fontWeight: "normal",
+                    fontStyle: "normal",
+                },
+            },
+        },
+        header: {
+            background: primaryColor,
+            avatarBackground: "transparent",
+            border: {
+                color: primaryColor,
+                radius: "0px",
+                width: "0px",
+            },
+            text: {
+                color: secondaryColor,
+                fontFamily,
+                fontSize: "16px",
+                fontWeight: "normal",
+                fontStyle: "normal",
+            },
+            subtitle: {
+                color: secondaryColor,
+                fontFamily,
+                fontSize: "10px",
+                fontWeight: "normal",
+                fontStyle: "normal",
+            },
+        },
+        input: {
+            background: "#ffffff",
+            border: {
+                radius: "20px",
+            },
+            text: {
+                color: "#000000",
+                fontFamily,
+                fontSize: "14px",
+            },
+            placeholder: {
+                color: "#e1e2e1",
+                fontFamily,
+                fontSize: "14px",
+                fontWeight: "normal",
+                fontStyle: "normal",
+            },
+        },
+        textTypingStatus: {
+            text: {
+                color: "#bfbfbf",
+                fontFamily,
+                fontSize: "14px",
+                fontWeight: "normal",
+                fontStyle: "normal",
+            },
+        },
+        menu: {
+            item: {
+                height: "24px",
+                text: {
+                    fontSize: "14px",
+                },
+            },
+        },
+        menuButton: {
+            color: "#ffffff",
+        },
+        messages: {
+            maxWidth: "400px",
+            mine: {
+                bubbleColor: "#f2f2f2",
+                text: {
+                    color: "#454545",
+                    fontFamily,
+                    fontSize: "18px",
+                    fontStyle: "normal",
+                    fontWeight: "normal",
+                },
+            },
+            others: {
+                bubbleColor: "#e1e2e1",
+                text: {
+                    color: "#262726",
+                    fontFamily,
+                    fontSize: "18px",
+                    fontStyle: "normal",
+                    fontWeight: "normal",
+                },
+            },
+            padding: {
+                bottom: "0px",
+                left: "20px",
+                right: "16px",
+                top: "16px",
+            },
+        },
+        refreshButton: {
+            color: secondaryColor,
+        },
+        minimizeButton: {
+            color: secondaryColor,
+        },
+        cancelButton: {
+            color: secondaryColor,
+        },
+        primaryColor: primaryColor,
+        sendButton: {
+            color: "#505050",
+            width: "20px",
+        },
+        size: {
+            width: "500px",
+            height: "700px",
+        },
+    };
+}
+//# sourceMappingURL=__clientTheme.js.map

package/lib/__clientTheme.js.map

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

package/lib/__tests__/buildChatWidgetChannel.test.d.ts

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

package/lib/__tests__/buildChatWidgetChannel.test.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const buildChatWidgetChannel_1 = require("../buildChatWidgetChannel");
+/**
+ * The chat widget a new app starts with.
+ *
+ * Built here rather than in stentor-client so Studio can create the same widget
+ * server-side for a get.xapp.ai signup. Two builders would mean onboarding and
+ * the funnel producing subtly different widgets from the same inputs.
+ */
+const BASE = {
+    appId: "buehler-air",
+    apiUrl: "https://api.xapp.ai",
+    mcpUrl: "https://agent.xapp.ai"
+};
+describe("buildChatWidgetChannel", () => {
+    it("connects over MCP by default", () => {
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(BASE);
+        expect(channel.connection.type).toEqual("mcp");
+        expect(channel.connection.serverUrl).toEqual("https://agent.xapp.ai/buehler-air");
+    });
+    it("uses homeowner mode, which needs no auth token", () => {
+        var _a;
+        // The widget runs on a public page. business_owner mode requires a
+        // token, and a token on a public page is not a token.
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(BASE);
+        expect((_a = channel.connection.mcp) === null || _a === void 0 ? void 0 : _a.mode).toEqual("homeowner");
+        expect(JSON.stringify(channel)).not.toContain("authToken");
+    });
+    it("turns the action bar on", () => {
+        var _a;
+        // Chat is not on the default tier, but the action bar is how people
+        // reach booking and the phone, so it ships enabled.
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(BASE);
+        expect((_a = channel.actionBar) === null || _a === void 0 ? void 0 : _a.enabled).toEqual(true);
+    });
+    it("offers booking first, ahead of calling and chat", () => {
+        // Booking is what the business is paying for. Calling is the fallback
+        // for people who will not use a form, and chat is last because it is
+        // the least likely to be enabled on their tier.
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(Object.assign(Object.assign({}, BASE), { formWidgetKey: "fw-1", phoneNumber: "+19042338831" }));
+        expect(channel.actionBar.buttons.map((b) => b.type)).toEqual(["schedule", "phone", "chat"]);
+        expect(channel.actionBar.buttons[0].label).toBeDefined();
+    });
+    it("carries the form widget's key so booking opens our form", () => {
+        var _a, _b, _c, _d;
+        // The button opens the form widget, which is a separate channel with
+        // its own key. Without it the button has nothing to open.
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(Object.assign(Object.assign({}, BASE), { formWidgetKey: "fw-key-123" }));
+        const book = channel.actionBar.buttons.find((b) => b.type === "schedule");
+        expect((_b = (_a = book.formConfig) === null || _a === void 0 ? void 0 : _a.api) === null || _b === void 0 ? void 0 : _b.key).toEqual("fw-key-123");
+        expect((_d = (_c = book.formConfig) === null || _c === void 0 ? void 0 : _c.api) === null || _d === void 0 ? void 0 : _d.url).toEqual("https://api.xapp.ai");
+    });
+    it("omits the booking button until the form widget exists", () => {
+        // The form widget is created first and its key read back. A booking
+        // button with no form behind it is a button that does nothing.
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(BASE);
+        expect(channel.actionBar.buttons.some((b) => b.type === "schedule")).toEqual(false);
+    });
+    it("adds click-to-call when the crawl found a number", () => {
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(Object.assign(Object.assign({}, BASE), { phoneNumber: "+19042338831" }));
+        const phone = channel.actionBar.buttons.find((b) => b.type === "phone");
+        expect(phone.phoneNumber).toEqual("+19042338831");
+    });
+    it("leaves the phone button out when there is no number", () => {
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(BASE);
+        expect(channel.actionBar.buttons.some((b) => b.type === "phone")).toEqual(false);
+    });
+    it("always offers chat itself", () => {
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(BASE);
+        expect(channel.actionBar.buttons.some((b) => b.type === "chat")).toEqual(true);
+    });
+    it("themes from the business's own colour", () => {
+        var _a, _b;
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(Object.assign(Object.assign({}, BASE), { primaryColor: "#f47c4c" }));
+        expect((_b = (_a = channel.theme) === null || _a === void 0 ? void 0 : _a.chatButton) === null || _b === void 0 ? void 0 : _b.background).toEqual("#f47c4c");
+    });
+    it("picks header text that reads on that colour rather than assuming dark", () => {
+        var _a, _b, _c;
+        // #f47c4c scores 154 for perceived brightness against a threshold of
+        // 186, so it takes white text. Assuming dark here is how a widget ships
+        // unreadable. The chat button carries no text of its own — it is an
+        // icon on a background — so the header is where this shows.
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(Object.assign(Object.assign({}, BASE), { primaryColor: "#f47c4c" }));
+        expect((_c = (_b = (_a = channel.theme) === null || _a === void 0 ? void 0 : _a.header) === null || _b === void 0 ? void 0 : _b.text) === null || _c === void 0 ? void 0 : _c.color).toEqual("#FFFFFF");
+    });
+    it("ignores a colour whose contrast cannot be computed", () => {
+        var _a, _b, _c, _d, _e;
+        // A scraped `orange` is valid CSS and unusable here: we cannot work out
+        // what text reads on it. Theming the header with it and guessing the
+        // text colour is how you ship invisible text, so the neutral default is
+        // used for both instead — background and foreground always a computed
+        // pair.
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(Object.assign(Object.assign({}, BASE), { primaryColor: "orange" }));
+        expect((_b = (_a = channel.theme) === null || _a === void 0 ? void 0 : _a.header) === null || _b === void 0 ? void 0 : _b.background).not.toEqual("orange");
+        expect(["#000000", "#FFFFFF"]).toContain((_e = (_d = (_c = channel.theme) === null || _c === void 0 ? void 0 : _c.header) === null || _d === void 0 ? void 0 : _d.text) === null || _e === void 0 ? void 0 : _e.color);
+    });
+    it("keeps a colour it can compute against", () => {
+        var _a, _b, _c, _d, _e;
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(Object.assign(Object.assign({}, BASE), { primaryColor: "rgb(20, 52, 204)" }));
+        expect((_b = (_a = channel.theme) === null || _a === void 0 ? void 0 : _a.header) === null || _b === void 0 ? void 0 : _b.background).toEqual("rgb(20, 52, 204)");
+        expect((_e = (_d = (_c = channel.theme) === null || _c === void 0 ? void 0 : _c.header) === null || _d === void 0 ? void 0 : _d.text) === null || _e === void 0 ? void 0 : _e.color).toEqual("#FFFFFF");
+    });
+    it("still builds a widget when the crawl found no colour", () => {
+        const channel = (0, buildChatWidgetChannel_1.buildChatWidgetChannel)(BASE);
+        expect(channel.theme).toBeDefined();
+        expect(channel.type).toEqual("chat-widget");
+    });
+    it("does not invent an id", () => {
+        // The id is assigned when the channel is written. A builder that made
+        // one up would be creating a second source of truth for it.
+        expect((0, buildChatWidgetChannel_1.buildChatWidgetChannel)(BASE).id).toBeUndefined();
+    });
+});
+//# sourceMappingURL=buildChatWidgetChannel.test.js.map

package/lib/__tests__/buildChatWidgetChannel.test.js.map

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

package/lib/__tests__/color.test.d.ts

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

package/lib/__tests__/color.test.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const color_1 = require("../color");
+/**
+ * These decide whether a widget's text is legible on the colour we scraped off
+ * a customer's website, so the contrast rule matters more than the inversion.
+ */
+describe("invertColorHEX", () => {
+    it("inverts a colour", () => {
+        expect((0, color_1.invertColorHEX)("#ffffff")).toEqual("#000000");
+        expect((0, color_1.invertColorHEX)("#000000")).toEqual("#ffffff");
+    });
+    it("expands three-digit hex", () => {
+        expect((0, color_1.invertColorHEX)("#fff")).toEqual((0, color_1.invertColorHEX)("#ffffff"));
+    });
+    it("accepts a colour with no leading hash", () => {
+        expect((0, color_1.invertColorHEX)("ffffff")).toEqual("#000000");
+    });
+    it("returns black or white when asked for contrast rather than inversion", () => {
+        // A mid-tone inverts to another mid-tone, which is unreadable behind
+        // text. bw picks whichever of black or white actually reads.
+        //
+        // Buehler's orange looks light and is not: weighted for perceived
+        // brightness it scores 154 against a threshold of 186, so it takes
+        // white text. Eyeballing this is how you ship an unreadable widget.
+        expect((0, color_1.invertColorHEX)("#f47c4c", true)).toEqual("#FFFFFF");
+        expect((0, color_1.invertColorHEX)("#0b83b3", true)).toEqual("#FFFFFF");
+        expect((0, color_1.invertColorHEX)("#c1bdb2", true)).toEqual("#000000");
+    });
+    it("has no answer for a missing colour", () => {
+        expect((0, color_1.invertColorHEX)(undefined)).toBeUndefined();
+        expect((0, color_1.invertColorHEX)("")).toBeUndefined();
+    });
+    it("refuses a value that is not a colour", () => {
+        expect(() => (0, color_1.invertColorHEX)("#12345")).toThrow(/Invalid HEX/);
+    });
+});
+describe("readableTextOn", () => {
+    it("picks the text colour that reads on the background", () => {
+        // From real crawls: Buehler's orange (154), Affordable Pest's grey
+        // (189) and XAPP's blue (60), against the 186 threshold.
+        expect((0, color_1.readableTextOn)("#f47c4c")).toEqual("#FFFFFF");
+        expect((0, color_1.readableTextOn)("#c1bdb2")).toEqual("#000000");
+        expect((0, color_1.readableTextOn)("#1434cc")).toEqual("#FFFFFF");
+    });
+    it("falls back to dark text when there is no background colour", () => {
+        // Better a readable default than a widget with white-on-white text
+        // because a crawl came back without a colour.
+        expect((0, color_1.readableTextOn)(undefined)).toEqual("#000000");
+    });
+});
+describe("invertColor", () => {
+    it("handles rgb as well as hex", () => {
+        // rgb input answers in rgb notation, as it always has. readableTextOn
+        // is the one that normalises, because a theme wants one shape.
+        expect((0, color_1.invertColor)("#ffffff", true)).toEqual("#000000");
+        expect((0, color_1.invertColor)("rgb(255, 255, 255)", true)).toEqual("rgba(0, 0, 0, 1)");
+    });
+    it("normalises rgb through readableTextOn", () => {
+        expect((0, color_1.readableTextOn)("rgb(255, 255, 255)")).toEqual("#000000");
+        expect((0, color_1.readableTextOn)("rgb(20, 52, 204)")).toEqual("#FFFFFF");
+    });
+});
+describe("readableTextOn with colours we cannot parse", () => {
+    it("never answers with the background it was given", () => {
+        // A CSS named colour is entirely plausible from a scrape — hand-written
+        // stylesheets are full of `orange`, `tomato`, `steelblue`. Returning it
+        // unchanged put the header text at exactly the header background.
+        expect((0, color_1.readableTextOn)("orange")).not.toEqual("orange");
+        expect((0, color_1.readableTextOn)("navy")).not.toEqual("navy");
+    });
+    it("only ever answers black or white", () => {
+        const answers = ["orange", "navy", "rgb( 255, 0, 0)", "RGB(255,0,0)", "hsl(9, 100%, 64%)", "#f47c4c", "not a colour"]
+            .map(color_1.readableTextOn);
+        answers.forEach((answer) => {
+            expect(["#000000", "#FFFFFF"]).toContain(answer);
+        });
+    });
+});
+describe("isSupportedColor", () => {
+    it("recognises the notations we can compute contrast for", () => {
+        expect((0, color_1.isSupportedColor)("#f47c4c")).toEqual(true);
+        expect((0, color_1.isSupportedColor)("#fff")).toEqual(true);
+        expect((0, color_1.isSupportedColor)("rgb(255, 0, 0)")).toEqual(true);
+        expect((0, color_1.isSupportedColor)("rgba(255, 0, 0, 0.5)")).toEqual(true);
+    });
+    it("rejects everything else, including named colours", () => {
+        // Not "these are invalid" — they are perfectly good CSS. We just
+        // cannot work out what text reads on them, and a background whose
+        // contrast we cannot compute is one we must not use.
+        expect((0, color_1.isSupportedColor)("orange")).toEqual(false);
+        expect((0, color_1.isSupportedColor)("hsl(9, 100%, 64%)")).toEqual(false);
+        expect((0, color_1.isSupportedColor)("#12345")).toEqual(false);
+        expect((0, color_1.isSupportedColor)(undefined)).toEqual(false);
+        expect((0, color_1.isSupportedColor)("")).toEqual(false);
+    });
+});
+describe("usableColorOr", () => {
+    it("keeps a colour we can compute contrast against", () => {
+        expect((0, color_1.usableColorOr)("#f47c4c", "#1AA7DC")).toEqual("#f47c4c");
+        expect((0, color_1.usableColorOr)("rgb(20, 52, 204)", "#1AA7DC")).toEqual("rgb(20, 52, 204)");
+    });
+    it("substitutes the fallback for anything else", () => {
+        // Including colours that are perfectly valid CSS. If we cannot work out
+        // what text reads on it, we must not use it as a background — the text
+        // colour would be a guess paired with an unknown.
+        expect((0, color_1.usableColorOr)("orange", "#1AA7DC")).toEqual("#1AA7DC");
+        expect((0, color_1.usableColorOr)("hsl(9, 100%, 64%)", "#1AA7DC")).toEqual("#1AA7DC");
+        expect((0, color_1.usableColorOr)(undefined, "#1AA7DC")).toEqual("#1AA7DC");
+        expect((0, color_1.usableColorOr)("", "#1AA7DC")).toEqual("#1AA7DC");
+    });
+});
+describe("darkenColor", () => {
+    it("darkens hex", () => {
+        expect((0, color_1.darkenColor)("#1434cc", 20)).toEqual("#0020b8");
+    });
+    it("darkens rgb without an alpha", () => {
+        expect((0, color_1.darkenColor)("rgb(20, 52, 204)", 20)).toEqual("#0020b8");
+    });
+    it("has no opinion about a missing colour", () => {
+        expect((0, color_1.darkenColor)(undefined, 20)).toBeUndefined();
+    });
+    it("returns unsupported input unchanged", () => {
+        expect((0, color_1.darkenColor)("orange", 20)).toEqual("orange");
+    });
+    /**
+     * Fixed here, and therefore the one place this package deliberately does
+     * not match stentor-client.
+     *
+     * The alpha branch computed luminance on the 0-255 scale the channels use
+     * and then clamped it to 0-1, so it collapsed to 1 for every real colour
+     * and the ratio crushed the result to near-black: rgba(20, 52, 204, 0.8)
+     * darkened by 20% came back rgba(0, 1, 3, 1). Clamping on the right scale
+     * makes it do what it says — scale each channel by 1 - amount/100.
+     *
+     * The client still has the old behaviour, so a form themed from an rgba
+     * colour will change appearance when it migrates onto this. That is the
+     * intended outcome rather than a regression: near-black was never what
+     * anyone asked for, and consolidating these builders is what makes one fix
+     * enough.
+     *
+     * Neither version is reachable from the funnel — Arachne reports
+     * site.primaryColor as hex.
+     */
+    it("darkens rgba proportionally rather than crushing it", () => {
+        // 80% of each channel, which is what "20% darker" should mean.
+        expect((0, color_1.darkenColor)("rgba(20, 52, 204, 0.8)", 20)).toEqual("rgba(16, 42, 163, 1)");
+        expect((0, color_1.darkenColor)("rgba(255, 0, 0, 0.5)", 20)).toEqual("rgba(204, 0, 0, 0.7)");
+    });
+    it("leaves the hex and rgb paths exactly as they were", () => {
+        // Those branches were correct and are untouched, so the parity tests
+        // over hex colours still hold.
+        expect((0, color_1.darkenColor)("#1434cc", 20)).toEqual("#0020b8");
+        expect((0, color_1.darkenColor)("rgb(20, 52, 204)", 20)).toEqual("#0020b8");
+    });
+});
+//# sourceMappingURL=color.test.js.map

package/lib/__tests__/color.test.js.map

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

package/lib/__tests__/themeParity.test.d.ts

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

package/lib/__tests__/themeParity.test.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const __clientTheme_1 = require("../__clientTheme");
+const buildChatWidgetChannel_1 = require("../buildChatWidgetChannel");
+/**
+ * The port has to be faithful, or migrating stentor-client to it restyles every
+ * widget created afterwards. This compares the two directly rather than
+ * trusting that it looks right.
+ *
+ * `__clientTheme.ts` is stentor-client's function, extracted verbatim with its
+ * colour helpers inlined so it can run here. It goes away once the client is
+ * migrated and there is only one of these left.
+ */
+describe("parity with stentor-client's buildDefaultChatTheme", () => {
+    // Hex is what a crawl actually yields — Arachne reports site.primaryColor
+    // as hex — so these are the cases that matter, and they are byte-identical.
+    const HEX = ["#f47c4c", "#c1bdb2", "#1434cc", "#1AA7DC", "#000000", "#ffffff"];
+    HEX.forEach((primaryColor) => {
+        it(`produces the same theme for ${primaryColor}`, () => {
+            expect((0, buildChatWidgetChannel_1.buildChatTheme)(primaryColor)).toEqual((0, __clientTheme_1.buildDefaultChatTheme)(primaryColor));
+        });
+    });
+    it("differs from the client only in notation for rgb input", () => {
+        // The one intentional difference. Given rgb, the client's contrast
+        // helper answers "rgba(255, 255, 255, 1)" while readableTextOn
+        // normalises to "#FFFFFF". Same colour, one shape instead of two — and
+        // not reachable from a crawl, which reports hex.
+        const mine = JSON.stringify((0, buildChatWidgetChannel_1.buildChatTheme)("rgb(20, 52, 204)"));
+        const theirs = JSON.stringify((0, __clientTheme_1.buildDefaultChatTheme)("rgb(20, 52, 204)"));
+        expect(mine.replace(/#FFFFFF/g, "rgba(255, 255, 255, 1)")).toEqual(theirs);
+    });
+    it("produces the same theme when a secondary colour is supplied", () => {
+        expect((0, buildChatWidgetChannel_1.buildChatTheme)("#f47c4c", "#ffffff")).toEqual((0, __clientTheme_1.buildDefaultChatTheme)("#f47c4c", "#ffffff"));
+    });
+});
+//# sourceMappingURL=themeParity.test.js.map

package/lib/__tests__/themeParity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeParity.test.js","sourceRoot":"","sources":["../../src/__tests__/themeParity.test.ts"],"names":[],"mappings":";;AAAA,oDAAyD;AACzD,sEAA2D;AAE3D;;;;;;;;GAQG;AACH,QAAQ,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAEhE,0EAA0E;IAC1E,4EAA4E;IAC5E,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAE/E,GAAG,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;QACzB,EAAE,CAAC,+BAA+B,YAAY,EAAE,EAAE,GAAG,EAAE;YACnD,MAAM,CAAC,IAAA,uCAAc,EAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,IAAA,qCAAqB,EAAC,YAAY,CAAC,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAC9D,mEAAmE;QACnE,+DAA+D;QAC/D,uEAAuE;QACvE,iDAAiD;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAA,uCAAc,EAAC,kBAAkB,CAAC,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAA,qCAAqB,EAAC,kBAAkB,CAAC,CAAC,CAAC;QAEzE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,IAAA,uCAAc,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAA,qCAAqB,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}