npm - @thisbefine/analytics - Versions diffs - 0.1.0 - Mend

@thisbefine/analytics 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (79) hide show

package/LICENSE +21 -0
package/README.md +403 -0
package/dist/core/analytics.d.ts +123 -0
package/dist/core/analytics.d.ts.map +1 -0
package/dist/core/analytics.js +334 -0
package/dist/core/analytics.js.map +1 -0
package/dist/core/errors.d.ts +94 -0
package/dist/core/errors.d.ts.map +1 -0
package/dist/core/errors.js +420 -0
package/dist/core/errors.js.map +1 -0
package/dist/core/logger.d.ts +28 -0
package/dist/core/logger.d.ts.map +1 -0
package/dist/core/logger.js +36 -0
package/dist/core/logger.js.map +1 -0
package/dist/core/logging.d.ts +12 -0
package/dist/core/logging.d.ts.map +1 -0
package/dist/core/logging.js +33 -0
package/dist/core/logging.js.map +1 -0
package/dist/core/privacy.d.ts +53 -0
package/dist/core/privacy.d.ts.map +1 -0
package/dist/core/privacy.js +94 -0
package/dist/core/privacy.js.map +1 -0
package/dist/core/queue.d.ts +59 -0
package/dist/core/queue.d.ts.map +1 -0
package/dist/core/queue.js +263 -0
package/dist/core/queue.js.map +1 -0
package/dist/core/session.d.ts +90 -0
package/dist/core/session.d.ts.map +1 -0
package/dist/core/session.js +246 -0
package/dist/core/session.js.map +1 -0
package/dist/core/storage.d.ts +64 -0
package/dist/core/storage.d.ts.map +1 -0
package/dist/core/storage.js +242 -0
package/dist/core/storage.js.map +1 -0
package/dist/core/types.d.ts +298 -0
package/dist/core/types.d.ts.map +1 -0
package/dist/core/types.js +34 -0
package/dist/core/types.js.map +1 -0
package/dist/core/validation.d.ts +11 -0
package/dist/core/validation.d.ts.map +1 -0
package/dist/core/validation.js +82 -0
package/dist/core/validation.js.map +1 -0
package/dist/core/version.d.ts +2 -0
package/dist/core/version.d.ts.map +1 -0
package/dist/core/version.js +4 -0
package/dist/core/version.js.map +1 -0
package/dist/index.d.ts +45 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +41 -0
package/dist/index.js.map +1 -0
package/dist/next/analytics.d.ts +59 -0
package/dist/next/analytics.d.ts.map +1 -0
package/dist/next/analytics.js +87 -0
package/dist/next/analytics.js.map +1 -0
package/dist/next.d.ts +46 -0
package/dist/next.d.ts.map +1 -0
package/dist/next.js +44 -0
package/dist/next.js.map +1 -0
package/dist/react/analytics.d.ts +51 -0
package/dist/react/analytics.d.ts.map +1 -0
package/dist/react/analytics.js +63 -0
package/dist/react/analytics.js.map +1 -0
package/dist/react/bug-report-widget.d.ts +21 -0
package/dist/react/bug-report-widget.d.ts.map +1 -0
package/dist/react/bug-report-widget.js +34 -0
package/dist/react/bug-report-widget.js.map +1 -0
package/dist/react/hooks.d.ts +141 -0
package/dist/react/hooks.d.ts.map +1 -0
package/dist/react/hooks.js +186 -0
package/dist/react/hooks.js.map +1 -0
package/dist/react.d.ts +42 -0
package/dist/react.d.ts.map +1 -0
package/dist/react.js +39 -0
package/dist/react.js.map +1 -0
package/dist/widget/bug-report.d.ts +16 -0
package/dist/widget/bug-report.d.ts.map +1 -0
package/dist/widget/bug-report.js +416 -0
package/dist/widget/bug-report.js.map +1 -0
package/package.json +107 -0

package/dist/next/analytics.js ADDED Viewed

