feat: add webhooks listen command for local development

[felipefreitag]

Adds a resend webhooks listen command that starts a local HTTP server, registers a temporary Resend webhook, displays incoming events in the terminal, and optionally forwards payloads to a local URL.

[cubic-dev-ai]

1 issue found across 2 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="src/commands/webhooks/listen.ts">

<violation number="1" location="src/commands/webhooks/listen.ts:271">
P2: Handle `server.listen` errors so port-binding failures are reported cleanly.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

1 issue found across 1 file (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="src/commands/webhooks/listen.ts">

<violation number="1" location="src/commands/webhooks/listen.ts:282">
P2: Use a one-time startup error handler (or remove it after listen) so later server errors are not silently swallowed.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

P2: Use a one-time startup error handler (or remove it after listen) so later server errors are not silently swallowed.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At src/commands/webhooks/listen.ts, line 282:

<comment>Use a one-time startup error handler (or remove it after listen) so later server errors are not silently swallowed.</comment>

<file context>
@@ -277,9 +277,23 @@ For example, if using ngrok: ngrok http 4318`,
-    });
+    try {
+      await new Promise<void>((resolve, reject) => {
+        server.on('error', reject);
+        server.listen(port, resolve);
+      });
</file context>

Suggested change

	server.on('error', reject);
	server.listen(port, resolve);
	server.once('error', reject);
	server.listen(port, () => {
	server.off('error', reject);
	resolve();
	});