feat(nitro): Nitro SDK

.craft.yml

@@ -139,6 +139,9 @@ targets:
   - name: npm
     id: '@sentry/react-router'
     includeNames: /^sentry-react-router-\d.*\.tgz$/
+  - name: npm
+    id: '@sentry/nitro'
+    includeNames: /^sentry-nitro-\d.*\.tgz$/
 
   ## 7. Other Packages
   ## 7.1
@@ -256,3 +259,9 @@ targets:
         packageUrl: 'https://www.npmjs.com/package/@sentry/elysia'
         mainDocsUrl: 'https://docs.sentry.io/platforms/javascript/guides/elysia/'
         onlyIfPresent: /^sentry-elysia-\d.*\.tgz$/
+      'npm:@sentry/nitro':
+        name: 'Sentry Nitro SDK'
+        sdkName: 'sentry.javascript.nitro'
+        packageUrl: 'https://www.npmjs.com/package/@sentry/nitro'
+        mainDocsUrl: 'https://docs.sentry.io/platforms/javascript/guides/nitro/'
+        onlyIfPresent: /^sentry-nitro-\d.*\.tgz$/

.github/ISSUE_TEMPLATE/bug.yml

@@ -52,6 +52,7 @@ body:
         - '@sentry/google-cloud-serverless'
         - '@sentry/nestjs'
         - '@sentry/nextjs'
+        - '@sentry/nitro'
         - '@sentry/nuxt'
         - '@sentry/react'
         - '@sentry/react-router'

.github/workflows/issue-package-label.yml

@@ -65,6 +65,9 @@ jobs:
               "@sentry.nestjs": {
                 "label": "Nest.js"
               },
+              "@sentry.nitro": {
+                "label": "Nitro"
+              },
               "@sentry.nextjs": {
                 "label": "Next.js"
               },

README.md

