@simple-product/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,241 @@
+"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, {
+  SimpleProduct: () => SimpleProduct,
+  createSimpleProduct: () => createSimpleProduct,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+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 : "");
+  }
+};
+function createSimpleProduct(config) {
+  return new SimpleProduct(config);
+}
+var index_default = SimpleProduct;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SimpleProduct,
+  createSimpleProduct
+});

package/dist/index.mjs

@@ -0,0 +1,10 @@
+import {
+  SimpleProduct,
+  createSimpleProduct,
+  index_default
+} from "./chunk-7F2GKQLH.mjs";
+export {
+  SimpleProduct,
+  createSimpleProduct,
+  index_default as default
+};

package/dist/react.d.mts

@@ -0,0 +1,82 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { IdentifyParams } from './index.mjs';
+
+interface SimpleProductContextValue {
+    /** Track a custom event */
+    track: (event: string, properties?: Record<string, unknown>) => void;
+    /** Manually trigger identify (usually not needed if user prop is provided) */
+    identify: (params: IdentifyParams) => void;
+    /** Reset user on logout */
+    reset: () => void;
+}
+interface SimpleProductProviderProps {
+    children: ReactNode;
+    /** Your Simple Product API key */
+    apiKey: string;
+    /** Optional API endpoint override */
+    endpoint?: string;
+    /**
+     * The current user. When provided, identify() is called automatically.
+     * At minimum, provide userId. Email and name are recommended.
+     */
+    user?: {
+        id: string;
+        email?: string;
+        name?: string;
+        company?: string;
+        [key: string]: unknown;
+    } | null;
+    /** Disable automatic heartbeat (not recommended) */
+    disableAutoHeartbeat?: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Simple Product Provider
+ *
+ * Wrap your app with this provider to enable analytics tracking.
+ *
+ * @example
+ * ```tsx
+ * // app/providers.tsx
+ * import { SimpleProductProvider } from '@simple-product/sdk/react';
+ *
+ * export function Providers({ children }) {
+ *   const user = useCurrentUser(); // from your auth
+ *
+ *   return (
+ *     <SimpleProductProvider
+ *       apiKey={process.env.NEXT_PUBLIC_SP_API_KEY!}
+ *       user={user ? { id: user.id, email: user.email, name: user.name } : null}
+ *     >
+ *       {children}
+ *     </SimpleProductProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function SimpleProductProvider({ children, apiKey, endpoint, user, disableAutoHeartbeat, debug, }: SimpleProductProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access Simple Product tracking functions
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { track } = useSimpleProduct();
+ *
+ *   return (
+ *     <button onClick={() => track('button_clicked', { button: 'signup' })}>
+ *       Sign Up
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useSimpleProduct(): SimpleProductContextValue;
+/**
+ * Hook that returns track function only (convenience for common use case)
+ */
+declare function useTrack(): (event: string, properties?: Record<string, unknown>) => void;
+
+export { SimpleProductProvider, type SimpleProductProviderProps, useSimpleProduct, useTrack };

package/dist/react.d.ts

@@ -0,0 +1,82 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { IdentifyParams } from './index.js';
+
+interface SimpleProductContextValue {
+    /** Track a custom event */
+    track: (event: string, properties?: Record<string, unknown>) => void;
+    /** Manually trigger identify (usually not needed if user prop is provided) */
+    identify: (params: IdentifyParams) => void;
+    /** Reset user on logout */
+    reset: () => void;
+}
+interface SimpleProductProviderProps {
+    children: ReactNode;
+    /** Your Simple Product API key */
+    apiKey: string;
+    /** Optional API endpoint override */
+    endpoint?: string;
+    /**
+     * The current user. When provided, identify() is called automatically.
+     * At minimum, provide userId. Email and name are recommended.
+     */
+    user?: {
+        id: string;
+        email?: string;
+        name?: string;
+        company?: string;
+        [key: string]: unknown;
+    } | null;
+    /** Disable automatic heartbeat (not recommended) */
+    disableAutoHeartbeat?: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Simple Product Provider
+ *
+ * Wrap your app with this provider to enable analytics tracking.
+ *
+ * @example
+ * ```tsx
+ * // app/providers.tsx
+ * import { SimpleProductProvider } from '@simple-product/sdk/react';
+ *
+ * export function Providers({ children }) {
+ *   const user = useCurrentUser(); // from your auth
+ *
+ *   return (
+ *     <SimpleProductProvider
+ *       apiKey={process.env.NEXT_PUBLIC_SP_API_KEY!}
+ *       user={user ? { id: user.id, email: user.email, name: user.name } : null}
+ *     >
+ *       {children}
+ *     </SimpleProductProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function SimpleProductProvider({ children, apiKey, endpoint, user, disableAutoHeartbeat, debug, }: SimpleProductProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access Simple Product tracking functions
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { track } = useSimpleProduct();
+ *
+ *   return (
+ *     <button onClick={() => track('button_clicked', { button: 'signup' })}>
+ *       Sign Up
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useSimpleProduct(): SimpleProductContextValue;
+/**
+ * Hook that returns track function only (convenience for common use case)
+ */
+declare function useTrack(): (event: string, properties?: Record<string, unknown>) => void;
+
+export { SimpleProductProvider, type SimpleProductProviderProps, useSimpleProduct, useTrack };