@unproducts/nuxt-posthog 2.0.4 → 2.0.7

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 {
     /**
@@ -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.4",
+  "version": "2.0.7",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -1,4 +1,4 @@
-import { defineNuxtModule, createResolver, addPlugin, addComponent, addTypeTemplate, addServerPlugin, addServerImports } from '@nuxt/kit';
+import { defineNuxtModule, createResolver, addPlugin, addServerImports } from '@nuxt/kit';
 import { defu } from 'defu';
 
 const module$1 = defineNuxtModule({
@@ -11,35 +11,35 @@ const module$1 = defineNuxtModule({
     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.key || !options.host) {
-      options.disabled = true;
-    } else if (!options.disabled) {
-      nuxt.options.runtimeConfig.public.posthog = defu(
-        nuxt.options.runtimeConfig.public.posthog,
-        {
-          key: options.key,
-          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");
@@ -55,34 +55,13 @@ const module$1 = defineNuxtModule({
         proxy: `https://${region}.i.posthog.com/**`
       };
     }
-    nuxt.hook("imports:dirs", (dirs) => {
-      dirs.push(resolve("./runtime/composables"));
-    });
-    addPlugin(resolve("./runtime/plugins/directives"));
     addPlugin(resolve("./runtime/plugins/posthog.client"));
-    addPlugin(resolve("./runtime/plugins/posthog.server"));
-    addComponent({
-      filePath: resolve("./runtime/components/PostHogFeatureFlag.vue"),
-      name: "PostHogFeatureFlag"
-    });
-    addTypeTemplate({
-      filename: "types/posthog-directives.d.ts",
-      src: resolve("./runtime/types/directives.d.ts")
-    });
-    addServerPlugin(resolve("./runtime/plugins/nitro"));
     addServerImports([
       {
         from: resolve("./runtime/utils/nitro"),
         name: "usePostHog"
       }
     ]);
-    addTypeTemplate(
-      {
-        filename: "types/posthog-nitro.d.ts",
-        src: resolve("./runtime/types/nitro.d.ts")
-      },
-      { nitro: true }
-    );
   }
 });
 

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

@@ -1,19 +1,22 @@
-import { defineNuxtPlugin, useCookie, useRouter, useRuntimeConfig, useState } from "#app";
+import { defineNuxtPlugin, useRouter, useRuntimeConfig, useState } from "#app";
 import { defu } from "defu";
 export default defineNuxtPlugin({
   name: "posthog",
-  enforce: "pre",
-  setup: async () => {
-    console.log("setup posthog client");
-    const runtimeConfig = useRuntimeConfig().posthog;
+  enforce: "post",
+  setup: async (nuxtApp) => {
     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");
@@ -33,8 +36,7 @@ export default defineNuxtPlugin({
       clientOptions.api_host = `${window.location.origin}/ingest/ph`;
     }
     const posthogClient = posthog.init(config.key, clientOptions);
-    const identity = useCookie("ph-identify");
-    identity.value = posthog.get_distinct_id();
+    nuxtApp.callHook("posthog:init", posthogClient);
     if (config.capturePageViews) {
       const router = useRouter();
       router.afterEach((to) => {

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

@@ -1,13 +1,29 @@
 import type { ModuleOptions } from '../../module';
+import type { HookResult } from 'nuxt/schema';
+import type { PostHog } from 'posthog-js';
 
 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,
       'key' | 'host' | 'capturePageViews' | 'capturePageLeaves' | 'clientOptions' | 'proxy'
-    >;
+    > & {
+      client: boolean;
+    };
+  }
+}
+
+declare module '#app' {
+  /** Custom runtime hook used by nuxtApp.hook('posthog:init', ...) */
+  interface RuntimeNuxtHooks {
+    'posthog:init': (posthog: PostHog | null) => HookResult;
   }
 }

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.key, { 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.4",
+  "version": "2.0.7",
   "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",

package/dist/runtime/components/PostHogFeatureFlag.d.vue.ts

@@ -1,37 +0,0 @@
-declare var __VLS_1: {
-    payload: any;
-};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    name: {
-        type: StringConstructor;
-        required: true;
-    };
-    match: {
-        default: boolean;
-        required: false;
-        type: (StringConstructor | BooleanConstructor)[];
-    };
-}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    name: {
-        type: StringConstructor;
-        required: true;
-    };
-    match: {
-        default: boolean;
-        required: false;
-        type: (StringConstructor | BooleanConstructor)[];
-    };
-}>> & Readonly<{}>, {
-    match: string | boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

package/dist/runtime/components/PostHogFeatureFlag.vue

@@ -1,14 +0,0 @@
-<script setup>
-import { computed } from "vue";
-import usePostHogFeatureFlag from "../composables/usePostHogFeatureFlag";
-const { name, match } = defineProps({
-  name: { type: String, required: true },
-  match: { default: true, required: false, type: [String, Boolean] }
-});
-const { getFeatureFlag } = usePostHogFeatureFlag();
-const featureFlag = computed(() => getFeatureFlag(name));
-</script>
-
-<template>
-  <slot v-if="featureFlag?.value === match" :payload="featureFlag.payload" />
-</template>

package/dist/runtime/components/PostHogFeatureFlag.vue.d.ts

@@ -1,37 +0,0 @@
-declare var __VLS_1: {
-    payload: any;
-};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    name: {
-        type: StringConstructor;
-        required: true;
-    };
-    match: {
-        default: boolean;
-        required: false;
-        type: (StringConstructor | BooleanConstructor)[];
-    };
-}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    name: {
-        type: StringConstructor;
-        required: true;
-    };
-    match: {
-        default: boolean;
-        required: false;
-        type: (StringConstructor | BooleanConstructor)[];
-    };
-}>> & Readonly<{}>, {
-    match: string | boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

package/dist/runtime/composables/usePostHogFeatureFlag.d.ts

@@ -1,9 +0,0 @@
-import type { JsonType } from 'posthog-js';
-declare const _default: () => {
-    isFeatureEnabled: (feature: string) => string | boolean;
-    getFeatureFlag: (feature: string) => {
-        value: string | boolean;
-        payload: JsonType;
-    };
-};
-export default _default;

package/dist/runtime/composables/usePostHogFeatureFlag.js

@@ -1,18 +0,0 @@
-import { useState } from "#app";
-export default () => {
-  const posthogFeatureFlags = useState("ph-feature-flags");
-  const posthogFeatureFlagPayloads = useState("ph-feature-flag-payloads");
-  const isFeatureEnabled = (feature) => {
-    return posthogFeatureFlags.value?.[feature] ?? false;
-  };
-  const getFeatureFlag = (feature) => {
-    return {
-      value: posthogFeatureFlags.value?.[feature] ?? false,
-      payload: posthogFeatureFlagPayloads.value?.[feature]
-    };
-  };
-  return {
-    isFeatureEnabled,
-    getFeatureFlag
-  };
-};

package/dist/runtime/directives/v-posthog-capture.d.ts

@@ -1,2 +0,0 @@
-import type { ObjectDirective } from 'vue';
-export declare const vPostHogCapture: ObjectDirective;

package/dist/runtime/directives/v-posthog-capture.js

@@ -1,17 +0,0 @@
-import { useNuxtApp } from "#app";
-const directive = (el, { value, arg }) => {
-  const nuxtApp = useNuxtApp();
-  const $clientPosthog = nuxtApp.$clientPosthog;
-  if (!$clientPosthog) return;
-  if (el.hasAttribute("posthog-listener")) return;
-  el.setAttribute("posthog-listener", "true");
-  el.addEventListener(arg ?? "click", () => {
-    if (!$clientPosthog) return;
-    if (typeof value === "string") $clientPosthog.capture(value);
-    else $clientPosthog.capture(value.name, value.properties);
-  });
-};
-export const vPostHogCapture = {
-  mounted: directive,
-  updated: directive
-};

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

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

package/dist/runtime/plugins/directives.js

@@ -1,5 +0,0 @@
-import { vPostHogCapture } from "../directives/v-posthog-capture.js";
-import { defineNuxtPlugin } from "#app";
-export default defineNuxtPlugin(({ vueApp }) => {
-  vueApp.directive("posthog-capture", vPostHogCapture);
-});

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

@@ -1,2 +0,0 @@
-declare const _default: import("nitropack/types").NitroAppPlugin;
-export default _default;

package/dist/runtime/plugins/nitro.js

@@ -1,12 +0,0 @@
-import { useRuntimeConfig } from "#imports";
-import { defineNitroPlugin } from "nitropack/runtime";
-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;
-    const distinctId = getCookie(event, "ph-identify");
-    event.context.posthogId = distinctId;
-  });
-});

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

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

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

