@q9labsai/chalk-client 5.0.1 → 5.2.0

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

@@ -1,6 +1,6 @@
 import type { MediaSource, ScreenShareCapture } from "../media/plane";
 import type { ChalkChatAttachment, ChalkChatMessage, ChalkChatReadReceipt, ChalkIncomingMediaRequest, ChalkParticipantMediaState, ChalkReaction, ChalkReactionEvent } from "../collaboration/types";
-import type { ChalkWhiteboardV1Failure } from "../whiteboard/types";
+import type { ChalkWhiteboardDrawPermission, ChalkWhiteboardDrawPolicy, ChalkWhiteboardV1Failure } from "../whiteboard/types";
 import type { AccessGrant } from "../access/grant";
 import type { V1Capability } from "../sync/v1-types";
 import type { ChatControllerEffects } from "./chat-controller";
@@ -47,11 +47,12 @@ export type JoinOptions = {
 };
 export type ConnectionStatus = "idle" | "joining" | "live" | "reconnecting" | "leaving" | "left" | "failed";
 export type Capability = V1Capability;
-export type ErrorCode = "access.invalid" | "access.unavailable" | "chat.cursor_reset_required" | "chat.payload_invalid" | "client.internal_error" | "collaboration.unavailable" | "command.rate_limited" | "command.rejected" | "connection.invalid_state" | "connection.join_cleanup_unconfirmed" | "connection.leave_unconfirmed" | "connection.media_recovery_exhausted" | "connection.media_start_failed" | "connection.sync_recovery_exhausted" | "connection.sync_start_failed" | "environment.unsupported" | "episode.ended" | "media.permission_denied" | "media.device_not_found" | "media.device_busy" | "media.device_constraint_invalid" | "media.capture_failed" | "media.request_invalid" | "media.timeout" | "offline.discarded" | "participant.invalid" | "reaction.invalid" | "whiteboard.unavailable";
+export type ErrorCode = "access.invalid" | "access.unavailable" | "chat.cursor_reset_required" | "chat.payload_invalid" | "client.internal_error" | "collaboration.unavailable" | "command.rate_limited" | "command.rejected" | "connection.invalid_state" | "connection.join_cleanup_unconfirmed" | "connection.leave_unconfirmed" | "connection.media_recovery_exhausted" | "connection.media_start_failed" | "connection.state_digest_recovery_failed" | "connection.sync_recovery_exhausted" | "connection.sync_start_failed" | "connection.sync_hello_timeout" | "environment.unsupported" | "episode.ended" | "media.permission_denied" | "media.device_not_found" | "media.device_busy" | "media.device_constraint_invalid" | "media.capture_failed" | "media.request_invalid" | "media.timeout" | "offline.discarded" | "participant.invalid" | "reaction.invalid" | "whiteboard.unavailable";
 export type ClientFailure = {
     readonly code: ErrorCode;
     readonly recoverable: boolean;
     readonly message: string;
+    readonly sync?: import("../sync/connect-diagnostics").SyncConnectDiagnostic;
 };
 export type EpisodeSummary = {
     readonly id: string;
@@ -60,6 +61,8 @@ export type EpisodeSummary = {
 };
 export type ConnectionSlice = {
     readonly status: ConnectionStatus;
+    /** Pong health; degradation keeps the public status live and controls usable. */
+    readonly syncHealth?: import("../sync/v1-health").SyncHealth;
     readonly episode: EpisodeSummary | null;
     readonly lastError: ClientFailure | null;
     /** The Episode ended while this person was in it. */
@@ -201,6 +204,12 @@ export type WhiteboardSlice = {
         readonly presenting: boolean;
         readonly error: ChalkWhiteboardV1Failure | null;
     };
+    /** Who can draw, as Sync last told this person. `canDraw` is false until the board subscription is live. */
+    readonly access: {
+        readonly canDraw: boolean;
+        readonly policy: ChalkWhiteboardDrawPolicy | null;
+        readonly permissions: readonly ChalkWhiteboardDrawPermission[];
+    };
 };
 export type SpaceSnapshot = {
     readonly connection: ConnectionSlice;
@@ -228,6 +237,10 @@ export type ChatUploadFile = {
     readonly mimeType: string;
     readonly bytes: ArrayBuffer;
 };
+export type CameraPreview = {
+    readonly track: MediaStreamTrack;
+    readonly release: () => void;
+};
 export type MediaController = PromiseController<Omit<MediaControllerEffects, "configure" | "dispose">>;
 export type ChatFilesController = PromiseController<Pick<ChatControllerEffects, "upload" | "url" | "resolveUrl">>;
 export type ChatController = PromiseController<Omit<ChatControllerEffects, "upload" | "url" | "resolveUrl" | "dispose">> & {
@@ -277,4 +290,3 @@ export type SpaceClient = {
     readonly extendEpisode: (minutes: number) => Promise<void>;
     readonly on: <TEvent extends ClientEventName>(event: TEvent, handler: ClientEventHandler<TEvent>) => () => void;
 };
-//# sourceMappingURL=types.d.ts.map

package/dist/space-client/whiteboard-controller.d.ts

@@ -14,4 +14,3 @@ export declare class WhiteboardControllerService extends WhiteboardControllerSer
 export declare const makeWhiteboardController: (connection: ConnectionLifecycleCapability, store: SpaceStore, create?: (input: ConnectionWhiteboardFactoryInput) => ChalkWhiteboardV1Transport | null) => Effect.Effect<WhiteboardControllerEffects, never, import("effect").Scope.Scope>;
 export declare const makeWhiteboardControllerLayer: (connection: ConnectionLifecycleCapability, store: SpaceStore, create?: (input: ConnectionWhiteboardFactoryInput) => ChalkWhiteboardV1Transport | null) => Layer.Layer<WhiteboardControllerService, never, never>;
 export {};
-//# sourceMappingURL=whiteboard-controller.d.ts.map

package/dist/sync/browser.d.ts

@@ -6,4 +6,3 @@ export type BrowserLifecycleEnvironment = {
 };
 export declare function createBrowserWebSocketFactory(WebSocketConstructor?: BrowserWebSocketConstructor): SyncWebSocketFactory;
 export declare function createBrowserSyncLifecycle(environment?: BrowserLifecycleEnvironment): SyncLifecycle;
-//# sourceMappingURL=browser.d.ts.map

package/dist/sync/canonical.d.ts

@@ -4,4 +4,3 @@ export type CanonicalJson = null | boolean | number | string | readonly Canonica
 export declare function canonicalJson(value: CanonicalJson): string;
 export declare function canonicalJsonBytes(value: CanonicalJson): Uint8Array;
 export declare function canonicalJsonBytesFromUnknown(value: unknown): Uint8Array;
-//# sourceMappingURL=canonical.d.ts.map

package/dist/sync/connect-diagnostics.d.ts

@@ -0,0 +1,10 @@
+/** Browsers expose only upgrade/open and hello, never DNS/TCP/TLS progress. */
+export type SyncConnectDiagnostic = {
+    readonly stage: "upgrade" | "hello";
+    readonly opened: boolean;
+    readonly closeCode: number | null;
+    readonly closeReason: string | null;
+    readonly durationMs: number;
+};
+export declare function safeSyncCloseReason(reason: string | undefined): string | null;
+export declare function formatSyncConnectDiagnostic(diagnostic: SyncConnectDiagnostic): string;

package/dist/sync/dial-deadline.d.ts

@@ -0,0 +1,3 @@
+import type { SyncClock } from "./types";
+export declare const SYNC_DIAL_TIMEOUT_MS = 10000;
+export declare function scheduleSyncDialDeadline(clock: Pick<SyncClock, "setTimeout" | "clearTimeout">, onTimeout: () => void, timeoutMs?: number): () => void;

package/dist/sync/errors.d.ts

@@ -6,4 +6,3 @@ export declare class SyncReactNativeCapabilityError extends Error {
     readonly _tag = "SyncReactNativeCapabilityError";
     constructor(capability: "WebSocket");
 }
-//# sourceMappingURL=errors.d.ts.map

package/dist/sync/index.d.ts

@@ -10,4 +10,3 @@ export { InMemoryV1PendingTargetStore } from "./v1-persistence";
 export { AsyncStorageV1PendingTargetStore, IndexedDbV1PendingTargetStore, type AsyncStorageV1PendingTargetStoreOptions, type IndexedDbV1PendingTargetStoreOptions } from "./v1-platform-persistence";
 export { applyV1Event, assertV1ControlSemantics, computeV1StateDigest, optimisticV1Control, restoreV1Snapshot, V1ReplicaError } from "./v1-reducer";
 export type { V1AdmissionPolicy, V1AdmissionTarget, V1AdmissionRequest, V1AssignableRole, V1Capability, V1ClientMediaPlane, V1CommandResult, V1ConnectionPhase, V1ControlState, V1DirectedRequest, V1DirectedRequestResult, V1LiveTargetResult, V1MediaPlaneOutcome, V1MediaPlaneResult, V1MediaPlaneTarget, V1MediaPublication, V1MediaSource, V1Participant, V1PendingTarget, V1PendingTargetStore, V1Presence, V1Projection, V1Recording, V1Role, V1SelfMediaTargetResult, V1EpisodeSnapshot, V1SyncClientOptions, V1TargetCommand, } from "./v1-types";
-//# sourceMappingURL=index.d.ts.map

package/dist/sync/index.js

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

package/dist/sync/react-native.d.ts

@@ -39,4 +39,3 @@ export type ReactNativeLifecycleEnvironment = {
     readonly networkInfo?: ReactNativeNetworkInfo;
 };
 export declare function createReactNativeSyncLifecycle(environment: ReactNativeLifecycleEnvironment): SyncLifecycle;
-//# sourceMappingURL=react-native.d.ts.map

package/dist/sync/types.d.ts

@@ -9,6 +9,7 @@ export type SyncSocket = {
     }) => void) | null;
     onclose: ((event: {
         readonly code: number;
+        readonly reason?: string;
     }) => void) | null;
     onerror: (() => void) | null;
     send(data: string): void;
@@ -25,4 +26,3 @@ export type SyncClock = {
 export type SyncIdGenerator = {
     readonly next: () => string;
 };
-//# sourceMappingURL=types.d.ts.map

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

@@ -1,5 +1,5 @@
 import type { ChalkChatReactionInput, ChalkChatReactions, ChalkChatMessage, ChalkChatPageResult, ChalkChatReadReceipt, ChalkReaction, ChalkReactionEvent, ChalkSendChatMessageInput, ChalkSyncV1CollaborationCapability } from "../collaboration/types";
-import type { V1AdmissionTarget, V1AssignableRole, V1CommandResult, V1DirectedRequest, V1DirectedRequestResult, V1CollaborationEvent, V1CollaborationClient, V1CollaborationExtensionState, V1EpisodeSnapshot, V1SelfMediaTargetResult, V1SyncClientOptions } from "./v1-types";
+import type { V1AdmissionTarget, V1AssignableRole, V1CommandResult, V1DirectedRequest, V1DirectedRequestResult, V1MediaPause, V1CollaborationEvent, V1CollaborationClient, V1CollaborationExtensionState, V1EpisodeSnapshot, V1SelfMediaTargetResult, V1SyncClientOptions } from "./v1-types";
 type CommandOptions = {
     readonly commandId?: string;
 };
@@ -13,8 +13,11 @@ export declare class V1SyncClient implements V1CollaborationClient {
     restartTransport(): void;
     start(): Promise<void>;
     stop(): void;
+    /** Announces completed startup; transport recovery resends until acknowledged. */
+    confirmEntered(): Promise<void>;
     getSnapshot(): V1EpisodeSnapshot;
     subscribe(listener: (snapshot: V1EpisodeSnapshot) => void): () => void;
+    onMediaPause(listener: (pause: V1MediaPause) => void): () => void;
     onDirectedRequest(listener: (request: V1DirectedRequest) => void): () => void;
     getCollaborationExtensionState(): V1CollaborationExtensionState;
     getParticipantCollaborationCapabilities(): Readonly<Record<string, readonly ChalkSyncV1CollaborationCapability[]>>;
@@ -54,4 +57,3 @@ export declare class V1SyncClient implements V1CollaborationClient {
     requestUnmute(participantId: string, options?: RequestOptions): Promise<V1DirectedRequestResult>;
     requestStartCamera(participantId: string, options?: RequestOptions): Promise<V1DirectedRequestResult>;
 }
-//# sourceMappingURL=v1-client.d.ts.map

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

@@ -2,4 +2,3 @@ import { type SyncV1ClientFrame, type SyncV1ServerFrame } from "../generated/syn
 export declare function encodeV1ClientFrame(frame: unknown): string;
 export declare function decodeV1ServerFrame(wire: string): SyncV1ServerFrame;
 export declare function decodeV1ClientFrame(value: unknown): SyncV1ClientFrame;
-//# sourceMappingURL=v1-codec.d.ts.map

package/dist/sync/v1-collaboration-state.d.ts

@@ -9,6 +9,7 @@ export type V1CollaborationHelloExtension = {
     };
 };
 type V1CollaborationStateOptions = {
+    readonly clock: () => NonNullable<V1SyncClientOptions["clock"]>;
     readonly request: V1SyncClientOptions["collaboration"];
     readonly requestIds: V1SyncClientOptions["requestIds"];
     readonly maxPendingRequests: number | undefined;
@@ -69,4 +70,3 @@ export declare class V1CollaborationState {
     }>): void;
 }
 export {};
-//# sourceMappingURL=v1-collaboration-state.d.ts.map

package/dist/sync/v1-command-scheduler.d.ts

@@ -51,4 +51,3 @@ export declare class V1CommandScheduler {
     enterLive(): void;
 }
 export {};
-//# sourceMappingURL=v1-command-scheduler.d.ts.map

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

@@ -9,4 +9,3 @@ export type CreateV1SyncClientOptions = Omit<V1SyncClientOptions, "lifecycle" |
     readonly indexedDb?: Omit<IndexedDbV1PendingTargetStoreOptions, "scope">;
 };
 export declare function createV1SyncClient(options: CreateV1SyncClientOptions): V1SyncClient;