@@ -0,0 +1,87 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { usePathname, useSearchParams } from "next/navigation";
+import { Suspense, useEffect, useRef } from "react";
+import { getAnalytics, initAnalytics } from "../core/analytics";
+/**
+ * Internal component that tracks page views using Next.js navigation hooks
+ */
+const PageTracker = () => {
+    const pathname = usePathname();
+    const searchParams = useSearchParams();
+    const previousPath = useRef(null);
+    const hasTrackedInitial = useRef(false);
+    useEffect(() => {
+        const analytics = getAnalytics();
+        if (!analytics)
+            return;
+        const search = searchParams?.toString();
+        const fullPath = search ? `${pathname}?${search}` : pathname;
+        if (previousPath.current === fullPath && hasTrackedInitial.current) {
+            return;
+        }
+        analytics.page(pathname ?? undefined, {
+            path: pathname,
+            search: search || undefined,
+            url: typeof window !== "undefined" ? window.location.href : undefined,
+        });
+        previousPath.current = fullPath;
+        hasTrackedInitial.current = true;
+    }, [pathname, searchParams]);
+    return null;
+};
+/**
+ * Next.js Analytics component - initializes Thisbefine analytics
+ *
+ * Optimized for the Next.js App Router with automatic pageview tracking
+ * on client-side navigations using usePathname/useSearchParams.
+ *
+ * Add this component once at the root of your app (e.g., in layout.tsx).
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * // Zero config - reads from NEXT_PUBLIC_TBF_API_KEY
+ * import { Analytics } from '@thisbefine/analytics/next';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         <Analytics />
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ *
+ * // With explicit config
+ * <Analytics apiKey="tbf_xxx" host="http://localhost:3000" debug />
+ * ```
+ */
+export const Analytics = ({ apiKey, host, debug = false, trackPageviews = true, config, }) => {
+    const initialized = useRef(false);
+    useEffect(() => {
+        if (initialized.current)
+            return;
+        if (typeof window === "undefined")
+            return;
+        const resolvedApiKey = apiKey ?? process.env.NEXT_PUBLIC_TBF_API_KEY ?? "";
+        if (!resolvedApiKey) {
+            console.warn("[Thisbefine] No API key provided. Set NEXT_PUBLIC_TBF_API_KEY or pass apiKey prop.");
+            return;
+        }
+        initAnalytics({
+            apiKey: resolvedApiKey,
+            host,
+            debug,
+            ...config,
+        });
+        initialized.current = true;
+    }, [apiKey, host, debug, config]);
+    if (!trackPageviews) {
+        return null;
+    }
+    return (_jsx(Suspense, { fallback: null, children: _jsx(PageTracker, {}) }));
+};
+//# sourceMappingURL=analytics.js.map

package/dist/next/analytics.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/next/analytics.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAmChE;;GAEG;AACH,MAAM,WAAW,GAAG,GAAG,EAAE;IACxB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IACjD,MAAM,iBAAiB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAExC,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,MAAM,GAAG,YAAY,EAAE,QAAQ,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE7D,IAAI,YAAY,CAAC,OAAO,KAAK,QAAQ,IAAI,iBAAiB,CAAC,OAAO,EAAE,CAAC;YACpE,OAAO;QACR,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,QAAQ,IAAI,SAAS,EAAE;YACrC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,MAAM,IAAI,SAAS;YAC3B,GAAG,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;SACrE,CAAC,CAAC;QAEH,YAAY,CAAC,OAAO,GAAG,QAAQ,CAAC;QAChC,iBAAiB,CAAC,OAAO,GAAG,IAAI,CAAC;IAClC,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAE7B,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EACzB,MAAM,EACN,IAAI,EACJ,KAAK,GAAG,KAAK,EACb,cAAc,GAAG,IAAI,EACrB,MAAM,GACc,EAAE,EAAE;IACxB,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAElC,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,WAAW,CAAC,OAAO;YAAE,OAAO;QAChC,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QAE1C,MAAM,cAAc,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC;QAE3E,IAAI,CAAC,cAAc,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CACX,oFAAoF,CACpF,CAAC;YACF,OAAO;QACR,CAAC;QAED,aAAa,CAAC;YACb,MAAM,EAAE,cAAc;YACtB,IAAI;YACJ,KAAK;YACL,GAAG,MAAM;SACT,CAAC,CAAC;QAEH,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;IAC5B,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAElC,IAAI,CAAC,cAAc,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,CACN,KAAC,QAAQ,IAAC,QAAQ,EAAE,IAAI,YACvB,KAAC,WAAW,KAAG,GACL,CACX,CAAC;AACH,CAAC,CAAC"}

