feat: extend math engine: currencies, timezones, finance, cooking

src/main/__tests__/currencyRates.test.ts

@@ -0,0 +1,88 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { getCurrencyRates, refreshFiatRatesForced } from '../currencyRates'
+
+const mocks = vi.hoisted(() => {
+  const state: {
+    cache: { rates: Record<string, number>, fetchedAt: number } | null
+  } = {
+    cache: null,
+  }
+
+  return {
+    state,
+    get: vi.fn(() => state.cache),
+    set: vi.fn(
+      (
+        _key: string,
+        value: { rates: Record<string, number>, fetchedAt: number },
+      ) => {
+        state.cache = value
+      },
+    ),
+  }
+})
+
+vi.mock('../store', () => ({
+  store: {
+    currencyRates: {
+      get: mocks.get,
+      set: mocks.set,
+    },
+  },
+}))
+
+describe('currencyRates', () => {
+  beforeEach(() => {
+    mocks.state.cache = null
+    mocks.get.mockClear()
+    mocks.set.mockClear()
+    vi.restoreAllMocks()
+  })
+
+  it('does not persist partial cold-start rates to cache', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            result: 'success',
+            rates: {
+              EUR: 0.92,
+              GBP: 0.79,
+            },
+          }),
+        })
+        .mockResolvedValueOnce({
+          ok: false,
+          status: 429,
+        }),
+    )
+
+    const payload = await getCurrencyRates()
+
+    expect(payload.source).toBe('live')
+    expect(payload.rates).toMatchObject({
+      USD: 1,
+      EUR: 0.92,
+      GBP: 0.79,
+    })
+    expect(mocks.set).not.toHaveBeenCalled()
+    expect(mocks.state.cache).toBeNull()
+  })
+
+  it('throws when forced fiat refresh fails', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi.fn().mockResolvedValue({
+        ok: false,
+        status: 500,
+      }),
+    )
+
+    await expect(refreshFiatRatesForced()).rejects.toThrow(
+      'Currency rates request failed with status 500',
+    )
+  })
+})

src/main/currencyRates.ts

@@ -14,6 +14,30 @@ export interface CurrencyRatesPayload {
   source: 'live' | 'cache' | 'unavailable'
 }
 
