BlueGit

timfa bluegit

Files

bluegit / internal / webhook / webhook.go

webhook.go

feat: webhook-formulier per preset
timfa project_87923614_bot_3aff574f6f98414b945a8799374f9092 · pushed by timfa · 3 weeks ago
Failed 934ba1ea History
webhook.go 6.0 KiB Download Raw
1// Package webhook filtert gebeurtenissen en vult URL, headers en body.
2package webhook
3
4import (
5 "encoding/json"
6 "regexp"
7 "strings"
8
9 "gitlab.com/Timfa/bluegit/internal/i18n"
10)
11
12// Soorten gebeurtenissen.
13const (
14 EventPush = "push"
15 EventMergeRequest = "merge_request"
16 EventPipelineSuccess = "pipeline_success"
17 EventPipelineFailure = "pipeline_failure"
18 EventRelease = "release_published"
19)
20
21// AllEvents is de vaste lijst die een webhook mag aanvinken.
22func AllEvents() []string {
23 return []string{EventPush, EventMergeRequest, EventPipelineSuccess, EventPipelineFailure, EventRelease}
24}
25
26// KnownEvent meldt of name een ondersteunde gebeurtenis is.
27func KnownEvent(name string) bool {
28 for _, e := range AllEvents() {
29 if e == name {
30 return true
31 }
32 }
33 return false
34}
35
36// Presets.
37const (
38 PresetDiscord = "discord"
39 PresetGrok = "grok"
40 PresetGeneric = "generic"
41)
42
43// Event is de gegevensset die een webhook te zien krijgt.
44type Event struct {
45 Type string
46 Project string
47 Group string
48 Branch string
49 Commit string
50 Summary string
51 URL string
52 PipelineID string
53 ReleaseTag string
54 Actor string
55}
56
57// Hook is de opgeslagen configuratie, zonder geheimen al ingevuld.
58type Hook struct {
59 Preset string
60 Events []string
61 BranchFilter string
62}
63
64// Allows meldt of deze hook de gebeurtenis wil ontvangen.
65// Het branchfilter geldt alleen voor push. Leeg betekent alle branches.
66// "re:" gevolgd door een reguliere expressie, anders een exacte branchnaam.
67func Allows(h Hook, ev Event) (bool, error) {
68 if !KnownEvent(ev.Type) {
69 return false, i18n.E("err.whEvent", ev.Type)
70 }
71 found := false
72 for _, e := range h.Events {
73 if e == ev.Type {
74 found = true
75 break
76 }
77 }
78 if !found {
79 return false, nil
80 }
81 if ev.Type != EventPush {
82 return true, nil
83 }
84 return MatchBranch(h.BranchFilter, ev.Branch)
85}
86
87// MatchBranch past een push-filter toe.
88func MatchBranch(filter, branch string) (bool, error) {
89 filter = strings.TrimSpace(filter)
90 if filter == "" {
91 return true, nil
92 }
93 if strings.HasPrefix(filter, "re:") {
94 re, err := regexp.Compile(strings.TrimPrefix(filter, "re:"))
95 if err != nil {
96 return false, i18n.E("err.whFilter", err.Error())
97 }
98 return re.MatchString(branch), nil
99 }
100 return filter == branch, nil
101}
102
103// Expand vult {{event.veld}} en {{secret.NAAM}}.
104// Een onbekend geheim of veld is een fout, zodat een webhook niet
105// per ongeluk met een leeg token vertrekt.
106func Expand(s string, ev Event, secrets map[string]string) (string, error) {
107 var b strings.Builder
108 for {
109 start := strings.Index(s, "{{")
110 if start < 0 {
111 b.WriteString(s)
112 break
113 }
114 b.WriteString(s[:start])
115 rest := s[start+2:]
116 end := strings.Index(rest, "}}")
117 if end < 0 {
118 return "", i18n.E("err.whTemplate")
119 }
120 key := strings.TrimSpace(rest[:end])
121 val, err := lookup(key, ev, secrets)
122 if err != nil {
123 return "", err
124 }
125 b.WriteString(val)
126 s = rest[end+2:]
127 }
128 return b.String(), nil
129}
130
131func lookup(key string, ev Event, secrets map[string]string) (string, error) {
132 switch {
133 case strings.HasPrefix(key, "secret."):
134 name := strings.TrimPrefix(key, "secret.")
135 v, ok := secrets[name]
136 if !ok {
137 return "", i18n.E("err.whSecret", name)
138 }
139 return v, nil
140 case strings.HasPrefix(key, "event."):
141 field := strings.TrimPrefix(key, "event.")
142 v, ok := eventField(ev, field)
143 if !ok {
144 return "", i18n.E("err.whField", field)
145 }
146 return v, nil
147 default:
148 return "", i18n.E("err.whPlaceholder", key)
149 }
150}
151
152func eventField(ev Event, field string) (string, bool) {
153 if base, ok := strings.CutSuffix(field, "_json"); ok && base != "" {
154 v, ok := eventField(ev, base)
155 if !ok {
156 return "", false
157 }
158 b, err := json.Marshal(v)
159 if err != nil {
160 return "", false
161 }
162 return string(b), true
163 }
164 switch field {
165 case "type":
166 return ev.Type, true
167 case "project":
168 return ev.Project, true
169 case "group":
170 return ev.Group, true
171 case "branch":
172 return ev.Branch, true
173 case "commit":
174 return ev.Commit, true
175 case "summary":
176 return ev.Summary, true
177 case "url":
178 return ev.URL, true
179 case "pipeline_id":
180 return ev.PipelineID, true
181 case "release_tag":
182 return ev.ReleaseTag, true
183 case "actor":
184 return ev.Actor, true
185 default:
186 return "", false
187 }
188}
189
190// PresetDefaults vult URL-headers en body als de gebruiker een preset kiest
191// en een veld leeg laat.
192func PresetDefaults(preset string) (headers map[string]string, body string) {
193 switch preset {
194 case PresetDiscord:
195 return map[string]string{"Content-Type": "application/json"}, `{"content":"{{event.summary}}"}`
196 case PresetGrok:
197 return map[string]string{
198 "Content-Type": "application/json",
199 "Authorization": "Bearer {{secret.GROK_TOKEN}}",
200 }, ""
201 default:
202 return map[string]string{"Content-Type": "application/json"}, ""
203 }
204}
205
206// RenderBody maakt de HTTP-body. Een lege sjabloon wordt de gebeurtenis als JSON.
207func RenderBody(bodyTemplate string, ev Event, secrets map[string]string) ([]byte, error) {
208 if strings.TrimSpace(bodyTemplate) == "" {
209 payload := map[string]string{
210 "type": ev.Type,
211 "project": ev.Project,
212 "group": ev.Group,
213 "branch": ev.Branch,
214 "commit": ev.Commit,
215 "summary": ev.Summary,
216 "url": ev.URL,
217 "pipeline_id": ev.PipelineID,
218 "release_tag": ev.ReleaseTag,
219 "actor": ev.Actor,
220 }
221 return json.Marshal(payload)
222 }
223 s, err := Expand(bodyTemplate, ev, secrets)
224 if err != nil {
225 return nil, err
226 }
227 return []byte(s), nil
228}
229
230// RenderHeaders vult geheimen in headers. Preset-headers vullen alleen
231// ontbrekende sleutels aan.
232func RenderHeaders(preset string, configured map[string]string, ev Event, secrets map[string]string) (map[string]string, error) {
233 base, _ := PresetDefaults(preset)
234 if base == nil {
235 base = map[string]string{}
236 }
237 for k, v := range configured {
238 base[k] = v
239 }
240 out := map[string]string{}
241 for k, v := range base {
242 ek, err := Expand(k, ev, secrets)
243 if err != nil {
244 return nil, err
245 }
246 evv, err := Expand(v, ev, secrets)
247 if err != nil {
248 return nil, err
249 }
250 out[ek] = evv
251 }
252 return out, nil
253}