-//# sourceMappingURL=v1-create.d.ts.map

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

@@ -5,4 +5,3 @@ export type V1Deferred<T> = {
 };
 export declare function resolveV1Deferred<T>(deferred: V1Deferred<T>, value: T): void;
 export declare function rejectV1Deferred<T>(deferred: V1Deferred<T>, error: Error): void;
-//# sourceMappingURL=v1-deferred.d.ts.map

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

@@ -2,4 +2,3 @@ export declare class V1SyncError extends Error {
     readonly code: string;
     constructor(message: string, code: string);
 }
-//# sourceMappingURL=v1-error.d.ts.map

package/dist/sync/v1-frame-signature.d.ts

@@ -1,2 +1 @@
 export declare function frameSignature(frame: unknown): string;
-//# sourceMappingURL=v1-frame-signature.d.ts.map

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

@@ -0,0 +1,15 @@
+/** Presentation health, independent of transport reconnection and its 60-second watchdog. */
+export type SyncHealth = "healthy" | "degraded" | "recovering";
+export declare const SYNC_HEALTH_BUDGET: {
+    readonly probeIntervalMs: 500;
+    readonly degradedAfterMs: 750;
+    readonly recoveringAfterMs: 4000;
+    readonly stablePongsForMs: 2000;
+};
+export declare class V1SyncHealth {
+    #private;
+    health: SyncHealth;
+    constructor(now: number);
+    observePong(now: number): void;
+    check(now: number): void;
+}

