@q9labsai/chalk-client 4.1.4 → 4.1.7

package/dist/{chunk-2DA665LP.js → chunk-MMK2K3LO.js}

@@ -1,7 +1,13 @@
 import {
+  CloudflareRTKClient,
   CloudflareSFUClient,
   createCloudflareSFUHTTPTransport
-} from "./chunk-PBCGWE2V.js";
+} from "./chunk-C4BIONCP.js";
+import {
+  AccessGrantError,
+  requireParsedAccessGrant,
+  validEpisodeDiagnosticCredential
+} from "./chunk-JPNE4K2L.js";
 import {
   createBrowserSyncLifecycle,
   createBrowserWebSocketFactory,
@@ -81,7 +87,15 @@ function validateRefresh(previous, next, replaceMediaConnection) {
   if (left.tenantId !== right.tenantId || left.spaceId !== right.spaceId || left.episodeId !== right.episodeId || left.participantId !== right.participantId || left.participantGeneration !== right.participantGeneration) {
     throw new TypeError("Access grant refresh changed its subject");
   }
-  if (!replaceMediaConnection && previous.media.clientPayload.connectionId !== next.media.clientPayload.connectionId) throw new TypeError("Access grant refresh unexpectedly replaced its media connection");
+  if (!replaceMediaConnection && (previous.media.provider !== next.media.provider || mediaBinding(previous) !== mediaBinding(next))) throw new TypeError("Access grant refresh unexpectedly replaced its media connection");
+}
+function mediaBinding(access) {
+  switch (access.media.provider) {
+    case "cloudflare_sfu":
+      return access.media.clientPayload.connectionId;
+    case "cloudflare_rtk":
+      return access.media.clientPayload.providerSubject;
+  }
 }
 function expiresAt(value) {
   const timestamp = Date.parse(value);
@@ -358,6 +372,12 @@ var WhiteboardV1ProtocolMetadata = {
     route: "/v1/whiteboard",
     transport: "websocket-json-text"
   },
+  extensions: {
+    presentation: {
+      name: "presentation_v1",
+      exactFields: ["name"]
+    }
+  },
   identity: {
     credential: "participant-access-token",
     authorityKey: ["tenant_id", "space_id", "episode_id"],
@@ -372,7 +392,7 @@ var WhiteboardV1ProtocolMetadata = {
     },
     {
       id: "live",
-      accepts: ["submit_update", "submit_update_part", "request_snapshot", "snapshot_ack", "clear", "set_draw_permission", "cursor", "ping"],
+      accepts: ["submit_update", "submit_update_part", "request_snapshot", "snapshot_ack", "clear", "set_draw_permission", "set_presentation", "cursor", "ping"],
       heartbeatIntervalMs: 2e4,
       missedDeadlinesBeforeClose: 2
     }
@@ -424,7 +444,8 @@ var WhiteboardV1ProtocolMetadata = {
   },
   frames: {
     hello: {
-      exactFields: ["type", "protocol", "token", "cursor"]
+      exactFields: ["type", "protocol", "token", "cursor"],
+      extendedExactFields: ["type", "protocol", "token", "cursor", "extensions"]
     },
     submitUpdate: {
       exactFields: ["type", "operation_id", "scene_id", "sync_all", "elements"]
@@ -444,12 +465,16 @@ var WhiteboardV1ProtocolMetadata = {
     setDrawPermission: {
       exactFields: ["type", "operation_id", "participant_id", "can_draw"]
     },
+    setPresentation: {
+      exactFields: ["type", "operation_id", "presenting"]
+    },
     cursor: {
       clientExactFields: ["type", "x", "y"],
       serverExactFields: ["type", "participant_id", "display_name", "x", "y", "occurred_at"]
     },
     welcome: {
-      exactFields: ["type", "protocol", "participant_id", "participant_generation", "capabilities", "participant_capabilities", "scene_id", "revision", "can_draw"]
+      exactFields: ["type", "protocol", "participant_id", "participant_generation", "capabilities", "participant_capabilities", "scene_id", "revision", "can_draw"],
+      extendedExactFields: ["type", "protocol", "participant_id", "participant_generation", "capabilities", "participant_capabilities", "scene_id", "revision", "can_draw", "presenting"]
     },
     snapshotPage: {
       exactFields: ["type", "request_id", "scene_id", "revision", "page", "page_count", "elements", "app_state"]
@@ -466,6 +491,9 @@ var WhiteboardV1ProtocolMetadata = {
     permissionUpdated: {
       exactFields: ["type", "participant_id", "can_draw"]
     },
+    presentationUpdated: {
+      exactFields: ["type", "scene_id", "revision", "presenting"]
+    },
     resetRequired: {
       exactFields: ["type", "scene_id", "reason"]
     },
@@ -473,9 +501,9 @@ var WhiteboardV1ProtocolMetadata = {
       exactFields: ["type", "correlation_id", "operation", "code", "recoverable", "message"]
     }
   },
-  clientFrames: ["hello", "submit_update", "submit_update_part", "request_snapshot", "snapshot_ack", "clear", "set_draw_permission", "cursor", "ping"],
-  serverFrames: ["welcome", "snapshot_page", "update", "update_part", "commit", "cursor", "permission_updated", "reset_required", "operation_error", "pong"],
-  receiptOperations: ["submit_update", "clear", "set_draw_permission"],
+  clientFrames: ["hello", "submit_update", "submit_update_part", "request_snapshot", "snapshot_ack", "clear", "set_draw_permission", "set_presentation", "cursor", "ping"],
+  serverFrames: ["welcome", "snapshot_page", "update", "update_part", "commit", "cursor", "permission_updated", "presentation_updated", "reset_required", "operation_error", "pong"],
+  receiptOperations: ["submit_update", "clear", "set_draw_permission", "set_presentation"],
   receiptOutcomes: ["committed", "duplicate"],
   resetReasons: ["scene_changed", "cursor_expired", "gap"],
   errorCodes: ["unavailable", "permission_denied", "invalid_payload", "stale_scene", "cursor_reset_required", "rate_limited", "overloaded", "storage_unavailable"],
@@ -537,6 +565,9 @@ function isRecord2(value) {
 function hasExactKeys(value, keys) {
   return isRecord2(value) && Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key));
 }
+function hasExactRecordKeys(value, keys) {
+  return Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key));
+}
 function isBoundedIdentifier(value, minimum, maximum) {
   return typeof value === "string" && utf8Bytes(value) >= minimum && utf8Bytes(value) <= maximum;
 }
@@ -581,7 +612,7 @@ function isClientFrame(value) {
   if (!isRecord2(value)) return false;
   switch (value.type) {
     case "hello":
-      return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.hello.exactFields) && value.protocol === "whiteboard-v1" && typeof value.token === "string" && utf8Bytes(value.token) > 0 && utf8Bytes(value.token) <= WhiteboardV1ProtocolLimits.tokenBytes && (value.cursor === null || isCursor(value.cursor));
+      return (hasExactRecordKeys(value, WhiteboardV1ProtocolMetadata.frames.hello.exactFields) || hasExactRecordKeys(value, WhiteboardV1ProtocolMetadata.frames.hello.extendedExactFields) && isPresentationExtensions(value.extensions)) && value.protocol === "whiteboard-v1" && typeof value.token === "string" && utf8Bytes(value.token) > 0 && utf8Bytes(value.token) <= WhiteboardV1ProtocolLimits.tokenBytes && (value.cursor === null || isCursor(value.cursor));
     case "submit_update":
       return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.submitUpdate.exactFields) && isBoundedIdentifier(value.operation_id, WhiteboardV1ProtocolLimits.operationIdMinBytes, WhiteboardV1ProtocolLimits.operationIdMaxBytes) && isUuid(value.scene_id) && typeof value.sync_all === "boolean" && isElementBatch(value.elements, WhiteboardV1ProtocolLimits.elementBatchMaxItems);
     case "submit_update_part":
@@ -594,6 +625,8 @@ function isClientFrame(value) {
       return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.clear.exactFields) && isBoundedIdentifier(value.operation_id, WhiteboardV1ProtocolLimits.operationIdMinBytes, WhiteboardV1ProtocolLimits.operationIdMaxBytes) && isUuid(value.scene_id);
     case "set_draw_permission":
       return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.setDrawPermission.exactFields) && isBoundedIdentifier(value.operation_id, WhiteboardV1ProtocolLimits.operationIdMinBytes, WhiteboardV1ProtocolLimits.operationIdMaxBytes) && isUuid(value.participant_id) && typeof value.can_draw === "boolean";
+    case "set_presentation":
+      return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.setPresentation.exactFields) && isBoundedIdentifier(value.operation_id, WhiteboardV1ProtocolLimits.operationIdMinBytes, WhiteboardV1ProtocolLimits.operationIdMaxBytes) && typeof value.presenting === "boolean";
     case "cursor":
       return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.cursor.clientExactFields) && isFiniteNumber(value.x) && isFiniteNumber(value.y) && encodedWhiteboardV1FrameBytes(value) <= WhiteboardV1ProtocolLimits.cursorFrameBytes;
     case "ping":
@@ -605,11 +638,18 @@ function isClientFrame(value) {
 function isAppState(value) {
   return value === null || hasExactKeys(value, WhiteboardV1ProtocolMetadata.sharedAppState.exactFields) && typeof value.view_background_color === "string" && utf8Bytes(value.view_background_color) <= 64;
 }
+function isPresentationExtensions(value) {
+  return Array.isArray(value) && value.length === 1 && hasExactKeys(value[0], WhiteboardV1ProtocolMetadata.extensions.presentation.exactFields) && value[0].name === WhiteboardV1ProtocolMetadata.extensions.presentation.name;
+}
+function isWelcome(value) {
+  const exact = hasExactRecordKeys(value, WhiteboardV1ProtocolMetadata.frames.welcome.exactFields) || hasExactRecordKeys(value, WhiteboardV1ProtocolMetadata.frames.welcome.extendedExactFields) && typeof value.presenting === "boolean";
+  return exact && value.protocol === "whiteboard-v1" && isUuid(value.participant_id) && Number.isSafeInteger(value.participant_generation) && Number(value.participant_generation) > 0 && isCapabilities(value.capabilities) && isCapabilities(value.participant_capabilities) && isUuid(value.scene_id) && isUnsignedDecimal(value.revision) && typeof value.can_draw === "boolean";
+}
 function isServerFrame(value) {
   if (!isRecord2(value)) return false;
   switch (value.type) {
     case "welcome":
-      return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.welcome.exactFields) && value.protocol === "whiteboard-v1" && isUuid(value.participant_id) && Number.isSafeInteger(value.participant_generation) && Number(value.participant_generation) > 0 && isCapabilities(value.capabilities) && isCapabilities(value.participant_capabilities) && isUuid(value.scene_id) && isUnsignedDecimal(value.revision) && typeof value.can_draw === "boolean";
+      return isWelcome(value);
     case "snapshot_page":
       return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.snapshotPage.exactFields) && isBoundedIdentifier(value.request_id, WhiteboardV1ProtocolLimits.requestIdMinBytes, WhiteboardV1ProtocolLimits.requestIdMaxBytes) && isUuid(value.scene_id) && isUnsignedDecimal(value.revision) && isNonNegativeInteger(value.page) && isNonNegativeInteger(value.page_count) && value.page_count > 0 && value.page_count <= WhiteboardV1ProtocolLimits.snapshotMaxPages && value.page < value.page_count && isElementBatch(value.elements, WhiteboardV1ProtocolLimits.snapshotPageMaxItems) && isAppState(value.app_state) && encodedWhiteboardV1FrameBytes(value) <= WhiteboardV1ProtocolLimits.snapshotPageEncodedBytes;
     case "update":
@@ -622,10 +662,12 @@ function isServerFrame(value) {
       return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.cursor.serverExactFields) && isUuid(value.participant_id) && typeof value.display_name === "string" && utf8Bytes(value.display_name) > 0 && utf8Bytes(value.display_name) <= WhiteboardV1ProtocolLimits.displayNameMaxBytes && isFiniteNumber(value.x) && isFiniteNumber(value.y) && typeof value.occurred_at === "string" && !Number.isNaN(Date.parse(value.occurred_at)) && encodedWhiteboardV1FrameBytes(value) <= WhiteboardV1ProtocolLimits.cursorFrameBytes;
     case "permission_updated":
       return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.permissionUpdated.exactFields) && isUuid(value.participant_id) && typeof value.can_draw === "boolean";
+    case "presentation_updated":
+      return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.presentationUpdated.exactFields) && isUuid(value.scene_id) && isUnsignedDecimal(value.revision) && typeof value.presenting === "boolean";
     case "reset_required":
       return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.resetRequired.exactFields) && isUuid(value.scene_id) && typeof value.reason === "string" && WhiteboardV1ProtocolMetadata.resetReasons.some((reason) => reason === value.reason);
     case "operation_error":
