@soulcraft/sdk 2.0.1 → 2.1.0

package/dist/client/index.d.ts

@@ -3,8 +3,6 @@
  * @description Browser/client entry point for @soulcraft/sdk. Exports everything needed
  * for kit apps running in a browser context to connect to a Soulcraft product backend.
  *
- * ## SDK 2.0 — Namespace-aware transports (recommended)
- *
  * Use `createSoulcraftProxy()` with a namespace-aware transport for full access to
  * all 25 SDK namespaces (brainy, chat, graph, search, ai, media, realtime, etc.).
  *
@@ -12,16 +10,7 @@
  * - {@link PostMessageRpcTransport} — `soulcraft:request` PostMessage. WebContainer iframes.
  * - {@link WsTransport} — MessagePack binary over WebSocket. Real-time, bidirectional.
  *
- * ## Legacy transports (brainy-only)
- *
- * These transports only support the `brainy` namespace. They still work for backward
- * compatibility but should be migrated to the namespace-aware transports above.
- *
- * - `LegacyHttpTransport` — `/api/brainy/rpc` only.
- * - `LegacyPostMessageTransport` — `brainy:request` only.
- * - `WorkshopTransport` — `workshop:request` non-brainy relay (superseded by PostMessageRpcTransport).
- *
- * @example SDK 2.0 — full namespace access
+ * @example Full namespace access via HTTP
  * ```typescript
  * import { createSoulcraftProxy, HttpRpcTransport } from '@soulcraft/sdk/client'
  *
@@ -30,7 +19,7 @@
  * const graph = await sdk.graph.getData()
  * ```
  *
- * @example SDK 2.0 — PostMessage in WebContainer iframe
+ * @example PostMessage in WebContainer iframe
  * ```typescript
  * import { createSoulcraftProxy, PostMessageRpcTransport } from '@soulcraft/sdk/client'
  *
@@ -45,36 +34,14 @@ export { createSoulcraftProxy } from './namespace-proxy.js';
 export type { NamespaceTransport } from './namespace-proxy.js';
 export { HttpNamespaceTransport, PostMessageNamespaceTransport, HttpRpcTransport, PostMessageRpcTransport, } from '../transports/http-namespace.js';
 export type { HttpNamespaceTransportOptions } from '../transports/http-namespace.js';
-export { createClientSDK } from './create-client-sdk.js';
-/**
- * @deprecated Use {@link HttpRpcTransport} for full namespace support.
- * This transport only supports the `brainy` namespace at `/api/brainy/rpc`.
- */
-export { HttpTransport as LegacyHttpTransport } from '../transports/http.js';
-/**
- * @deprecated Use {@link PostMessageRpcTransport} for full namespace support.
- * This transport only supports `brainy:request` / `brainy:response`.
- */
-export { PostMessageTransport as LegacyPostMessageTransport } from '../transports/postmessage.js';
 export { WsTransport } from '../transports/ws.js';
 export { SseTransport } from '../transports/sse.js';
-export type { PostMessageRequest, PostMessageResponse } from '../transports/postmessage.js';
-export type { SDKTransport } from '../transports/transport.js';
-/** @deprecated Use `createSoulcraftProxy()` for full namespace access. */
-export { createBrainyProxy } from '../modules/brainy/proxy.js';
-/** @deprecated Use `createSoulcraftProxy()` for full namespace access. */
-export { createAppContext } from '../modules/app-context/index.js';
-export type { CreateAppContextOptions, AppContext } from '../modules/app-context/index.js';
-/** @deprecated Use {@link PostMessageRpcTransport} which handles all namespaces. */
-export { WorkshopTransport } from '../transports/workshop.js';
-export type { WorkshopRequest, WorkshopResponse, WorkshopStreamChunk, } from '../transports/workshop.js';
 export { createYjsProvider } from '../transports/yjs-provider.js';
 export type { YjsProvider } from '../transports/yjs-provider.js';
-export { joinHallRoom } from '../modules/hall/browser.js';
-export type { JoinHallRoomOptions } from '../modules/hall/browser.js';
-export type { HallRoomHandle, HallRoomHandleEvents, TranscriptEvent, ConceptMentionEvent, RelationProposedEvent, SpeakerChangedEvent, PeerJoinedEvent, PeerLeftEvent, RoomOptions, RecordingManifest, ConceptInput, } from '../modules/hall/types.js';
+export { joinHallRoom, joinHallPubsub, getWhepUrl, getHlsUrl } from '../modules/hall/browser.js';
+export type { JoinHallRoomOptions, JoinHallPubsubOptions } from '../modules/hall/browser.js';
+export type { HallRoomHandle, HallRoomHandleEvents, HallPubsubHandle, HallPubsubHandleEvents, HallPeerRole, RoleChangedEvent, TranscriptEvent, ConceptMentionEvent, RelationProposedEvent, SpeakerChangedEvent, PeerJoinedEvent, PeerLeftEvent, RoomOptions, RecordingManifest, ConceptInput, TopicSubscribedEvent, TopicUnsubscribedEvent, TopicMessageEvent, PresenceUpdateEvent, PresenceEntry, PresenceSnapshotEvent, ReplayEntry, } from '../modules/hall/types.js';
 export type { SoulcraftSDK } from '../types.js';
-export type { ClientSDKOptions } from '../types.js';
 export type { SoulcraftNamespaces } from '../namespaces.js';
 export type { SoulcraftBrainy } from '../modules/brainy/types.js';
 export type { BrainyChangeEvent } from '../modules/brainy/events.js';

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAOH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG9D,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAOpF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGxD;;;GAGG;AACH,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC5E;;;GAGG;AACH,OAAO,EAAE,oBAAoB,IAAI,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAGjG,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAC3F,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,0EAA0E;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAG9D,0EAA0E;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,YAAY,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAG1F,oFAAoF;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAOlC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG9D,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAGpF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAChG,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAC5F,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,WAAW,GACZ,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/client/index.js

@@ -3,8 +3,6 @@
  * @description Browser/client entry point for @soulcraft/sdk. Exports everything needed
  * for kit apps running in a browser context to connect to a Soulcraft product backend.
  *
- * ## SDK 2.0 — Namespace-aware transports (recommended)
- *
  * Use `createSoulcraftProxy()` with a namespace-aware transport for full access to
  * all 25 SDK namespaces (brainy, chat, graph, search, ai, media, realtime, etc.).
  *
@@ -12,16 +10,7 @@
  * - {@link PostMessageRpcTransport} — `soulcraft:request` PostMessage. WebContainer iframes.
  * - {@link WsTransport} — MessagePack binary over WebSocket. Real-time, bidirectional.
  *
- * ## Legacy transports (brainy-only)
- *
- * These transports only support the `brainy` namespace. They still work for backward
- * compatibility but should be migrated to the namespace-aware transports above.
- *
- * - `LegacyHttpTransport` — `/api/brainy/rpc` only.
- * - `LegacyPostMessageTransport` — `brainy:request` only.
- * - `WorkshopTransport` — `workshop:request` non-brainy relay (superseded by PostMessageRpcTransport).
- *
- * @example SDK 2.0 — full namespace access
+ * @example Full namespace access via HTTP
  * ```typescript
  * import { createSoulcraftProxy, HttpRpcTransport } from '@soulcraft/sdk/client'
  *
