@serve.zone/dcrouter 11.0.40 → 11.0.45

package/dist_ts/cache/documents/classes.cached.email.d.ts

@@ -0,0 +1,125 @@
+import { CachedDocument } from '../classes.cached.document.js';
+/**
+ * Email status in the cache
+ */
+export type TCachedEmailStatus = 'pending' | 'processing' | 'delivered' | 'failed' | 'deferred';
+/**
+ * CachedEmail - Stores email queue items in the cache
+ *
+ * Used for persistent email queue storage, tracking delivery status,
+ * and maintaining email history for the configured TTL period.
+ */
+export declare class CachedEmail extends CachedDocument<CachedEmail> {
+    createdAt: Date;
+    expiresAt: Date;
+    lastAccessedAt: Date;
+    /**
+     * Unique identifier for this email
+     */
+    id: string;
+    /**
+     * Email message ID (RFC 822 Message-ID header)
+     */
+    messageId: string;
+    /**
+     * Sender email address (envelope from)
+     */
+    from: string;
+    /**
+     * Recipient email addresses
+     */
+    to: string[];
+    /**
+     * CC recipients
+     */
+    cc: string[];
+    /**
+     * BCC recipients
+     */
+    bcc: string[];
+    /**
+     * Email subject
+     */
+    subject: string;
+    /**
+     * Raw RFC822 email content
+     */
+    rawContent: string;
+    /**
+     * Current status of the email
+     */
+    status: TCachedEmailStatus;
+    /**
+     * Number of delivery attempts
+     */
+    attempts: number;
+    /**
+     * Maximum number of delivery attempts
+     */
+    maxAttempts: number;
+    /**
+     * Timestamp for next delivery attempt
+     */
+    nextAttempt: Date;
+    /**
+     * Last error message if delivery failed
+     */
+    lastError: string;
+    /**
+     * Timestamp when the email was successfully delivered
+     */
+    deliveredAt: Date;
+    /**
+     * Sender domain (for querying/filtering)
+     */
+    senderDomain: string;
+    /**
+     * Priority level (higher = more important)
+     */
+    priority: number;
+    /**
+     * JSON-serialized route data
+     */
+    routeData: string;
+    /**
+     * DKIM signature status
+     */
+    dkimSigned: boolean;
+    constructor();
+    /**
+     * Create a new CachedEmail with a unique ID
+     */
+    static createNew(): CachedEmail;
+    /**
+     * Find an email by ID
+     */
+    static findById(id: string): Promise<CachedEmail | null>;
+    /**
+     * Find all emails with a specific status
+     */
+    static findByStatus(status: TCachedEmailStatus): Promise<CachedEmail[]>;
+    /**
+     * Find all emails pending delivery (status = pending and nextAttempt <= now)
+     */
+    static findPendingForDelivery(): Promise<CachedEmail[]>;
+    /**
+     * Find emails by sender domain
+     */
+    static findBySenderDomain(domain: string): Promise<CachedEmail[]>;
+    /**
+     * Mark as delivered
+     */
+    markDelivered(): void;
+    /**
+     * Mark as failed with error
+     */
+    markFailed(error: string): void;
+    /**
+     * Increment attempt counter and schedule next attempt
+     */
+    scheduleRetry(delayMs?: number): void;
+    /**
+     * Extract sender domain from email address
+     */
+    updateSenderDomain(): void;
+}

package/dist_ts/cache/documents/classes.cached.email.js

