spamscanner 7.0.7 → 7.0.9

package/dist/types/index.d.ts

@@ -72,13 +72,16 @@ export class SpamScanner {
      * a header field ("Name: value", or an mbox "From " line) is read as the
      * body of a message with no header, so its text is the input; other
      * input mailparser cannot read gives a message with no text. Other errors
-     * are thrown.
+     * are thrown. `error` is the parser's limit the message exceeds, so that
+     * only its first parts were read (as scan() reports it, see parseError),
+     * or null.
      * @param {Buffer|string|Uint8Array|AsyncIterable} source
-     * @returns {Promise<{raw: Buffer, mail: object}>}
+     * @returns {Promise<{raw: Buffer, mail: object, error: string|null}>}
      */
     parse(source: Buffer | string | Uint8Array | AsyncIterable<any>): Promise<{
         raw: Buffer;
         mail: object;
+        error: string | null;
     }>;
     /**
      * Classifier features of a parsed message.
@@ -471,6 +474,13 @@ export type ScanDetails = {
         filename: string;
         reason: string;
     }>;
+    /**
+     * - attached messages not opened, past the limits attached messages are read within (nested more than 3 deep, more than 100 attachments in them, or more than 25 MB of them), whose attachments were not inspected: not scored, as forwarded messages can be nested so
+     */
+    unopenedAttachments: Array<{
+        filename: string;
+        reason: string;
+    }>;
     /**
      * - whether text beyond phishing.maxLength was not read for links
      */
@@ -509,7 +519,7 @@ import { ReputationChecker } from './reputation.js';
 import { LLMClassifier } from './llm.js';
 import { Buffer } from 'node:buffer';
 import { getFeatures } from './tokenizer.js';
-export { getFeatures, segmentWords } from "./tokenizer.js";
+export { getFeatures, segmentWords, unwrapLink } from "./tokenizer.js";
 export { LLMClassifier, PROVIDERS } from "./llm.js";
 export { DEFAULT_SCORES, scoreResults } from "./score.js";
 export { spamHeaders, rewriteMessage } from "./headers.js";

package/dist/types/parse.d.ts

@@ -19,6 +19,17 @@ export function boundedForAuth(raw: Buffer): {
     raw: Buffer;
     fromCut: boolean;
 };
+/**
+ * Whether an attachment is an attached message: message/rfc822, or
+ * message/global (RFC 6532, the same with UTF-8 in its header), by type or
+ * by file name (.eml, .u8msg).
+ * @param {{contentType?: string, filename?: string}} attachment - as mailparser gives it
+ * @returns {boolean}
+ */
+export function isAttachedMessage(attachment: {
+    contentType?: string;
+    filename?: string;
+}): boolean;
 /**
  * The simpleParser of mailparser on a message it can finish (see finishable),
  * settled within `timeout`: a parse that has not settled by then is stopped
@@ -95,7 +106,7 @@ export function parseWithin(raw: Buffer, parse?: (raw: Buffer, options: {
  * @param {(raw: Buffer) => Promise<object>} [parse] - for tests
  * @returns {Promise<Array<object>>}
  */
-export function expandAttachments(attachments?: Array<object>, errors?: string[], parse?: (raw: Buffer) => Promise<object>): Promise<Array<object>>;
+export function expandAttachments(attachments?: Array<object>, errors?: string[], parse?: (raw: Buffer) => Promise<object>, unopened?: any[]): Promise<Array<object>>;
 /**
  * DKIM-Signature fields mailauth reads of a message (see boundedForAuth): it
  * checks every signature, hashing the body once for each body length (l=)

package/dist/types/tokenizer.d.ts

@@ -9,8 +9,9 @@
 export function characterClass(ranges: number[][], flags?: string): RegExp;
 /**
  * The address a link goes to, as a URL: through a security gateway, the
- * address it goes on to (see gatewayTarget), as many as three wrapped in
- * one another; or null for an address that is no URL.
+ * address it goes on to (see gatewayTarget), as many as MAX_GATEWAYS
+ * wrapped in one another (past them, the gateway link it got to); or null for
+ * an address that is no URL.
  * @param {string} address
  * @returns {URL|null}
  */

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.7",
+  "version": "7.0.9",
   "author": "Forward Email (https://forwardemail.net)",
   "bin": {
     "spamscanner": "./dist/esm/cli.js"