RelayAccess.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
« Reaction.pm ↑ Summary RelayMonitor.pm »
1 package Net::Nostr::RelayAccess;
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 members
12 member
13 claim
14 role_id
15 label
16 description
17 color
18 order
19 );
20  
21 my %KINDS = (
22 13534 => 'membership_list',
23 33534 => 'role_definition',
24 8000 => 'add_member',
25 8001 => 'remove_member',
26 28934 => 'join_request',
27 28935 => 'invite',
28 28936 => 'leave_request',
29 );
30  
31 sub new {
32 my $class = shift;
33 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
34 $args{members} //= [];
35 my $self = bless { %args }, $class;
36 my %known; @known{Class::Tiny->get_all_attributes_for($class)} = ();
37 my @unknown = grep { !exists $known{$_} } keys %$self;
38 croak "unknown argument(s): " . join(', ', sort @unknown) if @unknown;
39 return $self;
40 }
41  
42 sub role_definition {
43 my $class = shift;
44 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
45  
46 my $role_id = delete $args{role_id}
47 // croak "role_definition requires 'role_id'";
48 croak "role_id must not be empty" unless length $role_id;
49  
50 my @tags = (['-'], ['d', $role_id]);
51 push @tags, ['label', delete $args{label}] if defined $args{label};
52 push @tags, ['description', delete $args{description}] if defined $args{description};
53  
54 if (defined $args{color}) {
55 croak "color must be an integer from 0 to 360"
56 unless $args{color} =~ /\A[0-9]+\z/ && $args{color} >= 0 && $args{color} <= 360;
57 push @tags, ['color', '' . delete $args{color}];
58 }
59  
60 if (defined $args{order}) {
61 croak "order must be an integer"
62 unless $args{order} =~ /\A[0-9]+\z/;
63 push @tags, ['order', '' . delete $args{order}];
64 }
65  
66 return Net::Nostr::Event->new(
67 %args,
68 kind => 33534,
69 content => '',
70 tags => \@tags,
71 );
72 }
73  
74 sub membership_list {
75 my $class = shift;
76 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
77  
78 my $members = delete $args{members} // [];
79 croak "members must be an array reference"
80 unless ref $members eq 'ARRAY';
81  
82 my @tags = (['-']);
83 for my $member (@$members) {
84 if (ref $member eq 'HASH') {
85 my $pubkey = $member->{pubkey} // croak "member requires 'pubkey'";
86 my $roles = $member->{roles} // [];
87 croak "member roles must be an array reference"
88 unless ref $roles eq 'ARRAY';
89 push @tags, ['member', $pubkey, @$roles];
90 } else {
91 push @tags, ['member', $member];
92 }
93 }
94  
95 return Net::Nostr::Event->new(
96 %args,
97 kind => 13534,
98 content => '',
99 tags => \@tags,
100 );
101 }
102  
103 sub add_member {
104 my $class = shift;
105 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
106  
107 my $member = delete $args{member}
108 // croak "add_member requires 'member'";
109  
110 return Net::Nostr::Event->new(
111 %args,
112 kind => 8000,
113 content => '',
114 tags => [['-'], ['p', $member]],
115 );
116 }
117  
118 sub remove_member {
119 my $class = shift;
120 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
121  
122 my $member = delete $args{member}
123 // croak "remove_member requires 'member'";
124  
125 return Net::Nostr::Event->new(
126 %args,
127 kind => 8001,
128 content => '',
129 tags => [['-'], ['p', $member]],
130 );
131 }
132  
133 sub join_request {
134 my $class = shift;
135 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
136  
137 my $claim = delete $args{claim}
138 // croak "join_request requires 'claim'";
139  
140 return Net::Nostr::Event->new(
141 %args,
142 kind => 28934,
143 content => '',
144 tags => [['-'], ['claim', $claim]],
145 );
146 }
147  
148 sub invite {
149 my $class = shift;
150 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
151  
152 my $claim = delete $args{claim}
153 // croak "invite requires 'claim'";
154  
155 return Net::Nostr::Event->new(
156 %args,
157 kind => 28935,
158 content => '',
159 tags => [['-'], ['claim', $claim]],
160 );
161 }
162  
163 sub leave_request {
164 my $class = shift;
165 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
166  
167 return Net::Nostr::Event->new(
168 %args,
169 kind => 28936,
170 content => '',
171 tags => [['-']],
172 );
173 }
174  
175 sub from_event {
176 my ($class, $event) = @_;
177 my $kind = $event->kind;
178  
179 return undef unless exists $KINDS{$kind};
180  
181 my (%attrs, @members);
182  
183 for my $tag (@{$event->tags}) {
184 my $t = $tag->[0];
185 if ($t eq 'd' && $kind == 33534) {
186 $attrs{role_id} = $tag->[1];
187 }
188 elsif ($t eq 'label') { $attrs{label} = $tag->[1] }
189 elsif ($t eq 'description') { $attrs{description} = $tag->[1] }
190 elsif ($t eq 'color') { $attrs{color} = $tag->[1] }
191 elsif ($t eq 'order') { $attrs{order} = $tag->[1] }
192 elsif ($t eq 'member') {
193 if (@$tag > 2) {
194 push @members, {
195 pubkey => $tag->[1],
196 roles => [@{$tag}[2 .. $#$tag]],
197 };
198 } else {
199 push @members, $tag->[1];
200 }
201 }
202 elsif ($t eq 'p') { $attrs{member} = $tag->[1] }
203 elsif ($t eq 'claim') { $attrs{claim} = $tag->[1] }
204 }
205  
206 $attrs{members} = \@members if $kind == 13534;
207  
208 return $class->new(%attrs);
209 }
210  
211 sub validate {
212 my ($class, $event) = @_;
213 my $kind = $event->kind;
214  
215 croak "relay access event MUST be kind 13534, 33534, 8000, 8001, 28934, 28935, or 28936"
216 unless exists $KINDS{$kind};
217  
218 croak "relay access event MUST have a \"-\" protected tag"
219 unless $event->is_protected;
220  
221 if ($kind == 8000 || $kind == 8001) {
222 my $has_p;
223 for my $tag (@{$event->tags}) {
224 if ($tag->[0] eq 'p') { $has_p = 1; last }
225 }
226 croak "add/remove member event MUST have a 'p' tag"
227 unless $has_p;
228 }
229  
230 if ($kind == 28934 || $kind == 28935) {
231 my $has_claim;
232 for my $tag (@{$event->tags}) {
233 if ($tag->[0] eq 'claim') { $has_claim = 1; last }
234 }
235 croak "join/invite event MUST have a 'claim' tag"
236 unless $has_claim;
237 }
238  
239 if ($kind == 33534) {
240 my $has_d;
241 for my $tag (@{$event->tags}) {
242 if ($tag->[0] eq 'd') { $has_d = 1; last }
243 }
244 croak "role definition event MUST have a d tag"
245 unless $has_d;
246 }
247  
248 return 1;
249 }
250  
251 1;
252  
253 __END__
« Reaction.pm ↑ Summary RelayMonitor.pm »