@agentshouse/app-bridge 0.1.0-c415579fa0c3a → 0.1.0-c58a055eeaa71

package/dist/client/src/bridge.js

@@ -1,320 +0,0 @@
-export class HouseCeremonyRefused extends Error {
-    path;
-    constructor(path) {
-        super('house_ceremony_refused');
-        this.name = 'HouseCeremonyRefused';
-        this.path = path;
-    }
-}
-export class HouseNavigationRefused extends Error {
-    address;
-    constructor(address) {
-        super('house_navigation_refused');
-        this.name = 'HouseNavigationRefused';
-        this.address = address;
-    }
-}
-function pendingAnswer(pending, answer) {
-    const asked = pending.get(answer.id);
-    if (asked === undefined)
-        return null;
-    pending.delete(answer.id);
-    if (answer.refused === true) {
-        asked.reject(new HouseCeremonyRefused(null));
-        return null;
-    }
-    if (answer.refusal !== undefined) {
-        asked.reject(new DOMException(answer.refusal.message, answer.refusal.name));
-        return null;
-    }
-    return asked;
-}
-const FRAME_HOUSES = [
-    'runtime',
-    'status',
-    'screenshot',
-    'address',
-    'ceremony-refused',
-    'navigate-refused',
-    'attachment',
-    'source',
-    'external-call',
-    'install',
-    'notifications',
-    'badge',
-    'app-message',
-];
-function frameMessage(value) {
-    if (value === null || typeof value !== 'object')
-        return null;
-    const message = value;
-    if (typeof message.house !== 'string')
-        return null;
-    if (!FRAME_HOUSES.includes(message.house))
-        return null;
-    return value;
-}
-function settled() {
-    let settle = null;
-    const promise = new Promise((resolve, reject) => {
-        settle = { resolve, reject };
-    });
-    return { promise, settle: settle };
-}
-function heldBridge() {
-    const held = globalThis;
-    if (held.houseBridge === undefined || held.houseRuntime === undefined)
-        throw new Error('house_bridge_absent');
-    return { port: held.houseBridge, runtime: held.houseRuntime };
-}
-export function connectHouseBridge(source = heldBridge()) {
-    const ceremonies = [];
-    const navigations = [];
-    const attachments = new Map();
-    let nextAttachment = 0;
-    const sources = new Map();
-    let nextSource = 0;
-    const installations = new Map();
-    let nextInstallation = 0;
-    const notifications = new Map();
-    let nextNotifications = 0;
-    const badges = new Map();
-    let nextBadge = 0;
-    const screenshots = new Map();
-    let nextScreenshot = 0;
-    const externals = new Map();
-    let nextExternal = 0;
-    const addressListeners = new Set();
-    const statusListeners = new Set();
-    const messageListeners = new Set();
-    let outbox = [];
-    let held = null;
-    let address = null;
-    let status = null;
-    function send(message) {
-        if (held === null)
-            outbox?.push(message);
-        else
-            held.postMessage(message);
-    }
-    function receive(event) {
-        const data = frameMessage(event.data);
-        if (data === null)
-            return;
-        if (data.house === 'status') {
-            status = data.status;
-            for (const listener of statusListeners)
-                listener(status);
-            return;
-        }
-        if (data.house === 'app-message') {
-            const { from, body } = data;
-            for (const listener of messageListeners)
-                listener({ from, body });
-            return;
-        }
-        if (data.house === 'address') {
-            address = String(data.address);
-            if (data.navigated === true)
-                navigations.shift()?.settle.resolve(address);
-            for (const listener of addressListeners)
-                listener(address);
-            return;
-        }
-        if (data.house === 'navigate-refused') {
-            const refused = data.address;
-            const named = typeof refused === 'string' ? refused : null;
-            const index = named === null ? 0 : navigations.findIndex((one) => one.address === named);
-            const [pending] = navigations.splice(index < 0 ? 0 : index, 1);
-            pending?.settle.reject(new HouseNavigationRefused(named));
-            return;
-        }
-        if (data.house === 'attachment') {
-            if (typeof data.id !== 'number')
-                return;
-            const pending = attachments.get(data.id);
-            if (pending === undefined)
-                return;
-            attachments.delete(data.id);
-            pending.resolve(data.image ?? null);
-            return;
-        }
-        if (data.house === 'install') {
-            const pending = pendingAnswer(installations, data);
-            if (pending !== null && 'outcome' in data)
-                pending.resolve(data.outcome);
-            return;
-        }
-        if (data.house === 'notifications') {
-            const pending = pendingAnswer(notifications, data);
-            if (pending !== null && 'state' in data)
-                pending.resolve(data.state);
-            return;
-        }
-        if (data.house === 'badge') {
-            pendingAnswer(badges, data)?.resolve();
-            return;
-        }
-        if (data.house === 'source') {
-            if (typeof data.id !== 'number')
-                return;
-            const pending = sources.get(data.id);
-            if (pending === undefined)
-                return;
-            sources.delete(data.id);
-            pending.resolve(data.answer ?? null);
-            return;
-        }
-        if (data.house === 'external-call') {
-            if (typeof data.id !== 'number')
-                return;
-            const pending = externals.get(data.id);
-            if (pending === undefined)
-                return;
-            externals.delete(data.id);
-            pending.resolve(data.answer ?? null);
-            return;
-        }
-        if (data.house === 'screenshot') {
-            if (typeof data.id !== 'number')
-                return;
-            const pending = screenshots.get(data.id);
-            if (pending === undefined)
-                return;
-            screenshots.delete(data.id);
-            pending.resolve(data.image ?? null);
-            return;
-        }
-        if (data.house === 'ceremony-refused') {
-            const refused = data.path;
-            const named = typeof refused === 'string' ? refused : null;
-            const index = named === null ? 0 : ceremonies.findIndex((one) => one.path === named);
-            const [pending] = ceremonies.splice(index < 0 ? 0 : index, 1);
-            pending?.settle.reject(new HouseCeremonyRefused(named));
-        }
-    }
-    void source.port.then((port) => {
-        held = port;
-        port.addEventListener('message', receive);
-        port.start();
-        const waiting = outbox ?? [];
-        outbox = null;
-        for (const message of waiting)
-            port.postMessage(message);
-    });
-    function readSource(house, app, release) {
-        const pending = settled();
-        const id = ++nextSource;
-        sources.set(id, pending.settle);
-        send({ house, id, app, release });
-        return pending.promise;
-    }
-    function screenshot(house, asked) {
-        const pending = settled();
-        const id = ++nextScreenshot;
-        screenshots.set(id, pending.settle);
-        if (house === 'screenshot-read' && 'app' in asked)
-            send({ house, id, app: asked.app });
-        if (house === 'site-screenshot-read' && 'site' in asked)
-            send({ house, id, site: asked.site });
-        return pending.promise;
-    }
-    function navigate(mode, asked) {
-        const pending = settled();
-        navigations.push({ address: asked, settle: pending.settle });
-        send({ house: 'navigate', mode, address: asked });
-        return pending.promise;
-    }
-    return {
-        runtime: source.runtime,
-        address() {
-            return address;
-        },
-        onAddress(listener) {
-            addressListeners.add(listener);
-            return () => {
-                addressListeners.delete(listener);
-            };
-        },
-        push(asked) {
-            return navigate('push', asked);
-        },
-        replace(asked) {
-            return navigate('replace', asked);
-        },
-        ceremony(path) {
-            const pending = settled();
-            ceremonies.push({ path, settle: pending.settle });
-            send({ house: 'ceremony', path });
-            return pending.promise;
-        },
-        install() {
-            const pending = settled();
-            const id = ++nextInstallation;
-            installations.set(id, pending.settle);
-            send({ house: 'install', id });
-            return pending.promise;
-        },
-        notifications(on) {
-            const pending = settled();
-            const id = ++nextNotifications;
-            notifications.set(id, pending.settle);
-            send({ house: 'notifications', id, on });
-            return pending.promise;
-        },
-        setBadge(unread) {
-            const pending = settled();
-            const id = ++nextBadge;
-            badges.set(id, pending.settle);
-            send({ house: 'badge', id, unread });
-            return pending.promise;
-        },
-        setTab(tab) {
-            send({ house: 'tab', title: tab.title, icon: tab.icon });
-        },
-        readAttachment(room, attachment) {
-            const pending = settled();
-            const id = ++nextAttachment;
-            attachments.set(id, pending.settle);
-            send({ house: 'attachment-read', id, room, attachment });
-            return pending.promise;
-        },
-        sourceTop(app, release) {
-            return readSource('source-top', app, release);
-        },
-        sourceDownload(app, release) {
-            return readSource('source-download', app, release);
-        },
-        callExternal(request) {
-            const pending = settled();
-            const id = ++nextExternal;
-            externals.set(id, pending.settle);
-            send({ house: 'external-call', id, request });
-            return pending.promise;
-        },
-        readScreenshot(app) {
-            return screenshot('screenshot-read', { app });
-        },
-        readSiteScreenshot(site) {
-            return screenshot('site-screenshot-read', { site });
-        },
-        status() {
-            return status;
-        },
-        onStatus(listener) {
-            statusListeners.add(listener);
-            return () => {
-                statusListeners.delete(listener);
-            };
-        },
-        messages(listener) {
-            messageListeners.add(listener);
-            return () => {
-                messageListeners.delete(listener);
-            };
-        },
-        gaConsent(choice) {
-            send({ house: 'ga/consent', choice });
-        },
-    };
-}

