Kiegészítők
A fő kassza modul a Számla Agent hívásait intézi. A körülötte lévő feladatokra külön alcsomagok vannak, amelyeket csak akkor importálsz, ha kellenek. Egyiknek sincs futásidejű függősége, és a kassza/storage/fs kivételével egyik sem használ Node.js API-t.
| Alcsomag | Mire való? |
|---|---|
kassza/testing | Mock kliens hálózat és Agent kulcs nélküli tesztekhez |
kassza/validators | Adószám, bankszámla, IBAN, EU adószám, e-mail és cím ellenőrzése |
kassza/money | A számlán használt kerekítés és összegzés a saját kódodban |
kassza/storage, kassza/storage/fs | A bizonylat PDF mentése S3-ba, R2-be, Vercel Blobba, Supabase-be vagy lemezre |
kassza/cookie-stores | Közös munkamenet-tároló serverless és edge környezethez |
kassza/ipn | A Számlázz.hu fizetési értesítéseinek fogadása |
Tesztelés
createMockKassza: hívásnapló, szimulált hibák és Vitest példák valódi API nélkül.
ValidátorokAdószám CDV, bankszámla, IBAN, EU adószám, e-mail és magyar cím feldolgozása.
PénzszámításTételösszegek, áfabontás és kerekítés pontosan úgy, ahogy a számlára kerül.
PDF tárhelystorePdf, dátum szerinti kulcsok és adapterek S3-hoz, R2-höz, Vercel Blobhoz és társaikhoz.
Serverless és edgeVercel, Cloudflare Workers, Deno, Bun és AWS Lambda: munkamenet, időkorlát, webhookok.
AI asszisztensekAz agents mappa és az llms.txt használata Claude Code, Cursor és Copilot mellett.