@nextlytics/core 0.5.1 → 0.6.0-canary.114

package/dist/middleware.js

@@ -59,6 +59,8 @@ function createNextlyticsMiddleware(config, dispatchEvent, updateEvent, collectT
         integrity: request.integrity,
         isPrefetch: reqInfo.isPrefetch,
         isRsc: reqInfo.isRsc,
+        isDocumentRequest: reqInfo.isDocumentRequest,
+        isBrowserSubrequest: reqInfo.isBrowserSubrequest,
         isPageNavigation: reqInfo.isPageNavigation,
         isStaticFile: reqInfo.isStaticFile,
         isNextjsInternal: reqInfo.isNextjsInternal,
@@ -76,7 +78,13 @@ function createNextlyticsMiddleware(config, dispatchEvent, updateEvent, collectT
       response2.headers.set(import_server_component_context.headerNames.active, "1");
       return response2;
     }
-    if (!reqInfo.isPageNavigation && !config.isApiPath(pathname)) {
+    if (reqInfo.isBrowserSubrequest && !config.isApiPath(pathname)) {
+      const response2 = import_server.NextResponse.next();
+      response2.headers.set(import_server_component_context.headerNames.active, "1");
+      return response2;
+    }
+    const isReadMethod = request.method === "GET" || request.method === "HEAD";
+    if (!isReadMethod && !reqInfo.isDocumentRequest && !config.isApiPath(pathname)) {
       const response2 = import_server.NextResponse.next();
       response2.headers.set(import_server_component_context.headerNames.active, "1");
       return response2;

package/dist/server.js

@@ -227,7 +227,9 @@ function Nextlytics(userConfig) {
           collectedAt: (/* @__PURE__ */ new Date()).toISOString(),
           anonymousUserId,
           serverContext,
-          userContext,
+          // An explicit per-event user (e.g. an email recipient resolved from a
+          // link) overrides the request-derived one from callbacks.getUser.
+          userContext: opts?.user ?? userContext,
           properties: { ...propsFromCallback, ...opts?.props }
         };
         const { completion } = dispatchEventInternal(event, ctx);

package/dist/types.d.ts

@@ -231,6 +231,10 @@ type NextlyticsServerSide = {
     /** Send custom event from a server component, server action, or API route */
     sendEvent: (eventName: string, opts?: {
         props?: Record<string, unknown>;
+        /** Identify the event's user explicitly. Overrides callbacks.getUser for
+         * this event — e.g. an email recipient resolved from a link, where the
+         * request has no session to derive identity from. */
+        user?: UserContext;
     }) => Promise<{
         ok: boolean;
     }>;

package/dist/uitils.d.ts

@@ -16,6 +16,17 @@ type RequestInfo = {
     isPrefetch: boolean;
     /** True if this is an RSC (React Server Components) navigation */
     isRsc: boolean;
+    /** True if this is a hard document navigation (sec-fetch-dest=document or
+     * sec-fetch-mode=navigate) — the strong signal, distinct from the weaker
+     * accepts-HTML heuristic folded into isPageNavigation. */
+    isDocumentRequest: boolean;
+    /** True if this is a browser-initiated sub-request (RSC soft-navigation, XHR,
+     * fetch(), or a subresource) — Sec-Fetch-Dest is present and is not
+     * "document". Modern browsers always send Sec-Fetch-Dest (it's a forbidden
+     * header, so it can't be spoofed); non-browser clients (curl, agents, bots,
+     * server-to-server) omit it. Used to skip soft-navigation RSC fetches, which
+     * carry no reliable RSC header in Next 15.5+ yet must not be double-counted. */
+    isBrowserSubrequest: boolean;
     /** True if this is a standard document or RSC navigation */
     isPageNavigation: boolean;
     /** True if this is a static file (ico, png, css, js, etc.) */

package/dist/uitils.js

@@ -81,6 +81,7 @@ function getRequestInfo(request) {
   const secFetchMode = headers.get("sec-fetch-mode");
   const accept = headers.get("accept") || "";
   const isDocumentRequest = secFetchDest === "document" || secFetchMode === "navigate";
+  const isBrowserSubrequest = secFetchDest !== null && !isDocumentRequest;
   const acceptsHtml = accept.includes("text/html");
   const isPageNavigation = isDocumentRequest || acceptsHtml;
   const isRscPrefetch = nextUrl !== null && nextUrl !== pathname;
@@ -88,6 +89,8 @@ function getRequestInfo(request) {
   return {
     isPrefetch,
     isRsc,
+    isDocumentRequest,
+    isBrowserSubrequest,
     isPageNavigation,
     isStaticFile,
     isNextjsInternal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextlytics/core",
-  "version": "0.5.1",
+  "version": "0.6.0-canary.114",
   "description": "Analytics library for Next.js",
   "license": "MIT",
   "repository": {