@fin.cx/opendata 4.2.0 → 4.3.1

package/ts/vatid/vatid.ts

@@ -0,0 +1,25 @@
+import { vatIdCountryCodes } from './constants.js';
+import type { IVatIdParts, TVatIdCountryCode } from './interfaces.js';
+
+/** A VAT ID as it is printed: spaces, dots and hyphens between its characters are left out. */
+const SEPARATORS = /[\s.\-]+/gu;
+
+/** After the country code: letters and digits, 2 to 13 of them (the longest form, France and the Netherlands, has 12). */
+const NUMBER_PART = /^[A-Z0-9+*]{2,13}$/u;
+
+/**
+ * Takes a VAT identification number apart: its country code and the number after it, without the
+ * spaces, dots and hyphens it is often printed with, in capitals. `GR` is written `EL`, as VAT IDs of
+ * Greece are. Answers `undefined` for anything that does not start with a member state's code or has
+ * no number after it; whether the number has its member state's form is the service's to say.
+ */
+export const splitVatId = (valueArg: string): IVatIdParts | undefined => {
+  const compact = valueArg.replace(SEPARATORS, '').toUpperCase();
+  const prefix = compact.slice(0, 2);
+  const countryCode = prefix === 'GR' ? 'EL' : prefix;
+  const number = compact.slice(2);
+  if (!(vatIdCountryCodes as readonly string[]).includes(countryCode) || !NUMBER_PART.test(number)) {
+    return undefined;
+  }
+  return { countryCode: countryCode as TVatIdCountryCode, number, vatId: `${countryCode}${number}` };
+};