@q9labsai/chalk-react-native 4.1.17 → 5.0.1

package/src/feedback/native-evidence.ts

@@ -1,37 +0,0 @@
-import type { FeedbackEvidenceInput, FeedbackPlatformKind } from "@q9labsai/chalk-client";
-import { Platform } from "react-native";
-
-import { getDeviceInfo } from "../runtime";
-
-export function createNativeFeedbackEvidence(): FeedbackEvidenceInput {
-  const device = getDeviceInfo({ scriptUrl: null });
-  const kind = feedbackPlatformKind(Platform.OS);
-  const osName = boundedString(device.systemName ?? device.platform ?? kind);
-  const osVersion = boundedString(device.osVersion);
-  const deviceModel = boundedString(device.model);
-  const reactNativeVersion = boundedString(device.reactNativeVersion);
-  const deviceClass = kind === "macos" ? "desktop" : device.interfaceIdiom === "pad" ? "tablet" : "phone";
-
-  return {
-    sdk: { client: "@q9labsai/chalk-client", ...(reactNativeVersion ? { react_native: reactNativeVersion } : {}) },
-    platform: {
-      kind,
-      ...(osName ? { os_name: osName } : {}),
-      ...(osVersion ? { os_version: osVersion } : {}),
-      device_class: deviceClass,
-      ...(deviceModel ? { device_model: deviceModel } : {}),
-    },
-  };
-}
-
-function feedbackPlatformKind(platform: string): FeedbackPlatformKind {
-  if (platform === "ios") return "ios";
-  if (platform === "macos") return "macos";
-  return "android";
-}
-
-function boundedString(value: string | null): string | undefined {
-  const normalized = value?.trim();
-  if (!normalized) return undefined;
-  return normalized.slice(0, 64);
-}

package/src/hooks/entrance-preview-store.ts

@@ -1,99 +0,0 @@
-import type { NativeMediaStream } from "../media/native-webrtc";
-import type { ExternalStore } from "./external-store";
-
-export interface PreviewSnapshot {
-  readonly previewStream: NativeMediaStream | null;
-  readonly previewError: string | null;
-}
-
-export type EntrancePreviewStore = ExternalStore<PreviewSnapshot>;
-
-interface EntrancePreviewStoreOptions {
-  readonly enabled: boolean;
-  readonly simulatorVideoDisabled: boolean;
-  readonly simulatorVideoMessage: string;
-  readonly getUserMedia: (constraints: unknown) => Promise<NativeMediaStream>;
-}
-
-function stopPreviewTracks(stream: NativeMediaStream | null): void {
-  stream?.getTracks?.().forEach((track) => {
-    try {
-      track.stop();
-    } catch {
-      // Best effort only.
-    }
-  });
-}
-
-export function createEntrancePreviewStore(options: EntrancePreviewStoreOptions): EntrancePreviewStore {
-  const initialSnapshot: PreviewSnapshot = {
-    previewStream: null,
-    previewError: options.enabled && options.simulatorVideoDisabled ? options.simulatorVideoMessage : null,
-  };
-  let snapshot = initialSnapshot;
-  let activeStream: NativeMediaStream | null = null;
-  let requestGeneration = 0;
-  const listeners = new Set<() => void>();
-
-  const notify = (): void => {
-    listeners.forEach((listener) => listener());
-  };
-
-  const reset = (): void => {
-    requestGeneration += 1;
-    stopPreviewTracks(activeStream);
-    activeStream = null;
-    snapshot = initialSnapshot;
-  };
-
-  const start = (): void => {
-    if (!options.enabled || options.simulatorVideoDisabled) return;
-
-    const generation = ++requestGeneration;
-    void options
-      .getUserMedia({ audio: false, video: { facingMode: "user" } })
-      .then((stream) => {
-        if (generation !== requestGeneration) {
-          stopPreviewTracks(stream);
-          return;
-        }
-
-        const videoTrack = stream.getVideoTracks?.()[0] ?? null;
-        if (!videoTrack) {
-          stopPreviewTracks(stream);
-          snapshot = { previewStream: null, previewError: "No camera track available" };
-          notify();
-          return;
-        }
-
-        stopPreviewTracks(activeStream);
-        activeStream = stream;
-        snapshot = { previewStream: stream, previewError: null };
-        notify();
-      })
-      .catch((cause: unknown) => {
-        if (generation !== requestGeneration) return;
-        snapshot = {
-          previewStream: null,
-          previewError: cause instanceof Error ? cause.message : "Unable to start camera preview",
-        };
-        notify();
-      });
-  };
-
-  const subscribe = (listener: () => void): (() => void) => {
-    listeners.add(listener);
-    if (listeners.size === 1) start();
-
-    return () => {
-      listeners.delete(listener);
-      if (listeners.size !== 0) return;
-      reset();
-    };
-  };
-
-  return {
-    getSnapshot: () => snapshot,
-    subscribe,
-  };
-}

