@molecule/app-analytics-posthog 1.0.0

package/LICENSE

@@ -0,0 +1,115 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship.
+
+      "Contribution" shall mean any work of authorship, including the
+      original version of the Work and any modifications or additions
+      to that Work, that is intentionally submitted to the Licensor for
+      inclusion in the Work by the copyright owner or by an individual or
+      Legal Entity authorized to submit on behalf of the copyright owner.
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      patent license to make, have made, use, offer to sell, sell, import,
+      and otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+   8. Limitation of Liability. In no event and under no legal theory shall
+      any Contributor be liable to You for damages.
+
+   9. Accepting Warranty or Additional Liability.
+
+   Copyright 2026 Molecule Dev, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * PostHog analytics provider for molecule.dev frontend.
+ *
+ * @example
+ * ```typescript
+ * import { setProvider } from '@molecule/app-analytics'
+ * import { createProvider } from '@molecule/app-analytics-posthog'
+ *
+ * // Canonical wiring: read the browser-side key from Vite client env and pass
+ * // it through options. `importMetaEnv` stands for Vite's `import.meta.env` —
+ * // in your app write `import.meta.env?.VITE_POSTHOG_KEY` directly. Without a
+ * // key, skip bonding — analytics calls no-op.
+ * const apiKey = importMetaEnv?.VITE_POSTHOG_KEY as string | undefined
+ * const host = importMetaEnv?.VITE_POSTHOG_HOST as string | undefined
+ * if (apiKey) {
+ *   setProvider(createProvider({ apiKey, ...(host ? { host } : {}) }))
+ * }
+ * ```
+ *
+ * @remarks
+ * The provider does NOT read env itself — configuration flows in through
+ * `createProvider(options)`. The canonical env names are `VITE_POSTHOG_KEY`
+ * and `VITE_POSTHOG_HOST` (the `VITE_` prefix is required: Vite only embeds
+ * `VITE_`-prefixed vars into the client bundle, and molecule's scaffolded app
+ * `.env` only includes `VITE_*` secrets). Do NOT use the API-side twin names
+ * (`POSTHOG_API_KEY`/`POSTHOG_HOST`) in frontend code — those belong to
+ * `@molecule/api-analytics-posthog` and never reach the browser. The PostHog
+ * project API key (`phc_...`) is a public browser-side credential, safe to
+ * embed client-side.
+ *
+ * Bonding without a key is failure-safe: `createProvider()` (and the lazy
+ * `provider` export, which cannot receive options) logs ONE console warning
+ * naming VITE_POSTHOG_KEY and returns a no-op provider instead of initializing
+ * the SDK with an empty key. If events never appear in PostHog, check the
+ * browser console for that warning FIRST. When no `host` is passed, the SDK's
+ * own default (PostHog Cloud US, `https://us.i.posthog.com`) applies — EU
+ * projects MUST set `VITE_POSTHOG_HOST=https://eu.i.posthog.com` or events are
+ * sent to the US region and silently never appear in the EU project.
+ *
+ * `createProvider()` called a second time (e.g. Vite HMR re-running a
+ * bonds.ts setup function) does NOT re-configure PostHog: `posthog-js`'s
+ * underlying client is a module-level singleton, so the second call's
+ * `host`/`autocapture`/etc. are silently ignored by the SDK — the FIRST
+ * configuration always wins. This logs one actionable console warning naming
+ * the ignored call before the SDK's own generic "already initialized"
+ * warning fires.
+ *
+ * @module
+ */
+export * from './provider.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,52 @@
+/**
+ * PostHog analytics provider for molecule.dev frontend.
+ *
+ * @example
+ * ```typescript
+ * import { setProvider } from '@molecule/app-analytics'
+ * import { createProvider } from '@molecule/app-analytics-posthog'
+ *
+ * // Canonical wiring: read the browser-side key from Vite client env and pass
+ * // it through options. `importMetaEnv` stands for Vite's `import.meta.env` —
+ * // in your app write `import.meta.env?.VITE_POSTHOG_KEY` directly. Without a
+ * // key, skip bonding — analytics calls no-op.
+ * const apiKey = importMetaEnv?.VITE_POSTHOG_KEY as string | undefined
+ * const host = importMetaEnv?.VITE_POSTHOG_HOST as string | undefined
+ * if (apiKey) {
+ *   setProvider(createProvider({ apiKey, ...(host ? { host } : {}) }))
+ * }
+ * ```
+ *
+ * @remarks
+ * The provider does NOT read env itself — configuration flows in through
+ * `createProvider(options)`. The canonical env names are `VITE_POSTHOG_KEY`
+ * and `VITE_POSTHOG_HOST` (the `VITE_` prefix is required: Vite only embeds
+ * `VITE_`-prefixed vars into the client bundle, and molecule's scaffolded app
+ * `.env` only includes `VITE_*` secrets). Do NOT use the API-side twin names
+ * (`POSTHOG_API_KEY`/`POSTHOG_HOST`) in frontend code — those belong to
+ * `@molecule/api-analytics-posthog` and never reach the browser. The PostHog
+ * project API key (`phc_...`) is a public browser-side credential, safe to
+ * embed client-side.
+ *
+ * Bonding without a key is failure-safe: `createProvider()` (and the lazy
+ * `provider` export, which cannot receive options) logs ONE console warning
+ * naming VITE_POSTHOG_KEY and returns a no-op provider instead of initializing
+ * the SDK with an empty key. If events never appear in PostHog, check the
+ * browser console for that warning FIRST. When no `host` is passed, the SDK's
+ * own default (PostHog Cloud US, `https://us.i.posthog.com`) applies — EU
+ * projects MUST set `VITE_POSTHOG_HOST=https://eu.i.posthog.com` or events are
+ * sent to the US region and silently never appear in the EU project.
+ *
+ * `createProvider()` called a second time (e.g. Vite HMR re-running a
+ * bonds.ts setup function) does NOT re-configure PostHog: `posthog-js`'s
+ * underlying client is a module-level singleton, so the second call's
+ * `host`/`autocapture`/etc. are silently ignored by the SDK — the FIRST
+ * configuration always wins. This logs one actionable console warning naming
+ * the ignored call before the SDK's own generic "already initialized"
+ * warning fires.
+ *
+ * @module
+ */
+export * from './provider.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,37 @@
+/**
+ * PostHog analytics provider for molecule.dev frontend.
+ *
+ * Uses the `posthog-js` browser SDK.
+ *
+ * @module
+ */
+import type { AnalyticsProvider } from '@molecule/app-analytics';
+import type { PostHogOptions } from './types.js';
+/**
+ * Creates a PostHog analytics provider using `posthog-js`. Initializes the SDK with the
+ * provided API key and host, and returns an `AnalyticsProvider` that maps molecule events to
+ * PostHog's `capture`, `identify`, and `group` APIs.
+ *
+ * When no API key is provided, this does NOT initialize the SDK (`posthog.init('')`
+ * leaves the singleton uninitialized — the SDK logs its own generic error, but
+ * every subsequent call is silently dropped): it logs one actionable warning
+ * naming VITE_POSTHOG_KEY and returns a no-op provider, so bonding the lazy
+ * `provider` export without configuration degrades gracefully.
+ *
+ * When no `host` is provided, the SDK's own default (PostHog Cloud US,
+ * `https://us.i.posthog.com`) applies — EU projects must pass their region host
+ * (`https://eu.i.posthog.com`).
+ *
+ * Calling this a second time with a DIFFERENT config (e.g. Vite HMR re-running
+ * a bonds.ts setup function) does NOT re-configure the SDK: `posthog-js`'s
+ * `posthog` export is a module-level singleton, so the second `.init()` call
+ * is a no-op that keeps the FIRST configuration. This logs one actionable
+ * warning naming the ignored call before the SDK's own generic warning fires.
+ *
+ * @param options - PostHog configuration including `apiKey`, optional `host`, and `autocapture`.
+ * @returns An `AnalyticsProvider` backed by the PostHog browser SDK.
+ */
+export declare const createProvider: (options?: PostHogOptions) => AnalyticsProvider;
+/** Lazy-initialized PostHog analytics provider singleton. */
+export declare const provider: AnalyticsProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAGV,iBAAiB,EAElB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,cAAc,KAAG,iBA8FzD,CAAA;AAID,6DAA6D;AAC7D,eAAO,MAAM,QAAQ,EAAE,iBAUrB,CAAA"}