package/dist/next.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+/**
+ * @thisbefine/analytics/next
+ *
+ * Next.js integration for Thisbefine Analytics.
+ *
+ * Optimized for the App Router with automatic pageview tracking
+ * on client-side navigations using usePathname/useSearchParams.
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { Analytics } from '@thisbefine/analytics/next';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html lang="en">
+ *       <body>
+ *         {children}
+ *         <Analytics />
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ *
+ * // components/signup-button.tsx
+ * 'use client';
+ * import { useTrack } from '@thisbefine/analytics/next';
+ *
+ * export function SignupButton() {
+ *   const trackSignup = useTrack('signup_clicked');
+ *
+ *   return (
+ *     <button onClick={() => trackSignup({ location: 'header' })}>
+ *       Sign Up
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { AccountTraits, Analytics as AnalyticsInstance, AnalyticsConfig, UserState, UserTraits, } from "./core/types";
+export type { NextAnalyticsProps } from "./next/analytics";
+export { Analytics } from "./next/analytics";
+export { useAnalytics, useCaptureException, useGetUser, useGroup, useIdentify, useLog, usePage, useReset, useTrack, } from "./react/hooks";
+//# sourceMappingURL=next.d.ts.map

package/dist/next.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,YAAY,EACX,aAAa,EACb,SAAS,IAAI,iBAAiB,EAC9B,eAAe,EACf,SAAS,EACT,UAAU,GACV,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EACN,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,WAAW,EACX,MAAM,EACN,OAAO,EACP,QAAQ,EACR,QAAQ,GACR,MAAM,eAAe,CAAC"}

package/dist/next.js ADDED Viewed

@@ -0,0 +1,44 @@
+/**
+ * @thisbefine/analytics/next
+ *
+ * Next.js integration for Thisbefine Analytics.
+ *
+ * Optimized for the App Router with automatic pageview tracking
+ * on client-side navigations using usePathname/useSearchParams.
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { Analytics } from '@thisbefine/analytics/next';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html lang="en">
+ *       <body>
+ *         {children}
+ *         <Analytics />
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ *
+ * // components/signup-button.tsx
+ * 'use client';
+ * import { useTrack } from '@thisbefine/analytics/next';
+ *
+ * export function SignupButton() {
+ *   const trackSignup = useTrack('signup_clicked');
+ *
+ *   return (
+ *     <button onClick={() => trackSignup({ location: 'header' })}>
+ *       Sign Up
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Analytics } from "./next/analytics";
+export { useAnalytics, useCaptureException, useGetUser, useGroup, useIdentify, useLog, usePage, useReset, useTrack, } from "./react/hooks";
+//# sourceMappingURL=next.js.map

package/dist/next.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"next.js","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAWH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EACN,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,WAAW,EACX,MAAM,EACN,OAAO,EACP,QAAQ,EACR,QAAQ,GACR,MAAM,eAAe,CAAC"}

package/dist/react/analytics.d.ts ADDED Viewed

@@ -0,0 +1,51 @@
+import type { AnalyticsConfig } from "../core/types";
+export interface AnalyticsProps {
+    /**
+     * Your Thisbefine API key.
+     * If not provided, reads from NEXT_PUBLIC_TBF_API_KEY environment variable.
+     */
+    apiKey?: string;
+    /**
+     * API host URL.
+     * Defaults to https://thisbefine.com
+     * For local development, use http://localhost:3000
+     */
+    host?: string;
+    /**
+     * Enable debug logging to console.
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Automatically track page views.
+     * @default true
+     */
+    trackPageviews?: boolean;
+    /**
+     * Additional configuration options
+     */
+    config?: Omit<AnalyticsConfig, "apiKey" | "host" | "debug">;
+}
+/**
+ * Analytics component - initializes Thisbefine analytics
+ *
+ * Add this component once at the root of your app (e.g., in layout.tsx).
+ * It will automatically initialize analytics and track page views.
+ *
+ * @example
+ * ```tsx
+ * // Zero config - reads from NEXT_PUBLIC_TBF_API_KEY
+ * <Analytics />
+ *
+ * // With explicit API key
+ * <Analytics apiKey="tbf_xxx" />
+ *
+ * // For local development
+ * <Analytics apiKey="tbf_xxx" host="http://localhost:3000" />
+ *
+ * // With debug mode
+ * <Analytics debug />
+ * ```
+ */
+export declare const Analytics: ({ apiKey, host, debug, trackPageviews, config, }: AnalyticsProps) => null;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/react/analytics.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/react/analytics.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,SAAS,GAAI,kDAMvB,cAAc,SA6ChB,CAAC"}

