@irisrun/client-sdk 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,32 @@
+# @irisrun/client-sdk
+
+**A portable client for durable, resumable sessions.** A thin, isomorphic
+(browser + Node ≥ 24) client over the `iris serve` protocol that holds only a
+`{ sessionId, continuationToken }` handle — *not* a live connection — so a reload
+or a brand-new process can rebuild the client from the saved handle and resume the
+**same** session.
+
+## What it is
+
+`IrisClient` mirrors the channel's two-identifier discipline exactly: it adopts
+the rotated `continuationToken` the server returns and presents it on the next
+turn. Sends are buffered or streamed over **SSE** via callbacks. Zero runtime
+dependencies — only global `fetch` / `TextDecoder` / `ReadableStream` — and it
+defines its own local `StreamEvent` wire union (it does *not* import
+`@irisrun/channel-rest`, which would pull in `node:http`). The WebSocket transport
+is **reserved** (held-connection model) and throws loudly until implemented — SSE
+and buffered today.
+
+## Use it
+
+```ts
+import { IrisClient } from "@irisrun/client-sdk";
+
+const client  = new IrisClient({ baseUrl });          // start a fresh session
+const resumed = new IrisClient({ baseUrl, handle });  // resume from a SessionHandle
+```
+
+See **[docs/Channels](../../docs/channels.md)**.
+
+---
+Part of [Iris](../../README.md) — own, portable, verifiable state.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@irisrun/client-sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
-  "description": "Iris client SDK — a thin, isomorphic (browser + Node 24) client over the `iris serve` two-identifier protocol (sessionId minted by the channel; single-use continuationToken owned/rotated by the channel). Buffered + streaming (SSE). Zero runtime deps: uses only global fetch / TextDecoder / ReadableStream. Defines its OWN local StreamEvent wire union (no @irisrun/channel-rest import — that pulls node:http). WS transport is reserved (held-connection model; throws loudly until implemented).",
+  "description": "Portable client for durable, resumable sessions — a thin, isomorphic (browser + Node 24) client over the `iris serve` two-identifier protocol; holds only a {sessionId, continuationToken} handle, so a reload or a fresh process resumes the same session. Buffered + streaming over SSE. Zero runtime deps (global fetch / TextDecoder / ReadableStream); defines its OWN local StreamEvent wire union (no @irisrun/channel-rest import — that pulls node:http). The WS transport is reserved (held-connection model; throws loudly until implemented).",
   "exports": {
     ".": {
       "iris-src": "./src/index.ts",
@@ -11,7 +11,7 @@
     }
   },
   "dependencies": {
-    "@irisrun/core": "^0.1.0"
+    "@irisrun/core": "^0.2.0"
   },
   "license": "MIT",
   "engines": {