package/src/hooks/useEntrancePreview.ts

@@ -1,26 +0,0 @@
-import { mediaDevices, type NativeMediaStream } from "../media/native-webrtc";
-import { useMemo, useSyncExternalStore } from "react";
-import { getIosSimulatorVideoMessage, isIosSimulator } from "../utils/ios-simulator";
-import { createEntrancePreviewStore } from "./entrance-preview-store";
-
-export interface UseEntrancePreviewReturn {
-  previewStream: NativeMediaStream | null;
-  previewError: string | null;
-}
-
-export function useEntrancePreview(enabled: boolean): UseEntrancePreviewReturn {
-  const simulatorVideoDisabled = isIosSimulator();
-  const store = useMemo(
-    () =>
-      createEntrancePreviewStore({
-        enabled,
-        simulatorVideoDisabled,
-        simulatorVideoMessage: getIosSimulatorVideoMessage(),
-        getUserMedia: mediaDevices.getUserMedia,
-      }),
-    [enabled, simulatorVideoDisabled],
-  );
-  const { previewStream, previewError } = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
-
-  return { previewStream, previewError };
-}

package/src/hooks/useLayout.ts

@@ -1,37 +0,0 @@
-import { useCallback, useEffect, useState } from "react";
-
-import type { Layout } from "../ui/native-types";
-
-export interface UseLayoutReturn {
-  readonly layout: Layout;
-  readonly isMobileView: boolean;
-  readonly isFullscreen: boolean;
-  readonly setLayout: (layout: Layout) => void;
-  readonly toggleLayout: () => void;
-  readonly toggleFullscreen: () => Promise<void>;
-}
-
-type UseLayoutOptions = {
-  readonly layout?: Layout;
-  readonly onLayoutChange?: (layout: Layout) => void;
-};
-
-export function useLayout({ layout: controlledLayout, onLayoutChange }: UseLayoutOptions = {}): UseLayoutReturn {
-  const [uncontrolledLayout, setUncontrolledLayout] = useState<Layout>(controlledLayout ?? "focus");
-  const [isFullscreen, setFullscreen] = useState(false);
-  const layout = controlledLayout ?? uncontrolledLayout;
-  useEffect(() => {
-    if (controlledLayout) setUncontrolledLayout(controlledLayout);
-  }, [controlledLayout]);
-  const setLayout = useCallback(
-    (nextLayout: Layout) => {
-      if (!controlledLayout) setUncontrolledLayout(nextLayout);
-      onLayoutChange?.(nextLayout);
-    },
-    [controlledLayout, onLayoutChange],
-  );
-  const toggleLayout = useCallback(() => setLayout(layout === "grid" ? "focus" : "grid"), [layout, setLayout]);
-  const toggleFullscreen = useCallback(async () => setFullscreen((current) => !current), []);
-
-  return { layout, isMobileView: true, isFullscreen, setLayout, toggleLayout, toggleFullscreen };
-}

package/src/hooks/usePanels.ts

