@growth-rail/react 1.0.1

package/dist/index.d.mts

@@ -0,0 +1,29 @@
+import React, { ReactNode } from 'react';
+import { GrowthRailOptions, AppUserType, GrowthRail, ReferrerTriggerButton, ReferrerModalOptions } from '@growth-rail/core';
+export { AppUserType, GrowthRailOptions } from '@growth-rail/core';
+
+interface GrowthRailProviderProps extends GrowthRailOptions {
+    userId?: string;
+    children: ReactNode;
+}
+declare const GrowthRailProvider: React.FC<GrowthRailProviderProps>;
+
+interface UseGrowthRailReturn {
+    initUser: (userId: string) => Promise<AppUserType>;
+    trackReward: (eventName?: string) => Promise<void>;
+    showReferralDashboard: (options?: Parameters<typeof GrowthRail.showReferralDashboard>[0]) => void;
+    showFloatingButton: (options: Partial<ReferrerTriggerButton>) => void;
+    hideFloatingButton: () => void;
+    isLoading: boolean;
+    error: Error | null;
+}
+declare const useGrowthRail: () => UseGrowthRailReturn;
+
+interface ReferralDashboardProps {
+    title?: string;
+    appearance?: ReferrerModalOptions;
+    onLinkCopied?: () => void;
+}
+declare const ReferralDashboard: React.FC<ReferralDashboardProps>;
+
+export { GrowthRailProvider, ReferralDashboard, type ReferralDashboardProps, type UseGrowthRailReturn, useGrowthRail };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import React, { ReactNode } from 'react';
+import { GrowthRailOptions, AppUserType, GrowthRail, ReferrerTriggerButton, ReferrerModalOptions } from '@growth-rail/core';
+export { AppUserType, GrowthRailOptions } from '@growth-rail/core';
+
+interface GrowthRailProviderProps extends GrowthRailOptions {
+    userId?: string;
+    children: ReactNode;
+}
+declare const GrowthRailProvider: React.FC<GrowthRailProviderProps>;
+
+interface UseGrowthRailReturn {
+    initUser: (userId: string) => Promise<AppUserType>;
+    trackReward: (eventName?: string) => Promise<void>;
+    showReferralDashboard: (options?: Parameters<typeof GrowthRail.showReferralDashboard>[0]) => void;
+    showFloatingButton: (options: Partial<ReferrerTriggerButton>) => void;
+    hideFloatingButton: () => void;
+    isLoading: boolean;
+    error: Error | null;
+}
+declare const useGrowthRail: () => UseGrowthRailReturn;
+
+interface ReferralDashboardProps {
+    title?: string;
+    appearance?: ReferrerModalOptions;
+    onLinkCopied?: () => void;
+}
+declare const ReferralDashboard: React.FC<ReferralDashboardProps>;
+
+export { GrowthRailProvider, ReferralDashboard, type ReferralDashboardProps, type UseGrowthRailReturn, useGrowthRail };

package/dist/index.js