@@ -0,0 +1,337 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import * as plugins from '../../plugins.js';
+import { CachedDocument, TTL } from '../classes.cached.document.js';
+import { CacheDb } from '../classes.cachedb.js';
+/**
+ * Helper to get the smartdata database instance
+ */
+const getDb = () => CacheDb.getInstance().getDb();
+/**
+ * CachedEmail - Stores email queue items in the cache
+ *
+ * Used for persistent email queue storage, tracking delivery status,
+ * and maintaining email history for the configured TTL period.
+ */
+let CachedEmail = (() => {
+    let _classDecorators = [plugins.smartdata.Collection(() => getDb())];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = CachedDocument;
+    let _createdAt_decorators;
+    let _createdAt_initializers = [];
+    let _createdAt_extraInitializers = [];
+    let _expiresAt_decorators;
+    let _expiresAt_initializers = [];
+    let _expiresAt_extraInitializers = [];
+    let _lastAccessedAt_decorators;
+    let _lastAccessedAt_initializers = [];
+    let _lastAccessedAt_extraInitializers = [];
+    let _id_decorators;
+    let _id_initializers = [];
+    let _id_extraInitializers = [];
+    let _messageId_decorators;
+    let _messageId_initializers = [];
+    let _messageId_extraInitializers = [];
+    let _from_decorators;
+    let _from_initializers = [];
+    let _from_extraInitializers = [];
+    let _to_decorators;
+    let _to_initializers = [];
+    let _to_extraInitializers = [];
+    let _cc_decorators;
+    let _cc_initializers = [];
+    let _cc_extraInitializers = [];
+    let _bcc_decorators;
+    let _bcc_initializers = [];
+    let _bcc_extraInitializers = [];
+    let _subject_decorators;
+    let _subject_initializers = [];
+    let _subject_extraInitializers = [];
+    let _rawContent_decorators;
+    let _rawContent_initializers = [];
+    let _rawContent_extraInitializers = [];
+    let _status_decorators;
+    let _status_initializers = [];
+    let _status_extraInitializers = [];
+    let _attempts_decorators;
+    let _attempts_initializers = [];
+    let _attempts_extraInitializers = [];
+    let _maxAttempts_decorators;
+    let _maxAttempts_initializers = [];
+    let _maxAttempts_extraInitializers = [];
+    let _nextAttempt_decorators;
+    let _nextAttempt_initializers = [];
+    let _nextAttempt_extraInitializers = [];
+    let _lastError_decorators;
+    let _lastError_initializers = [];
+    let _lastError_extraInitializers = [];
+    let _deliveredAt_decorators;
+    let _deliveredAt_initializers = [];
+    let _deliveredAt_extraInitializers = [];
+    let _senderDomain_decorators;
+    let _senderDomain_initializers = [];
+    let _senderDomain_extraInitializers = [];
+    let _priority_decorators;
+    let _priority_initializers = [];
+    let _priority_extraInitializers = [];
+    let _routeData_decorators;
+    let _routeData_initializers = [];
+    let _routeData_extraInitializers = [];
+    let _dkimSigned_decorators;
+    let _dkimSigned_initializers = [];
+    let _dkimSigned_extraInitializers = [];
+    var CachedEmail = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _createdAt_decorators = [plugins.smartdata.svDb()];
+            _expiresAt_decorators = [plugins.smartdata.svDb()];
+            _lastAccessedAt_decorators = [plugins.smartdata.svDb()];
+            _id_decorators = [plugins.smartdata.unI(), plugins.smartdata.svDb()];
+            _messageId_decorators = [plugins.smartdata.svDb()];
+            _from_decorators = [plugins.smartdata.svDb()];
+            _to_decorators = [plugins.smartdata.svDb()];
+            _cc_decorators = [plugins.smartdata.svDb()];
+            _bcc_decorators = [plugins.smartdata.svDb()];
+            _subject_decorators = [plugins.smartdata.svDb()];
+            _rawContent_decorators = [plugins.smartdata.svDb()];
+            _status_decorators = [plugins.smartdata.svDb()];
+            _attempts_decorators = [plugins.smartdata.svDb()];
+            _maxAttempts_decorators = [plugins.smartdata.svDb()];
+            _nextAttempt_decorators = [plugins.smartdata.svDb()];
+            _lastError_decorators = [plugins.smartdata.svDb()];
+            _deliveredAt_decorators = [plugins.smartdata.svDb()];
+            _senderDomain_decorators = [plugins.smartdata.svDb()];
+            _priority_decorators = [plugins.smartdata.svDb()];
+            _routeData_decorators = [plugins.smartdata.svDb()];
+            _dkimSigned_decorators = [plugins.smartdata.svDb()];
+            __esDecorate(null, null, _createdAt_decorators, { kind: "field", name: "createdAt", static: false, private: false, access: { has: obj => "createdAt" in obj, get: obj => obj.createdAt, set: (obj, value) => { obj.createdAt = value; } }, metadata: _metadata }, _createdAt_initializers, _createdAt_extraInitializers);
+            __esDecorate(null, null, _expiresAt_decorators, { kind: "field", name: "expiresAt", static: false, private: false, access: { has: obj => "expiresAt" in obj, get: obj => obj.expiresAt, set: (obj, value) => { obj.expiresAt = value; } }, metadata: _metadata }, _expiresAt_initializers, _expiresAt_extraInitializers);
+            __esDecorate(null, null, _lastAccessedAt_decorators, { kind: "field", name: "lastAccessedAt", static: false, private: false, access: { has: obj => "lastAccessedAt" in obj, get: obj => obj.lastAccessedAt, set: (obj, value) => { obj.lastAccessedAt = value; } }, metadata: _metadata }, _lastAccessedAt_initializers, _lastAccessedAt_extraInitializers);
+            __esDecorate(null, null, _id_decorators, { kind: "field", name: "id", static: false, private: false, access: { has: obj => "id" in obj, get: obj => obj.id, set: (obj, value) => { obj.id = value; } }, metadata: _metadata }, _id_initializers, _id_extraInitializers);
+            __esDecorate(null, null, _messageId_decorators, { kind: "field", name: "messageId", static: false, private: false, access: { has: obj => "messageId" in obj, get: obj => obj.messageId, set: (obj, value) => { obj.messageId = value; } }, metadata: _metadata }, _messageId_initializers, _messageId_extraInitializers);
+            __esDecorate(null, null, _from_decorators, { kind: "field", name: "from", static: false, private: false, access: { has: obj => "from" in obj, get: obj => obj.from, set: (obj, value) => { obj.from = value; } }, metadata: _metadata }, _from_initializers, _from_extraInitializers);
+            __esDecorate(null, null, _to_decorators, { kind: "field", name: "to", static: false, private: false, access: { has: obj => "to" in obj, get: obj => obj.to, set: (obj, value) => { obj.to = value; } }, metadata: _metadata }, _to_initializers, _to_extraInitializers);
+            __esDecorate(null, null, _cc_decorators, { kind: "field", name: "cc", static: false, private: false, access: { has: obj => "cc" in obj, get: obj => obj.cc, set: (obj, value) => { obj.cc = value; } }, metadata: _metadata }, _cc_initializers, _cc_extraInitializers);
+            __esDecorate(null, null, _bcc_decorators, { kind: "field", name: "bcc", static: false, private: false, access: { has: obj => "bcc" in obj, get: obj => obj.bcc, set: (obj, value) => { obj.bcc = value; } }, metadata: _metadata }, _bcc_initializers, _bcc_extraInitializers);
+            __esDecorate(null, null, _subject_decorators, { kind: "field", name: "subject", static: false, private: false, access: { has: obj => "subject" in obj, get: obj => obj.subject, set: (obj, value) => { obj.subject = value; } }, metadata: _metadata }, _subject_initializers, _subject_extraInitializers);
+            __esDecorate(null, null, _rawContent_decorators, { kind: "field", name: "rawContent", static: false, private: false, access: { has: obj => "rawContent" in obj, get: obj => obj.rawContent, set: (obj, value) => { obj.rawContent = value; } }, metadata: _metadata }, _rawContent_initializers, _rawContent_extraInitializers);
+            __esDecorate(null, null, _status_decorators, { kind: "field", name: "status", static: false, private: false, access: { has: obj => "status" in obj, get: obj => obj.status, set: (obj, value) => { obj.status = value; } }, metadata: _metadata }, _status_initializers, _status_extraInitializers);
+            __esDecorate(null, null, _attempts_decorators, { kind: "field", name: "attempts", static: false, private: false, access: { has: obj => "attempts" in obj, get: obj => obj.attempts, set: (obj, value) => { obj.attempts = value; } }, metadata: _metadata }, _attempts_initializers, _attempts_extraInitializers);
+            __esDecorate(null, null, _maxAttempts_decorators, { kind: "field", name: "maxAttempts", static: false, private: false, access: { has: obj => "maxAttempts" in obj, get: obj => obj.maxAttempts, set: (obj, value) => { obj.maxAttempts = value; } }, metadata: _metadata }, _maxAttempts_initializers, _maxAttempts_extraInitializers);
+            __esDecorate(null, null, _nextAttempt_decorators, { kind: "field", name: "nextAttempt", static: false, private: false, access: { has: obj => "nextAttempt" in obj, get: obj => obj.nextAttempt, set: (obj, value) => { obj.nextAttempt = value; } }, metadata: _metadata }, _nextAttempt_initializers, _nextAttempt_extraInitializers);
+            __esDecorate(null, null, _lastError_decorators, { kind: "field", name: "lastError", static: false, private: false, access: { has: obj => "lastError" in obj, get: obj => obj.lastError, set: (obj, value) => { obj.lastError = value; } }, metadata: _metadata }, _lastError_initializers, _lastError_extraInitializers);
+            __esDecorate(null, null, _deliveredAt_decorators, { kind: "field", name: "deliveredAt", static: false, private: false, access: { has: obj => "deliveredAt" in obj, get: obj => obj.deliveredAt, set: (obj, value) => { obj.deliveredAt = value; } }, metadata: _metadata }, _deliveredAt_initializers, _deliveredAt_extraInitializers);
+            __esDecorate(null, null, _senderDomain_decorators, { kind: "field", name: "senderDomain", static: false, private: false, access: { has: obj => "senderDomain" in obj, get: obj => obj.senderDomain, set: (obj, value) => { obj.senderDomain = value; } }, metadata: _metadata }, _senderDomain_initializers, _senderDomain_extraInitializers);
+            __esDecorate(null, null, _priority_decorators, { kind: "field", name: "priority", static: false, private: false, access: { has: obj => "priority" in obj, get: obj => obj.priority, set: (obj, value) => { obj.priority = value; } }, metadata: _metadata }, _priority_initializers, _priority_extraInitializers);
+            __esDecorate(null, null, _routeData_decorators, { kind: "field", name: "routeData", static: false, private: false, access: { has: obj => "routeData" in obj, get: obj => obj.routeData, set: (obj, value) => { obj.routeData = value; } }, metadata: _metadata }, _routeData_initializers, _routeData_extraInitializers);
+            __esDecorate(null, null, _dkimSigned_decorators, { kind: "field", name: "dkimSigned", static: false, private: false, access: { has: obj => "dkimSigned" in obj, get: obj => obj.dkimSigned, set: (obj, value) => { obj.dkimSigned = value; } }, metadata: _metadata }, _dkimSigned_initializers, _dkimSigned_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            CachedEmail = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        // TTL fields from base class (decorators required on concrete class)
+        createdAt = __runInitializers(this, _createdAt_initializers, new Date());
+        expiresAt = (__runInitializers(this, _createdAt_extraInitializers), __runInitializers(this, _expiresAt_initializers, new Date(Date.now() + TTL.DAYS_30)));
+        lastAccessedAt = (__runInitializers(this, _expiresAt_extraInitializers), __runInitializers(this, _lastAccessedAt_initializers, new Date()));
+        /**
+         * Unique identifier for this email
+         */
+        id = (__runInitializers(this, _lastAccessedAt_extraInitializers), __runInitializers(this, _id_initializers, void 0));
+        /**
+         * Email message ID (RFC 822 Message-ID header)
+         */
+        messageId = (__runInitializers(this, _id_extraInitializers), __runInitializers(this, _messageId_initializers, void 0));
+        /**
+         * Sender email address (envelope from)
+         */
+        from = (__runInitializers(this, _messageId_extraInitializers), __runInitializers(this, _from_initializers, void 0));
+        /**
+         * Recipient email addresses
+         */
+        to = (__runInitializers(this, _from_extraInitializers), __runInitializers(this, _to_initializers, void 0));
+        /**
+         * CC recipients
+         */
+        cc = (__runInitializers(this, _to_extraInitializers), __runInitializers(this, _cc_initializers, void 0));
+        /**
+         * BCC recipients
+         */
+        bcc = (__runInitializers(this, _cc_extraInitializers), __runInitializers(this, _bcc_initializers, void 0));
+        /**
+         * Email subject
+         */
+        subject = (__runInitializers(this, _bcc_extraInitializers), __runInitializers(this, _subject_initializers, void 0));
+        /**
+         * Raw RFC822 email content
+         */
+        rawContent = (__runInitializers(this, _subject_extraInitializers), __runInitializers(this, _rawContent_initializers, void 0));
+        /**
+         * Current status of the email
+         */
+        status = (__runInitializers(this, _rawContent_extraInitializers), __runInitializers(this, _status_initializers, void 0));
+        /**
+         * Number of delivery attempts
+         */
+        attempts = (__runInitializers(this, _status_extraInitializers), __runInitializers(this, _attempts_initializers, 0));
+        /**
+         * Maximum number of delivery attempts
+         */
+        maxAttempts = (__runInitializers(this, _attempts_extraInitializers), __runInitializers(this, _maxAttempts_initializers, 3));
+        /**
+         * Timestamp for next delivery attempt
+         */
+        nextAttempt = (__runInitializers(this, _maxAttempts_extraInitializers), __runInitializers(this, _nextAttempt_initializers, void 0));
+        /**
+         * Last error message if delivery failed
+         */
+        lastError = (__runInitializers(this, _nextAttempt_extraInitializers), __runInitializers(this, _lastError_initializers, void 0));
+        /**
+         * Timestamp when the email was successfully delivered
+         */
+        deliveredAt = (__runInitializers(this, _lastError_extraInitializers), __runInitializers(this, _deliveredAt_initializers, void 0));
+        /**
+         * Sender domain (for querying/filtering)
+         */
+        senderDomain = (__runInitializers(this, _deliveredAt_extraInitializers), __runInitializers(this, _senderDomain_initializers, void 0));
+        /**
+         * Priority level (higher = more important)
+         */
+        priority = (__runInitializers(this, _senderDomain_extraInitializers), __runInitializers(this, _priority_initializers, 0));
+        /**
+         * JSON-serialized route data
+         */
+        routeData = (__runInitializers(this, _priority_extraInitializers), __runInitializers(this, _routeData_initializers, void 0));
+        /**
+         * DKIM signature status
+         */
+        dkimSigned = (__runInitializers(this, _routeData_extraInitializers), __runInitializers(this, _dkimSigned_initializers, false));
+        constructor() {
+            super();
+            __runInitializers(this, _dkimSigned_extraInitializers);
+            this.setTTL(TTL.DAYS_30); // Default 30-day TTL
+            this.status = 'pending';
+            this.to = [];
+            this.cc = [];
+            this.bcc = [];
+        }
+        /**
+         * Create a new CachedEmail with a unique ID
+         */
+        static createNew() {
+            const email = new CachedEmail();
+            email.id = plugins.uuid.v4();
+            return email;
+        }
+        /**
+         * Find an email by ID
+         */
+        static async findById(id) {
+            return await CachedEmail.getInstance({
+                id,
+            });
+        }
+        /**
+         * Find all emails with a specific status
+         */
+        static async findByStatus(status) {
+            return await CachedEmail.getInstances({
+                status,
+            });
+        }
+        /**
+         * Find all emails pending delivery (status = pending and nextAttempt <= now)
+         */
+        static async findPendingForDelivery() {
+            const now = new Date();
+            return await CachedEmail.getInstances({
+                status: 'pending',
+                nextAttempt: { $lte: now },
+            });
+        }
+        /**
+         * Find emails by sender domain
+         */
+        static async findBySenderDomain(domain) {
+            return await CachedEmail.getInstances({
+                senderDomain: domain,
+            });
+        }
+        /**
+         * Mark as delivered
+         */
+        markDelivered() {
+            this.status = 'delivered';
+            this.deliveredAt = new Date();
+        }
+        /**
+         * Mark as failed with error
+         */
+        markFailed(error) {
+            this.status = 'failed';
+            this.lastError = error;
+        }
+        /**
+         * Increment attempt counter and schedule next attempt
+         */
+        scheduleRetry(delayMs = 5 * 60 * 1000) {
+            this.attempts++;
+            this.status = 'deferred';
+            this.nextAttempt = new Date(Date.now() + delayMs);
+            // If max attempts reached, mark as failed
+            if (this.attempts >= this.maxAttempts) {
+                this.status = 'failed';
+                this.lastError = `Max attempts (${this.maxAttempts}) reached`;
+            }
+        }
+        /**
+         * Extract sender domain from email address
+         */
+        updateSenderDomain() {
+            if (this.from) {
+                const match = this.from.match(/@([^>]+)>?$/);
+                if (match) {
+                    this.senderDomain = match[1].toLowerCase();
+                }
+            }
+        }
+    };
+    return CachedEmail = _classThis;
+})();
+export { CachedEmail };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jYWNoZWQuZW1haWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi90cy9jYWNoZS9kb2N1bWVudHMvY2xhc3Nlcy5jYWNoZWQuZW1haWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxFQUFFLGNBQWMsRUFBRSxHQUFHLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUNwRSxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFPaEQ7O0dBRUc7QUFDSCxNQUFNLEtBQUssR0FBRyxHQUFHLEVBQUUsQ0FBQyxPQUFPLENBQUMsV0FBVyxFQUFFLENBQUMsS0FBSyxFQUFFLENBQUM7QUFFbEQ7Ozs7O0dBS0c7SUFFVSxXQUFXOzRCQUR2QixPQUFPLENBQUMsU0FBUyxDQUFDLFVBQVUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxLQUFLLEVBQUUsQ0FBQzs7OztzQkFDWCxjQUFjOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OzJCQUF0QixTQUFRLFdBQTJCOzs7O3FDQUV6RCxPQUFPLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRTtxQ0FHeEIsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUU7MENBR3hCLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFOzhCQU14QixPQUFPLENBQUMsU0FBUyxDQUFDLEdBQUcsRUFBRSxFQUN2QixPQUFPLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRTtxQ0FNeEIsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUU7Z0NBTXhCLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFOzhCQU14QixPQUFPLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRTs4QkFNeEIsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUU7K0JBTXhCLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFO21DQU14QixPQUFPLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRTtzQ0FNeEIsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUU7a0NBTXhCLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFO29DQU14QixPQUFPLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRTt1Q0FNeEIsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUU7dUNBTXhCLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFO3FDQU14QixPQUFPLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRTt1Q0FNeEIsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUU7d0NBTXhCLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFO29DQU14QixPQUFPLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRTtxQ0FNeEIsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUU7c0NBTXhCLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFO1lBbEh6Qiw2S0FBTyxTQUFTLDZCQUFULFNBQVMsNkZBQW9CO1lBR3BDLDZLQUFPLFNBQVMsNkJBQVQsU0FBUyw2RkFBNEM7WUFHNUQsNExBQU8sY0FBYyw2QkFBZCxjQUFjLHVHQUFvQjtZQU96Qyx3SkFBTyxFQUFFLDZCQUFGLEVBQUUsK0VBQVM7WUFNbEIsNktBQU8sU0FBUyw2QkFBVCxTQUFTLDZGQUFTO1lBTXpCLDhKQUFPLElBQUksNkJBQUosSUFBSSxtRkFBUztZQU1wQix3SkFBTyxFQUFFLDZCQUFGLEVBQUUsK0VBQVc7WUFNcEIsd0pBQU8sRUFBRSw2QkFBRixFQUFFLCtFQUFXO1lBTXBCLDJKQUFPLEdBQUcsNkJBQUgsR0FBRyxpRkFBVztZQU1yQix1S0FBTyxPQUFPLDZCQUFQLE9BQU8seUZBQVM7WUFNdkIsZ0xBQU8sVUFBVSw2QkFBVixVQUFVLCtGQUFTO1lBTTFCLG9LQUFPLE1BQU0sNkJBQU4sTUFBTSx1RkFBcUI7WUFNbEMsMEtBQU8sUUFBUSw2QkFBUixRQUFRLDJGQUFhO1lBTTVCLG1MQUFPLFdBQVcsNkJBQVgsV0FBVyxpR0FBYTtZQU0vQixtTEFBTyxXQUFXLDZCQUFYLFdBQVcsaUdBQU87WUFNekIsNktBQU8sU0FBUyw2QkFBVCxTQUFTLDZGQUFTO1lBTXpCLG1MQUFPLFdBQVcsNkJBQVgsV0FBVyxpR0FBTztZQU16QixzTEFBTyxZQUFZLDZCQUFaLFlBQVksbUdBQVM7WUFNNUIsMEtBQU8sUUFBUSw2QkFBUixRQUFRLDJGQUFhO1lBTTVCLDZLQUFPLFNBQVMsNkJBQVQsU0FBUyw2RkFBUztZQU16QixnTEFBTyxVQUFVLDZCQUFWLFVBQVUsK0ZBQWtCO1lBdEhyQyw2S0EwTkM7OztZQTFOWSx1REFBVzs7UUFDdEIscUVBQXFFO1FBRTlELFNBQVMsb0RBQVMsSUFBSSxJQUFJLEVBQUUsRUFBQztRQUc3QixTQUFTLDRHQUFTLElBQUksSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxHQUFHLENBQUMsT0FBTyxDQUFDLEdBQUM7UUFHckQsY0FBYyxpSEFBUyxJQUFJLElBQUksRUFBRSxHQUFDO1FBRXpDOztXQUVHO1FBR0ksRUFBRSxtSEFBUztRQUVsQjs7V0FFRztRQUVJLFNBQVMsOEdBQVM7UUFFekI7O1dBRUc7UUFFSSxJQUFJLGdIQUFTO1FBRXBCOztXQUVHO1FBRUksRUFBRSx5R0FBVztRQUVwQjs7V0FFRztRQUVJLEVBQUUsdUdBQVc7UUFFcEI7O1dBRUc7UUFFSSxHQUFHLHdHQUFXO1FBRXJCOztXQUVHO1FBRUksT0FBTyw2R0FBUztRQUV2Qjs7V0FFRztRQUVJLFVBQVUsb0hBQVM7UUFFMUI7O1dBRUc7UUFFSSxNQUFNLG1IQUFxQjtRQUVsQzs7V0FFRztRQUVJLFFBQVEsd0dBQVcsQ0FBQyxHQUFDO1FBRTVCOztXQUVHO1FBRUksV0FBVyw2R0FBVyxDQUFDLEdBQUM7UUFFL0I7O1dBRUc7UUFFSSxXQUFXLHlIQUFPO1FBRXpCOztXQUVHO1FBRUksU0FBUyx1SEFBUztRQUV6Qjs7V0FFRztRQUVJLFdBQVcsdUhBQU87UUFFekI7O1dBRUc7UUFFSSxZQUFZLDBIQUFTO1FBRTVCOztXQUVHO1FBRUksUUFBUSw4R0FBVyxDQUFDLEdBQUM7UUFFNUI7O1dBRUc7UUFFSSxTQUFTLG9IQUFTO1FBRXpCOztXQUVHO1FBRUksVUFBVSw2R0FBWSxLQUFLLEdBQUM7UUFFbkM7WUFDRSxLQUFLLEVBQUUsQ0FBQzs7WUFDUixJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLHFCQUFxQjtZQUMvQyxJQUFJLENBQUMsTUFBTSxHQUFHLFNBQVMsQ0FBQztZQUN4QixJQUFJLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQztZQUNiLElBQUksQ0FBQyxFQUFFLEdBQUcsRUFBRSxDQUFDO1lBQ2IsSUFBSSxDQUFDLEdBQUcsR0FBRyxFQUFFLENBQUM7U0FDZjtRQUVEOztXQUVHO1FBQ0ksTUFBTSxDQUFDLFNBQVM7WUFDckIsTUFBTSxLQUFLLEdBQUcsSUFBSSxXQUFXLEVBQUUsQ0FBQztZQUNoQyxLQUFLLENBQUMsRUFBRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsRUFBRSxFQUFFLENBQUM7WUFDN0IsT0FBTyxLQUFLLENBQUM7UUFDZixDQUFDO1FBRUQ7O1dBRUc7UUFDSSxNQUFNLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxFQUFVO1lBQ3JDLE9BQU8sTUFBTSxXQUFXLENBQUMsV0FBVyxDQUFDO2dCQUNuQyxFQUFFO2FBQ0gsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztRQUVEOztXQUVHO1FBQ0ksTUFBTSxDQUFDLEtBQUssQ0FBQyxZQUFZLENBQUMsTUFBMEI7WUFDekQsT0FBTyxNQUFNLFdBQVcsQ0FBQyxZQUFZLENBQUM7Z0JBQ3BDLE1BQU07YUFDUCxDQUFDLENBQUM7UUFDTCxDQUFDO1FBRUQ7O1dBRUc7UUFDSSxNQUFNLENBQUMsS0FBSyxDQUFDLHNCQUFzQjtZQUN4QyxNQUFNLEdBQUcsR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDO1lBQ3ZCLE9BQU8sTUFBTSxXQUFXLENBQUMsWUFBWSxDQUFDO2dCQUNwQyxNQUFNLEVBQUUsU0FBUztnQkFDakIsV0FBVyxFQUFFLEVBQUUsSUFBSSxFQUFFLEdBQUcsRUFBRTthQUMzQixDQUFDLENBQUM7UUFDTCxDQUFDO1FBRUQ7O1dBRUc7UUFDSSxNQUFNLENBQUMsS0FBSyxDQUFDLGtCQUFrQixDQUFDLE1BQWM7WUFDbkQsT0FBTyxNQUFNLFdBQVcsQ0FBQyxZQUFZLENBQUM7Z0JBQ3BDLFlBQVksRUFBRSxNQUFNO2FBQ3JCLENBQUMsQ0FBQztRQUNMLENBQUM7UUFFRDs7V0FFRztRQUNJLGFBQWE7WUFDbEIsSUFBSSxDQUFDLE1BQU0sR0FBRyxXQUFXLENBQUM7WUFDMUIsSUFBSSxDQUFDLFdBQVcsR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDO1FBQ2hDLENBQUM7UUFFRDs7V0FFRztRQUNJLFVBQVUsQ0FBQyxLQUFhO1lBQzdCLElBQUksQ0FBQyxNQUFNLEdBQUcsUUFBUSxDQUFDO1lBQ3ZCLElBQUksQ0FBQyxTQUFTLEdBQUcsS0FBSyxDQUFDO1FBQ3pCLENBQUM7UUFFRDs7V0FFRztRQUNJLGFBQWEsQ0FBQyxVQUFrQixDQUFDLEdBQUcsRUFBRSxHQUFHLElBQUk7WUFDbEQsSUFBSSxDQUFDLFFBQVEsRUFBRSxDQUFDO1lBQ2hCLElBQUksQ0FBQyxNQUFNLEdBQUcsVUFBVSxDQUFDO1lBQ3pCLElBQUksQ0FBQyxXQUFXLEdBQUcsSUFBSSxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxHQUFHLE9BQU8sQ0FBQyxDQUFDO1lBRWxELDBDQUEwQztZQUMxQyxJQUFJLElBQUksQ0FBQyxRQUFRLElBQUksSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDO2dCQUN0QyxJQUFJLENBQUMsTUFBTSxHQUFHLFFBQVEsQ0FBQztnQkFDdkIsSUFBSSxDQUFDLFNBQVMsR0FBRyxpQkFBaUIsSUFBSSxDQUFDLFdBQVcsV0FBVyxDQUFDO1lBQ2hFLENBQUM7UUFDSCxDQUFDO1FBRUQ7O1dBRUc7UUFDSSxrQkFBa0I7WUFDdkIsSUFBSSxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7Z0JBQ2QsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsYUFBYSxDQUFDLENBQUM7Z0JBQzdDLElBQUksS0FBSyxFQUFFLENBQUM7b0JBQ1YsSUFBSSxDQUFDLFlBQVksR0FBRyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsV0FBVyxFQUFFLENBQUM7Z0JBQzdDLENBQUM7WUFDSCxDQUFDO1FBQ0gsQ0FBQzs7OztTQXpOVSxXQUFXIn0=

