@coderoftime/fints 0.0.0-stage → 0.1.0

package/dist/tan/tan-models.d.ts

@@ -0,0 +1,145 @@
+/** Whether a TAN method needs the name of a TAN medium. */
+export type TanMediumRequirement = 
+/** The method takes no medium name. */
+'notAllowed'
+/** The method takes a medium name but works without one. */
+ | 'optional'
+/** The method needs the name of the medium. */
+ | 'required';
+/** Reads the FinTS code: `0` not allowed, `1` optional, `2` required. */
+export declare function tanMediumRequirementOf(code: string | undefined): TanMediumRequirement;
+/** What `TanMethod` takes; the bank states the details it knows. */
+export interface TanMethodInit {
+    securityFunction: string;
+    name: string;
+    technicalId?: string | undefined;
+    dkMethod?: string | undefined;
+    dkVersion?: string | undefined;
+    maxTanLength?: number | undefined;
+    numericTan?: boolean;
+    returnValueText?: string | undefined;
+    maxChallengeLength?: number | undefined;
+    mediumRequirement?: TanMediumRequirement;
+    activeMediaCount?: number | undefined;
+    structuredChallenge?: boolean;
+    decoupled?: boolean;
+    decoupledMaxPolls?: number | undefined;
+    decoupledFirstPollDelaySeconds?: number | undefined;
+    decoupledPollIntervalSeconds?: number | undefined;
+    decoupledManualConfirmation?: boolean;
+    decoupledAutomaticPolling?: boolean;
+}
+/** A TAN procedure offered by the bank (FinTS "Sicherheitsfunktion"). */
+export declare class TanMethod {
+    /** Bank-specific code of the procedure, for example `942`; `999` is the one-step procedure. */
+    readonly securityFunction: string;
+    /** The name the bank gives the procedure, for example `pushTAN`. */
+    readonly name: string;
+    /** The bank's technical identification of the procedure. */
+    readonly technicalId: string | undefined;
+    /** DK procedure family such as `HHD1.4`, `mobileTAN` or `Decoupled`. */
+    readonly dkMethod: string | undefined;
+    /** Version of the `dkMethod`. */
+    readonly dkVersion: string | undefined;
+    /** Longest TAN the user may enter. */
+    readonly maxTanLength: number | undefined;
+    /** Whether the TAN consists of digits only. */
+    readonly numericTan: boolean;
+    /** The bank's label for the value the user sends back, for example `TAN`. */
+    readonly returnValueText: string | undefined;
+    /** Longest challenge text the bank sends for this procedure. */
+    readonly maxChallengeLength: number | undefined;
+    /** Whether a TAN medium name goes with this procedure. */
+    readonly mediumRequirement: TanMediumRequirement;
+    /**
+     * Most TAN media a user can have active at once for this procedure, as the bank's parameters state it ("Anzahl
+     * unterstützter aktiver TAN-Medien"); not how many the user has.
+     *
+     * Where it is above 1 and `needsMediumName`, each message names the medium, since the user may have several.
+     */
+    readonly activeMediaCount: number | undefined;
+    /** Whether the challenge text is structured (marked up) rather than plain. */
+    readonly structuredChallenge: boolean;
+    /** Whether approval happens in a separate app instead of entering a TAN. */
+    readonly decoupled: boolean;
+    /** Most status requests the bank allows for a decoupled approval; 0 allows any number. */
+    readonly decoupledMaxPolls: number | undefined;
+    /** How long to wait before the first status request of a decoupled approval, in seconds. */
+    readonly decoupledFirstPollDelaySeconds: number | undefined;
+    /** How long to wait between two status requests of a decoupled approval, in seconds. */
+    readonly decoupledPollIntervalSeconds: number | undefined;
+    /** Whether the user may report the approval, rather than the client asking the bank by itself. */
+    readonly decoupledManualConfirmation: boolean;
+    /** Whether the bank allows the client to ask for the approval by itself. */
+    readonly decoupledAutomaticPolling: boolean;
+    constructor(init: TanMethodInit);
+    /** The one-step procedure (PIN only, no TAN). */
+    static readonly oneStep: TanMethod;
+    /** Whether this is the one-step procedure. */
+    get isOneStep(): boolean;
+    /** Whether the bank needs the name of a TAN medium for this procedure. */
+    get needsMediumName(): boolean;
+    toString(): string;
+}
+/** State of a TAN medium as reported by the bank. */
+export type TanMediumStatus = 
+/** The medium is in use. */
+'active'
+/** The medium can be used but is not the active one. */
+ | 'available'
+/** The medium is the active follow-up card. */
+ | 'activeFollowUpCard'
+/** The medium is an available follow-up card. */
+ | 'availableFollowUpCard'
+/** The bank states no status, or one that is not known. */
+ | 'unknown';
+/** Reads the FinTS code `1` to `4`. */
+export declare function tanMediumStatusOf(code: string | undefined): TanMediumStatus;
+/** What `TanMedium` takes; the bank states the details it knows. */
+export interface TanMediumInit {
+    mediumClass: string;
+    status: TanMediumStatus;
+    name?: string | undefined;
+    securityFunction?: string | undefined;
+    cardNumber?: string | undefined;
+    cardSequenceNumber?: string | undefined;
+    mobileNumber?: string | undefined;
+    mobileNumberMasked?: string | undefined;
+    validFrom?: Date | undefined;
+    validUntil?: Date | undefined;
+    lastUsed?: Date | undefined;
+    activatedOn?: Date | undefined;
+}
+/** A TAN device registered for the user, such as a phone or TAN generator. */
+export declare class TanMedium {
+    /** `G` TAN generator, `M` mobile phone, `L` TAN list, `S` secoder, `B` bilateral. */
+    readonly mediumClass: string;
+    /** Whether the medium is in use. */
+    readonly status: TanMediumStatus;
+    /** The name the medium is registered under; this is what the bank wants back to pick the medium. */
+    readonly name: string | undefined;
+    /** The TAN procedure the medium belongs to (HITAB version 5). */
+    readonly securityFunction: string | undefined;
+    /** Card number of a TAN generator. */
+    readonly cardNumber: string | undefined;
+    /** Sequence number of the card of a TAN generator. */
+    readonly cardSequenceNumber: string | undefined;
+    /** Phone number of a mobile phone medium, if the bank states it in full. */
+    readonly mobileNumber: string | undefined;
+    /** Phone number with the middle digits hidden. */
+    readonly mobileNumberMasked: string | undefined;
+    /** The medium is valid from this date. */
+    readonly validFrom: Date | undefined;
+    /** The medium is valid until this date. */
+    readonly validUntil: Date | undefined;
+    /** When the medium was used last. */
+    readonly lastUsed: Date | undefined;
+    /** When the medium was activated. */
+    readonly activatedOn: Date | undefined;
+    constructor(init: TanMediumInit);
+    /** Whether the medium is the one in use. */
+    get isActive(): boolean;
+    /** The name, or the last digits of the card number, so that logs and crash reports do not collect the number. */
+    toString(): string;
+}
+//# sourceMappingURL=tan-models.d.ts.map

