@brightchain/brightchain-api-lib 0.25.0 → 0.27.0

package/src/lib/services/emailGateway/gatewayObservability.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Gateway Observability
+ *
+ * Provides unified logging, metrics collection, and alerting for all
+ * Email Gateway components. Wraps the existing `IMessageLogger`,
+ * `IMessageMetricsCollector`, and `AlertMonitor` services to add
+ * gateway-specific observability.
+ *
+ * @see Requirements 10.1, 10.2, 10.3, 10.4, 10.5
+ * @module gatewayObservability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GatewayObservability = void 0;
+/**
+ * Centralised observability for the Email Gateway.
+ *
+ * Integrates with the existing `IMessageLogger`, `IMessageMetricsCollector`,
+ * and `AlertMonitor` services so that all gateway events flow through the
+ * same infrastructure used by the rest of BrightChain.
+ *
+ * @see Requirements 10.1, 10.2, 10.3, 10.4, 10.5
+ */
+class GatewayObservability {
+    logger;
+    metrics;
+    alertMonitor;
+    // Gateway-specific counters (Req 10.3)
+    _outboundQueueDepth = 0;
+    _deliverySuccessCount = 0;
+    _deliveryFailureCount = 0;
+    _totalDeliveryLatencyMs = 0;
+    _spamRejectionCount = 0;
+    _totalInboundProcessed = 0;
+    constructor(logger, metrics, alertMonitor) {
+        this.logger = logger;
+        this.metrics = metrics;
+        this.alertMonitor = alertMonitor;
+    }
+    // ── Outbound delivery logging (Req 10.1) ──────────────────────────
+    /**
+     * Log an outbound delivery attempt.
+     *
+     * Delegates to `IMessageLogger.logMessageCreated` for consistent logging
+     * and records the attempt in the metrics collector.
+     *
+     * @see Requirement 10.1
+     */
+    logOutboundAttempt(recipient, statusCode, retryCount, timestamp) {
+        // Use the existing logger infrastructure (Req 10.4)
+        this.logger.logMessageCreated(`outbound:${recipient}:${timestamp.toISOString()}`, 'gateway-outbound', 1);
+        this.logger.logRoutingDecision(`outbound:${recipient}`, `smtp-status:${statusCode}:retry:${retryCount}`, 1);
+        // Track success/failure in metrics (Req 10.3)
+        if (statusCode >= 200 && statusCode < 300) {
+            this._deliverySuccessCount++;
+            this.metrics.recordMessageDelivered(0);
+        }
+        else {
+            this._deliveryFailureCount++;
+            this.metrics.recordMessageFailed();
+        }
+        this.metrics.recordMessageSent();
+    }
+    // ── Inbound processing logging (Req 10.2) ─────────────────────────
+    /**
+     * Log an inbound email processing event.
+     *
+     * @see Requirement 10.2
+     */
+    logInboundProcessing(sender, recipient, spamScore, authResults, accepted) {
+        this._totalInboundProcessed++;
+        const messageId = `inbound:${sender}->${recipient}:${Date.now()}`;
+        // Log via existing logger (Req 10.4)
+        this.logger.logMessageCreated(messageId, sender, 1);
+        this.logger.logRoutingDecision(messageId, `spam:${spamScore}|spf:${authResults.spf.status}|dkim:${authResults.dkim.status}|dmarc:${authResults.dmarc.status}|${accepted ? 'accepted' : 'rejected'}`, 1);
+        if (!accepted) {
+            this.logger.logDeliveryFailure(messageId, recipient, 'rejected');
+        }
+    }
+    // ── Metrics recording (Req 10.3) ──────────────────────────────────
+    /**
+     * Record the current outbound queue depth.
+     *
+     * @see Requirement 10.3
+     */
+    recordQueueDepth(depth) {
+        this._outboundQueueDepth = depth;
+        this.metrics.recordStorageUtilization(depth);
+    }
+    /**
+     * Record a successful delivery and its latency.
+     *
+     * @see Requirement 10.3
+     */
+    recordDeliverySuccess(latencyMs) {
+        this._deliverySuccessCount++;
+        if (latencyMs !== undefined) {
+            this._totalDeliveryLatencyMs += latencyMs;
+            this.metrics.recordMessageDelivered(latencyMs);
+        }
+        else {
+            this.metrics.recordMessageDelivered(0);
+        }
+    }
+    /**
+     * Record a delivery failure.
+     *
+     * @see Requirement 10.3
+     */
+    recordDeliveryFailure() {
+        this._deliveryFailureCount++;
+        this.metrics.recordMessageFailed();
+    }
+    /**
+     * Record delivery latency in milliseconds.
+     *
+     * @see Requirement 10.3
+     */
+    recordDeliveryLatency(ms) {
+        this._totalDeliveryLatencyMs += ms;
+        this.metrics.recordMessageDelivered(ms);
+    }
+    /**
+     * Record a spam rejection.
+     *
+     * @see Requirement 10.3
+     */
+    recordSpamRejection() {
+        this._spamRejectionCount++;
+        this._totalInboundProcessed++;
+        this.metrics.recordMessageFailed();
+    }
+    // ── Alert emission (Req 10.5) ─────────────────────────────────────
+    /**
+     * Emit an alert when delivery fails after all retries are exhausted.
+     *
+     * Delegates to the existing `AlertMonitor` for consistent alerting.
+     *
+     * @see Requirement 10.5
+     */
+    alertDeliveryExhausted(messageId, recipient, retryCount) {
+        // Use AlertMonitor's failure rate check to trigger handler (Req 10.5)
+        this.alertMonitor.checkFailureRate(this._deliverySuccessCount, this._deliveryFailureCount);
+        // Also emit a specific event-emission alert with context
+        this.alertMonitor.checkEventEmission(`Delivery exhausted: messageId=${messageId}, recipient=${recipient}, retries=${retryCount}`);
+        // Log via existing logger
+        this.logger.logDeliveryFailure(messageId, recipient, `retries exhausted after ${retryCount} attempts`);
+    }
+    // ── Metrics snapshot (Req 10.3) ───────────────────────────────────
+    /**
+     * Return a point-in-time snapshot of all gateway-specific metrics.
+     *
+     * @see Requirement 10.3
+     */
+    getMetricsSnapshot() {
+        const totalDeliveries = this._deliverySuccessCount + this._deliveryFailureCount;
+        const deliveredCount = this._deliverySuccessCount;
+        return {
+            outboundQueueDepth: this._outboundQueueDepth,
+            deliverySuccessCount: this._deliverySuccessCount,
+            deliveryFailureCount: this._deliveryFailureCount,
+            deliverySuccessRate: totalDeliveries > 0 ? deliveredCount / totalDeliveries : 0,
+            deliveryFailureRate: totalDeliveries > 0 ? this._deliveryFailureCount / totalDeliveries : 0,
+            averageDeliveryLatencyMs: deliveredCount > 0 ? this._totalDeliveryLatencyMs / deliveredCount : 0,
+            spamRejectionCount: this._spamRejectionCount,
+            spamRejectionRate: this._totalInboundProcessed > 0
+                ? this._spamRejectionCount / this._totalInboundProcessed
+                : 0,
+            totalInboundProcessed: this._totalInboundProcessed,
+        };
+    }
+    /**
+     * Reset all gateway-specific counters.
+     */
+    reset() {
+        this._outboundQueueDepth = 0;
+        this._deliverySuccessCount = 0;
+        this._deliveryFailureCount = 0;
+        this._totalDeliveryLatencyMs = 0;
+        this._spamRejectionCount = 0;
+        this._totalInboundProcessed = 0;
+        this.metrics.reset();
+    }
+}
+exports.GatewayObservability = GatewayObservability;
+//# sourceMappingURL=gatewayObservability.js.map

