fix(core): make callbacks config optional

packages/core/src/config-helpers.test.ts

@@ -0,0 +1,15 @@
+import { describe, expect, it } from "vitest";
+import { withDefaults } from "./config-helpers";
+
+describe("withDefaults", () => {
+  it("defaults callbacks to an empty object when omitted", () => {
+    const result = withDefaults({});
+    expect(result.callbacks).toEqual({});
+  });
+
+  it("preserves user-provided callbacks", () => {
+    const getUser = async () => undefined;
+    const result = withDefaults({ callbacks: { getUser } });
+    expect(result.callbacks.getUser).toBe(getUser);
+  });
+});

packages/core/src/config-helpers.ts

@@ -5,6 +5,7 @@ export type NextlyticsConfigWithDefaults = Required<
 > &
   NextlyticsConfig & {
     anonymousUsers: Required<NonNullable<NextlyticsConfig["anonymousUsers"]>>;
+    callbacks: NonNullable<NextlyticsConfig["callbacks"]>;
   };
 
 export function withDefaults(config: NextlyticsConfig): NextlyticsConfigWithDefaults {
@@ -14,6 +15,7 @@ export function withDefaults(config: NextlyticsConfig): NextlyticsConfigWithDefa
     eventEndpoint: config.eventEndpoint ?? "/api/event",
     isApiPath: config.isApiPath ?? ((str: string) => str.startsWith("/api")),
     backends: config.backends ?? [],
+    callbacks: config.callbacks ?? {},
     anonymousUsers: {
       gdprMode: config.anonymousUsers?.gdprMode ?? true,
       useCookies: config.anonymousUsers?.useCookies ?? false,

packages/core/src/server.tsx

@@ -245,7 +245,9 @@ export function Nextlytics(userConfig: NextlyticsConfig): NextlyticsResult {
     if (!ctx) {
       // x-nl-page-render-id absent → check if middleware is at least active
       if (!headersList.get(headerNames.active)) {
-        console.warn("[Nextlytics] nextlyticsMiddleware should be added in order for Server to work");
+        console.warn(
+          "[Nextlytics] nextlyticsMiddleware should be added in order for Server to work"
+        );
       }
       return <>{children}</>;
     }

packages/core/src/types.ts

@@ -164,7 +164,7 @@ export type NextlyticsConfig = {
   isApiPath?: (path: string) => boolean;
   /** Endpoint for client events. Default: "/api/event" */
   eventEndpoint?: string;
-  callbacks: {
+  callbacks?: {
     /** Resolve authenticated user from request context */
     getUser?: (ctx: RequestContext) => Promise<UserContext | undefined>;
     /** Override anonymous user ID generation */