@q9labsai/chalk-client 5.2.5 → 5.2.6

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 5.2.6
+
+- Reuse microphone and camera senders after short browser capture interruptions, keeping capture disabled until a fresh user enable. Republish after long interruptions before trusting an expired provider track, and detach again if capture is interrupted during reattachment. Report interrupted owned capture as unavailable to other participants through the existing Sync pause command. Include a bounded replacement cause on the first SFU track request after a media connection is replaced.
+
 ## 5.2.0
 
 ### board-draw-policy

package/dist/{chunk-UMAE5GCV.js → chunk-CJVLTSIO.js}

@@ -1109,7 +1109,25 @@ var AddCloudflareSFUTracksPathParamsSchema = Schema.Struct({
   tenant_id: TenantIdSchema
 });
 var AddCloudflareSFUTracksQueryParamsSchema = Schema.Struct({
-  allow_partial_remote_tracks: Schema.optional(Schema.Boolean)
+  allow_partial_remote_tracks: Schema.optional(Schema.Boolean),
+  replacement_cause: Schema.optional(
+    Schema.Literals([
+      "user_pause",
+      "moderation_pause",
+      "sync_recovery_loss",
+      "discovery_absent",
+      "capture_cleanup",
+      "consent_revoked",
+      "publish_failure",
+      "enable_failure",
+      "projection_mismatch",
+      "forced_pause",
+      "local_signaling_failure",
+      "remote_signaling_failure",
+      "dormant_connection",
+      "access_refresh"
+    ])
+  )
 });
 var AddCloudflareSFUTracksRequestBodySchema = CloudflareSFUTracksRequestSchema;
 var AddCloudflareSFUTracksResponseSchema = CloudflareSFUTracksAPIResponseSchema;

package/dist/{chunk-BUNSEDXL.js → chunk-I7Y4HR2P.js}

