@q9labsai/chalk-client 5.0.0 → 5.1.0

package/dist/media/cloudflare-sfu.d.ts

@@ -2,4 +2,3 @@ export * from "./client";
 export * from "./tracks";
 export * from "./transport";
 export * from "./types";
-//# sourceMappingURL=cloudflare-sfu.d.ts.map

package/dist/media/index.d.ts

@@ -1,4 +1,3 @@
 export * from "./cloudflare-sfu";
 export type { ClientMediaPlane, ConnectionMediaLocalTrack, ConnectionMediaPhase, ConnectionMediaRemoteTrack, ConnectionMediaSnapshot, MediaPlaneOutcome, MediaPlaneResult, MediaPlaneTarget, MediaPublication, MediaPublicationSource, MediaSource } from "./plane";
 export { describeMediaCaptureError } from "./capture-error";
-//# sourceMappingURL=index.d.ts.map

package/dist/media/index.js

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

package/dist/media/observers.d.ts

@@ -1,3 +1,2 @@
 export declare function subscribeSnapshot(listeners: Set<() => void>, listener: () => void): () => void;
 export declare function observePublications<T>(listeners: Set<() => void>, listener: (value: T) => void, project: () => T): () => void;
-//# sourceMappingURL=observers.d.ts.map

package/dist/media/plane.d.ts

@@ -61,4 +61,3 @@ export type ClientMediaPlane = {
     readonly remoteParticipantsChanged?: (participantIds: readonly string[]) => void;
     readonly remotePublicationResumed?: (publicationId: string) => void;
 };
-//# sourceMappingURL=plane.d.ts.map

package/dist/media/remote-track-response.d.ts

@@ -3,4 +3,3 @@ export declare function matchRemotePullTracks(publications: readonly CloudflareS
     publication: CloudflareSFUPublication;
     mid: string;
 }[];
-//# sourceMappingURL=remote-track-response.d.ts.map

package/dist/media/target.d.ts

@@ -9,4 +9,3 @@ export type MediaTargetResolution<T> = {
 export declare function resolveMediaTarget<T>(participantId: string, stopped: boolean, tracks: ReadonlyMap<MediaPublicationSource, T>, target: Omit<MediaPlaneTarget, "source"> & {
     readonly source: MediaPublicationSource;
 }): MediaTargetResolution<T>;
-//# sourceMappingURL=target.d.ts.map

package/dist/media/tracks.d.ts

@@ -18,4 +18,3 @@ export declare function publicationKey(publication: {
     readonly source: MediaPublicationSource;
 }): string;
 export declare function waitFor(predicate: () => boolean, timeoutMs: number, timeoutMessage?: string): Promise<void>;
-//# sourceMappingURL=tracks.d.ts.map

package/dist/media/transport.d.ts

@@ -1,3 +1,2 @@
 import type { CloudflareSFUHTTPTransportOptions, CloudflareSFUSignalingTransport } from "./types";
 export declare function createCloudflareSFUHTTPTransport(options: CloudflareSFUHTTPTransportOptions): CloudflareSFUSignalingTransport;
-//# sourceMappingURL=transport.d.ts.map

package/dist/media/types.d.ts

@@ -133,4 +133,3 @@ export declare class CloudflareSFUError extends Error {
         readonly providerCode?: string;
     });
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/public-invites/client.d.ts

@@ -1,4 +1,3 @@
 import type { ChalkPublicClient, ChalkPublicClientOptions } from "./types.js";
 export declare function createChalkPublicClient(options: ChalkPublicClientOptions): ChalkPublicClient;
 export declare const createChalkPublicInviteClient: typeof createChalkPublicClient;
-//# sourceMappingURL=client.d.ts.map

package/dist/public-invites/index.d.ts

@@ -2,4 +2,3 @@ export { createChalkPublicClient, createChalkPublicInviteClient } from "./client
 export type { ArriveBySpacePublicInviteInput, ChalkPublicClient, ChalkPublicClientOptions, ChalkPublicClientRuntime, ChalkPublicIdempotencyOptions, ChalkPublicInviteError, CreatePublicSpace, CreatePublicSpaceInput, ArriveBySpacePublicInvite, GetSpacePublicInviteArrival, LeaveSpacePublicInviteArrival, PublicArrivalOptions, PublicArrivalReference, PublicRefreshAccessInput, PublicLeaveOptions, PublicSpaceArrival, PublicSpaceArrivalAccess, PublicSpaceCreated, RefreshSpacePublicInviteAccess, } from "./types.js";
 export { ArrivalInvalidHandleError, ArrivalUnavailableError, SpacePublicInviteUnavailableError } from "../generated/schemas.js";
 export type { ApproveSpacePublicAdmissionRequestError, ArriveBySpacePublicInviteError, CreatePublicSpaceError, DenySpacePublicAdmissionRequestError, GetSpacePublicInviteArrivalError, LeaveSpacePublicInviteArrivalError, RefreshSpacePublicInviteAccessError } from "../generated/schemas.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/public-invites/index.js

