@chronista-club/unison-client 1.0.0-rc.1

package/README.md

@@ -0,0 +1,130 @@
+# @chronista-club/unison-client
+
+> TypeScript client SDK for the [Unison protocol](https://github.com/chronista-club/club-unison).
+> Part of the **v1.0 polyglot client base** (= server stays Rust, client polyglot for adoption surface).
+
+**Status**: `1.0.0-alpha.2` — v1.0 sprint feature-complete. The SDK genuinely talks to the Rust server over **real WebTransport** (verified by `tests/integration/webtransport_e2e.test.ts`). See [design/typescript-client-api.md](../../design/typescript-client-api.md) for the SDK design contract.
+
+---
+
+## What this is
+
+Unison is a KDL schema-driven, QUIC-based protocol with both **stream channels** (request/response + event) and **datagram channels** (broadcast event). The Rust crate `club-unison` ships the server and Rust client. This package is the **TypeScript client SDK** that lets:
+
+- **Browsers** (via [WebTransport](https://www.w3.org/TR/webtransport/)) speak unison directly to a Rust server (= no REST gateway)
+- **Node.js** clients connect server-to-server in TypeScript (= optional, v1.x)
+
+The asymmetric design — **fat Rust server, thin polyglot clients** — keeps complexity (TLS, accept loops, connection management) in one language while broadening the adoption surface.
+
+## v1.0 status (= what shipped)
+
+The v1.0 sprint is feature-complete. All phases are done:
+
+- **Phase 1** ✅ — KDL-driven TypeScript code generation (type interfaces + channel metadata)
+- **Phase 2a-e** ✅ — Package skeleton, WebTransport transport adapter, channel wrappers
+  (`UnisonChannel<M>` / `DatagramChannel<M>`), codecs (`JsonCodec` + `ProtoCodec`), tests + bundle build
+- **Phase 3** ✅ — `connect()` facade + Vantage Point dashboard proof point demo
+- **Phase 4-5** ✅ — `unison` developer CLI (ping / sniff / mock / schema-lint), `ErrorCategory` framework
+- **Phase 6** ✅ — Rust-compatible wire format + **real WebTransport E2E** (TS SDK ↔ Rust server)
+- **Phase 7** ✅ — Cross-language E2E integration tests in CI
+- **Phase 8** ✅ — User-facing docs (this file + the guides below)
+
+What is **v1.x deferred** (honest gaps):
+
+- TypeScript codegen for datagram channels (Rust codegen has it; TS handwrites the meta for now)
+- proto-descriptor codegen (`ProtoCodec` works, but KDL → descriptor generation is not automated)
+- Node native WebTransport (Node needs the `@fails-components/webtransport` polyfill)
+- Safari / Firefox WebTransport (Chromium-based browsers are the official support matrix)
+- per-channel codec override, auto-reconnect helper
+
+See [`design/typescript-client-api.md`](../../design/typescript-client-api.md) for the full API design contract.
+
+## Quickstart
+
+For the full end-to-end walkthrough (KDL schema → Rust server → TS client), see
+[`guides/quickstart.md`](../../guides/quickstart.md). API reference:
+[`guides/typescript-sdk.md`](../../guides/typescript-sdk.md).
+
+```typescript
+import { connect, type ChannelMeta } from "@chronista-club/unison-client";
+
+const EchoMeta = {
+  name: "echo",
+  backend: "stream",
+  from: "client",
+  lifetime: "persistent",
+  events: [],
+  requests: { Echo: { request: "EchoReq", response: "EchoResp" } },
+} as const satisfies ChannelMeta;
+
+// Connect — cert pinning for a dev self-signed server (loopback only).
+const client = await connect({
+  url: "https://127.0.0.1:4439",
+  trust: { certHash: "<CERT_HASH printed by the server>" },
+  awaitIdentity: false,
+});
+
+const echo = await client.openChannel(EchoMeta);
+const reply = await echo.request("Echo", { text: "hello-unison" });
+console.log(reply); // { text: "hello-unison" }
+
+await echo.close();
+await client.disconnect();
+```
+
+## Architecture
+
+```
+clients/typescript/
+├── src/
+│   ├── index.ts           ← public entry (= re-exports the surface below)
+│   ├── client.ts          ← connect() + UnisonClient facade
+│   ├── transport/         ← WebTransport adapter
+│   ├── channel/           ← UnisonChannel / DatagramChannel + dispatcher + frame
+│   ├── codec/             ← JsonCodec + ProtoCodec
+│   ├── wire/              ← Rust-compatible packet / protocol-message encode/decode
+│   └── error/             ← ErrorCategory framework
+├── examples/              ← vp-dashboard.ts (Vantage Point proof point demo)
+├── tests/                 ← vitest unit + integration tests (incl. real WebTransport E2E)
+├── package.json
+├── tsconfig.json
+├── vite.config.ts
+└── vitest.config.ts
+```
+
+## Building from source
+
+```bash
+cd clients/typescript
+npm install            # install dev deps (typescript / vite / vitest)
+npm run build          # vite build → dist/index.js + tsc → dist/index.d.ts
+npm test               # vitest run
+npm run typecheck      # tsc --noEmit (= type safety verification)
+```
+
+## Versioning policy
+
+- TS package version is kept in **major.minor sync** with the Rust crate `club-unison`
+- `1.0.0-alpha.x` — implementation phases, breaking changes allowed (current)
+- `1.0.0-rc.x` — feature complete, dogfood phase with the chronista-club ecosystem
+- `1.0.0` — stability commitment, breaking changes require v2.0
+  (dogfood exit criteria: 3+ caller × 3+ months × critical bug 0)
+
+## Compatibility
+
+| Component | Required |
+|---|---|
+| Browser | Chromium-based 95+ (= WebTransport native) |
+| Node.js | 20+ (= ESM + modern features) |
+| TypeScript | 5.7+ (= consumer's tsconfig.json target) |
+| Rust server | `club-unison` major.minor 一致 |
+
+Safari / Firefox WebTransport support: tracked in v1.x roadmap, polyfill via WebSocket fallback is deferred to caller demand.
+
+## License
+
+MIT — see [LICENSE](../../LICENSE-MIT) in the repository root.
+
+## Contributing
+
+This SDK is part of the `chronista-club/club-unison` monorepo. Issues + PRs at https://github.com/chronista-club/club-unison.

package/dist/channel/async_queue.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AsyncQueue (= Phase 2c 内部 util)。
+ *
+ * push 駆動の値を `for await` で pull できる単一消費者 queue。 channel の
+ * `events()` が server push / datagram demux の payload を AsyncIterable に
+ * 橋渡しするのに使う。 producer は非同期境界なしで `push` / `end` を呼べる。
+ */
+/** push された値を AsyncIterable として配る単一消費者 queue */
+export declare class AsyncQueue<T> implements AsyncIterableIterator<T> {
+    #private;
+    /** 値を 1 件投入 (= 待機中 consumer があれば即配送) */
+    push(value: T): void;
+    /** queue を終端 (= 以降の `next()` は done、 待機中 consumer を解放) */
+    end(): void;
+    next(): Promise<IteratorResult<T>>;
+    /** consumer が `break` した時の cleanup hook (= queue 終端) */
+    return(): Promise<IteratorResult<T>>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+//# sourceMappingURL=async_queue.d.ts.map

package/dist/channel/async_queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async_queue.d.ts","sourceRoot":"","sources":["../../src/channel/async_queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gDAAgD;AAChD,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,qBAAqB,CAAC,CAAC,CAAC;;IAM5D,wCAAwC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAWpB,0DAA0D;IAC1D,GAAG,IAAI,IAAI;IAUX,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAalC,wDAAwD;IACxD,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAKpC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC;CAGnD"}

package/dist/channel/datagram_channel.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Datagram channel wrapper (= Phase 2c)。
+ *
+ * 共有 datagram path 上の virtual stream。 受信は `DatagramDispatcher` が
+ * `channelId` で demux した payload を pull、 送信は `channelId` varint prefix +
+ * codec-encoded payload を組み立てて `Connection.sendDatagram` に渡す。
+ *
+ * Rust `network/datagram_channel.rs` の `DatagramChannel` に対応する TS port。
+ */
+import type { Codec } from "../codec/codec.js";
+import type { Connection } from "../transport/types.js";
+import type { DatagramDispatcher } from "./dispatcher.js";
+import type { ChannelPayload, DatagramChannel, DatagramChannelMeta, EventName, EventPayload, EventType } from "./types.js";
+/**
+ * `DatagramChannel` の concrete impl。 `openDatagramChannel(meta)` から構築する
+ * (= caller は直接 new せず factory 経由)。
+ */
+export declare class DatagramChannelImpl<M extends DatagramChannelMeta> implements DatagramChannel<M> {
+    #private;
+    readonly name: M["name"];
+    readonly channelId: M["channelId"];
+    /** @internal `openDatagramChannel` から呼ぶ。 */
+    constructor(meta: M, connection: Connection, dispatcher: DatagramDispatcher, codec?: Codec<ChannelPayload>);
+    events(): AsyncIterableIterator<EventType<M>>;
+    sendEvent<N extends EventName<M>>(_name: N, payload: EventPayload<M, N>): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=datagram_channel.d.ts.map

package/dist/channel/datagram_channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datagram_channel.d.ts","sourceRoot":"","sources":["../../src/channel/datagram_channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,SAAS,EACV,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,qBAAa,mBAAmB,CAAC,CAAC,SAAS,mBAAmB,CAC5D,YAAW,eAAe,CAAC,CAAC,CAAC;;IAE7B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IAWnC,4CAA4C;gBAE1C,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,kBAAkB,EAC9B,KAAK,GAAE,KAAK,CAAC,cAAc,CAAgB;IAuB7C,MAAM,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAIvC,SAAS,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EACpC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC;IAUhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAMvB"}

package/dist/channel/default_codec.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Channel payload の default codec (= Phase 2c)。
+ *
+ * design §5.1 の通り全 channel が default で JSON wire。 `JsonCodec.shared` は
+ * 構造的で状態を持たないため、 `ChannelPayload` 型に narrow した 1 instance を
+ * 全 channel で再利用する (= ProtoCodec は KDL→proto-descriptor codegen 待ち)。
+ */
+import type { Codec } from "../codec/codec.js";
+import type { ChannelPayload } from "./types.js";
+/** 全 channel 共有の default payload codec (= JsonCodec.shared を型 narrow) */
+export declare const defaultCodec: Codec<ChannelPayload>;
+//# sourceMappingURL=default_codec.d.ts.map

package/dist/channel/default_codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default_codec.d.ts","sourceRoot":"","sources":["../../src/channel/default_codec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,yEAAyE;AACzE,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,cAAc,CACJ,CAAC"}

package/dist/channel/dispatcher.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Datagram dispatcher (= Phase 2c) — Rust `network/datagram_dispatcher.rs` の TS port。
+ *
+ * `Connection.datagrams()` は単一の exclusive reader iterator しか払い出せない。
+ * dispatcher はその唯一の iterator を **占有** し、 受信 datagram 先頭の varint
+ * `channel_id` を decode、 登録済 channel handler に fan-out する。
+ *
+ * 配送特性 (= datagram semantics):
+ * - **Unreliable**: malformed varint / 未登録 channel_id / buffer 溢れは silently drop。
+ * - **Unordered**: 到着順 deliver、 sequence 保証なし。
+ * - **Best-effort**: dispatcher loop 自身は決して詰まらない (= 各 handler に try-push)。
+ */
+import type { Connection } from "../transport/types.js";
+/** 1 channel 分の受信 sink (= dispatcher が demux 後の payload を push) */
+export interface DatagramSink {
+    /** demux 済 payload を push (= best-effort、 buffer 溢れは sink 側で drop) */
+    push(payload: Uint8Array): void;
+    /** channel close 時に dispatcher が呼ぶ (= pending iterator を終端) */
+    end(): void;
+}
+/**
+ * Datagram dispatch table の data 層 (= `quinn` 抜きで test 可能、 Rust の
+ * `DispatcherInner` 相当)。 純粋な `channel_id → sink` map 管理に責務限定。
+ */
+export declare class DispatcherInner {
+    #private;
+    /** `channelId` に sink を登録 (= 既存は replace、 旧 sink は end) */
+    register(channelId: number, sink: DatagramSink): void;
+    /** `channelId` の登録解除 */
+    unregister(channelId: number): void;
+    /** 登録 channel 数 (= test / debug 用) */
+    get handlerCount(): number;
+    /**
+     * 1 datagram を dispatch (= varint decode → handler lookup → push)。
+     * malformed / 未登録 は silently drop (= unreliable semantics)。
+     */
+    dispatch(datagram: Uint8Array): void;
+    /** 全 handler を end して clear (= connection 終端時) */
+    clear(): void;
+}
+/**
+ * Per-connection datagram dispatcher の runtime 層 (= Rust `DatagramDispatcher` 相当)。
+ *
+ * `Connection.datagrams()` の単一 iterator を background loop で drain し、
+ * `DispatcherInner` に流す。 `register` / `unregister` で channel handler を出し入れ、
+ * `stop()` で loop 停止 + 全 handler clear。
+ */
+export declare class DatagramDispatcher {
+    #private;
+    constructor(connection: Connection);
+    /** background drain loop を起動 (= idempotent、 初回 `register` で呼ぶ) */
+    start(): void;
+    /** `channelId` に sink を登録 (= 初回で drain loop を起動) */
+    register(channelId: number, sink: DatagramSink): void;
+    /** `channelId` の登録解除 */
+    unregister(channelId: number): void;
+    /** 登録 channel 数 (= test / debug 用) */
+    get handlerCount(): number;
+    /** dispatcher を停止 (= drain loop 終了 + 全 handler clear) */
+    stop(): void;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/channel/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/channel/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,+DAA+D;IAC/D,GAAG,IAAI,IAAI,CAAC;CACb;AAED;;;GAGG;AACH,qBAAa,eAAe;;IAG1B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAKrD,wBAAwB;IACxB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOnC,sCAAsC;IACtC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAQpC,kDAAkD;IAClD,KAAK,IAAI,IAAI;CAId;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;;gBAMjB,UAAU,EAAE,UAAU;IAIlC,kEAAkE;IAClE,KAAK,IAAI,IAAI;IAkBb,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAKrD,wBAAwB;IACxB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAInC,sCAAsC;IACtC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,yDAAyD;IACzD,IAAI,IAAI,IAAI;CAIb"}

package/dist/channel/frame.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Channel stream の wire frame (= Phase 6b、 Rust server と byte 一致)。
+ *
+ * `UnisonChannel` (= QUIC / WebTransport bidi stream) を流れる typed frame の
+ * encode/decode。 Rust `crates/unison-protocol/src/network/quic.rs` の
+ * `read_typed_frame` / `write_typed_frame` と完全一致する layout:
+ *
+ * ```text
+ * [4B BE total_len] [1B frame_type] [payload]
+ * ```
+ *
+ * - `total_len` = frame_type (1B) + payload の合計
+ * - `frame_type` = 0x00 PROTOCOL (= UnisonPacket) / 0x01 RAW (= 生 bytes)
+ * - PROTOCOL frame の payload = UnisonPacket バイト列
+ *   (= `[u32 BE header_len][buffa PacketHeader][buffa ProtocolMessage]`)
+ *
+ * 旧 Phase 2c の `[4B len][2B hdrLen][JSON header][payload]` 自家製 frame は
+ * 廃止 (= Rust server と通信不能だった)。
+ */
+import { type PacketOptions } from "../wire/packet.js";
+import { type ProtocolMessage } from "../wire/protocol_message.js";
+/** frame type tag (= Rust `FRAME_TYPE_*`) */
+export declare const FRAME_TYPE_PROTOCOL = 0;
+export declare const FRAME_TYPE_RAW = 1;
+/**
+ * `ProtocolMessage` を 1 本の PROTOCOL typed frame へ encode する。
+ *
+ * layout: `[4B total_len][0x00][UnisonPacket]`。 `UnisonPacket` の中身は
+ * `[u32 header_len][PacketHeader][ProtocolMessage]`。
+ */
+export declare function encodeProtocolFrame(message: ProtocolMessage, packetOpts?: PacketOptions): Uint8Array;
+/** 生 byte 列を 1 本の RAW typed frame へ encode する (= `[4B len][0x01][data]`) */
+export declare function encodeRawFrame(data: Uint8Array): Uint8Array;
+/** typed frame の decode 結果 */
+export type DecodedFrame = {
+    type: "protocol";
+    message: ProtocolMessage;
+} | {
+    type: "raw";
+    data: Uint8Array;
+};
+/**
+ * 1 本の typed frame body (= 4B length prefix を剥がした後の `[1B type][payload]`)
+ * を decode する。
+ */
+export declare function decodeTypedFrame(body: Uint8Array): DecodedFrame;
+/**
+ * `ReadableStream<Uint8Array>` から typed frame body (= `[1B type][payload]`) を
+ * 1 本ずつ取り出す async generator。 byte 跨ぎ chunk を内部 buffer で結合する。
+ */
+export declare function readFrames(readable: ReadableStream<Uint8Array>): AsyncGenerator<Uint8Array>;
+//# sourceMappingURL=frame.d.ts.map

package/dist/channel/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/channel/frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAA8B,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AAErC,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,IAAO,CAAC;AACxC,eAAO,MAAM,cAAc,IAAO,CAAC;AAKnC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,UAAU,GAAE,aAAkB,GAC7B,UAAU,CAIZ;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAE3D;AAYD,8BAA8B;AAC9B,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAc/D;AAED;;;GAGG;AACH,wBAAuB,UAAU,CAC/B,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,cAAc,CAAC,UAAU,CAAC,CAgC5B"}

package/dist/channel/identity.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Identity handshake — server 自己紹介の受信 (= Phase 6b)。
+ *
+ * Unison server は接続直後に bidi stream を 1 本 open し、 そこへ
+ * `__identity` の `ProtocolMessage` (= msgType event、 payload は JSON 化した
+ * `ServerIdentity`) を 1 本送って stream を finish する
+ * (= Rust `quic.rs::handle_connection` の identity 送出ロジック)。
+ *
+ * TS client は `connect()` 時にこの stream を accept し identity を読む。
+ */
+import type { BidiStream, Connection } from "../transport/types.js";
+/** identity handshake のデフォルト timeout */
+export declare const DEFAULT_IDENTITY_TIMEOUT_MS = 5000;
+/** channel の方向 (= Rust `ChannelDirection`、 snake_case) */
+export type ChannelDirection = "server_to_client" | "client_to_server" | "bidirectional";
+/** channel の状態 (= Rust `ChannelStatus`、 snake_case) */
+export type ChannelStatus = "available" | "busy" | "unavailable";
+/** server が advertise する 1 channel の情報 (= Rust `ChannelInfo`) */
+export interface ChannelInfo {
+    name: string;
+    direction: ChannelDirection;
+    lifetime: string;
+    status: ChannelStatus;
+}
+/** server の自己紹介情報 (= Rust `ServerIdentity`) */
+export interface ServerIdentity {
+    name: string;
+    version: string;
+    namespace: string;
+    channels: ChannelInfo[];
+    metadata: unknown;
+}
+/**
+ * 1 本の identity stream を drain して `ServerIdentity` を返す。
+ *
+ * stream の最初の PROTOCOL frame を読み、 `__identity` method なら payload を
+ * JSON parse する。 frame が無い / method 不一致なら reject。
+ */
+export declare function readIdentity(stream: BidiStream): Promise<ServerIdentity>;
+/**
+ * connection が server から identity stream を受けるのを待ち、 `ServerIdentity`
+ * を返す。 `timeoutMs` 内に来なければ reject する。
+ *
+ * `connect()` の中で 1 回だけ呼ぶ (= identity stream は接続あたり 1 本)。
+ */
+export declare function performIdentityHandshake(connection: Connection, timeoutMs?: number): Promise<ServerIdentity>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/channel/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/channel/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKpE,wCAAwC;AACxC,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,CAAC;AAEpB,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC;AAEjE,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAuB9E;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,UAAU,EACtB,SAAS,GAAE,MAAoC,GAC9C,OAAO,CAAC,cAAc,CAAC,CAwBzB"}

package/dist/channel/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Channel 抽象 (= Phase 2c)。
+ *
+ * 全通信は channel 経由 (RPC は廃止)。 channel には 2 系統ある:
+ * - `UnisonChannel` — stream backend (= QUIC bidi stream)、 request/response + event
+ * - `DatagramChannel` — datagram backend (= 共有 datagram path)、 broadcast event のみ
+ *
+ * 両 interface は Phase 1 codegen が出力する `<Name>ChannelMeta` const に対して
+ * generic。 `as const` literal narrowing により、 caller code で event 名 /
+ * request 名が compile-time に絞り込まれる。
+ *
+ * codegen は meta に **phantom `__types` field** を埋め込む (= 生成 interface への
+ * link)。 `EventType<M>` / `RequestType<M,N>` / `ResponseType<M,N>` はこの field
+ * 経由で event/request 名 → 実 interface を解決する (= design doc §3.2/§4.2)。
+ */
+/**
+ * meta が `__types` 経由で運ぶ payload 型 map。 codegen が
+ * `<Channel>ChannelEventTypes` / `<Channel>ChannelRequestTypes` を生成し、
+ * これを `{ events; requests }` として束ねる。 runtime 値は `undefined`。
+ */
+export interface ChannelTypeMap {
+    readonly events: Readonly<Record<string, unknown>>;
+    readonly requests: Readonly<Record<string, {
+        request: unknown;
+        response: unknown;
+    }>>;
+}
+/** Stream backend の channel meta 形状 (= Phase 1 codegen 出力の構造的 subset) */
+export interface ChannelMeta {
+    readonly name: string;
+    readonly backend: "stream";
+    readonly from: "client" | "server" | "either";
+    readonly lifetime: "transient" | "persistent";
+    readonly events: readonly string[];
+    readonly requests: Readonly<Record<string, {
+        readonly request: string;
+        readonly response: string;
+    }>>;
+    /** codegen 埋め込みの phantom 型 carrier (= runtime undefined、 型のみ) */
+    readonly __types?: ChannelTypeMap;
+}
+/** Datagram backend の channel meta 形状 (= `channelId` 必須、 `requests` 空) */
+export interface DatagramChannelMeta {
+    readonly name: string;
+    readonly backend: "datagram";
+    readonly channelId: number;
+    readonly from: "client" | "server" | "either";
+    readonly lifetime: "transient" | "persistent";
+    readonly events: readonly string[];
+    readonly requests: Readonly<Record<string, never>>;
+    /** codegen 埋め込みの phantom 型 carrier (= runtime undefined、 型のみ) */
+    readonly __types?: ChannelTypeMap;
+}
+/** meta の `events` 配列から event 名 union を導出 */
+export type EventName<M> = M extends {
+    events: readonly (infer N)[];
+} ? N & string : never;
+/** meta の `requests` map から request 名 union を導出 */
+export type RequestName<M> = M extends {
+    requests: infer R;
+} ? keyof R & string : never;
+/**
+ * Channel payload の構造型 fallback。 codegen meta を渡さなかった場合
+ * (= raw `ChannelMeta` で開いた場合) の event/request payload 型。
+ */
+export type ChannelPayload = Record<string, unknown>;
+/**
+ * meta `M` の全 event payload 型 union (= `events()` が yield する型)。
+ * `__types` を持つ生成 meta なら実 interface の union、 持たなければ
+ * `ChannelPayload` に degrade する。
+ */
+export type EventType<M> = M extends {
+    __types?: infer T;
+} ? T extends ChannelTypeMap ? T["events"][keyof T["events"]] : ChannelPayload : ChannelPayload;
+/** meta `M` の event `N` の payload 型 (= `sendEvent()` 引数) */
+export type EventPayload<M, N extends PropertyKey> = M extends {
+    __types?: infer T;
+} ? T extends ChannelTypeMap ? N extends keyof T["events"] ? T["events"][N] : ChannelPayload : ChannelPayload : ChannelPayload;
+/** meta `M` の request `N` の request payload 型 */
+export type RequestType<M, N extends PropertyKey> = M extends {
+    __types?: infer T;
+} ? T extends ChannelTypeMap ? N extends keyof T["requests"] ? T["requests"][N]["request"] : ChannelPayload : ChannelPayload : ChannelPayload;
+/** meta `M` の request `N` の response payload 型 */
+export type ResponseType<M, N extends PropertyKey> = M extends {
+    __types?: infer T;
+} ? T extends ChannelTypeMap ? N extends keyof T["requests"] ? T["requests"][N]["response"] : ChannelPayload : ChannelPayload : ChannelPayload;
+/**
+ * Stream channel — request/response + server-pushed event。
+ *
+ * QUIC bidi stream に対応、 ordered + reliable。 `request()` は length-prefixed
+ * frame を送り response frame を await、 `events()` は server push を AsyncIterable
+ * で配る。 payload 型は meta の `__types` 経由で生成 interface に narrow される。
+ */
+export interface UnisonChannel<M extends ChannelMeta = ChannelMeta> {
+    /** KDL schema 上の channel 名 */
+    readonly name: M["name"];
+    /**
+     * Request を送り response を await する (= ordered/reliable)。
+     * `name` は `M["requests"]` の key に narrow、 戻り値は `ResponseType<M, N>`。
+     */
+    request<N extends RequestName<M>>(name: N, payload: RequestType<M, N>): Promise<ResponseType<M, N>>;
+    /** Server push event の購読 (= `for await`、 break で channel close cascade) */
+    events(): AsyncIterableIterator<EventType<M>>;
+    /** Event を送信 (= client → server、 応答なし) */
+    sendEvent<N extends EventName<M>>(name: N, payload: EventPayload<M, N>): Promise<void>;
+    /** Channel を閉じる (= 配下 stream を tear down、 idempotent) */
+    close(): Promise<void>;
+}
+/**
+ * Datagram channel — broadcast event のみ (= request 不可)。
+ *
+ * 共有 datagram path 上の virtual stream、 `channelId` varint prefix で demux。
+ * unordered + unreliable。 caller は基本 `events()` で subscribe するのみ。
+ */
+export interface DatagramChannel<M extends DatagramChannelMeta = DatagramChannelMeta> {
+    /** KDL schema 上の channel 名 */
+    readonly name: M["name"];
+    /** schema-time fixed の demux 識別子 (= varint prefix として wire 出現) */
+    readonly channelId: M["channelId"];
+    /** Datagram broadcast event の購読 (= unordered/unreliable) */
+    events(): AsyncIterableIterator<EventType<M>>;
+    /** Event を datagram で送信 (= best-effort、 MTU 超過は reject) */
+    sendEvent<N extends EventName<M>>(name: N, payload: EventPayload<M, N>): Promise<void>;
+    /** Channel を閉じる (= dispatcher から unregister、 idempotent) */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/channel/types.d.ts.map

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

package/dist/channel/unison_channel.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Stream channel wrapper (= Phase 2c、 Phase 6b で Rust wire 互換に再構築)。
+ *
+ * QUIC / WebTransport bidi stream 上の request/response + server-pushed event。
+ * 内部で 1 本の recv loop を持ち、 受信 `ProtocolMessage` を `msgType` で振り分ける:
+ * - `response` / `error` → `id` 対応の pending request を resolve/reject
+ * - `event` / `request` → events() の AsyncIterable queue に流す
+ *
+ * Rust `network/channel.rs` の `UnisonChannel` に対応する TS port。 wire は
+ * `frame.ts` の typed frame (= `[4B len][0x00][UnisonPacket]`) で Rust server と
+ * byte 一致する。
+ *
+ * ## channel open
+ *
+ * stream open 直後に `ProtocolMessage { method: "__channel:{name}",
+ * msgType: request }` を 1 本送る (= Rust `client.rs::open_channel` と同形)。
+ * Phase 6c 以降、 Rust server は同 stream へ `open_ack` (= method
+ * `__channel_ack`、 open request と同 id) を返す。 `waitAccepted` はこの ack を
+ * await し、 Response なら resolve / Error (= channel-not-found) なら reject /
+ * timeout なら reject する (= optimistic-resolve を廃止)。
+ */
+import type { Codec } from "../codec/codec.js";
+import type { BidiStream } from "../transport/types.js";
+import type { ChannelMeta, ChannelPayload, EventName, EventPayload, EventType, RequestName, RequestType, ResponseType, UnisonChannel } from "./types.js";
+/** channel open handshake のデフォルト timeout (= 後方互換のため引数に残す) */
+export declare const DEFAULT_OPEN_TIMEOUT_MS = 5000;
+/**
+ * `UnisonChannel` の concrete impl。 `openChannel(meta)` から構築する
+ * (= caller は直接 new せず factory 経由)。
+ */
+export declare class UnisonChannelImpl<M extends ChannelMeta> implements UnisonChannel<M> {
+    #private;
+    readonly name: M["name"];
+    /** @internal `openChannel` から呼ぶ。 */
+    constructor(meta: M, stream: BidiStream, codec?: Codec<ChannelPayload>);
+    /**
+     * @internal `openChannel` から呼ぶ。 `__channel:{name}` open frame を送り、
+     * server の `open_ack` を await する (= Phase 6c、 real accept signal)。
+     *
+     * server は同 stream へ open request と同 id の `__channel_ack` frame を返す:
+     * - Response → accept、 resolve する
+     * - Error → nack (= channel-not-found 等)、 reject する
+     *
+     * `timeoutMs` 内に ack が来なければ reject する。 send 自体が失敗 / accept
+     * 前に stream が終端した場合も no-accept として reject する。
+     */
+    waitAccepted(timeoutMs?: number): Promise<void>;
+    request<N extends RequestName<M>>(name: N, payload: RequestType<M, N>): Promise<ResponseType<M, N>>;
+    events(): AsyncIterableIterator<EventType<M>>;
+    sendEvent<N extends EventName<M>>(name: N, payload: EventPayload<M, N>): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=unison_channel.d.ts.map

package/dist/channel/unison_channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unison_channel.d.ts","sourceRoot":"","sources":["../../src/channel/unison_channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAgBxD,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,SAAS,EACT,YAAY,EACZ,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAKpB,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAc7C;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,WAAW,CAClD,YAAW,aAAa,CAAC,CAAC,CAAC;;IAE3B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAgBzB,oCAAoC;gBAElC,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,UAAU,EAClB,KAAK,GAAE,KAAK,CAAC,cAAc,CAAgB;IAS7C;;;;;;;;;;OAUG;IACG,YAAY,CAAC,SAAS,GAAE,MAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IA8HxE,OAAO,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EACpC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACzB,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IA2B9B,MAAM,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAIvC,SAAS,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EACpC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC;IAYV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}

package/dist/channel/varint.d.ts

@@ -0,0 +1,20 @@
+/**
+ * LEB128 varint (= Phase 2c)。
+ *
+ * datagram channel の `channel_id` prefix encoding。 Rust 側
+ * `network/datagram_channel.rs` の `encode_varint` / `decode_varint` と wire 互換。
+ * proto3 と同じ unsigned LEB128。
+ */
+/** u64 を表す varint の最大 byte 数 (= LEB128 で 64 bit) */
+export declare const VARINT_MAX_LEN = 10;
+/** `value` を LEB128 varint として encode (= 非負整数のみ) */
+export declare function encodeVarint(value: number): Uint8Array;
+/**
+ * `bytes` 先頭から varint を読み `{ value, consumed }` を返す。
+ * malformed (= 10 byte 超え / premature EOF) は `null` (= caller が drop)。
+ */
+export declare function decodeVarint(bytes: Uint8Array): {
+    value: number;
+    consumed: number;
+} | null;
+//# sourceMappingURL=varint.d.ts.map

package/dist/channel/varint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"varint.d.ts","sourceRoot":"","sources":["../../src/channel/varint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oDAAoD;AACpD,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAYtD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU5C"}