package/dist/provider.js

@@ -0,0 +1,134 @@
+/**
+ * PostHog analytics provider for molecule.dev frontend.
+ *
+ * Uses the `posthog-js` browser SDK.
+ *
+ * @module
+ */
+import { posthog } from 'posthog-js';
+/**
+ * Creates a PostHog analytics provider using `posthog-js`. Initializes the SDK with the
+ * provided API key and host, and returns an `AnalyticsProvider` that maps molecule events to
+ * PostHog's `capture`, `identify`, and `group` APIs.
+ *
+ * When no API key is provided, this does NOT initialize the SDK (`posthog.init('')`
+ * leaves the singleton uninitialized — the SDK logs its own generic error, but
+ * every subsequent call is silently dropped): it logs one actionable warning
+ * naming VITE_POSTHOG_KEY and returns a no-op provider, so bonding the lazy
+ * `provider` export without configuration degrades gracefully.
+ *
+ * When no `host` is provided, the SDK's own default (PostHog Cloud US,
+ * `https://us.i.posthog.com`) applies — EU projects must pass their region host
+ * (`https://eu.i.posthog.com`).
+ *
+ * Calling this a second time with a DIFFERENT config (e.g. Vite HMR re-running
+ * a bonds.ts setup function) does NOT re-configure the SDK: `posthog-js`'s
+ * `posthog` export is a module-level singleton, so the second `.init()` call
+ * is a no-op that keeps the FIRST configuration. This logs one actionable
+ * warning naming the ignored call before the SDK's own generic warning fires.
+ *
+ * @param options - PostHog configuration including `apiKey`, optional `host`, and `autocapture`.
+ * @returns An `AnalyticsProvider` backed by the PostHog browser SDK.
+ */
+export const createProvider = (options) => {
+    const apiKey = options?.apiKey ?? '';
+    if (!apiKey) {
+        // Graceful degradation with a molecule-canonical breadcrumb: the SDK's own
+        // "initialized without a token" error never names the env var this stack
+        // actually wires (VITE_POSTHOG_KEY), so debugging dead-ends there.
+        console.warn('[analytics] PostHog API key not configured — analytics events will NOT be delivered. ' +
+            'Pass createProvider({ apiKey }) (canonical source: import.meta.env.VITE_POSTHOG_KEY) ' +
+            'or skip bonding the provider entirely.');
+        const noop = async () => { };
+        return {
+            identify: noop,
+            track: noop,
+            page: noop,
+            group: noop,
+            reset: noop,
+            flush: noop,
+        };
+    }
+    // posthog-js's `posthog` export is a MODULE-LEVEL singleton: calling
+    // `.init()` a second time (e.g. Vite HMR re-running a bonds.ts setup
+    // function, or a duplicate createProvider() call) does NOT create a second
+    // client — the SDK checks its own `__loaded` flag, logs a generic
+    // '[PostHog.js] You have already initialized PostHog! Re-initializing is
+    // a no-op' warning, and returns immediately WITHOUT applying the new
+    // config. A changed host/autocapture/etc. on the second call is therefore
+    // silently discarded — recoverable (the SDK does warn) but the warning
+    // never says WHICH options were ignored, so this molecule-canonical
+    // warning names the actual failure mode before the SDK's own generic one
+    // fires. (`posthog.__loaded` is undefined — falsy — on any stub that
+    // doesn't model it, e.g. the mocked SDK in provider.test.ts, so this never
+    // fires for the standard single-call test/usage path.)
+    if (posthog.__loaded) {
+        console.warn("[analytics] PostHog is already initialized — this createProvider() call's " +
+            'options (host/autocapture/etc.) will be IGNORED; the FIRST configuration wins. ' +
+            'This is expected if Vite HMR re-ran your bond setup; if not, createProvider() ' +
+            'is being called more than once with different options.');
+    }
+    posthog.init(apiKey, {
+        // Only override api_host when the caller supplies one — the SDK's own
+        // default is the CURRENT PostHog Cloud US endpoint (us.i.posthog.com);
+        // hardcoding the legacy app.posthog.com here would re-introduce drift.
+        ...(options?.host ? { api_host: options.host } : {}),
+        autocapture: options?.autocapture ?? false,
+        capture_pageview: false, // We handle page views manually via auto-tracking
+    });
+    return {
+        async identify(user) {
+            posthog.identify(user.userId, {
+                email: user.email,
+                name: user.name,
+                ...user.traits,
+            });
+        },
+        async track(event) {
+            // posthog-js supports a client-set timestamp via CaptureOptions — honor
+            // the interface's `timestamp` field instead of silently dropping it.
+            if (event.timestamp) {
+                posthog.capture(event.name, event.properties, { timestamp: event.timestamp });
+            }
+            else {
+                posthog.capture(event.name, event.properties);
+            }
+        },
+        async page(pageView) {
+            posthog.capture('$pageview', {
+                $current_url: pageView.url,
+                $pathname: pageView.path,
+                $referrer: pageView.referrer,
+                page_name: pageView.name,
+                page_category: pageView.category,
+                ...pageView.properties,
+            });
+        },
+        async group(groupId, traits) {
+            posthog.group('company', groupId, traits);
+        },
+        async reset() {
+            posthog.reset();
+        },
+        async flush() {
+            // posthog-js doesn't have an explicit flush — events are sent automatically
+        },
+    };
+};
+/** Default PostHog provider instance (lazy-initialized via Proxy on first method call). */
+let _provider = null;
+/** Lazy-initialized PostHog analytics provider singleton. */
+export const provider = new Proxy({}, {
+    get(_, prop, receiver) {
+        if (!_provider)
+            _provider = createProvider();
+        return Reflect.get(_provider, prop, receiver);
+    },
+    // set trap: methods run with `this` bound to the proxy — without it, instance-state writes land on the dummy target and are lost (see api-push-notifications-web-push)
+    set(_, prop, value) {
+        if (!_provider)
+            _provider = createProvider();
+        return Reflect.set(_provider, prop, value);
+    },
+});
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PostHog app analytics types for molecule.dev.
+ *
+ * @module
+ */
+export type { AnalyticsEvent, AnalyticsPageView, AnalyticsProvider, AnalyticsUserProps, } from '@molecule/app-analytics';
+/**
+ * Options for creating a PostHog provider.
+ */
+export interface PostHogOptions {
+    apiKey?: string;
+    host?: string;
+    autocapture?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,yBAAyB,CAAA;AAEhC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * PostHog app analytics types for molecule.dev.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@molecule/app-analytics-posthog",
+  "version": "1.0.0",
+  "description": "PostHog analytics provider for molecule.dev frontend",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "molecule",
+    "analytics",
+    "posthog"
+  ],
+  "license": "Apache-2.0",
+  "dependencies": {
+    "posthog-js": "1.408.1"
+  },
+  "peerDependencies": {
+    "@molecule/app-analytics": "^1.0.0"
+  },
+  "devDependencies": {
+    "@molecule/app-analytics": "1.0.0",
+    "@types/node": "26.1.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/app/bonds/analytics/posthog"
+  },
+  "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/app/bonds/analytics/posthog",
+  "bugs": "https://github.com/molecule-dev/molecule/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}