package PGXN::Site::Controller;

use 5.10.0;
use utf8;
use strict;
use warnings;
#use aliased 'PGXN::Site::Request';
use Plack::Request;
use Plack::Response;
use PGXN::Site::Templates;
use HTML::TagCloud;
use Encode;
use WWW::PGXN;
use List::MoreUtils qw(any);
use namespace::autoclean;
our $VERSION = v0.23.9;

Template::Declare->init( dispatch_to => ['PGXN::Site::Templates'] );

my %code_for = (
    success     => 200,
    seeother    => 303,
    badrequest  => 400,
    forbidden   => 403,
    notfound    => 404,
    notallowed  => 405,
    conflict    => 409,
    gone        => 410,
    servererror => 200, # Only handled by ErrorDocument, which keeps 500.
);

sub new {
    my ($class, %p) = @_;

    unless ($p{base_url} && $p{api_url} && $p{errors_to} && $p{errors_from} && $p{feedback_to}) {
        die "Missing required parameters base_url, api_url, errors_to, errors_from, and feedback_to\n";
    }

    (my $api_url  = $p{api_url})  =~ s{/+$}{};
    (my $base_url = $p{base_url}) =~ s{/+$}{};
    bless {
        errors_to   => $p{errors_to},
        errors_from => $p{errors_from},
        feedback_to => $p{feedback_to},
        base_url    => URI->new($base_url),
        api_url     => URI->new($api_url),
        api         => WWW::PGXN->new(
            url   =>  $p{private_api_url} || $api_url,
            proxy => $p{proxy_url}
        )
    } => $class;
}

sub api         { shift->{api}         }
sub base_url    { shift->{base_url}    }
sub api_url     { shift->{api_url}     }
sub errors_to   { shift->{errors_to}   }
sub errors_from { shift->{errors_from} }
sub feedback_to { shift->{feedback_to} }

sub render {
    my ($self, $template, $p) = @_;
    my $req = $p->{req} ||= Plack::Request->new($p->{env});
    my $res = $req->new_response($p->{code} || 200);
    $p->{vars}{base_url} = $self->base_url;
    my $body = encode_utf8 +Template::Declare->show($template, $p->{req}, $p->{vars});
    $res->body($body);
    $res->content_length(length $body);
    $res->content_type($p->{type} || 'text/html; charset=UTF-8');
    $res->finalize;
}

sub redirect {
    my ($sel, $uri, $code) = @_;
    my $res = Plack::Response->new;
    $res->redirect($uri, $code || $code_for{seeother});
    return $res->finalize;
}

sub missing {
    my ($self, $env) = @_;
    $self->render('/notfound', { env => $env, code => $code_for{notfound} });
}

sub _cloud {
    my $self = shift;
    my $cloud = HTML::TagCloud->new(levels => 12);
    my $tags  = $self->api->get_stats('tag');
    $cloud->add($_->{tag}, "/tag/$_->{tag}/", $_->{dists})
        for grep { $_->{tag} = lc $_->{tag} } @{ $tags->{popular} };
    return $cloud;
}

sub home {
    my $self  = shift;
    $self->render('/home', {
        env => shift,
        vars => {
            cloud => _cloud($self),
            dists => $self->api->get_stats('dist')->{recent},
        },
    });
}

sub feedback {
    my $self = shift;
    $self->render('/feedback', { env => shift, vars => {
        feedback_to => $self->feedback_to
    } });
}

sub art {
    my $self = shift;
    $self->render('/art', { env => shift });
}

sub about {
    my $self = shift;
    $self->render('/about', { env => shift, vars => {
        stats => $self->api->get_stats('summary'),
    } });
}

sub donors {
    my $self = shift;
    $self->render('/donors', { env => shift });
}

sub recent {
    my $self  = shift;
    my $dists = $self->api->get_stats('dist')->{recent};
    $self->render('/recent', { env => shift, vars => { dists => $dists } });
}

