feat: add session replay functionality with privacy controls

This commit is contained in:
Usman Baig
2026-01-19 12:43:02 +01:00
parent c8695ff964
commit a740b0d703
8 changed files with 1434 additions and 12 deletions

View File

@@ -2,7 +2,7 @@
import { useEffect, useState } from 'react'
import { useParams, useRouter } from 'next/navigation'
import { getSite, updateSite, resetSiteData, deleteSite, type Site, type GeoDataLevel } from '@/lib/api/sites'
import { getSite, updateSite, resetSiteData, deleteSite, type Site, type GeoDataLevel, type ReplayMode } from '@/lib/api/sites'
import { getRealtime } from '@/lib/api/stats'
import { toast } from 'sonner'
import LoadingOverlay from '@/components/LoadingOverlay'
@@ -18,6 +18,7 @@ import {
CopyIcon,
ExclamationTriangleIcon,
LightningBoltIcon,
VideoIcon,
} from '@radix-ui/react-icons'
const TIMEZONES = [
@@ -45,7 +46,7 @@ export default function SiteSettingsPage() {
const [site, setSite] = useState<Site | null>(null)
const [loading, setLoading] = useState(true)
const [saving, setSaving] = useState(false)
const [activeTab, setActiveTab] = useState<'general' | 'visibility' | 'data'>('general')
const [activeTab, setActiveTab] = useState<'general' | 'visibility' | 'data' | 'replay'>('general')
const [formData, setFormData] = useState({
name: '',
@@ -58,7 +59,13 @@ export default function SiteSettingsPage() {
collect_referrers: true,
collect_device_info: true,
collect_geo_data: 'full' as GeoDataLevel,
collect_screen_resolution: true
collect_screen_resolution: true,
// Session replay settings
replay_mode: 'disabled' as ReplayMode,
replay_sampling_rate: 100,
replay_retention_days: 30,
replay_mask_all_text: false,
replay_mask_all_inputs: true
})
const [scriptCopied, setScriptCopied] = useState(false)
const [linkCopied, setLinkCopied] = useState(false)
@@ -85,7 +92,13 @@ export default function SiteSettingsPage() {
collect_referrers: data.collect_referrers ?? true,
collect_device_info: data.collect_device_info ?? true,
collect_geo_data: data.collect_geo_data || 'full',
collect_screen_resolution: data.collect_screen_resolution ?? true
collect_screen_resolution: data.collect_screen_resolution ?? true,
// Session replay settings
replay_mode: data.replay_mode || 'disabled',
replay_sampling_rate: data.replay_sampling_rate ?? 100,
replay_retention_days: data.replay_retention_days ?? 30,
replay_mask_all_text: data.replay_mask_all_text ?? false,
replay_mask_all_inputs: data.replay_mask_all_inputs ?? true
})
if (data.has_password) {
setIsPasswordEnabled(true)
@@ -121,7 +134,13 @@ export default function SiteSettingsPage() {
collect_referrers: formData.collect_referrers,
collect_device_info: formData.collect_device_info,
collect_geo_data: formData.collect_geo_data,
collect_screen_resolution: formData.collect_screen_resolution
collect_screen_resolution: formData.collect_screen_resolution,
// Session replay settings
replay_mode: formData.replay_mode,
replay_sampling_rate: formData.replay_sampling_rate,
replay_retention_days: formData.replay_retention_days,
replay_mask_all_text: formData.replay_mask_all_text,
replay_mask_all_inputs: formData.replay_mask_all_inputs
})
toast.success('Site updated successfully')
loadSite()
@@ -235,6 +254,17 @@ export default function SiteSettingsPage() {
<FileTextIcon className="w-5 h-5" />
Data & Privacy
</button>
<button
onClick={() => setActiveTab('replay')}
className={`w-full flex items-center gap-3 px-4 py-3 text-sm font-medium rounded-xl transition-all duration-200 ${
activeTab === 'replay'
? 'bg-brand-orange/10 text-brand-orange'
: 'text-neutral-600 dark:text-neutral-400 hover:bg-neutral-100 dark:hover:bg-neutral-800'
}`}
>
<VideoIcon className="w-5 h-5" />
Session Replay
</button>
</nav>
{/* Content Area */}
@@ -703,6 +733,263 @@ export default function SiteSettingsPage() {
</form>
</div>
)}
{activeTab === 'replay' && (
<div className="space-y-12">
<form onSubmit={handleSubmit} className="space-y-6">
<div>
<h2 className="text-xl font-semibold text-neutral-900 dark:text-white mb-1">Session Replay</h2>
<p className="text-sm text-neutral-500 dark:text-neutral-400">Record and playback visitor sessions to understand user behavior.</p>
</div>
{/* Privacy Mode Selection */}
<div className="space-y-4">
<h3 className="text-sm font-medium text-neutral-700 dark:text-neutral-300">Privacy Mode</h3>
<div className="space-y-3">
{/* Disabled */}
<label className={`block p-4 rounded-xl border-2 cursor-pointer transition-all ${
formData.replay_mode === 'disabled'
? 'border-brand-orange bg-brand-orange/5'
: 'border-neutral-200 dark:border-neutral-800 hover:border-neutral-300 dark:hover:border-neutral-700'
}`}>
<div className="flex items-start gap-3">
<input
type="radio"
name="replay_mode"
value="disabled"
checked={formData.replay_mode === 'disabled'}
onChange={(e) => setFormData({ ...formData, replay_mode: e.target.value as ReplayMode })}
className="mt-1 accent-brand-orange"
/>
<div>
<div className="font-medium text-neutral-900 dark:text-white">Disabled</div>
<p className="text-sm text-neutral-500 dark:text-neutral-400 mt-0.5">
No session recording. Maximum privacy.
</p>
</div>
</div>
</label>
{/* Consent Required */}
<label className={`block p-4 rounded-xl border-2 cursor-pointer transition-all ${
formData.replay_mode === 'consent_required'
? 'border-brand-orange bg-brand-orange/5'
: 'border-neutral-200 dark:border-neutral-800 hover:border-neutral-300 dark:hover:border-neutral-700'
}`}>
<div className="flex items-start gap-3">
<input
type="radio"
name="replay_mode"
value="consent_required"
checked={formData.replay_mode === 'consent_required'}
onChange={(e) => setFormData({ ...formData, replay_mode: e.target.value as ReplayMode })}
className="mt-1 accent-brand-orange"
/>
<div>
<div className="font-medium text-neutral-900 dark:text-white flex items-center gap-2">
Consent Required
<span className="text-xs bg-green-100 dark:bg-green-900/30 text-green-600 dark:text-green-400 px-2 py-0.5 rounded">GDPR Safe</span>
</div>
<p className="text-sm text-neutral-500 dark:text-neutral-400 mt-0.5">
Only records after visitor explicitly consents. Use with your cookie consent banner.
</p>
</div>
</div>
</label>
{/* Anonymous Skeleton */}
<label className={`block p-4 rounded-xl border-2 cursor-pointer transition-all ${
formData.replay_mode === 'anonymous_skeleton'
? 'border-brand-orange bg-brand-orange/5'
: 'border-neutral-200 dark:border-neutral-800 hover:border-neutral-300 dark:hover:border-neutral-700'
}`}>
<div className="flex items-start gap-3">
<input
type="radio"
name="replay_mode"
value="anonymous_skeleton"
checked={formData.replay_mode === 'anonymous_skeleton'}
onChange={(e) => setFormData({ ...formData, replay_mode: e.target.value as ReplayMode })}
className="mt-1 accent-brand-orange"
/>
<div>
<div className="font-medium text-neutral-900 dark:text-white flex items-center gap-2">
Anonymous Skeleton
<span className="text-xs bg-purple-100 dark:bg-purple-900/30 text-purple-600 dark:text-purple-400 px-2 py-0.5 rounded">Privacy First</span>
</div>
<p className="text-sm text-neutral-500 dark:text-neutral-400 mt-0.5">
All text replaced with blocks (), all inputs hidden. Layout and clicks preserved. No consent required.
</p>
</div>
</div>
</label>
</div>
</div>
{/* Recording Settings - Only show when not disabled */}
<AnimatePresence>
{formData.replay_mode !== 'disabled' && (
<motion.div
initial={{ opacity: 0, height: 0 }}
animate={{ opacity: 1, height: 'auto' }}
exit={{ opacity: 0, height: 0 }}
className="space-y-4 overflow-hidden"
>
<h3 className="text-sm font-medium text-neutral-700 dark:text-neutral-300 pt-4 border-t border-neutral-100 dark:border-neutral-800">Recording Settings</h3>
{/* Sampling Rate */}
<div className="p-4 bg-neutral-50 dark:bg-neutral-900/50 rounded-xl border border-neutral-100 dark:border-neutral-800">
<div className="flex items-center justify-between mb-3">
<div>
<h4 className="font-medium text-neutral-900 dark:text-white">Sampling Rate</h4>
<p className="text-sm text-neutral-500 dark:text-neutral-400 mt-0.5">
Percentage of sessions to record
</p>
</div>
<span className="text-lg font-semibold text-brand-orange">{formData.replay_sampling_rate}%</span>
</div>
<input
type="range"
min="1"
max="100"
value={formData.replay_sampling_rate}
onChange={(e) => setFormData({ ...formData, replay_sampling_rate: parseInt(e.target.value) })}
className="w-full h-2 bg-neutral-200 dark:bg-neutral-700 rounded-lg appearance-none cursor-pointer accent-brand-orange"
/>
<div className="flex justify-between text-xs text-neutral-500 mt-1">
<span>1%</span>
<span>50%</span>
<span>100%</span>
</div>
</div>
{/* Retention Period */}
<div className="p-4 bg-neutral-50 dark:bg-neutral-900/50 rounded-xl border border-neutral-100 dark:border-neutral-800">
<div className="flex items-center justify-between">
<div>
<h4 className="font-medium text-neutral-900 dark:text-white">Retention Period</h4>
<p className="text-sm text-neutral-500 dark:text-neutral-400 mt-0.5">
How long to keep recordings
</p>
</div>
<div className="relative">
<select
value={formData.replay_retention_days}
onChange={(e) => setFormData({ ...formData, replay_retention_days: parseInt(e.target.value) })}
className="px-4 py-2 border border-neutral-200 dark:border-neutral-700 rounded-lg bg-white dark:bg-neutral-800 text-neutral-900 dark:text-white text-sm font-medium appearance-none pr-10 focus:outline-none focus:ring-2 focus:ring-brand-orange/20 focus:border-brand-orange"
>
<option value={7}>7 days</option>
<option value={14}>14 days</option>
<option value={30}>30 days</option>
<option value={60}>60 days</option>
<option value={90}>90 days</option>
</select>
<div className="absolute inset-y-0 right-0 flex items-center px-3 pointer-events-none">
<svg className="w-4 h-4 text-neutral-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M19 9l-7 7-7-7" />
</svg>
</div>
</div>
</div>
</div>
{/* Masking Options - Only for consent mode */}
{formData.replay_mode === 'consent_required' && (
<>
<h3 className="text-sm font-medium text-neutral-700 dark:text-neutral-300 pt-4">Privacy Masking</h3>
{/* Mask All Text */}
<div className="p-4 bg-neutral-50 dark:bg-neutral-900/50 rounded-xl border border-neutral-100 dark:border-neutral-800">
<div className="flex items-center justify-between">
<div>
<h4 className="font-medium text-neutral-900 dark:text-white">Mask All Text</h4>
<p className="text-sm text-neutral-500 dark:text-neutral-400 mt-0.5">
Replace all text content with asterisks
</p>
</div>
<label className="relative inline-flex items-center cursor-pointer">
<input
type="checkbox"
checked={formData.replay_mask_all_text}
onChange={(e) => setFormData({ ...formData, replay_mask_all_text: e.target.checked })}
className="sr-only peer"
/>
<div className="w-11 h-6 bg-neutral-200 peer-focus:outline-none peer-focus:ring-4 peer-focus:ring-brand-orange/20 dark:peer-focus:ring-brand-orange/20 rounded-full peer dark:bg-neutral-700 peer-checked:after:translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:border-gray-300 after:border after:rounded-full after:h-5 after:w-5 after:transition-all dark:border-gray-600 peer-checked:bg-brand-orange"></div>
</label>
</div>
</div>
{/* Mask All Inputs */}
<div className="p-4 bg-neutral-50 dark:bg-neutral-900/50 rounded-xl border border-neutral-100 dark:border-neutral-800">
<div className="flex items-center justify-between">
<div>
<h4 className="font-medium text-neutral-900 dark:text-white">Mask All Inputs</h4>
<p className="text-sm text-neutral-500 dark:text-neutral-400 mt-0.5">
Hide all form input values (recommended)
</p>
</div>
<label className="relative inline-flex items-center cursor-pointer">
<input
type="checkbox"
checked={formData.replay_mask_all_inputs}
onChange={(e) => setFormData({ ...formData, replay_mask_all_inputs: e.target.checked })}
className="sr-only peer"
/>
<div className="w-11 h-6 bg-neutral-200 peer-focus:outline-none peer-focus:ring-4 peer-focus:ring-brand-orange/20 dark:peer-focus:ring-brand-orange/20 rounded-full peer dark:bg-neutral-700 peer-checked:after:translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:border-gray-300 after:border after:rounded-full after:h-5 after:w-5 after:transition-all dark:border-gray-600 peer-checked:bg-brand-orange"></div>
</label>
</div>
</div>
</>
)}
{/* Integration Guide */}
{formData.replay_mode === 'consent_required' && (
<div className="p-4 bg-blue-50 dark:bg-blue-900/20 rounded-xl border border-blue-200 dark:border-blue-800">
<h4 className="font-medium text-blue-900 dark:text-blue-100 mb-2">Integration with Consent Managers</h4>
<p className="text-sm text-blue-700 dark:text-blue-300 mb-3">
Call this function when the user grants consent for analytics/functional cookies:
</p>
<code className="block bg-blue-100 dark:bg-blue-900/50 text-blue-800 dark:text-blue-200 p-3 rounded-lg text-sm font-mono">
window.ciphera('enableReplay')
</code>
</div>
)}
{/* View Replays Link */}
<div className="pt-4">
<a
href={`/sites/${siteId}/replays`}
className="inline-flex items-center gap-2 text-brand-orange hover:underline text-sm font-medium"
>
<VideoIcon className="w-4 h-4" />
View Session Replays
</a>
</div>
</motion.div>
)}
</AnimatePresence>
<div className="pt-4 border-t border-neutral-100 dark:border-neutral-800 flex justify-end">
<button
type="submit"
disabled={saving}
className="flex items-center gap-2 px-6 py-2.5 bg-neutral-900 dark:bg-white text-white dark:text-neutral-900 rounded-xl font-medium
hover:bg-neutral-800 dark:hover:bg-neutral-100 disabled:opacity-50 disabled:cursor-not-allowed transition-all duration-200"
>
{saving ? (
<div className="w-5 h-5 border-2 border-white/30 border-t-white rounded-full animate-spin" />
) : (
<>
<CheckIcon className="w-4 h-4" />
Save Changes
</>
)}
</button>
</div>
</form>
</div>
)}
</motion.div>
</div>
</div>