@xapp/stentor-chat-widget 1.95.2 → 1.96.0

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,98 @@
+"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);
+    });
+});
+//# 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/buildChatWidgetChannel.d.ts

@@ -0,0 +1,52 @@
+import { ChatWidgetChannelData } from "./ChannelData";
+import { WidgetTheme } from "./WidgetTheme";
+/**
+ * The chat widget a newly created app starts with.
+ *
+ * This lived in stentor-client, which meant a widget could only be built by a
+ * browser. Studio creates apps server-side too — a get.xapp.ai signup is
+ * confirmed by an email click, with no browser anywhere — and two builders fed
+ * the same business would drift into two different-looking widgets.
+ *
+ * The urls are parameters rather than read from configuration, because the two
+ * callers know their own environment and this package should not.
+ */
+/**
+ * The channel as it is created, before it has one.
+ *
+ * `id` is assigned when the channel is written — it is not ours to invent —
+ * so what a builder can produce is everything except that.
+ */
+export type NewChatWidgetChannel = Omit<ChatWidgetChannelData, "id">;
+export interface BuildChatWidgetChannelProps {
+    appId: string;
+    apiUrl: string;
+    mcpUrl: string;
+    /**
+     * The business's own colour, as scraped. Absent is normal.
+     *
+     * Ignored unless we can compute what text reads on it — a named colour
+     * like `orange` is valid CSS and unusable here, and pairing it with a
+     * guessed foreground is how a widget ships with invisible text.
+     */
+    primaryColor?: string;
+    /**
+     * The form widget channel's key, which the booking button opens.
+     *
+     * The form widget has to be created first for this to exist. Without it the
+     * booking button is left out entirely rather than shipped pointing at
+     * nothing.
+     */
+    formWidgetKey?: string;
+    /** Click-to-call number, if the crawl found one. */
+    phoneNumber?: string;
+}
+export declare function buildChatWidgetChannel(props: BuildChatWidgetChannelProps): NewChatWidgetChannel;
+/**
+ * A theme derived from the business's own colour.
+ *
+ * Only the text colour is computed rather than chosen: which of black or white
+ * reads on a given background is arithmetic, and getting it wrong ships a
+ * widget nobody can read.
+ */
+export declare function buildChatTheme(primaryColor: string): WidgetTheme;

package/lib/buildChatWidgetChannel.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildChatWidgetChannel = buildChatWidgetChannel;
+exports.buildChatTheme = buildChatTheme;
+const color_1 = require("./color");
+/** Fallback when a crawl found no branding. Deliberately neutral. */
+const DEFAULT_PRIMARY = "#1AA7DC";
+function buildChatWidgetChannel(props) {
+    const { appId, apiUrl, mcpUrl, formWidgetKey, phoneNumber } = props;
+    // Only a colour whose contrast can actually be computed, so the background
+    // and the text on it are always a matched pair rather than one scraped
+    // value and one guess.
+    const primaryColor = (0, color_1.isSupportedColor)(props.primaryColor) ? props.primaryColor : DEFAULT_PRIMARY;
+    return {
+        type: "chat-widget",
+        // MCP by default. The widget runs on a public page, so homeowner mode
+        // — which is unauthenticated and carries the appId in the url — is the
+        // only one that can work there; business_owner needs a token, and a
+        // token on a public page is not a token.
+        connection: {
+            type: "mcp",
+            serverUrl: `${mcpUrl}/${appId}`,
+            mcp: {
+                mode: "homeowner"
+            }
+        },
+        theme: buildChatTheme(primaryColor),
+        actionBar: buildActionBar({ apiUrl, primaryColor, formWidgetKey, phoneNumber })
+    };
+}
+/**
+ * The dock of buttons that replaces the plain chat bubble.
+ *
+ * On by default, which is the part worth explaining: chat is not on the default
+ * tier, but the action bar is how someone reaches booking and the phone, and
+ * those are what the business is paying for.
+ *
+ * Order is deliberate. Booking is the thing we are selling, so it comes first;
+ * calling is the fallback for people who will not use a form; chat is last
+ * because it is the least likely to be enabled.
+ */
+function buildActionBar(props) {
+    const { apiUrl, formWidgetKey, phoneNumber } = props;
+    const buttons = [];
+    if (formWidgetKey) {
+        buttons.push({
+            id: "book",
+            type: "schedule",
+            label: "Book",
+            formConfig: {
+                api: {
+                    url: apiUrl,
+                    key: formWidgetKey
+                }
+            }
+        });
+    }
+    if (phoneNumber) {
+        buttons.push({
+            id: "call",
+            type: "phone",
+            label: "Call",
+            phoneNumber
+        });
+    }
+    buttons.push({
+        id: "chat",
+        type: "chat",
+        label: "Chat"
+    });
+    return {
+        enabled: true,
+        position: "right",
+        buttons
+    };
+}
+/**
+ * A theme derived from the business's own colour.
+ *
+ * Only the text colour is computed rather than chosen: which of black or white
+ * reads on a given background is arithmetic, and getting it wrong ships a
+ * widget nobody can read.
+ */
+function buildChatTheme(primaryColor) {
+    const onPrimary = (0, color_1.readableTextOn)(primaryColor);
+    return {
+        zIndex: "10000",
+        border: {
+            color: primaryColor,
+            radius: "10px"
+        },
+        chatButton: {
+            background: primaryColor,
+            margin: {
+                bottom: "10px",
+                left: "10px",
+                right: "10px",
+                top: "10px"
+            }
+        },
+        content: {
+            background: "#ffffff"
+        },
+        header: {
+            background: primaryColor,
+            text: {
+                color: onPrimary
+            }
+        }
+    };
+}
+//# sourceMappingURL=buildChatWidgetChannel.js.map

