| 1 | // Package webhook filtert gebeurtenissen en vult URL, headers en body. |
| 2 | package webhook |
| 3 | |
| 4 | import ( |
| 5 | "encoding/json" |
| 6 | "regexp" |
| 7 | "strings" |
| 8 | |
| 9 | "gitlab.com/Timfa/bluegit/internal/i18n" |
| 10 | ) |
| 11 | |
| 12 | // Soorten gebeurtenissen. |
| 13 | const ( |
| 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. |
| 22 | func AllEvents() []string { |
| 23 | return []string{EventPush, EventMergeRequest, EventPipelineSuccess, EventPipelineFailure, EventRelease} |
| 24 | } |
| 25 | |
| 26 | // KnownEvent meldt of name een ondersteunde gebeurtenis is. |
| 27 | func 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. |
| 37 | const ( |
| 38 | PresetDiscord = "discord" |
| 39 | PresetGrok = "grok" |
| 40 | PresetGeneric = "generic" |
| 41 | ) |
| 42 | |
| 43 | // Event is de gegevensset die een webhook te zien krijgt. |
| 44 | type 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. |
| 58 | type 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. |
| 67 | func 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. |
| 88 | func 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. |
| 106 | func 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 | |
| 131 | func 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 | |
| 152 | func 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. |
| 192 | func 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. |
| 207 | func 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. |
| 232 | func 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 | } |