@mavogel/awscdk-rootmail 0.1.23 → 0.1.25

package/node_modules/libqp/dist/cjs/libqp.js

@@ -0,0 +1,378 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Decoder = exports.Encoder = void 0;
+exports.encode = encode;
+exports.decode = decode;
+exports.wrap = wrap;
+const node_stream_1 = require("node:stream");
+// the shortest line wrap() can make progress with: a complete =XX sequence and the soft break
+const MIN_LINE_LENGTH = 4;
+// 1 for every byte value that is written as is: <TAB>, <LF>, <CR> and the printable ASCII
+// range except "=", https://tools.ietf.org/html/rfc2045#section-6.7
+const QP_LITERAL = new Uint8Array(256);
+for (let i = 0; i < 256; i++) {
+    QP_LITERAL[i] = i === 0x09 || i === 0x0a || i === 0x0d || (i >= 0x20 && i <= 0x7e && i !== 0x3d) ? 1 : 0;
+}
+const HEX_DIGITS = Buffer.from('0123456789ABCDEF', 'latin1');
+const isWhitespace = (c) => c === 0x20 || c === 0x09;
+/**
+ * Encodes a Buffer into a Quoted-Printable encoded string
+ *
+ * @param buffer Buffer to convert, a string is encoded as UTF-8
+ * @returns Quoted-Printable encoded string
+ */
+function encode(buffer) {
+    return encodeBytes(typeof buffer === 'string' ? Buffer.from(buffer, 'utf-8') : buffer);
+}
+/**
+ * Encodes bytes that may be followed by more input
+ *
+ * @param buffer Bytes to encode
+ * @param [next] The byte that follows the buffer, whitespace before it is kept literal unless it
+ *        is a line break. Without it the buffer ends the input and its trailing whitespace is encoded
+ * @param [binary] Keep only CRLF pairs literal. A lone CR or LF is data, not a line break, and
+ *        anything that rewrites line endings on the way would change it
+ * @param [previous] The byte before the buffer. Without it the buffer starts a line
+ * @returns Quoted-Printable encoded string
+ */
+function encodeBytes(buffer, next, binary, previous) {
+    const len = buffer.length;
+    // every byte takes three characters at most
+    const output = Buffer.allocUnsafe(len * 3);
+    let pos = 0;
+    for (let i = 0; i < len; i++) {
+        const ord = buffer[i];
+        const preceding = i > 0 ? buffer[i - 1] : previous;
+        const following = i + 1 < len ? buffer[i + 1] : next;
+        // in binary data only a CR followed by LF, or an LF that follows CR, is a line break
+        const loneLineBreak = binary && (ord === 0x0d ? following !== 0x0a : ord === 0x0a && preceding !== 0x0d);
+        // if the char is in allowed range, then keep as is, unless it is a ws in the end of a line
+        // or a hyphen in the start of a line. A line starting with two hyphens reads as a MIME
+        // boundary delimiter, so a decoded body that gets encoded again could inject a part. A lone
+        // CR counts as a line break here, a relay may turn it into CRLF
+        if (QP_LITERAL[ord] &&
+            !loneLineBreak &&
+            !(isWhitespace(ord) && (following === undefined || following === 0x0a || following === 0x0d)) &&
+            !(ord === 0x2d && (preceding === undefined || preceding === 0x0a || preceding === 0x0d))) {
+            output[pos++] = ord;
+            continue;
+        }
+        output[pos++] = 0x3d; // =
+        output[pos++] = HEX_DIGITS[Math.floor(ord / 16)];
+        output[pos++] = HEX_DIGITS[ord % 16];
+    }
+    return output.toString('latin1', 0, pos);
+}
+/**
+ * Decodes a Quoted-Printable encoded string to a Buffer object
+ *
+ * @param str Quoted-Printable encoded string. A Buffer is read byte for byte, so raw 8-bit bytes
+ *        in the input are copied to the output unchanged. A char of a string is copied as the low
+ *        byte of its char code, so a string should only hold chars below 256 ('binary')
+ * @returns Decoded value
+ */
+function decode(str) {
+    // 'binary' maps every byte to one char code 0-255. A UTF-8 read would collapse raw
+    // multi-byte chars into one byte below and turn raw latin1 bytes into U+FFFD
+    let input;
+    if (str instanceof Uint8Array) {
+        input = (Buffer.isBuffer(str) ? str : Buffer.from(str.buffer, str.byteOffset, str.byteLength)).toString('binary');
+    }
+    else {
+        input = (str || '').toString();
+    }
+    input = input
+        // remove invalid whitespace from the end of lines. The leading group keeps this linear,
+        // a plain /[\t ]+$/gm rescans the rest of a whitespace run from every position inside it,
+        // which is quadratic. The lookahead lists the line terminators multiline $ matches before
+        .replace(/(^|[^ \t])[ \t]+(?=[\n\r\u2028\u2029]|$)/g, '$1')
+        // remove soft line breaks
+        .replace(/[=](?:\r?\n|$)/g, '');
+    // every =XX escape decodes into one byte, so count them to size the output.
+    // Counted with a loop, a match() would build an array with a string for every escape
+    const len = input.length;
+    let encodedBytesCount = 0;
+    for (let i = input.indexOf('='); i >= 0 && i < len - 2; i = input.indexOf('=', i + 1)) {
+        if (hexValue(input.charCodeAt(i + 1)) >= 0 && hexValue(input.charCodeAt(i + 2)) >= 0) {
+            encodedBytesCount++;
+            i += 2;
+        }
+    }
+    const buffer = Buffer.alloc(len - encodedBytesCount * 2);
+    let bufferPos = 0;
+    for (let i = 0; i < len; i++) {
+        const code = input.charCodeAt(i);
+        if (code === 0x3d /* = */ && i < len - 2) {
+            const hi = hexValue(input.charCodeAt(i + 1));
+            const lo = hexValue(input.charCodeAt(i + 2));
+            if (hi >= 0 && lo >= 0) {
+                buffer[bufferPos++] = hi * 16 + lo;
+                i += 2;
+                continue;
+            }
+        }
+        buffer[bufferPos++] = code;
+    }
+    return buffer;
+}
+/**
+ * Helper function to read the value of a hex digit
+ *
+ * @param code Char code
+ * @returns 0-15, or -1 if the char is not a hex digit
+ */
+function hexValue(code) {
+    if (code >= 0x30 && code <= 0x39) {
+        return code - 0x30; // 0-9
+    }
+    if (code >= 0x41 && code <= 0x46) {
+        return code - 0x41 + 10; // A-F
+    }
+    if (code >= 0x61 && code <= 0x66) {
+        return code - 0x61 + 10; // a-f
+    }
+    return -1;
+}
+/**
+ * Adds soft line breaks to a Quoted-Printable string
+ *
+ * @param str Quoted-Printable encoded string that might need line wrapping
+ * @param [lineLength=76] Maximum allowed length for a line, at least 4
+ * @returns Soft-wrapped Quoted-Printable encoded string
+ */
+function wrap(str, lineLength) {
+    str = (str || '').toString();
+    // a line has to hold a complete =XX sequence plus the soft break, shorter lengths
+    // (or a negative one) would loop without consuming input
+    lineLength = Math.max(Number(lineLength) || 76, MIN_LINE_LENGTH);
+    if (str.length <= lineLength) {
+        return str;
+    }
+    // every line is wrapped on its own, a line break does not count towards the line length
+    const parts = str.split(/(\r?\n)/);
+    for (let i = 0; i < parts.length; i += 2) {
+        parts[i] = wrapLine(parts[i], lineLength);
+    }
+    return parts.join('');
+}
+/**
+ * Adds soft line breaks to one line of a Quoted-Printable string
+ *
+ * @param str Quoted-Printable encoded line, without line breaks
+ * @param lineLength Maximum allowed length for a line, at least MIN_LINE_LENGTH
+ * @returns Soft-wrapped line
+ */
+function wrapLine(str, lineLength) {
+    const len = str.length;
+    const lineMargin = Math.floor(lineLength / 3);
+    let pos = 0;
+    let result = '';
+    // every pass either ends with the rest of the line or consumes input
+    for (;;) {
+        // a line started by a soft break must not begin with a hyphen either, see encodeBytes().
+        // The escape takes the place of the hyphen, as if the input held it
+        const escapeHyphen = pos > 0 && str.charCodeAt(pos) === 0x2d;
+        if (len - pos + (escapeHyphen ? 2 : 0) <= lineLength) {
+            // the rest fits on a line
+            result += escapeHyphen ? '=2D' + str.substr(pos + 1) : str.substr(pos);
+            break;
+        }
+        let line = escapeHyphen ? '=2D' + str.substr(pos + 1, lineLength - 3) : str.substr(pos, lineLength);
+        let match;
+        if ((match = line.substr(-lineMargin).match(/[ \t.,!?][^ \t.,!?]*$/))) {
+            // truncate to nearest space
+            line = line.substr(0, line.length - (match[0].length - 1));
+        }
+        else if (/[=][\da-f]{0,2}$/i.test(line)) {
+            // push an incomplete encoding sequence to the next line and ensure that utf-8
+            // sequences are not split
+            line = trimUtf8Sequence(line.replace(/[=][\da-f]?$/i, ''));
+        }
+        // make room for the soft break, without splitting an encoding sequence
+        if (line.length === lineLength) {
+            line = line.substr(0, line.length - (/[=][\da-f]{2}$/i.test(line) ? 3 : 1));
+        }
+        // the escape stands for one char of the input
+        pos += escapeHyphen ? line.length - 2 : line.length;
+        result += line + '=\r\n';
+    }
+    return result;
+}
+/**
+ * Cuts the escapes of a trailing UTF-8 sequence off a line, so that a soft line break does not
+ * split the sequence. A line that holds nothing but the sequence, after the escape of a hyphen
+ * that starts the line, is kept whole
+ *
+ * @param line Quoted-Printable encoded line that ends with an escape
+ * @returns The line without the escapes of its last multi-byte sequence
+ */
+function trimUtf8Sequence(line) {
+    let end = line.length;
+    while (end >= 3 && line.charCodeAt(end - 3) === 0x3d /* = */) {
+        const hi = hexValue(line.charCodeAt(end - 2));
+        const lo = hexValue(line.charCodeAt(end - 1));
+        if (hi < 0 || lo < 0) {
+            break;
+        }
+        const code = hi * 16 + lo;
+        if (code < 0x80) {
+            break;
+        }
+        end -= 3;
+        if (code >= 0xc0) {
+            // the lead byte of the sequence
+            break;
+        }
+    }
+    return end > (line.startsWith('=2D') ? 3 : 0) ? line.substr(0, end) : line;
+}
+// Converts a chunk of a stream to bytes. A stream only hands over a string when its decodeStrings
+// option is off, and then the encoding is the one the chunk was written with
+const toBuffer = (chunk, encoding) => typeof chunk === 'string' ? Buffer.from(chunk, encoding) : chunk;
+// Input is encoded and wrapped this many bytes at a time. wrap() works on strings, and a large
+// chunk handed over at once, such as a whole Buffer attachment, would be held several times over
+// as intermediate strings
+const ENCODE_SLICE_SIZE = 64 * 1024;
+/**
+ * Creates a transform stream for encoding data to Quoted-Printable encoding
+ */
+class Encoder extends node_stream_1.Transform {
+    /**
+     * @param [options] Stream options
+     * @param [options.lineLength=76] Maximum length for lines, set to false to disable wrapping
+     * @param [options.binary=false] Encode every CR or LF that is not part of a CRLF pair
+     */
+    constructor(options) {
+        const opts = options || {};
+        super(opts);
+        this.options = opts;
+        if (this.options.lineLength !== false) {
+            this.options.lineLength = this.options.lineLength || 76;
+        }
+        this._curLine = '';
+        this._heldByte = undefined;
+        this._lastByte = undefined;
+        this.inputBytes = 0;
+        this.outputBytes = 0;
+    }
+    /** @internal */
+    _transform(chunk, encoding, done) {
+        let buf = toBuffer(chunk, encoding);
+        if (!buf || !buf.length) {
+            return done();
+        }
+        this.inputBytes += buf.length;
+        if (this._heldByte !== undefined) {
+            this._encodeSlices(Buffer.of(this._heldByte), buf[0]);
+            this._heldByte = undefined;
+        }
+        // Whitespace is encoded when it ends a line, and the end of the input counts as one, and a
+        // binary CR is a line break only when LF follows. Hold back such a last byte until it is
+        // known what follows it, so the output does not depend on where the input was split. Every
+        // other byte depends only on its neighbours, which _encodeSlices passes on
+        const last = buf[buf.length - 1];
+        if (isWhitespace(last) || (this.options.binary && last === 0x0d)) {
+            this._heldByte = last;
+            buf = buf.subarray(0, buf.length - 1);
+        }
+        // the bytes before a held back one only need to know it follows them
+        this._encodeSlices(buf, this._heldByte);
+        done();
+    }
+    /** @internal */
+    _flush(done) {
+        if (this._heldByte !== undefined) {
+            this._encodeSlices(Buffer.of(this._heldByte), undefined);
+            this._heldByte = undefined;
+        }
+        if (this._curLine) {
+            // it can end with a CR that was not wrapped yet
+            const qp = wrap(this._curLine, this.options.lineLength);
+            this.outputBytes += qp.length;
+            this.push(qp, 'ascii');
+            this._curLine = '';
+        }
+        done();
+    }
+    /**
+     * Encodes the input in slices of ENCODE_SLICE_SIZE bytes. Each slice is told the bytes around
+     * it, so a slice is encoded as if the input was not split
+     *
+     * @param buf Bytes to encode
+     * @param next The byte that follows buf, undefined when it is not known
+     * @internal
+     */
+    _encodeSlices(buf, next) {
+        for (let start = 0; start < buf.length; start += ENCODE_SLICE_SIZE) {
+            const end = Math.min(start + ENCODE_SLICE_SIZE, buf.length);
+            let qp = encodeBytes(buf.subarray(start, end), end < buf.length ? buf[end] : next, this.options.binary, this._lastByte);
+            this._lastByte = buf[end - 1];
+            if (this.options.lineLength) {
+                qp = this._curLine + qp;
+                // a CR at the end is a line break if LF follows, so it is wrapped once that is known
+                const cr = qp.endsWith('\r') ? '\r' : '';
+                qp = wrap(cr ? qp.slice(0, -1) : qp, this.options.lineLength);
+                // the last line is kept until it is known whether it needs a soft break
+                const lastLF = qp.lastIndexOf('\n');
+                this._curLine = qp.substring(lastLF + 1) + cr;
+                qp = qp.substring(0, lastLF + 1);
+            }
+            if (qp) {
+                this.outputBytes += qp.length;
+                this.push(qp, 'ascii');
+            }
+        }
+    }
+}
+exports.Encoder = Encoder;
+/**
+ * Creates a transform stream for decoding Quoted-Printable encoded strings.
+ * The input is not actually processed as a stream but concatted and processed as a single input,
+ * so escapes and soft line breaks split across chunks decode the same as unsplit input
+ */
+class Decoder extends node_stream_1.Transform {
+    /**
+     * @param [options] Stream options
+     */
+    constructor(options) {
+        const opts = options || {};
+        super(opts);
+        this.options = opts;
+        this.inputBytes = 0;
+        this.outputBytes = 0;
+        this.qpChunks = [];
+    }
+    /** @internal */
+    _transform(chunk, encoding, done) {
+        if (!chunk || !chunk.length) {
+            return done();
+        }
+        const buf = toBuffer(chunk, encoding);
+        // kept as a binary string, so joining the chunks is the only copy made before decoding
+        this.qpChunks.push(buf.toString('binary'));
+        this.inputBytes += buf.length;
+        done();
+    }
+    /** @internal */
+    _flush(done) {
+        if (this.inputBytes) {
+            const input = this.qpChunks.join('');
+            // the chunks are not needed anymore, release them before decoding allocates more
+            this.qpChunks = [];
+            const buf = decode(input);
+            this.outputBytes += buf.length;
+            this.push(buf);
+        }
+        done();
+    }
+}
+exports.Decoder = Decoder;
+const libqp = {
+    encode,
+    decode,
+    wrap,
+    Encoder,
+    Decoder
+};
+exports.default = libqp;
+Object.defineProperty(exports, 'default', { value: exports, enumerable: false, writable: true, configurable: true });

