@upyo/smtp 0.6.0-dev.311 → 0.6.0-dev.314

package/dist/index.d.cts

@@ -79,12 +79,24 @@ interface DkimSignature {
  * @since 0.4.0
  */
 type DkimSigningFailureAction = "throw" | "send-unsigned";
+/**
+ * Whether signing buffers the MIME body once or reads replayable sources twice.
+ * @since 0.6.0
+ */
+type DkimBodyMode = "buffered" | "streaming";
 /**
  * Configuration for DKIM signing in SMTP transport.
  *
  * @since 0.4.0
  */
 interface DkimConfig {
+  /**
+   * Body processing strategy. Streaming uses bounded attachment memory but
+   * requires a second source read; buffered reads once and retains all MIME.
+   * @default "buffered"
+   * @since 0.6.0
+   */
+  readonly bodyMode?: DkimBodyMode;
   /**
    * Array of DKIM signature configurations.
    * Each configuration will result in one DKIM-Signature header.
@@ -97,9 +109,9 @@ interface DkimConfig {
   readonly onSigningFailure?: DkimSigningFailureAction;
 }
 /**
- * Result of DKIM signing operation.
- *
- * @since 0.4.0
+ * Validates the runtime body-mode option without changing config identity.
+ * @param config Optional signing configuration.
+ * @throws {TypeError} If the body mode is unsupported.
  */
 //#endregion
 //#region src/config.d.ts
@@ -850,6 +862,17 @@ declare class SmtpAuthError extends Error {
  * @returns The Base64-encoded XOAUTH2 initial client response.
  * @since 0.5.0
  */
+//#endregion
+//#region src/message-stream.d.ts
+/**
+ * A replayable attachment changed between DKIM body reads.
+ * @since 0.6.0
+ */
+declare class SmtpAttachmentReplayError extends TypeError {
+  /** Creates a replay validation failure. */
+  constructor();
+}
+/** The final bytes and known size of an SMTP DATA transaction. */
 
 //#endregion
-export { DkimAlgorithm, DkimCanonicalization, DkimConfig, DkimSignature, DkimSigningFailureAction, OAuth2TokenProvider, SmtpAuth, SmtpAuthError, SmtpConfig, SmtpDsnNotification, SmtpDsnOptions, SmtpDsnRecipientOptions, SmtpDsnUnsupportedError, SmtpDsnValidationError, SmtpEnhancedStatusCode, SmtpEnvelopeOptions, SmtpEnvelopeResolver, SmtpEnvelopeValidationError, SmtpMessageSizeProviderDetails, SmtpOAuth2Auth, SmtpOAuth2RefreshAuth, SmtpOAuth2TokenAuth, SmtpProviderDetails, SmtpReceipt, SmtpRejectedRecipient, SmtpResponseProviderDetails, SmtpTlsOptions, SmtpTransport, SmtpTransportOptions, SmtpUserPassAuth, SmtpUtf8ProviderDetails, isSmtpResponseProviderDetails };
+export { DkimAlgorithm, DkimBodyMode, DkimCanonicalization, DkimConfig, DkimSignature, DkimSigningFailureAction, OAuth2TokenProvider, SmtpAttachmentReplayError, SmtpAuth, SmtpAuthError, SmtpConfig, SmtpDsnNotification, SmtpDsnOptions, SmtpDsnRecipientOptions, SmtpDsnUnsupportedError, SmtpDsnValidationError, SmtpEnhancedStatusCode, SmtpEnvelopeOptions, SmtpEnvelopeResolver, SmtpEnvelopeValidationError, SmtpMessageSizeProviderDetails, SmtpOAuth2Auth, SmtpOAuth2RefreshAuth, SmtpOAuth2TokenAuth, SmtpProviderDetails, SmtpReceipt, SmtpRejectedRecipient, SmtpResponseProviderDetails, SmtpTlsOptions, SmtpTransport, SmtpTransportOptions, SmtpUserPassAuth, SmtpUtf8ProviderDetails, isSmtpResponseProviderDetails };

package/dist/index.d.ts

@@ -79,12 +79,24 @@ interface DkimSignature {
  * @since 0.4.0
  */
 type DkimSigningFailureAction = "throw" | "send-unsigned";
+/**
+ * Whether signing buffers the MIME body once or reads replayable sources twice.
+ * @since 0.6.0
+ */
+type DkimBodyMode = "buffered" | "streaming";
 /**
  * Configuration for DKIM signing in SMTP transport.
  *
  * @since 0.4.0
  */
 interface DkimConfig {
+  /**
+   * Body processing strategy. Streaming uses bounded attachment memory but
+   * requires a second source read; buffered reads once and retains all MIME.
+   * @default "buffered"
+   * @since 0.6.0
+   */
+  readonly bodyMode?: DkimBodyMode;
   /**
    * Array of DKIM signature configurations.
    * Each configuration will result in one DKIM-Signature header.
@@ -97,9 +109,9 @@ interface DkimConfig {
   readonly onSigningFailure?: DkimSigningFailureAction;
 }
 /**
- * Result of DKIM signing operation.
- *
- * @since 0.4.0
+ * Validates the runtime body-mode option without changing config identity.
+ * @param config Optional signing configuration.
+ * @throws {TypeError} If the body mode is unsupported.
  */
 //#endregion
 //#region src/config.d.ts
@@ -850,6 +862,17 @@ declare class SmtpAuthError extends Error {
  * @returns The Base64-encoded XOAUTH2 initial client response.
  * @since 0.5.0
  */
+//#endregion
+//#region src/message-stream.d.ts
+/**
+ * A replayable attachment changed between DKIM body reads.
+ * @since 0.6.0
+ */
+declare class SmtpAttachmentReplayError extends TypeError {
+  /** Creates a replay validation failure. */
+  constructor();
+}
+/** The final bytes and known size of an SMTP DATA transaction. */
 
 //#endregion
-export { DkimAlgorithm, DkimCanonicalization, DkimConfig, DkimSignature, DkimSigningFailureAction, OAuth2TokenProvider, SmtpAuth, SmtpAuthError, SmtpConfig, SmtpDsnNotification, SmtpDsnOptions, SmtpDsnRecipientOptions, SmtpDsnUnsupportedError, SmtpDsnValidationError, SmtpEnhancedStatusCode, SmtpEnvelopeOptions, SmtpEnvelopeResolver, SmtpEnvelopeValidationError, SmtpMessageSizeProviderDetails, SmtpOAuth2Auth, SmtpOAuth2RefreshAuth, SmtpOAuth2TokenAuth, SmtpProviderDetails, SmtpReceipt, SmtpRejectedRecipient, SmtpResponseProviderDetails, SmtpTlsOptions, SmtpTransport, SmtpTransportOptions, SmtpUserPassAuth, SmtpUtf8ProviderDetails, isSmtpResponseProviderDetails };
+export { DkimAlgorithm, DkimBodyMode, DkimCanonicalization, DkimConfig, DkimSignature, DkimSigningFailureAction, OAuth2TokenProvider, SmtpAttachmentReplayError, SmtpAuth, SmtpAuthError, SmtpConfig, SmtpDsnNotification, SmtpDsnOptions, SmtpDsnRecipientOptions, SmtpDsnUnsupportedError, SmtpDsnValidationError, SmtpEnhancedStatusCode, SmtpEnvelopeOptions, SmtpEnvelopeResolver, SmtpEnvelopeValidationError, SmtpMessageSizeProviderDetails, SmtpOAuth2Auth, SmtpOAuth2RefreshAuth, SmtpOAuth2TokenAuth, SmtpProviderDetails, SmtpReceipt, SmtpRejectedRecipient, SmtpResponseProviderDetails, SmtpTlsOptions, SmtpTransport, SmtpTransportOptions, SmtpUserPassAuth, SmtpUtf8ProviderDetails, isSmtpResponseProviderDetails };