@@ -0,0 +1,177 @@
+"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.tsx
+var index_exports = {};
+__export(index_exports, {
+  GrowthRailProvider: () => GrowthRailProvider,
+  ReferralDashboard: () => ReferralDashboard,
+  useGrowthRail: () => useGrowthRail
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/GrowthRailProvider.tsx
+var import_react = require("react");
+var import_core = require("@growth-rail/core");
+var import_jsx_runtime = require("react/jsx-runtime");
+var GrowthRailProvider = ({
+  children,
+  userId,
+  ...options
+}) => {
+  const [isReady, setIsReady] = (0, import_react.useState)(import_core.GrowthRail.isInitialized());
+  const initialized = (0, import_react.useRef)(false);
+  (0, import_react.useEffect)(() => {
+    if (initialized.current) return;
+    initialized.current = true;
+    import_core.GrowthRail.init(options);
+    if (userId) {
+      import_core.GrowthRail.initAppUser(userId).catch(console.error);
+    }
+    setIsReady(true);
+  }, []);
+  (0, import_react.useEffect)(() => {
+    if (initialized.current && userId && import_core.GrowthRail.getUserId() !== userId) {
+      import_core.GrowthRail.initAppUser(userId).catch(console.error);
+    }
+  }, [userId]);
+  if (!isReady) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children });
+};
+
+// src/useGrowthRail.ts
+var import_react2 = require("react");
+var import_core2 = require("@growth-rail/core");
+var useGrowthRail = () => {
+  const [isLoading, setIsLoading] = (0, import_react2.useState)(false);
+  const [error, setError] = (0, import_react2.useState)(null);
+  const initUser = (0, import_react2.useCallback)(async (userId) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const user = await import_core2.GrowthRail.initAppUser(userId);
+      return user;
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error(String(err));
+      setError(error2);
+      throw error2;
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+  const trackReward = (0, import_react2.useCallback)(async (eventName) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      await import_core2.GrowthRail.trackRewardEvent(eventName);
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error(String(err));
+      setError(error2);
+      throw error2;
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+  const showReferralDashboard = (0, import_react2.useCallback)((options) => {
+    import_core2.GrowthRail.showReferralDashboard(options);
+  }, []);
+  const showFloatingButton = (0, import_react2.useCallback)((options) => {
+    import_core2.GrowthRail.createTriggerButton(options);
+  }, []);
+  const hideFloatingButton = (0, import_react2.useCallback)(() => {
+    import_core2.GrowthRail.destroyTriggerButton();
+  }, []);
+  return {
+    initUser,
+    trackReward,
+    showReferralDashboard,
+    showFloatingButton,
+    hideFloatingButton,
+    isLoading,
+    error
+  };
+};
+
+// src/ReferralDashboard.tsx
+var import_react3 = require("react");
+var import_core3 = require("@growth-rail/core");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var ReferralDashboard = ({
+  title,
+  appearance = {},
+  onLinkCopied
+}) => {
+  const containerRef = (0, import_react3.useRef)(null);
+  const modalRef = (0, import_react3.useRef)(null);
+  (0, import_react3.useEffect)(() => {
+    let mounted = true;
+    if (!containerRef.current) return;
+    import_core3.GrowthRail.ensureUserReady().then((user) => {
+      if (!mounted || !containerRef.current) return;
+      const deps = {
+        isUserReady: () => import_core3.GrowthRail.isUserReady(),
+        getReferralLink: () => {
+          try {
+            return import_core3.GrowthRail.getReferralLink();
+          } catch {
+            return "";
+          }
+        }
+      };
+      const experience = {
+        trigger: user.referrerExperience.trigger,
+        modal: {
+          ...user.referrerExperience.modal,
+          ...title ? { title } : {},
+          ...appearance
+        }
+      };
+      modalRef.current = new import_core3.ReferralModal(deps, experience);
+      modalRef.current.show(appearance, containerRef.current);
+    }).catch((err) => {
+      console.error("GrowthRail: User initialization failed", err);
+    });
+    return () => {
+      mounted = false;
+      if (modalRef.current) {
+        modalRef.current.hide();
+        modalRef.current = null;
+      }
+    };
+  }, [title, appearance]);
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    "div",
+    {
+      ref: containerRef,
+      style: {
+        width: "100%",
+        height: "100%",
+        minHeight: "400px",
+        position: "relative"
+      }
+    }
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GrowthRailProvider,
+  ReferralDashboard,
+  useGrowthRail
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx","../src/GrowthRailProvider.tsx","../src/useGrowthRail.ts","../src/ReferralDashboard.tsx"],"sourcesContent":["export { GrowthRailProvider } from './GrowthRailProvider';\nexport { useGrowthRail, type UseGrowthRailReturn } from './useGrowthRail';\nexport { \n  ReferralDashboard, \n  type ReferralDashboardProps,\n} from './ReferralDashboard';\n\nexport type { GrowthRailOptions, AppUserType } from '@growth-rail/core';\n","import React, { useEffect, useRef, useState, ReactNode } from 'react';\nimport { GrowthRail, GrowthRailOptions } from '@growth-rail/core';\n\ninterface GrowthRailProviderProps extends GrowthRailOptions {\n  userId?: string;\n  children: ReactNode;\n}\n\nexport const GrowthRailProvider: React.FC<GrowthRailProviderProps> = ({ \n  children, \n  userId,\n  ...options \n}) => {\n  const [isReady, setIsReady] = useState(GrowthRail.isInitialized());\n  const initialized = useRef(false);\n\n  useEffect(() => {\n    if (initialized.current) return;\n    initialized.current = true;\n\n    GrowthRail.init(options);\n    if (userId) {\n      GrowthRail.initAppUser(userId).catch(console.error);\n    }\n    setIsReady(true);\n  }, []);\n\n  useEffect(() => {\n    if (initialized.current && userId && GrowthRail.getUserId() !== userId) {\n      GrowthRail.initAppUser(userId).catch(console.error);\n    }\n  }, [userId]);\n\n  if (!isReady) return null;\n\n  return <>{children}</>;\n};\n","import { useState, useCallback } from 'react';\nimport { GrowthRail, AppUserType, ReferrerTriggerButton } from '@growth-rail/core';\n\nexport interface UseGrowthRailReturn {\n  initUser: (userId: string) => Promise<AppUserType>;\n  trackReward: (eventName?: string) => Promise<void>;\n  showReferralDashboard: (options?: Parameters<typeof GrowthRail.showReferralDashboard>[0]) => void;\n  showFloatingButton: (options: Partial<ReferrerTriggerButton>) => void;\n  hideFloatingButton: () => void;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nexport const useGrowthRail = (): UseGrowthRailReturn => {\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const initUser = useCallback(async (userId: string) => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const user = await GrowthRail.initAppUser(userId);\n      return user;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, []);\n\n  const trackReward = useCallback(async (eventName?: string) => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      await GrowthRail.trackRewardEvent(eventName);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, []);\n\n  const showReferralDashboard = useCallback((options?: Parameters<typeof GrowthRail.showReferralDashboard>[0]) => {\n    GrowthRail.showReferralDashboard(options);\n  }, []);\n\n  const showFloatingButton = useCallback((options: Partial<ReferrerTriggerButton>) => {\n    GrowthRail.createTriggerButton(options);\n  }, []);\n\n  const hideFloatingButton = useCallback(() => {\n    GrowthRail.destroyTriggerButton();\n  }, []);\n\n  return {\n    initUser,\n    trackReward,\n    showReferralDashboard,\n    showFloatingButton,\n    hideFloatingButton,\n    isLoading,\n    error,\n  };\n};\n","import React, { useEffect, useRef } from 'react';\nimport { GrowthRail, ReferrerModalOptions, ReferralModal, ReferrerExperience } from '@growth-rail/core';\n\nexport interface ReferralDashboardProps {\n  title?: string;\n  appearance?: ReferrerModalOptions;\n  onLinkCopied?: () => void;\n}\n\nexport const ReferralDashboard: React.FC<ReferralDashboardProps> = ({\n  title,\n  appearance = {},\n  onLinkCopied,\n}) => {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const modalRef = useRef<ReferralModal | null>(null);\n\n  useEffect(() => {\n    let mounted = true;\n    if (!containerRef.current) return;\n\n    GrowthRail.ensureUserReady().then((user) => {\n      if (!mounted || !containerRef.current) return;\n\n      const deps = {\n        isUserReady: () => GrowthRail.isUserReady(),\n        getReferralLink: () => {\n          try {\n            return GrowthRail.getReferralLink();\n          } catch {\n            return '';\n          }\n        },\n      };\n\n      // Construct experience config directly from BE\n      const experience: ReferrerExperience = {\n        trigger: user.referrerExperience.trigger,\n        modal: {\n          ...user.referrerExperience.modal,\n          ...(title ? { title } : {}),\n          ...appearance,\n        },\n      };\n\n      modalRef.current = new ReferralModal(deps, experience);\n      modalRef.current.show(appearance, containerRef.current);\n    }).catch((err) => {\n      console.error('GrowthRail: User initialization failed', err);\n    });\n\n    return () => {\n      mounted = false;\n      if (modalRef.current) {\n        modalRef.current.hide();\n        modalRef.current = null;\n      }\n    };\n  }, [title, appearance]);\n\n  return (\n    <div \n      ref={containerRef} \n      style={{ \n        width: '100%', \n        height: '100%', \n        minHeight: '400px',\n        position: 'relative' \n      }} \n    />\n  );\n};\n"],"mappings":"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","names":["import_react","import_core","error","import_react","import_core","import_jsx_runtime"]}

package/dist/index.mjs

@@ -0,0 +1,148 @@
+// src/GrowthRailProvider.tsx
+import { useEffect, useRef, useState } from "react";
+import { GrowthRail } from "@growth-rail/core";
+import { Fragment, jsx } from "react/jsx-runtime";
+var GrowthRailProvider = ({
+  children,
+  userId,
+  ...options
+}) => {
+  const [isReady, setIsReady] = useState(GrowthRail.isInitialized());
+  const initialized = useRef(false);
+  useEffect(() => {
+    if (initialized.current) return;
+    initialized.current = true;
+    GrowthRail.init(options);
+    if (userId) {
+      GrowthRail.initAppUser(userId).catch(console.error);
+    }
+    setIsReady(true);
+  }, []);
+  useEffect(() => {
+    if (initialized.current && userId && GrowthRail.getUserId() !== userId) {
+      GrowthRail.initAppUser(userId).catch(console.error);
+    }
+  }, [userId]);
+  if (!isReady) return null;
+  return /* @__PURE__ */ jsx(Fragment, { children });
+};
+
+// src/useGrowthRail.ts
+import { useState as useState2, useCallback } from "react";
+import { GrowthRail as GrowthRail2 } from "@growth-rail/core";
+var useGrowthRail = () => {
+  const [isLoading, setIsLoading] = useState2(false);
+  const [error, setError] = useState2(null);
+  const initUser = useCallback(async (userId) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const user = await GrowthRail2.initAppUser(userId);
+      return user;
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error(String(err));
+      setError(error2);
+      throw error2;
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+  const trackReward = useCallback(async (eventName) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      await GrowthRail2.trackRewardEvent(eventName);
+    } catch (err) {
+      const error2 = err instanceof Error ? err : new Error(String(err));
+      setError(error2);
+      throw error2;
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+  const showReferralDashboard = useCallback((options) => {
+    GrowthRail2.showReferralDashboard(options);
+  }, []);
+  const showFloatingButton = useCallback((options) => {
+    GrowthRail2.createTriggerButton(options);
+  }, []);
+  const hideFloatingButton = useCallback(() => {
+    GrowthRail2.destroyTriggerButton();
+  }, []);
+  return {
+    initUser,
+    trackReward,
+    showReferralDashboard,
+    showFloatingButton,
+    hideFloatingButton,
+    isLoading,
+    error
+  };
+};
+
+// src/ReferralDashboard.tsx
+import { useEffect as useEffect2, useRef as useRef2 } from "react";
+import { GrowthRail as GrowthRail3, ReferralModal } from "@growth-rail/core";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var ReferralDashboard = ({
+  title,
+  appearance = {},
+  onLinkCopied
+}) => {
+  const containerRef = useRef2(null);
+  const modalRef = useRef2(null);
+  useEffect2(() => {
+    let mounted = true;
+    if (!containerRef.current) return;
+    GrowthRail3.ensureUserReady().then((user) => {
+      if (!mounted || !containerRef.current) return;
+      const deps = {
+        isUserReady: () => GrowthRail3.isUserReady(),
+        getReferralLink: () => {
+          try {
+            return GrowthRail3.getReferralLink();
+          } catch {
+            return "";
+          }
+        }
+      };
+      const experience = {
+        trigger: user.referrerExperience.trigger,
+        modal: {
+          ...user.referrerExperience.modal,
+          ...title ? { title } : {},
+          ...appearance
+        }
+      };
+      modalRef.current = new ReferralModal(deps, experience);
+      modalRef.current.show(appearance, containerRef.current);
+    }).catch((err) => {
+      console.error("GrowthRail: User initialization failed", err);
+    });
+    return () => {
+      mounted = false;
+      if (modalRef.current) {
+        modalRef.current.hide();
+        modalRef.current = null;
+      }
+    };
+  }, [title, appearance]);
+  return /* @__PURE__ */ jsx2(
+    "div",
+    {
+      ref: containerRef,
+      style: {
+        width: "100%",
+        height: "100%",
+        minHeight: "400px",
+        position: "relative"
+      }
+    }
+  );
+};
+export {
+  GrowthRailProvider,
+  ReferralDashboard,
+  useGrowthRail
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/GrowthRailProvider.tsx","../src/useGrowthRail.ts","../src/ReferralDashboard.tsx"],"sourcesContent":["import React, { useEffect, useRef, useState, ReactNode } from 'react';\nimport { GrowthRail, GrowthRailOptions } from '@growth-rail/core';\n\ninterface GrowthRailProviderProps extends GrowthRailOptions {\n  userId?: string;\n  children: ReactNode;\n}\n\nexport const GrowthRailProvider: React.FC<GrowthRailProviderProps> = ({ \n  children, \n  userId,\n  ...options \n}) => {\n  const [isReady, setIsReady] = useState(GrowthRail.isInitialized());\n  const initialized = useRef(false);\n\n  useEffect(() => {\n    if (initialized.current) return;\n    initialized.current = true;\n\n    GrowthRail.init(options);\n    if (userId) {\n      GrowthRail.initAppUser(userId).catch(console.error);\n    }\n    setIsReady(true);\n  }, []);\n\n  useEffect(() => {\n    if (initialized.current && userId && GrowthRail.getUserId() !== userId) {\n      GrowthRail.initAppUser(userId).catch(console.error);\n    }\n  }, [userId]);\n\n  if (!isReady) return null;\n\n  return <>{children}</>;\n};\n","import { useState, useCallback } from 'react';\nimport { GrowthRail, AppUserType, ReferrerTriggerButton } from '@growth-rail/core';\n\nexport interface UseGrowthRailReturn {\n  initUser: (userId: string) => Promise<AppUserType>;\n  trackReward: (eventName?: string) => Promise<void>;\n  showReferralDashboard: (options?: Parameters<typeof GrowthRail.showReferralDashboard>[0]) => void;\n  showFloatingButton: (options: Partial<ReferrerTriggerButton>) => void;\n  hideFloatingButton: () => void;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nexport const useGrowthRail = (): UseGrowthRailReturn => {\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const initUser = useCallback(async (userId: string) => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      const user = await GrowthRail.initAppUser(userId);\n      return user;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, []);\n\n  const trackReward = useCallback(async (eventName?: string) => {\n    setIsLoading(true);\n    setError(null);\n    try {\n      await GrowthRail.trackRewardEvent(eventName);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      throw error;\n    } finally {\n      setIsLoading(false);\n    }\n  }, []);\n\n  const showReferralDashboard = useCallback((options?: Parameters<typeof GrowthRail.showReferralDashboard>[0]) => {\n    GrowthRail.showReferralDashboard(options);\n  }, []);\n\n  const showFloatingButton = useCallback((options: Partial<ReferrerTriggerButton>) => {\n    GrowthRail.createTriggerButton(options);\n  }, []);\n\n  const hideFloatingButton = useCallback(() => {\n    GrowthRail.destroyTriggerButton();\n  }, []);\n\n  return {\n    initUser,\n    trackReward,\n    showReferralDashboard,\n    showFloatingButton,\n    hideFloatingButton,\n    isLoading,\n    error,\n  };\n};\n","import React, { useEffect, useRef } from 'react';\nimport { GrowthRail, ReferrerModalOptions, ReferralModal, ReferrerExperience } from '@growth-rail/core';\n\nexport interface ReferralDashboardProps {\n  title?: string;\n  appearance?: ReferrerModalOptions;\n  onLinkCopied?: () => void;\n}\n\nexport const ReferralDashboard: React.FC<ReferralDashboardProps> = ({\n  title,\n  appearance = {},\n  onLinkCopied,\n}) => {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const modalRef = useRef<ReferralModal | null>(null);\n\n  useEffect(() => {\n    let mounted = true;\n    if (!containerRef.current) return;\n\n    GrowthRail.ensureUserReady().then((user) => {\n      if (!mounted || !containerRef.current) return;\n\n      const deps = {\n        isUserReady: () => GrowthRail.isUserReady(),\n        getReferralLink: () => {\n          try {\n            return GrowthRail.getReferralLink();\n          } catch {\n            return '';\n          }\n        },\n      };\n\n      // Construct experience config directly from BE\n      const experience: ReferrerExperience = {\n        trigger: user.referrerExperience.trigger,\n        modal: {\n          ...user.referrerExperience.modal,\n          ...(title ? { title } : {}),\n          ...appearance,\n        },\n      };\n\n      modalRef.current = new ReferralModal(deps, experience);\n      modalRef.current.show(appearance, containerRef.current);\n    }).catch((err) => {\n      console.error('GrowthRail: User initialization failed', err);\n    });\n\n    return () => {\n      mounted = false;\n      if (modalRef.current) {\n        modalRef.current.hide();\n        modalRef.current = null;\n      }\n    };\n  }, [title, appearance]);\n\n  return (\n    <div \n      ref={containerRef} \n      style={{ \n        width: '100%', \n        height: '100%', \n        minHeight: '400px',\n        position: 'relative' \n      }} \n    />\n  );\n};\n"],"mappings":"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","names":["useState","GrowthRail","error","useEffect","useRef","GrowthRail","jsx"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+    "name": "@growth-rail/react",
+    "version": "1.0.1",
+    "description": "Growth Rail React SDK",
+    "main": "./dist/index.js",
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "require": "./dist/index.js",
+            "import": "./dist/index.mjs"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "lint": "eslint src/",
+        "test": "vitest run",
+        "type-check": "tsc --noEmit"
+    },
+    "peerDependencies": {
+        "react": ">=16.8"
+    },
+    "dependencies": {
+        "@growth-rail/core": "workspace:*"
+    },
+    "devDependencies": {
+        "@growth-rail/eslint-config": "*",
+        "@growth-rail/tsconfig": "*",
+        "@testing-library/dom": "^10.0.0",
+        "@testing-library/react": "^16.2.0",
+        "@types/react": "^18.0.0",
+        "jsdom": "^26.0.0",
+        "react": "^18.0.0",
+        "tsup": "^8.0.0",
+        "typescript": "^5.0.0",
+        "vitest": "^1.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}