@allem-sdk/analytics 0.1.2 → 0.1.3

package/README.md

@@ -57,6 +57,34 @@ function ProductPage({ product }) {
 }
 ```
 
+## Built-in Adapters
+
+Pre-built adapters for popular analytics providers:
+
+```tsx
+import { mixpanelAdapter, posthogAdapter, segmentAdapter, consoleAdapter } from "@allem-sdk/analytics";
+```
+
+| Adapter | Usage | Description |
+|---------|-------|-------------|
+| `mixpanelAdapter(mixpanel)` | Pass your initialized Mixpanel instance | Tracks events, page views, and identifies users with `people.set` |
+| `posthogAdapter(posthog)` | Pass your initialized PostHog instance | Uses `capture` for events and `$pageview` for pages |
+| `segmentAdapter(analytics)` | Pass `window.analytics` or Analytics.js instance | Direct mapping to Segment's `track`, `page`, `identify` |
+| `consoleAdapter(prefix?)` | No dependencies | Logs all events to console. Great for development. |
+
+```tsx
+import mixpanel from "mixpanel-browser";
+import posthog from "posthog-js";
+
+mixpanel.init("YOUR_TOKEN");
+posthog.init("YOUR_KEY", { api_host: "https://app.posthog.com" });
+
+// Use one or many adapters simultaneously
+<AnalyticsProvider adapters={[mixpanelAdapter(mixpanel), posthogAdapter(posthog), consoleAdapter()]}>
+  <App />
+</AnalyticsProvider>
+```
+
 ## Exports
 
 | Export | Type | Description |
@@ -65,6 +93,10 @@ function ProductPage({ product }) {
 | `useTrack` | Hook | Returns a `track(event, properties)` function |
 | `usePageView` | Hook | Tracks a page view on mount |
 | `useIdentify` | Hook | Returns an `identify(userId, traits)` function |
+| `mixpanelAdapter` | Factory | Adapter for Mixpanel |
+| `posthogAdapter` | Factory | Adapter for PostHog |
+| `segmentAdapter` | Factory | Adapter for Segment / Analytics.js |
+| `consoleAdapter` | Factory | Console-logging adapter for development |
 
 ## Part of [Allem SDK](https://github.com/kingofmit/allem-sdk)
 

package/dist/index.d.mts

@@ -18,4 +18,60 @@ declare function usePageView(name?: string, properties?: Record<string, unknown>
 
 declare function useIdentify(): (userId: string, traits?: Record<string, unknown>) => void;
 
-export { type AnalyticsAdapter, AnalyticsProvider, type AnalyticsProviderProps, useIdentify, usePageView, useTrack };
+/**
+ * Mixpanel adapter.
+ *
+ * @example
+ * ```tsx
+ * import mixpanel from "mixpanel-browser";
+ * mixpanel.init("YOUR_TOKEN");
+ *
+ * <AnalyticsProvider adapters={[mixpanelAdapter(mixpanel)]}>
+ * ```
+ */
+declare function mixpanelAdapter(mixpanel: {
+    track: (event: string, properties?: Record<string, unknown>) => void;
+    identify: (id: string) => void;
+    people: {
+        set: (props: Record<string, unknown>) => void;
+    };
+}): AnalyticsAdapter;
+/**
+ * PostHog adapter.
+ *
+ * @example
+ * ```tsx
+ * import posthog from "posthog-js";
+ * posthog.init("YOUR_KEY", { api_host: "https://app.posthog.com" });
+ *
+ * <AnalyticsProvider adapters={[posthogAdapter(posthog)]}>
+ * ```
+ */
+declare function posthogAdapter(posthog: {
+    capture: (event: string, properties?: Record<string, unknown>) => void;
+    identify: (id: string, properties?: Record<string, unknown>) => void;
+}): AnalyticsAdapter;
+/**
+ * Segment (Analytics.js) adapter.
+ *
+ * @example
+ * ```tsx
+ * <AnalyticsProvider adapters={[segmentAdapter(window.analytics)]}>
+ * ```
+ */
+declare function segmentAdapter(analytics: {
+    track: (event: string, properties?: Record<string, unknown>) => void;
+    page: (name?: string, properties?: Record<string, unknown>) => void;
+    identify: (userId: string, traits?: Record<string, unknown>) => void;
+}): AnalyticsAdapter;
+/**
+ * Console adapter for development/debugging. Logs all events to console.
+ *
+ * @example
+ * ```tsx
+ * <AnalyticsProvider adapters={[consoleAdapter()]}>
+ * ```
+ */
+declare function consoleAdapter(prefix?: string): AnalyticsAdapter;
+
+export { type AnalyticsAdapter, AnalyticsProvider, type AnalyticsProviderProps, consoleAdapter, mixpanelAdapter, posthogAdapter, segmentAdapter, useIdentify, usePageView, useTrack };

package/dist/index.d.ts

@@ -18,4 +18,60 @@ declare function usePageView(name?: string, properties?: Record<string, unknown>
 
 declare function useIdentify(): (userId: string, traits?: Record<string, unknown>) => void;
 
-export { type AnalyticsAdapter, AnalyticsProvider, type AnalyticsProviderProps, useIdentify, usePageView, useTrack };
+/**
+ * Mixpanel adapter.
+ *
+ * @example
+ * ```tsx
+ * import mixpanel from "mixpanel-browser";
+ * mixpanel.init("YOUR_TOKEN");
+ *
+ * <AnalyticsProvider adapters={[mixpanelAdapter(mixpanel)]}>
+ * ```
+ */
+declare function mixpanelAdapter(mixpanel: {
+    track: (event: string, properties?: Record<string, unknown>) => void;
+    identify: (id: string) => void;
+    people: {
+        set: (props: Record<string, unknown>) => void;
+    };
+}): AnalyticsAdapter;
+/**
+ * PostHog adapter.
+ *
+ * @example
+ * ```tsx
+ * import posthog from "posthog-js";
+ * posthog.init("YOUR_KEY", { api_host: "https://app.posthog.com" });
+ *
+ * <AnalyticsProvider adapters={[posthogAdapter(posthog)]}>
+ * ```
+ */
+declare function posthogAdapter(posthog: {
+    capture: (event: string, properties?: Record<string, unknown>) => void;
+    identify: (id: string, properties?: Record<string, unknown>) => void;
+}): AnalyticsAdapter;
+/**
+ * Segment (Analytics.js) adapter.
+ *
+ * @example
+ * ```tsx
+ * <AnalyticsProvider adapters={[segmentAdapter(window.analytics)]}>
+ * ```
+ */
+declare function segmentAdapter(analytics: {
+    track: (event: string, properties?: Record<string, unknown>) => void;
+    page: (name?: string, properties?: Record<string, unknown>) => void;
+    identify: (userId: string, traits?: Record<string, unknown>) => void;
+}): AnalyticsAdapter;
+/**
+ * Console adapter for development/debugging. Logs all events to console.
+ *
+ * @example
+ * ```tsx
+ * <AnalyticsProvider adapters={[consoleAdapter()]}>
+ * ```
+ */
+declare function consoleAdapter(prefix?: string): AnalyticsAdapter;
+
+export { type AnalyticsAdapter, AnalyticsProvider, type AnalyticsProviderProps, consoleAdapter, mixpanelAdapter, posthogAdapter, segmentAdapter, useIdentify, usePageView, useTrack };

package/dist/index.js

@@ -22,6 +22,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AnalyticsProvider: () => AnalyticsProvider,
+  consoleAdapter: () => consoleAdapter,
+  mixpanelAdapter: () => mixpanelAdapter,
+  posthogAdapter: () => posthogAdapter,
+  segmentAdapter: () => segmentAdapter,
   useIdentify: () => useIdentify,
   usePageView: () => usePageView,
   useTrack: () => useTrack
@@ -80,9 +84,46 @@ function useIdentify() {
   );
   return identify;
 }
+
+// src/adapters.ts
+function mixpanelAdapter(mixpanel) {
+  return {
+    track: (event, properties) => mixpanel.track(event, properties),
+    page: (name, properties) => mixpanel.track("Page View", { page: name, ...properties }),
+    identify: (userId, traits) => {
+      mixpanel.identify(userId);
+      if (traits) mixpanel.people.set(traits);
+    }
+  };
+}
+function posthogAdapter(posthog) {
+  return {
+    track: (event, properties) => posthog.capture(event, properties),
+    page: (name, properties) => posthog.capture("$pageview", { page: name, ...properties }),
+    identify: (userId, traits) => posthog.identify(userId, traits)
+  };
+}
+function segmentAdapter(analytics) {
+  return {
+    track: (event, properties) => analytics.track(event, properties),
+    page: (name, properties) => analytics.page(name, properties),
+    identify: (userId, traits) => analytics.identify(userId, traits)
+  };
+}
+function consoleAdapter(prefix = "[analytics]") {
+  return {
+    track: (event, properties) => console.log(`${prefix} track:`, event, properties),
+    page: (name, properties) => console.log(`${prefix} page:`, name, properties),
+    identify: (userId, traits) => console.log(`${prefix} identify:`, userId, traits)
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AnalyticsProvider,
+  consoleAdapter,
+  mixpanelAdapter,
+  posthogAdapter,
+  segmentAdapter,
   useIdentify,
   usePageView,
   useTrack

package/dist/index.mjs

@@ -52,8 +52,45 @@ function useIdentify() {
   );
   return identify;
 }
+
+// src/adapters.ts
+function mixpanelAdapter(mixpanel) {
+  return {
+    track: (event, properties) => mixpanel.track(event, properties),
+    page: (name, properties) => mixpanel.track("Page View", { page: name, ...properties }),
+    identify: (userId, traits) => {
+      mixpanel.identify(userId);
+      if (traits) mixpanel.people.set(traits);
+    }
+  };
+}
+function posthogAdapter(posthog) {
+  return {
+    track: (event, properties) => posthog.capture(event, properties),
+    page: (name, properties) => posthog.capture("$pageview", { page: name, ...properties }),
+    identify: (userId, traits) => posthog.identify(userId, traits)
+  };
+}
+function segmentAdapter(analytics) {
+  return {
+    track: (event, properties) => analytics.track(event, properties),
+    page: (name, properties) => analytics.page(name, properties),
+    identify: (userId, traits) => analytics.identify(userId, traits)
+  };
+}
+function consoleAdapter(prefix = "[analytics]") {
+  return {
+    track: (event, properties) => console.log(`${prefix} track:`, event, properties),
+    page: (name, properties) => console.log(`${prefix} page:`, name, properties),
+    identify: (userId, traits) => console.log(`${prefix} identify:`, userId, traits)
+  };
+}
 export {
   AnalyticsProvider,
+  consoleAdapter,
+  mixpanelAdapter,
+  posthogAdapter,
+  segmentAdapter,
   useIdentify,
   usePageView,
   useTrack

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allem-sdk/analytics",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Provider-agnostic analytics hooks for React. Works with Mixpanel, Segment, PostHog, Amplitude, and any custom adapter. useTrack, usePageView, useIdentify.",
   "license": "MIT",
   "author": "Ahmed Allem",