reactor-effect-client 0.7.1 → 0.8.0

package/dist/ReactorTest.js

@@ -0,0 +1,317 @@
+/**
+ * Reactor in a box: Reactor's coordinator and an H3 model simulated in memory
+ * at the network edge, so an application and every SDK layer above it run
+ * unchanged without a paid session. Provide `layer({ timing })` beneath
+ * `Reactor.layer()` in place of an HTTP client and a host; `layerCoordinator`
+ * is the coordinator's HTTP API alone, with no host.
+ *
+ * It models what H3 does, not how fast it does it: every delay comes from the
+ * `timing` the caller chooses. A scenario test states the timing it relies on
+ * with `Timing.fixed`; a simulation test draws from wide ranges with
+ * `Timing.random`, reproducibly for its seed; `Timing.hosted` draws from
+ * ranges paid runs measured, for demos. Every delay is an `Effect.sleep`: under
+ * `TestClock`, fork `flow()` and the run is deterministic; on the live clock
+ * it plays in real time.
+ */
+import * as Context from "effect/Context";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
+import * as TestClock from "effect/testing/TestClock";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import * as Coordinator from "./internal/reactorTest/coordinator.js";
+import { clipId } from "./internal/reactorTest/h3.js";
+import * as Media from "./internal/reactorTest/media.js";
+import * as Peer from "./internal/reactorTest/peer.js";
+import * as Sessions from "./internal/reactorTest/sessions.js";
+import * as Sampler from "./internal/reactorTest/timing.js";
+import { PeerFactory } from "./Peer.js";
+const Count = Schema.Int.check(Schema.isGreaterThan(0));
+const nth = { nth: Schema.optionalKey(Count) };
+/**
+ * A fault the simulated Reactor injects. `nth` counts the occurrences the
+ * fault matches since it was added, from 1; without it every one matches.
+ */
+export const Fault = Schema.Union([
+    /**
+     * `POST /sessions` is refused with 403, or with `status`, allocating nothing
+     * either way: from a 5xx the client cannot tell that.
+     */
+    Schema.TaggedStruct("RefuseAllocation", {
+        ...nth,
+        status: Schema.optionalKey(Schema.Int.check(Schema.isBetween({ minimum: 400, maximum: 599 }))),
+    }),
+    /**
+     * `POST /sessions` on a token whose sessions are used allocates a session
+     * all the same, where it is otherwise refused 403 `session_limit`. What
+     * hosted Reactor answers a spent token is unobserved.
+     */
+    Schema.TaggedStruct("IgnoreSessionLimit", nth),
+    /**
+     * `POST /sessions` on a token whose sessions are used answers with the
+     * session the token created last, where it is otherwise refused 403
+     * `session_limit`. What hosted Reactor answers a spent token is unobserved.
+     */
+    Schema.TaggedStruct("RepeatSession", nth),
+    /**
+     * `POST /sessions` allocates, and answers 200 with a descriptor that names
+     * no session, so the client cannot tell what it made. Whether hosted
+     * Reactor ever answers so is unobserved.
+     */
+    Schema.TaggedStruct("UnnamedAllocation", nth),
+    /**
+     * `POST /sessions` is never answered and allocates nothing, so only the
+     * client's own deadline ends the request, not knowing what it made.
+     */
+    Schema.TaggedStruct("StallAllocation", nth),
+    /** Registering a WebRTC connection is refused with 403. */
+    Schema.TaggedStruct("RefuseConnect", nth),
+    /**
+     * A reconnect is refused with 503, or with `status`, saying to try again `retryAfter` later
+     * when it is set: the offer that replaces a connection's SDP (`PUT sdp_params`) takes no
+     * effect.
+     */
+    Schema.TaggedStruct("RefuseReconnect", {
+        ...nth,
+        status: Schema.optionalKey(Schema.Int.check(Schema.isBetween({ minimum: 400, maximum: 599 }))),
+        /** Sent as `Retry-After`, in whole seconds. */
+        retryAfter: Schema.optionalKey(Schema.Duration),
+    }),
+    /** The model never answers the command; with `applied` it takes effect and only the reply is lost. */
+    Schema.TaggedStruct("DropReply", {
+        ...nth,
+        command: Schema.String,
+        applied: Schema.optionalKey(Schema.Boolean),
+    }),
+    /**
+     * The model takes the command on time and answers it this long late, over
+     * the connection the command came on, whichever transport then carries it.
+     */
+    Schema.TaggedStruct("LateReply", { ...nth, command: Schema.String, after: Schema.Duration }),
+    /** A build never finishes and holds the build slot. */
+    Schema.TaggedStruct("StallBuild", nth),
+    /** A build fails: the model broadcasts `clip_failed` and drops the clip. */
+    Schema.TaggedStruct("FailBuild", { ...nth, reason: Schema.optionalKey(Schema.String) }),
+    /** A connection drops this long after its channels open; the session goes on. */
+    Schema.TaggedStruct("Disconnect", { ...nth, after: Schema.Duration }),
+    /** Sessions end this long after they become ready, when that is sooner than their grant. */
+    Schema.TaggedStruct("Expire", { after: Schema.Duration }),
+    /**
+     * No session ends at its grant's cap: each runs until it is terminated, or
+     * until 30 s after its last connection drops. Whether hosted Reactor ends a
+     * session nothing ever connected to at its cap is unobserved.
+     */
+    Schema.TaggedStruct("IgnoreCap", {}),
+    /** DELETE is accepted and the session reads STOPPING this long before it closes. */
+    Schema.TaggedStruct("SlowDelete", { for: Schema.Duration }),
+    /** DELETE is accepted and the session runs on until its grant ends. */
+    Schema.TaggedStruct("IgnoreDelete", {}),
+    /**
+     * `GET /sessions/{id}` answers 404 for a session that still runs, as a
+     * coordinator that lost track of it for a moment would. Whether hosted
+     * Reactor ever does is unobserved.
+     */
+    Schema.TaggedStruct("MissingSession", nth),
+    /** While a clip plays, video is absent, black or one repeated frame. */
+    Schema.TaggedStruct("Video", { video: Schema.Literals(["absent", "black", "frozen"]) }),
+    /** The session offers audio and sends none. */
+    Schema.TaggedStruct("NoAudio", {}),
+    /** An enqueue with reference images is refused because one of them is invalid. */
+    Schema.TaggedStruct("InvalidImage", nth),
+    /**
+     * `POST /tokens` misgrants: a longer session than was asked for (the
+     * default), none of the cap asked for, a session not asked to be bound, a
+     * token already expired, or no echo of what it granted.
+     */
+    Schema.TaggedStruct("OverGrant", {
+        ...nth,
+        grant: Schema.optionalKey(Schema.Literals(["longer", "uncapped", "bound", "expired", "silent"])),
+    }),
+    /** A recording's playlist is ready this long after the time its clip predicted. */
+    Schema.TaggedStruct("LateRecording", { ...nth, by: Schema.Duration }),
+    /**
+     * Content moderation flags an enqueue, every one or those with `prompt`.
+     * The enqueue is answered as usual; `timing.moderation` later the verdict
+     * arrives on the control channel naming no category, input, command or
+     * request, as it did in a paid run, and on `terminate` (the default) the
+     * session ends, as Reactor documents. `warn` only reports it.
+     */
+    Schema.TaggedStruct("Moderate", {
+        ...nth,
+        prompt: Schema.optionalKey(Schema.String),
+        action: Schema.optionalKey(Schema.Literals(["terminate", "warn"])),
+        /** False ends the session with no verdict sent, which Reactor's docs allow. */
+        verdict: Schema.optionalKey(Schema.Boolean),
+    }),
+]);
+const point = (input) => {
+    const value = Duration.fromInputUnsafe(input ?? 0);
+    return { min: value, max: value };
+};
+const range = (bounds) => ({
+    min: Duration.fromInputUnsafe(bounds[0]),
+    max: Duration.fromInputUnsafe(bounds[1]),
+});
+export const Timing = {
+    /**
+     * Every delay fixed: zero unless named. A scenario test names the ones its
+     * outcome depends on.
+     */
+    fixed: (input) => ({
+        label: "fixed",
+        seed: 1,
+        http: point(input.http),
+        channel: point(input.channel),
+        allocation: point(input.allocation),
+        negotiation: point(input.negotiation),
+        connect: point(input.connect),
+        seam: point(input.seam),
+        stop: point(input.stop),
+        moderation: point(input.moderation),
+        buildSpeed: { min: input.buildSpeed, max: input.buildSpeed },
+        continuedBuildSpeed: {
+            min: input.continuedBuildSpeed ?? input.buildSpeed,
+            max: input.continuedBuildSpeed ?? input.buildSpeed,
+        },
+    }),
+    /**
+     * Every delay drawn from a range, deliberately wider than anything measured
+     * so that code tuned to one provider speed fails: builds from a quarter of
+     * real time to ten times it, requests and messages up to 2 s, seams up to
+     * half a second, stops landing up to a second after their acknowledgement.
+     * Name a narrower range to explore one.
+     */
+    random: (input) => ({
+        label: `random seed ${input.seed}`,
+        seed: input.seed,
+        http: range(input.http ?? [0, "2 seconds"]),
+        channel: range(input.channel ?? [0, "2 seconds"]),
+        allocation: range(input.allocation ?? [0, "5 seconds"]),
+        negotiation: range(input.negotiation ?? [0, "2 seconds"]),
+        connect: range(input.connect ?? [0, "2 seconds"]),
+        seam: range(input.seam ?? [0, "500 millis"]),
+        stop: range(input.stop ?? [0, "1 second"]),
+        moderation: range(input.moderation ?? [0, "2 seconds"]),
+        buildSpeed: {
+            min: input.buildSpeed?.[0] ?? 0.25,
+            max: input.buildSpeed?.[1] ?? 10,
+        },
+        continuedBuildSpeed: {
+            min: input.continuedBuildSpeed?.[0] ?? 0.25,
+            max: input.continuedBuildSpeed?.[1] ?? 10,
+        },
+    }),
+    /**
+     * What two paid hosted H3 runs measured on 2026-09-27 (0.6.0 evidence):
+     * connect steps of 0.2–0.9 s, eleven 5 s clips built about every 2.1 s
+     * while playing, five seams of 30–110 ms and command round trips of 60–90
+     * ms; from 0.7.0's two runs on 2026-09-28, a stop landing about 20 ms
+     * after its acknowledgement and one continued 5 s clip built in 5.45 s; and
+     * from 0.8.0's cut run, a moderation verdict 1.01 s after its enqueue. These
+     * are small samples, drawn as ranges and not replayed as a trace: use them
+     * for demos and realism checks, not as what a test depends on.
+     */
+    hosted: {
+        label: "hosted H3, paid runs of 2026-09-27 and 2026-09-28",
+        seed: 1,
+        http: range(["200 millis", "300 millis"]),
+        channel: range(["30 millis", "45 millis"]),
+        allocation: range(["300 millis", "500 millis"]),
+        negotiation: range(["500 millis", "650 millis"]),
+        connect: range(["600 millis", "900 millis"]),
+        seam: range(["30 millis", "110 millis"]),
+        stop: point("20 millis"),
+        moderation: point("1 second"),
+        buildSpeed: { min: 2.3, max: 2.6 },
+        continuedBuildSpeed: { min: 0.92, max: 0.92 },
+    },
+};
+const count = (value) => Count.pipe(Schema.withConstructorDefault(Effect.succeed(value)));
+/** The simulated Reactor's fixed facts; its delays come from `Timing`. */
+export const Options = Schema.Struct({
+    /** The key `POST /tokens` accepts. */
+    apiKey: Schema.String.pipe(Schema.withConstructorDefault(Effect.succeed("reactor-test-api-key"))),
+    /** The queue capacities H3's state reports. */
+    generationCapacity: count(20),
+    playoutCapacity: count(10),
+    /**
+     * The rate the pricing API publishes, in credits a second, as it stated
+     * H3's for the paid runs: 125 at 10,000 a dollar is $0.0125 a second.
+     */
+    creditsPerSecond: count(125),
+    creditsPerDollar: count(10_000),
+    /** Sessions the account may run at once, as Reactor's default quota; more are refused with 429. */
+    concurrentSessions: count(5),
+    /**
+     * Sessions the account may create a minute, three back to back, as Reactor's
+     * default quota; more are refused with 429 and a `Retry-After`.
+     */
+    sessionsPerMinute: count(10),
+    /** Decoded frame size. */
+    width: count(16),
+    height: count(16),
+    /**
+     * The local candidate type of the pair a peer's statistics report carrying
+     * its media: `relay` stands for a connection through TURN.
+     */
+    candidate: Schema.Literals(["host", "srflx", "relay"]).pipe(Schema.withConstructorDefault(Effect.succeed("host"))),
+    /** Whether the deployment's `enqueue` declares `reference_audios`. */
+    referenceAudio: Schema.Boolean.pipe(Schema.withConstructorDefault(Effect.succeed(true))),
+    /**
+     * Whether the deployment records. A recorder answers a clip or recording
+     * request with an HLS playlist, ready when the clip says; without one the
+     * request fails as a disabled recorder does. Whether hosted H3 records is
+     * unobserved.
+     */
+    recorder: Schema.Boolean.pipe(Schema.withConstructorDefault(Effect.succeed(false))),
+    faults: Schema.Array(Fault).pipe(Schema.withConstructorDefault(Effect.succeed([]))),
+});
+/** Inspects and disturbs the simulated Reactor. */
+export class ReactorTest extends Context.Service()("reactor-effect-client/ReactorTest") {
+}
+/** The simulated coordinator's state, and the services over it. */
+const simulate = Effect.fnUntraced(function* (input) {
+    const { timing, ...rest } = input;
+    const options = Options.make(rest);
+    const sessions = yield* Sessions.make(options, yield* Sampler.make(timing));
+    const context = Context.make(ReactorTest, ReactorTest.of({
+        apiKey: Redacted.make(options.apiKey),
+        sessions: sessions.info,
+        billing: sessions.billing,
+        log: sessions.log,
+        inject: sessions.inject,
+    })).pipe(Context.add(HttpClient.HttpClient, Coordinator.client(sessions)));
+    return { sessions, context };
+});
+/**
+ * The simulated coordinator alone: tokens, sessions and their lifetimes,
+ * uploads and recordings over its HTTP API, with no host. Its sessions run
+ * without a connection, as a session does before its first or after its last.
+ */
+export const layerCoordinator = (input) => Layer.effectContext(Effect.map(simulate(input), ({ context }) => context));
+/** The simulated Reactor, as the network edge `Reactor.layer` needs. */
+export const layer = (input) => Layer.effectContext(Effect.map(simulate(input), ({ sessions, context }) => Context.add(context, PeerFactory, PeerFactory.of({
+    check: Effect.void,
+    make: Effect.acquireRelease(Peer.make(sessions), (peer) => peer.close),
+}))));
+/** The clip a simulated frame belongs to and its index in the clip; undefined when black. */
+export const frameOf = (frame) => {
+    const decoded = Media.decode(frame.data);
+    return decoded && { clipId: clipId(decoded.ordinal), index: decoded.index };
+};
+/**
+ * Keeps a `TestClock` moving in `step`s (5 ms by default) while it runs, so a
+ * scenario written as straight-line code advances in virtual time and each
+ * message chain lands within a step of when it would. Fork it into the test's
+ * scope; one large `TestClock.adjust` can run ahead of a fiber still being
+ * woken.
+ */
+export const flow = (step = "5 millis") => Effect.forever(TestClock.adjust(step));
+/**
+ * Reference media H3's local checks accept, for tests and demos:
+ * `pngBytes({ width, height })` is a black PNG, `wavBytes({ seconds })` a WAV tone.
+ */
+export { pngBytes, wavBytes } from "./internal/reactorTest/references.js";
+//# sourceMappingURL=ReactorTest.js.map

