Add shared VIES/VAT-ID/PLZ/carrier-tracking modules (v0.3.0)

Unifies logic that was hand-duplicated (and, for PLZ, actually inconsistent) between the backend and frontend repos — both explicitly flagged this drift risk in their own code comments. vies.ts stays behind a separate ./vies subpath (server-only by convention, unlike the client-safe main barrel). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-31 15:32:55 +00:00
parent 5f5b528db5
commit 2b4b2eb91f
7 changed files with 147 additions and 1 deletions
@@ -77,6 +77,12 @@ Ships raw TypeScript/TSX source (no build step) via `main`/`types` pointing stra
 - `fonts.ts` — registers the embedded Liberation Sans font (`src/assets/fonts/`) once for both PDF modules — see the 2026-07-28 changelog entry above.
 - `seller.ts` — the shared `InvoiceSeller` type both document types render in their footer.
 - `einvoice/` — the ZUGFeRD/Factur-X layer (see "E-invoicing" below).
+- `vies.ts` — `checkVatIdViaVies()`, a live check against the EU Commission's VIES API (server-only — import from `@einfach-produktiv/invoicing/vies`, not the main barrel).
+- `vatId.ts` — `normalizeVatId()`/`isValidVatId()`, EU VAT-ID format validation (client- and server-safe).
+- `plz.ts` — `isValidPlz()`/`plzInputPattern()`, postal-code digit-count validation keyed by a caller-supplied digit count per country.
+- `carrierTracking.ts` — `CARRIER_LABELS`/`buildTrackingUrl()`, shipping-carrier tracking-link generation.
+
+These four were unified from what used to be hand-duplicated, independently-drifting copies in both consuming repos (each had its own `vies.ts`/`vatId.ts`/PLZ-regex/`tracking.ts`) — see each consumer's own README for where they're used. The small in-memory rate limiter each repo also has (`rateLimit.ts`) is deliberately left duplicated — small enough (~15 lines) that a shared dependency isn't worth the coupling.

 ## E-invoicing