wacrawl-dashboard 0.1.1 → 0.2.0

package/apps/api/dist/demo/demoArchive.js

@@ -0,0 +1,371 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import Database from 'better-sqlite3';
+import { ARCHIVE_SCHEMA_SQL } from '../lib/archiveSchema.js';
+import { createSearchIndexes } from '../lib/searchIndex.js';
+import { CAPTIONS, DIRECT_PERSONAS, EMOJIS_MINE, EMOJIS_THEIRS, EXTRA_CONTACTS, GROUP_PERSONAS, LINK_INTROS, LINK_TEMPLATES, MY_TEMPLATES, SILENT_GROUP, THEIR_TEMPLATES, TOPICS, } from './demoCast.js';
+import { demoMediaPath, writeDemoMedia } from './demoMedia.js';
+export const DEFAULT_DEMO_SEED = 1815;
+const DAY_SECONDS = 86_400;
+const MONTH_SECONDS = 30 * DAY_SECONDS;
+const SELF_JID = '15550000000@s.whatsapp.net';
+/** Messaging by hour of day: quiet nights, a lunch bump, a long evening. */
+const HOUR_WEIGHTS = [2, 1, 1, 0, 0, 0, 1, 3, 6, 7, 7, 7, 9, 8, 6, 6, 6, 7, 9, 12, 14, 14, 10, 5];
+const NIGHT_OWL_WEIGHTS = HOUR_WEIGHTS.map((weight, hour) => (hour < 5 ? weight + 8 : weight));
+const WEEKDAY_FACTOR = [1.15, 0.85, 0.9, 0.95, 1, 1.1, 1.35];
+const MEDIA_MIX = [
+    // type, weight, smallest bytes, largest bytes
+    ['image', 55, 80_000, 2_400_000],
+    ['audio', 20, 40_000, 900_000],
+    ['video', 10, 2_000_000, 40_000_000],
+    ['sticker', 10, 12_000, 60_000],
+    ['document', 5, 50_000, 6_000_000],
+];
+const RAW_TYPES = { image: 1, video: 2, audio: 3, document: 8, sticker: 15 };
+/** Small, seedable and the same on every platform, unlike Math.random. */
+function mulberry32(seed) {
+    let state = seed >>> 0;
+    return () => {
+        state = (state + 0x6d2b79f5) >>> 0;
+        let t = state;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4_294_967_296;
+    };
+}
+function pick(rng, items) {
+    return items[Math.floor(rng() * items.length)];
+}
+function weightedIndex(rng, weights) {
+    const total = weights.reduce((sum, weight) => sum + weight, 0);
+    let roll = rng() * total;
+    for (let i = 0; i < weights.length; i += 1) {
+        roll -= weights[i];
+        if (roll < 0)
+            return i;
+    }
+    return weights.length - 1;
+}
+/** Knuth's method; the rates here are all small. */
+function poisson(rng, rate) {
+    const limit = Math.exp(-rate);
+    let count = 0;
+    let product = rng();
+    while (product > limit) {
+        count += 1;
+        product *= rng();
+    }
+    return count;
+}
+/** Reply gaps are long-tailed: mostly near the median, occasionally hours later. */
+function replyGapSeconds(rng, medianMinutes) {
+    const gaussian = Math.sqrt(-2 * Math.log(1 - rng())) * Math.cos(2 * Math.PI * rng());
+    const lateFactor = rng() < 0.06 ? 12 : 1;
+    return Math.max(5, Math.round(medianMinutes * 60 * Math.exp(0.9 * gaussian) * lateFactor));
+}
+function activityFactor(shape, monthsAgo, startMonthsAgo, stoppedMonthsAgo = 0) {
+    const age = 1 - monthsAgo / startMonthsAgo;
+    switch (shape) {
+        case 'steady': return 1;
+        case 'growing': return 0.25 + 1.25 * age;
+        case 'fading': return Math.max(0.08, 1.4 - 1.35 * age);
+        case 'arc': return 0.15 + Math.sin(Math.PI * age);
+        case 'stopped': return monthsAgo < stoppedMonthsAgo ? 0 : 1;
+    }
+}
+function phoneJid(index) {
+    return `1555000${String(1000 + index)}@s.whatsapp.net`;
+}
+function buildPeople() {
+    const people = new Map();
+    let index = 1;
+    for (const persona of DIRECT_PERSONAS) {
+        people.set(persona.name, {
+            name: persona.name,
+            jid: phoneJid(index),
+            lid: persona.hasLid ? `9000000000${String(index).padStart(3, '0')}@lid` : null,
+        });
+        index += 1;
+    }
+    for (const name of EXTRA_CONTACTS) {
+        people.set(name, { name, jid: phoneJid(index), lid: null });
+        index += 1;
+    }
+    return people;
+}
+function composeText(rng, plan, fromMe) {
+    const words = TOPICS[pick(rng, plan.topics)];
+    const template = pick(rng, fromMe ? MY_TEMPLATES : THEIR_TEMPLATES);
+    const text = template.replaceAll('{a}', pick(rng, words)).replaceAll('{b}', pick(rng, words));
+    if (rng() < 0.16)
+        return `${text} ${pick(rng, fromMe ? EMOJIS_MINE : EMOJIS_THEIRS)}`;
+    return text;
+}
+function composeLink(rng) {
+    const id = Math.floor(rng() * 1_000_000_000).toString(36);
+    return `${pick(rng, LINK_INTROS)} ${pick(rng, LINK_TEMPLATES).replace('{id}', id)}`;
+}
+function planChats(people) {
+    const person = (name) => people.get(name);
+    const direct = DIRECT_PERSONAS.map((persona) => ({
+        jid: person(persona.name).jid,
+        kind: 'dm',
+        name: persona.name,
+        archived: Boolean(persona.archived),
+        sessions: persona.sessions,
+        shape: persona.shape,
+        startMonthsAgo: persona.startMonthsAgo,
+        stoppedMonthsAgo: persona.stoppedMonthsAgo,
+        turns: persona.turns,
+        topics: persona.topics,
+        hourWeights: persona.nightOwl ? NIGHT_OWL_WEIGHTS : HOUR_WEIGHTS,
+        mine: persona.initiates,
+        others: [person(persona.name)],
+        otherWeights: [1],
+        theirReply: persona.reply,
+        myReply: persona.myReply,
+        ghost: persona.ghost ?? 0,
+    }));
+    // Everybody draws from one fixed ordering, shifted per group, so that the same
+    // few people turn up across groups the way friends do.
+    const everyone = [...people.values()];
+    const groups = GROUP_PERSONAS.map((persona, index) => {
+        const offset = (index * 7) % everyone.length;
+        const roster = Array.from({ length: persona.members }, (_, i) => everyone[(offset + i) % everyone.length]);
+        return {
+            jid: groupJid(index),
+            kind: 'group',
+            name: persona.name,
+            archived: Boolean(persona.archived),
+            sessions: persona.sessions,
+            shape: persona.shape,
+            startMonthsAgo: persona.startMonthsAgo,
+            stoppedMonthsAgo: persona.stoppedMonthsAgo,
+            turns: persona.turns,
+            topics: persona.topics,
+            hourWeights: HOUR_WEIGHTS,
+            mine: persona.myShare,
+            others: roster.slice(0, persona.speakers),
+            // Roughly Zipfian: in most groups a handful of people do the talking.
+            otherWeights: roster.slice(0, persona.speakers).map((_, i) => 1 / (i + 1)),
+            theirReply: 8,
+            myReply: 12,
+            ghost: 0,
+        };
+    });
+    return [...direct, ...groups];
+}
+function groupJid(index) {
+    return `120363000000${String(100 + index)}@g.us`;
+}
+/** Pick the sender. In a direct chat turns alternate; a group just has a next speaker. */
+function nextMine(rng, plan, previousMine) {
+    if (plan.kind === 'dm')
+        return rng() < 0.28 ? previousMine : !previousMine;
+    return rng() < plan.mine;
+}
+function planMessage(rng, plan, ts, fromMe, text) {
+    const speaker = fromMe ? null : plan.others[weightedIndex(rng, plan.otherWeights)];
+    // Real archives record a person by `@lid` in some group messages and leave the
+    // name for the contacts join to fill in; both spellings have to merge.
+    const useLid = plan.kind === 'group' && speaker?.lid != null && rng() < 0.35;
+    const message = {
+        chatJid: plan.jid,
+        chatName: plan.name,
+        // My own JID is never written down: a group records the group, a direct chat nothing.
+        senderJid: speaker ? (useLid ? speaker.lid : speaker.jid) : plan.kind === 'group' ? plan.jid : null,
+        senderName: speaker && !useLid ? speaker.name : null,
+        ts,
+        fromMe,
+        text: text ?? null,
+        mediaType: null,
+        mediaPath: null,
+        mediaSize: null,
+    };
+    if (text !== undefined)
+        return message;
+    const roll = rng();
+    if (roll < 0.08) {
+        const [type, , smallest, largest] = MEDIA_MIX[weightedIndex(rng, MEDIA_MIX.map((entry) => entry[1]))];
+        message.mediaType = type;
+        message.mediaPath = demoMediaPath(type, rng);
+        message.mediaSize = Math.round(smallest + rng() * (largest - smallest));
+        if (type === 'image' && rng() < 0.3)
+            message.text = pick(rng, CAPTIONS);
+    }
+    else if (roll < 0.11) {
+        message.text = composeLink(rng);
+    }
+    else {
+        message.text = composeText(rng, plan, fromMe);
+    }
+    return message;
+}
+function planSession(rng, plan, startTs, nowTs, out) {
+    let fromMe = rng() < plan.mine;
+    if (fromMe && rng() < plan.ghost) {
+        out.push(planMessage(rng, plan, startTs, true));
+        return;
+    }
+    const turns = 1 + Math.floor(-Math.log(1 - rng()) * (plan.turns - 1));
+    let ts = startTs;
+    for (let turn = 0; turn < turns && ts <= nowTs; turn += 1) {
+        out.push(planMessage(rng, plan, ts, fromMe));
+        const nextIsMine = nextMine(rng, plan, fromMe);
+        ts += nextIsMine === fromMe
+            ? Math.round(8 + rng() * 150)
+            : replyGapSeconds(rng, nextIsMine ? plan.myReply : plan.theirReply);
+        fromMe = nextIsMine;
+    }
+}
+function planHistory(rng, plans, nowTs) {
+    const out = [];
+    const today = Math.floor(nowTs / DAY_SECONDS) * DAY_SECONDS;
+    const longestHistory = Math.max(...plans.map((plan) => plan.startMonthsAgo));
+    for (const plan of plans) {
+        const startDay = today - Math.round(plan.startMonthsAgo * 30) * DAY_SECONDS;
+        for (let day = startDay; day <= today; day += DAY_SECONDS) {
+            const monthsAgo = (today - day) / MONTH_SECONDS;
+            const date = new Date(day * 1000);
+            // Everyone gets busier year on year, and December is December.
+            const trend = 0.7 + 0.5 * (1 - monthsAgo / longestHistory);
+            const season = date.getUTCMonth() === 11 ? 1.5 : date.getUTCMonth() === 7 ? 0.75 : 1;
+            const rate = (plan.sessions / 30)
+                * activityFactor(plan.shape, monthsAgo, plan.startMonthsAgo, plan.stoppedMonthsAgo)
+                * WEEKDAY_FACTOR[date.getUTCDay()]
+                * trend
+                * season;
+            for (let session = poisson(rng, rate); session > 0; session -= 1) {
+                const hour = weightedIndex(rng, plan.hourWeights);
+                const startTs = day + hour * 3600 + Math.floor(rng() * 3600);
+                if (startTs <= nowTs)
+                    planSession(rng, plan, startTs, nowTs, out);
+            }
+        }
+    }
+    return out;
+}
+/**
+ * The fixed points the smoke tests and the current-streak card rely on. Random
+ * history cannot promise that a term exists, or that today has any messages.
+ */
+function planMilestones(rng, plans, nowTs) {
+    const planFor = (name) => plans.find((plan) => plan.name === name);
+    const ada = planFor('Ada Lovelace');
+    const family = planFor('Family Dinner Planning');
+    const bookClub = planFor('Book Club');
+    const grace = planFor('Grace Hopper');
+    const daysAgo = (days, hour = 19) => Math.floor(nowTs / DAY_SECONDS) * DAY_SECONDS - days * DAY_SECONDS + hour * 3600;
+    const out = [
+        planMessage(rng, ada, daysAgo(12), true, 'The lighthouse trip is booked for the long weekend'),
+        planMessage(rng, ada, daysAgo(12) + 240, false, 'Perfect, I will bring the old lighthouse logbook'),
+        planMessage(rng, bookClub, daysAgo(30), false, 'Next month we read To the Lighthouse, paperback copies at the library'),
+        // A message in the last few hours keeps Day and the current streak populated.
+        planMessage(rng, ada, nowTs - 2 * 3600, false, 'Are we still on for tonight?'),
+        planMessage(rng, ada, nowTs - 2 * 3600 + 120, true, 'Definitely, see you at seven'),
+        planMessage(rng, family, nowTs - 5 * 3600, false, 'Who is bringing dessert on Sunday?'),
+        planMessage(rng, grace, nowTs - 9 * 3600, false, 'The deploy went out, thanks for the review'),
+    ];
+    for (let day = 1; day <= 60; day += 1) {
+        const hour = 8 + Math.floor(rng() * 14);
+        out.push(planMessage(rng, ada, daysAgo(day, hour), rng() < 0.5, 'Morning! How did it go?'));
+    }
+    return out;
+}
+function insertPeople(db, people) {
+    const insertContact = db.prepare(`
+    INSERT INTO contacts (jid, phone, full_name, first_name, last_name, business_name, lid)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `);
+    for (const { jid, lid, name } of people.values()) {
+        const [first, ...rest] = name.split(' ');
+        insertContact.run(jid, jid.split('@')[0], name, first, rest.join(' ') || null, null, lid);
+    }
+    // The other shapes an address book holds: a business, and a bare number.
+    insertContact.run('15550001900@s.whatsapp.net', '15550001900', null, null, null, 'Analytical Engine Repairs', null);
+    insertContact.run('15550001901@s.whatsapp.net', '15550001901', null, null, null, null, null);
+}
+function insertGroups(db, people, nowTs) {
+    const insertGroup = db.prepare('INSERT INTO groups (jid, name, owner_jid, created_at) VALUES (?, ?, ?, ?)');
+    const insertMember = db.prepare(`
+    INSERT INTO group_participants (group_jid, user_jid, contact_name, first_name, is_admin, is_active)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `);
+    const everyone = [...people.values()];
+    const seedRoster = (jid, members) => {
+        // I am on every roster, and on no other record: see lib/selfIdentity.ts.
+        insertMember.run(jid, SELF_JID, null, null, 0, 1);
+        members.forEach((member, i) => {
+            const user = member.lid && i % 2 === 1 ? member.lid : member.jid;
+            insertMember.run(jid, user, member.name, member.name.split(' ')[0], i === 0 ? 1 : 0, 1);
+        });
+    };
+    GROUP_PERSONAS.forEach((persona, index) => {
+        const offset = (index * 7) % everyone.length;
+        const roster = Array.from({ length: persona.members }, (_, i) => everyone[(offset + i) % everyone.length]);
+        const founded = nowTs - Math.round(persona.foundedYearsAgo * 365.25) * DAY_SECONDS;
+        insertGroup.run(groupJid(index), persona.name, roster[0].jid, founded);
+        seedRoster(groupJid(index), roster);
+    });
+    const silentJid = groupJid(GROUP_PERSONAS.length);
+    const silentRoster = everyone.slice(0, SILENT_GROUP.members);
+    insertGroup.run(silentJid, SILENT_GROUP.name, silentRoster[0].jid, nowTs - SILENT_GROUP.foundedYearsAgo * 365 * DAY_SECONDS);
+    seedRoster(silentJid, silentRoster);
+}
+export function generateDemoArchive(options) {
+    const nowTs = Math.floor((options.now ?? new Date()).getTime() / 1000);
+    const rng = mulberry32(options.seed ?? DEFAULT_DEMO_SEED);
+    const dbPath = path.join(options.dir, 'wacrawl-demo.db');
+    const mediaRoot = path.join(options.dir, 'media');
+    fs.mkdirSync(options.dir, { recursive: true });
+    writeDemoMedia(mediaRoot, rng);
+    const people = buildPeople();
+    const plans = planChats(people);
+    const messages = [...planHistory(rng, plans, nowTs), ...planMilestones(rng, plans, nowTs)]
+        .filter((message) => message.ts <= nowTs)
+        .sort((a, b) => a.ts - b.ts);
+    const db = new Database(dbPath);
+    try {
+        db.pragma('synchronous = OFF');
+        db.exec(ARCHIVE_SCHEMA_SQL);
+        db.exec(`
+      ALTER TABLE chats ADD COLUMN archived INTEGER NOT NULL DEFAULT 0;
+      CREATE TABLE sync_state (key TEXT PRIMARY KEY, value TEXT);
+    `);
+        db.transaction(() => {
+            insertPeople(db, people);
+            insertGroups(db, people, nowTs);
+            const insertMessage = db.prepare(`
+        INSERT INTO messages (
+          source_pk, chat_jid, chat_name, msg_id, sender_jid, sender_name, ts,
+          from_me, text, raw_type, message_type, media_type, media_path, media_size
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `);
+            const lastByChat = new Map();
+            messages.forEach((message, index) => {
+                insertMessage.run(index + 1, message.chatJid, message.chatName, `DEMO${(index + 1).toString(16).padStart(12, '0').toUpperCase()}`, message.senderJid, message.senderName, message.ts, message.fromMe ? 1 : 0, message.text, message.mediaType ? RAW_TYPES[message.mediaType] : 0, message.mediaType ?? 'text', message.mediaType, message.mediaPath, message.mediaSize);
+                lastByChat.set(message.chatJid, message.ts);
+            });
+            const insertChat = db.prepare('INSERT INTO chats (jid, kind, name, last_message_at, archived) VALUES (?, ?, ?, ?, ?)');
+            for (const plan of plans) {
+                insertChat.run(plan.jid, plan.kind, plan.name, lastByChat.get(plan.jid) ?? null, plan.archived ? 1 : 0);
+            }
+            insertChat.run(groupJid(GROUP_PERSONAS.length), 'group', SILENT_GROUP.name, null, 0);
+            const insertState = db.prepare('INSERT INTO sync_state (key, value) VALUES (?, ?)');
+            insertState.run('last_import_at', new Date((nowTs - 3 * 3600) * 1000).toISOString());
+            insertState.run('source_path', 'demo');
+        })();
+        createSearchIndexes(db);
+        return {
+            dbPath,
+            mediaRoot,
+            messages: messages.length,
+            chats: plans.length + 1,
+            contacts: db.prepare('SELECT COUNT(*) AS count FROM contacts').get().count,
+        };
+    }
+    finally {
+        db.close();
+    }
+}