@@ -30,7 +19,7 @@
  * const graph = await sdk.graph.getData()
  * ```
  *
- * @example SDK 2.0 — PostMessage in WebContainer iframe
+ * @example PostMessage in WebContainer iframe
  * ```typescript
  * import { createSoulcraftProxy, PostMessageRpcTransport } from '@soulcraft/sdk/client'
  *
@@ -41,47 +30,16 @@
  * }
  * ```
  */
-// ═══════════════════════════════════════════════════════════════════════════════
-// SDK 2.0 — Namespace proxy + transports (recommended)
-// ═══════════════════════════════════════════════════════════════════════════════
 // ── Namespace proxy factory ─────────────────────────────────────────────────
 export { createSoulcraftProxy } from './namespace-proxy.js';
 // ── Namespace-aware transports ──────────────────────────────────────────────
 export { HttpNamespaceTransport, PostMessageNamespaceTransport, HttpRpcTransport, PostMessageRpcTransport, } from '../transports/http-namespace.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Legacy — Brainy-only transports + factories (deprecated in SDK 2.0)
-// ═══════════════════════════════════════════════════════════════════════════════
-// ── Client SDK factory (creates brainy-only SDK) ────────────────────────────
-export { createClientSDK } from './create-client-sdk.js';
-// ── Brainy-only transports ──────────────────────────────────────────────────
-/**
- * @deprecated Use {@link HttpRpcTransport} for full namespace support.
- * This transport only supports the `brainy` namespace at `/api/brainy/rpc`.
- */
-export { HttpTransport as LegacyHttpTransport } from '../transports/http.js';
-/**
- * @deprecated Use {@link PostMessageRpcTransport} for full namespace support.
- * This transport only supports `brainy:request` / `brainy:response`.
- */
-export { PostMessageTransport as LegacyPostMessageTransport } from '../transports/postmessage.js';
-// Keep WsTransport and SseTransport — they'll be extended for namespace support.
+// ── Real-time transports ────────────────────────────────────────────────────
 export { WsTransport } from '../transports/ws.js';
 export { SseTransport } from '../transports/sse.js';
-// ── Brainy proxy factory (brainy-only) ──────────────────────────────────────
-/** @deprecated Use `createSoulcraftProxy()` for full namespace access. */
-export { createBrainyProxy } from '../modules/brainy/proxy.js';
-// ── App context factory ─────────────────────────────────────────────────────
-/** @deprecated Use `createSoulcraftProxy()` for full namespace access. */
-export { createAppContext } from '../modules/app-context/index.js';
-// ── Workshop transport (superseded by PostMessageRpcTransport) ──────────────
-/** @deprecated Use {@link PostMessageRpcTransport} which handles all namespaces. */
-export { WorkshopTransport } from '../transports/workshop.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Shared — used by both SDK 2.0 and legacy
-// ═══════════════════════════════════════════════════════════════════════════════
 // ── Y.js provider (collaborative editing) ───────────────────────────────────
 export { createYjsProvider } from '../transports/yjs-provider.js';
-// ── Hall room client (browser WebRTC) ───────────────────────────────────────
-export { joinHallRoom } from '../modules/hall/browser.js';
+// ── Hall room + pub/sub clients (browser) ───────────────────────────────────
+export { joinHallRoom, joinHallPubsub, getWhepUrl, getHlsUrl } from '../modules/hall/browser.js';
 export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from '../modules/brainy/errors.js';
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,kFAAkF;AAClF,uDAAuD;AACvD,kFAAkF;AAElF,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D,+EAA+E;AAC/E,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AAGxC,kFAAkF;AAClF,sEAAsE;AACtE,kFAAkF;AAElF,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,+EAA+E;AAC/E;;;GAGG;AACH,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC5E;;;GAGG;AACH,OAAO,EAAE,oBAAoB,IAAI,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAEjG,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAInD,+EAA+E;AAC/E,0EAA0E;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAE9D,+EAA+E;AAC/E,0EAA0E;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAGlE,+EAA+E;AAC/E,oFAAoF;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAO7D,kFAAkF;AAClF,2CAA2C;AAC3C,kFAAkF;AAElF,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAGjE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAsBzD,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D,+EAA+E;AAC/E,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AAGxC,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAGjE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAgChG,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/client/namespace-proxy.d.ts

@@ -15,10 +15,9 @@
  *
  * ## Special namespace: brainy
  *
- * The `brainy` namespace is special — it delegates to the existing
- * `createBrainyProxy()` for full backward compatibility with all existing
- * Brainy methods, sub-APIs (vfs, versions, neural, counts), and lifecycle
- * methods (onDataChange, offDataChange, isAlive, close).
+ * The `brainy` namespace uses the same recursive Proxy pattern but with
+ * special handling for Brainy sub-APIs (vfs, versions, neural, counts) and
+ * lifecycle methods (onDataChange, offDataChange, isAlive, close).
  *
  * ## Streaming
  *

package/dist/client/namespace-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"namespace-proxy.d.ts","sourceRoot":"","sources":["../../src/client/namespace-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO/C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAErE;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IAEjF;;OAEG;IACH,OAAO,IAAI,OAAO,CAAA;IAElB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,kBAAkB,GAAG,YAAY,CAEhF"}
+{"version":3,"file":"namespace-proxy.d.ts","sourceRoot":"","sources":["../../src/client/namespace-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO/C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAErE;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IAEjF;;OAEG;IACH,OAAO,IAAI,OAAO,CAAA;IAElB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,kBAAkB,GAAG,YAAY,CAEhF"}

package/dist/client/namespace-proxy.js

@@ -15,10 +15,9 @@
  *
  * ## Special namespace: brainy
  *
- * The `brainy` namespace is special — it delegates to the existing
- * `createBrainyProxy()` for full backward compatibility with all existing
- * Brainy methods, sub-APIs (vfs, versions, neural, counts), and lifecycle
- * methods (onDataChange, offDataChange, isAlive, close).
+ * The `brainy` namespace uses the same recursive Proxy pattern but with
+ * special handling for Brainy sub-APIs (vfs, versions, neural, counts) and
+ * lifecycle methods (onDataChange, offDataChange, isAlive, close).
  *
  * ## Streaming
  *

package/dist/client/namespace-proxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"namespace-proxy.js","sourceRoot":"","sources":["../../src/client/namespace-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAgDH,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA6B;IAChE,OAAO,gBAAgB,CAAC,SAAS,CAAiB,CAAA;AACpD,CAAC;AAED,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,SAA6B;IACrD,OAAO,IAAI,KAAK,CAAC,cAAa,CAAC,EAAE;QAC/B,GAAG,CAAC,OAAO,EAAE,IAAqB;YAChC,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC9C,IAAI,IAAI,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAA;YAErC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAEvB,gCAAgC;YAChC,IAAI,EAAE,KAAK,YAAY;gBAAE,OAAO,SAAS,CAAA;YACzC,IAAI,EAAE,KAAK,SAAS;gBAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;YACtD,IAAI,EAAE,KAAK,OAAO;gBAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;YAElD,6DAA6D;YAC7D,OAAO,qBAAqB,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;QACjD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,qBAAqB,CAC5B,SAA6B,EAC7B,EAAU,EACV,UAAkB;IAElB,OAAO,IAAI,KAAK,CAAC,cAAa,CAAC,EAAE;QAC/B,GAAG,CAAC,OAAO,EAAE,IAAqB;YAChC,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC9C,IAAI,IAAI,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAA;YAErC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAE5B,qEAAqE;YACrE,iDAAiD;YACjD,IAAI,EAAE,KAAK,QAAQ,IAAI,UAAU,KAAK,EAAE,IAAI,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,OAAO,qBAAqB,CAAC,SAAS,EAAE,UAAU,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;YAClE,CAAC;YAED,0BAA0B;YAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;YAClE,OAAO,qBAAqB,CAAC,SAAS,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAA;QACvD,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAe;YACtC,+DAA+D;YAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,sEAAsE;gBACtE,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,0BAA0B,EAAE,kCAAkC,EAAE,eAAe,CAAC,CAC3F,CAAA;YACH,CAAC;YACD,OAAO,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;QAC/C,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA"}
+{"version":3,"file":"namespace-proxy.js","sourceRoot":"","sources":["../../src/client/namespace-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAgDH,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA6B;IAChE,OAAO,gBAAgB,CAAC,SAAS,CAAiB,CAAA;AACpD,CAAC;AAED,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,SAA6B;IACrD,OAAO,IAAI,KAAK,CAAC,cAAa,CAAC,EAAE;QAC/B,GAAG,CAAC,OAAO,EAAE,IAAqB;YAChC,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC9C,IAAI,IAAI,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAA;YAErC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAEvB,gCAAgC;YAChC,IAAI,EAAE,KAAK,YAAY;gBAAE,OAAO,SAAS,CAAA;YACzC,IAAI,EAAE,KAAK,SAAS;gBAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;YACtD,IAAI,EAAE,KAAK,OAAO;gBAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;YAElD,6DAA6D;YAC7D,OAAO,qBAAqB,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;QACjD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,qBAAqB,CAC5B,SAA6B,EAC7B,EAAU,EACV,UAAkB;IAElB,OAAO,IAAI,KAAK,CAAC,cAAa,CAAC,EAAE;QAC/B,GAAG,CAAC,OAAO,EAAE,IAAqB;YAChC,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC9C,IAAI,IAAI,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAA;YAErC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAE5B,qEAAqE;YACrE,iDAAiD;YACjD,IAAI,EAAE,KAAK,QAAQ,IAAI,UAAU,KAAK,EAAE,IAAI,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,OAAO,qBAAqB,CAAC,SAAS,EAAE,UAAU,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;YAClE,CAAC;YAED,0BAA0B;YAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;YAClE,OAAO,qBAAqB,CAAC,SAAS,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAA;QACvD,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAe;YACtC,+DAA+D;YAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,sEAAsE;gBACtE,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,0BAA0B,EAAE,kCAAkC,EAAE,eAAe,CAAC,CAC3F,CAAA;YACH,CAAC;YACD,OAAO,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;QAC/C,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -4,14 +4,14 @@
  * environment-agnostic constants. This entry point is safe to import in any environment
  * (server or browser).
  *
- * For server-specific exports (Brainy lifecycle, Cortex, auth middleware, RPC handlers,
- * `createSDK`, `computeEmailHash`, `createCapabilityToken`, `verifyCapabilityToken`,
+ * For server-specific exports (`createSoulcraftRouter`, namespace handlers, auth
+ * middleware, `computeEmailHash`, `createCapabilityToken`, `verifyCapabilityToken`,
  * `getAuthMode`, `getOIDCClientConfig`), use `@soulcraft/sdk/server`.
  *
- * For browser-specific exports (HTTP/WS/SSE transports, `createClientSDK`), use
- * `@soulcraft/sdk/client`.
+ * For browser-specific exports (`createSoulcraftProxy`, HTTP/WS transports, Hall),
+ * use `@soulcraft/sdk/client`.
  */
-export type { SoulcraftSDK, SDKOptions, ServerSDKOptions, ClientSDKOptions } from './types.js';
+export type { SoulcraftSDK, SDKOptions, ServerSDKOptions } from './types.js';
 export type { SoulcraftProduct } from './modules/auth/products.js';
 export type { SoulcraftBrainy } from './modules/brainy/types.js';
 export type { Entity, Relation, Result, AddParams, UpdateParams, RelateParams, FindParams, BrainyConfig, AggregateDefinition, DiagnosticsResult, MigrationResult, MigrateOptions, MigrationPreview, NounType, VerbType, BrainyChangeEvent, BrainyChangeEntity, BrainyChangeRelation, } from './modules/brainy/types.js';
@@ -19,7 +19,7 @@ export type { CreateCapabilityTokenOptions, CapabilityTokenClaims, } from './mod
 export { SDKError, SDKDisconnectedError, SDKTimeoutError, SDKAuthError, SDKForbiddenError, SDKRpcError, SDKMethodNotFoundError, } from './modules/brainy/errors.js';
 export type { VfsModule } from './modules/vfs/types.js';
 export type { VersionsModule } from './modules/versions/types.js';
-export type { HallModule, HallRoom, HallRoomHandle, HallRoomEvents, HallRoomHandleEvents, HallConnectionOptions, RoomOptions, ConceptInput, RecordingManifest, TranscriptEvent, ConceptMentionEvent, RelationProposedEvent, SpeakerChangedEvent, PeerJoinedEvent, PeerLeftEvent, } from './modules/hall/types.js';
+export type { HallModule, HallRoom, HallRoomHandle, HallPubsubHandle, HallRoomEvents, HallRoomHandleEvents, HallPubsubHandleEvents, HallPubsubEvents, HallConnectionOptions, HallPeerRole, ScreenShareMode, RoomOptions, ConceptInput, RecordingManifest, RoleChangedEvent, TranscriptEvent, ConceptMentionEvent, RelationProposedEvent, SpeakerChangedEvent, PeerJoinedEvent, PeerLeftEvent, PeerPromotedEvent, PeerDemotedEvent, ViewerCountEvent, ScreenShareThumbnailEvent, ChatMessage as HallChatMessage, ChatHistoryEvent, MediaInfo as HallMediaInfo, MediaReadyEvent, MediaErrorEvent, TranscodeTarget, ReplayEntry, TopicSubscribedEvent, TopicUnsubscribedEvent, TopicMessageEvent, PresenceUpdateEvent, PresenceEntry, PresenceSnapshotEvent, } from './modules/hall/types.js';
 export type { AuthModule, PlatformRole, SoulcraftAuthProvider, SoulcraftOrganization, SoulcraftUserFields, SoulcraftSessionUser, SoulcraftSession, OIDCClientConfig, AuthMode, } from './modules/auth/types.js';
 export { SOULCRAFT_USER_FIELDS, SOULCRAFT_SESSION_CONFIG, } from './modules/auth/config.js';
 export type { AiModule, AiCompleteOptions, AiCompleteResult, AiStreamOptions, AiStreamEvent, AiToolCall, AiMessage, AiContentBlock, AiTool, AiModel, } from './modules/ai/types.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -4,12 +4,12 @@
  * environment-agnostic constants. This entry point is safe to import in any environment
  * (server or browser).
  *
- * For server-specific exports (Brainy lifecycle, Cortex, auth middleware, RPC handlers,
- * `createSDK`, `computeEmailHash`, `createCapabilityToken`, `verifyCapabilityToken`,
+ * For server-specific exports (`createSoulcraftRouter`, namespace handlers, auth
+ * middleware, `computeEmailHash`, `createCapabilityToken`, `verifyCapabilityToken`,
  * `getAuthMode`, `getOIDCClientConfig`), use `@soulcraft/sdk/server`.
  *
- * For browser-specific exports (HTTP/WS/SSE transports, `createClientSDK`), use
- * `@soulcraft/sdk/client`.
+ * For browser-specific exports (`createSoulcraftProxy`, HTTP/WS transports, Hall),
+ * use `@soulcraft/sdk/client`.
  */
 // createCapabilityToken and verifyCapabilityToken are server-only (node:crypto).
 // Import from @soulcraft/sdk/server.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+BH,iFAAiF;AACjF,qCAAqC;AACrC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,4BAA4B,CAAA;AAuCnC,gGAAgG;AAChG,oFAAoF;AACpF,2CAA2C;AAC3C,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,0BAA0B,CAAA;AAejC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAoFjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+BH,iFAAiF;AACjF,qCAAqC;AACrC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,4BAA4B,CAAA;AA8DnC,gGAAgG;AAChG,oFAAoF;AACpF,2CAA2C;AAC3C,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,0BAA0B,CAAA;AAejC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAoFjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/modules/hall/admin.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @module modules/hall/admin
+ * @description REST client for the Hall `/admin` API.
+ *
+ * The admin API provides operational management endpoints for Hall — listing rooms,
+ * kicking peers, revoking tokens, viewing config, and reading audit logs.
+ *
+ * Authentication is via `Authorization: Bearer {admin_secret}` header on all requests.
+ * The admin secret is configured in `[admin].secret` in `hall.toml` — it is separate
+ * from per-product shared secrets.
+ *
+ * @example
+ * ```typescript
+ * import { createHallAdmin } from '@soulcraft/sdk/server'
+ *
+ * const admin = createHallAdmin({
+ *   hallUrl: 'https://hall.soulcraft.com',
+ *   secret: process.env.HALL_ADMIN_SECRET!,
+ * })
+ *
+ * // List all rooms
+ * const { rooms, count } = await admin.listRooms()
+ *
+ * // Kick a disruptive peer
+ * await admin.kickPeer('room-1', 'user-abc')
+ *
+ * // View audit trail
+ * const { entries } = await admin.getAuditLog(50)
+ * ```
+ */
+import type { HallAdminOptions, HallAdminClient } from './types.js';
+/**
+ * Create a Hall admin REST client.
+ *
+ * @param options - Hall server URL and admin secret.
+ * @returns A `HallAdminClient` ready for use.
+ */
+export declare function createHallAdmin(options: HallAdminOptions): HallAdminClient;
+//# sourceMappingURL=admin.d.ts.map

package/dist/modules/hall/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../src/modules/hall/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAIhB,MAAM,YAAY,CAAA;AAEnB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAE1E"}

package/dist/modules/hall/admin.js

@@ -0,0 +1,115 @@
+/**
+ * @module modules/hall/admin
+ * @description REST client for the Hall `/admin` API.
+ *
+ * The admin API provides operational management endpoints for Hall — listing rooms,
+ * kicking peers, revoking tokens, viewing config, and reading audit logs.
+ *
+ * Authentication is via `Authorization: Bearer {admin_secret}` header on all requests.
+ * The admin secret is configured in `[admin].secret` in `hall.toml` — it is separate
+ * from per-product shared secrets.
+ *
+ * @example
+ * ```typescript
+ * import { createHallAdmin } from '@soulcraft/sdk/server'
+ *
+ * const admin = createHallAdmin({
+ *   hallUrl: 'https://hall.soulcraft.com',
+ *   secret: process.env.HALL_ADMIN_SECRET!,
+ * })
+ *
+ * // List all rooms
+ * const { rooms, count } = await admin.listRooms()
+ *
+ * // Kick a disruptive peer
+ * await admin.kickPeer('room-1', 'user-abc')
+ *
+ * // View audit trail
+ * const { entries } = await admin.getAuditLog(50)
+ * ```
+ */
+/**
+ * Create a Hall admin REST client.
+ *
+ * @param options - Hall server URL and admin secret.
+ * @returns A `HallAdminClient` ready for use.
+ */
+export function createHallAdmin(options) {
+    return new HallAdminClientImpl(options);
+}
+class HallAdminClientImpl {
+    #baseUrl;
+    #secret;
+    constructor(options) {
+        this.#baseUrl = options.hallUrl.replace(/\/$/, '');
+        this.#secret = options.secret;
+    }
+    async listRooms() {
+        return this.#get('/admin/rooms');
+    }
+    async getRoom(roomId) {
+        return this.#get(`/admin/rooms/${encodeURIComponent(roomId)}`);
+    }
+    async closeRoom(roomId) {
+        await this.#delete(`/admin/rooms/${encodeURIComponent(roomId)}`);
+    }
+    async kickPeer(roomId, peerId) {
+        await this.#delete(`/admin/rooms/${encodeURIComponent(roomId)}/peers/${encodeURIComponent(peerId)}`);
+    }
+    async revokeToken(token) {
+        await this.#post('/admin/revoke-token', { token });
+    }
+    async listProducts() {
+        return this.#get('/admin/products');
+    }
+    async listTopics() {
+        return this.#get('/admin/pubsub/topics');
+    }
+    async getConfig() {
+        return this.#get('/admin/config');
+    }
+    async reloadConfig() {
+        return this.#post('/admin/config/reload', {});
+    }
+    async getAuditLog(limit) {
+        const qs = limit ? `?limit=${limit}` : '';
+        return this.#get(`/admin/audit${qs}`);
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    async #get(path) {
+        const res = await fetch(`${this.#baseUrl}${path}`, {
+            headers: { 'Authorization': `Bearer ${this.#secret}` },
+        });
+        if (!res.ok) {
+            throw new Error(`Hall admin ${path}: ${res.status} ${await res.text()}`);
+        }
+        return res.json();
+    }
+    async #post(path, body) {
+        const res = await fetch(`${this.#baseUrl}${path}`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.#secret}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            throw new Error(`Hall admin ${path}: ${res.status} ${await res.text()}`);
+        }
+        // Some endpoints return 204 No Content.
+        if (res.status === 204)
+            return undefined;
+        return res.json();
+    }
+    async #delete(path) {
+        const res = await fetch(`${this.#baseUrl}${path}`, {
+            method: 'DELETE',
+            headers: { 'Authorization': `Bearer ${this.#secret}` },
+        });
+        if (!res.ok) {
+            throw new Error(`Hall admin ${path}: ${res.status} ${await res.text()}`);
+        }
+    }
+}
+//# sourceMappingURL=admin.js.map

