@unproducts/nuxt-posthog 2.0.3 → 2.0.6

package/dist/module.d.mts

@@ -1,5 +1,6 @@
 import * as _nuxt_schema from '@nuxt/schema';
 import { PostHogConfig } from 'posthog-js';
+import { PostHogOptions } from 'posthog-node';
 
 interface ModuleOptions {
     /**
@@ -9,7 +10,7 @@ interface ModuleOptions {
      * @type string
      * @docs https://posthog.com/docs/api
      */
-    publicKey: string;
+    key: string;
     /**
      * The PostHog API host
      * @default process.env.POSTHOG_API_HOST
@@ -42,21 +43,23 @@ interface ModuleOptions {
      */
     clientOptions?: Partial<PostHogConfig>;
     /**
-     * If set to true, the module will be disabled (no events will be sent to PostHog).
-     * This is useful for development environments. Directives and components will still be available for you to use.
-     * @default false
-     * @type boolean
+     * PostHog Server options
+     * @default {
+     *    api_host: process.env.POSTHOG_API_HOST,
+     * }
+     * @type object
+     * @docs https://posthog.com/docs/libraries/node#config
      */
-    disabled?: boolean;
+    serverOptions?: Partial<PostHogOptions>;
     /**
      * If set to true, the module will be enabled on the client side.
-     * @default true
+     * @default false
      * @type boolean
      */
     client?: boolean;
     /**
      * If set to true, the module will be enabled on the server side.
-     * @default true
+     * @default false
      * @type boolean
      */
     server?: boolean;

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-posthog",
   "configKey": "posthog",
-  "version": "2.0.3",
+  "version": "2.0.6",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -7,39 +7,39 @@ const module$1 = defineNuxtModule({
     configKey: "posthog"
   },
   defaults: {
-    publicKey: process.env.POSTHOG_API_KEY,
+    key: process.env.POSTHOG_API_KEY,
     host: process.env.POSTHOG_API_HOST,
     capturePageViews: true,
     capturePageLeaves: true,
-    disabled: false,
-    client: true,
-    server: true,
+    client: false,
+    server: false,
     proxy: false
   },
   setup(options, nuxt) {
     const { resolve } = createResolver(import.meta.url);
-    if (!options.publicKey || !options.host) {
-      options.disabled = true;
-    } else if (!options.disabled) {
-      nuxt.options.runtimeConfig.public.posthog = defu(
-        nuxt.options.runtimeConfig.public.posthog,
-        {
-          publicKey: options.publicKey,
-          host: options.host,
-          capturePageViews: options.capturePageViews,
-          capturePageLeaves: options.capturePageLeaves,
-          clientOptions: options.clientOptions,
-          proxy: options.proxy
-        }
-      );
-      nuxt.options.runtimeConfig.posthog = defu(nuxt.options.runtimeConfig.posthog, {
-        client: !!options.client,
-        server: !!options.server
-      });
+    const mergedKeyHost = defu(nuxt.options.runtimeConfig.public.posthog, { key: options.key, host: options.host });
+    if (options.server) {
+      nuxt.options.runtimeConfig.posthog = {
+        ...nuxt.options.runtimeConfig.posthog,
+        server: true,
+        ...options.serverOptions && { serverOptions: options.serverOptions }
+      };
+    }
+    if (options.client) {
+      nuxt.options.runtimeConfig.public.posthog = {
+        ...nuxt.options.runtimeConfig.public.posthog,
+        key: mergedKeyHost.key,
+        host: mergedKeyHost.host,
+        capturePageViews: options.capturePageViews,
+        capturePageLeaves: options.capturePageLeaves,
+        clientOptions: options.clientOptions,
+        proxy: options.proxy,
+        client: true
+      };
     }
-    const config = nuxt.options.runtimeConfig.public.posthog;
-    if (config && config.proxy) {
-      const url = new URL(config.host);
+    const publicPosthog = nuxt.options.runtimeConfig.public.posthog;
+    if (publicPosthog?.proxy && publicPosthog?.host) {
+      const url = new URL(publicPosthog.host);
       const region = url.hostname.split(".")[0];
       if (!region) {
         throw new Error("Invalid PostHog API host when setting proxy");

package/dist/runtime/plugins/directives.d.ts

@@ -1,2 +1,2 @@
-declare const _default: import("nuxt/app").Plugin<Record<string, unknown>> & import("nuxt/app").ObjectPlugin<Record<string, unknown>>;
+declare const _default: import("#app").Plugin<Record<string, unknown>> & import("#app").ObjectPlugin<Record<string, unknown>>;
 export default _default;

package/dist/runtime/plugins/nitro.js

@@ -4,8 +4,7 @@ import { getCookie } from "h3";
 export default defineNitroPlugin((nitroApp) => {
   nitroApp.hooks.hook("request", async (event) => {
     const config = useRuntimeConfig().public.posthog;
-    const runtimeConfig = useRuntimeConfig().posthog;
-    if (!config || !runtimeConfig.server) return;
+    if (!config?.client) return;
     const distinctId = getCookie(event, "ph-identify");
     event.context.posthogId = distinctId;
   });

package/dist/runtime/plugins/posthog.client.d.ts

@@ -1,8 +1,8 @@
 import type { PostHog } from 'posthog-js';
-declare const _default: import("nuxt/app").Plugin<{
+declare const _default: import("#app").Plugin<{
     posthog: "Deprecated: use $clientPosthog instead.";
     clientPosthog: PostHog | null;
-}> & import("nuxt/app").ObjectPlugin<{
+}> & import("#app").ObjectPlugin<{
     posthog: "Deprecated: use $clientPosthog instead.";
     clientPosthog: PostHog | null;
 }>;

package/dist/runtime/plugins/posthog.client.js

@@ -2,18 +2,21 @@ import { defineNuxtPlugin, useCookie, useRouter, useRuntimeConfig, useState } fr
 import { defu } from "defu";
 export default defineNuxtPlugin({
   name: "posthog",
-  enforce: "pre",
+  enforce: "post",
   setup: async () => {
-    console.log("setup posthog client");
-    const runtimeConfig = useRuntimeConfig().posthog;
     const config = useRuntimeConfig().public.posthog;
-    if (!config || !runtimeConfig.client)
+    if (!config?.client)
       return {
         provide: {
           posthog: "Deprecated: use $clientPosthog instead.",
           clientPosthog: null
         }
       };
+    if (!config.key || !config.host) {
+      throw new Error(
+        "PostHog client is enabled but key or host not found. Set client to false in module options to disable."
+      );
+    }
     const posthog = (await import("posthog-js")).posthog;
     const posthogFeatureFlags = useState("ph-feature-flags");
     const posthogFeatureFlagPayloads = useState("ph-feature-flag-payloads");
@@ -32,7 +35,7 @@ export default defineNuxtPlugin({
       clientOptions.ui_host = `https://${region}.posthog.com`;
       clientOptions.api_host = `${window.location.origin}/ingest/ph`;
     }
-    const posthogClient = posthog.init(config.publicKey, clientOptions);
+    const posthogClient = posthog.init(config.key, clientOptions);
     const identity = useCookie("ph-identify");
     identity.value = posthog.get_distinct_id();
     if (config.capturePageViews) {

package/dist/runtime/plugins/posthog.server.d.ts

@@ -1,7 +1,7 @@
 import type { PostHog } from 'posthog-node';
-declare const _default: import("nuxt/app").Plugin<{
+declare const _default: import("#app").Plugin<{
     serverPosthog: PostHog | null;
-}> & import("nuxt/app").ObjectPlugin<{
+}> & import("#app").ObjectPlugin<{
     serverPosthog: PostHog | null;
 }>;
 export default _default;

package/dist/runtime/plugins/posthog.server.js

@@ -1,18 +1,22 @@
 import { defineNuxtPlugin, useCookie, useRuntimeConfig, useState } from "#app";
 export default defineNuxtPlugin({
   name: "posthog-server",
-  enforce: "pre",
+  enforce: "post",
   setup: async () => {
-    const config = useRuntimeConfig().public.posthog;
-    const runtimeConfig = useRuntimeConfig().posthog;
-    if (!config || !runtimeConfig.server)
+    const publicConfig = useRuntimeConfig().public.posthog;
+    if (!publicConfig?.client)
       return {
         provide: {
           serverPosthog: null
         }
       };
+    if (!publicConfig.key || !publicConfig.host) {
+      throw new Error(
+        "PostHog client (SSR) is enabled but key or host not found. Set client to false in module options to disable."
+      );
+    }
     const PostHog = (await import("posthog-node")).PostHog;
-    const posthog = new PostHog(config.publicKey, { host: config.host });
+    const posthog = new PostHog(publicConfig.key, { host: publicConfig.host });
     await posthog.reloadFeatureFlags();
     const identity = useCookie("ph-identify", { default: () => "" });
     const { featureFlags, featureFlagPayloads } = await posthog.getAllFlagsAndPayloads(identity.value);

package/dist/runtime/types/index.d.ts

@@ -1,13 +1,20 @@
 import type { ModuleOptions } from '../../module';
 
 declare module '@nuxt/schema' {
+  /** Server-only config (private). Key/host live in public only; Nitro usePostHog reads serverOptions here. */
   interface RuntimeConfig {
-    posthog: Pick<ModuleOptions, 'client' | 'server'>;
+    posthog: {
+      server: boolean;
+      serverOptions?: ModuleOptions['serverOptions'];
+    };
   }
+  /** Client config (public). Single source of truth for key/host. Read in client plugins and server plugin. */
   interface PublicRuntimeConfig {
     posthog?: Pick<
       ModuleOptions,
-      'publicKey' | 'host' | 'capturePageViews' | 'capturePageLeaves' | 'clientOptions' | 'proxy'
-    >;
+      'key' | 'host' | 'capturePageViews' | 'capturePageLeaves' | 'clientOptions' | 'proxy'
+    > & {
+      client: boolean;
+    };
   }
 }

package/dist/runtime/utils/nitro.d.ts

@@ -1,2 +1,2 @@
 import type { PostHog } from 'posthog-node';
-export declare const usePostHog: () => Promise<PostHog | undefined>;
+export declare const usePostHog: () => Promise<PostHog | null>;

package/dist/runtime/utils/nitro.js

@@ -1,12 +1,19 @@
 import { useRuntimeConfig } from "#imports";
+const POSTHOG_SERVER_MISSING = "PostHog server is enabled but key or host not found. Set server to false in module options to disable.";
 let posthog = null;
 export const usePostHog = async () => {
-  const config = useRuntimeConfig().public.posthog;
-  const runtimeConfig = useRuntimeConfig().posthog;
-  if (!config || !runtimeConfig.server) return;
+  const serverConfig = useRuntimeConfig().posthog;
+  const publicConfig = useRuntimeConfig().public.posthog;
+  if (!serverConfig?.server) return null;
+  if (!publicConfig?.key || !publicConfig?.host) {
+    throw new Error(POSTHOG_SERVER_MISSING);
+  }
   if (!posthog) {
     const PostHog = (await import("posthog-node")).PostHog;
-    posthog = new PostHog(config.publicKey, { host: config.host });
+    posthog = new PostHog(publicConfig.key, {
+      host: publicConfig.host,
+      ...serverConfig.serverOptions
+    });
   }
   return posthog;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unproducts/nuxt-posthog",
-  "version": "2.0.3",
+  "version": "2.0.6",
   "description": "PostHog module for nuxt",
   "publishConfig": {
     "access": "public"
@@ -39,7 +39,7 @@
   },
   "peerDependencies": {
     "posthog-js": "^1.252.0",
-    "posthog-node": "5.14.0"
+    "posthog-node": "^5.14.0"
   },
   "devDependencies": {
     "@nuxt/devtools": "^3.1.1",
@@ -48,6 +48,7 @@
     "@nuxt/schema": "^4.2.1",
     "@nuxt/test-utils": "^3.19.1",
     "@types/node": "^24.0.1",
+    "baseline-browser-mapping": "^2.9.19",
     "changelogen": "^0.6.1",
     "eslint": "^9.29.0",
     "eslint-config-prettier": "^10.1.5",