@entifix/posthog 0.1.0-0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 r10c Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# @entifix/posthog
+
+The PostHog adapter for the product-analytics `Tracker` port
+(`@entifix/tooling/tracking`). One vendor, two SDKs, two entry points:
+
+- **`@entifix/posthog`** — `makePostHogTracker(client)` over
+  `posthog-node` (backend, server-side events).
+- **`@entifix/posthog/browser`** — `makeBrowserTracker(posthog)`
+  over `posthog-js` (browser events + sync feature-flag / A-B reads).
+
+Both return a framework-free `Tracker`, provided per environment behind
+`TrackerTag` (Effect `Context.Tag`) at a composition root — the same
+adapter-per-environment shape as REST vs Mongo behind `EntityRepositoryTag`.
+
+Unlike OpenTelemetry (which stays unwrapped), a real vendor SDK belongs behind an
+adapter: swapping PostHog for another analytics backend touches only this package.

package/dist/browser/index.d.ts

@@ -0,0 +1,2 @@
+export * from './make-browser-tracker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,3 @@
+export * from './make-browser-tracker.js';
+
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/browser/index.ts"],"sourcesContent":["export * from './make-browser-tracker.js';\n"],"names":[],"mappings":"AAAA,cAAc,4BAA4B"}

package/dist/browser/make-browser-tracker.d.ts

@@ -0,0 +1,13 @@
+import type { Tracker } from '@entifix/tooling/tracking';
+import type { PostHog } from 'posthog-js';
+/**
+ * Adapt the `posthog-js` browser client to the {@link Tracker} port. The
+ * browser half of the analytics adapter: provided as `TrackerTag` in a Next
+ * client composition root, resolved by a `useTracker()` hook (the browser runs
+ * Effect DI just like the backend).
+ *
+ * `flag` reads the browser's locally-cached flags synchronously — which is why
+ * the `Tracker.flag` contract is sync — defaulting an unknown flag to `false`.
+ */
+export declare const makeBrowserTracker: (posthog: PostHog) => Tracker;
+//# sourceMappingURL=make-browser-tracker.d.ts.map

package/dist/browser/make-browser-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-browser-tracker.d.ts","sourceRoot":"","sources":["../../src/browser/make-browser-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK1C;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,OAAO,KAAG,OAQpD,CAAC"}

package/dist/browser/make-browser-tracker.js

@@ -0,0 +1,24 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+const toProperties = (props)=>props === undefined ? undefined : _extends({}, props);
+/**
+ * Adapt the `posthog-js` browser client to the {@link Tracker} port. The
+ * browser half of the analytics adapter: provided as `TrackerTag` in a Next
+ * client composition root, resolved by a `useTracker()` hook (the browser runs
+ * Effect DI just like the backend).
+ *
+ * `flag` reads the browser's locally-cached flags synchronously — which is why
+ * the `Tracker.flag` contract is sync — defaulting an unknown flag to `false`.
+ */ export const makeBrowserTracker = (posthog)=>({
+        track: (event, props)=>{
+            posthog.capture(event, toProperties(props));
+        },
+        identify: (id, traits)=>{
+            posthog.identify(id, toProperties(traits));
+        },
+        flag: (key)=>{
+            var _posthog_getFeatureFlag;
+            return (_posthog_getFeatureFlag = posthog.getFeatureFlag(key)) != null ? _posthog_getFeatureFlag : false;
+        }
+    });
+
+//# sourceMappingURL=make-browser-tracker.js.map

