@q9labsai/chalk-react-native 5.1.0 → 5.2.1

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## 5.2.0
+
+### confirmed-call-entry
+
+Count a person in a call only after they have fully entered it. The built-in
+browser and React Native Sync clients ask Sync for entry confirmation on the Sync
+URL (`entry_confirmation=1`). When Sync's `welcome` grants it, the client sends
+`entered` once Sync is live and media has started, so a failed connection no
+longer leaves a ghost participant or an attendance record. Against an older Sync,
+the client sends the previous hello and Sync confirms entry at hello as before.
+
+`confirmEntered()` on a custom `createSyncClient` implementation is optional.
+Implementing it, and building `V1SyncClient` with `entryConfirmation: true`, adds
+the confirmed entry above. Without it, the client never asks for entry
+confirmation and Sync confirms the entry at hello, as in 5.0.x. `V1SyncClient`
+asks only when it is built with `entryConfirmation: true`.
+
+When entry fails, the client cancels the pending admission through the new
+`cancelEpisodeParticipantJoin` endpoint (`POST .../participants/:participant_id/cancel-join`),
+and a retry keeps the same person. If Sync reports `entry timeout` because the
+pending seat expired before entry, the connection fails as a retryable
+`sync_start_failed` instead of rejected access, and the client does not reconnect
+the expired seat with the same grant.
+
+The admission contract declares the 409 `participant.not_active` response when
+a retried admission names a participant that has already left. The public
+`AdmitEpisodeParticipantError` union stays compatible with 5.1.0; this response
+uses the existing `HttpClientError` channel, with its code in the response body.
+The dashboard reads that code and retries once with a fresh join key.
+
+Sync assigns each entry a participant-local generation and returns it in
+`welcome`. The client resumes that generation through the `entry_generation`
+WebSocket query, even after refreshing its credential. Confirmation advances
+ownership only forward and voids older pending Leaves. Acceptance and completion
+both fence a Leave against the confirmed generation, so reattaching the same
+seat cannot let the previous mount remove it. Previous Sync ignores this query.
+Legacy sockets receive a server generation internally without changing their
+welcome frame, and still confirm at hello. Participants created before seat
+storage acquire it on their first live hello. When recovery replaces the Sync
+client, it confirms the replacement entry before reporting recovery complete.
+Completed startup also survives reconnecting from an older Sync to an upgraded
+one. Recovery can finish while a previous entry's Leave is pending, and an
+uncertain confirmation reply checks that entry's generation before acknowledging it.
+A claimed Leave blocks later entry
+admission until its provider work settles. An entry admitted before that claim
+defers the older provider work until confirmation or its two-minute startup
+lease expires, preventing old cleanup from closing the new entry's media.
+
+Rollout: apply the database migrations first, then upgrade Sync, then the API and
+this client. This client also works with an older Sync, and published 5.0.x
+clients keep hello confirmation with the new Sync.
+
 ## 5.1.0
 
 - Bound each Sync and whiteboard WebSocket opening attempt to the existing 30-second startup allowance, or to `syncStartupTimeoutMs` when set. `syncStartupTimeoutMs` accepts 1 to 60,000 ms, and each attempt gets at least 10 seconds. The whiteboard retries a timed-out attempt through the existing reconnect backoff, and so does Sync once the call is live, such as after a drop or a return to the foreground. A first join does not retry a Sync socket that never opens: the join fails when its startup wait of `syncStartupTimeoutMs` ends, and a setting below 10 seconds ends the join before the attempt's own 10-second minimum. The client's 10-second default does not apply to React Native.

package/dist/{chunk-4L5GXJ36.js → chunk-BXDD5BE4.js}

@@ -1,4 +1,5 @@
 // src/invites.ts
+import { parseInviteCode } from "@q9labsai/chalk-client/invites";
 var CHALK_INVITE_HOSTS = ["chalkmeet.com", "chalk.q9labs.ai"];
 var CHALK_CUSTOM_PROTOCOLS = /* @__PURE__ */ new Set(["chalk:", "ai.q9labs.chalk.mobile:"]);
 var SPACE_SLUG_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/u;
@@ -27,6 +28,26 @@ function parseSpaceInviteLink(input) {
     return null;
   }
 }
