@simple-product/sdk 0.1.0

package/dist/react.js

@@ -0,0 +1,313 @@
+"use strict";
+"use client";
+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/react.tsx
+var react_exports = {};
+__export(react_exports, {
+  SimpleProductProvider: () => SimpleProductProvider,
+  useSimpleProduct: () => useSimpleProduct,
+  useTrack: () => useTrack
+});
+module.exports = __toCommonJS(react_exports);
+var import_react = require("react");
+
+// src/index.ts
+var STORAGE_KEY_PREFIX = "sp_sdk_";
+var HEARTBEAT_STORAGE_KEY = `${STORAGE_KEY_PREFIX}last_heartbeat`;
+var USER_ID_STORAGE_KEY = `${STORAGE_KEY_PREFIX}user_id`;
+var ANONYMOUS_ID_STORAGE_KEY = `${STORAGE_KEY_PREFIX}anonymous_id`;
+var SimpleProduct = class {
+  constructor(config) {
+    this.userId = null;
+    this.heartbeatInterval = null;
+    this.visibilityHandler = null;
+    this.apiKey = config.apiKey;
+    this.endpoint = config.endpoint || "https://simpleproduct.io/api/v1";
+    this.debug = config.debug || false;
+    this.disableAutoHeartbeat = config.disableAutoHeartbeat || false;
+    this.anonymousId = this.getOrCreateAnonymousId();
+    this.userId = this.getStoredUserId();
+    if (!this.disableAutoHeartbeat && typeof window !== "undefined") {
+      this.startHeartbeat();
+    }
+    this.log("Initialized", { userId: this.userId, anonymousId: this.anonymousId });
+  }
+  /**
+   * Identify a user - call this when a user signs in
+   */
+  identify(params) {
+    this.userId = params.userId;
+    this.storeUserId(params.userId);
+    this.log("Identify", params);
+    this.sendRequest("/people", {
+      method: "POST",
+      body: {
+        externalId: params.userId,
+        email: params.email,
+        name: params.name,
+        company: params.company,
+        ...params.traits
+      }
+    }).catch((err) => this.log("Identify error", err));
+    this.sendHeartbeat();
+  }
+  track(eventOrParams, properties) {
+    const event = typeof eventOrParams === "string" ? eventOrParams : eventOrParams.event;
+    const props = typeof eventOrParams === "string" ? properties : eventOrParams.properties;
+    this.log("Track", { event, properties: props });
+    this.sendRequest("/events", {
+      method: "POST",
+      body: {
+        event,
+        userId: this.userId,
+        anonymousId: this.anonymousId,
+        properties: props,
+        context: this.getContext()
+      }
+    }).catch((err) => this.log("Track error", err));
+  }
+  /**
+   * Reset the user - call this when a user signs out
+   */
+  reset() {
+    this.userId = null;
+    this.clearStoredUserId();
+    this.anonymousId = this.generateAnonymousId();
+    this.storeAnonymousId(this.anonymousId);
+    this.log("Reset");
+  }
+  /**
+   * Manually send a heartbeat (usually not needed - happens automatically)
+   */
+  heartbeat() {
+    this.sendHeartbeat();
+  }
+  /**
+   * Clean up SDK resources
+   */
+  destroy() {
+    if (this.heartbeatInterval) {
+      clearInterval(this.heartbeatInterval);
+      this.heartbeatInterval = null;
+    }
+    if (this.visibilityHandler && typeof document !== "undefined") {
+      document.removeEventListener("visibilitychange", this.visibilityHandler);
+      this.visibilityHandler = null;
+    }
+    this.log("Destroyed");
+  }
+  // --- Private methods ---
+  startHeartbeat() {
+    this.sendHeartbeatIfNeeded();
+    this.heartbeatInterval = setInterval(() => {
+      this.sendHeartbeatIfNeeded();
+    }, 5 * 60 * 1e3);
+    this.visibilityHandler = () => {
+      if (document.visibilityState === "visible") {
+        this.sendHeartbeatIfNeeded();
+      }
+    };
+    document.addEventListener("visibilitychange", this.visibilityHandler);
+  }
+  sendHeartbeatIfNeeded() {
+    if (!this.userId) {
+      this.log("Skipping heartbeat - no user identified");
+      return;
+    }
+    const today = this.getTodayString();
+    const lastHeartbeat = this.getLastHeartbeatDate();
+    if (lastHeartbeat === today) {
+      this.log("Skipping heartbeat - already sent today");
+      return;
+    }
+    this.sendHeartbeat();
+  }
+  sendHeartbeat() {
+    if (!this.userId) {
+      this.log("Cannot send heartbeat - no user identified");
+      return;
+    }
+    const today = this.getTodayString();
+    this.log("Sending heartbeat");
+    this.sendRequest("/events", {
+      method: "POST",
+      body: {
+        event: "sp_heartbeat",
+        userId: this.userId,
+        anonymousId: this.anonymousId,
+        context: this.getContext()
+      }
+    }).then(() => {
+      this.storeLastHeartbeatDate(today);
+      this.log("Heartbeat sent successfully");
+    }).catch((err) => this.log("Heartbeat error", err));
+  }
+  async sendRequest(path, options) {
+    const url = `${this.endpoint}${path}`;
+    const response = await fetch(url, {
+      method: options.method,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: options.body ? JSON.stringify(options.body) : void 0
+    });
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`API error: ${response.status} ${error}`);
+    }
+    return response.json();
+  }
+  getContext() {
+    if (typeof window === "undefined") {
+      return {};
+    }
+    return {
+      userAgent: navigator.userAgent,
+      page: {
+        url: window.location.href,
+        title: document.title,
+        referrer: document.referrer
+      }
+    };
+  }
+  getTodayString() {
+    return (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  }
+  getLastHeartbeatDate() {
+    if (typeof localStorage === "undefined") return null;
+    return localStorage.getItem(HEARTBEAT_STORAGE_KEY);
+  }
+  storeLastHeartbeatDate(date) {
+    if (typeof localStorage === "undefined") return;
+    localStorage.setItem(HEARTBEAT_STORAGE_KEY, date);
+  }
+  getStoredUserId() {
+    if (typeof localStorage === "undefined") return null;
+    return localStorage.getItem(USER_ID_STORAGE_KEY);
+  }
+  storeUserId(userId) {
+    if (typeof localStorage === "undefined") return;
+    localStorage.setItem(USER_ID_STORAGE_KEY, userId);
+  }
+  clearStoredUserId() {
+    if (typeof localStorage === "undefined") return;
+    localStorage.removeItem(USER_ID_STORAGE_KEY);
+    localStorage.removeItem(HEARTBEAT_STORAGE_KEY);
+  }
+  getOrCreateAnonymousId() {
+    if (typeof localStorage === "undefined") {
+      return this.generateAnonymousId();
+    }
+    const stored = localStorage.getItem(ANONYMOUS_ID_STORAGE_KEY);
+    if (stored) return stored;
+    const id = this.generateAnonymousId();
+    this.storeAnonymousId(id);
+    return id;
+  }
+  storeAnonymousId(id) {
+    if (typeof localStorage === "undefined") return;
+    localStorage.setItem(ANONYMOUS_ID_STORAGE_KEY, id);
+  }
+  generateAnonymousId() {
+    return "anon_" + Math.random().toString(36).substring(2, 15) + Math.random().toString(36).substring(2, 15);
+  }
+  log(message, data) {
+    if (!this.debug) return;
+    console.log(`[SimpleProduct] ${message}`, data !== void 0 ? data : "");
+  }
+};
+var index_default = SimpleProduct;
+
+// src/react.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var SimpleProductContext = (0, import_react.createContext)(null);
+function SimpleProductProvider({
+  children,
+  apiKey,
+  endpoint,
+  user,
+  disableAutoHeartbeat,
+  debug
+}) {
+  const spRef = (0, import_react.useRef)(null);
+  const identifiedUserIdRef = (0, import_react.useRef)(null);
+  (0, import_react.useEffect)(() => {
+    if (typeof window === "undefined") return;
+    spRef.current = new index_default({
+      apiKey,
+      endpoint,
+      disableAutoHeartbeat,
+      debug
+    });
+    return () => {
+      spRef.current?.destroy();
+      spRef.current = null;
+    };
+  }, [apiKey, endpoint, disableAutoHeartbeat, debug]);
+  (0, import_react.useEffect)(() => {
+    if (!spRef.current) return;
+    if (user?.id && user.id !== identifiedUserIdRef.current) {
+      const { id, email, name, company, ...traits } = user;
+      spRef.current.identify({
+        userId: id,
+        email,
+        name,
+        company,
+        traits: Object.keys(traits).length > 0 ? traits : void 0
+      });
+      identifiedUserIdRef.current = id;
+    } else if (!user && identifiedUserIdRef.current) {
+      spRef.current.reset();
+      identifiedUserIdRef.current = null;
+    }
+  }, [user]);
+  const contextValue = {
+    track: (event, properties) => {
+      spRef.current?.track(event, properties);
+    },
+    identify: (params) => {
+      spRef.current?.identify(params);
+      identifiedUserIdRef.current = params.userId;
+    },
+    reset: () => {
+      spRef.current?.reset();
+      identifiedUserIdRef.current = null;
+    }
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SimpleProductContext.Provider, { value: contextValue, children });
+}
+function useSimpleProduct() {
+  const context = (0, import_react.useContext)(SimpleProductContext);
+  if (!context) {
+    throw new Error("useSimpleProduct must be used within a SimpleProductProvider");
+  }
+  return context;
+}
+function useTrack() {
+  const { track } = useSimpleProduct();
+  return track;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SimpleProductProvider,
+  useSimpleProduct,
+  useTrack
+});

