@q9labsai/chalk-client 5.2.6 → 5.3.0

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-I7Y4HR2P.js";
+} from "./chunk-DHUHTIU7.js";
 import {
   CloudflareSFUClient,
   CloudflareSFUError,
@@ -28,19 +28,19 @@ import {
   requireSFUDescription,
   validatePublicationSnapshot,
   waitFor
-} from "./chunk-YIDKETOX.js";
+} from "./chunk-3TGVTP6Z.js";
 import {
   createChalkPublicClient,
   createChalkPublicInviteClient,
   parseInviteCode
-} from "./chunk-WFRTUBN6.js";
+} from "./chunk-O26BHHMI.js";
 import {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError,
   parseParsedAccessGrant,
   requireAccessGrant
-} from "./chunk-CJVLTSIO.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

@@ -7,12 +7,12 @@ 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>;
     pauseLocalCapture(source: "microphone" | "camera"): Promise<void>;

package/dist/media/index.js

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

package/dist/media/plane.d.ts

@@ -1,6 +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 LocalPublicationRetirementCause = Exclude<MediaConnectionReplacementCause, "local_signaling_failure" | "remote_signaling_failure" | "dormant_connection" | "access_refresh" | "receive_stalled">;
 export type ScreenShareSurface = "monitor" | "window" | "browser";
 export type ScreenShareOptions = {
     readonly surface?: ScreenShareSurface;
@@ -27,6 +27,7 @@ export type ConnectionMediaRemoteTrack = Pick<MediaPublication, "participantId"
     readonly track: MediaStreamTrack;
 };
 export type ConnectionMediaSnapshot = {
+    readonly receiveStalls?: readonly import("./receive-stall").ReceiveStallObservation[];
     readonly connection: {
         readonly phase: ConnectionMediaPhase;
         readonly peerConnectionState: RTCPeerConnectionState | null;
@@ -62,7 +63,8 @@ export type ClientMediaPlane = {
     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;
+    /** Unavailable suspends receive eligibility without withdrawing publication identities. */
+    readonly remotePublicationsChanged?: (publications?: readonly MediaPublication[], projectionState?: "available" | "unavailable") => void;
     readonly remoteParticipantsChanged?: (participantIds: readonly string[]) => void;
     readonly remotePublicationResumed?: (publicationId: string) => void;
 };

package/dist/media/receive-stall.d.ts

@@ -0,0 +1,43 @@
+import type { MediaPublication } from "./plane";
+import type { CloudflareSFURemoteTrack } from "./types";
+export declare const RECEIVE_STALL_WINDOW_MS = 7000;
+export declare const RECEIVE_STARTUP_GRACE_MS = 20000;
+export type ReceivePacketSample = {
+    readonly publicationId: string;
+    readonly trackId: string;
+    readonly packets: number;
+};
+/** Only consecutive, timely observations of expected media establish a stall. */
+export declare class ReceiveStallDetector {
+    #private;
+    forget(publicationId: string): void;
+    clear(): void;
+    sample(now: number, tracks: readonly ReceivePacketSample[]): {
+        readonly stalled: readonly string[];
+        readonly advanced: readonly string[];
+        readonly resumed: readonly string[];
+    };
+}
+export type ReceiveStallObservation = {
+    readonly event: "receive_stalled";
+    readonly scope: "partial" | "all";
+    readonly observedAtMs: number;
+    readonly expectedTracks: number;
+    readonly stalledTracks: number;
+};
+/** Owns eligibility, pending stalls and the budget across replacement peers. */
+export declare class ReceiveStallRecovery {
+    #private;
+    get observations(): readonly ReceiveStallObservation[];
+    expect(publications: readonly MediaPublication[], participantId: string): void;
+    suspend(): void;
+    isStalled(publicationId: string): boolean;
+    canRebuild(): boolean;
+    reserveRebuild(): boolean;
+    clear(): void;
+    sample(now: number, connection: RTCPeerConnection, report: RTCStatsReport, tracks: Iterable<CloudflareSFURemoteTrack>): {
+        readonly stalled: readonly string[];
+        readonly advanced: readonly string[];
+        readonly newlyStalled: readonly string[];
+    };
+}

package/dist/media/types.d.ts

@@ -77,6 +77,8 @@ export type CloudflareSFUFailureCode = CloudflareSFUErrorCode;
 export type CloudflareSFUConnectionPhase = "idle" | "connecting" | "live" | "recovering" | "failed" | "stopped";
 export type CloudflareSFUPhase = CloudflareSFUConnectionPhase;
 export type CloudflareSFUSnapshot = {
+    /** Omitted by media adapters without receive diagnostics; treat as empty. */
+    readonly receiveStalls?: readonly import("./receive-stall").ReceiveStallObservation[];
     readonly connection: {
         readonly phase: CloudflareSFUConnectionPhase;
         readonly peerConnectionState: RTCPeerConnectionState | null;

package/dist/public-invites/index.js

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

package/dist/server/index.cjs

@@ -602,6 +602,7 @@ function participantAdmissionRequest(input) {
     name: input.name,
     role: input.role,
     ...input.identityId === void 0 ? {} : { identity_id: input.identityId },
+    ...input.identityExternalId === void 0 ? {} : { identity_external_id: input.identityExternalId },
     ...input.metadata === void 0 ? {} : { metadata: input.metadata },
     ...input.participantId === void 0 ? {} : { participant_id: input.participantId }
   };

package/dist/server/index.js

@@ -504,6 +504,7 @@ function participantAdmissionRequest(input) {
     name: input.name,
     role: input.role,
     ...input.identityId === void 0 ? {} : { identity_id: input.identityId },
+    ...input.identityExternalId === void 0 ? {} : { identity_external_id: input.identityExternalId },
     ...input.metadata === void 0 ? {} : { metadata: input.metadata },
     ...input.participantId === void 0 ? {} : { participant_id: input.participantId }
   };

package/dist/server/types.d.cts

@@ -104,6 +104,8 @@ export type EpisodeEnd = {
     readonly status: string;
 };
 export type AdmitParticipantInput = {
+    /** Stable person key scoped to this tenant. Mutually exclusive with identityId. */
+    readonly identityExternalId?: string;
     readonly identityId?: string;
     readonly metadata?: unknown;
     readonly name: string;

package/dist/server/types.d.ts

@@ -104,6 +104,8 @@ export type EpisodeEnd = {
     readonly status: string;
 };
 export type AdmitParticipantInput = {
+    /** Stable person key scoped to this tenant. Mutually exclusive with identityId. */
+    readonly identityExternalId?: string;
     readonly identityId?: string;
     readonly metadata?: unknown;
     readonly name: string;

package/dist/space-client/same-identity.d.ts

@@ -0,0 +1,6 @@
+import type { Participant } from "./types";
+import type { V1EpisodeSnapshot } from "../sync/v1-types";
+type PersonSeat = Pick<Participant, "participantId" | "identityId">;
+export declare function otherDevices<Seat extends PersonSeat>(participants: readonly Seat[], participantId: string | null, ownIdentityId?: string): readonly Seat[];
+export declare function otherDeviceHasMicrophone(snapshot: V1EpisodeSnapshot, participants: readonly PersonSeat[]): boolean;
+export {};

package/dist/space-client/types.d.ts

@@ -77,6 +77,8 @@ export type ConnectionSlice = {
 };
 export type SelfSlice = {
     readonly participantId: string | null;
+    /** Verified person association, including before this seat confirms entry. */
+    readonly identityId?: string;
     readonly displayName: string | null;
     readonly role: string | null;
     readonly capabilities: readonly Capability[];
@@ -89,6 +91,9 @@ export type ParticipantPresence = {
     readonly activeSpeaker: boolean;
 };
 export type Participant = {
+    /** Stable person identity, independent of the per-device participant ID. */
+    readonly identityId?: string;
+    readonly deviceType?: "phone" | "tablet" | "computer";
     readonly participantId: string;
     readonly displayName: string;
     readonly role: string;
@@ -128,6 +133,7 @@ export type RemoteMedia = {
 export type IncomingMediaRequest = ChalkIncomingMediaRequest;
 export type { ScreenShareSurface, ScreenShareOptions, ScreenShareCapture } from "../media/plane";
 export type MediaSlice = {
+    readonly microphoneMutedByOtherDevice?: boolean;
     readonly devices: {
         readonly microphones: readonly MediaDevice[];
         readonly cameras: readonly MediaDevice[];

package/dist/sync/index.js

@@ -22,7 +22,7 @@ import {
   encodeV1ClientFrame,
   optimisticV1Control,
   restoreV1Snapshot
-} from "../chunk-5YPQNMJE.js";
+} from "../chunk-XSB2GDRW.js";
 export {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,

package/dist/sync/v1-types.d.ts

@@ -52,6 +52,10 @@ export type V1ControlState = {
 };
 export type V1MediaPublication = MediaPublication;
 export type V1Presence = {
+    readonly admissionRevision?: number;
+    /** Stable person identity, independent of the per-device participant ID. */
+    readonly identityId?: string;
+    readonly deviceType?: "phone" | "tablet" | "computer";
     readonly participantId: string;
     readonly state: "connected" | "disconnected";
     readonly speaking: boolean;
@@ -86,6 +90,8 @@ export type V1EpisodeSnapshot = {
     };
     readonly participantId: string | null;
     readonly participantGeneration: number | null;
+    /** Verified own-seat identity, available before admission confirmation on negotiated servers. */
+    readonly participantIdentityId?: string;
     readonly control: V1ControlState | null;
     readonly optimisticControl: V1ControlState | null;
     readonly media: V1Projection<V1MediaPublication> | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q9labsai/chalk-client",
-  "version": "5.2.6",
+  "version": "5.3.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -221,6 +221,7 @@
     "test": "node ../../../scripts/test/run.mjs pnpm exec vitest run",
     "test:webhooks-package": "pnpm run build && node ./scripts/check-webhook-package.mjs",
     "test:server-package": "pnpm run build && node ./scripts/check-server-package.mjs",
+    "test:receive-stall-sfu": "node ./scripts/real-sfu-receive-stall.mjs",
     "test:sync-browser": "pnpm run build && node ./scripts/real-browser-sync.mjs",
     "test:sync-node-restart": "pnpm run build && node ./scripts/real-node-restart-sync.mjs",
     "check-types": "tsc-rs --project tsconfig.check-types.json --noEmit",