@graview/ship 0.1.0

package/dist/remote.js

@@ -0,0 +1,271 @@
+import { foldPresence, PRESENCE_TTL_MS, samePresence, Store, } from "@graview/core";
+/**
+ * Opens a store from a server and keeps it in step with it.
+ *
+ * `seed` is deliberately absent: what is on the server is what there is. A
+ * client that seeded would be a client that could overwrite everybody's
+ * roster by being the first to load.
+ */
+/** A counter nobody else is using: this client's own, provisional ids. */
+function localIds() {
+    const who = Math.random().toString(36).slice(2, 8);
+    let at = 0;
+    return () => `local-${who}-${++at}`;
+}
+export async function openRemote(options) {
+    const call = options.fetch ?? fetch;
+    const headers = { "content-type": "application/json", ...(options.headers ?? {}) };
+    if (options.principal?.id)
+        headers["x-graview-seat"] = options.principal.id;
+    if (options.principal?.roles?.length)
+        headers["x-graview-roles"] = options.principal.roles.join(",");
+    const state = (await (await call(`${options.url}/graview/state`)).json());
+    const store = new Store({
+        schema: options.app.schema,
+        mutations: options.app.mutations ?? [],
+        invariants: options.app.invariants ?? [],
+        ...(options.app.policy ? { policy: options.app.policy } : {}),
+        ...(options.app.modules ? { modules: options.app.modules } : {}),
+        ...(options.app.intelligence ? { intelligence: options.app.intelligence } : {}),
+        /*
+         * The snapshot AND the log: the snapshot is the graph, the log is the
+         * history that led to it. Folding the log alone would lose whatever the
+         * server was seeded with, which was never an operation.
+         */
+        snapshot: state.snapshot,
+        log: state.log,
+        /*
+         * IDS THIS CLIENT CANNOT SHARE WITH ANYBODY.
+         *
+         * A store's default id is a monotonic counter, which is exactly right
+         * for a test and exactly wrong for a second writer: two stores both
+         * start at one, so this browser's first optimistic op and the server's
+         * first op are both `op1` — and `receive` then drops the server's as
+         * one it already had. The change silently never arrived, on whichever
+         * browser happened to have acted once.
+         *
+         * The ops this store mints are PROVISIONAL anyway: the server's own is
+         * what stays. Prefixing them says so, and makes the collision
+         * impossible rather than unlikely.
+         */
+        ids: localIds(),
+        ...(options.storeOptions ?? {}),
+    });
+    let seen = state.log.at(-1)?.seq ?? -1;
+    /*
+     * PRESENCE, beside the log and never in it. `mine` is the last word this
+     * browser said about itself; it goes out with every poll while it stands,
+     * and what comes back is folded into `known` for whoever is listening.
+     */
+    let mine = null;
+    let known = new Map();
+    const whoListeners = new Set();
+    const heard = (who) => {
+        const next = foldPresence(new Map(), who, Date.now(), PRESENCE_TTL_MS * 4, mine?.participant);
+        let changed = next.size !== known.size;
+        if (!changed)
+            for (const [participant, presence] of next)
+                if (!samePresence(presence, known.get(participant)))
+                    changed = true;
+        known = next;
+        if (!changed)
+            return;
+        for (const listener of whoListeners)
+            listener([...known.values()]);
+    };
+    const land = (ops, applied = false) => {
+        if (ops.length === 0)
+            return [];
+        seen = Math.max(seen, ...ops.map((op) => op.seq));
+        return store.receive(ops, { applied });
+    };
+    const pull = async () => {
+        if (mine) {
+            const response = await call(`${options.url}/graview/here`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ presence: mine, seq: seen }),
+            });
+            const { who, ops } = (await response.json());
+            heard(who ?? []);
+            return land(ops ?? []);
+        }
+        const response = await call(`${options.url}/graview/since?seq=${seen}`, { headers });
+        const { ops } = (await response.json());
+        return land(ops);
+    };
+    const presence = {
+        here(next) {
+            mine = next;
+        },
+        onWho(listener) {
+            whoListeners.add(listener);
+            return () => {
+                whoListeners.delete(listener);
+            };
+        },
+        leave() {
+            if (!mine)
+                return;
+            const body = JSON.stringify({ participant: mine.participant });
+            mine = null;
+            // A page on its way out gets one shot; a beacon is what survives it.
+            const beacon = globalThis.navigator?.sendBeacon;
+            if (beacon)
+                beacon.call(globalThis.navigator, `${options.url}/graview/leave`, body);
+            else
+                void call(`${options.url}/graview/leave`, { method: "POST", headers, body }).catch(() => { });
+        },
+    };
+    /** The server's batch for each provisional one this browser minted, so an undo names what the server has. */
+    const batches = new Map();
+    /** Every post not yet answered, so `settled` can wait for the verdicts. */
+    const inFlight = new Set();
+    const track = (promise) => {
+        inFlight.add(promise);
+        void promise.finally(() => inFlight.delete(promise)).catch(() => { });
+        return promise;
+    };
+    /*
+     * `applied` says the local store already holds this change — it was
+     * applied optimistically before the post — so the server's op is
+     * recorded rather than re-applied. `send` never applies first, so its
+     * answer lands in full.
+     */
+    const post = async (body, applied = false) => {
+        const response = await call(`${options.url}/graview/ops`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+        });
+        const answer = (await response.json());
+        if (!response.ok) {
+            // The policy's own sentence, carried across the wire unchanged: a
+            // refusal a person can read is the whole point of having one.
+            throw new Error(answer.error ?? `The server refused (${response.status})`);
+        }
+        const ops = answer.ops ?? [];
+        land(ops, applied);
+        return { ops, ...(answer.batch ? { batch: answer.batch } : {}) };
+    };
+    const send = async (calls, sending = {}) => (await post({ calls, ...sending })).ops;
+    /*
+     * APPLIED HERE FIRST, DECIDED THERE.
+     *
+     * `store.apply` is synchronous — the scene, the strip and the routed face
+     * all expect the graph to have moved by the time the press returns — and
+     * the network is not. So the local store applies optimistically and the
+     * server is told; what comes back is the SERVER's op, which is the one
+     * that stays, with the id, author and sequence everybody else will see.
+     *
+     * And a refusal takes the optimism back. The alternative — leaving the
+     * hopeful change on screen and logging the refusal to a console — is the
+     * one behaviour that would make this whole design a lie: the interface
+     * would be showing a graph the server does not have.
+     */
+    const appliedAll = store.applyAll.bind(store);
+    const undone = store.undo.bind(store);
+    const refusals = new Set();
+    /*
+     * A refusal takes the optimism back — undone by its own batch, which is
+     * the same mechanism a person's undo uses — AS THE SAME PERSON. What you
+     * may undo is what you may have done, and an undo judged as nobody is
+     * refused in an app with a policy: taking back your own optimism would
+     * have thrown a second, more confusing refusal on top of the first.
+     */
+    const takeBack = (batch, error) => {
+        const reason = error instanceof Error ? error.message : String(error);
+        try {
+            const asMe = options.principal ? { author: options.principal } : {};
+            if (store.canUndo(batch).ok)
+                undone(batch, asMe);
+        }
+        catch {
+            // A take-back that cannot run leaves the interface wrong, and
+            // saying so is still better than saying nothing.
+        }
+        for (const told of refusals)
+            told(reason);
+    };
+    /*
+     * EVERY WAY THE GRAPH CHANGES GOES DOWN THE WIRE. `apply` is one call;
+     * `applyAll` is a whole gesture — a seat's plan lands as one batch — and
+     * `undo` is a take-back. The first version patched `apply` alone, so a
+     * robot's plans and undos stayed in the browser that made them while its
+     * single presses travelled: two windows on one roster disagreed about
+     * exactly the changes an agent had made.
+     */
+    store.applyAll = ((calls, applyOptions) => {
+        /*
+         * As WHOEVER IS AT THIS KEYBOARD, by default.
+         *
+         * The local store carries the app's policy, so a call with no author is
+         * judged as an anonymous human — who, in an app with a policy, may do
+         * nothing. Every surface that threads a principal is unaffected; what
+         * this fixes is the one that does not, which would otherwise meet a
+         * refusal about a person who is not sitting there.
+         */
+        const result = appliedAll(calls, {
+            ...(options.principal ? { author: options.principal } : {}),
+            ...applyOptions,
+        });
+        track(post({ calls, ...(applyOptions?.intent ? { intent: applyOptions.intent } : {}) }, true)
+            .then((answer) => {
+            if (answer.batch)
+                batches.set(result.batch, answer.batch);
+        })
+            .catch((error) => takeBack(result.batch, error)));
+        return result;
+    });
+    // `apply` is `applyAll` of one — and it must go through the patched one.
+    store.apply = ((callMade, applyOptions) => store.applyAll([callMade], applyOptions));
+    store.undo = ((batchIds, undoOptions) => {
+        const ids = typeof batchIds === "string" ? [batchIds] : batchIds;
+        const result = undone(ids, {
+            ...(options.principal ? { author: options.principal } : {}),
+            ...undoOptions,
+        });
+        // Named as the server knows them: a provisional batch by the one it became.
+        const theirs = ids.map((id) => batches.get(id) ?? id);
+        track(post({ undo: theirs, ...(undoOptions?.intent ? { intent: undoOptions.intent } : {}) }, true)
+            .then((answer) => {
+            if (answer.batch)
+                batches.set(result.batch, answer.batch);
+        })
+            .catch((error) => takeBack(result.batch, error)));
+        return result;
+    });
+    const every = options.pollMs ?? 800;
+    const timer = every > 0 && typeof setInterval === "function"
+        ? setInterval(() => {
+            void pull().catch(() => {
+                // A poll that cannot reach the server is a poll that will try
+                // again; throwing here would take the interface down with the
+                // connection.
+            });
+        }, every)
+        : null;
+    return {
+        store,
+        version: state.version,
+        migrated: state.migrated ?? [],
+        send,
+        pull,
+        onRefusal(listener) {
+            refusals.add(listener);
+            return () => refusals.delete(listener);
+        },
+        async settled() {
+            // Whatever is in flight now — and whatever a settling handler put in flight after it.
+            while (inFlight.size > 0)
+                await Promise.allSettled([...inFlight]);
+        },
+        presence,
+        close() {
+            if (timer)
+                clearInterval(timer);
+            presence.leave();
+        },
+    };
+}
+//# sourceMappingURL=remote.js.map