package/dist/modules/hall/admin.js.map

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

package/dist/modules/hall/browser.d.ts

@@ -1,49 +1,51 @@
 /**
  * @module modules/hall/browser
- * @description Browser-side Hall room client — joins a WebRTC room via a session token.
+ * @description Browser-side Hall clients — join WebRTC rooms and pub/sub topics via session tokens.
  *
- * `joinHallRoom` is the browser entry point for Hall real-time communication.
- * It opens a WebSocket to the Hall signaling endpoint, negotiates a WebRTC peer
- * connection via offer/answer/ICE, and returns a `HallRoomHandle` with typed events
- * for tracks, transcripts, concept mentions, and room lifecycle.
+ * This module provides two browser entry points:
+ *
+ * - `joinHallRoom` — joins a WebRTC room for real-time audio/video/data communication.
+ *   Handles SDP offer/answer, ICE negotiation, track events, and AI events (transcripts,
+ *   concept mentions). In broadcast rooms, handles role changes (promotion/demotion)
+ *   transparently.
+ *
+ * - `joinHallPubsub` — connects to the Hall pub/sub system for topic-based messaging
+ *   with presence tracking. Uses msgpack over WebSocket, same binary format as the
+ *   product connection.
  *
  * **Auth model:** The browser never sees the product's shared secret. The product
- * backend mints a short-lived HMAC session token (via `sdk.hall.createSessionToken`)
- * and passes it to the browser. The browser passes the token to `joinHallRoom` — that
- * is the only browser credential.
+ * backend mints short-lived tokens (via `sdk.hall.createSessionToken` or
+ * `sdk.hall.createPubsubToken`) and passes them to the browser.
  *
  * This module has no server-only dependencies and is safe to bundle for the browser.
- * It does require `RTCPeerConnection` and `WebSocket` to be available (standard in
- * all modern browsers; not available in Node.js without polyfills).
  *
- * @example
+ * @example WebRTC room
  * ```typescript
  * import { joinHallRoom } from '@soulcraft/sdk/client'
  *
- * // 1. Get token from product backend:
  * const { token, hallUrl } = await fetch('/api/session/join').then(r => r.json())
- *
- * // 2. Get camera + mic:
  * const stream = await navigator.mediaDevices.getUserMedia({ video: true, audio: true })
- *
- * // 3. Join room:
  * const room = await joinHallRoom({ token, hallUrl })
  * room.addStream(stream)
+ * room.on('trackAdded', ({ peerId, streams }) => renderVideo(peerId, streams[0]))
+ * room.on('transcript', ({ text, isFinal }) => { if (isFinal) showCaption(text) })
+ * room.on('roleChanged', ({ role, canPublish }) => updateUI(role, canPublish))
+ * room.close()
+ * ```
  *
- * // 4. Handle events:
- * room.on('trackAdded', ({ peerId, streams }) => {
- *   document.getElementById(`video-${peerId}`).srcObject = streams[0]
- * })
- * room.on('transcript', ({ peerId, text, isFinal }) => {
- *   if (isFinal) appendCaption(peerId, text)
- * })
- * room.on('conceptMention', ({ nodeId, confidence }) => pulseGraphNode(nodeId, confidence))
+ * @example Pub/Sub
+ * ```typescript
+ * import { joinHallPubsub } from '@soulcraft/sdk/client'
  *
- * // 5. On leave:
- * room.close()
+ * const { token, hallUrl } = await fetch('/api/pubsub/token').then(r => r.json())
+ * const pubsub = await joinHallPubsub({ token, hallUrl })
+ * pubsub.subscribe('room:abc:chat', { username: 'Alice' })
+ * pubsub.on('topicMessage', ({ senderId, payload }) => showMessage(senderId, payload))
+ * pubsub.broadcast('room:abc:chat', { text: 'Hello!' })
+ * pubsub.close()
  * ```
  */