package/lib/buildChatWidgetChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildChatWidgetChannel.js","sourceRoot":"","sources":["../src/buildChatWidgetChannel.ts"],"names":[],"mappings":";;AAqDA,wDAuBC;AAiED,wCA4BC;AAtKD,mCAA2D;AA+C3D,qEAAqE;AACrE,MAAM,eAAe,GAAG,SAAS,CAAC;AAElC,SAAgB,sBAAsB,CAAC,KAAkC;IACrE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IACpE,2EAA2E;IAC3E,uEAAuE;IACvE,uBAAuB;IACvB,MAAM,YAAY,GAAG,IAAA,wBAAgB,EAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC;IAEjG,OAAO;QACH,IAAI,EAAE,aAAa;QACnB,sEAAsE;QACtE,uEAAuE;QACvE,oEAAoE;QACpE,yCAAyC;QACzC,UAAU,EAAE;YACR,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,GAAG,MAAM,IAAI,KAAK,EAAE;YAC/B,GAAG,EAAE;gBACD,IAAI,EAAE,WAAW;aACpB;SACJ;QACD,KAAK,EAAE,cAAc,CAAC,YAAY,CAAC;QACnC,SAAS,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;KAC1D,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,cAAc,CAAC,KAKvB;IACG,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IACrD,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,IAAI,aAAa,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,MAAM;YACb,UAAU,EAAE;gBACR,GAAG,EAAE;oBACD,GAAG,EAAE,MAAM;oBACX,GAAG,EAAE,aAAa;iBACrB;aACJ;SACJ,CAAC,CAAC;IACP,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,MAAM;YACb,WAAW;SACd,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,IAAI,CAAC;QACT,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;KAChB,CAAC,CAAC;IAEH,OAAO;QACH,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,OAAO;QACjB,OAAO;KACV,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,YAAoB;IAC/C,MAAM,SAAS,GAAG,IAAA,sBAAc,EAAC,YAAY,CAAC,CAAC;IAE/C,OAAO;QACH,MAAM,EAAE,OAAO;QACf,MAAM,EAAE;YACJ,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,MAAM;SACjB;QACD,UAAU,EAAE;YACR,UAAU,EAAE,YAAY;YACxB,MAAM,EAAE;gBACJ,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,MAAM;gBACb,GAAG,EAAE,MAAM;aACd;SACJ;QACD,OAAO,EAAE;YACL,UAAU,EAAE,SAAS;SACxB;QACD,MAAM,EAAE;YACJ,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE;gBACF,KAAK,EAAE,SAAS;aACnB;SACJ;KACW,CAAC;AACrB,CAAC"}

package/lib/color.d.ts

@@ -0,0 +1,43 @@
+/*! Copyright (c) 2026, XAPP AI */
+export interface Rgb {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+}
+export declare function parseRgb(colorString: string): Rgb | null;
+/**
+ * Inverts a hex colour, or returns black/white for contrast when `bw` is set.
+ *
+ * Inverting is rarely what you want behind text — a mid-tone inverts to another
+ * mid-tone and neither reads. `bw` is the contrast answer.
+ */
+export declare function invertColorHEX(hex: string, bw?: boolean): string | undefined;
+/** As invertColorHEX, for rgb/rgba input. */
+export declare function invertColorRgb(rgb: string, bw?: boolean): string;
+/** Inverts whichever colour notation was given. */
+export declare function invertColor(color: string, bw?: boolean): string | undefined;
+/**
+ * Whether we can work out what text reads on this colour.
+ *
+ * Hex and rgb/rgba only. A CSS named colour like `orange`, or `hsl(...)`, is
+ * perfectly valid CSS — we simply cannot compute its brightness, and a
+ * background whose contrast we cannot compute is one we must not use.
+ */
+export declare function isSupportedColor(color: string | undefined): boolean;
+/**
+ * The text colour that will read on this background: black or white, never
+ * anything else.
+ *
+ * That guarantee is the whole point. An earlier version leaned on invertColor,
+ * whose rgb path returns its input unchanged when it cannot parse it — so
+ * `readableTextOn("orange")` answered `"orange"`, and a header themed from a
+ * scraped named colour got text in exactly the background colour. Invisible,
+ * and by the one function meant to prevent it.
+ *
+ * Unparseable input falls back to black. That is a guess, so callers who
+ * control the background should check `isSupportedColor` first and use a
+ * colour whose contrast can actually be computed, rather than pairing a
+ * guessed foreground with an unknown background.
+ */
+export declare function readableTextOn(background: string | undefined): string;

