proton-mail-bridge-client 2.3.2 → 2.4.0

package/dist/utils/file-lock.js

@@ -23,6 +23,39 @@ const LOCK_ACQUIRE_TIMEOUT_MS = 10_000;
 // instead of blocking forever. Generous relative to how briefly these
 // load-modify-save cycles actually take.
 const STALE_LOCK_MS = 30_000;
+// Taking over a stale lock is itself a critical section. Two waiters can both judge the same lock stale; if
+// each then removes "the" lock and creates its own, the second removes the first's brand-new lock and both
+// end up inside the protected section. So stealing is serialized behind a short-lived guard file, and the
+// staleness verdict is taken again while holding it: a waiter that arrives second sees the first stealer's
+// fresh lock (live PID) and backs off.
+const STEAL_GUARD_STALE_MS = 5_000;
+async function stealStale(lockPath) {
+    const guard = `${lockPath}.steal`;
+    let handle;
+    try {
+        handle = await open(guard, "wx");
+    }
+    catch (error) {
+        if (error.code !== "EEXIST")
+            throw error;
+        // Someone else is stealing right now. A guard left behind by a process that died mid-steal is removed
+        // once it is old; either way this waiter just loops and looks again.
+        const info = await stat(guard).catch(() => undefined);
+        if (info && Date.now() - info.mtimeMs > STEAL_GUARD_STALE_MS)
+            await unlink(guard).catch(() => undefined);
+        return;
+    }
+    try {
+        await handle.close();
+        if (await isStale(lockPath)) {
+            logger.warn(`Stale lock file detected, stealing it: ${lockPath}`, "FileLock");
+            await unlink(lockPath).catch(() => undefined);
+        }
+    }
+    finally {
+        await unlink(guard).catch(() => undefined);
+    }
+}
 function lockPathFor(storePath) {
     return `${storePath}.lock`;
 }