package/dist/sync/v1-live-target-coordinator.d.ts

@@ -29,4 +29,3 @@ export declare class V1LiveTargetCoordinator {
     disconnect(code: string): void;
 }
 export {};
-//# sourceMappingURL=v1-live-target-coordinator.d.ts.map

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

@@ -7,4 +7,3 @@ export declare class InMemoryV1PendingTargetStore implements V1PendingTargetStor
     remove(commandId: string): Promise<void>;
 }
 export declare function compareV1PendingTargets(left: V1PendingTarget, right: V1PendingTarget): number;
-//# sourceMappingURL=v1-persistence.d.ts.map

package/dist/sync/v1-platform-persistence.d.ts

@@ -23,4 +23,3 @@ export declare class AsyncStorageV1PendingTargetStore implements V1PendingTarget
     put(command: V1PendingTarget): Promise<void>;
     remove(commandId: string): Promise<void>;
 }
-//# sourceMappingURL=v1-platform-persistence.d.ts.map

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

@@ -7,6 +7,9 @@ type Snapshot = typeof SnapshotSchema.Type;
 export declare class V1ReplicaError extends Error {
     constructor(message: string);
 }
+export declare class V1StateDigestMismatchError extends V1ReplicaError {
+    constructor();
+}
 export declare function restoreV1Snapshot(snapshot: Snapshot): Promise<V1ControlState>;
 export declare function applyV1Event(state: V1ControlState, event: EventFrame): Promise<V1ControlState>;
 export declare function optimisticV1Control(state: V1ControlState, actorId: string, commands: readonly V1TargetCommand[]): V1ControlState;
