| 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__ | ||