@q9labsai/chalk-react-native 4.1.5 → 4.1.8

package/dist/macos.js

@@ -2,6 +2,7 @@ import {
   Chalk,
   ChalkProvider,
   Entrance,
+  buildChalkInviteLink,
   useCan,
   useChat,
   useConnection,
@@ -11,7 +12,7 @@ import {
   useSelf,
   useSpaceClient,
   useWhiteboard
-} from "./chunk-5HETUU73.js";
+} from "./chunk-MMBE2BVK.js";
 import {
   THEME_PALETTES,
   THEME_TEXTURES,
@@ -23,7 +24,12 @@ import {
   Theme,
   createNativeTheme
 } from "./chunk-JB4LNWVP.js";
-import "./chunk-HXYIJ75K.js";
+import "./chunk-LZ67SXGB.js";
+import {
+  extractSpaceInviteFromLink,
+  getClipboardInviteSuggestion,
+  parseSpaceInviteLink
+} from "./chunk-4L5GXJ36.js";
 export {
   Chalk,
   ChalkProvider,
@@ -31,9 +37,13 @@ export {
   THEME_PALETTES,
   THEME_TEXTURES,
   Theme,
+  buildChalkInviteLink,
   createNativeTheme,
+  extractSpaceInviteFromLink,
+  getClipboardInviteSuggestion,
   getThemeMode,
   isDarkThemePalette,
+  parseSpaceInviteLink,
   resolveNativeAppearance,
   useCan,
   useChat,

package/dist/space-client/cloudflare-rtk-native.d.ts

@@ -0,0 +1,3 @@
+import type { CloudflareRTKClientFactory } from "@q9labsai/chalk-client";
+export declare const createNativeRealtimeKitClient: CloudflareRTKClientFactory;
+//# sourceMappingURL=cloudflare-rtk-native.d.ts.map

package/dist/space-client/cloudflare-rtk-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-rtk-native.d.ts","sourceRoot":"","sources":["../../src/space-client/cloudflare-rtk-native.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAqD,MAAM,wBAAwB,CAAC;AAK5H,eAAO,MAAM,6BAA6B,EAAE,0BAQ3C,CAAC"}

package/dist/space-client/create-native-space-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-native-space-client.d.ts","sourceRoot":"","sources":["../../src/space-client/create-native-space-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAWL,KAAK,SAAS,EAGd,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,OAAO,EAAwK,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAQ3N,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CACvC,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,WAAW,CAgDtF"}
+{"version":3,"file":"create-native-space-client.d.ts","sourceRoot":"","sources":["../../src/space-client/create-native-space-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAYL,KAAK,SAAS,EAGd,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,OAAO,EAAwK,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAU3N,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CACvC,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,WAAW,CAgDtF"}

package/dist/utils/build-chalk-invite-link.d.ts

@@ -1,2 +1,2 @@
-export declare function buildChalkInviteLink(joinToken: string, origin?: string): string;
+export declare function buildChalkInviteLink(spaceSlug: string, spaceInviteToken: string, origin?: string): string;
 //# sourceMappingURL=build-chalk-invite-link.d.ts.map

package/dist/utils/build-chalk-invite-link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-chalk-invite-link.d.ts","sourceRoot":"","sources":["../../src/utils/build-chalk-invite-link.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAuB,GAAG,MAAM,CAE7F"}
+{"version":3,"file":"build-chalk-invite-link.d.ts","sourceRoot":"","sources":["../../src/utils/build-chalk-invite-link.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,SAAuB,GAAG,MAAM,CAIvH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q9labsai/chalk-react-native",
-  "version": "4.1.5",
+  "version": "4.1.8",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -150,9 +150,9 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@q9labsai/chalk-client": "^4.1.5",
-    "@q9labsai/chalk-whiteboard": "^4.1.5",
-    "@q9labsai/facehash": "^4.1.5"
+    "@q9labsai/chalk-client": "^4.1.8",
+    "@q9labsai/chalk-whiteboard": "^4.1.8",
+    "@q9labsai/facehash": "^4.1.8"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
@@ -162,6 +162,7 @@
   },
   "peerDependencies": {
     "@cloudflare/react-native-webrtc": "~125.0.1 || ~125.0.3",
+    "@cloudflare/realtimekit-react-native": "1.1.0",
     "@hugeicons/core-free-icons": "^4.0.0",
     "@hugeicons/react-native": "^1.0.13",
     "react": "^18.0.0 || ^19.0.0",
@@ -170,9 +171,9 @@
     "react-native-webview": "^13.16.1"
   },
   "scripts": {
-    "build": "rm -rf ./dist && tsup ./src/index.ts ./src/client.ts ./src/android.ts ./src/ios.ts ./src/ios-phone.ts ./src/ios-pad.ts ./src/macos.ts ./src/runtime.ts ./src/clipboard.ts ./src/diagnostics.ts ./src/invites.ts ./src/ui/theme.ts ./src/ui/appearance.ts --format esm --out-dir ./dist --platform browser --external react --external react-native --external react-native-webview --external @q9labsai/chalk-whiteboard --external @cloudflare/react-native-webrtc && pnpm run build:types && pnpm run sync:whiteboard-assets",
+    "build": "rm -rf ./dist && tsup ./src/index.ts ./src/client.ts ./src/android.ts ./src/ios.ts ./src/ios-phone.ts ./src/ios-pad.ts ./src/macos.ts ./src/runtime.ts ./src/clipboard.ts ./src/diagnostics.ts ./src/invites.ts ./src/ui/theme.ts ./src/ui/appearance.ts --format esm --out-dir ./dist --platform browser --external react --external react-native --external react-native-webview --external @q9labsai/chalk-whiteboard --external @cloudflare/react-native-webrtc --external @cloudflare/realtimekit-react-native && pnpm run build:types && pnpm run sync:whiteboard-assets",
     "build:types": "rm -f tsconfig.tsbuildinfo && tsc --build tsconfig.json",
-    "dev": "tsup ./src/index.ts ./src/client.ts ./src/android.ts ./src/ios.ts ./src/ios-phone.ts ./src/ios-pad.ts ./src/macos.ts ./src/runtime.ts ./src/clipboard.ts ./src/diagnostics.ts ./src/invites.ts ./src/ui/theme.ts ./src/ui/appearance.ts --format esm --out-dir ./dist --platform browser --external react --external react-native --external react-native-webview --external @q9labsai/chalk-whiteboard --external @cloudflare/react-native-webrtc --watch",
+    "dev": "tsup ./src/index.ts ./src/client.ts ./src/android.ts ./src/ios.ts ./src/ios-phone.ts ./src/ios-pad.ts ./src/macos.ts ./src/runtime.ts ./src/clipboard.ts ./src/diagnostics.ts ./src/invites.ts ./src/ui/theme.ts ./src/ui/appearance.ts --format esm --out-dir ./dist --platform browser --external react --external react-native --external react-native-webview --external @q9labsai/chalk-whiteboard --external @cloudflare/react-native-webrtc --external @cloudflare/realtimekit-react-native --watch",
     "sync:whiteboard-assets": "node ./scripts/sync-whiteboard-assets.mjs",
     "test": "pnpm exec vitest run",
     "check-types": "tsc --project tsconfig.check-types.json --noEmit",

package/src/diagnostics.test.ts

@@ -9,12 +9,12 @@ describe("native diagnostics", () => {
     expect(buildDevDiagnosticsCopyText()).not.toContain("inviteToken");
   });
 
-  it("uses the broker as the single environment boundary", () => {
+  it("uses the public-invite API as the single environment boundary", () => {
     setDevDiagnosticsEnvironment({
-      brokerUrl: "http://localhost:8787/local-chalk",
+      apiBaseURL: "http://localhost:8787",
     });
     expect(getDevDiagnosticsState().environment.target).toBe("local");
-    expect(classifyTarget("https://chalkmeet.com/local-chalk")).toBe("production");
+    expect(classifyTarget("https://api.chalkmeet.com")).toBe("production");
   });
 
   it("records failures without legacy auth or transport state", () => {

package/src/diagnostics.ts

@@ -17,8 +17,8 @@ export interface DevDiagnosticsTimelineEntry {
 export interface DevDiagnosticsState {
   readonly enabled: boolean;
   readonly environment: {
+    readonly apiBaseURL: string | null;
     readonly buildProfile: string | null;
-    readonly brokerUrl: string | null;
     readonly target: "custom" | "local" | "production" | "unknown";
     readonly routeKind: string | null;
     readonly routeSpaceId: string | null;
@@ -40,10 +40,10 @@ const maximumTimelineItems = 120;
 const listeners = new Set<() => void>();
 let state = initialState();
 
-export function classifyTarget(brokerUrl: string | null | undefined): DevDiagnosticsState["environment"]["target"] {
-  if (!brokerUrl) return "unknown";
+export function classifyTarget(apiBaseURL: string | null | undefined): DevDiagnosticsState["environment"]["target"] {
+  if (!apiBaseURL) return "unknown";
   try {
-    const hostname = new URL(brokerUrl).hostname;
+    const hostname = new URL(apiBaseURL).hostname;
     if (["localhost", "127.0.0.1", "0.0.0.0"].includes(hostname)) return "local";
     if (hostname === "chalkmeet.com" || hostname.endsWith(".chalkmeet.com")) return "production";
     return "custom";
@@ -52,13 +52,13 @@ export function classifyTarget(brokerUrl: string | null | undefined): DevDiagnos
   }
 }
 
-export function resolveDevDiagnosticsMode({ isDevRuntime, brokerUrl }: { readonly isDevRuntime: boolean; readonly brokerUrl: string | null | undefined }): {
+export function resolveDevDiagnosticsMode({ isDevRuntime, apiBaseURL }: { readonly isDevRuntime: boolean; readonly apiBaseURL: string | null | undefined }): {
   readonly enabled: boolean;
   readonly buildProfile: "development" | "production";
 } {
   return {
     enabled: isDevRuntime,
-    buildProfile: isDevRuntime || classifyTarget(brokerUrl) === "local" ? "development" : "production",
+    buildProfile: isDevRuntime || classifyTarget(apiBaseURL) === "local" ? "development" : "production",
   };
 }
 
@@ -77,7 +77,7 @@ export function setDevDiagnosticsEnvironment(next: Partial<DevDiagnosticsState["
     environment: {
       ...current.environment,
       ...next,
-      target: next.brokerUrl ? classifyTarget(next.brokerUrl) : current.environment.target,
+      target: next.apiBaseURL ? classifyTarget(next.apiBaseURL) : current.environment.target,
     },
   }));
 }
@@ -145,8 +145,8 @@ function initialState(): DevDiagnosticsState {
   return {
     enabled: isDevelopmentRuntime,
     environment: {
+      apiBaseURL: null,
       buildProfile: null,
-      brokerUrl: null,
       target: "unknown",
       routeKind: null,
       routeSpaceId: null,

package/src/index.ts

@@ -6,5 +6,8 @@ export { ChalkProvider, useSpaceClient } from "./context/space-client-context";
 export type { ChalkProviderProps } from "./context/space-client-context";
 export { useCan, useChat, useConnection, useMedia, useParticipants, useReactions, useSelf, useWhiteboard } from "./hooks/space-hooks";
 export { Theme, createNativeTheme } from "./ui/theme";
+export { extractSpaceInviteFromLink, getClipboardInviteSuggestion, parseSpaceInviteLink } from "./invites";
+export type { SpaceInviteLink } from "./invites";
+export { buildChalkInviteLink } from "./utils/build-chalk-invite-link";
 export { getThemeMode, isDarkThemePalette, resolveNativeAppearance, THEME_PALETTES, THEME_TEXTURES } from "./ui/appearance";
 export type { NativeAppearance, NativeAppearanceTokens, NativeShadowToken, NativeTextureBlendMode, NativeTextureDescriptor, NativeTextureKind, ThemeAppearance, ThemeMode, ThemePalette, ThemeTexture } from "./ui/appearance";

package/src/invites.test.ts

@@ -1,53 +1,48 @@
 import { describe, expect, it } from "vitest";
-import { extractJoinTokenFromInviteLink, getClipboardInviteSuggestion } from "./invites";
+import { getClipboardInviteSuggestion, parseSpaceInviteLink } from "./invites";
 
-describe("extractJoinTokenFromInviteLink", () => {
-  const inviteToken = "i".repeat(43);
+describe("parseSpaceInviteLink", () => {
+  const inviteToken = "cspi1.key.payload.signature";
 
   it("accepts Chalk https invite links", () => {
-    expect(extractJoinTokenFromInviteLink(`https://chalk.q9labs.ai/j/${inviteToken}`)).toBe(inviteToken);
+    expect(parseSpaceInviteLink(`https://chalk.q9labs.ai/space/design-lab#spaceInviteToken=${inviteToken}`)).toEqual({ slug: "design-lab", spaceInviteToken: inviteToken });
   });
 
-  it("accepts the new Chalk meet host", () => {
-    expect(extractJoinTokenFromInviteLink(`https://chalkmeet.com/j/${inviteToken}`)).toBe(inviteToken);
+  it("accepts bare Chalk hostnames", () => {
+    expect(parseSpaceInviteLink(`chalkmeet.com/space/design-lab#spaceInviteToken=${inviteToken}`)).toEqual({ slug: "design-lab", spaceInviteToken: inviteToken });
   });
 
-  it("accepts the canonical access hash", () => {
-    expect(extractJoinTokenFromInviteLink(`https://chalkmeet.com/#access=${inviteToken}`)).toBe(inviteToken);
+  it("accepts native Chalk deep links with the canonical path", () => {
+    expect(parseSpaceInviteLink(`chalk://space/design-lab#spaceInviteToken=${inviteToken}`)).toEqual({ slug: "design-lab", spaceInviteToken: inviteToken });
+    expect(parseSpaceInviteLink(`ai.q9labs.chalk.mobile://space/design-lab#spaceInviteToken=${inviteToken}`)).toEqual({ slug: "design-lab", spaceInviteToken: inviteToken });
   });
 
-  it("accepts bare Chalk invite hostnames", () => {
-    expect(extractJoinTokenFromInviteLink(`chalk.q9labs.ai/j/${inviteToken}`)).toBe(inviteToken);
+  it("accepts loopback HTTP invite links for local development", () => {
+    expect(parseSpaceInviteLink(`http://127.0.0.1:3070/space/design-lab#spaceInviteToken=${inviteToken}`)).toEqual({ slug: "design-lab", spaceInviteToken: inviteToken });
+    expect(parseSpaceInviteLink(`http://localhost:3070/space/design-lab#spaceInviteToken=${inviteToken}`)).toEqual({ slug: "design-lab", spaceInviteToken: inviteToken });
   });
 
-  it("accepts bare Chalk meet hostnames", () => {
-    expect(extractJoinTokenFromInviteLink(`chalkmeet.com/j/${inviteToken}`)).toBe(inviteToken);
-  });
-
-  it("accepts native Chalk deep links", () => {
-    expect(extractJoinTokenFromInviteLink(`chalk://j/${inviteToken}`)).toBe(inviteToken);
-  });
-
-  it("accepts bundle-scheme Chalk deep links", () => {
-    expect(extractJoinTokenFromInviteLink(`ai.q9labs.chalk.mobile://j/${inviteToken}`)).toBe(inviteToken);
-  });
-
-  it("rejects direct Space links and raw codes", () => {
-    expect(extractJoinTokenFromInviteLink("https://chalk.q9labs.ai/space/2f0b302b-2449-43f5-ae3b-de57decb9f09")).toBeNull();
-    expect(extractJoinTokenFromInviteLink(`https://attacker.test/j/${inviteToken}`)).toBeNull();
-    expect(extractJoinTokenFromInviteLink("ABC123")).toBeNull();
+  it("rejects legacy paths, missing slugs, and invalid tokens", () => {
+    expect(parseSpaceInviteLink(`https://chalk.q9labs.ai/legacy/${inviteToken}`)).toBeNull();
+    expect(parseSpaceInviteLink(`https://chalk.q9labs.ai/space#spaceInviteToken=${inviteToken}`)).toBeNull();
+    expect(parseSpaceInviteLink("https://chalk.q9labs.ai/space/design-lab#invite=legacy")).toBeNull();
+    expect(parseSpaceInviteLink("https://attacker.test/space/design-lab#spaceInviteToken=cspi1.key.payload.signature")).toBeNull();
+    expect(parseSpaceInviteLink(`http://chalkmeet.com/space/design-lab#spaceInviteToken=${inviteToken}`)).toBeNull();
+    expect(parseSpaceInviteLink(`http://192.168.1.10/space/design-lab#spaceInviteToken=${inviteToken}`)).toBeNull();
+    expect(parseSpaceInviteLink("https://chalk.q9labs.ai/space/design-lab#spaceInviteToken=ABC123")).toBeNull();
+    expect(parseSpaceInviteLink(`https://chalk.q9labs.ai/space/design-lab#spaceInviteToken=${`cspi1.${"k".repeat(170)}.${"p".repeat(170)}.${"s".repeat(170)}`}`)).toBeNull();
   });
 });
 
 describe("getClipboardInviteSuggestion", () => {
-  const inviteToken = "i".repeat(43);
+  const inviteLink = "https://chalkmeet.com/space/design-lab#spaceInviteToken=cspi1.key.payload.signature";
 
   it("returns a copied Chalk invite link when it differs from the current input", () => {
-    expect(getClipboardInviteSuggestion(`https://chalkmeet.com/j/${inviteToken}`, "")).toBe(`https://chalkmeet.com/j/${inviteToken}`);
+    expect(getClipboardInviteSuggestion(inviteLink, "")).toBe(inviteLink);
   });
 
   it("hides the suggestion when the input already matches the clipboard", () => {
-    expect(getClipboardInviteSuggestion(`https://chalkmeet.com/j/${inviteToken}`, `https://chalkmeet.com/j/${inviteToken}`)).toBeNull();
+    expect(getClipboardInviteSuggestion(inviteLink, inviteLink)).toBeNull();
   });
 
   it("ignores non-invite clipboard values", () => {

package/src/invites.ts

@@ -1,8 +1,14 @@
-const CHALK_INVITE_HOSTS = ["chalkmeet.com", "chalk.q9labs.ai"] as const;
+const CHALK_INVITE_HOSTS: readonly string[] = ["chalkmeet.com", "chalk.q9labs.ai"];
 const CHALK_CUSTOM_PROTOCOLS = new Set(["chalk:", "ai.q9labs.chalk.mobile:"]);
-const capabilityPattern = /^[A-Za-z0-9_-]{43}$/u;
+const SPACE_SLUG_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/u;
+const SPACE_INVITE_TOKEN_PATTERN = /^cspi1\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/u;
 
-export function extractJoinTokenFromInviteLink(input: string): string | null {
+export type SpaceInviteLink = {
+  readonly slug: string;
+  readonly spaceInviteToken: string;
+};
+
+export function parseSpaceInviteLink(input: string): SpaceInviteLink | null {
   const trimmed = input.trim();
   if (!trimmed) {
     return null;
@@ -15,20 +21,38 @@ export function extractJoinTokenFromInviteLink(input: string): string | null {
 
   try {
     const parsed = new URL(normalized);
-    if (!CHALK_CUSTOM_PROTOCOLS.has(parsed.protocol) && (parsed.protocol !== "https:" || !CHALK_INVITE_HOSTS.includes(parsed.hostname as (typeof CHALK_INVITE_HOSTS)[number]))) {
+    if (!CHALK_CUSTOM_PROTOCOLS.has(parsed.protocol) && !isAllowedWebInviteOrigin(parsed)) {
       return null;
     }
-    const pathSegments = CHALK_CUSTOM_PROTOCOLS.has(parsed.protocol) ? [parsed.hostname, ...parsed.pathname.split("/").filter(Boolean)] : parsed.pathname.split("/").filter(Boolean);
-    const [head, tail] = pathSegments;
-    const hashInvite = new URLSearchParams(parsed.hash.replace(/^#/u, "")).get("access");
-    const token = head === "j" && tail ? tail : hashInvite?.trim();
+    const pathSegments = parsed.pathname.split("/").filter(Boolean);
+    if (CHALK_CUSTOM_PROTOCOLS.has(parsed.protocol)) pathSegments.unshift(parsed.hostname);
+    if (pathSegments.length !== 2 || pathSegments[0] !== "space") return null;
 
-    return token && capabilityPattern.test(token) ? token : null;
+    const slug = pathSegments[1];
+    const token = new URLSearchParams(parsed.hash.replace(/^#/u, "")).get("spaceInviteToken")?.trim();
+    return slug && token && token.length <= 512 && SPACE_SLUG_PATTERN.test(slug) && SPACE_INVITE_TOKEN_PATTERN.test(token) ? { slug, spaceInviteToken: token } : null;
   } catch {
     return null;
   }
 }
 
+function isChalkInviteHost(hostname: string): boolean {
+  return CHALK_INVITE_HOSTS.some((host) => host === hostname);
+}
+
+function isAllowedWebInviteOrigin(url: URL): boolean {
+  if (url.protocol === "https:") return isChalkInviteHost(url.hostname);
+  return url.protocol === "http:" && isLoopbackHost(url.hostname);
+}
+
+function isLoopbackHost(hostname: string): boolean {
+  return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
+}
+
+export function extractSpaceInviteFromLink(input: string): SpaceInviteLink | null {
+  return parseSpaceInviteLink(input);
+}
+
 export function getClipboardInviteSuggestion(clipboardText: string | null | undefined, currentInput = ""): string | null {
   const normalizedClipboardText = clipboardText?.trim();
   if (!normalizedClipboardText) {
@@ -39,5 +63,5 @@ export function getClipboardInviteSuggestion(clipboardText: string | null | unde
     return null;
   }
 
-  return extractJoinTokenFromInviteLink(normalizedClipboardText) ? normalizedClipboardText : null;
+  return parseSpaceInviteLink(normalizedClipboardText) ? normalizedClipboardText : null;
 }

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

@@ -0,0 +1,118 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const initialize = vi.hoisted(() => vi.fn());
+
+vi.mock("@cloudflare/realtimekit-react-native", () => ({ default: { init: initialize } }));
+
+import { createNativeRealtimeKitClient } from "./cloudflare-rtk-native";
+
+describe("native RealtimeKit adapter", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("initializes, joins, leaves, and projects native participants", async () => {
+    const selfOn = vi.fn();
+    const selfOff = vi.fn();
+    const joinedOn = vi.fn();
+    const joinedOff = vi.fn();
+    const joinRoom = vi.fn().mockResolvedValue(undefined);
+    const leaveRoom = vi.fn().mockResolvedValue(undefined);
+    const audioTrack = { kind: "audio" };
+    const videoTrack = { kind: "video" };
+    const participant = {
+      id: "native-participant",
+      userId: "user",
+      customParticipantId: "custom-participant",
+      audioEnabled: true,
+      videoEnabled: false,
+      screenShareEnabled: false,
+      audioTrack,
+      videoTrack: null,
+      screenShareTracks: {},
+    };
+    const nativeClient = {
+      joinRoom,
+      leaveRoom,
+      self: {
+        peerId: "peer",
+        audioEnabled: true,
+        videoEnabled: false,
+        screenShareEnabled: false,
+        audioTrack,
+        videoTrack,
+        screenShareTracks: {},
+        enableAudio: vi.fn().mockResolvedValue(undefined),
+        enableVideo: vi.fn().mockResolvedValue(undefined),
+        enableScreenShare: vi.fn().mockResolvedValue(undefined),
+        disableAudio: vi.fn().mockResolvedValue(undefined),
+        disableVideo: vi.fn().mockResolvedValue(undefined),
+        disableScreenShare: vi.fn().mockResolvedValue(undefined),
+        on: selfOn,
+        off: selfOff,
+      },
+      participants: {
+        joined: {
+          toArray: vi.fn(() => [participant]),
+          on: joinedOn,
+          off: joinedOff,
+        },
+      },
+    };
+    initialize.mockResolvedValue(nativeClient);
+
+    const onError = vi.fn();
+    const connection = await createNativeRealtimeKitClient({ authToken: "rtk-token", onError });
+    await connection.join();
+    await connection.leave();
+
+    expect(initialize).toHaveBeenCalledWith({ authToken: "rtk-token", defaults: { audio: false, video: false }, onError });
+    expect(joinRoom).toHaveBeenCalledOnce();
+    expect(leaveRoom).toHaveBeenCalledOnce();
+    expect(connection.self.peerId).toBe("peer");
+    expect(connection.self.audioTrack).toBe(audioTrack);
+    expect(connection.participants.joined.list()).toEqual([expect.objectContaining({ id: "native-participant", customParticipantId: "custom-participant", audioTrack })]);
+  });
+
+  it("bridges lifecycle event subscriptions and removes them", async () => {
+    const selfOn = vi.fn();
+    const selfOff = vi.fn();
+    const joinedOn = vi.fn();
+    const joinedOff = vi.fn();
+    initialize.mockResolvedValue({
+      joinRoom: vi.fn(),
+      leaveRoom: vi.fn(),
+      self: {
+        peerId: "peer",
+        audioEnabled: false,
+        videoEnabled: false,
+        screenShareEnabled: false,
+        audioTrack: null,
+        videoTrack: null,
+        screenShareTracks: {},
+        enableAudio: vi.fn(),
+        enableVideo: vi.fn(),
+        enableScreenShare: vi.fn(),
+        disableAudio: vi.fn(),
+        disableVideo: vi.fn(),
+        disableScreenShare: vi.fn(),
+        on: selfOn,
+        off: selfOff,
+      },
+      participants: { joined: { toArray: vi.fn(() => []), on: joinedOn, off: joinedOff } },
+    });
+
+    const connection = await createNativeRealtimeKitClient({ authToken: "rtk-token", onError: vi.fn() });
+    const listener = vi.fn();
+    const unsubscribeAudio = connection.self.onAudioUpdate(listener);
+    const unsubscribeJoined = connection.participants.joined.onJoined(listener);
+
+    unsubscribeAudio();
+    unsubscribeJoined();
+
+    expect(selfOn).toHaveBeenCalledWith("audioUpdate", listener);
+    expect(selfOff).toHaveBeenCalledWith("audioUpdate", listener);
+    expect(joinedOn).toHaveBeenCalledWith("participantJoined", expect.any(Function));
+    expect(joinedOff).toHaveBeenCalledWith("participantJoined", expect.any(Function));
+  });
+});

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

@@ -0,0 +1,104 @@
+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/space-client/create-native-space-client.test.ts

@@ -4,10 +4,43 @@ const createSpaceClientForPlatform = vi.hoisted(() => vi.fn());
 const addAppStateListener = vi.hoisted(() => vi.fn());
 const createV1SyncClient = vi.hoisted(() => vi.fn());
 const createCloudflareSFUHTTPTransport = vi.hoisted(() => vi.fn(() => ({})));
+const CloudflareRTKClient = vi.hoisted(() =>
+  vi.fn(
+    class MockCloudflareRTKClient {
+      setLocalPublicationTarget = vi.fn();
+      observeLocalPublications = vi.fn();
+      observeRemotePublications = vi.fn();
+      start = vi.fn();
+      stop = vi.fn();
+      restart = vi.fn();
+      prepareLocalTrack = vi.fn();
+      clearPreparedLocalTrack = vi.fn();
+      getSnapshot = vi.fn();
+      subscribe = vi.fn();
+    },
+  ),
+);
+const CloudflareSFUClient = vi.hoisted(() =>
+  vi.fn(
+    class MockCloudflareSFUClient {
+      setLocalPublicationTarget = vi.fn();
+      observeLocalPublications = vi.fn();
+      observeRemotePublications = vi.fn();
+      start = vi.fn();
+      stop = vi.fn();
+      restart = vi.fn();
+      prepareLocalTrack = vi.fn();
+      clearPreparedLocalTrack = vi.fn();
+      getSnapshot = vi.fn();
+      subscribe = vi.fn();
+    },
+  ),
+);
 
 vi.mock("@q9labsai/chalk-client", () => ({
   AsyncStorageV1PendingTargetStore: vi.fn(),
-  CloudflareSFUClient: vi.fn(),
+  CloudflareRTKClient,
+  CloudflareSFUClient,
   createChalkChatFileHttpTransport: vi.fn(),
   createChalkWhiteboardV1Client: vi.fn(),
   createChalkWhiteboardV1FileHttpTransport: vi.fn(),
@@ -58,6 +91,26 @@ describe("native client creation", () => {
     expect(createSpaceClientForPlatform.mock.calls[0]?.[1]).toEqual(expect.objectContaining({ apiBaseUrl: "https://api.chalkmeet.com", syncUrl: "wss://sync.chalkmeet.com/v1/sync" }));
   });
 
+  it("selects the native RealtimeKit adapter for RTK access grants", () => {
+    createNativeSpaceClient(options());
+    const platform = createSpaceClientForPlatform.mock.calls[0]?.[1] as {
+      readonly dependencies: { readonly createMediaClient: (input: unknown) => unknown };
+    };
+
+    platform.dependencies.createMediaClient({
+      access: {
+        subject: { tenantId: "tenant", spaceId: "space", episodeId: "episode", participantId: "participant", participantGeneration: 1 },
+        media: { provider: "cloudflare_rtk", clientPayload: { providerSubject: "provider-subject", token: "rtk-token" } },
+      },
+      credential: vi.fn(),
+      onFailure: vi.fn(),
+      onScreenEnded: vi.fn(),
+    });
+
+    expect(CloudflareRTKClient).toHaveBeenCalledWith(expect.objectContaining({ authToken: "rtk-token", participantId: "participant", clientFactory: expect.any(Function) }));
+    expect(createCloudflareSFUHTTPTransport).not.toHaveBeenCalled();
+  });
+
   it("passes the closed access callback to the client", () => {
     const getAccess = vi.fn();
     createNativeSpaceClient({ ...options(), getAccess });