@push.rocks/smartmta 8.1.0 → 8.2.0

package/changelog.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 2026-07-21 - 8.2.0
+
+### Features
+
+- support permanent SMTP envelope rejections from accept hooks (routing)
+  - Add AcceptEnvelopeRejectionError so onAcceptEnvelope consumers can reject envelopes with custom 5xx SMTP responses.
+  - Handle policy rejections separately from infrastructure failures to avoid returning generic temporary failures.
+
+## 2026-07-21 - 8.1.1
+
+### Features
+
+- add exact accepted-envelope dispatch for durable consumers
+  - Snapshot resolved per-recipient actions as immutable JSON-safe plans and replay them without consulting live routes.
+  - Scope parsed messages and SMTP sessions per envelope recipient while preserving the accepted raw RFC822 bytes unchanged.
+  - Queue forward, process, and deliver actions with durable deterministic idempotency keys and return their queue IDs.
+  - Persist bounded replay checkpoints through caller-managed storage; no filesystem persistence is introduced.
+  - Add backend-bounded prefix pagination and use it for convergent checkpoint and queue-tombstone cleanup.
+- add exact accepted-envelope dispatch (accepted-envelope-dispatch)
+  - Snapshot resolved per-recipient actions as immutable JSON-safe plans for replay without consulting live routes.
+  - Queue forward, process, and deliver actions with deterministic durable idempotency keys and return queue IDs.
+  - Add accepted-envelope replay checkpoints with bounded cleanup backed by caller-managed storage.
+  - Introduce backend-bounded prefix pagination and use it for checkpoint and queue tombstone cleanup.
+
 ## 2026-07-21 - 8.1.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@push.rocks/smartmta',
-    version: '8.1.0',
+    version: '8.2.0',
     description: 'A high-performance, enterprise-grade Mail Transfer Agent (MTA) built from scratch in TypeScript with Rust acceleration.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxzQkFBc0I7SUFDNUIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHlIQUF5SDtDQUN2SSxDQUFBIn0=

package/dist_ts/index.d.ts

@@ -12,4 +12,5 @@ export declare const smartMtaCapabilities: Readonly<{
     readonly outboundAttachments: true;
     readonly topologyAwareSelfMx: true;
     readonly durableDeliveryFailureOutbox: true;
+    readonly exactAcceptedEnvelopeDispatch: true;
 }>;

package/dist_ts/index.js

@@ -12,5 +12,6 @@ export const smartMtaCapabilities = Object.freeze({
     outboundAttachments: true,
     topologyAwareSelfMx: true,
     durableDeliveryFailureOutbox: true,
+    exactAcceptedEnvelopeDispatch: true,
 });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUVqRCxNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDO0lBQ2hELDBCQUEwQixFQUFFLElBQUk7SUFDaEMscUJBQXFCLEVBQUUsSUFBSTtJQUMzQiwwQkFBMEIsRUFBRSxJQUFJO0lBQ2hDLHFCQUFxQixFQUFFLElBQUk7SUFDM0Isb0JBQW9CLEVBQUUsSUFBSTtJQUMxQixpQkFBaUIsRUFBRSxJQUFJO0lBQ3ZCLG1CQUFtQixFQUFFLElBQUk7SUFDekIsbUJBQW1CLEVBQUUsSUFBSTtJQUN6Qiw0QkFBNEIsRUFBRSxJQUFJO0NBQzFCLENBQUMsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUVqRCxNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDO0lBQ2hELDBCQUEwQixFQUFFLElBQUk7SUFDaEMscUJBQXFCLEVBQUUsSUFBSTtJQUMzQiwwQkFBMEIsRUFBRSxJQUFJO0lBQ2hDLHFCQUFxQixFQUFFLElBQUk7SUFDM0Isb0JBQW9CLEVBQUUsSUFBSTtJQUMxQixpQkFBaUIsRUFBRSxJQUFJO0lBQ3ZCLG1CQUFtQixFQUFFLElBQUk7SUFDekIsbUJBQW1CLEVBQUUsSUFBSTtJQUN6Qiw0QkFBNEIsRUFBRSxJQUFJO0lBQ2xDLDZCQUE2QixFQUFFLElBQUk7Q0FDM0IsQ0FBQyxDQUFDIn0=

package/dist_ts/mail/delivery/classes.delivery.queue.d.ts

@@ -41,6 +41,10 @@ export interface IBounceOperation {
  */
 export interface IQueueItem {
     id: string;
+    /** Stable caller-supplied key used to make enqueue replay-safe. */
+    idempotencyKey?: string;
+    /** Fingerprint of the exact work associated with the idempotency key. */
+    idempotencyFingerprint?: string;
     processingMode: EmailProcessingMode;
     processingResult: Email;
     /** Materialized attachment count for queue/detail consumers. */
@@ -59,6 +63,7 @@ export interface IQueueItem {
     bounceOperations?: IBounceOperation[];
     smtpTransactions?: ISmtpTransactionAttempt[];
 }
+export declare const ACCEPTED_ENVELOPE_IDEMPOTENCY_RETENTION_MS: number;
 export interface IQueueFailureOptions {
     /** Unknown failures default to retryable so temporary internal faults do not lose mail. */
     retryable?: boolean;
@@ -90,6 +95,14 @@ export interface IQueueOptions {
     baseRetryDelay?: number;
     maxRetryDelay?: number;
 }
+export interface IQueueEnqueueOptions {
+    /** Stable key that resolves to one deterministic queue item id. */
+    idempotencyKey?: string;
+    /** Required with idempotencyKey to reject reuse for different work. */
+    idempotencyFingerprint?: string;
+    /** Fail closed unless the queue is backed by managed blob storage. */
+    requireDurable?: boolean;
+}
 export interface IQueueStats {
     queueSize: number;
     status: {
@@ -123,12 +136,25 @@ export declare class UnifiedDeliveryQueue extends EventEmitter {
     private totalProcessed;
     private ownsManagedPrefix;
     private lifecycleState;
+    private readonly idempotentEnqueueFlights;
+    private idempotencyTombstoneCleanupCursor?;
     /**
      * Create a new unified delivery queue
      * @param options Queue options
      */
     constructor(options: IQueueOptions);
     private assertMutable;
+    /** Whether queue entries are committed through caller-managed blob storage. */
+    hasManagedStorage(): boolean;
+    /** Whether managed storage can list a backend-bounded page of keys. */
+    hasPaginatedManagedStorage(): boolean;
+    private idempotentQueueId;
+    private idempotencyTombstonePrefix;
+    private idempotencyTombstoneKey;
+    private readIdempotencyTombstone;
+    private parseIdempotencyTombstone;
+    private persistIdempotencyTombstone;
+    private cleanupExpiredIdempotencyTombstones;
     private createInitialRecipientStates;
     private createBounceOperationId;
     /**
@@ -157,7 +183,8 @@ export declare class UnifiedDeliveryQueue extends EventEmitter {
      * @param mode Processing mode
      * @param route Email route
      */
-    enqueue(processingResult: Email, mode: EmailProcessingMode, route?: IEmailRoute): Promise<string>;
+    enqueue(processingResult: Email, mode: EmailProcessingMode, route?: IEmailRoute, enqueueOptions?: IQueueEnqueueOptions): Promise<string>;
+    private enqueueNew;
     /**
      * Get an item from the queue
      * @param id Item ID