@hexpro/qr-code-studio 0.0.0-stage → 0.1.0

package/dist/payload/content/swiss-qr-bill.js

@@ -0,0 +1,325 @@
+/**
+ * A Swiss QR-bill: the Swiss QR Code on a payment part (SIX, "Swiss
+ * Implementation Guidelines for the QR-bill", version 2.4 of 24 February
+ * 2026, valid from 14 November 2026; version 2.3 stays valid until November
+ * 2027).
+ *
+ * The rules that matter most:
+ *
+ * - The account is a CH or LI IBAN. A QR-IBAN, one whose institution ID is
+ *   30000 to 31999 (section 2.8), takes a QR reference (QRR) and nothing
+ *   else, and from version 2.4 only for bills in CHF. Any other IBAN takes an
+ *   ISO 11649 creditor reference (SCOR) or none (NON).
+ * - A QR reference is 26 digits and a modulo 10 recursive check digit.
+ * - Addresses are structured (S): street, building number, postcode and town
+ *   as separate lines. The combined type (K) was removed in version 2.3.
+ *   This writes S only, and reads K so an old bill can still be explained,
+ *   with a warning; the K lines land in the street and town fields, so the
+ *   postcode has to be filled in before the bill can be made again.
+ * - Text is UTF-8 from the Latin character set of section 4.1.1. Lines end
+ *   in LF (CR LF is also allowed, and is read), the last line has no line
+ *   end, and optional lines after the trailer are left off when empty.
+ *   At most 997 characters, which at level M is version 25.
+ * - The code is printed 46 by 46 mm with a 7 mm Swiss cross in the middle,
+ *   black on white, and nothing about its design may change.
+ */
+import { issue } from '../../core/issue.js';
+import { compactCreditorReference, compactIban, isCreditorReference } from '../banking.js';
+import { mod10Recursive } from '../check-digits.js';
+import { definePayload, field, unparseable } from '../define.js';
+import { charLength, decimalPlaces, FIELD_ISSUES, numberOf, textOf } from '../fields.js';
+const ID = 'swiss-qr-bill';
+export const SWISS_MAX_CHARACTERS = 997;
+const ADDRESS = ['Name', 'Street', 'Building', 'Postcode', 'Town', 'Country'];
+const TEXT_FIELDS = [
+    ...ADDRESS.slice(0, 5).map((part) => `creditor${part}`),
+    ...ADDRESS.slice(0, 5).map((part) => `debtor${part}`),
+    'message',
+    'billingInformation',
+    'alternative1',
+    'alternative2',
+];
+/** Section 4.1.1: Basic Latin, Latin-1 Supplement, Latin Extended-A, four Romanian letters and the euro sign. */
+function allowedCharacter(code) {
+    return ((code >= 0x20 && code <= 0x7e) ||
+        (code >= 0xa0 && code <= 0x17f) ||
+        (code >= 0x218 && code <= 0x21b) ||
+        code === 0x20ac);
+}
+/** The institution ID of a CH or LI IBAN marks a QR-IBAN when it is 30000 to 31999 (section 2.8). */
+export function isQrIban(iban) {
+    const compact = compactIban(iban);
+    const iid = Number(compact.slice(4, 9));
+    return /^(?:CH|LI)\d{7}/.test(compact) && iid >= 30000 && iid <= 31999;
+}
+/**
+ * 27 digits, the last a modulo 10 recursive check over the other 26, and not
+ * all zeros, which the check digit alone would allow (section 2.12.1: "The
+ * reference must not consist exclusively of zeros").
+ */
+export function isQrReference(reference) {
+    const compact = reference.replace(/ /g, '');
+    return (/^\d{27}$/.test(compact) &&
+        !/^0+$/.test(compact) &&
+        mod10Recursive(compact.slice(0, 26)) === Number(compact[26]));
+}
+/** A debtor is given when any line other than the country is, so a form that fills in a default country does not invent one. */
+function hasDebtor(value) {
+    return ADDRESS.slice(0, 5).some((part) => textOf(value, `debtor${part}`) !== '');
+}
+function addressLines(value, party, present) {
+    if (!present)
+        return ['', '', '', '', '', '', ''];
+    return ['S', ...ADDRESS.map((part) => textOf(value, `${party}${part}`))];
+}
+function reference(value) {
+    const text = textOf(value, 'reference');
+    return textOf(value, 'referenceType') === 'scor'
+        ? compactCreditorReference(text)
+        : text.replace(/ /g, '');
+}
+function lines(value) {
+    const amount = numberOf(value, 'amount');
+    const out = [
+        'SPC',
+        '0200',
+        '1',
+        compactIban(textOf(value, 'iban')),
+        ...addressLines(value, 'creditor', true),
+        // The ultimate creditor: reserved, and must not be filled in.
+        '',
+        '',
+        '',
+        '',
+        '',
+        '',
+        '',
+        amount === null ? '' : amount.toFixed(2),
+        textOf(value, 'currency').toUpperCase(),
+        ...addressLines(value, 'debtor', hasDebtor(value)),
+        textOf(value, 'referenceType').toUpperCase(),
+        reference(value),
+        textOf(value, 'message'),
+        'EPD',
+        textOf(value, 'billingInformation'),
+        textOf(value, 'alternative1'),
+        textOf(value, 'alternative2'),
+    ];
+    while (out.length > 31 && out[out.length - 1] === '')
+        out.pop();
+    return out;
+}
+function write(value) {
+    return lines(value).join('\n');
+}
+function addressIssues(value, party) {
+    const found = [];
+    for (const part of ['Name', 'Postcode', 'Town', 'Country']) {
+        if (textOf(value, `${party}${part}`) === '')
+            found.push(issue(FIELD_ISSUES.required, ['fields', `${party}${part}`]));
+    }
+    if (textOf(value, `${party}AddressType`) === 'k') {
+        found.push(issue('payload.swiss-qr-bill.issue.combined-address', ['fields', `${party}AddressType`], 'warning'));
+    }
+    return found;
+}
+function referenceIssues(value, flagged) {
+    const type = textOf(value, 'referenceType');
+    const text = textOf(value, 'reference');
+    const path = ['fields', 'reference'];
+    const qrIban = isQrIban(textOf(value, 'iban'));
+    const found = [];
+    if (type === 'qrr') {
+        if (!qrIban)
+            found.push(issue('payload.swiss-qr-bill.issue.qrr-needs-qr-iban', ['fields', 'referenceType']));
+        // Version 2.4 keeps the QR reference for francs, but version 2.3, which
+        // allows it in euros, stays valid until November 2027. So this is a
+        // warning: a bill made this way works now and will stop working.
+        if (textOf(value, 'currency') !== 'chf')
+            found.push(issue('payload.swiss-qr-bill.issue.qrr-chf-only', ['fields', 'currency'], 'warning'));
+        if (text === '')
+            found.push(issue(FIELD_ISSUES.required, path));
+        else if (!flagged('reference') && !isQrReference(text))
+            found.push(issue('payload.swiss-qr-bill.issue.qr-reference', path));
+        return found;
+    }
+    if (qrIban)
+        found.push(issue('payload.swiss-qr-bill.issue.qr-iban-needs-qrr', ['fields', 'referenceType']));
+    if (type === 'scor') {
+        if (text === '')
+            found.push(issue(FIELD_ISSUES.required, path));
+        else if (!flagged('reference') && !isCreditorReference(text))
+            found.push(issue('payload.issue.creditor-reference', path));
+    }
+    else if (text !== '') {
+        found.push(issue('payload.swiss-qr-bill.issue.reference-not-allowed', path));
+    }
+    return found;
+}
+function rules(value, flagged) {
+    const found = [];
+    const iban = compactIban(textOf(value, 'iban'));
+    if (iban !== '' && !flagged('iban') && !/^(?:CH|LI)/.test(iban)) {
+        found.push(issue('payload.swiss-qr-bill.issue.iban-country', ['fields', 'iban']));
+    }
+    found.push(...addressIssues(value, 'creditor'));
+    if (hasDebtor(value))
+        found.push(...addressIssues(value, 'debtor'));
+    found.push(...referenceIssues(value, flagged));
+    const amount = numberOf(value, 'amount');
+    if (amount !== null && !flagged('amount') && decimalPlaces(amount) > 2) {
+        found.push(issue(FIELD_ISSUES.amountDecimals, ['fields', 'amount'], 'error', { max: 2 }));
+    }
+    const combined = charLength(textOf(value, 'message')) + charLength(textOf(value, 'billingInformation'));
+    if (combined > 140) {
+        found.push(issue('payload.swiss-qr-bill.issue.message-too-long', ['fields', 'message'], 'error', {
+            length: combined,
+            max: 140,
+        }));
+    }
+    for (const key of TEXT_FIELDS) {
+        if (flagged(key))
+            continue;
+        const text = textOf(value, key);
+        let position = 0;
+        for (const char of text) {
+            if (!allowedCharacter(char.codePointAt(0))) {
+                found.push(issue('payload.swiss-qr-bill.issue.character', ['fields', key], 'error', { position }));
+                break;
+            }
+            position += 1;
+        }
+    }
+    const text = write(value);
+    const length = charLength(text);
+    if (length > SWISS_MAX_CHARACTERS) {
+        found.push(issue('payload.swiss-qr-bill.issue.too-long', ['fields'], 'error', {
+            length,
+            max: SWISS_MAX_CHARACTERS,
+        }));
+    }
+    else {
+        // The limit is in characters, and version 25 at level M holds 997
+        // bytes. A bill near the limit with accented letters can be within the
+        // one and over the other, which only the encoder can settle.
+        const bytes = new TextEncoder().encode(text).length;
+        if (bytes > SWISS_MAX_CHARACTERS) {
+            found.push(issue('payload.swiss-qr-bill.issue.bytes', ['fields'], 'warning', {
+                length: bytes,
+                max: SWISS_MAX_CHARACTERS,
+            }));
+        }
+    }
+    if (amount === 0) {
+        found.push(issue('payload.swiss-qr-bill.issue.notification', ['fields', 'amount'], 'warning'));
+    }
+    return found;
+}
+/** Seven lines from `start`: S or K, then the six address lines. Empty when there is no party. */
+function readAddress(rows, start) {
+    const [type = '', name = '', line1 = '', line2 = '', postcode = '', town = '', country = ''] = rows.slice(start, start + 7);
+    if (type === '')
+        return { type: 's', parts: ['', '', '', '', '', ''] };
+    if (type === 'S')
+        return { type: 's', parts: [name, line1, line2, postcode, town, country] };
+    if (type === 'K')
+        return { type: 'k', parts: [name, line1, '', '', line2, country] };
+    throw unparseable(ID, 'address-type');
+}
+function parse(text) {
+    // Section 4.1.4 puts no line end after the last line, but plenty of
+    // generators write one, and a bill is no less readable for it.
+    const rows = text.replace(/\r?\n$/, '').split(/\r?\n/);
+    if (rows[0] !== 'SPC')
+        throw unparseable(ID, 'not-swiss-qr-bill');
+    if (rows[1] !== '0200' || rows[2] !== '1' || rows[30] !== 'EPD' || rows.length > 34)
+        throw unparseable(ID, 'header');
+    const creditor = readAddress(rows, 4);
+    const debtor = readAddress(rows, 20);
+    const amountText = rows[18];
+    if (amountText !== '' && !/^\d{1,9}\.\d{2}$/.test(amountText))
+        throw unparseable(ID, 'amount');
+    const currency = rows[19].toLowerCase();
+    const referenceType = rows[27].toLowerCase();
+    if (!['chf', 'eur'].includes(currency) || !['qrr', 'scor', 'non'].includes(referenceType)) {
+        throw unparseable(ID, 'code');
+    }
+    const party = (prefix, address) => Object.fromEntries([
+        ...ADDRESS.map((part, index) => [`${prefix}${part}`, address.parts[index]]),
+        [`${prefix}AddressType`, address.type],
+    ]);
+    return {
+        iban: rows[3],
+        ...party('creditor', creditor),
+        amount: amountText === '' ? null : Number(amountText),
+        currency,
+        ...party('debtor', debtor),
+        referenceType,
+        reference: rows[28],
+        message: rows[29],
+        billingInformation: rows[31] ?? '',
+        alternative1: rows[32] ?? '',
+        alternative2: rows[33] ?? '',
+    };
+}
+function addressFields(party) {
+    const required = party === 'creditor';
+    const extras = (more) => ({
+        group: party,
+        ...(required ? {} : { advanced: true }),
+        ...more,
+    });
+    return [
+        field(ID, `${party}Name`, 'text', extras({ maxLength: 70, ...(required ? { required } : {}) })),
+        field(ID, `${party}Street`, 'text', extras({ maxLength: 70 })),
+        field(ID, `${party}Building`, 'text', extras({ maxLength: 16 })),
+        field(ID, `${party}Postcode`, 'text', extras({ maxLength: 16 })),
+        field(ID, `${party}Town`, 'text', extras({ maxLength: 35 })),
+        field(ID, `${party}Country`, 'country', extras(required ? { default: 'CH' } : {})),
+        field(ID, `${party}AddressType`, 'select', {
+            group: party,
+            options: ['s', 'k'],
+            default: 's',
+            advanced: true,
+            hint: true,
+        }),
+    ];
+}
+export const swissQrBillType = definePayload({
+    id: ID,
+    category: 'payment',
+    fields: [
+        field(ID, 'iban', 'iban', { required: true, hint: true }),
+        ...addressFields('creditor'),
+        // 0.00 is allowed: it makes a notification rather than a bill to pay
+        // (section 4.4, table 10).
+        field(ID, 'amount', 'amount', { min: 0, max: 999999999.99 }),
+        field(ID, 'currency', 'select', { required: true, options: ['chf', 'eur'], default: 'chf' }),
+        ...addressFields('debtor'),
+        field(ID, 'referenceType', 'select', {
+            required: true,
+            options: ['qrr', 'scor', 'non'],
+            default: 'non',
+            hint: true,
+        }),
+        field(ID, 'reference', 'text', { maxLength: 27 + 6 }),
+        field(ID, 'message', 'text', { maxLength: 140 }),
+        field(ID, 'billingInformation', 'text', { maxLength: 140, advanced: true }),
+        field(ID, 'alternative1', 'text', { maxLength: 100, advanced: true }),
+        field(ID, 'alternative2', 'text', { maxLength: 100, advanced: true }),
+    ],
+    constraints: {
+        ecLevels: ['M'],
+        maxVersion: '25',
+        sizeMm: 46,
+        colours: 'black-on-white',
+        designLocked: true,
+        overlay: 'swiss-cross',
+    },
+    rules,
+    write,
+    detect: (text) => (/^SPC\r?\n0200\r?\n1\r?\n/.test(text) ? 1 : 0),
+    parse,
+    safety: () => [{ code: 'payload/payment', severity: 'caution' }],
+});
+//# sourceMappingURL=swiss-qr-bill.js.map