package/src/lib/services/emailGateway/gatewayObservability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatewayObservability.js","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/services/emailGateway/gatewayObservability.ts"],"names":[],"mappings":"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"}

package/src/lib/services/emailGateway/inboundProcessor.d.ts

@@ -0,0 +1,113 @@
+/**
+ * InboundProcessor — watches the Mail Drop Directory for new Maildir-format
+ * files deposited by Postfix, parses each message via EmailParser, stores
+ * content in the Block Store, creates metadata via EmailMessageService, and
+ * announces delivery to the recipient via the Gossip Protocol.
+ *
+ * On success the processed file is deleted from the Mail Drop Directory.
+ * On failure the file is moved to a configurable error directory and the
+ * failure reason is logged.
+ *
+ * A Set of processed filenames provides idempotency — the same file will
+ * not be processed twice even if the watcher fires duplicate events.
+ *
+ * @see Requirements 4.4, 4.5, 4.6, 4.7, 4.8, 4.9
+ * @module inboundProcessor
+ */
+import type { IBlockStore, IGossipService } from '@brightchain/brightchain-lib';
+import { EmailMessageService, EmailParser } from '@brightchain/brightchain-lib';
+import type { IEmailAuthVerifier } from './emailAuthVerifier';
+import type { IEmailGatewayConfig } from './emailGatewayConfig';
+/**
+ * Watches the Mail Drop Directory for new inbound email files and processes
+ * them into the BrightChain internal messaging system.
+ *
+ * Processing pipeline per file:
+ * 1. Read raw file content
+ * 2. Parse RFC 5322 message via EmailParser
+ * 3. Store content in Block Store
+ * 4. Create metadata via EmailMessageService
+ * 5. Announce to recipient via Gossip Protocol
+ * 6. Delete file on success / move to error directory on failure
+ *
+ * @see Requirements 4.4, 4.5, 4.6, 4.7, 4.8, 4.9
+ */
+export declare class InboundProcessor {
+    private readonly config;
+    private readonly emailMessageService;
+    private readonly blockStore;
+    private readonly gossipService;
+    private readonly parser;
+    /** Authentication verifier for SPF/DKIM/DMARC. Req 6.4, 6.5 */
+    private readonly authVerifier;
+    /** fs.watch handle — `null` when stopped. */
+    private watcher;
+    /** Whether the processor is currently running. */
+    private running;
+    /** Filenames that have already been processed (idempotency guard). Req 4.7 */
+    private readonly processedFiles;
+    constructor(config: IEmailGatewayConfig, emailParser: EmailParser | null, emailMessageService: EmailMessageService, blockStore: IBlockStore, gossipService: IGossipService, authVerifier?: IEmailAuthVerifier);
+    /**
+     * Start watching the Mail Drop Directory for new files.
+     *
+     * Creates the mail drop and error directories if they do not exist,
+     * then sets up an `fs.watch` listener that triggers processing for
+     * every new or renamed file.
+     *
+     * @see Requirement 4.5 — watch via inotify / fs.watch
+     */
+    start(): void;
+    /**
+     * Stop watching the Mail Drop Directory.
+     */
+    stop(): void;
+    /**
+     * Whether the processor is currently running.
+     */
+    isRunning(): boolean;
+    /**
+     * Process all files already present in the Mail Drop Directory.
+     * Called once on startup to handle files deposited while the processor
+     * was not running.
+     */
+    private processExistingFiles;
+    /**
+     * Process a single inbound email file.
+     *
+     * Idempotency: if the file has already been processed (tracked in
+     * `processedFiles`) the call is a no-op. Req 4.7
+     *
+     * @param filename - The filename (not full path) within the Mail Drop Directory
+     *
+     * @see Requirement 4.6 — parse, store, create metadata
+     * @see Requirement 4.7 — delete on success
+     * @see Requirement 4.8 — move to error directory on failure
+     * @see Requirement 4.9 — announce via gossip
+     */
+    processFile(filename: string): Promise<void>;
+    /**
+     * Merge authentication results into custom headers as a serialized
+     * `X-BrightChain-Auth-Results` header so the auth metadata is
+     * preserved alongside the message.
+     *
+     * @see Requirement 6.4
+     */
+    private mergeAuthHeaders;
+    /**
+     * Extract plain-text body from parsed email metadata.
+     */
+    private extractTextBody;
+    /**
+     * Extract HTML body from parsed email metadata.
+     */
+    private extractHtmlBody;
+    /**
+     * Get the set of processed filenames (for testing / inspection).
+     */
+    getProcessedFiles(): ReadonlySet<string>;
+    /**
+     * Clear the processed files set (for testing).
+     */
+    clearProcessedFiles(): void;
+}
+//# sourceMappingURL=inboundProcessor.d.ts.map

