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

package/dist/payload/data/hosts.js.map

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

package/dist/payload/define.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The shared machinery behind every content type.
+ *
+ * A type supplies its fields, the rules its specification adds, a writer and a
+ * reader. This file turns that into a `PayloadType`: validation that reports
+ * every issue at once, a `build` that refuses a value with errors rather than
+ * writing a code that scans and then fails at the bank, and errors that never
+ * carry content.
+ */
+import { QrStudioError } from '../core/errors.js';
+import type { Issue } from '../core/issue.js';
+import type { CompatibilityNote, FieldKind, FieldSchema, PayloadCategory, PayloadConstraints, PayloadType, PayloadValue, PayloadVector, SafetyFinding } from './types.js';
+export interface PayloadDefinition<V extends PayloadValue> {
+    readonly id: string;
+    readonly category: PayloadCategory;
+    readonly fields: readonly FieldSchema[];
+    readonly constraints?: PayloadConstraints;
+    readonly compatibility?: readonly CompatibilityNote[];
+    readonly generate?: boolean;
+    /**
+     * The issues the specification adds to the schema's. `flagged` says which
+     * fields the schema already found a problem with, so a rule about a field's
+     * meaning stays quiet about one that is not even well formed.
+     */
+    readonly rules?: (value: V, flagged: (key: string) => boolean) => readonly Issue[];
+    /** The text, for a value already known to have no error issues. */
+    readonly write: (value: V) => string;
+    readonly detect: (text: string) => number;
+    readonly parse: (text: string) => V;
+    readonly safety?: (value: V) => readonly SafetyFinding[];
+    /** The built-in types leave this out: their vectors are in ./vectors, off the runtime path. */
+    readonly vectors?: readonly PayloadVector<V>[];
+}
+export declare function definePayload<V extends PayloadValue>(definition: PayloadDefinition<V>): PayloadType<V>;
+type FieldExtras = Omit<FieldSchema, 'key' | 'kind' | 'labelKey' | 'options'> & {
+    /** Option values, lower case; each gets the label key `payload.<id>.option.<key>.<value>`. */
+    readonly options?: readonly string[];
+    /** True to give the field a hint at `payload.<id>.hint.<key>`. */
+    readonly hint?: boolean;
+};
+/** A field key as it appears in a message key: 'givenName' is 'given-name', because keys are lower case. */
+export declare function keySegment(key: string): string;
+/**
+ * A field whose message keys follow the catalogue's naming:
+ * `payload.<id>.field.<key>`, with the key in kebab case.
+ */
+export declare function field(id: string, key: string, kind: FieldKind, extras?: FieldExtras): FieldSchema;
+/**
+ * The text is not this kind of content, or is too damaged to read as it.
+ * `reason` is an identifier for a developer and a translated message, never
+ * a piece of the text.
+ */
+export declare function unparseable(type: string, reason: string): QrStudioError;
+/** The text is this kind of content, but a check over the whole of it fails. */
+export declare function invalidPayload(type: string, reason: string): QrStudioError;
+export {};
+//# sourceMappingURL=define.d.ts.map

package/dist/payload/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/payload/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EACX,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,YAAY;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,KAAK,SAAS,KAAK,EAAE,CAAC;IACnF,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,aAAa,EAAE,CAAC;IACzD,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/C;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EACnD,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC9B,WAAW,CAAC,CAAC,CAAC,CAmChB;AAED,KAAK,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC,GAAG;IAC/E,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,4GAA4G;AAC5G,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,KAAK,CACpB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,EACf,MAAM,GAAE,WAAgB,GACtB,WAAW,CAkBb;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAMvE;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAM1E"}

package/dist/payload/define.js