+const CRYPTO_IDS: Record<string, string> = {
+  BTC: 'bitcoin',
+  ETH: 'ethereum',
+  SOL: 'solana',
+  DOGE: 'dogecoin',
+  XRP: 'ripple',
+  ADA: 'cardano',
+  DOT: 'polkadot',
+  LTC: 'litecoin',
+  AVAX: 'avalanche-2',
+  SHIB: 'shiba-inu',
+  BNB: 'binancecoin',
+  USDT: 'tether',
+  USDC: 'usd-coin',
+  XLM: 'stellar',
+  XMR: 'monero',
+  EOS: 'eos',
+  TRX: 'tron',
+  DASH: 'dash',
+  NEO: 'neo',
+  BCH: 'bitcoin-cash',
+  ETC: 'ethereum-classic',
+}
+
 function normalizeRates(rates: Record<string, number>) {
   const normalized: Record<string, number> = { USD: 1 }
 
@@ -28,6 +52,58 @@ function normalizeRates(rates: Record<string, number>) {
   return normalized
 }
 
+function createPayload(rates: Record<string, number>): CurrencyRatesPayload {
+  return {
+    rates: normalizeRates(rates),
+    fetchedAt: Date.now(),
+    source: 'live',
+  }
+}
+
+async function fetchFiatRates(): Promise<Record<string, number>> {
+  const response = await fetch('https://open.er-api.com/v6/latest/USD')
+  if (!response.ok) {
+    throw new Error(
+      `Currency rates request failed with status ${response.status}`,
+    )
+  }
+
+  const data = (await response.json()) as CurrencyRatesApiResponse
+  if (data.result !== 'success' || !data.rates) {
+    throw new Error('Currency rates response is invalid')
+  }
+
+  return data.rates
+}
+
+async function fetchCryptoRates(): Promise<Record<string, number>> {
+  const ids = Object.values(CRYPTO_IDS).join(',')
+  const response = await fetch(
+    `https://api.coingecko.com/api/v3/simple/price?ids=${ids}&vs_currencies=usd`,
+  )
+
+  if (!response.ok) {
+    if (response.status === 429) {
+      throw new Error('rate_limit')
+    }
+    throw new Error(
+      `Crypto rates request failed with status ${response.status}`,
+    )
+  }
+
+  const data = (await response.json()) as Record<string, { usd?: number }>
+  const rates: Record<string, number> = {}
+
+  for (const [code, coinId] of Object.entries(CRYPTO_IDS)) {
+    const usdPrice = data[coinId]?.usd
+    if (usdPrice && usdPrice > 0) {
+      rates[code] = 1 / usdPrice
+    }
+  }
+
+  return rates
+}
+
 export async function getCurrencyRates(): Promise<CurrencyRatesPayload> {
   const cached = store.currencyRates.get('cache')
 
@@ -39,31 +115,41 @@ export async function getCurrencyRates(): Promise<CurrencyRatesPayload> {
   }
 
   try {
-    const response = await fetch('https://open.er-api.com/v6/latest/USD')
-    if (!response.ok) {
-      throw new Error(
-        `Currency rates request failed with status ${response.status}`,
-      )
-    }
+    const [fiatRates, cryptoRates] = await Promise.allSettled([
+      fetchFiatRates(),
+      fetchCryptoRates(),
+    ])
 
-    const data = (await response.json()) as CurrencyRatesApiResponse
-    if (data.result !== 'success' || !data.rates) {
-      throw new Error('Currency rates response is invalid')
+    const freshRates: Record<string, number> = {}
+
+    if (fiatRates.status === 'fulfilled') {
+      Object.assign(freshRates, fiatRates.value)
     }
 
-    const payload = {
-      rates: normalizeRates(data.rates),
-      fetchedAt: data.time_last_update_unix
-        ? data.time_last_update_unix * 1000
-        : Date.now(),
+    if (cryptoRates.status === 'fulfilled') {
+      Object.assign(freshRates, cryptoRates.value)
     }
 
-    store.currencyRates.set('cache', payload)
+    if (Object.keys(freshRates).length === 0) {
+      throw new Error('No rates fetched')
+    }
 
-    return {
-      ...payload,
-      source: 'live',
+    if (
+      !cached
+      && (fiatRates.status !== 'fulfilled' || cryptoRates.status !== 'fulfilled')
+    ) {
+      return createPayload(freshRates)
     }
+
+    const previousRates = cached?.rates || {}
+    const payload = createPayload({ ...previousRates, ...freshRates })
+
+    store.currencyRates.set('cache', {
+      rates: payload.rates,
+      fetchedAt: payload.fetchedAt,
+    })
+
+    return payload
   }
   catch {
     if (cached) {
@@ -80,3 +166,37 @@ export async function getCurrencyRates(): Promise<CurrencyRatesPayload> {
     }
   }
 }
+
+export async function refreshFiatRatesForced(): Promise<CurrencyRatesPayload> {
+  const fiatRates = await fetchFiatRates()
+  const cached = store.currencyRates.get('cache')
+
+  if (!cached) {
+    return createPayload(fiatRates)
+  }
+
+  const payload = createPayload({ ...cached.rates, ...fiatRates })
+  store.currencyRates.set('cache', {
+    rates: payload.rates,
+    fetchedAt: payload.fetchedAt,
+  })
+
+  return payload
+}
+
+export async function refreshCryptoRatesForced(): Promise<CurrencyRatesPayload> {
+  const cryptoRates = await fetchCryptoRates()
+  const cached = store.currencyRates.get('cache')
+
+  if (!cached) {
+    return createPayload(cryptoRates)
+  }
+
+  const payload = createPayload({ ...cached.rates, ...cryptoRates })
+  store.currencyRates.set('cache', {
+    rates: payload.rates,
+    fetchedAt: payload.fetchedAt,
+  })
+
+  return payload
+}

src/main/i18n/locales/en_US/preferences.json

@@ -124,6 +124,26 @@
     "decimalPlaces": {
       "label": "Decimal Places",
       "description": "Maximum decimal places in results (0\u201314)."
+    },
+    "dateFormat": {
+      "label": "Date Format",
+      "description": "How dates are displayed in results."
+    },
+    "currencyRates": {
+      "label": "Currency Rates",
+      "description": "Cached for 1 hour.",
+      "refresh": "Refresh",
+      "refreshing": "Refreshing...",
+      "refreshed": "Currency rates updated",
+      "refreshError": "Failed to update currency rates"
+    },
+    "cryptoRates": {
+      "label": "Crypto Rates",
+      "description": "Cached for 1 hour. Rate limit: 10-30 req/min.",
+      "refresh": "Refresh",
+      "refreshing": "Refreshing...",
+      "refreshed": "Crypto rates updated",
+      "rateLimited": "Rate limit exceeded. Try again later."
     }
   },
   "api": {

src/main/ipc/handlers/system.ts

@@ -1,6 +1,10 @@
 import path from 'node:path'
 import { app, ipcMain, shell } from 'electron'
-import { getCurrencyRates } from '../../currencyRates'
+import {
+  getCurrencyRates,
+  refreshCryptoRatesForced,
+  refreshFiatRatesForced,
+} from '../../currencyRates'
 import {
   findNoteById,
   getNotesFolderPathById,
@@ -14,6 +18,14 @@ export function registerSystemHandlers() {
     return getCurrencyRates()
   })
 
+  ipcMain.handle('system:currency-rates-refresh', () => {
+    return refreshFiatRatesForced()
+  })
+
+  ipcMain.handle('system:crypto-rates-refresh', () => {
+    return refreshCryptoRatesForced()
+  })
+
   ipcMain.handle('system:reload', () => {
     app.relaunch()
     app.quit()

src/main/store/module/preferences.ts

@@ -24,6 +24,7 @@ const storagePath = isWin ? `${homedir()}\\massCode` : `${homedir()}/massCode`
 const MATH_DEFAULTS: MathSettings = {
   locale: 'en-US',
   decimalPlaces: 6,
+  dateFormat: 'numeric',
 }
 
 const PREFERENCES_DEFAULTS: PreferencesStore = {
@@ -153,13 +154,19 @@ function sanitizeMarkdownSettings(value: unknown): MarkdownSettings {
 function sanitizeMathSettings(value: unknown): MathSettings {
   const source = asRecord(value)
 
+  const dateFormat = readString(source, 'dateFormat', MATH_DEFAULTS.dateFormat)
+  const validDateFormats = ['numeric', 'short', 'long']
+
   return {
     locale: readString(source, 'locale', MATH_DEFAULTS.locale),
     decimalPlaces: readNumber(
       source,
       'decimalPlaces',
       MATH_DEFAULTS.decimalPlaces,
     ),
+    dateFormat: validDateFormats.includes(dateFormat)
+      ? (dateFormat as MathSettings['dateFormat'])
+      : MATH_DEFAULTS.dateFormat,
   }
 }
 

src/main/store/types/index.ts

@@ -81,6 +81,7 @@ export interface NotesEditorSettings {
 export interface MathSettings {
   locale: string
   decimalPlaces: number
+  dateFormat: 'numeric' | 'short' | 'long'
 }
 
 export interface PreferencesStore {

src/main/types/ipc.ts

@@ -34,6 +34,8 @@ type DBAction = 'migrate-to-markdown'
 
 type SystemAction =
   | 'currency-rates'
+  | 'currency-rates-refresh'
+  | 'crypto-rates-refresh'
   | 'reload'
   | 'open-external'
   | 'show-notes-folder-in-file-manager'

src/renderer/components/math-notebook/Workspace.vue

@@ -20,13 +20,21 @@ const {
 
 const mathSettings = reactive(store.preferences.get('math') as MathSettings)
 
-setFormatSettings(mathSettings.locale, mathSettings.decimalPlaces)
+setFormatSettings(
+  mathSettings.locale,
+  mathSettings.decimalPlaces,
+  mathSettings.dateFormat,
+)
 
 watch(
   mathSettings,
   () => {
     store.preferences.set('math', JSON.parse(JSON.stringify(mathSettings)))
-    setFormatSettings(mathSettings.locale, mathSettings.decimalPlaces)
+    setFormatSettings(
+      mathSettings.locale,
+      mathSettings.decimalPlaces,
+      mathSettings.dateFormat,
+    )
   },
   { deep: true },
 )