@q9labsai/chalk-client 5.3.0 → 5.4.0

package/dist/generated/sync.d.ts

@@ -100,11 +100,20 @@ export declare const SyncProtocolMetadata: {
                 readonly pattern: "^[a-z][a-z0-9_*\\-/]{0,255}=[\\x21-\\x2b\\x2d-\\x3c\\x3e-\\x7e]{1,256}(,[a-z][a-z0-9_*\\-/]{0,255}=[\\x21-\\x2b\\x2d-\\x3c\\x3e-\\x7e]{1,256})*$";
             };
         };
+        readonly helloOnlyFields: {
+            readonly baggage: {
+                readonly kind: "string";
+                readonly minBytes: 47;
+                readonly maxBytes: 47;
+                readonly format: "w3c-baggage-session-id";
+                readonly pattern: "^session\\.id=[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$";
+            };
+        };
         readonly acceptedOn: {
             readonly hello: "client-to-server";
             readonly serverFrames: "server-to-client";
         };
-        readonly upgradeHeaders: readonly ["x-chalk-journey-id", "traceparent", "tracestate"];
+        readonly upgradeHeaders: readonly ["x-chalk-journey-id", "traceparent", "tracestate", "baggage"];
         readonly rule: "propagate_from_first_observed_layer_to_every_downstream_frame";
     };
     readonly externalIntents: readonly ["admit_participant", "deny_admission", "admission_request_expired", "mute_participant", "stop_participant_camera", "stop_participant_screen_share", "remove_participant", "start_recording", "stop_recording", "participant_leave", "start_episode", "extend_episode", "end_episode", "tenant_set_deadline", "tenant_end_episode", "maximum_duration_expired"];
@@ -353,6 +362,7 @@ export declare const UuidSchema: Schema.String;
 export declare const JourneyIdSchema: Schema.String;
 export declare const TraceparentSchema: Schema.String;
 export declare const TracestateSchema: Schema.String;
+export declare const BaggageSchema: Schema.String;
 export declare const SyncCorrelationFieldsSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly traceparent: Schema.optional<Schema.String>;
@@ -424,6 +434,7 @@ export declare const HelloFrameSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly traceparent: Schema.optional<Schema.String>;
     readonly tracestate: Schema.optional<Schema.String>;
+    readonly baggage: Schema.optional<Schema.String>;
     readonly type: Schema.Literal<"hello">;
     readonly protocol: Schema.Literal<1>;
     readonly token: Schema.String;
@@ -461,6 +472,7 @@ export declare const ExtendedHelloFrameSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly traceparent: Schema.optional<Schema.String>;
     readonly tracestate: Schema.optional<Schema.String>;
+    readonly baggage: Schema.optional<Schema.String>;
     readonly type: Schema.Literal<"hello">;
     readonly protocol: Schema.Literal<1>;
     readonly token: Schema.String;
@@ -1321,6 +1333,7 @@ export declare const WelcomeSnapshotFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"snapshot">;
     readonly snapshot: Schema.Struct<{
@@ -1370,6 +1383,7 @@ export declare const WelcomeReplayFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"replay">;
 }>;
@@ -1389,6 +1403,7 @@ export declare const WelcomeUpToDateFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"up_to_date">;
 }>;
@@ -1408,6 +1423,7 @@ export declare const WelcomeTerminalFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"terminal">;
     readonly reason: Schema.Union<readonly [Schema.Literal<"episode_ended">, Schema.Literal<"participant_inactive">, Schema.Literal<"stale_participant_generation">]>;
