reactor-effect-client 0.2.0 → 0.3.0-rc.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +62 -6
- package/dist/FetchHttp.js +1 -1
- package/dist/FetchHttp.js.map +1 -1
- package/dist/PeerFactory.d.ts +13 -2
- package/dist/PeerFactory.d.ts.map +1 -1
- package/dist/PeerFactory.js.map +1 -1
- package/dist/PeerTypes.d.ts +2 -2
- package/dist/PeerTypes.d.ts.map +1 -1
- package/dist/Sequence.d.ts +18 -14
- package/dist/Sequence.d.ts.map +1 -1
- package/dist/Sequence.js +117 -122
- package/dist/Sequence.js.map +1 -1
- package/dist/SessionTypes.d.ts +168 -15
- package/dist/SessionTypes.d.ts.map +1 -1
- package/dist/SessionTypes.js +18 -1
- package/dist/SessionTypes.js.map +1 -1
- package/dist/bytes.js +3 -3
- package/dist/bytes.js.map +1 -1
- package/dist/contract.d.ts +120 -29
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +105 -73
- package/dist/contract.js.map +1 -1
- package/dist/coordinator/_internal/client.d.ts +111 -17
- package/dist/coordinator/_internal/client.d.ts.map +1 -1
- package/dist/coordinator/_internal/client.js +187 -74
- package/dist/coordinator/_internal/client.js.map +1 -1
- package/dist/coordinator/_internal/recording.d.ts +33 -0
- package/dist/coordinator/_internal/recording.d.ts.map +1 -0
- package/dist/coordinator/_internal/recording.js +123 -0
- package/dist/coordinator/_internal/recording.js.map +1 -0
- package/dist/coordinator/_internal/response.d.ts.map +1 -1
- package/dist/coordinator/_internal/response.js +5 -7
- package/dist/coordinator/_internal/response.js.map +1 -1
- package/dist/coordinator/_internal/schemas.d.ts +40 -6
- package/dist/coordinator/_internal/schemas.d.ts.map +1 -1
- package/dist/coordinator/_internal/schemas.js +94 -64
- package/dist/coordinator/_internal/schemas.js.map +1 -1
- package/dist/coordinator/index.d.ts +14 -2
- package/dist/coordinator/index.d.ts.map +1 -1
- package/dist/coordinator/index.js +14 -18
- package/dist/coordinator/index.js.map +1 -1
- package/dist/correlation.d.ts +15 -0
- package/dist/correlation.d.ts.map +1 -1
- package/dist/correlation.js +26 -8
- package/dist/correlation.js.map +1 -1
- package/dist/duration.d.ts +25 -0
- package/dist/duration.d.ts.map +1 -0
- package/dist/duration.js +47 -0
- package/dist/duration.js.map +1 -0
- package/dist/errors.d.ts +1264 -49
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +698 -46
- package/dist/errors.js.map +1 -1
- package/dist/h3/_internal/client.d.ts +2 -2
- package/dist/h3/_internal/client.d.ts.map +1 -1
- package/dist/h3/_internal/client.js +210 -125
- package/dist/h3/_internal/client.js.map +1 -1
- package/dist/h3/_internal/contracts.d.ts.map +1 -1
- package/dist/h3/_internal/contracts.js +2 -2
- package/dist/h3/_internal/contracts.js.map +1 -1
- package/dist/h3/_internal/deployment.d.ts.map +1 -1
- package/dist/h3/_internal/deployment.js +5 -4
- package/dist/h3/_internal/deployment.js.map +1 -1
- package/dist/h3/_internal/evidence.js +1 -1
- package/dist/h3/_internal/evidence.js.map +1 -1
- package/dist/h3/_internal/operations.d.ts +48 -0
- package/dist/h3/_internal/operations.d.ts.map +1 -0
- package/dist/h3/_internal/operations.js +230 -0
- package/dist/h3/_internal/operations.js.map +1 -0
- package/dist/h3/_internal/references.d.ts.map +1 -1
- package/dist/h3/_internal/references.js +3 -8
- package/dist/h3/_internal/references.js.map +1 -1
- package/dist/h3/_internal/request.js +1 -1
- package/dist/h3/_internal/request.js.map +1 -1
- package/dist/h3/_internal/retained.d.ts +22 -0
- package/dist/h3/_internal/retained.d.ts.map +1 -0
- package/dist/h3/_internal/retained.js +89 -0
- package/dist/h3/_internal/retained.js.map +1 -0
- package/dist/h3/_internal/state.d.ts +15 -1
- package/dist/h3/_internal/state.d.ts.map +1 -1
- package/dist/h3/_internal/state.js +69 -29
- package/dist/h3/_internal/state.js.map +1 -1
- package/dist/h3/index.d.ts +1 -1
- package/dist/h3/index.d.ts.map +1 -1
- package/dist/h3/messages.d.ts +118 -109
- package/dist/h3/messages.d.ts.map +1 -1
- package/dist/h3/messages.js +73 -51
- package/dist/h3/messages.js.map +1 -1
- package/dist/h3/types.d.ts +108 -13
- package/dist/h3/types.d.ts.map +1 -1
- package/dist/host.d.ts +6 -6
- package/dist/host.d.ts.map +1 -1
- package/dist/host.js +4 -5
- package/dist/host.js.map +1 -1
- package/dist/index.d.ts +11 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -1
- package/dist/index.js.map +1 -1
- package/dist/json.d.ts +13 -6
- package/dist/json.d.ts.map +1 -1
- package/dist/json.js +34 -14
- package/dist/json.js.map +1 -1
- package/dist/media-stream.d.ts.map +1 -1
- package/dist/media-stream.js +9 -11
- package/dist/media-stream.js.map +1 -1
- package/dist/observation.d.ts +9 -0
- package/dist/observation.d.ts.map +1 -1
- package/dist/observation.js +20 -18
- package/dist/observation.js.map +1 -1
- package/dist/orchestration/h3-source.d.ts +32 -4
- package/dist/orchestration/h3-source.d.ts.map +1 -1
- package/dist/orchestration/h3-source.js +47 -14
- package/dist/orchestration/h3-source.js.map +1 -1
- package/dist/orchestration/index.d.ts +9 -6
- package/dist/orchestration/index.d.ts.map +1 -1
- package/dist/orchestration/index.js +5 -3
- package/dist/orchestration/index.js.map +1 -1
- package/dist/orchestration/media-buffer.d.ts +12 -4
- package/dist/orchestration/media-buffer.d.ts.map +1 -1
- package/dist/orchestration/media-buffer.js +31 -11
- package/dist/orchestration/media-buffer.js.map +1 -1
- package/dist/orchestration/open-h3.d.ts +65 -0
- package/dist/orchestration/open-h3.d.ts.map +1 -0
- package/dist/orchestration/open-h3.js +65 -0
- package/dist/orchestration/open-h3.js.map +1 -0
- package/dist/orchestration/references.d.ts +5 -1
- package/dist/orchestration/references.d.ts.map +1 -1
- package/dist/orchestration/references.js +37 -34
- package/dist/orchestration/references.js.map +1 -1
- package/dist/orchestration/renewal-state.js +1 -1
- package/dist/orchestration/renewal-state.js.map +1 -1
- package/dist/orchestration/renewal.d.ts +64 -64
- package/dist/orchestration/renewal.d.ts.map +1 -1
- package/dist/orchestration/renewal.js +149 -88
- package/dist/orchestration/renewal.js.map +1 -1
- package/dist/orchestration/request.d.ts +11 -12
- package/dist/orchestration/request.d.ts.map +1 -1
- package/dist/orchestration/request.js +63 -66
- package/dist/orchestration/request.js.map +1 -1
- package/dist/orchestration/routing.d.ts.map +1 -1
- package/dist/orchestration/routing.js +17 -14
- package/dist/orchestration/routing.js.map +1 -1
- package/dist/orchestration/source-slot.d.ts +15 -5
- package/dist/orchestration/source-slot.d.ts.map +1 -1
- package/dist/orchestration/source-slot.js +40 -21
- package/dist/orchestration/source-slot.js.map +1 -1
- package/dist/orchestration/types.d.ts +594 -39
- package/dist/orchestration/types.d.ts.map +1 -1
- package/dist/orchestration/types.js +20 -0
- package/dist/orchestration/types.js.map +1 -1
- package/dist/protobuf.js +2 -2
- package/dist/protobuf.js.map +1 -1
- package/dist/session/_internal/acquire.d.ts +4 -6
- package/dist/session/_internal/acquire.d.ts.map +1 -1
- package/dist/session/_internal/acquire.js +40 -50
- package/dist/session/_internal/acquire.js.map +1 -1
- package/dist/session/_internal/cleanup.d.ts +2 -1
- package/dist/session/_internal/cleanup.d.ts.map +1 -1
- package/dist/session/_internal/cleanup.js +23 -15
- package/dist/session/_internal/cleanup.js.map +1 -1
- package/dist/session/_internal/lifecycle.d.ts +5 -0
- package/dist/session/_internal/lifecycle.d.ts.map +1 -1
- package/dist/session/_internal/lifecycle.js +16 -6
- package/dist/session/_internal/lifecycle.js.map +1 -1
- package/dist/session/_internal/remote.d.ts.map +1 -1
- package/dist/session/_internal/remote.js +16 -7
- package/dist/session/_internal/remote.js.map +1 -1
- package/dist/session/_internal/uploads.d.ts +4 -1
- package/dist/session/_internal/uploads.d.ts.map +1 -1
- package/dist/session/_internal/uploads.js +25 -27
- package/dist/session/_internal/uploads.js.map +1 -1
- package/dist/session/commands.d.ts +1 -21
- package/dist/session/commands.d.ts.map +1 -1
- package/dist/session/commands.js +1 -12
- package/dist/session/commands.js.map +1 -1
- package/dist/session/files.d.ts +10 -2
- package/dist/session/files.d.ts.map +1 -1
- package/dist/session/files.js +11 -16
- package/dist/session/files.js.map +1 -1
- package/dist/session/index.d.ts +6 -6
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js.map +1 -1
- package/dist/session/media.d.ts +53 -6
- package/dist/session/media.d.ts.map +1 -1
- package/dist/session/recorder.d.ts +24 -0
- package/dist/session/recorder.d.ts.map +1 -0
- package/dist/session/recorder.js +19 -0
- package/dist/session/recorder.js.map +1 -0
- package/dist/session.d.ts +5 -4
- package/dist/session.d.ts.map +1 -1
- package/dist/session.js +208 -109
- package/dist/session.js.map +1 -1
- package/dist/simulation/_internal/source.d.ts.map +1 -1
- package/dist/simulation/_internal/source.js +57 -48
- package/dist/simulation/_internal/source.js.map +1 -1
- package/dist/simulation/index.d.ts +4 -5
- package/dist/simulation/index.d.ts.map +1 -1
- package/dist/simulation/index.js +3 -4
- package/dist/simulation/index.js.map +1 -1
- package/dist/simulation/types.d.ts +16 -2
- package/dist/simulation/types.d.ts.map +1 -1
- package/dist/stats.d.ts.map +1 -1
- package/dist/stats.js +4 -5
- package/dist/stats.js.map +1 -1
- package/package.json +5 -4
- package/notices/owned-webrtc/Effect-MIT.txt +0 -21
- package/notices/owned-webrtc/IETF.txt +0 -43
- package/notices/owned-webrtc/LICENSE +0 -21
- package/notices/owned-webrtc/UPSTREAM.md +0 -20
- package/notices/owned-webrtc/VP8-ADAPTATION.md +0 -32
- package/notices/owned-webrtc/VP8-AUTHORS.txt +0 -42
- package/notices/owned-webrtc/VP8-LICENSE.txt +0 -25
- package/notices/owned-webrtc/VP8-PATENTS.txt +0 -21
- package/notices/owned-webrtc/Werift-MIT.txt +0 -21
- package/notices/owned-webrtc/libvpx-v1.12.0-LICENSE.txt +0 -28
- package/notices/owned-webrtc/libvpx-v1.12.0-PATENTS.txt +0 -22
- package/notices/owned-webrtc/rfc3711.txt +0 -3139
- package/notices/owned-webrtc/str0m-MIT.txt +0 -7
package/README.md
CHANGED
|
@@ -67,13 +67,67 @@ const clientLayer = Reactor.layer().pipe(
|
|
|
67
67
|
const main = Effect.scoped(useSession).pipe(Effect.provide(clientLayer));
|
|
68
68
|
```
|
|
69
69
|
|
|
70
|
-
`Native.
|
|
70
|
+
Building a host layer is its preflight: `Native.layer()` loads and verifies the native library, and `Browser.layer` detects WebRTC, so an unsupported host fails while the layer is built, before any `Client` exists to allocate a remote session. Constructing a factory makes no allocation. HTTP and crypto services remain explicit. The root session constructor has no filesystem or path requirement. A custom host provides `PeerFactory` itself: `make` returns a fresh `Peer` for each connection generation, and an optional `check` fails when the host cannot create one right now; the factory runs it before every remote allocation.
|
|
71
71
|
|
|
72
|
-
Browser and native media values stay bound to their negotiated generation. A reconnect creates a new generation; existing readers end or fail with their source. Applications obtain the new media generation explicitly, or opt into orchestration's recovering media streams.
|
|
72
|
+
Browser and native media values stay bound to their negotiated generation. A reconnect creates a new generation; existing readers end or fail with their source. Applications obtain the new media generation explicitly, or opt into orchestration's recovering media streams. Each `VideoFrame` declares its pixel `format` (`"BGRA"` from the native host); nothing converts between formats implicitly. A recorder reads a track directly and sees loss before admission as a rise in `pressure`'s `droppedVideo`/`droppedAudio`, and a reader that falls behind its bound fails with `Overflow` and counts in `readerOverflows`. Every frame carries its admission `sequence` on its track, so `recorder(stream)` yields each frame plus a `Lost { after, count }` wherever the host dropped frames, at their position. A preview keeps only the newest frame with `Stream.buffer({ capacity: 1, strategy: "sliding" })`.
|
|
73
|
+
|
|
74
|
+
## Errors
|
|
75
|
+
|
|
76
|
+
Every failure the client raises is one of four classes, each with its own `_tag`, so `Effect.catchTag` and a Schema union tell them apart:
|
|
77
|
+
|
|
78
|
+
- `ReactorError`: a session, coordinator or host failure;
|
|
79
|
+
- `CommandFailure`: a failed command, with the dispatch evidence its owner established;
|
|
80
|
+
- `AcquisitionFailure`: a failed acquisition, with the `cleanup` report of its partial lease, kept by reference;
|
|
81
|
+
- `PolicyFailure`, from `/orchestration`: a local refusal, which was never dispatched.
|
|
82
|
+
|
|
83
|
+
`isReactorFailure` recognizes any of them, and each class has an `is` guard. Re-raise a known failure through a guard rather than `instanceof ReactorError`, which none of the other three satisfies.
|
|
84
|
+
|
|
85
|
+
Each carries a tagged `reason`: route on `reason._tag`, with `Effect.catchReason`, `catchReasons` or `unwrapReason`. A `ReactorError`, `CommandFailure` or `AcquisitionFailure` reason is `Failure`, whose tag is a code such as `Timeout`, `Disconnected` or `InvalidInput`, or one of the reasons with fields of their own: `Http` (`status`, `retryAfter`, `body`), `Remote` and `RecorderDisabled` (`remoteCode`, `body`), `Native` (`status`, a Redacted `backendMessage`), `IceFailed` (`pairs`, `candidateTypes`) and `TransportFailed` (`pairs`). `ErrorCode` is the union of those tags. A `PolicyFailure` reason is a `Refusal` such as `QueueFull`, `SessionRecovering` or `Busy`, `Missing` with the request field whose clip has no known owner, or `Sequence` with the sequence's code.
|
|
86
|
+
|
|
87
|
+
`context.outcome` says whether the remote may have applied the request: `not-submitted`, `unknown` or `replied`. A `PolicyFailure`'s outcome is always `not-submitted`, so an `EngineError = CommandFailure | PolicyFailure` is read without narrowing. `isRetryable` is true for local backpressure, a connection lost before dispatch, an HTTP refusal that names a delay, and the `QueueFull` and `SessionRecovering` refusals, and never when the outcome is `unknown`; `retryAfter` is the delay an `Http` reason named.
|
|
88
|
+
|
|
89
|
+
```ts
|
|
90
|
+
const admission = (failure: EngineError) =>
|
|
91
|
+
failure.context.outcome === "unknown" ? "reconcile" : failure.isRetryable ? "defer" : "reject";
|
|
92
|
+
|
|
93
|
+
const enqueued = engine.enqueue(request).pipe(
|
|
94
|
+
Effect.catchReasons("PolicyFailure", {
|
|
95
|
+
QueueFull: () => Effect.succeed("wait for a free generation slot"),
|
|
96
|
+
SessionRecovering: () => Effect.succeed("wait for the session to recover"),
|
|
97
|
+
}),
|
|
98
|
+
);
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
`message` is written by the library and never contains provider or payload text, so spans and logs that record it stay payload-free. Provider and backend text is kept only for explicit inspection: `Http.body`, `Remote.body`, the Redacted `Native.backendMessage` and `context.detail`. Diagnostic JSON leaves all of them out, and none of them is part of the cause chain that exporters render.
|
|
102
|
+
|
|
103
|
+
## Tracing
|
|
104
|
+
|
|
105
|
+
The client traces through Effect's `Tracer`, so any tracer the application provides, such as `OtlpTracer`, receives its spans. An operation a caller can cancel has a client span at the call: `reactor.session.create` and `reactor.session.attach`, `reactor.session.connect` and `reactor.session.reconnect` (with an event per phase, from `reactor.connect.described` to `reactor.connect.ready`), `reactor.session.upload` and `reactor.session.close`, and in orchestration `reactor.orchestration.renewal.open`, `recover`, `replace` and `switch`. A request the session owns past its caller's wait, a command or control request (`reactor.session.command`, `reactor.session.control`) or an H3 enqueue (`reactor.h3.enqueue`, with `reactor.h3.reconcile`), has its span on its own execution, so the span ends with the request's outcome even after the caller stopped waiting. Termination returns a verdict rather than failing, so `reactor.coordinator.terminate` and `reactor.session.close` carry it as `reactor.termination.attempted`, `confirmed` and `evidence`: a span that ended without error does not mean a paid session stopped. Spans name identity and outcome only: never a credential, command input, a reply, an upload's name or bytes, or provider text. The renewal tick, frames, streams and heartbeats are not traced.
|
|
106
|
+
|
|
107
|
+
## Time options
|
|
108
|
+
|
|
109
|
+
Every time option is an Effect `Duration.Input` named by its role:
|
|
110
|
+
|
|
111
|
+
- on the session, `connectTimeout`, `readyTimeout`, `heartbeatInterval`, `replyTimeout` and `uploadTimeout`;
|
|
112
|
+
- on the coordinator, `requestTimeout` and the poll's `initialDelay` and `maxDelay`, and on a token, `maxSessionDuration` and `expiresAfter`, which must be whole seconds;
|
|
113
|
+
- on H3, `replyTimeout`, `uploadTimeout`, `setupTimeout`, `reconcileWindow` and `resultHookTimeout`;
|
|
114
|
+
- in orchestration, `lead`, `reconnectTimeout` and the `lifetime` that `open` returns.
|
|
115
|
+
|
|
116
|
+
A bare number is milliseconds, as everywhere in Effect, so write the unit: `lead: "30 seconds"`, because `lead: 30` is 30 milliseconds. `"Infinity"` disables the heartbeat and marks a source that never expires. A value that is NaN, negative, zero where zero means nothing, or longer than the option's maximum fails with `InvalidInput`, not submitted. Measurements, instants and media lengths stay numbers in the unit their name carries: `requestRecordingClip(seconds)`, `ClipRequest.durationSeconds`, a renewal's `ageSeconds`.
|
|
117
|
+
|
|
118
|
+
`replyTimeout` is the session's own deadline for a reply. The session's default and a command's override share the key: `session.command(name, data, { uploads, replyTimeout })`. It is not a caller's wait. After dispatch it fails with `Timeout`, outcome `unknown`, and the command's `requestId`, and the request's slot stays held until a late reply or the connection generation retires. To stop waiting without abandoning the command, fork it and bound only the join:
|
|
119
|
+
|
|
120
|
+
```ts
|
|
121
|
+
const fiber = yield * Effect.forkScoped(session.command("set_seed", { seed: 1 }));
|
|
122
|
+
const reply = yield * Fiber.join(fiber).pipe(Effect.timeout("2 seconds"));
|
|
123
|
+
// Later, Fiber.await(fiber) still reads the command's own outcome.
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
When the command must be replayed rather than awaited, prepare it as an `Orchestration.Submission`.
|
|
73
127
|
|
|
74
128
|
## Coordinator helpers
|
|
75
129
|
|
|
76
|
-
`Coordinator` is a namespace on the root export. `Coordinator.make(configuration)` provides pricing, bounded token minting, session inspection,
|
|
130
|
+
`Coordinator` is a namespace on the root export. `Coordinator.make(configuration)` provides pricing, bounded token minting, session inspection, termination reports, and `downloadClip` for a prepared recording (`clip_ready`), which polls its HLS playlist and concatenates its segments within a caller wall deadline, through Effect HTTP services. Constructing this client makes no network request and requires no peer implementation. The root exports the Schemas the client decodes a session descriptor with, `SessionDescriptor`, `Capabilities`, `Track` and `Mapping`, and derives their types from them.
|
|
77
131
|
|
|
78
132
|
## H3 provider
|
|
79
133
|
|
|
@@ -96,15 +150,17 @@ const enqueueClip = (session: Session) =>
|
|
|
96
150
|
|
|
97
151
|
Use a session created with `H3.modelName`. The adapter targets the documented `0.5.5` prompt-and-images subset of `reactor/h3-reference-to-video-turbo-realtime`. Prompt-only requests are supported. Image references accept owned bytes or explicit upload references; H3 itself requires no filesystem or path services. Reference-audio input is unsupported, and FastH3 `startingFrame`/`endingFrame` fields are absent from this contract.
|
|
98
152
|
|
|
153
|
+
`provider.operation(submission)` keeps a committed clip's facts for as long as its scope holds them: `accepted`, `reached("generated" | "started")` and `ended` each resolve once, every fact naming the transport generation of its evidence, and a clip that fails or is popped first fails the phases it never reached with `ClipEnded`. Evidence arriving after the reconcile window, or in a later transport generation of the same session, still attributes an unknown enqueue. A commit reserves the operation's slot before it sends, so a table full of unresolved operations refuses new commits with `Overflow` instead of discarding evidence; releasing the scope frees the slot.
|
|
154
|
+
|
|
99
155
|
The adapter exposes autoplay, flush, playback, reset, and other model controls as explicit operations. Creating it does not change those policies or initiate reconnect. Request `metadata` is a provider string; orchestration keeps its richer application annotation separately.
|
|
100
156
|
|
|
101
157
|
## Orchestration and simulation
|
|
102
158
|
|
|
103
|
-
`reactor-effect-client/orchestration` owns opt-in scheduling, sequence routing, renewal, and recovering media. `
|
|
159
|
+
`reactor-effect-client/orchestration` owns opt-in scheduling, sequence routing, renewal, and recovering media. `fromH3Session(session, options)` builds a physical source from one connected session, deriving its H3 provider view (exposed as `source.provider`) and its decoded media from that session, so a source cannot pair one session's commands with another's media; it needs a host with decoded media (the native host), and `make({ open, ...options })` returns a handle with `engine`, `media`, `mediaState`, sequence operations, and joined cleanup reports. The `open` effect supplies each source and its lifetime budget. `openH3({ mint, onAllocated })` is that effect for paid H3 sessions: it mints the token, allocates the session, runs `onAllocated({ session, grant })` before connecting so the owner can be recorded durably, then connects and derives the source, with the granted length as its lifetime. `Orchestration.layer(options)` provides the handle's `Engine`, `Media` and `Handle` services from one orchestration; each build opens its own paid chain, so bind the layer to a `const`. `engine.observe(options)` is the engine's gap-free observation, as `session.observe` and `provider.observe` are for theirs: it subscribes before reading, returning the current `EngineState` with a stream of every later event (apply events idempotently by `clipId`; after an `Overflow`, observe again). `handle.observe(options)` extends it to the whole handle: the engine and media state, then engine events, renewals and media-state transitions in the one order they happened. `onRenewal` runs on its own reader and never holds the handle's command permit, and the orchestration logs through Effect's logger at debug level. Application scheduling, pricing, persona, and show policy stay outside the session and H3 layers.
|
|
104
160
|
|
|
105
161
|
`ClipRequest.sameSessionAs` targets the physical session that owns a known clip, including one already ready or playing, while leaving queue position unchanged. `before` requests insertion ahead of a clip still in the generation queue. Source affinity, insertion anchors, continuation, and sequence ownership must agree; missing, conflicting, retired, or recovering ownership fails locally with a `not-submitted` outcome. This keeps a dependent request on its required session during renewal without inventing an insertion point.
|
|
106
162
|
|
|
107
|
-
`Orchestration.Submission` models an inert prepared operation. Preparation may be interrupted before commit; once execution commits, callers joining or abandoning the result do not replay the dispatch. `CommandFailure.context` distinguishes `not-submitted`, `unknown`, and `replied` outcomes independently of the transport error category
|
|
163
|
+
`Orchestration.Submission` models an inert prepared operation. Preparation may be interrupted before commit; once execution commits, callers joining or abandoning the result do not replay the dispatch. `CommandFailure.context` distinguishes `not-submitted`, `unknown`, and `replied` outcomes independently of the transport error category, and an engine command fails with `EngineError`, a `CommandFailure` or a local `PolicyFailure`.
|
|
108
164
|
|
|
109
165
|
`Orchestration.Sequences` owns bounded sequence affinity and explicit member outcomes. Partial admission is represented member-by-member as accepted, rejected, or indeterminate, and a sequence remains bound to one owner until it is sealed/retired and explicitly released.
|
|
110
166
|
|
|
@@ -120,7 +176,7 @@ Effect `4.0.0-rc.115` itself references the global `TextDecoderOptions` type in
|
|
|
120
176
|
|
|
121
177
|
## Development
|
|
122
178
|
|
|
123
|
-
This package is built and tested from the workspace root; see the repository [CONTRIBUTING](https://github.com/mannyc2/reactor-effect-client/blob/main/CONTRIBUTING.md). Inside `packages/client`, `bun test` runs the portable
|
|
179
|
+
This package is built and tested from the workspace root; see the repository [CONTRIBUTING](https://github.com/mannyc2/reactor-effect-client/blob/main/CONTRIBUTING.md). Inside `packages/client`, `bun run test` runs the portable suite under Vitest and `bun run typecheck` checks the source closure both with browser types and with Node types.
|
|
124
180
|
|
|
125
181
|
## License
|
|
126
182
|
|
package/dist/FetchHttp.js
CHANGED
|
@@ -36,7 +36,7 @@ export const layer = Layer.effect(HttpClient.HttpClient, Effect.gen(function* ()
|
|
|
36
36
|
? Stream.empty
|
|
37
37
|
: fromOwnedReadableStream({
|
|
38
38
|
evaluate: () => source.body,
|
|
39
|
-
onError: (cause) =>
|
|
39
|
+
onError: (cause) => ReactorError.fromCode("Http", "HTTP response body failed", { detail: cause }),
|
|
40
40
|
}).pipe(Stream.mapError((cause) => new HttpClientError.HttpClientError({
|
|
41
41
|
reason: new HttpClientError.DecodeError({ request, response, cause }),
|
|
42
42
|
})));
|
package/dist/FetchHttp.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"FetchHttp.js","sourceRoot":"","sources":["../src/FetchHttp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,eAAe,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,kBAAkB,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,eAAe,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAC/B,UAAU,CAAC,UAAU,EACrB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;IAC3C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;QAC9C,MAAM,IAAI,GAAG,CAAC,IAAyB,EAAE,EAAE,CACzC,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CACR,KAAK,CAAC,GAAG,EAAE;gBACT,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;gBACvC,MAAM;gBACN,WAAW,EAAE,MAAM;gBACnB,QAAQ,EAAE,OAAO;gBACjB,wEAAwE;gBACxE,qEAAqE;gBACrE,GAAG,CAAC,IAAI,YAAY,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9D,CAAC;YACJ,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,eAAe,CAAC,eAAe,CAAC;gBAClC,MAAM,EAAE,IAAI,eAAe,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aAC/D,CAAC;SACL,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7D,MAAM,MAAM,GACV,MAAM,CAAC,IAAI,KAAK,IAAI;gBAClB,CAAC,CAAC,MAAM,CAAC,KAAK;gBACd,CAAC,CAAC,uBAAuB,CAAC;oBACtB,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAK;oBAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,
|
|
1
|
+
{"version":3,"file":"FetchHttp.js","sourceRoot":"","sources":["../src/FetchHttp.ts"],"names":[],"mappings":"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"}
|
package/dist/PeerFactory.d.ts
CHANGED
|
@@ -2,11 +2,22 @@ import * as Context from "effect/Context";
|
|
|
2
2
|
import type * as Effect from "effect/Effect";
|
|
3
3
|
import type { Peer } from "./PeerTypes.js";
|
|
4
4
|
import type { ReactorError } from "./errors.js";
|
|
5
|
+
/**
|
|
6
|
+
* A host's transport capability. A host resolves and validates what it needs
|
|
7
|
+
* while its layer is built, so building the layer is the host preflight and
|
|
8
|
+
* `make` never depends on another call having run first.
|
|
9
|
+
*/
|
|
5
10
|
export interface PeerFactoryShape {
|
|
6
|
-
/** Validate host support before allocating a remote session. */
|
|
7
|
-
readonly check: Effect.Effect<void, ReactorError>;
|
|
8
11
|
/** A fresh transport for each connection generation. No Reactor orchestration. */
|
|
9
12
|
readonly make: () => Peer;
|
|
13
|
+
/**
|
|
14
|
+
* Fails when the host cannot create a peer right now, for example while a
|
|
15
|
+
* native runtime still holds an owner that did not join. The session factory
|
|
16
|
+
* runs it before every remote allocation, so a paid session is never
|
|
17
|
+
* allocated for a peer that cannot be made. It must not change what `make`
|
|
18
|
+
* does; a host with nothing to check omits it.
|
|
19
|
+
*/
|
|
20
|
+
readonly check?: Effect.Effect<void, ReactorError> | undefined;
|
|
10
21
|
}
|
|
11
22
|
declare const PeerFactory_base: Context.ServiceClass<PeerFactory, "reactor-effect-client/PeerFactory", PeerFactoryShape>;
|
|
12
23
|
export declare class PeerFactory extends PeerFactory_base {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"PeerFactory.d.ts","sourceRoot":"","sources":["../src/PeerFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,
|
|
1
|
+
{"version":3,"file":"PeerFactory.d.ts","sourceRoot":"","sources":["../src/PeerFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;CAChE;;AAED,qBAAa,WAAY,SAAQ,gBAEhC;CAAG;AAEJ,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}
|
package/dist/PeerFactory.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"PeerFactory.js","sourceRoot":"","sources":["../src/PeerFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"PeerFactory.js","sourceRoot":"","sources":["../src/PeerFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAuB1C,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EAAiC,CAC/E,mCAAmC,CACpC;CAAG"}
|
package/dist/PeerTypes.d.ts
CHANGED
|
@@ -46,7 +46,7 @@ export interface Prepared {
|
|
|
46
46
|
/** Transport only. Coordinator allocation and Reactor protocol state remain session-owned. */
|
|
47
47
|
export interface Peer {
|
|
48
48
|
readonly rawMedia?: RawMedia;
|
|
49
|
-
readonly shutdown?:
|
|
49
|
+
readonly shutdown?: Effect.Effect<void, ReactorError>;
|
|
50
50
|
readonly nativeTracks?: boolean;
|
|
51
51
|
readonly mediaSupported?: boolean;
|
|
52
52
|
prepare(servers: readonly IceServer[], tracks: readonly Track[], emit: (event: PeerEvent) => void): Effect.Effect<Prepared, ReactorError, Scope.Scope>;
|
|
@@ -59,6 +59,6 @@ export interface Peer {
|
|
|
59
59
|
direction(name: string, active: boolean): Effect.Effect<void, ReactorError>;
|
|
60
60
|
replace(name: string, track: MediaTrack | null): Effect.Effect<void, ReactorError>;
|
|
61
61
|
maxBitrate(name: string, bitsPerSecond: number): Effect.Effect<void, ReactorError>;
|
|
62
|
-
stats
|
|
62
|
+
readonly stats: Effect.Effect<readonly unknown[], ReactorError>;
|
|
63
63
|
}
|
|
64
64
|
//# sourceMappingURL=PeerTypes.d.ts.map
|
package/dist/PeerTypes.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"PeerTypes.d.ts","sourceRoot":"","sources":["../src/PeerTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AACzC,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElG,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,KAAK,IAAI,UAAU,CAAC;IACpB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACnF;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACvE;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAE7D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAED,8FAA8F;AAC9F,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"PeerTypes.d.ts","sourceRoot":"","sources":["../src/PeerTypes.ts"],"names":[],"mappings":"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"}
|
package/dist/Sequence.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { Effect } from "effect";
|
|
1
|
+
import { Effect, Schema } from "effect";
|
|
2
2
|
export type SequenceStatus = "open" | "sealed" | "indeterminate" | "retired";
|
|
3
3
|
export type MemberOutcome = {
|
|
4
4
|
readonly _tag: "Accepted";
|
|
@@ -26,20 +26,22 @@ export interface SequenceSnapshot<Owner> {
|
|
|
26
26
|
readonly sealRequested: boolean;
|
|
27
27
|
readonly members: ReadonlyArray<MemberOutcome>;
|
|
28
28
|
}
|
|
29
|
-
declare const InvalidSequenceOptions_base:
|
|
30
|
-
readonly
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
}> {
|
|
29
|
+
declare const InvalidSequenceOptions_base: Schema.Class<InvalidSequenceOptions, Schema.TaggedStruct<"InvalidSequenceOptions", {
|
|
30
|
+
readonly message: Schema.String;
|
|
31
|
+
}>, import("effect/Cause").YieldableError>;
|
|
32
|
+
/** An affinity bound that is not a positive safe integer. */
|
|
33
|
+
export declare class InvalidSequenceOptions extends InvalidSequenceOptions_base {
|
|
35
34
|
}
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
readonly sequenceId:
|
|
41
|
-
readonly
|
|
42
|
-
}
|
|
35
|
+
/** Why a sequence refused an operation. */
|
|
36
|
+
export declare const SequenceCode: Schema.Literals<readonly ["capacity", "member-capacity", "owner-mismatch", "sealed", "sealing", "indeterminate", "retired", "missing", "member-missing", "member-duplicate", "not-releasable"]>;
|
|
37
|
+
export type SequenceCode = typeof SequenceCode.Type;
|
|
38
|
+
declare const SequenceError_base: Schema.Class<SequenceError, Schema.TaggedStruct<"SequenceError", {
|
|
39
|
+
readonly sequenceId: Schema.String;
|
|
40
|
+
readonly code: Schema.Literals<readonly ["capacity", "member-capacity", "owner-mismatch", "sealed", "sealing", "indeterminate", "retired", "missing", "member-missing", "member-duplicate", "not-releasable"]>;
|
|
41
|
+
}>, import("effect/Cause").YieldableError>;
|
|
42
|
+
/** A sequence operation the affinity state refused; `code` says why. */
|
|
43
|
+
export declare class SequenceError extends SequenceError_base {
|
|
44
|
+
get message(): string;
|
|
43
45
|
}
|
|
44
46
|
export interface Affinity<Owner> {
|
|
45
47
|
readonly get: (id: string) => Effect.Effect<SequenceSnapshot<Owner> | undefined>;
|
|
@@ -75,6 +77,8 @@ export interface Options<Owner> {
|
|
|
75
77
|
/**
|
|
76
78
|
* Bounded sequence-affinity state. Unresolved work is never evicted to admit
|
|
77
79
|
* another sequence or member; callers explicitly account and release history.
|
|
80
|
+
* Every operation is one pure transition of the whole state, applied with
|
|
81
|
+
* `Ref.modify`, so none observes another half done.
|
|
78
82
|
*/
|
|
79
83
|
export declare const makeAffinity: <Owner>(options?: Options<Owner>) => Effect.Effect<Affinity<Owner>, InvalidSequenceOptions>;
|
|
80
84
|
export {};
|
package/dist/Sequence.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Sequence.d.ts","sourceRoot":"","sources":["../src/Sequence.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"Sequence.d.ts","sourceRoot":"","sources":["../src/Sequence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAO,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,CAAC;AAE7E,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC7F;IACE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,CAAC;AAEN,MAAM,WAAW,gBAAgB,CAAC,KAAK;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAChD;;;;AAED,6DAA6D;AAC7D,qBAAa,sBAAuB,SAAQ,2BAEW;CAAG;AAE1D,2CAA2C;AAC3C,eAAO,MAAM,YAAY,iMAYvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC;;;;;AAEpD,wEAAwE;AACxE,qBAAa,aAAc,SAAQ,kBAEkC;IACnE,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;AAED,MAAM,WAAW,QAAQ,CAAC,KAAK;IAC7B,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC;IACjF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1E,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IACjF,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACrF,QAAQ,CAAC,QAAQ,EAAE,CACjB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,OAAO,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,CACjB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,CAClB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAClE,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvD;;;OAGG;IACH,QAAQ,CAAC,wBAAwB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACtF,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,OAAO,CAAC,KAAK;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CAC7D;AA6DD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,YACvB,OAAO,CAAC,KAAK,CAAC,KACtB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,CA6MpD,CAAC"}
|
package/dist/Sequence.js
CHANGED
|
@@ -1,105 +1,119 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
1
|
+
import { Effect, Ref, Schema } from "effect";
|
|
2
|
+
/** An affinity bound that is not a positive safe integer. */
|
|
3
|
+
export class InvalidSequenceOptions extends Schema.TaggedError("reactor-effect-client/InvalidSequenceOptions")("InvalidSequenceOptions", { message: Schema.String }) {
|
|
3
4
|
}
|
|
4
|
-
|
|
5
|
+
/** Why a sequence refused an operation. */
|
|
6
|
+
export const SequenceCode = Schema.Literals([
|
|
7
|
+
"capacity",
|
|
8
|
+
"member-capacity",
|
|
9
|
+
"owner-mismatch",
|
|
10
|
+
"sealed",
|
|
11
|
+
"sealing",
|
|
12
|
+
"indeterminate",
|
|
13
|
+
"retired",
|
|
14
|
+
"missing",
|
|
15
|
+
"member-missing",
|
|
16
|
+
"member-duplicate",
|
|
17
|
+
"not-releasable",
|
|
18
|
+
]);
|
|
19
|
+
/** A sequence operation the affinity state refused; `code` says why. */
|
|
20
|
+
export class SequenceError extends Schema.TaggedError("reactor-effect-client/SequenceError")("SequenceError", { sequenceId: Schema.String, code: SequenceCode }) {
|
|
21
|
+
get message() {
|
|
22
|
+
return `Sequence ${this.sequenceId}: ${this.code}`;
|
|
23
|
+
}
|
|
5
24
|
}
|
|
25
|
+
const count = (members, tag) => members.reduce((total, member) => (member._tag === tag ? total + 1 : total), 0);
|
|
6
26
|
const immutableMembers = (members) => Object.freeze(members.map((member) => Object.freeze({ ...member })));
|
|
7
27
|
const snapshot = (entry) => Object.freeze({
|
|
8
28
|
id: entry.id,
|
|
9
29
|
owner: entry.owner,
|
|
10
30
|
status: entry.status,
|
|
11
|
-
acceptedCount: entry.
|
|
12
|
-
rejectedCount: entry.
|
|
13
|
-
indeterminateCount: entry.
|
|
31
|
+
acceptedCount: count(entry.members, "Accepted"),
|
|
32
|
+
rejectedCount: count(entry.members, "Rejected"),
|
|
33
|
+
indeterminateCount: count(entry.members, "Indeterminate"),
|
|
14
34
|
pendingCount: entry.pending.size,
|
|
15
35
|
sealRequested: entry.sealRequested,
|
|
16
36
|
members: immutableMembers(entry.members),
|
|
17
37
|
});
|
|
18
38
|
const positiveInteger = (value, name) => Number.isSafeInteger(value) && value > 0
|
|
19
39
|
? Effect.succeed(value)
|
|
20
|
-
: Effect.fail(new InvalidSequenceOptions({
|
|
40
|
+
: Effect.fail(new InvalidSequenceOptions({ message: `${name} must be a positive safe integer` }));
|
|
41
|
+
const refuse = (sequenceId, code) => new SequenceError({ sequenceId, code });
|
|
42
|
+
const unavailable = (id, entry) => entry.status === "sealed"
|
|
43
|
+
? refuse(id, "sealed")
|
|
44
|
+
: entry.status === "indeterminate"
|
|
45
|
+
? refuse(id, "indeterminate")
|
|
46
|
+
: entry.status === "retired"
|
|
47
|
+
? refuse(id, "retired")
|
|
48
|
+
: entry.sealRequested
|
|
49
|
+
? refuse(id, "sealing")
|
|
50
|
+
: undefined;
|
|
51
|
+
const put = (all, entry) => new Map(all).set(entry.id, entry);
|
|
21
52
|
/**
|
|
22
53
|
* Bounded sequence-affinity state. Unresolved work is never evicted to admit
|
|
23
54
|
* another sequence or member; callers explicitly account and release history.
|
|
55
|
+
* Every operation is one pure transition of the whole state, applied with
|
|
56
|
+
* `Ref.modify`, so none observes another half done.
|
|
24
57
|
*/
|
|
25
58
|
export const makeAffinity = (options = {}) => Effect.gen(function* () {
|
|
26
59
|
const maxEntries = yield* positiveInteger(options.maxEntries ?? 256, "maxEntries");
|
|
27
60
|
const maxMembers = yield* positiveInteger(options.maxMembers ?? 256, "maxMembers");
|
|
28
61
|
const sameOwner = options.sameOwner ?? Object.is;
|
|
29
62
|
const entries = yield* Ref.make(new Map());
|
|
30
|
-
const
|
|
63
|
+
const apply = (transition) => Ref.modify(entries, (all) => {
|
|
64
|
+
const step = transition(all);
|
|
65
|
+
return step instanceof SequenceError
|
|
66
|
+
? [Effect.fail(step), all]
|
|
67
|
+
: [Effect.succeed(step[0]), step[1]];
|
|
68
|
+
}).pipe(Effect.flatten);
|
|
69
|
+
/** A transition of one existing sequence. */
|
|
70
|
+
const onEntry = (id, transition) => (all) => {
|
|
71
|
+
const entry = all.get(id);
|
|
72
|
+
return entry === undefined ? refuse(id, "missing") : transition(entry, all);
|
|
73
|
+
};
|
|
31
74
|
const get = (id) => Ref.get(entries).pipe(Effect.map((all) => {
|
|
32
75
|
const entry = all.get(id);
|
|
33
76
|
return entry === undefined ? undefined : snapshot(entry);
|
|
34
77
|
}));
|
|
35
|
-
const
|
|
36
|
-
? new SequenceError({ sequenceId: id, reason: "sealed" })
|
|
37
|
-
: entry.status === "indeterminate"
|
|
38
|
-
? new SequenceError({ sequenceId: id, reason: "indeterminate" })
|
|
39
|
-
: entry.status === "retired"
|
|
40
|
-
? new SequenceError({ sequenceId: id, reason: "retired" })
|
|
41
|
-
: entry.sealRequested
|
|
42
|
-
? new SequenceError({ sequenceId: id, reason: "sealing" })
|
|
43
|
-
: undefined;
|
|
44
|
-
const set = (all, entry) => Ref.set(entries, new Map(all).set(entry.id, entry));
|
|
45
|
-
const bind = (id, owner) => lock.withPermit(Effect.gen(function* () {
|
|
46
|
-
const all = yield* Ref.get(entries);
|
|
78
|
+
const bind = (id, owner) => apply((all) => {
|
|
47
79
|
const existing = all.get(id);
|
|
48
80
|
if (existing !== undefined) {
|
|
49
81
|
if (!sameOwner(existing.owner, owner))
|
|
50
|
-
return
|
|
51
|
-
|
|
52
|
-
if (failure !== undefined)
|
|
53
|
-
return yield* failure;
|
|
54
|
-
return existing.owner;
|
|
82
|
+
return refuse(id, "owner-mismatch");
|
|
83
|
+
return unavailable(id, existing) ?? [existing.owner, all];
|
|
55
84
|
}
|
|
56
85
|
if (all.size >= maxEntries)
|
|
57
|
-
return
|
|
58
|
-
|
|
59
|
-
id,
|
|
86
|
+
return refuse(id, "capacity");
|
|
87
|
+
return [
|
|
60
88
|
owner,
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
const begin = (id, memberId) => lock.withPermit(Effect.gen(function* () {
|
|
73
|
-
const all = yield* Ref.get(entries);
|
|
74
|
-
const entry = all.get(id);
|
|
75
|
-
if (entry === undefined)
|
|
76
|
-
return yield* new SequenceError({ sequenceId: id, reason: "missing" });
|
|
89
|
+
put(all, {
|
|
90
|
+
id,
|
|
91
|
+
owner,
|
|
92
|
+
status: "open",
|
|
93
|
+
pending: new Set(),
|
|
94
|
+
sealRequested: false,
|
|
95
|
+
members: [],
|
|
96
|
+
}),
|
|
97
|
+
];
|
|
98
|
+
});
|
|
99
|
+
const begin = (id, memberId) => apply(onEntry(id, (entry, all) => {
|
|
77
100
|
const failure = unavailable(id, entry);
|
|
78
101
|
if (failure !== undefined)
|
|
79
|
-
return
|
|
102
|
+
return failure;
|
|
80
103
|
if (entry.pending.has(memberId) ||
|
|
81
|
-
entry.members.some((member) => member.memberId === memberId))
|
|
82
|
-
return
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
}
|
|
87
|
-
yield* set(all, { ...entry, pending: new Set(entry.pending).add(memberId) });
|
|
104
|
+
entry.members.some((member) => member.memberId === memberId))
|
|
105
|
+
return refuse(id, "member-duplicate");
|
|
106
|
+
if (entry.pending.size + entry.members.length >= maxMembers)
|
|
107
|
+
return refuse(id, "member-capacity");
|
|
108
|
+
return [undefined, put(all, { ...entry, pending: new Set(entry.pending).add(memberId) })];
|
|
88
109
|
}));
|
|
89
|
-
const settle = (id, memberId, outcome,
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
if (!entry.pending.has(memberId)) {
|
|
95
|
-
if (entry.members.some((member) => member.memberId === memberId)) {
|
|
96
|
-
return yield* new SequenceError({ sequenceId: id, reason: "member-duplicate" });
|
|
97
|
-
}
|
|
98
|
-
return yield* new SequenceError({ sequenceId: id, reason: "member-missing" });
|
|
99
|
-
}
|
|
110
|
+
const settle = (id, memberId, outcome, terminal, requestSeal = false) => apply(onEntry(id, (entry, all) => {
|
|
111
|
+
if (!entry.pending.has(memberId))
|
|
112
|
+
return entry.members.some((member) => member.memberId === memberId)
|
|
113
|
+
? refuse(id, "member-duplicate")
|
|
114
|
+
: refuse(id, "member-missing");
|
|
100
115
|
const pending = new Set(entry.pending);
|
|
101
116
|
pending.delete(memberId);
|
|
102
|
-
const counts = update(entry);
|
|
103
117
|
const sealRequested = entry.sealRequested || requestSeal;
|
|
104
118
|
const status = entry.status === "indeterminate" || entry.status === "retired"
|
|
105
119
|
? entry.status
|
|
@@ -108,48 +122,43 @@ export const makeAffinity = (options = {}) => Effect.gen(function* () {
|
|
|
108
122
|
: sealRequested && pending.size === 0
|
|
109
123
|
? "sealed"
|
|
110
124
|
: entry.status;
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
125
|
+
return [
|
|
126
|
+
undefined,
|
|
127
|
+
put(all, {
|
|
128
|
+
...entry,
|
|
129
|
+
status,
|
|
130
|
+
sealRequested,
|
|
131
|
+
pending,
|
|
132
|
+
members: [...entry.members, outcome(entry)],
|
|
133
|
+
}),
|
|
134
|
+
];
|
|
119
135
|
}));
|
|
120
|
-
const accepted = (id, memberId, clipId, final = false) => settle(id, memberId, (entry) => ({
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
acceptedCount: entry.acceptedCount,
|
|
127
|
-
rejectedCount: entry.rejectedCount + 1,
|
|
128
|
-
indeterminateCount: entry.indeterminateCount,
|
|
136
|
+
const accepted = (id, memberId, clipId, final = false) => settle(id, memberId, (entry) => ({
|
|
137
|
+
_tag: "Accepted",
|
|
138
|
+
memberId,
|
|
139
|
+
clipId,
|
|
140
|
+
index: count(entry.members, "Accepted"),
|
|
141
|
+
final,
|
|
129
142
|
}), "known", final);
|
|
130
|
-
const
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
indeterminateCount: entry.indeterminateCount + 1,
|
|
134
|
-
}), "unknown");
|
|
135
|
-
const seal = (id) => lock.withPermit(Effect.gen(function* () {
|
|
136
|
-
const all = yield* Ref.get(entries);
|
|
137
|
-
const entry = all.get(id);
|
|
138
|
-
if (entry === undefined)
|
|
139
|
-
return yield* new SequenceError({ sequenceId: id, reason: "missing" });
|
|
143
|
+
const rejected = (id, memberId, reason, final = false) => settle(id, memberId, () => ({ _tag: "Rejected", memberId, reason }), "known", final);
|
|
144
|
+
const uncertain = (id, memberId, reason) => settle(id, memberId, () => ({ _tag: "Indeterminate", memberId, reason }), "unknown");
|
|
145
|
+
const seal = (id) => apply(onEntry(id, (entry, all) => {
|
|
140
146
|
if (entry.status === "indeterminate")
|
|
141
|
-
return
|
|
147
|
+
return refuse(id, "indeterminate");
|
|
142
148
|
if (entry.status === "retired")
|
|
143
|
-
return
|
|
149
|
+
return refuse(id, "retired");
|
|
144
150
|
if (entry.status === "sealed")
|
|
145
|
-
return;
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
+
return [undefined, all];
|
|
152
|
+
return [
|
|
153
|
+
undefined,
|
|
154
|
+
put(all, {
|
|
155
|
+
...entry,
|
|
156
|
+
sealRequested: true,
|
|
157
|
+
status: entry.pending.size === 0 ? "sealed" : "open",
|
|
158
|
+
}),
|
|
159
|
+
];
|
|
151
160
|
}));
|
|
152
|
-
const retire = (owner) =>
|
|
161
|
+
const retire = (owner) => Ref.update(entries, (all) => {
|
|
153
162
|
const next = new Map(all);
|
|
154
163
|
for (const [id, entry] of all) {
|
|
155
164
|
if (!sameOwner(entry.owner, owner))
|
|
@@ -167,35 +176,21 @@ export const makeAffinity = (options = {}) => Effect.gen(function* () {
|
|
|
167
176
|
next.set(id, {
|
|
168
177
|
...entry,
|
|
169
178
|
status: "indeterminate",
|
|
170
|
-
indeterminateCount: entry.indeterminateCount + entry.pending.size,
|
|
171
179
|
pending: new Set(),
|
|
172
180
|
members: [...entry.members, ...pendingOutcomes],
|
|
173
181
|
});
|
|
174
182
|
}
|
|
175
183
|
return next;
|
|
176
|
-
})
|
|
177
|
-
const acknowledgeIndeterminate = (id) =>
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
return yield* new SequenceError({ sequenceId: id, reason: "not-releasable" });
|
|
184
|
-
}
|
|
185
|
-
yield* set(all, { ...entry, status: "retired" });
|
|
186
|
-
}));
|
|
187
|
-
const release = (id) => lock.withPermit(Effect.gen(function* () {
|
|
188
|
-
const all = yield* Ref.get(entries);
|
|
189
|
-
const entry = all.get(id);
|
|
190
|
-
if (entry === undefined)
|
|
191
|
-
return yield* new SequenceError({ sequenceId: id, reason: "missing" });
|
|
192
|
-
if (entry.pending.size !== 0 ||
|
|
193
|
-
(entry.status !== "sealed" && entry.status !== "retired")) {
|
|
194
|
-
return yield* new SequenceError({ sequenceId: id, reason: "not-releasable" });
|
|
195
|
-
}
|
|
184
|
+
});
|
|
185
|
+
const acknowledgeIndeterminate = (id) => apply(onEntry(id, (entry, all) => entry.status !== "indeterminate" || entry.pending.size !== 0
|
|
186
|
+
? refuse(id, "not-releasable")
|
|
187
|
+
: [undefined, put(all, { ...entry, status: "retired" })]));
|
|
188
|
+
const release = (id) => apply(onEntry(id, (entry, all) => {
|
|
189
|
+
if (entry.pending.size !== 0 || (entry.status !== "sealed" && entry.status !== "retired"))
|
|
190
|
+
return refuse(id, "not-releasable");
|
|
196
191
|
const next = new Map(all);
|
|
197
192
|
next.delete(id);
|
|
198
|
-
|
|
193
|
+
return [undefined, next];
|
|
199
194
|
}));
|
|
200
195
|
return {
|
|
201
196
|
get,
|