@allem-sdk/analytics 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Allem
+
+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,80 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kingofmit/allem-sdk/main/.github/AllemSDK.png" alt="Allem SDK" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/kingofmit/allem-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
+  <img src="https://img.shields.io/badge/react-18+-61dafb" alt="React 18+" />
+  <img src="https://img.shields.io/badge/typescript-strict-blue" alt="TypeScript" />
+</p>
+
+# @allem-sdk/analytics
+
+Provider-agnostic analytics hooks for React. Bring your own analytics provider (Mixpanel, Segment, PostHog, etc.) via a simple adapter interface. Supports multiple adapters simultaneously.
+
+## Installation
+
+```bash
+npm install @allem-sdk/analytics
+```
+
+## Usage
+
+```tsx
+import { AnalyticsProvider, useTrack, usePageView, useIdentify } from "@allem-sdk/analytics";
+
+// Define adapters for your providers — use one or many
+const mixpanelAdapter = {
+  track: (event, properties) => mixpanel.track(event, properties),
+  page: (name, properties) => mixpanel.track_pageview({ page: name, ...properties }),
+  identify: (userId, traits) => mixpanel.identify(userId),
+};
+
+const posthogAdapter = {
+  track: (event, properties) => posthog.capture(event, properties),
+  page: (name, properties) => posthog.capture("$pageview", { page: name, ...properties }),
+  identify: (userId, traits) => posthog.identify(userId, traits),
+};
+
+function App() {
+  return (
+    <AnalyticsProvider adapters={[mixpanelAdapter, posthogAdapter]}>
+      <MyApp />
+    </AnalyticsProvider>
+  );
+}
+
+function ProductPage({ product }) {
+  const track = useTrack();
+  usePageView("Product Page", { productId: product.id });
+
+  return (
+    <button onClick={() => track("Add to Cart", { productId: product.id })}>
+      Add to Cart
+    </button>
+  );
+}
+```
+
+## Exports
+
+| Export | Type | Description |
+|--------|------|-------------|
+| `AnalyticsProvider` | Component | Context provider accepting one or multiple adapters |
+| `useTrack` | Hook | Returns a `track(event, properties)` function |
+| `usePageView` | Hook | Tracks a page view on mount |
+| `useIdentify` | Hook | Returns an `identify(userId, traits)` function |
+
+## Part of [Allem SDK](https://github.com/kingofmit/allem-sdk)
+
+This package can be used standalone or as part of the full SDK. Install `allem-sdk` to get all packages in one install.
+
+## Support
+
+If you find Allem SDK useful, consider supporting its development:
+
+<a href="https://buymeacoffee.com/kingofmit" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50" /></a>
+
+## License
+
+[MIT](https://github.com/kingofmit/allem-sdk/blob/main/LICENSE) - [Ahmed Allem](https://kingallem.com)

package/dist/index.d.mts

@@ -0,0 +1,21 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface AnalyticsAdapter {
+    track: (event: string, properties?: Record<string, unknown>) => void;
+    page: (name?: string, properties?: Record<string, unknown>) => void;
+    identify: (userId: string, traits?: Record<string, unknown>) => void;
+}
+interface AnalyticsProviderProps {
+    adapters: AnalyticsAdapter[];
+    children: ReactNode;
+}
+declare function AnalyticsProvider({ adapters, children }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
+
+declare function useTrack(): (event: string, properties?: Record<string, unknown>) => void;
+
+declare function usePageView(name?: string, properties?: Record<string, unknown>): void;
+
+declare function useIdentify(): (userId: string, traits?: Record<string, unknown>) => void;
+
+export { type AnalyticsAdapter, AnalyticsProvider, type AnalyticsProviderProps, useIdentify, usePageView, useTrack };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface AnalyticsAdapter {
+    track: (event: string, properties?: Record<string, unknown>) => void;
+    page: (name?: string, properties?: Record<string, unknown>) => void;
+    identify: (userId: string, traits?: Record<string, unknown>) => void;
+}
+interface AnalyticsProviderProps {
+    adapters: AnalyticsAdapter[];
+    children: ReactNode;
+}
+declare function AnalyticsProvider({ adapters, children }: AnalyticsProviderProps): react_jsx_runtime.JSX.Element;
+
+declare function useTrack(): (event: string, properties?: Record<string, unknown>) => void;
+
+declare function usePageView(name?: string, properties?: Record<string, unknown>): void;
+
+declare function useIdentify(): (userId: string, traits?: Record<string, unknown>) => void;
+
+export { type AnalyticsAdapter, AnalyticsProvider, type AnalyticsProviderProps, useIdentify, usePageView, useTrack };

package/dist/index.js

@@ -0,0 +1,89 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AnalyticsProvider: () => AnalyticsProvider,
+  useIdentify: () => useIdentify,
+  usePageView: () => usePageView,
+  useTrack: () => useTrack
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/AnalyticsProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var AnalyticsContext = (0, import_react.createContext)({ adapters: [] });
+function AnalyticsProvider({ adapters, children }) {
+  const value = (0, import_react.useRef)({ adapters }).current;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AnalyticsContext.Provider, { value, children });
+}
+function useAnalyticsAdapters() {
+  return (0, import_react.useContext)(AnalyticsContext).adapters;
+}
+
+// src/useTrack.ts
+var import_react2 = require("react");
+function useTrack() {
+  const adapters = useAnalyticsAdapters();
+  const track = (0, import_react2.useCallback)(
+    (event, properties) => {
+      for (const adapter of adapters) {
+        adapter.track(event, properties);
+      }
+    },
+    [adapters]
+  );
+  return track;
+}
+
+// src/usePageView.ts
+var import_react3 = require("react");
+function usePageView(name, properties) {
+  const adapters = useAnalyticsAdapters();
+  (0, import_react3.useEffect)(() => {
+    for (const adapter of adapters) {
+      adapter.page(name, properties);
+    }
+  }, [adapters, name, properties]);
+}
+
+// src/useIdentify.ts
+var import_react4 = require("react");
+function useIdentify() {
+  const adapters = useAnalyticsAdapters();
+  const identify = (0, import_react4.useCallback)(
+    (userId, traits) => {
+      for (const adapter of adapters) {
+        adapter.identify(userId, traits);
+      }
+    },
+    [adapters]
+  );
+  return identify;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AnalyticsProvider,
+  useIdentify,
+  usePageView,
+  useTrack
+});