package/dist/tan/tan-models.d.ts.map

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

package/dist/tan/tan-models.js

@@ -0,0 +1,148 @@
+import { maskedId } from '../util/text.js';
+/** Reads the FinTS code: `0` not allowed, `1` optional, `2` required. */
+export function tanMediumRequirementOf(code) {
+    return code === '1' ? 'optional' : code === '2' ? 'required' : 'notAllowed';
+}
+/** A TAN procedure offered by the bank (FinTS "Sicherheitsfunktion"). */
+export class TanMethod {
+    /** Bank-specific code of the procedure, for example `942`; `999` is the one-step procedure. */
+    securityFunction;
+    /** The name the bank gives the procedure, for example `pushTAN`. */
+    name;
+    /** The bank's technical identification of the procedure. */
+    technicalId;
+    /** DK procedure family such as `HHD1.4`, `mobileTAN` or `Decoupled`. */
+    dkMethod;
+    /** Version of the `dkMethod`. */
+    dkVersion;
+    /** Longest TAN the user may enter. */
+    maxTanLength;
+    /** Whether the TAN consists of digits only. */
+    numericTan;
+    /** The bank's label for the value the user sends back, for example `TAN`. */
+    returnValueText;
+    /** Longest challenge text the bank sends for this procedure. */
+    maxChallengeLength;
+    /** Whether a TAN medium name goes with this procedure. */
+    mediumRequirement;
+    /**
+     * Most TAN media a user can have active at once for this procedure, as the bank's parameters state it ("Anzahl
+     * unterstützter aktiver TAN-Medien"); not how many the user has.
+     *
+     * Where it is above 1 and `needsMediumName`, each message names the medium, since the user may have several.
+     */
+    activeMediaCount;
+    /** Whether the challenge text is structured (marked up) rather than plain. */
+    structuredChallenge;
+    /** Whether approval happens in a separate app instead of entering a TAN. */
+    decoupled;
+    /** Most status requests the bank allows for a decoupled approval; 0 allows any number. */
+    decoupledMaxPolls;
+    /** How long to wait before the first status request of a decoupled approval, in seconds. */
+    decoupledFirstPollDelaySeconds;
+    /** How long to wait between two status requests of a decoupled approval, in seconds. */
+    decoupledPollIntervalSeconds;
+    /** Whether the user may report the approval, rather than the client asking the bank by itself. */
+    decoupledManualConfirmation;
+    /** Whether the bank allows the client to ask for the approval by itself. */
+    decoupledAutomaticPolling;
+    constructor(init) {
+        this.securityFunction = init.securityFunction;
+        this.name = init.name;
+        this.technicalId = init.technicalId;
+        this.dkMethod = init.dkMethod;
+        this.dkVersion = init.dkVersion;
+        this.maxTanLength = init.maxTanLength;
+        this.numericTan = init.numericTan ?? true;
+        this.returnValueText = init.returnValueText;
+        this.maxChallengeLength = init.maxChallengeLength;
+        this.mediumRequirement = init.mediumRequirement ?? 'notAllowed';
+        this.activeMediaCount = init.activeMediaCount;
+        this.structuredChallenge = init.structuredChallenge ?? false;
+        this.decoupled = init.decoupled ?? false;
+        this.decoupledMaxPolls = init.decoupledMaxPolls;
+        this.decoupledFirstPollDelaySeconds = init.decoupledFirstPollDelaySeconds;
+        this.decoupledPollIntervalSeconds = init.decoupledPollIntervalSeconds;
+        this.decoupledManualConfirmation = init.decoupledManualConfirmation ?? true;
+        this.decoupledAutomaticPolling = init.decoupledAutomaticPolling ?? true;
+    }
+    /** The one-step procedure (PIN only, no TAN). */
+    static oneStep = new TanMethod({ securityFunction: '999', name: 'One-step (PIN only)' });
+    /** Whether this is the one-step procedure. */
+    get isOneStep() {
+        return this.securityFunction === TanMethod.oneStep.securityFunction;
+    }
+    /** Whether the bank needs the name of a TAN medium for this procedure. */
+    get needsMediumName() {
+        return this.mediumRequirement === 'required';
+    }
+    toString() {
+        return `TanMethod(${this.securityFunction}, ${this.name})`;
+    }
+}
+/** Reads the FinTS code `1` to `4`. */
+export function tanMediumStatusOf(code) {
+    switch (code) {
+        case '1':
+            return 'active';
+        case '2':
+            return 'available';
+        case '3':
+            return 'activeFollowUpCard';
+        case '4':
+            return 'availableFollowUpCard';
+        default:
+            return 'unknown';
+    }
+}
+/** A TAN device registered for the user, such as a phone or TAN generator. */
+export class TanMedium {
+    /** `G` TAN generator, `M` mobile phone, `L` TAN list, `S` secoder, `B` bilateral. */
+    mediumClass;
+    /** Whether the medium is in use. */
+    status;
+    /** The name the medium is registered under; this is what the bank wants back to pick the medium. */
+    name;
+    /** The TAN procedure the medium belongs to (HITAB version 5). */
+    securityFunction;
+    /** Card number of a TAN generator. */
+    cardNumber;
+    /** Sequence number of the card of a TAN generator. */
+    cardSequenceNumber;
+    /** Phone number of a mobile phone medium, if the bank states it in full. */
+    mobileNumber;
+    /** Phone number with the middle digits hidden. */
+    mobileNumberMasked;
+    /** The medium is valid from this date. */
+    validFrom;
+    /** The medium is valid until this date. */
+    validUntil;
+    /** When the medium was used last. */
+    lastUsed;
+    /** When the medium was activated. */
+    activatedOn;
+    constructor(init) {
+        this.mediumClass = init.mediumClass;
+        this.status = init.status;
+        this.name = init.name;
+        this.securityFunction = init.securityFunction;
+        this.cardNumber = init.cardNumber;
+        this.cardSequenceNumber = init.cardSequenceNumber;
+        this.mobileNumber = init.mobileNumber;
+        this.mobileNumberMasked = init.mobileNumberMasked;
+        this.validFrom = init.validFrom;
+        this.validUntil = init.validUntil;
+        this.lastUsed = init.lastUsed;
+        this.activatedOn = init.activatedOn;
+    }
+    /** Whether the medium is the one in use. */
+    get isActive() {
+        return this.status === 'active' || this.status === 'activeFollowUpCard';
+    }
+    /** The name, or the last digits of the card number, so that logs and crash reports do not collect the number. */
+    toString() {
+        const label = this.name ?? (this.cardNumber === undefined ? this.mediumClass : maskedId(this.cardNumber));
+        return `TanMedium(${label}, ${this.status})`;
+    }
+}
+//# sourceMappingURL=tan-models.js.map

