teqo-backup/src/lib/campaignActionRoutes.ts
Francisco Ignácio Fontoura Solla 09fa21d4b3 B63: wizard registrar sinal (grid de tipos + passo de texto).
Two-step UX-1 flow on the B59 chassis with URL contract ?signalType= and optional ?entryAction= for embedded skip; reuses createMunicipalityListSignalFormAction.
2026-07-30 04:01:48 -03:00

132 lines
4 KiB
TypeScript

/** Client-safe entry paths for UX-1 action wizards under `/campanha/acoes`. */
import {
parseMunicipalitySignalType,
type MunicipalitySignalType,
} from '@/lib/schemas/municipalityUpdate'
export const CAMPAIGN_ACTIONS_HOME = '/campanha/acoes' as const
export type CampaignWizardActionId =
| 'update-votes'
| 'register-signal'
| 'change-trend'
| 'update-leadership'
| 'register-demand'
export const CAMPAIGN_WIZARD_ACTION_SLUGS: Record<CampaignWizardActionId, string> = {
'update-votes': 'atualizar-votos',
'register-signal': 'registrar-sinal',
'change-trend': 'mudar-tendencia',
'update-leadership': 'atualizar-lideranca',
'register-demand': 'registrar-pedido',
}
const wizardActionSlugs = new Set(Object.values(CAMPAIGN_WIZARD_ACTION_SLUGS))
const campaignWizardSlugToId = Object.fromEntries(
Object.entries(CAMPAIGN_WIZARD_ACTION_SLUGS).map(([id, actionSlug]) => [
actionSlug,
id as CampaignWizardActionId,
]),
) as Record<string, CampaignWizardActionId>
export const isCampaignWizardActionSlug = (slug: string): boolean => wizardActionSlugs.has(slug)
export const campaignWizardActionIdForSlug = (slug: string): CampaignWizardActionId | undefined =>
campaignWizardSlugToId[slug]
export const isCampaignWizardActionId = (id: string): id is CampaignWizardActionId =>
id in CAMPAIGN_WIZARD_ACTION_SLUGS
export const campaignActionEntryHref = (id: CampaignWizardActionId): string =>
`${CAMPAIGN_ACTIONS_HOME}/${CAMPAIGN_WIZARD_ACTION_SLUGS[id]}`
export const WIZARD_MUNICIPIO_QUERY_KEY = 'municipio' as const
/** Legacy B61 ritual param — canonical URLs omit it (B77). */
export const WIZARD_SCENARIO_QUERY_KEY = 'cenario' as const
export const WIZARD_SIGNAL_TYPE_QUERY_KEY = 'signalType' as const
export const WIZARD_ENTRY_ACTION_QUERY_KEY = 'entry' as const
export type WizardActionHrefOptions = {
entryAction?: CampaignWizardActionId
}
export const wizardActionHref = (
actionSlug: string,
municipalitySlug?: string,
options?: WizardActionHrefOptions,
): string => {
const base = `${CAMPAIGN_ACTIONS_HOME}/${actionSlug}`
if (!municipalitySlug) {
return base
}
const params = new URLSearchParams({ [WIZARD_MUNICIPIO_QUERY_KEY]: municipalitySlug })
if (options?.entryAction) {
params.set(WIZARD_ENTRY_ACTION_QUERY_KEY, options.entryAction)
}
return `${base}?${params.toString()}`
}
export const parseWizardMunicipioParam = (
value: string | string[] | undefined,
): string | undefined => {
const raw = Array.isArray(value) ? value[0] : value
const trimmed = raw?.trim()
return trimmed ? trimmed : undefined
}
export const hasWizardScenarioParam = (value: string | string[] | undefined): boolean =>
parseWizardMunicipioParam(value) !== undefined
export const parseWizardEntryActionParam = (
value: string | string[] | undefined,
): CampaignWizardActionId | undefined => {
const raw = Array.isArray(value) ? value[0] : value
const trimmed = raw?.trim()
if (!trimmed || !isCampaignWizardActionId(trimmed)) {
return undefined
}
return trimmed
}
export const wizardSignalHref = (
actionSlug: string,
municipalitySlug?: string,
signalType?: MunicipalitySignalType,
entryAction?: CampaignWizardActionId,
): string => {
const base = `${CAMPAIGN_ACTIONS_HOME}/${actionSlug}`
if (!municipalitySlug) {
return base
}
const params = new URLSearchParams({ [WIZARD_MUNICIPIO_QUERY_KEY]: municipalitySlug })
if (signalType) {
params.set(WIZARD_SIGNAL_TYPE_QUERY_KEY, signalType)
}
if (entryAction) {
params.set(WIZARD_ENTRY_ACTION_QUERY_KEY, entryAction)
}
return `${base}?${params.toString()}`
}
export const resolveWizardSignalTypeParam = (
value: string | string[] | undefined,
): { signalType?: MunicipalitySignalType; invalid: boolean } => {
const raw = Array.isArray(value) ? value[0] : value
const trimmed = raw?.trim()
if (!trimmed) {
return { signalType: undefined, invalid: false }
}
const signalType = parseMunicipalitySignalType(trimmed)
if (signalType) {
return { signalType, invalid: false }
}
return { signalType: undefined, invalid: true }
}