-import type { HallRoomHandle } from './types.js';
+import type { HallRoomHandle, HallPubsubHandle } from './types.js';
 /**
  * Options for {@link joinHallRoom}.
  */
@@ -65,6 +67,19 @@ export interface JoinHallRoomOptions {
      */
     iceServers?: RTCIceServer[];
 }
+/**
+ * Options for {@link joinHallPubsub}.
+ */
+export interface JoinHallPubsubOptions {
+    /**
+     * The pub/sub token issued by the product backend via `sdk.hall.createPubsubToken()`.
+     */
+    token: string;
+    /**
+     * The Hall server WebSocket base URL (e.g. `"wss://hall.soulcraft.com"`).
+     */
+    hallUrl: string;
+}
 /**
  * Join a Hall room from the browser using a session token.
  *
@@ -72,6 +87,9 @@ export interface JoinHallRoomOptions {
  * performs the offer/answer/ICE exchange, and resolves once the peer connection reaches
  * `connected` state. Returns a {@link HallRoomHandle} with typed events.
  *
+ * In broadcast rooms, the handle also emits `roleChanged` when the peer is promoted
+ * or demoted. The `role` and `canPublish` properties are updated automatically.
+ *
  * @param options - Token, Hall URL, and optional ICE server overrides.
  * @returns A connected `HallRoomHandle`.
  * @throws {Error} If the signaling handshake fails or the connection times out.
@@ -82,7 +100,45 @@ export interface JoinHallRoomOptions {
  * room.addStream(localStream)
  * room.on('trackAdded', ({ peerId, streams }) => renderVideo(peerId, streams[0]))
  * room.on('transcript', ({ text, isFinal }) => { if (isFinal) showCaption(text) })
+ * room.on('roleChanged', ({ role, canPublish }) => updateUI(role, canPublish))
  * ```
  */
 export declare function joinHallRoom(options: JoinHallRoomOptions): Promise<HallRoomHandle>;
