# This module is part of debbugs, and is released
# under the terms of the GPL version 2, or any later
# version at your option.
# See the file README and COPYING for more information.
#
# Copyright 2004-7 by Don Armstrong <don@donarmstrong.com>.

package Debbugs::Mail;

=head1 NAME

Debbugs::Mail -- Outgoing Mail Handling

=head1 SYNOPSIS

use Debbugs::Mail qw(send_mail_message get_addresses);

my @addresses = get_addresses('blah blah blah foo@bar.com')
send_mail_message(message => <<END, recipients=>[@addresses]);
To: $addresses[0]
Subject: Testing

Testing 1 2 3
END

=head1 EXPORT TAGS

=over

=item :all -- all functions that can be exported

=back

=head1 FUNCTIONS


=cut

use warnings;
use strict;
use vars qw($VERSION $DEBUG %EXPORT_TAGS @EXPORT_OK @EXPORT);
use base qw(Exporter);

use IPC::Open3;
use POSIX qw(:sys_wait_h strftime);
use Time::HiRes qw(usleep);
use Mail::Address ();
use Debbugs::MIME qw(encode_rfc1522);
use Debbugs::Config qw(:config);
use Params::Validate qw(:types validate_with);

use Debbugs::Packages;

BEGIN{
     ($VERSION) = q$Revision: 1.1 $ =~ /^Revision:\s+([^\s+])/;
     $DEBUG = 0 unless defined $DEBUG;

     @EXPORT = ();
     %EXPORT_TAGS = (addresses => [qw(get_addresses)],
		     misc      => [qw(rfc822_date)],
		     mail      => [qw(send_mail_message encode_headers default_headers)],
		    );
     @EXPORT_OK = ();
     Exporter::export_ok_tags(keys %EXPORT_TAGS);
     $EXPORT_TAGS{all} = [@EXPORT_OK];
}

# We set this here so it can be overridden for testing purposes
our $SENDMAIL = $config{sendmail};

