@chronista-club/unison-client 1.1.0 → 1.2.0

package/README.md

@@ -3,7 +3,7 @@
 > 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.1.0` — v1.0 GA + `/testing` subpath. Protocol API is frozen and the SDK is shipped to npm. It 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.
+**Status**: `1.1.1` — v1.0 GA + `/testing` subpath. Protocol API is frozen and the SDK is shipped to npm. It 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.
 
 ---
 

package/dist/channel/auth.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Connection-level auth (= v1.4.0)。
+ *
+ * Rust `enable_auth` / `connect_with_credential` の TS 対応。auth は専用 transport を
+ * 要求せず、 reserved `unison.auth` channel を open して `Authenticate` request を 1 回
+ * 送るだけ (= stream channel + request を持てば認証できる)。
+ *
+ * wire 不変条件・各言語 API の SSOT は `design/connection-auth.md` §5.8。
+ */
+/** reserved auth channel 名 (= Rust `network::auth::AUTH_CHANNEL_NAME`) */
+export declare const AUTH_CHANNEL_NAME = "unison.auth";
+/** credential 提示 method (= Rust `network::auth::AUTHENTICATE_METHOD`) */
+export declare const AUTHENTICATE_METHOD = "Authenticate";
+/** `unison.auth` の reserved channel meta (= codegen 不要、 SDK 内蔵) */
+export declare const AUTH_CHANNEL_META: {
+    readonly name: "unison.auth";
+    readonly backend: "stream";
+    readonly from: "client";
+    readonly lifetime: "persistent";
+    readonly events: readonly [];
+    readonly requests: {
+        readonly Authenticate: {
+            readonly request: "AuthenticateRequest";
+            readonly response: "AuthResult";
+        };
+    };
+};
+/**
+ * `Authenticate` request payload (= wire: `{ credential: number[] }`)。
+ *
+ * `interface` ではなく `type` (= 暗黙 index signature を持ち `ChannelPayload`
+ * = `Record<string, unknown>` に代入可能にするため)。
+ */
+export type AuthenticateRequest = {
+    /**
+     * opaque credential。u8 の **数値配列** (各要素 0–255)。
+     * library は中身を解釈しない (例 Creo ID JWT / API キー / 独自トークン)。
+     */
+    credential: number[];
+};
+/** `AuthResult` response payload */
+export type AuthResult = {
+    ok: boolean;
+};
+/**
+ * credential bytes を wire 互換の request payload に変換する。
+ *
+ * ⚠️ `Uint8Array` を直接 JSON 化すると `{"0":104,...}` object になり、 Rust 側
+ * `Vec<u8>` (= serde_json の数値配列 `[104,...]`) と **非互換**。必ず `Array.from`
+ * で `number[]` に変換すること。本関数がその規約を強制する単一の入口。
+ */
+export declare function toAuthenticateRequest(credential: Uint8Array): AuthenticateRequest;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/channel/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,mEAAmE;AACnE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAYE,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;OAGG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,OAAO,CAAC;CACb,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,mBAAmB,CAEjF"}

package/dist/client.d.ts

@@ -28,6 +28,13 @@ export interface UnisonConnectOptions extends ConnectOptions {
     awaitIdentity?: boolean;
     /** identity handshake の timeout ms (= default: 5000) */
     identityTimeoutMs?: number;
+    /**
+     * 接続直後に 1 回提示する credential (= connection-level auth、 v1.4.0)。指定すると
+     * identity handshake 後に `unison.auth` で Authenticate し、 拒否 (ok=false) なら
+     * connect が throw する。server が `enable_auth` 未設定なら open が reject される。
+     * 設計: `design/connection-auth.md` §5.8。
+     */
+    credential?: Uint8Array;
 }
 /**
  * 確立済み connection を束ねる SDK facade。 `connect()` で生成する
@@ -56,6 +63,19 @@ export declare class UnisonClient {
     openChannel<M extends ChannelMeta>(meta: M, openTimeoutMs?: number): Promise<UnisonChannel<M>>;
     /** Datagram channel を開設 (= 共有 datagram path、 broadcast event のみ) */
     openDatagramChannel<M extends DatagramChannelMeta>(meta: M): DatagramChannel<M>;
+    /**
+     * credential を提示して connection を認証する (= connection-level authN、 v1.4.0)。
+     *
+     * `unison.auth` channel を open して `Authenticate` request を 1 回送り、 server の
+     * verifier 結果を待つ。`ok=false` (= 拒否) なら throw。認証成功後は server 側が
+     * この connection の principal を立てるので、 以降 open する channel は per-message
+     * gate を通過できる。**他 channel を open する前に呼ぶこと** (= 未認証だと principal
+     * None で app handler に gate される)。
+     *
+     * server が `enable_auth` 未設定なら `unison.auth` が未登録で open が reject される。
+     * `connect({ credential })` は内部でこれを呼ぶ。設計: `design/connection-auth.md` §5.8。
+     */
+    authenticate(credential: Uint8Array): Promise<void>;
     /** Connection を閉じる (= dispatcher 停止 + 配下 channel を tear down) */
     disconnect(reason?: string): Promise<void>;
 }

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGlF,yDAAyD;AACzD,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,sEAAsE;IACtE,KAAK,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,YAAY;;IAOvB,kCAAkC;gBAEhC,UAAU,EAAE,UAAU,EACtB,KAAK,GAAE,KAAK,CAAC,cAAc,CAAgB,EAC3C,QAAQ,CAAC,EAAE,cAAc;IAQ3B;;;;;OAKG;IACH,cAAc,IAAI,cAAc,GAAG,SAAS;IAI5C,0EAA0E;IAC1E,MAAM;IAIN;;;;;;OAMG;IACG,WAAW,CAAC,CAAC,SAAS,WAAW,EACrC,IAAI,EAAE,CAAC,EACP,aAAa,GAAE,MAAgC,GAC9C,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAa5B,oEAAoE;IACpE,mBAAmB,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAK/E,iEAAiE;IAC3D,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMjD;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoB/E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAS9C,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGlF,yDAAyD;AACzD,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,sEAAsE;IACtE,KAAK,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,YAAY;;IAOvB,kCAAkC;gBAEhC,UAAU,EAAE,UAAU,EACtB,KAAK,GAAE,KAAK,CAAC,cAAc,CAAgB,EAC3C,QAAQ,CAAC,EAAE,cAAc;IAQ3B;;;;;OAKG;IACH,cAAc,IAAI,cAAc,GAAG,SAAS;IAI5C,0EAA0E;IAC1E,MAAM;IAIN;;;;;;OAMG;IACG,WAAW,CAAC,CAAC,SAAS,WAAW,EACrC,IAAI,EAAE,CAAC,EACP,aAAa,GAAE,MAAgC,GAC9C,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAa5B,oEAAoE;IACpE,mBAAmB,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAK/E;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzD,iEAAiE;IAC3D,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMjD;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAgC/E"}

package/dist/index.d.ts

@@ -18,6 +18,8 @@ export type { ChannelMeta, ChannelPayload, ChannelTypeMap, DatagramChannel, Data
 export { UnisonChannelImpl } from "./channel/unison_channel.js";
 export { DatagramChannelImpl } from "./channel/datagram_channel.js";
 export { DatagramDispatcher, DispatcherInner } from "./channel/dispatcher.js";
+export { AUTH_CHANNEL_META, AUTH_CHANNEL_NAME, AUTHENTICATE_METHOD, toAuthenticateRequest, } from "./channel/auth.js";
+export type { AuthResult, AuthenticateRequest } from "./channel/auth.js";
 export { FRAME_TYPE_PROTOCOL, FRAME_TYPE_RAW, decodeTypedFrame, encodeProtocolFrame, encodeRawFrame, readFrames, } from "./channel/frame.js";
 export type { DecodedFrame } from "./channel/frame.js";
 export { AsyncQueue } from "./channel/async_queue.js";
@@ -36,5 +38,5 @@ export { JsonCodec } from "./codec/json_codec.js";
 export { ProtoCodec } from "./codec/proto_codec.js";
 export type { UnisonConnectOptions } from "./client.js";
 export { UnisonClient, connect } from "./client.js";
-export declare const VERSION = "1.1.0";
+export declare const VERSION = "1.2.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,YAAY,EACX,UAAU,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,SAAS,EACT,SAAS,GACT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,oBAAoB,EACpB,4BAA4B,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EAGtB,OAAO,IAAI,gBAAgB,GAC3B,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG9E,OAAO,EACN,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,UAAU,GACV,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GACf,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACN,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GAChB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACX,eAAe,EACf,eAAe,GACf,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACN,2BAA2B,EAC3B,wBAAwB,EACxB,YAAY,GACZ,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,cAAc,GACd,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGpD,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,YAAY,EACX,UAAU,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,SAAS,EACT,SAAS,GACT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,oBAAoB,EACpB,4BAA4B,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EAGtB,OAAO,IAAI,gBAAgB,GAC3B,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG9E,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,OAAO,EACN,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,UAAU,GACV,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GACf,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACN,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GAChB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACX,eAAe,EACf,eAAe,GACf,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACN,2BAA2B,EAC3B,wBAAwB,EACxB,YAAY,GACZ,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,cAAc,GACd,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGpD,eAAO,MAAM,OAAO,UAAU,CAAC"}