userPreferences.test.ts

import { describe, it, expect } from 'vitest'
import {
  DEFAULT_PREFERENCES,
  PREFERENCE_KEYS,
  type UserPreferences,
} from './userPreferences'

// TESTING.md invariant 16, asserted where it says to assert it: on the
// SCHEMA, not the DOM. "No closures toggle rendered on the settings screen"
// is a weaker claim than "no such preference exists" - the first survives
// someone adding the control on a different screen, the second does not.
//
// Closures and serious warnings are always shown, with no switch here or
// anywhere (features/MAP_OPTIONS.md, features/HIKER_SAFETY.md). The backend
// enforces the same thing from its side: backend/app/schemas/preferences.py
// sets extra="forbid" precisely so a client sending `show_closures` gets a
// visible 422 rather than having it silently dropped.

describe('UserPreferences schema', () => {
  it.each([
    'show_closures',
    'showClosures',
    'hide_closures',
    'show_warnings',
    'showWarnings',
    'hide_warnings',
    'show_serious_warnings',
  ])('has no "%s" key - a safety layer is not a preference', (forbidden) => {
    expect(PREFERENCE_KEYS).not.toContain(forbidden)
    expect(DEFAULT_PREFERENCES).not.toHaveProperty(forbidden)
  })

  it('exposes no key that would let closures or warnings be switched off', () => {
    // Catches a differently-named future variant, which the exact list above
    // would sail straight past.
    const suspicious = PREFERENCE_KEYS.filter((key) => /closure|warning/i.test(key))

    expect(suspicious).toEqual([])
  })

  it('keeps the wrong-way alert togglable - it is the one push, and it is opt-out', () => {
    // Distinct from the above: the alert is a NOTIFICATION preference, not a
    // question of whether hazards appear on the map. WIREFRAMES.md §10 puts
    // this toggle in Safety & privacy on purpose.
    expect(PREFERENCE_KEYS).toContain('wrong_way_alert_enabled')
  })

  it('matches the backend contract field-for-field', () => {
    // backend/app/schemas/preferences.py is the sync target; a key here that
    // it does not accept becomes a 422 the moment an account is linked.
    expect([...PREFERENCE_KEYS].sort()).toEqual(
      [
        'anonymity_window_days',
        'auto_rotate_enabled',
        'background_source',
        'download_choice_made',
        'layer_detail_level',
        'location_permission_requested',
        'max_background_zoom',
        'onboarding_completed',
        'show_roads',
        'theme',
        'trail_name',
        'unit_system',
        'waypoint_types_shown',
        'wrong_way_alert_enabled',
      ].sort(),
    )
  })

  it('defaults to the offline topo basemap - the only source that works with no signal', () => {
    expect(DEFAULT_PREFERENCES.background_source).toBe('usgs_topo_offline')
  })

  it('defaults theme to auto and units to imperial, per the canonical model', () => {
    expect(DEFAULT_PREFERENCES.theme).toBe('auto')
    expect(DEFAULT_PREFERENCES.unit_system).toBe('imperial')
  })

  it('defaults the wrong-way alert to on, so the one safety push is not opt-in', () => {
    expect(DEFAULT_PREFERENCES.wrong_way_alert_enabled).toBe(true)
  })

  it('starts a fresh install with onboarding not yet done', () => {
    const fresh: UserPreferences = DEFAULT_PREFERENCES

    expect(fresh.onboarding_completed).toBe(false)
    expect(fresh.download_choice_made).toBe(false)
    expect(fresh.location_permission_requested).toBe(false)
  })
})