package/dist/client/src/index.d.ts

@@ -1,3 +0,0 @@
-export { connectHouseBridge, HouseCeremonyRefused, HouseNavigationRefused, type HouseBridge, type HouseBridgeSource, type HouseImageCopy, } from './bridge.js';
-export { HOUSE_ADDRESS_MAX_CHARS } from './wire.js';
-export type { HouseAppMessage, HouseBridgeEvent, HouseBridgePort, HouseCredentialState, HouseExternalAnswer, HouseExternalRequest, HouseGa, HouseGaChoice, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceFile, HouseSourceTop, HouseStatus, HouseSyncState, } from './wire.js';

package/dist/client/src/index.js

@@ -1,2 +0,0 @@
-export { connectHouseBridge, HouseCeremonyRefused, HouseNavigationRefused, } from './bridge.js';
-export { HOUSE_ADDRESS_MAX_CHARS } from './wire.js';

package/dist/client/src/test-host.js

@@ -1,185 +0,0 @@
-import { appAddressOf } from '../../src/apps/remainder.js';
-import { tabChange } from '../../src/apps/tab.js';
-import { HOUSE_ADDRESS_MAX_CHARS } from './wire.js';
-const HOST_ORIGIN = 'https://house.invalid';
-function sameOriginPath(value) {
-    if (typeof value !== 'string')
-        return null;
-    if (value.charAt(0) !== '/' || value.slice(0, 2) === '//')
-        return null;
-    if (value.length > HOUSE_ADDRESS_MAX_CHARS)
-        return null;
-    const target = new URL(value, HOST_ORIGIN);
-    return target.origin === HOST_ORIGIN ? `${target.pathname}${target.search}${target.hash}` : null;
-}
-export function createHouseBridgeTestHost(options = {}) {
-    const navigations = [];
-    const ceremonies = [];
-    const consents = [];
-    const tabs = [];
-    const externalCalls = [];
-    const listeners = new Set();
-    const queued = [];
-    let started = false;
-    let address = appAddressOf('/', options.address ?? '/');
-    let status = options.status ?? null;
-    let attached = () => { };
-    const runtime = new Promise((resolve) => {
-        attached = resolve;
-    });
-    function deliver(data) {
-        const event = { data };
-        if (!started) {
-            queued.push(event);
-            return;
-        }
-        queueMicrotask(() => {
-            for (const listener of listeners)
-                listener(event);
-        });
-    }
-    function arrive(target, navigated) {
-        address = target;
-        deliver({ house: 'address', address, navigated });
-    }
-    function navigate(mode, asked) {
-        const target = sameOriginPath(asked);
-        if (target === null) {
-            deliver({
-                house: 'navigate-refused',
-                address: typeof asked === 'string' ? asked : null,
-            });
-            return;
-        }
-        navigations.push({ mode: mode === 'replace' ? 'replace' : 'push', address: target });
-        arrive(target, true);
-    }
-    function ceremony(path) {
-        const target = sameOriginPath(path);
-        if (target === null) {
-            deliver({ house: 'ceremony-refused', path: typeof path === 'string' ? path : null });
-            return;
-        }
-        ceremonies.push(target);
-    }
-    function publish(next) {
-        status = next;
-        deliver({ house: 'status', status });
-    }
-    function consent(choice) {
-        if (status === null || !status.ga.measures)
-            return;
-        if (choice !== 'accept' && choice !== 'decline')
-            return;
-        consents.push(choice);
-        publish({ ...status, ga: { measures: true, choice } });
-    }
-    function receive(message) {
-        const data = message;
-        if (data === null || typeof data !== 'object')
-            return;
-        if (data.house === 'navigate') {
-            navigate(data.mode, data.address);
-        }
-        else if (data.house === 'ceremony') {
-            ceremony(data.path);
-        }
-        else if (data.house === 'install') {
-            deliver({ house: 'install', id: data.id, outcome: 'manual' });
-        }
-        else if (data.house === 'notifications') {
-            deliver({ house: 'notifications', id: data.id, state: 'unavailable' });
-        }
-        else if (data.house === 'badge') {
-            deliver({ house: 'badge', id: data.id });
-        }
-        else if (data.house === 'tab') {
-            const change = tabChange(data);
-            if (change !== null)
-                tabs.push(change);
-        }
-        else if (data.house === 'ga/consent') {
-            consent(data.choice);
-        }
-        else if (data.house === 'source-top' || data.house === 'source-download') {
-            const asked = data;
-            const source = options.sources?.find((entry) => entry.top.app_ref === asked.app);
-            const answer = source === undefined ? null : data.house === 'source-top' ? source.top : source.download;
-            deliver({ house: 'source', id: asked.id, answer });
-        }
-        else if (data.house === 'attachment-read') {
-            const asked = data;
-            const image = options.images?.find((entry) => entry.room === asked.room && entry.attachment === asked.attachment);
-            deliver({
-                house: 'attachment',
-                id: asked.id,
-                image: image === undefined
-                    ? null
-                    : {
-                        attachment: image.attachment,
-                        copy: image.copy,
-                        name: image.name,
-                        media_type: image.media_type,
-                    },
-            });
-        }
-        else if (data.house === 'external-call') {
-            const asked = data;
-            externalCalls.push(asked.request);
-            void Promise.resolve(options.external?.(asked.request) ?? null).then((answer) => deliver({ house: 'external-call', id: asked.id, answer }));
-        }
-        else if (data.house === 'screenshot-read') {
-            const asked = data;
-            const held = typeof asked.app === 'string' ? options.screenshots?.[asked.app] : undefined;
-            deliver({ house: 'screenshot', id: asked.id, image: held ?? null });
-        }
-        else if (data.house === 'site-screenshot-read') {
-            const asked = data;
-            const held = typeof asked.site === 'string' ? options.siteScreenshots?.[asked.site] : undefined;
-            deliver({ house: 'screenshot', id: asked.id, image: held ?? null });
-        }
-    }
-    const port = {
-        postMessage(message) {
-            receive(message);
-        },
-        addEventListener(_type, listener) {
-            listeners.add(listener);
-        },
-        start() {
-            started = true;
-            const held = queued.splice(0);
-            queueMicrotask(() => {
-                for (const event of held) {
-                    for (const listener of listeners)
-                        listener(event);
-                }
-            });
-        },
-    };
-    if (status !== null)
-        deliver({ house: 'status', status });
-    deliver({ house: 'address', address, navigated: false });
-    return {
-        port: Promise.resolve(port),
-        runtime,
-        navigations,
-        ceremonies,
-        consents,
-        tabs,
-        externalCalls,
-        address() {
-            return address;
-        },
-        open(asked) {
-            arrive(appAddressOf('/', asked), false);
-        },
-        publish,
-        message(message) {
-            deliver({ house: 'app-message', from: message.from, body: message.body });
-        },
-        attachRuntime(client) {
-            attached(client);
-        },
-    };
-}