@@ -14,4 +17,3 @@ export declare function snapshotToState(snapshot: Snapshot): V1ControlState;
 export declare function assertV1ControlSemantics(state: V1ControlState): void;
 export declare function computeV1StateDigest(state: V1ControlState): Promise<string>;
 export {};
-//# sourceMappingURL=v1-reducer.d.ts.map

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

@@ -72,6 +72,11 @@ export type V1EpisodeSnapshot = {
         readonly phase: V1ConnectionPhase;
         readonly terminalReason?: string;
         readonly noticeUnresponsive?: boolean;
+        readonly health?: import("./v1-health").SyncHealth;
+        /** Cumulative count retained across successful retries; contains no URL or credentials. */
+        readonly dialTimeoutCount?: number;
+        readonly connectAttempt?: import("./connect-diagnostics").SyncConnectDiagnostic;
+        readonly connectFailure?: import("./connect-diagnostics").SyncConnectDiagnostic;
     };
     readonly participantId: string | null;
     readonly participantGeneration: number | null;
@@ -189,6 +194,8 @@ export type V1SyncClientOptions = {
     readonly clock?: SyncClock;
     readonly lifecycle?: SyncLifecycle;
     readonly reconnectDelayMs?: number;
+    /** Per-attempt WebSocket opening allowance, clamped to 10–60 seconds; defaults to 10 seconds. */
+    readonly dialTimeoutMs?: number;
     readonly maxPendingCommands?: number;
     readonly maxPendingBytes?: number;
     readonly maxPendingAgeMs?: number;
@@ -196,6 +203,12 @@ export type V1SyncClientOptions = {
     readonly retryDelayMs?: number;
     readonly collaboration?: V1CollaborationExtensionRequest | false;
     readonly maxPendingCollaborationRequests?: number;
+    /** Asks Sync to hold the entry until `confirmEntered()`; set it only when the caller will call that method. */
+    readonly entryConfirmation?: boolean;
 };
 export type V1Socket = SyncSocket;
-//# sourceMappingURL=v1-types.d.ts.map
+/** Explicit host pause; control revisions do not identify a self-media operation. */
+export type V1MediaPause = {
+    readonly source: V1MediaSource;
+    readonly revision: number;
+};

package/dist/webhooks/errors.d.ts

@@ -6,4 +6,3 @@ export declare class WebhookVerificationError extends Error {
 export declare class WebhookServerOnlyError extends Error {
     constructor();
 }
-//# sourceMappingURL=errors.d.ts.map

package/dist/webhooks/generated/event-v1.d.ts

@@ -770,4 +770,3 @@ export type EndpointTestWebhookEvent = Extract<KnownWebhookEventV1, {
     readonly event: "endpoint.test";
 }>;
 export {};
-//# sourceMappingURL=event-v1.d.ts.map

package/dist/webhooks/generated/fixtures-v1.d.ts

@@ -44,4 +44,3 @@ export declare const webhookFixturesV1: readonly [{
     readonly event: "endpoint.test";
     readonly body_utf8: '{"id":"00000000-0000-4000-8000-000000000015","event":"endpoint.test","api_version":1,"occurred_at":"2026-07-12T19:13:00.000Z","tenant_id":"10000000-0000-4000-8000-000000000001","data":{"object":{"endpoint_id":"80000000-0000-4000-8000-000000000001"}}}';
 }];
-//# sourceMappingURL=fixtures-v1.d.ts.map

package/dist/webhooks/index.d.ts

@@ -3,4 +3,3 @@ export * from "./generated/event-v1.js";
 export * from "./processor.js";
 export * from "./types.js";
 export * from "./verify.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/webhooks/processor.d.ts

@@ -19,4 +19,3 @@ export type CreateWebhookProcessorOptions = {
 };
 export declare const createWebhookProcessor: (options: CreateWebhookProcessorOptions) => WebhookProcessor;
 export declare const toWebhookResponse: (processResult: WebhookProcessResult) => Response;
-//# sourceMappingURL=processor.d.ts.map

package/dist/webhooks/server-only.d.ts

@@ -1,2 +1 @@
 export { WebhookServerOnlyError } from "./errors.js";
-//# sourceMappingURL=server-only.d.ts.map

package/dist/webhooks/test.d.ts

@@ -40,4 +40,3 @@ export declare class TestOnlyInMemoryWebhookInbox implements WebhookInbox {
         token: string;
     }): Promise<void>;
 }
