@upyo/logtape 0.6.0-dev.262 → 0.6.0-dev.265

package/README.md

@@ -53,6 +53,28 @@ const transport = new LogTapeTransport({
 });
 ~~~~
 
-Complete messages are excluded from structured logs by default.  Set
-`recordMessage: true` only when the configured sinks and redaction rules can
-safely handle addresses, bodies, headers, and attachment data.
+Complete messages are excluded from logs by default.  Set `recordMessage` to
+`"properties"` to add the complete `Message` object to each lifecycle event
+while keeping its log message on one line:
+
+~~~~ typescript
+const transport = new LogTapeTransport({
+  recordMessage: "properties",
+});
+~~~~
+
+For local development, `"inline"` also renders the subject and body beneath
+the lifecycle message:
+
+~~~~ typescript
+const transport = new LogTapeTransport({
+  recordMessage: "inline",
+});
+~~~~
+
+Inline logs use the plain-text body when it is defined, including an empty
+string, and otherwise use the HTML body.  Subject and body values remain
+LogTape placeholders so sinks can apply their own rendering and redaction.
+Both modes expose the complete message, which may contain addresses, bodies,
+headers, and attachment data.  Use them only when the configured sinks,
+access controls, and redaction rules can safely handle that data.

package/dist/index.cjs

