reactor-effect-client 0.0.0-reserved.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Reactor Technologies, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,29 @@
+reactor-effect-client
+
+This independent SDK is not an official Reactor SDK.
+
+The canonical wire definitions and selected protocol behavior derive from:
+- reactor-client-sdks, commit 24f1865b48f03354b15402731f1b92e90ceee92a
+- reactor-runtime, commit 8e98536c6daedca298700dc45cbb5fd9e3676f16
+Their upstream licenses and notices are retained under notices/.
+The repository's packages/client/wire/proto directory contains the selected
+canonical protocol sources. The generated wire module also incorporates
+Google's protobuf Struct descriptor; see notices/google-protobuf-LICENSE.
+
+Session, correlation and observation implementations incorporate the
+user-supplied reactor-effect-client reference source. Reusable H3, coordinator,
+reference and engine behavior is extracted from the user's the-show source.
+The extracted package does not depend on the-show or ship its application policy.
+
+Effect is MIT-licensed. The package declares Effect as a peer dependency; its
+license is retained in notices/effect-LICENSE. Development tooling and
+node_modules are excluded from the npm package.
+
+The reference archive's limited TypeScript WebRTC/codec implementation is not
+part of this package's production graph. Retained owned-webrtc notices document
+the supplied reference and vector provenance; they do not indicate that a second
+WebRTC engine is shipped or supported.
+
+Host transports are separate packages: reactor-effect-browser uses the browser's
+built-in WebRTC implementation, and reactor-effect-native carries the Rust
+bridge and its libwebrtc attribution.

package/README.md

@@ -1,5 +1,127 @@
 # reactor-effect-client
 
