@xrayradar/nextjs 0.1.0

package/README.md

@@ -0,0 +1,61 @@
+# @xrayradar/nextjs
+
+XrayRadar SDK for Next.js: use **@xrayradar/node** on the server and **@xrayradar/react** (or **@xrayradar/browser**) on the client.
+
+## Server (Node)
+
+1. Create `instrumentation.ts` at your project root (same level as `app/` or `pages/`):
+
+```ts
+import { init } from "@xrayradar/node";
+
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    init({
+      dsn: process.env.XRAYRADAR_DSN!,
+      authToken: process.env.XRAYRADAR_AUTH_TOKEN,
+      environment: process.env.XRAYRADAR_ENVIRONMENT,
+      release: process.env.XRAYRADAR_RELEASE,
+    });
+  }
+}
+```
+
+2. Set env: `XRAYRADAR_DSN`, `XRAYRADAR_AUTH_TOKEN` (and optional `XRAYRADAR_ENVIRONMENT`, `XRAYRADAR_RELEASE`).
+
+## Client (Browser)
+
+In your root layout or `_app.tsx`:
+
+```tsx
+import { init } from "@xrayradar/react";
+import { ErrorBoundary } from "@xrayradar/react";
+
+// Call once when the app loads (client-side)
+if (typeof window !== "undefined") {
+  init({
+    dsn: process.env.NEXT_PUBLIC_XRAYRADAR_DSN!,
+    authToken: process.env.NEXT_PUBLIC_XRAYRADAR_AUTH_TOKEN,
+  });
+}
+
+export default function App({ Component, pageProps }) {
+  return (
+    <ErrorBoundary>
+      <Component {...pageProps} />
+    </ErrorBoundary>
+  );
+}
+```
+
+Use `NEXT_PUBLIC_*` for any client-visible DSN/token so Next.js inlines them.
+
+## Optional config wrapper
+
+```js
+// next.config.js
+const { withXrayRadarConfig } = require("@xrayradar/nextjs");
+module.exports = withXrayRadarConfig(yourExistingConfig);
+```
+
+This is a no-op placeholder for future Next.js-specific config (e.g. source maps, rewrites).

package/dist/index.d.mts

@@ -0,0 +1,31 @@
+export { ErrorBoundary, XrayRadarProvider, addBreadcrumb, captureException, captureMessage, getClient as getBrowserClient, init as initBrowser, setContext, setExtra, setTag, setUser, useXrayRadar } from '@xrayradar/react';
+export { getClient as getNodeClient, init as initNode } from '@xrayradar/node';
+
+/**
+ * Optional wrapper for next.config.js to integrate XrayRadar.
+ * Usage: const nextConfig = withXrayRadarConfig(yourExistingConfig);
+ */
+declare function withXrayRadarConfig<T extends Record<string, unknown>>(nextConfig: T): T;
+
+/**
+ * Next.js 13+ instrumentation: runs once when the Node server starts.
+ * Use this to init @xrayradar/node for server-side error capture.
+ *
+ * In your project, create instrumentation.ts (or .js) at the project root (same level as app/)
+ * and call registerServerInstrumentation() from there, or init @xrayradar/node directly:
+ *
+ *   import { init } from "@xrayradar/node";
+ *   export async function register() {
+ *     if (process.env.NEXT_RUNTIME === "nodejs") {
+ *       init({ dsn: process.env.XRAYRADAR_DSN, authToken: process.env.XRAYRADAR_AUTH_TOKEN });
+ *     }
+ *   }
+ */
+declare function registerServerInstrumentation(options?: {
+    dsn?: string;
+    authToken?: string;
+    environment?: string;
+    release?: string;
+}): Promise<void>;
+
+export { registerServerInstrumentation, withXrayRadarConfig };

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export { ErrorBoundary, XrayRadarProvider, addBreadcrumb, captureException, captureMessage, getClient as getBrowserClient, init as initBrowser, setContext, setExtra, setTag, setUser, useXrayRadar } from '@xrayradar/react';
+export { getClient as getNodeClient, init as initNode } from '@xrayradar/node';
+
+/**
+ * Optional wrapper for next.config.js to integrate XrayRadar.
+ * Usage: const nextConfig = withXrayRadarConfig(yourExistingConfig);
+ */
+declare function withXrayRadarConfig<T extends Record<string, unknown>>(nextConfig: T): T;
+
+/**
+ * Next.js 13+ instrumentation: runs once when the Node server starts.
+ * Use this to init @xrayradar/node for server-side error capture.
+ *
+ * In your project, create instrumentation.ts (or .js) at the project root (same level as app/)
+ * and call registerServerInstrumentation() from there, or init @xrayradar/node directly:
+ *
+ *   import { init } from "@xrayradar/node";
+ *   export async function register() {
+ *     if (process.env.NEXT_RUNTIME === "nodejs") {
+ *       init({ dsn: process.env.XRAYRADAR_DSN, authToken: process.env.XRAYRADAR_AUTH_TOKEN });
+ *     }
+ *   }
+ */
+declare function registerServerInstrumentation(options?: {
+    dsn?: string;
+    authToken?: string;
+    environment?: string;
+    release?: string;
+}): Promise<void>;
+
+export { registerServerInstrumentation, withXrayRadarConfig };