package/dist/payload/content/swiss-qr-bill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swiss-qr-bill.js","sourceRoot":"","sources":["../../../src/payload/content/swiss-qr-bill.ts"],"names":[],"mappings":"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"}

package/dist/payload/content/telegram.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A Telegram chat, by username or by phone number, with an optional draft
+ * message: Telegram's own deep links (core.telegram.org/api/links), written
+ * as t.me/<username> or t.me/+<phone_number>, each with ?text=.
+ *
+ * A username is 5 to 32 characters of Latin letters, digits and underscores
+ * (core.telegram.org/method/account.updateUsername). Telegram's invite links
+ * also start t.me/+ but carry letters after it, so only digits are read as a
+ * phone number.
+ */
+export type TelegramValue = {
+    readonly target: string;
+    readonly username: string;
+    readonly phone: string;
+    readonly message: string;
+};
+export declare const telegramType: import("../types.js").PayloadType<TelegramValue>;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/payload/content/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../../src/payload/content/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,MAAM,MAAM,aAAa,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB,CAAC;AAyDF,eAAO,MAAM,YAAY,kDA4BvB,CAAC"}

package/dist/payload/content/telegram.js

@@ -0,0 +1,105 @@
+/**
+ * A Telegram chat, by username or by phone number, with an optional draft
+ * message: Telegram's own deep links (core.telegram.org/api/links), written
+ * as t.me/<username> or t.me/+<phone_number>, each with ?text=.
+ *
+ * A username is 5 to 32 characters of Latin letters, digits and underscores
+ * (core.telegram.org/method/account.updateUsername). Telegram's invite links
+ * also start t.me/+ but carry letters after it, so only digits are read as a
+ * phone number.
+ */
+import { issue } from '../../core/issue.js';
+import { definePayload, field, unparseable } from '../define.js';
+import { parseQuery } from '../escape.js';
+import { telDigits, textOf } from '../fields.js';
+const ID = 'telegram';
+const USERNAME = /^[A-Za-z0-9_]{5,32}$/;
+function write(value) {
+    const target = textOf(value, 'target');
+    const path = target === 'phone' ? `+${telDigits(textOf(value, 'phone'))}` : textOf(value, 'username');
+    const message = textOf(value, 'message');
+    return `https://t.me/${path}${message === '' ? '' : `?text=${encodeURIComponent(message)}`}`;
+}
+function rules(value, flagged) {
+    if (textOf(value, 'target') === 'phone') {
+        const phone = textOf(value, 'phone');
+        if (phone === '')
+            return [issue('payload.issue.required', ['fields', 'phone'])];
+        if (!flagged('phone') && !phone.startsWith('+')) {
+            return [issue('payload.telegram.issue.international', ['fields', 'phone'])];
+        }
+        return [];
+    }
+    const username = textOf(value, 'username');
+    if (username === '')
+        return [issue('payload.issue.required', ['fields', 'username'])];
+    return USERNAME.test(username)
+        ? []
+        : [issue('payload.telegram.issue.username', ['fields', 'username'])];
+}
+function locate(text) {
+    const web = /^(?:https?:\/\/)?(?:t\.me|telegram\.me)\/([^/?#]+)\/?(?:\?([^#]*))?$/i.exec(text);
+    if (web)
+        return { path: web[1], query: web[2] ?? '' };
+    const app = /^tg:\/\/resolve\?(.*)$/i.exec(text);
+    if (!app)
+        return undefined;
+    const pairs = parseQuery(app[1]) ?? [];
+    const domain = pairs.find(([name]) => name === 'domain')?.[1];
+    const phone = pairs.find(([name]) => name === 'phone')?.[1];
+    const rest = pairs
+        .filter(([name]) => name === 'text')
+        .map(([, v]) => `text=${encodeURIComponent(v)}`)
+        .join('&');
+    if (domain !== undefined)
+        return { path: domain, query: rest };
+    if (phone !== undefined)
+        return { path: `+${phone.replace(/^\+/, '')}`, query: rest };
+    return undefined;
+}
+function parse(text) {
+    const found = locate(text);
+    if (found === undefined)
+        throw unparseable(ID, 'not-telegram');
+    const pairs = parseQuery(found.query);
+    if (pairs === undefined)
+        throw unparseable(ID, 'malformed-escape');
+    const message = pairs.find(([name]) => name === 'text')?.[1] ?? '';
+    const phone = /^\+(\d{3,15})$/.exec(found.path);
+    if (phone)
+        return { target: 'phone', username: '', phone: `+${phone[1]}`, message };
+    if (!USERNAME.test(found.path))
+        throw unparseable(ID, 'not-a-username');
+    return { target: 'username', username: found.path, phone: '', message };
+}
+export const telegramType = definePayload({
+    id: ID,
+    category: 'message',
+    fields: [
+        field(ID, 'target', 'select', {
+            required: true,
+            options: ['username', 'phone'],
+            default: 'username',
+        }),
+        field(ID, 'username', 'text', { maxLength: 32, hint: true }),
+        field(ID, 'phone', 'tel', { hint: true }),
+        field(ID, 'message', 'multiline', { maxLength: 4096 }),
+    ],
+    compatibility: [
+        // Telegram, "Deep links": https://core.telegram.org/api/links
+        { reader: 'telegram', noteKey: 'payload.telegram.compat.app' },
+    ],
+    rules,
+    write,
+    detect: (text) => {
+        try {
+            parse(text);
+            return 0.9;
+        }
+        catch {
+            return 0;
+        }
+    },
+    parse,
+});
+//# sourceMappingURL=telegram.js.map

package/dist/payload/content/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../../src/payload/content/telegram.ts"],"names":[],"mappings":"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"}

package/dist/payload/content/text.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Plain text: the fallback every reader understands and the type anything is
+ * when it is not something more specific.
+ */
+export type TextValue = {
+    readonly text: string;
+};
+export declare const textType: import("../types.js").PayloadType<TextValue>;
+//# sourceMappingURL=text.d.ts.map

package/dist/payload/content/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/payload/content/text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,eAAO,MAAM,QAAQ,8CASnB,CAAC"}

package/dist/payload/content/text.js

@@ -0,0 +1,18 @@
+/**
+ * Plain text: the fallback every reader understands and the type anything is
+ * when it is not something more specific.
+ */
+import { definePayload, field } from '../define.js';
+import { textOf } from '../fields.js';
+const ID = 'text';
+export const textType = definePayload({
+    id: ID,
+    category: 'text',
+    fields: [field(ID, 'text', 'multiline', { required: true })],
+    write: (value) => textOf(value, 'text'),
+    // Any text is text, so this never says no; and it never says more than
+    // "possibly", so every specific type outranks it.
+    detect: (text) => (text === '' ? 0 : 0.01),
+    parse: (text) => ({ text }),
+});
+//# sourceMappingURL=text.js.map

package/dist/payload/content/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/payload/content/text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,EAAE,GAAG,MAAM,CAAC;AAIlB,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAY;IAChD,EAAE,EAAE,EAAE;IACN,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;IACvC,uEAAuE;IACvE,kDAAkD;IAClD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;CAC3B,CAAC,CAAC"}

package/dist/payload/content/upi.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A UPI payment (India): upi://pay with pa (the payee's address), pn (their
+ * name), and optionally am (the amount), cu (always INR) and tn (a note), from
+ * NPCI's "UPI Linking Specifications" (version 1.6, November 2017,
+ * "Common URL Specifications for Deep Linking and Proximity Integration").
+ *
+ * The specification asks for spaces as %20 under RFC 3986 and gives no
+ * syntax for a payment address beyond name@handle, so the address check here
+ * is the shape every UPI app accepts rather than a rule from NPCI: letters,
+ * digits, dot, hyphen and underscore, an @, then a handle that starts with a
+ * letter. Merchant parameters (mc, tr, mode, sign, orgid) belong to signed
+ * merchant codes, which only a bank can issue, and are not offered.
+ */
+export type UpiValue = {
+    readonly address: string;
+    readonly name: string;
+    readonly amount: number | null;
+    readonly note: string;
+};
+export declare const upiType: import("../types.js").PayloadType<UpiValue>;
+//# sourceMappingURL=upi.d.ts.map