package/dist/react.mjs

@@ -0,0 +1,80 @@
+"use client";
+import {
+  index_default
+} from "./chunk-7F2GKQLH.mjs";
+
+// src/react.tsx
+import { createContext, useContext, useEffect, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+var SimpleProductContext = createContext(null);
+function SimpleProductProvider({
+  children,
+  apiKey,
+  endpoint,
+  user,
+  disableAutoHeartbeat,
+  debug
+}) {
+  const spRef = useRef(null);
+  const identifiedUserIdRef = useRef(null);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    spRef.current = new index_default({
+      apiKey,
+      endpoint,
+      disableAutoHeartbeat,
+      debug
+    });
+    return () => {
+      spRef.current?.destroy();
+      spRef.current = null;
+    };
+  }, [apiKey, endpoint, disableAutoHeartbeat, debug]);
+  useEffect(() => {
+    if (!spRef.current) return;
+    if (user?.id && user.id !== identifiedUserIdRef.current) {
+      const { id, email, name, company, ...traits } = user;
+      spRef.current.identify({
+        userId: id,
+        email,
+        name,
+        company,
+        traits: Object.keys(traits).length > 0 ? traits : void 0
+      });
+      identifiedUserIdRef.current = id;
+    } else if (!user && identifiedUserIdRef.current) {
+      spRef.current.reset();
+      identifiedUserIdRef.current = null;
+    }
+  }, [user]);
+  const contextValue = {
+    track: (event, properties) => {
+      spRef.current?.track(event, properties);
+    },
+    identify: (params) => {
+      spRef.current?.identify(params);
+      identifiedUserIdRef.current = params.userId;
+    },
+    reset: () => {
+      spRef.current?.reset();
+      identifiedUserIdRef.current = null;
+    }
+  };
+  return /* @__PURE__ */ jsx(SimpleProductContext.Provider, { value: contextValue, children });
+}
+function useSimpleProduct() {
+  const context = useContext(SimpleProductContext);
+  if (!context) {
+    throw new Error("useSimpleProduct must be used within a SimpleProductProvider");
+  }
+  return context;
+}
+function useTrack() {
+  const { track } = useSimpleProduct();
+  return track;
+}
+export {
+  SimpleProductProvider,
+  useSimpleProduct,
+  useTrack
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@simple-product/sdk",
+  "version": "0.1.0",
+  "description": "Simple Product SDK - Track users and product usage",
+  "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"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/react.tsx --format cjs,esm --dts --external react",
+    "dev": "tsup src/index.ts src/react.tsx --format cjs,esm --dts --external react --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "product",
+    "sdk",
+    "react"
+  ],
+  "author": "Simple Product",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}