@coderoftime/fints 0.0.0-stage → 0.2.0

package/dist/util/dates.js

@@ -0,0 +1,189 @@
+// A value is either a calendar date, a local `Date` at midnight of which only the day counts, or the exact moment of a
+// date with a time of day, which the bank states in German time (see `germanTime`). The parsers keep the two apart: a
+// date without a valid time of day is not a moment.
+const hourMs = 3_600_000;
+function twoDigits(n) {
+    return n.toString().padStart(2, '0');
+}
+function year(d) {
+    return d.getFullYear().toString().padStart(4, '0');
+}
+/** `YYYYMMDD`, the FinTS 3.0 date format. */
+export function formatFintsDate(d) {
+    return `${year(d)}${twoDigits(d.getMonth() + 1)}${twoDigits(d.getDate())}`;
+}
+/** `HHMMSS`, the FinTS 3.0 time format. */
+export function formatFintsTime(d) {
+    return `${twoDigits(d.getHours())}${twoDigits(d.getMinutes())}${twoDigits(d.getSeconds())}`;
+}
+/** `YYYY-MM-DD`, the ISO 8601 date format of camt. */
+export function formatIsoDate(d) {
+    return `${year(d)}-${twoDigits(d.getMonth() + 1)}-${twoDigits(d.getDate())}`;
+}
+const fintsDate = /^(\d{4})(\d{2})(\d{2})$/;
+const fintsTime = /^(\d{2})(\d{2})(\d{2})/;
+const isoDate = /^(\d{4})-(\d{2})-(\d{2})/;
+const isoTime = /^(\d{2}):(\d{2}):(\d{2})/;
+const isoDateTime = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}:\d{2})(?:\.\d+)?(Z|[+-]\d{2}:\d{2})?$/;
+/** Parses a FinTS 3.0 date `YYYYMMDD` as a calendar date; `undefined` if it is missing or invalid. */
+export function parseFintsDate(date) {
+    return parseDate(fintsDate, date);
+}
+/**
+ * Parses a FinTS 3.0 date `YYYYMMDD` and time `HHMMSS` as the moment they name; `undefined` if either is missing or
+ * invalid.
+ */
+export function parseFintsDateTime(date, time) {
+    return moment(parseDate(fintsDate, date), fintsTime, time);
+}
+/**
+ * Parses an ISO 8601 date `YYYY-MM-DD` as a calendar date, ignoring extra characters such as a time part; `undefined`
+ * if it is missing or invalid.
+ */
+export function parseIsoDate(date) {
+    return parseDate(isoDate, date);
+}
+/**
+ * Parses an ISO 8601 date and time as XML Schema writes it, `YYYY-MM-DDThh:mm:ss` with optional fractional seconds and
+ * UTC offset (`Z` or `±hh:mm`), as the moment it names, to the second: in German time where it states no offset.
+ * `undefined` if it is missing or invalid.
+ */
+export function parseIsoMoment(dateTime) {
+    const m = dateTime === undefined ? null : isoDateTime.exec(dateTime);
+    if (!m)
+        return undefined;
+    const [, date, time, offset] = m;
+    const german = moment(parseIsoDate(date), isoTime, time);
+    if (german === undefined || offset === undefined)
+        return german;
+    // Every engine reads a valid date and time with an offset alike (ECMAScript Date Time String Format), but some roll
+    // an invalid date, such as 30 February, over into the next month: `german` has checked them.
+    const exact = new Date(`${date}T${time}${offset}`);
+    return Number.isNaN(exact.getTime()) ? undefined : exact;
+}
+function parseDate(pattern, date) {
+    const d = date === undefined ? null : pattern.exec(date);
+    return d ? validDate(Number(d[1]), Number(d[2]), Number(d[3])) : undefined;
+}
+/** Hour, minute and second of the time matched by `pattern` in `time`; `undefined` if it is missing or invalid. */
+function parseTime(pattern, time) {
+    const t = time === undefined ? null : pattern.exec(time);
+    if (!t)
+        return undefined;
+    const [hour, minute, second] = [Number(t[1]), Number(t[2]), Number(t[3])];
+    return hour > 23 || minute > 59 || second > 59 ? undefined : [hour, minute, second];
+}
+/** The moment of the German time matched by `timePattern` in `time` on `day`. */
+function moment(day, timePattern, time) {
+    const t = parseTime(timePattern, time);
+    if (day === undefined || t === undefined)
+        return undefined;
+    return germanTime(day.getFullYear(), day.getMonth() + 1, day.getDate(), ...t);
+}
+/**
+ * Parses a FinTS 3.0 date `YYYYMMDD` and time `HHMMSS` given in UTC+01:00 all year round, as the account extension of
+ * the user parameter data states its times (Formals E.3.1); `undefined` if either is missing or invalid. A time with
+ * fewer than six digits lost its leading zeros as a JSON number.
+ */
+export function parseUtcPlusOneDateTime(date, time) {
+    const day = parseDate(fintsDate, date);
+    const t = parseTime(fintsTime, time?.padStart(6, '0'));
+    if (day === undefined || t === undefined)
+        return undefined;
+    return new Date(utc(day.getFullYear(), day.getMonth() + 1, day.getDate(), ...t) - hourMs);
+}
+/**
+ * The moment a German clock shows the given time.
+ *
+ * German time is CET (UTC+1), and CEST (UTC+2) from 01:00 UTC on the last Sunday of March to 01:00 UTC on the last
+ * Sunday of October (the EU rule). The hour the clocks show twice in October counts as CEST; a time in the hour that is
+ * skipped in March counts as CET.
+ */
+function germanTime(year, month, day, hour, minute, second) {
+    const clock = utc(year, month, day, hour, minute, second);
+    const summer = clock - 2 * hourMs;
+    return new Date(isSummerTime(summer) ? summer : clock - hourMs);
+}
+/** The calendar day a German clock shows at `moment`, as a local `Date` at midnight like every calendar date. */
+export function germanDay(moment) {
+    const utcMs = moment.getTime();
+    const clock = new Date(utcMs + (isSummerTime(utcMs) ? 2 : 1) * hourMs);
+    return localDate(clock.getUTCFullYear(), clock.getUTCMonth() + 1, clock.getUTCDate());
+}
+function isSummerTime(utcMs) {
+    const y = new Date(utcMs).getUTCFullYear();
+    return utcMs >= clockChange(y, 3) && utcMs < clockChange(y, 10);
+}
+/** 01:00 UTC on the last Sunday of `month`, when the EU changes the clocks. */
+function clockChange(year, month) {
+    const lastDay = daysInMonth(year, month);
+    const weekday = new Date(utc(year, month, lastDay, 0, 0, 0)).getUTCDay();
+    return utc(year, month, lastDay - weekday, 1, 0, 0);
+}
+/** Milliseconds since the epoch of the UTC time; `month` counts from 1, and years below 100 are not moved to 19xx. */
+function utc(year, month, day, hour, minute, second) {
+    const d = new Date(0);
+    d.setUTCFullYear(year, month - 1, day);
+    d.setUTCHours(hour, minute, second, 0);
+    return d.getTime();
+}
+/** Local midnight of the day; `month` counts from 1, and years below 100 are not moved to 19xx. */
+function localDate(year, month, day) {
+    const d = new Date(0);
+    d.setFullYear(year, month - 1, day);
+    d.setHours(0, 0, 0, 0);
+    return d;
+}
+/** The date, or `undefined` if `month` or `day` is out of range; `Date` would roll it over into another date. */
+function validDate(year, month, day) {
+    if (month < 1 || month > 12 || day < 1 || day > daysInMonth(year, month))
+        return undefined;
+    return localDate(year, month, day);
+}
+/**
+ * The date, with a day beyond the end of the month moved to its last day: banks write 30 February or 31 April for
+ * month-end bookings. `undefined` for a month or day that no month has.
+ */
+export function clampedDate(year, month, day) {
+    if (month < 1 || month > 12 || day < 1 || day > 31)
+        return undefined;
+    return validDate(year, month, day) ?? localDate(year, month, daysInMonth(year, month));
+}
+const swiftDate = /^(\d{2})(\d{2})(\d{2})$/;
+/**
+ * Parses a SWIFT date `YYMMDD`, as MT940 writes it, with month ends as `clampedDate` reads them; years from 80 on count
+ * as 19xx. `undefined` if the date is invalid.
+ */
+export function parseSwiftDate(yymmdd) {
+    const m = swiftDate.exec(yymmdd);
+    if (!m)
+        return undefined;
+    const yy = Number(m[1]);
+    return clampedDate(yy >= 80 ? 1900 + yy : 2000 + yy, Number(m[2]), Number(m[3]));
+}
+/** Number of days the `month` (1 to 12) of `year` has. */
+function daysInMonth(year, month) {
+    if (month === 2)
+        return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0 ? 29 : 28;
+    return [4, 6, 9, 11].includes(month) ? 30 : 31;
+}
+export function copyDate(d) {
+    return d && new Date(d.getTime());
+}
+/** The calendar day `moment` falls on in local time, as a local `Date` at midnight. */
+export function calendarDay(moment) {
+    return localDate(moment.getFullYear(), moment.getMonth() + 1, moment.getDate());
+}
+/**
+ * The calendar `day`, moved back to the bank's today if it lies after it: banks reject future dates in queries.
+ *
+ * The bank's today is the German day at `now`, the current time by default; east of Germany the local day starts
+ * earlier.
+ */
+export function notAfterToday(day, now = new Date()) {
+    if (day === undefined)
+        return undefined;
+    const today = germanDay(now);
+    return day.getTime() > today.getTime() ? today : day;
+}
+//# sourceMappingURL=dates.js.map