@@ -0,0 +1,87 @@
+/**
+ * The shared machinery behind every content type.
+ *
+ * A type supplies its fields, the rules its specification adds, a writer and a
+ * reader. This file turns that into a `PayloadType`: validation that reports
+ * every issue at once, a `build` that refuses a value with errors rather than
+ * writing a code that scans and then fails at the bank, and errors that never
+ * carry content.
+ */
+import { QrStudioError } from '../core/errors.js';
+import { hasErrors } from '../core/issue.js';
+import { validateFields } from './fields.js';
+export function definePayload(definition) {
+    const { id, rules, write } = definition;
+    const validate = (value) => {
+        const base = validateFields(definition.fields, value);
+        if (rules === undefined || typeof value !== 'object' || value === null)
+            return base;
+        const flaggedKeys = new Set(base.map((found) => found.path[1]));
+        return [...base, ...rules(value, (key) => flaggedKeys.has(key))];
+    };
+    const type = {
+        id,
+        labelKey: `payload.${id}.label`,
+        descriptionKey: `payload.${id}.description`,
+        actionKey: `payload.${id}.action`,
+        category: definition.category,
+        fields: definition.fields,
+        validate,
+        build(value) {
+            if (hasErrors(validate(value))) {
+                throw new TypeError(`This ${id} value has error issues, so it cannot be built. Call validate first and fix what it reports.`);
+            }
+            return { text: write(value) };
+        },
+        detect: definition.detect,
+        parse: definition.parse,
+    };
+    return Object.freeze({
+        ...type,
+        ...(definition.constraints ? { constraints: definition.constraints } : {}),
+        ...(definition.compatibility ? { compatibility: definition.compatibility } : {}),
+        ...(definition.generate === false ? { generate: false } : {}),
+        ...(definition.safety ? { safety: definition.safety } : {}),
+        ...(definition.vectors ? { vectors: definition.vectors } : {}),
+    });
+}
+/** A field key as it appears in a message key: 'givenName' is 'given-name', because keys are lower case. */
+export function keySegment(key) {
+    return key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+/**
+ * A field whose message keys follow the catalogue's naming:
+ * `payload.<id>.field.<key>`, with the key in kebab case.
+ */
+export function field(id, key, kind, extras = {}) {
+    const { options, hint, ...rest } = extras;
+    const segment = keySegment(key);
+    return {
+        key,
+        kind,
+        labelKey: `payload.${id}.field.${segment}`,
+        ...(hint ? { hintKey: `payload.${id}.hint.${segment}` } : {}),
+        ...(options
+            ? {
+                options: options.map((value) => ({
+                    value,
+                    labelKey: `payload.${id}.option.${segment}.${value}`,
+                })),
+            }
+            : {}),
+        ...rest,
+    };
+}
+/**
+ * The text is not this kind of content, or is too damaged to read as it.
+ * `reason` is an identifier for a developer and a translated message, never
+ * a piece of the text.
+ */
+export function unparseable(type, reason) {
+    return new QrStudioError('payload/unparseable', 'That text could not be read as this kind of content.', { type, reason });
+}
+/** The text is this kind of content, but a check over the whole of it fails. */
+export function invalidPayload(type, reason) {
+    return new QrStudioError('payload/invalid', 'That code is damaged or was made incorrectly: its own check does not match what it holds.', { type, reason });
+}
+//# sourceMappingURL=define.js.map

package/dist/payload/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/payload/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmC7C,MAAM,UAAU,aAAa,CAC5B,UAAgC;IAEhC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IACxC,MAAM,QAAQ,GAAG,CAAC,KAAQ,EAAoB,EAAE;QAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACpF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC;IACF,MAAM,IAAI,GAAmB;QAC5B,EAAE;QACF,QAAQ,EAAE,WAAW,EAAE,QAAQ;QAC/B,cAAc,EAAE,WAAW,EAAE,cAAc;QAC3C,SAAS,EAAE,WAAW,EAAE,SAAS;QACjC,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,QAAQ;QACR,KAAK,CAAC,KAAQ;YACb,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,SAAS,CAClB,QAAQ,EAAE,8FAA8F,CACxG,CAAC;YACH,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,KAAK,EAAE,UAAU,CAAC,KAAK;KACvB,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,GAAG,IAAI;QACP,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,CAAC,CAAC;AACJ,CAAC;AASD,4GAA4G;AAC5G,MAAM,UAAU,UAAU,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CACpB,EAAU,EACV,GAAW,EACX,IAAe,EACf,SAAsB,EAAE;IAExB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO;QACN,GAAG;QACH,IAAI;QACJ,QAAQ,EAAE,WAAW,EAAE,UAAU,OAAO,EAAE;QAC1C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO;YACV,CAAC,CAAC;gBACA,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAChC,KAAK;oBACL,QAAQ,EAAE,WAAW,EAAE,WAAW,OAAO,IAAI,KAAK,EAAE;iBACpD,CAAC,CAAC;aACH;YACF,CAAC,CAAC,EAAE,CAAC;QACN,GAAG,IAAI;KACP,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc;IACvD,OAAO,IAAI,aAAa,CACvB,qBAAqB,EACrB,sDAAsD,EACtD,EAAE,IAAI,EAAE,MAAM,EAAE,CAChB,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAc;IAC1D,OAAO,IAAI,aAAa,CACvB,iBAAiB,EACjB,2FAA2F,EAC3F,EAAE,IAAI,EAAE,MAAM,EAAE,CAChB,CAAC;AACH,CAAC"}

package/dist/payload/detect.d.ts

@@ -0,0 +1,13 @@
+/**
+ * What some text is: the content type that claims it most strongly.
+ *
+ * Every type scores the text from 0 to 1 and the highest wins, earlier
+ * registration breaking a tie. A type whose `detect` throws scores 0: one
+ * broken entry must not stop a scanned code from being explained. When
+ * nothing scores above 0, or the registry holds nothing that claims the
+ * text, the answer is plain text with the confidence text gives itself.
+ */
+import type { PayloadRegistry } from './registry.js';
+import type { PayloadDetection } from './types.js';
+export declare function detectPayload(text: string, registry: PayloadRegistry): PayloadDetection;
+//# sourceMappingURL=detect.d.ts.map

package/dist/payload/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/payload/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,YAAY,CAAC;AAWhE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAUvF"}

package/dist/payload/detect.js

@@ -0,0 +1,32 @@
+/**
+ * What some text is: the content type that claims it most strongly.
+ *
+ * Every type scores the text from 0 to 1 and the highest wins, earlier
+ * registration breaking a tie. A type whose `detect` throws scores 0: one
+ * broken entry must not stop a scanned code from being explained. When
+ * nothing scores above 0, or the registry holds nothing that claims the
+ * text, the answer is plain text with the confidence text gives itself.
+ */
+import { textType } from './content/text.js';
+function score(type, text) {
+    try {
+        const value = type.detect(text);
+        return Number.isFinite(value) ? Math.min(Math.max(value, 0), 1) : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+export function detectPayload(text, registry) {
+    let best;
+    for (const type of registry.list()) {
+        const confidence = score(type, text);
+        if (confidence > 0 && (best === undefined || confidence > best.confidence))
+            best = { type, confidence };
+    }
+    if (best !== undefined)
+        return best;
+    const fallback = registry.get('text') ?? textType;
+    return { type: fallback, confidence: score(fallback, text) };
+}
+//# sourceMappingURL=detect.js.map

package/dist/payload/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/payload/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C,SAAS,KAAK,CAAC,IAAiB,EAAE,IAAY;IAC7C,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,CAAC,CAAC;IACV,CAAC;AACF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAyB;IACpE,IAAI,IAAkC,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YACzE,IAAI,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAK,QAAwB,CAAC;IACnE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;AAC9D,CAAC"}

package/dist/payload/emv.d.ts

@@ -0,0 +1,41 @@
+/**
+ * EMVCo merchant-presented QR (MPM): the tag, length, value format that
+ * Brazil's Pix, Singapore's PayNow, Thailand's PromptPay, Malaysia's DuitNow
+ * and others all share.
+ *
+ * Each data object is a two-digit ID, a two-digit length and the value. Some
+ * IDs hold templates whose value is more data objects in the same format. The
+ * last object is always 63, a CRC-16/CCITT-FALSE over everything before it
+ * including the "6304" that introduces it, written as four upper-case hex
+ * digits (EMVCo MPM specification, section 4.7.3; BCB Manual BR Code).
+ *
+ * Lengths count characters. The specification's character set is printable
+ * ASCII, where characters and bytes are the same thing; a value outside it is
+ * reported by the content type, and the CRC is taken over UTF-8 bytes, which
+ * is what every Pix reader that accepts such a value does.
+ */
+export interface EmvObject {
+    readonly id: string;
+    readonly value: string;
+}
+/** Why a string is not an MPM payload. */
+export type EmvFailure = 'format' | 'crc';
+/** One data object as text. Throws TypeError for a value longer than 99 characters or an ID that is not two digits. */
+export declare function emvObject(id: string, value: string): string;
+export declare function emvCrc(text: string): string;
+/** A whole payload: the objects in order, then 63 with its CRC. */
+export declare function writeEmv(objects: readonly EmvObject[]): string;
+/** Read a run of data objects, as the top level or a template's value holds them. */
+export declare function readEmvObjects(text: string): EmvObject[] | undefined;
+/**
+ * Read a whole payload and check its CRC. The CRC object must come last and
+ * the payload format indicator (00, "01") first, as the specification fixes.
+ */
+export declare function readEmv(text: string): {
+    readonly ok: true;
+    readonly value: readonly EmvObject[];
+} | {
+    readonly ok: false;
+    readonly reason: EmvFailure;
+};
+//# sourceMappingURL=emv.d.ts.map

package/dist/payload/emv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emv.d.ts","sourceRoot":"","sources":["../../src/payload/emv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,0CAA0C;AAC1C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE1C,uHAAuH;AACvH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3C;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAG9D;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAS,CAcpE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACtB,IAAI,EAAE,MAAM,GAEV;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAWrD"}

package/dist/payload/emv.js

@@ -0,0 +1,73 @@
+/**
+ * EMVCo merchant-presented QR (MPM): the tag, length, value format that
+ * Brazil's Pix, Singapore's PayNow, Thailand's PromptPay, Malaysia's DuitNow
+ * and others all share.
+ *
+ * Each data object is a two-digit ID, a two-digit length and the value. Some
+ * IDs hold templates whose value is more data objects in the same format. The
+ * last object is always 63, a CRC-16/CCITT-FALSE over everything before it
+ * including the "6304" that introduces it, written as four upper-case hex
+ * digits (EMVCo MPM specification, section 4.7.3; BCB Manual BR Code).
+ *
+ * Lengths count characters. The specification's character set is printable
+ * ASCII, where characters and bytes are the same thing; a value outside it is
+ * reported by the content type, and the CRC is taken over UTF-8 bytes, which
+ * is what every Pix reader that accepts such a value does.
+ */
+import { crc16CcittFalse } from './check-digits.js';
+/** One data object as text. Throws TypeError for a value longer than 99 characters or an ID that is not two digits. */
+export function emvObject(id, value) {
+    if (!/^\d{2}$/.test(id))
+        throw new TypeError('An EMV data object ID is two digits.');
+    const length = [...value].length;
+    if (length > 99)
+        throw new TypeError('An EMV data object holds at most 99 characters.');
+    return `${id}${String(length).padStart(2, '0')}${value}`;
+}
+export function emvCrc(text) {
+    return crc16CcittFalse(new TextEncoder().encode(text))
+        .toString(16)
+        .toUpperCase()
+        .padStart(4, '0');
+}
+/** A whole payload: the objects in order, then 63 with its CRC. */
+export function writeEmv(objects) {
+    const body = `${objects.map(({ id, value }) => emvObject(id, value)).join('')}6304`;
+    return `${body}${emvCrc(body)}`;
+}
+/** Read a run of data objects, as the top level or a template's value holds them. */
+export function readEmvObjects(text) {
+    const chars = [...text];
+    const objects = [];
+    let i = 0;
+    while (i < chars.length) {
+        const id = chars.slice(i, i + 2).join('');
+        const lengthText = chars.slice(i + 2, i + 4).join('');
+        if (!/^\d{2}$/.test(id) || !/^\d{2}$/.test(lengthText))
+            return undefined;
+        const length = Number(lengthText);
+        if (i + 4 + length > chars.length)
+            return undefined;
+        objects.push({ id, value: chars.slice(i + 4, i + 4 + length).join('') });
+        i += 4 + length;
+    }
+    return objects;
+}
+/**
+ * Read a whole payload and check its CRC. The CRC object must come last and
+ * the payload format indicator (00, "01") first, as the specification fixes.
+ */
+export function readEmv(text) {
+    const objects = readEmvObjects(text);
+    const last = objects?.[objects.length - 1];
+    if (objects === undefined || last === undefined || last.id !== '63' || objects[0]?.id !== '00') {
+        return { ok: false, reason: 'format' };
+    }
+    if (objects[0].value !== '01' || !/^[0-9A-Fa-f]{4}$/.test(last.value))
+        return { ok: false, reason: 'format' };
+    const body = text.slice(0, text.length - 4);
+    if (emvCrc(body) !== last.value.toUpperCase())
+        return { ok: false, reason: 'crc' };
+    return { ok: true, value: objects.slice(0, -1) };
+}
+//# sourceMappingURL=emv.js.map

package/dist/payload/emv.js.map

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

package/dist/payload/escape.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The escaping rules of the text formats a QR code commonly carries.
+ *
+ * There are two families and they disagree. MECARD and the WIFI: string put a
+ * backslash before each reserved character and otherwise leave text alone.
+ * vCard and iCalendar escape text the same way but also turn a newline into
+ * `\n`, and on top of that fold long lines. Getting either wrong produces a
+ * card that scans and then shows a name cut off at its first comma, which
+ * looks like the reader's fault and is not.
+ */
+/** A backslash before each character in `reserved`, as MECARD and WIFI: write it. */
+export declare function backslashEscape(text: string, reserved: string): string;
+/** Undo `backslashEscape`: a backslash keeps whatever follows it. A trailing lone backslash is kept. */
+export declare function backslashUnescape(text: string): string;
+/** Split at each `separator` not preceded by an escaping backslash. Pieces stay escaped. */
+export declare function splitUnescaped(text: string, separator: string): string[];
+/**
+ * A TEXT value for vCard (RFC 2426 section 5, RFC 6350 section 3.4) or
+ * iCalendar (RFC 5545 section 3.3.11): backslash, comma and semicolon get a
+ * backslash, a newline becomes `\n`. Escaping the semicolon in a value that is
+ * not compound is allowed by all three and read correctly by every parser, and
+ * it means one function serves both kinds of value.
+ */
+export declare function escapeText(text: string): string;
+/** Undo `escapeText`. `\N` is a newline too (RFC 5545 allows it); any other escaped character stands for itself. */
+export declare function unescapeText(text: string): string;
+/**
+ * Fold a content line at 75 octets, as RFC 5545 section 3.1 and RFC 6350
+ * section 3.2 ask: CRLF and a space, never inside a UTF-8 sequence. The space
+ * that starts a continuation counts towards that line's 75.
+ */
+export declare function foldLine(line: string): string;
+/**
+ * Split text into unfolded content lines. CRLF is the standard ending; a bare
+ * LF is accepted because plenty of generators write one, and a continuation
+ * starts with one space or tab.
+ */
+export declare function unfoldLines(text: string): string[];
+export interface ContentLine {
+    /** Upper case, without any group prefix. */
+    readonly name: string;
+    /** Parameter names upper case; each value split at unquoted commas, quotes removed. */
+    readonly params: ReadonlyMap<string, readonly string[]>;
+    /** As written: still escaped. */
+    readonly value: string;
+}
+/**
+ * Read `group.NAME;PARAM=a,b;TYPE="x,y":value` into its parts.
+ *
+ * Parameter values may be quoted, and a quoted one may hold the colon and
+ * semicolon that otherwise end it. vCard 2.1 writes bare types (`TEL;CELL:`),
+ * which are read as TYPE values so an old card still says which number is the
+ * mobile. Undefined when the line has no colon outside quotes.
+ */
+export declare function parseContentLine(line: string): ContentLine | undefined;
+/** Split an escaped compound value (`N`, `ADR`, `ORG`) at its unescaped semicolons, then unescape each part. */
+export declare function splitCompound(value: string): string[];
+/** `decodeURIComponent` that answers undefined on a malformed escape rather than throwing URIError. */
+export declare function percentDecode(text: string, plusAsSpace?: boolean): string | undefined;
+/**
+ * The query of a URI as decoded name and value pairs, in order, names as
+ * written. Undefined when any escape is malformed, because a link whose
+ * parameters cannot be read cannot be explained either.
+ */
+export declare function parseQuery(query: string, plusAsSpace?: boolean): (readonly [string, string])[] | undefined;
+//# sourceMappingURL=escape.d.ts.map

package/dist/payload/escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../src/payload/escape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAItE;AAED,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYtD;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBxE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED,oHAAoH;AACpH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAajD;AASD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB7C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAUlD;AAED,MAAM,WAAW,WAAW;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACxD,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CA0BtE;AAmBD,gHAAgH;AAChH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD;AAED,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,MAAM,GAAG,SAAS,CAMnF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,EACb,WAAW,UAAQ,GACjB,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,CAY3C"}

package/dist/payload/escape.js

@@ -0,0 +1,225 @@
+/**
+ * The escaping rules of the text formats a QR code commonly carries.
+ *
+ * There are two families and they disagree. MECARD and the WIFI: string put a
+ * backslash before each reserved character and otherwise leave text alone.
+ * vCard and iCalendar escape text the same way but also turn a newline into
+ * `\n`, and on top of that fold long lines. Getting either wrong produces a
+ * card that scans and then shows a name cut off at its first comma, which
+ * looks like the reader's fault and is not.
+ */
+/** A backslash before each character in `reserved`, as MECARD and WIFI: write it. */
+export function backslashEscape(text, reserved) {
+    let out = '';
+    for (const char of text)
+        out += reserved.includes(char) ? `\\${char}` : char;
+    return out;
+}
+/** Undo `backslashEscape`: a backslash keeps whatever follows it. A trailing lone backslash is kept. */
+export function backslashUnescape(text) {
+    let out = '';
+    for (let i = 0; i < text.length; i += 1) {
+        const char = text[i];
+        if (char === '\\' && i + 1 < text.length) {
+            i += 1;
+            out += text[i];
+        }
+        else {
+            out += char;
+        }
+    }
+    return out;
+}
+/** Split at each `separator` not preceded by an escaping backslash. Pieces stay escaped. */
+export function splitUnescaped(text, separator) {
+    const pieces = [];
+    let current = '';
+    for (let i = 0; i < text.length; i += 1) {
+        const char = text[i];
+        if (char === '\\' && i + 1 < text.length) {
+            current += char + text[i + 1];
+            i += 1;
+        }
+        else if (char === separator) {
+            pieces.push(current);
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    pieces.push(current);
+    return pieces;
+}
+/**
+ * A TEXT value for vCard (RFC 2426 section 5, RFC 6350 section 3.4) or
+ * iCalendar (RFC 5545 section 3.3.11): backslash, comma and semicolon get a
+ * backslash, a newline becomes `\n`. Escaping the semicolon in a value that is
+ * not compound is allowed by all three and read correctly by every parser, and
+ * it means one function serves both kinds of value.
+ */
+export function escapeText(text) {
+    let out = '';
+    for (const char of text) {
+        if (char === '\\' || char === ',' || char === ';')
+            out += `\\${char}`;
+        else if (char === '\n')
+            out += '\\n';
+        else
+            out += char;
+    }
+    return out;
+}
+/** Undo `escapeText`. `\N` is a newline too (RFC 5545 allows it); any other escaped character stands for itself. */
+export function unescapeText(text) {
+    let out = '';
+    for (let i = 0; i < text.length; i += 1) {
+        const char = text[i];
+        if (char !== '\\' || i + 1 >= text.length) {
+            out += char;
+            continue;
+        }
+        i += 1;
+        const next = text[i];
+        out += next === 'n' || next === 'N' ? '\n' : next;
+    }
+    return out;
+}
+function utf8Length(codePoint) {
+    if (codePoint < 0x80)
+        return 1;
+    if (codePoint < 0x800)
+        return 2;
+    if (codePoint < 0x10000)
+        return 3;
+    return 4;
+}
+/**
+ * Fold a content line at 75 octets, as RFC 5545 section 3.1 and RFC 6350
+ * section 3.2 ask: CRLF and a space, never inside a UTF-8 sequence. The space
+ * that starts a continuation counts towards that line's 75.
+ */
+export function foldLine(line) {
+    const out = [];
+    let current = '';
+    let octets = 0;
+    for (const char of line) {
+        const size = utf8Length(char.codePointAt(0));
+        if (octets + size > 75) {
+            out.push(current);
+            current = ' ';
+            octets = 1;
+        }
+        current += char;
+        octets += size;
+    }
+    out.push(current);
+    return out.join('\r\n');
+}
+/**
+ * Split text into unfolded content lines. CRLF is the standard ending; a bare
+ * LF is accepted because plenty of generators write one, and a continuation
+ * starts with one space or tab.
+ */
+export function unfoldLines(text) {
+    const lines = [];
+    for (const raw of text.split(/\r\n|\n|\r/)) {
+        if ((raw.startsWith(' ') || raw.startsWith('\t')) && lines.length > 0) {
+            lines[lines.length - 1] += raw.slice(1);
+        }
+        else {
+            lines.push(raw);
+        }
+    }
+    return lines;
+}
+/**
+ * Read `group.NAME;PARAM=a,b;TYPE="x,y":value` into its parts.
+ *
+ * Parameter values may be quoted, and a quoted one may hold the colon and
+ * semicolon that otherwise end it. vCard 2.1 writes bare types (`TEL;CELL:`),
+ * which are read as TYPE values so an old card still says which number is the
+ * mobile. Undefined when the line has no colon outside quotes.
+ */
+export function parseContentLine(line) {
+    let quoted = false;
+    let colon = -1;
+    for (let i = 0; i < line.length; i += 1) {
+        const char = line[i];
+        if (char === '"')
+            quoted = !quoted;
+        else if (char === ':' && !quoted) {
+            colon = i;
+            break;
+        }
+    }
+    if (colon === -1)
+        return undefined;
+    const head = line.slice(0, colon);
+    const value = line.slice(colon + 1);
+    const parts = splitOutsideQuotes(head, ';');
+    const qualified = parts.shift().toUpperCase();
+    const name = qualified.slice(qualified.lastIndexOf('.') + 1);
+    const params = new Map();
+    for (const part of parts) {
+        const equals = part.indexOf('=');
+        const key = equals === -1 ? 'TYPE' : part.slice(0, equals).toUpperCase();
+        const raw = equals === -1 ? part : part.slice(equals + 1);
+        const values = splitOutsideQuotes(raw, ',').map((item) => item.replace(/^"|"$/g, ''));
+        params.set(key, [...(params.get(key) ?? []), ...values]);
+    }
+    return { name, params, value };
+}
+function splitOutsideQuotes(text, separator) {
+    const pieces = [];
+    let current = '';
+    let quoted = false;
+    for (const char of text) {
+        if (char === '"')
+            quoted = !quoted;
+        if (char === separator && !quoted) {
+            pieces.push(current);
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    pieces.push(current);
+    return pieces;
+}
+/** Split an escaped compound value (`N`, `ADR`, `ORG`) at its unescaped semicolons, then unescape each part. */
+export function splitCompound(value) {
+    return splitUnescaped(value, ';').map(unescapeText);
+}
+/** `decodeURIComponent` that answers undefined on a malformed escape rather than throwing URIError. */
+export function percentDecode(text, plusAsSpace = false) {
+    try {
+        return decodeURIComponent(plusAsSpace ? text.replace(/\+/g, ' ') : text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The query of a URI as decoded name and value pairs, in order, names as
+ * written. Undefined when any escape is malformed, because a link whose
+ * parameters cannot be read cannot be explained either.
+ */
+export function parseQuery(query, plusAsSpace = false) {
+    const pairs = [];
+    if (query === '')
+        return pairs;
+    for (const part of query.split('&')) {
+        if (part === '')
+            continue;
+        const equals = part.indexOf('=');
+        const name = percentDecode(equals === -1 ? part : part.slice(0, equals), plusAsSpace);
+        const value = percentDecode(equals === -1 ? '' : part.slice(equals + 1), plusAsSpace);
+        if (name === undefined || value === undefined)
+            return undefined;
+        pairs.push([name, value]);
+    }
+    return pairs;
+}
+//# sourceMappingURL=escape.js.map