package/dist/ReactorTest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactorTest.js","sourceRoot":"","sources":["../src/ReactorTest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,WAAW,MAAM,uCAAuC,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,iCAAiC,CAAC;AACzD,OAAO,KAAK,IAAI,MAAM,gCAAgC,CAAC;AACvD,OAAO,KAAK,QAAQ,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,OAAO,MAAM,kCAAkC,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAChC;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE;QACtC,GAAG,GAAG;QACN,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;KAC/F,CAAC;IACF;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,GAAG,CAAC;IAC9C;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,GAAG,CAAC;IACzC;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,mBAAmB,EAAE,GAAG,CAAC;IAC7C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE,GAAG,CAAC;IAC3C,2DAA2D;IAC3D,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,GAAG,CAAC;IACzC;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE;QACrC,GAAG,GAAG;QACN,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9F,+CAA+C;QAC/C,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;KAChD,CAAC;IACF,sGAAsG;IACtG,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE;QAC/B,GAAG,GAAG;QACN,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC;KAC5C,CAAC;IACF;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC5F,uDAAuD;IACvD,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,GAAG,CAAC;IACtC,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IACvF,iFAAiF;IACjF,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACrE,4FAA4F;IAC5F,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACzD;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;IACpC,oFAAoF;IACpF,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3D,uEAAuE;IACvE,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,CAAC;IACvC;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,GAAG,CAAC;IAC1C,wEAAwE;IACxE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;IACvF,+CAA+C;IAC/C,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC;IAClC,kFAAkF;IAClF,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,GAAG,CAAC;IACxC;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE;QAC/B,GAAG,GAAG;QACN,KAAK,EAAE,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CACtE;KACF,CAAC;IACF,mFAAmF;IACnF,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACrE;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE;QAC9B,GAAG,GAAG;QACN,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAClE,+EAA+E;QAC/E,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC;KAC5C,CAAC;CACH,CAAC,CAAC;AAwCH,MAAM,KAAK,GAAG,CAAC,KAAiC,EAAS,EAAE;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IACnD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACpC,CAAC,CAAC;AACF,MAAM,KAAK,GAAG,CAAC,MAAiD,EAAS,EAAE,CAAC,CAAC;IAC3E,GAAG,EAAE,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,GAAG,EAAE,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;;;OAGG;IACH,KAAK,EAAE,CAAC,KAYP,EAAU,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QACvB,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7B,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;QACnC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC;QACrC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QACvB,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;QACnC,UAAU,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,EAAE;QAC5D,mBAAmB,EAAE;YACnB,GAAG,EAAE,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,UAAU;YAClD,GAAG,EAAE,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,UAAU;SACnD;KACF,CAAC;IACF;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,KAYR,EAAU,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,eAAe,KAAK,CAAC,IAAI,EAAE;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC3C,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACjD,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACvD,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACjD,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QAC5C,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC1C,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACvD,UAAU,EAAE;YACV,GAAG,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI;YAClC,GAAG,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;SACjC;QACD,mBAAmB,EAAE;YACnB,GAAG,EAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI;YAC3C,GAAG,EAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;SAC1C;KACF,CAAC;IACF;;;;;;;;;OASG;IACH,MAAM,EAAE;QACN,KAAK,EAAE,mDAAmD;QAC1D,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,KAAK,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC1C,UAAU,EAAE,KAAK,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC/C,WAAW,EAAE,KAAK,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAChD,OAAO,EAAE,KAAK,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC5C,IAAI,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACxC,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;QAC7B,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;QAClC,mBAAmB,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;KAC7B;CACnB,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAElG,0EAA0E;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACjG,+CAA+C;IAC/C,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC;IAC7B,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC;IAC5B,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC;IAC/B,mGAAmG;IACnG,kBAAkB,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5B;;;OAGG;IACH,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC;IAC5B,0BAA0B;IAC1B,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;IACjB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CACzD,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,MAAe,CAAC,CAAC,CAC/D;IACD,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACxF;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACnF,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;CACpF,CAAC,CAAC;AAgDH,mDAAmD;AACnD,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EAY7C,CAAC,mCAAmC,CAAC;CAAG;AAI3C,mEAAmE;AACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,KAAY;IACxD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAC1B,WAAW,EACX,WAAW,CAAC,EAAE,CAAC;QACb,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACrC,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;KACxB,CAAC,CACH,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAY,EAAoD,EAAE,CACjG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAE7E,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,KAAY,EACoD,EAAE,CAClE,KAAK,CAAC,aAAa,CACjB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,CACpD,OAAO,CAAC,GAAG,CACT,OAAO,EACP,WAAW,EACX,WAAW,CAAC,EAAE,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,IAAI;IAClB,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;CACvE,CAAC,CACH,CACF,CACF,CAAC;AAEJ,6FAA6F;AAC7F,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,KAAiB,EACgD,EAAE;IACnE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,OAAO,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;AAC9E,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,GAAmB,UAAU,EAAwB,EAAE,CAC9E,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAEzC;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAmB,MAAM,sCAAsC,CAAC"}

