fix(gateway): preserve inbound event fidelity for Sentry and Linear sources (#124)

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>

Author: yordis

devops/docker/compose/.env.example

@@ -41,6 +41,13 @@
 # TROGON_SOURCE_NOTION_STREAM_MAX_AGE_SECS=604800
 # TROGON_SOURCE_NOTION_NATS_ACK_TIMEOUT_SECS=10
 
+# --- Sentry Source ---
+# TROGON_SOURCE_SENTRY_CLIENT_SECRET=
+# TROGON_SOURCE_SENTRY_SUBJECT_PREFIX=sentry
+# TROGON_SOURCE_SENTRY_STREAM_NAME=SENTRY
+# TROGON_SOURCE_SENTRY_STREAM_MAX_AGE_SECS=604800
+# TROGON_SOURCE_SENTRY_NATS_ACK_TIMEOUT_SECS=1
+
 # --- Discord Source ---
 # TROGON_SOURCE_DISCORD_BOT_TOKEN=
 # TROGON_SOURCE_DISCORD_GATEWAY_INTENTS=guilds,guild_members,guild_messages,guild_message_reactions,direct_messages,message_content,guild_voice_states

devops/docker/compose/services/trogon-gateway/README.md

@@ -16,6 +16,7 @@ prefix:
 | incident.io | `/incidentio/webhook` | `TROGON_SOURCE_INCIDENTIO_SIGNING_SECRET` |
 | Linear | `/linear/webhook` | `TROGON_SOURCE_LINEAR_WEBHOOK_SECRET` |
 | Notion | `/notion/webhook` | `TROGON_SOURCE_NOTION_VERIFICATION_TOKEN` |
+| Sentry | `/sentry/webhook` | `TROGON_SOURCE_SENTRY_CLIENT_SECRET` |
 
 The gateway port is configured via `TROGON_GATEWAY_PORT` (default `8080`).
 Liveness and readiness probes are available at `GET /-/liveness` and `GET /-/readiness`.
@@ -67,6 +68,13 @@ then point the Notion webhook endpoint at `/notion/webhook`. Verified events
 are forwarded to NATS on `{subject_prefix}.{type}` subjects such as
 `notion.page.created`.
 
+## Sentry webhooks
+
+Sentry integration-platform webhooks sign the raw JSON body with the app client
+secret. Configure `TROGON_SOURCE_SENTRY_CLIENT_SECRET`, point the webhook URL
+at `/sentry/webhook`, and the gateway will forward verified payloads to NATS on
+`{subject_prefix}.{resource}.{action}` subjects such as `sentry.issue.created`.
+
 ## Exposing webhooks with ngrok
 
 ```bash

rsworkspace/Cargo.lock

@@ -21,6 +21,7 @@ trogon-source-gitlab = { path = "crates/trogon-source-gitlab" }
 trogon-source-incidentio = { path = "crates/trogon-source-incidentio" }
 trogon-source-linear = { path = "crates/trogon-source-linear" }
 trogon-source-notion = { path = "crates/trogon-source-notion" }
+trogon-source-sentry = { path = "crates/trogon-source-sentry" }
 trogon-source-slack = { path = "crates/trogon-source-slack" }
 trogon-source-telegram = { path = "crates/trogon-source-telegram" }
 trogon-std = { path = "crates/trogon-std" }

rsworkspace/Cargo.toml

@@ -27,6 +27,7 @@ trogon-source-gitlab = { workspace = true }
 trogon-source-incidentio = { workspace = true }
 trogon-source-linear = { workspace = true }
 trogon-source-notion = { workspace = true }
+trogon-source-sentry = { workspace = true }
 trogon-source-slack = { workspace = true }
 trogon-source-telegram = { workspace = true }
 trogon-std = { workspace = true, features = ["clap", "telemetry-http"] }