@endevops/peppol-schema 0.1.2 → 0.1.4

package/dist/invoice-response-code-not-needs-schema-DNrfKYLh.js

@@ -0,0 +1,36 @@
+//#region src/invoice-response-codes/invoice-response-code-needs-schema.ts
+/**
+* @description Invoice response status codes that require a clarification. The codes are Under query (UQ), Rejected (RE), and Conditionally accepted (CA).
+* Consumed by {@link withStatusCodes}, where the `status` array must contain at least one entry.
+*
+* @example
+*   ```ts
+*   invoiceResponseCodeNeedsSchema; // ['UQ', 'RE', 'CA']
+*   ```;
+*/
+const invoiceResponseCodeNeedsSchema = [
+	"UQ",
+	"RE",
+	"CA"
+];
+//#endregion
+//#region src/invoice-response-codes/invoice-response-code-not-needs-schema.ts
+/**
+* @description Invoice response status codes that do not require a clarification. The codes are Message acknowledgement (AB), Accepted (AP), In process (IP), and
+* Paid (PD). Consumed by {@link withoutStatusCodes}, where `status` is optional.
+*
+* @example
+*   ```ts
+*   invoiceResponseCodeNotNeedsSchema; // ['AB', 'AP', 'IP', 'PD']
+*   ```;
+*/
+const invoiceResponseCodeNotNeedsSchema = [
+	"AB",
+	"AP",
+	"IP",
+	"PD"
+];
+//#endregion
+export { invoiceResponseCodeNeedsSchema as n, invoiceResponseCodeNotNeedsSchema as t };
+
+//# sourceMappingURL=invoice-response-code-not-needs-schema-DNrfKYLh.js.map

package/dist/invoice-response-code-not-needs-schema-DNrfKYLh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-response-code-not-needs-schema-DNrfKYLh.js","names":[],"sources":["../src/invoice-response-codes/invoice-response-code-needs-schema.ts","../src/invoice-response-codes/invoice-response-code-not-needs-schema.ts"],"sourcesContent":["/**\n * @description Invoice response status codes that require a clarification. The codes are Under query (UQ), Rejected (RE), and Conditionally accepted (CA).\n * Consumed by {@link withStatusCodes}, where the `status` array must contain at least one entry.\n *\n * @example\n *   ```ts\n *   invoiceResponseCodeNeedsSchema; // ['UQ', 'RE', 'CA']\n *   ```;\n */\nexport const invoiceResponseCodeNeedsSchema = ['UQ', 'RE', 'CA'] as const;\n","/**\n * @description Invoice response status codes that do not require a clarification. The codes are Message acknowledgement (AB), Accepted (AP), In process (IP), and\n * Paid (PD). Consumed by {@link withoutStatusCodes}, where `status` is optional.\n *\n * @example\n *   ```ts\n *   invoiceResponseCodeNotNeedsSchema; // ['AB', 'AP', 'IP', 'PD']\n *   ```;\n */\nexport const invoiceResponseCodeNotNeedsSchema = ['AB', 'AP', 'IP', 'PD'] as const;\n"],"mappings":";;;;;;;;;;AASA,MAAa,iCAAiC;CAAC;CAAM;CAAM;AAAI;;;;;;;;;;;;ACA/D,MAAa,oCAAoC;CAAC;CAAM;CAAM;CAAM;AAAI"}

package/dist/invoice-response-codes.d.ts

@@ -1,11 +1,39 @@
 import { t as InvoiceStatusCodesKeys } from "./invoice-status-codes.generated-DL-agLdx.js";
 //#region src/invoice-response-codes/invoice-response-code-needs-schema.d.ts
+/**
+ * @description Invoice response status codes that require a clarification. The codes are Under query (UQ), Rejected (RE), and Conditionally accepted (CA).
+ * Consumed by {@link withStatusCodes}, where the `status` array must contain at least one entry.
+ *
+ * @example
+ *   ```ts
+ *   invoiceResponseCodeNeedsSchema; // ['UQ', 'RE', 'CA']
+ *   ```;
+ */
 export declare const invoiceResponseCodeNeedsSchema: readonly ['UQ', 'RE', 'CA'];
 //#endregion
 //#region src/invoice-response-codes/invoice-response-code-not-needs-schema.d.ts
+/**
+ * @description Invoice response status codes that do not require a clarification. The codes are Message acknowledgement (AB), Accepted (AP), In process (IP), and
+ * Paid (PD). Consumed by {@link withoutStatusCodes}, where `status` is optional.
+ *
+ * @example
+ *   ```ts
+ *   invoiceResponseCodeNotNeedsSchema; // ['AB', 'AP', 'IP', 'PD']
+ *   ```;
+ */
 export declare const invoiceResponseCodeNotNeedsSchema: readonly ['AB', 'AP', 'IP', 'PD'];
 //#endregion
 //#region src/invoice-response-codes/invoice-response-codes-order.d.ts
+/**
+ * @description Map of allowed status transitions for an invoice response, keyed by the current status code. Each value lists the status codes that may follow the
+ * key. Keys and values are {@link InvoiceStatusCodesKeys}. The terminal statuses PD and RE map to empty arrays.
+ *
+ * @example
+ *   ```ts
+ *   invoiceResponseCodesOrder.UQ; // ['CA', 'AP', 'RE']
+ *   invoiceResponseCodesOrder.PD; // []
+ *   ```;
+ */
 export declare const invoiceResponseCodesOrder: Record<InvoiceStatusCodesKeys, Array<InvoiceStatusCodesKeys>>;
 //#endregion
 //# sourceMappingURL=invoice-response-codes.d.ts.map

package/dist/invoice-response-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoice-response-codes.d.ts","names":[],"sources":["../src/invoice-response-codes/invoice-response-code-needs-schema.ts","../src/invoice-response-codes/invoice-response-code-not-needs-schema.ts","../src/invoice-response-codes/invoice-response-codes-order.ts"],"mappings":";;qBAAa;;;qBCAA;;;qBCEA,2BAA2B,OAAO,wBAAwB,MAAM"}
+{"version":3,"file":"invoice-response-codes.d.ts","names":[],"sources":["../src/invoice-response-codes/invoice-response-code-needs-schema.ts","../src/invoice-response-codes/invoice-response-code-not-needs-schema.ts","../src/invoice-response-codes/invoice-response-codes-order.ts"],"mappings":";;;;;;;;;;;qBASa;;;;;;;;;;;;qBCAA;;;;;;;;;;;;;qBCGA,2BAA2B,OAAO,wBAAwB,MAAM"}