+function parseChalkInviteLink(input) {
+  const trimmed = input.trim();
+  const code = parseInviteCode(trimmed);
+  if (code) return { spaceInviteToken: code };
+  const legacy = parseSpaceInviteLink(trimmed);
+  if (legacy) return legacy;
+  const normalized = trimmed.includes("://") ? trimmed : CHALK_INVITE_HOSTS.some((host) => trimmed.startsWith(`${host}/`)) ? `https://${trimmed}` : null;
+  if (!normalized) return null;
+  try {
+    const parsed = new URL(normalized);
+    if (!CHALK_CUSTOM_PROTOCOLS.has(parsed.protocol) && !isAllowedWebInviteOrigin(parsed)) return null;
+    const pathSegments = parsed.pathname.split("/").filter(Boolean);
+    if (CHALK_CUSTOM_PROTOCOLS.has(parsed.protocol)) pathSegments.unshift(parsed.hostname);
+    if (pathSegments.length !== 1 || parsed.search || parsed.hash) return null;
+    const pathCode = parseInviteCode(decodeURIComponent(pathSegments[0] ?? ""));
+    return pathCode ? { spaceInviteToken: pathCode } : null;
+  } catch {
+    return null;
+  }
+}
 function isChalkInviteHost(hostname) {
   return CHALK_INVITE_HOSTS.some((host) => host === hostname);
 }
@@ -48,11 +69,12 @@ function getClipboardInviteSuggestion(clipboardText, currentInput = "") {
   if (normalizedClipboardText === currentInput.trim()) {
     return null;
   }
-  return parseSpaceInviteLink(normalizedClipboardText) ? normalizedClipboardText : null;
+  return parseChalkInviteLink(normalizedClipboardText) ? normalizedClipboardText : null;
 }
 
 export {
   parseSpaceInviteLink,
+  parseChalkInviteLink,
   extractSpaceInviteFromLink,
   getClipboardInviteSuggestion
 };

package/dist/{chunk-MBZRE4US.js → chunk-PPQSOU35.js}

