| 1 | package Mail::DMARC::Report::Aggregate::Metadata; | ||
| 2 | use strict; | ||
| 3 | use warnings; | ||
| 4 | use feature 'signatures'; | ||
| 5 | no warnings 'experimental::args_array_with_signatures'; ## no critic (ProhibitNoWarnings) | ||
| 6 | |||
| 7 | our $VERSION = '2.20260827'; | ||
| 8 | |||
| 9 | use XML::LibXML; | ||
| 10 | |||
| 11 | use parent 'Mail::DMARC::Base'; | ||
| 12 | |||
| 13 | sub org_name( $self, $value = undef ) { | ||
| 14 | return $self->{org_name} if @_ == 1; | ||
| 15 | return $self->{org_name} = $value; | ||
| 16 | } | ||
| 17 | |||
| 18 | sub email( $self, $value = undef ) { | ||
| 19 | return $self->{email} if @_ == 1; | ||
| 20 | return $self->{email} = $value; | ||
| 21 | } | ||
| 22 | |||
| 23 | sub extra_contact_info( $self, $value = undef ) { | ||
| 24 | return $self->{extra_contact_info} if @_ == 1; | ||
| 25 | return $self->{extra_contact_info} = $value; | ||
| 26 | } | ||
| 27 | |||
| 28 | sub report_id( $self, $value = undef ) { | ||
| 29 | return $self->{report_id} if @_ == 1; | ||
| 30 | return $self->{report_id} = $value; | ||
| 31 | } | ||
| 32 | |||
| 33 | sub date_range( $self, $value = undef ) { | ||
| 34 | return $self->{date_range} if @_ == 1; | ||
| 35 | |||
| 36 | # croak "invalid date_range" if ('HASH' ne ref $value); | ||
| 37 | return $self->{date_range} = $value; | ||
| 38 | } | ||
| 39 | |||
| 40 | sub begin( $self, $value = undef ) { | ||
| 41 | return $self->{date_range}{begin} if @_ == 1; | ||
| 42 | return $self->{date_range}{begin} = $value; | ||
| 43 | } | ||
| 44 | |||
| 45 | sub end( $self, $value = undef ) { | ||
| 46 | return $self->{date_range}{end} if @_ == 1; | ||
| 47 | return $self->{date_range}{end} = $value; | ||
| 48 | } | ||
| 49 | |||
| 50 | sub error( $self, $value = undef ) { | ||
| 51 | return $self->{error} if @_ == 1; | ||
| 52 | return push @{ $self->{error} }, $value; | ||
| 53 | } | ||
| 54 | |||
| 55 | sub uuid( $self, $value = undef ) { | ||
| 56 | return $self->{uuid} if @_ == 1; | ||
| 57 | return $self->{uuid} = $value; | ||
| 58 | } | ||
| 59 | |||
| 60 | sub as_xml($self) { | ||
| 61 | my $meta = "\t<report_metadata>\n"; | ||
| 62 | |||
| 63 | foreach my $f (qw/ org_name email extra_contact_info report_id /) { | ||
| 64 | my $val = $self->$f or next; | ||
| 65 | $val = XML::LibXML::Text->new($val)->toString(); | ||
| 66 | $meta .= "\t\t<$f>$val</$f>\n"; | ||
| 67 | } | ||
| 68 | my $begin = XML::LibXML::Text->new( $self->begin )->toString(); | ||
| 69 | my $end = XML::LibXML::Text->new( $self->end )->toString(); | ||
| 70 | $meta | ||
| 71 | .= "\t\t<date_range>\n\t\t\t<begin>" | ||
| 72 | . $begin | ||
| 73 | . "</begin>\n" | ||
| 74 | . "\t\t\t<end>" | ||
| 75 | . $end | ||
| 76 | . "</end>\n\t\t</date_range>\n"; | ||
| 77 | |||
| 78 | my $errors = $self->error; | ||
| 79 | if ( $errors && @$errors ) { | ||
| 80 | foreach my $err (@$errors) { | ||
| 81 | $err = XML::LibXML::Text->new($err)->toString(); | ||
| 82 | $meta .= "\t\t<error>$err</error>\n"; | ||
| 83 | } | ||
| 84 | } | ||
| 85 | $meta .= "\t</report_metadata>"; | ||
| 86 | return $meta; | ||
| 87 | } | ||
| 88 | |||
| 89 | 1; | ||
| 90 | |||
| 91 | __END__ | ||
| 92 | |||
| 93 | =pod | ||
| 94 | |||
| 95 | =head1 NAME | ||
| 96 | |||
| 97 | Mail::DMARC::Report::Aggregate::Metadata - metadata section of aggregate report | ||
| 98 | |||
| 99 | =head1 VERSION | ||
| 100 | |||
| 101 | version 2.20260827 | ||
| 102 | |||
| 103 | =head1 AUTHORS | ||
| 104 | |||
| 105 | =over 4 | ||
| 106 | |||
| 107 | =item * | ||
| 108 | |||
| 109 | Matt Simerson <msimerson@cpan.org> | ||
| 110 | |||
| 111 | =item * | ||
| 112 | |||
| 113 | Davide Migliavacca <shari@cpan.org> | ||
| 114 | |||
| 115 | =item * | ||
| 116 | |||
| 117 | Marc Bradshaw <marc@marcbradshaw.net> | ||
| 118 | |||
| 119 | =back | ||
| 120 | |||
| 121 | =head1 COPYRIGHT AND LICENSE | ||
| 122 | |||
| 123 | This software is copyright (c) 2026 by Matt Simerson. | ||
| 124 | |||
| 125 | This is free software; you can redistribute it and/or modify it under | ||
| 126 | the same terms as the Perl 5 programming language system itself. | ||
| 127 | |||
| 128 | =cut |