teqo-backup/tests/unit/wizardMunicipalitySuggestMerge.unit.spec.ts
Cursor Agent 20c69bd0de
B94 — wizard empty state: município mais próximo (geo)
No idle do passo de busca de município, resolve client-side o município
mais próximo no escopo do ator quando a permissão de geo já está granted
(reuso B14: campaignGeolocation + municipalityProximity + malha lazy).

- Prop RSC accessibleMunicipalities na rota acoes/[slug]
- Hook useWizardNearestMunicipality (fail-soft, só inScope)
- Merge geo no topo da lista B92 via wizardMunicipalitySuggestMerge
- Unit tests do merge/format

Closes #94

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
2026-08-01 07:43:42 +00:00

210 lines
7 KiB
TypeScript

import { describe, expect, it } from 'vitest'
import type { HomeSearchMunicipalityHit } from '@/lib/campaignHomeSearchHits'
<<<<<<< HEAD
import { HOME_SEARCH_SUGGEST_LIMIT } from '@/lib/homeSearchSuggest'
import {
listWizardContinuitySlugs,
mergeWizardMunicipalitySuggestions,
municipalitySlugFromRecentVisitHref,
WIZARD_CONTINUITY_LAST_ACTED_LABEL,
WIZARD_CONTINUITY_VISITED_LABEL,
type WizardContinuityVisitInput,
} from '@/lib/wizardMunicipalitySuggestMerge'
const hit = (
partial: Partial<HomeSearchMunicipalityHit> & Pick<HomeSearchMunicipalityHit, 'slug' | 'name'>,
): HomeSearchMunicipalityHit => ({
kind: 'municipality',
region: 'Região',
=======
import {
formatWizardGeoSecondary,
mergeWizardMunicipalitySuggestions,
WIZARD_GEO_NEARBY_REASON,
} from '@/lib/wizardMunicipalitySuggestMerge'
const serverHit = (
partial: Partial<HomeSearchMunicipalityHit> & Pick<HomeSearchMunicipalityHit, 'slug' | 'name'>,
): HomeSearchMunicipalityHit => ({
kind: 'municipality',
region: 'Costa do Dendê',
>>>>>>> 076bd2f (B94 — wizard empty state: município mais próximo (geo))
priority: null,
votePosition2022: null,
...partial,
})
<<<<<<< HEAD
const visit = (
overrides: Partial<WizardContinuityVisitInput> = {},
): WizardContinuityVisitInput => ({
href: '/campanha/municipios/cairu',
kind: 'municipality',
...overrides,
})
describe('municipalitySlugFromRecentVisitHref', () => {
it('extracts municipality slug from detail href', () => {
expect(municipalitySlugFromRecentVisitHref('/campanha/municipios/itabuna')).toBe('itabuna')
expect(municipalitySlugFromRecentVisitHref('/campanha/municipios')).toBeNull()
expect(municipalitySlugFromRecentVisitHref('/campanha/atividades/foo')).toBeNull()
})
})
describe('listWizardContinuitySlugs', () => {
const scope = new Set(['itabuna', 'cairu', 'valenca'])
it('orders last-acted before visited and filters out of scope', () => {
const continuity = listWizardContinuitySlugs({
lastActedSlug: 'itabuna',
recentVisits: [
visit({ href: '/campanha/municipios/cairu' }),
visit({ href: '/campanha/municipios/fora' }),
visit({ href: '/campanha/municipios/valenca' }),
],
scopeSlugs: scope,
})
expect(continuity).toEqual([
{ source: 'last-acted', slug: 'itabuna' },
{ source: 'visited', slug: 'cairu' },
{ source: 'visited', slug: 'valenca' },
])
})
it('deduplicates visited slug that matches last-acted', () => {
const continuity = listWizardContinuitySlugs({
lastActedSlug: 'cairu',
recentVisits: [visit({ href: '/campanha/municipios/cairu' })],
scopeSlugs: new Set(['cairu']),
})
expect(continuity).toEqual([{ source: 'last-acted', slug: 'cairu' }])
})
it('ignores non-municipality visits and caps visited count', () => {
const continuity = listWizardContinuitySlugs({
lastActedSlug: null,
recentVisits: [
visit({ href: '/campanha/municipios', kind: 'municipalityList' }),
visit({ href: '/campanha/municipios/a' }),
visit({ href: '/campanha/municipios/b' }),
visit({ href: '/campanha/municipios/c' }),
visit({ href: '/campanha/municipios/d' }),
],
scopeSlugs: new Set(['a', 'b', 'c', 'd']),
maxVisited: 3,
})
expect(continuity.map((item) => item.slug)).toEqual(['a', 'b', 'c'])
=======
describe('formatWizardGeoSecondary', () => {
it('formats reason without distance', () => {
expect(formatWizardGeoSecondary(undefined)).toBe(WIZARD_GEO_NEARBY_REASON)
expect(formatWizardGeoSecondary('Costa do Dendê')).toBe(
`Costa do Dendê · ${WIZARD_GEO_NEARBY_REASON}`,
)
})
it('formats reason with distance', () => {
expect(formatWizardGeoSecondary('Costa do Dendê', 1.2)).toBe(
`Costa do Dendê · ${WIZARD_GEO_NEARBY_REASON} (~1,2 km)`,
)
expect(formatWizardGeoSecondary(undefined, 0.4)).toBe(
`${WIZARD_GEO_NEARBY_REASON} (~menos de 1 km)`,
)
>>>>>>> 076bd2f (B94 — wizard empty state: município mais próximo (geo))
})
})
describe('mergeWizardMunicipalitySuggestions', () => {
<<<<<<< HEAD
const hitBySlug = new Map(
[
hit({ slug: 'geo', name: 'Geo' }),
hit({ slug: 'acted', name: 'Acted' }),
hit({ slug: 'visited', name: 'Visited' }),
hit({ slug: 'forgot-a', name: 'Forgot A' }),
hit({ slug: 'forgot-b', name: 'Forgot B' }),
].map((row) => [row.slug, row]),
)
it('dedupes in geo > continuity > server order with reason labels', () => {
const merged = mergeWizardMunicipalitySuggestions({
geoSlug: 'forgot-a',
continuity: [
{ source: 'last-acted', slug: 'acted' },
{ source: 'visited', slug: 'visited' },
{ source: 'visited', slug: 'forgot-a' },
],
serverHits: [
hit({ slug: 'forgot-a', name: 'Forgot A' }),
hit({ slug: 'forgot-b', name: 'Forgot B' }),
],
hitBySlug,
})
expect(merged.map((row) => row.hit.slug)).toEqual(['forgot-a', 'acted', 'visited', 'forgot-b'])
expect(merged.find((row) => row.hit.slug === 'acted')?.continuityReason).toBe(
WIZARD_CONTINUITY_LAST_ACTED_LABEL,
)
expect(merged.find((row) => row.hit.slug === 'visited')?.continuityReason).toBe(
WIZARD_CONTINUITY_VISITED_LABEL,
)
expect(merged.find((row) => row.hit.slug === 'forgot-b')?.continuityReason).toBeUndefined()
})
it('caps the merged list at HOME_SEARCH_SUGGEST_LIMIT', () => {
const manyHits = Array.from({ length: 10 }, (_, index) =>
hit({ slug: `m-${index}`, name: `M ${index}` }),
)
const manyBySlug = new Map(manyHits.map((row) => [row.slug, row]))
const merged = mergeWizardMunicipalitySuggestions({
continuity: [],
serverHits: manyHits,
hitBySlug: manyBySlug,
})
expect(merged).toHaveLength(HOME_SEARCH_SUGGEST_LIMIT)
=======
it('returns server hits unchanged when geo is null', () => {
const hits = [serverHit({ slug: 'cairu', name: 'Cairu' })]
expect(mergeWizardMunicipalitySuggestions(hits, null)).toEqual(hits)
})
it('prepends geo hit and dedupes by slug', () => {
const hits = [
serverHit({ slug: 'cairu', name: 'Cairu', priority: 'alta' }),
serverHit({ slug: 'valenca', name: 'Valença' }),
]
const merged = mergeWizardMunicipalitySuggestions(hits, {
slug: 'valenca',
name: 'Valença',
distanceKm: 2.5,
})
expect(merged).toHaveLength(2)
expect(merged[0]?.slug).toBe('valenca')
expect(merged[0]?.region).toContain(WIZARD_GEO_NEARBY_REASON)
expect(merged[0]?.region).toContain('~2,5 km')
expect(merged[1]?.slug).toBe('cairu')
})
it('preserves server metadata when geo slug was not in the suggest list', () => {
const hits = [serverHit({ slug: 'cairu', name: 'Cairu' })]
const merged = mergeWizardMunicipalitySuggestions(hits, {
slug: 'itabuna',
name: 'Itabuna',
})
expect(merged).toHaveLength(2)
expect(merged[0]?.slug).toBe('itabuna')
expect(merged[0]?.region).toBe(WIZARD_GEO_NEARBY_REASON)
>>>>>>> 076bd2f (B94 — wizard empty state: município mais próximo (geo))
})
})