mod/mod-ci-github.hxx


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
146
147
148
149
150
151

// file      : mod/mod-ci-github.hxx -*- C++ -*-
// license   : MIT; see accompanying LICENSE file

#ifndef MOD_MOD_CI_GITHUB_HXX
#define MOD_MOD_CI_GITHUB_HXX

#include <web/xhtml/fragment.hxx>

#include <libbrep/types.hxx>
#include <libbrep/utility.hxx>

#include <mod/module.hxx>
#include <mod/module-options.hxx>

namespace butl
{
  namespace json
  {
    class parser;
  }
}

namespace brep
{
  // GitHub request/response types.
  //
  // Note that having this types directly in brep causes clashes (e.g., for
  // the repository name).
  //
  namespace gh
  {
    namespace json = butl::json;

    // The "check_suite" object within a check_suite webhook request.
    //
    struct check_suite
    {
      uint64_t id;
      string head_branch;
      string head_sha;
      string before;
      string after;

      explicit
      check_suite (json::parser&);

      check_suite () = default;
    };

    struct repository
    {
      string name;
      string full_name;
      string default_branch;

      explicit
      repository (json::parser&);

      repository () = default;
    };

    struct installation
    {
      uint64_t id;

      explicit
      installation (json::parser&);

      installation () = default;
    };

    struct check_suite_event
    {
      string action;
      gh::check_suite check_suite;
      gh::repository repository;
      gh::installation installation;

      explicit
      check_suite_event (json::parser&);

      check_suite_event () = default;
    };

    struct installation_access_token
    {
      string token;
      timestamp expires_at;

      explicit
      installation_access_token (json::parser&);

      installation_access_token () = default;
    };

    static ostream&
    operator<< (ostream&, const check_suite&);

    static ostream&
    operator<< (ostream&, const repository&);

    static ostream&
    operator<< (ostream&, const installation&);

    static ostream&
    operator<< (ostream&, const check_suite_event&);

    static ostream&
    operator<< (ostream&, const installation_access_token&);
  }

  class ci_github: public handler
  {
  public:
    ci_github () = default;

    // Create a shallow copy (handling instance) if initialized and a deep
    // copy (context exemplar) otherwise.
    //
    explicit
    ci_github (const ci_github&);

    virtual bool
    handle (request&, response&);

    virtual const cli::options&
    cli_options () const {return options::ci_github::description ();}

  private:
    virtual void
    init (cli::scanner&);

    // Handle the check_suite event `requested` and `rerequested` actions.
    //
    bool
    handle_check_suite_request (gh::check_suite_event) const;

    string
    generate_jwt () const;

    // Authenticate to GitHub as an app installation.
    //
    gh::installation_access_token
    obtain_installation_access_token (uint64_t install_id, string jwt) const;

  private:
    shared_ptr<options::ci_github> options_;
  };
}

#endif // MOD_MOD_CI_GITHUB_HXX