@@ -1,30 +0,0 @@
-import { useCallback, useState } from "react";
-
-import type { NativePanel } from "../ui/native-types";
-
-export interface UsePanelsReturn {
-  readonly activePanel: NativePanel;
-  readonly controlsVisible: boolean;
-  readonly openPanel: (panel: NativePanel) => void;
-  readonly closePanel: () => void;
-  readonly togglePanel: (panel: Exclude<NativePanel, null>) => void;
-  readonly showControls: () => void;
-  readonly hideControls: () => void;
-}
-
-export function usePanels(): UsePanelsReturn {
-  const [activePanel, setActivePanel] = useState<NativePanel>(null);
-  const [controlsVisible, setControlsVisible] = useState(true);
-  const closePanel = useCallback(() => setActivePanel(null), []);
-  const togglePanel = useCallback((panel: Exclude<NativePanel, null>) => setActivePanel((current) => (current === panel ? null : panel)), []);
-
-  return {
-    activePanel,
-    controlsVisible,
-    openPanel: setActivePanel,
-    closePanel,
-    togglePanel,
-    showControls: () => setControlsVisible(true),
-    hideControls: () => setControlsVisible(false),
-  };
-}

package/src/ios-pad.ts

@@ -1 +0,0 @@
-export * from "./index";

package/src/ios-phone.ts

@@ -1 +0,0 @@
-export * from "./index";

package/src/ios.ts

@@ -1 +0,0 @@
-export * from "./index";

package/src/macos.ts

@@ -1 +0,0 @@
-export * from "./index";

package/src/space-client/cloudflare-rtk-native.ts

@@ -1,104 +0,0 @@
-import type RealtimeKitClient from "@cloudflare/realtimekit-react-native";
-import type { CloudflareRTKClientFactory, CloudflareRTKConnection, CloudflareRTKParticipant } from "@q9labsai/chalk-client";
-
-type NativeRealtimeKitClient = Awaited<ReturnType<typeof RealtimeKitClient.init>>;
-type NativeRealtimeKitParticipant = ReturnType<NativeRealtimeKitClient["participants"]["joined"]["toArray"]>[number];
-
-export const createNativeRealtimeKitClient: CloudflareRTKClientFactory = async ({ authToken, onError }) => {
-  const { default: NativeRealtimeKitClient } = await import("@cloudflare/realtimekit-react-native");
-  const client = await NativeRealtimeKitClient.init({
-    authToken,
-    defaults: { audio: false, video: false },
-    onError,
-  });
-  return adaptNativeRealtimeKitClient(client);
-};
-
-function adaptNativeRealtimeKitClient(client: NativeRealtimeKitClient): CloudflareRTKConnection {
-  const self = client.self;
-  return {
-    join: () => client.joinRoom(),
-    leave: () => client.leaveRoom(),
-    self: {
-      get peerId() {
-        return self.peerId;
-      },
-      get audioEnabled() {
-        return self.audioEnabled;
-      },
-      get videoEnabled() {
-        return self.videoEnabled;
-      },
-      get screenShareEnabled() {
-        return self.screenShareEnabled;
-      },
-      get audioTrack() {
-        return self.audioTrack ?? null;
-      },
-      get videoTrack() {
-        return self.videoTrack ?? null;
-      },
-      get screenShareTracks() {
-        return {
-          ...(self.screenShareTracks.audio ? { audio: self.screenShareTracks.audio } : {}),
-          ...(self.screenShareTracks.video ? { video: self.screenShareTracks.video } : {}),
-        };
-      },
-      enableAudio: () => self.enableAudio(),
-      enableVideo: () => self.enableVideo(),
-      enableScreenShare: () => self.enableScreenShare(),
-      disableAudio: () => self.disableAudio(),
-      disableVideo: () => self.disableVideo(),
-      disableScreenShare: () => self.disableScreenShare(),
-      onAudioUpdate: (listener) => {
-        self.on("audioUpdate", listener);
-        return () => self.off("audioUpdate", listener);
-      },
-      onVideoUpdate: (listener) => {
-        self.on("videoUpdate", listener);
-        return () => self.off("videoUpdate", listener);
-      },
-      onScreenShareUpdate: (listener) => {
-        self.on("screenShareUpdate", listener);
-        return () => self.off("screenShareUpdate", listener);
-      },
-      onLeft: (listener) => {
-        const callback = () => listener();
-        self.on("roomLeft", callback);
-        return () => self.off("roomLeft", callback);
-      },
-    },
-    participants: {
-      joined: {
-        list: () => client.participants.joined.toArray().map(toParticipant),
-        onJoined: (listener) => {
-          const callback = (participant: NativeRealtimeKitParticipant) => listener(toParticipant(participant));
-          client.participants.joined.on("participantJoined", callback);
-          return () => client.participants.joined.off("participantJoined", callback);
-        },
-        onLeft: (listener) => {
-          const callback = (participant: NativeRealtimeKitParticipant) => listener(toParticipant(participant));
-          client.participants.joined.on("participantLeft", callback);
-          return () => client.participants.joined.off("participantLeft", callback);
-        },
-      },
-    },
-  };
-}
-
-function toParticipant(participant: NativeRealtimeKitParticipant): CloudflareRTKParticipant {
-  return {
-    id: participant.id,
-    userId: participant.userId,
-    ...(participant.customParticipantId === undefined ? {} : { customParticipantId: participant.customParticipantId }),
-    audioEnabled: participant.audioEnabled,
-    videoEnabled: participant.videoEnabled,
-    screenShareEnabled: participant.screenShareEnabled,
-    audioTrack: participant.audioTrack ?? null,
-    videoTrack: participant.videoTrack ?? null,
-    screenShareTracks: {
-      ...(participant.screenShareTracks.audio ? { audio: participant.screenShareTracks.audio } : {}),
-      ...(participant.screenShareTracks.video ? { video: participant.screenShareTracks.video } : {}),
-    },
-  };
-}