@@ -123,12 +156,14 @@ async function acquire(lockPath) {
         }
         catch (error) {
             const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
-            if (code !== "EEXIST") {
+            // Windows refuses to open a lock file that another process has just deleted (delete pending) with
+            // EPERM/EACCES/EBUSY instead of letting the create succeed; that is contention, not a real failure.
+            const contendedOnWindows = process.platform === "win32" && (code === "EPERM" || code === "EACCES" || code === "EBUSY");
+            if (code !== "EEXIST" && !contendedOnWindows) {
                 throw error;
             }
-            if (await isStale(lockPath)) {
-                logger.warn(`Stale lock file detected, stealing it: ${lockPath}`, "FileLock");
-                await unlink(lockPath).catch(() => undefined);
+            if (!contendedOnWindows && (await isStale(lockPath))) {
+                await stealStale(lockPath);
                 continue;
             }
             if (Date.now() > deadline) {

package/dist/utils/file-lock.js.map

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

package/dist/utils/helpers.d.ts

@@ -31,7 +31,13 @@ export declare function extractMessageIdList(value?: string | string[]): string[
 export declare function extractAttachments(structure?: MessageStructureObject): EmailAttachmentSummary[];
 export declare function dedupeEmails(emails: EmailSummary[]): EmailSummary[];
 export declare function sortEmailsByNewest<T extends Pick<EmailSummary, "date" | "internalDate" | "uid">>(emails: T[]): T[];
+export declare class InvalidArgumentError extends Error {
+    constructor(message: string);
+}
 export declare function normalizeLimit(value: unknown, defaultValue: number, min?: number, max?: number): number;
+export declare function optionalInteger(value: unknown, min: number, max: number): number | undefined;
+export declare function optionalNumber(value: unknown, min: number, max: number): number | undefined;
+export declare function optionalBoolean(value: unknown): boolean | undefined;
 export declare function normalizeBoolean(value: unknown, defaultValue: boolean): boolean;
 export declare function parseDateInput(value?: string): Date | undefined;
 export declare function nextDay(date: Date): Date;
@@ -54,10 +60,18 @@ export declare function stringifyForJson(value: unknown): string;
 export declare function normalizeJsonValue(value: unknown): unknown;
 export declare function lowerCaseAddress(value?: string): string | undefined;
 export declare function isSelfAddress(candidate: string | undefined, ownerEmail: string | undefined): boolean;
+export declare function isOutgoingMessage(message: {
+    from: Array<{
+        address?: string;
+    }>;
+    folder?: string;
+}, ownerEmail?: string): boolean;
 export declare function normalizeMessageId(value?: string): string | undefined;
 export declare function extractDomain(address: string): string | undefined;
 export declare function normalizeSubjectForThread(subject: string): string;
 export declare function sanitizeFileName(filename?: string, fallback?: string): string;
+export declare function isPathInside(parent: string, child: string, separator?: string): boolean;
+export declare function decodeAttachmentText(content: Buffer, declaredCharset?: string): string | undefined;
 export declare function isTextLikeMimeType(mimeType?: string): boolean;
 export declare function classifyAttachment(input: {
     filename?: string;

package/dist/utils/helpers.d.ts.map

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

package/dist/utils/helpers.js

@@ -1,4 +1,5 @@
 import { createHash } from "node:crypto";
+import { sep as pathSeparator } from "node:path";
 import TurndownService from "turndown";
 const EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
 const EMAIL_ID_SEPARATOR = "::";
@@ -435,11 +436,34 @@ export function sortEmailsByNewest(emails) {
         return right.uid - left.uid;
     });
 }
+// A tool argument that could not be read as what it should be. The server maps it to InvalidParams, so
+// the caller is told, instead of the argument being ignored and a default used.
+export class InvalidArgumentError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidArgumentError";
+    }
+}
+// Reads an integer argument: a number, or a string that holds one ("5"), clamped to [min, max]. Nothing given
+// (undefined, null, "") uses the default. Anything else is an error rather than a silent default.
 export function normalizeLimit(value, defaultValue, min = 1, max = 250) {
-    if (typeof value !== "number" || Number.isNaN(value)) {
+    if (value === undefined || value === null || value === "") {
         return defaultValue;
     }
-    const rounded = Math.trunc(value);
+    let number;
+    if (typeof value === "number") {
+        number = value;
+    }
+    else if (typeof value === "string" && /^\s*-?\d+(\.\d+)?\s*$/.test(value)) {
+        number = Number(value);
+    }
+    else {
+        throw new InvalidArgumentError(`Expected a number but got ${JSON.stringify(value)}.`);
+    }
+    if (Number.isNaN(number)) {
+        throw new InvalidArgumentError("Expected a number but got NaN.");
+    }
+    const rounded = Math.trunc(number);
     if (rounded < min) {
         return min;
     }
@@ -448,8 +472,58 @@ export function normalizeLimit(value, defaultValue, min = 1, max = 250) {
     }
     return rounded;
 }
+// Like normalizeLimit, but "nothing given" stays undefined, for arguments whose default lives in the service.
+export function optionalInteger(value, min, max) {
+    return value === undefined || value === null || value === "" ? undefined : normalizeLimit(value, min, min, max);
+}
+// A number argument that may be absent (a filter such as sizeLarger): absent stays undefined, "1.5" and 1.5
+// both read as 1.5, anything unreadable is an error, and the value is kept inside [min, max].
+export function optionalNumber(value, min, max) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    let number;
+    if (typeof value === "number") {
+        number = value;
+    }
+    else if (typeof value === "string" && /^\s*-?\d+(\.\d+)?\s*$/.test(value)) {
+        number = Number(value);
+    }
+    else {
+        throw new InvalidArgumentError(`Expected a number but got ${JSON.stringify(value)}.`);
+    }
+    if (Number.isNaN(number))
+        throw new InvalidArgumentError("Expected a number but got NaN.");
+    return Math.min(max, Math.max(min, number));
+}
+const TRUE_WORDS = new Set(["true", "yes", "1", "on"]);
+const FALSE_WORDS = new Set(["false", "no", "0", "off"]);
+// Reads a boolean argument. Clients and models do send "true" and 1; reading only a real boolean made
+// dryRun:"true" run for real and isRead:"false" mark a message read. Nothing given uses the default; a value
+// that is none of the recognised spellings is an error, never a silent default.
+export function optionalBoolean(value) {
+    return value === undefined || value === null || value === "" ? undefined : normalizeBoolean(value, false);
+}
 export function normalizeBoolean(value, defaultValue) {
-    return typeof value === "boolean" ? value : defaultValue;
+    if (typeof value === "boolean")
+        return value;
+    if (value === undefined || value === null)
+        return defaultValue;
+    if (typeof value === "number") {
+        if (value === 1)
+            return true;
+        if (value === 0)
+            return false;
+    }
+    else if (typeof value === "string") {
+        const word = value.trim().toLowerCase();
+        if (word === "")
+            return defaultValue;
+        if (TRUE_WORDS.has(word))
+            return true;
+        if (FALSE_WORDS.has(word))
+            return false;
+    }
+    throw new InvalidArgumentError(`Expected true or false but got ${JSON.stringify(value)}.`);
 }
 export function parseDateInput(value) {
     if (!value) {
@@ -474,8 +548,13 @@ const FOLD_EXTRA = { ß: "ss", æ: "ae", œ: "oe", ø: "o", ł: "l", đ: "d", ð
 export function hasNonAscii(value) {
     return value !== undefined && /[^\x00-\x7f]/.test(value);
 }
+const NON_ASCII = /[^\x00-\x7f]/;
 // Lowercase, strip combining accents, and spell out the letters Unicode does not decompose.
 export function foldSearchText(value) {
+    // Plain ASCII (most of the text the index compares) folds to just its lower case: skip the Unicode
+    // normalisation, which is most of the cost when this runs for every row of a large mailbox.
+    if (!NON_ASCII.test(value))
+        return value.toLowerCase();
     return value
         .normalize("NFKD")
         .replace(/[\u0300-\u036f]/g, "")
@@ -487,6 +566,8 @@ export function foldSearchText(value) {
 const SPELLED_OUT = { ä: "ae", ö: "oe", ü: "ue", ø: "oe", å: "aa" };
 // The value with those letters spelled out as pairs, or undefined when it has none.
 function spelledOutText(value) {
+    if (!NON_ASCII.test(value))
+        return undefined;
     const lower = value.normalize("NFC").toLowerCase();
     if (!/[äöüøå]/.test(lower))
         return undefined;
@@ -698,6 +779,16 @@ export function isSelfAddress(candidate, ownerEmail) {
     }
     return stripPlusTag(a) === stripPlusTag(b);
 }
+// Whether a message was written by the mailbox owner. The login address is compared the way every other
+// "is this me" check here does (case-insensitive, a +tag ignored), and anything in the Sent folder counts too: a
+// reply sent from an alias (alias@pm.me) is the owner's, but its address is not the login address.
+export function isOutgoingMessage(message, ownerEmail) {
+    if (normalizeMailboxLabel(message.folder) === "Sent")
+        return true;
+    if (!ownerEmail)
+        return false;
+    return message.from.some((entry) => isSelfAddress(entry.address, ownerEmail));
+}
 export function normalizeMessageId(value) {
     const trimmed = value?.trim();
     if (!trimmed) {
@@ -716,10 +807,87 @@ export function normalizeSubjectForThread(subject) {
     }
     return collapsed.replace(/^(?:(?:re|fw|fwd)\s*:\s*)+/i, "").trim() || "(no subject)";
 }
+const WINDOWS_RESERVED_NAME = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i;
+// Well under the 255-byte limit of common filesystems, leaving room for a " (n)" suffix on a collision.
+const MAX_FILE_NAME_BYTES = 200;
+function cleanFileName(value) {
+    return value
+        .normalize("NFC")
+        .replace(/[\u0000-\u001f\u007f]/g, "")
+        .replace(/[\\/:*?"<>|]+/g, "_")
+        .replace(/\.\./g, "_")
+        .trim()
+        .replace(/[. ]+$/g, "");
+}
+// A file name taken from untrusted mail made safe to create on any platform: no path separators or control
+// characters, no trailing dots or spaces (Windows drops them, so two names could collapse into one), no
+// Windows device names (CON, NUL, COM1...), never "." or "..", and short enough for the filesystem.
 export function sanitizeFileName(filename, fallback = "attachment") {
-    let name = (filename || fallback).normalize('NFC');
-    const normalized = name.replace(/[\\/:*?"<>|]+/g, "_").replace(/\.\./g, '_').trim();
-    return normalized || fallback;
+    // "." and ".." (and a name of only dots and spaces) are directory references, not file names.
+    let name = /^[\s.]*$/.test(filename ?? "") ? "" : cleanFileName(filename ?? "");
+    if (!name) {
+        name = cleanFileName(fallback) || "attachment";
+    }
+    if (WINDOWS_RESERVED_NAME.test(name.split(".")[0])) {
+        name = `_${name}`;
+    }
+    if (Buffer.byteLength(name) > MAX_FILE_NAME_BYTES) {
+        const dot = name.lastIndexOf(".");
+        const extension = dot > 0 && Buffer.byteLength(name.slice(dot)) <= 16 ? name.slice(dot) : "";
+        let stem = Array.from(extension ? name.slice(0, dot) : name);
+        while (stem.length > 1 && Buffer.byteLength(stem.join("")) + Buffer.byteLength(extension) > MAX_FILE_NAME_BYTES) {
+            stem = stem.slice(0, -1);
+        }
+        name = `${stem.join("")}${extension}`;
+    }
+    return name;
+}
+// Whether `child` is `parent` or lies below it. Appending the separator to a parent that already ends in one
+// (a filesystem root: "/" or "C:\\") would give "//" and refuse every path.
+export function isPathInside(parent, child, separator = pathSeparator) {
+    if (child === parent)
+        return true;
+    return child.startsWith(parent.endsWith(separator) ? parent : parent + separator);
+}
+// Decodes the bytes of a text attachment. The charset the sender declared is honoured (windows-1250,
+// iso-8859-2... are common in mail from Poland and Czechia), a byte order mark is read and removed, and data
+// that is really binary (NUL bytes, or mostly bytes that are not valid text) is not returned as text.
+export function decodeAttachmentText(content, declaredCharset) {
+    if (content.length === 0)
+        return undefined;
+    let label = (declaredCharset ?? "").trim().toLowerCase().replace(/^["']|["']$/g, "");
+    let bytes = content;
+    if (content.length >= 3 && content[0] === 0xef && content[1] === 0xbb && content[2] === 0xbf) {
+        label = "utf-8";
+        bytes = content.subarray(3);
+    }
+    else if (content.length >= 2 && content[0] === 0xff && content[1] === 0xfe) {
+        label = "utf-16le";
+        bytes = content.subarray(2);
+    }
+    else if (content.length >= 2 && content[0] === 0xfe && content[1] === 0xff) {
+        label = "utf-16be";
+        bytes = content.subarray(2);
+    }
+    else if (bytes.subarray(0, 8192).includes(0)) {
+        return undefined;
+    }
+    let decoder;
+    try {
+        decoder = new TextDecoder(label || "utf-8");
+    }
+    catch {
+        decoder = new TextDecoder("utf-8");
+    }
+    const text = decoder.decode(bytes);
+    let replacements = 0;
+    for (let index = 0; index < text.length; index += 1) {
+        if (text.charCodeAt(index) === 0xfffd)
+            replacements += 1;
+    }
+    if (text.length > 0 && replacements / text.length > 0.1)
+        return undefined;
+    return text;
 }
 export function isTextLikeMimeType(mimeType) {
     if (!mimeType) {
@@ -776,21 +944,49 @@ export function classifyAttachment(input) {
     }
     return { kind: "other", isCalendarInvite: false, isSignature: false };
 }
+// Splits "NAME;PARAM=x:value" at the first colon that is not inside a quoted parameter value
+// (ORGANIZER;CN="Doe: John":mailto:j@x.com), returning the upper-case name and the value.
+function splitIcsProperty(line) {
+    let quoted = false;
+    for (let index = 0; index < line.length; index += 1) {
+        const char = line[index];
+        if (char === '"') {
+            quoted = !quoted;
+        }
+        else if (char === ":" && !quoted) {
+            if (index === 0)
+                return undefined;
+            return { name: line.slice(0, index).split(";")[0].trim().toUpperCase(), value: line.slice(index + 1).trim() };
+        }
+    }
+    return undefined;
+}
+// RFC 5545 text escapes: \n is a line break, \, \; \\ are the literal character.
+function unescapeIcsText(value) {
+    return value.replace(/\\([nN,;\\])/g, (_match, char) => (char === "n" || char === "N" ? " " : char));
+}
+const ICS_TEXT_FIELDS = new Set(["SUMMARY", "LOCATION", "DESCRIPTION"]);
+// Components whose own properties (e.g. the DTSTART of a daylight-saving rule) are not the event's.
+const ICS_NON_EVENT_COMPONENTS = new Set(["VTIMEZONE", "DAYLIGHT", "STANDARD", "VALARM"]);
 export function summarizeCalendarText(value) {
-    const normalized = value.replace(/\r/g, "");
+    const normalized = value.replace(/\r\n?/g, "\n");
+    // A line that starts with a space or tab continues the previous one (RFC 5545 line folding).
+    const lines = normalized.replace(/\n[ \t]/g, "").split("\n");
     const fields = new Map();
-    const lines = normalized.split("\n");
-    // Only read the first VEVENT's own properties when one exists: a VTIMEZONE ahead of it
-    // carries its own DTSTART (e.g. 19700329T020000 for a DST rule), and a nested VALARM
-    // carries its own SUMMARY/DESCRIPTION.
-    const hasEvent = lines.some((line) => line.trim().toUpperCase() === "BEGIN:VEVENT");
     const componentStack = [];
+    let method;
+    let eventCount = 0;
     let seenEvent = false;
+    // Only the first VEVENT's own properties are read when there is one: a VTIMEZONE ahead of it carries
+    // its own DTSTART (e.g. 19700329T020000 for a DST rule) and a nested VALARM its own SUMMARY.
+    const hasEvent = lines.some((line) => line.trim().toUpperCase() === "BEGIN:VEVENT");
     for (const line of lines) {
         const marker = /^(BEGIN|END):(\S+)\s*$/i.exec(line.trim());
         if (marker) {
             const component = marker[2].toUpperCase();
             if (marker[1].toUpperCase() === "BEGIN") {
+                if (component === "VEVENT")
+                    eventCount += 1;
                 componentStack.push(component);
             }
             else {
@@ -801,25 +997,30 @@ export function summarizeCalendarText(value) {
             }
             continue;
         }
-        if (hasEvent && (seenEvent || componentStack[componentStack.length - 1] !== "VEVENT")) {
+        const property = splitIcsProperty(line);
+        if (!property)
             continue;
-        }
-        const separator = line.indexOf(":");
-        if (separator <= 0) {
+        const top = componentStack[componentStack.length - 1];
+        if (top === "VCALENDAR" && property.name === "METHOD") {
+            method = property.value.toUpperCase();
             continue;
         }
-        const key = line.slice(0, separator).split(";")[0].trim().toUpperCase();
-        const fieldValue = line.slice(separator + 1).trim();
-        if (fieldValue && !fields.has(key)) {
-            fields.set(key, fieldValue);
+        if (componentStack.some((component) => ICS_NON_EVENT_COMPONENTS.has(component)))
+            continue;
+        if (hasEvent && (seenEvent || top !== "VEVENT"))
+            continue;
+        if (property.value && !fields.has(property.name)) {
+            fields.set(property.name, ICS_TEXT_FIELDS.has(property.name) ? unescapeIcsText(property.value) : property.value);
         }
     }
+    const cancelled = method === "CANCEL" || fields.get("STATUS")?.toUpperCase() === "CANCELLED";
     const summary = [
-        fields.get("SUMMARY"),
+        fields.get("SUMMARY") ? `${cancelled ? "[Cancelled] " : ""}${fields.get("SUMMARY")}` : cancelled ? "[Cancelled]" : undefined,
         fields.get("ORGANIZER"),
         fields.get("DTSTART") ? `Starts ${fields.get("DTSTART")}` : undefined,
         fields.get("DTEND") ? `Ends ${fields.get("DTEND")}` : undefined,
         fields.get("LOCATION") ? `Location ${fields.get("LOCATION")}` : undefined,
+        eventCount > 1 ? `+${eventCount - 1} more event${eventCount === 2 ? "" : "s"}` : undefined,
     ]
         .filter(Boolean)
         .join(" | ");