swarmbox 0.0.0-stage → 0.11.0

package/dist/control-room/server.js

@@ -0,0 +1,180 @@
+// The control room: one live tile per open screen, and take-over.
+//
+// Tiles are Chromium's own screencast (CDP Page.startScreencast). The page polls /state and fetches a
+// tile's latest picture (/screens/:id/frame) only when its frame count moved: short requests, because a
+// browser opens at most 6 connections to one address, and one never-ending stream per tile used them all,
+// so /state stopped getting through and the page froze (16 Oct, with 8 tiles; /stream remains for other
+// viewers). Take-over flips the screen's controller in the harness, the same state the MCP tools check,
+// so "a person has this screen" is enforced rather than hoped for; while they have it, their clicks,
+// wheel and keys on the tile go to that screen's browser (/screens/:id/input).
+//
+// Loopback only. Every request must carry this server's own Host (stops DNS rebinding, which would
+// otherwise let a website read the tiles: they show the product's data), and the one write must come
+// from this page's own origin (stops cross-site form posts).
+import http from 'node:http';
+import { page } from "./page.js";
+/** How long a screen may be quiet before its latest frame is re-sent to make the tile show it. */
+const REPEAT_MS = 500;
+export async function serveControlRoom(h, port) {
+    const PAGE = page(h.product.title ?? h.product.name);
+    let actualPort = port;
+    const own = () => [`127.0.0.1:${actualPort}`, `localhost:${actualPort}`];
+    const sockets = new Set();
+    const server = http.createServer((req, res) => {
+        if (!own().includes(req.headers.host ?? '')) {
+            res.writeHead(403).end('wrong host');
+            return;
+        }
+        const url = new URL(req.url ?? '/', `http://${req.headers.host}`);
+        if (req.method === 'GET' && url.pathname === '/') {
+            res
+                .writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store' })
+                .end(PAGE);
+            return;
+        }
+        if (req.method === 'GET' && url.pathname === '/state') {
+            const state = {
+                worlds: h.worlds().map((w) => ({
+                    id: w.id,
+                    port: w.world.port,
+                    tenants: w.world.tenants.map((t) => ({ slug: t, origin: w.world.origin(t) })),
+                })),
+                screens: h.screens().map((s) => ({
+                    id: s.id,
+                    world: s.worldId,
+                    tenant: s.persona.tenant,
+                    person: s.persona.label,
+                    controller: s.controller,
+                    url: s.screen.page.url(),
+                    frameSeq: s.frameSeq,
+                })),
+            };
+            res
+                .writeHead(200, { 'content-type': 'application/json', 'cache-control': 'no-store' })
+                .end(JSON.stringify(state));
+            return;
+        }
+        const frame = url.pathname.match(/^\/screens\/(s\d+)\/frame$/);
+        if (req.method === 'GET' && frame) {
+            const entry = h.screens().find((s) => s.id === frame[1]);
+            if (!entry?.frame) {
+                res.writeHead(entry ? 204 : 404).end();
+                return;
+            }
+            res
+                .writeHead(200, {
+                'content-type': 'image/jpeg',
+                'cache-control': 'no-store',
+                'x-frame-seq': String(entry.frameSeq),
+            })
+                .end(entry.frame);
+            return;
+        }
+        const stream = url.pathname.match(/^\/screens\/(s\d+)\/stream$/);
+        if (req.method === 'GET' && stream) {
+            const entry = h.screens().find((s) => s.id === stream[1]);
+            if (!entry) {
+                res.writeHead(404).end();
+                return;
+            }
+            res.writeHead(200, {
+                'content-type': 'multipart/x-mixed-replace; boundary=frame',
+                'cache-control': 'no-store',
+                connection: 'close',
+            });
+            // Chromium shows a part of a multipart image only once the NEXT part arrives. The screencast emits
+            // only when the page changes, so a quiet screen would leave its tile blank, or a step behind, until
+            // something else happened on it. So when a screen has been quiet for a moment its latest frame is
+            // sent again, which pushes the previous one onto the tile.
+            res.write('--frame\r\n');
+            let last = 0;
+            const send = (jpeg) => {
+                last = Date.now();
+                res.write(`Content-Type: image/jpeg\r\nContent-Length: ${jpeg.length}\r\n\r\n`);
+                res.write(jpeg);
+                res.write('\r\n--frame\r\n');
+            };
+            if (entry.frame)
+                send(entry.frame);
+            const repeat = setInterval(() => {
+                if (entry.frame && Date.now() - last >= REPEAT_MS)
+                    send(entry.frame);
+            }, REPEAT_MS);
+            entry.watchers.add(send);
+            req.on('close', () => {
+                clearInterval(repeat);
+                entry.watchers.delete(send);
+            });
+            return;
+        }
+        const sameOrigin = () => {
+            const origin = req.headers.origin;
+            if (origin &&
+                own()
+                    .map((x) => `http://${x}`)
+                    .includes(origin))
+                return true;
+            res.writeHead(403).end('wrong origin');
+            return false;
+        };
+        const input = url.pathname.match(/^\/screens\/(s\d+)\/input$/);
+        if (req.method === 'POST' && input) {
+            if (!sameOrigin())
+                return;
+            let body = '';
+            req.on('data', (c) => (body += c));
+            req.on('end', () => {
+                let parsed;
+                try {
+                    parsed = JSON.parse(body);
+                }
+                catch {
+                    res.writeHead(400).end('json please');
+                    return;
+                }
+                h.personInput(input[1], parsed).then(() => res.writeHead(204).end(), (e) => res.writeHead(409).end(e.message));
+            });
+            return;
+        }
+        const control = url.pathname.match(/^\/screens\/(s\d+)\/control$/);
+        if (req.method === 'POST' && control) {
+            if (!sameOrigin())
+                return;
+            let body = '';
+            req.on('data', (c) => (body += c));
+            req.on('end', () => {
+                const to = (() => {
+                    try {
+                        return JSON.parse(body).controller;
+                    }
+                    catch {
+                        return undefined;
+                    }
+                })();
+                if (to !== 'person' && to !== 'agent') {
+                    res.writeHead(400).end('controller must be person or agent');
+                    return;
+                }
+                h.setController(control[1], to).then(() => res.writeHead(204).end(), (e) => res.writeHead(404).end(e.message));
+            });
+            return;
+        }
+        res.writeHead(404).end();
+    });
+    // MJPEG responses never end on their own; track sockets so close() does not wait forever.
+    server.on('connection', (s) => {
+        sockets.add(s);
+        s.on('close', () => sockets.delete(s));
+    });
+    await new Promise((resolve) => server.listen(port, '127.0.0.1', resolve));
+    actualPort = server.address().port;
+    return {
+        url: `http://127.0.0.1:${actualPort}/`,
+        close: () => new Promise((resolve) => {
+            for (const s of sockets)
+                s.destroy();
+            server.close(() => resolve());
+        }),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/control-room/server.js.map

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

package/dist/device/device.d.ts

@@ -0,0 +1,20 @@
+import type { BrowserContext } from 'playwright-core';
+import type { Prop } from './props.ts';
+export interface DeviceState {
+    /** Props queued for the next file choosers, first first. */
+    files: Prop[];
+    /** What the camera shows now, if anything. */
+    camera: Prop | null;
+    /** Counts camera changes, so a page reads the picture again only when it changed. */
+    cameraVersion: number;
+}
+/**
+ * Set a new screen's device up, before its first page: the camera allowed and stood in for, and every file
+ * chooser answered from the queue, or noted when nothing was queued.
+ */
+export declare function setUpDevice(context: BrowserContext, state: DeviceState, note: (text: string) => void): Promise<void>;
+/** Put a prop in front of the camera (null: nothing): open pages see it within half a second, new ones at once. */
+export declare function showOnCamera(state: DeviceState, prop: Prop | null): void;
+export declare function setLocation(context: BrowserContext, latitude: number, longitude: number, accuracy?: number): Promise<void>;
+export declare function setNotifications(context: BrowserContext, allow: boolean): Promise<void>;
+//# sourceMappingURL=device.d.ts.map

package/dist/device/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/device/device.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,8CAA8C;IAC9C,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IACpB,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;CACvB;AAuED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,mHAAmH;AACnH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAGxE;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,SAAK,GACZ,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7F"}

package/dist/device/device.js

@@ -0,0 +1,108 @@
+// The device a screen runs on (docs/standins.md, The device and props): its camera, the files it can pick, where it
+// is and whether it shows notifications. Network, clock, shape and appearance are set elsewhere (harness.ts,
+// fleet/browser.ts); this is the part a person reaches with their hands.
+import { readFileSync } from 'node:fs';
+/**
+ * Inside every page: the camera is a canvas that draws whatever Swarmbox last put in front of it (a grey frame
+ * until then), so an app asking for the camera gets a working one with no prompt and no real device.
+ */
+function cameraInPage() {
+    const md = navigator.mediaDevices;
+    if (!md)
+        return;
+    // What the camera shows lives in Swarmbox, read through two exposed functions: its version (cheap, polled) and,
+    // when that changes, the picture itself. Nothing is added to the page per prop.
+    const w = window;
+    md.getUserMedia = async (constraints) => {
+        if (!constraints?.video)
+            throw new DOMException('This device has no microphone in a Swarmbox world', 'NotFoundError');
+        const canvas = document.createElement('canvas');
+        canvas.width = 1280;
+        canvas.height = 960;
+        const ctx = canvas.getContext('2d');
+        const img = new Image();
+        let version = -1;
+        let url = null;
+        const draw = () => {
+            if (url && img.complete && img.naturalWidth)
+                ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
+            else {
+                ctx.fillStyle = '#444';
+                ctx.fillRect(0, 0, canvas.width, canvas.height);
+            }
+        };
+        const look = async () => {
+            const v = (await w.__swarmboxCameraVersion?.()) ?? 0;
+            if (v === version)
+                return;
+            version = v;
+            url = (await w.__swarmboxCameraNow?.()) ?? null;
+            if (url)
+                img.src = url;
+        };
+        await look();
+        await new Promise((r) => (img.complete ? r(null) : (img.onload = img.onerror = () => r(null))));
+        draw();
+        const drawing = setInterval(draw, 66);
+        const looking = setInterval(() => void look(), 500);
+        const stream = canvas.captureStream(15);
+        // A stopped camera stops its timers too.
+        for (const track of stream.getTracks()) {
+            const stop = track.stop.bind(track);
+            track.stop = () => {
+                clearInterval(drawing);
+                clearInterval(looking);
+                stop();
+            };
+        }
+        return stream;
+    };
+    md.enumerateDevices = async () => [
+        {
+            deviceId: 'swarmbox-camera',
+            groupId: 'swarmbox',
+            kind: 'videoinput',
+            label: 'Swarmbox camera',
+            toJSON: () => ({}),
+        },
+    ];
+}
+const dataUrl = (prop) => `data:${prop.mime};base64,${readFileSync(prop.file).toString('base64')}`;
+/**
+ * Set a new screen's device up, before its first page: the camera allowed and stood in for, and every file
+ * chooser answered from the queue, or noted when nothing was queued.
+ */
+export async function setUpDevice(context, state, note) {
+    await context.grantPermissions(['camera', 'microphone']);
+    await context.exposeFunction('__swarmboxCameraVersion', () => state.cameraVersion);
+    await context.exposeFunction('__swarmboxCameraNow', () => (state.camera ? dataUrl(state.camera) : null));
+    await context.addInitScript(cameraInPage);
+    const answer = async (chooser) => {
+        const prop = state.files.shift();
+        if (!prop) {
+            note('a file chooser opened and nothing was picked: file_pick puts a prop in it');
+            return;
+        }
+        await chooser.setFiles({ name: prop.name, mimeType: prop.mime, buffer: readFileSync(prop.file) });
+        note(`picked ${prop.id} (${prop.kind}: ${prop.about}) in a file chooser`);
+    };
+    const watch = (page) => page.on('filechooser', (c) => void answer(c).catch((e) => note(`could not pick: ${e.message}`)));
+    context.on('page', watch);
+    for (const page of context.pages())
+        watch(page);
+}
+/** Put a prop in front of the camera (null: nothing): open pages see it within half a second, new ones at once. */
+export function showOnCamera(state, prop) {
+    state.camera = prop;
+    state.cameraVersion++;
+}
+export async function setLocation(context, latitude, longitude, accuracy = 20) {
+    await context.grantPermissions(['geolocation']);
+    await context.setGeolocation({ latitude, longitude, accuracy });
+}
+export async function setNotifications(context, allow) {
+    // Permissions can only be cleared all at once, so the camera's go back with them.
+    await context.clearPermissions();
+    await context.grantPermissions(allow ? ['camera', 'microphone', 'notifications'] : ['camera', 'microphone']);
+}
+//# sourceMappingURL=device.js.map

package/dist/device/device.js.map

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

package/dist/device/props.d.ts

@@ -0,0 +1,31 @@
+export type PropKind = 'photo' | 'document' | 'signature';
+/** Props kept at once; past it the oldest go, with their files. */
+export declare const PROPS_KEPT = 200;
+export interface Prop {
+    id: string;
+    kind: PropKind;
+    /** What it shows, as asked for. */
+    about: string;
+    file: string;
+    name: string;
+    mime: string;
+    bytes: number;
+    sha256: string;
+    /** The tag inside the file: `swarmbox-prop:<id>`. */
+    tag: string;
+    /** The colour a photo is drawn in, so a frame of it on a screen can be told apart. */
+    colour?: string;
+}
+/** A JPEG with a comment segment (FF FE) after its start and its JFIF header (APP0): where a photo carries its tag. */
+export declare function withJpegComment(jpeg: Buffer, text: string): Buffer;
+/** A PNG with a tEXt chunk right after its header: where a signature carries its tag. */
+export declare function withPngText(png: Buffer, keyword: string, text: string): Buffer;
+export interface PropMaker {
+    make(kind: PropKind, about: string): Promise<Prop>;
+    get(id: string): Prop;
+    list(): Prop[];
+    close(): Promise<void>;
+}
+/** Makes props into `dir`, drawing them in a headless Chromium of its own, started the first time it's needed. */
+export declare function propMaker(dir: string): PropMaker;
+//# sourceMappingURL=props.d.ts.map

package/dist/device/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/device/props.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAE1D,mEAAmE;AACnE,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,uHAAuH;AACvH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlE;AAaD,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAU9E;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,IAAI,IAAI,EAAE,CAAC;IACf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,kHAAkH;AAClH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAoGhD"}

package/dist/device/props.js

@@ -0,0 +1,143 @@
+// Props (docs/standins.md, The device and props): things a person makes or carries, a photo of the job, a vendor's
+// bill as a PDF, a signature. Swarmbox makes them, so a world never needs a real person's files, and tags each one
+// with its id, so a check can later tell which arrived where: visibly in a corner, and inside the file itself (a
+// JPEG comment, a PNG text chunk, a line of the PDF's text).
+import { createHash, randomBytes } from 'node:crypto';
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { chromium } from 'playwright-core';
+/** Props kept at once; past it the oldest go, with their files. */
+export const PROPS_KEPT = 200;
+const escape = (s) => s.replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[c]);
+/** A JPEG with a comment segment (FF FE) after its start and its JFIF header (APP0): where a photo carries its tag. */
+export function withJpegComment(jpeg, text) {
+    if (jpeg[0] !== 0xff || jpeg[1] !== 0xd8)
+        throw new Error('not a JPEG');
+    // After APP0 when there is one, where strict readers expect it to stay first.
+    const at = jpeg[2] === 0xff && jpeg[3] === 0xe0 ? 4 + jpeg.readUInt16BE(4) : 2;
+    const body = Buffer.from(text, 'latin1');
+    const segment = Buffer.alloc(4 + body.length);
+    segment.writeUInt16BE(0xfffe, 0);
+    segment.writeUInt16BE(body.length + 2, 2);
+    body.copy(segment, 4);
+    return Buffer.concat([jpeg.subarray(0, at), segment, jpeg.subarray(at)]);
+}
+const CRC_TABLE = Array.from({ length: 256 }, (_, n) => {
+    let c = n;
+    for (let k = 0; k < 8; k++)
+        c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+    return c >>> 0;
+});
+const crc32 = (b) => {
+    let c = 0xffffffff;
+    for (const byte of b)
+        c = CRC_TABLE[(c ^ byte) & 0xff] ^ (c >>> 8);
+    return (c ^ 0xffffffff) >>> 0;
+};
+/** A PNG with a tEXt chunk right after its header: where a signature carries its tag. */
+export function withPngText(png, keyword, text) {
+    const IHDR_END = 8 + 25; // signature, then the IHDR chunk (4 length + 4 type + 13 data + 4 crc)
+    if (png.toString('latin1', 12, 16) !== 'IHDR')
+        throw new Error('not a PNG');
+    const data = Buffer.concat([Buffer.from(keyword, 'latin1'), Buffer.from([0]), Buffer.from(text, 'latin1')]);
+    const typed = Buffer.concat([Buffer.from('tEXt', 'latin1'), data]);
+    const chunk = Buffer.alloc(8 + data.length + 4);
+    chunk.writeUInt32BE(data.length, 0);
+    typed.copy(chunk, 4);
+    chunk.writeUInt32BE(crc32(typed), 8 + data.length);
+    return Buffer.concat([png.subarray(0, IHDR_END), chunk, png.subarray(IHDR_END)]);
+}
+/** Makes props into `dir`, drawing them in a headless Chromium of its own, started the first time it's needed. */
+export function propMaker(dir) {
+    const props = new Map();
+    let browser;
+    // Drawn offline: the HTML is static and escaped, and there's still no reason for this browser to reach anything.
+    const page = async () => (await (await (browser ??= chromium.launch({ channel: 'chromium', headless: true }))).newContext({
+        offline: true,
+    })).newPage();
+    return {
+        async make(kind, about) {
+            const text = about.trim().slice(0, 300) || kind;
+            const id = `prop_${randomBytes(4).toString('hex')}`;
+            const tag = `swarmbox-prop:${id}`;
+            const hue = parseInt(id.slice(5, 9), 16) % 360;
+            const colour = `hsl(${hue}, 55%, 42%)`;
+            const p = await page();
+            let file;
+            let ext;
+            let mime;
+            try {
+                if (kind === 'photo') {
+                    await p.setViewportSize({ width: 1280, height: 960 });
+                    await p.setContent(`<body style="margin:0;width:1280px;height:960px;background:${colour};font:600 56px system-ui;color:#fff;display:flex;align-items:center;justify-content:center;text-align:center">` +
+                        `<div style="max-width:1000px">${escape(text)}</div>` +
+                        `<div style="position:absolute;right:24px;bottom:18px;font:24px ui-monospace,monospace;opacity:.8">${tag}</div></body>`);
+                    file = withJpegComment(await p.screenshot({ type: 'jpeg', quality: 85 }), tag);
+                    [ext, mime] = ['jpg', 'image/jpeg'];
+                }
+                else if (kind === 'signature') {
+                    await p.setViewportSize({ width: 600, height: 200 });
+                    await p.setContent(`<body style="margin:0;background:#fff"><svg width="600" height="200"><path d="M40 140 C 90 40, 130 40, 160 120 S 230 180, 270 90 S 360 40, 400 130 S 500 150, 560 70" ` +
+                        `fill="none" stroke="#123" stroke-width="5" stroke-linecap="round"/><text x="40" y="190" font-size="14" fill="#999">${escape(text)}</text></svg></body>`);
+                    file = withPngText(await p.screenshot({ type: 'png' }), 'Comment', tag);
+                    [ext, mime] = ['png', 'image/png'];
+                }
+                else {
+                    await p.setContent(`<body style="font:16px system-ui;padding:48px"><h1 style="font-size:28px">${escape(text)}</h1>` +
+                        `<p>Made by Swarmbox for a test world. Not a real document.</p>` +
+                        `<p style="color:#fff;font-size:6px">${tag}</p></body>`);
+                    file = await p.pdf({ format: 'Letter', printBackground: true });
+                    [ext, mime] = ['pdf', 'application/pdf'];
+                }
+            }
+            finally {
+                await p.context().close();
+            }
+            mkdirSync(dir, { recursive: true });
+            const name = `${text
+                .toLowerCase()
+                .replace(/[^a-z0-9]+/g, '-')
+                .replace(/^-|-$/g, '')
+                .slice(0, 40) || kind}.${ext}`;
+            const path = join(dir, `${id}-${name}`);
+            writeFileSync(path, file);
+            const prop = {
+                id,
+                kind,
+                about: text,
+                file: path,
+                name,
+                mime,
+                bytes: file.length,
+                sha256: createHash('sha256').update(file).digest('hex'),
+                tag,
+                ...(kind === 'photo' ? { colour } : {}),
+            };
+            props.set(id, prop);
+            // At most PROPS_KEPT: the oldest go, with their files.
+            while (props.size > PROPS_KEPT) {
+                const [oldest, old] = props.entries().next().value;
+                props.delete(oldest);
+                rmSync(old.file, { force: true });
+            }
+            return prop;
+        },
+        get(id) {
+            const prop = props.get(id);
+            if (!prop)
+                throw new Error(`no prop ${id}; make one with prop_make`);
+            return prop;
+        },
+        list: () => [...props.values()],
+        async close() {
+            const b = await browser?.catch(() => undefined);
+            browser = undefined;
+            await b?.close();
+            // A world's props are for its run: none outlive the harness.
+            for (const p of props.values())
+                rmSync(p.file, { force: true });
+            props.clear();
+        },
+    };
+}
+//# sourceMappingURL=props.js.map

package/dist/device/props.js.map

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

package/dist/fleet/browser.d.ts

@@ -0,0 +1,116 @@
+import { type BrowserContext, type Page } from 'playwright-core';
+import type { Persona, SignIn, StartCookie } from '../product.ts';
+/** A sign-in's cookies, on the tenant's own origin: how a screen is signed in, and kept signed in. */
+export declare function setCookies(context: BrowserContext, origin: string, cookies: StartCookie[]): Promise<void>;
+/** Makes `*.{baseDomain}` resolve to loopback inside this browser, and nowhere else on the machine. */
+export declare function resolverRule(baseDomain: string): string;
+export interface FleetOptions {
+    baseDomain: string;
+    /** The port the product serves its tenants on, used to build each tenant's origin. */
+    port: number;
+    /** Headed is the default: the point of the sandbox is that the screens can be watched. */
+    headless?: boolean;
+    /** Slow actions down so a person can follow along. Milliseconds between operations. */
+    slowMo?: number;
+    /**
+     * Provider pages a stand-in plays in the browser (a card form's script and iframe): every request to `origin`
+     * is answered by the stand-in at `to`, so the page keeps the provider's origin and its origin checks pass.
+     */
+    routes?: {
+        origin: string;
+        to: string;
+    }[];
+    /**
+     * With routes, where else the browsers may go: the world's stand-ins and what the product loads from outside.
+     * A routed provider page is the stand-in's own code in the browser, so the world's browsers then reach only the
+     * world's hosts, the routed origins and these; every other request and WebSocket is blocked.
+     */
+    allowOrigins?: string[];
+    /**
+     * The world's stand-ins' own addresses (http://127.0.0.1:<port>): reachable from its browsers (a presigned
+     * upload goes straight to S3's), but when its browsers play a provider's pages, only through the same checked
+     * proxy as the routed origins, so a stand-in can't bounce the browser out with a redirect of its own.
+     */
+    standins?: string[];
+}
+/** Whether a URL is inside a world whose browsers play a provider's pages (see FleetOptions.allowOrigins). */
+export declare function insideWorld(url: string, options: FleetOptions): boolean;
+/**
+ * The devices a screen can be. A sign-in's own viewport (a product's tablet app) is the default for that
+ * app; a device named when the screen opens wins over it, so the same app can be tried on a phone or turned
+ * to portrait. Sizes are CSS pixels of common devices: a 6.1" phone, an 11" tablet each way, a laptop.
+ */
+export declare const DEVICES: {
+    readonly desktop: {
+        readonly viewport: {
+            readonly width: 1440;
+            readonly height: 900;
+        };
+    };
+    readonly phone: {
+        readonly viewport: {
+            readonly width: 390;
+            readonly height: 844;
+        };
+        readonly isMobile: true;
+        readonly hasTouch: true;
+        readonly deviceScaleFactor: 3;
+    };
+    readonly tablet: {
+        readonly viewport: {
+            readonly width: 1180;
+            readonly height: 820;
+        };
+        readonly hasTouch: true;
+        readonly deviceScaleFactor: 2;
+    };
+    readonly 'tablet-portrait': {
+        readonly viewport: {
+            readonly width: 820;
+            readonly height: 1180;
+        };
+        readonly hasTouch: true;
+        readonly deviceScaleFactor: 2;
+    };
+};
+export type Device = keyof typeof DEVICES;
+/** How a screen looks: its device and the light or dark appearance its system asks for. */
+export interface Appearance {
+    device?: Device;
+    colorScheme?: 'light' | 'dark';
+}
+/**
+ * Who a screen is for: a signed-in person, or someone with only a link, a customer, whose browser has no
+ * sign-in at all (signIn null).
+ */
+export interface Who {
+    persona: Pick<Persona, 'tenant' | 'timeZone'>;
+    signIn: SignIn | null;
+}
+export interface Screen {
+    /** Null for a screen with no sign-in: a customer's, opened at their link. */
+    signIn: SignIn | null;
+    /** The client address the api sees for this screen (see open()). */
+    address: string;
+    context: BrowserContext;
+    page: Page;
+    close(): Promise<void>;
+}
+export interface Fleet {
+    /** Open a screen as one person, already signed in, or as a customer with nothing but a link. */
+    open(who: Who, path?: string, options?: Appearance & {
+        address?: string;
+        /** Called with the new context before it loads anything, so nothing it does is missed. */
+        onContext?: (context: BrowserContext) => void | Promise<void>;
+        /** The world's time, when its clock has moved: the page starts on it, not on this machine's. */
+        clock?: {
+            at: string;
+            paused: boolean;
+        };
+    }): Promise<Screen>;
+    originFor(tenant: string): string;
+    readonly screens: readonly Screen[];
+    close(): Promise<void>;
+}
+export declare function launchFleet(options: FleetOptions): Promise<Fleet>;
+//# sourceMappingURL=browser.d.ts.map