package/dist/remote.js.map

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

package/dist/serve.d.ts

@@ -0,0 +1,121 @@
+import { type IncomingMessage, type Server } from "node:http";
+import { Store, type AnySchema, type GraviewApp, type Operation, type PersistenceAdapter, type Principal } from "@graview/core";
+import { type OpenedStore } from "./open-store.js";
+import type { GraphSnapshot } from "./snapshot.js";
+/**
+ * THE STORE, BEHIND HTTP — and the op log is the wire.
+ *
+ * Two server-side adapters existed and nothing showed either, so the
+ * strongest thing this platform can say to somebody self-hosting — "where
+ * is my data" answered with a folder you can open — was a capability the
+ * launcher asserted rather than a capability anybody had seen.
+ *
+ * What is deliberately NOT here: a second way to change the graph. A client
+ * sends CALLS, not primitives; the server applies them through an ordinary
+ * `Store` under the principal the request carries, so the policy judges
+ * them exactly as it judges them in a browser, the invariants run, and the
+ * op that comes back is the same shape the browser would have made. A
+ * client that could post primitives would be a client that could write past
+ * every rule the app declares.
+ *
+ * The whole protocol is four routes:
+ *
+ *   GET  /graview/state        the graph, the log and the stored version
+ *   POST /graview/ops          calls in, the ops they produced out — or `undo`, batches to take back
+ *   GET  /graview/since?seq=N  the ops appended after N — everyone else's
+ *   GET  /graview/health       ship's own report, plus where the data is
+ *
+ * And two for WHO IS HERE, which is not the op log and never touches it:
+ *
+ *   POST /graview/here         say where you are; answers with who else is, and the ops since `seq`
+ *   GET  /graview/who          who is here right now
+ *   POST /graview/leave        say you have gone
+ *
+ * Presence lives in a map inside this closure with a time to live — not in
+ * the store, not in the adapter, not in the log. A tab that dies without a
+ * word is gone after three missed heartbeats.
+ *
+ * Polling rather than a socket, on purpose: a demo whose point is "your data
+ * is in this folder" should not also be a demonstration of connection
+ * lifecycles, and a poll is a thing a person can reproduce with `curl`.
+ */
+/**
+ * THE WIRE, AS A CONTRACT. Every route `serveStore` answers, in one place a
+ * test pins and a README repeats: what a host in front of this — Graview
+ * Cloud, or anybody's — must keep answering for `openRemote`, `graview mcp
+ * --remote-url` and `graview apply --remote-url` to work unchanged. What a
+ * host adds (who a bearer token is, which tenant, how much) goes in
+ * `seatOf` and around these routes, never inside them.
+ */
+export declare const WIRE: readonly [{
+    readonly method: "GET";
+    readonly path: "/graview/state";
+    readonly says: "the graph, the log and the stored version";
+}, {
+    readonly method: "POST";
+    readonly path: "/graview/ops";
+    readonly says: "calls in, the ops they produced out — or `undo`, batches to take back; 409 with the policy's sentence when refused";
+}, {
+    readonly method: "GET";
+    readonly path: "/graview/since";
+    readonly says: "the ops appended after ?seq=N — everyone else's";
+}, {
+    readonly method: "GET";
+    readonly path: "/graview/health";
+    readonly says: "ship's own report, plus where the data is";
+}, {
+    readonly method: "GET";
+    readonly path: "/graview/export";
+    readonly says: "the whole store as one bundle, the way out";
+}, {
+    readonly method: "POST";
+    readonly path: "/graview/here";
+    readonly says: "say where you are; answers with who else is, and the ops since `seq`";
+}, {
+    readonly method: "GET";
+    readonly path: "/graview/who";
+    readonly says: "who is here right now";
+}, {
+    readonly method: "POST";
+    readonly path: "/graview/leave";
+    readonly says: "say you have gone";
+}];
+/** The headers a request carries its seat in. A host's `seatOf` may read others; these are what the framework's clients send. */
+export declare const SEAT_HEADERS: {
+    readonly seat: "x-graview-seat";
+    readonly roles: "x-graview-roles";
+};
+export interface ServeOptions<S extends AnySchema> {
+    readonly app: GraviewApp<S>;
+    /** Where the graph lives. The file adapter by default — see `createFileAdapter`. */
+    readonly adapter: PersistenceAdapter<string>;
+    /** What to put in an empty store on first start. */
+    readonly seed?: GraphSnapshot;
+    readonly scope?: string;
+    readonly port?: number;
+    /**
+     * Who a request is, from its own headers.
+     *
+     * Not an authentication system — this is a demo server, and pretending
+     * otherwise would be worse than saying so. It reads `x-graview-seat` and
+     * `x-graview-roles` and hands the result to the store, which is enough to
+     * show the thing worth showing: the SAME policy refusing the same act on
+     * the server that refuses it in the browser.
+     */
+    readonly seatOf?: (request: IncomingMessage) => Principal;
+    /** Where the data is, for the health report to say out loud. */
+    readonly where?: string;
+    /** How long a presence stands after its last word. Three heartbeats by default. */
+    readonly presenceTtlMs?: number;
+}
+export interface ServedStore<S extends AnySchema> {
+    readonly store: Store<S>;
+    readonly opened: OpenedStore<S>;
+    readonly server: Server;
+    readonly port: number;
+    readonly url: string;
+    close(): Promise<void>;
+}
+export declare function serveStore<S extends AnySchema>(options: ServeOptions<S>): Promise<ServedStore<S>>;
+export type { Operation };
+//# sourceMappingURL=serve.d.ts.map