sub mirroring {
    my $self = shift;
    $self->render('/mirroring', { env => shift, vars => {
        feedback_to => $self->feedback_to
    } });
}

sub spec {
    my ($self, $env, $format) = @_;
    return [
        200,
        ['Content-Type' => 'text/plain; charset=utf-8'],
        [encode_utf8 $self->api->spec('txt')]
    ] if $format eq 'txt';

    $self->render('/spec', { env => $env, vars => {
        body => $self->api->spec('html')
    } });
}

sub faq {
    my $self = shift;
    $self->render('/faq', { env => shift });
}

sub distribution {
    my ($self, $env, $name, $version) = @_;
    my $dist = $self->api->get_distribution($name => $version)
        or return $self->missing($env);

    $self->render('/distribution', { env => $env, vars => {
        dist      => $dist,
        api_url   => $self->api_url,
        dist_name => $dist->{name} . ($version ? " $version" : ''),
        user      => $self->api->get_user($dist->user),
    }});
}

sub document {
    my ($self, $env, $name, $version, $path) = @_;
    my $dist = $self->api->get_distribution($name => $version)
        or return $self->missing($env);
    $path =~ s/[.]html$//;
    my $doc = $dist->body_for_html_doc($path) or return $self->missing($env);

    my ($dist_uri, $dist_name) = $version
        ? (lc "/dist/$name/$version/", "$dist->{name} $version")
        : (lc "/dist/$name/", $dist->{name});
    $self->render('/document', { env => $env, vars => {
        dist      => $dist,
        docpath   => $path,
        body      => $doc,
        dist_uri  => $dist_uri,
        dist_name => $dist_name,
        user      => $self->api->get_user($dist->user),
    }});
}

sub user {
    my ($self, $env, $nick) = @_;
    my $user = $self->api->get_user($nick) or return $self->missing($env);

    $self->render('/user', { env => $env, vars => {
        user    => $user,
        api     => $self->api,
        api_url => $self->api_url,
    }});
}

sub users {
    my ($self, $env) = @_;
    my $req    = Plack::Request->new($env);
    my $params = $req->query_parameters;
    my $char   = lc ($params->{c} || '');

    # Usernames must always start with an ASCII letter.
    if ($char && $char !~ /^[a-z]$/) {
        return $self->render('/badrequest', {
            env => $env,
            code => $code_for{badrequest},
            vars => { param => 'c' },
        });
    }

    for my $param (qw(o l)) {
        my $val = $params->{$param};
        return $self->render('/badrequest', {
            env => $env,
            code => $code_for{badrequest},
            vars => { param => $param },
        }) if $val && $val !~ /^\d+$/;
    }

    $self->render('/users', { req => $req, vars => {
        in    => 'users',
        char  => $char,
        api   => $self->api,
        users => $char ? $self->api->get_userlist($char) : undef,
    }});
}

sub tags {
    my $self = shift;
    $self->render('/tags', {
        env  => shift,
        vars => { cloud => _cloud($self) },
    });
}

sub tag {
    my ($self, $env, $tag) = @_;
    $tag = $self->api->get_tag($tag) or return $self->missing($env);

    $self->render('/tag', { env => $env, vars => {
        tag     => $tag,
        api     => $self->api,
        api_url => $self->api_url,
    }});
}

sub extension {
    my ($self, $env, $ext) = @_;
    $ext = $self->api->get_extension($ext) or return $self->missing($env);
    my $data = $ext->{$ext->{latest}};
    my $uri = lc "/dist/$data->{dist}/";
    $uri .= "$data->{docpath}.html" if $data->{docpath};
    $self->redirect($uri, $code_for{seeother});
}