package/apps/api/dist/demo/demoCast.js

@@ -0,0 +1,138 @@
+/**
+ * Who is in the demo archive and how they behave. All of it is invented.
+ *
+ * The names are long-dead scientists on purpose: nobody can mistake them for
+ * somebody's real contacts. Phone numbers sit in the reserved 555-0xxx range and
+ * LIDs in a made-up 900… block. Do not "improve" this with real data, ever.
+ */
+export const SELF_NAME = 'Charles Babbage';
+export const TOPICS = {
+    climbing: ['crag', 'belay', 'harness', 'chalk', 'overhang', 'bouldering'],
+    books: ['novel', 'chapter', 'library', 'paperback', 'author', 'bookmark'],
+    cooking: ['sourdough', 'risotto', 'paprika', 'oven', 'recipe', 'lentils'],
+    code: ['compiler', 'deploy', 'refactor', 'debugger', 'kernel', 'pipeline'],
+    maths: ['theorem', 'proof', 'algebra', 'calculus', 'matrix', 'integral'],
+    space: ['orbit', 'telescope', 'comet', 'rocket', 'eclipse', 'satellite'],
+    travel: ['airport', 'itinerary', 'passport', 'ferry', 'hostel', 'luggage'],
+    family: ['grandma', 'birthday', 'cousins', 'picnic', 'dinner', 'photos'],
+    garden: ['tomatoes', 'compost', 'seedlings', 'greenhouse', 'roses', 'allotment'],
+    football: ['match', 'referee', 'penalty', 'stadium', 'midfielder', 'kickoff'],
+    music: ['concert', 'playlist', 'cello', 'rehearsal', 'vinyl', 'soundcheck'],
+    work: ['meeting', 'deadline', 'roadmap', 'standup', 'invoice', 'quarterly'],
+    health: ['marathon', 'physio', 'yoga', 'sleep', 'running', 'stretching'],
+    home: ['plumber', 'landlord', 'paint', 'neighbours', 'boiler', 'skylight'],
+};
+export const DIRECT_PERSONAS = [
+    { name: 'Ada Lovelace', sessions: 18, shape: 'steady', startMonthsAgo: 44, turns: 8, initiates: 0.55, reply: 6, myReply: 9, topics: ['maths', 'music', 'code'], hasLid: true },
+    { name: 'Grace Hopper', sessions: 14, shape: 'steady', startMonthsAgo: 44, turns: 8, initiates: 0.4, reply: 15, myReply: 8, topics: ['code', 'work'], hasLid: true },
+    { name: 'Katherine Johnson', sessions: 16, shape: 'growing', startMonthsAgo: 30, turns: 7, initiates: 0.35, reply: 12, myReply: 25, topics: ['space', 'maths'] },
+    { name: 'Marie Curie', sessions: 12, shape: 'steady', startMonthsAgo: 44, turns: 6, initiates: 0.7, reply: 95, myReply: 12, topics: ['garden', 'family'], ghost: 0.25 },
+    { name: 'Alan Turing', sessions: 14, shape: 'fading', startMonthsAgo: 44, turns: 7, initiates: 0.6, reply: 35, myReply: 20, topics: ['maths', 'health', 'code'], nightOwl: true },
+    { name: 'Rosalind Franklin', sessions: 10, shape: 'stopped', startMonthsAgo: 40, stoppedMonthsAgo: 6, turns: 6, initiates: 0.5, reply: 40, myReply: 30, topics: ['travel', 'books'], archived: true },
+    { name: 'Nikola Tesla', sessions: 14, shape: 'steady', startMonthsAgo: 38, turns: 5, initiates: 0.2, reply: 4, myReply: 180, topics: ['space', 'home'], nightOwl: true, hasLid: true },
+    { name: 'Emmy Noether', sessions: 9, shape: 'growing', startMonthsAgo: 14, turns: 8, initiates: 0.45, reply: 20, myReply: 15, topics: ['maths', 'books'] },
+    { name: 'Hedy Lamarr', sessions: 7, shape: 'steady', startMonthsAgo: 42, turns: 5, initiates: 0.5, reply: 60, myReply: 45, topics: ['music', 'travel'], archived: true },
+    { name: 'Charles Darwin', sessions: 8, shape: 'fading', startMonthsAgo: 44, turns: 5, initiates: 0.75, reply: 400, myReply: 30, topics: ['garden', 'travel'], ghost: 0.45 },
+    { name: 'Johannes Kepler', sessions: 6, shape: 'stopped', startMonthsAgo: 36, stoppedMonthsAgo: 9, turns: 5, initiates: 0.5, reply: 50, myReply: 40, topics: ['space'] },
+    { name: 'Mary Somerville', sessions: 6, shape: 'steady', startMonthsAgo: 28, turns: 4, initiates: 0.3, reply: 25, myReply: 70, topics: ['books', 'space'] },
+    { name: 'Michael Faraday', sessions: 5, shape: 'arc', startMonthsAgo: 34, turns: 5, initiates: 0.5, reply: 30, myReply: 30, topics: ['home', 'work'] },
+    { name: 'Caroline Herschel', sessions: 5, shape: 'steady', startMonthsAgo: 8, turns: 5, initiates: 0.4, reply: 18, myReply: 22, topics: ['space', 'cooking'] },
+    { name: 'Louis Pasteur', sessions: 4, shape: 'fading', startMonthsAgo: 40, turns: 4, initiates: 0.8, reply: 900, myReply: 50, topics: ['cooking', 'health'], ghost: 0.6 },
+    { name: 'Sofia Kovalevskaya', sessions: 6, shape: 'steady', startMonthsAgo: 5, turns: 6, initiates: 0.5, reply: 14, myReply: 16, topics: ['maths', 'travel'] },
+    { name: 'Blaise Pascal', sessions: 3, shape: 'stopped', startMonthsAgo: 30, stoppedMonthsAgo: 5, turns: 4, initiates: 0.6, reply: 90, myReply: 60, topics: ['maths', 'football'] },
+    { name: 'Lise Meitner', sessions: 4, shape: 'steady', startMonthsAgo: 3, turns: 5, initiates: 0.6, reply: 22, myReply: 26, topics: ['travel', 'music'] },
+    { name: 'Florence Nightingale', sessions: 4, shape: 'steady', startMonthsAgo: 24, turns: 4, initiates: 0.25, reply: 35, myReply: 110, topics: ['health', 'family'] },
+    { name: 'Isaac Newton', sessions: 3, shape: 'steady', startMonthsAgo: 44, turns: 3, initiates: 0.85, reply: 1500, myReply: 60, topics: ['maths', 'garden'], ghost: 0.7, archived: true },
+    { name: 'Joan Clarke', sessions: 3, shape: 'growing', startMonthsAgo: 12, turns: 5, initiates: 0.5, reply: 28, myReply: 28, topics: ['books', 'code'], nightOwl: true },
+    { name: 'Dorothy Vaughan', sessions: 3, shape: 'steady', startMonthsAgo: 18, turns: 4, initiates: 0.4, reply: 40, myReply: 35, topics: ['work', 'cooking'] },
+];
+/** In group rosters and the address book, with no direct chat of their own. */
+export const EXTRA_CONTACTS = [
+    'Annie Easley', 'Leonhard Euler', 'Carl Gauss', 'Srinivasa Ramanujan', 'Galileo Galilei',
+    'Mary Anning', 'Gregor Mendel', 'Dmitri Mendeleev', 'Maria Agnesi', 'Antoine Lavoisier',
+    'Tycho Brahe', 'Robert Hooke', 'James Maxwell', 'Barbara McClintock', 'Henrietta Leavitt',
+    'Chien-Shiung Wu', 'Niels Bohr', 'Paul Dirac', 'Pierre Fermat', 'Sophie Germain',
+];
+export const GROUP_PERSONAS = [
+    { name: 'Family Dinner Planning', sessions: 16, shape: 'steady', startMonthsAgo: 44, turns: 9, myShare: 0.3, members: 7, speakers: 6, topics: ['family', 'cooking'], foundedYearsAgo: 7 },
+    { name: 'Climbing Crew', sessions: 12, shape: 'growing', startMonthsAgo: 36, turns: 9, myShare: 0.2, members: 14, speakers: 9, topics: ['climbing', 'travel', 'health'], foundedYearsAgo: 3 },
+    { name: 'Book Club', sessions: 8, shape: 'steady', startMonthsAgo: 44, turns: 8, myShare: 0.18, members: 11, speakers: 7, topics: ['books'], foundedYearsAgo: 5 },
+    { name: 'Neighbourhood Watch', sessions: 10, shape: 'steady', startMonthsAgo: 40, turns: 7, myShare: 0.03, members: 34, speakers: 9, topics: ['home', 'garden'], foundedYearsAgo: 4 },
+    { name: 'Friday Football', sessions: 9, shape: 'steady', startMonthsAgo: 34, turns: 8, myShare: 0.12, members: 18, speakers: 12, topics: ['football'], foundedYearsAgo: 3 },
+    { name: 'Office Coffee Run', sessions: 16, shape: 'steady', startMonthsAgo: 26, turns: 5, myShare: 0.25, members: 9, speakers: 8, topics: ['work', 'cooking'], foundedYearsAgo: 2, archived: true },
+    { name: 'Allotment Society', sessions: 6, shape: 'steady', startMonthsAgo: 32, turns: 5, myShare: 0.08, members: 21, speakers: 6, topics: ['garden'], foundedYearsAgo: 6, archived: true },
+    { name: 'Difference Engine Alumni', sessions: 10, shape: 'fading', startMonthsAgo: 44, turns: 6, myShare: 0.15, members: 25, speakers: 10, topics: ['code', 'work'], foundedYearsAgo: 8 },
+    { name: 'Eclipse Road Trip', sessions: 18, shape: 'stopped', startMonthsAgo: 26, stoppedMonthsAgo: 13, turns: 10, myShare: 0.28, members: 6, speakers: 6, topics: ['travel', 'space'], foundedYearsAgo: 2 },
+    { name: 'Wedding Planning', sessions: 14, shape: 'stopped', startMonthsAgo: 34, stoppedMonthsAgo: 20, turns: 9, myShare: 0.25, members: 8, speakers: 7, topics: ['family', 'music'], foundedYearsAgo: 3 },
+    { name: 'Startup Ideas', sessions: 12, shape: 'stopped', startMonthsAgo: 42, stoppedMonthsAgo: 24, turns: 8, myShare: 0.35, members: 5, speakers: 5, topics: ['code', 'work'], foundedYearsAgo: 4 },
+    { name: 'Old Flatmates', sessions: 5, shape: 'stopped', startMonthsAgo: 44, stoppedMonthsAgo: 8, turns: 5, myShare: 0.25, members: 4, speakers: 4, topics: ['home', 'music'], foundedYearsAgo: 8 },
+    { name: 'Concert Tickets', sessions: 8, shape: 'stopped', startMonthsAgo: 18, stoppedMonthsAgo: 11, turns: 6, myShare: 0.2, members: 10, speakers: 6, topics: ['music'], foundedYearsAgo: 1, archived: true },
+];
+/** On the roster with nothing ever posted, which the graveyard reports separately. */
+export const SILENT_GROUP = { name: 'School Reunion', members: 12, foundedYearsAgo: 2 };
+/** Words only I lean on, so the Distinctive Words card has something to find. */
+export const MY_TEMPLATES = [
+    'honestly the {a} sounds great',
+    'basically done with the {a}, will send it over',
+    'definitely up for the {a} tomorrow',
+    'honestly not sure about the {a} yet',
+    'let me check the {a} and get back to you',
+    'running late, the {a} took forever',
+    'basically the {a} is sorted, what about the {b}?',
+    'can you remind me about the {a} tomorrow?',
+    'I reckon the {a} needs another look',
+    'definitely agree on the {a}',
+    'on my way, bringing the {a}',
+    'sorry, just saw this. {a} works for me',
+    'sounds good',
+    'tomorrow works',
+    'on my way',
+    'will do, thanks',
+];
+export const THEIR_TEMPLATES = [
+    'hey charles, did you see the {a}?',
+    'thanks charles! the {a} was brilliant',
+    'any news on the {a}?',
+    'the {a} was amazing yesterday',
+    'what do you think about the {a} and the {b}?',
+    'charles are you coming to the {a} this weekend?',
+    'just finished the {a}, wow',
+    'can we talk about the {a} later?',
+    'lovely, the {b} turned out really well',
+    'wonderful news about the {a}',
+    'so the {a} got moved to next week',
+    'haha that {a} story is great',
+    'thanks!',
+    'lovely',
+    'see you soon',
+    'wonderful',
+];
+export const EMOJIS_MINE = ['😂', '🙏', '👍', '😅', '🤔'];
+export const EMOJIS_THEIRS = ['😂', '❤️', '🔥', '🎉', '😊', '🙌', '😍', '👏', '🥳', '😮'];
+export const CAPTIONS = ['look at this', 'from today', 'the view from here', 'this one is for you', 'finally got a decent shot'];
+/** Every category in the link report gets at least one domain. */
+export const LINK_TEMPLATES = [
+    'https://www.youtube.com/watch?v={id}',
+    'https://www.youtube.com/watch?v={id}',
+    'https://vimeo.com/{id}',
+    'https://www.reddit.com/r/space/comments/{id}',
+    'https://x.com/example/status/{id}',
+    'https://www.linkedin.com/posts/example-{id}',
+    'https://www.nytimes.com/2026/example-{id}.html',
+    'https://www.bbc.com/news/example-{id}',
+    'https://www.theguardian.com/science/example-{id}',
+    'https://www.amazon.com/dp/{id}',
+    'https://www.etsy.com/listing/{id}',
+    'https://open.spotify.com/track/{id}',
+    'https://open.spotify.com/track/{id}',
+    'https://bandcamp.com/track/{id}',
+    'https://github.com/example/{id}',
+    'https://github.com/example/{id}',
+    'https://stackoverflow.com/questions/{id}',
+    'https://en.wikipedia.org/wiki/Analytical_Engine',
+    'https://en.wikipedia.org/wiki/Comet',
+    'https://docs.google.com/document/d/{id}',
+    'https://example.com/notes/{id}',
+    'https://example.org/events/{id}',
+];
+export const LINK_INTROS = ['check this out', 'you will like this', 'this reminded me of you', 'read this', 'worth a look', 'saved this for you'];

