hci-atrium 0.1.0 → 0.2.0

package/dist/react/use-room-connection.js

@@ -0,0 +1,85 @@
+/**
+ * ``useRoomConnection`` — the connect/reconnect skeleton shared by the browser tools that consume a
+ * room by connect code (Dashboard, Viewer).
+ *
+ * It owns exactly the transport lifecycle: ``joinRoom(code)`` → classify a join failure
+ * (``APIError`` 4xx = a bad code, anything else = unreachable) → register a terminal ``onEnd``
+ * (the typed reason becomes the status) → ``await room.connect()`` (a non-terminal failure =
+ * unreachable) → remount-safe cleanup (a ``cancelled`` flag guards every late setState, and
+ * ``room.close()`` tears the handle down). App-specific signal handling stays outside: pass
+ * ``onRoom`` to register handlers on the room the moment it exists — **before** ``connect()`` runs,
+ * so a durable-signal replay isn't missed — and return an optional cleanup from it.
+ */
+import { useEffect, useRef, useState } from "react";
+import { APIError } from "../errors.js";
+import { joinRoom } from "../rooms/index.js";
+export function useRoomConnection(code, opts) {
+    const { identity, baseUrl } = opts;
+    const [status, setStatus] = useState("connecting");
+    const [room, setRoom] = useState(null);
+    // Latest ``onRoom`` without re-running the connect effect when the caller passes an inline closure.
+    const onRoomRef = useRef(opts.onRoom);
+    onRoomRef.current = opts.onRoom;
+    useEffect(() => {
+        let cancelled = false;
+        let handle = null;
+        let teardown;
+        async function connect() {
+            let r;
+            try {
+                r = await joinRoom(code, { baseUrl: baseUrl ?? location.origin, identity });
+            }
+            catch (err) {
+                if (cancelled)
+                    return;
+                const badCode = err instanceof APIError && err.status >= 400 && err.status < 500;
+                setStatus(badCode ? "bad-code" : "unreachable");
+                return;
+            }
+            if (cancelled) {
+                r.close();
+                return;
+            }
+            handle = r;
+            setRoom(r);
+            const cleanup = onRoomRef.current?.(r);
+            teardown = typeof cleanup === "function" ? cleanup : undefined;
+            // A terminal room end (code rotated / bad code / room deleted) comes back typed — map the
+            // reason straight to the status. Fires exactly once, for a mid-session end and a connect-time
+            // reject alike; `handleEnd` has already torn the handle down, so no `close()` here.
+            let terminalEnded = false;
+            r.onEnd((reason) => {
+                terminalEnded = true;
+                if (!cancelled) {
+                    setStatus(reason);
+                    // The handle is torn down on a terminal end — drop it so callers don't hold a dead room.
+                    setRoom(null);
+                }
+            });
+            try {
+                await r.connect();
+            }
+            catch {
+                if (cancelled)
+                    return;
+                // A terminal end already classified itself via onEnd; only a non-terminal connect failure
+                // (a connect timeout / no reachable transport) falls through here → unreachable.
+                if (!terminalEnded)
+                    setStatus("unreachable");
+                return;
+            }
+            if (cancelled)
+                return;
+            setStatus("connected");
+        }
+        void connect();
+        return () => {
+            cancelled = true;
+            teardown?.();
+            handle?.close();
+            setRoom(null);
+        };
+    }, [code, identity, baseUrl]);
+    return { status, room };
+}
+//# sourceMappingURL=use-room-connection.js.map

package/dist/react/use-room-connection.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hci-atrium",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "TypeScript SDK for the Atrium framework — multimodal asset library, semantic + cross-modal search, and capability routing.",
   "type": "module",
   "license": "MIT",
@@ -22,6 +22,10 @@
     "./react": {
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js"
+    },
+    "./player": {
+      "types": "./dist/player/index.d.ts",
+      "import": "./dist/player/index.js"
     }
   },
   "peerDependencies": {