Added opaque join-token support across backend and frontend: new migration/model/service/endpoints, guest controllers now resolve tokens, and the demo seeder seeds a token. Tenant event details list/manage tokens with copy/revoke actions, and the guest PWA uses tokens end-to-end (routing, storage, uploads, achievements, etc.). Docs TODO updated to reflect completed steps.

resources/js/guest/context/EventStatsContext.tsx

@@ -2,16 +2,17 @@ import React from 'react';
 import { usePollStats } from '../polling/usePollStats';
 
 type EventStatsContextValue = ReturnType<typeof usePollStats> & {
+  eventKey: string;
   slug: string;
 };
 
 const EventStatsContext = React.createContext<EventStatsContextValue | undefined>(undefined);
 
-export function EventStatsProvider({ slug, children }: { slug: string; children: React.ReactNode }) {
-  const stats = usePollStats(slug);
+export function EventStatsProvider({ eventKey, children }: { eventKey: string; children: React.ReactNode }) {
+  const stats = usePollStats(eventKey);
   const value = React.useMemo<EventStatsContextValue>(
-    () => ({ slug, ...stats }),
-    [slug, stats.onlineGuests, stats.tasksSolved, stats.latestPhotoAt, stats.loading]
+    () => ({ eventKey, slug: eventKey, ...stats }),
+    [eventKey, stats.onlineGuests, stats.tasksSolved, stats.latestPhotoAt, stats.loading]
   );
   return <EventStatsContext.Provider value={value}>{children}</EventStatsContext.Provider>;
 }

resources/js/guest/context/GuestIdentityContext.tsx

@@ -1,7 +1,8 @@
 import React from 'react';
 
 type GuestIdentityContextValue = {
-  slug: string;
+  eventKey: string;
+  slug: string; // backward-compatible alias
   name: string;
   hydrated: boolean;
   setName: (nextName: string) => void;
@@ -11,36 +12,36 @@ type GuestIdentityContextValue = {
 
 const GuestIdentityContext = React.createContext<GuestIdentityContextValue | undefined>(undefined);
 
-function storageKey(slug: string) {
-  return `guestName_${slug}`;
+function storageKey(eventKey: string) {
+  return `guestName_${eventKey}`;
 }
 
-export function readGuestName(slug: string) {
-  if (!slug || typeof window === 'undefined') {
+export function readGuestName(eventKey: string) {
+  if (!eventKey || typeof window === 'undefined') {
     return '';
   }
 
   try {
-    return window.localStorage.getItem(storageKey(slug)) ?? '';
+    return window.localStorage.getItem(storageKey(eventKey)) ?? '';
   } catch (error) {
     console.warn('Failed to read guest name', error);
     return '';
   }
 }
 
-export function GuestIdentityProvider({ slug, children }: { slug: string; children: React.ReactNode }) {
+export function GuestIdentityProvider({ eventKey, children }: { eventKey: string; children: React.ReactNode }) {
   const [name, setNameState] = React.useState('');
   const [hydrated, setHydrated] = React.useState(false);
 
   const loadFromStorage = React.useCallback(() => {
-    if (!slug) {
+    if (!eventKey) {
       setHydrated(true);
       setNameState('');
       return;
     }
 
     try {
-      const stored = window.localStorage.getItem(storageKey(slug));
+      const stored = window.localStorage.getItem(storageKey(eventKey));
       setNameState(stored ?? '');
     } catch (error) {
       console.warn('Failed to read guest name from storage', error);
@@ -48,7 +49,7 @@ export function GuestIdentityProvider({ slug, children }: { slug: string; childr
     } finally {
       setHydrated(true);
     }
-  }, [slug]);
+  }, [eventKey]);
 
   React.useEffect(() => {
     setHydrated(false);
@@ -61,36 +62,37 @@ export function GuestIdentityProvider({ slug, children }: { slug: string; childr
       setNameState(trimmed);
       try {
         if (trimmed) {
-          window.localStorage.setItem(storageKey(slug), trimmed);
+          window.localStorage.setItem(storageKey(eventKey), trimmed);
         } else {
-          window.localStorage.removeItem(storageKey(slug));
+          window.localStorage.removeItem(storageKey(eventKey));
         }
       } catch (error) {
         console.warn('Failed to persist guest name', error);
       }
     },
-    [slug]
+    [eventKey]
   );
 
   const clearName = React.useCallback(() => {
     setNameState('');
     try {
-      window.localStorage.removeItem(storageKey(slug));
+      window.localStorage.removeItem(storageKey(eventKey));
     } catch (error) {
       console.warn('Failed to clear guest name', error);
     }
-  }, [slug]);
+  }, [eventKey]);
 
   const value = React.useMemo<GuestIdentityContextValue>(
     () => ({
-      slug,
+      eventKey,
+      slug: eventKey,
       name,
       hydrated,
       setName: persistName,
       clearName,
       reload: loadFromStorage,
     }),
-    [slug, name, hydrated, persistName, clearName, loadFromStorage]
+    [eventKey, name, hydrated, persistName, clearName, loadFromStorage]
   );
 
   return <GuestIdentityContext.Provider value={value}>{children}</GuestIdentityContext.Provider>;