thai-bank-transfer-qr 0.2.1 → 0.3.0

package/README.md

@@ -22,12 +22,34 @@ const payload = buildThaiQRBankTransfer({
 console.log(payload)
 ```
 
+PromptPay phone number QR (Tag 29 subtag 01, amount optional):
+
+```js
+import { buildThaiQRPromptPayPhone } from "thai-bank-transfer-qr"
+
+const phonePayload = buildThaiQRPromptPayPhone({
+  phoneNumber: "+66 81 234 5678", // accepts +66 / 66 / 0-leading
+  amount: 25.5,                   // optional; omit for open amount
+})
+
+console.log(phonePayload)
+```
+
 ## API
 
 - buildThaiQRBankTransfer(options)
   - bankCode: string (3 digits)
   - accountNumber: string (digits only)
   - amount: number|string (formatted to 2 decimals)
+- buildThaiQRPromptPayPhone(options)
+  - phoneNumber: string|number (Thai mobile in +66 / 66 / 0 format)
+  - amount?: number|string (optional fixed amount; omit to allow payer entry)
+- Validators (throw on invalid input):
+  - validateBankCode(bankCode)
+  - validateAccountNumber(accountNumber)
+  - validateAmount(amount)
+  - validateOptionalAmount(amount) // returns null if empty/undefined
+  - validatePhoneNumber(phoneNumber) // returns normalized 0066 + 9 digits
 
 Also exports: `tlv`, `crc16CCITT`.
 

package/index.js

@@ -29,6 +29,96 @@ export function crc16CCITT(input) {
   return crc.toString(16).toUpperCase().padStart(4, "0");
 }
 
+export function validateBankCode(bankCode) {
+  if (!/^\d{3}$/.test(bankCode)) {
+    throw new Error("bankCode must be 3 digits (e.g. 004)");
+  }
+  return bankCode;
+}
+
+export function validateAccountNumber(accountNumber) {
+  if (!/^\d+$/.test(accountNumber)) {
+    throw new Error("accountNumber must be digits only");
+  }
+  if (accountNumber.length < 10 || accountNumber.length > 15) {
+    throw new Error("accountNumber must be 10-15 digits");
+  }
+  return accountNumber;
+}
+
+export function validateAmount(amount) {
+  const formatted = (
+    typeof amount === "number" ? amount : parseFloat(amount)
+  ).toFixed(2);
+  if (isNaN(Number(formatted))) {
+    throw new Error("amount must be a number");
+  }
+  return formatted;
+}
+
+export function validateOptionalAmount(amount) {
+  if (amount === undefined || amount === null || String(amount).trim() === "") {
+    return null;
+  }
+  return validateAmount(amount);
+}
+
+function normalizeThaiMobile(phoneNumber) {
+  const digits = String(phoneNumber || "").replace(/\D+/g, "");
+  let national = digits;
+  if (national.startsWith("0066")) {
+    national = national.slice(4);
+  } else if (national.startsWith("66")) {
+    national = national.slice(2);
+  } else if (national.startsWith("0")) {
+    national = national.slice(1);
+  }
+  if (!/^\d{9}$/.test(national)) {
+    throw new Error("phoneNumber must be a Thai mobile (+66/66/0) with 9 digits after country/leading zero is stripped");
+  }
+  return `0066${national}`;
+}
+
+export function validatePhoneNumber(phoneNumber) {
+  return normalizeThaiMobile(phoneNumber);
+}
+
+/**
+ * Build PromptPay QR payload for Thai mobile number (Tag 29 subtag 01)
+ * @param {Object} options
+ * @param {string|number} options.phoneNumber Thai mobile in +66 / 66 / 0 formats
+ * @param {number|string} [options.amount] Optional fixed THB amount
+ * @returns {string}
+ */
+export function buildThaiQRPromptPayPhone({ phoneNumber, amount }) {
+  const normalized = validatePhoneNumber(phoneNumber);
+  const formattedAmount = validateOptionalAmount(amount);
+  const hasAmount = formattedAmount !== null;
+
+  const tag29 = tlv(
+    "29",
+    tlv("00", "A000000677010111") + tlv("01", normalized)
+  );
+
+  const parts = [
+    tlv("00", "01"),
+    tlv("01", "11"),
+    tag29,
+    tlv("52", "0000"),
+    tlv("53", "764"),
+  ];
+
+  if (hasAmount) {
+    parts.push(tlv("54", formattedAmount));
+  }
+
+  parts.push(tlv("58", "TH"));
+
+  const withoutCRC = parts.join("") + "6304";
+  const crc = crc16CCITT(withoutCRC);
+  return withoutCRC + crc;
+}
+
 /**
  * Build Thai QR Bank Transfer payload (EMVCo + Thai spec)
  * @param {Object} options
@@ -38,15 +128,9 @@ export function crc16CCITT(input) {
  * @returns {string}
  */
 export function buildThaiQRBankTransfer({ bankCode, accountNumber, amount }) {
-  if (!/^\d{3}$/.test(bankCode))
-    throw new Error("bankCode must be 3 digits (e.g. 004)");
-  if (!/^\d+$/.test(accountNumber))
-    throw new Error("accountNumber must be digits only");
-
-  const amt = (
-    typeof amount === "number" ? amount : parseFloat(amount)
-  ).toFixed(2);
-  if (isNaN(Number(amt))) throw new Error("amount must be a number");
+  validateBankCode(bankCode);
+  validateAccountNumber(accountNumber);
+  const amt = validateAmount(amount);
 
   // Tag 29 (Bank transfer template) → 00=AID, 03=bankCode+accountNumber
   const tag29 = tlv(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thai-bank-transfer-qr",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Thai bank transfer QR payload builder (PromptPay – Tag 29 + CRC16)",
   "type": "module",
   "main": "index.js",