-//# sourceMappingURL=test.d.ts.map

package/dist/webhooks/types.d.ts

@@ -53,4 +53,3 @@ export type WebhookDiagnosticEvent = Readonly<{
     eventName?: string;
     apiVersion?: number;
 }>;
-//# sourceMappingURL=types.d.ts.map

package/dist/webhooks/validate.d.ts

@@ -3,4 +3,3 @@ export declare const validateSchema: (value: unknown, schema: Schema) => boolean
 export declare const validateWebhookEnvelopeV1: (value: unknown) => value is Record<string, unknown>;
 export declare const validateKnownWebhookEventV1: (value: unknown) => boolean;
 export {};
-//# sourceMappingURL=validate.d.ts.map

package/dist/webhooks/verify.d.ts

@@ -8,4 +8,3 @@ export type VerifyWebhookInput = {
     now?: () => Date;
 };
 export declare const verifyWebhook: (input: VerifyWebhookInput) => Promise<ChalkWebhookEvent>;
-//# sourceMappingURL=verify.d.ts.map

package/dist/whiteboard/file-download-transport.d.ts

@@ -5,4 +5,3 @@ export type ChalkWhiteboardV1FileDownloadTransportOptions = {
     readonly fetch?: typeof globalThis.fetch;
 };
 export declare function createChalkWhiteboardV1FileDownloadTransport(options: ChalkWhiteboardV1FileDownloadTransportOptions): ChalkWhiteboardV1FileTransport;
-//# sourceMappingURL=file-download-transport.d.ts.map

package/dist/whiteboard/index.d.ts

@@ -1,7 +1,8 @@
+export { ChalkWhiteboardViewBounds } from "./view-bounds";
 export { createChalkWhiteboardV1FileDownloadTransport, type ChalkWhiteboardV1FileDownloadTransportOptions } from "./file-download-transport";
 export * from "./types";
 export { ChalkWhiteboardV1Client } from "./v1-client";
 export { decodeWhiteboardV1ServerFrame, encodeWhiteboardV1ClientFrame } from "./v1-codec";
 export { createChalkWhiteboardV1Client, type CreateChalkWhiteboardV1ClientOptions } from "./v1-create";
 export { InMemoryChalkWhiteboardV1PendingOperationStore } from "./v1-persistence";
-//# sourceMappingURL=index.d.ts.map
+export { ChalkWhiteboardViewVersions } from "./view-versions";

package/dist/whiteboard/types.d.ts

@@ -36,17 +36,53 @@ export type ChalkWhiteboardV1Event = {
     readonly x: number;
     readonly y: number;
     readonly occurredAt: string;
-} | {
+} | ({
+    readonly type: "view";
+    readonly participantId: string;
+    readonly displayName: string;
+    readonly occurredAt: string;
+} & ChalkWhiteboardView) | {
     readonly type: "reset_required";
     readonly sceneId: string;
     readonly reason: "scene_changed" | "cursor_expired" | "gap";
 };