package/src/lib/services/emailGateway/inboundProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inboundProcessor.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/services/emailGateway/inboundProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAEV,WAAW,EAGX,cAAc,EACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIhE;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB;IAgBzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAnBhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IAErC,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,6CAA6C;IAC7C,OAAO,CAAC,OAAO,CAA6B;IAE5C,kDAAkD;IAClD,OAAO,CAAC,OAAO,CAAS;IAExB,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;gBAGtC,MAAM,EAAE,mBAAmB,EAC5C,WAAW,EAAE,WAAW,GAAG,IAAI,EACd,mBAAmB,EAAE,mBAAmB,EACxC,UAAU,EAAE,WAAW,EACvB,aAAa,EAAE,cAAc,EAC9C,YAAY,CAAC,EAAE,kBAAkB;IAQnC;;;;;;;;OAQG;IACH,KAAK,IAAI,IAAI;IA4Bb;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAMpB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;;;;;;;;;;;OAYG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4GlD;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,iBAAiB,IAAI,WAAW,CAAC,MAAM,CAAC;IAIxC;;OAEG;IACH,mBAAmB,IAAI,IAAI;CAG5B"}

package/src/lib/services/emailGateway/inboundProcessor.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * InboundProcessor — watches the Mail Drop Directory for new Maildir-format
+ * files deposited by Postfix, parses each message via EmailParser, stores
+ * content in the Block Store, creates metadata via EmailMessageService, and
+ * announces delivery to the recipient via the Gossip Protocol.
+ *
+ * On success the processed file is deleted from the Mail Drop Directory.
+ * On failure the file is moved to a configurable error directory and the
+ * failure reason is logged.
+ *
+ * A Set of processed filenames provides idempotency — the same file will
+ * not be processed twice even if the watcher fires duplicate events.
+ *
+ * @see Requirements 4.4, 4.5, 4.6, 4.7, 4.8, 4.9
+ * @module inboundProcessor
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InboundProcessor = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const brightchain_lib_1 = require("@brightchain/brightchain-lib");
+const emailAuthVerifier_1 = require("./emailAuthVerifier");
+// ─── InboundProcessor ───────────────────────────────────────────────────────
+/**
+ * Watches the Mail Drop Directory for new inbound email files and processes
+ * them into the BrightChain internal messaging system.
+ *
+ * Processing pipeline per file:
+ * 1. Read raw file content
+ * 2. Parse RFC 5322 message via EmailParser
+ * 3. Store content in Block Store
+ * 4. Create metadata via EmailMessageService
+ * 5. Announce to recipient via Gossip Protocol
+ * 6. Delete file on success / move to error directory on failure
+ *
+ * @see Requirements 4.4, 4.5, 4.6, 4.7, 4.8, 4.9
+ */
+class InboundProcessor {
+    config;
+    emailMessageService;
+    blockStore;
+    gossipService;
+    parser;
+    /** Authentication verifier for SPF/DKIM/DMARC. Req 6.4, 6.5 */
+    authVerifier;
+    /** fs.watch handle — `null` when stopped. */
+    watcher = null;
+    /** Whether the processor is currently running. */
+    running = false;
+    /** Filenames that have already been processed (idempotency guard). Req 4.7 */
+    processedFiles = new Set();
+    constructor(config, emailParser, emailMessageService, blockStore, gossipService, authVerifier) {
+        this.config = config;
+        this.emailMessageService = emailMessageService;
+        this.blockStore = blockStore;
+        this.gossipService = gossipService;
+        this.parser = emailParser ?? new brightchain_lib_1.EmailParser();
+        this.authVerifier = authVerifier ?? new emailAuthVerifier_1.EmailAuthVerifier();
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────────
+    /**
+     * Start watching the Mail Drop Directory for new files.
+     *
+     * Creates the mail drop and error directories if they do not exist,
+     * then sets up an `fs.watch` listener that triggers processing for
+     * every new or renamed file.
+     *
+     * @see Requirement 4.5 — watch via inotify / fs.watch
+     */
+    start() {
+        if (this.running) {
+            return;
+        }
+        // Ensure directories exist.
+        fs.mkdirSync(this.config.mailDropDirectory, { recursive: true });
+        fs.mkdirSync(this.config.errorDirectory, { recursive: true });
+        // Process any files already present in the directory.
+        this.processExistingFiles();
+        // Watch for new files.
+        this.watcher = fs.watch(this.config.mailDropDirectory, (eventType, filename) => {
+            if (filename && (eventType === 'rename' || eventType === 'change')) {
+                // Small delay to allow the file to be fully written.
+                setTimeout(() => {
+                    void this.processFile(filename);
+                }, 100);
+            }
+        });
+        this.running = true;
+    }
+    /**
+     * Stop watching the Mail Drop Directory.
+     */
+    stop() {
+        if (!this.running) {
+            return;
+        }
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        this.running = false;
+    }
+    /**
+     * Whether the processor is currently running.
+     */
+    isRunning() {
+        return this.running;
+    }
+    // ─── File Processing ────────────────────────────────────────────────
+    /**
+     * Process all files already present in the Mail Drop Directory.
+     * Called once on startup to handle files deposited while the processor
+     * was not running.
+     */
+    processExistingFiles() {
+        let entries;
+        try {
+            entries = fs.readdirSync(this.config.mailDropDirectory);
+        }
+        catch {
+            return;
+        }
+        for (const filename of entries) {
+            const fullPath = path.join(this.config.mailDropDirectory, filename);
+            try {
+                const stat = fs.statSync(fullPath);
+                if (stat.isFile()) {
+                    void this.processFile(filename);
+                }
+            }
+            catch {
+                // Skip entries we cannot stat.
+            }
+        }
+    }
+    /**
+     * Process a single inbound email file.
+     *
+     * Idempotency: if the file has already been processed (tracked in
+     * `processedFiles`) the call is a no-op. Req 4.7
+     *
+     * @param filename - The filename (not full path) within the Mail Drop Directory
+     *
+     * @see Requirement 4.6 — parse, store, create metadata
+     * @see Requirement 4.7 — delete on success
+     * @see Requirement 4.8 — move to error directory on failure
+     * @see Requirement 4.9 — announce via gossip
+     */
+    async processFile(filename) {
+        // Idempotency guard (Req 4.7).
+        if (this.processedFiles.has(filename)) {
+            return;
+        }
+        const filePath = path.join(this.config.mailDropDirectory, filename);
+        // Verify the file still exists (it may have been removed between
+        // the watcher event and this handler running).
+        if (!fs.existsSync(filePath)) {
+            return;
+        }
+        // Mark as in-progress immediately to prevent duplicate processing
+        // from concurrent watcher events.
+        this.processedFiles.add(filename);
+        try {
+            // 1. Read raw file content.
+            const rawContent = fs.readFileSync(filePath);
+            // 2. Parse RFC 5322 message via EmailParser (Req 4.6).
+            const metadata = await this.parser.parse(rawContent);
+            // 2b. Verify SPF/DKIM/DMARC authentication results (Req 6.4).
+            const authResult = this.authVerifier.verify(rawContent);
+            // 2c. Reject messages failing DMARC with reject policy (Req 6.5).
+            if (emailAuthVerifier_1.EmailAuthVerifier.shouldRejectDmarc(authResult)) {
+                throw new Error(`DMARC verification failed (550 reject): ${authResult.dmarc.details ?? 'policy=reject'}`);
+            }
+            // 3. Store content in Block Store.
+            const blockId = metadata.messageId;
+            await this.blockStore.put(blockId, rawContent);
+            // 4. Create metadata via EmailMessageService (Req 4.6).
+            //    We use sendEmail with the parsed metadata to go through the
+            //    standard storage and delivery pipeline.
+            const recipientAddresses = [
+                ...metadata.to.map((m) => m.address),
+                ...(metadata.cc ?? []).map((m) => m.address),
+            ];
+            await this.emailMessageService.sendEmail({
+                from: metadata.from,
+                to: metadata.to,
+                cc: metadata.cc,
+                bcc: metadata.bcc,
+                subject: metadata.subject,
+                messageId: metadata.messageId,
+                date: metadata.date,
+                inReplyTo: metadata.inReplyTo,
+                references: metadata.references,
+                contentType: metadata.contentType,
+                parts: metadata.parts,
+                textBody: this.extractTextBody(metadata),
+                htmlBody: this.extractHtmlBody(metadata),
+                customHeaders: this.mergeAuthHeaders(metadata.customHeaders, authResult),
+            });
+            // 5. Announce to recipients via Gossip Protocol (Req 4.9).
+            await this.gossipService.announceMessage(metadata.cblBlockIds ?? [blockId], {
+                messageId: metadata.messageId,
+                recipientIds: recipientAddresses,
+                priority: 'normal',
+                blockIds: metadata.cblBlockIds ?? [blockId],
+                cblBlockId: metadata.blockId ?? blockId,
+                ackRequired: true,
+            });
+            // 6. Delete processed file on success (Req 4.7).
+            fs.unlinkSync(filePath);
+        }
+        catch (err) {
+            // On failure: move to error directory and log reason (Req 4.8).
+            const reason = err instanceof Error ? err.message : String(err);
+            try {
+                const errorPath = path.join(this.config.errorDirectory, filename);
+                fs.renameSync(filePath, errorPath);
+            }
+            catch {
+                // If we can't move the file, leave it in place — it won't be
+                // reprocessed because it's already in processedFiles.
+            }
+            // Log the failure reason.
+            console.error(`[InboundProcessor] Failed to process ${filename}: ${reason}`);
+            // Remove from processedFiles so a retry can be attempted if the
+            // file is re-deposited.
+            this.processedFiles.delete(filename);
+        }
+    }
+    // ─── Helpers ────────────────────────────────────────────────────────
+    /**
+     * Merge authentication results into custom headers as a serialized
+     * `X-BrightChain-Auth-Results` header so the auth metadata is
+     * preserved alongside the message.
+     *
+     * @see Requirement 6.4
+     */
+    mergeAuthHeaders(existing, authResult) {
+        const merged = new Map(existing);
+        const summary = [
+            `spf=${authResult.spf.status}`,
+            `dkim=${authResult.dkim.status}`,
+            `dmarc=${authResult.dmarc.status}`,
+        ].join('; ');
+        merged.set('X-BrightChain-Auth-Results', [summary]);
+        return merged;
+    }
+    /**
+     * Extract plain-text body from parsed email metadata.
+     */
+    extractTextBody(metadata) {
+        if (metadata.parts && metadata.parts.length > 0) {
+            for (const part of metadata.parts) {
+                if (part.contentType?.type === 'text' &&
+                    part.contentType?.subtype === 'plain' &&
+                    part.body) {
+                    return typeof part.body === 'string'
+                        ? part.body
+                        : new TextDecoder().decode(part.body);
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract HTML body from parsed email metadata.
+     */
+    extractHtmlBody(metadata) {
+        if (metadata.parts && metadata.parts.length > 0) {
+            for (const part of metadata.parts) {
+                if (part.contentType?.type === 'text' &&
+                    part.contentType?.subtype === 'html' &&
+                    part.body) {
+                    return typeof part.body === 'string'
+                        ? part.body
+                        : new TextDecoder().decode(part.body);
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get the set of processed filenames (for testing / inspection).
+     */
+    getProcessedFiles() {
+        return this.processedFiles;
+    }
+    /**
+     * Clear the processed files set (for testing).
+     */
+    clearProcessedFiles() {
+        this.processedFiles.clear();
+    }
+}
+exports.InboundProcessor = InboundProcessor;
+//# sourceMappingURL=inboundProcessor.js.map

package/src/lib/services/emailGateway/inboundProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inboundProcessor.js","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/services/emailGateway/inboundProcessor.ts"],"names":[],"mappings":"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"}

package/src/lib/services/emailGateway/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Email Gateway module barrel export.
+ *
+ * Re-exports all public gateway components so consumers can import from
+ * `@brightchain/brightchain-api-lib` (via the services barrel) with a
+ * single import path.
+ *
+ * @see Requirements 11.2, 11.3
+ * @module emailGateway
+ */
+export * from './antiSpamFilter';
+export * from './bounceProcessor';
+export * from './emailAuthVerifier';
+export * from './emailGatewayConfig';
+export * from './emailGatewayService';
+export * from './gatewayObservability';
+export * from './inboundProcessor';
+export * from './outboundDeliveryWorker';
+export * from './outboundQueue';
+export * from './outboundQueueStore';
+export * from './recipientLookupService';
+export * from './retryBackoff';
+//# sourceMappingURL=index.d.ts.map

package/src/lib/services/emailGateway/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../brightchain-api-lib/src/lib/services/emailGateway/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC"}