package/dist/tan/tan-models.js.map

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

package/dist/util/async.d.ts

@@ -0,0 +1,24 @@
+/** A promise with its resolve and reject functions, which tells whether it has settled. */
+export declare class Deferred<T> {
+    readonly promise: Promise<T>;
+    private resolveFn;
+    private rejectFn;
+    private settled;
+    constructor();
+    get isCompleted(): boolean;
+    resolve(value: T): void;
+    reject(error: unknown): void;
+}
+/**
+ * Runs asynchronous actions one after another, in the order they were submitted.
+ *
+ * A failing action does not stop the ones queued after it.
+ */
+export declare class SerialExecutor {
+    private last;
+    /** Runs `action` once the actions submitted before have finished; the result is that of `action`. */
+    run<T>(action: () => Promise<T>): Promise<T>;
+}
+/** Waits for `promise` and ignores its result, so that neither a value nor an error goes unhandled. */
+export declare function ignoreOutcome(promise: Promise<unknown>): void;
+//# sourceMappingURL=async.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/util/async.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,qBAAa,QAAQ,CAAC,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,OAAO,CAAS;;IAWxB,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAMvB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;CAK7B;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAuC;IAEnD,qGAAqG;IACrG,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAK7C;AAED,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAE7D"}

package/dist/util/async.js