@@ -1,27 +0,0 @@
-import { defineNuxtPlugin, useCookie, useRuntimeConfig, useState } from "#app";
-export default defineNuxtPlugin({
-  name: "posthog-server",
-  enforce: "pre",
-  setup: async () => {
-    const config = useRuntimeConfig().public.posthog;
-    const runtimeConfig = useRuntimeConfig().posthog;
-    if (!config || !runtimeConfig.server)
-      return {
-        provide: {
-          serverPosthog: null
-        }
-      };
-    const PostHog = (await import("posthog-node")).PostHog;
-    const posthog = new PostHog(config.key, { host: config.host });
-    await posthog.reloadFeatureFlags();
-    const identity = useCookie("ph-identify", { default: () => "" });
-    const { featureFlags, featureFlagPayloads } = await posthog.getAllFlagsAndPayloads(identity.value);
-    useState("ph-feature-flags", () => featureFlags);
-    useState("ph-feature-flag-payloads", () => featureFlagPayloads);
-    return {
-      provide: {
-        serverPosthog: posthog
-      }
-    };
-  }
-});

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

@@ -1,27 +0,0 @@
-import type { ObjectDirective } from 'vue';
-import type { Property } from 'posthog-js';
-
-declare global {
-  export interface PostHogCaptureEvent {
-    /**
-     * Event name
-     *
-     * @docs https://posthog.com/docs/product-analytics/capture-events
-     */
-    name: string;
-
-    /**
-     * Event properties
-     *
-     * @docs https://posthog.com/docs/product-analytics/capture-events#setting-event-properties
-     */
-    properties?: Record<string, Property>;
-  }
-}
-
-declare module 'vue' {
-  export interface ComponentCustomProperties {
-    vPosthogCapture: ObjectDirective<HTMLElement, PostHogCaptureEvent | string>;
-  }
-}
-export {};

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

@@ -1,7 +0,0 @@
-declare module 'h3' {
-  interface H3EventContext {
-    posthogId?: string;
-  }
-}
-
-export {};