package/dist/util/dates.js.map

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

package/dist/util/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Data that do not have the expected format, such as a malformed MT940 line or amount.
+ *
+ * The message leaves out `source`, which may hold account data, such as amounts, names and IBANs, so that logs and
+ * crash reports do not collect them.
+ */
+export declare class FormatError extends Error {
+    name: string;
+    /** The part of the data that is malformed, where the parser can tell it. */
+    readonly source: string | undefined;
+    constructor(message: string, source?: string);
+}
+/** Throws a `FormatError`, where an expression is expected, such as `value ?? fail('…')`. */
+export declare function fail(message: string, source?: string): never;
+/** An argument the function cannot work with, such as an empty PIN. The message never contains a PIN. */
+export declare function invalidArgument(message: string, name?: string): TypeError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/util/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/util/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAC3B,IAAI,SAAiB;IAE9B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAI7C;AAED,6FAA6F;AAC7F,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAE5D;AAED,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAEzE"}

package/dist/util/errors.js

@@ -0,0 +1,24 @@
+/**
+ * Data that do not have the expected format, such as a malformed MT940 line or amount.
+ *
+ * The message leaves out `source`, which may hold account data, such as amounts, names and IBANs, so that logs and
+ * crash reports do not collect them.
+ */
+export class FormatError extends Error {
+    name = 'FormatError';
+    /** The part of the data that is malformed, where the parser can tell it. */
+    source;
+    constructor(message, source) {
+        super(message);
+        this.source = source;
+    }
+}
+/** Throws a `FormatError`, where an expression is expected, such as `value ?? fail('…')`. */
+export function fail(message, source) {
+    throw new FormatError(message, source);
+}
+/** An argument the function cannot work with, such as an empty PIN. The message never contains a PIN. */
+export function invalidArgument(message, name) {
+    return new TypeError(name === undefined ? message : `Invalid argument (${name}): ${message}`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/util/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/util/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,GAAG,aAAa,CAAC;IAE9B,4EAA4E;IACnE,MAAM,CAAqB;IAEpC,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,6FAA6F;AAC7F,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,MAAe;IACnD,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,IAAa;IAC5D,OAAO,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,IAAI,MAAM,OAAO,EAAE,CAAC,CAAC;AAChG,CAAC"}

package/dist/util/immutable-map.d.ts

@@ -0,0 +1,16 @@
+/** A map that cannot be changed, also not at runtime: it has no `set`, `delete` or `clear`. */
+export declare class ImmutableMap<K, V> implements ReadonlyMap<K, V> {
+    private readonly map;
+    constructor(entries?: Iterable<readonly [K, V]>);
+    get size(): number;
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    forEach(callback: (value: V, key: K, map: ReadonlyMap<K, V>) => void): void;
+    entries(): MapIterator<[K, V]>;
+    keys(): MapIterator<K>;
+    values(): MapIterator<V>;
+    [Symbol.iterator](): MapIterator<[K, V]>;
+    /** A plain object of the entries, for JSON and for display. */
+    toJSON(): Record<string, V>;
+}
+//# sourceMappingURL=immutable-map.d.ts.map

package/dist/util/immutable-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutable-map.d.ts","sourceRoot":"","sources":["../../src/util/immutable-map.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,qBAAa,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;gBAEpB,OAAO,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAI/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAI1B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAM3E,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAI9B,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC;IAItB,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC;IAIxB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAIxC,+DAA+D;IAC/D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;CAG5B"}

package/dist/util/immutable-map.js

@@ -0,0 +1,38 @@
+/** A map that cannot be changed, also not at runtime: it has no `set`, `delete` or `clear`. */
+export class ImmutableMap {
+    map;
+    constructor(entries) {
+        this.map = new Map(entries);
+    }
+    get size() {
+        return this.map.size;
+    }
+    get(key) {
+        return this.map.get(key);
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    forEach(callback) {
+        this.map.forEach((value, key) => {
+            callback(value, key, this);
+        });
+    }
+    entries() {
+        return this.map.entries();
+    }
+    keys() {
+        return this.map.keys();
+    }
+    values() {
+        return this.map.values();
+    }
+    [Symbol.iterator]() {
+        return this.map.entries();
+    }
+    /** A plain object of the entries, for JSON and for display. */
+    toJSON() {
+        return Object.fromEntries([...this.map].map(([key, value]) => [String(key), value]));
+    }
+}
+//# sourceMappingURL=immutable-map.js.map

package/dist/util/immutable-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutable-map.js","sourceRoot":"","sources":["../../src/util/immutable-map.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,OAAO,YAAY;IACN,GAAG,CAAY;IAEhC,YAAY,OAAmC;QAC7C,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,QAA4D;QAClE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC9B,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAED,+DAA+D;IAC/D,MAAM;QACJ,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;CACF"}

package/dist/util/json.d.ts

@@ -0,0 +1,17 @@
+/** A JSON object read from a saved state. */
+export type JsonObject = Record<string, unknown>;
+export declare function isJsonObject(value: unknown): value is JsonObject;
+/** The optional string at `key`; throws `FormatError` for a value of another type. */
+export declare function readOptionalString(json: JsonObject, key: string): string | undefined;
+/** The optional integer at `key`; throws `FormatError` for a value of another type. */
+export declare function readOptionalInt(json: JsonObject, key: string): number | undefined;
+/** The optional boolean at `key`; throws `FormatError` for a value of another type. */
+export declare function readOptionalBoolean(json: JsonObject, key: string): boolean | undefined;
+/** The object at `key`; throws `FormatError` if it is missing or not an object. */
+export declare function readObject(json: JsonObject, key: string): JsonObject;
+/** The optional object at `key`; throws `FormatError` for a value of another type. */
+export declare function readOptionalObject(json: JsonObject, key: string): JsonObject | undefined;
+/** The optional list at `key`, each element checked by `isElement`; throws `FormatError` for anything else. */
+export declare function readOptionalList<T>(json: JsonObject, key: string, isElement: (value: unknown) => value is T): T[] | undefined;
+export declare function isString(value: unknown): value is string;
+//# sourceMappingURL=json.d.ts.map

package/dist/util/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/util/json.ts"],"names":[],"mappings":"AAEA,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKpF;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOjF;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAKtF;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAIpE;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAKxF;AAED,+GAA+G;AAC/G,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACxC,CAAC,EAAE,GAAG,SAAS,CAOjB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD"}

package/dist/util/json.js

@@ -0,0 +1,62 @@
+import { FormatError } from './errors.js';
+export function isJsonObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** The optional string at `key`; throws `FormatError` for a value of another type. */
+export function readOptionalString(json, key) {
+    const value = json[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== 'string')
+        throw new FormatError(`Saved state: "${key}" is not a string`);
+    return value;
+}
+/** The optional integer at `key`; throws `FormatError` for a value of another type. */
+export function readOptionalInt(json, key) {
+    const value = json[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== 'number' || !Number.isInteger(value)) {
+        throw new FormatError(`Saved state: "${key}" is not an integer`);
+    }
+    return value;
+}
+/** The optional boolean at `key`; throws `FormatError` for a value of another type. */
+export function readOptionalBoolean(json, key) {
+    const value = json[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== 'boolean')
+        throw new FormatError(`Saved state: "${key}" is not a boolean`);
+    return value;
+}
+/** The object at `key`; throws `FormatError` if it is missing or not an object. */
+export function readObject(json, key) {
+    const value = json[key];
+    if (!isJsonObject(value))
+        throw new FormatError(`Saved state: "${key}" is not an object`);
+    return value;
+}
+/** The optional object at `key`; throws `FormatError` for a value of another type. */
+export function readOptionalObject(json, key) {
+    const value = json[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (!isJsonObject(value))
+        throw new FormatError(`Saved state: "${key}" is not an object`);
+    return value;
+}
+/** The optional list at `key`, each element checked by `isElement`; throws `FormatError` for anything else. */
+export function readOptionalList(json, key, isElement) {
+    const value = json[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (!Array.isArray(value) || !value.every(isElement)) {
+        throw new FormatError(`Saved state: "${key}" is not a list of the expected values`);
+    }
+    return value;
+}
+export function isString(value) {
+    return typeof value === 'string';
+}
+//# sourceMappingURL=json.js.map

package/dist/util/json.js.map

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

package/dist/util/text.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Decodes text from the bank, which may be UTF-8 (with or without BOM) or ISO 8859-1; ASCII reads the same in both.
+ *
+ * UTF-8 comes first, since some banks send it. ISO 8859-1 text that happens to be valid UTF-8, such as `ß°`, reads as
+ * UTF-8 then: a rare misreading of text shown, as values sent back to the bank are read byte for byte
+ * (`Segment.verbatim`).
+ */
+export declare function decodeBankText(bytes: Uint8Array): string;
+/** Decodes an XML document, honouring an ISO 8859-1 or Windows-1252 encoding declaration. */
+export declare function decodeXmlText(bytes: Uint8Array): string;
+/**
+ * Decodes Windows-1252, which matches ISO 8859-1 except for `€`, typographic quotes and a few letters.
+ *
+ * @internal Exported for the tests.
+ */
+export declare function decodeWindows1252(bytes: Uint8Array): string;
+/**
+ * The last four characters of `id`, such as an IBAN or a card number, after an ellipsis: enough to tell two apart, too
+ * little to identify one in a log.
+ */
+export declare function maskedId(id: string): string;
+/** Whether `value` fits into ISO 8859-1, the FinTS 3.0 character set. */
+export declare function isLatin1(value: string): boolean;
+/** `text` without blanks around it; `undefined` if that leaves nothing. */
+export declare function nonBlank(text: string | undefined): string | undefined;
+/**
+ * The character the numeric character reference `name` names, such as `#x41` or `#65`; `undefined` for any other name,
+ * and for a number that is no character as XML defines them: `NUL`, half a surrogate pair, or beyond Unicode.
+ */
+export declare function characterReference(name: string): string | undefined;
+/** `text` without spaces and line breaks. */
+export declare function withoutWhitespace(text: string): string;
+/** Decodes base64 that may be broken into lines; throws `FormatError` if it is invalid. */
+export declare function decodeBase64Lines(text: string): Uint8Array;
+/** The integer `text` states, decimal digits with an optional sign and blanks around; `undefined` for anything else. */
+export declare function tryParseInt(text: string | undefined): number | undefined;
+//# sourceMappingURL=text.d.ts.map

package/dist/util/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/util/text.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CASxD;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAcvD;AAYD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKnE;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE1D;AAED,wHAAwH;AACxH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIxE"}

package/dist/util/text.js

@@ -0,0 +1,107 @@
+import { base64Decode, fromCharCodes, latin1Decode, utf8Decode } from './bytes.js';
+import { FormatError } from './errors.js';
+const xmlEncodingDeclaration = /encoding\s*=\s*["']([A-Za-z0-9._-]+)["']/;
+const whitespace = /\s/g;
+/**
+ * Decodes text from the bank, which may be UTF-8 (with or without BOM) or ISO 8859-1; ASCII reads the same in both.
+ *
+ * UTF-8 comes first, since some banks send it. ISO 8859-1 text that happens to be valid UTF-8, such as `ß°`, reads as
+ * UTF-8 then: a rare misreading of text shown, as values sent back to the bank are read byte for byte
+ * (`Segment.verbatim`).
+ */
+export function decodeBankText(bytes) {
+    const hasBom = bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf;
+    const content = hasBom ? bytes.subarray(3) : bytes;
+    try {
+        return utf8Decode(content);
+    }
+    catch (error) {
+        if (!(error instanceof FormatError))
+            throw error;
+        return hasBom ? utf8Decode(content, true) : latin1Decode(content);
+    }
+}
+/** Decodes an XML document, honouring an ISO 8859-1 or Windows-1252 encoding declaration. */
+export function decodeXmlText(bytes) {
+    const head = latin1Decode(bytes.length > 200 ? bytes.subarray(0, 200) : bytes);
+    switch (xmlEncodingDeclaration.exec(head)?.[1]?.toLowerCase()) {
+        case 'windows-1252':
+        case 'cp1252':
+            return decodeWindows1252(bytes);
+        case 'iso-8859-1':
+        case 'iso8859-1':
+        case 'latin1':
+        case 'latin-1':
+            return latin1Decode(bytes);
+        default:
+            return decodeBankText(bytes);
+    }
+}
+/**
+ * The code points of the Windows-1252 bytes 0x80 to 0x9F, where ISO 8859-1 has control characters; the five unassigned
+ * bytes keep their code.
+ */
+const windows1252High = [
+    0x20ac, 0x0081, 0x201a, 0x0192, 0x201e, 0x2026, 0x2020, 0x2021, 0x02c6, 0x2030, 0x0160, 0x2039, 0x0152, 0x008d,
+    0x017d, 0x008f, 0x0090, 0x2018, 0x2019, 0x201c, 0x201d, 0x2022, 0x2013, 0x2014, 0x02dc, 0x2122, 0x0161, 0x203a,
+    0x0153, 0x009d, 0x017e, 0x0178,
+];
+/**
+ * Decodes Windows-1252, which matches ISO 8859-1 except for `€`, typographic quotes and a few letters.
+ *
+ * @internal Exported for the tests.
+ */
+export function decodeWindows1252(bytes) {
+    const codes = new Uint16Array(bytes.length);
+    for (let i = 0; i < bytes.length; i++) {
+        const b = bytes[i];
+        codes[i] = b >= 0x80 && b < 0xa0 ? windows1252High[b - 0x80] : b;
+    }
+    return fromCharCodes(codes);
+}
+/**
+ * The last four characters of `id`, such as an IBAN or a card number, after an ellipsis: enough to tell two apart, too
+ * little to identify one in a log.
+ */
+export function maskedId(id) {
+    return id.length <= 4 ? '…' : `…${id.substring(id.length - 4)}`;
+}
+/** Whether `value` fits into ISO 8859-1, the FinTS 3.0 character set. */
+export function isLatin1(value) {
+    for (let i = 0; i < value.length; i++)
+        if (value.charCodeAt(i) > 0xff)
+            return false;
+    return true;
+}
+/** `text` without blanks around it; `undefined` if that leaves nothing. */
+export function nonBlank(text) {
+    const trimmed = text?.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+/**
+ * The character the numeric character reference `name` names, such as `#x41` or `#65`; `undefined` for any other name,
+ * and for a number that is no character as XML defines them: `NUL`, half a surrogate pair, or beyond Unicode.
+ */
+export function characterReference(name) {
+    const m = /^#(?:x([0-9a-fA-F]+)|([0-9]+))$/.exec(name);
+    if (!m)
+        return undefined;
+    const code = m[1] === undefined ? parseInt(m[2], 10) : parseInt(m[1], 16);
+    return code > 0 && (code < 0xd800 || code > 0xdfff) && code <= 0x10ffff ? String.fromCodePoint(code) : undefined;
+}
+/** `text` without spaces and line breaks. */
+export function withoutWhitespace(text) {
+    return text.replace(whitespace, '');
+}
+/** Decodes base64 that may be broken into lines; throws `FormatError` if it is invalid. */
+export function decodeBase64Lines(text) {
+    return base64Decode(withoutWhitespace(text));
+}
+/** The integer `text` states, decimal digits with an optional sign and blanks around; `undefined` for anything else. */
+export function tryParseInt(text) {
+    if (text === undefined)
+        return undefined;
+    const match = /^\s*([+-]?\d+)\s*$/.exec(text);
+    return match ? Number(match[1]) : undefined;
+}
+//# sourceMappingURL=text.js.map

package/dist/util/text.js.map

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

package/dist/util/xml.d.ts

@@ -0,0 +1,36 @@
+/**
+ * An element of a parsed XML document, looked up by local name: camt documents come with and without namespace
+ * prefixes.
+ */
+export declare class XmlElement {
+    /** The name without namespace prefix. */
+    readonly localName: string;
+    /** The attributes by name without namespace prefix; namespace declarations are left out. */
+    readonly attributes: ReadonlyMap<string, string>;
+    readonly children: (XmlElement | string)[];
+    constructor(
+    /** The name without namespace prefix. */
+    localName: string, 
+    /** The attributes by name without namespace prefix; namespace declarations are left out. */
+    attributes: ReadonlyMap<string, string>);
+    get childElements(): XmlElement[];
+    /** The text of this element and all below it. */
+    get innerText(): string;
+    getAttribute(localName: string): string | undefined;
+    /** The first child element called `localName`. */
+    child(localName: string): XmlElement | undefined;
+    /** The element reached by following child names along `path`; this element for an empty path. */
+    at(path: readonly string[]): XmlElement | undefined;
+    /** The trimmed text of the element at `path`, or `undefined` if it is missing or empty. */
+    textAt(path: readonly string[]): string | undefined;
+    /** The child elements called `localName`, in document order. */
+    childrenNamed(localName: string): XmlElement[];
+}
+/**
+ * Parses an XML document and returns its root element; throws `FormatError` if it is not well-formed, nests elements
+ * deeper than 256 levels or holds more than a million elements and attributes.
+ *
+ * A document type declaration is refused: bank data have none, and its entities could expand without limit.
+ */
+export declare function parseXml(xml: string): XmlElement;
+//# sourceMappingURL=xml.d.ts.map

package/dist/util/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/util/xml.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,UAAU;IAInB,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IANlD,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,CAAM;;IAG9C,yCAAyC;IAChC,SAAS,EAAE,MAAM;IAC1B,4FAA4F;IACnF,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAGlD,IAAI,aAAa,IAAI,UAAU,EAAE,CAEhC;IAED,iDAAiD;IACjD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAInD,kDAAkD;IAClD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIhD,iGAAiG;IACjG,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,SAAS;IAInD,2FAA2F;IAC3F,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS;IAInD,gEAAgE;IAChE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;CAG/C;AAiDD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CA8EhD"}