Settings Mega Branch (#191)

Author: cjroth

TELEMETRY.md

@@ -40,6 +40,7 @@ Events follow the pattern: `<feature>_<action>`
 - `settings_name_clear` - User clears their preferred name
 - `settings_location_set` - User sets their location initially
 - `settings_location_update` - User updates their location
+- `settings_localization_update` - User updates localization settings (temperature, wind speed, precipitation, time format, language)
 - `settings_database_reset` - User resets the application database
 - `settings_data_collection_enabled` - User enables data collection
 - `settings_data_collection_disabled` - User disables data collection

backend/.env.test

@@ -0,0 +1 @@
+EXA_API_KEY=""

backend/.gitignore

@@ -1,3 +1,2 @@
 .env
-.env.test
 server

backend/src/api/routes.test.ts

@@ -92,5 +92,149 @@ describe('Main Routes', () => {
     const data = await response.json()
     expect(Array.isArray(data)).toBe(true)
   })
-})
 
+  describe('Units routes', () => {
+    it('should require country parameter for units endpoint', async () => {
+      const response = await app.handle(new Request('http://localhost/v1/units'))
+      expect(response.status).toBe(422) // Elysia validation error
+    })
+
+    it('should return units data for valid country code (Brazil)', async () => {
+      const response = await app.handle(new Request('http://localhost/v1/units?country=BR'))
+      expect(response.status).toBe(200)
+
+      const data = await response.json()
+      expect(data).toEqual({
+        unit: 'metric',
+        temperature: 'c',
+        timeFormat: '24h',
+        dateFormatExample: 'DD/MM/YYYY',
+        currency: {
+          code: 'BRL',
+          symbol: 'R$',
+          name: 'Brazilian Real',
+        },
+      })
+    })
+
+    it('should return units data for valid country name (Brazil)', async () => {
+      const response = await app.handle(new Request('http://localhost/v1/units?country=Brazil'))
+      expect(response.status).toBe(200)
+
+      const data = await response.json()
+      expect(data).toEqual({
+        unit: 'metric',
+        temperature: 'c',
+        timeFormat: '24h',
+        dateFormatExample: 'DD/MM/YYYY',
+        currency: {
+          code: 'BRL',
+          symbol: 'R$',
+          name: 'Brazilian Real',
+        },
+      })
+    })
+
+    it('should return units data for valid country code (United States)', async () => {
+      const response = await app.handle(new Request('http://localhost/v1/units?country=US'))
+      expect(response.status).toBe(200)
+
+      const data = await response.json()
+      expect(data).toEqual({
+        unit: 'imperial',
+        temperature: 'f',
+        timeFormat: '12h',
+        dateFormatExample: 'MM/DD/YYYY',
+        currency: {
+          code: 'USD',
+          symbol: '$',
+          name: 'US Dollar',
+        },
+      })
+    })
+
+    it('should return units data for valid country name (United States)', async () => {
+      const response = await app.handle(new Request('http://localhost/v1/units?country=United States'))
+      expect(response.status).toBe(200)
+
+      const data = await response.json()
+      expect(data).toEqual({
+        unit: 'imperial',
+        temperature: 'f',
+        timeFormat: '12h',
+        dateFormatExample: 'MM/DD/YYYY',
+        currency: {
+          code: 'USD',
+          symbol: '$',
+          name: 'US Dollar',
+        },
+      })
+    })
+
+    it('should return US data as fallback for invalid country', async () => {
+      const response = await app.handle(new Request('http://localhost/v1/units?country=INVALID'))
+      expect(response.status).toBe(200)
+
+      const data = await response.json()
+      expect(data).toEqual({
+        unit: 'imperial',
+        temperature: 'f',
+        timeFormat: '12h',
+        dateFormatExample: 'MM/DD/YYYY',
+        currency: {
+          code: 'USD',
+          symbol: '$',
+          name: 'US Dollar',
+        },
+      })
+    })
+
+    it('should return 400 for empty country parameter', async () => {
+      const response = await app.handle(new Request('http://localhost/v1/units?country='))
+      expect(response.status).toBe(400)
+
+      const data = await response.text()
+      expect(data).toBe('Country parameter is required')
+    })
+
+    it('should return units-options data', async () => {
+      const response = await app.handle(new Request('http://localhost/v1/units-options'))
+      expect(response.status).toBe(200)
+
+      const data = await response.json()
+      expect(data).toHaveProperty('units')
+      expect(data).toHaveProperty('temperature')
+      expect(data).toHaveProperty('timeFormat')
+      expect(data).toHaveProperty('dateFormats')
+      expect(data).toHaveProperty('currencies')
+
+      // Verify structure of units options
+      expect(Array.isArray(data.units)).toBe(true)
+      expect(data.units).toContain('metric')
+      expect(data.units).toContain('imperial')
+
+      expect(Array.isArray(data.temperature)).toBe(true)
+      expect(data.temperature).toEqual(
+        expect.arrayContaining([
+          expect.objectContaining({ symbol: 'c', name: 'Celsius' }),
+          expect.objectContaining({ symbol: 'f', name: 'Fahrenheit' }),
+        ]),
+      )
+
+      expect(Array.isArray(data.timeFormat)).toBe(true)
+      expect(data.timeFormat).toContain('12h')
+      expect(data.timeFormat).toContain('24h')
+
+      expect(Array.isArray(data.dateFormats)).toBe(true)
+      expect(data.dateFormats.length).toBeGreaterThan(0)
+      expect(data.dateFormats[0]).toHaveProperty('format')
+      expect(data.dateFormats[0]).toHaveProperty('example')
+
+      expect(Array.isArray(data.currencies)).toBe(true)
+      expect(data.currencies.length).toBeGreaterThan(0)
+      expect(data.currencies[0]).toHaveProperty('code')
+      expect(data.currencies[0]).toHaveProperty('symbol')
+      expect(data.currencies[0]).toHaveProperty('name')
+    })
+  })
+})

backend/src/api/routes.ts

@@ -1,4 +1,7 @@
 import { Elysia, t } from 'elysia'
+import unitsByCountryData from '../data/localization/units-by-country.json'
+import unitsOptionsData from '../data/localization/units-options.json'
+import { resolveCountryCode } from '../utils/country'
 
 export interface LocationResult {
   name: string
@@ -17,6 +20,42 @@ export const createMainRoutes = () => {
       status: 'ok',
     }))
 
+    .get(
+      '/units',
+      (ctx) => {
+        const { query, set } = ctx
+        const country = query.country
+
+        if (!country) {
+          set.status = 400
+          throw new Error('Country parameter is required')
+        }
+
+        const countryCode = resolveCountryCode(country)
+        
+        if (!countryCode) {
+          return unitsByCountryData.US
+        }
+
+        const countryData = unitsByCountryData[countryCode as keyof typeof unitsByCountryData]
+        
+        if (!countryData) {
+          return unitsByCountryData.US
+        }
+
+        return countryData
+      },
+      {
+        query: t.Object({
+          country: t.String(),
+        }),
+      },
+    )
+
+    .get('/units-options', () => {
+      return unitsOptionsData
+    })
+
     .get(
       '/locations',
       async (ctx): Promise<LocationResult[]> => {