package/dist/payload/content/upi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upi.d.ts","sourceRoot":"","sources":["../../../src/payload/content/upi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,MAAM,MAAM,QAAQ,GAAG;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB,CAAC;AAwDF,eAAO,MAAM,OAAO,6CAclB,CAAC"}

package/dist/payload/content/upi.js

@@ -0,0 +1,89 @@
+/**
+ * A UPI payment (India): upi://pay with pa (the payee's address), pn (their
+ * name), and optionally am (the amount), cu (always INR) and tn (a note), from
+ * NPCI's "UPI Linking Specifications" (version 1.6, November 2017,
+ * "Common URL Specifications for Deep Linking and Proximity Integration").
+ *
+ * The specification asks for spaces as %20 under RFC 3986 and gives no
+ * syntax for a payment address beyond name@handle, so the address check here
+ * is the shape every UPI app accepts rather than a rule from NPCI: letters,
+ * digits, dot, hyphen and underscore, an @, then a handle that starts with a
+ * letter. Merchant parameters (mc, tr, mode, sign, orgid) belong to signed
+ * merchant codes, which only a bank can issue, and are not offered.
+ */
+import { issue } from '../../core/issue.js';
+import { definePayload, field, unparseable } from '../define.js';
+import { parseQuery } from '../escape.js';
+import { decimalPlaces, FIELD_ISSUES, numberOf, textOf } from '../fields.js';
+const ID = 'upi';
+const ADDRESS = /^[A-Za-z0-9._-]{2,256}@[A-Za-z][A-Za-z0-9.-]{1,63}$/;
+function encode(text) {
+    // The @ of a payment address is written as it is; every app reads it, and
+    // several do not decode %40 in pa.
+    return encodeURIComponent(text).replace(/%40/g, '@');
+}
+function rules(value, flagged) {
+    const found = [];
+    const address = textOf(value, 'address');
+    if (address !== '' && !flagged('address') && !ADDRESS.test(address)) {
+        found.push(issue('payload.upi.issue.address', ['fields', 'address']));
+    }
+    const amount = numberOf(value, 'amount');
+    if (amount !== null && !flagged('amount') && decimalPlaces(amount) > 2) {
+        found.push(issue(FIELD_ISSUES.amountDecimals, ['fields', 'amount'], 'error', { max: 2 }));
+    }
+    return found;
+}
+function write(value) {
+    const query = [`pa=${encode(textOf(value, 'address'))}`, `pn=${encode(textOf(value, 'name'))}`];
+    const amount = numberOf(value, 'amount');
+    if (amount !== null)
+        query.push(`am=${amount.toFixed(2)}`);
+    query.push('cu=INR');
+    if (textOf(value, 'note') !== '')
+        query.push(`tn=${encode(textOf(value, 'note'))}`);
+    return `upi://pay?${query.join('&')}`;
+}
+function parse(text) {
+    const match = /^upi:\/\/pay\?(.*)$/i.exec(text);
+    if (!match)
+        throw unparseable(ID, 'not-upi');
+    // UPI apps on Android read parameters with Uri.getQueryParameter, which
+    // takes + as a space, so this does too.
+    const pairs = parseQuery(match[1], true);
+    if (pairs === undefined)
+        throw unparseable(ID, 'malformed-escape');
+    const get = (name) => pairs.find(([key]) => key === name)?.[1];
+    const address = get('pa');
+    if (address === undefined || address === '')
+        throw unparseable(ID, 'missing-address');
+    const currency = get('cu');
+    if (currency !== undefined && currency !== 'INR')
+        throw unparseable(ID, 'currency');
+    const amountText = get('am');
+    if (amountText !== undefined && amountText !== '' && !/^\d+(?:\.\d{1,2})?$/.test(amountText)) {
+        throw unparseable(ID, 'amount');
+    }
+    return {
+        address,
+        name: get('pn') ?? '',
+        amount: amountText === undefined || amountText === '' ? null : Number(amountText),
+        note: get('tn') ?? '',
+    };
+}
+export const upiType = definePayload({
+    id: ID,
+    category: 'payment',
+    fields: [
+        field(ID, 'address', 'text', { required: true, maxLength: 321, hint: true }),
+        field(ID, 'name', 'text', { required: true, maxLength: 99 }),
+        field(ID, 'amount', 'amount', { min: 0.01, max: 1000000 }),
+        field(ID, 'note', 'text', { maxLength: 80 }),
+    ],
+    rules,
+    write,
+    detect: (text) => (/^upi:\/\/pay\?/i.test(text) ? 1 : 0),
+    parse,
+    safety: () => [{ code: 'payload/payment', severity: 'caution' }],
+});
+//# sourceMappingURL=upi.js.map