Blossom.pm

filter: Statementstmt 86.6% 13 / 15 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub 100% 5 / 5 Podpod n/a totaltotal 90.0% 18 / 20 CC 1 SCAR 0.6
CC
1
Cov
87%
BEGIN
1.3
BEGIN
1.0
BEGIN
1.0
CRAP 1.1
« Torrent.pm ↑ Summary DirectMessage.pm »
1 package Net::Nostr::Blossom;
2  
3 2 ▶use strictures 2;
Subroutine BEGIN: called CC=1 SCAR=0.0
4  
5 2 ▶use Net::Nostr::_ConstructorArgs ();
Subroutine BEGIN: called CC=1 SCAR=0.0
6  
7 2 ▶use Carp qw(croak);
Subroutine BEGIN: called CC=1 SCAR=0.0
8 2 ▶use Digest::SHA qw(sha256_hex);
Subroutine BEGIN: called CC=1 SCAR=0.0
9 0 ▶use Net::Nostr::Event;
Subroutine BEGIN: called CC=1 SCAR=2.6
10 use Scalar::Util qw(blessed);
11 use URI ();
12  
13 use Class::Tiny qw(_servers);
14  
15 my $SERVER_LIST_KIND = 10063;
16 my $HEX64 = qr/\A[0-9a-fA-F]{64}\z/;
17  
18 sub new {
19 my $class = shift;
20 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
21  
22 my $servers = delete $args{servers};
23 croak "unknown argument(s): " . join(', ', sort keys %args) if %args;
24  
25 if (!defined $servers) {
26 $servers = [];
27 } else {
28 croak "servers must be an arrayref"
29 unless ref($servers) eq 'ARRAY';
30 }
31  
32 my @servers = map { _validate_server_url($_) } @$servers;
33 my $self = bless {}, $class;
34 $self->_servers(\@servers);
35 return $self;
36 }
37  
38 sub from_event {
39 my ($class, $event) = @_;
40  
41 croak "event is required"
42 unless defined $event;
43 croak "event must be a Net::Nostr::Event object"
44 unless blessed($event) && $event->isa('Net::Nostr::Event');
45  
46 my $kind = $event->kind;
47 croak "event must be kind 10063"
48 unless defined $kind && !ref($kind) && $kind =~ /\A\d+\z/ && $kind == $SERVER_LIST_KIND;
49  
50 my $tags = $event->_tags;
51 croak "tags must be an arrayref"
52 unless ref($tags) eq 'ARRAY';
53  
54 my @servers;
55 for my $tag (@$tags) {
56 croak "each tag must be an arrayref"
57 unless ref($tag) eq 'ARRAY';
58 for my $elem (@$tag) {
59 croak "tag elements must be defined strings"
60 unless defined $elem && !ref($elem);
61 }
62  
63 next unless @$tag && $tag->[0] eq 'server';
64  
65 croak "server tag requires a URL"
66 unless defined $tag->[1] && length $tag->[1];
67 push @servers, _validate_server_url($tag->[1]);
68 }
69  
70 croak "kind 10063 event requires at least one server tag"
71 unless @servers;
72  
73 return $class->new(servers => \@servers);
74 }
75  
76 sub servers {
77 my ($self) = @_;
78 return wantarray ? @{$self->_servers} : [@{$self->_servers}];
79 }
80  
81 sub primary_server {
82 my ($self) = @_;
83 return $self->_servers->[0];
84 }
85  
86 sub server_tags {
87 my ($self) = @_;
88 return [map { ['server', $_] } @{$self->_servers}];
89 }
90  
91 sub to_event {
92 my $self = shift;
93 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
94  
95 croak "kind 10063 event requires at least one server tag"
96 unless @{$self->_servers};
97  
98 return Net::Nostr::Event->new(
99 %args,
100 kind => $SERVER_LIST_KIND,
101 content => '',
102 tags => $self->server_tags,
103 );
104 }
105  
106 sub extract_hash {
107 my ($class, $input) = @_;
108 return (undef, undef)
109 unless defined $input && !ref($input);
110  
111 my ($hash, $ext);
112 while ($input =~ /(?<![0-9a-fA-F])([0-9a-fA-F]{64})(?![0-9a-fA-F])(?:\.([A-Za-z0-9]+)(?=\z|[?#]))?/g) {
113 ($hash, $ext) = (lc($1), $2);
114 }
115  
116 return defined $hash ? ($hash, $ext) : (undef, undef);
117 }
118  
119 sub fallback_urls {
120 my ($self, $url) = @_;
121 croak "fallback_urls must be called on a Net::Nostr::Blossom object"
122 unless blessed($self) && $self->isa(__PACKAGE__);
123  
124 my ($hash, $ext) = __PACKAGE__->extract_hash($url);
125 return () unless defined $hash;
126  
127 my $path = defined $ext ? "$hash.$ext" : $hash;
128 return map {
129 my $base = $_;
130 $base =~ s{/+\z}{};
131 "$base/$path";
132 } @{$self->_servers};
133 }
134  
135 sub verify_sha256 {
136 my ($class, $data, $expected) = @_;
137 croak "expected hash must be 64-char hex"
138 unless defined $expected && !ref($expected) && $expected =~ $HEX64;
139  
140 return sha256_hex($data) eq lc($expected);
141 }
142  
143 sub _validate_server_url {
144 my ($url) = @_;
145  
146 croak "server url is required"
147 unless defined $url && !ref($url);
148 croak "server url must not contain control or space characters"
149 if $url =~ /[[:cntrl:]\s]/;
150  
151 my $uri = URI->new($url);
152 my $scheme = $uri->scheme;
153 croak "server url must use http or https"
154 unless defined $scheme && (lc($scheme) eq 'http' || lc($scheme) eq 'https');
155  
156 my $authority = $uri->authority;
157 croak "server url must include an authority/host"
158 unless defined $authority && length $authority;
159  
160 croak "server url must not include userinfo"
161 if defined($uri->userinfo) || $authority =~ /@/;
162 croak "server url must not include a query"
163 if defined $uri->query;
164 croak "server url must not include a fragment"
165 if defined $uri->fragment;
166  
167 my $host = $uri->host;
168 croak "server url must include an authority/host"
169 unless defined $host && length $host;
170  
171 _validate_authority_port($authority);
172 return $url;
173 }
174  
175 sub _validate_authority_port {
176 my ($authority) = @_;
177  
178 my $port;
179 if ($authority =~ /\A\[[^\]]+\](?::([^:]*))?\z/) {
180 $port = $1;
181 } elsif ($authority =~ /\A[^:]*:(.*)\z/) {
182 $port = $1;
183 } else {
184 croak "server url must bracket IPv6 host"
185 if $authority =~ /:/;
186 return;
187 }
188  
189 return unless defined $port;
190 croak "server url port must be between 1 and 65535"
191 unless $port =~ /\A\d+\z/ && $port >= 1 && $port <= 65535;
192 }
193  
194 1;
195  
196 __END__
« Torrent.pm ↑ Summary DirectMessage.pm »