+/** The part of the board a person sees, in board coordinates. `bring` asks everyone to move there. */
+export type ChalkWhiteboardView = {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly bring: boolean;
+    /** Real move by default; false marks a passive refresh or heartbeat. */
+    readonly lead?: boolean;
+} & ({
+    readonly ownerId: string;
+    readonly ownerSequence: number;
+} | {
+    readonly ownerId?: never;
+    readonly ownerSequence?: never;
+}) & ({
+    readonly originParticipantId: string;
+    readonly originSequence: number;
+    readonly originEpoch?: string;
+} | {
+    readonly originParticipantId?: never;
+    readonly originSequence?: never;
+    readonly originEpoch?: never;
+});
 export type ChalkWhiteboardV1Commit = {
     readonly operationId: string;
     readonly sceneId: string;
     readonly revision: string;
 };
-export type ChalkWhiteboardV1Operation = "start_scene_subscription" | "submit_update" | "request_snapshot" | "clear" | "set_draw_permission" | "set_presentation" | "get_file_download";
+export type ChalkWhiteboardV1Operation = "start_scene_subscription" | "submit_update" | "request_snapshot" | "clear" | "set_draw_permission" | "set_draw_policy" | "set_presentation" | "get_file_download";
+/** Who can draw in the call. Hosts, the people whose role can manage the board, can always draw under `hosts` and `picked`. */
+export type ChalkWhiteboardDrawPolicy = WhiteboardV1DrawPolicy;
+/** A host's choice for one person. Under `everyone` it overrides the role default; under `picked` `true` means picked; under `hosts` it is kept but ignored. */
+export type ChalkWhiteboardDrawPermission = {
+    readonly participantId: string;
+    readonly canDraw: boolean;
+};
 export type ChalkWhiteboardV1ErrorCode = "unavailable" | "permission_denied" | "invalid_payload" | "stale_scene" | "cursor_reset_required" | "storage_unavailable" | "file_transfer_failed";
 export type ChalkWhiteboardV1Failure = {
     readonly operation: ChalkWhiteboardV1Operation;
@@ -76,16 +112,23 @@ export type ChalkWhiteboardV1Transport = {
         readonly x: number;
         readonly y: number;
     }) => void;
+    /** Whether the active subscription negotiated view_v1; remains stable during recovery. */
+    readonly supportsViews?: boolean;
+    /** Accepts views while subscribed; keeps the latest bring through recovery. False means views are unavailable. */
+    readonly forgetParticipant?: (participantId: string) => void;
+    readonly sendView?: (view: ChalkWhiteboardView) => boolean;
     readonly requestSnapshot: () => Promise<void>;
     readonly clear: () => Promise<ChalkWhiteboardV1Commit>;
     readonly setDrawPermission: (participantId: string, canDraw: boolean) => Promise<void>;
+    /** Sets the call-wide drawing policy. Requires manageWhiteboard and a Sync server with draw_policy_v1. */
+    readonly setDrawPolicy?: (policy: ChalkWhiteboardDrawPolicy) => Promise<void>;
     readonly setPresentation?: (presenting: boolean) => Promise<void>;
     readonly files: ChalkWhiteboardV1FileTransport;
 };
 export type ChalkWhiteboardV1PendingOperation = {
     readonly operationId: string;
     readonly frame: Extract<WhiteboardV1ClientFrame, {
-        readonly type: "submit_update" | "clear" | "set_draw_permission" | "set_presentation";
+        readonly type: "submit_update" | "clear" | "set_draw_permission" | "set_draw_policy" | "set_presentation";
     }>;
     readonly createdAt: number;
     readonly bytes: number;
@@ -112,6 +155,8 @@ export type ChalkWhiteboardV1ClientOptions = {
         readonly revision: string;
     };
     readonly reconnectDelayMs?: number;
+    /** Per-attempt WebSocket opening allowance, clamped to 10–60 seconds; defaults to 10 seconds. */
+    readonly dialTimeoutMs?: number;
     readonly retryDelayMs?: number;
     readonly onSummary?: (summary: ChalkWhiteboardSummary) => void;
     readonly watchdog?: boolean;
@@ -127,13 +172,17 @@ export type ChalkWhiteboardSummary = {
     readonly sceneId: string | null;
     readonly revision: string | null;
     readonly capabilities: readonly ChalkWhiteboardV1Capability[];
+    /** This person's drawing permission, computed by Sync from the policy, their role and the host's choice for them. */
     readonly canDraw: boolean;
     readonly canClear: boolean;
+    /** The call-wide policy, or null when the Sync server predates draw_policy_v1. */
+    readonly drawPolicy: ChalkWhiteboardDrawPolicy | null;
+    /** The host's per-person choices for people in the call. Empty unless this person is a host. */
+    readonly drawPermissions: readonly ChalkWhiteboardDrawPermission[];
     readonly presenting: boolean;
     readonly error: ChalkWhiteboardV1Failure | null;
 };
-import type { WhiteboardV1ClientFrame } from "../generated/whiteboard-v1";
+import type { WhiteboardV1ClientFrame, WhiteboardV1DrawPolicy } from "../generated/whiteboard-v1";
 import type { ChalkWhiteboardV1Capability } from "../collaboration/types";
 import type { SyncClock, SyncIdGenerator, SyncLifecycle, SyncWebSocketFactory } from "../sync/types";
 export type { ChalkWhiteboardV1Capability } from "../collaboration/types";
-//# sourceMappingURL=types.d.ts.map

package/dist/whiteboard/v1-client.d.ts

@@ -1,4 +1,4 @@
-import { type ChalkWhiteboardV1ClientOptions, type ChalkWhiteboardV1Commit, type ChalkWhiteboardV1Event, type ChalkWhiteboardSummary, type ChalkWhiteboardV1Transport, type ChalkWhiteboardV1UpdateInput } from "./types";
+import { type ChalkWhiteboardV1ClientOptions, type ChalkWhiteboardV1Commit, type ChalkWhiteboardDrawPolicy, type ChalkWhiteboardV1Event, type ChalkWhiteboardSummary, type ChalkWhiteboardV1Transport, type ChalkWhiteboardV1UpdateInput, type ChalkWhiteboardView } from "./types";
 export declare class ChalkWhiteboardV1Client implements ChalkWhiteboardV1Transport {
     #private;
     readonly files: import("./types").ChalkWhiteboardV1FileTransport;
@@ -12,9 +12,12 @@ export declare class ChalkWhiteboardV1Client implements ChalkWhiteboardV1Transpo
         readonly x: number;
         readonly y: number;
     }): void;