package/dist/index.js

@@ -0,0 +1,92 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ErrorBoundary: () => import_react.ErrorBoundary,
+  XrayRadarProvider: () => import_react.XrayRadarProvider,
+  addBreadcrumb: () => import_react.addBreadcrumb,
+  captureException: () => import_react.captureException,
+  captureMessage: () => import_react.captureMessage,
+  getBrowserClient: () => import_react.getClient,
+  getNodeClient: () => import_node.getClient,
+  initBrowser: () => import_react.init,
+  initNode: () => import_node.init,
+  registerServerInstrumentation: () => registerServerInstrumentation,
+  setContext: () => import_react.setContext,
+  setExtra: () => import_react.setExtra,
+  setTag: () => import_react.setTag,
+  setUser: () => import_react.setUser,
+  useXrayRadar: () => import_react.useXrayRadar,
+  withXrayRadarConfig: () => withXrayRadarConfig
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/config.ts
+function withXrayRadarConfig(nextConfig) {
+  return nextConfig;
+}
+
+// src/instrumentation.ts
+async function registerServerInstrumentation(options) {
+  if (typeof process === "undefined" || process.env.NEXT_RUNTIME !== "nodejs") {
+    return;
+  }
+  const { init: init3 } = await import("@xrayradar/node");
+  init3({
+    dsn: options?.dsn ?? process.env.XRAYRADAR_DSN,
+    authToken: options?.authToken ?? process.env.XRAYRADAR_AUTH_TOKEN,
+    environment: options?.environment ?? process.env.XRAYRADAR_ENVIRONMENT,
+    release: options?.release ?? process.env.XRAYRADAR_RELEASE
+  });
+}
+
+// src/index.ts
+var import_react = require("@xrayradar/react");
+var import_node = require("@xrayradar/node");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ErrorBoundary,
+  XrayRadarProvider,
+  addBreadcrumb,
+  captureException,
+  captureMessage,
+  getBrowserClient,
+  getNodeClient,
+  initBrowser,
+  initNode,
+  registerServerInstrumentation,
+  setContext,
+  setExtra,
+  setTag,
+  setUser,
+  useXrayRadar,
+  withXrayRadarConfig
+});

package/dist/index.mjs

@@ -0,0 +1,53 @@
+// src/config.ts
+function withXrayRadarConfig(nextConfig) {
+  return nextConfig;
+}
+
+// src/instrumentation.ts
+async function registerServerInstrumentation(options) {
+  if (typeof process === "undefined" || process.env.NEXT_RUNTIME !== "nodejs") {
+    return;
+  }
+  const { init: init3 } = await import("@xrayradar/node");
+  init3({
+    dsn: options?.dsn ?? process.env.XRAYRADAR_DSN,
+    authToken: options?.authToken ?? process.env.XRAYRADAR_AUTH_TOKEN,
+    environment: options?.environment ?? process.env.XRAYRADAR_ENVIRONMENT,
+    release: options?.release ?? process.env.XRAYRADAR_RELEASE
+  });
+}
+
+// src/index.ts
+import {
+  init,
+  getClient,
+  captureException,
+  captureMessage,
+  addBreadcrumb,
+  setUser,
+  setTag,
+  setExtra,
+  setContext,
+  ErrorBoundary,
+  XrayRadarProvider,
+  useXrayRadar
+} from "@xrayradar/react";
+import { init as init2, getClient as getClient2 } from "@xrayradar/node";
+export {
+  ErrorBoundary,
+  XrayRadarProvider,
+  addBreadcrumb,
+  captureException,
+  captureMessage,
+  getClient as getBrowserClient,
+  getClient2 as getNodeClient,
+  init as initBrowser,
+  init2 as initNode,
+  registerServerInstrumentation,
+  setContext,
+  setExtra,
+  setTag,
+  setUser,
+  useXrayRadar,
+  withXrayRadarConfig
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@xrayradar/nextjs",
+  "version": "0.1.0",
+  "description": "XrayRadar SDK for Next.js – server + client setup",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@xrayradar/node": "*",
+    "@xrayradar/react": "*"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.0"
+  },
+  "peerDependencies": {
+    "next": ">=13.0.0"
+  }
+}