@nexttrace/next 0.1.1 → 0.1.2

package/README.md

@@ -76,10 +76,10 @@ NextTrace can capture outgoing HTTP requests originating from:
 
 Follow these 3 simple steps:
 
-### Step 1: Enable the Instrumentation Hook in Next.js
-
-In your `next.config.js` or `next.config.mjs`, enable `instrumentationHook`:
+### Step 1: Next.js Configuration
 
+- **Next.js 15+**: `instrumentation.ts` is **stable and enabled by default**! You can skip directly to Step 2 without touching your `next.config`.
+- **Next.js 14 & 13**: Enable `instrumentationHook` in `next.config.js` or `next.config.mjs`:
 ```js
 /** @type {import('next').NextConfig} */
 const nextConfig = {
@@ -91,8 +91,6 @@ const nextConfig = {
 module.exports = nextConfig;
 ```
 
-*(Note: In Next.js 15+, `instrumentationHook` is stable and enabled by default).*
-
 ---
 
 ### Step 2: Register Server Tracing in `instrumentation.ts`

package/dist/server.d.mts

@@ -6,10 +6,22 @@
  * Instruments globalThis.fetch on the Node.js server side in development
  */
 declare function instrumentServerFetch(): () => void;
+/**
+ * Alias for instrumentServerFetch (used in documentation and standard naming)
+ */
+declare const traceNextServer: typeof instrumentServerFetch;
+type NextTraceRouteHandlerFn = () => Promise<Response>;
+interface NextTraceRouteHandlers extends NextTraceRouteHandlerFn {
+    GET: NextTraceRouteHandlerFn;
+    POST: NextTraceRouteHandlerFn;
+}
 /**
  * Next.js App Router Route Handler for `app/api/__nexttrace/route.ts`
- * Exposes server events in dev mode only.
+ * Supports both:
+ *   export const { GET, POST } = createNextTraceRouteHandler();
+ * and:
+ *   export const GET = createNextTraceRouteHandler();
  */
-declare function createNextTraceRouteHandler(): () => Promise<Response>;
+declare function createNextTraceRouteHandler(): NextTraceRouteHandlers;
 
-export { createNextTraceRouteHandler, instrumentServerFetch };
+export { type NextTraceRouteHandlerFn, type NextTraceRouteHandlers, createNextTraceRouteHandler, instrumentServerFetch, traceNextServer };

package/dist/server.d.ts

@@ -6,10 +6,22 @@
  * Instruments globalThis.fetch on the Node.js server side in development
  */
 declare function instrumentServerFetch(): () => void;
+/**
+ * Alias for instrumentServerFetch (used in documentation and standard naming)
+ */
+declare const traceNextServer: typeof instrumentServerFetch;
+type NextTraceRouteHandlerFn = () => Promise<Response>;
+interface NextTraceRouteHandlers extends NextTraceRouteHandlerFn {
+    GET: NextTraceRouteHandlerFn;
+    POST: NextTraceRouteHandlerFn;
+}
 /**
  * Next.js App Router Route Handler for `app/api/__nexttrace/route.ts`
- * Exposes server events in dev mode only.
+ * Supports both:
+ *   export const { GET, POST } = createNextTraceRouteHandler();
+ * and:
+ *   export const GET = createNextTraceRouteHandler();
  */
-declare function createNextTraceRouteHandler(): () => Promise<Response>;
+declare function createNextTraceRouteHandler(): NextTraceRouteHandlers;
 
-export { createNextTraceRouteHandler, instrumentServerFetch };
+export { type NextTraceRouteHandlerFn, type NextTraceRouteHandlers, createNextTraceRouteHandler, instrumentServerFetch, traceNextServer };

package/dist/server.js

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var server_exports = {};
 __export(server_exports, {
   createNextTraceRouteHandler: () => createNextTraceRouteHandler,
-  instrumentServerFetch: () => instrumentServerFetch
+  instrumentServerFetch: () => instrumentServerFetch,
+  traceNextServer: () => traceNextServer
 });
 module.exports = __toCommonJS(server_exports);
 var import_core = require("@nexttrace/core");
@@ -182,8 +183,9 @@ function instrumentServerFetch() {
     }
   };
 }
+var traceNextServer = instrumentServerFetch;
 function createNextTraceRouteHandler() {
-  return async function GET() {
+  const handler = async function GET() {
     if (process.env.NODE_ENV !== "development") {
       return new Response(JSON.stringify({ error: "Forbidden in production" }), {
         status: 403,
@@ -201,9 +203,14 @@ function createNextTraceRouteHandler() {
       }
     });
   };
+  const routeHandler = handler;
+  routeHandler.GET = handler;
+  routeHandler.POST = handler;
+  return routeHandler;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createNextTraceRouteHandler,
-  instrumentServerFetch
+  instrumentServerFetch,
+  traceNextServer
 });

package/dist/server.mjs

@@ -164,8 +164,9 @@ function instrumentServerFetch() {
     }
   };
 }
+var traceNextServer = instrumentServerFetch;
 function createNextTraceRouteHandler() {
-  return async function GET() {
+  const handler = async function GET() {
     if (process.env.NODE_ENV !== "development") {
       return new Response(JSON.stringify({ error: "Forbidden in production" }), {
         status: 403,
@@ -183,8 +184,13 @@ function createNextTraceRouteHandler() {
       }
     });
   };
+  const routeHandler = handler;
+  routeHandler.GET = handler;
+  routeHandler.POST = handler;
+  return routeHandler;
 }
 export {
   createNextTraceRouteHandler,
-  instrumentServerFetch
+  instrumentServerFetch,
+  traceNextServer
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexttrace/next",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Next.js integration for NextTrace with dev-only gating, server fetch collection, and overlay component",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@nexttrace/core": "0.1.0",
-    "@nexttrace/devtools": "0.1.0"
+    "@nexttrace/devtools": "0.1.2"
   },
   "peerDependencies": {
     "next": ">=13.0.0 || >=14.0.0 || >=15.0.0",