@bayonai/analytics

Shared Bayon AI adapter for browser analytics and Next.js server log export. PostHog is the first provider implementation.

Browser analytics

Use AnalyticsPageViewTracker once in an App Router layout or provider shell:

import { AnalyticsPageViewTracker } from "@bayonai/analytics/next";

<AnalyticsPageViewTracker appName="bounded" />;

The adapter defaults the analytics engine to PostHog. Apps must provide:

• NEXT_PUBLIC_ANALYTICS_ENGINE=posthog
• NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN
• NEXT_PUBLIC_POSTHOG_HOST
• NEXT_PUBLIC_ANALYTICS_LOCALHOST_ENABLE=true

NEXT_PUBLIC_POSTHOG_KEY is still accepted as a token fallback for older apps. If analytics cannot connect, the browser adapter logs a clear console warning and does not send events.

Server logs

Register the OpenTelemetry log exporter from instrumentation.ts:

import { registerAnalyticsLogger } from "@bayonai/analytics/server";

export function register() {
  if (process.env.NEXT_RUNTIME === "nodejs") {
    registerAnalyticsLogger({
      provider: "posthog",
      projectToken: process.env.POSTHOG_PROJECT_TOKEN,
      host: process.env.POSTHOG_HOST,
      serviceName: "bounded",
    });
  }
}

Then server code can call emitAnalyticsLog or read the global logger with getAnalyticsLogger.