@@ -58,6 +58,7 @@ package. Please refer to the README and instructions of those SDKs for more deta
 - [`@sentry/gatsby`](https://github.com/getsentry/sentry-javascript/tree/master/packages/gatsby): SDK for Gatsby
 - [`@sentry/nestjs`](https://github.com/getsentry/sentry-javascript/tree/master/packages/nestjs): SDK for NestJS
 - [`@sentry/nextjs`](https://github.com/getsentry/sentry-javascript/tree/master/packages/nextjs): SDK for Next.js
+- [`@sentry/nitro`](https://github.com/getsentry/sentry-javascript/tree/master/packages/nitro): SDK for Nitro
 - [`@sentry/remix`](https://github.com/getsentry/sentry-javascript/tree/master/packages/remix): SDK for Remix
 - [`@sentry/tanstackstart-react`](https://github.com/getsentry/sentry-javascript/tree/master/packages/tanstackstart-react): SDK for TanStack Start React
 - [`@sentry/aws-serverless`](https://github.com/getsentry/sentry-javascript/tree/master/packages/aws-serverless): SDK

dev-packages/e2e-tests/verdaccio-config/config.yaml

@@ -242,6 +242,12 @@ packages:
     unpublish: $all
     # proxy: npmjs # Don't proxy for E2E tests!
 
+  '@sentry/nitro':
+    access: $all
+    publish: $all
+    unpublish: $all
+    # proxy: npmjs # Don't proxy for E2E tests!
+
   '@sentry-internal/*':
     access: $all
     publish: $all

package.json

@@ -71,6 +71,7 @@
     "packages/integration-shims",
     "packages/nestjs",
     "packages/nextjs",
+    "packages/nitro",
     "packages/node",
     "packages/node-core",
     "packages/node-native",

packages/nitro/.eslintrc.js

@@ -0,0 +1,7 @@
+module.exports = {
+  env: {
+    browser: true,
+    node: true,
+  },
+  extends: ['../../.eslintrc.js'],
+};

packages/nitro/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Functional Software, Inc. dba Sentry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/nitro/README.md

@@ -0,0 +1,126 @@
+<p align="center">
+  <a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
+    <img src="https://sentry-brand.storage.googleapis.com/sentry-wordmark-dark-280x84.png" alt="Sentry" width="280" height="84">
+  </a>
+</p>
+
+# Official Sentry SDK for Nitro
+
+[![npm version](https://img.shields.io/npm/v/@sentry/nitro.svg)](https://www.npmjs.com/package/@sentry/nitro)
+[![npm dm](https://img.shields.io/npm/dm/@sentry/nitro.svg)](https://www.npmjs.com/package/@sentry/nitro)
+[![npm dt](https://img.shields.io/npm/dt/@sentry/nitro.svg)](https://www.npmjs.com/package/@sentry/nitro)
+
+## Links
+
+- [Official Nitro SDK Docs](https://docs.sentry.io/platforms/javascript/guides/nitro/)
+
+## Compatibility
+
+The minimum supported version of Nitro is `3.0.0-alpha.1`.
+
+## General
+
+This package is a wrapper around `@sentry/node` with added instrumentation for Nitro's features like:
+
+- HTTP handlers and error capturing.
+- [Middleware instrumentation](https://nitro.build/guide/routing#middleware).
+  <!-- - [Database instrumentation](https://nitro.build/guide/database). -->
+  <!-- - [KV Storage](https://nitro.build/guide/storage) and [Cache](https://nitro.build/guide/cache) instrumentation. -->
+
+## Manual Setup
+
+### 1. Prerequisites & Installation
+
+1. Install the Sentry Nitro SDK:
+
+   ```bash
+   # Using npm
+   npm install @sentry/nitro
+
+   # Using yarn
+   yarn add @sentry/nitro
+
+   # Using pnpm
+   pnpm add @sentry/nitro
+   ```
+
+### 2. Nitro Config Setup
+
+1. Import `withSentryConfig` from `@sentry/nitro` and call it with your Nitro config.
+
+#### In `nitro.config.ts`
+
+If you are using a dedicated `nitro.config.ts` file, you can import `withSentryConfig` from `@sentry/nitro` and call it with your Nitro config.
+
+```javascript
+import { defineNitroConfig } from 'nitro/config';
+import { withSentryConfig } from '@sentry/nitro';
+
+const config = defineNitroConfig({
+  // ...
+});
+
+export default withSentryConfig(config, {
+  // Sentry Build Options
+});
+```
+
+#### In `vite.config.ts`
+
+If you are using nitro as a Vite plugin, you can import `withSentryConfig` from `@sentry/nitro` and call it with your Nitro config.
+
+```ts
+import { defineConfig } from 'vite';
+import { nitro } from 'nitro/vite';
+import { withSentryConfig } from '@sentry/nitro';
+
+export default defineConfig({
+  plugins: [nitro()],
+  nitro: withSentryConfig(
+    {
+      // Nitro options
+    },
+    {
+      // Sentry Build Options
+    },
+  ),
+});
+```
+
+### 3. Sentry Config Setup
+
+Create an `instrument.mjs` file in your project root to initialize the Sentry SDK:
+
+```javascript
+import * as Sentry from '@sentry/nitro';
+
+Sentry.init({
+  dsn: '__YOUR_DSN__',
+  tracesSampleRate: 1.0,
+});
+```
+
+Then use `NODE_OPTIONS` to load the instrumentation before your app code:
+
+```bash
+NODE_OPTIONS='--import ./instrument.mjs' npx nitro dev
+```
+
+This works with any Nitro command (`nitro dev`, `nitro preview`, or a production start script).
+
+## Uploading Source Maps
+
+The `withSentryConfig` function automatically configures source map uploading when the `authToken`, `org`, and `project`
+options are provided:
+
+```javascript
+export default withSentryConfig(config, {
+  org: 'your-sentry-org',
+  project: 'your-sentry-project',
+  authToken: process.env.SENTRY_AUTH_TOKEN,
+});
+```
+
+## Troubleshoot
+
+If you encounter any issues with error tracking or integrations, refer to the official [Sentry Nitro SDK documentation](https://docs.sentry.io/platforms/javascript/guides/nitro/). If the documentation does not provide the necessary information, consider opening an issue on GitHub.

packages/nitro/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@sentry/nitro",
+  "version": "10.48.0",
+  "description": "Official Sentry SDK for Nitro",
+  "repository": "git://github.com/getsentry/sentry-javascript.git",
+  "homepage": "https://github.com/getsentry/sentry-javascript/tree/master/packages/nitro",
+  "author": "Sentry",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.19.1"
+  },
+  "files": [
+    "/build"
+  ],
+  "main": "build/esm/index.js",
+  "module": "build/esm/index.js",
+  "types": "build/types/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "plugins": [
+        "build/types/plugins.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./build/types/index.d.ts",
+      "node": {
+        "import": "./build/esm/index.js"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "nitro": ">=3.0.260311-beta"
+  },
+  "dependencies": {
+    "@sentry/core": "10.48.0",
+    "@sentry/node": "10.48.0"
+  },
+  "devDependencies": {
+    "nitro": "^3.0.260311-beta"
+  },
+  "scripts": {
+    "build": "run-p build:transpile build:types",
+    "build:dev": "yarn build",
+    "build:transpile": "rollup -c rollup.npm.config.mjs",
+    "build:types": "run-s build:types:core",
+    "build:types:core": "tsc -p tsconfig.types.json",
+    "build:watch": "run-p build:transpile:watch build:types:watch",
+    "build:dev:watch": "yarn build:watch",
+    "build:transpile:watch": "rollup -c rollup.npm.config.mjs --watch",
+    "build:types:watch": "tsc -p tsconfig.types.json --watch",
+    "build:tarball": "npm pack",
+    "clean": "rimraf build coverage sentry-nitro-*.tgz",
+    "fix": "eslint . --format stylish --fix",
+    "lint": "eslint . --format stylish",
+    "lint:es-compatibility": "es-check es2022 ./build/esm/*.js --module",
+    "test": "vitest run",
+    "test:watch": "vitest --watch",
+    "yalc:publish": "yalc publish --push --sig"
+  },
+  "volta": {
+    "extends": "../../package.json"
+  },
+  "sideEffects": false
+}

packages/nitro/rollup.npm.config.mjs

@@ -0,0 +1,13 @@
+import { makeBaseNPMConfig, makeNPMConfigVariants } from '@sentry-internal/rollup-utils';
+
+export default [
+  ...makeNPMConfigVariants(
+    makeBaseNPMConfig({
+      entrypoints: ['src/index.ts'],
+      packageSpecificConfig: {
+        external: [/^nitro/],
+      },
+    }),
+    { emitCjs: false },
+  ),
+];

packages/nitro/src/common/debug-build.ts

@@ -0,0 +1,8 @@
+declare const __DEBUG_BUILD__: boolean;
+
+/**
+ * This serves as a build time flag that will be true by default, but false in non-debug builds or if users replace `__SENTRY_DEBUG__` in their generated code.
+ *
+ * ATTENTION: This constant must never cross package boundaries (i.e. be exported) to guarantee that it can be used for tree shaking.
+ */
+export const DEBUG_BUILD = __DEBUG_BUILD__;

packages/nitro/src/config.ts

@@ -0,0 +1,32 @@
+import type { NitroConfig } from 'nitro/types';
+import { createNitroModule } from './module';
+
+type SentryNitroOptions = {
+  // TODO: Add options
+};
+
+/**
+ * Modifies the passed in Nitro configuration with automatic build-time instrumentation.
+ *
+ * @param config A Nitro configuration object, as usually exported in `nitro.config.ts` or `nitro.config.mjs`.
+ * @returns The modified config to be exported
+ */
+export function withSentryConfig(config: NitroConfig, moduleOptions?: SentryNitroOptions): NitroConfig {
+  setupSentryNitroModule(config, moduleOptions);
+
+  return config;
+}
+
+/**
+ * Sets up the Sentry Nitro module, useful for meta framework integrations.
+ */
+export function setupSentryNitroModule(
+  config: NitroConfig,
+  _moduleOptions?: SentryNitroOptions,
+  _serverConfigFile?: string,
+): NitroConfig {
+  config.modules = config.modules || [];
+  config.modules.push(createNitroModule());
+
+  return config;
+}

packages/nitro/src/index.ts

@@ -0,0 +1,4 @@
+/* eslint-disable import/export */
+export * from './config';
+export * from '@sentry/node';
+export { init } from './sdk';

packages/nitro/src/module.ts

@@ -0,0 +1,13 @@
+import type { NitroModule } from 'nitro/types';
+
+/**
+ * Creates a Nitro module to setup the Sentry SDK.
+ */
+export function createNitroModule(): NitroModule {
+  return {
+    name: 'sentry',
+    setup: _nitro => {
+      // TODO: Setup the Sentry SDK.
+    },
+  };
+}

packages/nitro/src/sdk.ts

@@ -0,0 +1,29 @@
+import type { Integration } from '@sentry/core';
+import { applySdkMetadata } from '@sentry/core';
+import type { NodeClient, NodeOptions } from '@sentry/node';
+import { getDefaultIntegrations as getDefaultNodeIntegrations, init as nodeInit } from '@sentry/node';
+
+/**
+ * Initializes the Nitro SDK
+ */
+export function init(options: NodeOptions | undefined = {}): NodeClient | undefined {
+  const opts: NodeOptions = {
+    defaultIntegrations: getDefaultIntegrations(options),
+    ...options,
+  };
+
+  applySdkMetadata(opts, 'nitro');
+
+  const client = nodeInit(opts);
+
+  return client;
+}
+
+/**
+ *  Get the default integrations for the Nitro SDK.
+ *
+ *  @returns The default integrations for the Nitro SDK.
+ */
+export function getDefaultIntegrations(options: NodeOptions): Integration[] | undefined {
+  return [...getDefaultNodeIntegrations(options)];
+}