@hogsend/plugin-posthog 0.3.0 → 0.5.0

package/README.md

@@ -3,6 +3,12 @@
 PostHog integration for [Hogsend](https://github.com/dougwithseismic/hogsend):
 person-property fetching with optional Redis caching, and event capture.
 
+`createPostHogService` is the **reference implementation** of the `PostHogService`
+contract — the contract itself (with `CaptureOptions`) lives in `@hogsend/core`
+(canonical author import `@hogsend/engine`); this package re-exports them for
+back-compat. To swap analytics, implement that interface. See
+[docs/adr/0001-provider-boundary.md](https://github.com/dougwithseismic/hogsend/blob/main/docs/adr/0001-provider-boundary.md).
+
 This package ships raw TypeScript source; consumers bundle it via their own build
 (tsup `noExternal`). See the
 [release model](https://github.com/dougwithseismic/hogsend/blob/main/docs/RELEASING.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hogsend/plugin-posthog",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -22,7 +22,8 @@
     "access": "public"
   },
   "dependencies": {
-    "posthog-node": "^5.35.1"
+    "posthog-node": "^5.35.1",
+    "@hogsend/core": "^0.5.0"
   },
   "peerDependencies": {
     "ioredis": ">=5.0.0"

package/src/types.ts

@@ -7,26 +7,10 @@ export interface PostHogServiceConfig {
   cacheTtlSeconds?: number;
 }
 
-export interface PostHogService {
-  getPersonProperties(distinctId: string): Promise<Record<string, unknown>>;
-
-  captureEvent(opts: CaptureOptions): void;
-
-  identify(distinctId: string, properties: Record<string, unknown>): void;
-
-  isFeatureEnabled(opts: {
-    distinctId: string;
-    flag: string;
-  }): Promise<boolean>;
-
-  shutdown(): Promise<void>;
-}
-
-export interface CaptureOptions {
-  distinctId: string;
-  event: string;
-  properties?: Record<string, unknown>;
-}
+// The analytics-provider contract now lives in the neutral @hogsend/core
+// package. These re-exports keep every existing
+// `import ... from "@hogsend/plugin-posthog"` working unchanged.
+export type { CaptureOptions, PostHogService } from "@hogsend/core";
 
 export interface PersonPropertiesConfig {
   apiKey: string;