@@ -234,7 +234,7 @@ var LogTapeTransport = class {
 		};
 	}
 	logSending(message, operation) {
-		this.log(this.config.levels.sending, "Sending email.", {
+		this.log(this.config.levels.sending, this.getMessageTemplate("Sending email.", message), {
 			...this.getMessageProperties(message),
 			event: "email.sending",
 			operation,
@@ -245,7 +245,7 @@ var LogTapeTransport = class {
 		const durationMilliseconds = pendingMessage == null ? void 0 : performance.now() - pendingMessage.startedAt;
 		const messageProperties = pendingMessage == null ? {} : this.getMessageProperties(pendingMessage.message);
 		if (receipt.successful) {
-			this.log(this.config.levels.sent, "Email sent.", {
+			this.log(this.config.levels.sent, this.getMessageTemplate("Email sent.", pendingMessage?.message), {
 				...messageProperties,
 				event: "email.sent",
 				operation,
@@ -257,7 +257,7 @@ var LogTapeTransport = class {
 			});
 			return;
 		}
-		this.log(this.config.levels.failed, "Failed to send email.", {
+		this.log(this.config.levels.failed, this.getMessageTemplate("Failed to send email.", pendingMessage?.message), {
 			...messageProperties,
 			event: "email.failed",
 			operation,
@@ -272,7 +272,7 @@ var LogTapeTransport = class {
 		});
 	}
 	logThrownError(error, message, operation, startedAt, extraProperties = {}) {
-		this.log(this.config.levels.failed, "Failed to send email: {error}", {
+		this.log(this.config.levels.failed, this.getMessageTemplate("Failed to send email: {error}", message), {
 			...message == null ? {} : this.getMessageProperties(message),
 			...extraProperties,
 			event: "email.failed",
@@ -301,9 +301,14 @@ var LogTapeTransport = class {
 			bccRecipientCount: message.bccRecipients.length,
 			attachmentCount: message.attachments.length,
 			priority: message.priority,
-			...this.config.recordMessage ? { message } : {}
+			...this.config.recordMessage === false ? {} : { message }
 		};
 	}
+	getMessageTemplate(lifecycleMessage, message) {
+		if (this.config.recordMessage !== "inline" || message == null) return lifecycleMessage;
+		const contentPlaceholder = "text" in message.content && message.content.text !== void 0 ? "{message.content.text}" : "{message.content.html}";
+		return `${lifecycleMessage}\n\nSubject: {message.subject}\n\n${contentPlaceholder}`;
+	}
 	log(level, message, properties) {
 		this.logger[level](message, properties);
 	}

package/dist/index.d.cts

@@ -49,15 +49,19 @@ interface LogTapeTransportOptions<TProviderId extends string = "logtape"> {
    */
   readonly category?: string | readonly string[];
   /**
-   * Whether to include the complete email message in structured log
-   * properties.
+   * How to include the complete email message in logs.
+   *
+   * `"properties"` adds the message to structured log properties while
+   * keeping the lifecycle message on one line.  `"inline"` also renders the
+   * subject and body beneath the lifecycle message.  Plain text is preferred
+   * when it is defined; otherwise, the HTML body is rendered.
    *
    * Messages may contain sensitive or large values, including email bodies,
    * headers, and attachment data.
    *
-   * @default false
+   * @default undefined
    */
-  readonly recordMessage?: boolean;
+  readonly recordMessage?: "properties" | "inline";
   /**
    * Levels used for delivery lifecycle events.
    */
@@ -74,8 +78,8 @@ interface ResolvedLogTapeTransportOptions<TProviderId extends string = "logtape"
   readonly transport?: Transport<TProviderId>;
   /** Resolved LogTape category. */
   readonly category: readonly string[];
-  /** Whether complete messages are included in structured logs. */
-  readonly recordMessage: boolean;
+  /** Resolved complete-message recording mode, or `false` when disabled. */
+  readonly recordMessage: "properties" | "inline" | false;
   /** Resolved delivery lifecycle log levels. */
   readonly levels: Required<LogTapeTransportLevels>;
 }
@@ -155,6 +159,7 @@ declare class LogTapeTransport<TProviderId extends string = "logtape"> implement
   private logThrownError;
   private logBatchThrownError;
   private getMessageProperties;
+  private getMessageTemplate;
   private log;
 }
 //#endregion

package/dist/index.d.ts

@@ -49,15 +49,19 @@ interface LogTapeTransportOptions<TProviderId extends string = "logtape"> {
    */
   readonly category?: string | readonly string[];
   /**
-   * Whether to include the complete email message in structured log
-   * properties.
+   * How to include the complete email message in logs.
+   *
+   * `"properties"` adds the message to structured log properties while
+   * keeping the lifecycle message on one line.  `"inline"` also renders the
+   * subject and body beneath the lifecycle message.  Plain text is preferred
+   * when it is defined; otherwise, the HTML body is rendered.
    *
    * Messages may contain sensitive or large values, including email bodies,
    * headers, and attachment data.
    *
-   * @default false
+   * @default undefined
    */
-  readonly recordMessage?: boolean;
+  readonly recordMessage?: "properties" | "inline";
   /**
    * Levels used for delivery lifecycle events.
    */
@@ -74,8 +78,8 @@ interface ResolvedLogTapeTransportOptions<TProviderId extends string = "logtape"
   readonly transport?: Transport<TProviderId>;
   /** Resolved LogTape category. */
   readonly category: readonly string[];
-  /** Whether complete messages are included in structured logs. */
-  readonly recordMessage: boolean;
+  /** Resolved complete-message recording mode, or `false` when disabled. */
+  readonly recordMessage: "properties" | "inline" | false;
   /** Resolved delivery lifecycle log levels. */
   readonly levels: Required<LogTapeTransportLevels>;
 }
@@ -155,6 +159,7 @@ declare class LogTapeTransport<TProviderId extends string = "logtape"> implement
   private logThrownError;
   private logBatchThrownError;
   private getMessageProperties;
+  private getMessageTemplate;
   private log;
 }
 //#endregion

package/dist/index.js

@@ -211,7 +211,7 @@ var LogTapeTransport = class {
 		};
 	}
 	logSending(message, operation) {
-		this.log(this.config.levels.sending, "Sending email.", {
+		this.log(this.config.levels.sending, this.getMessageTemplate("Sending email.", message), {
 			...this.getMessageProperties(message),
 			event: "email.sending",
 			operation,
@@ -222,7 +222,7 @@ var LogTapeTransport = class {
 		const durationMilliseconds = pendingMessage == null ? void 0 : performance.now() - pendingMessage.startedAt;
 		const messageProperties = pendingMessage == null ? {} : this.getMessageProperties(pendingMessage.message);
 		if (receipt.successful) {
-			this.log(this.config.levels.sent, "Email sent.", {
+			this.log(this.config.levels.sent, this.getMessageTemplate("Email sent.", pendingMessage?.message), {
 				...messageProperties,
 				event: "email.sent",
 				operation,
@@ -234,7 +234,7 @@ var LogTapeTransport = class {
 			});
 			return;
 		}
-		this.log(this.config.levels.failed, "Failed to send email.", {
+		this.log(this.config.levels.failed, this.getMessageTemplate("Failed to send email.", pendingMessage?.message), {
 			...messageProperties,
 			event: "email.failed",
 			operation,
@@ -249,7 +249,7 @@ var LogTapeTransport = class {
 		});
 	}
 	logThrownError(error, message, operation, startedAt, extraProperties = {}) {
-		this.log(this.config.levels.failed, "Failed to send email: {error}", {
+		this.log(this.config.levels.failed, this.getMessageTemplate("Failed to send email: {error}", message), {
 			...message == null ? {} : this.getMessageProperties(message),
 			...extraProperties,
 			event: "email.failed",
@@ -278,9 +278,14 @@ var LogTapeTransport = class {
 			bccRecipientCount: message.bccRecipients.length,
 			attachmentCount: message.attachments.length,
 			priority: message.priority,
-			...this.config.recordMessage ? { message } : {}
+			...this.config.recordMessage === false ? {} : { message }
 		};
 	}
+	getMessageTemplate(lifecycleMessage, message) {
+		if (this.config.recordMessage !== "inline" || message == null) return lifecycleMessage;
+		const contentPlaceholder = "text" in message.content && message.content.text !== void 0 ? "{message.content.text}" : "{message.content.html}";
+		return `${lifecycleMessage}\n\nSubject: {message.subject}\n\n${contentPlaceholder}`;
+	}
 	log(level, message, properties) {
 		this.logger[level](message, properties);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/logtape",
-  "version": "0.6.0-dev.262",
+  "version": "0.6.0-dev.265",
   "description": "LogTape observability transport for Upyo email library",
   "keywords": [
     "email",
@@ -55,7 +55,7 @@
   "sideEffects": false,
   "peerDependencies": {
     "@logtape/logtape": "^2.2.4",
-    "@upyo/core": "0.6.0-dev.262+56881d4a"
+    "@upyo/core": "0.6.0-dev.265+77f3e71a"
   },
   "devDependencies": {
     "@logtape/logtape": "^2.2.4",