@q9labsai/chalk-client 5.2.5 → 5.3.0

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

@@ -84,6 +84,7 @@ var AccessGrantSchema = Schema.Struct({
 });
 var AdmitEpisodeParticipantRequestSchema = Schema.Struct({
   admission: Schema.optional(Schema.Literals(["policy", "direct"])),
+  identity_external_id: Schema.optional(Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(256))),
   identity_id: Schema.optional(UUIDSchema),
   metadata: Schema.optional(Schema.Unknown),
   name: Schema.String.check(Schema.isMinLength(1)),
@@ -1109,7 +1110,26 @@ 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",
+      "receive_stalled"
+    ])
+  )
 });
 var AddCloudflareSFUTracksRequestBodySchema = CloudflareSFUTracksRequestSchema;
 var AddCloudflareSFUTracksResponseSchema = CloudflareSFUTracksAPIResponseSchema;

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

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

package/dist/{chunk-5YPQNMJE.js → chunk-XSB2GDRW.js}

@@ -861,7 +861,8 @@ function strictEvent(value) {
 }
 function strictProjectionItem(value, stream) {
   if (stream === "media") return exactObject(value, ["participant_id", "source", "enabled", "publication_id"]);
-  if (stream === "presence") return exactObject(value, ["participant_id", "state", "speaking", "active_speaker"]);
+  if (stream === "presence")
+    return isObject(value) && exactObject(value, [...["participant_id", "state", "speaking", "active_speaker"], ...Object.hasOwn(value, "identity_id") ? ["identity_id"] : [], ...Object.hasOwn(value, "device_type") ? ["device_type"] : [], ...Object.hasOwn(value, "admission_revision") ? ["admission_revision"] : []]);
   return false;
 }
 function strictProjection(value) {
@@ -873,7 +874,13 @@ function strictWelcome(value) {
   const extension = Array.isArray(value.extensions) && value.extensions.length === 1 ? value.extensions[0] : void 0;
   const extensionValid = isObject(extension) && ["collaboration_v1", "collaboration_v2"].includes(String(extension.name)) && exactObject(extension, ["name", "capabilities", "participant_capabilities", "chat_head_sequence", "retained_floor_sequence", "read_receipts"]) && Array.isArray(extension.read_receipts);
   if (Object.hasOwn(value, "entry_confirmation") && value.entry_confirmation !== true) return false;
-  const fields = [...base, ...extensionValid ? ["extensions"] : [], ...Object.hasOwn(value, "entry_confirmation") ? ["entry_confirmation"] : [], ...Object.hasOwn(value, "entry_generation") ? ["entry_generation"] : []];
+  const fields = [
+    ...base,
+    ...extensionValid ? ["extensions"] : [],
+    ...Object.hasOwn(value, "entry_confirmation") ? ["entry_confirmation"] : [],
+    ...Object.hasOwn(value, "entry_generation") ? ["entry_generation"] : [],
+    ...Object.hasOwn(value, "participant_identity_id") ? ["participant_identity_id"] : []
+  ];
   if (!strictCursor(value.head)) return false;
   if (value.mode === "snapshot") return exactObjectWithCorrelation(value, [...fields, "snapshot"]) && strictSnapshot(value.snapshot);
   if (value.mode === "terminal") return exactObjectWithCorrelation(value, [...fields, "reason"]);
@@ -1479,6 +1486,7 @@ var WelcomeBase = {
   protocol: Schema.Literal(1),
   participant_id: UuidSchema,
   participant_generation: PositiveIntegerSchema,
+  participant_identity_id: Schema.optionalKey(UuidSchema),
   recovery_id: UuidSchema,
   head: ControlCursorSchema,
   entry_confirmation: Schema.optionalKey(Schema.Literal(true)),
@@ -1527,9 +1535,15 @@ var CommandIdConflictAckFrameSchema = Schema.Struct({ type: Schema.Literal("ack"
 var MediaProjectionItemSchema = Schema.Struct({ participant_id: UuidSchema, source: Schema.Union([Schema.Literal("microphone"), Schema.Literal("camera"), Schema.Literal("screen")]), enabled: Schema.Boolean, publication_id: Schema.NullOr(boundedUtf8String(256, 1)) }).check(
   Schema.makeFilter((item) => !item.enabled || item.publication_id !== null ? void 0 : { path: [], issue: "enabled requires a publication_id" })
 );
-var PresenceProjectionItemSchema = Schema.Struct({ participant_id: UuidSchema, state: Schema.Union([Schema.Literal("connected"), Schema.Literal("disconnected")]), speaking: Schema.Boolean, active_speaker: Schema.Boolean }).check(
-  Schema.makeFilter((item) => item.state !== "disconnected" || !item.speaking && !item.active_speaker ? void 0 : { path: [], issue: "disconnected presence cannot be speaking or active speaker" })
-);
+var PresenceProjectionItemSchema = Schema.Struct({
+  participant_id: UuidSchema,
+  state: Schema.Union([Schema.Literal("connected"), Schema.Literal("disconnected")]),
+  speaking: Schema.Boolean,
+  active_speaker: Schema.Boolean,
+  identity_id: Schema.optional(UuidSchema),
+  device_type: Schema.optional(Schema.Literals(["phone", "tablet", "computer"])),
+  admission_revision: Schema.optional(PositiveIntegerSchema)
+}).check(Schema.makeFilter((item) => item.state !== "disconnected" || !item.speaking && !item.active_speaker ? void 0 : { path: [], issue: "disconnected presence cannot be speaking or active speaker" }));
 var MediaProjectionSnapshotFrameSchema = Schema.Struct({
   type: Schema.Literal("projection_snapshot"),
   stream: Schema.Literal("media"),
@@ -3016,6 +3030,7 @@ var V1SyncClient = class {
   #presence = null;
   #participantId = null;
   #participantGeneration = null;
+  #participantIdentityId;
   #entryGeneration = null;
   #recovery = null;
   #snapshotRecoveryRequested = false;
@@ -3136,6 +3151,7 @@ var V1SyncClient = class {
     this.#socket?.close(1e3, "client stopped");
     this.#socket = null;
     this.#phase = { phase: "stopped" };
+    this.#options.mediaPlane?.remotePublicationsChanged?.([], "unavailable");
     this.#rejectEphemeral("client_stopped");
     this.#collaborationState.disconnect("client_stopped");
     this.#localPublications = [];
@@ -3164,6 +3180,7 @@ var V1SyncClient = class {
       },
       participantId: this.#participantId,
       participantGeneration: this.#participantGeneration,
+      participantIdentityId: this.#participantIdentityId,
       control: this.#control,
       optimisticControl,
       media: copyProjection(this.#media),
@@ -3183,6 +3200,7 @@ var V1SyncClient = class {
     return () => this.#mediaPauseListeners.delete(listener);
   }
   #notifyMediaPause(event) {
+    if (event.name === "episode_ended") this.#options.mediaPlane?.remotePublicationsChanged?.([]);
     const source = event.name === "participant_microphone_stopped" ? "microphone" : event.name === "participant_camera_stopped" ? "camera" : event.name === "participant_screen_share_stopped" ? "screen" : null;
     if (source && "participant_id" in event.payload && event.payload.participant_id === this.#participantId) {
       for (const listener of this.#mediaPauseListeners) listener({ source, revision: event.revision });
@@ -3444,6 +3462,7 @@ var V1SyncClient = class {
           const control = this.#requireControl();
           this.#send({ type: "delivery_ack", stream: "control", revision: control.revision, state_digest: control.stateDigest });
         }
+        if (this.#control?.status === "ended" || frame.name === "participant_left" && frame.payload.participant_id === this.#participantId) this.#participantIdentityId = void 0;
         if (frame.name === "participant_left" && frame.payload.participant_id === this.#participantId) {
           this.#phase = { phase: "terminal", terminalReason: frame.payload.reason === "removed" ? "participant_removed" : "participant_inactive" };
           this.#socket?.close(1e3, "participant inactive");
@@ -3534,6 +3553,7 @@ var V1SyncClient = class {
     this.#entryGeneration = frame.entry_generation ?? this.#entryGeneration;
     this.#participantId = frame.participant_id;
     this.#participantGeneration = frame.participant_generation;
+    this.#participantIdentityId = frame.mode === "terminal" ? void 0 : frame.participant_identity_id;
     this.#updateLocalMediaStates();
     if (frame.mode === "terminal") {
       await this.#commandScheduler.settleTerminalRecovery(frame);
@@ -3547,6 +3567,7 @@ var V1SyncClient = class {
       const control = await restoreV1Snapshot(frame.snapshot);
       if (!sameHead(control, frame.head)) throw new V1ReplicaError("snapshot head mismatch");
       this.#control = control;
+      if (control.status === "ended") this.#options.mediaPlane?.remotePublicationsChanged?.([]);
       this.#snapshotRevision = control.revision;
       this.#snapshotRecoveryRequested = false;
       this.#controlHeads.clear();
@@ -3592,7 +3613,7 @@ var V1SyncClient = class {
           previous.find((candidate) => mediaKey(candidate) === mediaKey(item)),
           item
         );
-      if (!this.#mediaEnded()) this.#options.mediaPlane?.remotePublicationsChanged?.();
+      if (!this.#mediaEnded()) this.#options.mediaPlane?.remotePublicationsChanged?.(this.#media?.items ?? []);
     } else {
       this.#presence = { projectionId: frame.projection_id, sequence: 0, items: frame.items.map(presenceItem) };
       this.#presenceEventEvidence.clear();
@@ -3611,7 +3632,7 @@ var V1SyncClient = class {
       rememberBoundedEvidence(this.#mediaEventEvidence, frame.sequence, frameSignature(frame), MAX_PROJECTION_EVENT_EVIDENCE);
       this.#notifyRemotePublicationResumed(previous, item);
       if (!this.#mediaEnded() && item.participantId !== this.#participantId && (previous?.enabled !== item.enabled || previous?.publicationId !== item.publicationId)) {
-        this.#options.mediaPlane?.remotePublicationsChanged?.();
+        this.#options.mediaPlane?.remotePublicationsChanged?.(this.#media?.items ?? []);
       }
     } else {
       if (this.#acceptProjectionDuplicate(this.#presence, this.#presenceEventEvidence, frame)) return;
@@ -3694,6 +3715,7 @@ var V1SyncClient = class {
     this.#commandScheduler.disconnect();
     this.#media = null;
     this.#presence = null;
+    this.#options.mediaPlane?.remotePublicationsChanged?.([], this.#mediaEnded() ? "available" : "unavailable");
     this.#rejectRequests("disconnected_before_delivery");
     this.#collaborationState.disconnect("disconnected_before_delivery");
     if (!this.#started || this.#phase.phase === "terminal") return;
@@ -3900,7 +3922,7 @@ function mediaItem(item) {
   return { participantId: item.participant_id, source: item.source, enabled: item.enabled, publicationId: item.publication_id };
 }
 function presenceItem(item) {
-  return { participantId: item.participant_id, state: item.state, speaking: item.speaking, activeSpeaker: item.active_speaker };
+  return { participantId: item.participant_id, admissionRevision: item.admission_revision, identityId: item.identity_id, deviceType: item.device_type, state: item.state, speaking: item.speaking, activeSpeaker: item.active_speaker };
 }
 function mediaKey(item) {
   return `${item.participantId}:${item.source}`;
@@ -3928,6 +3950,8 @@ function validMediaPublication(publication) {
 }
 function entryUrl(value, generation, confirmation) {
   const url = new URL(value);
+  url.searchParams.set("participant_devices", "1");
+  url.searchParams.set("participant_device_admissions", "2");
   url.searchParams.set("entry_generation", generation === null ? "new" : String(generation));
   if (confirmation) url.searchParams.set("entry_confirmation", "1");
   return url.toString();

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", "receive_stalled"]>>;
         }>>, 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<{
@@ -2477,6 +2478,7 @@ export declare const createChalkEffectClient: (options: ChalkEffectClientOptions
             readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
         }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
             readonly admission: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["policy", "direct"]>>;
+            readonly identity_external_id: import("effect/Schema").optional<import("effect/Schema").String>;
             readonly identity_id: import("effect/Schema").optional<import("effect/Schema").brand<import("effect/Schema").String, "UUID">>;
             readonly metadata: import("effect/Schema").optional<import("effect/Schema").Unknown>;
             readonly name: import("effect/Schema").String;

package/dist/connection/dependencies.d.ts

@@ -68,7 +68,8 @@ export type ConnectionSyncClient = V1CollaborationClient & {
     readonly requestStartCamera: (participantId: string) => Promise<V1DirectedRequestResult>;
 };
 export type ConnectionMediaClient = ClientMediaPlane & {
-    readonly start: (stream: MediaStream) => Promise<void>;
+    /** Starts receiving immediately; resolves the optional initial publication policy before sending. */
+    readonly start: (stream: MediaStream, beforePublish?: () => Promise<MediaStream>) => Promise<void>;
     readonly stop: () => void;
     readonly restart: (input: CloudflareSFUBootstrap | ParticipantMediaAccess) => Promise<void>;
     readonly prepareLocalTrack: (source: "microphone" | "camera" | "screen" | "screen_audio", track: MediaStreamTrack) => void;

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-DHUHTIU7.js";
+import "./chunk-3TGVTP6Z.js";
 import {
   APIKeyListSchema,
   APIKeyWithSecretSchema,
@@ -841,8 +841,8 @@ import {
   WhiteboardStorageUnavailableErrorSchema,
   WhiteboardStorageUnavailableErrorWireSchema,
   createChalkEffectClient
-} from "./chunk-UMAE5GCV.js";
-import "./chunk-5YPQNMJE.js";
+} from "./chunk-GOSWSXTH.js";
+import "./chunk-XSB2GDRW.js";
 
 // src/space-client/effect.ts
 import { Context, Effect, Exit, Layer, Scope } from "effect";

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", "receive_stalled"]>>;
 }>>, 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<{
@@ -2433,6 +2434,7 @@ declare const ChalkApi_base: HttpApi.HttpApi<"ChalkApi", HttpApiGroup.HttpApiGro
     readonly tenant_id: import("effect/Schema").brand<import("effect/Schema").String, "TenantId">;
 }>>, never, import("effect/Schema").toCodecJson<import("effect/Schema").Struct<{
     readonly admission: import("effect/Schema").optional<import("effect/Schema").Literals<readonly ["policy", "direct"]>>;
+    readonly identity_external_id: import("effect/Schema").optional<import("effect/Schema").String>;
     readonly identity_id: import("effect/Schema").optional<import("effect/Schema").brand<import("effect/Schema").String, "UUID">>;
     readonly metadata: import("effect/Schema").optional<import("effect/Schema").Unknown>;
     readonly name: import("effect/Schema").String;

package/dist/generated/schemas.d.ts

@@ -89,6 +89,7 @@ export declare const AccessGrantSchema: Schema.Struct<{
 export type AccessGrant = typeof AccessGrantSchema.Type;
 export declare const AdmitEpisodeParticipantRequestSchema: Schema.Struct<{
     readonly admission: Schema.optional<Schema.Literals<readonly ["policy", "direct"]>>;
+    readonly identity_external_id: Schema.optional<Schema.String>;
     readonly identity_id: Schema.optional<Schema.brand<Schema.String, "UUID">>;
     readonly metadata: Schema.optional<Schema.Unknown>;
     readonly name: Schema.String;
@@ -1358,6 +1359,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", "receive_stalled"]>>;
 }>;
 export type AddCloudflareSFUTracksQueryParams = typeof AddCloudflareSFUTracksQueryParamsSchema.Type;
 export declare const AddCloudflareSFUTracksRequestBodySchema: Schema.Struct<{
@@ -1425,6 +1427,7 @@ export declare const AdmitEpisodeParticipantRequestHeadersSchema: Schema.Struct<
 export type AdmitEpisodeParticipantRequestHeaders = typeof AdmitEpisodeParticipantRequestHeadersSchema.Type;
 export declare const AdmitEpisodeParticipantRequestBodySchema: Schema.Struct<{
     readonly admission: Schema.optional<Schema.Literals<readonly ["policy", "direct"]>>;
+    readonly identity_external_id: Schema.optional<Schema.String>;
     readonly identity_id: Schema.optional<Schema.brand<Schema.String, "UUID">>;
     readonly metadata: Schema.optional<Schema.Unknown>;
     readonly name: Schema.String;

package/dist/generated/sync.d.ts

@@ -1313,6 +1313,7 @@ export declare const WelcomeSnapshotFrameSchema: Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1361,6 +1362,7 @@ export declare const WelcomeReplayFrameSchema: Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1379,6 +1381,7 @@ export declare const WelcomeUpToDateFrameSchema: Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1397,6 +1400,7 @@ export declare const WelcomeTerminalFrameSchema: Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1416,6 +1420,7 @@ export declare const ExtendedWelcomeSnapshotFrameSchema: Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1477,6 +1482,7 @@ export declare const ExtendedWelcomeReplayFrameSchema: Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1508,6 +1514,7 @@ export declare const ExtendedWelcomeUpToDateFrameSchema: Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1539,6 +1546,7 @@ export declare const ExtendedWelcomeTerminalFrameSchema: Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1571,6 +1579,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1631,6 +1640,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1661,6 +1671,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1691,6 +1702,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1722,6 +1734,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1769,6 +1782,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1786,6 +1800,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -1803,6 +1818,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -2176,6 +2192,9 @@ export declare const PresenceProjectionItemSchema: Schema.Struct<{
     readonly state: Schema.Union<readonly [Schema.Literal<"connected">, Schema.Literal<"disconnected">]>;
     readonly speaking: Schema.Boolean;
     readonly active_speaker: Schema.Boolean;
+    readonly identity_id: Schema.optional<Schema.String>;
+    readonly device_type: Schema.optional<Schema.Literals<readonly ["phone", "tablet", "computer"]>>;
+    readonly admission_revision: Schema.optional<Schema.Number>;
 }>;
 export declare const MediaProjectionSnapshotFrameSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
@@ -2205,6 +2224,9 @@ export declare const PresenceProjectionSnapshotFrameSchema: Schema.Struct<{
         readonly state: Schema.Union<readonly [Schema.Literal<"connected">, Schema.Literal<"disconnected">]>;
         readonly speaking: Schema.Boolean;
         readonly active_speaker: Schema.Boolean;
+        readonly identity_id: Schema.optional<Schema.String>;
+        readonly device_type: Schema.optional<Schema.Literals<readonly ["phone", "tablet", "computer"]>>;
+        readonly admission_revision: Schema.optional<Schema.Number>;
     }>>;
 }>;
 export declare const MediaProjectionEventFrameSchema: Schema.Struct<{
@@ -2235,6 +2257,9 @@ export declare const PresenceProjectionEventFrameSchema: Schema.Struct<{
         readonly state: Schema.Union<readonly [Schema.Literal<"connected">, Schema.Literal<"disconnected">]>;
         readonly speaking: Schema.Boolean;
         readonly active_speaker: Schema.Boolean;
+        readonly identity_id: Schema.optional<Schema.String>;
+        readonly device_type: Schema.optional<Schema.Literals<readonly ["phone", "tablet", "computer"]>>;
+        readonly admission_revision: Schema.optional<Schema.Number>;
     }>;
 }>;
 export declare const ProjectionFrameSchema: Schema.Union<readonly [Schema.Struct<{
@@ -2264,6 +2289,9 @@ export declare const ProjectionFrameSchema: Schema.Union<readonly [Schema.Struct
         readonly state: Schema.Union<readonly [Schema.Literal<"connected">, Schema.Literal<"disconnected">]>;
         readonly speaking: Schema.Boolean;
         readonly active_speaker: Schema.Boolean;
+        readonly identity_id: Schema.optional<Schema.String>;
+        readonly device_type: Schema.optional<Schema.Literals<readonly ["phone", "tablet", "computer"]>>;
+        readonly admission_revision: Schema.optional<Schema.Number>;
     }>>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
@@ -2292,6 +2320,9 @@ export declare const ProjectionFrameSchema: Schema.Union<readonly [Schema.Struct
         readonly state: Schema.Union<readonly [Schema.Literal<"connected">, Schema.Literal<"disconnected">]>;
         readonly speaking: Schema.Boolean;
         readonly active_speaker: Schema.Boolean;
+        readonly identity_id: Schema.optional<Schema.String>;
+        readonly device_type: Schema.optional<Schema.Literals<readonly ["phone", "tablet", "computer"]>>;
+        readonly admission_revision: Schema.optional<Schema.Number>;
     }>;
 }>]>;
 export declare const LiveTargetOutcomeSchema: Schema.Union<readonly [Schema.Literal<"confirmed">, Schema.Literal<"satisfied">, Schema.Literal<"retryable_failure">, Schema.Literal<"terminal_failure">, Schema.Literal<"ambiguous">]>;
@@ -2984,6 +3015,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -3044,6 +3076,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -3074,6 +3107,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -3104,6 +3138,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -3135,6 +3170,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -3182,6 +3218,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -3199,6 +3236,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -3216,6 +3254,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly protocol: Schema.Literal<1>;
     readonly participant_id: Schema.String;
     readonly participant_generation: Schema.Number;
+    readonly participant_identity_id: Schema.optionalKey<Schema.String>;
     readonly recovery_id: Schema.String;
     readonly head: Schema.Struct<{
         readonly revision: Schema.Number;
@@ -3882,6 +3921,9 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state: Schema.Union<readonly [Schema.Literal<"connected">, Schema.Literal<"disconnected">]>;
         readonly speaking: Schema.Boolean;
         readonly active_speaker: Schema.Boolean;
+        readonly identity_id: Schema.optional<Schema.String>;
+        readonly device_type: Schema.optional<Schema.Literals<readonly ["phone", "tablet", "computer"]>>;
+        readonly admission_revision: Schema.optional<Schema.Number>;
     }>>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
@@ -3910,6 +3952,9 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state: Schema.Union<readonly [Schema.Literal<"connected">, Schema.Literal<"disconnected">]>;
         readonly speaking: Schema.Boolean;
         readonly active_speaker: Schema.Boolean;
+        readonly identity_id: Schema.optional<Schema.String>;
+        readonly device_type: Schema.optional<Schema.Literals<readonly ["phone", "tablet", "computer"]>>;
+        readonly admission_revision: Schema.optional<Schema.Number>;
     }>;
 }>]>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   createSpaceClient,
   decodeWhiteboardV1ServerFrame,
   encodeWhiteboardV1ClientFrame
-} from "./chunk-BUNSEDXL.js";
+} from "./chunk-DHUHTIU7.js";
 import {
   CloudflareSFUClient,
   CloudflareSFUError,
@@ -28,19 +28,19 @@ import {
   requireSFUDescription,
   validatePublicationSnapshot,
   waitFor
-} from "./chunk-FD25AMLG.js";
+} from "./chunk-3TGVTP6Z.js";
 import {
   createChalkPublicClient,
   createChalkPublicInviteClient,
   parseInviteCode
-} from "./chunk-LKNT6XFD.js";
+} from "./chunk-O26BHHMI.js";
 import {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError,
   parseParsedAccessGrant,
   requireAccessGrant
-} from "./chunk-UMAE5GCV.js";
+} from "./chunk-GOSWSXTH.js";
 import {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,
@@ -69,7 +69,7 @@ import {
   optimisticV1Control,
   reactionFromFrame,
   restoreV1Snapshot
-} from "./chunk-5YPQNMJE.js";
+} from "./chunk-XSB2GDRW.js";
 
 // src/space-client/reload-rejoin.ts
 import { Schema } from "effect";

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;
@@ -7,16 +7,17 @@ export declare class CloudflareSFUClient implements ClientMediaPlane {
     subscribe(listener: () => void): () => void;
     remotePublicationResumed(publicationId: string): void;
     remoteParticipantsChanged(participantIds: readonly string[]): void;
-    remotePublicationsChanged(): void;
+    remotePublicationsChanged(publications?: readonly MediaPublication[], projectionState?: "available" | "unavailable"): void;
     prepareLocalTrack(source: MediaPublicationSource, track: MediaStreamTrack): void;
     clearPreparedLocalTrack(source: MediaPublicationSource, options?: {
         readonly stopTrack?: boolean;
     }): Promise<void>;
-    start(localMedia: MediaStream): Promise<void>;
+    start(localMedia: MediaStream, beforePublish?: () => Promise<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-3TGVTP6Z.js";
 export {
   CloudflareSFUClient,
   CloudflareSFUError,