package/dist/index.mjs

@@ -0,0 +1,60 @@
+"use client";
+
+// src/AnalyticsProvider.tsx
+import { createContext, useContext, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+var AnalyticsContext = createContext({ adapters: [] });
+function AnalyticsProvider({ adapters, children }) {
+  const value = useRef({ adapters }).current;
+  return /* @__PURE__ */ jsx(AnalyticsContext.Provider, { value, children });
+}
+function useAnalyticsAdapters() {
+  return useContext(AnalyticsContext).adapters;
+}
+
+// src/useTrack.ts
+import { useCallback as useCallback2 } from "react";
+function useTrack() {
+  const adapters = useAnalyticsAdapters();
+  const track = useCallback2(
+    (event, properties) => {
+      for (const adapter of adapters) {
+        adapter.track(event, properties);
+      }
+    },
+    [adapters]
+  );
+  return track;
+}
+
+// src/usePageView.ts
+import { useEffect } from "react";
+function usePageView(name, properties) {
+  const adapters = useAnalyticsAdapters();
+  useEffect(() => {
+    for (const adapter of adapters) {
+      adapter.page(name, properties);
+    }
+  }, [adapters, name, properties]);
+}
+
+// src/useIdentify.ts
+import { useCallback as useCallback3 } from "react";
+function useIdentify() {
+  const adapters = useAnalyticsAdapters();
+  const identify = useCallback3(
+    (userId, traits) => {
+      for (const adapter of adapters) {
+        adapter.identify(userId, traits);
+      }
+    },
+    [adapters]
+  );
+  return identify;
+}
+export {
+  AnalyticsProvider,
+  useIdentify,
+  usePageView,
+  useTrack
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@allem-sdk/analytics",
+  "version": "0.1.0",
+  "description": "Provider-agnostic analytics hooks for React",
+  "license": "MIT",
+  "author": "Ahmed Allem",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^25.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingofmit/allem-sdk.git",
+    "directory": "packages/analytics"
+  },
+  "keywords": [
+    "allem-sdk",
+    "react",
+    "hooks",
+    "analytics",
+    "tracking",
+    "mixpanel",
+    "segment"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}