feat(node): Auto-register Hapi error handler on server start

MIGRATION.md

@@ -285,6 +285,12 @@ Affected SDKs: `@sentry/node` and all dependents.
 
 The new channel-based instrumentations (using `orchestrion` instead of `import-in-the-middle`) are now the default. They were available opt-in in v10. This unlocks instrumenting at run and build time, which enables instrumentation at deployment targets like Vercel and Netlify, as well as using instrumentations on non-Node runtimes like Cloudflare, Bun and Deno. For most users this requires no changes.
 
+### `setupHapiErrorHandler` is deprecated (Hapi errors are captured automatically)
+
+Affected SDKs: `@sentry/node` and all dependents that re-export it (e.g. `@sentry/aws-serverless`, `@sentry/google-cloud-serverless`, `@sentry/astro`, `@sentry/remix`, `@sentry/solidstart`, `@sentry/sveltekit`, `@sentry/bun`, `@sentry/elysia`).
+
+The Hapi error handler is now registered automatically when your server starts, so you no longer need to call `setupHapiErrorHandler` yourself. The function is deprecated and will be removed in a future major version; you should no longer call it.
+
 ### Initializing via `--require` is no longer supported
 
 Affected SDKs: `@sentry/node` and all dependents.

dev-packages/e2e-tests/test-applications/node-hapi/src/app.js

@@ -118,7 +118,6 @@ const init = async () => {
 
 (async () => {
   init();
-  await Sentry.setupHapiErrorHandler(server);
   await server.start();
   console.log('Server running on %s', server.info.uri);
 })();

dev-packages/node-integration-tests/suites/tracing/hapi/scenario.mjs

@@ -1,6 +1,5 @@
 import Boom from '@hapi/boom';
 import Hapi from '@hapi/hapi';
-import * as Sentry from '@sentry/node';
 import { sendPortToRunner } from '@sentry-internal/node-integration-tests';
 
 const port = 5999;
@@ -67,7 +66,6 @@ const run = async () => {
   // Server extension produces a `middleware` span.
   server.ext('onPreResponse', (request, h) => h.continue);
 
-  await Sentry.setupHapiErrorHandler(server);
   await server.start();
 
   sendPortToRunner(port);

packages/astro/src/index.server.ts

@@ -124,6 +124,7 @@ export {
   setAttribute,
   setAttributes,
   setupExpressErrorHandler,
+  // oxlint-disable-next-line typescript/no-deprecated
   setupHapiErrorHandler,
   setupKoaErrorHandler,
   setUser,

packages/aws-serverless/src/index.ts

@@ -121,6 +121,7 @@ export {
   childProcessIntegration,
   createSentryWinstonTransport,
   hapiIntegration,
+  // oxlint-disable-next-line typescript/no-deprecated
   setupHapiErrorHandler,
   spotlightIntegration,
   initOpenTelemetry,

packages/bun/src/index.ts

@@ -139,6 +139,7 @@ export {
   getOtlpTracesEndpoint,
   processSessionIntegration,
   hapiIntegration,
+  // oxlint-disable-next-line typescript/no-deprecated
   setupHapiErrorHandler,
   spotlightIntegration,
   initOpenTelemetry,

packages/elysia/src/index.ts

@@ -116,6 +116,7 @@ export {
   prismaIntegration,
   processSessionIntegration,
   hapiIntegration,
+  // oxlint-disable-next-line typescript/no-deprecated
   setupHapiErrorHandler,
   spotlightIntegration,
   initOpenTelemetry,

packages/google-cloud-serverless/src/index.ts

@@ -119,6 +119,7 @@ export {
   getOtlpTracesEndpoint,
   processSessionIntegration,
   hapiIntegration,
+  // oxlint-disable-next-line typescript/no-deprecated
   setupHapiErrorHandler,
   spotlightIntegration,
   initOpenTelemetry,

packages/node/src/index.ts

@@ -42,6 +42,7 @@ export {
   instrumentStateGraph,
   instrumentStateGraphCompile,
 } from '@sentry/server-utils';
+// oxlint-disable-next-line typescript/no-deprecated
 export { setupHapiErrorHandler } from './integrations/tracing/hapi';
 export { setupKoaErrorHandler } from './integrations/tracing/koa';
 export {

packages/node/src/integrations/tracing/hapi.ts

@@ -0,0 +1,17 @@
+import { attachHapiErrorHandler } from '@sentry/server-utils';
+
+/**
+ * Add a Hapi plugin to capture errors to Sentry.
+ *
+ * @deprecated The error handler is now registered automatically when the Hapi
+ * server starts (via the orchestrion `@hapi/hapi` instrumentation), so calling
+ * this is no longer necessary. It remains a safe, idempotent operation when the
+ * handler is already attached, and is kept for setups where auto-registration is
+ * unavailable. This will be removed in a future major version.
+ *
+ * @param server The Hapi server to attach the error handler to
+ */
+export async function setupHapiErrorHandler(server: unknown): Promise<void> {
+  // oxlint-disable-next-line typescript/no-deprecated
+  attachHapiErrorHandler(server as Parameters<typeof attachHapiErrorHandler>[0]);
+}