+    get supportsViews(): boolean;
+    forgetParticipant(participantId: string): void;
+    sendView(view: ChalkWhiteboardView): boolean;
     requestSnapshot(): Promise<void>;
     clear(): Promise<ChalkWhiteboardV1Commit>;
     setDrawPermission(participantId: string, canDraw: boolean): Promise<void>;
+    setDrawPolicy(policy: ChalkWhiteboardDrawPolicy): Promise<void>;
     setPresentation(presenting: boolean): Promise<void>;
 }
-//# sourceMappingURL=v1-client.d.ts.map

package/dist/whiteboard/v1-codec.d.ts

@@ -1,4 +1,7 @@
 import { type WhiteboardV1ServerFrame } from "../generated/whiteboard-v1";
 export declare function encodeWhiteboardV1ClientFrame(frame: unknown): string;
-export declare function decodeWhiteboardV1ServerFrame(wire: string): WhiteboardV1ServerFrame;
-//# sourceMappingURL=v1-codec.d.ts.map
+/** Negotiated control frames belong to the connection, not the public 5.1 frame union. */
+export declare function decodeWhiteboardV1ServerFrame(wire: string): Exclude<WhiteboardV1ServerFrame, {
+    readonly type: "view_ack" | "draw_access";
+}>;
+export declare function decodeWhiteboardV1WireFrame(wire: string): WhiteboardV1ServerFrame;

package/dist/whiteboard/v1-create.d.ts

@@ -5,4 +5,3 @@ export type CreateChalkWhiteboardV1ClientOptions = Omit<ChalkWhiteboardV1ClientO
     readonly webSocket?: ChalkWhiteboardV1ClientOptions["webSocket"];
 };
 export declare function createChalkWhiteboardV1Client(options: CreateChalkWhiteboardV1ClientOptions): ChalkWhiteboardV1Client;
-//# sourceMappingURL=v1-create.d.ts.map

package/dist/whiteboard/v1-multipart.d.ts

@@ -1,6 +1,6 @@
 import { type WhiteboardV1ClientFrame, type WhiteboardV1ServerFrame } from "../generated/whiteboard-v1";
 export type WhiteboardV1LogicalOperationFrame = Extract<WhiteboardV1ClientFrame, {
-    readonly type: "submit_update" | "clear" | "set_draw_permission" | "set_presentation";
+    readonly type: "submit_update" | "clear" | "set_draw_permission" | "set_draw_policy" | "set_presentation";
 }>;
 type UpdatePartFrame = Extract<WhiteboardV1ServerFrame, {
     readonly type: "update_part";
@@ -27,4 +27,3 @@ export declare class WhiteboardV1UpdateAssembler {
 }
 export declare function whiteboardV1UpdateAssemblyKey(frame: Pick<UpdatePartFrame, "operation_id" | "scene_id" | "revision">): string;
 export {};
-//# sourceMappingURL=v1-multipart.d.ts.map

package/dist/whiteboard/v1-persistence.d.ts

@@ -6,4 +6,3 @@ export declare class InMemoryChalkWhiteboardV1PendingOperationStore implements C
     remove(operationId: string): Promise<void>;
 }
 export declare function compareChalkWhiteboardV1PendingOperations(left: ChalkWhiteboardV1PendingOperation, right: ChalkWhiteboardV1PendingOperation): number;