package/dist/browser/make-browser-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/browser/make-browser-tracker.ts"],"sourcesContent":["import type { Props, Tracker } from '@entifix/tooling/tracking';\nimport type { PostHog } from 'posthog-js';\n\nconst toProperties = (props?: Props): Record<string, unknown> | undefined =>\n  props === undefined ? undefined : { ...props };\n\n/**\n * Adapt the `posthog-js` browser client to the {@link Tracker} port. The\n * browser half of the analytics adapter: provided as `TrackerTag` in a Next\n * client composition root, resolved by a `useTracker()` hook (the browser runs\n * Effect DI just like the backend).\n *\n * `flag` reads the browser's locally-cached flags synchronously — which is why\n * the `Tracker.flag` contract is sync — defaulting an unknown flag to `false`.\n */\nexport const makeBrowserTracker = (posthog: PostHog): Tracker => ({\n  track: (event, props) => {\n    posthog.capture(event, toProperties(props));\n  },\n  identify: (id, traits) => {\n    posthog.identify(id, toProperties(traits));\n  },\n  flag: key => posthog.getFeatureFlag(key) ?? false,\n});\n"],"names":["toProperties","props","undefined","makeBrowserTracker","posthog","track","event","capture","identify","id","traits","flag","key","getFeatureFlag"],"mappings":";AAGA,MAAMA,eAAe,CAACC,QACpBA,UAAUC,YAAYA,YAAY,aAAKD;AAEzC;;;;;;;;CAQC,GACD,OAAO,MAAME,qBAAqB,CAACC,UAA+B,CAAA;QAChEC,OAAO,CAACC,OAAOL;YACbG,QAAQG,OAAO,CAACD,OAAON,aAAaC;QACtC;QACAO,UAAU,CAACC,IAAIC;YACbN,QAAQI,QAAQ,CAACC,IAAIT,aAAaU;QACpC;QACAC,MAAMC,CAAAA;gBAAOR;oBAAAA,0BAAAA,QAAQS,cAAc,CAACD,gBAAvBR,0BAA+B;;IAC9C,CAAA,EAAG"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './make-posthog-tracker.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,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './make-posthog-tracker.js';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './make-posthog-tracker.js';\n"],"names":[],"mappings":"AAAA,cAAc,4BAA4B"}

package/dist/make-posthog-tracker.d.ts

@@ -0,0 +1,19 @@
+import type { Tracker } from '@entifix/tooling/tracking';
+import type { PostHog } from 'posthog-node';
+/** Options for {@link makePostHogTracker}. */
+export interface PostHogTrackerOptions {
+    /** distinctId used when a `track` call carries none (default `'anonymous'`). */
+    readonly distinctId?: string;
+}
+/**
+ * Adapt the `posthog-node` client to the framework-free {@link Tracker} port.
+ * The server-side half of the analytics adapter: provided as `TrackerTag`
+ * (`@entifix/business`) at a service composition root.
+ *
+ * `flag` returns `false` here: `posthog-node` evaluates flags asynchronously, so
+ * the synchronous `Tracker.flag` (which fits the browser's cached, sync eval) has
+ * no server-side answer. Server-side experiment assignment gets a dedicated async
+ * path if/when experiments move off the browser.
+ */
+export declare const makePostHogTracker: (client: PostHog, options?: PostHogTrackerOptions) => Tracker;
+//# sourceMappingURL=make-posthog-tracker.d.ts.map

package/dist/make-posthog-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-posthog-tracker.d.ts","sourceRoot":"","sources":["../src/make-posthog-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAaD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,OAAO,EACf,UAAS,qBAA0B,KAClC,OAeF,CAAC"}

package/dist/make-posthog-tracker.js

@@ -0,0 +1,37 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+const toProperties = (props)=>props === undefined ? undefined : _extends({}, props);
+const resolveDistinctId = (props, fallback)=>{
+    const fromProps = props == null ? void 0 : props['distinctId'];
+    return typeof fromProps === 'string' ? fromProps : fallback;
+};
+/**
+ * Adapt the `posthog-node` client to the framework-free {@link Tracker} port.
+ * The server-side half of the analytics adapter: provided as `TrackerTag`
+ * (`@entifix/business`) at a service composition root.
+ *
+ * `flag` returns `false` here: `posthog-node` evaluates flags asynchronously, so
+ * the synchronous `Tracker.flag` (which fits the browser's cached, sync eval) has
+ * no server-side answer. Server-side experiment assignment gets a dedicated async
+ * path if/when experiments move off the browser.
+ */ export const makePostHogTracker = (client, options = {})=>{
+    var _options_distinctId;
+    const fallback = (_options_distinctId = options.distinctId) != null ? _options_distinctId : 'anonymous';
+    return {
+        track: (event, props)=>{
+            client.capture({
+                distinctId: resolveDistinctId(props, fallback),
+                event,
+                properties: toProperties(props)
+            });
+        },
+        identify: (id, traits)=>{
+            client.identify({
+                distinctId: id,
+                properties: toProperties(traits)
+            });
+        },
+        flag: ()=>false
+    };
+};
+
+//# sourceMappingURL=make-posthog-tracker.js.map

