@heojeongbo/wirestage 0.0.0-stage → 0.1.1

package/dist/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,cAAc,yBAAyB,CAAC"}

package/dist/webrtc.d.ts

@@ -0,0 +1,3 @@
+/** @heojeongbo/wirestage/webrtc — WebRTC data channels. */
+export * from "./features/webrtc/index.js";
+//# sourceMappingURL=webrtc.d.ts.map

package/dist/webrtc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.d.ts","sourceRoot":"","sources":["../src/webrtc.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,4BAA4B,CAAC"}

package/dist/webrtc.js

@@ -0,0 +1,3 @@
+/** @heojeongbo/wirestage/webrtc — WebRTC data channels. */
+export * from "./features/webrtc/index.js";
+//# sourceMappingURL=webrtc.js.map

package/dist/webrtc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.js","sourceRoot":"","sources":["../src/webrtc.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,4BAA4B,CAAC"}

package/dist/websocket.d.ts

@@ -0,0 +1,3 @@
+/** @heojeongbo/wirestage/websocket — WebSockets. */
+export * from "./features/websocket/index.js";
+//# sourceMappingURL=websocket.d.ts.map

package/dist/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,cAAc,+BAA+B,CAAC"}

package/dist/websocket.js

@@ -0,0 +1,3 @@
+/** @heojeongbo/wirestage/websocket — WebSockets. */
+export * from "./features/websocket/index.js";
+//# sourceMappingURL=websocket.js.map

package/dist/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,cAAc,+BAA+B,CAAC"}

package/dist/widgets/stage/index.d.ts

@@ -0,0 +1,3 @@
+export { createStage } from "./lib/create-stage.js";
+export type { AttachOptions, ReportOptions, Stage, StageCore, StageOptions, StageReport, } from "./model/stage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/widgets/stage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/widgets/stage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EACX,aAAa,EACb,aAAa,EACb,KAAK,EACL,SAAS,EACT,YAAY,EACZ,WAAW,GACX,MAAM,kBAAkB,CAAC"}

package/dist/widgets/stage/index.js

@@ -0,0 +1,2 @@
+export { createStage } from "./lib/create-stage.js";
+//# sourceMappingURL=index.js.map

package/dist/widgets/stage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/widgets/stage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/widgets/stage/lib/attached-context.d.ts

@@ -0,0 +1,10 @@
+import type { Attachment } from "../../../entities/plugin/index.js";
+import type { ContextPort } from "../../../shared/api/playwright/index.js";
+/**
+ * An attachment as the stage's engines see it: with the browser context that
+ * plugins are not given.
+ */
+export interface AttachedContext extends Attachment {
+    readonly context: ContextPort;
+}
+//# sourceMappingURL=attached-context.d.ts.map

package/dist/widgets/stage/lib/attached-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attached-context.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/attached-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,UAAU;IAClD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC9B"}

package/dist/widgets/stage/lib/attached-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=attached-context.js.map

package/dist/widgets/stage/lib/attached-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attached-context.js","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/attached-context.ts"],"names":[],"mappings":""}

package/dist/widgets/stage/lib/create-stage.d.ts

@@ -0,0 +1,12 @@
+import type { AnyWirePlugin } from "../../../entities/plugin/index.js";
+import type { Stage, StageOptions } from "../model/stage.js";
+/**
+ * Build a stage: one timeline, the shared services plugins are given, and the
+ * plugins themselves, each mounted as `stage.<name>`.
+ *
+ * The stage is the composition root of everything below it. It is the only
+ * place the routers, the page host and the stream server are constructed, so
+ * a plugin can only ever reach them through its `PluginContext`.
+ */
+export declare function createStage<const Plugins extends readonly AnyWirePlugin[]>(options: StageOptions<Plugins>): Stage<Plugins>;
+//# sourceMappingURL=create-stage.d.ts.map

