Skip to content

v0.6.0

Choose a tag to compare

@github-actions github-actions released this 01 Mar 19:43
· 71 commits to main since this release
c8613e7

New Features

Email hook type

Hooks now support a native Email (SMTP) type, alongside the existing Webhook and Shell types. Configure your mail server once and attach it to any job for instant delivery notifications.

  • Supports STARTTLS (port 587), SSL/TLS (port 465), and plain SMTP (port 25) — useful for internal mail relays that require no authentication
  • The Security selector auto-fills the port field when you choose a mode; the port remains manually editable for non-standard setups
  • Password field includes a show/hide eye toggle
  • Subject and body support the same {{job_name}}, {{status}}, and other template variables available on webhooks
  • A ready-to-use Email Notification community template is available in the Hook Library

Hook Library — email support

The Hook Library browser now fully supports email-type templates:

  • Email templates appear in the library list with an Email badge
  • The Type filter includes an Email option
  • Secret fields in the "Configure & Import" form display a show/hide eye toggle (previously only available in the hook form itself)

Bug Fixes

  • Hook Library silently dropped email templates — the YAML parser rejected any template with type: email, so email-notification.yaml never appeared in the library. Fixed.
  • Hook Library import saved wrong type for email hooks — the import route was casting the type to "webhook" | "shell", which would have stored email hooks with an incorrect type in the database. Fixed.
  • TypeScript build error in executor — config as EmailConfig failed because the variable was typed as WebhookConfig | ShellConfig. Fixed by widening the type to include EmailConfig.

Documentation

Three new documentation pages have been added:

  • Hooks — complete reference for all three hook types, template variables, pre-job vs post-job behaviour, attaching hooks to jobs, viewing run logs, and security notes
  • Hook Library — how to use the library browser, the difference between community and local templates, GitHub API rate limits, and how to add local templates (including a Docker volume example)
  • Hook Template Authoring — full YAML format reference, the import-time vs runtime placeholder distinction, complete worked examples for each hook type, and the step-by-step community submission process

The docs/Home.md navigation table, CONTRIBUTING.md, and the Hook Submission pull request template have also been updated.

Dependencies

  • Added nodemailer@^7.0.13 for SMTP email delivery
  • Added .npmrc with legacy-peer-deps=true to suppress peer dependency warnings caused by conflicting @auth/core versions bundled by next-auth

Full Changelog: v0.5.7...v0.6.0