package/dist/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAC;AACjG,OAAO,EAGL,KAAK,EACL,KAAK,SAAS,EACd,KAAK,UAAU,EAEf,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASP,CAAC;AAEX,iIAAiI;AACjI,eAAO,MAAM,YAAY;;;CAAgE,CAAC;AAE1F,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,SAAS;IAC/C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,oDAAoD;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,SAAS,CAAC;IAC1D,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,SAAS;IAC9C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAiBD,wBAAsB,UAAU,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAyKvG;AAyBD,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/serve.js

@@ -0,0 +1,249 @@
+import { createServer } from "node:http";
+import { foldPresence, PRESENCE_TTL_MS, Store, } from "@graview/core";
+import { exportBundle } from "./export.js";
+import { health } from "./health.js";
+import { openStore } from "./open-store.js";
+/**
+ * THE STORE, BEHIND HTTP — and the op log is the wire.
+ *
+ * Two server-side adapters existed and nothing showed either, so the
+ * strongest thing this platform can say to somebody self-hosting — "where
+ * is my data" answered with a folder you can open — was a capability the
+ * launcher asserted rather than a capability anybody had seen.
+ *
+ * What is deliberately NOT here: a second way to change the graph. A client
+ * sends CALLS, not primitives; the server applies them through an ordinary
+ * `Store` under the principal the request carries, so the policy judges
+ * them exactly as it judges them in a browser, the invariants run, and the
+ * op that comes back is the same shape the browser would have made. A
+ * client that could post primitives would be a client that could write past
+ * every rule the app declares.
+ *
+ * The whole protocol is four routes:
+ *
+ *   GET  /graview/state        the graph, the log and the stored version
+ *   POST /graview/ops          calls in, the ops they produced out — or `undo`, batches to take back
+ *   GET  /graview/since?seq=N  the ops appended after N — everyone else's
+ *   GET  /graview/health       ship's own report, plus where the data is
+ *
+ * And two for WHO IS HERE, which is not the op log and never touches it:
+ *
+ *   POST /graview/here         say where you are; answers with who else is, and the ops since `seq`
+ *   GET  /graview/who          who is here right now
+ *   POST /graview/leave        say you have gone
+ *
+ * Presence lives in a map inside this closure with a time to live — not in
+ * the store, not in the adapter, not in the log. A tab that dies without a
+ * word is gone after three missed heartbeats.
+ *
+ * Polling rather than a socket, on purpose: a demo whose point is "your data
+ * is in this folder" should not also be a demonstration of connection
+ * lifecycles, and a poll is a thing a person can reproduce with `curl`.
+ */
+/**
+ * THE WIRE, AS A CONTRACT. Every route `serveStore` answers, in one place a
+ * test pins and a README repeats: what a host in front of this — Graview
+ * Cloud, or anybody's — must keep answering for `openRemote`, `graview mcp
+ * --remote-url` and `graview apply --remote-url` to work unchanged. What a
+ * host adds (who a bearer token is, which tenant, how much) goes in
+ * `seatOf` and around these routes, never inside them.
+ */
+export const WIRE = [
+    { method: "GET", path: "/graview/state", says: "the graph, the log and the stored version" },
+    { method: "POST", path: "/graview/ops", says: "calls in, the ops they produced out — or `undo`, batches to take back; 409 with the policy's sentence when refused" },
+    { method: "GET", path: "/graview/since", says: "the ops appended after ?seq=N — everyone else's" },
+    { method: "GET", path: "/graview/health", says: "ship's own report, plus where the data is" },
+    { method: "GET", path: "/graview/export", says: "the whole store as one bundle, the way out" },
+    { method: "POST", path: "/graview/here", says: "say where you are; answers with who else is, and the ops since `seq`" },
+    { method: "GET", path: "/graview/who", says: "who is here right now" },
+    { method: "POST", path: "/graview/leave", says: "say you have gone" },
+];
+/** The headers a request carries its seat in. A host's `seatOf` may read others; these are what the framework's clients send. */
+export const SEAT_HEADERS = { seat: "x-graview-seat", roles: "x-graview-roles" };
+const SEAT = (request) => {
+    const id = header(request, "x-graview-seat");
+    const roles = header(request, "x-graview-roles");
+    return {
+        kind: "human",
+        ...(id ? { id } : {}),
+        ...(roles ? { roles: roles.split(",").filter(Boolean) } : {}),
+    };
+};
+function header(request, name) {
+    const value = request.headers[name];
+    return Array.isArray(value) ? value[0] : value;
+}
+export async function serveStore(options) {
+    const scope = options.scope ?? options.app.name;
+    const seatOf = options.seatOf ?? SEAT;
+    /*
+     * The migration runs HERE, once, against the stored graph — which is the
+     * whole reason a server is the honest place for it. A browser that
+     * migrates its own copy migrates it once per browser; a server that
+     * migrates the roster migrates the roster.
+     */
+    const opened = await openStore({
+        app: options.app,
+        adapter: options.adapter,
+        scope,
+        ...(options.seed ? { seed: options.seed } : {}),
+    });
+    const store = opened.store;
+    /*
+     * WHO IS HERE. Keyed by participant, named by the seat the request
+     * carries — a poster cannot claim to be somebody else's seat — and
+     * stamped with the server's clock, so expiry does not depend on two
+     * browsers agreeing what time it is.
+     */
+    const ttl = options.presenceTtlMs ?? PRESENCE_TTL_MS;
+    let here = new Map();
+    const alive = () => {
+        here = foldPresence(here, [], Date.now(), ttl);
+        return [...here.values()];
+    };
+    const arrive = (told, seat) => {
+        const session = told.participant.split(":").slice(2).join(":");
+        const participant = seat.id ? `${seat.kind}:${seat.id}:${session}` : told.participant;
+        const presence = { ...told, participant, at: new Date().toISOString() };
+        here = foldPresence(here, [presence], Date.now(), ttl);
+        return presence;
+    };
+    const since = (seq) => store.log.all().filter((op) => op.seq > seq);
+    const server = createServer((request, response) => {
+        void handle(request, response).catch((error) => {
+            send(response, 500, { error: error instanceof Error ? error.message : String(error) });
+        });
+    });
+    async function handle(request, response) {
+        // A browser on another origin is the ordinary case for an embed.
+        response.setHeader("access-control-allow-origin", "*");
+        response.setHeader("access-control-allow-headers", "content-type, authorization, x-graview-seat, x-graview-roles");
+        response.setHeader("access-control-allow-methods", "GET, POST, OPTIONS");
+        if (request.method === "OPTIONS") {
+            response.writeHead(204).end();
+            return;
+        }
+        const url = new URL(request.url ?? "/", "http://localhost");
+        if (url.pathname === "/graview/state") {
+            send(response, 200, {
+                version: options.app.version ?? 1,
+                snapshot: store.snapshot(),
+                log: store.log.all(),
+                migrated: opened.migrated.map((op) => op.intent),
+            });
+            return;
+        }
+        if (url.pathname === "/graview/since") {
+            const seq = Number(url.searchParams.get("seq") ?? "-1");
+            send(response, 200, { ops: since(seq) });
+            return;
+        }
+        if (url.pathname === "/graview/who") {
+            send(response, 200, { who: alive() });
+            return;
+        }
+        if (url.pathname === "/graview/here" && request.method === "POST") {
+            const body = (await read(request));
+            if (!body.presence || typeof body.presence.participant !== "string" || typeof body.presence.stop !== "string") {
+                send(response, 400, { error: "A presence is a participant and a stop." });
+                return;
+            }
+            const mine = arrive(body.presence, seatOf(request));
+            // Folded into the poll: the heartbeat carries back everybody else AND
+            // the ops since, so being here costs no round trip of its own.
+            send(response, 200, {
+                who: alive().filter((presence) => presence.participant !== mine.participant),
+                ...(typeof body.seq === "number" ? { ops: since(body.seq) } : {}),
+            });
+            return;
+        }
+        if (url.pathname === "/graview/leave" && request.method === "POST") {
+            const body = (await read(request));
+            if (typeof body.participant === "string") {
+                here = new Map(here);
+                here.delete(body.participant);
+            }
+            send(response, 200, { who: alive() });
+            return;
+        }
+        if (url.pathname === "/graview/health") {
+            send(response, 200, {
+                ...health(store, options.app),
+                // Said by the adapter where it knows, because it is the only thing
+                // that does; `where` is for a caller with a better name for it.
+                where: options.where ?? options.adapter.root ?? scope,
+                adapter: options.adapter.name,
+            });
+            return;
+        }
+        if (url.pathname === "/graview/export") {
+            send(response, 200, exportBundle(store, options.app));
+            return;
+        }
+        if (url.pathname === "/graview/ops" && request.method === "POST") {
+            const body = (await read(request));
+            const calls = body.calls ?? [];
+            const seat = seatOf(request);
+            try {
+                /*
+                 * Through the STORE, under the requester's own seat. The policy
+                 * refuses here exactly what it refuses in the browser — and the
+                 * refusal comes back with the policy's own sentence rather than a
+                 * bare 403, because that sentence is the product.
+                 */
+                const result = body.undo
+                    ? store.undo(body.undo, { author: seat, ...(body.intent ? { intent: body.intent } : {}) })
+                    : store.applyAll(calls, {
+                        author: seat,
+                        ...(body.intent ? { intent: body.intent } : {}),
+                        ...(body.batch ? { batch: body.batch } : {}),
+                    });
+                await opened.flush();
+                send(response, 200, { ops: result.ops, batch: result.batch });
+            }
+            catch (error) {
+                send(response, 409, {
+                    error: error instanceof Error ? error.message : String(error),
+                    refused: true,
+                });
+            }
+            return;
+        }
+        send(response, 404, { error: `Nothing at ${url.pathname}` });
+    }
+    const port = await listen(server, options.port ?? 0);
+    return {
+        store,
+        opened,
+        server,
+        port,
+        url: `http://localhost:${port}`,
+        async close() {
+            await opened.flush();
+            opened.close();
+            await new Promise((done) => server.close(() => done()));
+        },
+    };
+}
+function send(response, status, body) {
+    const text = JSON.stringify(body);
+    response.writeHead(status, { "content-type": "application/json", "content-length": Buffer.byteLength(text) });
+    response.end(text);
+}
+async function read(request) {
+    const chunks = [];
+    for await (const chunk of request)
+        chunks.push(chunk);
+    const text = Buffer.concat(chunks).toString("utf8");
+    return text.length === 0 ? {} : JSON.parse(text);
+}
+function listen(server, port) {
+    return new Promise((ready, fail) => {
+        server.once("error", fail);
+        server.listen(port, () => {
+            const address = server.address();
+            ready(typeof address === "object" && address !== null ? address.port : port);
+        });
+    });
+}
+//# sourceMappingURL=serve.js.map