keystone-design-bootstrap 1.0.69 → 1.0.71

package/src/tracking/PostHogProvider.tsx

@@ -14,6 +14,12 @@ export type PostHogProviderProps = {
   accountId?: number;
   /** Keystone account name (company_name) — attached to every event as a super property. */
   accountName?: string;
+  /**
+   * Environment identifier from KEYSTONE_ENV on the Rails server (e.g. "production", "staging",
+   * "development"). Registered as a super property so events can be filtered by environment
+   * in PostHog and the sync job only imports data for the matching environment.
+   */
+  environment?: string;
   children: React.ReactNode;
 };
 
@@ -102,7 +108,7 @@ function PostHogPageviewTracker() {
  * Mount once in the root layout body. One project key covers all customer
  * sites — filter by account_name or site_domain in the PostHog dashboard.
  */
-export function PostHogProvider({ apiKey, apiHost, accountId, accountName, children }: PostHogProviderProps) {
+export function PostHogProvider({ apiKey, apiHost, accountId, accountName, environment, children }: PostHogProviderProps) {
   useEffect(() => {
     posthog.init(apiKey, {
       api_host: apiHost ?? DEFAULT_HOST,
@@ -113,9 +119,10 @@ export function PostHogProvider({ apiKey, apiHost, accountId, accountName, child
     posthog.register({
       ...(accountId !== undefined && { account_id: accountId }),
       ...(accountName && { account_name: accountName }),
+      ...(environment && { environment }),
       site_domain: window.location.hostname,
     });
-  }, [apiKey, apiHost, accountId, accountName]);
+  }, [apiKey, apiHost, accountId, accountName, environment]);
 
   return (
     <PHProvider client={posthog}>