package/dist/Session.d.ts

@@ -0,0 +1,314 @@
+/**
+ * One Reactor session: an allocation this process owns or an attachment it
+ * joined, its connection generations, commands, events and cleanup evidence.
+ * `Reactor.create` and `Reactor.attach` acquire one in a scope.
+ */
+import type * as Duration from "effect/Duration";
+import type * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import type * as Scope from "effect/Scope";
+import type * as Stream from "effect/Stream";
+import type { Capabilities, Descriptor, Transport } from "./Coordinator.js";
+import type { Correlation } from "./internal/correlator.js";
+import type { Statistics } from "./internal/stats.js";
+import type { DecodedMedia, TrackMedia } from "./Media.js";
+import type { CommandFailure, ReactorError } from "./ReactorError.js";
+export type { Correlation } from "./internal/correlator.js";
+export type { Statistics } from "./internal/stats.js";
+/** A recording the session prepared, with the playlist to download it from. */
+export declare const ClipReady: Schema.Struct<{
+    readonly sessionId: Schema.String;
+    readonly kind: Schema.String;
+    readonly startMarker: Schema.Finite;
+    readonly endMarker: Schema.Finite;
+    readonly nowMarker: Schema.Finite;
+    readonly predictedReadyAtMs: Schema.BigInt;
+    readonly playlistUrl: Schema.String;
+}>;
+export type ClipReady = typeof ClipReady.Type;
+/**
+ * A control-channel message Reactor sent. Provider text (a clip failure's
+ * reason, an error's code and message) stays `Redacted`.
+ */
+export declare const ControlMessage: Schema.Union<readonly [Schema.TaggedStruct<"ModelSchema", {
+    readonly openapi: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+}>, Schema.TaggedStruct<"ClipReady", {
+    readonly clip: Schema.Struct<{
+        readonly sessionId: Schema.String;
+        readonly kind: Schema.String;
+        readonly startMarker: Schema.Finite;
+        readonly endMarker: Schema.Finite;
+        readonly nowMarker: Schema.Finite;
+        readonly predictedReadyAtMs: Schema.BigInt;
+        readonly playlistUrl: Schema.String;
+    }>;
+}>, Schema.TaggedStruct<"ClipFailed", {
+    readonly reason: Schema.Redacted<Schema.String>;
+}>, Schema.TaggedStruct<"TrackPublished", {
+    readonly name: Schema.String;
+}>, Schema.TaggedStruct<"Error", {
+    readonly code: Schema.Redacted<Schema.String>;
+    readonly message: Schema.Redacted<Schema.String>;
+}>]>;
+export type ControlMessage = typeof ControlMessage.Type;
+/** An uploaded file, as a command refers to it. */
+export interface UploadReference {
+    readonly uploadId: string;
+    readonly name: string;
+    readonly mimeType: string;
+    readonly size: bigint;
+}
+export type Status = "idle" | "connecting" | "waiting" | "ready" | "disconnected" | "closing" | "closed";
+export type Ownership = "owned" | "attached" | "allocating" | "unknown";
+/**
+ * A session's cleanup evidence, a Schema so it can be persisted. Termination
+ * is confirmed by an independent read, never by a DELETE response alone.
+ */
+export declare const CloseReport: Schema.Struct<{
+    readonly localClosed: Schema.Boolean;
+    readonly allocation: Schema.Literals<readonly ["none", "known", "unknown"]>;
+    readonly ownership: Schema.optionalKey<Schema.Literals<readonly ["owned", "attached"]>>;
+    readonly sessionId: Schema.optionalKey<Schema.String>;
+    readonly remote: Schema.Struct<{
+        readonly attempted: Schema.Boolean;
+        readonly responseReceived: Schema.Boolean;
+        readonly confirmed: Schema.Boolean;
+        readonly evidence: Schema.NullOr<Schema.Literals<readonly ["absent", "terminal"]>>;
+        readonly deleteStatus: Schema.NullOr<Schema.Int>;
+        readonly state: Schema.NullOr<Schema.String>;
+        readonly error: Schema.optionalKey<Schema.Struct<{
+            readonly _tag: Schema.String;
+            readonly reason: Schema.String;
+            readonly message: Schema.String;
+            readonly operation: Schema.optionalKey<Schema.String>;
+            readonly requestId: Schema.optionalKey<Schema.String>;
+            readonly sessionId: Schema.optionalKey<Schema.String>;
+            readonly generation: Schema.optionalKey<Schema.String>;
+            readonly outcome: Schema.optionalKey<Schema.Literals<readonly ["not-submitted", "unknown", "replied"]>>;
+        }>>;
+    }>;
+    readonly unpublishSubmitted: Schema.$Array<Schema.String>;
+    /** Claims possibly accepted remotely without an attributable response. */
+    readonly unresolvedPublications: Schema.$Array<Schema.String>;
+    readonly localErrors: Schema.$Array<Schema.Struct<{
+        readonly _tag: Schema.String;
+        readonly reason: Schema.String;
+        readonly message: Schema.String;
+        readonly operation: Schema.optionalKey<Schema.String>;
+        readonly requestId: Schema.optionalKey<Schema.String>;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly generation: Schema.optionalKey<Schema.String>;
+        readonly outcome: Schema.optionalKey<Schema.Literals<readonly ["not-submitted", "unknown", "replied"]>>;
+    }>>;
+}>;
+export type CloseReport = typeof CloseReport.Type;
+/**
+ * Whether the session a report closed may still bill: this process owned it
+ * and no read confirmed it ended, or it asked for an allocation whose outcome,
+ * and so whose id, never arrived. Nothing can confirm the second ended; the
+ * session's cap bounds it.
+ */
+export declare const mayStillBill: (report: CloseReport) => boolean;
+export interface ReadyDescriptor extends Descriptor {
+    readonly capabilities: Capabilities;
+    readonly selected_transport: typeof Transport.Type;
+}
+export interface ReadyState {
+    readonly status: "ready";
+    readonly generation: bigint;
+    readonly remote: {
+        readonly ownership: "owned" | "attached";
+        readonly sessionId: string;
+        readonly descriptor: ReadyDescriptor;
+        readonly connectionId: number;
+    };
+}
+interface SnapshotDetails {
+    readonly generation: bigint;
+    /**
+     * The session is reconnecting a dropped connection on its own: from the drop until a
+     * connection is ready or it stops trying, as `Reactor.Options.reconnect` says. `disconnected`
+     * without it is lasting: only `session.reconnect` connects the session again. A drop no attempt
+     * could reconnect, once content moderation or Reactor has ended the session or Reactor refuses
+     * this client's protocol (`VersionMismatch`), is lasting from the drop on, and `lastError` says
+     * why. A connection that drops before it has been ready 10 seconds, once the reconnect's time
+     * has run out, reads `reconnecting` for one change before the reconnect stops.
+     */
+    readonly reconnecting: boolean;
+    readonly pending: {
+        readonly data: number;
+        readonly control: number;
+    };
+    readonly pausedLocally: ReadonlyArray<string>;
+    readonly claimedTracks: ReadonlyArray<string>;
+    readonly unresolvedPublications: ReadonlyArray<string>;
+    readonly receivedTracks: ReadonlyArray<string>;
+    readonly observationOverflows: bigint;
+    readonly subscribers: number;
+    readonly lastError?: ReactorError;
+    readonly close?: CloseReport;
+}
+export type Snapshot = SnapshotDetails & (ReadyState | {
+    readonly status: Exclude<Status, "ready">;
+    readonly remote?: {
+        readonly ownership: Ownership;
+        readonly sessionId?: string;
+        readonly descriptor?: Descriptor;
+        readonly connectionId?: number;
+    };
+});
+export interface Attribution {
+    readonly requestId: string;
+    readonly sequence: bigint;
+    readonly generation: bigint;
+    readonly correlation: Correlation;
+}
+/** A command's result and its observation are the same attributed value. */
+export type CommandReply = Attribution & {
+    readonly _tag: "Model";
+    readonly outcome: "replied";
+} & ({
+    readonly kind: "ack";
+} | {
+    readonly kind: "message";
+    readonly type: string;
+    readonly data?: Schema.JsonObject;
+});
+export interface UploadProgress {
+    readonly allocation: "not-requested" | "unknown" | "confirmed";
+    readonly transfer: "not-requested" | "unknown" | "confirmed";
+    readonly notification: "not-submitted" | "unknown" | "submitted";
+    readonly file?: UploadReference;
+}
+export interface Uploaded {
+    readonly file: UploadReference;
+    readonly transfer: "confirmed";
+    readonly notification: "submitted";
+}
+export type EventPayload = {
+    readonly _tag: "Status";
+    readonly status: Status;
+} | {
+    readonly _tag: "CommandError";
+    readonly error: ReactorError;
+    readonly requestId: string;
+    readonly correlation: Correlation;
+}
+/** A control message; a reply to this client's own request only when correlation says so. */
+ | {
+    readonly _tag: "Control";
+    readonly message: ControlMessage;
+    readonly requestId: string;
+    readonly correlation: Correlation;
+} | {
+    readonly _tag: "Track";
+    readonly name: string;
+    readonly mid: string;
+} | {
+    readonly _tag: "Decoded";
+    readonly kind: "audio" | "video";
+    readonly name: string;
+    readonly mid: string;
+} | {
+    readonly _tag: "Diagnostic";
+    readonly error: ReactorError;
+}
+/**
+ * Reactor's content moderation flagged an input. `terminate` means Reactor
+ * is ending the session, and it is not reconnected; `warn` is informational.
+ * Its text stays out: the categories name what was flagged.
+ */
+ | {
+    readonly _tag: "Moderation";
+    readonly action: string;
+    readonly categories: ReadonlyArray<string>;
+    /** What was screened, such as `prompt` or `image`, when Reactor says. */
+    readonly inputKind?: string;
+    /** The command that carried it, when Reactor says. */
+    readonly command?: string;
+    /** The request it answers, when Reactor names one. */
+    readonly requestId?: string;
+} | {
+    readonly _tag: "Upload";
+    readonly progress: UploadProgress;
+};
+export type SessionEvent = CommandReply | (EventPayload & {
+    readonly sequence: bigint;
+    readonly generation: bigint;
+});
+/** A state and every event after it, with no gap: events at or below `revision` are already in it. */
+export interface Observation {
+    readonly initial: Snapshot;
+    readonly revision: bigint;
+    readonly events: Stream.Stream<SessionEvent, ReactorError>;
+}
+export interface ObserveOptions {
+    /** Events an observer may hold unread before it fails with `Overflow`; 64 by default. */
+    readonly capacity?: number | undefined;
+}
+/**
+ * The library's own reply deadline, not a caller's wait: after dispatch its
+ * expiry fails with `Timeout`, outcome `unknown`, and the request stays
+ * attributable. To only stop waiting, fork the command and bound the join.
+ */
+export interface CommandOptions {
+    /** 10 seconds by default. */
+    readonly replyTimeout?: Duration.Input | undefined;
+    /** Uploaded files the command refers to, by the name the command uses. */
+    readonly uploads?: ReadonlyMap<string, UploadReference> | undefined;
+}
+export interface UploadOptions {
+    /** From allocation to notification; the session's upload timeout by default. */
+    readonly uploadTimeout?: Duration.Input | undefined;
+}
+export interface Session {
+    readonly id: string;
+    readonly ownership: "owned" | "attached";
+    readonly snapshot: Effect.Effect<Snapshot>;
+    /**
+     * The snapshot at every lifecycle change, starting with the current one; a reader that falls
+     * behind still sees each status in turn. A snapshot's status, generation, `reconnecting`,
+     * `lastError`, `receivedTracks` and `close` are as its change left them; the rest (pending
+     * counts, observers and overflows, and the connection's paused, claimed and unresolved tracks)
+     * is read as the reader takes it.
+     */
+    readonly changes: Stream.Stream<Snapshot>;
+    /** The negotiated connection, when the session is ready. */
+    readonly ready: Effect.Effect<ReadyState, ReactorError>;
+    /** Events from now on; see `observe` to pair them with a state. */
+    readonly events: (options?: ObserveOptions) => Stream.Stream<SessionEvent, ReactorError>;
+    readonly observe: (options?: ObserveOptions) => Effect.Effect<Observation, ReactorError, Scope.Scope>;
+    readonly command: (name: string, data: unknown, options?: CommandOptions) => Effect.Effect<CommandReply, CommandFailure>;
+    /** The deployment's OpenAPI document, when it publishes one. */
+    readonly schema: Effect.Effect<{
+        readonly openapi?: Schema.JsonObject;
+    }, ReactorError>;
+    readonly upload: (name: string, mimeType: string, bytes: Uint8Array, options?: UploadOptions) => Effect.Effect<Uploaded, ReactorError>;
+    readonly requestRecordingClip: (seconds: number) => Effect.Effect<ClipReady, ReactorError>;
+    readonly recording: Effect.Effect<ClipReady, ReactorError>;
+    /** A sample of the connection's statistics; its `rates` run from the session's previous sample. */
+    readonly stats: Effect.Effect<Statistics, ReactorError>;
+    /** The current generation's decoded media, from a host that decodes it. */
+    readonly decoded: Effect.Effect<DecodedMedia, ReactorError>;
+    /** The current generation's platform tracks, from a host that has them. */
+    readonly tracks: Effect.Effect<TrackMedia, ReactorError>;
+    /**
+     * A new connection generation now, from a ready connection or a lasting drop; it never replays a
+     * command. While the session reconnects a dropped connection on its own (`reconnecting`), as it
+     * does unless `Reactor.Options` turns `reconnect` off, this joins that reconnect rather than
+     * begin another: it succeeds once a connection is ready again, and fails as the reconnect stops,
+     * with the session's `lastError`, or with `Closed` if the session closes first. One whose
+     * connection is replaced while it makes its peer, as the session reconnects a drop or another
+     * reconnect asked for takes over, begins nothing either: it succeeds once a later connection is
+     * ready, and fails with the session's `lastError` once a later one is down for good, as the
+     * session's own reconnect stops or as another reconnect asked for fails meanwhile, whose failure
+     * it then takes. It fails with `InvalidState` while another reconnect asked for is under way. It
+     * fails with `Closed`, not submitted, if the session's close has begun before it takes the
+     * session over, or once its connection is open and becoming ready; one the close overtakes
+     * earlier in its negotiation fails with its connection's `Aborted`.
+     */
+    readonly reconnect: Effect.Effect<void, ReactorError>;
+    /** Idempotent. Closing an owned session attempts and then confirms remote termination. */
+    readonly close: Effect.Effect<CloseReport>;
+}
+//# sourceMappingURL=Session.d.ts.map

package/dist/Session.d.ts.map

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