sub search {
    my ($self, $env) = @_;
    my $req = Plack::Request->new($env);
    my $params = $req->query_parameters;
    my $q = $params->{q};

    if (!defined $q || any { $q eq $_ } '', '*', '?') {
        # Just redirect if there is no search term.
        unless ($q) {
            my $ref = '/';
            if ($req->referer) {
                my $uri = URI->new($req->referer);
                $ref = $uri if $uri->can('host') && $uri->host
                    && $uri->host eq $req->uri->host;
            }
            return $self->redirect($ref, $code_for{seeother});
        }
        return $self->render('/badrequest', {
            env => $env,
            code => $code_for{badrequest},
            vars => { param => 'q' },
        });
    }

    my $in = $params->{in};
    unless (defined $in && any { $in eq $_ } qw(docs dists extensions users tags)) {
        return $self->render('/badrequest', {
            env => $env,
            code => $code_for{badrequest},
            vars => { param => $q ? 'in' : 'q' },
        });
    }

    for my $param (qw(o l)) {
        my $val = $params->{$param};
        return $self->render('/badrequest', {
            env => $env,
            code => $code_for{badrequest},
            vars => { param => $param },
        }) if $val && $val !~ /^\d+$/;
    }

    $self->render('/search', { req => $req, vars => {
        in      => $in,
        api     => $self->api,
        results => $self->api->search(
            in     => $in,
            query  => decode_utf8($q),
            offset => $params->{o},
            limit  => $params->{l},
        ),
    }});
}

sub server_error {
    my ($self, $env) = @_;

    # Pull together the original request environment.
    my $err_env = { map {
        my $k = $_;
        s/^psgix[.]errordocument[.]//
            ? /plack[.]stacktrace[.]/ ? () : ($_ => $env->{$k} )
            : ();
    } keys %{ $env } };
    my $uri = Plack::Request->new($err_env)->uri;

    if (%{ $err_env }) {
        # Send an email to the administrator.
        require Email::MIME;
        require Email::Sender::Simple;
        require Data::Dump;
        if (my $errfh = $env->{'psgi.errors'}) {
            print {$errfh} "An error occurred during a request to $uri:\n\n"
                . ($env->{'plack.stacktrace.text'} || 'No Trace. :-(')
                . "\n";
        }

        my $email = Email::MIME->create(
            header     => [
                From    => $self->errors_from,
                To      => $self->errors_to,
                Subject => 'PGXN Internal Server Error',
            ],
            attributes => {
                content_type => 'text/plain',
                charset      => 'UTF-8',
            },
            body    => "An error occurred during a request to $uri.\n\n"
                     . "Environment:\n\n" . Data::Dump::pp($err_env)
                     . "\n\nTrace:\n\n"
                     . ($env->{'plack.stacktrace.text'} || 'None found. :-(')
                     . "\n",
        );
        Email::Sender::Simple->send($email);
    }

    $self->render('/servererror', { env => $env });
 }

1;

=head1 Name

PGXN::Site::Controller - The PGXN::Site request controller

=head1 Synopsis

  use PGXN::Site::Controller;
  use Router::Resource;

  my $controller = PGXN::Site::Controller->new(url => 'https://api.pgxn.org');
  my $router = router {
      resource '/' => sub {
          GET { $controller->home(@_) };
      };
  };

=head1 Description

This class defines controller actions for PGXN::Site requests. It's designed
to be called from within Router::Resource HTTP methods.

=head1 Interface

=head2 Constructor

=head3 C<new>

  my $controller = PGXN::Site::Controller->new(url => $private_api_url);

Constructs and returns a new controller. The parameters are the same as those
supported by L<WWW::PGXN>, which will be used to fetch the data needed to
serve pages.

=head2 Accessors

=head3 C<api>

  my $api = $controller->api;

Returns a L<WWW::PGXN> object used to access the PGXN API.

=head3 C<api_url>

  my $api_url = $controller->api_url;

Returns the URL used to link to the API in the UI. If C<private_api_url> is
not passed to C<new()>, this URL is also used for communicating with the API
via the L<WWW::PGXN> object returned by C<api>.

=head3 C<base_url>

  my $base_url = $controller->base_url;

Returns the base URL for the site. Used for links that must be absolute.

=head3 C<errors_to>

  my $errors_to = $controller->errors_to;

Returns the email address to which error messages will be sent.