package/src/telemetry.ts

@@ -1,234 +0,0 @@
-import { syncTelemetryCorrelation, type DiagnosticObservation, type JourneyTelemetryContext, type RtcConnectionStateSnapshot, type RtcStatsLike, type SyncFrameObservation } from "@q9labsai/chalk-client/telemetry";
-
-export interface TelemetryJourney {
-  readonly context: JourneyTelemetryContext;
-  readonly headers: Readonly<Record<string, string>>;
-  /** Internal native bridge; callers must not inspect or derive media credentials. */
-  readonly setAuthenticatedTelemetryHeaders?: (headers: Readonly<Record<string, string>> | undefined) => void;
-  recordDiagnostic(observation: DiagnosticObservation): unknown;
-  recordRtcSummary(connection: RtcConnectionStateSnapshot, stats: Iterable<RtcStatsLike>): unknown;
-  recordSyncFrame(observation: SyncFrameObservation): unknown;
-}
-
-export interface WhiteboardMetric {
-  readonly name: string;
-  readonly value: number;
-  readonly attributes?: Readonly<Record<string, string | number | boolean>>;
-}
-
-export interface ConnectionTelemetry {
-  readonly apiHeaders: Readonly<Record<string, string>>;
-  readonly context: JourneyTelemetryContext;
-  readonly syncCorrelation: ReturnType<typeof syncTelemetryCorrelation>;
-}
-
-export interface RtcPeerConnection {
-  readonly connectionState?: string;
-  readonly iceConnectionState?: string;
-  readonly signalingState?: string;
-  addEventListener(type: NativeRtcStateEvent, listener: () => void): void;
-  getStats(): Promise<unknown>;
-  removeEventListener(type: NativeRtcStateEvent, listener: () => void): void;
-}
-
-type NativeRtcStateEvent = "connectionstatechange" | "iceconnectionstatechange" | "signalingstatechange";
-
-const rtcStateEvents: readonly NativeRtcStateEvent[] = ["connectionstatechange", "iceconnectionstatechange", "signalingstatechange"];
-
-export interface Telemetry {
-  readonly connection: ConnectionTelemetry;
-  observePeerConnection(peerConnection: RtcPeerConnection): () => void;
-  recordSyncFrame(observation: SyncFrameObservation): void;
-  recordWhiteboardMetric(metric: WhiteboardMetric): void;
-}
-
-export interface NativeJourneyContext {
-  readonly journeyId: string;
-  readonly traceparent: string;
-  readonly tracestate?: string;
-  readonly recordWhiteboardMetric: (metric: WhiteboardMetric) => void;
-}
-
-const nativeJourneyContexts = new WeakMap<object, NativeJourneyContext>();
-
-type NativeTelemetryClient = {
-  readonly getSnapshot: () => { readonly connection: { readonly status: string } };
-  readonly subscribe: (listener: () => void) => () => void;
-  readonly dispose: () => void;
-};
-
-export async function authenticatedNativeCredential(credential: () => Promise<string>, journey: TelemetryJourney | undefined): Promise<string> {
-  const value = await credential();
-  try {
-    journey?.setAuthenticatedTelemetryHeaders?.({ Authorization: `Bearer ${value}` });
-  } catch {
-    // Telemetry exporters cannot interrupt an authenticated media request.
-  }
-  return value;
-}
-
-/** Binds authenticated-header cleanup to the private native client's terminal lifecycle. */
-export function bindNativeAuthenticatedTelemetry(client: NativeTelemetryClient, journey: TelemetryJourney | undefined): void {
-  const setHeaders = journey?.setAuthenticatedTelemetryHeaders;
-  if (!setHeaders) return;
-
-  const clear = () => {
-    try {
-      setHeaders(undefined);
-    } catch {
-      // Telemetry exporters cannot interrupt client teardown.
-    }
-  };
-  const onSnapshot = () => {
-    const status = client.getSnapshot().connection.status;
-    if (status === "idle" || status === "failed" || status === "left") clear();
-  };
-  const unsubscribe = client.subscribe(onSnapshot);
-  let disposed = false;
-  const originalDispose = client.dispose;
-  (client as NativeTelemetryClient & { dispose: () => void }).dispose = () => {
-    if (disposed) return;
-    disposed = true;
-    clear();
-    unsubscribe();
-    originalDispose();
-  };
-}
-
-export function registerNativeJourneyContext(client: object, journey: TelemetryJourney | undefined, telemetry: Telemetry | undefined): void {
-  if (!journey || !telemetry) return;
-  nativeJourneyContexts.set(client, {
-    journeyId: journey.context.journeyId,
-    traceparent: journey.context.traceparent,
-    ...(journey.context.tracestate ? { tracestate: journey.context.tracestate } : {}),
-    recordWhiteboardMetric: telemetry.recordWhiteboardMetric,
-  });
-}
-
-export function getNativeJourneyContext(client: object): NativeJourneyContext | undefined {
-  return nativeJourneyContexts.get(client);
-}
-
-/** Connects a typed journey to native API, WebSocket, and WebRTC boundaries without collecting raw media or network data. */
-export function createTelemetry(journey: TelemetryJourney): Telemetry {
-  const connection: ConnectionTelemetry = {
-    apiHeaders: journey.headers,
-    context: journey.context,
-    syncCorrelation: syncTelemetryCorrelation(journey.context),
-  };
-
-  return {
-    connection,
-    observePeerConnection(peerConnection) {
-      return observeNativeRtc(peerConnection, journey);
-    },
-    recordSyncFrame(observation) {
-      journey.recordSyncFrame(observation);
-    },
-    recordWhiteboardMetric(metric) {
-      journey.recordDiagnostic({
-        category: "whiteboard_renderer",
-        code: metric.name,
-        metricValue: metric.value,
-        phase: "media",
-        state: isFailedWhiteboardMetric(metric.name) ? "failed" : "observed",
-      });
-    },
-  };
-}
-
-export function syncTransportCloseDiagnostic(event: { readonly code?: unknown; readonly reason?: unknown }): DiagnosticObservation {
-  const code = typeof event.code === "number" ? event.code : null;
-  const reason = typeof event.reason === "string" ? event.reason : "";
-  return {
-    category: "network",
-    code: code === null ? "sync_websocket_closed_unknown" : `sync_websocket_closed_${code}_${syncCloseReason(reason)}`,
-    phase: "signaling",
-    state: code === 1000 ? "observed" : "failed",
-  };
-}
-
-function syncCloseReason(reason: string): string {
-  switch (reason) {
-    case "authentication failed":
-    case "heartbeat timeout":
-    case "hello timeout":
-    case "invalid token":
-    case "policy violation":
-    case "space actions unsupported":
-    case "text frames only":
-    case "transport error":
-      return reason.replaceAll(" ", "_");
-    default:
-      return reason ? "other" : "none";
-  }
-}
-
-function isFailedWhiteboardMetric(name: string): boolean {
-  return name.endsWith(".failure") || name.endsWith(".termination");
-}
-
-function observeNativeRtc(peerConnection: RtcPeerConnection, journey: TelemetryJourney): () => void {
-  let disposed = false;
-  const dispose = () => {
-    if (disposed) return;
-    disposed = true;
-    for (const event of rtcStateEvents) peerConnection.removeEventListener(event, capture);
-  };
-  const capture = () => {
-    void peerConnection
-      .getStats()
-      .then((stats) => journey.recordRtcSummary(rtcConnectionState(peerConnection), rtcStats(stats)))
-      .catch(() => undefined);
-    if (peerConnection.connectionState === "closed") dispose();
-  };
-
-  for (const event of rtcStateEvents) peerConnection.addEventListener(event, capture);
-  capture();
-
-  return dispose;
-}
-
-function rtcConnectionState(peerConnection: RtcPeerConnection): RtcConnectionStateSnapshot {
-  return {
-    connectionState: peerConnection.connectionState,
-    iceConnectionState: peerConnection.iceConnectionState,
-    signalingState: peerConnection.signalingState,
-  };
-}
-
-function rtcStats(stats: unknown): readonly RtcStatsLike[] {
-  if (Array.isArray(stats)) return stats.filter(isRtcStatsLike);
-  if (isIterable(stats)) return Array.from(stats, statsValue).filter(isRtcStatsLike);
-  if (hasForEach(stats)) return forEachStats(stats);
-  if (isObject(stats)) return Object.values(stats).filter(isRtcStatsLike);
-  return [];
-}
-
-function isIterable(value: unknown): value is Iterable<unknown> {
-  return isObject(value) && Symbol.iterator in value;
-}
-
-function hasForEach(value: unknown): value is { forEach(callback: (entry: unknown) => void): void } {
-  return isObject(value) && "forEach" in value && typeof value.forEach === "function";
-}
-
-function forEachStats(stats: { forEach(callback: (entry: unknown) => void): void }): RtcStatsLike[] {
-  const entries: RtcStatsLike[] = [];
-  stats.forEach((entry) => {
-    if (isRtcStatsLike(entry)) entries.push(entry);
-  });
-  return entries;
-}
-
-function statsValue(entry: unknown): unknown {
-  return Array.isArray(entry) ? entry[1] : entry;
-}
-
-function isRtcStatsLike(value: unknown): value is RtcStatsLike {
-  return isObject(value) && typeof value.type === "string";
-}
-
-function isObject(value: unknown): value is Record<PropertyKey, unknown> {
-  return typeof value === "object" && value !== null;
-}

package/src/types/hugeicons-direct.d.ts

@@ -1,4 +0,0 @@
-declare module "@hugeicons/core-free-icons/dist/esm/*" {
-  const icon: any;
-  export default icon;
-}

package/src/types/react-native-safe-area-context.d.ts

@@ -1,8 +0,0 @@
-declare module "react-native-safe-area-context" {
-  export function useSafeAreaInsets(): {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-  };
-}