bysquare 2.12.5 → 2.13.1

package/README.md

@@ -104,6 +104,7 @@ const qrstring = encode({
 import {
 	CurrencyCode,
 	encode,
+	Month,
 	PaymentOptions,
 	Periodicity,
 } from "bysquare";
@@ -116,6 +117,7 @@ const qrstring = encode({
 			variableSymbol: "654321",
 			currencyCode: CurrencyCode.EUR, // "EUR"
 			day: 15,
+			month: Month.January, // Single month
 			periodicity: Periodicity.Monthly, // "m"
 			bankAccounts: [
 				{ iban: "SK9611000000002918599669" },
@@ -125,6 +127,63 @@ const qrstring = encode({
 });
 ```
 
+#### Standing Order with Multiple Months
+
+For standing orders that should execute in specific months, you can combine
+multiple months using bitwise OR operators:
+
+```js
+import {
+	CurrencyCode,
+	encode,
+	encodeOptions,
+	Month,
+	PaymentOptions,
+	Periodicity,
+} from "bysquare";
+
+const qrstring = encode({
+	payments: [
+		{
+			type: PaymentOptions.StandingOrder,
+			amount: 100.0,
+			variableSymbol: "654321",
+			currencyCode: CurrencyCode.EUR,
+			day: 15,
+			// Execute in January, July, and October only
+			month: Month.January | Month.July | Month.October, // Results in 577
+			periodicity: Periodicity.Monthly,
+			lastDate: "20251231",
+			bankAccounts: [
+				{ iban: "SK9611000000002918599669" },
+			],
+		},
+	],
+});
+
+// Alternative: Use the utility function to encode multiple months
+const monthsToEncode = [Month.January, Month.July, Month.October];
+const encodedMonths = encodeOptions(monthsToEncode);
+
+const qrstring2 = encode({
+	payments: [
+		{
+			type: PaymentOptions.StandingOrder,
+			amount: 100.0,
+			variableSymbol: "654321",
+			currencyCode: CurrencyCode.EUR,
+			day: 15,
+			month: encodedMonths, // Same result: 577
+			periodicity: Periodicity.Monthly,
+			lastDate: "20251231",
+			bankAccounts: [
+				{ iban: "SK9611000000002918599669" },
+			],
+		},
+	],
+});
+```
+
 ### HTML example
 
 This example shows how to generate a payment QR code and display it in a web
@@ -150,7 +209,7 @@ page:
 						type: PaymentOptions.PaymentOrder,
 						amount: 123.45,
 						variableSymbol: "987654",
-						rrencyCode: CurrencyCode.EUR,
+						currencyCode: CurrencyCode.EUR,
 						bankAccounts: [
 							{ iban: "SK9611000000002918599669" }
 						],
@@ -212,6 +271,29 @@ const qrstring = encode(data);
 const model = decode(qrstring);
 ```
 
+## Classifier Utilities
+
+The library provides utility functions for working with multiple classifier
+options as specified in the PAY by Square standard. These functions are
+particularly useful for handling multiple month selections in standing orders.
+
+### Encoding Multiple Options
+
+```ts
+import {
+	encodeOptions,
+	Month,
+} from "bysquare";
+
+// Encode multiple months into a single value
+const monthsArray = [Month.January, Month.July, Month.October];
+const encoded = encodeOptions(monthsArray);
+console.log(encoded); // 577 (1 + 64 + 512)
+
+// This matches the specification example:
+// January=1, July=64, October=512, sum=577
+```
+
 ## CLI
 
 ```sh

package/lib/classifier.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Utility functions for handling multiple classifier value options using summed
+ * classifiers as specified in the PAY by Square specification.
+ *
+ * Supports Month Classifier (Table 10) and other classifiers that use summed
+ * values.
+ */
+/**
+ * Encodes multiple classifier options into a single number by summing their
+ * values.
+ *
+ * @example
+ * // Encode January + July + October months
+ * const encoded = encodeOptions([Month.January, Month.July, Month.October]);
+ * // Result: 577 (1 + 64 + 512)
+ *
+ * @param options Array of classifier values to sum
+ * @returns Sum of classifier values
+ */
+export declare function encodeOptions(options: number[]): number;
+/**
+ * Decodes a summed classifier value back into individual options.
+ * Uses the classifier decomposition algorithm from the specification.
+ * Automatically detects the range based on the highest bit set.
+ *
+ * @example
+ * // Decode months: January=1, July=64, October=512 sum to 577
+ * const decoded = decodeOptions(577);
+ * // Result: [512, 64, 1] (October, July, January)
+ *
+ * @param sum The summed classifier value to decode
+ * @returns Array of individual classifier values in descending order
+ */
+export declare function decodeOptions(sum: number): number[];

package/lib/classifier.js

@@ -0,0 +1,50 @@
+/**
+ * Utility functions for handling multiple classifier value options using summed
+ * classifiers as specified in the PAY by Square specification.
+ *
+ * Supports Month Classifier (Table 10) and other classifiers that use summed
+ * values.
+ */
+/**
+ * Encodes multiple classifier options into a single number by summing their
+ * values.
+ *
+ * @example
+ * // Encode January + July + October months
+ * const encoded = encodeOptions([Month.January, Month.July, Month.October]);
+ * // Result: 577 (1 + 64 + 512)
+ *
+ * @param options Array of classifier values to sum
+ * @returns Sum of classifier values
+ */
+export function encodeOptions(options) {
+    return options.reduce((sum, option) => sum + option, 0);
+}
+/**
+ * Decodes a summed classifier value back into individual options.
+ * Uses the classifier decomposition algorithm from the specification.
+ * Automatically detects the range based on the highest bit set.
+ *
+ * @example
+ * // Decode months: January=1, July=64, October=512 sum to 577
+ * const decoded = decodeOptions(577);
+ * // Result: [512, 64, 1] (October, July, January)
+ *
+ * @param sum The summed classifier value to decode
+ * @returns Array of individual classifier values in descending order
+ */
+export function decodeOptions(sum) {
+    const classifiers = [];
+    if (sum === 0)
+        return [];
+    // Find the position of the highest bit set
+    const totalOptions = Math.floor(Math.log2(sum)) + 1;
+    for (let i = 1; i <= totalOptions; i++) {
+        const next = Math.pow(2, totalOptions - i);
+        if (next <= sum) {
+            sum = sum - next;
+            classifiers.push(next);
+        }
+    }
+    return classifiers;
+}

package/lib/crc32.d.ts

@@ -1 +1,4 @@
+/**
+ * Computes the CRC32 checksum of a given string.
+ */
 export declare function crc32(data: string): number;

package/lib/crc32.js

@@ -1,58 +1,7 @@
-// Computed CRC32 lookup table
-// const CRC32_TABLE = new Uint32Array(256);
-// for (let i = 0; i < CRC32_TABLE.length; i++) {
-// 	let crc = i;
-// 	for (let j = 0; j < 8; j++) {
-// 		crc = (crc >>> 1) ^ (0xEDB88320 * (crc & 1));
-// 	}
-// 	CRC32_TABLE[i] = crc;
-// }
-// dprint-ignore
-const CRC32_TABLE = [
-    0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, 0x076dc419, 0x706af48f,
-    0xe963a535, 0x9e6495a3, 0x0edb8832, 0x79dcb8a4, 0xe0d5e91e, 0x97d2d988,
-    0x09b64c2b, 0x7eb17cbd, 0xe7b82d07, 0x90bf1d91, 0x1db71064, 0x6ab020f2,
-    0xf3b97148, 0x84be41de, 0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7,
-    0x136c9856, 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, 0x14015c4f, 0x63066cd9,
-    0xfa0f3d63, 0x8d080df5, 0x3b6e20c8, 0x4c69105e, 0xd56041e4, 0xa2677172,
-    0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b, 0x35b5a8fa, 0x42b2986c,
-    0xdbbbc9d6, 0xacbcf940, 0x32d86ce3, 0x45df5c75, 0xdcd60dcf, 0xabd13d59,
-    0x26d930ac, 0x51de003a, 0xc8d75180, 0xbfd06116, 0x21b4f4b5, 0x56b3c423,
-    0xcfba9599, 0xb8bda50f, 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924,
-    0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, 0x76dc4190, 0x01db7106,
-    0x98d220bc, 0xefd5102a, 0x71b18589, 0x06b6b51f, 0x9fbfe4a5, 0xe8b8d433,
-    0x7807c9a2, 0x0f00f934, 0x9609a88e, 0xe10e9818, 0x7f6a0dbb, 0x086d3d2d,
-    0x91646c97, 0xe6635c01, 0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e,
-    0x6c0695ed, 0x1b01a57b, 0x8208f4c1, 0xf50fc457, 0x65b0d9c6, 0x12b7e950,
-    0x8bbeb8ea, 0xfcb9887c, 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3, 0xfbd44c65,
-    0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2, 0x4adfa541, 0x3dd895d7,
-    0xa4d1c46d, 0xd3d6f4fb, 0x4369e96a, 0x346ed9fc, 0xad678846, 0xda60b8d0,
-    0x44042d73, 0x33031de5, 0xaa0a4c5f, 0xdd0d7cc9, 0x5005713c, 0x270241aa,
-    0xbe0b1010, 0xc90c2086, 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f,
-    0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, 0x59b33d17, 0x2eb40d81,
-    0xb7bd5c3b, 0xc0ba6cad, 0xedb88320, 0x9abfb3b6, 0x03b6e20c, 0x74b1d29a,
-    0xead54739, 0x9dd277af, 0x04db2615, 0x73dc1683, 0xe3630b12, 0x94643b84,
-    0x0d6d6a3e, 0x7a6a5aa8, 0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1,
-    0xf00f9344, 0x8708a3d2, 0x1e01f268, 0x6906c2fe, 0xf762575d, 0x806567cb,
-    0x196c3671, 0x6e6b06e7, 0xfed41b76, 0x89d32be0, 0x10da7a5a, 0x67dd4acc,
-    0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5, 0xd6d6a3e8, 0xa1d1937e,
-    0x38d8c2c4, 0x4fdff252, 0xd1bb67f1, 0xa6bc5767, 0x3fb506dd, 0x48b2364b,
-    0xd80d2bda, 0xaf0a1b4c, 0x36034af6, 0x41047a60, 0xdf60efc3, 0xa867df55,
-    0x316e8eef, 0x4669be79, 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236,
-    0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, 0xc5ba3bbe, 0xb2bd0b28,
-    0x2bb45a92, 0x5cb36a04, 0xc2d7ffa7, 0xb5d0cf31, 0x2cd99e8b, 0x5bdeae1d,
-    0x9b64c2b0, 0xec63f226, 0x756aa39c, 0x026d930a, 0x9c0906a9, 0xeb0e363f,
-    0x72076785, 0x05005713, 0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38,
-    0x92d28e9b, 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, 0x86d3d2d4, 0xf1d4e242,
-    0x68ddb3f8, 0x1fda836e, 0x81be16cd, 0xf6b9265b, 0x6fb077e1, 0x18b74777,
-    0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c, 0x8f659eff, 0xf862ae69,
-    0x616bffd3, 0x166ccf45, 0xa00ae278, 0xd70dd2ee, 0x4e048354, 0x3903b3c2,
-    0xa7672661, 0xd06016f7, 0x4969474d, 0x3e6e77db, 0xaed16a4a, 0xd9d65adc,
-    0x40df0b66, 0x37d83bf0, 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9,
-    0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, 0xbad03605, 0xcdd70693,
-    0x54de5729, 0x23d967bf, 0xb3667a2e, 0xc4614ab8, 0x5d681b02, 0x2a6f2b94,
-    0xb40bbe37, 0xc30c8ea1, 0x5a05df1b, 0x2d02ef8d
-];
+import { CRC32_TABLE } from "lzma1";
+/**
+ * Computes the CRC32 checksum of a given string.
+ */
 export function crc32(data) {
     let crc = 0 ^ (-1);
     const encoded = new TextEncoder().encode(data);

package/lib/encode.js

@@ -2,7 +2,7 @@ import { compress } from "lzma1";
 import * as base32hex from "./base32hex.js";
 import { crc32 } from "./crc32.js";
 import { deburr } from "./deburr.js";
-import { PaymentOptions, Version, } from "./types.js";
+import { Month, PaymentOptions, Version, } from "./types.js";
 import { validateDataModel } from "./validations.js";
 export const EncodeErrorMessage = {
     /**
@@ -134,16 +134,30 @@ export function serialize(data) {
             serialized.push(ba.iban);
             serialized.push(ba.bic);
         }
+        // Handle standing order extension
+        // check if payment type is standing order
         if (p.type === PaymentOptions.StandingOrder) {
             serialized.push("1");
             serialized.push(p.day?.toString());
-            serialized.push(p.month?.toString());
+            // Handle month classifier
+            // check if it's a number, use it directly, otherwise convert key to number
+            const monthValue = p.month;
+            if (typeof monthValue === "string") {
+                // Convert month key to its numeric value
+                serialized.push(Month[monthValue]?.toString());
+            }
+            else {
+                // Use numeric value directly (already encoded classifier sum)
+                serialized.push(monthValue?.toString());
+            }
             serialized.push(p.periodicity);
             serialized.push(p.lastDate);
         }
         else {
             serialized.push("0");
         }
+        // Handle direct debit extension
+        // check if payment type is direct debit
         if (p.type === PaymentOptions.DirectDebit) {
             serialized.push("1");
             serialized.push(p.directDebitScheme?.toString());

package/lib/index.d.ts

@@ -3,6 +3,7 @@
  * Copyright Filip Seman
  * SPDX-License-Identifier: Apache-2.0
  */
+export { decodeOptions, encodeOptions } from "./classifier.js";
 export { decode, detect, parse } from "./decode.js";
 export { encode, generate } from "./encode.js";
 export { validateDataModel, ValidationErrorMessage } from "./validations.js";

package/lib/index.js

@@ -3,6 +3,7 @@
  * Copyright Filip Seman
  * SPDX-License-Identifier: Apache-2.0
  */
+export { decodeOptions, encodeOptions } from "./classifier.js";
 export { decode, detect, parse } from "./decode.js";
 export { encode, generate } from "./encode.js";
 export { validateDataModel, ValidationErrorMessage } from "./validations.js";

package/lib/types.d.ts

@@ -1,6 +1,5 @@
 /**
- * Mapping semantic version to encoded version number, header 4-bits
- *
+ * Mapping semantic version to encoded version number, header 4-bit.
  * It's a bit silly to limit the version number to 4-bit, if they keep
  * increasing the version number, the latest possible mapped value is 16
  */
@@ -58,11 +57,13 @@ export declare const Periodicity: {
 };
 export type Periodicity = typeof Periodicity[keyof typeof Periodicity];
 /**
- * This is the payment day. It‘s meaning depends on the periodicity, meaning
+ * This is the payment day. It's meaning depends on the periodicity, meaning
  * either day of the month (number between 1 and 31) or day of the week
  * (1=Monday,2=Tuesday, …, 7=Sunday).
  *
- * @maximum 2
+ * @description Payment day value range from 1 to 31
+ * @minimum 1
+ * @maximum 31
  */
 export type Day = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31;
 /**
@@ -93,20 +94,23 @@ export type PaymentOptions = typeof PaymentOptions[keyof typeof PaymentOptions];
  */
 export type BankAccount = {
     /**
-     * Medzinárodné číslo bankového účtu vo formáte IBAN. Príklad:
+     * Medzinárodné číslo bankového účtu vo formáte IBAN.
      *
-     * @example `"SK8209000000000011424060"`
-     * @maximum 34
+     * @description International Bank Account Number in IBAN format
+     * @example "SK8209000000000011424060"
      * @pattern [A-Z]{2}[0-9]{2}[A-Z0-9]{0,30}
+     * @minLength 15
+     * @maxLength 34
      */
     iban: string;
     /**
      * Medzinárodný bankový identifikačný kód (z ang. Bank Identification Code).
      *
-     * Formát [ISO 9362](https://en.wikipedia.org/wiki/ISO_9362) (swift) 8 or 11 characters long
-     *
+     * @description Bank Identification Code in ISO 9362 format (SWIFT)
      * @example "TATRSKBX"
      * @pattern [A-Z]{4}[A-Z]{2}[A-Z\d]{2}([A-Z\d]{3})?
+     * @minLength 8
+     * @maxLength 11
      */
     bic?: string;
 };
@@ -150,19 +154,22 @@ export type Beneficiary = {
     /**
      * Rozšírenie o meno príjemcu
      *
-     * @maximum 70
+     * @description Beneficiary name
+     * @maxLength 70
      */
     name?: string;
     /**
      * Rozšírenie o adresu príjemcu
      *
-     * @maximum 70
+     * @description Beneficiary street address
+     * @maxLength 70
      */
     street?: string;
     /**
      * Rozšírenie o adresu príjemcu (druhý riadok)
      *
-     * @maximum 70
+     * @description Beneficiary city
+     * @maxLength 70
      */
     city?: string;
 };
@@ -172,63 +179,79 @@ export type SimplePayment = {
      * oddelená bodkou. Môže ostať nevyplnené, napríklad pre dobrovoľný
      * príspevok (donations).
      *
-     * Príklad: Tisíc sa uvádza ako `1000`. Jedna celá
-     * deväťdesiatdeväť sa uvádza ako `1.99`. Desať celých peťdesiat sa uvádza
-     * ako `10.5`. Nula celá nula osem sa uvádza ako `0.08`.
-     *
-     * @maximum 15
+     * @description Payment amount in decimal format
+     * @example 1000
+     * @example 1.99
+     * @example 10.5
+     * @example 0.08
+     * @minimum 0
+     * @maximum 999999999999999
      */
     amount?: number;
     /**
      * Mena v [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) formáte (3 písmená).
      *
+     * @description Currency code in ISO 4217 format
      * @example "EUR"
      * @pattern [A-Z]{3}
+     * @minLength 3
+     * @maxLength 3
      */
     currencyCode: string | keyof typeof CurrencyCode;
     /**
      * Dátum splatnosti vo formáte [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) `"RRRR-MM-DD"`.
      * Vprípade trvalého príkazu označuje dátum prvej platby.
      *
-     * Formát `YYYY-MM-DD`
+     * @description Payment due date in ISO 8601 format
+     * @format date
+     * @example "2024-12-31"
+     * @pattern \d{4}-\d{2}-\d{2}
      */
     paymentDueDate?: string;
     /**
      * Variabilný symbol je maximálne 10 miestne číslo.
      *
-     * @maximum 10
+     * @description Variable symbol up to 10 digits
      * @pattern [0-9]{0,10}
+     * @maxLength 10
      */
     variableSymbol?: string;
     /**
-     * Konštantný symbol je 4 miestne identifikačné číslo.
+     * Konštantný symbol je 4 číselný identifikátor platby definovaný NBS.
      *
-     * @maximum 4
+     * @description Constant symbol - 4 digit payment identifier defined by NBS
      * @pattern [0-9]{0,4}
+     * @maxLength 4
      */
     constantSymbol?: string;
     /**
      * Špecifický symbol je maximálne 10 miestne číslo.
      *
-     * @maximum 10
+     * @description Specific symbol up to 10 digits
      * @pattern [0-9]{0,10}
+     * @maxLength 10
      */
     specificSymbol?: string;
     /**
      * Referenčná informácia prijímateľa podľa SEPA.
      *
-     * @maximum 35
+     * @description Originator's reference information according to SEPA
+     * @maxLength 35
      */
     originatorsReferenceInformation?: string;
     /**
      * Správa pre prijímateľa. Údaje o platbe, na základe ktorých príjemca bude
      * môcť platbu identifikovať.
      *
-     * @maximum 140
+     * @description Payment note for beneficiary identification
+     * @maxLength 140
      */
     paymentNote?: string;
     /**
      * Zoznam bankových účtov.
+     *
+     * @description List of bank accounts
+     * @minItems 1
      */
     bankAccounts: BankAccount[];
     beneficiary?: Beneficiary;
@@ -242,23 +265,37 @@ export type PaymentOrder = SimplePayment & {
 export type StandingOrder = SimplePayment & {
     type: typeof PaymentOptions.StandingOrder;
     /**
-     * Deň platby vyplývajúci z opakovania (Periodicity). Deň v mesiaci je číslo
-     * medzi 1 a 31. Deň v týždni je číslo medzi 1 a 7 (1 = pondelok, 2 =utorok,
-     * …, 7 = nedeľa).
+     * Určuje deň, v ktorom bude trvalý platobný príkaz spracovaný v určených
+     * mesiacoch.
+     *
+     * @description Payment day for standing order execution
+     * @minimum 1
+     * @maximum 31
      */
     day?: number | Day;
     /**
-     * Medzerou oddelený zoznam mesiacov, v ktoré sa má platba uskutočniť.
+     * Určuje mesiace, v ktorých sa má vykonať platba trvalého platobného
+     * príkazu.
+     *
+     * @description Months for standing order execution
+     * @example Month.January
+     * @example Month.January | Month.July | Month.October
+     * @example 577
      */
     month?: keyof typeof Month | number;
     /**
      * Opakovanie (periodicita) trvalého príkazu.
+     *
+     * @description Standing order periodicity
      */
     periodicity: keyof typeof Periodicity | string;
     /**
-     * Dátum poslednej platby v trvalom príkaze.
+     * Dátum poslednej platby v rámci trvalého platobného príkazu.
      *
-     * Formát `YYYYMMDD`
+     * @description Last payment date for standing order
+     * @format date
+     * @pattern \d{8}
+     * @example "20241231"
      */
     lastDate?: string;
 };
@@ -272,32 +309,40 @@ export type DirectDebit = SimplePayment & {
     /**
      * Identifikácia mandátu medzi veriteľom a dlžníkom podľa SEPA.
      *
-     * @maximum 35
+     * @description Mandate identification between creditor and debtor according to SEPA
+     * @maxLength 35
      */
     mandateId?: string;
     /**
      * Identifikácia veriteľa podľa SEPA.
      *
-     * @maximum 35
+     * @description Creditor identification according to SEPA
+     * @maxLength 35
      */
     creditorId?: string;
     /**
      * Identifikácia zmluvy medzi veriteľom a dlžníkom podľa SEPA.
      *
-     * @maximum 35
+     * @description Contract identification between creditor and debtor according to SEPA
+     * @maxLength 35
      */
     contractId?: string;
     /**
      * Maximálna čiastka inkasa.
      *
-     * @maximum 15
+     * @description Maximum direct debit amount
+     * @minimum 0
+     * @maximum 999999999999999
      */
     maxAmount?: number;
     /**
      * Dátum platnosti inkasa. Platnosť inkasa zaníka dňom tohto dátumu.
      *
-     * @maximum 8
-     * Formát `YYYYMMDD`
+     * @description Direct debit validity date
+     * @format date
+     * @pattern \d{8}
+     * @maxLength 8
+     * @example "20241231"
      */
     validTillDate?: string;
 };
@@ -310,12 +355,16 @@ export type DataModel = {
      * Číslo faktúry v prípade, že údaje sú súčasťou faktúry, alebo
      * identifikátor pre intérne potreby vystavovateľa.
      *
-     * @maximum 10
+     * @description Invoice ID or internal identifier
+     * @maxLength 10
      */
     invoiceId?: string;
     /**
      * Zoznam jednej alebo viacerých platieb v prípade hromadného príkazu.
      * Hlavná (preferovaná) platba sa uvádza ako prvá.
+     *
+     * @description List of payments (preferred payment should be first)
+     * @minItems 1
      */
     payments: Payment[];
 };

package/lib/types.js

@@ -1,6 +1,5 @@
 /**
- * Mapping semantic version to encoded version number, header 4-bits
- *
+ * Mapping semantic version to encoded version number, header 4-bit.
  * It's a bit silly to limit the version number to 4-bit, if they keep
  * increasing the version number, the latest possible mapped value is 16
  */

package/package.json

@@ -2,7 +2,7 @@
 	"name": "bysquare",
 	"description": "It's a national standard for payment QR codes adopted by Slovak Banking Association (SBA)",
 	"type": "module",
-	"version": "2.12.5",
+	"version": "2.13.1",
 	"license": "Apache-2.0",
 	"funding": "https://github.com/sponsors/xseman",
 	"homepage": "https://github.com/xseman/bysquare#readme",
@@ -22,16 +22,16 @@
 		"fmt": "dprint fmt",
 		"fmt:check": "dprint check",
 		"typecheck": "tsc --noEmit",
-		"test": "bun test --coverage .",
+		"test": "bun test --coverage --coverage-reporter=text --coverage-reporter=lcov",
 		"test:watch": "bun test --watch --coverage ."
 	},
 	"dependencies": {
-		"lzma1": "0.1.2",
-		"validator": "^13.12.0"
+		"lzma1": "0.2.0",
+		"validator": "^13.15.15"
 	},
 	"devDependencies": {
-		"@types/bun": "^1.2.19",
-		"@types/node": "^24.1.0",
+		"@types/bun": "^1.2.20",
+		"@types/node": "^24.2.1",
 		"@types/validator": "^13.15.2",
 		"dprint": "~0.50.0",
 		"typescript": "~5.8.3"