package/lib/color.js

@@ -0,0 +1,157 @@
+"use strict";
+/*! Copyright (c) 2026, XAPP AI */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRgb = parseRgb;
+exports.invertColorHEX = invertColorHEX;
+exports.invertColorRgb = invertColorRgb;
+exports.invertColor = invertColor;
+exports.isSupportedColor = isSupportedColor;
+exports.readableTextOn = readableTextOn;
+/**
+ * Colour maths for building a widget theme from a business's own branding.
+ *
+ * These lived in stentor-client, which meant the only way to work out a
+ * readable text colour was to be running in a browser. Studio needs the same
+ * answers when it builds an app server-side for a get.xapp.ai signup, and two
+ * implementations of "which colour reads on this background" would drift into
+ * two different-looking widgets.
+ *
+ * The inputs are colours scraped off a customer's website, so they are whatever
+ * their designer chose — any hex length, rgb or rgba, or nothing at all.
+ */
+/** Left-pads a hex component so "f" becomes "0f". */
+function padZero(value, length = 2) {
+    const zeros = new Array(length).join("0");
+    return (zeros + value).slice(-length);
+}
+function parseRgb(colorString) {
+    const rgba = /^rgba?\((\d+),\s*(\d+),\s*(\d+),\s*([\d.]+)\)$/;
+    const rgb = /^rgb?\((\d+),\s*(\d+),\s*(\d+)\)$/;
+    const withAlpha = colorString === null || colorString === void 0 ? void 0 : colorString.match(rgba);
+    if (withAlpha) {
+        return {
+            r: parseInt(withAlpha[1], 10),
+            g: parseInt(withAlpha[2], 10),
+            b: parseInt(withAlpha[3], 10),
+            a: parseFloat(withAlpha[4])
+        };
+    }
+    const plain = colorString === null || colorString === void 0 ? void 0 : colorString.match(rgb);
+    if (plain) {
+        return { r: parseInt(plain[1], 10), g: parseInt(plain[2], 10), b: parseInt(plain[3], 10) };
+    }
+    return null;
+}
+/**
+ * Whether text should be black or white to read on this background.
+ *
+ * The weighting is perceived brightness, not an average: the eye is far more
+ * sensitive to green than to blue, so a pure blue is dark to us even though its
+ * numeric average is mid-range.
+ *
+ * @see http://stackoverflow.com/a/3943023/112731
+ */
+function isLight(r, g, b) {
+    return r * 0.299 + g * 0.587 + b * 0.114 > 186;
+}
+/**
+ * Inverts a hex colour, or returns black/white for contrast when `bw` is set.
+ *
+ * Inverting is rarely what you want behind text — a mid-tone inverts to another
+ * mid-tone and neither reads. `bw` is the contrast answer.
+ */
+function invertColorHEX(hex, bw) {
+    if (!hex) {
+        return undefined;
+    }
+    let value = hex.indexOf("#") === 0 ? hex.slice(1) : hex;
+    if (value.length === 3) {
+        value = value[0] + value[0] + value[1] + value[1] + value[2] + value[2];
+    }
+    if (value.length !== 6) {
+        throw new Error("Invalid HEX color.");
+    }
+    const r = parseInt(value.slice(0, 2), 16);
+    const g = parseInt(value.slice(2, 4), 16);
+    const b = parseInt(value.slice(4, 6), 16);
+    if (bw) {
+        return isLight(r, g, b) ? "#000000" : "#FFFFFF";
+    }
+    return `#${padZero((255 - r).toString(16))}${padZero((255 - g).toString(16))}${padZero((255 - b).toString(16))}`;
+}
+/** As invertColorHEX, for rgb/rgba input. */
+function invertColorRgb(rgb, bw) {
+    const parsed = parseRgb(rgb);
+    if (!parsed) {
+        return rgb;
+    }
+    const { r, g, b } = parsed;
+    if (bw) {
+        return isLight(r, g, b) ? "rgba(0, 0, 0, 1)" : "rgba(255, 255, 255, 1)";
+    }
+    return `rgba(${255 - r}, ${255 - g}, ${255 - b}, 1)`;
+}
+/** Inverts whichever colour notation was given. */
+function invertColor(color, bw) {
+    if (!color) {
+        return undefined;
+    }
+    return color.startsWith("#") ? invertColorHEX(color, bw) : invertColorRgb(color, bw);
+}
+/**
+ * Whether we can work out what text reads on this colour.
+ *
+ * Hex and rgb/rgba only. A CSS named colour like `orange`, or `hsl(...)`, is
+ * perfectly valid CSS — we simply cannot compute its brightness, and a
+ * background whose contrast we cannot compute is one we must not use.
+ */
+function isSupportedColor(color) {
+    if (!color) {
+        return false;
+    }
+    if (color.startsWith("#")) {
+        const value = color.slice(1);
+        return (value.length === 3 || value.length === 6) && /^[0-9a-f]+$/i.test(value);
+    }
+    return parseRgb(color) !== null;
+}
+/**
+ * The text colour that will read on this background: black or white, never
+ * anything else.
+ *
+ * That guarantee is the whole point. An earlier version leaned on invertColor,
+ * whose rgb path returns its input unchanged when it cannot parse it — so
+ * `readableTextOn("orange")` answered `"orange"`, and a header themed from a
+ * scraped named colour got text in exactly the background colour. Invisible,
+ * and by the one function meant to prevent it.
+ *
+ * Unparseable input falls back to black. That is a guess, so callers who
+ * control the background should check `isSupportedColor` first and use a
+ * colour whose contrast can actually be computed, rather than pairing a
+ * guessed foreground with an unknown background.
+ */
+function readableTextOn(background) {
+    if (!isSupportedColor(background)) {
+        return "#000000";
+    }
+    const rgb = background.startsWith("#") ? hexToRgb(background) : parseRgb(background);
+    if (!rgb) {
+        return "#000000";
+    }
+    return isLight(rgb.r, rgb.g, rgb.b) ? "#000000" : "#FFFFFF";
+}
+function hexToRgb(hex) {
+    let value = hex.slice(1);
+    if (value.length === 3) {
+        value = value[0] + value[0] + value[1] + value[1] + value[2] + value[2];
+    }
+    if (value.length !== 6) {
+        return null;
+    }
+    return {
+        r: parseInt(value.slice(0, 2), 16),
+        g: parseInt(value.slice(2, 4), 16),
+        b: parseInt(value.slice(4, 6), 16)
+    };
+}
+//# sourceMappingURL=color.js.map

