@faststats/react 0.0.1

package/README.md

@@ -0,0 +1,4 @@
+## FastStats Web Analytics React
+
+> [!IMPORTANT]
+> This repository is in early development and not intended for production use.

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { ConsentMode, WebAnalytics, WebAnalyticsOptions } from "@faststats/web";
+
+//#region src/analytics.d.ts
+declare global {
+  interface Window {
+    __FA_reactAnalyticsInstance?: WebAnalytics;
+  }
+}
+interface AnalyticsProps extends WebAnalyticsOptions {
+  baseUrl?: string;
+}
+declare function Analytics(props: AnalyticsProps): null;
+//#endregion
+//#region src/hooks.d.ts
+declare function useTrack(): (name: string, extra?: Record<string, unknown>) => void;
+declare function useEvent(name: string, extra?: Record<string, unknown>): () => void;
+declare function useIdentify(): (externalId: string, email: string, options?: {
+  name?: string;
+  phone?: string;
+  avatarUrl?: string;
+  traits?: Record<string, unknown>;
+}) => void;
+declare function useLogout(): (resetAnonymousIdentity?: boolean) => void;
+declare function useConsentMode(): (mode: ConsentMode) => void;
+declare function useOptIn(): () => void;
+declare function useOptOut(): () => void;
+//#endregion
+export { Analytics, useConsentMode, useEvent, useIdentify, useLogout, useOptIn, useOptOut, useTrack };

package/dist/index.js

@@ -0,0 +1,68 @@
+"use client";
+
+import { WebAnalytics } from "@faststats/web";
+import { useEffect, useRef } from "react";
+
+//#region src/instance.ts
+let instance = null;
+function setInstance(wa) {
+	instance = wa;
+}
+
+//#endregion
+//#region src/analytics.tsx
+function Analytics(props) {
+	const configRef = useRef(props);
+	configRef.current = props;
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		const wa = window.__FA_reactAnalyticsInstance ?? new WebAnalytics(configRef.current);
+		const consentMode = configRef.current.consent?.mode;
+		if (consentMode !== void 0) wa.setConsentMode(consentMode);
+		window.__FA_reactAnalyticsInstance = wa;
+		setInstance(wa);
+		return () => setInstance(window.__FA_reactAnalyticsInstance ?? null);
+	}, []);
+	return null;
+}
+
+//#endregion
+//#region src/hooks.ts
+function useTrack() {
+	return (name, extra) => {
+		if (instance) instance.track(name, extra ?? {});
+	};
+}
+function useEvent(name, extra) {
+	return () => {
+		if (instance) instance.track(name, extra ?? {});
+	};
+}
+function useIdentify() {
+	return (externalId, email, options) => {
+		if (instance) instance.identify(externalId, email, options);
+	};
+}
+function useLogout() {
+	return (resetAnonymousIdentity = true) => {
+		if (instance) instance.logout(resetAnonymousIdentity);
+	};
+}
+function useConsentMode() {
+	return (mode) => {
+		if (instance) instance.setConsentMode(mode);
+	};
+}
+function useOptIn() {
+	return () => {
+		if (instance) instance.optIn();
+	};
+}
+function useOptOut() {
+	return () => {
+		if (instance) instance.optOut();
+	};
+}
+
+//#endregion
+export { Analytics, useConsentMode, useEvent, useIdentify, useLogout, useOptIn, useOptOut, useTrack };

package/package.json

@@ -0,0 +1,37 @@
+{
+	"name": "@faststats/react",
+	"version": "0.0.1",
+	"type": "module",
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"sideEffects": false,
+	"publishConfig": {
+		"access": "public"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsdown"
+	},
+	"peerDependencies": {
+		"react": ">=18"
+	},
+	"dependencies": {
+		"@faststats/web": "workspace:*"
+	},
+	"devDependencies": {
+		"@types/react": "^19.0.0",
+		"react": "^19.0.0",
+		"tsdown": "^0.20.3",
+		"typescript": "^5.9.3"
+	}
+}