@faststats/react 0.10.3 → 0.12.0

package/README.md

@@ -40,3 +40,29 @@ export function FastStats() {
 	);
 }
 ```
+
+### Feature flags
+
+```tsx
+"use client";
+
+import { Analytics } from "@faststats/react";
+import { featureFlags, useFlag } from "@faststats/react/flags";
+
+const flags = featureFlags({ flags: ["new-checkout", "max-uploads"] });
+
+export function FastStats() {
+	return <Analytics siteKey="site_123" extensions={[flags]} />;
+}
+
+export function Checkout() {
+	const newCheckout = useFlag("new-checkout", false);
+	return newCheckout ? <NewCheckout /> : <OldCheckout />;
+}
+```
+
+`useFlag` returns the default during server rendering and until flags have
+loaded, then re-renders with the flag's value. `useIdentify` and `useLogout`
+re-evaluate flags for the new user. `useFeatureFlags()` returns the running
+instance for `status`, `details()`, `setContext()` and `reload()`; see
+[`@faststats/web`](../core/README.md#feature-flags) for the options.

package/dist/flags.d.ts

@@ -0,0 +1,21 @@
+import { FeatureFlagReason, FeatureFlagResult, FeatureFlags as FeatureFlags$1, FeatureFlagsContext, FeatureFlagsOptions, FeatureFlagsOptions as FeatureFlagsOptions$1, FeatureFlagsStatus } from "@faststats/web/flags";
+//#region src/flags.d.ts
+/** Feature flags that the hooks read once `<Analytics>` has started them. */
+export declare class FeatureFlags extends FeatureFlags$1 {
+  setup(...args: Parameters<FeatureFlags$1["setup"]>): (options: {
+    discard: boolean;
+  }) => void;
+}
+export declare function featureFlags(options?: FeatureFlagsOptions$1): FeatureFlags;
+/**
+ * The flag's value, or `defaultValue` while flags are loading, during server
+ * rendering, and when the flag does not exist or has another type.
+ */
+export declare function useFlag(key: string, defaultValue: boolean): boolean;
+export declare function useFlag(key: string, defaultValue: string): string;
+export declare function useFlag(key: string, defaultValue: number): number;
+export declare function useFlag<T>(key: string, defaultValue: T): T;
+/** The running flags instance, re-rendering whenever flags or status change. */
+export declare function useFeatureFlags(): FeatureFlags | null;
+//#endregion
+export type { FeatureFlagReason, FeatureFlagResult, FeatureFlagsContext, FeatureFlagsOptions, FeatureFlagsStatus };

package/dist/flags.js

@@ -0,0 +1,45 @@
+"use client";
+import { useSyncExternalStore } from "react";
+import { FeatureFlags as FeatureFlags$1 } from "@faststats/web/flags";
+//#region src/flags.ts
+let active = null;
+let version = 0;
+const listeners = /* @__PURE__ */ new Set();
+function notify() {
+	version++;
+	for (const l of listeners) l();
+}
+function subscribe(onStoreChange) {
+	listeners.add(onStoreChange);
+	return () => {
+		listeners.delete(onStoreChange);
+	};
+}
+/** Feature flags that the hooks read once `<Analytics>` has started them. */
+var FeatureFlags = class extends FeatureFlags$1 {
+	setup(...args) {
+		const cleanup = super.setup(...args);
+		const off = this.subscribe(notify);
+		active = this;
+		notify();
+		return (options) => {
+			cleanup(options);
+			off();
+			if (active === this) active = null;
+			notify();
+		};
+	}
+};
+function featureFlags(options = {}) {
+	return new FeatureFlags(options);
+}
+function useFlag(key, defaultValue) {
+	return useSyncExternalStore(subscribe, () => active ? active.get(key, defaultValue) : defaultValue, () => defaultValue);
+}
+/** The running flags instance, re-rendering whenever flags or status change. */
+function useFeatureFlags() {
+	useSyncExternalStore(subscribe, () => version, () => 0);
+	return active;
+}
+//#endregion
+export { FeatureFlags, featureFlags, useFeatureFlags, useFlag };

package/dist/index.js

@@ -20,7 +20,7 @@ function setInstance(wa) {
 //#endregion
 //#region src/analytics.tsx
 const SDK_NAME = "@faststats/react";
-const SDK_VERSION = "0.10.3";
+const SDK_VERSION = "0.12.0";
 function Analytics(props) {
 	const ownedRef = useRef(null);
 	const propsRef = useRef(props);

package/package.json

@@ -4,7 +4,7 @@
 		"type": "git",
 		"url": "https://github.com/faststats-dev/faststats-javascript.git"
 	},
-	"version": "0.10.3",
+	"version": "0.12.0",
 	"type": "module",
 	"main": "./dist/index.js",
 	"module": "./dist/index.js",
@@ -19,16 +19,16 @@
 			"import": "./dist/index.js",
 			"default": "./dist/index.js"
 		},
-		"./outbound-links": {
-			"types": "./dist/outbound-links.d.ts",
-			"import": "./dist/outbound-links.js",
-			"default": "./dist/outbound-links.js"
-		},
 		"./error": {
 			"types": "./dist/error.d.ts",
 			"import": "./dist/error.js",
 			"default": "./dist/error.js"
 		},
+		"./flags": {
+			"types": "./dist/flags.d.ts",
+			"import": "./dist/flags.js",
+			"default": "./dist/flags.js"
+		},
 		"./web-vitals": {
 			"types": "./dist/web-vitals.d.ts",
 			"import": "./dist/web-vitals.js",
@@ -51,10 +51,10 @@
 		"react": ">=18"
 	},
 	"dependencies": {
-		"@faststats/web": "^0.10.3"
+		"@faststats/web": "^0.12.0"
 	},
 	"devDependencies": {
-		"@types/node": "^26.6.2",
+		"@types/node": "^26.6.4",
 		"@types/react": "^19.3.0",
 		"react": "^19.3.0",
 		"tsdown": "^0.23.0",

package/dist/outbound-links.d.ts

@@ -1,2 +0,0 @@
-import { outboundLinks } from "@faststats/web/outbound-links";
-export { outboundLinks };

package/dist/outbound-links.js

@@ -1,3 +0,0 @@
-"use client";
-import { outboundLinks } from "@faststats/web/outbound-links";
-export { outboundLinks };