AppHandler.pm

filter: Statementstmt 83.3% 10 / 12 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub 100% 4 / 4 Podpod n/a totaltotal 87.5% 14 / 16 CC 1 SCAR 0.7
CC
1
Cov
83%
BEGIN
1.3
BEGIN
1.0
BEGIN
1.0
CRAP 1.1
« Core.pm ↑ Summary Article.pm »
1 package Net::Nostr::AppHandler;
2  
3 1 ▶use strictures 2;
Subroutine BEGIN: called CC=1 SCAR=0.0
4  
5 1 ▶use Net::Nostr::_ConstructorArgs ();
Subroutine BEGIN: called CC=1 SCAR=0.0
6  
7 1 ▶use Carp qw(croak);
Subroutine BEGIN: called CC=1 SCAR=0.0
8 0 ▶use Net::Nostr::Event;
Subroutine BEGIN: called CC=1 SCAR=2.6
9  
10 use Class::Tiny qw(
11 event_kind
12 identifier
13 kinds
14 content
15 apps
16 platforms
17 latest
18 next
19 );
20  
21 # Known platform tag names
22 my %PLATFORM_TAGS = map { $_ => 1 } qw(web ios android);
23  
24 sub new {
25 my $class = shift;
26 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
27 $args{apps} //= [];
28 $args{kinds} //= [];
29 $args{platforms} //= [];
30 $args{content} //= '';
31 my $self = bless { %args }, $class;
32 my %known; @known{Class::Tiny->get_all_attributes_for($class)} = ();
33 my @unknown = grep { !exists $known{$_} } keys %$self;
34 croak "unknown argument(s): " . join(', ', sort @unknown) if @unknown;
35 return $self;
36 }
37  
38 sub recommendation {
39 my $class = shift;
40 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
41  
42 my $pubkey = $args{pubkey} // croak "recommendation requires 'pubkey'";
43 my $event_kind = $args{event_kind} // croak "recommendation requires 'event_kind'";
44  
45 my @tags;
46 push @tags, ['d', "$event_kind"];
47  
48 for my $app (@{$args{apps} // []}) {
49 my @a_tag = ('a', $app->{coordinate});
50 push @a_tag, $app->{relay} if defined $app->{relay};
51 push @a_tag, $app->{platform} if defined $app->{platform};
52 push @tags, \@a_tag;
53 }
54  
55 return Net::Nostr::Event->new(
56 kind => 31989,
57 pubkey => $pubkey,
58 content => '',
59 tags => \@tags,
60 );
61 }
62  
63 sub handler {
64 my $class = shift;
65 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
66  
67 my $pubkey = $args{pubkey} // croak "handler requires 'pubkey'";
68 my $identifier = $args{identifier} // croak "handler requires 'identifier'";
69 my $kinds = $args{kinds} // croak "handler requires 'kinds'";
70  
71 my @tags;
72 push @tags, ['d', $identifier];
73  
74 for my $k (@$kinds) {
75 push @tags, ['k', "$k"];
76 }
77  
78 for my $name (qw(latest next)) {
79 next unless defined $args{$name};
80 my $manifest = $args{$name};
81 croak "$name must be a hash reference" unless ref $manifest eq 'HASH';
82 my $coordinate = $manifest->{coordinate} // croak "$name requires 'coordinate'";
83 my @tag = ($name, $coordinate);
84 push @tag, $manifest->{relay} if defined $manifest->{relay};
85 push @tags, \@tag;
86 }
87  
88 for my $p (@{$args{platforms} // []}) {
89 my @p_tag = ($p->{platform}, $p->{url});
90 push @p_tag, $p->{entity} if defined $p->{entity};
91 push @tags, \@p_tag;
92 }
93  
94 return Net::Nostr::Event->new(
95 kind => 31990,
96 pubkey => $pubkey,
97 content => $args{content} // '',
98 tags => \@tags,
99 );
100 }
101  
102 sub client_tag {
103 my $class = shift;
104 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
105 croak "client_tag requires 'name'" unless defined $args{name};
106 croak "client_tag requires 'coordinate'" unless defined $args{coordinate};
107 my @tag = ('client', $args{name}, $args{coordinate});
108 push @tag, $args{relay} if defined $args{relay};
109 return \@tag;
110 }
111  
112 sub from_event {
113 my ($class, $event) = @_;
114  
115 if ($event->kind == 31989) {
116 return $class->_parse_recommendation($event);
117 } elsif ($event->kind == 31990) {
118 return $class->_parse_handler($event);
119 }
120  
121 return undef;
122 }
123  
124 sub _parse_recommendation {
125 my ($class, $event) = @_;
126  
127 my $event_kind;
128 my @apps;
129  
130 for my $tag (@{$event->tags}) {
131 next unless @$tag >= 2;
132 my $name = $tag->[0];
133 if ($name eq 'd') {
134 $event_kind = $tag->[1] // '';
135 } elsif ($name eq 'a') {
136 my %app = (coordinate => $tag->[1]);
137 $app{relay} = $tag->[2] if @$tag > 2 && defined $tag->[2];
138 $app{platform} = $tag->[3] if @$tag > 3 && defined $tag->[3];
139 push @apps, \%app;
140 }
141 }
142  
143 return $class->new(
144 event_kind => $event_kind,
145 apps => \@apps,
146 );
147 }
148  
149 sub _parse_handler {
150 my ($class, $event) = @_;
151  
152 my ($identifier, @kinds, @platforms, $latest, $next);
153  
154 for my $tag (@{$event->tags}) {
155 next unless @$tag >= 2;
156 my $name = $tag->[0];
157 if ($name eq 'd') {
158 $identifier = $tag->[1] // '';
159 } elsif ($name eq 'k') {
160 push @kinds, $tag->[1];
161 } elsif ($name eq 'latest' || $name eq 'next') {
162 my %manifest = (coordinate => $tag->[1]);
163 $manifest{relay} = $tag->[2] if @$tag > 2 && defined $tag->[2];
164 if ($name eq 'latest') {
165 $latest = \%manifest;
166 } else {
167 $next = \%manifest;
168 }
169 } elsif ($PLATFORM_TAGS{$name}) {
170 my %p = (platform => $name, url => $tag->[1]);
171 $p{entity} = $tag->[2] if @$tag > 2 && defined $tag->[2];
172 push @platforms, \%p;
173 }
174 }
175  
176 return $class->new(
177 identifier => $identifier,
178 kinds => \@kinds,
179 content => $event->content,
180 platforms => \@platforms,
181 latest => $latest,
182 next => $next,
183 );
184 }
185  
186 sub validate {
187 my ($class, $event) = @_;
188  
189 croak "app handler MUST be kind 31989 or 31990"
190 unless $event->kind == 31989 || $event->kind == 31990;
191  
192 my $has_d = grep { $_->[0] eq 'd' } @{$event->tags};
193 croak "app handler MUST include a d tag" unless $has_d;
194  
195 if ($event->kind == 31990) {
196 my $has_k = grep { $_->[0] eq 'k' } @{$event->tags};
197 croak "handler (kind 31990) MUST include at least one k tag" unless $has_k;
198 }
199  
200 return 1;
201 }
202  
203 sub recommendation_filter {
204 my $class = shift;
205 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
206 return {
207 kinds => [31989],
208 '#d' => ["$args{event_kind}"],
209 authors => $args{authors},
210 };
211 }
212  
213 sub handler_filter {
214 my $class = shift;
215 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
216 return {
217 kinds => [31990],
218 '#k' => ["$args{event_kind}"],
219 authors => $args{authors},
220 };
221 }
222  
223 1;
224  
225 __END__
« Core.pm ↑ Summary Article.pm »