summaryrefslogtreecommitdiffstats
path: root/extensions/MyDashboard/lib/WebService.pm
blob: 87061eabe4533b3681f72263835a20ff08155859 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
#
# This Source Code Form is "Incompatible With Secondary Licenses", as
# defined by the Mozilla Public License, v. 2.0.
package Bugzilla::Extension::MyDashboard::WebService;

use strict;
use warnings;

use base qw(Bugzilla::WebService Bugzilla::WebService::Bug);

use Bugzilla::Constants;
use Bugzilla::Error;
use Bugzilla::Util qw(detaint_natural trick_taint template_var datetime_from);
use Bugzilla::WebService::Util qw(validate);

use Bugzilla::Extension::MyDashboard::Queries qw(QUERY_DEFS query_bugs query_flags);

use constant READ_ONLY => qw(
    run_bug_query
    run_flag_query
);

sub run_last_changes {
    my ($self, $params) = @_;

    my $dbh = Bugzilla->dbh;
    my $user = Bugzilla->login(LOGIN_REQUIRED);

    trick_taint($params->{changeddate_api});
    trick_taint($params->{bug_id});

    my $last_comment_sql = "
        SELECT comment_id
            FROM longdescs
            WHERE bug_id = ? AND bug_when > ?";
    if (!$user->is_insider) {
        $last_comment_sql .= " AND isprivate = 0";
    }
    $last_comment_sql .= " LIMIT 1";
    my $last_comment_sth = $dbh->prepare($last_comment_sql);

    my $last_changes = {};
    my $activity = $self->history({ ids       => [ $params->{bug_id} ],
                                    new_since => $params->{changeddate_api} });
    if (@{$activity->{bugs}[0]{history}}) {
        my $change_set = $activity->{bugs}[0]{history}[0];
        $last_changes->{activity} = $change_set->{changes};
        foreach my $change (@{ $last_changes->{activity} }) {
            $change->{field_desc}
                = template_var('field_descs')->{$change->{field_name}} || $change->{field_name};
        }
        $last_changes->{email} = $change_set->{who};
        my $datetime = datetime_from($change_set->{when});
        $datetime->set_time_zone($user->timezone);
        $last_changes->{when} = $datetime->strftime('%Y-%m-%d %T %Z');
    }
    my $last_comment_id = $dbh->selectrow_array(
        $last_comment_sth, undef, $params->{bug_id}, $params->{changeddate_api});
    if ($last_comment_id) {
        my $comments = $self->comments({ comment_ids => [ $last_comment_id ] });
        my $comment = $comments->{comments}{$last_comment_id};
        $last_changes->{comment} = $comment->{text};
        $last_changes->{email} = $comment->{creator} if !$last_changes->{email};
        my $datetime = datetime_from($comment->{creation_time});
        $datetime->set_time_zone($user->timezone);
        $last_changes->{when} = $datetime->strftime('%Y-%m-%d %T %Z');
    }

    return { results => [ {last_changes => $last_changes } ] };
}

sub run_bug_query {
    my($self, $params) = @_;
    my $dbh = Bugzilla->dbh;
    my $user = Bugzilla->login(LOGIN_REQUIRED);

    defined $params->{query}
        || ThrowCodeError('param_required',
                          { function => 'MyDashboard.run_bug_query',
                            param    => 'query' });

    my $result;
    foreach my $qdef (QUERY_DEFS) {
        next if $qdef->{name} ne $params->{query};
        my ($bugs, $query_string) = query_bugs($qdef);

        # Add last changes to each bug
        foreach my $b (@$bugs) {
            # Set the data type properly for webservice clients
            # for non-string values.
            $b->{bug_id} = $self->type('int', $b->{bug_id});
        }

        $query_string =~ s/^POSTDATA=&//;
        $qdef->{bugs}   = $bugs;
        $qdef->{buffer} = $query_string;
        $result = $qdef;
        last;
    }

    return { result => $result };
}

sub run_flag_query {
    my ($self, $params) =@_;
    my $user = Bugzilla->login(LOGIN_REQUIRED);

    my $type = $params->{type};
    $type || ThrowCodeError('param_required',
                            { function => 'MyDashboard.run_flag_query',
                              param    => 'type' });

    my $results = query_flags($type);

    # Set the data type properly for webservice clients
    # for non-string values.
    foreach my $flag (@$results) {
        $flag->{id}        = $self->type('int', $flag->{id});
        $flag->{attach_id} = $self->type('int', $flag->{attach_id});
        $flag->{bug_id}    = $self->type('int', $flag->{bug_id});
        $flag->{is_patch}  = $self->type('boolean', $flag->{is_patch});
    }

    return { result => { $type => $results }};
}

1;

__END__

=head1 NAME

Bugzilla::Extension::MyDashboard::Webservice - The MyDashboard WebServices API

=head1 DESCRIPTION

This module contains API methods that are useful to user's of bugzilla.mozilla.org.

=head1 METHODS

See L<Bugzilla::WebService> for a description of how parameters are passed, 
and what B<STABLE>, B<UNSTABLE>, and B<EXPERIMENTAL> mean.