Files
accounted/extensions/general/mail/lib/__tests__/gmail-query.test.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

136 lines
5.4 KiB
TypeScript

/**
* The Gmail query is where recall is won or lost, so it is pure and tested
* without a mailbox. Cases are drawn from the real bank descriptors and
* confirmed receipt pairs observed in production.
*/
import { describe, it, expect } from 'vitest'
import {
DAYS_AFTER,
DAYS_BEFORE,
amountTerms,
buildGmailQuery,
looksLikeReceipt,
merchantTerms,
} from '../gmail-query'
describe('merchantTerms', () => {
it('drops legal forms and other tokens that would match the whole mailbox', () => {
expect(merchantTerms('circle k')).toEqual(['circle'])
expect(merchantTerms('ryde sweden')).toEqual(['ryde'])
expect(merchantTerms('')).toEqual([])
expect(merchantTerms(null)).toEqual([])
})
it('keeps at most three terms so the query stays selective', () => {
expect(merchantTerms('alviks kott och fisk stockholm sodermalm').length).toBeLessThanOrEqual(3)
})
})
describe('amountTerms', () => {
it('offers both Swedish and international decimal forms', () => {
// A Swedish receipt writes 438,75; a SaaS invoice writes 438.75.
expect(amountTerms(438.75)).toEqual(expect.arrayContaining(['438.75', '438,75']))
})
it('adds the bare integer when the amount is whole', () => {
expect(amountTerms(425)).toEqual(expect.arrayContaining(['425.00', '425,00', '425']))
})
it('ignores the sign, since bank outflows are negative', () => {
expect(amountTerms(-425)).toEqual(amountTerms(425))
})
})
describe('buildGmailQuery', () => {
const base = { merchant: 'circle', amount: 438.75, currency: 'SEK', date: '2026-05-02' }
it('brackets the purchase with an asymmetric window', () => {
const q = buildGmailQuery(base)
// Receipts arrive at or after the purchase; the bank may post it late.
expect(DAYS_AFTER).toBeGreaterThan(DAYS_BEFORE)
expect(q).toContain('after:2026/04/28')
expect(q).toContain('before:2026/05/13')
})
it('leads with the amount, then ORs the merchant', () => {
// Amount first because it is the one signal that does not drift: banks post
// late and receipts get forwarded, so dates move, but the charged figure
// does not. Still an OR and never an AND: a receipt billed in USD contains
// no SEK amount, and a bank descriptor often names nothing in the receipt.
const q = buildGmailQuery(base)
expect(q).toMatch(/\("438\.75" OR .*"circle"/)
})
it('still searches on amount alone when the merchant is unusable', () => {
const q = buildGmailQuery({ ...base, merchant: 'ab' })
expect(q).toContain('"438.75"')
expect(q).not.toContain('"ab"')
})
it('does not require an attachment, because many receipts are the body', () => {
expect(buildGmailQuery(base)).not.toContain('has:attachment')
})
})
describe('looksLikeReceipt', () => {
it('keeps plausible receipts', () => {
expect(looksLikeReceipt('Ditt kvitto från Circle K', 'no-reply@circlek.se')).toBe(true)
expect(looksLikeReceipt('Your receipt from Anthropic', 'billing@anthropic.com')).toBe(true)
})
it('drops the obvious non-receipts before anything expensive reads them', () => {
expect(looksLikeReceipt('Nyhetsbrev maj', 'news@example.com')).toBe(false)
expect(looksLikeReceipt('Calendar invite: standup', 'cal@example.com')).toBe(false)
})
})
describe('buildAuthorizationUrl', () => {
it('carries the CSRF state, which the callback refuses to proceed without', async () => {
const { buildAuthorizationUrl } = await import('../google-oauth')
const url = buildAuthorizationUrl(
{ clientId: 'cid', clientSecret: 'sec', redirectUri: 'https://app.accounted.se/cb' },
'signed-state',
)
const params = new URL(url).searchParams
expect(params.get('state')).toBe('signed-state')
// Read-only, and offline so a refresh token is actually issued.
expect(params.get('scope')).toContain('gmail.readonly')
expect(params.get('scope')).not.toContain('gmail.modify')
expect(params.get('scope')).not.toContain('gmail.send')
expect(params.get('access_type')).toBe('offline')
// Not incremental: include_granted_scopes would let Google fold scopes this
// app was granted elsewhere into the token issued here, so a mailbox grant
// could carry more authority than the consent screen showed.
expect(params.get('include_granted_scopes')).toBeNull()
})
})
/**
* Regression from the first provkörning against a real ledger: the same seven
* unrelated messages came back for every purchase, because the bank's
* description is not a merchant name and its month and person tokens match most
* of a mailbox.
*/
describe('merchant terms drawn from a real bank description', () => {
it('does not search for the month in a salary row', () => {
expect(merchantTerms('Lön Juli Jakob Överföring via internet')).not.toContain('Juli')
})
it('drops the payment rail, which every row on the statement shares', () => {
const terms = merchantTerms('Kontor Sting apr BG 0000059142596 Bg-bet. via internet')
for (const noise of ['apr', 'via', 'internet']) {
expect(terms.map((t) => t.toLowerCase())).not.toContain(noise)
}
})
it('still keeps what actually names the supplier', () => {
// This row matched a real Sting invoice; the fix must not cost that.
const terms = merchantTerms('Kontor Sting apr BG 0000059142596 Bg-bet. via internet')
expect(terms.map((t) => t.toLowerCase())).toContain('sting')
})
it('leaves an ordinary card purchase alone', () => {
expect(merchantTerms('Elgiganten Aktiebolag')).toContain('Elgiganten')
})
})