sims-hq/apps/hq/test/reminder-schedule.test.ts

// apps/hq/test/reminder-schedule.test.ts — Phase 4: dated reminder schedule (spec §4, §7)
import { describe, it, expect } from 'vitest'
import { uuidv7 } from '@sims/domain'
import { openDb, type DB } from '../src/db'
import { resolveSchedule, SCHEDULE_DEFAULTS } from '../src/repos-reminders'
import { seedIfEmpty } from '../src/seed'

interface Row {
  ruleKind: string; from: string; to?: string | null
  offsets: string; subject?: string | null; body?: string | null
}

/** Raw insert — proves a cadence change is a dated DB row, no code edit (rule 3). */
function insertSchedule(db: DB, r: Row): void {
  db.prepare(
    `INSERT INTO reminder_schedule (id, rule_kind, effective_from, effective_to, day_offsets, subject, body)
     VALUES (?, ?, ?, ?, ?, ?, ?)`,
  ).run(uuidv7(), r.ruleKind, r.from, r.to ?? null, r.offsets, r.subject ?? null, r.body ?? null)
}

describe('resolveSchedule', () => {
  it('falls back to the code defaults when no row exists', () => {
    const db = openDb(':memory:') // unseeded — table empty
    const qf = resolveSchedule(db, 'quote_followup', '2026-07-17')
    expect(qf.dayOffsets).toEqual([3, 7, 14])
    expect(qf.source).toBe('default')
    expect(qf.subject).toContain('{ref}')
    expect(qf.body).toContain('{shareUrl}')
    const inv = resolveSchedule(db, 'invoice_overdue', '2026-07-17')
    expect(inv.dayOffsets).toEqual([7, 15, 30])
    expect(inv.source).toBe('default')
    expect(inv.subject).toBeNull() // invoice mail text stays in reminder-templates
    expect(inv.body).toBeNull()
  })

  it('returns the dated row active on today; latest effective_from wins', () => {
    const db = openDb(':memory:')
    insertSchedule(db, { ruleKind: 'quote_followup', from: '2026-01-01', offsets: '3,7,14' })
    insertSchedule(db, { ruleKind: 'quote_followup', from: '2026-07-01', offsets: '2,5,9' })
    expect(resolveSchedule(db, 'quote_followup', '2026-07-17').dayOffsets).toEqual([2, 5, 9])
    expect(resolveSchedule(db, 'quote_followup', '2026-07-17').source).toBe('db')
    expect(resolveSchedule(db, 'quote_followup', '2026-03-01').dayOffsets).toEqual([3, 7, 14])
    // a row dated in the future is not active yet
    expect(resolveSchedule(db, 'quote_followup', '2025-12-31').source).toBe('default')
  })

  it('tied effective_from resolves deterministically: highest id wins on any engine', () => {
    const db = openDb(':memory:')
    const ins = (id: string, offsets: string) => db.prepare(
      `INSERT INTO reminder_schedule (id, rule_kind, effective_from, effective_to, day_offsets, subject, body)
       VALUES (?, 'quote_followup', '2026-01-01', NULL, ?, NULL, NULL)`,
    ).run(id, offsets)
    // Insert the higher id FIRST so plain scan order would pick the other row —
    // the tiebreaker (id DESC; UUIDv7 ids are time-ordered) must decide, not the plan.
    ins('zzzz-high', '2,4')
    ins('aaaa-low', '5,10')
    expect(resolveSchedule(db, 'quote_followup', '2026-07-17').dayOffsets).toEqual([2, 4])
  })

  it('effective_to closes the window: active requires effective_to > today', () => {
    const db = openDb(':memory:')
    insertSchedule(db, { ruleKind: 'quote_followup', from: '2026-01-01', to: '2026-07-01', offsets: '1,2' })
    expect(resolveSchedule(db, 'quote_followup', '2026-06-30').dayOffsets).toEqual([1, 2])
    expect(resolveSchedule(db, 'quote_followup', '2026-07-01').source).toBe('default') // boundary day excluded
  })

  it('a new dated row changes cadence with no code edit', () => {
    const db = openDb(':memory:')
    seedIfEmpty(db)
    expect(resolveSchedule(db, 'quote_followup', '2026-07-17').dayOffsets).toEqual([3, 7, 14])
    insertSchedule(db, { ruleKind: 'quote_followup', from: '2026-08-01', offsets: '5,10' })
    expect(resolveSchedule(db, 'quote_followup', '2026-07-17').dayOffsets).toEqual([3, 7, 14]) // unchanged before
    expect(resolveSchedule(db, 'quote_followup', '2026-08-01').dayOffsets).toEqual([5, 10]) // new cadence after
  })

  it('parses messy CSV ascending and falls back on garbage offsets', () => {
    const db = openDb(':memory:')
    insertSchedule(db, { ruleKind: 'quote_followup', from: '2026-01-01', offsets: ' 14, 3 ,7 ' })
    expect(resolveSchedule(db, 'quote_followup', '2026-07-17').dayOffsets).toEqual([3, 7, 14])
    insertSchedule(db, { ruleKind: 'invoice_overdue', from: '2026-01-01', offsets: 'a,b,-3,0' })
    const inv = resolveSchedule(db, 'invoice_overdue', '2026-07-17')
    expect(inv.dayOffsets).toEqual([7, 15, 30]) // nothing usable → code default
    expect(inv.source).toBe('default')
  })

  it('a cadence-only row keeps the code-constant message text', () => {
    const db = openDb(':memory:')
    insertSchedule(db, { ruleKind: 'quote_followup', from: '2026-01-01', offsets: '4,8' })
    const r = resolveSchedule(db, 'quote_followup', '2026-07-17')
    expect(r.dayOffsets).toEqual([4, 8])
    expect(r.subject).toBe(SCHEDULE_DEFAULTS.quote_followup.subject)
    expect(r.body).toBe(SCHEDULE_DEFAULTS.quote_followup.body)
  })
})

describe('seeded schedule rows', () => {
  it('seedIfEmpty seeds one dated row per rule kind, audited, and is idempotent', () => {
    const db = openDb(':memory:')
    seedIfEmpty(db)
    seedIfEmpty(db) // idempotent — no duplicates
    const rows = db.prepare(
      `SELECT rule_kind, COUNT(*) AS n FROM reminder_schedule GROUP BY rule_kind ORDER BY rule_kind`,
    ).all() as { rule_kind: string; n: number }[]
    expect(rows).toEqual([
      { rule_kind: 'invoice_overdue', n: 1 },
      { rule_kind: 'quote_followup', n: 1 },
    ])
    expect(resolveSchedule(db, 'quote_followup', '2026-07-17').source).toBe('db')
    expect(resolveSchedule(db, 'invoice_overdue', '2026-07-17').source).toBe('db')
    const audits = db.prepare(
      `SELECT COUNT(*) AS n FROM audit_log WHERE entity='reminder_schedule'`,
    ).get() as { n: number }
    expect(audits.n).toBe(2)
  })
})