@serve.zone/dcrouter 16.5.0 → 17.1.0

package/dist_ts/dns/txt-record-presentation.js

@@ -0,0 +1,131 @@
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder('utf-8', { fatal: true });
+function appendCharacterBytes(target, character) {
+    target.push(...textEncoder.encode(character));
+}
+/**
+ * Decode the representation returned by DNS provider APIs for TXT records.
+ *
+ * Cloudflare uses RFC 1035 presentation syntax (one or more adjacent quoted
+ * character strings). Some older API responses and dcrouter mirrors contain
+ * the already-decoded payload, so an unquoted input is accepted as canonical.
+ * A value that starts as presentation syntax must parse completely; malformed
+ * quoting or escaping is never repaired by stripping quote characters.
+ */
+export function decodeTxtRecordContent(input) {
+    const source = input.trim();
+    if (!source.startsWith('"')) {
+        return { ok: true, value: source, wasPresentation: false };
+    }
+    const bytes = [];
+    let index = 0;
+    let chunkCount = 0;
+    while (index < source.length) {
+        while (/\s/.test(source[index] || ''))
+            index++;
+        if (index >= source.length)
+            break;
+        if (source[index] !== '"') {
+            return { ok: false, error: `Unexpected TXT presentation content at offset ${index}` };
+        }
+        chunkCount++;
+        index++;
+        let closed = false;
+        while (index < source.length) {
+            const character = source[index];
+            if (character === '"') {
+                index++;
+                closed = true;
+                break;
+            }
+            if (character === '\\') {
+                index++;
+                if (index >= source.length) {
+                    return { ok: false, error: 'TXT presentation ends with an incomplete escape' };
+                }
+                if (/\d/.test(source[index])) {
+                    const decimalEscape = source.slice(index, index + 3);
+                    if (!/^\d{3}$/.test(decimalEscape)) {
+                        return { ok: false, error: `Invalid TXT decimal escape at offset ${index - 1}` };
+                    }
+                    const byte = Number.parseInt(decimalEscape, 10);
+                    if (byte > 255) {
+                        return { ok: false, error: `TXT decimal escape exceeds 255 at offset ${index - 1}` };
+                    }
+                    bytes.push(byte);
+                    index += 3;
+                    continue;
+                }
+                const escapedCodePoint = source.codePointAt(index);
+                if (escapedCodePoint === undefined) {
+                    return { ok: false, error: `Invalid TXT escape at offset ${index - 1}` };
+                }
+                const escapedCharacter = String.fromCodePoint(escapedCodePoint);
+                appendCharacterBytes(bytes, escapedCharacter);
+                index += escapedCharacter.length;
+                continue;
+            }
+            const codePoint = source.codePointAt(index);
+            if (codePoint === undefined) {
+                return { ok: false, error: `Invalid TXT character at offset ${index}` };
+            }
+            const nextCharacter = String.fromCodePoint(codePoint);
+            appendCharacterBytes(bytes, nextCharacter);
+            index += nextCharacter.length;
+        }
+        if (!closed) {
+            return { ok: false, error: 'TXT presentation contains an unterminated character string' };
+        }
+        while (/\s/.test(source[index] || ''))
+            index++;
+        if (index < source.length && source[index] !== '"') {
+            return { ok: false, error: `Unexpected TXT presentation content at offset ${index}` };
+        }
+    }
+    if (chunkCount === 0) {
+        return { ok: false, error: 'TXT presentation contains no character strings' };
+    }
+    try {
+        return { ok: true, value: textDecoder.decode(Uint8Array.from(bytes)), wasPresentation: true };
+    }
+    catch {
+        return { ok: false, error: 'TXT presentation is not valid UTF-8' };
+    }
+}
+function escapeTxtChunk(chunk) {
+    let result = '';
+    for (const character of chunk) {
+        const codePoint = character.codePointAt(0);
+        if (character === '"' || character === '\\') {
+            result += `\\${character}`;
+        }
+        else if (codePoint < 32 || codePoint === 127) {
+            for (const byte of textEncoder.encode(character)) {
+                result += `\\${byte.toString(10).padStart(3, '0')}`;
+            }
+        }
+        else {
+            result += character;
+        }
+    }
+    return result;
+}
+/** Encode a canonical TXT payload as Cloudflare/RFC 1035 presentation text. */
+export function encodeCloudflareTxtContent(value) {
+    const chunks = [];
+    let current = '';
+    let currentBytes = 0;
+    for (const character of value) {
+        const characterBytes = textEncoder.encode(character).length;
+        if (currentBytes > 0 && currentBytes + characterBytes > 255) {
+            chunks.push(current);
+            current = '';
+            currentBytes = 0;
+        }
+        current += character;
+        currentBytes += characterBytes;
+    }
+    chunks.push(current);
+    return chunks.map((chunk) => `"${escapeTxtChunk(chunk)}"`).join(' ');
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHh0LXJlY29yZC1wcmVzZW50YXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9kbnMvdHh0LXJlY29yZC1wcmVzZW50YXRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBSUEsTUFBTSxXQUFXLEdBQUcsSUFBSSxXQUFXLEVBQUUsQ0FBQztBQUN0QyxNQUFNLFdBQVcsR0FBRyxJQUFJLFdBQVcsQ0FBQyxPQUFPLEVBQUUsRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztBQUU5RCxTQUFTLG9CQUFvQixDQUFDLE1BQWdCLEVBQUUsU0FBaUI7SUFDL0QsTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLFdBQVcsQ0FBQyxNQUFNLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQztBQUNoRCxDQUFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLFVBQVUsc0JBQXNCLENBQUMsS0FBYTtJQUNsRCxNQUFNLE1BQU0sR0FBRyxLQUFLLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDNUIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUM1QixPQUFPLEVBQUUsRUFBRSxFQUFFLElBQUksRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLGVBQWUsRUFBRSxLQUFLLEVBQUUsQ0FBQztJQUM3RCxDQUFDO0lBRUQsTUFBTSxLQUFLLEdBQWEsRUFBRSxDQUFDO0lBQzNCLElBQUksS0FBSyxHQUFHLENBQUMsQ0FBQztJQUNkLElBQUksVUFBVSxHQUFHLENBQUMsQ0FBQztJQUNuQixPQUFPLEtBQUssR0FBRyxNQUFNLENBQUMsTUFBTSxFQUFFLENBQUM7UUFDN0IsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLENBQUM7WUFBRSxLQUFLLEVBQUUsQ0FBQztRQUMvQyxJQUFJLEtBQUssSUFBSSxNQUFNLENBQUMsTUFBTTtZQUFFLE1BQU07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

package/dist_ts/email/classes.accepted-email-spool.d.ts

@@ -1,9 +1,11 @@
 import * as plugins from '../plugins.js';
-import type { TCachedEmailDirection } from '../db/documents/classes.cached.email.js';
-import type { IExtendedSmtpSession, IMessageAcceptanceContext, IMessageAcceptanceDecision } from '@push.rocks/smartmta';
+import { CachedEmail } from '../db/index.js';
+import type { ICachedEmailSmtpTransaction, TCachedEmailDirection } from '../db/documents/classes.cached.email.js';
+import type { IExtendedSmtpSession, IMessageAcceptanceContext, IMessageAcceptanceDecision, UnifiedEmailServer } from '@push.rocks/smartmta';
 import type { DcRouter } from '../classes.dcrouter.js';
 export declare const DCROUTER_CACHE_ID_HEADER = "X-Dcrouter-Cached-Email-Id";
 export type TSmartMtaQueueItemLike = {
+    id?: string;
     processingResult?: {
         headers?: Record<string, string>;
         email?: {
@@ -14,7 +16,17 @@ export type TSmartMtaQueueItemLike = {
     attempts?: number;
     nextAttempt?: Date;
     lastError?: string;
+    smtpTransactions?: ICachedEmailSmtpTransaction[];
 };
+export interface IEmailQueuePersistedEvent {
+    cachedEmailId: string;
+    status: string;
+    reason: string;
+}
+export interface ISmtpTransactionPersistedEvent {
+    cachedEmailId: string;
+    transaction: ICachedEmailSmtpTransaction;
+}
 export interface IAcceptRawEmailOptions {
     rawMessage: string | plugins.buffer.Buffer;
     envelope: {
@@ -40,6 +52,9 @@ export declare class AcceptedEmailSpool {
     private processing;
     private stopping;
     private queueUpdatePromises;
+    private cachedEmailUpdateChains;
+    private smtpTransactionListeners;
+    private emailQueuePersistedListeners;
     constructor(dcRouterRef: DcRouter);
     acceptMessage(context: IMessageAcceptanceContext, processAfterAccept?: boolean): Promise<IMessageAcceptanceDecision>;
     acceptRawMessage(optionsArg: IAcceptRawEmailOptions): Promise<IMessageAcceptanceDecision & {
@@ -53,8 +68,16 @@ export declare class AcceptedEmailSpool {
     stop(): Promise<void>;
     /** Kick off a spool run unless one is already in flight. */
     run(): void;
-    trackQueueUpdate(item: TSmartMtaQueueItemLike, status: 'queued' | 'deferred' | 'delivered' | 'failed', failureMessage: string): void;
+    trackQueueUpdate(item: TSmartMtaQueueItemLike, status: 'queued' | 'deferred' | 'delivered' | 'failed', failureMessage: string): Promise<void>;
+    trackSmtpTransaction(transactionArg: ICachedEmailSmtpTransaction, emailServerArg: UnifiedEmailServer): Promise<void>;
+    /** Subscribe to updates only after the SMTP transaction is durably stored. */
+    onSmtpTransactionPersisted(listenerArg: (eventArg: ISmtpTransactionPersistedEvent) => void | Promise<void>): () => void;
+    /** Subscribe to queue state changes only after the CachedEmail row is durable. */
+    onEmailQueuePersisted(listenerArg: (eventArg: IEmailQueuePersistedEvent) => void | Promise<void>): () => void;
+    private notifyEmailQueuePersisted;
     drainQueueUpdates(): Promise<void>;
+    /** Reconcile persisted queue traces after restart before queue recovery runs. */
+    recoverSmtpTransactionHistory(emailServerArg: UnifiedEmailServer): Promise<void>;
     /** Requeue emails left in 'queued' state by a previous process as pending. */
     recoverQueuedEmails(): Promise<void>;
     private processSpool;
@@ -73,6 +96,12 @@ export declare class AcceptedEmailSpool {
     private getLiveQueueItemForCachedEmail;
     private getHeaderValue;
     private updateSmartMtaRouteData;
+    readRawMessage(cachedEmailArg: CachedEmail): Promise<plugins.buffer.Buffer>;
+    deleteRawMessage(cachedEmailArg: CachedEmail): Promise<void>;
+    private persistRawMessage;
+    private runCachedEmailUpdate;
+    private trackUpdatePromise;
+    private appendSmtpTransaction;
     private removeHeader;
     private throwIfMessageAcceptanceAborted;
 }