@heojeongbo/wirestage 0.0.0-stage → 0.1.1

package/dist/entities/frame/lib/snapshot.js

@@ -0,0 +1,90 @@
+import { toBase64 } from "../../../shared/lib/bytes/index.js";
+/**
+ * A JSON-safe copy of `frames`, with payloads cut at `maxBytes` and, given a
+ * `limit`, only the newest frames kept: a report is read from its end.
+ */
+export function snapshotFrames(frames, evicted, options = {}) {
+    const maxBytes = options.maxBytes ?? 4096;
+    const kept = options.limit === undefined || frames.length <= options.limit
+        ? frames
+        : frames.slice(frames.length - options.limit);
+    return {
+        evicted,
+        omitted: frames.length - kept.length,
+        frames: kept.map((frame) => {
+            const base = {
+                seq: frame.seq,
+                at: frame.at,
+                protocol: frame.protocol,
+                kind: frame.kind,
+                direction: frame.direction,
+                endpoint: frame.endpoint,
+                source: frame.source,
+                ...(frame.page === undefined ? {} : { page: frame.page }),
+                ...(frame.context === undefined ? {} : { context: frame.context }),
+                ...(frame.correlation === undefined
+                    ? {}
+                    : { correlation: frame.correlation }),
+                ...(Object.keys(frame.meta).length === 0
+                    ? {}
+                    : { meta: jsonSafe(frame.meta) }),
+            };
+            if (frame.payload.empty)
+                return base;
+            const bytes = frame.payload.bytes();
+            return {
+                ...base,
+                size: bytes.byteLength,
+                data: toBase64(bytes.subarray(0, maxBytes)),
+                ...(bytes.byteLength > maxBytes ? { truncated: true } : {}),
+            };
+        }),
+    };
+}
+/**
+ * One line per frame: `#12  +3.2ms  connect  out request  pkg.Svc/Method  42B`.
+ * Times are relative to the first frame listed, which is what a reader of a
+ * failure report compares.
+ */
+export function formatFrames(frames, options = {}) {
+    const limit = options.limit ?? 200;
+    // Not `slice(-limit)`: a limit of 0 would be `slice(-0)`, every frame.
+    const shown = frames.length > limit ? frames.slice(frames.length - limit) : frames;
+    const origin = shown[0]?.at ?? 0;
+    const lines = shown.map((frame) => {
+        const size = frame.payload.empty
+            ? ""
+            : `  ${frame.payload.bytes().byteLength}B`;
+        const page = frame.page === undefined ? "" : `  ${frame.page}`;
+        return `#${frame.seq}  +${(frame.at - origin).toFixed(1)}ms  ${frame.protocol}  ${frame.direction} ${frame.kind}  ${frame.endpoint}${page}${size}`;
+    });
+    if (frames.length > limit)
+        lines.unshift(`… ${frames.length - limit} earlier frames not shown`);
+    return lines.join("\n");
+}
+/**
+ * Make `meta` survive `JSON.stringify`: a bigint (protobuf int64) or a cycle
+ * would otherwise throw while writing the report — at the exact moment a test
+ * has already failed and the report is the only evidence.
+ */
+function jsonSafe(meta) {
+    // The objects on the path from the root to the value being written. Only
+    // those make a cycle: an object met again elsewhere is merely shared.
+    const ancestors = [];
+    return JSON.parse(JSON.stringify(meta, function (_key, value) {
+        if (typeof value === "bigint")
+            return value.toString();
+        if (value instanceof Uint8Array)
+            return toBase64(value);
+        if (typeof value !== "object" || value === null)
+            return value;
+        // `this` holds `value`: whatever was above it is finished.
+        while (ancestors.length > 0 && ancestors.at(-1) !== this)
+            ancestors.pop();
+        if (ancestors.includes(value))
+            return "[circular]";
+        ancestors.push(value);
+        return value;
+    }));
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/entities/frame/lib/snapshot.js.map

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

package/dist/entities/frame/lib/timeline.d.ts

@@ -0,0 +1,23 @@
+import type { Clock } from "../../../shared/lib/clock/index.js";
+import type { Timeline } from "../model/frame.js";
+export interface TimelineOptions {
+    readonly clock: Clock;
+    /**
+     * Frames kept before the oldest are dropped. A 60 Hz data channel makes
+     * 3,600 frames a minute; the default holds a long test without letting a
+     * soak run grow without bound.
+     */
+    readonly capacity?: number;
+    /**
+     * Told when a subscriber throws. By default the first such error is
+     * thrown to whoever appended the frame, once every subscriber has run.
+     */
+    readonly onListenerError?: (error: unknown) => void;
+}
+/**
+ * The append-only log every protocol writes to. Order is arrival order (`seq`),
+ * not timestamp order: the stage flushes page buffers before every read, so
+ * arrival order is also the order things happened in.
+ */
+export declare function createTimeline(options: TimelineOptions): Timeline;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/entities/frame/lib/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../../src/entities/frame/lib/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,KAAK,EAIX,QAAQ,EAER,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CA+GjE"}

package/dist/entities/frame/lib/timeline.js

@@ -0,0 +1,122 @@
+import { WirestageError } from "../../../shared/lib/errors/index.js";
+import { compileFilter } from "./filter.js";
+import { createPayload } from "./payload.js";
+import { formatFrames, snapshotFrames } from "./snapshot.js";
+const DEFAULT_CAPACITY = 100_000;
+/**
+ * The append-only log every protocol writes to. Order is arrival order (`seq`),
+ * not timestamp order: the stage flushes page buffers before every read, so
+ * arrival order is also the order things happened in.
+ */
+export function createTimeline(options) {
+    const capacity = options.capacity ?? DEFAULT_CAPACITY;
+    if (!Number.isInteger(capacity) || capacity < 1)
+        throw new WirestageError("INVALID_ARGUMENT", `timeline capacity must be a positive integer, got ${capacity}`);
+    let frames = [];
+    let evicted = 0;
+    let seq = 0;
+    const listeners = new Set();
+    const query = (filter) => {
+        if (filter === undefined)
+            return frames.slice();
+        return frames.filter(compileFilter(filter));
+    };
+    /** Index of the first frame with `seq` greater than `position`. */
+    const indexAfter = (position) => {
+        const first = frames[0];
+        if (first === undefined)
+            return 0;
+        return Math.max(0, position - first.seq + 1);
+    };
+    return {
+        append(init) {
+            const frame = {
+                seq: ++seq,
+                at: init.at ?? options.clock.now(),
+                protocol: init.protocol,
+                kind: init.kind,
+                direction: init.direction,
+                endpoint: init.endpoint,
+                source: init.source,
+                payload: createPayload(init.data),
+                value: init.value,
+                meta: init.meta ?? {},
+                page: init.page,
+                context: init.context,
+                correlation: init.correlation,
+            };
+            frames.push(frame);
+            if (frames.length > capacity) {
+                // Drop a tenth at once: shifting one frame per append would make a
+                // full timeline O(n) per frame.
+                const drop = Math.max(1, Math.floor(capacity / 10));
+                frames = frames.slice(drop);
+                evicted += drop;
+            }
+            // The frame is on the timeline whatever a subscriber does with it,
+            // and one that throws does not starve the rest.
+            const failures = [];
+            for (const listener of listeners) {
+                try {
+                    listener(frame);
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+            }
+            if (failures.length > 0) {
+                if (options.onListenerError === undefined)
+                    throw failures[0];
+                for (const failure of failures)
+                    options.onListenerError(failure);
+            }
+            return frame;
+        },
+        frames: query,
+        last(filter) {
+            const match = compileFilter(filter);
+            return frames.findLast(match);
+        },
+        marker(name) {
+            return frames.findLast((f) => f.kind === "marker" && f.endpoint === name);
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        cursor() {
+            let position = seq;
+            return {
+                take(filter) {
+                    const fresh = frames.slice(indexAfter(position));
+                    position = seq;
+                    return filter === undefined
+                        ? fresh
+                        : fresh.filter(compileFilter(filter));
+                },
+                get position() {
+                    return position;
+                },
+            };
+        },
+        clear() {
+            frames = [];
+        },
+        snapshot(filter, snapshotOptions) {
+            return snapshotFrames(query(filter), evicted, snapshotOptions);
+        },
+        format(filter, formatOptions) {
+            return formatFrames(query(filter), formatOptions);
+        },
+        get size() {
+            return frames.length;
+        },
+        get evicted() {
+            return evicted;
+        },
+        capacity,
+    };
+}
+//# sourceMappingURL=timeline.js.map

package/dist/entities/frame/lib/timeline.js.map

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

package/dist/entities/frame/model/frame.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Which way a frame travelled, from the page's point of view: `out` left the
+ * page (a request, a sent message), `in` reached it. Markers and lifecycle
+ * events travel nowhere.
+ */
+export type Direction = "out" | "in" | "none";
+export type FrameKind = 
+/** The opening half of an exchange: an HTTP request, an RPC's request message. */
+"request"
+/** The closing half: an HTTP response, an RPC's status. */
+ | "response"
+/** One message on a stream or channel. */
+ | "message"
+/** One server-sent event. */
+ | "event"
+/** A named point the test placed on the timeline. */
+ | "marker"
+/** Something went wrong on purpose or by accident: an abort, a drop, a cut. */
+ | "fault"
+/** A channel or connection opened or closed. */
+ | "lifecycle";
+/**
+ * Who produced what the frame carries. With `direction` it says who was
+ * talking to whom: `out` from `page` is the app speaking, `in` from `stub`
+ * is a stub answering it, `in` from `network` the real backend.
+ */
+export type FrameSource = 
+/** The app in the browser: its requests, the messages it sends. */
+"page"
+/** The real backend, a real remote peer, or a client outside the browser. */
+ | "network"
+/** A stub: its responses, its messages, the faults it injects. */
+ | "stub"
+/** The test itself: markers, drive-client requests, injected messages. */
+ | "test"
+/** A fake served on a port of its own (`serve()`). */
+ | "server";
+/**
+ * A payload as given: bytes, text, or a thunk that encodes on demand. The thunk
+ * keeps a high-rate stub from serializing every message twice when nobody ever
+ * reads the bytes back.
+ */
+export type PayloadInput = Uint8Array | string | (() => Uint8Array);
+export interface Payload {
+    /** True when the frame carries no payload at all. */
+    readonly empty: boolean;
+    bytes(): Uint8Array;
+    /** UTF-8 text of the bytes, or the text as given. */
+    text(): string;
+    /** `JSON.parse(text())`. Throws on invalid JSON. */
+    json<T = unknown>(): T;
+    /**
+     * Decode with `decoder`, cached per decoder: asserting on the same frame
+     * from three helpers decodes it once.
+     */
+    decode<T>(decoder: (bytes: Uint8Array) => T): T;
+}
+export interface FrameInit {
+    /** The protocol plugin's name: `webrtc`, `connect`, `rest`, ... */
+    readonly protocol: string;
+    readonly kind: FrameKind;
+    readonly direction: Direction;
+    /**
+     * What the frame is about, in the protocol's own terms: a URL path, an RPC
+     * (`pkg.Service/Method`), a channel label, a WebSocket URL, a marker name.
+     */
+    readonly endpoint: string;
+    readonly source: FrameSource;
+    /** Epoch milliseconds. Defaults to the stage clock's now. */
+    readonly at?: number;
+    readonly data?: PayloadInput;
+    /** An already-decoded form of the payload, e.g. a protobuf message. */
+    readonly value?: unknown;
+    readonly meta?: Readonly<Record<string, unknown>>;
+    /** The page the frame belongs to (`p1`, ...). */
+    readonly page?: string;
+    /** The browser context the frame belongs to (`c1`, ...). */
+    readonly context?: string;
+    /** Links the frames of one exchange: a request, its messages, its response. */
+    readonly correlation?: string;
+}
+export interface Frame {
+    /** Arrival order on the timeline, starting at 1. The order to trust. */
+    readonly seq: number;
+    /** Epoch milliseconds. Informational: page and Node clocks differ slightly. */
+    readonly at: number;
+    readonly protocol: string;
+    readonly kind: FrameKind;
+    readonly direction: Direction;
+    readonly endpoint: string;
+    readonly source: FrameSource;
+    readonly payload: Payload;
+    readonly value: unknown;
+    readonly meta: Readonly<Record<string, unknown>>;
+    readonly page: string | undefined;
+    readonly context: string | undefined;
+    readonly correlation: string | undefined;
+}
+export interface FrameFilter {
+    readonly protocol?: string | readonly string[];
+    readonly kind?: FrameKind | readonly FrameKind[];
+    readonly direction?: Direction;
+    /** Exact match, or a RegExp tested against the endpoint. */
+    readonly endpoint?: string | RegExp;
+    readonly source?: FrameSource;
+    readonly page?: string;
+    readonly context?: string;
+    readonly correlation?: string;
+    /** Only frames whose `seq` is greater. */
+    readonly after?: number;
+    /** Any further condition. Runs last, so cheap fields filter first. */
+    readonly where?: (frame: Frame) => boolean;
+}
+/** A consumer's position on the timeline: each `take` returns what is new. */
+export interface TimelineCursor {
+    /**
+     * Frames appended since the previous `take` that match `filter`. The
+     * cursor moves past ALL of them, matching or not: "what happened since I
+     * last looked", narrowed.
+     */
+    take(filter?: FrameFilter): Frame[];
+    /** The `seq` the cursor has read up to. */
+    readonly position: number;
+}
+export interface SnapshotFrame {
+    readonly seq: number;
+    readonly at: number;
+    readonly protocol: string;
+    readonly kind: FrameKind;
+    readonly direction: Direction;
+    readonly endpoint: string;
+    readonly source: FrameSource;
+    readonly page?: string;
+    readonly context?: string;
+    readonly correlation?: string;
+    readonly meta?: Readonly<Record<string, unknown>>;
+    /** Base64 of the payload, cut at the snapshot's byte limit. */
+    readonly data?: string;
+    readonly size?: number;
+    readonly truncated?: boolean;
+}
+/** A JSON-safe copy of the timeline, for a test report attachment. */
+export interface TimelineSnapshot {
+    readonly frames: readonly SnapshotFrame[];
+    /** Frames dropped from the front because the timeline hit its capacity. */
+    readonly evicted: number;
+    /** Earlier matching frames left out by the snapshot's `limit`. */
+    readonly omitted: number;
+}
+export interface SnapshotOptions {
+    /** Bytes of payload kept per frame. Default 4096. */
+    readonly maxBytes?: number;
+    /** Frames kept, counting back from the newest. Default: all of them. */
+    readonly limit?: number;
+}
+export interface Timeline {
+    /** Append a frame and notify subscribers. The only way frames enter. */
+    append(init: FrameInit): Frame;
+    frames(filter?: FrameFilter): Frame[];
+    last(filter?: FrameFilter): Frame | undefined;
+    /** The most recent marker with this name. */
+    marker(name: string): Frame | undefined;
+    /**
+     * Called for every appended frame, synchronously, after it is on the
+     * timeline. A listener that throws does not stop the others. Returns
+     * unsubscribe.
+     */
+    subscribe(listener: (frame: Frame) => void): () => void;
+    /** A new cursor starting at the current end. */
+    cursor(): TimelineCursor;
+    /** Drop every frame. `seq` keeps counting; `evicted` is left alone. */
+    clear(): void;
+    snapshot(filter?: FrameFilter, options?: SnapshotOptions): TimelineSnapshot;
+    /** A human-readable listing, one line per frame. */
+    format(filter?: FrameFilter, options?: {
+        readonly limit?: number;
+    }): string;
+    readonly size: number;
+    readonly evicted: number;
+    readonly capacity: number;
+}
+//# sourceMappingURL=frame.d.ts.map

package/dist/entities/frame/model/frame.d.ts.map

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

package/dist/entities/frame/model/frame.js

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

package/dist/entities/frame/model/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../../../src/entities/frame/model/frame.ts"],"names":[],"mappings":""}

package/dist/entities/plugin/index.d.ts

@@ -0,0 +1,9 @@
+export { definePlugin } from "./lib/define-plugin.js";
+export { named } from "./lib/named.js";
+export type { Attachment } from "./model/attachment.js";
+export type { AbortErrorCode, HttpOutcome, HttpRequestView, HttpRouter, HttpRule, HttpRuleHandle, PassthroughResponse, } from "./model/http.js";
+export type { PageEntry, PageHost, PageInstaller, PageModule, PageModuleEnv, PageSource, } from "./model/page.js";
+export type { AnyWirePlugin, PluginApis, PluginContext, PluginRuntime, WaitForOptions, WirePlugin, } from "./model/plugin.js";
+export type { SocketPeer, SocketRouter, SocketRule, SocketRuleHandle, SocketView, } from "./model/socket.js";
+export type { ResponseStream, StreamEnd } from "./model/stream.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/entities/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/entities/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EACX,cAAc,EACd,WAAW,EACX,eAAe,EACf,UAAU,EACV,QAAQ,EACR,cAAc,EACd,mBAAmB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,SAAS,EACT,QAAQ,EACR,aAAa,EACb,UAAU,EACV,aAAa,EACb,UAAU,GACV,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,GACV,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACX,UAAU,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,UAAU,GACV,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/entities/plugin/index.js

@@ -0,0 +1,3 @@
+export { definePlugin } from "./lib/define-plugin.js";
+export { named } from "./lib/named.js";
+//# sourceMappingURL=index.js.map

package/dist/entities/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/entities/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/entities/plugin/lib/define-plugin.d.ts

@@ -0,0 +1,8 @@
+import type { WirePlugin } from "../model/plugin.js";
+/**
+ * Identity, for inference: it keeps the plugin's `name` a literal type, so
+ * `createStage({ plugins: [myPlugin()] })` types `stage.myPlugin` without the
+ * author writing the generic arguments out.
+ */
+export declare function definePlugin<const Name extends string, Api>(plugin: WirePlugin<Name, Api>): WirePlugin<Name, Api>;
+//# sourceMappingURL=define-plugin.d.ts.map

package/dist/entities/plugin/lib/define-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-plugin.d.ts","sourceRoot":"","sources":["../../../../src/entities/plugin/lib/define-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,EAC1D,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,GAC3B,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAEvB"}

package/dist/entities/plugin/lib/define-plugin.js

@@ -0,0 +1,9 @@
+/**
+ * Identity, for inference: it keeps the plugin's `name` a literal type, so
+ * `createStage({ plugins: [myPlugin()] })` types `stage.myPlugin` without the
+ * author writing the generic arguments out.
+ */
+export function definePlugin(plugin) {
+    return plugin;
+}
+//# sourceMappingURL=define-plugin.js.map

package/dist/entities/plugin/lib/define-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-plugin.js","sourceRoot":"","sources":["../../../../src/entities/plugin/lib/define-plugin.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC3B,MAA6B;IAE7B,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/entities/plugin/lib/named.d.ts

@@ -0,0 +1,10 @@
+import type { WirePlugin } from "../model/plugin.js";
+/**
+ * The same plugin under another name: mounted as `stage.<name>`, and
+ * recording its frames under that name. What lets one protocol run twice —
+ * two backends, two sets of channels — with each instance's traffic apart:
+ *
+ *     plugins: [rest({ baseURL: "/api" }), named("billing", rest({ baseURL: "https://billing.test" }))]
+ */
+export declare function named<const Name extends string, Api>(name: Name, plugin: WirePlugin<string, Api>): WirePlugin<Name, Api>;
+//# sourceMappingURL=named.d.ts.map

package/dist/entities/plugin/lib/named.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.d.ts","sourceRoot":"","sources":["../../../../src/entities/plugin/lib/named.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,EACnD,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAQvB"}

package/dist/entities/plugin/lib/named.js

@@ -0,0 +1,17 @@
+/**
+ * The same plugin under another name: mounted as `stage.<name>`, and
+ * recording its frames under that name. What lets one protocol run twice —
+ * two backends, two sets of channels — with each instance's traffic apart:
+ *
+ *     plugins: [rest({ baseURL: "/api" }), named("billing", rest({ baseURL: "https://billing.test" }))]
+ */
+export function named(name, plugin) {
+    return {
+        name,
+        scope: plugin.scope,
+        // Called on the plugin, not copied off it: a plugin written as a class
+        // has `setup` on its prototype, which a spread leaves behind.
+        setup: (context) => plugin.setup(context),
+    };
+}
+//# sourceMappingURL=named.js.map

package/dist/entities/plugin/lib/named.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.js","sourceRoot":"","sources":["../../../../src/entities/plugin/lib/named.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CACpB,IAAU,EACV,MAA+B;IAE/B,OAAO;QACN,IAAI;QACJ,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,uEAAuE;QACvE,8DAA8D;QAC9D,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;KACzC,CAAC;AACH,CAAC"}

package/dist/entities/plugin/model/attachment.d.ts

@@ -0,0 +1,18 @@
+import type { CookieJarPort } from "../../../shared/api/playwright/index.js";
+/**
+ * One browser context the stage is attached to, as a plugin sees it: a
+ * frozen view, not the context. The context stays with the stage, and a
+ * plugin reaches the browser through the services of its `PluginContext`.
+ */
+export interface Attachment {
+    /** `c1`, `c2`, ... — what frames name in their `context` field. */
+    readonly id: string;
+    /** The context's base URL, when the caller supplied one. */
+    readonly baseURL: string | undefined;
+    /**
+     * The context's cookie jar, for a client that calls as the signed-in
+     * page: reads and adds go to the context, and nothing else does.
+     */
+    readonly cookies: CookieJarPort;
+}
+//# sourceMappingURL=attachment.d.ts.map

package/dist/entities/plugin/model/attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../../../src/entities/plugin/model/attachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CAChC"}

package/dist/entities/plugin/model/attachment.js

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

package/dist/entities/plugin/model/attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../../../src/entities/plugin/model/attachment.ts"],"names":[],"mappings":""}