refactor(private-zoom): rename full feature surface

src/app/_components/__tests__/tailwind-components.test.tsx

@@ -85,8 +85,8 @@ describe("shared Tailwind components", () => {
       <CharacterAvatar
         src="/images/avatar/elio.png"
         alt="Elio Silvestri"
-        actionLabel="Open Elio's private room"
-        analyticsKey="chat.open_private_room_from_avatar"
+        actionLabel="Open Elio's private zoom"
+        analyticsKey="chat.open_private_zoom_from_avatar"
         onClick={() => undefined}
       />,
     );
@@ -100,10 +100,10 @@ describe("shared Tailwind components", () => {
 
     expect(characterHtml).toContain('<button type="button"');
     expect(characterHtml).toContain(
-      'aria-label="Open Elio&#x27;s private room"',
+      'aria-label="Open Elio&#x27;s private zoom"',
     );
     expect(characterHtml).toContain(
-      'data-analytics-key="chat.open_private_room_from_avatar"',
+      'data-analytics-key="chat.open_private_zoom_from_avatar"',
     );
     expect(userHtml).toContain('<button type="button"');
     expect(userHtml).toContain('aria-label="Open profile"');

src/app/_components/core/__tests__/tailwind-components.test.tsx

@@ -79,18 +79,18 @@ describe("core Tailwind components", () => {
       <AppBottomNav
         activeItem="chat"
         variant="dark"
-        privateRoomLabel="Maya Private room"
+        privateZoomLabel="Maya Private Zoom"
         onChatClick={() => undefined}
-        onPrivateRoomClick={() => undefined}
+        onPrivateZoomClick={() => undefined}
       />,
     );
-    const privateRoomHtml = renderToStaticMarkup(
+    const privateZoomHtml = renderToStaticMarkup(
       <AppBottomNav
-        activeItem="privateRoom"
+        activeItem="privateZoom"
         variant="warm"
-        privateRoomLabel="Maya Private room"
+        privateZoomLabel="Maya Private Zoom"
         onChatClick={() => undefined}
-        onPrivateRoomClick={() => undefined}
+        onPrivateZoomClick={() => undefined}
       />,
     );
 
@@ -99,13 +99,13 @@ describe("core Tailwind components", () => {
     expect(chatHtml).toMatch(
       /<button[^>]*aria-current="page"[^>]*>.*?<span>Chat<\/span>/,
     );
-    expect(privateRoomHtml).toMatch(/class="[^"]*warm[^"]*"/);
-    expect(privateRoomHtml).toMatch(
-      /<button[^>]*aria-current="page"[^>]*>.*?<span>Maya Private room<\/span>/,
+    expect(privateZoomHtml).toMatch(/class="[^"]*warm[^"]*"/);
+    expect(privateZoomHtml).toMatch(
+      /<button[^>]*aria-current="page"[^>]*>.*?<span>Maya Private Zoom<\/span>/,
     );
     expect(chatHtml).toContain('data-analytics-key="navigation.chat"');
-    expect(privateRoomHtml).toContain(
-      'data-analytics-key="navigation.private_room"',
+    expect(privateZoomHtml).toContain(
+      'data-analytics-key="navigation.private_zoom"',
     );
   });
 });

src/app/_components/core/app-bottom-nav.tsx

@@ -4,23 +4,23 @@ import { Camera, MessageCircle } from "lucide-react";
 
 import styles from "./app-bottom-nav.module.css";
 
-export type AppBottomNavItem = "chat" | "privateRoom";
+export type AppBottomNavItem = "chat" | "privateZoom";
 export type AppBottomNavVariant = "warm" | "dark";
 
 export interface AppBottomNavProps {
   activeItem?: AppBottomNavItem | null;
   variant?: AppBottomNavVariant;
-  privateRoomLabel: string;
+  privateZoomLabel: string;
   onChatClick: () => void;
-  onPrivateRoomClick: () => void;
+  onPrivateZoomClick: () => void;
 }
 
 export function AppBottomNav({
   activeItem = null,
   variant = "warm",
-  privateRoomLabel,
+  privateZoomLabel,
   onChatClick,
-  onPrivateRoomClick,
+  onPrivateZoomClick,
 }: AppBottomNavProps) {
   return (
     <nav className={getRootClass(variant)} aria-label="Primary navigation">
@@ -37,14 +37,14 @@ export function AppBottomNav({
       </button>
       <button
         type="button"
-        data-analytics-key="navigation.private_room"
-        data-analytics-label="Private room navigation"
-        className={getButtonClass(activeItem === "privateRoom")}
-        aria-current={activeItem === "privateRoom" ? "page" : undefined}
-        onClick={onPrivateRoomClick}
+        data-analytics-key="navigation.private_zoom"
+        data-analytics-label="Private Zoom navigation"
+        className={getButtonClass(activeItem === "privateZoom")}
+        aria-current={activeItem === "privateZoom" ? "page" : undefined}
+        onClick={onPrivateZoomClick}
       >
         <Camera size={20} aria-hidden="true" />
-        <span>{privateRoomLabel}</span>
+        <span>{privateZoomLabel}</span>
       </button>
     </nav>
   );

src/app/characters/[characterSlug]/private-room/page.tsx

@@ -1,5 +0,0 @@
-import { PrivateRoomScreen } from "@/app/private-room/private-room-screen";
-
-export default function CharacterPrivateRoomPage() {
-  return <PrivateRoomScreen />;
-}

src/app/characters/[characterSlug]/private-zoom/layout.tsx

@@ -2,9 +2,9 @@ import type { ReactNode } from "react";
 import { notFound } from "next/navigation";
 
 import { getCharacterBySlug } from "@/data/constants/character";
-import { PrivateRoomRouteProvider } from "@/providers/private-room-route-provider";
+import { PrivateZoomRouteProvider } from "@/providers/private-zoom-route-provider";
 
-export default async function CharacterPrivateRoomLayout({
+export default async function CharacterPrivateZoomLayout({
   children,
   params,
 }: {
@@ -13,11 +13,11 @@ export default async function CharacterPrivateRoomLayout({
 }) {
   const { characterSlug } = await params;
   const character = getCharacterBySlug(characterSlug);
-  if (!character?.capabilities.privateRoom) notFound();
+  if (!character?.capabilities.privateZoom) notFound();
 
   return (
-    <PrivateRoomRouteProvider characterId={character.id}>
+    <PrivateZoomRouteProvider characterId={character.id}>
       {children}
-    </PrivateRoomRouteProvider>
+    </PrivateZoomRouteProvider>
   );
 }

src/app/characters/[characterSlug]/private-zoom/page.tsx

@@ -0,0 +1,5 @@
+import { PrivateZoomScreen } from "@/app/private-zoom/private-zoom-screen";
+
+export default function CharacterPrivateZoomPage() {
+  return <PrivateZoomScreen />;
+}

src/app/chat/chat-screen.tsx

@@ -253,8 +253,8 @@ export function ChatScreen() {
     );
   }
 
-  function handleOpenCharacterPrivateRoom(): void {
-    router.push(characterRoutes.privateRoom);
+  function handleOpenCharacterPrivateZoom(): void {
+    router.push(characterRoutes.privateZoom);
   }
 
   return (
@@ -304,7 +304,7 @@ export function ChatScreen() {
             onUnlockImageMessage={handleUnlockImageMessage}
             onOpenImage={handleOpenImage}
             onUserAvatarClick={handleOpenUserProfile}
-            onCharacterAvatarClick={handleOpenCharacterPrivateRoom}
+            onCharacterAvatarClick={handleOpenCharacterPrivateZoom}
             onLoadMoreHistory={() => {
               chatDispatch({ type: "ChatLoadMoreHistoryRequested" });
             }}

src/app/chat/components/__tests__/tailwind-components.test.tsx

@@ -62,10 +62,10 @@ describe("chat Tailwind components", () => {
 
     expect(aiHtml).toContain('<button type="button"');
     expect(aiHtml).toContain(
-      'data-analytics-key="chat.open_private_room_from_avatar"',
+      'data-analytics-key="chat.open_private_zoom_from_avatar"',
     );
     expect(aiHtml).toContain(
-      'aria-label="Open Elio Silvestri&#x27;s private room"',
+      'aria-label="Open Elio Silvestri&#x27;s private zoom"',
     );
     expect(userHtml).toContain('<button type="button"');
     expect(userHtml).toContain(

src/app/chat/components/message-avatar.tsx

@@ -29,8 +29,8 @@ export function MessageAvatar({
           imageSize={43}
           priority
           className={AVATAR_CLASS_NAME}
-          actionLabel={`Open ${character.displayName}'s private room`}
-          analyticsKey="chat.open_private_room_from_avatar"
+          actionLabel={`Open ${character.displayName}'s private zoom`}
+          analyticsKey="chat.open_private_zoom_from_avatar"
           onClick={onClick}
         />
       );

src/app/private-zoom/__tests__/private-album-gallery-url.test.ts

@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
 
 import {
   buildPrivateAlbumGalleryUrl,
-  buildPrivateRoomWithoutGalleryUrl,
+  buildPrivateZoomWithoutGalleryUrl,
   getPrivateAlbumGalleryState,
 } from "../private-album-gallery-url";
 
@@ -11,7 +11,7 @@ describe("private album gallery URL", () => {
     const url = buildPrivateAlbumGalleryUrl("album:91", 3);
     const params = new URL(url, "https://cozsweet.test").searchParams;
 
-    expect(url).toBe("/private-room?album=album%3A91&image=3");
+    expect(url).toBe("/private-zoom?album=album%3A91&image=3");
     expect(getPrivateAlbumGalleryState(params)).toEqual({
       albumId: "album:91",
       imageIndex: 3,
@@ -29,9 +29,9 @@ describe("private album gallery URL", () => {
 
   it("removes gallery params without dropping other query values", () => {
     expect(
-      buildPrivateRoomWithoutGalleryUrl(
+      buildPrivateZoomWithoutGalleryUrl(
         new URLSearchParams("album=album-1&image=2&source=external"),
       ),
-    ).toBe("/private-room?source=external");
+    ).toBe("/private-zoom?source=external");
   });
 });

src/app/private-zoom/__tests__/private-album-images.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 
-import { PrivateAlbumSchema } from "@/data/schemas/private-room";
+import { PrivateAlbumSchema } from "@/data/schemas/private-zoom";
 
 import {
   findPrivateAlbumDisplayImage,

src/app/private-zoom/__tests__/use-private-zoom-flow-navigation.test.tsx

@@ -6,10 +6,10 @@ import { getCharacterBySlug } from "@/data/constants/character";
 import type { LoginStatus } from "@/data/schemas/auth";
 import { CharacterProvider } from "@/providers/character-provider";
 import { getCharacterRoutes } from "@/router/routes";
-import type { PrivateRoomEvent } from "@/stores/private-room";
-import type { PrivateRoomUnlockPaywallRequest } from "@/stores/private-room/private-room-state";
+import type { PrivateZoomEvent } from "@/stores/private-zoom";
+import type { PrivateZoomUnlockPaywallRequest } from "@/stores/private-zoom/private-zoom-state";
 
-import { usePrivateRoomUnlockPaywallNavigation } from "../use-private-room-flow";
+import { usePrivateZoomUnlockPaywallNavigation } from "../use-private-zoom-flow";
 
 const mocks = vi.hoisted(() => ({
   openAuth: vi.fn(),
@@ -30,7 +30,7 @@ vi.mock("@/lib/analytics", () => ({
   },
 }));
 
-const unlockPaywallRequest: PrivateRoomUnlockPaywallRequest = {
+const unlockPaywallRequest: PrivateZoomUnlockPaywallRequest = {
   albumId: "album-1",
   reason: "insufficient_credits",
   requiredCredits: 10,
@@ -38,7 +38,7 @@ const unlockPaywallRequest: PrivateRoomUnlockPaywallRequest = {
   shortfallCredits: 7,
 };
 
-describe("Private Room paywall navigation", () => {
+describe("Private Zoom paywall navigation", () => {
   let container: HTMLDivElement;
   let root: Root;
 
@@ -58,31 +58,31 @@ describe("Private Room paywall navigation", () => {
     container.remove();
   });
 
-  it("opens top up with a private room return target", () => {
-    const roomDispatch = vi.fn<Dispatch<PrivateRoomEvent>>();
+  it("opens top up with a private zoom return target", () => {
+    const roomDispatch = vi.fn<Dispatch<PrivateZoomEvent>>();
 
     renderHarness(root, "email", roomDispatch);
 
     expect(mocks.openSubscription).toHaveBeenCalledWith({
       type: "topup",
-      returnTo: "private-room",
+      returnTo: "private-zoom",
       analytics: {
         entryPoint: "private_album_unlock",
         triggerReason: "insufficient_credits",
       },
     });
     expect(roomDispatch).toHaveBeenCalledWith({
-      type: "PrivateRoomUnlockPaywallConsumed",
+      type: "PrivateZoomUnlockPaywallConsumed",
     });
   });
 
-  it("keeps guest users on the private room auth return path", () => {
-    const roomDispatch = vi.fn<Dispatch<PrivateRoomEvent>>();
+  it("keeps guest users on the private zoom auth return path", () => {
+    const roomDispatch = vi.fn<Dispatch<PrivateZoomEvent>>();
 
     renderHarness(root, "guest", roomDispatch);
 
     expect(mocks.openAuth).toHaveBeenCalledWith(
-      getCharacterRoutes("maya").privateRoom,
+      getCharacterRoutes("maya").privateZoom,
     );
     expect(mocks.openSubscription).not.toHaveBeenCalled();
   });
@@ -91,7 +91,7 @@ describe("Private Room paywall navigation", () => {
 function renderHarness(
   root: Root,
   loginStatus: LoginStatus,
-  roomDispatch: Dispatch<PrivateRoomEvent>,
+  roomDispatch: Dispatch<PrivateZoomEvent>,
 ): void {
   const character = getCharacterBySlug("maya");
   if (!character) throw new Error("Missing Maya character fixture");
@@ -109,9 +109,9 @@ function Harness({
   roomDispatch,
 }: {
   loginStatus: LoginStatus;
-  roomDispatch: Dispatch<PrivateRoomEvent>;
+  roomDispatch: Dispatch<PrivateZoomEvent>;
 }) {
-  usePrivateRoomUnlockPaywallNavigation({
+  usePrivateZoomUnlockPaywallNavigation({
     loginStatus,
     roomDispatch,
     unlockPaywallRequest,

src/app/private-zoom/__tests__/use-private-zoom-flow.test.ts

@@ -1,19 +1,19 @@
 import { describe, expect, it } from "vitest";
 
-import { isPrivateRoomAuthRequired } from "../use-private-room-flow";
+import { isPrivateZoomAuthRequired } from "../use-private-zoom-flow";
 
-describe("isPrivateRoomAuthRequired", () => {
+describe("isPrivateZoomAuthRequired", () => {
   it.each(["guest", "notLoggedIn"] as const)(
     "requires auth for %s users",
     (loginStatus) => {
-      expect(isPrivateRoomAuthRequired(loginStatus)).toBe(true);
+      expect(isPrivateZoomAuthRequired(loginStatus)).toBe(true);
     },
   );
 
   it.each(["email", "facebook", "google"] as const)(
     "allows %s users to top up directly",
     (loginStatus) => {
-      expect(isPrivateRoomAuthRequired(loginStatus)).toBe(false);
+      expect(isPrivateZoomAuthRequired(loginStatus)).toBe(false);
     },
   );
 });

src/app/private-zoom/components/__tests__/private-album-card.interaction.test.tsx

@@ -4,7 +4,7 @@ import { act } from "react";
 import { createRoot, type Root } from "react-dom/client";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
-import { PrivateAlbumSchema } from "@/data/schemas/private-room";
+import { PrivateAlbumSchema } from "@/data/schemas/private-zoom";
 
 import { PrivateAlbumCard } from "../private-album-card";
 
@@ -33,9 +33,9 @@ describe("PrivateAlbumCard interactions", () => {
       imageCount: 4,
       images: [
         { url: "", locked: false, index: 0 },
-        { url: "/images/private-room/locked.png", locked: true, index: 1 },
-        { url: "/images/private-room/photo-2.png", locked: false, index: 2 },
-        { url: "/images/private-room/photo-3.png", locked: false, index: 3 },
+        { url: "/images/private-zoom/locked.png", locked: true, index: 1 },
+        { url: "/images/private-zoom/photo-2.png", locked: false, index: 2 },
+        { url: "/images/private-zoom/photo-3.png", locked: false, index: 3 },
       ],
       locked: false,
       unlocked: true,
@@ -72,7 +72,7 @@ describe("PrivateAlbumCard interactions", () => {
       title: "Locked afternoon",
       imageCount: 3,
       images: [
-        { url: "/images/private-room/locked.png", locked: true, index: 0 },
+        { url: "/images/private-zoom/locked.png", locked: true, index: 0 },
       ],
       locked: true,
       unlocked: false,

src/app/private-zoom/components/__tests__/private-album-card.test.tsx

@@ -5,11 +5,11 @@ import {
   PrivateAlbumSchema,
   type PrivateAlbum,
   type PrivateAlbumInput,
-} from "@/data/schemas/private-room";
+} from "@/data/schemas/private-zoom";
 
 import { PrivateAlbumCard } from "../private-album-card";
 
-const COVER_URL = "/images/private-room/banner/elio.png";
+const COVER_URL = "/images/private-zoom/banner/elio.png";
 
 function makeAlbum(overrides: Partial<PrivateAlbumInput> = {}): PrivateAlbum {
   return PrivateAlbumSchema.parse({
@@ -157,7 +157,7 @@ describe("PrivateAlbumCard", () => {
 
 function makeImages(count: number) {
   return Array.from({ length: count }, (_, index) => ({
-    url: `/images/private-room/photo-${index}.png`,
+    url: `/images/private-zoom/photo-${index}.png`,
     locked: false,
     index,
   }));

src/app/private-zoom/components/__tests__/private-album-gallery.test.tsx

@@ -4,7 +4,7 @@ import { act } from "react";
 import { createRoot, type Root } from "react-dom/client";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
-import { PrivateAlbumSchema } from "@/data/schemas/private-room";
+import { PrivateAlbumSchema } from "@/data/schemas/private-zoom";
 
 import { PrivateAlbumGallery } from "../private-album-gallery";
 
@@ -13,11 +13,11 @@ const album = PrivateAlbumSchema.parse({
   title: "Private afternoon",
   imageCount: 5,
   images: [
-    { url: "/images/private-room/photo-0.png", locked: false, index: 0 },
+    { url: "/images/private-zoom/photo-0.png", locked: false, index: 0 },
     { url: "", locked: false, index: 1 },
-    { url: "/images/private-room/locked.png", locked: true, index: 2 },
-    { url: "/images/private-room/photo-3.png", locked: false, index: 3 },
-    { url: "/images/private-room/photo-4.png", locked: false, index: 4 },
+    { url: "/images/private-zoom/locked.png", locked: true, index: 2 },
+    { url: "/images/private-zoom/photo-3.png", locked: false, index: 3 },
+    { url: "/images/private-zoom/photo-4.png", locked: false, index: 4 },
   ],
   locked: false,
   unlocked: true,

src/app/private-zoom/components/private-album-card.tsx

@@ -3,8 +3,8 @@ import Image from "next/image";
 import { Copy, ImageIcon, LockKeyhole } from "lucide-react";
 
 import { CharacterAvatar } from "@/app/_components";
-import type { PrivateAlbum } from "@/data/schemas/private-room";
-import { isPrivateAlbumLocked } from "@/lib/private-room/private_album";
+import type { PrivateAlbum } from "@/data/schemas/private-zoom";
+import { isPrivateAlbumLocked } from "@/lib/private-zoom/private_album";
 
 import {
   getPrivateAlbumDisplayImages,
@@ -12,7 +12,7 @@ import {
   PRIVATE_ALBUM_GRID_LIMIT,
 } from "../private-album-images";
 
-import styles from "../private-room-screen.module.css";
+import styles from "../private-zoom-screen.module.css";
 
 export interface PrivateAlbumCardProps {
   album: PrivateAlbum;

src/app/private-zoom/components/private-album-gallery.tsx

@@ -11,14 +11,14 @@ import {
 import Image from "next/image";
 import { ChevronLeft, ChevronRight, X } from "lucide-react";
 
-import type { PrivateAlbum } from "@/data/schemas/private-room";
+import type { PrivateAlbum } from "@/data/schemas/private-zoom";
 
 import {
   getResistedGalleryDragDistance,
   resolveGallerySwipeDirection,
 } from "../private-album-gallery-motion";
 import { getPrivateAlbumDisplayImages } from "../private-album-images";
-import styles from "../private-room-screen.module.css";
+import styles from "../private-zoom-screen.module.css";
 
 export interface PrivateAlbumGalleryProps {
   album: PrivateAlbum;

src/app/private-zoom/components/status-card.tsx

@@ -1,4 +1,4 @@
-import styles from "../private-room-screen.module.css";
+import styles from "../private-zoom-screen.module.css";
 
 export interface StatusCardProps {
   message: string;

src/app/private-zoom/components/unlock-confirm-dialog.tsx

@@ -1,6 +1,6 @@
-import type { PrivateAlbum } from "@/data/schemas/private-room";
+import type { PrivateAlbum } from "@/data/schemas/private-zoom";
 
-import styles from "../private-room-screen.module.css";
+import styles from "../private-zoom-screen.module.css";
 
 export interface UnlockConfirmDialogProps {
   album: PrivateAlbum;

src/app/private-zoom/page.tsx

@@ -7,14 +7,14 @@ import {
   type RouteSearchParams,
 } from "@/router/routes";
 
-export default async function PrivateRoomPage({
+export default async function PrivateZoomPage({
   searchParams,
 }: {
   searchParams: Promise<RouteSearchParams>;
 }) {
   redirect(
     appendRouteSearchParams(
-      getCharacterRoutes(DEFAULT_CHARACTER_SLUG).privateRoom,
+      getCharacterRoutes(DEFAULT_CHARACTER_SLUG).privateZoom,
       await searchParams,
     ),
   );

src/app/private-zoom/private-album-gallery-url.ts

@@ -15,7 +15,7 @@ export function getPrivateAlbumGalleryState(input: {
 export function buildPrivateAlbumGalleryUrl(
   albumId: string,
   imageIndex: number,
-  basePath: string = ROUTES.privateRoom,
+  basePath: string = ROUTES.privateZoom,
 ): string {
   const params = new URLSearchParams({
     [PRIVATE_ALBUM_QUERY_PARAM]: albumId,
@@ -24,9 +24,9 @@ export function buildPrivateAlbumGalleryUrl(
   return `${basePath}?${params.toString()}`;
 }
 
-export function buildPrivateRoomWithoutGalleryUrl(
+export function buildPrivateZoomWithoutGalleryUrl(
   input: { toString: () => string },
-  basePath: string = ROUTES.privateRoom,
+  basePath: string = ROUTES.privateZoom,
 ): string {
   const params = new URLSearchParams(input.toString());
   params.delete(PRIVATE_ALBUM_QUERY_PARAM);

src/app/private-zoom/private-album-images.ts

@@ -1,4 +1,4 @@
-import type { PrivateAlbum } from "@/data/schemas/private-room";
+import type { PrivateAlbum } from "@/data/schemas/private-zoom";
 
 export const PRIVATE_ALBUM_GRID_LIMIT = 9;
 

src/app/private-zoom/private-zoom-screen.tsx

@@ -11,12 +11,12 @@ import {
   useActiveCharacter,
   useActiveCharacterRoutes,
 } from "@/providers/character-provider";
-import { isPrivateAlbumLocked } from "@/lib/private-room/private_album";
+import { isPrivateAlbumLocked } from "@/lib/private-zoom/private_album";
 import { useAuthDispatch, useAuthState } from "@/stores/auth/auth-context";
 import {
-  usePrivateRoomDispatch,
-  usePrivateRoomState,
-} from "@/stores/private-room";
+  usePrivateZoomDispatch,
+  usePrivateZoomState,
+} from "@/stores/private-zoom";
 
 import {
   PrivateAlbumCard,
@@ -24,21 +24,21 @@ import {
   StatusCard,
   UnlockConfirmDialog,
 } from "./components";
-import styles from "./private-room-screen.module.css";
+import styles from "./private-zoom-screen.module.css";
 import {
-  isPrivateRoomAuthRequired,
-  usePrivateRoomBootstrapFlow,
-  usePrivateRoomUnlockPaywallNavigation,
-  usePrivateRoomUnlockSuccessRefresh,
-} from "./use-private-room-flow";
+  isPrivateZoomAuthRequired,
+  usePrivateZoomBootstrapFlow,
+  usePrivateZoomUnlockPaywallNavigation,
+  usePrivateZoomUnlockSuccessRefresh,
+} from "./use-private-zoom-flow";
 import {
   buildPrivateAlbumGalleryUrl,
-  buildPrivateRoomWithoutGalleryUrl,
+  buildPrivateZoomWithoutGalleryUrl,
   getPrivateAlbumGalleryState,
 } from "./private-album-gallery-url";
 import { findPrivateAlbumDisplayImage } from "./private-album-images";
 
-export function PrivateRoomScreen() {
+export function PrivateZoomScreen() {
   const router = useRouter();
   const searchParams = useSearchParams();
   const navigator = useAppNavigator();
@@ -46,15 +46,15 @@ export function PrivateRoomScreen() {
   const characterRoutes = useActiveCharacterRoutes();
   const authState = useAuthState();
   const authDispatch = useAuthDispatch();
-  const state = usePrivateRoomState();
-  const dispatch = usePrivateRoomDispatch();
+  const state = usePrivateZoomState();
+  const dispatch = usePrivateZoomDispatch();
   const openedGalleryInPageRef = useRef(false);
   const galleryState = useMemo(
     () => getPrivateAlbumGalleryState(searchParams),
     [searchParams],
   );
 
-  usePrivateRoomBootstrapFlow({
+  usePrivateZoomBootstrapFlow({
     authDispatch,
     hasInitialized: authState.hasInitialized,
     isAuthLoading: authState.isLoading,
@@ -62,17 +62,17 @@ export function PrivateRoomScreen() {
     roomDispatch: dispatch,
     roomStatus: state.status,
   });
-  usePrivateRoomUnlockPaywallNavigation({
+  usePrivateZoomUnlockPaywallNavigation({
     loginStatus: authState.loginStatus,
     roomDispatch: dispatch,
     unlockPaywallRequest: state.unlockPaywallRequest,
   });
-  usePrivateRoomUnlockSuccessRefresh(state.unlockSuccessNonce);
+  usePrivateZoomUnlockSuccessRefresh(state.unlockSuccessNonce);
 
   const displayName = character.displayName;
   const avatarUrl = character.assets.avatar;
-  const title = character.copy.privateRoomTitle;
-  const subtitle = character.copy.privateRoomSubtitle;
+  const title = character.copy.privateZoomTitle;
+  const subtitle = character.copy.privateZoomSubtitle;
   const pendingAlbum = useMemo(
     () =>
       state.items.find(
@@ -107,15 +107,15 @@ export function PrivateRoomScreen() {
       !galleryImage
     ) {
       router.replace(
-        buildPrivateRoomWithoutGalleryUrl(
+        buildPrivateZoomWithoutGalleryUrl(
           searchParams,
-          characterRoutes.privateRoom,
+          characterRoutes.privateZoom,
         ),
         { scroll: false },
       );
     }
   }, [
-    characterRoutes.privateRoom,
+    characterRoutes.privateZoom,
     galleryAlbum,
     galleryImage,
     galleryState,
@@ -125,15 +125,15 @@ export function PrivateRoomScreen() {
   ]);
 
   const handleTopUpClick = () => {
-    if (isPrivateRoomAuthRequired(authState.loginStatus)) {
-      navigator.openAuth(characterRoutes.privateRoom);
+    if (isPrivateZoomAuthRequired(authState.loginStatus)) {
+      navigator.openAuth(characterRoutes.privateZoom);
       return;
     }
     navigator.openSubscription({
       type: "topup",
-      returnTo: "private-room",
+      returnTo: "private-zoom",
       analytics: {
-        entryPoint: "private_room",
+        entryPoint: "private_zoom",
         triggerReason: "vip_cta",
       },
     });
@@ -145,7 +145,7 @@ export function PrivateRoomScreen() {
       buildPrivateAlbumGalleryUrl(
         albumId,
         imageIndex,
-        characterRoutes.privateRoom,
+        characterRoutes.privateZoom,
       ),
       { scroll: false },
     );
@@ -158,9 +158,9 @@ export function PrivateRoomScreen() {
       return;
     }
     router.replace(
-      buildPrivateRoomWithoutGalleryUrl(
+      buildPrivateZoomWithoutGalleryUrl(
         searchParams,
-        characterRoutes.privateRoom,
+        characterRoutes.privateZoom,
       ),
       { scroll: false },
     );
@@ -172,7 +172,7 @@ export function PrivateRoomScreen() {
       buildPrivateAlbumGalleryUrl(
         galleryAlbum.albumId,
         imageIndex,
-        characterRoutes.privateRoom,
+        characterRoutes.privateZoom,
       ),
       { scroll: false },
     );
@@ -187,7 +187,7 @@ export function PrivateRoomScreen() {
         <section className={styles.hero} aria-label={title}>
           <div className={styles.heroCover}>
             <Image
-              src={character.assets.privateRoomBanner}
+              src={character.assets.privateZoomBanner}
               alt=""
               width={2048}
               height={1152}
@@ -213,8 +213,8 @@ export function PrivateRoomScreen() {
 
           <button
             type="button"
-            data-analytics-key="private_room.primary_cta"
-            data-analytics-label="Open private room top up"
+            data-analytics-key="private_zoom.primary_cta"
+            data-analytics-label="Open private zoom top up"
             className={styles.primaryCta}
             onClick={handleTopUpClick}
           >
@@ -237,7 +237,7 @@ export function PrivateRoomScreen() {
             <StatusCard
               message={state.errorMessage}
               actionLabel="Retry"
-              onAction={() => dispatch({ type: "PrivateRoomRefresh" })}
+              onAction={() => dispatch({ type: "PrivateZoomRefresh" })}
             />
           ) : null}
 
@@ -249,7 +249,7 @@ export function PrivateRoomScreen() {
             <StatusCard
               message="No private albums yet."
               actionLabel="Refresh"
-              onAction={() => dispatch({ type: "PrivateRoomRefresh" })}
+              onAction={() => dispatch({ type: "PrivateZoomRefresh" })}
             />
           ) : null}
 
@@ -267,7 +267,7 @@ export function PrivateRoomScreen() {
                 }
                 onUnlock={() =>
                   dispatch({
-                    type: "PrivateRoomUnlockRequested",
+                    type: "PrivateZoomUnlockRequested",
                     albumId: album.albumId,
                   })
                 }
@@ -277,12 +277,12 @@ export function PrivateRoomScreen() {
         </section>
 
         <AppBottomNav
-          activeItem="privateRoom"
-          privateRoomLabel={character.copy.privateRoomTitle}
+          activeItem="privateZoom"
+          privateZoomLabel={character.copy.privateZoomTitle}
           onChatClick={() =>
             navigator.push(characterRoutes.splash, { scroll: false })
           }
-          onPrivateRoomClick={() => undefined}
+          onPrivateZoomClick={() => undefined}
         />
 
         {pendingAlbum ? (
@@ -290,8 +290,8 @@ export function PrivateRoomScreen() {
             album={pendingAlbum}
             isUnlocking={state.isUnlocking}
             errorMessage={state.unlockErrorMessage}
-            onCancel={() => dispatch({ type: "PrivateRoomUnlockCancelled" })}
-            onConfirm={() => dispatch({ type: "PrivateRoomUnlockConfirmed" })}
+            onCancel={() => dispatch({ type: "PrivateZoomUnlockCancelled" })}
+            onConfirm={() => dispatch({ type: "PrivateZoomUnlockConfirmed" })}
           />
         ) : state.unlockErrorMessage ? (
           <div className={styles.toast} role="status">

src/app/private-zoom/use-private-zoom-flow.ts

@@ -8,37 +8,37 @@ import { behaviorAnalytics } from "@/lib/analytics";
 import { useActiveCharacterRoutes } from "@/providers/character-provider";
 import { useAppNavigator } from "@/router/use-app-navigator";
 import type { AuthEvent } from "@/stores/auth/auth-events";
-import type { PrivateRoomEvent } from "@/stores/private-room";
-import type { PrivateRoomUnlockPaywallRequest } from "@/stores/private-room/private-room-state";
+import type { PrivateZoomEvent } from "@/stores/private-zoom";
+import type { PrivateZoomUnlockPaywallRequest } from "@/stores/private-zoom/private-zoom-state";
 import { useUserDispatch } from "@/stores/user/user-context";
 
-export interface UsePrivateRoomBootstrapFlowInput {
+export interface UsePrivateZoomBootstrapFlowInput {
   authDispatch: Dispatch<AuthEvent>;
   hasInitialized: boolean;
   isAuthLoading: boolean;
   loginStatus: LoginStatus;
-  roomDispatch: Dispatch<PrivateRoomEvent>;
+  roomDispatch: Dispatch<PrivateZoomEvent>;
   roomStatus: string;
 }
 
-export interface UsePrivateRoomUnlockPaywallNavigationInput {
+export interface UsePrivateZoomUnlockPaywallNavigationInput {
   loginStatus: LoginStatus;
-  roomDispatch: Dispatch<PrivateRoomEvent>;
-  unlockPaywallRequest: PrivateRoomUnlockPaywallRequest | null;
+  roomDispatch: Dispatch<PrivateZoomEvent>;
+  unlockPaywallRequest: PrivateZoomUnlockPaywallRequest | null;
 }
 
-export function isPrivateRoomAuthRequired(loginStatus: LoginStatus): boolean {
+export function isPrivateZoomAuthRequired(loginStatus: LoginStatus): boolean {
   return loginStatus === "guest" || loginStatus === "notLoggedIn";
 }
 
-export function usePrivateRoomBootstrapFlow({
+export function usePrivateZoomBootstrapFlow({
   authDispatch,
   hasInitialized,
   isAuthLoading,
   loginStatus,
   roomDispatch,
   roomStatus,
-}: UsePrivateRoomBootstrapFlowInput): void {
+}: UsePrivateZoomBootstrapFlowInput): void {
   const previousLoginStatusRef = useRef(loginStatus);
 
   useGuestLoginBootstrap({
@@ -56,12 +56,12 @@ export function usePrivateRoomBootstrapFlow({
     previousLoginStatusRef.current = loginStatus;
 
     if (roomStatus === "idle") {
-      roomDispatch({ type: "PrivateRoomInit" });
+      roomDispatch({ type: "PrivateZoomInit" });
       return;
     }
 
     if (previousLoginStatus !== loginStatus && roomStatus !== "loading") {
-      roomDispatch({ type: "PrivateRoomRefresh" });
+      roomDispatch({ type: "PrivateZoomRefresh" });
     }
   }, [
     hasInitialized,
@@ -72,19 +72,19 @@ export function usePrivateRoomBootstrapFlow({
   ]);
 }
 
-export function usePrivateRoomUnlockPaywallNavigation({
+export function usePrivateZoomUnlockPaywallNavigation({
   loginStatus,
   roomDispatch,
   unlockPaywallRequest,
-}: UsePrivateRoomUnlockPaywallNavigationInput): void {
+}: UsePrivateZoomUnlockPaywallNavigationInput): void {
   const navigator = useAppNavigator();
   const characterRoutes = useActiveCharacterRoutes();
 
   useEffect(() => {
     if (!unlockPaywallRequest) return;
 
-    if (isPrivateRoomAuthRequired(loginStatus)) {
-      navigator.openAuth(characterRoutes.privateRoom);
+    if (isPrivateZoomAuthRequired(loginStatus)) {
+      navigator.openAuth(characterRoutes.privateZoom);
     } else {
       behaviorAnalytics.paywallShown({
         entryPoint: "private_album_unlock",
@@ -92,16 +92,16 @@ export function usePrivateRoomUnlockPaywallNavigation({
       });
       navigator.openSubscription({
         type: "topup",
-        returnTo: "private-room",
+        returnTo: "private-zoom",
         analytics: {
           entryPoint: "private_album_unlock",
           triggerReason: "insufficient_credits",
         },
       });
     }
-    roomDispatch({ type: "PrivateRoomUnlockPaywallConsumed" });
+    roomDispatch({ type: "PrivateZoomUnlockPaywallConsumed" });
   }, [
-    characterRoutes.privateRoom,
+    characterRoutes.privateZoom,
     loginStatus,
     navigator,
     roomDispatch,
@@ -109,7 +109,7 @@ export function usePrivateRoomUnlockPaywallNavigation({
   ]);
 }
 
-export function usePrivateRoomUnlockSuccessRefresh(
+export function usePrivateZoomUnlockSuccessRefresh(
   unlockSuccessNonce: number,
 ): void {
   const userDispatch = useUserDispatch();

src/app/splash/splash-screen.tsx

@@ -37,8 +37,8 @@ export function SplashScreen() {
     navigator.openChat({ replace: true });
   };
 
-  const handleOpenPrivateRoom = () => {
-    navigator.push(characterRoutes.privateRoom, { scroll: false });
+  const handleOpenPrivateZoom = () => {
+    navigator.push(characterRoutes.privateZoom, { scroll: false });
   };
 
   const handleOpenSplash = () => {
@@ -77,9 +77,9 @@ export function SplashScreen() {
         </div>
         <AppBottomNav
           activeItem="chat"
-          privateRoomLabel={character.copy.privateRoomTitle}
+          privateZoomLabel={character.copy.privateZoomTitle}
           onChatClick={handleOpenSplash}
-          onPrivateRoomClick={handleOpenPrivateRoom}
+          onPrivateZoomClick={handleOpenPrivateZoom}
         />
       </div>
     </MobileShell>

src/data/constants/__tests__/character.test.ts

@@ -71,7 +71,7 @@ describe("local character catalog", () => {
     expect(snapshot.catalog.getById("maya-tan")).toMatchObject({
       displayName: "Maya Backend",
       assets: { avatar: "/images/avatar/maya.png" },
-      capabilities: { chat: true, privateRoom: false, tip: true },
+      capabilities: { chat: true, privateZoom: false, tip: true },
     });
     expect(snapshot.defaultCharacter.id).toBe("elio");
   });
@@ -101,7 +101,7 @@ describe("local character catalog", () => {
     for (const character of CHARACTERS) {
       expect(character.capabilities).toEqual({
         chat: true,
-        privateRoom: true,
+        privateZoom: true,
         tip: true,
       });
       expect(character.tagline.length).toBeGreaterThan(0);

src/data/constants/character.ts

@@ -1,6 +1,6 @@
 export interface CharacterCapabilities {
   readonly chat: boolean;
-  readonly privateRoom: boolean;
+  readonly privateZoom: boolean;
   readonly tip: boolean;
 }
 
@@ -17,12 +17,12 @@ export interface CharacterProfile {
     readonly avatar: string;
     readonly cover: string;
     readonly chatBackground: string;
-    readonly privateRoomBanner: string;
+    readonly privateZoomBanner: string;
   };
   readonly copy: {
     readonly splashRelationship: string;
-    readonly privateRoomTitle: string;
-    readonly privateRoomSubtitle: string;
+    readonly privateZoomTitle: string;
+    readonly privateZoomSubtitle: string;
     readonly tipHeader: string;
     readonly tipTitle: string;
   };
@@ -62,19 +62,19 @@ const CHARACTER_PROFILES: readonly CharacterProfile[] = Object.freeze([
       "Finally I can relax. How was your day out?",
     capabilities: {
       chat: true,
-      privateRoom: true,
+      privateZoom: true,
       tip: true,
     },
     assets: {
       avatar: "/images/avatar/elio.png",
       cover: "/images/cover/elio.png",
       chatBackground: "/images/chat/bg-chatpage.png",
-      privateRoomBanner: "/images/private-room/banner/elio.png",
+      privateZoomBanner: "/images/private-zoom/banner/elio.png",
     },
     copy: {
       splashRelationship: "Your exclusive AI boyfriend",
-      privateRoomTitle: "Elio Private room",
-      privateRoomSubtitle: "Join me, unlock my private room",
+      privateZoomTitle: "Elio Private Zoom",
+      privateZoomSubtitle: "Join me, unlock my private zoom",
       tipHeader: "Tip Elio",
       tipTitle: "Buy Elio a coffee",
     },
@@ -91,19 +91,19 @@ const CHARACTER_PROFILES: readonly CharacterProfile[] = Object.freeze([
       "How was your day?",
     capabilities: {
       chat: true,
-      privateRoom: true,
+      privateZoom: true,
       tip: true,
     },
     assets: {
       avatar: "/images/avatar/maya.png",
       cover: "/images/cover/maya.png",
       chatBackground: "/images/chat/bg-chatpage.png",
-      privateRoomBanner: "/images/private-room/banner/maya.png",
+      privateZoomBanner: "/images/private-zoom/banner/maya.png",
     },
     copy: {
       splashRelationship: "Your exclusive AI girlfriend",
-      privateRoomTitle: "Maya Private room",
-      privateRoomSubtitle: "Join me, unlock my private room",
+      privateZoomTitle: "Maya Private Zoom",
+      privateZoomSubtitle: "Join me, unlock my private zoom",
       tipHeader: "Tip Maya",
       tipTitle: "Buy Maya a coffee",
     },
@@ -120,19 +120,19 @@ const CHARACTER_PROFILES: readonly CharacterProfile[] = Object.freeze([
       "Tell me how your day went.",
     capabilities: {
       chat: true,
-      privateRoom: true,
+      privateZoom: true,
       tip: true,
     },
     assets: {
       avatar: "/images/avatar/nayeli.png",
       cover: "/images/cover/nayeli.png",
       chatBackground: "/images/chat/bg-chatpage.png",
-      privateRoomBanner: "/images/private-room/banner/nayeli.png",
+      privateZoomBanner: "/images/private-zoom/banner/nayeli.png",
     },
     copy: {
       splashRelationship: "Your exclusive AI girlfriend",
-      privateRoomTitle: "Nayeli Private room",
-      privateRoomSubtitle: "Join me, unlock my private room",
+      privateZoomTitle: "Nayeli Private Zoom",
+      privateZoomSubtitle: "Join me, unlock my private zoom",
       tipHeader: "Tip Nayeli",
       tipTitle: "Buy Nayeli a coffee",
     },
@@ -186,8 +186,8 @@ export function mergeRemoteCharacterCatalog(
         sortOrder: item.sortOrder,
         capabilities: {
           chat: item.capabilities.chat,
-          privateRoom:
-            local.capabilities.privateRoom && item.capabilities.privateContent,
+          privateZoom:
+            local.capabilities.privateZoom && item.capabilities.privateContent,
           tip: local.capabilities.tip,
         },
       }),

src/data/repositories/index.ts

@@ -8,7 +8,7 @@ export * from "./character_repository";
 export * from "./feedback_repository";
 export * from "./metrics_repository";
 export * from "./payment_repository";
-export * from "./private_room_repository";
+export * from "./private_zoom_repository";
 export * from "./user_repository";
 export * from "./interfaces/iauth_repository";
 export * from "./interfaces/ichat_repository";
@@ -16,5 +16,5 @@ export * from "./interfaces/icharacter_repository";
 export * from "./interfaces/ifeedback_repository";
 export * from "./interfaces/imetrics_repository";
 export * from "./interfaces/ipayment_repository";
-export * from "./interfaces/iprivate_room_repository";
+export * from "./interfaces/iprivate_zoom_repository";
 export * from "./interfaces/iuser_repository";

src/data/repositories/interfaces/index.ts

@@ -8,5 +8,5 @@ export * from "./icharacter_repository";
 export * from "./ifeedback_repository";
 export * from "./imetrics_repository";
 export * from "./ipayment_repository";
-export * from "./iprivate_room_repository";
+export * from "./iprivate_zoom_repository";
 export * from "./iuser_repository";

src/data/repositories/interfaces/iprivate_zoom_repository.ts

@@ -1,7 +1,7 @@
 import type {
   PrivateAlbumsResponse,
   PrivateAlbumUnlockResponse,
-} from "@/data/schemas/private-room";
+} from "@/data/schemas/private-zoom";
 import type { Result } from "@/utils/result";
 
 export interface GetPrivateAlbumsInput {
@@ -9,7 +9,7 @@ export interface GetPrivateAlbumsInput {
   limit?: number;
 }
 
-export interface IPrivateRoomRepository {
+export interface IPrivateZoomRepository {
   getAlbums(
     input: GetPrivateAlbumsInput,
   ): Promise<Result<PrivateAlbumsResponse>>;

src/data/repositories/private_zoom_repository.ts

@@ -1,22 +1,22 @@
 import type {
   GetPrivateAlbumsInput,
-  IPrivateRoomRepository,
+  IPrivateZoomRepository,
 } from "@/data/repositories/interfaces";
 import {
   type PrivateAlbumsResponse,
   type PrivateAlbumUnlockResponse,
   UnlockPrivateAlbumRequestSchema,
-} from "@/data/schemas/private-room";
+} from "@/data/schemas/private-zoom";
 import {
-  PrivateRoomApi,
-  privateRoomApi,
-} from "@/data/services/api/private_room_api";
+  PrivateZoomApi,
+  privateZoomApi,
+} from "@/data/services/api/private_zoom_api";
 import { Result } from "@/utils/result";
 
 import { createLazySingleton } from "./lazy_singleton";
 
-export class PrivateRoomRepository implements IPrivateRoomRepository {
-  constructor(private readonly api: PrivateRoomApi) {}
+export class PrivateZoomRepository implements IPrivateZoomRepository {
+  constructor(private readonly api: PrivateZoomApi) {}
 
   getAlbums(
     input: GetPrivateAlbumsInput,
@@ -37,7 +37,7 @@ export class PrivateRoomRepository implements IPrivateRoomRepository {
   }
 }
 
-export const getPrivateRoomRepository =
-  createLazySingleton<IPrivateRoomRepository>(
-    () => new PrivateRoomRepository(privateRoomApi),
+export const getPrivateZoomRepository =
+  createLazySingleton<IPrivateZoomRepository>(
+    () => new PrivateZoomRepository(privateZoomApi),
   );

src/data/schemas/__tests__/immutable_schema.test.ts

@@ -3,7 +3,7 @@ import { describe, expect, it } from "vitest";
 import { FacebookIdentityResponseSchema } from "@/data/schemas/auth";
 import { ChatHistoryResponseSchema } from "@/data/schemas/chat";
 import { PaymentPlansResponseSchema } from "@/data/schemas/payment";
-import { PrivateAlbumsResponseSchema } from "@/data/schemas/private-room";
+import { PrivateAlbumsResponseSchema } from "@/data/schemas/private-zoom";
 import { UserSchema } from "@/data/schemas/user";
 
 describe("immutable schemas", () => {
@@ -33,7 +33,7 @@ describe("immutable schemas", () => {
     expectDeepFrozen(response);
   });
 
-  it("freezes payment and private-room collections", () => {
+  it("freezes payment and private-zoom collections", () => {
     const plans = PaymentPlansResponseSchema.parse({
       firstRechargeOffer: {
         enabled: true,

src/data/schemas/private-zoom/__tests__/private_album.test.ts

@@ -4,7 +4,7 @@ import {
   PrivateAlbumUnlockResponseSchema,
   PrivateAlbumsResponseSchema,
   UnlockPrivateAlbumRequestSchema,
-} from "@/data/schemas/private-room";
+} from "@/data/schemas/private-zoom";
 import { ApiPath } from "@/data/services/api";
 
 const ALBUM_ID = "a1b2c3d4-0000-0000-0000-000000000000";
@@ -96,8 +96,8 @@ describe("Private Album schema models", () => {
   });
 
   it("encodes the album id in the unlock path", () => {
-    expect(ApiPath.privateRoomAlbumUnlock("album:91")).toBe(
-      "/api/private-room/albums/album%3A91/unlock",
+    expect(ApiPath.privateZoomAlbumUnlock("album:91")).toBe(
+      "/api/private-zoom/albums/album%3A91/unlock",
     );
   });
 });

src/data/services/api/__tests__/api_path.test.ts

@@ -6,7 +6,7 @@ import { ApiPath } from "../api_path";
 describe("ApiPath contract source", () => {
   it("uses the shared contract path for every static operation", () => {
     const staticOperations = Object.entries(apiContract).filter(
-      ([operationId]) => operationId !== "privateRoomAlbumUnlock",
+      ([operationId]) => operationId !== "privateZoomAlbumUnlock",
     );
 
     for (const [operationId, operation] of staticOperations) {
@@ -17,8 +17,8 @@ describe("ApiPath contract source", () => {
   });
 
   it("fills and encodes the private album path parameter", () => {
-    expect(ApiPath.privateRoomAlbumUnlock("album/id 1")).toBe(
-      "/api/private-room/albums/album%2Fid%201/unlock",
+    expect(ApiPath.privateZoomAlbumUnlock("album/id 1")).toBe(
+      "/api/private-zoom/albums/album%2Fid%201/unlock",
     );
   });
 });

src/data/services/api/__tests__/multi_character_api.test.ts

@@ -14,7 +14,7 @@ vi.mock("../http_client", () => ({
 
 import { ChatApi } from "../chat_api";
 import { CharacterApi } from "../character_api";
-import { PrivateRoomApi } from "../private_room_api";
+import { PrivateZoomApi } from "../private_zoom_api";
 
 const CHARACTER_ID = "elio";
 
@@ -146,18 +146,18 @@ describe("multi-character API contract", () => {
     );
   });
 
-  it("scopes private-room albums to characterId", async () => {
+  it("scopes private-zoom albums to characterId", async () => {
     httpClientMock.mockResolvedValue({
       success: true,
       data: { items: [], creditBalance: 0 },
     });
 
-    await new PrivateRoomApi().getAlbums({
+    await new PrivateZoomApi().getAlbums({
       characterId: CHARACTER_ID,
       limit: 20,
     });
 
-    expect(httpClientMock).toHaveBeenCalledWith("/api/private-room/albums", {
+    expect(httpClientMock).toHaveBeenCalledWith("/api/private-zoom/albums", {
       query: { characterId: CHARACTER_ID, limit: 20 },
     });
   });

src/data/services/api/api_contract.json

@@ -21,8 +21,8 @@
   "chatHistory": { "method": "get", "path": "/api/chat/history" },
   "chatUnlockPrivate": { "method": "post", "path": "/api/chat/unlock-private" },
   "chatUnlockHistory": { "method": "post", "path": "/api/chat/unlock-history" },
-  "privateRoomAlbums": { "method": "get", "path": "/api/private-room/albums" },
-  "privateRoomAlbumUnlock": { "method": "post", "path": "/api/private-room/albums/{albumId}/unlock" },
+  "privateZoomAlbums": { "method": "get", "path": "/api/private-zoom/albums" },
+  "privateZoomAlbumUnlock": { "method": "post", "path": "/api/private-zoom/albums/{albumId}/unlock" },
   "metricsPwaEvent": { "method": "post", "path": "/api/metrics/pwa/event" },
   "reportUserInfo": { "method": "post", "path": "/api/data/report-user-info" },
   "feedback": { "method": "post", "path": "/api/feedback" },

src/data/services/api/api_path.ts

@@ -81,11 +81,11 @@ export class ApiPath {
 
   // ============ 私密空间相关 ============
   /** 获取私密图片包列表 */
-  static readonly privateRoomAlbums = apiContract.privateRoomAlbums.path;
+  static readonly privateZoomAlbums = apiContract.privateZoomAlbums.path;
 
   /** 解锁私密图片包 */
-  static privateRoomAlbumUnlock(albumId: string): string {
-    return apiContract.privateRoomAlbumUnlock.path.replace(
+  static privateZoomAlbumUnlock(albumId: string): string {
+    return apiContract.privateZoomAlbumUnlock.path.replace(
       "{albumId}",
       encodeURIComponent(albumId),
     );

src/data/services/api/index.ts

@@ -12,6 +12,6 @@ export * from "./feedback_api";
 export * from "./http_client";
 export * from "./metrics_api";
 export * from "./payment_api";
-export * from "./private_room_api";
+export * from "./private_zoom_api";
 export * from "./response_helper";
 export * from "./user_api";

src/data/services/api/private_zoom_api.ts

@@ -4,7 +4,7 @@ import {
   PrivateAlbumUnlockResponse,
   PrivateAlbumUnlockResponseSchema,
   UnlockPrivateAlbumRequest,
-} from "@/data/schemas/private-room";
+} from "@/data/schemas/private-zoom";
 
 import { ApiPath } from "./api_path";
 import { httpClient } from "./http_client";
@@ -15,12 +15,12 @@ export interface GetPrivateAlbumsInput {
   limit?: number;
 }
 
-export class PrivateRoomApi {
+export class PrivateZoomApi {
   async getAlbums(
     input: GetPrivateAlbumsInput,
   ): Promise<PrivateAlbumsResponse> {
     const env = await httpClient<ApiEnvelope<unknown>>(
-      ApiPath.privateRoomAlbums,
+      ApiPath.privateZoomAlbums,
       {
         query: {
           characterId: input.characterId,
@@ -36,7 +36,7 @@ export class PrivateRoomApi {
     body: UnlockPrivateAlbumRequest,
   ): Promise<PrivateAlbumUnlockResponse> {
     const env = await httpClient<ApiEnvelope<unknown>>(
-      ApiPath.privateRoomAlbumUnlock(albumId),
+      ApiPath.privateZoomAlbumUnlock(albumId),
       {
         method: "POST",
         body,
@@ -46,4 +46,4 @@ export class PrivateRoomApi {
   }
 }
 
-export const privateRoomApi = new PrivateRoomApi();
+export const privateZoomApi = new PrivateZoomApi();

src/data/storage/payment/pending_payment_order_storage.ts

@@ -14,7 +14,7 @@ const PendingPaymentOrderSchema = z
     subscriptionType: z.enum(["vip", "topup", "tip"]),
     giftCategory: z.string().min(1).nullable().default(null),
     giftPlanId: z.string().min(1).nullable().default(null),
-    returnTo: z.enum(["chat", "private-room", "profile"]).optional(),
+    returnTo: z.enum(["chat", "private-zoom", "profile"]).optional(),
     characterSlug: z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).optional(),
     createdAt: z.number(),
   })

src/lib/analytics/payment_analytics_context.ts

@@ -15,7 +15,7 @@ export type PaymentAnalyticsEntryPoint =
   | "chat_input"
   | "chat_unlock"
   | "private_album_unlock"
-  | "private_room"
+  | "private_zoom"
   | "profile"
   | "chat_offer_banner"
   | "subscription_direct"
@@ -32,7 +32,7 @@ const ENTRY_POINTS = new Set<PaymentAnalyticsEntryPoint>([
   "chat_input",
   "chat_unlock",
   "private_album_unlock",
-  "private_room",
+  "private_zoom",
   "profile",
   "chat_offer_banner",
   "subscription_direct",

src/lib/navigation/__tests__/external_entry.test.ts

@@ -17,15 +17,15 @@ describe("external entry navigation", () => {
   it("resolves only canonical targets", () => {
     expect(resolveExternalEntryTarget({ target: "chat" })).toBe(ROUTES.chat);
     expect(resolveExternalEntryTarget({ target: "tip" })).toBe(ROUTES.tip);
-    expect(resolveExternalEntryTarget({ target: "private-room" })).toBe(
-      ROUTES.privateRoom,
+    expect(resolveExternalEntryTarget({ target: "private-zoom" })).toBe(
+      ROUTES.privateZoom,
     );
   });
 
   it("rejects removed aliases and unsupported targets", () => {
     expect(resolveExternalEntryTarget({ target: "tips" })).toBe(ROUTES.chat);
     expect(resolveExternalEntryTarget({ target: "coffee" })).toBe(ROUTES.chat);
-    expect(resolveExternalEntryTarget({ target: "private_room" })).toBe(
+    expect(resolveExternalEntryTarget({ target: "private_zoom" })).toBe(
       ROUTES.chat,
     );
     expect(resolveExternalEntryTarget({ target: "/tip" })).toBe(ROUTES.chat);
@@ -44,10 +44,10 @@ describe("external entry navigation", () => {
     ).toBe(getCharacterRoutes("maya").chat);
     expect(
       resolveExternalEntryDestination({
-        target: "private-room",
+        target: "private-zoom",
         character: "unknown",
       }),
-    ).toBe(getCharacterRoutes("elio").privateRoom);
+    ).toBe(getCharacterRoutes("elio").privateZoom);
   });
 });
 

src/lib/navigation/__tests__/subscription_exit.test.ts

@@ -89,7 +89,7 @@ describe("subscription exit helpers", () => {
     expect(peekPendingChatUnlockMock).not.toHaveBeenCalled();
   });
 
-  it("returns directly to private room without consuming chat state", async () => {
+  it("returns directly to private zoom without consuming chat state", async () => {
     consumePendingChatImageReturnMock.mockResolvedValue({
       reason: "image_paywall",
       characterId: "elio",
@@ -108,18 +108,18 @@ describe("subscription exit helpers", () => {
       createdAt: 1,
     });
 
-    expect(getSubscriptionFallbackExitUrl("private-room")).toBe(
-      getCharacterRoutes("elio").privateRoom,
+    expect(getSubscriptionFallbackExitUrl("private-zoom")).toBe(
+      getCharacterRoutes("elio").privateZoom,
     );
-    await expect(consumeSubscriptionExitUrl("private-room")).resolves.toBe(
-      getCharacterRoutes("elio").privateRoom,
+    await expect(consumeSubscriptionExitUrl("private-zoom")).resolves.toBe(
+      getCharacterRoutes("elio").privateZoom,
     );
     expect(consumePendingChatImageReturnMock).not.toHaveBeenCalled();
     expect(peekPendingChatUnlockMock).not.toHaveBeenCalled();
     expect(clearPendingChatUnlockMock).not.toHaveBeenCalled();
   });
 
-  it("keeps private room ahead of stale chat state after payment", async () => {
+  it("keeps private zoom ahead of stale chat state after payment", async () => {
     peekPendingChatUnlockMock.mockResolvedValue({
       reason: "single_message_unlock",
       characterId: "elio",
@@ -132,8 +132,8 @@ describe("subscription exit helpers", () => {
     });
 
     await expect(
-      resolveSubscriptionSuccessExitUrl("private-room", "maya"),
-    ).resolves.toBe(getCharacterRoutes("maya").privateRoom);
+      resolveSubscriptionSuccessExitUrl("private-zoom", "maya"),
+    ).resolves.toBe(getCharacterRoutes("maya").privateZoom);
     expect(peekPendingChatUnlockMock).not.toHaveBeenCalled();
     expect(clearPendingChatUnlockMock).not.toHaveBeenCalled();
   });

src/lib/navigation/external_entry.ts

@@ -13,7 +13,7 @@ import { getCharacterRoutes, ROUTES } from "@/router/routes";
 export type ExternalEntryTarget =
   | typeof ROUTES.chat
   | typeof ROUTES.tip
-  | typeof ROUTES.privateRoom;
+  | typeof ROUTES.privateZoom;
 
 export interface ExternalEntryPayload {
   deviceId?: string | null;
@@ -91,7 +91,7 @@ export function resolveExternalEntryDestination({
   const routes = getCharacterRoutes(characterSlug);
   const resolvedTarget = resolveExternalEntryTarget({ target });
   if (resolvedTarget === ROUTES.tip) return routes.tip;
-  if (resolvedTarget === ROUTES.privateRoom) return routes.privateRoom;
+  if (resolvedTarget === ROUTES.privateZoom) return routes.privateZoom;
   return routes.chat;
 }
 
@@ -129,7 +129,7 @@ function resolveTarget(
 
   if (target === "chat") return ROUTES.chat;
   if (target === "tip") return ROUTES.tip;
-  if (target === "private-room") return ROUTES.privateRoom;
+  if (target === "private-zoom") return ROUTES.privateZoom;
 
   return null;
 }

src/lib/navigation/subscription_exit.ts

@@ -47,7 +47,7 @@ export function getSubscriptionFallbackExitUrl(
 ): string {
   const routes = getCharacterRoutes(characterSlug);
   if (returnTo === "chat") return routes.chat;
-  if (returnTo === "private-room") return routes.privateRoom;
+  if (returnTo === "private-zoom") return routes.privateZoom;
   if (returnTo === "profile") {
     return buildGlobalPageUrl(ROUTES.profile, routes.chat);
   }
@@ -58,8 +58,8 @@ export async function consumeSubscriptionExitUrl(
   returnTo: SubscriptionReturnTo,
   characterSlug: string = DEFAULT_CHARACTER_SLUG,
 ): Promise<string> {
-  if (returnTo === "private-room") {
-    return getCharacterRoutes(characterSlug).privateRoom;
+  if (returnTo === "private-zoom") {
+    return getCharacterRoutes(characterSlug).privateZoom;
   }
   if (returnTo === "profile") {
     return getSubscriptionFallbackExitUrl(returnTo, characterSlug);
@@ -75,8 +75,8 @@ export async function resolveSubscriptionSuccessExitUrl(
   returnTo: SubscriptionReturnTo,
   characterSlug: string = DEFAULT_CHARACTER_SLUG,
 ): Promise<string> {
-  if (returnTo === "private-room") {
-    return getCharacterRoutes(characterSlug).privateRoom;
+  if (returnTo === "private-zoom") {
+    return getCharacterRoutes(characterSlug).privateZoom;
   }
   if (returnTo === "profile") {
     return getSubscriptionFallbackExitUrl(returnTo, characterSlug);

src/lib/payment/__tests__/payment_search_params.test.ts

@@ -39,10 +39,10 @@ describe("payment search params", () => {
 
   it("accepts only supported subscription return targets", () => {
     expect(parseSubscriptionReturnTo("chat")).toBe("chat");
-    expect(parseSubscriptionReturnTo("private-room")).toBe("private-room");
+    expect(parseSubscriptionReturnTo("private-zoom")).toBe("private-zoom");
     expect(parseSubscriptionReturnTo("profile")).toBe("profile");
-    expect(parseSubscriptionReturnTo(["private-room", "chat"])).toBe(
-      "private-room",
+    expect(parseSubscriptionReturnTo(["private-zoom", "chat"])).toBe(
+      "private-zoom",
     );
     expect(parseSubscriptionReturnTo("tip")).toBeNull();
     expect(parseSubscriptionReturnTo(undefined)).toBeNull();

src/lib/payment/__tests__/pending_payment_order.test.ts

@@ -20,24 +20,24 @@ describe("pending payment order helpers", () => {
     );
   });
 
-  it("preserves private room returns when rebuilding Ezpay urls", () => {
+  it("preserves private zoom returns when rebuilding Ezpay urls", () => {
     expect(
       buildPendingPaymentSubscriptionUrl({
         payChannel: "ezpay",
-        returnTo: "private-room",
+        returnTo: "private-zoom",
         subscriptionType: "topup",
       }),
     ).toBe(
-      "/subscription?type=topup&payChannel=ezpay&paymentReturn=1&returnTo=private-room&character=elio",
+      "/subscription?type=topup&payChannel=ezpay&paymentReturn=1&returnTo=private-zoom&character=elio",
     );
   });
 
-  it("stores private room as an Ezpay return target", async () => {
+  it("stores private zoom as an Ezpay return target", async () => {
     await clearPendingPaymentOrder();
 
     const saveResult = await savePendingEzpayOrder({
-      orderId: "order-private-room",
-      returnTo: "private-room",
+      orderId: "order-private-zoom",
+      returnTo: "private-zoom",
       subscriptionType: "topup",
       createdAt: 1,
     });
@@ -47,8 +47,8 @@ describe("pending payment order helpers", () => {
     expect(storedResult).toMatchObject({
       success: true,
       data: {
-        orderId: "order-private-room",
-        returnTo: "private-room",
+        orderId: "order-private-zoom",
+        returnTo: "private-zoom",
       },
     });
     await clearPendingPaymentOrder();

src/lib/payment/payment_search_params.ts

@@ -28,7 +28,7 @@ export function parseSubscriptionReturnTo(
   const returnTo = getFirstPaymentSearchParam(value);
   if (
     returnTo === "chat" ||
-    returnTo === "private-room" ||
+    returnTo === "private-zoom" ||
     returnTo === "profile"
   ) {
     return returnTo;

src/lib/private-zoom/private_album.ts

@@ -1,4 +1,4 @@
-import type { PrivateAlbum } from "@/data/schemas/private-room";
+import type { PrivateAlbum } from "@/data/schemas/private-zoom";
 
 export function isPrivateAlbumLocked(album: PrivateAlbum): boolean {
   return album.locked || !album.unlocked || album.lockDetail.locked;

src/providers/__tests__/character-actor-scope-providers.test.tsx

@@ -7,7 +7,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 const instances = vi.hoisted(() => ({
   chat: 0,
   payment: 0,
-  privateRoom: 0,
+  privateZoom: 0,
 }));
 
 vi.mock("@/stores/chat/chat-context", async () => {
@@ -51,23 +51,23 @@ vi.mock("@/stores/payment/payment-context", async () => {
   };
 });
 
-vi.mock("@/stores/private-room", async () => {
+vi.mock("@/stores/private-zoom", async () => {
   const { createElement, useState } = await import("react");
   return {
-    PrivateRoomProvider({
+    PrivateZoomProvider({
       characterId,
       children,
     }: {
       characterId: string;
       children: ReactNode;
     }) {
-      const [instanceId] = useState(() => ++instances.privateRoom);
+      const [instanceId] = useState(() => ++instances.privateZoom);
       return createElement(
         "div",
         {
           "data-character-id": characterId,
           "data-instance-id": instanceId,
-          "data-testid": "private-room-provider",
+          "data-testid": "private-zoom-provider",
         },
         children,
       );
@@ -85,7 +85,7 @@ vi.mock("@/stores/sync/payment-success-sync", () => ({
 
 import { ChatRouteProviders } from "@/providers/chat-route-providers";
 import { PaymentRouteProvider } from "@/providers/payment-route-provider";
-import { PrivateRoomRouteProvider } from "@/providers/private-room-route-provider";
+import { PrivateZoomRouteProvider } from "@/providers/private-zoom-route-provider";
 
 describe("character actor route providers", () => {
   let container: HTMLDivElement;
@@ -94,7 +94,7 @@ describe("character actor route providers", () => {
   beforeEach(() => {
     instances.chat = 0;
     instances.payment = 0;
-    instances.privateRoom = 0;
+    instances.privateZoom = 0;
     (globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean })
       .IS_REACT_ACT_ENVIRONMENT = true;
     container = document.createElement("div");
@@ -121,14 +121,14 @@ describe("character actor route providers", () => {
     );
   });
 
-  it("recreates the private-room actor when the character changes", () => {
-    renderPrivateRoom("elio");
-    const firstInstance = instanceId("private-room-provider");
+  it("recreates the private-zoom actor when the character changes", () => {
+    renderPrivateZoom("elio");
+    const firstInstance = instanceId("private-zoom-provider");
 
-    renderPrivateRoom("maya-tan");
+    renderPrivateZoom("maya-tan");
 
-    expect(instanceId("private-room-provider")).not.toBe(firstInstance);
-    expect(testNode("private-room-provider").dataset.characterId).toBe(
+    expect(instanceId("private-zoom-provider")).not.toBe(firstInstance);
+    expect(testNode("private-zoom-provider").dataset.characterId).toBe(
       "maya-tan",
     );
   });
@@ -155,12 +155,12 @@ describe("character actor route providers", () => {
     });
   }
 
-  function renderPrivateRoom(characterId: string): void {
+  function renderPrivateZoom(characterId: string): void {
     act(() => {
       root.render(
-        <PrivateRoomRouteProvider characterId={characterId}>
-          <span>private room</span>
-        </PrivateRoomRouteProvider>,
+        <PrivateZoomRouteProvider characterId={characterId}>
+          <span>private zoom</span>
+        </PrivateZoomRouteProvider>,
       );
     });
   }

src/providers/private-room-route-provider.tsx

@@ -1,21 +0,0 @@
-"use client";
-
-import type { ReactNode } from "react";
-
-import { PrivateRoomProvider } from "@/stores/private-room";
-
-export interface PrivateRoomRouteProviderProps {
-  children: ReactNode;
-  characterId: string;
-}
-
-export function PrivateRoomRouteProvider({
-  children,
-  characterId,
-}: PrivateRoomRouteProviderProps) {
-  return (
-    <PrivateRoomProvider key={characterId} characterId={characterId}>
-      {children}
-    </PrivateRoomProvider>
-  );
-}

src/providers/private-zoom-route-provider.tsx

@@ -0,0 +1,21 @@
+"use client";
+
+import type { ReactNode } from "react";
+
+import { PrivateZoomProvider } from "@/stores/private-zoom";
+
+export interface PrivateZoomRouteProviderProps {
+  children: ReactNode;
+  characterId: string;
+}
+
+export function PrivateZoomRouteProvider({
+  children,
+  characterId,
+}: PrivateZoomRouteProviderProps) {
+  return (
+    <PrivateZoomProvider key={characterId} characterId={characterId}>
+      {children}
+    </PrivateZoomProvider>
+  );
+}

src/providers/root-providers.tsx

@@ -4,7 +4,7 @@
  * 根级 Client Providers 包装
  *
  * 这里只保留跨路由的 Character Catalog、Auth、User、消息预览和 viewport
- * Provider。Chat、Payment、PrivateRoom 状态机由对应路由 layout 按需挂载。
+ * Provider。Chat、Payment、PrivateZoom 状态机由对应路由 layout 按需挂载。
  */
 
 import type { ReactNode } from "react";

src/router/__tests__/global-route-context.test.ts

@@ -43,7 +43,7 @@ describe("global route context", () => {
     "https://example.com/characters/maya/chat",
     "//example.com/characters/maya/chat",
     "/characters/unknown/chat",
-    "/characters/maya/private-room",
+    "/characters/maya/private-zoom",
     "/characters/maya/chat?image=1",
   ])("falls back to Elio for an invalid return target", (value) => {
     expect(resolveGlobalRouteContextValue(value)).toBe(

src/router/__tests__/navigation-resolver.test.ts

@@ -54,15 +54,15 @@ describe("navigation resolver", () => {
     ).toBe(ROUTE_BUILDERS.authWithRedirect(subscriptionUrl));
   });
 
-  it("builds private room subscription return urls", () => {
+  it("builds private zoom subscription return urls", () => {
     expect(
       ROUTE_BUILDERS.subscription("topup", {
         payChannel: "stripe",
-        returnTo: "private-room",
+        returnTo: "private-zoom",
         sourceCharacterSlug: "maya",
       }),
     ).toBe(
-      "/subscription?type=topup&payChannel=stripe&returnTo=private-room&character=maya",
+      "/subscription?type=topup&payChannel=stripe&returnTo=private-zoom&character=maya",
     );
   });
 

src/router/__tests__/route-meta.test.ts

@@ -8,7 +8,7 @@ describe("route meta", () => {
     expect(getRouteAccess(ROUTES.splash)).toBe("authOnly");
     expect(getRouteAccess(ROUTES.auth)).toBe("authOnly");
     expect(getRouteAccess(ROUTES.chat)).toBe("guestEntry");
-    expect(getRouteAccess(ROUTES.privateRoom)).toBe("guestEntry");
+    expect(getRouteAccess(ROUTES.privateZoom)).toBe("guestEntry");
     expect(getRouteAccess(ROUTES.tip)).toBe("public");
     expect(getRouteAccess(ROUTES.externalEntry)).toBe("public");
     expect(getRouteAccess(ROUTES.profile)).toBe("realUser");
@@ -26,12 +26,12 @@ describe("route meta", () => {
     expect(routes).toEqual({
       splash: "/characters/maya/splash",
       chat: "/characters/maya/chat",
-      privateRoom: "/characters/maya/private-room",
+      privateZoom: "/characters/maya/private-zoom",
       tip: "/characters/maya/tip",
     });
     expect(getRouteAccess(routes.splash)).toBe("authOnly");
     expect(getRouteAccess(routes.chat)).toBe("guestEntry");
-    expect(getRouteAccess(routes.privateRoom)).toBe("guestEntry");
+    expect(getRouteAccess(routes.privateZoom)).toBe("guestEntry");
     expect(getRouteAccess(routes.tip)).toBe("public");
   });
 
@@ -41,8 +41,8 @@ describe("route meta", () => {
     expect(getRouteAccess("/characters/maya/coins-rules")).toBe("public");
   });
 
-  it("includes private room in static routes", () => {
-    expect(ALL_STATIC_ROUTES).toContain(ROUTES.privateRoom);
+  it("includes private zoom in static routes", () => {
+    expect(ALL_STATIC_ROUTES).toContain(ROUTES.privateZoom);
   });
 
   it("includes tip in static routes", () => {

src/router/navigation-types.ts

@@ -9,7 +9,7 @@ import type {
 export type AppSubscriptionType = "vip" | "topup";
 export type AppSubscriptionReturnTo =
   | "chat"
-  | "private-room"
+  | "private-zoom"
   | "profile"
   | null;
 

src/router/route-meta.ts

@@ -12,7 +12,7 @@ const GLOBAL_ROUTE_ACCESS: Partial<Record<string, RouteAccess>> = {
   [ROUTES.splash]: "authOnly",
   [ROUTES.auth]: "authOnly",
   [ROUTES.chat]: "guestEntry",
-  [ROUTES.privateRoom]: "guestEntry",
+  [ROUTES.privateZoom]: "guestEntry",
   [ROUTES.tip]: "public",
   [ROUTES.externalEntry]: "public",
   [ROUTES.profile]: "realUser",
@@ -24,7 +24,7 @@ const GLOBAL_ROUTE_ACCESS: Partial<Record<string, RouteAccess>> = {
 const CHARACTER_ROUTE_ACCESS: Readonly<Record<string, RouteAccess>> = {
   splash: "authOnly",
   chat: "guestEntry",
-  "private-room": "guestEntry",
+  "private-zoom": "guestEntry",
   tip: "public",
 };
 

src/router/routes.ts

@@ -21,7 +21,7 @@ export const ROUTES = {
   root: "/",
   splash: "/splash",
   chat: "/chat",
-  privateRoom: "/private-room",
+  privateZoom: "/private-zoom",
   tip: "/tip",
   externalEntry: "/external-entry",
   auth: "/auth",
@@ -36,7 +36,7 @@ export type StaticRoute = (typeof ROUTES)[keyof typeof ROUTES];
 export interface CharacterRoutes {
   readonly splash: string;
   readonly chat: string;
-  readonly privateRoom: string;
+  readonly privateZoom: string;
   readonly tip: string;
 }
 
@@ -47,7 +47,7 @@ export function getCharacterRoutes(
   return {
     splash: `${root}/splash`,
     chat: `${root}/chat`,
-    privateRoom: `${root}/private-room`,
+    privateZoom: `${root}/private-zoom`,
     tip: `${root}/tip`,
   };
 }
@@ -110,7 +110,7 @@ export const ROUTE_BUILDERS = {
 export const ALL_STATIC_ROUTES: readonly StaticRoute[] = [
   ROUTES.splash,
   ROUTES.chat,
-  ROUTES.privateRoom,
+  ROUTES.privateZoom,
   ROUTES.tip,
   ROUTES.externalEntry,
   ROUTES.auth,

src/stores/private-room/index.ts

@@ -1,7 +0,0 @@
-/** @file Private Room store barrel. */
-
-export * from "./private-room-context";
-export * from "./private-room-events";
-export * from "./helper";
-export * from "./private-room-machine";
-export * from "./private-room-state";

src/stores/private-room/private-room-events.ts

@@ -1,8 +0,0 @@
-/** Public events for one character-scoped Private Room actor. */
-export type PrivateRoomEvent =
-  | { type: "PrivateRoomInit" }
-  | { type: "PrivateRoomRefresh" }
-  | { type: "PrivateRoomUnlockRequested"; albumId: string }
-  | { type: "PrivateRoomUnlockConfirmed" }
-  | { type: "PrivateRoomUnlockCancelled" }
-  | { type: "PrivateRoomUnlockPaywallConsumed" };

src/stores/private-room/private-room-machine.ts

@@ -1,18 +0,0 @@
-import {
-  privateRoomMachineSetup,
-  privateRoomRootStateConfig,
-} from "./machine/unlock-flow";
-import { createInitialPrivateRoomState } from "./private-room-state";
-
-export type { PrivateRoomEvent } from "./private-room-events";
-export type { PrivateRoomState } from "./private-room-state";
-export { initialState } from "./private-room-state";
-
-export const privateRoomMachine = privateRoomMachineSetup.createMachine({
-  id: "privateRoom",
-  context: ({ input }) =>
-    createInitialPrivateRoomState(input.characterId),
-  ...privateRoomRootStateConfig,
-});
-
-export type PrivateRoomMachine = typeof privateRoomMachine;

src/stores/private-zoom/__tests__/private-zoom-album-flow.test.ts

@@ -2,18 +2,18 @@ import { describe, expect, it } from "vitest";
 import { createActor, waitFor } from "xstate";
 
 import {
-  createTestPrivateRoomMachine,
-  loadPrivateRoom,
+  createTestPrivateZoomMachine,
+  loadPrivateZoom,
   makeAlbum,
   makeAlbumsResponse,
-  TEST_PRIVATE_ROOM_INPUT,
-} from "./private-room-machine.test-utils";
+  TEST_PRIVATE_ZOOM_INPUT,
+} from "./private-zoom-machine.test-utils";
 
-describe("private room album flow", () => {
+describe("private zoom album flow", () => {
   it("loads albums for the supplied character", async () => {
     let loadedCharacterId: string | null = null;
     const actor = createActor(
-      createTestPrivateRoomMachine({
+      createTestPrivateZoomMachine({
         onLoad: ({ characterId }) => {
           loadedCharacterId = characterId;
         },
@@ -21,7 +21,7 @@ describe("private room album flow", () => {
       { input: { characterId: "character_aria" } },
     ).start();
 
-    actor.send({ type: "PrivateRoomInit" });
+    actor.send({ type: "PrivateZoomInit" });
     await waitFor(actor, (snapshot) => snapshot.matches("ready"));
 
     expect(actor.getSnapshot().context.characterId).toBe("character_aria");
@@ -30,7 +30,7 @@ describe("private room album flow", () => {
   });
 
   it("loads only the first non-paginated album page", async () => {
-    const actor = await loadPrivateRoom({
+    const actor = await loadPrivateZoom({
       loadResponse: makeAlbumsResponse({
         items: Array.from({ length: 20 }, (_, index) => makeAlbum(index)),
       }),
@@ -43,12 +43,12 @@ describe("private room album flow", () => {
 
   it("moves to failed when the album actor rejects", async () => {
     const actor = createActor(
-      createTestPrivateRoomMachine({
+      createTestPrivateZoomMachine({
         loadError: new Error("albums unavailable"),
       }),
-      { input: TEST_PRIVATE_ROOM_INPUT },
+      { input: TEST_PRIVATE_ZOOM_INPUT },
     ).start();
-    actor.send({ type: "PrivateRoomInit" });
+    actor.send({ type: "PrivateZoomInit" });
     await waitFor(actor, (snapshot) => snapshot.matches("failed"));
     expect(actor.getSnapshot().context.errorMessage).toBe(
       "albums unavailable",

src/stores/private-zoom/__tests__/private-zoom-machine.test-utils.ts

@@ -8,13 +8,13 @@ import {
   type PrivateAlbumUnlockResponseInput,
   type PrivateAlbumsResponse,
   type PrivateAlbumsResponseInput,
-} from "@/data/schemas/private-room";
-import { privateRoomMachine } from "@/stores/private-room/private-room-machine";
+} from "@/data/schemas/private-zoom";
+import { privateZoomMachine } from "@/stores/private-zoom/private-zoom-machine";
 
 export const ALBUM_ID = "a1b2c3d4-0000-0000-0000-000000000000";
 export const COVER_URL =
   "https://dbapi.banlv-ai.com/storage/v1/object/public/elio-schedules/01.jpg";
-export const TEST_PRIVATE_ROOM_INPUT = {
+export const TEST_PRIVATE_ZOOM_INPUT = {
   characterId: DEFAULT_CHARACTER_ID,
 };
 
@@ -65,7 +65,7 @@ export function makeUnlockResponse(
   });
 }
 
-export function createTestPrivateRoomMachine(
+export function createTestPrivateZoomMachine(
   options: {
     loadResponse?: PrivateAlbumsResponse;
     unlockResponse?: PrivateAlbumUnlockResponse;
@@ -74,7 +74,7 @@ export function createTestPrivateRoomMachine(
     onLoad?: (input: { characterId: string }) => void;
   } = {},
 ) {
-  return privateRoomMachine.provide({
+  return privateZoomMachine.provide({
     actors: {
       loadAlbums: fromPromise<PrivateAlbumsResponse, { characterId: string }>(
         async ({ input }) => {
@@ -91,24 +91,24 @@ export function createTestPrivateRoomMachine(
   });
 }
 
-export async function loadPrivateRoom(
-  options: Parameters<typeof createTestPrivateRoomMachine>[0] = {},
+export async function loadPrivateZoom(
+  options: Parameters<typeof createTestPrivateZoomMachine>[0] = {},
 ) {
-  const actor = createActor(createTestPrivateRoomMachine(options), {
-    input: TEST_PRIVATE_ROOM_INPUT,
+  const actor = createActor(createTestPrivateZoomMachine(options), {
+    input: TEST_PRIVATE_ZOOM_INPUT,
   }).start();
-  actor.send({ type: "PrivateRoomInit" });
+  actor.send({ type: "PrivateZoomInit" });
   await waitFor(actor, (snapshot) => snapshot.matches("ready"));
   return actor;
 }
 
 export async function unlockFirstAlbum(
-  actor: Awaited<ReturnType<typeof loadPrivateRoom>>,
+  actor: Awaited<ReturnType<typeof loadPrivateZoom>>,
 ) {
   actor.send({
-    type: "PrivateRoomUnlockRequested",
+    type: "PrivateZoomUnlockRequested",
     albumId: ALBUM_ID,
   });
-  actor.send({ type: "PrivateRoomUnlockConfirmed" });
+  actor.send({ type: "PrivateZoomUnlockConfirmed" });
   await waitFor(actor, (snapshot) => snapshot.matches("ready"));
 }

src/stores/private-zoom/__tests__/private-zoom-unlock-flow.test.ts

@@ -3,14 +3,14 @@ import { describe, expect, it } from "vitest";
 import {
   ALBUM_ID,
   COVER_URL,
-  loadPrivateRoom,
+  loadPrivateZoom,
   makeUnlockResponse,
   unlockFirstAlbum,
-} from "./private-room-machine.test-utils";
+} from "./private-zoom-machine.test-utils";
 
-describe("private room unlock flow", () => {
+describe("private zoom unlock flow", () => {
   it("patches album images after a successful unlock", async () => {
-    const actor = await loadPrivateRoom();
+    const actor = await loadPrivateZoom();
     await unlockFirstAlbum(actor);
     expect(actor.getSnapshot().context.items[0]).toMatchObject({
       albumId: ALBUM_ID,
@@ -24,7 +24,7 @@ describe("private room unlock flow", () => {
   });
 
   it("exposes a paywall request when credits are low", async () => {
-    const actor = await loadPrivateRoom({
+    const actor = await loadPrivateZoom({
       unlockResponse: makeUnlockResponse({
         locked: true,
         unlocked: false,
@@ -47,7 +47,7 @@ describe("private room unlock flow", () => {
 
   it("reloads when expected cost changes", async () => {
     let loadCount = 0;
-    const actor = await loadPrivateRoom({
+    const actor = await loadPrivateZoom({
       onLoad: () => {
         loadCount += 1;
       },
@@ -66,7 +66,7 @@ describe("private room unlock flow", () => {
   });
 
   it("removes an album that no longer exists", async () => {
-    const actor = await loadPrivateRoom({
+    const actor = await loadPrivateZoom({
       unlockResponse: makeUnlockResponse({
         locked: true,
         unlocked: false,
@@ -80,7 +80,7 @@ describe("private room unlock flow", () => {
   });
 
   it("keeps refunded persistence failures locked", async () => {
-    const actor = await loadPrivateRoom({
+    const actor = await loadPrivateZoom({
       unlockResponse: makeUnlockResponse({
         locked: true,
         unlocked: false,
@@ -99,7 +99,7 @@ describe("private room unlock flow", () => {
   });
 
   it("returns to ready when the unlock actor rejects", async () => {
-    const actor = await loadPrivateRoom({
+    const actor = await loadPrivateZoom({
       unlockError: new Error("unlock unavailable"),
     });
     await unlockFirstAlbum(actor);

src/stores/private-zoom/helper/albums.ts

@@ -3,15 +3,15 @@ import {
   PrivateAlbumSchema,
   type PrivateAlbumsResponse,
   type PrivateAlbumUnlockResponse,
-} from "@/data/schemas/private-room";
+} from "@/data/schemas/private-zoom";
 
-import type { PrivateRoomState } from "../private-room-state";
+import type { PrivateZoomState } from "../private-zoom-state";
 
-export const PRIVATE_ROOM_PAGE_SIZE = 20;
+export const PRIVATE_ZOOM_PAGE_SIZE = 20;
 
 export function applyAlbumsResponse(
   response: PrivateAlbumsResponse,
-): Partial<PrivateRoomState> {
+): Partial<PrivateZoomState> {
   return {
     items: response.items,
     creditBalance: response.creditBalance,
@@ -20,7 +20,7 @@ export function applyAlbumsResponse(
 }
 
 export function getPendingAlbum(
-  context: PrivateRoomState,
+  context: PrivateZoomState,
 ): PrivateAlbum | null {
   if (!context.pendingConfirmAlbumId) return null;
   return (

src/stores/private-zoom/helper/unlock.ts

@@ -1,10 +1,10 @@
-import type { PrivateAlbumUnlockResponse } from "@/data/schemas/private-room";
+import type { PrivateAlbumUnlockResponse } from "@/data/schemas/private-zoom";
 
-import type { PrivateRoomUnlockPaywallRequest } from "../private-room-state";
+import type { PrivateZoomUnlockPaywallRequest } from "../private-zoom-state";
 
-export function toPrivateRoomErrorMessage(error: unknown): string {
+export function toPrivateZoomErrorMessage(error: unknown): string {
   if (error instanceof Error && error.message) return error.message;
-  return "Private room is temporarily unavailable. Please try again.";
+  return "Private Zoom is temporarily unavailable. Please try again.";
 }
 
 export function toUnlockErrorMessage(
@@ -30,7 +30,7 @@ export function toUnlockErrorMessage(
 
 export function toPaywallRequest(
   response: PrivateAlbumUnlockResponse,
-): PrivateRoomUnlockPaywallRequest {
+): PrivateZoomUnlockPaywallRequest {
   return {
     albumId: response.albumId,
     reason: response.reason,

src/stores/private-zoom/index.ts

@@ -0,0 +1,7 @@
+/** @file Private Zoom store barrel. */
+
+export * from "./private-zoom-context";
+export * from "./private-zoom-events";
+export * from "./helper";
+export * from "./private-zoom-machine";
+export * from "./private-zoom-state";

src/stores/private-zoom/machine/actors/albums.ts

@@ -3,19 +3,19 @@ import { fromPromise } from "xstate";
 import type {
   PrivateAlbumsResponse,
   PrivateAlbumUnlockResponse,
-} from "@/data/schemas/private-room";
-import { getPrivateRoomRepository } from "@/data/repositories/private_room_repository";
+} from "@/data/schemas/private-zoom";
+import { getPrivateZoomRepository } from "@/data/repositories/private_zoom_repository";
 import { Result } from "@/utils/result";
 
-import { PRIVATE_ROOM_PAGE_SIZE } from "../../helper/albums";
+import { PRIVATE_ZOOM_PAGE_SIZE } from "../../helper/albums";
 
 export const loadPrivateAlbumsActor =
   fromPromise<PrivateAlbumsResponse, { characterId: string }>(async ({
     input,
   }) => {
-    const result = await getPrivateRoomRepository().getAlbums({
+    const result = await getPrivateZoomRepository().getAlbums({
       characterId: input.characterId,
-      limit: PRIVATE_ROOM_PAGE_SIZE,
+      limit: PRIVATE_ZOOM_PAGE_SIZE,
     });
     if (Result.isErr(result)) throw result.error;
     return result.data;
@@ -25,7 +25,7 @@ export const unlockPrivateAlbumActor = fromPromise<
   PrivateAlbumUnlockResponse,
   { albumId: string; expectedCost: number }
 >(async ({ input }) => {
-  const result = await getPrivateRoomRepository().unlockAlbum(
+  const result = await getPrivateZoomRepository().unlockAlbum(
     input.albumId,
     input.expectedCost,
   );

src/stores/private-zoom/machine/album-flow.ts

@@ -1,43 +1,43 @@
 import type { DoneActorEvent, ErrorActorEvent } from "xstate";
 
-import type { PrivateAlbumsResponse } from "@/data/schemas/private-room";
+import type { PrivateAlbumsResponse } from "@/data/schemas/private-zoom";
 
 import { applyAlbumsResponse } from "../helper/albums";
-import { toPrivateRoomErrorMessage } from "../helper/unlock";
+import { toPrivateZoomErrorMessage } from "../helper/unlock";
 import {
-  basePrivateRoomMachineSetup,
-  createPrivateRoomActorActionSetup,
+  basePrivateZoomMachineSetup,
+  createPrivateZoomActorActionSetup,
 } from "./setup";
 
-const clearAlbumLoadStateAction = basePrivateRoomMachineSetup.assign({
+const clearAlbumLoadStateAction = basePrivateZoomMachineSetup.assign({
   errorMessage: null,
   unlockPaywallRequest: null,
 });
 
-export const albumMachineSetup = basePrivateRoomMachineSetup.extend({
+export const albumMachineSetup = basePrivateZoomMachineSetup.extend({
   actions: {
     clearAlbumLoadState: clearAlbumLoadStateAction,
   },
 });
 
 const albumsDoneSetup =
-  createPrivateRoomActorActionSetup<
+  createPrivateZoomActorActionSetup<
     DoneActorEvent<PrivateAlbumsResponse>
   >();
 const albumErrorSetup =
-  createPrivateRoomActorActionSetup<ErrorActorEvent>();
+  createPrivateZoomActorActionSetup<ErrorActorEvent>();
 
 const applyAlbumsResponseAction = albumsDoneSetup.assign(({ event }) =>
   applyAlbumsResponse(event.output),
 );
 
 const applyAlbumLoadErrorAction = albumErrorSetup.assign(({ event }) => ({
-  errorMessage: toPrivateRoomErrorMessage(event.error),
+  errorMessage: toPrivateZoomErrorMessage(event.error),
 }));
 
 export const idleState = albumMachineSetup.createStateConfig({
   on: {
-    PrivateRoomInit: "loading",
+    PrivateZoomInit: "loading",
   },
 });
 
@@ -59,7 +59,7 @@ export const loadingState = albumMachineSetup.createStateConfig({
 
 export const failedState = albumMachineSetup.createStateConfig({
   on: {
-    PrivateRoomInit: "loading",
-    PrivateRoomRefresh: "loading",
+    PrivateZoomInit: "loading",
+    PrivateZoomRefresh: "loading",
   },
 });

src/stores/private-zoom/machine/setup.ts

@@ -1,22 +1,22 @@
 import { setup, type ActionFunction, type EventObject } from "xstate";
 
 import { getPendingAlbum } from "../helper/albums";
-import type { PrivateRoomEvent } from "../private-room-events";
-import type { PrivateRoomState } from "../private-room-state";
+import type { PrivateZoomEvent } from "../private-zoom-events";
+import type { PrivateZoomState } from "../private-zoom-state";
 import {
   loadPrivateAlbumsActor,
   unlockPrivateAlbumActor,
 } from "./actors/albums";
 
-export interface PrivateRoomMachineInput {
+export interface PrivateZoomMachineInput {
   characterId: string;
 }
 
-export const basePrivateRoomMachineSetup = setup({
+export const basePrivateZoomMachineSetup = setup({
   types: {
-    context: {} as PrivateRoomState,
-    events: {} as PrivateRoomEvent,
-    input: {} as PrivateRoomMachineInput,
+    context: {} as PrivateZoomState,
+    events: {} as PrivateZoomEvent,
+    input: {} as PrivateZoomMachineInput,
   },
   actors: {
     loadAlbums: loadPrivateAlbumsActor,
@@ -27,10 +27,10 @@ export const basePrivateRoomMachineSetup = setup({
   },
 });
 
-type PrivateRoomActorAction<TEvent extends EventObject> = ActionFunction<
-  PrivateRoomState,
+type PrivateZoomActorAction<TEvent extends EventObject> = ActionFunction<
+  PrivateZoomState,
   TEvent,
-  PrivateRoomEvent,
+  PrivateZoomEvent,
   undefined,
   never,
   never,
@@ -39,22 +39,22 @@ type PrivateRoomActorAction<TEvent extends EventObject> = ActionFunction<
   never
 >;
 
-export function createPrivateRoomActorActionSetup<
+export function createPrivateZoomActorActionSetup<
   TEvent extends EventObject,
 >() {
   const actorActionSetup = setup({
     types: {
-      context: {} as PrivateRoomState,
+      context: {} as PrivateZoomState,
       events: {} as TEvent,
     },
   });
   return {
     assign(
       assignment: Parameters<typeof actorActionSetup.assign>[0],
-    ): PrivateRoomActorAction<TEvent> {
+    ): PrivateZoomActorAction<TEvent> {
       return actorActionSetup.assign(
         assignment,
-      ) as unknown as PrivateRoomActorAction<TEvent>;
+      ) as unknown as PrivateZoomActorAction<TEvent>;
     },
   };
 }

src/stores/private-zoom/machine/unlock-flow.ts

@@ -1,6 +1,6 @@
 import type { DoneActorEvent, ErrorActorEvent } from "xstate";
 
-import type { PrivateAlbumUnlockResponse } from "@/data/schemas/private-room";
+import type { PrivateAlbumUnlockResponse } from "@/data/schemas/private-zoom";
 
 import {
   getPendingAlbum,
@@ -9,7 +9,7 @@ import {
 } from "../helper/albums";
 import {
   toPaywallRequest,
-  toPrivateRoomErrorMessage,
+  toPrivateZoomErrorMessage,
   toUnlockErrorMessage,
 } from "../helper/unlock";
 import {
@@ -18,10 +18,10 @@ import {
   idleState,
   loadingState,
 } from "./album-flow";
-import { createPrivateRoomActorActionSetup } from "./setup";
+import { createPrivateZoomActorActionSetup } from "./setup";
 
 const requestUnlockAction = albumMachineSetup.assign(({ event }) =>
-  event.type === "PrivateRoomUnlockRequested"
+  event.type === "PrivateZoomUnlockRequested"
     ? {
         pendingConfirmAlbumId: event.albumId,
         unlockErrorMessage: null,
@@ -44,7 +44,7 @@ const beginUnlockAction = albumMachineSetup.assign(({ context }) => ({
   unlockPaywallRequest: null,
 }));
 
-export const privateRoomMachineSetup = albumMachineSetup.extend({
+export const privateZoomMachineSetup = albumMachineSetup.extend({
   actions: {
     requestUnlock: requestUnlockAction,
     cancelUnlock: cancelUnlockAction,
@@ -54,11 +54,11 @@ export const privateRoomMachineSetup = albumMachineSetup.extend({
 });
 
 const unlockDoneSetup =
-  createPrivateRoomActorActionSetup<
+  createPrivateZoomActorActionSetup<
     DoneActorEvent<PrivateAlbumUnlockResponse>
   >();
 const unlockErrorSetup =
-  createPrivateRoomActorActionSetup<ErrorActorEvent>();
+  createPrivateZoomActorActionSetup<ErrorActorEvent>();
 
 const applyUnlockSuccessAction = unlockDoneSetup.assign(
   ({ context, event }) => ({
@@ -111,26 +111,26 @@ const applyUnlockFailureAction = unlockDoneSetup.assign(
 const applyUnlockActorErrorAction = unlockErrorSetup.assign(({ event }) => ({
   pendingConfirmAlbumId: null,
   unlockingAlbumId: null,
-  unlockErrorMessage: toPrivateRoomErrorMessage(event.error),
+  unlockErrorMessage: toPrivateZoomErrorMessage(event.error),
 }));
 
-const readyState = privateRoomMachineSetup.createStateConfig({
+const readyState = privateZoomMachineSetup.createStateConfig({
   on: {
-    PrivateRoomInit: "loading",
-    PrivateRoomRefresh: "loading",
-    PrivateRoomUnlockRequested: { actions: "requestUnlock" },
-    PrivateRoomUnlockCancelled: { actions: "cancelUnlock" },
-    PrivateRoomUnlockConfirmed: [
+    PrivateZoomInit: "loading",
+    PrivateZoomRefresh: "loading",
+    PrivateZoomUnlockRequested: { actions: "requestUnlock" },
+    PrivateZoomUnlockCancelled: { actions: "cancelUnlock" },
+    PrivateZoomUnlockConfirmed: [
       {
         guard: "hasPendingAlbum",
         target: "unlocking",
       },
     ],
-    PrivateRoomUnlockPaywallConsumed: { actions: "clearUnlockPaywall" },
+    PrivateZoomUnlockPaywallConsumed: { actions: "clearUnlockPaywall" },
   },
 });
 
-const unlockingState = privateRoomMachineSetup.createStateConfig({
+const unlockingState = privateZoomMachineSetup.createStateConfig({
   entry: "beginUnlock",
   invoke: {
     src: "unlockAlbum",
@@ -175,8 +175,8 @@ const unlockingState = privateRoomMachineSetup.createStateConfig({
   },
 });
 
-export const privateRoomRootStateConfig =
-  privateRoomMachineSetup.createStateConfig({
+export const privateZoomRootStateConfig =
+  privateZoomMachineSetup.createStateConfig({
     initial: "idle",
     states: {
       idle: idleState,

src/stores/private-zoom/private-zoom-context.tsx

@@ -4,14 +4,14 @@ import type { Dispatch, ReactNode } from "react";
 import { createActorContext, shallowEqual } from "@xstate/react";
 import type { SnapshotFrom } from "xstate";
 
-import { privateRoomMachine } from "./private-room-machine";
+import { privateZoomMachine } from "./private-zoom-machine";
 import type {
-  PrivateRoomEvent,
-  PrivateRoomState as MachineContext,
-} from "./private-room-machine";
+  PrivateZoomEvent,
+  PrivateZoomState as MachineContext,
+} from "./private-zoom-machine";
 
-/** Route UI reads this projection instead of the Private Room snapshot. */
-export interface PrivateRoomContextState {
+/** Route UI reads this projection instead of the Private Zoom snapshot. */
+export interface PrivateZoomContextState {
   characterId: string;
   status: string;
   items: MachineContext["items"];
@@ -26,45 +26,45 @@ export interface PrivateRoomContextState {
   isUnlocking: boolean;
 }
 
-type PrivateRoomSnapshot = SnapshotFrom<typeof privateRoomMachine>;
-type PrivateRoomSelector<T> = (snapshot: PrivateRoomSnapshot) => T;
+type PrivateZoomSnapshot = SnapshotFrom<typeof privateZoomMachine>;
+type PrivateZoomSelector<T> = (snapshot: PrivateZoomSnapshot) => T;
 
-const PrivateRoomActorContext = createActorContext(privateRoomMachine);
+const PrivateZoomActorContext = createActorContext(privateZoomMachine);
 
-export interface PrivateRoomProviderProps {
+export interface PrivateZoomProviderProps {
   children: ReactNode;
   characterId: string;
 }
 
-export function PrivateRoomProvider({
+export function PrivateZoomProvider({
   children,
   characterId,
-}: PrivateRoomProviderProps) {
+}: PrivateZoomProviderProps) {
   return (
-    <PrivateRoomActorContext.Provider options={{ input: { characterId } }}>
+    <PrivateZoomActorContext.Provider options={{ input: { characterId } }}>
       {children}
-    </PrivateRoomActorContext.Provider>
+    </PrivateZoomActorContext.Provider>
   );
 }
 
-export function usePrivateRoomState(): PrivateRoomContextState {
-  return usePrivateRoomSelector(selectPrivateRoomState, shallowEqual);
+export function usePrivateZoomState(): PrivateZoomContextState {
+  return usePrivateZoomSelector(selectPrivateZoomState, shallowEqual);
 }
 
-export function usePrivateRoomDispatch(): Dispatch<PrivateRoomEvent> {
-  return PrivateRoomActorContext.useActorRef().send;
+export function usePrivateZoomDispatch(): Dispatch<PrivateZoomEvent> {
+  return PrivateZoomActorContext.useActorRef().send;
 }
 
-export function usePrivateRoomSelector<T>(
-  selector: PrivateRoomSelector<T>,
+export function usePrivateZoomSelector<T>(
+  selector: PrivateZoomSelector<T>,
   compare?: (previous: T, next: T) => boolean,
 ): T {
-  return PrivateRoomActorContext.useSelector(selector, compare);
+  return PrivateZoomActorContext.useSelector(selector, compare);
 }
 
-function selectPrivateRoomState(
-  state: PrivateRoomSnapshot,
-): PrivateRoomContextState {
+function selectPrivateZoomState(
+  state: PrivateZoomSnapshot,
+): PrivateZoomContextState {
   return {
     characterId: state.context.characterId,
     status: String(state.value),

src/stores/private-zoom/private-zoom-events.ts

@@ -0,0 +1,8 @@
+/** Public events for one character-scoped Private Zoom actor. */
+export type PrivateZoomEvent =
+  | { type: "PrivateZoomInit" }
+  | { type: "PrivateZoomRefresh" }
+  | { type: "PrivateZoomUnlockRequested"; albumId: string }
+  | { type: "PrivateZoomUnlockConfirmed" }
+  | { type: "PrivateZoomUnlockCancelled" }
+  | { type: "PrivateZoomUnlockPaywallConsumed" };

src/stores/private-zoom/private-zoom-machine.ts

@@ -0,0 +1,18 @@
+import {
+  privateZoomMachineSetup,
+  privateZoomRootStateConfig,
+} from "./machine/unlock-flow";
+import { createInitialPrivateZoomState } from "./private-zoom-state";
+
+export type { PrivateZoomEvent } from "./private-zoom-events";
+export type { PrivateZoomState } from "./private-zoom-state";
+export { initialState } from "./private-zoom-state";
+
+export const privateZoomMachine = privateZoomMachineSetup.createMachine({
+  id: "privateZoom",
+  context: ({ input }) =>
+    createInitialPrivateZoomState(input.characterId),
+  ...privateZoomRootStateConfig,
+});
+
+export type PrivateZoomMachine = typeof privateZoomMachine;

src/stores/private-zoom/private-zoom-state.ts

@@ -1,7 +1,7 @@
 import { DEFAULT_CHARACTER_ID } from "@/data/constants/character";
-import type { PrivateAlbum } from "@/data/schemas/private-room";
+import type { PrivateAlbum } from "@/data/schemas/private-zoom";
 
-export interface PrivateRoomUnlockPaywallRequest {
+export interface PrivateZoomUnlockPaywallRequest {
   albumId: string;
   reason: string;
   requiredCredits: number;
@@ -9,7 +9,7 @@ export interface PrivateRoomUnlockPaywallRequest {
   shortfallCredits: number;
 }
 
-export interface PrivateRoomState {
+export interface PrivateZoomState {
   characterId: string;
   items: readonly PrivateAlbum[];
   creditBalance: number;
@@ -17,13 +17,13 @@ export interface PrivateRoomState {
   unlockingAlbumId: string | null;
   unlockErrorMessage: string | null;
   pendingConfirmAlbumId: string | null;
-  unlockPaywallRequest: PrivateRoomUnlockPaywallRequest | null;
+  unlockPaywallRequest: PrivateZoomUnlockPaywallRequest | null;
   unlockSuccessNonce: number;
 }
 
-export function createInitialPrivateRoomState(
+export function createInitialPrivateZoomState(
   characterId: string,
-): PrivateRoomState {
+): PrivateZoomState {
   return {
     characterId,
     items: [],
@@ -37,4 +37,4 @@ export function createInitialPrivateRoomState(
   };
 }
 
-export const initialState = createInitialPrivateRoomState(DEFAULT_CHARACTER_ID);
+export const initialState = createInitialPrivateZoomState(DEFAULT_CHARACTER_ID);