@@ -6,11 +6,11 @@ import {
   describeMediaCaptureError,
   grantedMediaFromStream,
   markMediaFailure
-} from "./chunk-FD25AMLG.js";
+} from "./chunk-YIDKETOX.js";
 import {
   AccessGrantError,
   requireParsedAccessGrant
-} from "./chunk-UMAE5GCV.js";
+} from "./chunk-CJVLTSIO.js";
 import {
   ChatAttachmentMimeTypeSchema,
   ChatReactionSetFrameSchema,
@@ -2699,6 +2699,7 @@ function createSFUConnectionMediaClient(client) {
 function bindConnectionMediaClient(client, restart) {
   return {
     setLocalPublicationTarget: client.setLocalPublicationTarget.bind(client),
+    ...client.pauseLocalCapture ? { pauseLocalCapture: client.pauseLocalCapture.bind(client) } : {},
     ...client.setLocalSourceIntent ? { setLocalSourceIntent: client.setLocalSourceIntent.bind(client) } : {},
     ...client.closeForcedLocalPublication ? { closeForcedLocalPublication: client.closeForcedLocalPublication.bind(client) } : {},
     observeLocalPublications: client.observeLocalPublications.bind(client),
@@ -2998,7 +2999,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
       yield* publish();
     });
     const enqueue = (effect, join = false) => Effect2.gen(function* () {
-      if (model.closed) return yield* Effect2.fail(lifecycleFailure("invalid_state", false, "The Connection scope is closed"));
+      if (model.closed) return yield* Effect2.fail(lifecycleFailure("invalid_state", false, "The Connection scope is closed. Rejoin the call."));
       const deferred = yield* Deferred2.make();
       yield* Queue.offer(queue, { effect, deferred, join });
       return yield* Deferred2.await(deferred);
@@ -3328,7 +3329,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
         yield* scheduleRefresh();
       })
     );
-    const requireOpen = Effect2.suspend(() => model.closed ? Effect2.fail(lifecycleFailure("invalid_state", false, "The Connection scope is closed")) : Effect2.void);
+    const requireOpen = Effect2.suspend(() => model.closed ? Effect2.fail(lifecycleFailure("invalid_state", false, "The Connection scope is closed. Rejoin the call.")) : Effect2.void);
     const withFreshAccess = (operation) => Effect2.gen(function* () {
       yield* requireOpen;
       if (yield* access.requiresRefresh) {
@@ -4949,7 +4950,7 @@ var MediaProjectionMonitor = class {
 var MEDIA_SOURCES = ["microphone", "camera", "screen"];
 var MEDIA_READY_TIMEOUT_MS = 1e4;
 function sourceWorker(enabled) {
-  return { desired: { enabled, revision: 0, controlRevision: -1, previousEnabled: enabled }, result: { revision: 0, status: "confirmed" }, initialRevision: 0, localEnabled: enabled, pause: null, serverSequence: -1, forcedRevision: null, pausedPublicationId: null };
+  return { desired: { enabled, revision: 0, controlRevision: -1, previousEnabled: enabled }, result: { revision: 0, status: "confirmed" }, initialRevision: 0, localEnabled: enabled, pause: null, serverSequence: -1, forcedRevision: null, pausedPublicationId: null, capturePause: "none" };
 }
 var MediaControllerService = class extends Context6.Service()("@chalk/client/MediaController") {
 };
@@ -4992,6 +4993,7 @@ var MediaControllerRuntime = class {
   #tracks = /* @__PURE__ */ new Map();
   #sources = { microphone: sourceWorker(true), camera: sourceWorker(true), screen: sourceWorker(false) };
   #syncLive = false;
+  #disposed = false;
   #recovering = null;
   #pendingSources = /* @__PURE__ */ new Map();
   #pendingCaptures = /* @__PURE__ */ new Set();
@@ -5024,7 +5026,7 @@ var MediaControllerRuntime = class {
       changed: () => this.#publish(),
       report: (event) => connection.recordTransportDiagnostic(event),
       pause: (source, revision) => {
-        if (this.#ports) this.#pausePublication(this.#ports, source, revision);
+        if (this.#ports) this.#pausePublication(this.#ports, source, revision, "projection_mismatch");
       }
     });
     this.#unsubscribeConnection = connection.subscribe(() => this.#handleConnectionChange());
@@ -5130,8 +5132,9 @@ var MediaControllerRuntime = class {
     this.#fork(this.#refreshDevices().pipe(Effect5.ignore));
   }
   dispose() {
+    this.#disposed = true;
     this.#projection.reset();
-    for (const check of this.#readinessChecks) check(normalizeMediaError(cancelledCaptureError()));
+    for (const check of this.#readinessChecks) check(normalizeMediaError(this.#cancelledCaptureError()));
     this.#cancelCaptures();
     for (const unsubscribe of [this.#unsubscribeMedia, this.#unsubscribeRequests, this.#unsubscribePause, this.#unsubscribeSync]) unsubscribe?.();
     this.#unsubscribeConnection?.();
@@ -5161,7 +5164,7 @@ var MediaControllerRuntime = class {
         const check = (failure2) => {
           if (failure2) return resume(Effect5.fail(failure2));
           if (this.#sources[source].desired.revision !== revision) return resume(Effect5.void);
-          if (ports && !this.#canUsePorts(ports)) return resume(Effect5.fail(normalizeMediaError(cancelledCaptureError())));
+          if (ports && !this.#canUsePorts(ports)) return resume(Effect5.fail(normalizeMediaError(this.#cancelledCaptureError())));
           const state = this.#connection.getSnapshot().state;
           const phases = [state, this.#ports?.sync.getSnapshot().connection.phase, this.#store.getSnapshot().connection.status];
           if (phases.every((phase) => phase === "live")) return resume(Effect5.void);
@@ -5210,6 +5213,7 @@ var MediaControllerRuntime = class {
     const controlRevision = Math.max(state.serverSequence, this.#ports?.sync.getSnapshot().control?.revision ?? -1);
     const desired = { enabled, revision: state.desired.revision + 1, controlRevision, options, previousEnabled: state.localEnabled };
     state.desired = desired;
+    state.capturePause = "none";
     if (!enabled) {
       state.localEnabled = false;
       this.#pauseTracks(source);
@@ -5219,8 +5223,8 @@ var MediaControllerRuntime = class {
       }
       const ports = this.#ports;
       if (ports) {
-        ports.media.setLocalSourceIntent?.(source, false);
-        this.#retainPause(state, this.#beginLocalPause(ports, source));
+        ports.media.setLocalSourceIntent?.(source, false, "user_pause");
+        this.#retainPause(state, this.#beginLocalPause(ports, source, "user_pause"));
       }
     }
     for (const check of this.#readinessChecks) check();
@@ -5316,11 +5320,11 @@ var MediaControllerRuntime = class {
       if (state.desired.revision !== intent.revision) return;
       state.result = { revision: intent.revision, status: "failed", cause, cleanup: !intent.enabled || !previous };
       if (state.result.cleanup) {
-        if (intent.enabled && source !== "screen") this.#pausePublication(ports, source, intent.revision);
+        if (intent.enabled && source !== "screen") this.#pausePublication(ports, source, intent.revision, "enable_failure");
         else {
           state.localEnabled = false;
           this.#pauseTracks(source);
-          ports.media.setLocalSourceIntent?.(source, false);
+          ports.media.setLocalSourceIntent?.(source, false, "enable_failure");
         }
       }
     });
@@ -5434,7 +5438,7 @@ var MediaControllerRuntime = class {
   }
   #assertCurrentIntent(source, revision, enabling = true) {
     const state = this.#sources[source];
-    if (state.desired.revision !== revision || enabling && state.forcedRevision === revision) throw cancelledCaptureError();
+    if (state.desired.revision !== revision || enabling && state.forcedRevision === revision) throw this.#cancelledCaptureError();
   }
   #hasConsent(source) {
     const state = this.#sources[source];
@@ -5519,9 +5523,9 @@ var MediaControllerRuntime = class {
       )
     );
   }
-  #beginLocalPause(ports, source) {
+  #beginLocalPause(ports, source, cause) {
     this.#sources[source].pausedPublicationId = ports.media.getSnapshot().localTracks.find((item) => item.source === source)?.publicationId ?? null;
-    const pause = ports.media.closeForcedLocalPublication ? Promise.resolve().then(() => ports.media.closeForcedLocalPublication(source)) : Effect5.runPromise(this.#localTarget(ports, source, false));
+    const pause = ports.media.closeForcedLocalPublication ? Promise.resolve().then(() => ports.media.closeForcedLocalPublication(source, cause)) : Effect5.runPromise(this.#localTarget(ports, source, false));
     void pause.catch(() => void 0);
     return pause;
   }
@@ -5594,15 +5598,15 @@ var MediaControllerRuntime = class {
       return;
     }
     const state = this.#camera;
-    if (!("owner" in state)) throw cancelledCaptureError();
-    if (state.status === "live" && state.track !== track) throw cancelledCaptureError();
+    if (!("owner" in state)) throw this.#cancelledCaptureError();
+    if (state.status === "live" && state.track !== track) throw this.#cancelledCaptureError();
     const onEnded = () => this.#handleCameraEnded(track);
     this.#transitionCamera({ status: "live", owner: state.owner, track, publication: this.#ports?.media ?? "initial", onEnded });
   }
   #handleCameraEnded(track) {
     const state = this.#camera;
     if (state.status !== "live" || state.track !== track) return;
-    if (this.#ports && state.publication === this.#ports.media) this.#pausePublication(this.#ports, "camera", this.#sources.camera.desired.revision);
+    if (this.#ports && state.publication === this.#ports.media) this.#pausePublication(this.#ports, "camera", this.#sources.camera.desired.revision, "capture_cleanup");
     this.#transitionCamera({ status: "ended" });
   }
   #watchMicrophone(track) {
@@ -5615,7 +5619,7 @@ var MediaControllerRuntime = class {
       if (track.muted || track.readyState === "ended") {
         track.enabled = false;
         const state = this.#sources.microphone;
-        if (this.#ports) this.#pausePublication(this.#ports, "microphone", state.desired.revision);
+        if (this.#ports) this.#pausePublication(this.#ports, "microphone", state.desired.revision, "capture_cleanup");
         else {
           state.forcedRevision = state.desired.revision;
           state.localEnabled = false;
@@ -5694,7 +5698,7 @@ var MediaControllerRuntime = class {
       references: 0,
       cancel: () => {
         abort.abort();
-        Deferred3.doneUnsafe(owner.result, Effect5.fail(cancelledCaptureError()));
+        Deferred3.doneUnsafe(owner.result, Effect5.fail(this.#cancelledCaptureError()));
       }
     };
     this.#transitionCamera({ status: "capturing", owner });
@@ -5706,13 +5710,13 @@ var MediaControllerRuntime = class {
               const state = this.#camera;
               if (abort.signal.aborted || !("owner" in state) || state.owner !== owner) {
                 track.stop();
-                throw cancelledCaptureError();
+                throw this.#cancelledCaptureError();
               }
               const onEnded = () => this.#handleCameraEnded(track);
               this.#transitionCamera({ status: "live", owner, track, publication: state.status === "live" ? state.publication : null, onEnded });
               if (track.readyState !== "live") {
                 this.#transitionCamera({ status: "ended" });
-                throw cancelledCaptureError();
+                throw this.#cancelledCaptureError();
               }
             },
             catch: (cause) => cause
@@ -5735,7 +5739,7 @@ var MediaControllerRuntime = class {
       if (owner.references === 0 && "owner" in current && current.owner === owner && (current.status !== "live" || current.publication === null)) this.#transitionCamera({ status: "ended" });
     };
     return Deferred3.await(owner.result).pipe(
-      Effect5.flatMap((track) => track.readyState === "live" ? Effect5.succeed({ track, release }) : Effect5.fail(cancelledCaptureError())),
+      Effect5.flatMap((track) => track.readyState === "live" ? Effect5.succeed({ track, release }) : Effect5.fail(this.#cancelledCaptureError())),
       Effect5.onExit(
         (exit) => Effect5.sync(() => {
           if (Exit2.isFailure(exit)) release();
@@ -5768,25 +5772,25 @@ var MediaControllerRuntime = class {
       const cancel = () => {
         cancelled = true;
         stopStream(captured);
-        Deferred3.doneUnsafe(cancellation, Effect5.fail(cancelledCaptureError()));
+        Deferred3.doneUnsafe(cancellation, Effect5.fail(this.#cancelledCaptureError()));
       };
       this.#pendingCaptures.add(cancel);
       signal?.addEventListener("abort", cancel, { once: true });
       if (signal?.aborted) cancel();
       return foreign2(async () => {
-        if (cancelled) throw cancelledCaptureError();
+        if (cancelled) throw this.#cancelledCaptureError();
         const stream = await operation();
         captured = stream;
         if (cancelled || this.#ports?.media.getSnapshot().connection.phase === "stopped") {
           stopStream(stream);
-          throw cancelledCaptureError();
+          throw this.#cancelledCaptureError();
         }
         return stream;
       }).pipe(
         Effect5.mapError(onCaptureError),
         Effect5.flatMap(use),
         Effect5.raceFirst(Deferred3.await(cancellation)),
-        Effect5.tap(() => cancelled ? Effect5.fail(cancelledCaptureError()) : Effect5.void),
+        Effect5.tap(() => cancelled ? Effect5.fail(this.#cancelledCaptureError()) : Effect5.void),
         Effect5.onExit(
           (exit) => Effect5.sync(() => {
             this.#pendingCaptures.delete(cancel);
@@ -5860,23 +5864,48 @@ var MediaControllerRuntime = class {
     const failure2 = isPermissionDenied(input.cause) || captureWasUnavailable ? captureError(input.cause, input.action, input.permissionMessage) : input.cause;
     return rollback.pipe(Effect5.andThen(Effect5.sync(() => this.#publish())), Effect5.andThen(Effect5.fail(failure2)));
   }
+  #cancelledCaptureError() {
+    return new ConnectionError({ code: "invalid_state", action: null, recoverable: !this.#disposed, message: this.#disposed ? "This media client has been disposed. Rejoin the call." : "Media capture was cancelled before its result could be used" });
+  }
   #canUsePorts(ports) {
     return this.#ports?.sync === ports.sync && this.#ports.media === ports.media && ports.media.getSnapshot().connection.phase !== "stopped";
   }
   #assertActivePorts(ports, action) {
     if (this.#connection.getSnapshot().state === "live" && this.#canUsePorts(ports)) return;
-    throw new ConnectionError({ code: "invalid_state", action, recoverable: false, message: `${action} belongs to an inactive connection` });
+    throw new ConnectionError({ code: "invalid_state", action, recoverable: !this.#disposed, message: this.#disposed ? "This media client has been disposed. Rejoin the call." : `${action} belongs to an inactive connection` });
   }
-  #pausePublication(ports, source, revision) {
+  #pausePublication(ports, source, revision, cause) {
     const state = this.#sources[source];
     if (state.desired.revision !== revision || state.forcedRevision === revision || ports.sync.getSnapshot().control?.status === "ended") return;
     state.forcedRevision = revision;
     state.localEnabled = false;
     this.#pauseTracks(source);
-    ports.media.setLocalSourceIntent?.(source, false);
-    this.#retainPause(state, this.#beginLocalPause(ports, source));
+    if (cause === "capture_cleanup" && source !== "screen" && ports.media.pauseLocalCapture) {
+      state.capturePause = "pending";
+      this.#retainPause(state, ports.media.pauseLocalCapture(source));
+      this.#notifyCapturePauses(ports);
+    } else {
+      ports.media.setLocalSourceIntent?.(source, false, cause);
+      this.#retainPause(state, this.#beginLocalPause(ports, source, cause));
+    }
     this.#publish();
   }
+  #notifyCapturePauses(ports) {
+    for (const source of ["microphone", "camera"]) {
+      const state = this.#sources[source];
+      if (state.capturePause === "pending") this.#retainPause(state, this.#announceCapturePause(ports, source));
+    }
+  }
+  async #announceCapturePause(ports, source) {
+    const snapshot = ports.sync.getSnapshot();
+    if (snapshot.connection.phase !== "live") return;
+    const owned = ports.media.getSnapshot().localTracks.find((item) => item.source === source);
+    const projected = snapshot.media?.items.find((item) => item.participantId === snapshot.participantId && item.source === source);
+    if (!owned?.publicationId || !projected?.enabled || projected.publicationId !== owned.publicationId) return;
+    this.#sources[source].capturePause = "announced";
+    const send = source === "microphone" ? ports.sync.setMicrophoneEnabled : ports.sync.setCameraEnabled;
+    await send.call(ports.sync, false);
+  }
   #bind(ports) {
     if (ports?.media.getSnapshot().connection.phase === "stopped") this.#cancelCaptures();
     if (ports && this.#ports?.sync === ports.sync && this.#ports.media === ports.media) return;
@@ -5914,10 +5943,11 @@ var MediaControllerRuntime = class {
       const state = this.#sources[pause.source];
       if (pause.revision <= state.serverSequence) return;
       state.serverSequence = pause.revision;
-      if (pause.revision > state.desired.controlRevision) this.#pausePublication(ports, pause.source, state.desired.revision);
+      if (pause.revision > state.desired.controlRevision) this.#pausePublication(ports, pause.source, state.desired.revision, "moderation_pause");
     }) ?? null;
   }
   #rememberRecoveryIntents() {
+    for (const state of Object.values(this.#sources)) if (state.capturePause === "announced") state.capturePause = "pending";
     if (!this.#ports) return;
     this.#recovering ??= new Map(MEDIA_SOURCES.filter((source) => this.#sources[source].desired.enabled).map((source) => [source, this.#sources[source].desired.revision]));
   }
@@ -5926,7 +5956,7 @@ var MediaControllerRuntime = class {
     this.#recovering = null;
     for (const [source, revision] of recovering ?? []) {
       const current = snapshot.media?.items.find((item) => item.participantId === snapshot.participantId && item.source === source);
-      if (!current?.enabled) this.#pausePublication(ports, source, revision);
+      if (!current?.enabled) this.#pausePublication(ports, source, revision, "sync_recovery_loss");
     }
   }
   #subscribeSync(ports) {
@@ -5934,6 +5964,7 @@ var MediaControllerRuntime = class {
       this.#removeRequestsFromMissingParticipants(snapshot);
       this.#applyRemoteMediaState(ports, snapshot);
       this.#reconcileIntents();
+      this.#notifyCapturePauses(ports);
       this.#publish();
     });
   }
@@ -6029,8 +6060,8 @@ var MediaControllerRuntime = class {
     const state = this.#sources[source];
     if (!this.#hasConsent(source) && publication?.enabled && state.pausedPublicationId !== publication.publicationId) {
       this.#pauseTracks(source);
-      ports.media.setLocalSourceIntent?.(source, false);
-      this.#retainPause(state, this.#beginLocalPause(ports, source));
+      ports.media.setLocalSourceIntent?.(source, false, "consent_revoked");
+      this.#retainPause(state, this.#beginLocalPause(ports, source, "consent_revoked"));
     }
   }
   #observeProjection(ports, source) {
@@ -6094,9 +6125,6 @@ function confirmedLocalMediaState(track, desired, pending, confirmed, live, conv
   if (!live && track && liveTrack(track)) return "requesting";
   return confirmed ? "enabled" : pending ? "requesting" : "disabled";
 }
-function cancelledCaptureError() {
-  return new ConnectionError({ code: "invalid_state", action: null, recoverable: false, message: "Media capture was cancelled before its result could be used" });
-}
 function foreign2(operation) {
   return Effect5.tryPromise({ try: operation, catch: (cause) => cause });
 }
@@ -7193,7 +7221,7 @@ var SpaceClientCore = class {
       }
   }
   #requireActive() {
-    if (this.#disposed) throw new SpaceClientError({ code: "connection.invalid_state", recoverable: false, message: "The SpaceClient has been disposed" });
+    if (this.#disposed) throw new SpaceClientError({ code: "connection.invalid_state", recoverable: false, message: "The SpaceClient has been disposed. Rejoin the call." });
   }
 };
 function liveClock(dependencies) {

package/dist/{chunk-LKNT6XFD.js → chunk-WFRTUBN6.js}

@@ -1,7 +1,7 @@
 import {
   createChalkEffectClient,
   parseAccessGrant
-} from "./chunk-UMAE5GCV.js";
+} from "./chunk-CJVLTSIO.js";
 
 // src/public-invites/client.ts
 import { Effect } from "effect";

package/dist/{chunk-FD25AMLG.js → chunk-YIDKETOX.js}

@@ -238,6 +238,7 @@ var INVALID_PUBLICATION_SIGNATURE = "\0invalid";
 var CONNECTION_TIMEOUT_MS = 8e3;
 var NEGOTIATION_TIMEOUT_MS = 35e3;
 var PEER_OPERATION_TIMEOUT_MS = 8e3;
+var CAPTURE_REUSE_WINDOW_MS = 2e4;
 var CloudflareSFUClient = class {
   #localListeners = /* @__PURE__ */ new Set();
   #onError;
@@ -250,7 +251,7 @@ var CloudflareSFUClient = class {
   #remoteListeners = /* @__PURE__ */ new Set();
   #snapshotListeners = /* @__PURE__ */ new Set();
   #failureOwners = /* @__PURE__ */ new WeakMap();
-  #locallyPausedSources = /* @__PURE__ */ new Set();
+  #locallyPausedSources = /* @__PURE__ */ new Map();
   #localTracks = /* @__PURE__ */ new Map();
   #ownedPublications = /* @__PURE__ */ new Set();
   #remoteTracks = /* @__PURE__ */ new Map();
@@ -259,9 +260,11 @@ var CloudflareSFUClient = class {
   #disposeConnectionObservation;
   #connectionEpoch = 0;
   #retiredLocalConnection = null;
+  #retiredLocalCause = "forced_pause";
+  #replacementCause;
   #cursor = null;
   #remotePullIncomplete = false;
-  #remotePullRetryAfter = /* @__PURE__ */ new Map();
+  #remotePullRetries = /* @__PURE__ */ new Map();
   #remoteParticipantIds = null;
   #remoteParticipantRevision = 0;
   #subscribedPublicationIds = /* @__PURE__ */ new Set();
@@ -308,7 +311,7 @@ var CloudflareSFUClient = class {
     return subscribeSnapshot(this.#snapshotListeners, listener);
   }
   remotePublicationResumed(publicationId) {
-    this.#remotePullRetryAfter.delete(publicationId);
+    this.#remotePullRetries.delete(publicationId);
     this.remotePublicationsChanged();
   }
   remoteParticipantsChanged(participantIds) {
@@ -363,9 +366,9 @@ var CloudflareSFUClient = class {
   }
   async #clearPreparedTrack(state, stopTrack = true) {
     const source = state.source;
-    if (source === "screen" || source === "screen_audio" || state.track.readyState === "ended") {
+    if (source === "screen" || source === "screen_audio") {
       try {
-        this.#pauseLocalSource(source);
+        this.#pauseLocalSource(source, "capture_cleanup");
         await this.#retireOwnedPublications();
       } finally {
         this.#removeOwnedLocalTrack(state, stopTrack);
@@ -431,6 +434,10 @@ var CloudflareSFUClient = class {
     const resolved = resolveMediaTarget(this.#participantId, this.#stopped, this.#localTracks, target);
     if (resolved.kind === "result" && resolved.result.outcome !== "satisfied") return resolved.result;
     const outcome = resolved.kind === "state" && resolved.value.enabled ? "confirmed" : "satisfied";
+    if (target.source !== "screen" && this.#locallyPausedSources.get(target.source) === "capture_cleanup") {
+      await this.pauseLocalCapture(target.source);
+      return { outcome, errorCode: null };
+    }
     this.#pauseLocalSource(target.source);
     try {
       await this.#retireOwnedPublications();
@@ -449,26 +456,31 @@ var CloudflareSFUClient = class {
       await this.#retireUnavailableLocalPublication(state);
       if (this.#locallyPausedSources.has(target.source)) return { outcome: "terminal_failure", errorCode: "local_source_paused" };
       if (state.enabled) return { outcome: "satisfied", errorCode: null };
-      await this.#enablePreparedTrack(state);
+      if (!await this.#enablePreparedTrack(state)) return { outcome: "terminal_failure", errorCode: "local_source_paused" };
       return { outcome: "confirmed", errorCode: null };
     } catch (error) {
       if (generation === this.#generation && !this.#stopped) this.#reportError(error);
       return mediaTargetFailure(error);
     }
   }
-  setLocalSourceIntent(source, enabled) {
+  async pauseLocalCapture(source) {
+    this.#locallyPausedSources.set(source, "capture_cleanup");
+    const state = this.#localTracks.get(source);
+    if (state) await this.#disablePreparedTrack(state);
+  }
+  setLocalSourceIntent(source, enabled, cause = "forced_pause") {
     const sources = localSourceGroup(source);
     for (const item of sources) {
       if (enabled) this.#locallyPausedSources.delete(item);
-      else this.#locallyPausedSources.add(item);
+      else this.#locallyPausedSources.set(item, cause);
     }
-    if (!enabled) this.#pauseLocalSource(source);
+    if (!enabled) this.#pauseLocalSource(source, cause);
     return enabled ? Promise.resolve() : this.#retireOwnedPublications();
   }
-  async closeForcedLocalPublication(source) {
+  async closeForcedLocalPublication(source, cause = "forced_pause") {
     const sources = localSourceGroup(source);
     const ownsPublication = [...this.#ownedPublications].some((item) => sources.includes(item.state.source));
-    await this.setLocalSourceIntent(source, false);
+    await this.setLocalSourceIntent(source, false, cause);
     if (!ownsPublication || !this.#replaceMediaConnection) return;
     const generation = this.#generation;
     await this.#serializeSDP(async () => {
@@ -491,16 +503,15 @@ var CloudflareSFUClient = class {
     const authoritative = await this.#signal(() => this.#requireTransport().listPublications());
     if (authoritative.publications.some((publication) => publication.publicationId === publicationId)) return;
     if (state.providerPublicationId === publicationId) {
-      this.#pauseLocalSource(state.source);
+      this.#pauseLocalSource(state.source, "discovery_absent");
       await this.#retireOwnedPublications();
     }
   }
-  #pauseLocalSource(source) {
+  #pauseLocalSource(source, cause = "forced_pause") {
     const sources = localSourceGroup(source);
     for (const publication of this.#ownedPublications) {
       if (!sources.includes(publication.state.source)) continue;
-      this.#markPublicationRetiring(publication);
-      this.#retiredLocalConnection = this.#connection;
+      this.#markPublicationRetiring(publication, cause);
     }
     for (const state of this.#localTracks.values()) {
       if (!sources.includes(state.source)) continue;
@@ -510,7 +521,7 @@ var CloudflareSFUClient = class {
     this.#publishSnapshot();
     this.#emitLocal();
   }
-  #retireOwnedPublications() {
+  #retireOwnedPublications(reportFailure = this.#reportError.bind(this)) {
     const publications = [...this.#ownedPublications].filter((item) => item.lifecycle.kind === "retiring" && item.lifecycle.handle);
     const retirement = (async () => {
       const errors = [];
@@ -519,7 +530,7 @@ var CloudflareSFUClient = class {
           await this.#serializeSDP(() => this.#closeOwnedPublication(publication), true);
         } catch (error) {
           errors.push(error);
-          if (!this.#stopped) this.#reportError(error);
+          if (!this.#stopped) reportFailure(error);
         }
       }
       if (this.#stopped && this.#ownedPublications.size === 0) this.#transport = void 0;
@@ -529,15 +540,24 @@ var CloudflareSFUClient = class {
     });
     return this.#retirement = retirement;
   }
-  #markPublicationRetiring(publication) {
+  #markPublicationRetiring(publication, cause = "publish_failure") {
     const phase = publication.lifecycle;
-    if (phase.kind === "pending" || phase.kind === "confirmed") publication.lifecycle = { kind: "retiring", handle: phase.kind === "confirmed" ? phase.handle : null, detached: false };
+    if (phase.kind === "pending" || phase.kind === "confirmed") publication.lifecycle = { kind: "retiring", handle: phase.kind === "confirmed" ? phase.handle : null, detached: false, cause };
+  }
+  #markBundledTransportRetiring(publication) {
+    const bundleTag = /(?:^|\r?\n)a=group:BUNDLE[ \t]+(\S+)/.exec(publication.connection.localDescription?.sdp ?? "")?.[1];
+    if (!bundleTag || publication.transceiver.mid !== null && publication.transceiver.mid === bundleTag) {
+      if (this.#retiredLocalConnection === publication.connection) return;
+      this.#retiredLocalConnection = publication.connection;
+      if (publication.lifecycle.kind === "retiring") this.#retiredLocalCause = publication.lifecycle.cause;
+    }
   }
   async #closeOwnedPublication(publication) {
     const phase = publication.lifecycle;
     if (phase.kind !== "retiring" || !phase.handle) return;
     const handle = phase.handle;
     const { connection, connectionId, transceiver, state } = publication;
+    this.#markBundledTransportRetiring(publication);
     let closed = connection.connectionState === "closed";
     try {
       if (!phase.detached && !closed) {
@@ -574,13 +594,16 @@ var CloudflareSFUClient = class {
     this.#requireActive();
     const options = "connectionId" in input ? { bootstrap: input } : input;
     validateBootstrap(options.bootstrap);
-    if (options.bootstrap.connectionId !== this.#bootstrap.connectionId) this.#fenceLocalPublications();
+    if (options.bootstrap.connectionId !== this.#bootstrap.connectionId) {
+      this.#fenceLocalPublications();
+      this.#replacementCause = "access_refresh";
+    }
     const generation = ++this.#generation;
     const connectionEpoch = ++this.#connectionEpoch;
     this.#polling = false;
     this.#pollAfterCurrent = false;
     this.#clearPoll();
-    this.#remotePullRetryAfter.clear();
+    this.#remotePullRetries.clear();
     this.#disposeConnection(false);
     for (const publication of this.#ownedPublications) this.#markPublicationRetiring(publication);
     void this.#retireOwnedPublications();
@@ -622,7 +645,7 @@ var CloudflareSFUClient = class {
     this.#generation++;
     this.#connectionEpoch++;
     this.#clearPoll();
-    this.#remotePullRetryAfter.clear();
+    this.#remotePullRetries.clear();
     this.#polling = false;
     this.#pollAfterCurrent = false;
     this.#disposeConnection(true);
@@ -645,35 +668,64 @@ var CloudflareSFUClient = class {
   }
   async #enablePreparedTrack(state) {
     const generation = this.#generation;
-    state.desiredEnabled = true;
-    state.track.enabled = true;
     try {
-      if (state.providerPublicationId && state.transceiver) {
-        await this.#boundPeerOperation(state.transceiver.sender.replaceTrack(state.track));
-        state.enabled = !this.#locallyPausedSources.has(state.source);
-        state.desiredEnabled = state.enabled;
-        state.track.enabled = state.enabled;
-        if (!state.enabled) {
-          this.#pauseLocalSource(state.source);
-          await this.#retireOwnedPublications();
-        }
-        this.#publishSnapshot();
-        this.#emitLocal();
-        return;
-      }
+      await this.#retireExpiredCapture(state);
+      if (this.#locallyPausedSources.has(state.source)) return false;
+      state.desiredEnabled = true;
+      state.track.enabled = true;
+      if (state.providerPublicationId && state.transceiver) return await this.#reattachLocalTrack(state, state.transceiver);
       await this.#publishPreparedTracks([state], generation);
       if (this.#remoteRecoveryGeneration !== generation) this.#replacementAttemptedGeneration = null;
+      return state.enabled;
     } catch (error) {
       if (generation === this.#generation) {
-        this.#pauseLocalSource(state.source);
+        this.#pauseLocalSource(state.source, "enable_failure");
         await this.#retireOwnedPublications().catch(() => {
         });
       }
       throw error;
     }
   }
+  async #retireExpiredCapture(state) {
+    const publication = [...this.#ownedPublications].find((item) => item.transceiver === state.transceiver && item.lifecycle.kind === "confirmed");
+    if (!publication || publication.detachedAt === null || Date.now() - publication.detachedAt < CAPTURE_REUSE_WINDOW_MS) return;
+    this.#pauseLocalSource(state.source, "capture_cleanup");
+    try {
+      await this.#retireOwnedPublications((error) => {
+        if (!this.#isExpiredRetiredConnection(error)) this.#reportError(error);
+      });
+    } catch (error) {
+      if (!this.#isExpiredRetiredConnection(error)) throw error;
+      this.#fenceLocalPublications();
+    }
+  }
+  #isExpiredRetiredConnection(error) {
+    if (!this.#replaceMediaConnection || this.#retiredLocalConnection !== this.#connection) return false;
+    if (error instanceof AggregateError) return error.errors.every((cause) => this.#isRetryableConnectionFailure(cause));
+    return this.#isRetryableConnectionFailure(error);
+  }
+  async #reattachLocalTrack(state, transceiver) {
+    await this.#boundPeerOperation(transceiver.sender.replaceTrack(state.track));
+    const cause = this.#locallyPausedSources.get(state.source);
+    state.enabled = cause === void 0;
+    state.desiredEnabled = state.enabled;
+    state.track.enabled = state.enabled;
+    if (cause === "capture_cleanup") await this.#disablePreparedTrack(state);
+    else if (cause) {
+      this.#pauseLocalSource(state.source, cause);
+      await this.#retireOwnedPublications();
+    } else {
+      for (const publication of this.#ownedPublications) if (publication.transceiver === transceiver) publication.detachedAt = null;
+    }
+    this.#publishSnapshot();
+    this.#emitLocal();
+    return state.enabled;
+  }
   async #disablePreparedTrack(state) {
     const transceiver = state.transceiver;
+    for (const publication of this.#ownedPublications) {
+      if (publication.transceiver === transceiver && publication.lifecycle.kind === "confirmed") publication.detachedAt ??= Date.now();
+    }
     state.desiredEnabled = false;
     state.track.enabled = false;
     const detach = transceiver ? this.#boundPeerOperation(transceiver.sender.replaceTrack(null)) : Promise.resolve();
@@ -691,7 +743,7 @@ var CloudflareSFUClient = class {
           await this.#publishPreparedTracksSerialized(pending, generation, this.#connection, this.#bootstrap.connectionId);
         } catch (error) {
           if (!this.#replaceMediaConnection || !this.#isRetryableConnectionFailure(error) || this.#replacementAttemptedGeneration === generation) throw error;
-          await this.#replaceMediaConnectionForRecovery(generation);
+          await this.#replaceMediaConnectionForRecovery(generation, "local_signaling_failure");
           await this.#publishPreparedTracksSerialized(
             [...this.#localTracks.values()].filter((state) => (state.desiredEnabled || states.includes(state)) && state.track.readyState !== "ended"),
             generation,
@@ -713,14 +765,14 @@ var CloudflareSFUClient = class {
     const authoritative = await this.#signal(() => this.#requireTransport().listPublications());
     this.#pauseUnavailableOtherSources(authoritative.publications, states);
     this.#replacementAttemptedGeneration = null;
-    await this.#replaceMediaConnectionForRecovery(generation);
+    await this.#replaceMediaConnectionForRecovery(generation, this.#retiredLocalCause);
     return [...this.#localTracks.values()].filter((state) => (state.desiredEnabled || states.includes(state)) && state.track.readyState !== "ended");
   }
   #pauseUnavailableOtherSources(publications, states) {
     for (const state of this.#localTracks.values()) {
       if (states.includes(state) || !state.providerPublicationId) continue;
       if (publications.some((publication) => publication.publicationId === state.providerPublicationId)) continue;
-      this.#pauseLocalSource(state.source);
+      this.#pauseLocalSource(state.source, "discovery_absent");
     }
     void this.#retireOwnedPublications();
   }
@@ -750,7 +802,7 @@ var CloudflareSFUClient = class {
   }
   async #prepareLocalPublication(connection, state, generation) {
     const transceiver = state.transceiver ?? this.#addLocalTransceiver(connection, state);
-    const publication = { state, transceiver, trackName: `${state.source}-${globalThis.crypto.randomUUID()}`, connection, connectionId: this.#bootstrap.connectionId, lifecycle: { kind: "pending" } };
+    const publication = { state, transceiver, trackName: `${state.source}-${globalThis.crypto.randomUUID()}`, connection, connectionId: this.#bootstrap.connectionId, detachedAt: null, lifecycle: { kind: "pending" } };
     this.#ownedPublications.add(publication);
     if (state.transceiver) await this.#boundPeerOperation(transceiver.sender.replaceTrack(state.track));
     this.#requireGeneration(generation);
@@ -798,7 +850,7 @@ var CloudflareSFUClient = class {
         source: state.source
       })
     );
-    const response = await this.#signal(() => this.#requireTransport().addTracks({ connectionId, sessionDescription, tracks }), { generation, connectionId });
+    const response = await this.#signal(() => this.#addTracks({ connectionId, sessionDescription, tracks }), { generation, connectionId });
     this.#recordLocalPublicationHandles(publications, response.tracks);
     this.#requireGeneration(generation);
     await this.#applyProviderDescription(response, connection);
@@ -824,7 +876,7 @@ var CloudflareSFUClient = class {
         state.providerPublicationId = lifecycle.handle.publicationId;
         continue;
       }
-      this.#markPublicationRetiring(publication);
+      this.#markPublicationRetiring(publication, this.#locallyPausedSources.get(state.source) ?? "publish_failure");
       if (state.transceiver === transceiver) {
         this.#clearLocalPublication(state);
       }
@@ -871,8 +923,8 @@ var CloudflareSFUClient = class {
   }
   #pendingRemotePulls(desired) {
     const desiredIds = new Set([...desired.values()].map((publication) => publication.publicationId));
-    for (const publicationId of this.#remotePullRetryAfter.keys()) {
-      if (!desiredIds.has(publicationId)) this.#remotePullRetryAfter.delete(publicationId);
+    for (const publicationId of this.#remotePullRetries.keys()) {
+      if (!desiredIds.has(publicationId)) this.#remotePullRetries.delete(publicationId);
     }
     for (const publicationId of this.#subscribedPublicationIds) {
       if (!desiredIds.has(publicationId)) this.#subscribedPublicationIds.delete(publicationId);
@@ -880,7 +932,7 @@ var CloudflareSFUClient = class {
     const now = Date.now();
     return [...desired].filter(([key, publication]) => {
       if (this.#remoteTracks.get(key)?.publicationId === publication.publicationId) return false;
-      const remaining = (this.#remotePullRetryAfter.get(publication.publicationId) ?? 0) - now;
+      const remaining = (this.#remotePullRetries.get(publication.publicationId)?.retryAfter ?? 0) - now;
       return remaining <= 0;
     }).map(([, publication]) => publication);
   }
@@ -921,7 +973,8 @@ var CloudflareSFUClient = class {
     }
   }
   #canReplaceConnectionAfterRemotePull(error, generation) {
-    return this.#isRetryableConnectionFailure(error) && !this.#hasLiveRemoteTracks() && this.#replaceMediaConnection !== void 0 && this.#replacementAttemptedGeneration !== generation;
+    const gone = error instanceof CloudflareSFUError && (error.options.status === 404 || error.options.status === 410);
+    return this.#isRetryableConnectionFailure(error) && (gone || !this.#hasLiveRemoteTracks()) && this.#replaceMediaConnection !== void 0 && this.#replacementAttemptedGeneration !== generation;
   }
   #hasLiveRemoteTracks() {
     return [...this.#remoteTracks.values()].some((publication) => publication.track.readyState === "live");
@@ -929,7 +982,7 @@ var CloudflareSFUClient = class {
   async #retryRemotePullOnReplacement(publications, cursor, generation) {
     this.#remoteRecoveryGeneration = generation;
     try {
-      await this.#replaceMediaConnectionForRecovery(generation);
+      await this.#replaceMediaConnectionForRecovery(generation, "remote_signaling_failure");
       await this.#republishPreparedTracksAfterRecovery(generation);
       return await this.#pull(publications, generation);
     } catch (error) {
@@ -974,7 +1027,10 @@ var CloudflareSFUClient = class {
   }
   #deferRemotePulls(publications, error) {
     const retryAfter = retryableRemotePull(error) ? Date.now() + 15e3 : Number.POSITIVE_INFINITY;
-    for (const publication of publications) this.#remotePullRetryAfter.set(publication.publicationId, retryAfter);
+    for (const publication of publications) {
+      const failures = this.#remotePullRetries.get(publication.publicationId)?.failures ?? 0;
+      this.#remotePullRetries.set(publication.publicationId, { retryAfter, failures });
+    }
   }
   async #pullBatch(publications, generation) {
     if (publications.length === 0) return [];
@@ -1000,12 +1056,12 @@ var CloudflareSFUClient = class {
       connection.addEventListener("track", onTrack);
       try {
         this.#requireGeneration(generation);
-        const response = await this.#signal(() => this.#requireTransport().addTracks({ connectionId, tracks: requested, allowPartialRemoteTracks: true }), { generation, connectionId });
+        const response = await this.#signal(() => this.#addTracks({ connectionId, tracks: requested, allowPartialRemoteTracks: true }), { generation, connectionId });
         this.#requireGeneration(generation);
         this.#recordRemotePullErrors(publications, response.trackErrors ?? []);
         const responseTracks = response.tracks ?? [];
         const matched = matchRemotePullTracks(publications, responseTracks);
-        for (const { publication } of matched) this.#remotePullRetryAfter.delete(publication.publicationId);
+        for (const { publication } of matched) this.#remotePullRetries.delete(publication.publicationId);
         await this.#completeRenegotiation(response, connection, connectionId, generation);
         if (matched.length === 0) return [];
         await this.#waitForConnection(connection, generation);
@@ -1035,8 +1091,10 @@ var CloudflareSFUClient = class {
     for (const failure of failures) {
       const publication = requested.get(`${failure.connectionId}\0${failure.trackName}`);
       if (!publication) throw new CloudflareSFUError("Cloudflare SFU returned an unrequested remote track error", "invalid_publication");
-      const delay = 15e3;
-      this.#remotePullRetryAfter.set(publication.publicationId, Date.now() + delay);
+      const previous = this.#remotePullRetries.get(publication.publicationId) ?? { retryAfter: 0, failures: 0 };
+      const failureCount = Math.min(previous.failures + 1, 6);
+      const delay = Math.min(15e3, 750 * 2 ** (failureCount - 1));
+      this.#remotePullRetries.set(publication.publicationId, { retryAfter: Date.now() + delay, failures: failureCount });
       this.#reportError(new CloudflareSFUError(`Cloudflare SFU remote track failed: ${failure.code}`, "media_failed", { providerCode: failure.code }));
     }
   }
@@ -1187,9 +1245,14 @@ var CloudflareSFUClient = class {
   }
   async #replaceDormantConnectionBeforeNegotiation(generation) {
     if (!this.#started || this.#negotiatedGeneration === generation || this.#replacementAttemptedGeneration === generation || !this.#replaceMediaConnection) return;
-    await this.#replaceMediaConnectionForRecovery(generation);
+    await this.#replaceMediaConnectionForRecovery(generation, "dormant_connection");
+  }
+  #addTracks(input) {
+    const replacementCause = this.#replacementCause;
+    this.#replacementCause = void 0;
+    return this.#requireTransport().addTracks({ ...input, replacementCause });
   }
-  async #replaceMediaConnectionForRecovery(generation) {
+  async #replaceMediaConnectionForRecovery(generation, cause) {
     this.#requireGeneration(generation);
     if (!this.#replaceMediaConnection || this.#replacementAttemptedGeneration === generation) {
       throw new CloudflareSFUError("A fresh Cloudflare SFU connection is unavailable", "signaling_failed");
@@ -1209,6 +1272,7 @@ var CloudflareSFUClient = class {
     this.#cursor = null;
     this.#bootstrap = bootstrap;
     this.#rebuildPeerConnection(bootstrap, generation, connectionEpoch);
+    this.#replacementCause = cause;
     this.#retiredLocalConnection = null;
     this.#negotiatedGeneration = null;
     for (const state of this.#localTracks.values()) {
@@ -1557,7 +1621,10 @@ function createCloudflareSFUHTTPTransport(options) {
   };
   return {
     addTracks: async (input) => {
-      const path = input.allowPartialRemoteTracks ? "tracks?allow_partial_remote_tracks=true" : "tracks";
+      const query = new URLSearchParams();
+      if (input.allowPartialRemoteTracks) query.set("allow_partial_remote_tracks", "true");
+      if (input.replacementCause) query.set("replacement_cause", input.replacementCause);
+      const path = query.size ? `tracks?${query}` : "tracks";
       const response = await request(path, {
         method: "POST",
         body: JSON.stringify({ connection_id: input.connectionId, session_description: input.sessionDescription, tracks: input.tracks })

package/dist/client.d.ts

@@ -23,6 +23,7 @@ export declare const createChalkEffectClient: (options: ChalkEffectClientOptions
             readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
         }>>, import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
             readonly allow_partial_remote_tracks: import("effect/Schema").optional<import("effect/Schema").Boolean>;
+            readonly replacement_cause: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["user_pause", "moderation_pause", "sync_recovery_loss", "discovery_absent", "capture_cleanup", "consent_revoked", "publish_failure", "enable_failure", "projection_mismatch", "forced_pause", "local_signaling_failure", "remote_signaling_failure", "dormant_connection", "access_refresh"]>>;
         }>>, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
             readonly connection_id: import("effect/Schema").String;
             readonly session_description: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{

package/dist/connection/production.d.ts

@@ -10,6 +10,6 @@ export declare const makeProductionConnectionPlatformLayer: (options: {
     readonly syncURL: string;
     readonly whiteboardURL?: string | null;
 }) => import("effect/Layer").Layer<import("./dependencies").ConnectionPlatformService, never, never>;
-type BoundMediaClient = Pick<ConnectionMediaClient, "setLocalPublicationTarget" | "setLocalSourceIntent" | "closeForcedLocalPublication" | "observeLocalPublications" | "observeRemotePublications" | "remotePublicationsChanged" | "remoteParticipantsChanged" | "remotePublicationResumed" | "start" | "stop" | "prepareLocalTrack" | "clearPreparedLocalTrack" | "getSnapshot" | "subscribe">;
+type BoundMediaClient = Pick<ConnectionMediaClient, "setLocalPublicationTarget" | "pauseLocalCapture" | "setLocalSourceIntent" | "closeForcedLocalPublication" | "observeLocalPublications" | "observeRemotePublications" | "remotePublicationsChanged" | "remoteParticipantsChanged" | "remotePublicationResumed" | "start" | "stop" | "prepareLocalTrack" | "clearPreparedLocalTrack" | "getSnapshot" | "subscribe">;
 export declare function bindConnectionMediaClient(client: BoundMediaClient, restart: ConnectionMediaClient["restart"]): ConnectionMediaClient;
 export {};

package/dist/effect.js

@@ -17,8 +17,8 @@ import {
   makeSpaceClientCoreLayer,
   makeSpaceClientCoreLayerFromServices,
   makeSpaceStoreLayer
-} from "./chunk-BUNSEDXL.js";
-import "./chunk-FD25AMLG.js";
+} from "./chunk-I7Y4HR2P.js";
+import "./chunk-YIDKETOX.js";
 import {
   APIKeyListSchema,
   APIKeyWithSecretSchema,
@@ -841,7 +841,7 @@ import {
   WhiteboardStorageUnavailableErrorSchema,
   WhiteboardStorageUnavailableErrorWireSchema,
   createChalkEffectClient
-} from "./chunk-UMAE5GCV.js";
+} from "./chunk-CJVLTSIO.js";
 import "./chunk-5YPQNMJE.js";
 
 // src/space-client/effect.ts

package/dist/generated/http-api.d.ts

@@ -7,6 +7,7 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
     readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
 }>>, import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
     readonly allow_partial_remote_tracks: import("effect/Schema").optional<import("effect/Schema").Boolean>;
+    readonly replacement_cause: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["user_pause", "moderation_pause", "sync_recovery_loss", "discovery_absent", "capture_cleanup", "consent_revoked", "publish_failure", "enable_failure", "projection_mismatch", "forced_pause", "local_signaling_failure", "remote_signaling_failure", "dormant_connection", "access_refresh"]>>;
 }>>, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
     readonly connection_id: import("effect/Schema").String;
     readonly session_description: import("effect/Schema").optional<import("effect/Schema").NullOr<import("effect/Schema").Struct<{

package/dist/generated/schemas.d.ts

@@ -1358,6 +1358,7 @@ export declare const AddCloudflareSFUTracksPathParamsSchema: Schema.Struct<{
 export type AddCloudflareSFUTracksPathParams = typeof AddCloudflareSFUTracksPathParamsSchema.Type;
 export declare const AddCloudflareSFUTracksQueryParamsSchema: Schema.Struct<{
     readonly allow_partial_remote_tracks: Schema.optional<Schema.Boolean>;
+    readonly replacement_cause: Schema.optional<Schema.Literals<readonly ["user_pause", "moderation_pause", "sync_recovery_loss", "discovery_absent", "capture_cleanup", "consent_revoked", "publish_failure", "enable_failure", "projection_mismatch", "forced_pause", "local_signaling_failure", "remote_signaling_failure", "dormant_connection", "access_refresh"]>>;
 }>;
 export type AddCloudflareSFUTracksQueryParams = typeof AddCloudflareSFUTracksQueryParamsSchema.Type;
 export declare const AddCloudflareSFUTracksRequestBodySchema: Schema.Struct<{

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   createSpaceClient,
   decodeWhiteboardV1ServerFrame,
   encodeWhiteboardV1ClientFrame
-} from "./chunk-BUNSEDXL.js";
+} from "./chunk-I7Y4HR2P.js";
 import {
   CloudflareSFUClient,
   CloudflareSFUError,
@@ -28,19 +28,19 @@ import {
   requireSFUDescription,
   validatePublicationSnapshot,
   waitFor
-} from "./chunk-FD25AMLG.js";
+} from "./chunk-YIDKETOX.js";
 import {
   createChalkPublicClient,
   createChalkPublicInviteClient,
   parseInviteCode
-} from "./chunk-LKNT6XFD.js";
+} from "./chunk-WFRTUBN6.js";
 import {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError,
   parseParsedAccessGrant,
   requireAccessGrant
-} from "./chunk-UMAE5GCV.js";
+} from "./chunk-CJVLTSIO.js";
 import {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,

package/dist/media/client.d.ts

@@ -1,4 +1,4 @@
-import type { ClientMediaPlane, MediaPlaneResult, MediaPlaneTarget, MediaPublication, MediaPublicationSource } from "./plane";
+import type { ClientMediaPlane, LocalPublicationRetirementCause, MediaPlaneResult, MediaPlaneTarget, MediaPublication, MediaPublicationSource } from "./plane";
 import type { CloudflareSFUBootstrap, CloudflareSFUClientOptions, CloudflareSFURestartOptions, CloudflareSFUSnapshot } from "./types";
 export declare class CloudflareSFUClient implements ClientMediaPlane {
     #private;
@@ -15,8 +15,9 @@ export declare class CloudflareSFUClient implements ClientMediaPlane {
     start(localMedia: MediaStream): Promise<void>;
     refreshRemotePublications(): Promise<void>;
     setLocalPublicationTarget(target: MediaPlaneTarget): Promise<MediaPlaneResult>;
-    setLocalSourceIntent(source: MediaPublicationSource, enabled: boolean): Promise<void>;
-    closeForcedLocalPublication(source: MediaPublicationSource): Promise<void>;
+    pauseLocalCapture(source: "microphone" | "camera"): Promise<void>;
+    setLocalSourceIntent(source: MediaPublicationSource, enabled: boolean, cause?: LocalPublicationRetirementCause): Promise<void>;
+    closeForcedLocalPublication(source: MediaPublicationSource, cause?: LocalPublicationRetirementCause): Promise<void>;
     observeLocalPublications(listener: (publications: readonly MediaPublication[]) => void): () => void;
     observeRemotePublications(listener: (publications: readonly MediaPublication[]) => void): () => void;
     restart(input: CloudflareSFUBootstrap | CloudflareSFURestartOptions): Promise<void>;

package/dist/media/index.js

@@ -10,7 +10,7 @@ import {
   requireSFUDescription,
   validatePublicationSnapshot,
   waitFor
-} from "../chunk-FD25AMLG.js";
+} from "../chunk-YIDKETOX.js";
 export {
   CloudflareSFUClient,
   CloudflareSFUError,

package/dist/media/plane.d.ts

@@ -1,3 +1,6 @@
+import type { operations } from "../generated/openapi-types";
+export type MediaConnectionReplacementCause = NonNullable<NonNullable<operations["addCloudflareSFUTracks"]["parameters"]["query"]>["replacement_cause"]>;
+export type LocalPublicationRetirementCause = Exclude<MediaConnectionReplacementCause, "local_signaling_failure" | "remote_signaling_failure" | "dormant_connection" | "access_refresh">;
 export type ScreenShareSurface = "monitor" | "window" | "browser";
 export type ScreenShareOptions = {
     readonly surface?: ScreenShareSurface;
@@ -54,8 +57,9 @@ export type MediaPlaneResult = {
 };
 export type ClientMediaPlane = {
     readonly setLocalPublicationTarget: (target: MediaPlaneTarget) => Promise<MediaPlaneResult>;
-    readonly setLocalSourceIntent?: (source: MediaSource, enabled: boolean) => void;
-    readonly closeForcedLocalPublication?: (source: MediaSource) => Promise<void>;
+    readonly pauseLocalCapture?: (source: "microphone" | "camera") => Promise<void>;
+    readonly setLocalSourceIntent?: (source: MediaSource, enabled: boolean, cause?: LocalPublicationRetirementCause) => void;
+    readonly closeForcedLocalPublication?: (source: MediaSource, cause?: LocalPublicationRetirementCause) => Promise<void>;
     readonly observeLocalPublications: (listener: (publications: readonly MediaPublication[]) => void) => () => void;
     readonly observeRemotePublications: (listener: (publications: readonly MediaPublication[]) => void) => () => void;
     readonly remotePublicationsChanged?: () => void;

package/dist/media/types.d.ts

@@ -1,5 +1,5 @@
 import type { ConnectionReportTransportEvent } from "../transport-diagnostics";
-import type { MediaPublication, MediaPublicationSource } from "./plane";
+import type { MediaConnectionReplacementCause, MediaPublication, MediaPublicationSource } from "./plane";
 export type CloudflareSFUBootstrap = {
     readonly connectionId: string;
     readonly stunServer: string;
@@ -52,6 +52,7 @@ export type CloudflareSFUSignalingTransport = {
         readonly sessionDescription?: CloudflareSFUSessionDescription;
         readonly tracks: readonly CloudflareSFUTrackRequest[];
         readonly allowPartialRemoteTracks?: boolean;
+        readonly replacementCause?: MediaConnectionReplacementCause;
     }) => Promise<CloudflareSFUTracksResponse>;
     readonly closeTracks: (input: {
         readonly connectionId: string;

package/dist/public-invites/index.js

@@ -2,12 +2,12 @@ import {
   createChalkPublicClient,
   createChalkPublicInviteClient,
   parseInviteCode
-} from "../chunk-LKNT6XFD.js";
+} from "../chunk-WFRTUBN6.js";
 import {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError
-} from "../chunk-UMAE5GCV.js";
+} from "../chunk-CJVLTSIO.js";
 export {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,

package/dist/space-client/promise-facade.d.ts

@@ -1,11 +1,11 @@
 import { Effect } from "effect";
-type ControllerCommand = (...args: any[]) => unknown;
-type PromiseRuntime = {
-    readonly runPromise: (effect: Effect.Effect<any, any, any>) => Promise<any>;
+type ControllerCommand = (...args: never[]) => unknown;
+type PromiseRuntime<Services> = {
+    readonly runPromise: (effect: Effect.Effect<unknown, unknown, Services>) => Promise<unknown>;
 };
-export type PromiseCommand<Command> = Command extends (...args: infer Arguments) => infer Result ? (Result extends Effect.Effect<infer Success, any, any> ? (...args: Arguments) => Promise<Success> : (...args: Arguments) => Result) : never;
+export type PromiseCommand<Command> = Command extends (...args: infer Arguments) => infer Result ? (Result extends Effect.Effect<infer Success, unknown, unknown> ? (...args: Arguments) => Promise<Success> : (...args: Arguments) => Result) : never;
 export type PromiseController<Controller extends Record<string, ControllerCommand>> = {
     readonly [Key in keyof Controller]: PromiseCommand<Controller[Key]>;
 };
-export declare function toPromiseController<Controller extends Record<string, ControllerCommand>>(runtime: PromiseRuntime, controller: Controller): PromiseController<Omit<Controller, "configure" | "dispose">>;
+export declare function toPromiseController<Services, Controller extends Record<string, ControllerCommand>>(runtime: PromiseRuntime<Services>, controller: Controller): PromiseController<Omit<Controller, "configure" | "dispose">>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q9labsai/chalk-client",
-  "version": "5.2.5",
+  "version": "5.2.6",
   "license": "MIT",
   "repository": {
     "type": "git",