@push.rocks/smartmta 8.2.1 → 9.0.0

package/dist_ts/mail/routing/classes.unified.email.server.d.ts

@@ -86,8 +86,9 @@ export declare class AcceptEnvelopeRejectionError extends Error {
     constructor(smtpCode: number, smtpMessage: string);
 }
 /**
- * Terminal durable acceptance context for an envelope containing at least one `store` route.
- * The consumer owns persistence and all recipient fan-out before this hook resolves.
+ * Terminal durable acceptance context for an envelope containing at least one
+ * `store` or `deliver` route. The consumer owns persistence and all recipient
+ * fan-out before this hook resolves.
  */
 export interface IAcceptEnvelopeContext {
     email: Email;
@@ -240,9 +241,14 @@ export interface IUnifiedEmailServerOptions {
     hooks?: {
         /** Async recipient policy hook that may further restrict an accepted built-in decision. */
         onRcptTo?: (context: IRcptToPolicyContext) => Promise<ISmtpDecision>;
-        /** Async message acceptance hook for envelopes with no resolved `store` action. */
+        /** Async message acceptance hook for envelopes with no resolved `store` or `deliver` action. */
         onMessageData?: (context: IMessageAcceptanceContext) => Promise<IMessageAcceptanceDecision>;
-        /** Required terminal durable owner for any envelope containing a resolved `store` action. */
+        /**
+         * Required terminal durable owner for any envelope containing a resolved
+         * `store` or `deliver` action. The hook must durably persist the exact
+         * raw message before resolving; its resolution is what authorizes the
+         * SMTP 250 for those envelopes.
+         */
         onAcceptEnvelope?: (context: IAcceptEnvelopeContext) => Promise<void>;
         /** Observer-safe callback for SMTP recipient rejections. */
         onRecipientRejected?: (event: IRecipientRejectedEvent) => Promise<void> | void;
@@ -459,6 +465,13 @@ export declare class UnifiedEmailServer extends EventEmitter {
      * Generate SmartProxy routes for email ports
      */
     generateProxyRoutes(portMapping?: Record<number, number>): any[];
+    /**
+     * Server-level action policy for a single route. A `deliver` action is a
+     * terminal local delivery owned by the durable `hooks.onAcceptEnvelope`
+     * acceptance path; without that hook the route could only accept-then-fail,
+     * so it is rejected at configuration time instead.
+     */
+    private assertRouteActionServable;
     /**
      * Update server configuration
      */