package/dist/make-posthog-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/make-posthog-tracker.ts"],"sourcesContent":["import type { Props, Tracker } from '@entifix/tooling/tracking';\nimport type { PostHog } from 'posthog-node';\n\n/** Options for {@link makePostHogTracker}. */\nexport interface PostHogTrackerOptions {\n  /** distinctId used when a `track` call carries none (default `'anonymous'`). */\n  readonly distinctId?: string;\n}\n\nconst toProperties = (props?: Props): Record<string, unknown> | undefined =>\n  props === undefined ? undefined : { ...props };\n\nconst resolveDistinctId = (\n  props: Props | undefined,\n  fallback: string,\n): string => {\n  const fromProps = props?.['distinctId'];\n  return typeof fromProps === 'string' ? fromProps : fallback;\n};\n\n/**\n * Adapt the `posthog-node` client to the framework-free {@link Tracker} port.\n * The server-side half of the analytics adapter: provided as `TrackerTag`\n * (`@entifix/business`) at a service composition root.\n *\n * `flag` returns `false` here: `posthog-node` evaluates flags asynchronously, so\n * the synchronous `Tracker.flag` (which fits the browser's cached, sync eval) has\n * no server-side answer. Server-side experiment assignment gets a dedicated async\n * path if/when experiments move off the browser.\n */\nexport const makePostHogTracker = (\n  client: PostHog,\n  options: PostHogTrackerOptions = {},\n): Tracker => {\n  const fallback = options.distinctId ?? 'anonymous';\n  return {\n    track: (event, props) => {\n      client.capture({\n        distinctId: resolveDistinctId(props, fallback),\n        event,\n        properties: toProperties(props),\n      });\n    },\n    identify: (id, traits) => {\n      client.identify({ distinctId: id, properties: toProperties(traits) });\n    },\n    flag: () => false,\n  };\n};\n"],"names":["toProperties","props","undefined","resolveDistinctId","fallback","fromProps","makePostHogTracker","client","options","distinctId","track","event","capture","properties","identify","id","traits","flag"],"mappings":";AASA,MAAMA,eAAe,CAACC,QACpBA,UAAUC,YAAYA,YAAY,aAAKD;AAEzC,MAAME,oBAAoB,CACxBF,OACAG;IAEA,MAAMC,YAAYJ,yBAAAA,KAAO,CAAC,aAAa;IACvC,OAAO,OAAOI,cAAc,WAAWA,YAAYD;AACrD;AAEA;;;;;;;;;CASC,GACD,OAAO,MAAME,qBAAqB,CAChCC,QACAC,UAAiC,CAAC,CAAC;QAElBA;IAAjB,MAAMJ,YAAWI,sBAAAA,QAAQC,UAAU,YAAlBD,sBAAsB;IACvC,OAAO;QACLE,OAAO,CAACC,OAAOV;YACbM,OAAOK,OAAO,CAAC;gBACbH,YAAYN,kBAAkBF,OAAOG;gBACrCO;gBACAE,YAAYb,aAAaC;YAC3B;QACF;QACAa,UAAU,CAACC,IAAIC;YACbT,OAAOO,QAAQ,CAAC;gBAAEL,YAAYM;gBAAIF,YAAYb,aAAagB;YAAQ;QACrE;QACAC,MAAM,IAAM;IACd;AACF,EAAE"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@entifix/posthog",
+  "version": "0.1.0-0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/r10c-technologies/entifix.git",
+    "directory": "packages/ts/posthog-client"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@entifix/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "@entifix/source": "./src/browser/index.ts",
+      "types": "./dist/browser/index.d.ts",
+      "import": "./dist/browser/index.js",
+      "default": "./dist/browser/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo",
+    "LICENSE"
+  ],
+  "nx": {
+    "tags": [
+      "layer:entifix",
+      "scope:shared",
+      "entifix:client",
+      "tier:2"
+    ],
+    "sourceRoot": "packages/ts/posthog-client/src",
+    "targets": {
+      "build": {
+        "executor": "@nx/js:swc",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/ts/posthog-client/dist",
+          "main": "packages/ts/posthog-client/src/index.ts",
+          "tsConfig": "packages/ts/posthog-client/tsconfig.lib.json",
+          "skipTypeCheck": true,
+          "stripLeadingPaths": true
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@swc/helpers": "0.5.23",
+    "posthog-js": "1.417.0",
+    "posthog-node": "5.49.0",
+    "@entifix/tooling": "0.1.0-0"
+  }
+}