@@ -0,0 +1,49 @@
+/** A promise with its resolve and reject functions, which tells whether it has settled. */
+export class Deferred {
+    promise;
+    resolveFn;
+    rejectFn;
+    settled = false;
+    constructor() {
+        this.promise = new Promise((resolve, reject) => {
+            this.resolveFn = resolve;
+            this.rejectFn = reject;
+        });
+        // A rejection nobody waits for is not an unhandled one: whoever awaits the promise still gets it.
+        this.promise.catch(() => undefined);
+    }
+    get isCompleted() {
+        return this.settled;
+    }
+    resolve(value) {
+        if (this.settled)
+            return;
+        this.settled = true;
+        this.resolveFn(value);
+    }
+    reject(error) {
+        if (this.settled)
+            return;
+        this.settled = true;
+        this.rejectFn(error);
+    }
+}
+/**
+ * Runs asynchronous actions one after another, in the order they were submitted.
+ *
+ * A failing action does not stop the ones queued after it.
+ */
+export class SerialExecutor {
+    last = Promise.resolve();
+    /** Runs `action` once the actions submitted before have finished; the result is that of `action`. */
+    run(action) {
+        const result = this.last.then(action);
+        this.last = result.catch(() => undefined);
+        return result;
+    }
+}
+/** Waits for `promise` and ignores its result, so that neither a value nor an error goes unhandled. */
+export function ignoreOutcome(promise) {
+    promise.catch(() => undefined);
+}
+//# sourceMappingURL=async.js.map

package/dist/util/async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.js","sourceRoot":"","sources":["../../src/util/async.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,OAAO,QAAQ;IACV,OAAO,CAAa;IACrB,SAAS,CAAsB;IAC/B,QAAQ,CAA4B;IACpC,OAAO,GAAG,KAAK,CAAC;IAExB;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAChD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;YACzB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,kGAAkG;QAClG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,KAAQ;QACd,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,KAAc;QACnB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACjB,IAAI,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEnD,qGAAqG;IACrG,GAAG,CAAI,MAAwB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,uGAAuG;AACvG,MAAM,UAAU,aAAa,CAAC,OAAyB;IACrD,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/util/bytes.d.ts