-      return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.operationError.exactFields) && isBoundedIdentifier(value.correlation_id, WhiteboardV1ProtocolLimits.requestIdMinBytes, WhiteboardV1ProtocolLimits.requestIdMaxBytes) && ["submit_update", "request_snapshot", "clear", "set_draw_permission"].includes(String(value.operation)) && typeof value.code === "string" && WhiteboardV1ProtocolMetadata.errorCodes.some((code) => code === value.code) && typeof value.recoverable === "boolean" && typeof value.message === "string" && utf8Bytes(value.message) <= WhiteboardV1ProtocolLimits.errorMessageMaxBytes;
+      return hasExactKeys(value, WhiteboardV1ProtocolMetadata.frames.operationError.exactFields) && isBoundedIdentifier(value.correlation_id, WhiteboardV1ProtocolLimits.requestIdMinBytes, WhiteboardV1ProtocolLimits.requestIdMaxBytes) && ["submit_update", "request_snapshot", "clear", "set_draw_permission", "set_presentation"].includes(String(value.operation)) && typeof value.code === "string" && WhiteboardV1ProtocolMetadata.errorCodes.some((code) => code === value.code) && typeof value.recoverable === "boolean" && typeof value.message === "string" && utf8Bytes(value.message) <= WhiteboardV1ProtocolLimits.errorMessageMaxBytes;
     case "pong":
       return hasExactKeys(value, ["type"]);
     default:
