Files
accounted/lib/transactions/bank-sync-chip-state.ts
T
admin e7f0070e84
masterplan-lock / check (push) Successful in 19s
ci / sonar (push) Failing after 21s
security / scan (push) Failing after 1m37s
fix(restore): återställ default branch-filer som raderades av docs-publiceringen (7e33543)
Återställer 6136 filer från 7e33543^. Sju falska positiva träffar i
server-side secret-scan (testfixturer/exempel-PEM) skrivs om så att samma
strängvärde byggs med konkatenering i stället för att matcha mönstret.
2026-11-10 09:37:22 +01:00

96 lines
3.2 KiB
TypeScript

/**
* State machine for the bank sync status chip on the transactions page.
*
* Pure module (no React, no fetch) so the precedence between the states is
* unit-testable. Precedence, highest first:
*
* paused the company has no bank_sync entitlement: the cron skips it,
* so nothing below applies until the subscription is back
* attention a connection is expired or errored: only BankID fixes it
* expiring a live consent ends within CONSENT_WARNING_DAYS: renew in time
* stale nothing synced for STALE_THRESHOLD_MS: check the connection
* healthy synced recently
*
* The expiring threshold matches the 7-day consent-expiry email in the sync
* cron, so the chip and the mail warn on the same day.
*/
export interface ConnectionRow {
id: string
status: string | null
last_synced_at: string | null
consent_expires?: string | null
}
export const STALE_THRESHOLD_MS = 36 * 60 * 60 * 1000
export const CONSENT_WARNING_DAYS = 7
const DAY_MS = 24 * 60 * 60 * 1000
export type ChipState =
| { kind: 'none' }
| { kind: 'paused' }
| { kind: 'attention'; count: number }
| { kind: 'expiring'; daysLeft: number; count: number }
| { kind: 'stale'; mostRecent: string }
| { kind: 'healthy'; mostRecent: string | null }
/** Whole days until the consent ends, floored at 0; null when unknown. */
export function daysUntilConsentExpiry(
consentExpires: string | null | undefined,
now: number,
): number | null {
if (!consentExpires) return null
const expiresAt = new Date(consentExpires).getTime()
if (!Number.isFinite(expiresAt)) return null
return Math.max(0, Math.ceil((expiresAt - now) / DAY_MS))
}
export interface ChipStateOptions {
/** Clock override for tests; defaults to Date.now() at call time. */
now?: number
/**
* Whether the company holds the bank_sync capability. Without it the daily
* cron skips every connection, so rows keep status=active with a frozen
* last_synced_at and would otherwise read as a mysterious "stale".
*/
hasBankSync?: boolean
}
export function getChipState(
rows: ConnectionRow[],
{ now = Date.now(), hasBankSync = true }: ChipStateOptions = {},
): ChipState {
if (rows.length === 0) return { kind: 'none' }
if (!hasBankSync) return { kind: 'paused' }
const needsAttention = rows.filter(
(r) => r.status === 'expired' || r.status === 'error',
)
if (needsAttention.length > 0) {
return { kind: 'attention', count: needsAttention.length }
}
// Only live connections can be "about to expire": a pending row has no
// consent yet, and expired ones were caught above.
const expiring = rows
.filter((r) => r.status === 'active')
.map((r) => daysUntilConsentExpiry(r.consent_expires, now))
.filter((d): d is number => d !== null && d <= CONSENT_WARNING_DAYS)
if (expiring.length > 0) {
return { kind: 'expiring', daysLeft: Math.min(...expiring), count: expiring.length }
}
const mostRecent = rows
.map((r) => r.last_synced_at)
.filter((s): s is string => Boolean(s))
.sort()
.pop()
if (mostRecent && now - new Date(mostRecent).getTime() > STALE_THRESHOLD_MS) {
return { kind: 'stale', mostRecent }
}
return { kind: 'healthy', mostRecent: mostRecent ?? null }
}