+/**
+ * Connect to the Hall pub/sub system from the browser using a pub/sub token.
+ *
+ * Opens a WebSocket to `{hallUrl}/ws/pubsub/{token}` using msgpack wire format.
+ * Resolves once `authOk` is received from the server, confirming the token is valid.
+ *
+ * @param options - Token and Hall URL.
+ * @returns A connected `HallPubsubHandle`.
+ * @throws {Error} If authentication fails or the connection times out.
+ *
+ * @example
+ * ```typescript
+ * const pubsub = await joinHallPubsub({ token, hallUrl: 'wss://hall.soulcraft.com' })
+ * pubsub.subscribe('room:abc:chat', { username: 'Alice' })
+ * pubsub.on('topicMessage', ({ topic, senderId, payload }) => showMessage(senderId, payload))
+ * pubsub.broadcast('room:abc:chat', { text: 'Hello!' })
+ * pubsub.close()
+ * ```
+ */
+export declare function joinHallPubsub(options: JoinHallPubsubOptions): Promise<HallPubsubHandle>;
+/**
+ * Build the WHEP endpoint URL for receive-only WebRTC viewing of a broadcast room.
+ * The browser POSTs an SDP offer to this URL with `Authorization: Bearer <sessionToken>`.
+ *
+ * @param hallUrl - Hall server base URL (e.g. `"https://hall.soulcraft.com"`).
+ * @param roomId - The room to view.
+ * @returns The WHEP endpoint URL.
+ */
+export declare function getWhepUrl(hallUrl: string, roomId: string): string;
+/**
+ * Build the LL-HLS master playlist URL for scalable HLS viewing of a broadcast room.
+ *
+ * @param hallUrl - Hall server base URL (e.g. `"https://hall.soulcraft.com"`).
+ * @param roomId - The room to view.
+ * @returns The HLS playlist URL.
+ */
+export declare function getHlsUrl(hallUrl: string, roomId: string): string;
 //# sourceMappingURL=browser.d.ts.map