@@ -858,6 +900,9 @@ var ChalkWhiteboardV1Client = class {
   #revision;
   #capabilities = [];
   #canDraw = false;
+  #presentationSupported = false;
+  #presenting = false;
+  #useLegacyHello = false;
   #summaryStatus = "unsubscribed";
   #summaryError = null;
   #latestSnapshot = null;
@@ -883,6 +928,7 @@ var ChalkWhiteboardV1Client = class {
   startSceneSubscription() {
     if (this.#started && this.#startPromise) return this.#startPromise;
     this.#started = true;
+    this.#useLegacyHello = false;
     this.#phase = "connecting";
     this.#publishSummary("loading", null);
     const generation = ++this.#startupGeneration;
@@ -912,6 +958,7 @@ var ChalkWhiteboardV1Client = class {
     this.#participantId = null;
     this.#capabilities = [];
     this.#canDraw = false;
+    this.#presenting = false;
     this.#publishSummary("unsubscribed", null);
   }
   subscribe(listener) {
@@ -968,6 +1015,21 @@ var ChalkWhiteboardV1Client = class {
     };
     await this.#queueOperation(frame);
   }
+  async setPresentation(presenting) {
+    this.#assertLive("set_presentation");
+    if (!this.#presentationSupported) {
+      throw error(failure("set_presentation", "unavailable", true, "Whiteboard presentation is unavailable on this Sync server."));
+    }
+    if (!this.#canDraw || !this.#capabilities.includes("drawWhiteboard")) {
+      throw error(failure("set_presentation", "permission_denied", false, "Whiteboard draw permission is required."));
+    }
+    const frame = {
+      type: "set_presentation",
+      operation_id: this.#nextId(),
+      presenting
+    };
+    await this.#queueOperation(frame);
+  }
   async #restoreAndConnect(generation) {
     try {
       const stored = await this.#store.load();
@@ -1024,12 +1086,9 @@ var ChalkWhiteboardV1Client = class {
       const token = await this.#options.token();
       if (socket !== this.#socket) return;
       this.#phase = "authenticating";
-      this.#send({
-        type: "hello",
-        protocol: "whiteboard-v1",
-        token,
-        cursor: this.#sceneId && this.#revision ? { scene_id: this.#sceneId, revision: this.#revision } : null
-      });
+      this.#presentationSupported = false;
+      const cursor = this.#sceneId && this.#revision ? { scene_id: this.#sceneId, revision: this.#revision } : null;
+      this.#send(this.#useLegacyHello ? { type: "hello", protocol: "whiteboard-v1", token, cursor } : { type: "hello", protocol: "whiteboard-v1", token, cursor, extensions: [{ name: "presentation_v1" }] });
     } catch {
       socket.close(1008, "whiteboard authentication failed");
     }
@@ -1080,11 +1139,22 @@ var ChalkWhiteboardV1Client = class {
         if (frame.participant_id === this.#participantId) this.#canDraw = frame.can_draw;
         this.#publishSummary("ready", null);
         return;
+      case "presentation_updated":
+        this.#requireLive();
+        this.#sceneId = frame.scene_id;
+        this.#revision = frame.revision;
+        this.#presenting = frame.presenting;
+        this.#publishSummary("ready", null);
+        return;
       case "reset_required":
         this.#requireLive();
         this.#sceneId = frame.scene_id;
         this.#revision = null;
         this.#publishSummary("recovering", failure("request_snapshot", "cursor_reset_required", true, "Whiteboard snapshot recovery is required."));
+        if (this.#presentationSupported) {
+          this.#socket?.close(CLIENT_RESTART_CLOSE_CODE, "whiteboard presentation recovery required");
+          return;
+        }
         this.#emit({ type: "reset_required", sceneId: frame.scene_id, reason: frame.reason });
         return;
       case "operation_error":
@@ -1137,6 +1207,8 @@ var ChalkWhiteboardV1Client = class {
     this.#revision = frame.revision;
     this.#capabilities = [...frame.capabilities];
     this.#canDraw = frame.can_draw;
+    this.#presentationSupported = "presenting" in frame;
+    this.#presenting = "presenting" in frame ? frame.presenting : false;
     this.#publishSummary("loading", null);
     this.#missedHeartbeats = 0;
     for (const entry of [...this.#operations.values()].sort((left, right) => compareChalkWhiteboardV1PendingOperations(left.pending, right.pending))) {
@@ -1283,6 +1355,24 @@ var ChalkWhiteboardV1Client = class {
   }
   #disconnected(socket, closeCode) {
     if (socket !== this.#socket) return;
+    const rejectedPresentationHello = this.#rejectedPresentationHello(closeCode);
+    this.#resetDisconnectedState();
+    if (!this.#started || !this.#transportAvailable) return;
+    if (rejectedPresentationHello) {
+      this.#useLegacyHello = true;
+      this.#scheduleReconnect();
+      return;
+    }
+    if (terminalCloseCode(closeCode)) {
+      this.#failRejectedConnection(closeCode);
+      return;
+    }
+    this.#scheduleReconnect();
+  }
+  #rejectedPresentationHello(closeCode) {
+    return this.#phase === "authenticating" && !this.#useLegacyHello && terminalCloseCode(closeCode);
+  }
+  #resetDisconnectedState() {
     this.#socket = null;
     this.#clearHeartbeat();
     this.#clearUpdateAssemblies();
@@ -1292,15 +1382,15 @@ var ChalkWhiteboardV1Client = class {
     this.#canDraw = false;
     this.#rejectSnapshots(failure("request_snapshot", "unavailable", true, "Whiteboard connection interrupted."));
     this.#publishSummary("recovering", failure("start_scene_subscription", "unavailable", true, "Whiteboard connection interrupted."));
-    if (!this.#started || !this.#transportAvailable) return;
-    if (closeCode === 1008 || closeCode === 1009) {
-      const terminalFailure = failure("start_scene_subscription", closeCode === 1008 ? "permission_denied" : "invalid_payload", false, "Whiteboard connection was rejected.");
-      this.#started = false;
-      this.#publishSummary("failed", terminalFailure);
-      if (this.#initialSnapshot) rejectDeferred(this.#initialSnapshot, error(terminalFailure));
-      this.#rejectOperationCallers(terminalFailure);
-      return;
-    }
+  }
+  #failRejectedConnection(closeCode) {
+    const terminalFailure = failure("start_scene_subscription", closeCode === 1008 ? "permission_denied" : "invalid_payload", false, "Whiteboard connection was rejected.");
+    this.#started = false;
+    this.#publishSummary("failed", terminalFailure);
+    if (this.#initialSnapshot) rejectDeferred(this.#initialSnapshot, error(terminalFailure));
+    this.#rejectOperationCallers(terminalFailure);
+  }
+  #scheduleReconnect() {
     this.#clearReconnect();
     this.#reconnectTimer = this.#clock().setTimeout(() => {
       this.#reconnectTimer = void 0;
@@ -1352,6 +1442,7 @@ var ChalkWhiteboardV1Client = class {
       capabilities: [...this.#capabilities],
       canDraw: this.#canDraw,
       canClear: this.#capabilities.includes("manageWhiteboard"),
+      presenting: this.#presenting,
       error: this.#summaryError
     };
     try {
@@ -1473,6 +1564,9 @@ function operationName(frame) {
 function retryableOperationCode(code) {
   return code === "unavailable" || code === "overloaded" || code === "rate_limited" || code === "storage_unavailable";
 }
+function terminalCloseCode(closeCode) {
+  return closeCode === 1008 || closeCode === 1009;
+}
 function mapErrorCode(code) {
   return code === "overloaded" || code === "rate_limited" ? "unavailable" : code;
 }
@@ -1589,8 +1683,18 @@ function createChatFileTransport(apiBaseURL, input) {
   });
 }
 function createMediaClient(apiBaseURL, input) {
+  if (input.access.media.provider === "cloudflare_rtk") {
+    return createRTKConnectionMediaClient(
+      new CloudflareRTKClient({
+        authToken: input.access.media.clientPayload.token,
+        participantId: input.access.subject.participantId,
+        onError: input.onFailure,
+        onScreenEnded: input.onScreenEnded
+      })
+    );
+  }
   const { subject } = input.access;
-  return new CloudflareSFUClient({
+  const client = new CloudflareSFUClient({
     bootstrap: input.access.media.clientPayload,
     participantId: subject.participantId,
     transport: createCloudflareSFUHTTPTransport({
@@ -1604,6 +1708,36 @@ function createMediaClient(apiBaseURL, input) {
     onError: input.onFailure,
     onScreenEnded: input.onScreenEnded
   });
+  return createSFUConnectionMediaClient(client);
+}
+function createRTKConnectionMediaClient(client) {
+  return bindConnectionMediaClient(client, (input) => {
+    if (!("provider" in input) || input.provider !== "cloudflare_rtk") throw new TypeError("The RealtimeKit adapter requires a Cloudflare RealtimeKit access grant");
+    return client.restart(input);
+  });
+}
+function createSFUConnectionMediaClient(client) {
+  return bindConnectionMediaClient(client, (input) => {
+    if ("provider" in input) {
+      if (input.provider !== "cloudflare_sfu") throw new TypeError("The Cloudflare SFU adapter requires a Cloudflare SFU access grant");
+      return client.restart(input.clientPayload);
+    }
+    return client.restart(input);
+  });
+}
+function bindConnectionMediaClient(client, restart) {
+  return {
+    setLocalPublicationTarget: client.setLocalPublicationTarget.bind(client),
+    observeLocalPublications: client.observeLocalPublications.bind(client),
+    observeRemotePublications: client.observeRemotePublications.bind(client),
+    start: client.start.bind(client),
+    stop: client.stop.bind(client),
+    restart,
+    prepareLocalTrack: client.prepareLocalTrack.bind(client),
+    clearPreparedLocalTrack: client.clearPreparedLocalTrack.bind(client),
+    getSnapshot: client.getSnapshot.bind(client),
+    subscribe: client.subscribe.bind(client)
+  };
 }
 function createSyncClient(syncURL, input) {
   return createV1SyncClient({
@@ -1645,172 +1779,6 @@ function whiteboardURL(syncURL) {
 // src/connection/lifecycle.ts
 import { Clock as Clock2, Context as Context3, Data as Data2, Deferred, Duration, Effect as Effect2, Exit, Fiber, Layer as Layer3, Queue, Scope, SubscriptionRef } from "effect";
 
-// src/access/base64-url.ts
-function decodeBase64Url(value) {
-  const base64 = value.replaceAll("-", "+").replaceAll("_", "/").padEnd(Math.ceil(value.length / 4) * 4, "=");
-  const bytes = Uint8Array.from(globalThis.atob(base64), (character) => character.charCodeAt(0));
-  return new TextDecoder().decode(bytes);
-}
-
-// src/access/episode-diagnostic-credential.ts
-var INTAKE_PATH = "/_internal/episode-diagnostic-events";
-var RFC3339_ZONED = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
-function parseEpisodeDiagnosticCredential(value) {
-  if (!isRecord3(value)) return null;
-  const token = value.token;
-  const expiresAt2 = value.expires_at;
-  const generation = value.generation;
-  const intakePath = value.intake_path;
-  if (typeof token !== "string" || !validDiagnosticCredential(token)) return null;
-  if (!isRFC3339Zoned(expiresAt2)) return null;
-  if (!Number.isSafeInteger(generation) || generation < 1) return null;
-  if (intakePath !== INTAKE_PATH) return null;
-  return Object.freeze({ token, expiresAt: expiresAt2, generation, intakePath });
-}
-function validEpisodeDiagnosticCredential(credential, now) {
-  return credential.intakePath === INTAKE_PATH && Number.isSafeInteger(credential.generation) && credential.generation > 0 && isRFC3339Zoned(credential.expiresAt) && Date.parse(credential.expiresAt) > now && validDiagnosticCredential(credential.token);
-}
-function validDiagnosticCredential(token) {
-  const segments = token.split(".");
-  if (segments.length !== 3) return false;
-  try {
-    const payload = JSON.parse(decodeBase64Url(segments[1] ?? ""));
-    return isRecord3(payload) && payload.aud === "chalk-diagnostics";
-  } catch {
-    return false;
-  }
-}
-function isRFC3339Zoned(value) {
-  if (typeof value !== "string") return false;
-  const match = RFC3339_ZONED.exec(value);
-  if (!match) return false;
-  return validTimestampFields(match) && Number.isFinite(Date.parse(value));
-}
-function validTimestampFields(match) {
-  const year = Number(match[1]);
-  const month = Number(match[2]);
-  const day = Number(match[3]);
-  const hour = Number(match[4]);
-  const minute = Number(match[5]);
-  const second = Number(match[6]);
-  const zone = match[7] ?? "";
-  return validCalendarDate(year, month, day) && validClockTime(hour, minute, second) && validZoneOffset(zone);
-}
-function inRange(value, min, max) {
-  return value >= min && value <= max;
-}
-function validCalendarDate(year, month, day) {
-  return inRange(month, 1, 12) && inRange(day, 1, daysInMonth(year, month));
-}
-function validClockTime(hour, minute, second) {
-  return inRange(hour, 0, 23) && inRange(minute, 0, 59) && inRange(second, 0, 59);
-}
-function validZoneOffset(zone) {
-  if (zone === "Z") return true;
-  return inRange(Number(zone.slice(1, 3)), 0, 23) && inRange(Number(zone.slice(4, 6)), 0, 59);
-}
-function daysInMonth(year, month) {
-  if (month === 2) return isLeapYear(year) ? 29 : 28;
-  return [4, 6, 9, 11].includes(month) ? 30 : 31;
-}
-function isLeapYear(year) {
-  return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
-}
-function isRecord3(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-// src/access/grant.ts
-var AccessGrantError = class extends TypeError {
-  code = "access.invalid";
-  constructor(message = "Access grant is invalid") {
-    super(message);
-    this.name = "AccessGrantError";
-  }
-};
-function parseParsedAccessGrant(value) {
-  if (!isRecord4(value)) throw new AccessGrantError();
-  const subject = parseSubject(value.subject);
-  const diagnostics = parseEpisodeDiagnosticCredential(value.diagnostics);
-  return {
-    subject,
-    sync: parseSyncAccess(value.sync),
-    media: parseMediaAccess(value.media),
-    diagnostics: diagnostics?.generation === subject.participantGeneration ? diagnostics : null
-  };
-}
-async function requireParsedAccessGrant(value) {
-  if (typeof Response !== "undefined" && value instanceof Response) {
-    if (!value.ok) throw new AccessGrantError(`Access grant request failed with HTTP ${value.status}`);
-    try {
-      return parseParsedAccessGrant(await value.json());
-    } catch (error2) {
-      if (error2 instanceof AccessGrantError) throw error2;
-      throw new AccessGrantError();
-    }
-  }
-  return parseParsedAccessGrant(value);
-}
-function parseSubject(value) {
-  if (!isRecord4(value)) throw new AccessGrantError();
-  return {
-    tenantId: requireNonEmptyString(value.tenant_id),
-    spaceId: requireNonEmptyString(value.space_id),
-    episodeId: requireNonEmptyString(value.episode_id),
-    participantId: requireNonEmptyString(value.participant_id),
-    participantGeneration: requirePositiveInteger(value.participant_generation)
-  };
-}
-function requirePositiveInteger(value) {
-  if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1) throw new AccessGrantError();
-  return value;
-}
-function parseSyncAccess(value) {
-  if (!isRecord4(value)) throw new AccessGrantError();
-  return {
-    token: requireCredential(value.token, "chalk-sync"),
-    expiresAt: requireDateTime(value.expires_at ?? value.expiresAt)
-  };
-}
-function parseMediaAccess(value) {
-  if (!isRecord4(value) || value.provider !== "cloudflare_sfu" || !isRecord4(value.client_payload ?? value.clientPayload)) throw new AccessGrantError();
-  const payload = value.client_payload ?? value.clientPayload;
-  return {
-    token: requireCredential(value.token, "chalk-media"),
-    expiresAt: requireDateTime(value.expires_at ?? value.expiresAt),
-    provider: value.provider,
-    clientPayload: {
-      connectionId: requireNonEmptyString(payload.connectionId),
-      stunServer: requireNonEmptyString(payload.stunServer)
-    }
-  };
-}
-function requireCredential(value, audience) {
-  const token = requireNonEmptyString(value);
-  const segments = token.split(".");
-  if (segments.length !== 3) throw new AccessGrantError();
-  let payload;
-  try {
-    payload = JSON.parse(decodeBase64Url(segments[1] ?? ""));
-  } catch {
-    throw new AccessGrantError();
-  }
-  if (!isRecord4(payload) || payload.aud !== audience) throw new AccessGrantError();
-  return token;
-}
-function requireDateTime(value) {
-  const dateTime = requireNonEmptyString(value);
-  if (!Number.isFinite(Date.parse(dateTime))) throw new AccessGrantError();
-  return dateTime;
-}
-function requireNonEmptyString(value) {
-  if (typeof value !== "string" || value.trim().length === 0) throw new AccessGrantError();
-  return value;
-}
-function isRecord4(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 // src/connection/diagnostics.ts
 var ConnectionDiagnostics = class {
   #limit;
@@ -2266,7 +2234,8 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
       const sync = model.sync;
       if (!media || !sync) return yield* Effect2.fail(lifecycleFailure("invalid_state", false, "Media recovery requires active ports"));
       const grant = yield* access.refresh("media_recovery", true).pipe(Effect2.mapError(accessFailure));
-      yield* foreign6(() => media.restart(grant.media.clientPayload));
+      const restartInput = grant.media.provider === "cloudflare_sfu" ? grant.media.clientPayload : grant.media;
+      yield* foreign6(() => media.restart(restartInput));
       model.mediaSnapshot = media.getSnapshot();
       yield* waitForSyncLive(sync, boundedInteger(options.recovery?.budgetMs, RECOVERY_BUDGET_MS, 1, 6e4));
     });
@@ -2547,7 +2516,7 @@ var EMPTY = empty({
   }),
   chat: empty({ status: "idle", messages: empty([]), pendingSends: empty([]), readReceipts: empty([]), unreadCount: 0, pagination: empty({ cursor: null, hasOlder: false, historyTruncated: false }), lastError: null }),
   reactions: empty({ active: empty([]) }),
-  whiteboard: empty({ open: false, engine: empty({ status: "unsubscribed", sceneId: null, revision: null, error: null }) })
+  whiteboard: empty({ open: false, engine: empty({ status: "unsubscribed", sceneId: null, revision: null, presenting: false, error: null }) })
 });
 var SpaceStore = class _SpaceStore {
   #listeners = /* @__PURE__ */ new Set();
@@ -4031,7 +4000,7 @@ function sameReactions(left, right) {
 
 // src/space-client/whiteboard-controller.ts
 import { Context as Context9, Effect as Effect8, Layer as Layer9 } from "effect";
-var EMPTY_SUMMARY = Object.freeze({ status: "unsubscribed", sceneId: null, revision: null, capabilities: Object.freeze([]), canDraw: false, canClear: false, error: null });
+var EMPTY_SUMMARY = Object.freeze({ status: "unsubscribed", sceneId: null, revision: null, capabilities: Object.freeze([]), canDraw: false, canClear: false, presenting: false, error: null });
 var WhiteboardControllerService = class extends Context9.Service()("@chalk/client/WhiteboardController") {
 };
 var makeWhiteboardController = (connection, store, create) => Effect8.gen(function* () {
@@ -4067,7 +4036,16 @@ var WhiteboardControllerRuntime = class {
   }
   observe(summary) {
     if (!this.#connected && summary.status !== "unsubscribed") return;
-    this.#summary = Object.freeze({ status: summary.status, sceneId: summary.sceneId, revision: summary.revision, capabilities: Object.freeze([...summary.capabilities]), canDraw: summary.canDraw, canClear: summary.canClear, error: summary.error ? Object.freeze({ ...summary.error }) : null });
+    this.#summary = Object.freeze({
+      status: summary.status,
+      sceneId: summary.sceneId,
+      revision: summary.revision,
+      capabilities: Object.freeze([...summary.capabilities]),
+      canDraw: summary.canDraw,
+      canClear: summary.canClear,
+      presenting: summary.presenting,
+      error: summary.error ? Object.freeze({ ...summary.error }) : null
+    });
     this.#publish();
   }
   #bind(ports) {
@@ -4082,14 +4060,14 @@ var WhiteboardControllerRuntime = class {
     this.#publish();
   }
   #publish() {
-    const slice = Object.freeze({ open: this.#summary.status !== "unsubscribed", engine: Object.freeze({ status: this.#summary.status, sceneId: this.#summary.sceneId, revision: this.#summary.revision, error: this.#summary.error }) });
+    const slice = Object.freeze({ open: this.#summary.status !== "unsubscribed", engine: Object.freeze({ status: this.#summary.status, sceneId: this.#summary.sceneId, revision: this.#summary.revision, presenting: this.#summary.presenting, error: this.#summary.error }) });
     const current = this.#store.getSnapshot().whiteboard;
     if (sameWhiteboard(current, slice)) return;
     this.#store.updateWhiteboard(slice);
   }
 };
 function sameWhiteboard(left, right) {
-  return left.open === right.open && left.engine.status === right.engine.status && left.engine.sceneId === right.engine.sceneId && left.engine.revision === right.engine.revision && sameError2(left.engine.error, right.engine.error);
+  return left.open === right.open && left.engine.status === right.engine.status && left.engine.sceneId === right.engine.sceneId && left.engine.revision === right.engine.revision && left.engine.presenting === right.engine.presenting && sameError2(left.engine.error, right.engine.error);
 }
 function sameError2(left, right) {
   if (left === right) return true;
@@ -4668,7 +4646,7 @@ function stripTrailingUrlSlash(value) {
   return value.endsWith("/") ? value.slice(0, -1) : value;
 }
 function intakeResponse(value) {
-  if (!isRecord5(value) || typeof value.diagnosticReference !== "string" || !Number.isSafeInteger(value.committedCursor)) return null;
+  if (!isRecord3(value) || typeof value.diagnosticReference !== "string" || !Number.isSafeInteger(value.committedCursor)) return null;
   if (!Array.isArray(value.accepted) || !Array.isArray(value.duplicates) || !Array.isArray(value.conflicts)) return null;
   return { accepted: value.accepted, duplicates: value.duplicates, conflicts: value.conflicts };
 }
@@ -4679,14 +4657,14 @@ function completeDelivery(delivery, expected) {
 function intakeIds(items, expected, cursorRequired) {
   const ids = [];
   for (const item of items) {
-    if (!isRecord5(item) || typeof item.eventId !== "string" || !expected.has(item.eventId)) return null;
+    if (!isRecord3(item) || typeof item.eventId !== "string" || !expected.has(item.eventId)) return null;
     if (cursorRequired && !Number.isSafeInteger(item.cursor)) return null;
     if (!cursorRequired && item.code !== "fingerprint_mismatch") return null;
     ids.push(item.eventId);
   }
   return ids;
 }
-function isRecord5(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -4774,7 +4752,7 @@ var makeSpaceClientCoreLayer = (options, platform = {}) => {
     now: baseDependencies.clock.now,
     setTimeout: baseDependencies.clock.setTimeout,
     clearTimeout: baseDependencies.clock.clearTimeout,
-    release: { id: "chalk-client@4.1.4" }
+    release: { id: "chalk-client@4.1.7" }
   });
   const diagnosticSyncClients = /* @__PURE__ */ new Set();
   const dependencies = {