package/node_modules/libqp/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "commonjs"
+}

package/node_modules/libqp/dist/esm/libqp.d.ts

@@ -0,0 +1,74 @@
+import { Transform, type TransformOptions } from 'node:stream';
+/**
+ * Encodes a Buffer into a Quoted-Printable encoded string
+ *
+ * @param buffer Buffer to convert, a string is encoded as UTF-8
+ * @returns Quoted-Printable encoded string
+ */
+export declare function encode(buffer: Buffer | Uint8Array | string): string;
+/**
+ * Decodes a Quoted-Printable encoded string to a Buffer object
+ *
+ * @param str Quoted-Printable encoded string. A Buffer is read byte for byte, so raw 8-bit bytes
+ *        in the input are copied to the output unchanged. A char of a string is copied as the low
+ *        byte of its char code, so a string should only hold chars below 256 ('binary')
+ * @returns Decoded value
+ */
+export declare function decode(str: string | Buffer | Uint8Array): Buffer;
+/**
+ * Adds soft line breaks to a Quoted-Printable string
+ *
+ * @param str Quoted-Printable encoded string that might need line wrapping
+ * @param [lineLength=76] Maximum allowed length for a line, at least 4
+ * @returns Soft-wrapped Quoted-Printable encoded string
+ */
+export declare function wrap(str: string, lineLength?: number): string;
+/**
+ * Options for the Quoted-Printable encoder stream, on top of the Transform stream options
+ */
+export interface EncoderOptions extends TransformOptions {
+    /** Maximum length for lines (76 by default), set to false to disable wrapping */
+    lineLength?: number | false | undefined;
+    /** The input is binary data: a CR or LF that is not part of a CRLF pair is encoded */
+    binary?: boolean | undefined;
+}
+/**
+ * Options for the Quoted-Printable decoder stream, the Transform stream options
+ */
+export type DecoderOptions = TransformOptions;
+/**
+ * Creates a transform stream for encoding data to Quoted-Printable encoding
+ */
+export declare class Encoder extends Transform {
+    options: EncoderOptions;
+    inputBytes: number;
+    outputBytes: number;
+    /**
+     * @param [options] Stream options
+     * @param [options.lineLength=76] Maximum length for lines, set to false to disable wrapping
+     * @param [options.binary=false] Encode every CR or LF that is not part of a CRLF pair
+     */
+    constructor(options?: EncoderOptions);
+}
+/**
+ * Creates a transform stream for decoding Quoted-Printable encoded strings.
+ * The input is not actually processed as a stream but concatted and processed as a single input,
+ * so escapes and soft line breaks split across chunks decode the same as unsplit input
+ */
+export declare class Decoder extends Transform {
+    options: DecoderOptions;
+    inputBytes: number;
+    outputBytes: number;
+    /**
+     * @param [options] Stream options
+     */
+    constructor(options?: DecoderOptions);
+}
+declare const libqp: {
+    encode: typeof encode;
+    decode: typeof decode;
+    wrap: typeof wrap;
+    Encoder: typeof Encoder;
+    Decoder: typeof Decoder;
+};
+export default libqp;