Free, Open Source, Self-Hosted WhatsApp API Gateway
TypeScript apibotgatewayself-hostedwhatsappwhatsapp-apiwhatsapp-automationwhatsapp-botwhatsapp-gatewaywhatsapp-gateway-apiwhatsapp-webwhatsapp-web-api
import { test } from 'node:test';
import assert from 'node:assert/strict';
import { readFileSync, readdirSync } from 'node:fs';
import { fileURLToPath } from 'node:url';
import { dirname, join } from 'node:path';
import ts from 'typescript';
// The brand green (#25d366) and the amber warning fill are light colours: white on them is 1.98:1 and 2.15:1,
// far under the 4.5:1 AA needs, and the green as text on white is the same 1.98:1. Text and icons on those fills are
// dark (#0f172a, 9.0:1 on the green, as .btn-primary has it), and the brand green as text is --primary-text. The chat
// page's accent (#00a884, 3.03:1 against white either way) follows the same rule, with --chat-accent-text as its text.
const SRC = dirname(fileURLToPath(import.meta.url));
function filesUnder(dir: string, extensions: string[]): string[] {
return readdirSync(dir, { withFileTypes: true }).flatMap(entry => {
const full = join(dir, entry.name);
if (entry.isDirectory()) return filesUnder(full, extensions);
return extensions.some(ext => entry.name.endsWith(ext)) && !entry.name.endsWith('.test.ts') ? [full] : [];
});
}
interface Rule {
at: string;
selectors: string;
decl: Record<string, string>;
}
function rules(): Rule[] {
return filesUnder(SRC, ['.css']).flatMap(full => {
const css = readFileSync(full, 'utf8').replace(/\/\*[\s\S]*?\*\//g, comment => comment.replace(/[^\n]/g, ''));
return [...css.matchAll(/([^{}]+)\{([^{}]*)\}/g)].map(m => ({
at: `${full.slice(SRC.length + 1)}:${css.slice(0, m.index + m[1].length).split('\n').length}`,
selectors: m[1].trim().replace(/\s+/g, ' '),
decl: Object.fromEntries([...m[2].matchAll(/(?:^|;)\s*([\w-]+)\s*:\s*([^;]+)/g)].map(d => [d[1], d[2].trim()])),
}));
});
}
const WHITE = /^(?:#fff|#ffffff|white)$/i;
// Solid fills only: a translucent tint (rgba, color-mix) is a different pair and is checked by its own ratio.
const LIGHT_FILL =
/^(?:var\(--(?:primary|chat-accent)(?:-hover)?(?:,[^)]*)?\)|var\(--warning(?:,[^)]*)?\)|#25d366|#1da851|#16a34a|#f59e0b|#d97706|#00a884|#008f6f)$/i;
// A gradient is a light fill when one of its stops is: `linear-gradient(135deg, #5fd17b, var(--chat-accent))`.
function fillStops(r: Rule): string[] {
const fill = r.decl.background ?? r.decl['background-color'] ?? '';
const gradient = /^linear-gradient\((.*)\)$/.exec(fill);
return gradient ? (gradient[1].match(/(?:[^,(]|\([^)]*\))+/g) ?? []).map(stop => stop.trim().split(' ')[0]) : [fill];
}
// The colour a selector draws in: its own rule's, else the one of the rule it refines, so a state rule that only paints
// the fill (`.select-check.checked`) is paired with the white its base rule (`.select-check`) sets.
function colourOf(all: Rule[], selector: string): string {
let at = selector;
while (at && !/\s$/.test(at)) {
const colour = all.find(r => r.selectors.split(/,\s*/).includes(at) && r.decl.color)?.decl.color;
if (colour) return colour;
const base = at.replace(/(?:\.[\w-]+|:[\w-]+(?:\([^)]*\))?)$/, '');
if (base === at) break;
at = base;
}
return '';
}
test('no rule sets white text on the brand green or amber fill', () => {
const all = rules();
const offenders = all
.filter(r => fillStops(r).some(stop => LIGHT_FILL.test(stop)))
.filter(r => r.selectors.split(/,\s*/).some(selector => WHITE.test(colourOf(all, selector))))
.map(r => `${r.at}: ${r.selectors}`);
assert.deepEqual(offenders, []);
});
// The same pair written as an inline style object, e.g. { backgroundColor: 'var(--primary)', color: 'white' }: the
// stylesheet scan above cannot see it. Returns the line of every object literal that pairs them.
function inlineWhiteOnFill(source: string): number[] {
const file = ts.createSourceFile('inline.tsx', source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
const found: number[] = [];
const walk = (node: ts.Node): void => {
if (ts.isObjectLiteralExpression(node)) {
const values: Record<string, string> = {};
for (const p of node.properties) {
if (ts.isPropertyAssignment(p) && ts.isStringLiteralLike(p.initializer))
values[p.name.getText(file)] = p.initializer.text;
}
if (WHITE.test(values.color ?? '') && LIGHT_FILL.test(values.backgroundColor ?? values.background ?? ''))
found.push(file.getLineAndCharacterOfPosition(node.getStart(file)).line + 1);
}
ts.forEachChild(node, walk);
};
walk(file);
return found;
}
test('no inline style sets white text on the brand green or amber fill', () => {
const offenders = filesUnder(SRC, ['.tsx']).flatMap(full =>
inlineWhiteOnFill(readFileSync(full, 'utf8')).map(line => `${full.slice(SRC.length + 1)}:${line}`),
);
assert.deepEqual(offenders, []);
});
test('the inline scan sees white on a light fill and leaves dark text alone', () => {
assert.deepEqual(
inlineWhiteOnFill(`const a = <b style={{ backgroundColor: 'var(--primary)', color: 'white' }} />;`),
[1],
);
assert.deepEqual(inlineWhiteOnFill(`const a = { background: '#f59e0b', color: '#FFF' };`), [1]);
assert.deepEqual(inlineWhiteOnFill(`const a = { backgroundColor: 'var(--primary)', color: '#0f172a' };`), []);
assert.deepEqual(inlineWhiteOnFill(`const a = { backgroundColor: 'var(--error)', color: 'white' };`), []);
});
test('the brand green is never used as a text colour', () => {
const css = rules()
.filter(r => /^(?:var\(--(?:primary|chat-accent)(?:,[^)]*)?\)|#25d366|#00a884)$/i.test(r.decl.color ?? ''))
.map(r => `${r.at}: ${r.selectors}`);
const inline = filesUnder(SRC, ['.tsx']).flatMap(full =>
readFileSync(full, 'utf8')
.split('\n')
.map((line, i) => ({ line, at: `${full.slice(SRC.length + 1)}:${i + 1}` }))
.filter(({ line }) =>
/(?<![\w-])color:\s*['"](?:var\(--(?:primary|chat-accent)\)|#25d366|#00a884)['"]/.test(line),
)
.map(({ at }) => at),
);
assert.deepEqual([...css, ...inline], []);
});