-This namespace-only bootstrap package enables npm trusted publishing for [mannyc2/reactor-effect-client](https://github.com/mannyc2/reactor-effect-client).
+An independent Effect SDK for scoped Reactor sessions, H3 provider state and explicit orchestration. This is the portable core of the [reactor-effect workspace](https://github.com/mannyc2/reactor-effect-client); browser and native transports are the separate `reactor-effect-browser` and `reactor-effect-native` packages.
 
-It contains no SDK, executable code, scripts, or dependencies. Wait for the first qualified SDK release before installing.
+One canonical `Session` owns each allocation or attachment, its commands, connection generations, and cleanup evidence. Host packages select transport capabilities. H3 consumes that same session and exposes provider state. Applications opt into the separate orchestration and simulation modules when they need scheduling, sequence affinity, or renewal.
+
+This is not an official Reactor SDK. Protocol material is attributed in [NOTICE](./NOTICE) and [`notices/`](./notices/).
+
+## Install
+
+```sh
+npm install reactor-effect-client effect@4.0.0-rc.115
+```
+
+Effect `4.0.0-rc.115` is an exact peer dependency. Every module in this package is portable: importing it selects no host and loads no native code. Add `reactor-effect-browser` or `reactor-effect-native` for a transport.
+
+## Modules
+
+| Import                                | Purpose                                                                                        |
+| ------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `reactor-effect-client`               | Canonical `Client`, `Session`, `make`/`layer`, errors, `Coordinator`, `Peers`, and `FetchHttp` |
+| `reactor-effect-client/h3`            | H3 provider contract, state/queue/clip evidence, controls, and image validation                |
+| `reactor-effect-client/orchestration` | Scheduling, renewal, source adaptation, references, submissions, and sequences                 |
+| `reactor-effect-client/simulation`    | Production simulation source, factory, and Effect service layer                                |
+| `reactor-effect-client/testing`       | Reusable fault and PNG fixtures                                                                |
+| `reactor-effect-client/wire`          | Generated protocol messages and wire encoding/decoding                                         |
+| `reactor-effect-client/host`          | Host transport extension surface used by the first-party host packages                         |
+
+These seven paths are the complete public export map. Internal file layout does not create additional supported deep imports. `/host` is published for `reactor-effect-browser` and `reactor-effect-native`, which pin this exact version; applications compose hosts through those packages and never need it.
+
+## Session ownership
+
+The root exports the `Client` service and its `make` and `layer` constructors. They require Effect HTTP and crypto services plus a `PeerFactory`. `create` allocates a remote session; `attach` identifies an existing session without taking ownership of its remote lifetime. Both return the same scope-owned `Session` contract, and `session.connect` starts WebRTC. `createConnected` and `attachConnected` combine those steps and clean up a partial acquisition before reporting failure.
+
+Releasing an owned session attempts and independently confirms remote termination. Releasing an attached session closes its local resources and publication claims. `session.close` returns a `CloseReport` that retains local cleanup errors and remote termination uncertainty. Supervisors can inspect that evidence without allocating another owner.
+
+```ts
+import { Effect, Redacted } from "effect";
+import * as Reactor from "reactor-effect-client";
+
+const useSession = Effect.gen(function* () {
+  const client = yield* Reactor.Client;
+  const session = yield* client.create({
+    model: "your-model",
+    jwt: Redacted.make("session-token"),
+  });
+
+  yield* session.connect;
+  return yield* session.current;
+});
+```
+
+The surrounding application supplies the `Client` layer and Effect platform services. Credentials, HTTP policy, scopes, and host transport selection stay visible in composition. A host package supplies the `PeerFactory`:
+
+```ts
+import { Effect, Layer } from "effect";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import * as Reactor from "reactor-effect-client";
+import * as Native from "reactor-effect-native";
+
+const clientLayer = Reactor.layer().pipe(
+  Layer.provide(Layer.mergeAll(Reactor.FetchHttp.layer, NodeServices.layer, Native.layer())),
+);
+
+// useSession is the operation above. Acquiring a real session can be billable;
+// the repository's ordinary verification uses controlled local peers instead.
+const main = Effect.scoped(useSession).pipe(Effect.provide(clientLayer));
+```
+
+`Native.make(configuration, nativeOptions)` and `Browser.make(configuration)` also construct the canonical factory with their host peer already selected. Constructing a factory makes no allocation. HTTP and crypto services remain explicit. The root session constructor has no filesystem or path requirement.
+
+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.
+
+## Coordinator helpers
+
+`Coordinator` is a namespace on the root export. `Coordinator.make(configuration)` provides pricing, bounded token minting, session inspection, and termination reports through Effect HTTP services. Constructing this client makes no network request and requires no peer implementation.
+
+## H3 provider
+
+`H3.make(session, options)` consumes an already connected canonical `Session`. It checks the deployment contract and exposes provider state, queue and clip messages, observations, command replies, and locally correlated acceptance evidence. Provider facts remain visible even when another client authored the clip. A command ACK establishes receipt; state changes require the corresponding model evidence.
+
+```ts
+import { Effect } from "effect";
+import type { Session } from "reactor-effect-client";
+import * as H3 from "reactor-effect-client/h3";
+
+const enqueueClip = (session: Session) =>
+  Effect.gen(function* () {
+    const provider = yield* H3.make(session);
+    return yield* provider.enqueue({
+      prompt: "A slow camera move through a sunlit garden",
+      seconds: 5,
+    });
+  });
+```
+
+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.
+
+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.
+
+## Orchestration and simulation
+
+`reactor-effect-client/orchestration` owns opt-in scheduling, sequence routing, renewal, and recovering media. `fromH3` adapts a provider into a physical source, 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. Application scheduling, pricing, persona, and show policy stay outside the session and H3 layers.
+
+`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.
+
+`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.
+
+`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.
+
+`reactor-effect-client/simulation` provides `make` and `layerSim` over the same orchestration engine and media contracts. Its source and renderer hooks support unpaid local execution and controlled failures. Reusable fault and image fixtures are available through the separate `reactor-effect-client/testing` entry point.
+
+## Wire module
+
+`reactor-effect-client/wire` is generated from the tracked canonical protocol sources under [`wire/`](./wire/README.md) by `wire/generate.py` (CPython 3.13, standard library only). `bun run generate:check` fails on any byte difference; `bun run generate:wire` rewrites the module. Do not format the generated file or edit it independently of its inputs.
+
+## Declarations without DOM types
+
+Effect `4.0.0-rc.115` itself references the global `TextDecoderOptions` type in its channel declarations. A strict Node project that deliberately omits DOM types may need to declare that standard interface. The workspace's installed-package check first proves this is the sole upstream diagnostic, then applies a test-only declaration; it does not enable `skipLibCheck` or hide SDK declaration errors.
+
+## Development
+
+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 suites and `bun run typecheck` checks the source closure both with browser types and with Node types.
+
+## License
+
+Apache-2.0. Third-party and derived-source notices are retained in [NOTICE](./NOTICE) and [`notices/`](./notices/).

package/dist/FetchHttp.d.ts

@@ -0,0 +1,9 @@
+import * as Layer from "effect/Layer";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+/**
+ * A Fetch implementation of Effect's HttpClient. The small response adaptation
+ * owns both cancellation and reader-lock release, and preserves an empty body
+ * as zero bytes. Applications may supply another HttpClient implementation.
+ */
+export declare const layer: Layer.Layer<HttpClient.HttpClient, never, never>;
+//# sourceMappingURL=FetchHttp.d.ts.map

package/dist/FetchHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchHttp.d.ts","sourceRoot":"","sources":["../src/FetchHttp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAO9D;;;;GAIG;AACH,eAAO,MAAM,KAAK,kDA+DjB,CAAC"}

package/dist/FetchHttp.js

@@ -0,0 +1,63 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Stream from "effect/Stream";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import * as HttpClientError from "effect/unstable/http/HttpClientError";
+import * as HttpClientResponse from "effect/unstable/http/HttpClientResponse";
+import * as FetchHttpClient from "effect/unstable/http/FetchHttpClient";
+import { fromOwnedReadableStream } from "./media-stream.js";
+import { ReactorError } from "./errors.js";
+/**
+ * A Fetch implementation of Effect's HttpClient. The small response adaptation
+ * owns both cancellation and reader-lock release, and preserves an empty body
+ * as zero bytes. Applications may supply another HttpClient implementation.
+ */
+export const layer = Layer.effect(HttpClient.HttpClient, Effect.gen(function* () {
+    const fetch = yield* FetchHttpClient.Fetch;
+    return HttpClient.make((request, url, signal) => {
+        const send = (body) => Effect.tryPromise({
+            try: () => fetch(url, {
+                method: request.method,
+                headers: request.headers,
+                ...(body === undefined ? {} : { body }),
+                signal,
+                credentials: "omit",
+                redirect: "error",
+                // Node requires this option for streaming request bodies. It is ignored
+                // by browsers, and is not part of the portable coordinator contract.
+                ...(body instanceof ReadableStream ? { duplex: "half" } : {}),
+            }),
+            catch: (cause) => new HttpClientError.HttpClientError({
+                reason: new HttpClientError.TransportError({ request, cause }),
+            }),
+        }).pipe(Effect.map((source) => {
+            const response = HttpClientResponse.fromWeb(request, source);
+            const stream = source.body === null
+                ? Stream.empty
+                : fromOwnedReadableStream({
+                    evaluate: () => source.body,
+                    onError: (cause) => new ReactorError("Http", "HTTP response body failed", { detail: cause }),
+                }).pipe(Stream.mapError((cause) => new HttpClientError.HttpClientError({
+                    reason: new HttpClientError.DecodeError({ request, response, cause }),
+                })));
+            // Retain the official response's public accessors and identity; only its
+            // stream owns the additional reader-release contract.
+            return Object.create(response, {
+                stream: { get: () => stream },
+            });
+        }));
+        switch (request.body._tag) {
+            case "Raw":
+                return send(request.body.body);
+            case "Uint8Array":
+                return send(new Uint8Array(request.body.body));
+            case "FormData":
+                return send(request.body.formData);
+            case "Stream":
+                return Stream.toReadableStreamEffect(request.body.stream).pipe(Effect.flatMap(send));
+            default:
+                return send(undefined);
+        }
+    });
+}));
+//# sourceMappingURL=FetchHttp.js.map

package/dist/FetchHttp.js.map

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

package/dist/PeerFactory.d.ts

@@ -0,0 +1,15 @@
+import * as Context from "effect/Context";
+import type * as Effect from "effect/Effect";
+import type { Peer } from "./PeerTypes.js";
+import type { ReactorError } from "./errors.js";
+export interface PeerFactoryShape {
+    /** Validate host support before allocating a remote session. */
+    readonly check: Effect.Effect<void, ReactorError>;
+    /** A fresh transport for each connection generation. No Reactor orchestration. */
+    readonly make: () => Peer;
+}
+declare const PeerFactory_base: Context.ServiceClass<PeerFactory, "reactor-effect-client/PeerFactory", PeerFactoryShape>;
+export declare class PeerFactory extends PeerFactory_base {
+}
+export type { Peer, PeerEvent, Prepared, Channel } from "./PeerTypes.js";
+//# sourceMappingURL=PeerFactory.d.ts.map

package/dist/PeerFactory.d.ts.map

@@ -0,0 +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,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAClD,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;CAC3B;;AAED,qBAAa,WAAY,SAAQ,gBAEhC;CAAG;AAEJ,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/PeerFactory.js

@@ -0,0 +1,4 @@
+import * as Context from "effect/Context";
+export class PeerFactory extends Context.Service()("reactor-effect-client/PeerFactory") {
+}
+//# sourceMappingURL=PeerFactory.js.map

package/dist/PeerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerFactory.js","sourceRoot":"","sources":["../src/PeerFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAY1C,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EAAiC,CAC/E,mCAAmC,CACpC;CAAG"}

package/dist/PeerTypes.d.ts

@@ -0,0 +1,64 @@
+import type * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import type { ReactorError } from "./errors.js";
+import type { IceCandidate, IceServer, Mapping, Track } from "./contract.js";
+import type { RawMedia } from "./session/media.js";
+export type Channel = "control" | "data";
+export type PeerState = "new" | "connecting" | "connected" | "disconnected" | "failed" | "closed";
+/** Minimal track lifetime contract. Native peers expose owned frames instead. */
+export interface MediaTrack {
+    readonly kind: string;
+    readonly readyState: "live" | "ended";
+    clone(): MediaTrack;
+    stop(): void;
+}
+export type PeerEvent = {
+    readonly type: "state";
+    readonly state: PeerState;
+} | {
+    readonly type: "channel";
+    readonly channel: Channel;
+    readonly open: boolean;
+} | {
+    readonly type: "message";
+    readonly channel: Channel;
+    readonly bytes: Uint8Array;
+} | {
+    readonly type: "ice";
+    readonly candidate?: IceCandidate;
+} | {
+    readonly type: "track";
+    readonly name: string;
+    readonly mid: string;
+} | {
+    readonly type: "decoded";
+    readonly kind: "video" | "audio";
+    readonly name: string;
+    readonly mid: string;
+} | {
+    readonly type: "error";
+    readonly error: ReactorError;
+};
+export interface Prepared {
+    readonly sdp: string;
+    readonly mapping: readonly Mapping[];
+}
+/** Transport only. Coordinator allocation and Reactor protocol state remain session-owned. */
+export interface Peer {
+    readonly rawMedia?: RawMedia;
+    readonly shutdown?: () => Effect.Effect<void, ReactorError>;
+    readonly nativeTracks?: boolean;
+    readonly mediaSupported?: boolean;
+    prepare(servers: readonly IceServer[], tracks: readonly Track[], emit: (event: PeerEvent) => void): Effect.Effect<Prepared, ReactorError, Scope.Scope>;
+    answer(sdp: string): Effect.Effect<void, ReactorError>;
+    /** Local submission/transport acknowledgement is never a Reactor application reply. */
+    send(channel: Channel, bytes: Uint8Array<ArrayBuffer>): Effect.Effect<void, ReactorError>;
+    close(): void;
+    lease(name: string): MediaTrack;
+    release(track: MediaTrack): void;
+    direction(name: string, active: boolean): Effect.Effect<void, ReactorError>;
+    replace(name: string, track: MediaTrack | null): Effect.Effect<void, ReactorError>;
+    maxBitrate(name: string, bitsPerSecond: number): Effect.Effect<void, ReactorError>;
+    stats(): Effect.Effect<readonly unknown[], ReactorError>;
+}
+//# sourceMappingURL=PeerTypes.d.ts.map

package/dist/PeerTypes.d.ts.map

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

package/dist/PeerTypes.js

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

package/dist/PeerTypes.js.map

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

package/dist/Sequence.d.ts

@@ -0,0 +1,81 @@
+import { Effect } from "effect";
+export type SequenceStatus = "open" | "sealed" | "indeterminate" | "retired";
+export type MemberOutcome = {
+    readonly _tag: "Accepted";
+    readonly memberId: string;
+    readonly clipId: string;
+    readonly index: number;
+    readonly final: boolean;
+} | {
+    readonly _tag: "Rejected";
+    readonly memberId: string;
+    readonly reason: string | undefined;
+} | {
+    readonly _tag: "Indeterminate";
+    readonly memberId: string;
+    readonly reason: string | undefined;
+};
+export interface SequenceSnapshot<Owner> {
+    readonly id: string;
+    readonly owner: Owner;
+    readonly status: SequenceStatus;
+    readonly acceptedCount: number;
+    readonly rejectedCount: number;
+    readonly indeterminateCount: number;
+    readonly pendingCount: number;
+    readonly sealRequested: boolean;
+    readonly members: ReadonlyArray<MemberOutcome>;
+}
+declare const InvalidSequenceOptions_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InvalidSequenceOptions";
+} & Readonly<A>;
+export declare class InvalidSequenceOptions extends InvalidSequenceOptions_base<{
+    readonly reason: string;
+}> {
+}
+declare const SequenceError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SequenceError";
+} & Readonly<A>;
+export declare class SequenceError extends SequenceError_base<{
+    readonly sequenceId: string;
+    readonly reason: "capacity" | "member-capacity" | "owner-mismatch" | "sealed" | "sealing" | "indeterminate" | "retired" | "missing" | "member-missing" | "member-duplicate" | "not-releasable";
+}> {
+}
+export interface Affinity<Owner> {
+    readonly get: (id: string) => Effect.Effect<SequenceSnapshot<Owner> | undefined>;
+    readonly snapshots: Effect.Effect<ReadonlyArray<SequenceSnapshot<Owner>>>;
+    /** Bind no later than the first member dispatch. Existing ownership never changes. */
+    readonly bind: (id: string, owner: Owner) => Effect.Effect<Owner, SequenceError>;
+    /** Register one member whose remote outcome is not yet known. */
+    readonly begin: (id: string, memberId: string) => Effect.Effect<void, SequenceError>;
+    readonly accepted: (id: string, memberId: string, clipId: string, final?: boolean) => Effect.Effect<void, SequenceError>;
+    readonly rejected: (id: string, memberId: string, reason?: string, final?: boolean) => Effect.Effect<void, SequenceError>;
+    readonly uncertain: (id: string, memberId: string, reason?: string) => Effect.Effect<void, SequenceError>;
+    /**
+     * Stop admitting members. With no pending member this seals immediately;
+     * otherwise the sequence seals after every already-started member resolves.
+     */
+    readonly seal: (id: string) => Effect.Effect<void, SequenceError>;
+    /** Session death retires known sequences and makes still-pending members indeterminate. */
+    readonly retire: (owner: Owner) => Effect.Effect<void>;
+    /**
+     * Explicitly acknowledge that an indeterminate sequence has been accounted
+     * for externally. Its history stays queryable as Retired until release.
+     */
+    readonly acknowledgeIndeterminate: (id: string) => Effect.Effect<void, SequenceError>;
+    /** Explicit cleanup after history has been consumed. Open/unknown/pending work is retained. */
+    readonly release: (id: string) => Effect.Effect<void, SequenceError>;
+    readonly size: Effect.Effect<number>;
+}
+export interface Options<Owner> {
+    readonly maxEntries?: number;
+    readonly maxMembers?: number;
+    readonly sameOwner?: (left: Owner, right: Owner) => boolean;
+}
+/**
+ * Bounded sequence-affinity state. Unresolved work is never evicted to admit
+ * another sequence or member; callers explicitly account and release history.
+ */
+export declare const makeAffinity: <Owner>(options?: Options<Owner>) => Effect.Effect<Affinity<Owner>, InvalidSequenceOptions>;
+export {};
+//# sourceMappingURL=Sequence.d.ts.map