package/dist/react/analytics.js ADDED Viewed

@@ -0,0 +1,63 @@
+"use client";
+import { useEffect, useRef } from "react";
+import { initAnalytics } from "../core/analytics";
+/**
+ * Analytics component - initializes Thisbefine analytics
+ *
+ * Add this component once at the root of your app (e.g., in layout.tsx).
+ * It will automatically initialize analytics and track page views.
+ *
+ * @example
+ * ```tsx
+ * // Zero config - reads from NEXT_PUBLIC_TBF_API_KEY
+ * <Analytics />
+ *
+ * // With explicit API key
+ * <Analytics apiKey="tbf_xxx" />
+ *
+ * // For local development
+ * <Analytics apiKey="tbf_xxx" host="http://localhost:3000" />
+ *
+ * // With debug mode
+ * <Analytics debug />
+ * ```
+ */
+export const Analytics = ({ apiKey, host, debug = false, trackPageviews = true, config, }) => {
+    const initialized = useRef(false);
+    useEffect(() => {
+        if (initialized.current)
+            return;
+        if (typeof window === "undefined")
+            return;
+        const resolvedApiKey = apiKey ?? process.env.NEXT_PUBLIC_TBF_API_KEY ?? "";
+        if (!resolvedApiKey) {
+            console.warn("[Thisbefine] No API key provided. Set NEXT_PUBLIC_TBF_API_KEY or pass apiKey prop.");
+            return;
+        }
+        const analytics = initAnalytics({
+            apiKey: resolvedApiKey,
+            host,
+            debug,
+            ...config,
+        });
+        initialized.current = true;
+        if (trackPageviews) {
+            analytics.page();
+        }
+    }, [apiKey, host, debug, trackPageviews, config]);
+    useEffect(() => {
+        if (!trackPageviews)
+            return;
+        if (typeof window === "undefined")
+            return;
+        const handlePopState = () => {
+            import("../core/analytics").then(({ getAnalytics }) => {
+                getAnalytics()?.page();
+            });
+        };
+        window.addEventListener("popstate", handlePopState);
+        return () => window.removeEventListener("popstate", handlePopState);
+    }, [trackPageviews]);
+    return null;
+};
+//# sourceMappingURL=analytics.js.map

