package Sisimai::Lhost::ApacheJames; use parent 'Sisimai::Lhost'; use v5.26; use strict; use warnings; sub description { 'James: https://james.apache.org/' } sub inquire { # Detect an error from Apache James # @param [Hash] mhead Message headers of a bounce email # @param [String] mbody Message body of a bounce email # @return [Hash] Bounce data list and message/rfc822 part # @return [undef] failed to decode or the arguments are missing # @since v4.1.26 my $class = shift; my $mhead = shift // return undef; my $mbody = shift // return undef; my $match = 0; $match ||= 1 if $mhead->{'subject'} eq '[BOUNCE]'; $match ||= 1 if defined $mhead->{'message-id'} && rindex($mhead->{'message-id'}, '.JavaMail.') > -1; $match ||= 1 if grep { rindex($_, 'JAMES SMTP Server') > -1 } $mhead->{'received'}->@*; return undef unless $match; state $indicators = __PACKAGE__->INDICATORS; state $boundaries = ["Content-Type: message/rfc822"]; state $startingof = { # apache-james-2.3.2/src/java/org/apache/james/transport/mailets/ # AbstractNotify.java|124: out.println("Error message below:"); # AbstractNotify.java|128: out.println("Message details:"); "message" => ["Message details:"], }; my $dscontents = [__PACKAGE__->DELIVERYSTATUS]; my $v = $dscontents->[-1]; my $emailparts = Sisimai::RFC5322->part($mbody, $boundaries); my $readcursor = 0; # Points the current cursor position my $recipients = 0; # The number of 'Final-Recipient' header my $alternates = ["", "", "", ""]; # [Envelope-From, Header-From, Date, Subject] for my $e ( split("\n", $emailparts->[0]) ) { # Read error messages and delivery status lines from the head of the email to the previous # line of the beginning of the original message. unless( $readcursor ) { # Beginning of the bounce message or message/delivery-status part if( index($e, $startingof->{"message"}->[0]) == 0 ) { # Message details: # Subject: Nyaaan $readcursor |= $indicators->{"deliverystatus"}; next; } $v->{"diagnosis"} .= $e." " if $e ne ""; next; } next if ($readcursor & $indicators->{'deliverystatus'}) == 0 || $e eq ""; # Message details: # Subject: Nyaaan # Sent date: Thu Apr 29 01:20:50 JST 2015 # MAIL FROM: shironeko@example.jp # RCPT TO: kijitora@example.org # From: Neko # To: kijitora@example.org # Size (in bytes): 1024 # Number of lines: 64 if( index($e, " RCPT TO: ") == 0 ) { # RCPT TO: kijitora@example.org if( $v->{"recipient"} ) { # There are multiple recipient addresses in the message body. push @$dscontents, __PACKAGE__->DELIVERYSTATUS; $v = $dscontents->[-1]; } $v->{"recipient"} = substr($e, 12,); $recipients++; } elsif( index($e, " Sent date: ") == 0 ) { # Sent date: Thu Apr 29 01:20:50 JST 2015 $v->{"date"} = substr($e, 13,); $alternates->[2] = $v->{"date"}; } elsif( index($e, " Subject: ") == 0 ) { # Subject: Nyaaan $alternates->[3] = substr($e, 11,); } elsif( index($e, " MAIL FROM: ") == 0 ) { # MAIL FROM: shironeko@example.jp $alternates->[0] = substr($e, 13,); } elsif( index($e, " From: ") == 0 ) { # From: Neko $alternates->[1] = substr($e, 8,); } } return undef unless $recipients; if( $emailparts->[1] eq "" ) { # The original message is empty $emailparts->[1] .= sprintf("From: %s\n", $alternates->[1]) if $alternates->[1] ne ""; $emailparts->[1] .= sprintf("Date: %s\n", $alternates->[2]) if $alternates->[2] ne ""; } if( index($emailparts->[1], "Return-Path: ") < 0 ) { # Set the envelope from address as a Return-Path: header $emailparts->[1] .= sprintf("Return-Path: <%s>\n", $alternates->[0]) if $alternates->[0] ne ""; } if( index($emailparts->[1], "\nSubject: ") < 0 ) { # Set the envelope from address as a Return-Path: header $emailparts->[1] .= sprintf("Subject: %s\n", $alternates->[3]) if $alternates->[3] ne ""; } return {"ds" => $dscontents, "rfc822" => $emailparts->[1]}; } 1; __END__ =encoding utf-8 =head1 NAME Sisimai::Lhost::ApacheJames - bounce mail decoder class for Apache James L. =head1 SYNOPSIS use Sisimai::Lhost::ApacheJames; =head1 DESCRIPTION C decodes a bounce email which created by Apache James L. Methods in the module are called from only C. =head1 CLASS METHODS =head2 C> C returns description string of this module. print Sisimai::Lhost::ApacheJames->description; =head2 C, I)>> C method decodes a bounced email and return results as a array reference. See C for more details. =head1 AUTHOR azumakuniyuki =head1 COPYRIGHT Copyright (C) 2015-2026 azumakuniyuki, All rights reserved. =head1 LICENSE This software is distributed under The BSD 2-Clause License. =cut