spamscanner 7.0.11 → 7.0.12

package/dist/types/links.d.ts

@@ -1,15 +1,17 @@
 /**
  * The link hosts of a message and of what it carries, as they are looked up
  * (see lookupName; an address as it is), in the order they are found, up to
- * `maxHosts`; names with no "/" after them come last, as far as there is
- * room, as text that is not a link may read as one.
+ * `maxHosts` and then the first of each domain not found yet (`maxHosts`
+ * domains in all); names with no "/" after them come last, as far as there is
+ * room, as text that is not a link may read as one. All of it is read for at
+ * most five seconds.
  * @param {object} mail - the message, as mailparser parsed it
  * @param {object} [options]
  * @param {object[]} [options.mails] - the messages attached to it, opened (see expandAttachments)
  * @param {object[]} [options.attachments] - its attachments and theirs (see expandAttachments)
  * @param {number} [options.maxHosts]
  * @param {boolean} [options.hostsInText] - also names with no "/" after them, "evil.example", as mail clients make links of them
- * @returns {{hosts: string[], more: boolean, tooComplex: boolean, incomplete: boolean}} `more`: it has more hosts, so not every link was read; `tooComplex`: a link whose host was never read whole (it runs past where the text is cut to be read, it is wrapped deeper than unwrapLink unwraps, or in more documents than are read); `incomplete`: an attachment was left unread for time
+ * @returns {{hosts: string[], more: boolean, tooComplex: boolean, incomplete: boolean}} `more`: it has more hosts than are given (at most `maxHosts`, and past them the first host of each domain not found yet, `maxHosts` domains in all), so not every link was read; `tooComplex`: a link whose host was never read whole (its host, or a link of click tracking or a security gateway, runs past where the text is cut to be read, it is in an attribute value or a card longer than is read, it is wrapped deeper than unwrapLink unwraps, or in more documents than are read); `incomplete`: not all of it was read in time
  */
 export function carriedLinkHosts(mail: object, { mails, attachments, maxHosts, hostsInText, }?: {
     mails?: object[];

package/dist/types/tokenizer.d.ts

@@ -7,6 +7,15 @@
  * @returns {RegExp}
  */
 export function characterClass(ranges: number[][], flags?: string): RegExp;
+/**
+ * A URL as the URL parser reads it, refused (a TypeError, as for one that is
+ * no URL) when its host is longer than any host is, so a link in a message
+ * cannot hold the parser for seconds.
+ * @param {string} address
+ * @returns {URL}
+ */
+export function boundedUrl(address: string): URL;
+export function isClickTracker(url: any): any;
 /**
  * The address a link goes to, as a URL: through a security gateway, the
  * address it goes on to (see gatewayTarget), as many as MAX_GATEWAYS

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "spamscanner",
   "description": "Spam, phishing and malware filter for email in any language: a trainable classifier, link and attachment checks, SPF/DKIM/DMARC, and an optional AI second opinion from any LLM, including local Ollama models. Works as a library, CLI, Postfix milter or HTTP API.",
-  "version": "7.0.11",
+  "version": "7.0.12",
   "author": "Forward Email (https://forwardemail.net)",
   "bin": {
     "spamscanner": "./dist/esm/cli.js"