package/dist_ts/cache/documents/classes.cached.ip.reputation.d.ts

@@ -0,0 +1,119 @@
+import { CachedDocument } from '../classes.cached.document.js';
+/**
+ * IP reputation result data
+ */
+export interface IIPReputationData {
+    score: number;
+    isSpam: boolean;
+    isProxy: boolean;
+    isTor: boolean;
+    isVPN: boolean;
+    country?: string;
+    asn?: string;
+    org?: string;
+    blacklists?: string[];
+}
+/**
+ * CachedIPReputation - Stores IP reputation lookup results
+ *
+ * Caches the results of IP reputation checks to avoid repeated
+ * external API calls. Default TTL is 24 hours.
+ */
+export declare class CachedIPReputation extends CachedDocument<CachedIPReputation> {
+    createdAt: Date;
+    expiresAt: Date;
+    lastAccessedAt: Date;
+    /**
+     * IP address (unique identifier)
+     */
+    ipAddress: string;
+    /**
+     * Reputation score (0-100, higher = better)
+     */
+    score: number;
+    /**
+     * Whether the IP is flagged as spam source
+     */
+    isSpam: boolean;
+    /**
+     * Whether the IP is a known proxy
+     */
+    isProxy: boolean;
+    /**
+     * Whether the IP is a Tor exit node
+     */
+    isTor: boolean;
+    /**
+     * Whether the IP is a VPN endpoint
+     */
+    isVPN: boolean;
+    /**
+     * Country code (ISO 3166-1 alpha-2)
+     */
+    country: string;
+    /**
+     * Autonomous System Number
+     */
+    asn: string;
+    /**
+     * Organization name
+     */
+    org: string;
+    /**
+     * List of blacklists the IP appears on
+     */
+    blacklists: string[];
+    /**
+     * Number of times this IP has been checked
+     */
+    checkCount: number;
+    /**
+     * Number of connections from this IP
+     */
+    connectionCount: number;
+    /**
+     * Number of emails received from this IP
+     */
+    emailCount: number;
+    /**
+     * Number of spam emails from this IP
+     */
+    spamCount: number;
+    constructor();
+    /**
+     * Create from reputation data
+     */
+    static fromReputationData(ipAddress: string, data: IIPReputationData): CachedIPReputation;
+    /**
+     * Convert to reputation data object
+     */
+    toReputationData(): IIPReputationData;
+    /**
+     * Find by IP address
+     */
+    static findByIP(ipAddress: string): Promise<CachedIPReputation | null>;
+    /**
+     * Find all IPs flagged as spam
+     */
+    static findSpamIPs(): Promise<CachedIPReputation[]>;
+    /**
+     * Find IPs with score below threshold
+     */
+    static findLowScoreIPs(threshold: number): Promise<CachedIPReputation[]>;
+    /**
+     * Record a connection from this IP
+     */
+    recordConnection(): void;
+    /**
+     * Record an email from this IP
+     */
+    recordEmail(isSpam?: boolean): void;
+    /**
+     * Update the reputation data
+     */
+    updateReputation(data: IIPReputationData): void;
+    /**
+     * Check if this IP should be blocked
+     */
+    shouldBlock(): boolean;
+}