@@ -0,0 +1,23 @@
+/** The `parts` joined into one array. */
+export declare function concatBytes(parts: readonly Uint8Array[]): Uint8Array;
+/** Collects bytes, like a growing buffer. */
+export declare class BytesBuilder {
+    private readonly parts;
+    private size;
+    get length(): number;
+    add(bytes: Uint8Array | readonly number[]): void;
+    addByte(byte: number): void;
+    takeBytes(): Uint8Array;
+}
+/** ISO 8859-1 bytes of `text`, which must contain no character beyond U+00FF. */
+export declare function latin1Encode(text: string): Uint8Array;
+/** The text of ISO 8859-1 `bytes`. */
+export declare function latin1Decode(bytes: Uint8Array): string;
+export declare function utf8Encode(text: string): Uint8Array;
+/** Decodes UTF-8; throws `FormatError` for malformed data unless `allowMalformed`. */
+export declare function utf8Decode(bytes: Uint8Array, allowMalformed?: boolean): string;
+export declare function base64Encode(bytes: Uint8Array): string;
+/** Decodes base64, in the standard or the URL-safe alphabet; throws `FormatError` if `text` is not base64. */
+export declare function base64Decode(text: string): Uint8Array;
+export declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+//# sourceMappingURL=bytes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../src/util/bytes.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,CAUpE;AAED,6CAA6C;AAC7C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,IAAI,CAAK;IAEjB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI;IAMhD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,SAAS,IAAI,UAAU;CAMxB;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAIrD;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAOtD;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEnD;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,cAAc,UAAQ,GAAG,MAAM,CAM5E;AAYD,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAoBtD;AAED,8GAA8G;AAC9G,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAqBrD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAIhE"}

package/dist/util/bytes.js

@@ -0,0 +1,136 @@
+import { FormatError } from './errors.js';
+/** The `parts` joined into one array. */
+export function concatBytes(parts) {
+    let length = 0;
+    for (const part of parts)
+        length += part.length;
+    const result = new Uint8Array(length);
+    let offset = 0;
+    for (const part of parts) {
+        result.set(part, offset);
+        offset += part.length;
+    }
+    return result;
+}
+/** Collects bytes, like a growing buffer. */
+export class BytesBuilder {
+    parts = [];
+    size = 0;
+    get length() {
+        return this.size;
+    }
+    add(bytes) {
+        const part = bytes instanceof Uint8Array ? bytes : Uint8Array.from(bytes);
+        this.parts.push(part);
+        this.size += part.length;
+    }
+    addByte(byte) {
+        this.add(Uint8Array.of(byte));
+    }
+    takeBytes() {
+        const result = concatBytes(this.parts);
+        this.parts.length = 0;
+        this.size = 0;
+        return result;
+    }
+}
+/** ISO 8859-1 bytes of `text`, which must contain no character beyond U+00FF. */
+export function latin1Encode(text) {
+    const bytes = new Uint8Array(text.length);
+    for (let i = 0; i < text.length; i++)
+        bytes[i] = text.charCodeAt(i) & 0xff;
+    return bytes;
+}
+/** The text of ISO 8859-1 `bytes`. */
+export function latin1Decode(bytes) {
+    let text = '';
+    // In chunks, since a spread of a large array exceeds the argument limit of some engines.
+    for (let i = 0; i < bytes.length; i += 0x8000) {
+        text += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+    }
+    return text;
+}
+const utf8Encoder = new TextEncoder();
+export function utf8Encode(text) {
+    return utf8Encoder.encode(text);
+}
+/** Decodes UTF-8; throws `FormatError` for malformed data unless `allowMalformed`. */
+export function utf8Decode(bytes, allowMalformed = false) {
+    try {
+        return new TextDecoder('utf-8', { fatal: !allowMalformed, ignoreBOM: true }).decode(bytes);
+    }
+    catch {
+        throw new FormatError('Invalid UTF-8');
+    }
+}
+const base64Alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+const base64Values = (() => {
+    const values = new Int16Array(128).fill(-1);
+    for (let i = 0; i < base64Alphabet.length; i++)
+        values[base64Alphabet.charCodeAt(i)] = i;
+    // The URL-safe alphabet as well.
+    values['-'.charCodeAt(0)] = 62;
+    values['_'.charCodeAt(0)] = 63;
+    return values;
+})();
+export function base64Encode(bytes) {
+    let out = '';
+    let i = 0;
+    for (; i + 2 < bytes.length; i += 3) {
+        const n = (bytes[i] << 16) | (bytes[i + 1] << 8) | bytes[i + 2];
+        out +=
+            base64Alphabet[n >> 18] +
+                base64Alphabet[(n >> 12) & 63] +
+                base64Alphabet[(n >> 6) & 63] +
+                base64Alphabet[n & 63];
+    }
+    const rest = bytes.length - i;
+    if (rest === 1) {
+        const n = bytes[i] << 16;
+        out += base64Alphabet[n >> 18] + base64Alphabet[(n >> 12) & 63] + '==';
+    }
+    else if (rest === 2) {
+        const n = (bytes[i] << 16) | (bytes[i + 1] << 8);
+        out += base64Alphabet[n >> 18] + base64Alphabet[(n >> 12) & 63] + base64Alphabet[(n >> 6) & 63] + '=';
+    }
+    return out;
+}
+/** Decodes base64, in the standard or the URL-safe alphabet; throws `FormatError` if `text` is not base64. */
+export function base64Decode(text) {
+    if (text.length % 4 !== 0)
+        throw new FormatError('Invalid base64 length, must be a multiple of four');
+    let padding = 0;
+    if (text.endsWith('=='))
+        padding = 2;
+    else if (text.endsWith('='))
+        padding = 1;
+    const out = new Uint8Array((text.length / 4) * 3 - padding);
+    let o = 0;
+    for (let i = 0; i < text.length; i += 4) {
+        let n = 0;
+        for (let j = 0; j < 4; j++) {
+            const c = text.charCodeAt(i + j);
+            const isPadding = c === 0x3d && i + 4 === text.length && j >= 4 - padding;
+            const value = isPadding ? 0 : c < 128 ? base64Values[c] : -1;
+            if (value < 0)
+                throw new FormatError('Invalid base64 character', text.charAt(i + j));
+            n = (n << 6) | value;
+        }
+        if (o < out.length)
+            out[o++] = n >> 16;
+        if (o < out.length)
+            out[o++] = (n >> 8) & 0xff;
+        if (o < out.length)
+            out[o++] = n & 0xff;
+    }
+    return out;
+}
+export function bytesEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++)
+        if (a[i] !== b[i])
+            return false;
+    return true;
+}
+//# sourceMappingURL=bytes.js.map