-//# sourceMappingURL=v1-persistence.d.ts.map

package/dist/whiteboard/view-bounds.d.ts

@@ -0,0 +1,5 @@
+/** Bounds for shared camera rectangles. */
+export declare const ChalkWhiteboardViewBounds: {
+    maxCoordinate: 1000000;
+    maxExtent: 2000000;
+};

package/dist/whiteboard/view-versions.d.ts

@@ -0,0 +1,9 @@
+import type { ChalkWhiteboardView } from "./types";
+/** Owner sequences are compared only within a connection's authoritative snapshot. */
+export declare class ChalkWhiteboardViewVersions {
+    #private;
+    isNew(view: ChalkWhiteboardView, participantId?: string): boolean;
+    remember(view: ChalkWhiteboardView, participantId?: string): void;
+    forgetParticipant(participantId: string): void;
+    clear(): void;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q9labsai/chalk-client",
-  "version": "5.0.1",
+  "version": "5.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -8,7 +8,9 @@
     "directory": "sdks/typescript/client"
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md",
+    "!dist/**/*.test.helpers.*"
   ],
   "type": "module",
   "sideEffects": [

package/dist/access/base64-url.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base64-url.d.ts","sourceRoot":"","sources":["../../src/access/base64-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOrD"}

package/dist/access/grant.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"grant.d.ts","sourceRoot":"","sources":["../../src/access/grant.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,mBAAmB,EAAE,OAAO,MAAM,CAAC;AACjD,OAAO,CAAC,MAAM,oBAAoB,EAAE,OAAO,MAAM,CAAC;AAClD,QAAA,MAAM,gBAAgB,EAAE,OAAO,MAA8B,CAAC;AAC9D,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG;IAC/C,QAAQ,CAAC,CAAC,mBAAmB,CAAC,EAAE,YAAY,CAAC;CAC9C,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG;IAChD,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC;CAChD,CAAC;AACF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;CACxC,CAAC;AACF,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;CAC5C,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AACvF,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IAC1C,YAAY,OAAO,SAA4B,EAG9C;CACF;AAcD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAUxE;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAE5D;AACD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CAmB3E;AACD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAWzF;AACD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAW7E;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAO9E"}

package/dist/access/grant.test.helpers.d.ts

@@ -1,10 +0,0 @@
-import type { ParsedAccessGrant } from "./grant";
-export declare const ACCESS_SUBJECT: {
-    readonly tenantId: "tenant-1";
-    readonly spaceId: "space-1";
-    readonly episodeId: "episode-1";
-    readonly participantId: "participant-1";
-    readonly participantGeneration: 1;
-};
-export declare function accessGrant(expiresAt: number, suffix: string, connectionId?: string): ParsedAccessGrant;
-//# sourceMappingURL=grant.test.helpers.d.ts.map

package/dist/access/grant.test.helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"grant.test.helpers.d.ts","sourceRoot":"","sources":["../../src/access/grant.test.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,eAAO,MAAM,cAAc;aACzB,QAAQ,EAAE,UAAU;aACpB,OAAO,EAAE,SAAS;aAClB,SAAS,EAAE,WAAW;aACtB,aAAa,EAAE,eAAe;aAC9B,qBAAqB,EAAE,CAAC;CAChB,CAAC;AAEX,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,SAAiB,GAAG,iBAAiB,CAM/G"}

package/dist/access/manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/access/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,OAAO,EAAQ,MAAM,EAAE,KAAK,EAAmB,MAAM,QAAQ,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AACxG,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;;;;AAGlG,qBAAa,uBAAwB,SAAQ,6BAA4C;IACvF,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,oBAAoB,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;AACL,MAAM,MAAM,8BAA8B,GAAG,CAAC,OAAO,EAAE,uBAAuB,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;AAC7I,MAAM,MAAM,iCAAiC,GAAG,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;AACpF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,iBAAiB,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;IACrH,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;IACrH,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,EAAE,MAAM,CAAC,EAAE,sBAAsB,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;IAClK,QAAQ,CAAC,qBAAqB,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;IAChG,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,KAAK,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,uBAAuB,CAAC,CAAC;IAC9H,QAAQ,CAAC,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,0BAA0B,EAAE,uBAAuB,CAAC,CAAC;IACjG,QAAQ,CAAC,kCAAkC,EAAE,CAAC,QAAQ,EAAE,iCAAiC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACxH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CACrC,CAAC;;AACF,qBAAa,uBAAwB,SAAQ,4BAA2G;CAAG;AAe3J;;;GAGG;AACH,eAAO,MAAM,yBAAyB,aAAc,8BAA8B,iFAsC/E,CAAC;AACJ,eAAO,MAAM,6BAA6B,aAvCU,8BAA8B,iFAuCZ,CAAC"}