@@ -1428,6 +1444,7 @@ export declare const ExtendedWelcomeSnapshotFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1490,6 +1507,7 @@ export declare const ExtendedWelcomeReplayFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1522,6 +1540,7 @@ export declare const ExtendedWelcomeUpToDateFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1554,6 +1573,7 @@ export declare const ExtendedWelcomeTerminalFrameSchema: Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1587,6 +1607,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1648,6 +1669,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1679,6 +1701,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1710,6 +1733,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -1742,6 +1766,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"snapshot">;
     readonly snapshot: Schema.Struct<{
@@ -1790,6 +1815,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"replay">;
 }>, Schema.Struct<{
@@ -1808,6 +1834,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"up_to_date">;
 }>, Schema.Struct<{
@@ -1826,6 +1853,7 @@ export declare const WelcomeFrameSchema: Schema.Union<readonly [Schema.Struct<{
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"terminal">;
     readonly reason: Schema.Union<readonly [Schema.Literal<"episode_ended">, Schema.Literal<"participant_inactive">, Schema.Literal<"stale_participant_generation">]>;
@@ -2186,6 +2214,8 @@ export declare const MediaProjectionItemSchema: Schema.Struct<{
     readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
     readonly enabled: Schema.Boolean;
     readonly publication_id: Schema.NullOr<Schema.String>;
+    readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+    readonly off_revision: Schema.optional<Schema.Number>;
 }>;
 export declare const PresenceProjectionItemSchema: Schema.Struct<{
     readonly participant_id: Schema.String;
@@ -2209,6 +2239,8 @@ export declare const MediaProjectionSnapshotFrameSchema: Schema.Struct<{
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>>;
 }>;
 export declare const PresenceProjectionSnapshotFrameSchema: Schema.Struct<{
@@ -2242,6 +2274,8 @@ export declare const MediaProjectionEventFrameSchema: Schema.Struct<{
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>;
 }>;
 export declare const PresenceProjectionEventFrameSchema: Schema.Struct<{
@@ -2275,6 +2309,8 @@ export declare const ProjectionFrameSchema: Schema.Union<readonly [Schema.Struct
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
@@ -2306,6 +2342,8 @@ export declare const ProjectionFrameSchema: Schema.Union<readonly [Schema.Struct
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
@@ -2793,6 +2831,7 @@ export declare const SyncV1ClientFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly journey_id: Schema.optional<Schema.String>;
     readonly traceparent: Schema.optional<Schema.String>;
     readonly tracestate: Schema.optional<Schema.String>;
+    readonly baggage: Schema.optional<Schema.String>;
     readonly type: Schema.Literal<"hello">;
     readonly protocol: Schema.Literal<1>;
     readonly token: Schema.String;
@@ -2825,6 +2864,7 @@ export declare const SyncV1ClientFrameSchema: Schema.decodeTo<Schema.Union<reado
     readonly journey_id: Schema.optional<Schema.String>;
     readonly traceparent: Schema.optional<Schema.String>;
     readonly tracestate: Schema.optional<Schema.String>;
+    readonly baggage: Schema.optional<Schema.String>;
     readonly type: Schema.Literal<"hello">;
     readonly protocol: Schema.Literal<1>;
     readonly token: Schema.String;
@@ -3023,6 +3063,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -3084,6 +3125,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -3115,6 +3157,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -3146,6 +3189,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly extensions: Schema.Tuple<readonly [Schema.Struct<{
         readonly name: Schema.Literals<readonly ["collaboration_v1", "collaboration_v2"]>;
@@ -3178,6 +3222,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"snapshot">;
     readonly snapshot: Schema.Struct<{
@@ -3226,6 +3271,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"replay">;
 }>, Schema.Struct<{
@@ -3244,6 +3290,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"up_to_date">;
 }>, Schema.Struct<{
@@ -3262,6 +3309,7 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly state_digest: Schema.String;
     }>;
     readonly entry_confirmation: Schema.optionalKey<Schema.Literal<true>>;
+    readonly media_off_reason: Schema.optionalKey<Schema.Literal<true>>;
     readonly entry_generation: Schema.optionalKey<Schema.Number>;
     readonly mode: Schema.Literal<"terminal">;
     readonly reason: Schema.Union<readonly [Schema.Literal<"episode_ended">, Schema.Literal<"participant_inactive">, Schema.Literal<"stale_participant_generation">]>;
@@ -3907,6 +3955,8 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
@@ -3938,6 +3988,8 @@ export declare const SyncV1ServerFrameSchema: Schema.decodeTo<Schema.Union<reado
         readonly source: Schema.Union<readonly [Schema.Literal<"microphone">, Schema.Literal<"camera">, Schema.Literal<"screen">]>;
         readonly enabled: Schema.Boolean;
         readonly publication_id: Schema.NullOr<Schema.String>;
+        readonly off_reason: Schema.optional<Schema.Literals<readonly ["host", "self", "dead"]>>;
+        readonly off_revision: Schema.optional<Schema.Number>;
     }>;
 }>, Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;

package/dist/index.d.ts

@@ -5,5 +5,6 @@ export * from "./space-client";
 export * from "./sync";
 export * from "./whiteboard";
 export * from "./public-invites";
+export { currentSessionId, newSessionId, requestContextHeaders, SESSION_ID_KEY, sessionBaggage, setSessionSource, withRequestContext, type SessionSource } from "./session";
 export { formatSyncConnectDiagnostic } from "./sync/connect-diagnostics";
 export { getConnectionFailureDetail } from "./space-client/failure-detail";

package/dist/index.js

@@ -15,7 +15,19 @@ import {
   createSpaceClient,
   decodeWhiteboardV1ServerFrame,
   encodeWhiteboardV1ClientFrame
-} from "./chunk-DHUHTIU7.js";
+} from "./chunk-TA2BJXI7.js";
+import {
+  createChalkPublicClient,
+  createChalkPublicInviteClient,
+  parseInviteCode
+} from "./chunk-VAJ6XNAA.js";
+import {
+  ArrivalInvalidHandleError,
+  ArrivalUnavailableError,
+  SpacePublicInviteUnavailableError,
+  parseParsedAccessGrant,
+  requireAccessGrant
+} from "./chunk-MHJ4UPM3.js";
 import {
   CloudflareSFUClient,
   CloudflareSFUError,
@@ -26,21 +38,10 @@ import {
   publicationKey,
   requireDescription,
   requireSFUDescription,
+  setVideoRenderSize,
   validatePublicationSnapshot,
   waitFor
-} from "./chunk-3TGVTP6Z.js";
-import {
-  createChalkPublicClient,
-  createChalkPublicInviteClient,
-  parseInviteCode
-} from "./chunk-O26BHHMI.js";
-import {
-  ArrivalInvalidHandleError,
-  ArrivalUnavailableError,
-  SpacePublicInviteUnavailableError,
-  parseParsedAccessGrant,
-  requireAccessGrant
-} from "./chunk-GOSWSXTH.js";
+} from "./chunk-UVWRTXNO.js";
 import {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,
@@ -69,7 +70,16 @@ import {
   optimisticV1Control,
   reactionFromFrame,
   restoreV1Snapshot
-} from "./chunk-XSB2GDRW.js";
+} from "./chunk-XF567GPH.js";
+import {
+  SESSION_ID_KEY,
+  currentSessionId,
+  newSessionId,
+  requestContextHeaders,
+  sessionBaggage,
+  setSessionSource,
+  withRequestContext
+} from "./chunk-N4IPKRS6.js";
 
 // src/space-client/reload-rejoin.ts
 import { Schema } from "effect";
@@ -149,6 +159,7 @@ export {
   InMemoryChalkWhiteboardV1PendingOperationStore,
   InMemoryV1PendingTargetStore,
   IndexedDbV1PendingTargetStore,
+  SESSION_ID_KEY,
   SpaceClientError,
   SpacePublicInviteUnavailableError,
   SyncBrowserCapabilityError,
@@ -176,6 +187,7 @@ export {
   createReactNativeWebSocketFactory,
   createSpaceClient,
   createV1SyncClient,
+  currentSessionId,
   decodeV1ClientFrame,
   decodeV1ServerFrame,
   decodeWhiteboardV1ServerFrame,
@@ -184,6 +196,7 @@ export {
   encodeWhiteboardV1ClientFrame,
   formatSyncConnectDiagnostic,
   getConnectionFailureDetail,
+  newSessionId,
   optimisticV1Control,
   parseCloudflareSFUPublicationID,
   parseInviteCode,
@@ -192,11 +205,16 @@ export {
   readReloadRejoin,
   reloadRejoinAccess,
   reloadRejoinStorageKey,
+  requestContextHeaders,
   requireDescription,
   requireSFUDescription,
   restoreV1Snapshot,
   resumeReloadRejoin,
+  sessionBaggage,
+  setSessionSource,
+  setVideoRenderSize,
   validatePublicationSnapshot,
   waitFor,
+  withRequestContext,
   writeReloadRejoin
 };

package/dist/media/call-stats.d.ts

@@ -0,0 +1,27 @@
+import type { components } from "../generated/openapi-types";
+export type CallStatsRequest = components["schemas"]["CallStatsRequest"];
+export type CallStatsSample = CallStatsRequest["samples"][number];
+/** One summary covers this long, so a call makes about six per minute. */
+export declare const CALL_STATS_WINDOW_MS = 10000;
+/** A batch uploads once it holds this many samples (about a minute of call). */
+export declare const CALL_STATS_UPLOAD_SAMPLES = 6;
+/** The API rejects larger batches. */
+export declare const CALL_STATS_MAX_BATCH = 30;
+/** The API rejects a window longer than this and drops the whole batch, so a longer gap (a stalled tab, a sleeping device) is skipped. */
+export declare const CALL_STATS_MAX_WINDOW_MS = 60000;
+/** Per-call cap: about an hour of samples. Later windows are dropped. */
+export declare const CALL_STATS_CALL_CAP = 360;
+export type CallStatsCollector = {
+    /** Feed one `getStats()` report. Cheap; summarises once a window has elapsed. */
+    readonly observe: (report: RTCStatsReport) => void;
+    /** Close the open window (if long enough) and upload what is buffered with `upload`, once any upload in flight ends. */
+    readonly flush: (upload: Upload) => Promise<void>;
+    /** A new peer connection starts new counters: drop the open window and its baseline, keep what is already buffered. */
+    readonly reset: () => void;
+};
+type Upload = (request: CallStatsRequest) => Promise<void>;
+export declare function createCallStatsCollector(options: {
+    readonly upload: Upload;
+    readonly now?: () => number;
+}): CallStatsCollector;
+export {};

package/dist/media/client.d.ts

@@ -6,6 +6,7 @@ export declare class CloudflareSFUClient implements ClientMediaPlane {
     getSnapshot(): CloudflareSFUSnapshot;
     subscribe(listener: () => void): () => void;
     remotePublicationResumed(publicationId: string): void;
+    localPublicationWithdrawn(publicationId: string): void;
     remoteParticipantsChanged(participantIds: readonly string[]): void;
     remotePublicationsChanged(publications?: readonly MediaPublication[], projectionState?: "available" | "unavailable"): void;
     prepareLocalTrack(source: MediaPublicationSource, track: MediaStreamTrack): void;

package/dist/media/ice-servers.d.ts

@@ -0,0 +1,3 @@
+import type { CloudflareSFUBootstrap } from "./types";
+/** The server sends TURN with its STUN entry; an older server sends only `stunServer`. */
+export declare function iceServersFor(bootstrap: CloudflareSFUBootstrap): RTCIceServer[];

package/dist/media/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./cloudflare-sfu";
 export type { ClientMediaPlane, ConnectionMediaLocalTrack, ConnectionMediaPhase, ConnectionMediaRemoteTrack, ConnectionMediaSnapshot, MediaPlaneOutcome, MediaPlaneResult, MediaPlaneTarget, MediaPublication, MediaPublicationSource, MediaSource } from "./plane";
 export { describeMediaCaptureError } from "./capture-error";
+export { setVideoRenderSize } from "./video-render-size";
+export type { VideoRenderSize } from "./video-render-size";

package/dist/media/index.js

@@ -8,9 +8,11 @@ import {
   publicationKey,
   requireDescription,
   requireSFUDescription,
+  setVideoRenderSize,
   validatePublicationSnapshot,
   waitFor
-} from "../chunk-3TGVTP6Z.js";
+} from "../chunk-UVWRTXNO.js";
+import "../chunk-N4IPKRS6.js";
 export {
   CloudflareSFUClient,
   CloudflareSFUError,
@@ -21,6 +23,7 @@ export {
   publicationKey,
   requireDescription,
   requireSFUDescription,
+  setVideoRenderSize,
   validatePublicationSnapshot,
   waitFor
 };

package/dist/media/plane.d.ts

@@ -67,4 +67,5 @@ export type ClientMediaPlane = {
     readonly remotePublicationsChanged?: (publications?: readonly MediaPublication[], projectionState?: "available" | "unavailable") => void;
     readonly remoteParticipantsChanged?: (participantIds: readonly string[]) => void;
     readonly remotePublicationResumed?: (publicationId: string) => void;
+    readonly localPublicationWithdrawn?: (publicationId: string) => void;
 };

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

@@ -25,15 +25,24 @@ export type ReceiveStallObservation = {
     readonly expectedTracks: number;
     readonly stalledTracks: number;
 };
-/** Owns eligibility, pending stalls and the budget across replacement peers. */
+/**
+ * Owns eligibility, pending stalls and the budget across replacement peers.
+ * Rebuild budgets belong to a remote participant's source, not to one publication id:
+ * a rebuild republishes every local track, and the peers' replacement publications must not renew them.
+ */
 export declare class ReceiveStallRecovery {
     #private;
     get observations(): readonly ReceiveStallObservation[];
     expect(publications: readonly MediaPublication[], participantId: string): void;
     suspend(): void;
     isStalled(publicationId: string): boolean;
-    canRebuild(): boolean;
+    canRepull(id: string): boolean;
+    reserveRepull(id: string): boolean;
+    restarted(id: string): void;
+    canRebuild(id?: string): boolean;
     reserveRebuild(): boolean;
+    /** The media connection was replaced: its receivers are gone, so nothing is awaiting a restore. */
+    replaced(): void;
     clear(): void;
     sample(now: number, connection: RTCPeerConnection, report: RTCStatsReport, tracks: Iterable<CloudflareSFURemoteTrack>): {
         readonly stalled: readonly string[];

package/dist/media/types.d.ts

@@ -1,8 +1,15 @@
 import type { ConnectionReportTransportEvent } from "../transport-diagnostics";
 import type { MediaConnectionReplacementCause, MediaPublication, MediaPublicationSource } from "./plane";
+export type CloudflareSFUIceServer = {
+    readonly urls: readonly string[];
+    readonly username?: string;
+    readonly credential?: string;
+};
 export type CloudflareSFUBootstrap = {
     readonly connectionId: string;
     readonly stunServer: string;
+    /** STUN and TURN servers from the API. Absent on older servers, which means STUN only. */
+    readonly iceServers?: readonly CloudflareSFUIceServer[];
 };
 export type CloudflareSFUSessionDescription = {
     readonly type: "offer" | "answer";
@@ -59,12 +66,24 @@ export type CloudflareSFUSignalingTransport = {
         readonly sessionDescription?: CloudflareSFUSessionDescription;
         readonly tracks: readonly CloudflareSFUCloseTrackRequest[];
         readonly force: boolean;
+        readonly receiveOnly?: boolean;
+    }) => Promise<CloudflareSFUTracksResponse>;
+    /** Changes the simulcast layer of tracks already pulled, without renegotiating. Transports without it keep the layer chosen at pull time. */
+    readonly updateTracks?: (input: {
+        readonly connectionId: string;
+        readonly tracks: readonly CloudflareSFUTrackRequest[];
     }) => Promise<CloudflareSFUTracksResponse>;
     readonly renegotiate: (input: {
         readonly connectionId: string;
         readonly sessionDescription: CloudflareSFUSessionDescription;
     }) => Promise<void>;
     readonly listPublications: () => Promise<CloudflareSFUPublicationSnapshot>;
+    /**
+     * Best-effort per-call stats upload; transports without it simply report nothing. The `closing`
+     * batch reuses the last token and never asks the credential provider, which could refresh access
+     * for a participant who just left or was evicted.
+     */
+    readonly uploadCallStats?: (stats: import("./call-stats").CallStatsRequest, closing: boolean) => Promise<void>;
 };
 export type CloudflareSFURemoteTrack = CloudflareSFUPublication & {
     readonly track: MediaStreamTrack;

package/dist/media/video-render-size.d.ts

@@ -0,0 +1,7 @@
+export type VideoRenderSize = {
+    readonly width: number;
+    readonly height: number;
+};
+/** Tells the media client how large the UI draws a remote video, in device pixels. Pass null when the track leaves the screen. */
+export declare function setVideoRenderSize(track: MediaStreamTrack, size: VideoRenderSize | null): void;
+export declare function videoRenderSize(track: MediaStreamTrack): VideoRenderSize | undefined;

package/dist/media/viewer-layer.d.ts

@@ -0,0 +1,48 @@
+export type ViewerLayer = "h" | "l";
+export type ViewerLayerSample = {
+    /** Fraction of packets lost since the last sample; undefined when no packet arrived or was lost. */
+    readonly lossFraction: number | undefined;
+    readonly framesPerSecond: number | undefined;
+    readonly newFreezes: number;
+    readonly freezeSeconds: number;
+    /** Rendered tile height in device pixels, when the UI reports it. */
+    readonly tileHeight: number | undefined;
+};
+export declare class ViewerLayerPolicy {
+    #private;
+    get layer(): ViewerLayer;
+    /** Drops fast, rises slowly: a failed attempt at h doubles the wait before the next one. */
+    sample(sample: ViewerLayerSample): ViewerLayer;
+}
+type ViewerStatsRow = {
+    readonly type?: string;
+    readonly kind?: string;
+    readonly trackIdentifier?: string;
+    readonly timestamp?: number;
+    readonly packetsReceived?: number;
+    readonly packetsLost?: number;
+    readonly framesDecoded?: number;
+    readonly freezeCount?: number;
+    readonly totalFreezesDuration?: number;
+};
+/** Turns cumulative inbound-rtp counters into per-interval rates for one video track. */
+export declare class ViewerStatsReader {
+    #private;
+    read(stats: Iterable<ViewerStatsRow>, trackId: string): Pick<ViewerLayerSample, "lossFraction" | "framesPerSecond" | "newFreezes" | "freezeSeconds"> | undefined;
+    forget(trackId: string): void;
+}
+export type ViewerLayerCamera = {
+    readonly publicationId: string;
+    readonly track: MediaStreamTrack;
+};
+export type ViewerLayerChange = ViewerLayerCamera & {
+    readonly layer: ViewerLayer;
+};
+/** One per peer connection: owns a policy for each remote camera and reports the switches still to apply. */
+export declare class ViewerLayerSelector {
+    #private;
+    sample(now: number, report: RTCStatsReport, cameras: readonly ViewerLayerCamera[]): readonly ViewerLayerChange[];
+    applied({ publicationId, track, layer }: ViewerLayerChange): void;
+    failed({ publicationId, track }: ViewerLayerChange, now: number): void;
+}
+export {};

package/dist/public-invites/index.js

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