=head3 C<errors_from>

  my $errors_from = $controller->errors_from;

Returns the email address from which error messages will be sent to
C<errors_to>.

=head3 C<feedback_to>

  my $feedback_to = $controller->feedback_to;

Returns the email address listed in the UI for sending feedback.

=head2 Actions

=head3 C<home>

  PGXN::Site::Controller->home($env);

Displays the HTML for the home page.

=head3 C<feedback>

  PGXN::Site::Controller->feedback($env);

Displays the HTML for the feedback page.

=head3 C<art>

  PGXN::Site::Controller->art($env);

Displays the HTML for the identity page.

=head3 C<about>

  PGXN::Site::Controller->about($env);

Displays the HTML for the about page.

=head3 C<donors>

  PGXN::Site::Controller->donors($env);

Displays the HTML for the donors page.

=head3 C<recent>

  PGXN::Site::Controller->recent($env);

Displays the HTML for the recent releases page.

=head3 C<mirroring>

  PGXN::Site::Controller->mirroring($env);

Displays the HTML for the mirroring page.

=head3 C<spec>

  PGXN::Site::Controller->spec($env, $format);

Displays the HTML or plain text for the PGXN Meta Spec.

=head3 C<faq>

  PGXN::Site::Controller->faq($env);

Displays the HTML for the FAQ page.

=head3 C<distribution>

  PGXN::Site::Controller->distribution($env);

Displays the HTML for the distribution page.

=head3 C<document>

  PGXN::Site::Controller->document($env);

Displays the HTML for the document page.

=head3 C<user>

  PGXN::Site::Controller->user($env);

Displays the HTML for the user page.

=head3 C<users>

  PGXN::Site::Controller->users($env);

Displays the HTML for the users search page.

=head3 C<tags>

  PGXN::Site::Controller->tags($env);

Displays the HTML for the tags page, including search form and tag cloud.

=head3 C<tag>

  PGXN::Site::Controller->tag($env);

Displays the HTML for the tag page.

=head3 C<extension>

  PGXN::Site::Controller->extension($env);

Displays the HTML for the extension page.

=head3 C<search>

  PGXN::Site::Controller->search($env);

Displays the HTML for the search page.

=head3 C<server_error>

Handles subrequests from L<Plack::Middleware::ErrorDocument> when a 500 is
returned. Best way to set it up is to add these three middlewares to the
production configuration file:

    "middleware": [
        ["ErrorDocument", 500, "/error", "subrequest", 1],
        ["HTTPExceptions"],
        ["StackTrace", "no_print_errors", 1]
    ],

=head2 Methods

=head3 C<render>

  $controller->render('/home', $req, @template_args);

Renders the response to the request using L<PGXN::Site::Templates>.

=head3 C<redirect>

  $controller->render('/home', $req);

Redirect the request to a new page.

=head3 C<missing>

  $controller->missing($env, $data);

Handles 404 and 405 errors from Router::Resource.

=over

=item C<success>

=item C<forbidden>

=item C<notfound>

=back

=head1 Author

David E. Wheeler <david@justatheory.com>

=head1 Copyright and License

Copyright (c) 2010-2026 David E. Wheeler.

This module is free software; you can redistribute it and/or modify it under
the L<PostgreSQL License|https://www.opensource.org/licenses/postgresql>.

Permission to use, copy, modify, and distribute this software and its
documentation for any purpose, without fee, and without a written agreement is
hereby granted, provided that the above copyright notice and this paragraph
and the following two paragraphs appear in all copies.

In no event shall David E. Wheeler be liable to any party for direct,
indirect, special, incidental, or consequential damages, including lost
profits, arising out of the use of this software and its documentation, even
if David E. Wheeler has been advised of the possibility of such damage.

David E. Wheeler specifically disclaims any warranties, including, but not
limited to, the implied warranties of merchantability and fitness for a
particular purpose. The software provided hereunder is on an "as is" basis,
and David E. Wheeler has no obligations to provide maintenance, support,
updates, enhancements, or modifications.

=cut