package/lib/color.js.map

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

package/lib/index.d.ts

@@ -1,6 +1,8 @@
 /*! Copyright (c) 2021, XAPPmedia */
 export * from "./ActionBar";
+export * from "./buildChatWidgetChannel";
 export * from "./ChannelData";
+export * from "./color";
 export * from "./Constants";
 export * from "./Types";
 export * from "./UserInfo";

package/lib/index.js

@@ -16,7 +16,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 /*! Copyright (c) 2021, XAPPmedia */
 __exportStar(require("./ActionBar"), exports);
+__exportStar(require("./buildChatWidgetChannel"), exports);
 __exportStar(require("./ChannelData"), exports);
+__exportStar(require("./color"), exports);
 __exportStar(require("./Constants"), exports);
 __exportStar(require("./Types"), exports);
 __exportStar(require("./UserInfo"), exports);

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,8CAA4B;AAC5B,gDAA8B;AAC9B,8CAA4B;AAC5B,0CAAwB;AACxB,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,8CAA4B;AAC5B,2DAAyC;AACzC,gDAA8B;AAC9B,0CAAwB;AACxB,8CAA4B;AAC5B,0CAAwB;AACxB,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,2CAAyB"}

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "1.95.2",
+    "version": "1.96.0",
     "description": "Chat Widget channel for stentor",
     "types": "lib/index",
     "main": "lib/index",
@@ -16,15 +16,18 @@
     },
     "devDependencies": {
         "@types/chai": "4.3.20",
+        "@types/jest": "27.5.2",
         "@types/react": "19.2.14",
         "@types/sinon": "10.0.20",
         "@types/sinon-chai": "3.2.12",
         "@xapp/config": "0.3.0",
         "chai": "4.5.0",
+        "jest": "29.7.0",
         "mocha": "9.2.2",
         "sinon": "13.0.2",
         "sinon-chai": "3.7.0",
         "stentor-models": "1.79.0",
+        "ts-jest": "29.4.12",
         "ts-node": "10.9.2",
         "typescript": "5.9.3"
     },
@@ -37,7 +40,8 @@
     },
     "scripts": {
         "build": "tsc -d true -p .",
-        "clean": "rm -rf ./lib/*"
+        "clean": "rm -rf ./lib/*",
+        "test": "jest"
     },
     "gitHead": "488151c23d71460d3a22522a4a3b99bcef1c1c85"
 }