package/dist/widgets/stage/lib/create-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-stage.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/create-stage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,aAAa,EAIb,MAAM,mCAAmC,CAAC;AAiB3C,OAAO,KAAK,EAAE,KAAK,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAsCxE;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,aAAa,EAAE,EACzE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,GAC5B,KAAK,CAAC,OAAO,CAAC,CA2OhB"}

package/dist/widgets/stage/lib/create-stage.js

@@ -0,0 +1,250 @@
+import { createTimeline } from "../../../entities/frame/index.js";
+import { createStreamServer } from "../../../shared/api/stream-server/index.js";
+import { runAll } from "../../../shared/lib/async/index.js";
+import { createSystemClock } from "../../../shared/lib/clock/index.js";
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+import { createObjectIds, createSequence, randomToken, } from "../../../shared/lib/id/index.js";
+import { createScopedLogger } from "../../../shared/lib/logger/index.js";
+import { createHttpRouter } from "./http-router.js";
+import { createPageHost } from "./page-host.js";
+import { createReads } from "./reads.js";
+import { createSocketRouter } from "./socket-router.js";
+/** Names a plugin may not take: they would shadow the stage's own API. */
+const RESERVED = new Set([
+    "id",
+    "timeline",
+    "attachments",
+    "disposed",
+    "attach",
+    "detach",
+    "pageId",
+    "sync",
+    "frames",
+    "drain",
+    "mark",
+    "since",
+    "between",
+    "waitFor",
+    "report",
+    "dispose",
+]);
+/**
+ * Build a stage: one timeline, the shared services plugins are given, and the
+ * plugins themselves, each mounted as `stage.<name>`.
+ *
+ * The stage is the composition root of everything below it. It is the only
+ * place the routers, the page host and the stream server are constructed, so
+ * a plugin can only ever reach them through its `PluginContext`.
+ */
+export function createStage(options) {
+    const clock = options.clock ?? createSystemClock();
+    const id = randomToken().slice(0, 12);
+    const log = createScopedLogger("Stage");
+    const timeline = createTimeline({
+        clock,
+        capacity: options.capacity,
+        // A subscriber is the test's own code; its failure is its own, and
+        // must not break the route handler or page flush that appended.
+        onListenerError: (error) => log.error("a timeline subscriber threw", {}, error),
+    });
+    const pageId = createObjectIds("p");
+    const contextId = createSequence("c");
+    const streamServer = createStreamServer({
+        ...options.streamServer,
+        log: createScopedLogger("Stream"),
+    });
+    const http = createHttpRouter({
+        timeline,
+        log: createScopedLogger("Http"),
+        streams: streamServer,
+        pageId,
+        correlation: createSequence("x"),
+        clock,
+        timeoutMs: options.pageTimeoutMs ?? 2_000,
+    });
+    const sockets = createSocketRouter({
+        timeline,
+        log: createScopedLogger("Socket"),
+        correlation: createSequence("w"),
+    });
+    const pages = createPageHost({
+        stage: id,
+        log: createScopedLogger("Page"),
+        clock,
+        pageId,
+        flushMs: options.pageFlushMs ?? 25,
+        timeoutMs: options.pageTimeoutMs ?? 2_000,
+    });
+    const attached = new Map();
+    /** Every plugin's runtime, a plugin's own dependencies before it. */
+    const runtimes = [];
+    let disposed = false;
+    let built = false;
+    const sync = async () => {
+        await pages.sync();
+        await http.settle();
+    };
+    const reads = createReads({
+        timeline,
+        clock,
+        sync,
+        wait: {
+            timeout: options.wait?.timeout ?? 5_000,
+            interval: options.wait?.interval ?? 25,
+        },
+    });
+    /**
+     * Undo an attach. One still installing is waited for first: undoing half
+     * of it would leave the rest installed for good. Every step runs even when
+     * one fails: a plugin's bug must not leak a route.
+     */
+    const detachOne = async (context) => {
+        const entry = attached.get(context);
+        if (entry === undefined)
+            return;
+        attached.delete(context);
+        await entry.installing;
+        context.off("close", entry.onClose);
+        const { attachment, view } = entry;
+        await runAll([
+            ...[...entry.runtimes]
+                .reverse()
+                .map((runtime) => () => runtime.detach?.(view)),
+            () => sockets.detach(attachment),
+            () => http.detach(attachment),
+            () => pages.detach(attachment),
+        ]);
+        log.debug("detached", { context: attachment.id });
+    };
+    const core = {
+        id,
+        timeline,
+        get attachments() {
+            return [...attached.values()].map((entry) => entry.view);
+        },
+        get disposed() {
+            return disposed;
+        },
+        async attach(context, attachOptions = {}) {
+            if (disposed)
+                throw new WirestageError("INVALID_STATE", "cannot attach: the stage is disposed");
+            if (attached.has(context))
+                throw new WirestageError("INVALID_STATE", "this context is already attached to the stage");
+            // The context stays with the stage and its engines. A plugin gets its
+            // id, its base URL and a jar that only reads and adds cookies: what
+            // it could do with the context itself would go round the engines.
+            const cookies = Object.freeze({
+                cookies: (urls) => context.cookies(urls),
+                addCookies: (init) => context.addCookies(init),
+            });
+            const view = Object.freeze({
+                id: contextId(),
+                baseURL: attachOptions.baseURL ?? options.baseURL,
+                cookies,
+            });
+            const attachment = { ...view, context };
+            // A closed context takes its routes with it; forgetting it here keeps
+            // the next sync from evaluating in pages that no longer exist.
+            const onClose = () => {
+                detachOne(context).catch((error) => log.debug("detaching a closed context failed", {}, error));
+            };
+            const started = [];
+            const installing = (async () => {
+                await pages.attach(attachment);
+                await http.attach(attachment);
+                await sockets.attach(attachment);
+                for (const runtime of runtimes) {
+                    started.push(runtime);
+                    await runtime.attach?.(view);
+                }
+            })();
+            const entry = {
+                attachment,
+                view,
+                onClose,
+                runtimes: started,
+                installing: installing.then(() => undefined, () => undefined),
+            };
+            attached.set(context, entry);
+            context.on("close", onClose);
+            try {
+                await installing;
+            }
+            catch (error) {
+                // Half-attached is worse than not attached: undo what took, so the
+                // caller can fix the cause and attach this context again.
+                await detachOne(context).catch((secondary) => log.debug("undoing a failed attach failed", {}, secondary));
+                throw error;
+            }
+            if (attached.get(context) !== entry)
+                // Detached, or closed, while it was installing: that detach is
+                // undoing all of it, so this attach did not take.
+                throw new WirestageError("INVALID_STATE", "the context was detached while it was being attached");
+            log.debug("attached", { context: attachment.id });
+            return () => detachOne(context);
+        },
+        async detach(context) {
+            if (context !== undefined)
+                return detachOne(context);
+            await runAll([...attached.keys()].map((each) => () => detachOne(each)));
+        },
+        pageId,
+        sync,
+        ...reads,
+        async dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            await runAll([
+                () => core.detach(),
+                ...[...runtimes].reverse().map((runtime) => () => runtime.dispose?.()),
+                () => streamServer.close(),
+            ]);
+        },
+    };
+    // The services, not the engines behind them: attaching, detaching and
+    // settling are the stage's to do.
+    const services = {
+        http: Object.freeze({ add: http.add }),
+        sockets: Object.freeze({ add: sockets.add, prepare: sockets.prepare }),
+        pages: Object.freeze({
+            register: pages.register,
+            command: pages.command,
+            refresh: pages.refresh,
+            pageId: pages.pageId,
+        }),
+    };
+    /** Set a plugin up, and whatever it builds on first. */
+    const mount = (plugin) => {
+        const context = {
+            name: plugin.name,
+            timeline,
+            clock,
+            log: createScopedLogger(plugin.scope ?? "Plugin"),
+            ...services,
+            baseURL: options.baseURL,
+            attachments: () => core.attachments,
+            sync,
+            waitFor: reads.waitFor,
+            use(inner) {
+                if (built)
+                    throw new WirestageError("INVALID_STATE", `plugin "${plugin.name}" asked for "${inner.name}" after setup; call use() inside setup(), before any context is attached`);
+                return mount(inner).api;
+            },
+        };
+        const runtime = plugin.setup(context);
+        runtimes.push(runtime);
+        return runtime;
+    };
+    const apis = new Map();
+    for (const plugin of options.plugins) {
+        if (RESERVED.has(plugin.name) || apis.has(plugin.name))
+            throw new WirestageError("INVALID_ARGUMENT", RESERVED.has(plugin.name)
+                ? `plugin name "${plugin.name}" is reserved by the stage`
+                : `two plugins are named "${plugin.name}"`);
+        apis.set(plugin.name, mount(plugin).api);
+    }
+    built = true;
+    return Object.assign(core, Object.fromEntries(apis));
+}
+//# sourceMappingURL=create-stage.js.map