@@ -1,12 +1,12 @@
 import {
   createChalkPublicClient,
   createChalkPublicInviteClient
-} from "../chunk-CMVO7USN.js";
+} from "../chunk-KHHULLBZ.js";
 import {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
   SpacePublicInviteUnavailableError
-} from "../chunk-2HJIJVE2.js";
+} from "../chunk-3ZN7IXOZ.js";
 export {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,

package/dist/public-invites/types.d.ts

@@ -63,4 +63,3 @@ export type ChalkPublicClient = {
 };
 export type ChalkPublicInviteError = PreparePublicSpaceEntranceError | ApproveSpacePublicAdmissionRequestError | ArriveBySpacePublicInviteError | DenySpacePublicAdmissionRequestError | CreatePublicSpaceError | GetSpacePublicInviteArrivalError | LeaveSpacePublicInviteArrivalError | RefreshSpacePublicInviteAccessError | ArrivalInvalidHandleError | ArrivalUnavailableError | SpacePublicInviteUnavailableError;
 export type PublicSpaceArrivalAccess = PublicSpaceArrival["access"];
-//# sourceMappingURL=types.d.ts.map

package/dist/server/access-refresh.d.ts

@@ -11,4 +11,3 @@ export type AccessRefreshState = {
 /** Retain after admission and every issueAccess response; pass directly to participants.issueAccess for refresh. */
 export declare function getAccessRefreshState(access: AccessGrant): AccessRefreshState;
 export declare function accessRefreshInput(state: IssueAccessGrantInput, request?: AccessRefreshRequest): IssueAccessGrantInput;
-//# sourceMappingURL=access-refresh.d.ts.map

package/dist/server/{chunk-C4XITY5U.js → chunk-XQOQTCUL.js}

@@ -1,4 +1,22 @@
 // src/server/errors.ts
+var accessGrantErrorCodes = [
+  "media_token.required",
+  "media_token.malformed",
+  "media_token.invalid_header",
+  "media_token.unknown_key",
+  "media_token.invalid_signature",
+  "media_token.invalid_issuer",
+  "media_token.invalid_audience",
+  "media_token.invalid_time_claims",
+  "media_token.not_yet_valid",
+  "media_token.expired",
+  "media_token.lifetime_exceeded",
+  "media_token.invalid_subject",
+  "media_token.subject_mismatch",
+  "participant.generation_mismatch",
+  "participant.connection_superseded",
+  "access.forbidden"
+];
 var safeCodePattern = /^[a-z][a-z0-9_.-]{0,63}$/u;
 var safeRequestIdPattern = /^[A-Za-z0-9._:-]{1,128}$/u;
 var ChalkAPIError = class extends Error {
@@ -15,6 +33,9 @@ var ChalkAPIError = class extends Error {
     this.requestId = input.requestId;
   }
 };
+function isChalkAccessGrantError(error) {
+  return error instanceof ChalkAPIError && accessGrantErrorCodes.some((code) => code === error.code);
+}
 var ChalkServerOnlyError = class extends Error {
   constructor() {
     super("The Chalk server client is available only in Node.js runtimes.");
@@ -55,6 +76,7 @@ function isRecord(value) {
 
 export {
   ChalkAPIError,
+  isChalkAccessGrantError,
   ChalkServerOnlyError,
   errorCode,
   requestId

package/dist/server/client.d.ts

@@ -1,3 +1,2 @@
 import type { ChalkServerClient, ChalkServerClientOptions } from "./types.js";
 export declare function createChalkServerClient(options: ChalkServerClientOptions): ChalkServerClient;
-//# sourceMappingURL=client.d.ts.map

package/dist/server/errors.d.cts

@@ -1,4 +1,6 @@
-export type ChalkAPIErrorCode = "network_error" | "invalid_response" | "request_failed" | (string & {});
+declare const accessGrantErrorCodes: readonly ["media_token.required", "media_token.malformed", "media_token.invalid_header", "media_token.unknown_key", "media_token.invalid_signature", "media_token.invalid_issuer", "media_token.invalid_audience", "media_token.invalid_time_claims", "media_token.not_yet_valid", "media_token.expired", "media_token.lifetime_exceeded", "media_token.invalid_subject", "media_token.subject_mismatch", "participant.generation_mismatch", "participant.connection_superseded", "access.forbidden"];
+export type ChalkAccessGrantErrorCode = (typeof accessGrantErrorCodes)[number];
+export type ChalkAPIErrorCode = ChalkAccessGrantErrorCode | "network_error" | "invalid_response" | "request_failed" | (string & {});
 export declare class ChalkAPIError extends Error {
     readonly code: ChalkAPIErrorCode;
     readonly requestId: string | undefined;
@@ -11,8 +13,13 @@ export declare class ChalkAPIError extends Error {
         status: number;
     });
 }
+/** Narrows known access-grant failures while preserving their status and request ID. */
+export declare function isChalkAccessGrantError(error: unknown): error is ChalkAPIError & {
+    readonly code: ChalkAccessGrantErrorCode;
+};
 export declare class ChalkServerOnlyError extends Error {
     constructor();
 }
 export declare function errorCode(value: unknown): ChalkAPIErrorCode;
 export declare function requestId(headers: Headers): string | undefined;
+export {};

package/dist/server/errors.d.ts

@@ -1,4 +1,6 @@
-export type ChalkAPIErrorCode = "network_error" | "invalid_response" | "request_failed" | (string & {});
+declare const accessGrantErrorCodes: readonly ["media_token.required", "media_token.malformed", "media_token.invalid_header", "media_token.unknown_key", "media_token.invalid_signature", "media_token.invalid_issuer", "media_token.invalid_audience", "media_token.invalid_time_claims", "media_token.not_yet_valid", "media_token.expired", "media_token.lifetime_exceeded", "media_token.invalid_subject", "media_token.subject_mismatch", "participant.generation_mismatch", "participant.connection_superseded", "access.forbidden"];
+export type ChalkAccessGrantErrorCode = (typeof accessGrantErrorCodes)[number];
+export type ChalkAPIErrorCode = ChalkAccessGrantErrorCode | "network_error" | "invalid_response" | "request_failed" | (string & {});
 export declare class ChalkAPIError extends Error {
     readonly code: ChalkAPIErrorCode;
     readonly requestId: string | undefined;
@@ -11,9 +13,13 @@ export declare class ChalkAPIError extends Error {
         status: number;
     });
 }
+/** Narrows known access-grant failures while preserving their status and request ID. */
+export declare function isChalkAccessGrantError(error: unknown): error is ChalkAPIError & {
+    readonly code: ChalkAccessGrantErrorCode;
+};
 export declare class ChalkServerOnlyError extends Error {
     constructor();
 }
 export declare function errorCode(value: unknown): ChalkAPIErrorCode;
 export declare function requestId(headers: Headers): string | undefined;
-//# sourceMappingURL=errors.d.ts.map
+export {};

package/dist/server/index.cjs

@@ -23,7 +23,8 @@ __export(index_exports, {
   ChalkAPIError: () => ChalkAPIError,
   ChalkServerOnlyError: () => ChalkServerOnlyError,
   createChalkServerClient: () => createChalkServerClient,
-  getAccessRefreshState: () => getAccessRefreshState
+  getAccessRefreshState: () => getAccessRefreshState,
+  isChalkAccessGrantError: () => isChalkAccessGrantError
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -169,6 +170,24 @@ function accessRefreshInput(state, request) {
 }
 
 // src/server/errors.ts
+var accessGrantErrorCodes = [
+  "media_token.required",
+  "media_token.malformed",
+  "media_token.invalid_header",
+  "media_token.unknown_key",
+  "media_token.invalid_signature",
+  "media_token.invalid_issuer",
+  "media_token.invalid_audience",
+  "media_token.invalid_time_claims",
+  "media_token.not_yet_valid",
+  "media_token.expired",
+  "media_token.lifetime_exceeded",
+  "media_token.invalid_subject",
+  "media_token.subject_mismatch",
+  "participant.generation_mismatch",
+  "participant.connection_superseded",
+  "access.forbidden"
+];
 var safeCodePattern = /^[a-z][a-z0-9_.-]{0,63}$/u;
 var safeRequestIdPattern = /^[A-Za-z0-9._:-]{1,128}$/u;
 var ChalkAPIError = class extends Error {
@@ -185,6 +204,9 @@ var ChalkAPIError = class extends Error {
     this.requestId = input.requestId;
   }
 };
+function isChalkAccessGrantError(error) {
+  return error instanceof ChalkAPIError && accessGrantErrorCodes.some((code) => code === error.code);
+}
 var ChalkServerOnlyError = class extends Error {
   constructor() {
     super("The Chalk server client is available only in Node.js runtimes.");
@@ -245,7 +267,7 @@ async function performAttempt(attempt, index) {
   const response = await fetchAttempt(attempt, index);
   if (response.status === attempt.input.expectedStatus) return decodeSuccess(response);
   if (canRetryResponse(response, attempt.retries, index)) return retryResponse(response, attempt, index);
-  throw await responseError(response);
+  throw await responseError(response, attempt.input.retry !== "never");
 }
 async function fetchAttempt(attempt, index) {
   try {
@@ -255,7 +277,7 @@ async function fetchAttempt(attempt, index) {
   }
 }
 async function retryTransport(attempt, index) {
-  if (index >= attempt.retries) throw new ChalkAPIError({ code: "network_error", retryable: true, status: 0 });
+  if (index >= attempt.retries) throw new ChalkAPIError({ code: "network_error", retryable: attempt.input.retry !== "never", status: 0 });
   await retryDelay(index);
   return fetchAttempt(attempt, index + 1);
 }
@@ -303,8 +325,8 @@ function setContentType(headers, hasBody) {
 function setOptionalHeader(headers, name, value) {
   if (value !== void 0) headers.set(name, value);
 }
-async function responseError(response) {
-  return new ChalkAPIError({ code: errorCode(await errorBody(response)), requestId: requestId(response.headers), retryable: retryableStatuses.has(response.status), status: response.status });
+async function responseError(response, retryable) {
+  return new ChalkAPIError({ code: errorCode(await errorBody(response)), requestId: requestId(response.headers), retryable: retryable && retryableStatuses.has(response.status), status: response.status });
 }
 async function errorBody(response) {
   try {
@@ -420,7 +442,8 @@ function createChalkServerClient(options) {
           path: `${tenantPath}/spaces/${segment(spaceId)}/episodes/${segment(episodeId)}/participants/${segment(participantId)}/access-grant`,
           body: accessGrantRequest(resolvedInput),
           expectedStatus: 201,
-          retry: resolvedInput.replaceMediaConnection === true ? "never" : "always"
+          // An expired token can cause replacement even without the explicit flag.
+          retry: "never"
         });
         return accessGrant(access);
       },
@@ -686,5 +709,6 @@ function invalidResponse(status) {
   ChalkAPIError,
   ChalkServerOnlyError,
   createChalkServerClient,
-  getAccessRefreshState
+  getAccessRefreshState,
+  isChalkAccessGrantError
 });

package/dist/server/index.d.cts

@@ -1,4 +1,4 @@
 export { getAccessRefreshState, type AccessRefreshRequest, type AccessRefreshState } from "./access-refresh.cjs";
 export { createChalkServerClient } from "./client.cjs";
-export { ChalkAPIError, ChalkServerOnlyError } from "./errors.cjs";
+export { ChalkAPIError, ChalkServerOnlyError, isChalkAccessGrantError, type ChalkAccessGrantErrorCode } from "./errors.cjs";
 export type { APIKey, APIKeyList, APIKeyWithSecret, AdmitParticipantInput, ChalkIdempotencyOptions, ChalkServerClient, ChalkServerClientOptions, ChalkServerHeaders, CreateAPIKeyInput, CreateEpisodeInput, CreateRecordingDownloadURLInput, CreateSpaceInput, Episode, EpisodeEnd, IssueAccessGrantInput, ListPublicAdmissionRequestsInput, ListRecordingsInput, ListAPIKeysInput, ListSpacesInput, AccessGrant, ParticipantLifecycle, ParticipantRemoval, PublicAdmissionRequest, PublicAdmissionRequestPage, Recording, RecordingDownloadURL, RecordingExport, RecordingExportRequestAcceptedResponse, RecordingExportStatus, RecordingList, RecordingSource, RecordingSourceStatus, RecordingPolicy, RemoveParticipantInput, RotateAPIKeyInput, Space, SpacePublicInvite, SpaceList, TranscriptionPolicy, UpdateSpaceInput, UpdateSpacePublicInviteInput, } from "./types.cjs";

package/dist/server/index.d.ts

@@ -1,5 +1,4 @@
 export { getAccessRefreshState, type AccessRefreshRequest, type AccessRefreshState } from "./access-refresh.js";
 export { createChalkServerClient } from "./client.js";
-export { ChalkAPIError, ChalkServerOnlyError } from "./errors.js";
+export { ChalkAPIError, ChalkServerOnlyError, isChalkAccessGrantError, type ChalkAccessGrantErrorCode } from "./errors.js";
 export type { APIKey, APIKeyList, APIKeyWithSecret, AdmitParticipantInput, ChalkIdempotencyOptions, ChalkServerClient, ChalkServerClientOptions, ChalkServerHeaders, CreateAPIKeyInput, CreateEpisodeInput, CreateRecordingDownloadURLInput, CreateSpaceInput, Episode, EpisodeEnd, IssueAccessGrantInput, ListPublicAdmissionRequestsInput, ListRecordingsInput, ListAPIKeysInput, ListSpacesInput, AccessGrant, ParticipantLifecycle, ParticipantRemoval, PublicAdmissionRequest, PublicAdmissionRequestPage, Recording, RecordingDownloadURL, RecordingExport, RecordingExportRequestAcceptedResponse, RecordingExportStatus, RecordingList, RecordingSource, RecordingSourceStatus, RecordingPolicy, RemoveParticipantInput, RotateAPIKeyInput, Space, SpacePublicInvite, SpaceList, TranscriptionPolicy, UpdateSpaceInput, UpdateSpacePublicInviteInput, } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/server/index.js

@@ -2,8 +2,9 @@ import {
   ChalkAPIError,
   ChalkServerOnlyError,
   errorCode,
+  isChalkAccessGrantError,
   requestId
-} from "./chunk-C4XITY5U.js";
+} from "./chunk-XQOQTCUL.js";
 
 // src/access/base64-url.ts
 function decodeBase64Url(value) {
@@ -168,7 +169,7 @@ async function performAttempt(attempt, index) {
   const response = await fetchAttempt(attempt, index);
   if (response.status === attempt.input.expectedStatus) return decodeSuccess(response);
   if (canRetryResponse(response, attempt.retries, index)) return retryResponse(response, attempt, index);
-  throw await responseError(response);
+  throw await responseError(response, attempt.input.retry !== "never");
 }
 async function fetchAttempt(attempt, index) {
   try {
@@ -178,7 +179,7 @@ async function fetchAttempt(attempt, index) {
   }
 }
 async function retryTransport(attempt, index) {
-  if (index >= attempt.retries) throw new ChalkAPIError({ code: "network_error", retryable: true, status: 0 });
+  if (index >= attempt.retries) throw new ChalkAPIError({ code: "network_error", retryable: attempt.input.retry !== "never", status: 0 });
   await retryDelay(index);
   return fetchAttempt(attempt, index + 1);
 }
@@ -226,8 +227,8 @@ function setContentType(headers, hasBody) {
 function setOptionalHeader(headers, name, value) {
   if (value !== void 0) headers.set(name, value);
 }
-async function responseError(response) {
-  return new ChalkAPIError({ code: errorCode(await errorBody(response)), requestId: requestId(response.headers), retryable: retryableStatuses.has(response.status), status: response.status });
+async function responseError(response, retryable) {
+  return new ChalkAPIError({ code: errorCode(await errorBody(response)), requestId: requestId(response.headers), retryable: retryable && retryableStatuses.has(response.status), status: response.status });
 }
 async function errorBody(response) {
   try {
@@ -343,7 +344,8 @@ function createChalkServerClient(options) {
           path: `${tenantPath}/spaces/${segment(spaceId)}/episodes/${segment(episodeId)}/participants/${segment(participantId)}/access-grant`,
           body: accessGrantRequest(resolvedInput),
           expectedStatus: 201,
-          retry: resolvedInput.replaceMediaConnection === true ? "never" : "always"
+          // An expired token can cause replacement even without the explicit flag.
+          retry: "never"
         });
         return accessGrant(access);
       },
@@ -608,5 +610,6 @@ export {
   ChalkAPIError,
   ChalkServerOnlyError,
   createChalkServerClient,
-  getAccessRefreshState
+  getAccessRefreshState,
+  isChalkAccessGrantError
 };

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

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

package/dist/server/server-only.js

@@ -1,6 +1,6 @@
 import {
   ChalkServerOnlyError
-} from "./chunk-C4XITY5U.js";
+} from "./chunk-XQOQTCUL.js";
 
 // src/server/server-only.ts
 throw new ChalkServerOnlyError();

package/dist/server/transport.d.ts

@@ -10,4 +10,3 @@ export type ServerRequest = {
 };
 export declare function createServerRequester(options: ChalkServerClientOptions, apiKey: string, apiBaseURL: string, fetchImplementation: typeof globalThis.fetch): <T>(input: ServerRequest) => Promise<T>;
 export {};
-//# sourceMappingURL=transport.d.ts.map

package/dist/server/types.d.ts

@@ -326,4 +326,3 @@ export type ChalkServerClient = {
         deny(spaceId: string, requestHandle: string, options?: ChalkIdempotencyOptions): Promise<PublicAdmissionRequest>;
     };
 };
-//# sourceMappingURL=types.d.ts.map

package/dist/space-client/chat-controller-helpers.d.ts

@@ -12,4 +12,3 @@ export declare function chatMessageFor(message: ChalkChatMessage): ChatMessage;
 export declare function chatReceiptFor(receipt: ChalkChatReadReceipt): ChatReadReceipt;
 export declare function mergeChatMessage(messages: readonly ChatMessage[], existing: ChatMessage, incoming: ChatMessage): readonly ChatMessage[];
 export declare function compareChatSequence(left: string, right: string): number;
-//# sourceMappingURL=chat-controller-helpers.d.ts.map

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

@@ -33,4 +33,3 @@ export declare const makeChatController: (input: {
 }) => Effect.Effect<ChatControllerEffects, never, Scope.Scope>;
 export declare const makeChatControllerLayer: (input: Parameters<typeof makeChatController>[0]) => Layer.Layer<ChatControllerService, never, never>;
 export {};
-//# sourceMappingURL=chat-controller.d.ts.map

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

@@ -45,4 +45,3 @@ export declare function uploadFileEffect(file: ChatUploadFile, input: {
     readonly fetch: typeof globalThis.fetch;
 }): ClientEffect<ChatAttachment>;
 export type { ActiveReaction, ChatAttachment, ChatMessage, ChatReadReceipt, ChatSendInput, MediaRequestKind, Reaction };
-//# sourceMappingURL=controller-effects.d.ts.map

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

@@ -47,4 +47,3 @@ export declare class SpaceClientCore {
 }
 export declare function defaultSyncUrl(apiBaseUrl: string): string;
 export {};
-//# sourceMappingURL=core.d.ts.map

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

@@ -44,4 +44,3 @@ export declare function createEffectSpaceClient(options: SpaceClientOptions, pla
 export declare function effectClientFromCore(core: SpaceClientCore, dispose?: () => Effect.Effect<void, unknown>): EffectSpaceClient;
 export type { SpaceClientPlatform } from "./core";
 export type { ChalkChatPageResult, ChalkDirectedRequestResult, MediaRequestKind, Reaction, ActiveReaction };
-//# sourceMappingURL=effect.d.ts.map

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

@@ -1,11 +1,13 @@
+import type { ConnectionError } from "../connection/types";
 import type { ClientFailure, ErrorCode } from "./types";
 declare const SpaceClientError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "SpaceClientError";
 } & Readonly<A>;
 export declare class SpaceClientError extends SpaceClientError_base<ClientFailure> {
 }
-export declare function normalizeClientError(cause: unknown, fallback?: ErrorCode): SpaceClientError;
+export declare function normalizeMediaError(cause: unknown): SpaceClientError;
+export declare function normalizeClientError(cause: unknown, fallback?: ErrorCode, scope?: "media"): SpaceClientError;
 export declare function failureFromError(error: SpaceClientError): ClientFailure;
 export declare function isAccessInvalid(cause: unknown): boolean;
+export declare function connectionErrorCode(code: ConnectionError["code"], action: ConnectionError["action"]): ErrorCode;
 export {};
-//# sourceMappingURL=errors.d.ts.map

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

@@ -1,7 +1,6 @@
 export { SpaceClientError } from "./errors";
 export { createSpaceClient } from "./space-client";
 export type { AccessGrant } from "../access/grant";
-export type { AccessContext, AccessGrantSource, AccessReason, ActiveReaction, AdmissionRequest, Capability, ChatAttachment, ChatController, ChatFilesController, ChatMessage, ChatReactionInput, ChatReaction, ChatReactions, ChatReadReceipt, ChatSendInput, ChatSlice, ChatUploadFile, ClientEventHandler, ClientEventMap, ClientEventName, ClientFailure, ConnectionSlice, ConnectionStatus, EpisodeSummary, ErrorCode, GetAccess, IncomingMediaRequest, JoinOptions, LocalMedia, Logger, OfflineAction, OfflineActionKind, OfflineActionsPolicy, OfflineController, OfflineSlice, MediaController, MediaDevice, MediaRequestKind, MediaSlice, Participant, PendingChatSend, ParticipantPresence, ParticipantsController, ParticipantsSlice, Reaction, Recording, RecordingController, RecordingSlice, ReactionsController, ReactionsSlice, RemoteMedia, SelfSlice, ScreenShareOptions, ScreenShareSurface, ScreenShareCapture, SpaceClient, SpaceClientOptions, SpaceSnapshot, WhiteboardController, WhiteboardSlice, } from "./types";
+export type { AccessContext, AccessGrantSource, AccessReason, ActiveReaction, AdmissionRequest, Capability, CameraPreview, ChatAttachment, ChatController, ChatFilesController, ChatMessage, ChatReactionInput, ChatReaction, ChatReactions, ChatReadReceipt, ChatSendInput, ChatSlice, ChatUploadFile, ClientEventHandler, ClientEventMap, ClientEventName, ClientFailure, ConnectionSlice, ConnectionStatus, EpisodeSummary, ErrorCode, GetAccess, IncomingMediaRequest, JoinOptions, LocalMedia, Logger, OfflineAction, OfflineActionKind, OfflineActionsPolicy, OfflineController, OfflineSlice, MediaController, MediaDevice, MediaRequestKind, MediaSlice, Participant, PendingChatSend, ParticipantPresence, ParticipantsController, ParticipantsSlice, Reaction, Recording, RecordingController, RecordingSlice, ReactionsController, ReactionsSlice, RemoteMedia, SelfSlice, ScreenShareOptions, ScreenShareSurface, ScreenShareCapture, SpaceClient, SpaceClientOptions, SpaceSnapshot, WhiteboardController, WhiteboardSlice, } from "./types";
 export { reloadRejoinAccess, readReloadRejoin, writeReloadRejoin, resumeReloadRejoin, reloadRejoinStorageKey } from "./reload-rejoin";
 export type { ReloadRejoinMarker } from "./reload-rejoin";
-//# sourceMappingURL=index.d.ts.map

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

@@ -3,7 +3,7 @@ import type { ConnectionLifecycleCapability } from "../connection";
 import { SpaceClientError } from "./errors";
 import type { MediaDeviceSelection } from "./media-device-selection";
 import { SpaceStore } from "./store";
-import type { ScreenShareOptions } from "./types";
+import type { CameraPreview, ScreenShareOptions } from "./types";
 type ClientEffect<A> = Effect.Effect<A, SpaceClientError>;
 export type MediaControllerEffects = {
     readonly configure: (intent: Readonly<{
@@ -12,6 +12,8 @@ export type MediaControllerEffects = {
     }>) => void;
     readonly setMicrophoneEnabled: (enabled: boolean) => ClientEffect<void>;
     readonly setCameraEnabled: (enabled: boolean) => ClientEffect<void>;
+    /** Borrows the current camera or captures privately. The caller must release the preview. */
+    readonly captureCameraPreview: () => ClientEffect<CameraPreview>;
     readonly setScreenShareEnabled: (enabled: boolean, options?: ScreenShareOptions) => ClientEffect<void>;
     readonly selectMicrophone: (deviceId: string) => ClientEffect<void>;
     readonly selectCamera: (deviceId: string) => ClientEffect<void>;
@@ -27,4 +29,3 @@ export declare class MediaControllerService extends MediaControllerService_base
 export declare const makeMediaController: (connection: ConnectionLifecycleCapability, store: SpaceStore, selection: MediaDeviceSelection) => Effect.Effect<MediaControllerEffects, never, Clock.Clock | Scope.Scope>;
 export declare const makeMediaControllerLayer: (connection: ConnectionLifecycleCapability, store: SpaceStore, selection: MediaDeviceSelection) => Layer.Layer<MediaControllerService, never, Clock.Clock>;
 export {};
-//# sourceMappingURL=media-controller.d.ts.map

package/dist/space-client/media-device-selection.d.ts

@@ -10,4 +10,3 @@ export declare class MediaDeviceSelection implements ConnectionMediaDevices {
     selectSpeaker(deviceId: string): Promise<void>;
 }
 export {};
-//# sourceMappingURL=media-device-selection.d.ts.map

package/dist/space-client/offline-actions-storage.d.ts

@@ -78,4 +78,3 @@ export declare const decodeOfflineActions: (input: unknown, options?: import("ef
         } | undefined;
     }[];
 };
-//# sourceMappingURL=offline-actions-storage.d.ts.map

package/dist/space-client/offline-actions.d.ts

@@ -34,4 +34,3 @@ export declare const makeOfflineActions: (input: {
 }) => Effect.Effect<OfflineActionsControllerEffects & OfflineActionsHold, never, Scope.Scope>;
 export declare const makeOfflineActionsLayer: (input: Parameters<typeof makeOfflineActions>[0]) => Layer.Layer<OfflineActionsService, never, never>;
 export {};
-//# sourceMappingURL=offline-actions.d.ts.map

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

@@ -30,4 +30,3 @@ export declare class ParticipantsControllerService extends ParticipantsControlle
 export declare const makeParticipantsController: (connection: ConnectionLifecycleCapability, store: SpaceStore, offline?: OfflineActionsHold) => Effect.Effect<ParticipantsControllerEffects, never, import("effect").Scope.Scope>;
 export declare const makeParticipantsControllerLayer: (connection: ConnectionLifecycleCapability, store: SpaceStore) => Layer.Layer<ParticipantsControllerService, never, never>;
 export {};
-//# sourceMappingURL=participants-controller.d.ts.map

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

@@ -9,4 +9,3 @@ export type PromiseController<Controller extends Record<string, ControllerComman
 };
 export declare function toPromiseController<Controller extends Record<string, ControllerCommand>>(runtime: PromiseRuntime, controller: Controller): PromiseController<Omit<Controller, "configure" | "dispose">>;
 export {};
-//# sourceMappingURL=promise-facade.d.ts.map

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

@@ -15,4 +15,3 @@ export declare class ReactionsControllerService extends ReactionsControllerServi
 export declare const makeReactionsController: (connection: ConnectionLifecycleCapability, store: SpaceStore) => Effect.Effect<ReactionsControllerEffects, never, Clock.Clock | Scope.Scope>;
 export declare const makeReactionsControllerLayer: (connection: ConnectionLifecycleCapability, store: SpaceStore) => Layer.Layer<ReactionsControllerService, never, Clock.Clock>;
 export {};
-//# sourceMappingURL=reactions-controller.d.ts.map

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

@@ -16,4 +16,3 @@ export declare class RecordingControllerService extends RecordingControllerServi
 export declare const makeRecordingController: (connection: ConnectionLifecycleCapability, store: SpaceStore) => Effect.Effect<RecordingControllerEffects, never, import("effect").Scope.Scope>;
 export declare const makeRecordingControllerLayer: (connection: ConnectionLifecycleCapability, store: SpaceStore) => Layer.Layer<RecordingControllerService, never, never>;
 export {};
-//# sourceMappingURL=recording-controller.d.ts.map

package/dist/space-client/reload-rejoin.d.ts

@@ -21,4 +21,3 @@ export declare function writeReloadRejoin(storage: Pick<Storage, "setItem">, mar
 /** Refuse a fresh Episode or Participant even if an integration returns a new grant. */
 export declare function resumeReloadRejoin(marker: ReloadRejoinMarker, refresh: () => Promise<unknown>): Promise<AccessGrant>;
 export declare function reloadRejoinAccess(access: unknown): Pick<ReloadRejoinMarker, "episodeId" | "participantId" | "participantGeneration" | "mediaProof">;
-//# sourceMappingURL=reload-rejoin.d.ts.map

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

@@ -2,4 +2,3 @@ import { type SpaceClientPlatform } from "./core";
 import type { SpaceClient, SpaceClientOptions } from "./types";
 export declare function createSpaceClient(options: SpaceClientOptions): SpaceClient;
 export declare function createSpaceClientForPlatform(options: SpaceClientOptions, platform: SpaceClientPlatform): SpaceClient;
-//# sourceMappingURL=space-client.d.ts.map

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

@@ -28,4 +28,3 @@ export declare class SpaceStoreService extends SpaceStoreService_base {
 export declare const makeSpaceStoreLayer: Layer.Layer<SpaceStoreService, never, never>;
 export declare const makeFakeSpaceStoreLayer: (store?: SpaceStore) => Layer.Layer<SpaceStoreService, never, never>;
 export {};
-//# sourceMappingURL=store.d.ts.map

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

@@ -47,7 +47,7 @@ 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;
@@ -60,6 +60,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. */
@@ -228,6 +230,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 +283,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/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