reactor-effect-client 0.7.1 → 0.8.0

package/dist/internal/session/tracks.js

@@ -0,0 +1,166 @@
+/**
+ * A session's tracks: pausing and resuming received ones, publishing to
+ * sent ones, the sender bitrate, and the media a host exposes. One operation
+ * runs per track at a time, on the generation it started on.
+ */
+import * as Cause from "effect/Cause";
+import * as Deferred from "effect/Deferred";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Ref from "effect/Ref";
+import * as SubscriptionRef from "effect/SubscriptionRef";
+import { ReactorError } from "../../ReactorError.js";
+import * as Wire from "../wire.js";
+import { excluding, failureOr, including, timedOut } from "./model.js";
+import { unexpected } from "./requests.js";
+const unsupported = (message) => ReactorError.fromCode("UnsupportedCapability", message, { outcome: "not-submitted" });
+export const make = ({ core, generation, requests, }) => {
+    const { settings, state } = core;
+    const { current, currentReady, guard, fail, fenced } = generation;
+    const { notification, controlRequest } = requests;
+    /** `body` on a negotiated track of `expected`, or of the ready generation; one per track. */
+    const trackOperation = (name, body, expected) => Effect.acquireUseRelease(Effect.gen(function* () {
+        const c = expected ?? (yield* currentReady).c;
+        yield* current(c);
+        const link = yield* Ref.get(c.link);
+        const track = link.negotiated?.descriptor.capabilities.tracks.find((t) => t.name === name);
+        if (track === undefined)
+            return yield* ReactorError.fromCode("InvalidState", `unknown track: ${name}`);
+        const free = yield* Ref.modify(c.link, (held) => held.busy.has(name)
+            ? [false, held]
+            : [true, { ...held, busy: including(name)(held.busy) }]);
+        if (!free)
+            return yield* ReactorError.fromCode("InvalidState", `another track operation is in flight: ${name}`);
+        return { c, track };
+    }), ({ c, track }) => guard(c, body(c, track)), ({ c }) => Ref.update(c.link, (link) => ({ ...link, busy: excluding(name)(link.busy) })));
+    const setTrackActive = (name, active, expected) => trackOperation(name, (c) => c.peer.direction(name, active).pipe(Effect.andThen(Ref.update(c.link, (link) => ({
+        ...link,
+        paused: (active ? excluding(name) : including(name))(link.paused),
+    }))), Effect.andThen(notification(c, active
+        ? { case: "resumeTrack", value: { name } }
+        : { case: "pauseTrack", value: { name } }))), expected);
+    /**
+     * A platform track replacement cannot be cancelled. Recording its owner is
+     * masked, and an abandoned wait retires the generation so a late
+     * replacement cannot race another sender operation.
+     */
+    const replaceSender = (c, name, source) => Effect.uninterruptibleMask((restore) => Effect.gen(function* () {
+        const media = c.peer.media;
+        if (media._tag !== "Tracks")
+            return yield* unsupported("this peer publishes no tracks");
+        yield* current(c);
+        const clone = source === null ? null : source.clone();
+        const invoked = yield* Ref.make(false);
+        const expired = yield* Ref.make(false);
+        yield* restore(current(c).pipe(Effect.andThen(Ref.set(invoked, true)), Effect.andThen(media.replace(name, clone)), Effect.timeoutOrElse({
+            duration: settings.replyTimeout,
+            orElse: () => Ref.set(expired, true).pipe(Effect.andThen(Effect.fail(ReactorError.fromCode("Timeout", "sender replacement deadline; generation retired", { operation: name, outcome: "unknown" })))),
+        }))).pipe(Effect.onExit((exit) => Exit.isSuccess(exit)
+            ? Effect.void
+            : Effect.gen(function* () {
+                clone?.stop();
+                const deadlined = yield* Ref.get(expired);
+                if ((yield* Ref.get(invoked)) && (deadlined || Cause.hasInterrupts(exit.cause)))
+                    yield* fail(c, ReactorError.fromCode(deadlined ? "Timeout" : "Disconnected", "sender replacement abandoned; reconnect before reusing the publication", { operation: name, outcome: "unknown" }));
+            })));
+        const live = yield* Effect.exit(current(c));
+        if (Exit.isFailure(live)) {
+            clone?.stop();
+            return yield* live;
+        }
+        const previous = yield* Ref.modify(c.link, (link) => {
+            const sending = new Map(link.sending);
+            const before = sending.get(name);
+            if (clone === null)
+                sending.delete(name);
+            else
+                sending.set(name, clone);
+            return [before, { ...link, sending }];
+        });
+        previous?.stop();
+    }));
+    const publishTrack = (name, source, expected) => trackOperation(name, Effect.fnUntraced(function* (c, track) {
+        if (track.direction !== "sendonly" ||
+            source.kind !== track.kind ||
+            source.readyState !== "live")
+            return yield* ReactorError.fromCode("InvalidState", "publish requires a live matching input track");
+        if (!(yield* Ref.get(c.link)).claimed.has(name)) {
+            const reply = yield* controlRequest("publish_track", { case: "publishTrack", value: { name } }, c);
+            if (reply._tag !== "TrackPublished" || reply.name !== name)
+                return yield* unexpected("publisher claim reply mismatch");
+            yield* Ref.update(c.link, (link) => ({
+                ...link,
+                claimed: including(name)(link.claimed),
+            }));
+        }
+        yield* replaceSender(c, name, source);
+    }), expected);
+    const unpublishTrack = (name, expected) => trackOperation(name, (c) => replaceSender(c, name, null).pipe(Effect.andThen(notification(c, { case: "unpublishTrack", value: { name } })), Effect.andThen(Ref.update(c.link, (link) => ({
+        ...link,
+        claimed: excluding(name)(link.claimed),
+    })))), expected);
+    const setMaxBitrate = (name, bitsPerSecond, expected) => trackOperation(name, (c) => c.peer.maxBitrate(name, bitsPerSecond).pipe(Effect.andThen(SubscriptionRef.update(state, (session) => ({
+        ...session,
+        bitrates: new Map(session.bitrates).set(name, bitsPerSecond),
+    })))), expected);
+    /** Closing's last notifications: an unpublish for every track `c` claimed. */
+    const releasePublications = Effect.fnUntraced(function* (c) {
+        const submitted = [];
+        const errors = [];
+        if (c === undefined)
+            return { submitted, errors };
+        const link = yield* Ref.get(c.link);
+        if (link.failure !== undefined)
+            return { submitted, errors };
+        for (const name of link.claimed) {
+            // Closing has fenced ordinary requests; these are the last notifications.
+            const sent = yield* Effect.exit(Wire.encode(Wire.ControlClientMessageSchema)({
+                kind: Wire.MessageKind.NOTIFICATION,
+                payload: { case: "unpublishTrack", value: { name } },
+            }).pipe(Effect.flatMap((bytes) => c.peer.send("control", bytes)), Effect.timeoutOrElse({
+                duration: Duration.min(Duration.seconds(1), settings.replyTimeout),
+                orElse: timedOut("close unpublish"),
+            })));
+            if (Exit.isSuccess(sent))
+                submitted.push(name);
+            else
+                errors.push(failureOr(() => ReactorError.fromCode("Shutdown", "publication cleanup failed", {
+                    detail: sent.cause,
+                }))(sent.cause));
+        }
+        return { submitted, errors };
+    });
+    const decoded = Effect.gen(function* () {
+        const { c, negotiated } = yield* currentReady;
+        const media = c.peer.media;
+        if (media._tag !== "Decoded")
+            return yield* unsupported("this peer has no decoded media");
+        return {
+            generation: c.generation,
+            tracks: negotiated.descriptor.capabilities.tracks,
+            retired: Deferred.await(c.failed),
+            video: (name) => fenced(c, media.video(name)),
+            audio: (name) => fenced(c, media.audio(name)),
+            pressure: media.pressure,
+        };
+    });
+    const tracks = Effect.gen(function* () {
+        const { c, negotiated } = yield* currentReady;
+        const media = c.peer.media;
+        if (media._tag !== "Tracks")
+            return yield* unsupported("this peer has no platform tracks");
+        return {
+            generation: c.generation,
+            tracks: negotiated.descriptor.capabilities.tracks,
+            retired: Deferred.await(c.failed),
+            track: (name) => current(c).pipe(Effect.andThen(media.lease(name))),
+            publish: (name, source) => publishTrack(name, source, c),
+            unpublish: (name) => unpublishTrack(name, c),
+            setTrackActive: (name, active) => setTrackActive(name, active, c),
+            setMaxBitrate: (name, bits) => setMaxBitrate(name, bits, c),
+        };
+    });
+    return { setTrackActive, releasePublications, decoded, tracks };
+};
+//# sourceMappingURL=tracks.js.map