package/dist/widgets/stage/lib/create-stage.js.map

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

package/dist/widgets/stage/lib/http-router.d.ts

@@ -0,0 +1,44 @@
+import type { Timeline } from "../../../entities/frame/index.js";
+import type { HttpRouter } from "../../../entities/plugin/index.js";
+import type { PagePort } from "../../../shared/api/playwright/index.js";
+import type { StreamServer } from "../../../shared/api/stream-server/index.js";
+import type { Clock } from "../../../shared/lib/clock/index.js";
+import type { ScopedLogger } from "../../../shared/lib/logger/index.js";
+import type { AttachedContext } from "./attached-context.js";
+export interface HttpRouterDeps {
+    readonly timeline: Timeline;
+    readonly log: ScopedLogger;
+    readonly streams: Pick<StreamServer, "open">;
+    readonly pageId: (page: PagePort) => string;
+    readonly correlation: () => string;
+    readonly clock: Clock;
+    /**
+     * How long the browser may take over what the router waits on: handing
+     * over a passed-through response's body, which a dialog holds back, and
+     * bringing a live stream's request to the stream server.
+     */
+    readonly timeoutMs: number;
+}
+export interface HttpRouterEngine extends HttpRouter {
+    attach(attachment: AttachedContext): Promise<void>;
+    detach(attachment: AttachedContext): Promise<void>;
+    /**
+     * Wait for what is on its way to the timeline: the responses that came
+     * back — reading one is a round trip to the browser, waited on for
+     * `timeoutMs` at most — and the ends of the streams a stub closed.
+     */
+    settle(): Promise<void>;
+}
+/**
+ * Turns HTTP rules into ONE Playwright route per attached context and runs
+ * the chain itself: the newest rule that matches decides, and a `fallback`
+ * hands the request to the next.
+ *
+ * Running the chain here, rather than as one Playwright route per rule, is
+ * what makes a request one exchange however many rules see it: they share a
+ * view and a correlation id, `times` is claimed without an await between the
+ * check and the count, and a rule that passed a request on hears about the
+ * network's answer only when the network really gave one.
+ */
+export declare function createHttpRouter(deps: HttpRouterDeps): HttpRouterEngine;
+//# sourceMappingURL=http-router.d.ts.map

package/dist/widgets/stage/lib/http-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-router.d.ts","sourceRoot":"","sources":["../../../../src/widgets/stage/lib/http-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAIX,UAAU,EAKV,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACX,QAAQ,EAKR,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAEX,YAAY,EAEZ,MAAM,4CAA4C,CAAC;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IACnD,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA+LD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAwrBvE"}