package/dist/util/bytes.js.map

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

package/dist/util/call-context.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tells which asynchronous call an operation runs in, through every `await` and callback it starts. Where the runtime
+ * cannot track that, as in browsers, `current` is always `undefined`.
+ */
+export declare class CallContext<T extends object> {
+    private readonly storage;
+    /** The value of the call that runs now, if the runtime can tell. */
+    get current(): T | undefined;
+    /** Runs `action` as the call `value`. */
+    run<R>(value: T, action: () => R): R;
+}
+//# sourceMappingURL=call-context.d.ts.map

package/dist/util/call-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-context.d.ts","sourceRoot":"","sources":["../../src/util/call-context.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,MAAM;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2F;IAEnH,oEAAoE;IACpE,IAAI,OAAO,IAAI,CAAC,GAAG,SAAS,CAE3B;IAED,yCAAyC;IACzC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;CAGrC"}

package/dist/util/call-context.js

@@ -0,0 +1,29 @@
+/**
+ * `AsyncLocalStorage` where the runtime has it (Node.js, Deno, Bun), found without importing `node:async_hooks`, so that
+ * bundlers for the browser have nothing to resolve.
+ */
+const AsyncStorageClass = (() => {
+    const runtime = globalThis;
+    try {
+        return runtime.process?.getBuiltinModule?.('node:async_hooks')?.AsyncLocalStorage;
+    }
+    catch {
+        return undefined;
+    }
+})();
+/**
+ * Tells which asynchronous call an operation runs in, through every `await` and callback it starts. Where the runtime
+ * cannot track that, as in browsers, `current` is always `undefined`.
+ */
+export class CallContext {
+    storage = AsyncStorageClass ? new AsyncStorageClass() : undefined;
+    /** The value of the call that runs now, if the runtime can tell. */
+    get current() {
+        return this.storage?.getStore();
+    }
+    /** Runs `action` as the call `value`. */
+    run(value, action) {
+        return this.storage ? this.storage.run(value, action) : action();
+    }
+}
+//# sourceMappingURL=call-context.js.map

package/dist/util/call-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-context.js","sourceRoot":"","sources":["../../src/util/call-context.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,iBAAiB,GAAwC,CAAC,GAAG,EAAE;IACnE,MAAM,OAAO,GAAG,UAEf,CAAC;IACF,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL;;;GAGG;AACH,MAAM,OAAO,WAAW;IACL,OAAO,GAAgC,iBAAiB,CAAC,CAAC,CAAC,IAAI,iBAAiB,EAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnH,oEAAoE;IACpE,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;IAClC,CAAC;IAED,yCAAyC;IACzC,GAAG,CAAI,KAAQ,EAAE,MAAe;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnE,CAAC;CACF"}