package/dist/internal/session/tracks.js.map

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

package/dist/internal/session/upload.d.ts

@@ -0,0 +1,21 @@
+/**
+ * An upload: a slot from the coordinator, the bytes to its presigned URL,
+ * then the notification that names the file to the model. How far it got is
+ * the evidence a failure carries and the event observers see.
+ */
+import * as Effect from "effect/Effect";
+import { ReactorError } from "../../ReactorError.js";
+import type { UploadOptions, UploadReference } from "../../Session.js";
+import type { Generation } from "./generation.js";
+import type { Core } from "./model.js";
+import type { Requests } from "./requests.js";
+export declare const make: ({ core, generation, requests, }: {
+    readonly core: Core;
+    readonly generation: Generation;
+    readonly requests: Requests;
+}) => (name: string, mimeType: string, bytes: Uint8Array<ArrayBufferLike>, options?: UploadOptions | undefined) => Effect.Effect<{
+    file: UploadReference;
+    transfer: "confirmed";
+    notification: "submitted";
+}, ReactorError, never>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/internal/session/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/internal/session/upload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAA4B,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,eAAO,MAAM,IAAI,oCAId;IACD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;;;;uBA8FA,CAAC"}

package/dist/internal/session/upload.js

@@ -0,0 +1,68 @@
+/**
+ * An upload: a slot from the coordinator, the bytes to its presigned URL,
+ * then the notification that names the file to the model. How far it got is
+ * the evidence a failure carries and the event observers see.
+ */
+import * as Effect from "effect/Effect";
+import * as Ref from "effect/Ref";
+import * as SubscriptionRef from "effect/SubscriptionRef";
+import { ReactorError } from "../../ReactorError.js";
+import * as Deadline from "../deadline.js";
+import { isKnown, timedOut } from "./model.js";
+export const make = ({ core, generation, requests, }) => {
+    const { settings, signaling, state, publish } = core;
+    const { currentReady, guard } = generation;
+    return Effect.fnUntraced(function* (name, mimeType, bytes, options = {}) {
+        const progress = yield* Ref.make({
+            allocation: "not-requested",
+            transfer: "not-requested",
+            notification: "not-submitted",
+        });
+        const reach = (patch) => Ref.update(progress, (p) => ({ ...p, ...patch }));
+        const operation = Effect.gen(function* () {
+            const { c } = yield* currentReady;
+            const known = (yield* SubscriptionRef.get(state)).remote;
+            if (!isKnown(known))
+                return yield* ReactorError.fromCode("InvalidState", "no known session id");
+            if (name.length === 0 ||
+                mimeType.length === 0 ||
+                bytes.byteLength < 1 ||
+                bytes.byteLength > settings.maxUploadBytes)
+                return yield* ReactorError.fromCode("InvalidInput", `an upload needs a name, a MIME type and 1..${String(settings.maxUploadBytes)} bytes`, { outcome: "not-submitted" });
+            const copy = new Uint8Array(bytes);
+            yield* reach({ allocation: "unknown" });
+            const slot = yield* guard(c, signaling.allocateUpload(known.id, name, mimeType, copy.length));
+            const file = {
+                uploadId: slot.presigned_id,
+                name,
+                mimeType,
+                size: BigInt(copy.length),
+            };
+            yield* reach({ allocation: "confirmed", file, transfer: "unknown" });
+            yield* guard(c, signaling.putUpload(slot, copy, mimeType));
+            yield* reach({ transfer: "confirmed", notification: "unknown" });
+            yield* requests
+                .notification(c, { case: "fileUploaded", value: file })
+                .pipe(Effect.tapError((error) => error.context.outcome === "not-submitted"
+                ? reach({ notification: "not-submitted" })
+                : Effect.void));
+            yield* reach({ notification: "submitted" });
+            return { file, transfer: "confirmed", notification: "submitted" };
+        });
+        const wait = yield* Deadline.decode("uploadTimeout")(options.uploadTimeout ?? settings.uploadTimeout);
+        return yield* operation.pipe(Effect.timeoutOrElse({ duration: wait, orElse: timedOut("upload") }), Effect.catch((error) => Ref.get(progress).pipe(Effect.flatMap((reached) => Effect.fail(ReactorError.fromCode("Upload", error.message, {
+            ...error.context,
+            operation: "upload",
+            detail: { cause: error, progress: reached },
+        }))))), Effect.ensuring(Ref.get(progress).pipe(Effect.flatMap((reached) => publish({ _tag: "Upload", progress: reached })))));
+    }, 
+    // The MIME type and size only: never the name or the bytes.
+    Effect.withSpan("Session.upload", (_name, mimeType, bytes) => ({
+        kind: "client",
+        attributes: {
+            "reactor.upload.mime_type": mimeType,
+            "reactor.upload.size": bytes.byteLength,
+        },
+    }), { captureStackTrace: false }));
+};
+//# sourceMappingURL=upload.js.map