package/apps/api/dist/demo/demoMedia.js

@@ -0,0 +1,108 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const IMAGE_COUNT = 24;
+const STICKER_COUNT = 6;
+const DOCUMENT_COUNT = 3;
+/**
+ * One second of a solid colour, VP8, small enough to live in the source:
+ * ffmpeg -f lavfi -i "color=c=0x0ea5a4:s=64x64:d=1:r=4" -map_metadata -1 -fflags +bitexact
+ *   -pix_fmt yuv420p -c:v libvpx -b:v 8k -g 4 -auto-alt-ref 0 -an -f webm clip.webm
+ * WebM rather than MP4 because stock Chromium, which runs the smoke tests, has no H.264.
+ */
+const CLIP_WEBM_BASE64 = 'GkXfo59ChoEBQveBAULygQRC84EIQoKEd2VibUKHgQJChYECGFOAZwEAAAAAAAIjEU2bdLpNu4tTq4QVSalmU6yBoU27i1OrhBZU'
+    + 'rmtTrIHGTbuMU6uEElTDZ1OsggEiTbuMU6uEHFO7a1OsggIN7AEAAAAAAABZAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'
+    + 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAVSalmoCrXsYMPQkBNgIRM'
+    + 'YXZmV0GETGF2ZkSJiECPQAAAAAAAFlSua9euAQAAAAAAAE7XgQFzxYgAAAAAAAAAAZyBACK1nIN1bmSIgQCGhVZfVlA4g4EBI+OD'
+    + 'hA7msoDgkLCBQLqBQJqBAlWwhFW5gQFV7oEA7AEAAAAAAAACAAASVMNn0HNzzWPAi2PFiAAAAAAAAAABZ8iYRaOHRU5DT0RFUkSH'
+    + 'i0xhdmMgbGlidnB4Z8ihRaOIRFVSQVRJT05Eh5MwMDowMDowMS4wMDAwMDAwMDAAH0O2dUCQ54EAo8OBAACAkAMAnQEqQABAAABH'
+    + 'CIWFiIWEiAICAnWqA/gCBuhKMBVkQe7MTgD+7L2P/UGfIM+QZ+ql//A/f4H7/A/f/gTwo5aBAPoA0QEAARAQABgAGFgv9AAIjoAA'
+    + 'o5aBAfQA0QEAARAQABgAGFgv9AAIjoAAo5aBAu4A0QEAARAQABgAGFgv9AAIjoAAHFO7a5G7j7OBALeK94EB8YIBd/CBAw==';
+const SKIES = [
+    ['#fde68a', '#fb7185', '#7c2d12'],
+    ['#bae6fd', '#38bdf8', '#14532d'],
+    ['#c4b5fd', '#f0abfc', '#312e81'],
+    ['#99f6e4', '#2dd4bf', '#134e4a'],
+    ['#fed7aa', '#f97316', '#451a03'],
+    ['#e2e8f0', '#94a3b8', '#1e293b'],
+];
+/** A little landscape: nothing in it can be anybody's real photo. */
+function landscapeSvg(rng, index) {
+    const [top, bottom, ground] = SKIES[index % SKIES.length];
+    const hill = (base) => {
+        const peak = Math.round(base - 40 - rng() * 90);
+        const x = Math.round(80 + rng() * 240);
+        return `M0 ${base} Q${x} ${peak} 400 ${Math.round(base - rng() * 50)} L400 400 L0 400 Z`;
+    };
+    const sunX = Math.round(60 + rng() * 280);
+    const sunY = Math.round(60 + rng() * 110);
+    const sunRadius = Math.round(18 + rng() * 26);
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 400">
+  <defs><linearGradient id="sky" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="${top}"/><stop offset="1" stop-color="${bottom}"/></linearGradient></defs>
+  <rect width="400" height="400" fill="url(#sky)"/>
+  <circle cx="${sunX}" cy="${sunY}" r="${sunRadius}" fill="#ffffff" opacity="0.8"/>
+  <path d="${hill(300)}" fill="${ground}" opacity="0.55"/>
+  <path d="${hill(350)}" fill="${ground}"/>
+</svg>
+`;
+}
+function stickerSvg(index) {
+    const [, fill, shade] = SKIES[index % SKIES.length];
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200">
+  <circle cx="100" cy="100" r="90" fill="${fill}"/>
+  <circle cx="70" cy="82" r="11" fill="${shade}"/>
+  <circle cx="130" cy="82" r="11" fill="${shade}"/>
+  <path d="M60 125 Q100 165 140 125" stroke="${shade}" stroke-width="9" fill="none" stroke-linecap="round"/>
+</svg>
+`;
+}
+/** Half a second of a soft tone, as 8-bit mono PCM. */
+function toneWav() {
+    const rate = 8000;
+    const samples = rate / 2;
+    const header = Buffer.alloc(44);
+    header.write('RIFF', 0, 'ascii');
+    header.writeUInt32LE(36 + samples, 4);
+    header.write('WAVEfmt ', 8, 'ascii');
+    header.writeUInt32LE(16, 16);
+    header.writeUInt16LE(1, 20);
+    header.writeUInt16LE(1, 22);
+    header.writeUInt32LE(rate, 24);
+    header.writeUInt32LE(rate, 28);
+    header.writeUInt16LE(1, 32);
+    header.writeUInt16LE(8, 34);
+    header.write('data', 36, 'ascii');
+    header.writeUInt32LE(samples, 40);
+    const body = Buffer.alloc(samples);
+    for (let i = 0; i < samples; i += 1) {
+        const fade = 1 - i / samples;
+        body[i] = Math.round(128 + 60 * fade * Math.sin((2 * Math.PI * 440 * i) / rate));
+    }
+    return Buffer.concat([header, body]);
+}
+const pad = (value) => String(value).padStart(2, '0');
+/** Paths are relative to the media root, the way a WaCrawl archive stores them. */
+export function demoMediaPath(type, rng) {
+    switch (type) {
+        case 'image': return `images/photo-${pad(Math.floor(rng() * IMAGE_COUNT))}.svg`;
+        case 'sticker': return `stickers/sticker-${pad(Math.floor(rng() * STICKER_COUNT))}.svg`;
+        case 'video': return 'videos/clip.webm';
+        case 'audio': return 'audio/voice-note.wav';
+        case 'document': return `documents/notes-${pad(Math.floor(rng() * DOCUMENT_COUNT))}.txt`;
+    }
+}
+/** Real, tiny files behind every media row, so the media grid has something to show. */
+export function writeDemoMedia(mediaRoot, rng) {
+    const write = (relative, contents) => {
+        const target = path.join(mediaRoot, relative);
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        fs.writeFileSync(target, contents);
+    };
+    for (let i = 0; i < IMAGE_COUNT; i += 1)
+        write(`images/photo-${pad(i)}.svg`, landscapeSvg(rng, i));
+    for (let i = 0; i < STICKER_COUNT; i += 1)
+        write(`stickers/sticker-${pad(i)}.svg`, stickerSvg(i));
+    for (let i = 0; i < DOCUMENT_COUNT; i += 1)
+        write(`documents/notes-${pad(i)}.txt`, `Demo attachment ${i + 1}. Synthetic, like everything else here.\n`);
+    write('videos/clip.webm', Buffer.from(CLIP_WEBM_BASE64, 'base64'));
+    write('audio/voice-note.wav', toneWav());
+}