@coderoftime/fints 0.0.0-stage → 0.2.0

package/dist/util/xml.js

@@ -0,0 +1,194 @@
+import { FormatError } from './errors.js';
+import { characterReference, nonBlank } from './text.js';
+/**
+ * An element of a parsed XML document, looked up by local name: camt documents come with and without namespace
+ * prefixes.
+ */
+export class XmlElement {
+    localName;
+    attributes;
+    children = [];
+    constructor(
+    /** The name without namespace prefix. */
+    localName, 
+    /** The attributes by name without namespace prefix; namespace declarations are left out. */
+    attributes) {
+        this.localName = localName;
+        this.attributes = attributes;
+    }
+    get childElements() {
+        return this.children.filter((c) => c instanceof XmlElement);
+    }
+    /** The text of this element and all below it. */
+    get innerText() {
+        return this.children.map((c) => (c instanceof XmlElement ? c.innerText : c)).join('');
+    }
+    getAttribute(localName) {
+        return this.attributes.get(localName);
+    }
+    /** The first child element called `localName`. */
+    child(localName) {
+        return this.children.find((c) => c instanceof XmlElement && c.localName === localName);
+    }
+    /** The element reached by following child names along `path`; this element for an empty path. */
+    at(path) {
+        return path.reduce((element, name) => element?.child(name), this);
+    }
+    /** The trimmed text of the element at `path`, or `undefined` if it is missing or empty. */
+    textAt(path) {
+        return nonBlank(this.at(path)?.innerText);
+    }
+    /** The child elements called `localName`, in document order. */
+    childrenNamed(localName) {
+        return this.children.filter((c) => c instanceof XmlElement && c.localName === localName);
+    }
+}
+const namePattern = /[^\s<>/=!?"']+/y;
+const attributePattern = /\s+([^\s<>/=!?"']+)\s*=\s*(?:"([^"<]*)"|'([^'<]*)')/y;
+/** The match of the sticky `pattern` at `position` in `text`. */
+function matchAt(pattern, text, position) {
+    pattern.lastIndex = position;
+    return pattern.exec(text);
+}
+const predefinedEntities = new Map([
+    ['amp', '&'],
+    ['lt', '<'],
+    ['gt', '>'],
+    ['quot', '"'],
+    ['apos', "'"],
+]);
+/** Deepest nesting of elements the parser takes: camt needs fewer than 20 levels, and `innerText` recurses. */
+const maxDepth = 256;
+/**
+ * Most elements and attributes one document may hold. Real camt spends about 20 bytes on each, so the largest answer a
+ * bank can send holds fewer than 600,000, while a hostile document stays within about 150 MB of memory.
+ */
+const maxNodes = 1_000_000;
+const noAttributes = new Map();
+function localNameOf(qualified) {
+    const colon = qualified.indexOf(':');
+    return colon < 0 ? qualified : qualified.substring(colon + 1);
+}
+/** Resolves the character and predefined entity references in `text`; throws `FormatError` for any other. */
+function decodeEntities(text) {
+    return text.replace(/&([^;&\s]*);?/g, (match, name) => {
+        if (!match.endsWith(';'))
+            throw new FormatError('Invalid XML: unterminated entity reference');
+        if (name.startsWith('#')) {
+            const character = characterReference(name);
+            if (character === undefined)
+                throw new FormatError('Invalid XML character reference', match);
+            return character;
+        }
+        const value = predefinedEntities.get(name);
+        if (value === undefined)
+            throw new FormatError('Invalid XML: unknown entity', match);
+        return value;
+    });
+}
+/**
+ * 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 function parseXml(xml) {
+    let position = 0;
+    const stack = [];
+    let root;
+    let nodes = 0;
+    const fail = (reason) => {
+        throw new FormatError(`Invalid XML: ${reason} at position ${position}`);
+    };
+    const skipPast = (terminator, what) => {
+        const end = xml.indexOf(terminator, position);
+        if (end < 0)
+            fail(`unterminated ${what}`);
+        position = end + terminator.length;
+    };
+    while (position < xml.length) {
+        const lt = xml.indexOf('<', position);
+        const textEnd = lt < 0 ? xml.length : lt;
+        if (textEnd > position) {
+            const text = xml.substring(position, textEnd);
+            const parent = stack.at(-1);
+            if (parent)
+                parent.children.push(decodeEntities(text));
+            else if (text.trim() !== '')
+                fail('text outside the root element');
+            position = textEnd;
+            continue;
+        }
+        if (xml.startsWith('<?', position)) {
+            skipPast('?>', 'processing instruction');
+        }
+        else if (xml.startsWith('<!--', position)) {
+            skipPast('-->', 'comment');
+        }
+        else if (xml.startsWith('<![CDATA[', position)) {
+            const parent = stack.at(-1) ?? fail('CDATA outside the root element');
+            const start = position + 9;
+            skipPast(']]>', 'CDATA section');
+            parent.children.push(xml.substring(start, position - 3));
+        }
+        else if (xml.startsWith('<!', position)) {
+            fail('document type declarations are not supported');
+        }
+        else if (xml.startsWith('</', position)) {
+            position += 2;
+            const name = matchAt(namePattern, xml, position)?.[0] ?? fail('missing end tag name');
+            position += name.length;
+            while (/\s/.test(xml.charAt(position)))
+                position++;
+            if (xml.charAt(position) !== '>')
+                fail('malformed end tag');
+            position++;
+            const open = stack.pop();
+            if (open === undefined || open.localName !== localNameOf(name))
+                fail(`unexpected end tag ${name}`);
+        }
+        else {
+            if (stack.length >= maxDepth)
+                fail(`elements nested deeper than ${maxDepth} levels`);
+            if (++nodes > maxNodes)
+                fail(`more than ${maxNodes} elements and attributes`);
+            position++;
+            const name = matchAt(namePattern, xml, position)?.[0] ?? fail('missing element name');
+            position += name.length;
+            let attributes;
+            for (;;) {
+                const attribute = matchAt(attributePattern, xml, position);
+                if (!attribute)
+                    break;
+                position += attribute[0].length;
+                if (++nodes > maxNodes)
+                    fail(`more than ${maxNodes} elements and attributes`);
+                const attributeName = attribute[1];
+                if (attributeName !== 'xmlns' && !attributeName.startsWith('xmlns:')) {
+                    attributes ??= new Map();
+                    attributes.set(localNameOf(attributeName), decodeEntities(attribute[2] ?? attribute[3] ?? ''));
+                }
+            }
+            while (/\s/.test(xml.charAt(position)))
+                position++;
+            const selfClosing = xml.startsWith('/>', position);
+            if (!selfClosing && xml.charAt(position) !== '>')
+                fail(`malformed start tag ${name}`);
+            position += selfClosing ? 2 : 1;
+            const element = new XmlElement(localNameOf(name), attributes ?? noAttributes);
+            const parent = stack.at(-1);
+            if (parent)
+                parent.children.push(element);
+            else if (root)
+                fail('a second root element');
+            else
+                root = element;
+            if (!selfClosing)
+                stack.push(element);
+        }
+    }
+    if (stack.length > 0)
+        fail(`unclosed element ${stack.at(-1).localName}`);
+    return root ?? fail('no root element');
+}
+//# sourceMappingURL=xml.js.map

package/dist/util/xml.js.map

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

package/dist/v3/account-extension.d.ts

@@ -0,0 +1,25 @@
+import { AccountDataStatus, type Account } from '../core/account.js';
+import { Balance } from '../core/balance.js';
+/**
+ * The account extension of the user parameter data (HIUPD "Erweiterung, kontobezogen", Formals E.3.1): JSON with the
+ * BIC, the balance, and what the bank tells about the data it holds for the account.
+ */
+export declare class AccountExtension {
+    /** The BIC of the account, which spares the SEPA account list (Formals F.3.4). */
+    readonly bic: string | undefined;
+    /** What the bank tells about the account's data. */
+    readonly status: AccountDataStatus;
+    private readonly balance;
+    /** Whether `balance` holds all a balance query would deliver (`BalComplete`). */
+    private readonly balanceComplete;
+    private constructor();
+    /**
+     * Reads `json`; `undefined` if it is not a JSON object or any element is malformed, which voids the whole extension
+     * (Formals F.2, KF3).
+     */
+    static tryParse(json: string): AccountExtension | undefined;
+    private static read;
+    /** The balance of `account`, where the extension holds all a balance query would deliver (Formals F.3.2). */
+    completeBalance(account: Account): Balance | undefined;
+}
+//# sourceMappingURL=account-extension.d.ts.map

package/dist/v3/account-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-extension.d.ts","sourceRoot":"","sources":["../../src/v3/account-extension.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAyB7C;;;GAGG;AACH,qBAAa,gBAAgB;IAEzB,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAChC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,eAAe;IAPlC,OAAO;IAUP;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAU3D,OAAO,CAAC,MAAM,CAAC,IAAI;IAgBnB,6GAA6G;IAC7G,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;CAkBvD"}

package/dist/v3/account-extension.js

@@ -0,0 +1,173 @@
+// Internal to the package, and named after the FinTS specification. Documentation is where the meaning is not evident.
+import { AccountDataStatus } from '../core/account.js';
+import { Amount, withMark } from '../core/amount.js';
+import { Balance } from '../core/balance.js';
+import { parseFintsDate, parseUtcPlusOneDateTime } from '../util/dates.js';
+import { fail, FormatError } from '../util/errors.js';
+import { isJsonObject } from '../util/json.js';
+import { nonBlank } from '../util/text.js';
+/**
+ * The account extension of the user parameter data (HIUPD "Erweiterung, kontobezogen", Formals E.3.1): JSON with the
+ * BIC, the balance, and what the bank tells about the data it holds for the account.
+ */
+export class AccountExtension {
+    bic;
+    status;
+    balance;
+    balanceComplete;
+    constructor(
+    /** The BIC of the account, which spares the SEPA account list (Formals F.3.4). */
+    bic, 
+    /** What the bank tells about the account's data. */
+    status, balance, 
+    /** Whether `balance` holds all a balance query would deliver (`BalComplete`). */
+    balanceComplete) {
+        this.bic = bic;
+        this.status = status;
+        this.balance = balance;
+        this.balanceComplete = balanceComplete;
+    }
+    /**
+     * Reads `json`; `undefined` if it is not a JSON object or any element is malformed, which voids the whole extension
+     * (Formals F.2, KF3).
+     */
+    static tryParse(json) {
+        try {
+            const decoded = JSON.parse(json);
+            return isJsonObject(decoded) ? AccountExtension.read(new Json(decoded)) : undefined;
+        }
+        catch (error) {
+            if (error instanceof FormatError || error instanceof SyntaxError)
+                return undefined;
+            throw error;
+        }
+    }
+    static read(json) {
+        const balance = json.object('AcctBal');
+        const next = json.object('AcctStatNext');
+        return new AccountExtension(json.string('BIC'), new AccountDataStatus({
+            inventory: json.object('Inventory')?.strings ?? new Map(),
+            lastTransactions: json.string('umsltzt'),
+            nextTransactionsAt: next === undefined ? undefined : moment(next, '000000'),
+            transactionBalancesCurrent: json.flag('BalStatAcct') || json.flag('BalStatAct'),
+        }), balance === undefined ? undefined : readBalance(balance), json.flag('BalComplete'));
+    }
+    /** The balance of `account`, where the extension holds all a balance query would deliver (Formals F.3.2). */
+    completeBalance(account) {
+        const b = this.balance;
+        if (b === undefined || !this.balanceComplete)
+            return undefined;
+        return new Balance({
+            account,
+            productName: account.productName,
+            booked: b.booked.amount,
+            bookedAsOf: b.booked.date,
+            bookedAsOfTime: b.booked.time,
+            pending: b.pending?.amount,
+            creditLine: b.creditLine,
+            available: b.available,
+            used: b.used,
+            overdraft: b.overdraft,
+            bookingDate: b.bookingDate,
+            bookingTime: b.bookingTime,
+        });
+    }
+}
+function readBalance(json) {
+    const currency = json.string('Cur') ?? fail('Extension balance without currency');
+    const amount = (key) => {
+        const value = json.string(key);
+        return value === undefined ? undefined : Amount.parseDecimal(value, currency);
+    };
+    const saldo = (key) => {
+        const s = json.object(key);
+        if (s === undefined)
+            return undefined;
+        const value = s.string('Val') ?? fail('Extension balance without value');
+        return {
+            amount: withMark(Amount.parseDecimal(value, currency), s.string('DebCrd'), 'C', 'D'),
+            date: parseFintsDate(s.string('Date')) ?? fail('Extension balance without date'),
+            time: moment(s),
+        };
+    };
+    const bookTime = json.object('BookTime');
+    return {
+        booked: saldo('CurValBal') ?? fail('Extension balance without booked balance'),
+        pending: saldo('InclPendTransBal'),
+        creditLine: amount('OverdraftLim'),
+        available: amount('AvailFunds'),
+        used: amount('AlrdyDrwnOnBal'),
+        overdraft: amount('OverDraft'),
+        bookingDate: bookTime === undefined ? undefined : parseFintsDate(bookTime.string('Date')),
+        bookingTime: bookTime === undefined ? undefined : moment(bookTime),
+    };
+}
+/**
+ * The moment of `Date` and `Time` in `json`, which the extension states in UTC+01:00 all year round; `undefined`
+ * without a time, unless `defaultTime` stands in for it.
+ */
+function moment(json, defaultTime) {
+    const time = json.string('Time') ?? defaultTime;
+    if (time === undefined)
+        return undefined;
+    return parseUtcPlusOneDateTime(json.string('Date'), time) ?? fail('Extension date or time is malformed');
+}
+/**
+ * A JSON object of the extension, read by key without regard to case: the specification itself spells some keys
+ * differently (`OverDraftLim` and `OverdraftLim`). Values of the wrong type are a `FormatError`.
+ */
+class Json {
+    values = new Map();
+    constructor(values) {
+        for (const [key, value] of Object.entries(values))
+            this.values.set(key.toLowerCase(), value);
+    }
+    value(key) {
+        return this.values.get(key.toLowerCase());
+    }
+    /** A string, or a number written as string: dates and times come as either. */
+    string(key) {
+        const value = this.value(key);
+        if (value === undefined || value === null)
+            return undefined;
+        if (typeof value === 'string')
+            return nonBlank(value);
+        if (typeof value === 'number')
+            return String(value);
+        throw new FormatError(`Extension element "${key}" is not text`);
+    }
+    flag(key) {
+        const value = this.value(key);
+        if (value === undefined || value === null)
+            return false;
+        if (typeof value === 'boolean')
+            return value;
+        if (typeof value === 'string')
+            return value === 'J' || value.toLowerCase() === 'true';
+        throw new FormatError(`Extension element "${key}" is not a flag`);
+    }
+    object(key) {
+        const value = this.value(key);
+        if (value === undefined || value === null)
+            return undefined;
+        if (isJsonObject(value))
+            return new Json(value);
+        throw new FormatError(`Extension element "${key}" is not an object`);
+    }
+    /** The object's values as strings, keyed in capitals, as segment IDs are written. */
+    get strings() {
+        const result = new Map();
+        for (const [key, value] of this.values) {
+            if (value === null)
+                result.set(key.toUpperCase(), '');
+            else if (typeof value === 'string')
+                result.set(key.toUpperCase(), value);
+            else if (typeof value === 'number')
+                result.set(key.toUpperCase(), String(value));
+            else
+                throw new FormatError(`Extension element "${key}" is not text`);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=account-extension.js.map

package/dist/v3/account-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-extension.js","sourceRoot":"","sources":["../../src/v3/account-extension.ts"],"names":[],"mappings":"AAAA,uHAAuH;AAEvH,OAAO,EAAE,iBAAiB,EAAgB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAqB3C;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAGhB;IAEA;IACQ;IAEA;IAPnB;IACE,kFAAkF;IACzE,GAAuB;IAChC,oDAAoD;IAC3C,MAAyB,EACjB,OAAmC;IACpD,iFAAiF;IAChE,eAAwB;QALhC,QAAG,GAAH,GAAG,CAAoB;QAEvB,WAAM,GAAN,MAAM,CAAmB;QACjB,YAAO,GAAP,OAAO,CAA4B;QAEnC,oBAAe,GAAf,eAAe,CAAS;IACxC,CAAC;IAEJ;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,IAAI,CAAC;YACH,MAAM,OAAO,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,YAAY,WAAW;gBAAE,OAAO,SAAS,CAAC;YACnF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,IAAI,CAAC,IAAU;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACzC,OAAO,IAAI,gBAAgB,CACzB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAClB,IAAI,iBAAiB,CAAC;YACpB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,IAAI,IAAI,GAAG,EAAE;YACzD,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YACxC,kBAAkB,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;YAC3E,0BAA0B,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;SAChF,CAAC,EACF,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,EACxD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CACzB,CAAC;IACJ,CAAC;IAED,6GAA6G;IAC7G,eAAe,CAAC,OAAgB;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,SAAS,CAAC;QAC/D,OAAO,IAAI,OAAO,CAAC;YACjB,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;YACvB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;YACzB,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;YAC7B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM;YAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,WAAW,CAAC,IAAU;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,CAAC,GAAW,EAAsB,EAAE;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChF,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,GAAW,EAAqB,EAAE;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACtC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACzE,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC;YACpF,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,gCAAgC,CAAC;YAChF,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;SAChB,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,0CAA0C,CAAC;QAC9E,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC,cAAc,CAAC;QAClC,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QAC9B,WAAW,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzF,WAAW,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;KACnE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,MAAM,CAAC,IAAU,EAAE,WAAoB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC;IAChD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,qCAAqC,CAAC,CAAC;AAC3G,CAAC;AAED;;;GAGG;AACH,MAAM,IAAI;IACS,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;IAErD,YAAY,MAA+B;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/F,CAAC;IAEO,KAAK,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,+EAA+E;IAC/E,MAAM,CAAC,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,IAAI,WAAW,CAAC,sBAAsB,GAAG,eAAe,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,GAAW;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACxD,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;QACtF,MAAM,IAAI,WAAW,CAAC,sBAAsB,GAAG,iBAAiB,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5D,IAAI,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,IAAI,WAAW,CAAC,sBAAsB,GAAG,oBAAoB,CAAC,CAAC;IACvE,CAAC;IAED,qFAAqF;IACrF,IAAI,OAAO;QACT,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvC,IAAI,KAAK,KAAK,IAAI;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;iBACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;iBACpE,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;;gBAC5E,MAAM,IAAI,WAAW,CAAC,sBAAsB,GAAG,eAAe,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/v3/bank-connection.d.ts

@@ -0,0 +1,34 @@
+import type { MessageDirection, MessageLogger } from '../core/client.js';
+import { type FinTsTransport } from '../core/transport.js';
+/**
+ * Throws `FinTsProtocolError` if a message of `size` bytes exceeds the bank's `limit` in kilobytes (1024 bytes): the
+ * specification does not allow to send such a message.
+ */
+export declare function checkMessageSize(size: number, limit: number | undefined): void;
+/** The bank's FinTS endpoint: posts messages there and reports them to the logger. */
+export declare class BankConnection {
+    private readonly logger;
+    private readonly transport;
+    /** Where the messages go, as `FinTsConfig` checked it. */
+    private readonly href;
+    /** Aborts the requests on their way (`abortRequests`). */
+    private requests;
+    /** A connection to `url` through `transport`, an `HttpTransport` by default. */
+    constructor(url: URL, transport: FinTsTransport | undefined, logger: MessageLogger | undefined);
+    /**
+     * Posts `body` to a new copy of the URL, so that a transport that changes the one it is given changes no later
+     * request.
+     *
+     * Reports any failure of the transport as `FinTsTransportError`: a custom transport that calls `fetch` fails with a
+     * `TypeError` where the network does, and one that throws another `FinTsError`, such as `FinTsPinError`, would pass
+     * for an answer of the bank. Of such an error only the message is kept (`failureMessage`), since it may hold `body`,
+     * as the errors of HTTP clients such as axios do.
+     */
+    post(body: Uint8Array, contentType: string): Promise<Uint8Array>;
+    /** Reports a message to the logger; `message` is only built when a logger is set. */
+    log(direction: MessageDirection, message: () => string): void;
+    /** Aborts the requests on their way; those posted afterwards, such as the dialog ends of a closing client, go out. */
+    abortRequests(): void;
+    close(): void;
+}
+//# sourceMappingURL=bank-connection.d.ts.map

package/dist/v3/bank-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-connection.d.ts","sourceRoot":"","sources":["../../src/v3/bank-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAiC,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE1F;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI9E;AAED,sFAAsF;AACtF,qBAAa,cAAc;IAavB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAE3C,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAyB;IAEzC,gFAAgF;gBAE9E,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,cAAc,GAAG,SAAS,EACpB,MAAM,EAAE,aAAa,GAAG,SAAS;IAMpD;;;;;;;;OAQG;IACG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAStE,qFAAqF;IACrF,GAAG,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,MAAM,GAAG,IAAI;IAI7D,sHAAsH;IACtH,aAAa,IAAI,IAAI;IAKrB,KAAK,IAAI,IAAI;CAGd"}

package/dist/v3/bank-connection.js

@@ -0,0 +1,58 @@
+import { FinTsProtocolError, FinTsTransportError } from '../core/errors.js';
+import { failureMessage, HttpTransport } from '../core/transport.js';
+/**
+ * Throws `FinTsProtocolError` if a message of `size` bytes exceeds the bank's `limit` in kilobytes (1024 bytes): the
+ * specification does not allow to send such a message.
+ */
+export function checkMessageSize(size, limit) {
+    if (limit !== undefined && limit > 0 && size > limit * 1024) {
+        throw new FinTsProtocolError(`A message of ${size} bytes exceeds the bank's maximum message size of ${limit} KB`);
+    }
+}
+/** The bank's FinTS endpoint: posts messages there and reports them to the logger. */
+export class BankConnection {
+    logger;
+    transport;
+    /** Where the messages go, as `FinTsConfig` checked it. */
+    href;
+    /** Aborts the requests on their way (`abortRequests`). */
+    requests = new AbortController();
+    /** A connection to `url` through `transport`, an `HttpTransport` by default. */
+    constructor(url, transport, logger) {
+        this.logger = logger;
+        this.href = url.href;
+        this.transport = transport ?? new HttpTransport();
+    }
+    /**
+     * Posts `body` to a new copy of the URL, so that a transport that changes the one it is given changes no later
+     * request.
+     *
+     * Reports any failure of the transport as `FinTsTransportError`: a custom transport that calls `fetch` fails with a
+     * `TypeError` where the network does, and one that throws another `FinTsError`, such as `FinTsPinError`, would pass
+     * for an answer of the bank. Of such an error only the message is kept (`failureMessage`), since it may hold `body`,
+     * as the errors of HTTP clients such as axios do.
+     */
+    async post(body, contentType) {
+        try {
+            return await this.transport.post(new URL(this.href), body, contentType, this.requests.signal);
+        }
+        catch (error) {
+            if (error instanceof FinTsTransportError)
+                throw error;
+            throw new FinTsTransportError(failureMessage(error));
+        }
+    }
+    /** Reports a message to the logger; `message` is only built when a logger is set. */
+    log(direction, message) {
+        this.logger?.(direction, message());
+    }
+    /** Aborts the requests on their way; those posted afterwards, such as the dialog ends of a closing client, go out. */
+    abortRequests() {
+        this.requests.abort();
+        this.requests = new AbortController();
+    }
+    close() {
+        this.transport.close();
+    }
+}
+//# sourceMappingURL=bank-connection.js.map

package/dist/v3/bank-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-connection.js","sourceRoot":"","sources":["../../src/v3/bank-connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAuB,MAAM,sBAAsB,CAAC;AAE1F;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAyB;IACtE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC;QAC5D,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,IAAI,qDAAqD,KAAK,KAAK,CAAC,CAAC;IACpH,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,OAAO,cAAc;IAaN;IAZF,SAAS,CAAiB;IAE3C,0DAA0D;IACzC,IAAI,CAAS;IAE9B,0DAA0D;IAClD,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,gFAAgF;IAChF,YACE,GAAQ,EACR,SAAqC,EACpB,MAAiC;QAAjC,WAAM,GAAN,MAAM,CAA2B;QAElD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,IAAI,aAAa,EAAE,CAAC;IACpD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAC,IAAgB,EAAE,WAAmB;QAC9C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB;gBAAE,MAAM,KAAK,CAAC;YACtD,MAAM,IAAI,mBAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,GAAG,CAAC,SAA2B,EAAE,OAAqB;QACpD,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,sHAAsH;IACtH,aAAa;QACX,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/v3/dialog.d.ts

@@ -0,0 +1,112 @@
+import { TanChallenge } from '../tan/challenge.js';
+import { TanMethod } from '../tan/tan-models.js';
+import { IncomingMessage3 } from './message.js';
+import type { FinTs3Protocol } from './protocol.js';
+import type { SegmentSpec } from './syntax.js';
+/** The bank's request to approve a message with a TAN or in a banking app; `R` is the bank's answer. */
+export interface Approval<R> {
+    /** What the user is asked. */
+    readonly challenge: TanChallenge;
+    /** Sends the TAN the user entered. */
+    readonly submitTan: (tan: string) => Promise<R>;
+    /** Asks the bank whether the user has approved in the banking app. */
+    readonly checkStatus: () => Promise<R>;
+    /**
+     * Whether the bank announces a push message for once the user has approved (return code 3957), before which the
+     * status must not be asked. The client has no push channel, so the user reports the approval instead.
+     */
+    readonly waitForPush: boolean;
+    /** The new instructions a status answer gives the user (return code 3956); `undefined` where it gives none. */
+    readonly instructionsIn: (response: R) => string | undefined;
+}
+/**
+ * One FinTS 3.0 dialog: numbered messages under the dialog ID the bank assigns in its first answer, signed with a TAN
+ * method and medium, and the approvals the bank asks for. The `FinTs3Protocol` builds the messages and signs them.
+ */
+export declare class FinTs3Dialog {
+    private readonly protocol;
+    readonly method: TanMethod;
+    /** The TAN medium the messages name, where the method takes one. */
+    readonly tanMedium: string | undefined;
+    private readonly anonymous;
+    private systemId;
+    private id;
+    private messageNumber;
+    private ended;
+    /** When the bank last answered without rejecting the whole message, which shows it still knows the dialog. */
+    private lastAnswer;
+    private constructor();
+    static signed(protocol: FinTs3Protocol, method: TanMethod, tanMedium?: string): FinTs3Dialog;
+    /** A dialog without login, which only delivers the bank parameter data. */
+    static anonymous(protocol: FinTs3Protocol): FinTs3Dialog;
+    /** Whether the bank knows this dialog and it has not ended. */
+    get isActive(): boolean;
+    /**
+     * Whether the dialog has ended, on either side.
+     *
+     * The bank ends a dialog idle for longer than its maximum timeout (HIBPA, Formals C.9), or five minutes where it
+     * states none. Such a dialog is neither used nor ended again: the bank would refuse any message in it.
+     */
+    private get hasEnded();
+    private get idleTooLong();
+    /** Whether the messages are signed with a two-step TAN method, so that the bank may ask for approvals. */
+    private get isTwoStep();
+    /** The version of the HKTAN segments: that of the HITANS segment the bank describes the method in. */
+    private get tanVersion();
+    /** Opens the dialog; with `synchronize` the bank also assigns a customer system ID. */
+    start(synchronize?: boolean): Promise<IncomingMessage3>;
+    /**
+     * The messages that open the dialog and send `order` while no TAN medium is chosen yet, as for listing the media:
+     * `login` opens the dialog, asking strong authentication for `order` with a two-step method, and `order` sends the
+     * order in a message of its own.
+     */
+    startWith(order: SegmentSpec): {
+        readonly login: () => Promise<IncomingMessage3>;
+        readonly order: () => Promise<IncomingMessage3>;
+    };
+    /**
+     * Opens the anonymous dialog; the answer carries the bank parameter data.
+     *
+     * With `announceSca` the message also carries HKTAN, the way a client that can do strong customer authentication
+     * tells the bank so, whereupon the bank may send parameter data suited to it (PIN/TAN, B.4.3.1).
+     */
+    requestBankParameters(announceSca?: boolean): Promise<IncomingMessage3>;
+    /** Sends `order`, asking for strong customer authentication where the bank requires it. */
+    send(order: SegmentSpec): Promise<IncomingMessage3>;
+    /**
+     * Ends the dialog at the bank and returns the answer; `undefined` if the dialog is not active or the end failed.
+     *
+     * Bank and connection errors are ignored, since the bank may have ended the dialog on its side already.
+     */
+    end(): Promise<IncomingMessage3 | undefined>;
+    /** Forgets the dialog without contacting the bank, for example after the bank rejected the PIN. */
+    discard(): void;
+    /**
+     * The approval `response`, the dialog's latest answer, asks for with return code 0030 (TAN) or 3955 (banking app):
+     * HITAN of process 4, answered with HKTAN process 2 (TAN) or S (status); `undefined` if it asks for none, or carries
+     * only the dummy challenge of a message the bank exempts from strong authentication.
+     *
+     * The bank has not executed the message then, so a request without a challenge is a `FinTsProtocolError`: read as
+     * done, it would report an empty result. So is an app approval with a method of HITANS #6: the status request
+     * (process S) came with version 7, along with app approvals (PIN/TAN B.5.2).
+     */
+    approvalAskedIn(response: IncomingMessage3): Approval<IncomingMessage3> | undefined;
+    private tanRequest;
+    /**
+     * Sends `segments`, with `tan` where they complete an approval, as the next message, and reads the bank's answer. The
+     * message counts once the bank has answered, whatever it answered.
+     *
+     * The bank assigns the dialog ID in its answer to the first message, so the answer to another user's first message
+     * passes for it (`ParameterStore.reportedUpdVersion`). Any other answer to another message fails with
+     * `FinTsProtocolError` before anything of it is kept: a relay or proxy that mixes up answers would hand the client
+     * another user's data, or a page of another query.
+     *
+     * The dialog ends on the client's side, without a dialog end, where it is over for the bank: after a return code that
+     * ends it, such as 9800, and after a rejected opening message (Formals C.1.2), or a broken connection (C.6).
+     *
+     * Only an answer that does not reject the whole message starts the idle time anew (`hasEnded`): a rejection may come
+     * from a bank that has ended the dialog without saying so.
+     */
+    private sendSegments;
+}
+//# sourceMappingURL=dialog.d.ts.map

package/dist/v3/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/v3/dialog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiB/C,wGAAwG;AACxG,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IAEjC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhD,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B,+GAA+G;IAC/G,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9D;AAED;;;GAGG;AACH,qBAAa,YAAY;IAUrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAb5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAS;IAEtB,8GAA8G;IAC9G,OAAO,CAAC,UAAU,CAAqB;IAEvC,OAAO;IAUP,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY;IAI5F,2EAA2E;IAC3E,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,YAAY;IAIxD,+DAA+D;IAC/D,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,WAAW,GAMtB;IAED,0GAA0G;IAC1G,OAAO,KAAK,SAAS,GAEpB;IAED,sGAAsG;IACtG,OAAO,KAAK,UAAU,GAErB;IAED,uFAAuF;IACvF,KAAK,CAAC,WAAW,UAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASrD;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG;QAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;KACjD;IAWD;;;;;OAKG;IACH,qBAAqB,CAAC,WAAW,UAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOrE,2FAA2F;IAC3F,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAMnD;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAWlD,mGAAmG;IACnG,OAAO,IAAI,IAAI;IAIf;;;;;;;;OAQG;IACH,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,GAAG,SAAS;IA8BnF,OAAO,CAAC,UAAU;IASlB;;;;;;;;;;;;;;OAcG;YACW,YAAY;CA4B3B"}