package/dist/invoice-response-codes.js

@@ -1,5 +1,15 @@
-import { n as invoiceResponseCodeNeedsSchema, t as invoiceResponseCodeNotNeedsSchema } from "./invoice-response-code-not-needs-schema-p_RKKNLc.js";
+import { n as invoiceResponseCodeNeedsSchema, t as invoiceResponseCodeNotNeedsSchema } from "./invoice-response-code-not-needs-schema-DNrfKYLh.js";
 //#region src/invoice-response-codes/invoice-response-codes-order.ts
+/**
+* @description Map of allowed status transitions for an invoice response, keyed by the current status code. Each value lists the status codes that may follow the
+* key. Keys and values are {@link InvoiceStatusCodesKeys}. The terminal statuses PD and RE map to empty arrays.
+*
+* @example
+*   ```ts
+*   invoiceResponseCodesOrder.UQ; // ['CA', 'AP', 'RE']
+*   invoiceResponseCodesOrder.PD; // []
+*   ```;
+*/
 const invoiceResponseCodesOrder = {
 	AB: [
 		"IP",

package/dist/invoice-response-codes.js.map

@@ -1 +1 @@
-{"version":3,"file":"invoice-response-codes.js","names":[],"sources":["../src/invoice-response-codes/invoice-response-codes-order.ts"],"sourcesContent":["import type { InvoiceStatusCodesKeys } from '#/values/invoice-status-codes.generated';\n\nexport const invoiceResponseCodesOrder: Record<InvoiceStatusCodesKeys, Array<InvoiceStatusCodesKeys>> = {\n  AB: ['IP', 'UQ', 'AP', 'CA', 'PD', 'RE'],\n  AP: ['PD'],\n  CA: ['PD'],\n  IP: ['UQ', 'CA', 'AP', 'PD', 'RE'],\n  PD: [],\n  RE: [],\n  UQ: ['CA', 'AP', 'RE'],\n};\n"],"mappings":";;AAEA,MAAa,4BAA2F;CACtG,IAAI;EAAC;EAAM;EAAM;EAAM;EAAM;EAAM;CAAI;CACvC,IAAI,CAAC,IAAI;CACT,IAAI,CAAC,IAAI;CACT,IAAI;EAAC;EAAM;EAAM;EAAM;EAAM;CAAI;CACjC,IAAI,CAAC;CACL,IAAI,CAAC;CACL,IAAI;EAAC;EAAM;EAAM;CAAI;AACvB"}
+{"version":3,"file":"invoice-response-codes.js","names":[],"sources":["../src/invoice-response-codes/invoice-response-codes-order.ts"],"sourcesContent":["import type { InvoiceStatusCodesKeys } from '#/values/invoice-status-codes.generated';\n\n/**\n * @description Map of allowed status transitions for an invoice response, keyed by the current status code. Each value lists the status codes that may follow the\n * key. Keys and values are {@link InvoiceStatusCodesKeys}. The terminal statuses PD and RE map to empty arrays.\n *\n * @example\n *   ```ts\n *   invoiceResponseCodesOrder.UQ; // ['CA', 'AP', 'RE']\n *   invoiceResponseCodesOrder.PD; // []\n *   ```;\n */\nexport const invoiceResponseCodesOrder: Record<InvoiceStatusCodesKeys, Array<InvoiceStatusCodesKeys>> = {\n  AB: ['IP', 'UQ', 'AP', 'CA', 'PD', 'RE'],\n  AP: ['PD'],\n  CA: ['PD'],\n  IP: ['UQ', 'CA', 'AP', 'PD', 'RE'],\n  PD: [],\n  RE: [],\n  UQ: ['CA', 'AP', 'RE'],\n};\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,4BAA2F;CACtG,IAAI;EAAC;EAAM;EAAM;EAAM;EAAM;EAAM;CAAI;CACvC,IAAI,CAAC,IAAI;CACT,IAAI,CAAC,IAAI;CACT,IAAI;EAAC;EAAM;EAAM;EAAM;EAAM;CAAI;CACjC,IAAI,CAAC;CACL,IAAI,CAAC;CACL,IAAI;EAAC;EAAM;EAAM;CAAI;AACvB"}

package/dist/{is-valid-abn-160i38PG.js → is-valid-abn-D7eSygBG.js}

@@ -1,7 +1,17 @@
-import { n as normalizeSpace } from "./is-valid-mod97-0208-CzMOXMO-.js";
+import { n as normalizeSpace } from "./is-valid-mod97-0208-CjR324eG.js";
 //#region src/peppol-validations/is-valid-iban.ts
 /**
 * @description IBAN validation using mod 97 algorithm.
+*
+* @example
+*   ```ts
+*   isValidIBAN('GB82 WEST 1234 5698 7654 32'); // true
+*   ```;
+*
+* @param iban - The IBAN to validate, with or without spaces.
+*
+* @returns `true` when the normalised value matches the `{2 letters}{2 digits}{up to 30 alphanumerics}` shape and its mod 97 remainder is 1,
+*   otherwise `false`.
 */
 function isValidIBAN(iban) {
 	const s = normalizeSpace(iban).replace(/[ \t\r\n]/g, "");
@@ -18,6 +28,15 @@ function isValidIBAN(iban) {
 //#region src/peppol-validations/greek-tin-verification.ts
 /**
 * @description Greek TIN verification.
+*
+* @example
+*   ```ts
+*   greekTinVerification('123456783'); // true
+*   ```;
+*
+* @param val - The nine digit Greek tax identification number.
+*
+* @returns `true` when the value is nine digits and the computed checksum matches the last digit, otherwise `false`.
 */
 function greekTinVerification(val) {
 	if (!/^\d{9}$/.test(val)) return false;
@@ -28,6 +47,15 @@ function greekTinVerification(val) {
 //#region src/peppol-validations/is-valid-mod11.ts
 /**
 * @description Validates Norwegian organization numbers using mod11 algorithm.
+*
+* @example
+*   ```ts
+*   isValidMod11('923609016'); // true
+*   ```;
+*
+* @param val - The organization number to validate. Whitespace is normalised first.
+*
+* @returns `true` when the normalised value is at least two digits and its mod 11 check digit matches, otherwise `false`.
 */
 function isValidMod11(val) {
 	const s = normalizeSpace(val);
@@ -45,6 +73,16 @@ function isValidMod11(val) {
 //#region src/peppol-validations/is-valid-gln.ts
 /**
 * @description [GLN](https://en.wikipedia.org/wiki/Global_Location_Number) check (GS1)
+*
+* @example
+*   ```ts
+*   isValidGLN('1234567890128'); // { success: true }
+*   ```;
+*
+* @param val - The GLN to validate. Whitespace is stripped first.
+*
+* @returns `{ success: true }` when the computed check digit matches the last digit, otherwise `{ success: false, expected, actual }` with the
+*   computed and supplied check digits.
 */
 function isValidGLN(val) {
 	const value = (val ?? "").replace(/\s+/g, "");
@@ -61,6 +99,18 @@ function isValidGLN(val) {
 //#region src/peppol-validations/check-cf16.ts
 /**
 * @description Validates 16-character Italian fiscal codes.
+*
+* @example
+*   ```ts
+*   checkCF16('RSSMRA80A01H501U'); // true
+*   ```;
+*
+* @param arg - The fiscal code to validate. Whitespace is normalised first.
+*
+* @returns `true` when the normalised code is 16 characters and matches `{6 letters}{2 digits}{letter}{2 digits}{letter}{3 digits}{letter}`,
+*   otherwise `false`.
+*
+* @see {@link checkCF}
 */
 function checkCF16(arg) {
 	const s = normalizeSpace(arg);
@@ -72,6 +122,17 @@ function checkCF16(arg) {
 //#region src/peppol-validations/check-cf.ts
 /**
 * @description Validates both 16 and 11 character Italian fiscal codes.
+*
+* @example
+*   ```ts
+*   checkCF('RSSMRA80A01H501U'); // true
+*   ```;
+*
+* @param arg - The fiscal code to validate. Whitespace is normalised first.
+*
+* @returns `true` when the normalised code is a valid 16 character personal fiscal code or an 11 digit VAT code, otherwise `false`.
+*
+* @see {@link checkCF16}
 */
 function checkCF(arg) {
 	const s = normalizeSpace(arg);
@@ -83,6 +144,18 @@ function checkCF(arg) {
 //#region src/peppol-validations/add-piva.ts
 /**
 * @description Helper function for calculating weighted sum for Italian PIVA validation.
+*
+* @example
+*   ```ts
+*   addPIVA('123', 0); // 8
+*   ```;
+*
+* @param arg - The digit string to sum, processed one character at a time.
+* @param pari - Parity flag toggled at each recursion; `1` maps the digit through the `0246813579` table, `0` keeps it as is.
+*
+* @returns The weighted sum, or `0` when `arg` contains a non-digit.
+*
+* @see {@link checkPIVA}
 */
 function addPIVA(arg, pari) {
 	if (!/^\d+$/.test(arg)) return 0;
@@ -95,6 +168,17 @@ function addPIVA(arg, pari) {
 //#region src/peppol-validations/check-piva.ts
 /**
 * @description Validates Italian VAT numbers (PIVA)
+*
+* @example
+*   ```ts
+*   checkPIVA('00743110157'); // 0
+*   ```;
+*
+* @param arg - The Italian VAT number without the `IT` prefix.
+*
+* @returns `0` when valid, otherwise the non-zero remainder of {@link addPIVA}, or `1` when `arg` contains a non-digit.
+*
+* @see {@link addPIVA}
 */
 function checkPIVA(arg) {
 	if (!/^\d+$/.test(arg)) return 1;
@@ -104,6 +188,17 @@ function checkPIVA(arg) {
 //#region src/peppol-validations/check-piva-se-it.ts
 /**
 * @description Validates Italian VAT numbers with IT prefix.
+*
+* @example
+*   ```ts
+*   checkPIVAseIT('IT00743110157'); // true
+*   ```;
+*
+* @param arg - The VAT identifier including its two letter country prefix.
+*
+* @returns `true` when the prefix is not `IT`, or when the 11 digit Italian part passes {@link checkPIVA}; otherwise `false`.
+*
+* @see {@link checkPIVA}
 */
 function checkPIVAseIT(arg) {
 	const paese = arg.substring(0, 2);
@@ -115,6 +210,15 @@ function checkPIVAseIT(arg) {
 //#region src/peppol-validations/check-se-orgnr.ts
 /**
 * @description Validates Swedish organization numbers (0007)
+*
+* @example
+*   ```ts
+*   checkSEOrgnr('5560160680'); // true
+*   ```;
+*
+* @param number - The organization number to validate. Whitespace is normalised first.
+*
+* @returns `true` when the normalised number is 10 digits and its Luhn check digit matches, otherwise `false`.
 */
 function checkSEOrgnr(number) {
 	const s = normalizeSpace(number);
@@ -135,6 +239,15 @@ function checkSEOrgnr(number) {
 //#region src/peppol-validations/is-valid-abn.ts
 /**
 * @description Australian Business Number (ABN) validation.
+*
+* @example
+*   ```ts
+*   isValidABN('51 824 753 556'); // true
+*   ```;
+*
+* @param val - The ABN to validate. Whitespace is normalised first.
+*
+* @returns `true` when the normalised value is 11 digits and the weighted checksum is divisible by 89, otherwise `false`.
 */
 function isValidABN(val) {
 	const s = normalizeSpace(val);
@@ -159,4 +272,4 @@ function isValidABN(val) {
 //#endregion
 export { addPIVA as a, isValidGLN as c, isValidIBAN as d, checkPIVA as i, isValidMod11 as l, checkSEOrgnr as n, checkCF as o, checkPIVAseIT as r, checkCF16 as s, isValidABN as t, greekTinVerification as u };
 
-//# sourceMappingURL=is-valid-abn-160i38PG.js.map
+//# sourceMappingURL=is-valid-abn-D7eSygBG.js.map

package/dist/is-valid-abn-D7eSygBG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid-abn-D7eSygBG.js","names":[],"sources":["../src/peppol-validations/is-valid-iban.ts","../src/peppol-validations/greek-tin-verification.ts","../src/peppol-validations/is-valid-mod11.ts","../src/peppol-validations/is-valid-gln.ts","../src/peppol-validations/check-cf16.ts","../src/peppol-validations/check-cf.ts","../src/peppol-validations/add-piva.ts","../src/peppol-validations/check-piva.ts","../src/peppol-validations/check-piva-se-it.ts","../src/peppol-validations/check-se-orgnr.ts","../src/peppol-validations/is-valid-abn.ts"],"sourcesContent":["import { normalizeSpace } from './normalize-space.ts';\n\n/**\n * @description IBAN validation using mod 97 algorithm.\n *\n * @example\n *   ```ts\n *   isValidIBAN('GB82 WEST 1234 5698 7654 32'); // true\n *   ```;\n *\n * @param iban - The IBAN to validate, with or without spaces.\n *\n * @returns `true` when the normalised value matches the `{2 letters}{2 digits}{up to 30 alphanumerics}` shape and its mod 97 remainder is 1,\n *   otherwise `false`.\n */\nexport function isValidIBAN(iban: string): boolean {\n  const s = normalizeSpace(iban).replace(/[ \\t\\r\\n]/g, '');\n  if (!/^[A-Z]{2}\\d{2}[A-Za-z0-9]{0,30}$/.test(s)) return false;\n  const rearranged = s.slice(4) + s.slice(0, 4);\n  const converted = rearranged\n    .split('')\n    .map(ch => {\n      const code = ch.charCodeAt(0);\n      // A=10..Z=35, digits 0..9\n      return code >= 65 && code <= 90 ? String(code - 55) : ch;\n    })\n    .join('');\n  // mod 97 calculation on big integer string\n  let remainder = 0;\n  for (const c of converted) {\n    remainder = (remainder * 10 + (c.charCodeAt(0) - 48)) % 97;\n  }\n  return remainder === 1;\n}\n","/**\n * @description Greek TIN verification.\n *\n * @example\n *   ```ts\n *   greekTinVerification('123456783'); // true\n *   ```;\n *\n * @param val - The nine digit Greek tax identification number.\n *\n * @returns `true` when the value is nine digits and the computed checksum matches the last digit, otherwise `false`.\n */\nexport function greekTinVerification(val: string): boolean {\n  if (!/^\\d{9}$/.test(val)) return false;\n  const digits = val.split('').map(Number) as [number, number, number, number, number, number, number, number, number];\n  const checksum =\n    digits[7] * 2 + digits[6] * 4 + digits[5] * 8 + digits[4] * 16 + digits[3] * 32 + digits[2] * 64 + digits[1] * 128 + digits[0] * 256;\n\n  return (checksum % 11) % 10 === digits[8];\n}\n","import { normalizeSpace } from './normalize-space.ts';\n\n/**\n * @description Validates Norwegian organization numbers using mod11 algorithm.\n *\n * @example\n *   ```ts\n *   isValidMod11('923609016'); // true\n *   ```;\n *\n * @param val - The organization number to validate. Whitespace is normalised first.\n *\n * @returns `true` when the normalised value is at least two digits and its mod 11 check digit matches, otherwise `false`.\n */\nexport function isValidMod11(val: string): boolean {\n  const s = normalizeSpace(val);\n  if (!/^\\d+$/.test(s) || s.length < 2) return false;\n  const length = s.length - 1;\n  let weightedSum = 0;\n  // weights 2..7 repeated\n  for (let i = 0; i < length; i += 1) {\n    const digit = s.charCodeAt(length - 1 - i) - 48; // reverse to match XSLT reverse\n    const weight = (i % 6) + 2;\n    weightedSum += digit * weight;\n  }\n  const check = (11 - (weightedSum % 11)) % 11;\n  return check === Number(s[length]);\n}\n","/**\n * @description [GLN](https://en.wikipedia.org/wiki/Global_Location_Number) check (GS1)\n *\n * @example\n *   ```ts\n *   isValidGLN('1234567890128'); // { success: true }\n *   ```;\n *\n * @param val - The GLN to validate. Whitespace is stripped first.\n *\n * @returns `{ success: true }` when the computed check digit matches the last digit, otherwise `{ success: false, expected, actual }` with the\n *   computed and supplied check digits.\n */\nexport function isValidGLN(val: string): { success: true } | { success: false; expected: number; actual: number } {\n  const value = (val ?? '').replace(/\\s+/g, '');\n  const len = value.length - 1;\n\n  const digits = value\n    .slice(0, len)\n    .split('')\n    .map(c => c.charCodeAt(0) - 48)\n    .reverse();\n\n  const weightedSum = digits.reduce((sum, d, i) => sum + d * (1 + ((i + 1) % 2) * 2), 0);\n  const check = (10 - (weightedSum % 10)) % 10;\n  const success = check === Number(value[len]);\n  if (success) {\n    return { success: true };\n  }\n  return { actual: Number(value[len]), expected: check, success: false };\n}\n","import { normalizeSpace } from './normalize-space.ts';\n\n/**\n * @description Validates 16-character Italian fiscal codes.\n *\n * @example\n *   ```ts\n *   checkCF16('RSSMRA80A01H501U'); // true\n *   ```;\n *\n * @param arg - The fiscal code to validate. Whitespace is normalised first.\n *\n * @returns `true` when the normalised code is 16 characters and matches `{6 letters}{2 digits}{letter}{2 digits}{letter}{3 digits}{letter}`,\n *   otherwise `false`.\n *\n * @see {@link checkCF}\n */\nexport function checkCF16(arg: string): boolean {\n  const s = normalizeSpace(arg);\n  if (s.length !== 16) return false;\n  if (!/^[A-Za-z]{6}\\d{2}[A-Za-z]\\d{2}[A-Za-z]\\d{3}[A-Za-z]$/.test(s)) return false;\n  return true;\n}\n","import { checkCF16 } from './check-cf16.ts';\nimport { normalizeSpace } from './normalize-space.ts';\n\n/**\n * @description Validates both 16 and 11 character Italian fiscal codes.\n *\n * @example\n *   ```ts\n *   checkCF('RSSMRA80A01H501U'); // true\n *   ```;\n *\n * @param arg - The fiscal code to validate. Whitespace is normalised first.\n *\n * @returns `true` when the normalised code is a valid 16 character personal fiscal code or an 11 digit VAT code, otherwise `false`.\n *\n * @see {@link checkCF16}\n */\nexport function checkCF(arg: string): boolean {\n  const s = normalizeSpace(arg);\n  if (s.length === 16) return checkCF16(s);\n  if (s.length === 11) return /^\\d{11}$/.test(s);\n  return false;\n}\n","// NOTE: check and add valid values for the tests in `add-piva.spec.ts`\n\n/**\n * @description Helper function for calculating weighted sum for Italian PIVA validation.\n *\n * @example\n *   ```ts\n *   addPIVA('123', 0); // 8\n *   ```;\n *\n * @param arg - The digit string to sum, processed one character at a time.\n * @param pari - Parity flag toggled at each recursion; `1` maps the digit through the `0246813579` table, `0` keeps it as is.\n *\n * @returns The weighted sum, or `0` when `arg` contains a non-digit.\n *\n * @see {@link checkPIVA}\n */\nexport function addPIVA(arg: string, pari: number): number {\n  if (!/^\\d+$/.test(arg)) return 0;\n  const first = Number(arg[0]);\n  const mapper = pari === 1 ? Number('0246813579'[first]) : first;\n  if (arg.length === 1) return mapper;\n  return mapper + addPIVA(arg.slice(1), pari === 0 ? 1 : 0);\n}\n","import { addPIVA } from './add-piva.ts';\n\n/**\n * @description Validates Italian VAT numbers (PIVA)\n *\n * @example\n *   ```ts\n *   checkPIVA('00743110157'); // 0\n *   ```;\n *\n * @param arg - The Italian VAT number without the `IT` prefix.\n *\n * @returns `0` when valid, otherwise the non-zero remainder of {@link addPIVA}, or `1` when `arg` contains a non-digit.\n *\n * @see {@link addPIVA}\n */\nexport function checkPIVA(arg: string): number {\n  if (!/^\\d+$/.test(arg)) return 1;\n  return addPIVA(arg, 0) % 10;\n}\n","import { checkPIVA } from './check-piva.ts';\n\n/**\n * @description Validates Italian VAT numbers with IT prefix.\n *\n * @example\n *   ```ts\n *   checkPIVAseIT('IT00743110157'); // true\n *   ```;\n *\n * @param arg - The VAT identifier including its two letter country prefix.\n *\n * @returns `true` when the prefix is not `IT`, or when the 11 digit Italian part passes {@link checkPIVA}; otherwise `false`.\n *\n * @see {@link checkPIVA}\n */\nexport function checkPIVAseIT(arg: string): boolean {\n  const paese = arg.substring(0, 2);\n  const codice = arg.substring(2);\n  if (paese.toUpperCase() !== 'IT') return true;\n  return codice.length === 11 && checkPIVA(codice) === 0;\n}\n","import { normalizeSpace } from './normalize-space.ts';\n\n/**\n * @description Validates Swedish organization numbers (0007)\n *\n * @example\n *   ```ts\n *   checkSEOrgnr('5560160680'); // true\n *   ```;\n *\n * @param number - The organization number to validate. Whitespace is normalised first.\n *\n * @returns `true` when the normalised number is 10 digits and its Luhn check digit matches, otherwise `false`.\n */\nexport function checkSEOrgnr(number: string): boolean {\n  const s = normalizeSpace(number);\n  if (!/^\\d+$/.test(s) || s.length !== 10) return false;\n  const main = s.substring(0, 9);\n  const checkDigit = Number(s[9]);\n  let sum = 0;\n  for (let pos = 1; pos <= main.length; pos += 1) {\n    const digit = Number(main[main.length - pos]);\n    if (pos % 2 === 1) {\n      const dbl = ((digit * 2) % 10) + Math.floor((digit * 2) / 10);\n      sum += dbl;\n    } else {\n      sum += digit;\n    }\n  }\n  const calculated = (10 - (sum % 10)) % 10;\n  return calculated === checkDigit;\n}\n","import { normalizeSpace } from './normalize-space.ts';\n\n/**\n * @description Australian Business Number (ABN) validation.\n *\n * @example\n *   ```ts\n *   isValidABN('51 824 753 556'); // true\n *   ```;\n *\n * @param val - The ABN to validate. Whitespace is normalised first.\n *\n * @returns `true` when the normalised value is 11 digits and the weighted checksum is divisible by 89, otherwise `false`.\n */\nexport function isValidABN(val: string): boolean {\n  const s = normalizeSpace(val);\n  if (!/^\\d{11}$/.test(s)) return false;\n  const weights = [10, 1, 3, 5, 7, 9, 11, 13, 15, 17, 19];\n  let sum = (s.charCodeAt(0) - 49) * 10; // (first digit -1)*10\n  for (let i = 1; i < 11; i += 1) {\n    sum += (s.charCodeAt(i) - 48) * weights[i]!;\n  }\n  return sum % 89 === 0;\n}\n"],"mappings":"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"}

package/dist/{is-valid-mod97-0208-CzMOXMO-.js → is-valid-mod97-0208-CjR324eG.js}

@@ -9,6 +9,16 @@ function normalizeSpace(input) {
 //#region src/peppol-validations/is-valid-mod97-0208.ts
 /**
 * @description Belgian enterprise number validation (mod 97-0208)
+*
+* @example
+*   ```ts
+*   isValidMod97_0208('0123456749'); // { success: true }
+*   ```;
+*
+* @param val - The enterprise number to validate. Whitespace is normalised first.
+*
+* @returns `{ success: true }` when the last two digits equal `97 - (first eight digits % 97)`, otherwise `{ success: false, expected, actual }` with
+*   the computed and supplied check digits.
 */
 function isValidMod97_0208(val) {
 	const s = normalizeSpace(val);
@@ -24,4 +34,4 @@ function isValidMod97_0208(val) {
 //#endregion
 export { normalizeSpace as n, isValidMod97_0208 as t };
 
-//# sourceMappingURL=is-valid-mod97-0208-CzMOXMO-.js.map
+//# sourceMappingURL=is-valid-mod97-0208-CjR324eG.js.map

package/dist/is-valid-mod97-0208-CjR324eG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid-mod97-0208-CjR324eG.js","names":[],"sources":["../src/peppol-validations/normalize-space.ts","../src/peppol-validations/is-valid-mod97-0208.ts"],"sourcesContent":["/**\n * @description Normalize whitespace in a string by replacing multiple whitespace characters with a single space and trimming.\n */\nexport function normalizeSpace(input: string): string {\n  const s = typeof input === 'string' ? input : input == null ? '' : String(input);\n  return s.replace(/\\s+/g, ' ').trim();\n}\n","import { normalizeSpace } from './normalize-space.ts';\n\n/**\n * @description Belgian enterprise number validation (mod 97-0208)\n *\n * @example\n *   ```ts\n *   isValidMod97_0208('0123456749'); // { success: true }\n *   ```;\n *\n * @param val - The enterprise number to validate. Whitespace is normalised first.\n *\n * @returns `{ success: true }` when the last two digits equal `97 - (first eight digits % 97)`, otherwise `{ success: false, expected, actual }` with\n *   the computed and supplied check digits.\n */\nexport function isValidMod97_0208(val: string): { success: true } | { success: false; expected: number; actual: number } {\n  const s = normalizeSpace(val);\n  const checkdigits = Number(s.substring(8, 10));\n  const main = Number(s.substring(0, 8));\n  const calculated = 97 - (main % 97);\n  const success = checkdigits === calculated;\n  if (success) {\n    return { success: true };\n  }\n  return { actual: checkdigits, expected: calculated, success: false };\n}\n"],"mappings":";;;;AAGA,SAAgB,eAAe,OAAuB;CAEpD,QADU,OAAO,UAAU,WAAW,QAAQ,SAAS,OAAO,KAAK,OAAO,KAAK,EAAA,CACtE,QAAQ,QAAQ,GAAG,CAAC,CAAC,KAAK;AACrC;;;;;;;;;;;;;;;;ACSA,SAAgB,kBAAkB,KAAuF;CACvH,MAAM,IAAI,eAAe,GAAG;CAC5B,MAAM,cAAc,OAAO,EAAE,UAAU,GAAG,EAAE,CAAC;CAE7C,MAAM,aAAa,KADN,OAAO,EAAE,UAAU,GAAG,CAAC,CACR,IAAI;CAEhC,IADgB,gBAAgB,YAE9B,OAAO,EAAE,SAAS,KAAK;CAEzB,OAAO;EAAE,QAAQ;EAAa,UAAU;EAAY,SAAS;CAAM;AACrE"}

package/dist/message-level-response-profile-id-B9c0A7S_.js

@@ -0,0 +1,27 @@
+//#region src/constants/invoice-response-profile-id.ts
+/**
+* @description PEPPOL profile id for the invoice response, version 3. It is the `cbc:ProfileID` value fixed by {@link PeppolInvoiceResponse} and is matched when
+* dispatching `ApplicationResponse` documents to that schema.
+*
+* @example
+*   ```ts
+*   INVOICE_RESPONSE_PROFILE_ID; // 'urn:fdc:peppol.eu:poacc:bis:invoice_response:3'
+*   ```;
+*/
+const INVOICE_RESPONSE_PROFILE_ID = "urn:fdc:peppol.eu:poacc:bis:invoice_response:3";
+//#endregion
+//#region src/constants/message-level-response-profile-id.ts
+/**
+* @description PEPPOL profile id for the message level response, version 3. It is the `cbc:ProfileID` value fixed by {@link PeppolMessageLevelResponse} and is
+* matched when dispatching `ApplicationResponse` documents to that schema.
+*
+* @example
+*   ```ts
+*   MESSAGE_LEVEL_RESPONSE_PROFILE_ID; // 'urn:fdc:peppol.eu:poacc:bis:mlr:3'
+*   ```;
+*/
+const MESSAGE_LEVEL_RESPONSE_PROFILE_ID = "urn:fdc:peppol.eu:poacc:bis:mlr:3";
+//#endregion
+export { INVOICE_RESPONSE_PROFILE_ID as n, MESSAGE_LEVEL_RESPONSE_PROFILE_ID as t };
+
+//# sourceMappingURL=message-level-response-profile-id-B9c0A7S_.js.map

package/dist/message-level-response-profile-id-B9c0A7S_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-level-response-profile-id-B9c0A7S_.js","names":[],"sources":["../src/constants/invoice-response-profile-id.ts","../src/constants/message-level-response-profile-id.ts"],"sourcesContent":["/**\n * @description PEPPOL profile id for the invoice response, version 3. It is the `cbc:ProfileID` value fixed by {@link PeppolInvoiceResponse} and is matched when\n * dispatching `ApplicationResponse` documents to that schema.\n *\n * @example\n *   ```ts\n *   INVOICE_RESPONSE_PROFILE_ID; // 'urn:fdc:peppol.eu:poacc:bis:invoice_response:3'\n *   ```;\n */\nexport const INVOICE_RESPONSE_PROFILE_ID = 'urn:fdc:peppol.eu:poacc:bis:invoice_response:3' as const;\n","/**\n * @description PEPPOL profile id for the message level response, version 3. It is the `cbc:ProfileID` value fixed by {@link PeppolMessageLevelResponse} and is\n * matched when dispatching `ApplicationResponse` documents to that schema.\n *\n * @example\n *   ```ts\n *   MESSAGE_LEVEL_RESPONSE_PROFILE_ID; // 'urn:fdc:peppol.eu:poacc:bis:mlr:3'\n *   ```;\n */\nexport const MESSAGE_LEVEL_RESPONSE_PROFILE_ID = 'urn:fdc:peppol.eu:poacc:bis:mlr:3' as const;\n"],"mappings":";;;;;;;;;;AASA,MAAa,8BAA8B;;;;;;;;;;;;ACA3C,MAAa,oCAAoC"}

package/dist/{nodable-parser-CyDZtLCK.js → nodable-parser-CupS2H55.js}

@@ -2,6 +2,15 @@ import { NumberValueParser } from "@nodable/base-output-builder";
 import { CompactBuilderFactory } from "@nodable/compact-builder";
 import { XMLParser } from "@nodable/flexible-xml-parser";
 //#region src/xml/common-xml-options.ts
+/**
+* @description Options shared by the XML parser and builder so documents round-trip: `@` attributes, coerced values, trimmed values.
+*
+* @example
+*   ```ts
+*   commonXmlOptions.attributeNamePrefix; // '@'
+*   commonXmlOptions.parseAttributeValue; // true
+*   ```;
+*/
 const commonXmlOptions = {
 	attributeNamePrefix: "@",
 	format: false,
@@ -17,6 +26,15 @@ const commonXmlOptions = {
 };
 //#endregion
 //#region src/xml/builder-options.ts
+/**
+* @description Default `fast-xml-builder` options for serialising PEPPOL documents: {@link commonXmlOptions} with `suppressEmptyNode` forced on.
+*
+* @example
+*   ```ts
+*   builderOptions.attributeNamePrefix; // '@'
+*   builderOptions.suppressEmptyNode; // true
+*   ```;
+*/
 const builderOptions = {
 	...commonXmlOptions,
 	suppressEmptyNode: true
@@ -52,6 +70,18 @@ const nodableParser = new XMLParser({
 		nsPrefix: true
 	}
 });
+/**
+* @description Parses an XML string into an {@link XmlNode} tree with the nodable compact builder, coercing values and removing `@xmlns`.
+*
+* @example
+*   ```ts
+*   parseXmlNodable('<root xmlns="urn:x"><a>1</a></root>'); // { root: { a: 1 } }
+*   ```;
+*
+* @param value - The XML document to parse.
+*
+* @returns The parsed {@link XmlNode} tree with `@xmlns` stripped.
+*/
 function parseXmlNodable(value) {
 	const parsed = nodableParser.parse(value);
 	stripDefaultXmlns(parsed);
@@ -71,4 +101,4 @@ function stripDefaultXmlns(node) {
 //#endregion
 export { builderOptions as n, commonXmlOptions as r, parseXmlNodable as t };
 
-//# sourceMappingURL=nodable-parser-CyDZtLCK.js.map
+//# sourceMappingURL=nodable-parser-CupS2H55.js.map

package/dist/nodable-parser-CupS2H55.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodable-parser-CupS2H55.js","names":[],"sources":["../src/xml/common-xml-options.ts","../src/xml/builder-options.ts","../src/xml/nodable-parser.ts"],"sourcesContent":["import type { XmlBuilderOptions } from 'fast-xml-builder';\nimport type { X2jOptions } from 'fast-xml-parser';\n\n/**\n * @description Options shared by the XML parser and builder so documents round-trip: `@` attributes, coerced values, trimmed values.\n *\n * @example\n *   ```ts\n *   commonXmlOptions.attributeNamePrefix; // '@'\n *   commonXmlOptions.parseAttributeValue; // true\n *   ```;\n */\nexport const commonXmlOptions = {\n  attributeNamePrefix: '@',\n  format: false,\n  ignoreAttributes: false,\n  numberParseOptions: { hex: false, leadingZeros: false },\n  parseAttributeValue: true,\n  suppressBooleanAttributes: true,\n  suppressEmptyNode: true,\n  trimValues: true,\n} satisfies X2jOptions & XmlBuilderOptions;\n","import type { XmlBuilderOptions } from 'fast-xml-builder';\n\nimport { commonXmlOptions } from '#/xml/common-xml-options.ts';\n\n/**\n * @description Default `fast-xml-builder` options for serialising PEPPOL documents: {@link commonXmlOptions} with `suppressEmptyNode` forced on.\n *\n * @example\n *   ```ts\n *   builderOptions.attributeNamePrefix; // '@'\n *   builderOptions.suppressEmptyNode; // true\n *   ```;\n */\nexport const builderOptions = { ...commonXmlOptions, suppressEmptyNode: true } satisfies XmlBuilderOptions;\n","import { NumberValueParser } from '@nodable/base-output-builder';\nimport { CompactBuilderFactory } from '@nodable/compact-builder';\nimport { XMLParser } from '@nodable/flexible-xml-parser';\n\nimport type { XmlNode } from '#/helpers/get-prop.ts';\n\nexport type { XmlNode } from '#/helpers/get-prop.ts';\n\nconst numberParser = new NumberValueParser({ eNotation: true, hex: false, leadingZeros: false });\n\nconst compactFactory = new CompactBuilderFactory({\n  attributes: { valueParsers: ['entity', numberParser, 'boolean'] },\n  tags: { valueParsers: ['trim', 'entity', 'boolean', numberParser] },\n});\n\nconst nodableParser = new XMLParser({\n  OutputBuilder: compactFactory,\n  attributes: { booleanType: 'allow', prefix: '@' },\n  skip: { attributes: false, nsPrefix: true },\n});\n\n/**\n * @description Parses an XML string into an {@link XmlNode} tree with the nodable compact builder, coercing values and removing `@xmlns`.\n *\n * @example\n *   ```ts\n *   parseXmlNodable('<root xmlns=\"urn:x\"><a>1</a></root>'); // { root: { a: 1 } }\n *   ```;\n *\n * @param value - The XML document to parse.\n *\n * @returns The parsed {@link XmlNode} tree with `@xmlns` stripped.\n */\nexport function parseXmlNodable(value: string): XmlNode {\n  const parsed = nodableParser.parse(value) as XmlNode;\n  stripDefaultXmlns(parsed);\n  return parsed;\n}\n\nfunction stripDefaultXmlns(node: unknown): void {\n  if (Array.isArray(node)) {\n    for (const item of node) stripDefaultXmlns(item);\n    return;\n  }\n  if (typeof node === 'object' && node !== null) {\n    const record = node as Record<string, unknown>;\n    delete record['@xmlns'];\n    for (const key of Object.keys(record)) stripDefaultXmlns(record[key]);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,MAAa,mBAAmB;CAC9B,qBAAqB;CACrB,QAAQ;CACR,kBAAkB;CAClB,oBAAoB;EAAE,KAAK;EAAO,cAAc;CAAM;CACtD,qBAAqB;CACrB,2BAA2B;CAC3B,mBAAmB;CACnB,YAAY;AACd;;;;;;;;;;;;ACRA,MAAa,iBAAiB;CAAE,GAAG;CAAkB,mBAAmB;AAAK;;;ACL7E,MAAM,eAAe,IAAI,kBAAkB;CAAE,WAAW;CAAM,KAAK;CAAO,cAAc;AAAM,CAAC;AAE/F,MAAM,iBAAiB,IAAI,sBAAsB;CAC/C,YAAY,EAAE,cAAc;EAAC;EAAU;EAAc;CAAS,EAAE;CAChE,MAAM,EAAE,cAAc;EAAC;EAAQ;EAAU;EAAW;CAAY,EAAE;AACpE,CAAC;AAED,MAAM,gBAAgB,IAAI,UAAU;CAClC,eAAe;CACf,YAAY;EAAE,aAAa;EAAS,QAAQ;CAAI;CAChD,MAAM;EAAE,YAAY;EAAO,UAAU;CAAK;AAC5C,CAAC;;;;;;;;;;;;;AAcD,SAAgB,gBAAgB,OAAwB;CACtD,MAAM,SAAS,cAAc,MAAM,KAAK;CACxC,kBAAkB,MAAM;CACxB,OAAO;AACT;AAEA,SAAS,kBAAkB,MAAqB;CAC9C,IAAI,MAAM,QAAQ,IAAI,GAAG;EACvB,KAAK,MAAM,QAAQ,MAAM,kBAAkB,IAAI;EAC/C;CACF;CACA,IAAI,OAAO,SAAS,YAAY,SAAS,MAAM;EAC7C,MAAM,SAAS;EACf,OAAO,OAAO;EACd,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAAG,kBAAkB,OAAO,IAAI;CACtE;AACF"}

package/dist/schematron.d.ts

@@ -1,4 +1,4 @@
-import { X as PeppolDocument } from "./index-BBzPjq7o.js";
+import { s as PeppolDocument } from "./index-CILtZytZ.js";
 import { Context, Effect, Layer, Result, Schema } from "effect";
 //#region src/schematron/types.d.ts
 /**
@@ -35,6 +35,13 @@ declare const SchematronRuleError_base: Schema.Class<SchematronRuleError, Schema
 }>, import("effect/Cause").YieldableError>;
 /**
  * @description Failure of a single schematron rule against a document.
+ *
+ * @example
+ *   ```ts
+ *   new SchematronRuleError({ id: 'PEPPOL-EN16931-R001', level: 'fatal', message: 'The document must carry a number.' });
+ *   ```;
+ *
+ * @see {@link SchematronValidationError}
  */
 export declare class SchematronRuleError extends SchematronRuleError_base {}
 declare const SchematronValidationError_base: Schema.Class<SchematronValidationError, Schema.TaggedStruct<"SchematronValidationError", {
@@ -42,12 +49,26 @@ declare const SchematronValidationError_base: Schema.Class<SchematronValidationE
 }>, import("effect/Cause").YieldableError>;
 /**
  * @description Failure of a schematron validation run, wrapping every rule that failed.
+ *
+ * @example
+ *   ```ts
+ *   new SchematronValidationError({ errors: [ruleError] });
+ *   ```;
+ *
+ * @see {@link SchematronRuleError}
  */
 export declare class SchematronValidationError extends SchematronValidationError_base {}
 //#endregion
 //#region src/schematron/helpers.d.ts
 /**
  * @description An effectful schematron rule validator. Fails with a `SchematronRuleError` when the document does not satisfy the rule.
+ *
+ * @example
+ *   ```ts
+ *   const validate: SchematronDocumentValidator = schematronRule(metadata, document => document.taxTotals.length > 0);
+ *   ```;
+ *
+ * @see {@link schematronRule}
  */
 type SchematronDocumentValidator = (document: PeppolDocument) => Effect.Effect<void, SchematronRuleError>;
 //#endregion
@@ -1132,6 +1153,16 @@ export declare const validateSeR012: SchematronDocumentValidator;
 export declare const validateSeR013: SchematronDocumentValidator;
 //#endregion
 //#region src/schematron/run-all-rules.d.ts
+/**
+ * @description Every schematron rule validator of this library, in evaluation order.
+ *
+ * @example
+ *   ```ts
+ *   ruleValidators.length; // 360
+ *   ```;
+ *
+ * @see {@link SchematronDocumentValidator}
+ */
 export declare const ruleValidators: ReadonlyArray<SchematronDocumentValidator>;
 //#endregion
 //#region src/schematron/schematron.d.ts
@@ -1141,14 +1172,39 @@ export declare const ruleValidators: ReadonlyArray<SchematronDocumentValidator>;
 interface SchematronShape {
   /**
    * @description Runs every schematron rule against the document, failing with a single `SchematronValidationError` that wraps each failed rule.
+   *
+   * @example
+   *   ```ts
+   *   const program = Effect.gen(function* () {
+   *     const schematron = yield* Schematron;
+   *     return yield* schematron.run(document);
+   *   });
+   *   ```;
+   *
+   * @param document - The PEPPOL invoice or credit note to validate.
+   *
+   * @returns An `Effect` that succeeds with a `Result` holding `void`, or fails with the wrapped rule failures.
    */
   readonly run: (document: PeppolDocument) => Effect.Effect<Result.Result<void, SchematronValidationError>>;
 }
 declare const Schematron_base: Context.ServiceClass<Schematron, "@endevops/peppol-schema/schematron/Schematron", SchematronShape>;
 /**
  * @description Runs the schematron rules of this library against a PEPPOL document.
+ *
+ * @example
+ *   ```ts
+ *   const program = Effect.gen(function* () {
+ *     const schematron = yield* Schematron;
+ *     return yield* schematron.run(document);
+ *   });
+ *   ```;
+ *
+ * @see {@link SchematronShape}
  */
 export declare class Schematron extends Schematron_base {
+  /**
+   * @description Layer that builds the {@link Schematron} service from the rule validators in `ruleValidators`.
+   */
   static readonly layer: Layer.Layer<Schematron, never, never>;
 }
 //#endregion