package/dist/react/analytics.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/react/analytics.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAmClD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EACzB,MAAM,EACN,IAAI,EACJ,KAAK,GAAG,KAAK,EACb,cAAc,GAAG,IAAI,EACrB,MAAM,GACU,EAAE,EAAE;IACpB,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAElC,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,WAAW,CAAC,OAAO;YAAE,OAAO;QAChC,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QAE1C,MAAM,cAAc,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC;QAE3E,IAAI,CAAC,cAAc,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CACX,oFAAoF,CACpF,CAAC;YACF,OAAO;QACR,CAAC;QAED,MAAM,SAAS,GAAG,aAAa,CAAC;YAC/B,MAAM,EAAE,cAAc;YACtB,IAAI;YACJ,KAAK;YACL,GAAG,MAAM;SACT,CAAC,CAAC;QAEH,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;QAE3B,IAAI,cAAc,EAAE,CAAC;YACpB,SAAS,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;IACF,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,cAAc;YAAE,OAAO;QAC5B,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QAE1C,MAAM,cAAc,GAAG,GAAG,EAAE;YAC3B,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;gBACrD,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC;YACxB,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACpD,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACrE,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IAErB,OAAO,IAAI,CAAC;AACb,CAAC,CAAC"}

package/dist/react/bug-report-widget.d.ts ADDED Viewed

@@ -0,0 +1,21 @@
+import type { BugReportWidgetOptions } from "../widget/bug-report";
+export interface BugReportFABProps extends BugReportWidgetOptions {
+}
+/**
+ * React component that mounts the bug report FAB widget.
+ *
+ * @example
+ * ```tsx
+ * import { BugReportFAB } from '@thisbefine/analytics/react';
+ *
+ * const App = () => (
+ *   <>
+ *     <Analytics apiKey="tbf_xxx" />
+ *     <MyApp />
+ *     <BugReportFAB position="bottom-right" />
+ *   </>
+ * );
+ * ```
+ */
+export declare const BugReportFAB: (props: BugReportFABProps) => null;
+//# sourceMappingURL=bug-report-widget.d.ts.map

package/dist/react/bug-report-widget.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"bug-report-widget.d.ts","sourceRoot":"","sources":["../../src/react/bug-report-widget.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAInE,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;CAAG;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,iBAAiB,SAepD,CAAC"}

package/dist/react/bug-report-widget.js ADDED Viewed

@@ -0,0 +1,34 @@
+"use client";
+import { useEffect, useRef } from "react";
+import { createBugReportWidget } from "../widget/bug-report";
+import { useAnalytics } from "./hooks";
+/**
+ * React component that mounts the bug report FAB widget.
+ *
+ * @example
+ * ```tsx
+ * import { BugReportFAB } from '@thisbefine/analytics/react';
+ *
+ * const App = () => (
+ *   <>
+ *     <Analytics apiKey="tbf_xxx" />
+ *     <MyApp />
+ *     <BugReportFAB position="bottom-right" />
+ *   </>
+ * );
+ * ```
+ */
+export const BugReportFAB = (props) => {
+    const analytics = useAnalytics();
+    const destroyRef = useRef(null);
+    useEffect(() => {
+        const widget = createBugReportWidget(analytics, props);
+        destroyRef.current = widget.destroy;
+        return () => {
+            widget.destroy();
+            destroyRef.current = null;
+        };
+    }, [analytics, props.position, props.buttonColor, props.buttonText, props]);
+    return null;
+};
+//# sourceMappingURL=bug-report-widget.js.map

package/dist/react/bug-report-widget.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"bug-report-widget.js","sourceRoot":"","sources":["../../src/react/bug-report-widget.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAwB,EAAE,EAAE;IACxD,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAC;IAErD,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACvD,UAAU,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAEpC,OAAO,GAAG,EAAE;YACX,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAE5E,OAAO,IAAI,CAAC;AACb,CAAC,CAAC"}

package/dist/react/hooks.d.ts ADDED Viewed