@@ -507,11 +507,11 @@ function usePressAnimation(family) {
 
 // src/primitives/IconButton.tsx
 import { forwardRef, memo as memo2 } from "react";
-import { Pressable, StyleSheet, View } from "react-native";
+import { ActivityIndicator, Pressable, StyleSheet, View } from "react-native";
 import Animated, { useAnimatedStyle as useAnimatedStyle2 } from "react-native-reanimated";
 import { jsx as jsx5, jsxs } from "react/jsx-runtime";
 var IconButton = memo2(
-  forwardRef(function IconButton2({ icon, accessibilityLabel, onPress, size = 44, tone = "raised", selected = false, off = false, caption, expanded, onCanvas = false, disabled = false, testID }, ref) {
+  forwardRef(function IconButton2({ icon, accessibilityLabel, onPress, size = 44, tone = "raised", selected = false, off = false, caption, expanded, onCanvas = false, disabled = false, busy = false, testID }, ref) {
     const { colors, elevation } = useTheme();
     const press = usePressAnimation("round");
     const base = selected ? colors.text : BASE[tone](colors);
@@ -530,8 +530,8 @@ var IconButton = memo2(
       {
         accessibilityLabel,
         accessibilityRole: "button",
-        accessibilityState: { selected, disabled, expanded },
-        disabled,
+        accessibilityState: { selected, disabled: disabled || busy, expanded, busy },
+        disabled: disabled || busy,
         hitSlop: size < 44 ? (44 - size) / 2 : void 0,
         onPress,
         onPressIn: press.onPressIn,
@@ -539,7 +539,7 @@ var IconButton = memo2(
         ref,
         testID,
         children: [
-          /* @__PURE__ */ jsx5(Animated.View, { ref: roundRef, style: [roundStyle, background, press.scaleStyle], children: /* @__PURE__ */ jsx5(Icon, { color: iconColor, name: icon, size: tone === "ghost" ? 18 : 20 }) }),
+          /* @__PURE__ */ jsx5(Animated.View, { ref: roundRef, style: [roundStyle, background, press.scaleStyle], children: busy ? /* @__PURE__ */ jsx5(ActivityIndicator, { color: iconColor, size: "small" }) : /* @__PURE__ */ jsx5(Icon, { color: iconColor, name: icon, size: tone === "ghost" ? 18 : 20 }) }),
           caption ? /* @__PURE__ */ jsx5(View, { pointerEvents: "none", style: styles.captionBox, children: /* @__PURE__ */ jsx5(ChalkText, { numberOfLines: 1, tone: "textMuted", variant: "caption", children: caption }) }) : null
         ]
       }

package/dist/client.js

@@ -146,6 +146,7 @@ function createSyncClient(syncURL, input, lifecycle, webSocket, storage, dialTim
     lifecycle,
     webSocket,
     dialTimeoutMs,
+    entryConfirmation: true,
     ...storage ? { pendingStore: new AsyncStorageV1PendingTargetStore({ scope, storage }) } : {}
   });
 }

package/dist/components/EmbeddedWhiteboard.d.ts

@@ -1,6 +1,9 @@
-import { type ChalkEmbeddedWhiteboardTransport } from "@q9labsai/chalk-whiteboard/embedded";
+import { type ChalkEmbeddedWhiteboardTransport, type ChalkEmbeddedBoardContext } from "@q9labsai/chalk-whiteboard/embedded";
 import { type StyleProp, type ViewStyle } from "react-native";
 export interface EmbeddedWhiteboardProps {
+    readonly board: ChalkEmbeddedBoardContext;
+    readonly onFollow?: (participantId: string | null) => void;
+    readonly onCloseBoard?: () => void;
     readonly transport: ChalkEmbeddedWhiteboardTransport;
     readonly journeyId: string;
     readonly traceparent?: string;
@@ -27,14 +30,15 @@ export interface EmbeddedWhiteboardProps {
         readonly format: "png" | "svg";
         readonly mimeType: string;
         readonly dataURL: string;
-    }) => void;
+        readonly action?: "download" | "copy";
+    }) => void | Promise<void>;
 }
 export declare const embeddedWhiteboardWebViewSecurityPolicy: Readonly<{
     allowFileAccess: true;
     allowFileAccessFromFileURLs: false;
     allowUniversalAccessFromFileURLs: false;
     cacheEnabled: false;
-    domStorageEnabled: false;
+    domStorageEnabled: true;
     javaScriptCanOpenWindowsAutomatically: false;
     javaScriptEnabled: true;
     mixedContentMode: "never";
@@ -42,4 +46,4 @@ export declare const embeddedWhiteboardWebViewSecurityPolicy: Readonly<{
     sharedCookiesEnabled: false;
     thirdPartyCookiesEnabled: false;
 }>;
-export declare function EmbeddedWhiteboard({ transport, journeyId, traceparent, tracestate, canDraw, canClear, theme: themeOverride, localParticipantColor, rendererURL: rendererURLOverride, style, testID, onMetric, onError, onUserExport }: EmbeddedWhiteboardProps): React.JSX.Element;
+export declare function EmbeddedWhiteboard({ board, onFollow, onCloseBoard, transport, journeyId, traceparent, tracestate, canDraw, canClear, theme: themeOverride, localParticipantColor, rendererURL: rendererURLOverride, style, testID, onMetric, onError, onUserExport, }: EmbeddedWhiteboardProps): React.JSX.Element;

package/dist/frame/call-controls.d.ts

@@ -0,0 +1,2 @@
+/** Landscape controls overlay the stage, so board tools need room above them. */
+export declare const LandscapeControlsContext: import("react").Context<boolean>;

package/dist/frame/use-landscape-chrome.d.ts

@@ -0,0 +1,8 @@
+/** A visible board stays interactive instead of acquiring the tap-to-reveal overlay. */
+export declare function useLandscapeChrome({ fades, boardVisible }: {
+    readonly fades: boolean;
+    readonly boardVisible: boolean;
+}): {
+    hidden: boolean;
+    show: () => void;
+};

package/dist/index.d.ts

@@ -7,6 +7,6 @@ export type { ColorScheme, Palette } from "./theme/tokens";
 export { ChalkProvider, useSpaceClient } from "./context/space-client-context";
 export type { ChalkProviderProps } from "./context/space-client-context";
 export { useCan, useChat, useConnection, useMedia, useParticipants, useReactions, useRecording, useSelf, useWhiteboard } from "./hooks/space-hooks";
-export { extractSpaceInviteFromLink, getClipboardInviteSuggestion, parseSpaceInviteLink } from "./invites";
-export type { SpaceInviteLink } from "./invites";
+export { extractSpaceInviteFromLink, getClipboardInviteSuggestion, parseChalkInviteLink, parseSpaceInviteLink } from "./invites";
+export type { ChalkInviteLink, SpaceInviteLink } from "./invites";
 export { buildChalkInviteLink } from "./utils/build-chalk-invite-link";