package/dist/internal/session/upload.js.map

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

package/dist/internal/session.d.ts

@@ -0,0 +1,66 @@
+import * as Effect from "effect/Effect";
+import type { Coordinator, Tokens } from "../Coordinator.js";
+import type { PeerFactory } from "../Peer.js";
+import { ReactorError } from "../ReactorError.js";
+import type { CloseReport, Session } from "../Session.js";
+import type { Intent, Settings } from "./session/model.js";
+export type { Intent, Settings } from "./session/model.js";
+export interface Handle {
+    /** The session's public value, once its id is known. */
+    readonly session: (id: string) => Session;
+    /** Allocates, or identifies the attached session, without connecting. */
+    readonly allocate: Effect.Effect<string, ReactorError>;
+    readonly connect: Effect.Effect<void, ReactorError>;
+    readonly close: Effect.Effect<CloseReport>;
+}
+export declare const make: (input: {
+    readonly intent: Intent;
+    readonly coordinator: Coordinator["Service"];
+    /** Where the session's tokens come from; none sends no credential. */
+    readonly tokens: (Pick<Tokens, "bind"> & Partial<Pick<Tokens, "create">>) | undefined;
+    /** Resume receive-only tracks as each connection becomes ready; Reactor sends no media until then. */
+    readonly resumeTracks: boolean;
+    readonly peers: PeerFactory["Service"];
+    readonly settings: Settings;
+}) => Effect.Effect<{
+    session: (id: string) => Session;
+    allocate: Effect.Effect<string, ReactorError, never>;
+    connect: Effect.Effect<void, ReactorError, never>;
+    close: Effect.Effect<{
+        readonly localClosed: boolean;
+        readonly allocation: "known" | "none" | "unknown";
+        readonly ownership?: "attached" | "owned";
+        readonly sessionId?: string;
+        readonly remote: {
+            readonly attempted: boolean;
+            readonly responseReceived: boolean;
+            readonly confirmed: boolean;
+            readonly evidence: "absent" | "terminal" | null;
+            readonly deleteStatus: number | null;
+            readonly state: string | null;
+            readonly error?: {
+                readonly _tag: string;
+                readonly reason: string;
+                readonly message: string;
+                readonly operation?: string;
+                readonly requestId?: string;
+                readonly sessionId?: string;
+                readonly generation?: string;
+                readonly outcome?: "not-submitted" | "replied" | "unknown";
+            };
+        };
+        readonly unpublishSubmitted: readonly string[];
+        readonly unresolvedPublications: readonly string[];
+        readonly localErrors: readonly {
+            readonly _tag: string;
+            readonly reason: string;
+            readonly message: string;
+            readonly operation?: string;
+            readonly requestId?: string;
+            readonly sessionId?: string;
+            readonly generation?: string;
+            readonly outcome?: "not-submitted" | "replied" | "unknown";
+        }[];
+    }, never, never>;
+}, never, never>;
+//# sourceMappingURL=session.d.ts.map

