feat(integrations): push Vercel deployment and uninstall events by webhook
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 35/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- nextjs, playwright, typescript
Hướng nghiên cứu
Start by reading the webhook contract from #28 and the existing adapter in src/lib/adapters/vercel/ to see how polling currently emits deployment events, then read docs/providers/vercel.md for the signature and envelope details. Work through the handler in order: constant-time HMAC SHA-1 verification of x-vercel-signature on the raw body, dedup on envelope id, team-to-connection mapping, then event mapping and integration-configuration.removed. Cover it with unit tests on recorded payloads plus the Playwright spec for the simulated provider; done is all acceptance boxes green under npm run lint, npm run typecheck, npm test.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Context
The Vercel adapter (#47, closed) polls deployments hourly. Eddie's decision on #28 (2026-11-14): webhooks first, polling as the backfill, and webhooks are in the MVP. Vercel can push without any new scope: the webhook URL lives on the integration, and deliveries are signed with the client secret the adapter already has.
From docs/providers/vercel.md, "Webhooks (Post-MVP)", checked against Vercel's docs on 2026-10-31:
| Item | Value |
|---|---|
| Where the URL lives | One Webhook URL per integration, set in the Integrations Console, with event checkboxes |
| Signature | x-vercel-signature: hex HMAC SHA-1 of the raw body, keyed with the integration's client secret. Rotating the secret changes the key |
| Envelope | { type, id, createdAt, region, payload }. Deployment payloads carry payload.team.id, payload.project.id, payload.deployment.{id,url,name}, payload.target |
| Delivery | 30 second timeout. Non-2xx responses are retried with backoff for up to 24 hours |
| Useful events | deployment.created, deployment.succeeded, deployment.ready, deployment.error, deployment.canceled, project.created, project.removed, integration-configuration.removed |
| Not pushed | Billing charges and usage. Spend stays polled |
Plan
- Implement the Vercel webhook declaration from the contract #28 adds: verify
x-vercel-signatureagainst the raw body in constant time, deduplicate on the envelopeid. - Map
payload.team.id(or the user id for a personal account) to the connection. Unknown teams are acknowledged and dropped. - Deployment events become the event types the adapter already emits, so a deployment seen by webhook and then by polling shows once.
integration-configuration.removedmarks the connection as needing a reconnect at once.project.createdandproject.removedupdate the connection's accounts without a reconnect, if the adapter's accounts are projects; otherwise ignore them.- Docs:
docs/providers/vercel.md(rename the section to "Webhooks", update uninstall detection and self-hosted registration to set the Webhook URL and events),docs/operations/oauth-apps.md.
Acceptance criteria
- A signed deployment delivery reaches the timeline within a minute, without waiting for a sync.
- A deployment seen by webhook and by polling shows once.
- Unsigned, wrongly signed, or repeated deliveries are rejected or ignored, and logged without their body.
-
integration-configuration.removedmarks the connection as needing a reconnect. - Polling still runs and still fills in charges and any missed delivery.
- Unit tests on recorded, sanitized payloads from Vercel's documented samples. No live calls in CI.
- Playwright e2e: a signed delivery for the simulated Vercel provider appears on the timeline.
Files and areas
src/lib/adapters/vercel/(webhook handler, schemas, fixtures, tests), the webhook route from #28,docs/providers/vercel.md,docs/operations/oauth-apps.md.- Non-goals: new scopes, domain events, and pushing spend (no webhook exists for it).
Verification
npm run lint,npm run typecheck,npm test- The Playwright spec for the simulated delivery.
Depends on
- #28 Ingest provider webhooks (contract, route, deduplication)
- #47 Add the Vercel adapter (closed)
Branch: <issue-number>-vercel-webhooks
Closes with a Closes #<issue-number> footer on the commit or pull request.
Model: anthropic/claude-opus-5-5 | Reasoning effort: unknown
- Ngôn ngữ chính
- TypeScript
- Star
- 1
- Fork
- 1
- Merge trung bình
- 6 giờ 56 phút
- Pull request đã merge (30 ngày)
- 136
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của eddiejaoude/StackDash
-
area: docs documentation priority: P3 size: S
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
eddiejaoude/StackDash#462 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area: web bug priority: P3 size: XS
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 85/100
eddiejaoude/StackDash#432 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area: database bug priority: P3 size: S
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
eddiejaoude/StackDash#419 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area: docs bug priority: P2 size: XS
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
eddiejaoude/StackDash#418 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
accessibility area: timeline bug priority: P3 size: XS
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 80/100
eddiejaoude/StackDash#389 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của eddiejaoude/StackDash
Issue tương tự
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
langchain-ai/langchainjs#12239 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Board view: the Monitoring column is always empty because compact issue rows drop displayStatusĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
paperclipai/paperclip#21837 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 73/100
code-yeongyu/senpi#6813 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 93/100
lingdojo/kana-dojo#34169 · 1 bình luận · 5 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100