@@ -0,0 +1,141 @@
+import type { LogLevel } from "../core/logging";
+import type { AccountTraits, Analytics, UserTraits } from "../core/types";
+/**
+ * Hook to access the Analytics instance
+ *
+ * @throws Error if Analytics component has not been mounted
+ *
+ * @example
+ * ```tsx
+ * const analytics = useAnalytics();
+ *
+ * const handleClick = () => {
+ *   analytics.track('button_clicked', { buttonId: 'signup' });
+ * };
+ * ```
+ */
+export declare const useAnalytics: () => Analytics;
+/**
+ * Hook to get a memoized track function for a specific event
+ *
+ * This is useful for event handlers where you want to avoid
+ * creating new function references on each render.
+ *
+ * @param eventName - The name of the event to track
+ *
+ * @example
+ * ```tsx
+ * const trackSignup = useTrack('signup_clicked');
+ *
+ * return (
+ *   <button onClick={() => trackSignup({ location: 'header' })}>
+ *     Sign Up
+ *   </button>
+ * );
+ * ```
+ */
+export declare const useTrack: (eventName: string) => (properties?: Record<string, unknown>) => void;
+/**
+ * Hook to identify the current user
+ *
+ * Returns a memoized identify function.
+ *
+ * @example
+ * ```tsx
+ * const identify = useIdentify();
+ *
+ * // After login
+ * identify(user.id, {
+ *   email: user.email,
+ *   name: user.name,
+ *   plan: user.plan,
+ * });
+ * ```
+ */
+export declare const useIdentify: () => (userId: string, traits?: UserTraits) => void;
+/**
+ * Hook to associate the current user with an account/company
+ *
+ * Returns a memoized group function.
+ *
+ * @example
+ * ```tsx
+ * const group = useGroup();
+ *
+ * // After user selects workspace/company
+ * group(workspace.id, {
+ *   name: workspace.name,
+ *   plan: workspace.plan,
+ *   mrr: workspace.mrr,
+ * });
+ * ```
+ */
+export declare const useGroup: () => (accountId: string, traits?: AccountTraits) => void;
+/**
+ * Hook to track page views
+ *
+ * Returns a memoized page function.
+ *
+ * @example
+ * ```tsx
+ * const trackPage = usePage();
+ *
+ * useEffect(() => {
+ *   trackPage('/dashboard', { section: 'overview' });
+ * }, [trackPage]);
+ * ```
+ */
+export declare const usePage: () => (name?: string, properties?: Record<string, unknown>) => void;
+/**
+ * Hook to reset the analytics session (call on logout)
+ *
+ * @example
+ * ```tsx
+ * const resetAnalytics = useReset();
+ *
+ * const handleLogout = () => {
+ *   resetAnalytics();
+ *   // ... other logout logic
+ * };
+ * ```
+ */
+export declare const useReset: () => () => void;
+/**
+ * Hook to get the current user state
+ *
+ * @example
+ * ```tsx
+ * const getUser = useGetUser();
+ *
+ * const handleDebug = () => {
+ *   console.log(getUser());
+ *   // { anonymousId: '...', userId: '...', traits: { ... } }
+ * };
+ * ```
+ */
+export declare const useGetUser: () => () => import("..").UserState | undefined;
+/**
+ * Hook to capture exceptions
+ *
+ * @example
+ * ```tsx
+ * const captureException = useCaptureException();
+ *
+ * try { ... } catch (error) {
+ *   captureException(error as Error, { component: 'Checkout' });
+ * }
+ * ```
+ */
+export declare const useCaptureException: () => (error: Error, context?: Record<string, unknown>) => void;
+/**
+ * Hook to send structured log events
+ *
+ * @example
+ * ```tsx
+ * const log = useLog();
+ *
+ * log('User completed onboarding', 'info', { step: 3 });
+ * ```
+ */
+export declare const useLog: () => (message: string, level: LogLevel, metadata?: Record<string, unknown>) => void;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/react/hooks.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/react/hooks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAiB1E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,QAAO,SAE/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,MAAM,mBAE1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAKtC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,iBACK,MAAM,WAAW,UAAU,SAGvD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,oBACW,MAAM,WAAW,aAAa,SAG7D,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,gBACQ,MAAM,eAAe,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAGvE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,kBAIpB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,gDAItB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,gBACJ,KAAK,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAGnE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,kBAEP,MAAM,SAAS,QAAQ,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAKtE,CAAC"}