package/dist/internal/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/internal/session.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAa,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EACV,WAAW,EAMX,OAAO,EAIR,MAAM,eAAe,CAAC;AAOvB,OAAO,KAAK,EAAQ,MAAM,EAAiB,QAAQ,EAAS,MAAM,oBAAoB,CAAC;AAQvF,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;CAC5C;AAmBD,eAAO,MAAM,IAAI;qBACE,MAAM;0BACD,WAAW,CAAC,SAAS,CAAC;IAC5C,sEAAsE;qBACrD,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;IACrF,sGAAsG;2BAC/E,OAAO;oBACd,WAAW,CAAC,SAAS,CAAC;uBACnB,QAAQ;;kBAiON,MAAM,KAAG,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA+BrC,CAAC"}

package/dist/internal/session.js

@@ -0,0 +1,280 @@
+/**
+ * The session implementation behind `Reactor.create` and `Reactor.attach`,
+ * composed from its parts in `internal/session/`: the live generation,
+ * inbound events, trickled ICE, requests, tracks, uploads and connection.
+ *
+ * State lives in a `SubscriptionRef` (the session) and a `Ref` per connection
+ * generation. Each generation owns a scope, a peer and one fiber that applies
+ * the peer's events in order; retiring a generation closes its scope, so
+ * nothing it started outlives it. Commands are correlated before they are
+ * sent, and their failures carry the dispatch evidence.
+ */
+import * as Cause from "effect/Cause";
+import * as Clock from "effect/Clock";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Ref from "effect/Ref";
+import * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+import * as SubscriptionRef from "effect/SubscriptionRef";
+import { notTerminated, terminationAttributes } from "../Coordinator.js";
+import { ReactorError, summarize } from "../ReactorError.js";
+import * as Correlator from "./correlator.js";
+import * as Hub from "./hub.js";
+import * as Connect from "./session/connect.js";
+import * as Generation from "./session/generation.js";
+import * as Ice from "./session/ice.js";
+import * as Inbound from "./session/inbound.js";
+import { isClosing, isKnown, transitions } from "./session/model.js";
+import * as Requests from "./session/requests.js";
+import * as Tracks from "./session/tracks.js";
+import * as Upload from "./session/upload.js";
+import * as Stats from "./stats.js";
+import * as Token from "./token.js";
+/** What a close report says of the remote session. */
+const allocationOf = (remote) => {
+    if (remote === undefined)
+        return "none";
+    return isKnown(remote) ? "known" : "unknown";
+};
+/** The remote session as a snapshot shows it outside a ready connection. */
+const remoteOf = (remote) => isKnown(remote)
+    ? {
+        ownership: remote.ownership,
+        sessionId: remote.id,
+        ...(remote.descriptor === undefined ? {} : { descriptor: remote.descriptor }),
+        ...(remote.connectionId === undefined ? {} : { connectionId: remote.connectionId }),
+    }
+    : { ownership: remote.ownership };
+export const make = Effect.fnUntraced(function* (input) {
+    const { intent, coordinator, settings } = input;
+    const root = yield* Scope.make();
+    const state = yield* SubscriptionRef.make({
+        status: "idle",
+        moderated: false,
+        reconnects: false,
+        reconnecting: false,
+        generation: 0n,
+        remote: undefined,
+        connection: undefined,
+        lastError: undefined,
+        close: undefined,
+        received: new Set(),
+        bitrates: new Map(),
+        sampler: Stats.initialSampler,
+    });
+    const sequence = yield* Ref.make(0n);
+    const hub = yield* Hub.make();
+    const data = yield* Correlator.make({
+        prefix: "data",
+        limit: settings.maxPending,
+        namespace: settings.namespace,
+    });
+    const control = yield* Correlator.make({
+        prefix: "ctrl",
+        limit: settings.maxPending,
+        namespace: settings.namespace,
+    });
+    const closing = yield* Deferred.make();
+    const closed = yield* Deferred.make();
+    const closeStarted = yield* Ref.make(false);
+    const publish = Effect.fnUntraced(function* (payload, generation) {
+        const next = yield* Ref.updateAndGet(sequence, (value) => value + 1n);
+        const current = generation ?? (yield* SubscriptionRef.get(state)).generation;
+        yield* hub.publish({ ...payload, sequence: next, generation: current });
+    });
+    const transition = Effect.fnUntraced(function* (status) {
+        const from = yield* SubscriptionRef.modify(state, (current) => current.status !== status && transitions[current.status].includes(status)
+            ? [
+                current.status,
+                {
+                    ...current,
+                    status,
+                    // The close ends the session's own reconnect.
+                    reconnecting: current.reconnecting && status !== "closing",
+                },
+            ]
+            : [current.status, current]);
+        if (from === status)
+            return true;
+        if (!transitions[from].includes(status)) {
+            // Once the session closes only its close moves it on: an attempt that raced it is told so.
+            if (isClosing(from))
+                return false;
+            return yield* Effect.die(`illegal session transition ${from} -> ${status}`);
+        }
+        yield* publish({ _tag: "Status", status });
+        return true;
+    });
+    const token = yield* Token.make({
+        tokens: input.tokens,
+        sessionId: intent._tag === "Attach" ? intent.sessionId : undefined,
+        onRefreshFailure: (error) => publish({ _tag: "Diagnostic", error }),
+    });
+    const signaling = coordinator.signaling(token.current);
+    const core = {
+        intent,
+        settings,
+        signaling,
+        state,
+        sequence,
+        hub,
+        data,
+        control,
+        publish,
+        transition,
+    };
+    const generation = Generation.make(core);
+    const ice = Ice.make({ core, generation });
+    const inbound = Inbound.make({ core, generation, ice });
+    const requests = Requests.make({ core, generation, apiUrl: coordinator.apiUrl });
+    const tracks = Tracks.make({ core, generation, requests });
+    const upload = Upload.make({ core, generation, requests });
+    const connect = Connect.make({
+        core,
+        generation,
+        ice,
+        inbound,
+        requests,
+        tracks,
+        peers: input.peers,
+        root,
+        token,
+        closing,
+        resumeTracks: input.resumeTracks,
+    });
+    const terminateOwned = (remote) => isKnown(remote) && remote.ownership === "owned"
+        ? signaling.terminate(remote.id)
+        : Effect.succeed(notTerminated);
+    const shutdown = Effect.gen(function* () {
+        yield* transition("closing");
+        yield* Deferred.fail(closing, ReactorError.fromCode("Closed", "session closing"));
+        const connection = (yield* SubscriptionRef.get(state)).connection;
+        const { submitted, errors } = yield* tracks.releasePublications(connection);
+        // The host's own failure is the evidence; its message says what did not
+        // finish. Anything else is reported as an opaque shutdown. A host effect
+        // that cannot carry a typed error dies with it.
+        const keep = (cleanup, what) => {
+            if (Exit.isSuccess(cleanup))
+                return;
+            const failure = Cause.squash(cleanup.cause);
+            errors.push(ReactorError.is(failure)
+                ? failure
+                : ReactorError.fromCode("Shutdown", `${what} did not complete cleanly`, {
+                    detail: cleanup.cause,
+                }));
+        };
+        if (connection !== undefined)
+            keep(yield* generation.failUnreported(connection, ReactorError.fromCode("Aborted", "session closed")), "connection teardown");
+        keep(yield* Effect.exit(Scope.close(root, Exit.void)), "local cleanup");
+        // Ownership is read after local work has joined: an interrupted
+        // allocation may have changed its evidence meanwhile.
+        const remote = (yield* SubscriptionRef.get(state)).remote;
+        const termination = yield* terminateOwned(remote);
+        const unresolved = connection === undefined ? [] : [...(yield* Ref.get(connection.link)).claims.values()];
+        const report = {
+            localClosed: errors.length === 0,
+            allocation: allocationOf(remote),
+            ...(isKnown(remote) ? { ownership: remote.ownership, sessionId: remote.id } : {}),
+            remote: termination,
+            unpublishSubmitted: submitted,
+            unresolvedPublications: unresolved,
+            localErrors: errors.map(summarize),
+        };
+        yield* SubscriptionRef.update(state, (current) => ({ ...current, close: report }));
+        yield* transition("closed");
+        yield* hub.end;
+        yield* Deferred.succeed(closed, report);
+        yield* Effect.annotateCurrentSpan({
+            "reactor.close.local_closed": report.localClosed,
+            "reactor.close.allocation": report.allocation,
+            ...terminationAttributes(report.remote),
+        });
+        return report;
+    }).pipe(Effect.withSpan("Session.close", { kind: "client" }, { captureStackTrace: false }));
+    const close = Effect.uninterruptible(Ref.getAndSet(closeStarted, true).pipe(Effect.flatMap((started) => (started ? Deferred.await(closed) : shutdown))));
+    /** `session` as its readers see it, with what its connection and queues hold now. */
+    const snapshotOf = Effect.fnUntraced(function* (session) {
+        const link = session.connection === undefined ? undefined : yield* Ref.get(session.connection.link);
+        const details = {
+            generation: session.generation,
+            reconnecting: session.reconnecting,
+            pending: { data: yield* data.size, control: yield* control.size },
+            pausedLocally: [...(link?.paused ?? [])],
+            claimedTracks: [...(link?.claimed ?? [])],
+            receivedTracks: [...session.received],
+            unresolvedPublications: [...(link?.claims.values() ?? [])],
+            observationOverflows: yield* hub.overflows,
+            subscribers: yield* hub.observers,
+            ...(session.lastError === undefined ? {} : { lastError: session.lastError }),
+            ...(session.close === undefined ? {} : { close: session.close }),
+        };
+        if (session.status === "ready" && link?.negotiated !== undefined)
+            return { ...details, status: "ready", remote: link.negotiated };
+        return {
+            ...details,
+            status: session.status === "ready" ? "waiting" : session.status,
+            ...(session.remote === undefined ? {} : { remote: remoteOf(session.remote) }),
+        };
+    });
+    const snapshot = Effect.flatMap(SubscriptionRef.get(state), snapshotOf);
+    const observe = Effect.fnUntraced(function* (options = {}) {
+        // Subscribe first, so nothing falls between the state and its events.
+        const events = yield* hub.subscribe(options.capacity);
+        const revision = yield* Ref.get(sequence);
+        const initial = yield* snapshot;
+        return {
+            initial,
+            revision,
+            events: Stream.filter(events, (event) => event.sequence > revision),
+        };
+    });
+    const stats = Effect.gen(function* () {
+        const { c } = yield* generation.currentReady;
+        const raw = yield* generation.guard(c, c.peer.stats);
+        if (raw.length > 4096)
+            return yield* ReactorError.fromCode("Protocol", "statistics exceed their bound");
+        const atMs = Number(yield* Clock.monotonicTimeNanos) / 1_000_000;
+        return yield* SubscriptionRef.modify(state, (current) => {
+            const [statistics, sampler] = Stats.sample({
+                state: current.sampler,
+                raw,
+                generation: c.generation,
+                atMs,
+            });
+            return [statistics, { ...current, sampler }];
+        });
+    });
+    const session = (id) => ({
+        id,
+        ownership: intent._tag === "Create" || intent.adopt ? "owned" : "attached",
+        snapshot,
+        // Each change as it was, so a reader that falls behind still sees every status.
+        changes: SubscriptionRef.changes(state).pipe(Stream.mapEffect(snapshotOf)),
+        ready: Effect.map(generation.currentReady, ({ c, negotiated }) => ({
+            status: "ready",
+            generation: c.generation,
+            remote: negotiated,
+        })),
+        events: (options) => Stream.unwrap(hub.subscribe(options?.capacity)),
+        observe,
+        command: requests.command,
+        schema: requests.schema,
+        upload,
+        requestRecordingClip: requests.requestRecordingClip,
+        recording: requests.recording,
+        stats,
+        decoded: tracks.decoded,
+        tracks: tracks.tracks,
+        reconnect: connect.reconnect,
+        close,
+    });
+    return {
+        session,
+        allocate: connect.allocate,
+        connect: Effect.andThen(connect.connect, connect.arm),
+        close,
+    };
+});
+//# sourceMappingURL=session.js.map