=head2 get_addresses

     my @addresses = get_addresses('don@debian.org blars@debian.org
                                    kamion@debian.org ajt@debian.org');

Given a string containing some e-mail addresses, parses the string
using Mail::Address->parse and returns a list of the addresses.

=cut

sub get_addresses {
     return map { $_->address() } map { Mail::Address->parse($_) } @_;
}


=head2 default_headers

      my @head = default_headers(queue_file => 'foo',
                                 data       => $data,
                                 msgid      => $header{'message-id'},
                                 msgtype    => 'error',
                                 headers    => [...],
                                );
      create_mime_message(\@headers,
                         ...
                         );

This function is generally called to generate the headers for
create_mime_message (and anything else that needs a set of default
headers.)

In list context, returns an array of headers. In scalar context,
returns headers for shoving in a mail message after encoding using
encode_headers.

=head3 options

=over

=item queue_file -- the queue file which will generate this set of
headers (refered to as $nn in lots of the code)

=item data -- the data of the bug which this message involves; can be
undefined if there is no bug involved.

=item msgid -- the Message-ID: of the message which will generate this
set of headers

=item msgtype -- the type of message that this is.

=item pr_msg -- the pr message field

=item headers -- a set of headers which will override the default
headers; these headers will be passed through (and may be reordered.)
If a particular header is undef, it overrides the default, but isn't
passed through.

=back

=head3 default headers

=over

=item X-Loop -- set to the maintainer e-mail

=item From -- set to the maintainer e-mail

=item To -- set to Unknown recipients

=item Subject -- set to Unknown subject

=item Message-ID -- set appropriately (see code)

=item Precedence -- set to bulk

=item References -- set to the full set of message ids that are known
(from data and the msgid option)

=item In-Reply-To -- set to msg id or the msgid from data

=item X-Project-PR-Message -- set to pr_msg with the bug number appended

=item X-Project-PR-Package -- set to the package of the bug

=item X-Project-PR-Keywords -- set to the keywords of the bug

=item X-Project-PR-Source -- set to the source of the bug

=back

=cut

sub default_headers {
    my %param = validate_with(params => \@_,
			      spec   => {queue_file => {type => SCALAR,
							optional => 1,
						       },
					 data       => {type => HASHREF,
							optional => 1,
						       },
					 msgid      => {type => SCALAR,
							optional => 1,
						       },
					 msgtype    => {type => SCALAR,
							default => 'misc',
							optional => 1,
						       },
					 pr_msg     => {type => SCALAR,
							default => 'misc',
						       },
					 headers    => {type => ARRAYREF,
							default => [],
						       },
					},
			     );
    my @header_order = (qw(X-Loop From To subject),
			qw(Message-ID In-Reply-To References));
    my %header_order;
    @header_order{map {lc $_} @header_order} = 0..$#header_order;
    my %set_headers;
    my @ordered_headers;
    my @temp = @{$param{headers}};
    my @other_headers;
    while (my ($header,$value) = splice @temp,0,2) {
	if (exists $header_order{lc($header)}) {
	    push @{$ordered_headers[$header_order{lc($header)}]},
		($header,$value);
	}
	else {
	    push @other_headers,($header,$value);
	}
	$set_headers{lc($header)} = 1;
    }

    # calculate our headers
    my $bug_num = exists $param{data} ? $param{data}{bug_num} : 'x';
    my $nn = $param{queue_file};
    # handle the user giving the actual queue filename instead of nn
    $nn =~ s/^[a-zA-Z]([a-zA-Z])/$1/;
    $nn = lc($nn);
    my @msgids;
    if (exists $param{msgid} and defined $param{msgid}) {
	push @msgids, $param{msgid}
    }
    elsif (exists $param{data} and defined $param{data}{msgid}) {
	push @msgids, $param{data}{msgid}
    }
    my %default_header;
    $default_header{'X-Loop'} = $config{maintainer_email};
    $default_header{From}     = "$config{maintainer_email} ($config{project} $config{ubug} Tracking System)";
    $default_header{To}       = "Unknown recipients";
    $default_header{Subject}  = "Unknown subject";
    $default_header{'Message-ID'} = "<handler.${bug_num}.${nn}.$param{msgtype}\@$config{email_domain}>";
    if (@msgids) {
	$default_header{'In-Reply-To'} = $msgids[0];
	$default_header{'References'} = join(' ',@msgids);
    }
    $default_header{Precedence} = 'bulk';
    $default_header{"X-$config{project}-PR-Message"} = $param{pr_msg} . (exists $param{data} ? ' '.$param{data}{bug_num}:'');
    $default_header{Date} = rfc822_date();
    if (exists $param{data}) {
	if (defined $param{data}{keywords}) {
	    $default_header{"X-$config{project}-PR-Keywords"} = $param{data}{keywords};
	}
	if (defined $param{data}{package}) {
	    $default_header{"X-$config{project}-PR-Package"} = $param{data}{package};
	    if ($param{data}{package} =~ /^src:(.+)$/) {
		$default_header{"X-$config{project}-PR-Source"} = $1;
	    }
	    else {
		my $pkg_src = Debbugs::Packages::getpkgsrc();
		$default_header{"X-$config{project}-PR-Source"} = $pkg_src->{$param{data}{package}};
	    }
	}
    }
    for my $header (sort keys %default_header) {
	next if $set_headers{lc($header)};
	if (exists $header_order{lc($header)}) {
	    push @{$ordered_headers[$header_order{lc($header)}]},
		($header,$default_header{$header});
	}
	else {
	    push @other_headers,($header,$header_order{lc($header)});
	}
    }
    my @headers;
    for my $hdr1 (@ordered_headers) {
	next if not defined $hdr1;
	my @temp = @{$hdr1};
	while (my ($header,$value) = splice @temp,0,2) {
	    next if not defined $value;
	    push @headers,($header,$value);
	}
    }
    push @headers,@other_headers;
    if (wantarray) {
	return @headers;
    }
    else {
	my $headers = '';
	while (my ($header,$value) = splice @headers,0,2) {
	    $headers .= "${header}: $value\n";
	}
	return $headers;
    }
}



=head2 send_mail_message

     send_mail_message(message    => $message,
                       recipients => [@recipients],
                       envelope_from => 'don@debian.org',
                      );


=over

=item message -- message to send out

=item recipients -- recipients to send the message to. If undefed or
an empty arrayref, will use '-t' to parse the message for recipients.

=item envelope_from -- envelope_from for outgoing messages

=item encode_headers -- encode headers using RFC1522 (default)

=item parse_for_recipients -- use -t to parse the message for
recipients in addition to those specified. [Can be used to set Bcc
recipients, for example.]

=back

Returns true on success, false on failures. All errors are indicated
using warn.

=cut

sub send_mail_message{
     my %param = validate_with(params => \@_,
			       spec  => {sendmail_arguments => {type => ARRAYREF,
								default => [qw(-odq -oem -oi)],
							       },
					 parse_for_recipients => {type => BOOLEAN,
								  default => 0,
								 },
					 encode_headers       => {type => BOOLEAN,
								  default => 1,
								 },
					 message              => {type => SCALAR,
								 },
					 envelope_from        => {type => SCALAR,
								  optional => 1,
								 },
					 recipients           => {type => ARRAYREF|UNDEF,
								  optional => 1,
								 },
					},
			      );
     my @sendmail_arguments = qw(-odq -oem -oi);
     push @sendmail_arguments, '-f', $param{envelope_from} if exists $param{envelope_from};

     my @recipients;
     @recipients = @{$param{recipients}} if defined $param{recipients} and
	  ref($param{recipients}) eq 'ARRAY';
     my %recipients;
     @recipients{@recipients} = (1) x @recipients;
     @recipients = keys %recipients;
     # If there are no recipients, use -t to parse the message
     if (@recipients == 0) {
	  $param{parse_for_recipients} = 1 unless exists $param{parse_for_recipients};
     }
     # Encode headers if necessary
     $param{encode_headers} = 1 if not exists $param{encode_headers};
     if ($param{encode_headers}) {
	  $param{message} = encode_headers($param{message});
     }

     # First, try to send the message as is.
     eval {
	  _send_message($param{message},
			@sendmail_arguments,
			$param{parse_for_recipients}?q(-t):(),
			@recipients);
     };
     return 1 unless $@;
     # If there's only one recipient, there's nothing more we can do,
     # so bail out.
     warn $@ and return 0 if $@ and @recipients == 0;
     # If that fails, try to send the message to each of the
     # recipients separately. We also send the -t option separately in
     # case one of the @recipients is ok, but the addresses in the
     # mail message itself are malformed.
     my @errors;
     for my $recipient ($param{parse_for_recipients}?q(-t):(),@recipients) {
	  eval {
	       _send_message($param{message},@sendmail_arguments,$recipient);
	  };
	  push @errors, "Sending to $recipient failed with $@" if $@;
     }
     # If it still fails, complain bitterly but don't die.
     warn join(qq(\n),@errors) and return 0 if @errors;
     return 1;
}

=head2 encode_headers

     $message = encode_heeaders($message);

RFC 1522 encodes the headers of a message

=cut

sub encode_headers{
     my ($message) = @_;

     my ($header,$body) = split /\n\n/, $message, 2;
     $header = encode_rfc1522($header);
     return $header . qq(\n\n). $body;
}

=head2 rfc822_date

     rfc822_date

Return the current date in RFC822 format in the UTC timezone

=cut

sub rfc822_date{
     return scalar strftime "%a, %d %h %Y %T +0000", gmtime;
}

=head1 PRIVATE FUNCTIONS

=head2 _send_message

     _send_message($message,@sendmail_args);

Private function that actually calls sendmail with @sendmail_args and
sends message $message.

dies with errors, so calls to this function in send_mail_message
should be wrapped in eval.

=cut

sub _send_message{
     my ($message,@sendmail_args) = @_;

     my ($wfh,$rfh);
     my $pid = open3($wfh,$rfh,$rfh,$SENDMAIL,@sendmail_args)
	  or die "Unable to fork off $SENDMAIL: $!";
     local $SIG{PIPE} = 'IGNORE';
     eval {
	  print {$wfh} $message or die "Unable to write to $SENDMAIL: $!";
	  close $wfh or die "$SENDMAIL exited with $?";
     };
     if ($@) {
	  local $\;
	  # Reap the zombie
	  waitpid($pid,WNOHANG);
	  # This shouldn't block because the pipe closing is the only
	  # way this should be triggered.
	  my $message = <$rfh>;
	  die "$@$message";
     }
     # Wait for sendmail to exit for at most 30 seconds.
     my $loop = 0;
     while (waitpid($pid, WNOHANG) == 0 or $loop++ >= 600){
	  # sleep for a 20th of a second
	  usleep(50_000);
     }
     if ($loop >= 600) {
	  warn "$SENDMAIL didn't exit within 30 seconds";
     }
}


1;


__END__






