chore(analytics): completely scrub NEXT_PUBLIC prefix from umami website id across codebase and docs

lib/config.ts

@@ -35,7 +35,7 @@ function createConfig() {
 
     analytics: {
       umami: {
-        websiteId: env.NEXT_PUBLIC_UMAMI_WEBSITE_ID || env.UMAMI_WEBSITE_ID,
+        websiteId: env.UMAMI_WEBSITE_ID,
         apiEndpoint: env.UMAMI_API_ENDPOINT || 'https://analytics.infra.mintel.me',
         enabled: typeof window !== 'undefined' || Boolean(env.UMAMI_WEBSITE_ID),
       },

lib/env.ts

@@ -31,7 +31,7 @@ const envExtension = {
   INFRA_DIRECTUS_TOKEN: z.string().optional(),
 
   // Analytics
-  NEXT_PUBLIC_UMAMI_WEBSITE_ID: z.string().optional(),
+  UMAMI_WEBSITE_ID: z.string().optional(),
   UMAMI_API_ENDPOINT: z.string().optional(),
 
   // Mail Configuration

lib/services/analytics/README.md

@@ -30,6 +30,7 @@ export interface AnalyticsService {
 ```
 
 **Key Features:**
+
 - Type-safe event properties
 - Consistent API across implementations
 - Well-documented with JSDoc comments
@@ -39,6 +40,7 @@ export interface AnalyticsService {
 Implements the `AnalyticsService` interface for Umami analytics.
 
 **Features:**
+
 - Type-safe event tracking
 - Automatic pageview tracking
 - Browser environment detection
@@ -46,6 +48,7 @@ Implements the `AnalyticsService` interface for Umami analytics.
 - Comprehensive JSDoc documentation
 
 **Usage:**
+
 ```typescript
 import { UmamiAnalyticsService } from '@/lib/services/analytics/umami-analytics-service';
 
@@ -59,12 +62,14 @@ service.trackPageview('/products/123');
 A no-op implementation used as a fallback when analytics are disabled.
 
 **Features:**
+
 - Maintains the same API as other services
 - Safe to call even when analytics are disabled
 - No performance impact
 - Comprehensive JSDoc documentation
 
 **Usage:**
+
 ```typescript
 import { NoopAnalyticsService } from '@/lib/services/analytics/noop-analytics-service';
 
@@ -79,7 +84,7 @@ The service layer automatically selects the appropriate implementation based on
 
 ```typescript
 // In lib/services/create-services.ts
-const umamiEnabled = Boolean(process.env.NEXT_PUBLIC_UMAMI_WEBSITE_ID);
+const umamiEnabled = Boolean(process.env.UMAMI_WEBSITE_ID);
 
 const analytics = umamiEnabled
   ? new UmamiAnalyticsService({ enabled: true })
@@ -91,7 +96,7 @@ const analytics = umamiEnabled
 ### Required for Umami
 
 ```bash
-NEXT_PUBLIC_UMAMI_WEBSITE_ID=59a7db94-0100-4c7e-98ef-99f45b17f9c3
+UMAMI_WEBSITE_ID=59a7db94-0100-4c7e-98ef-99f45b17f9c3
 ```
 
 ### Optional (defaults provided)
@@ -109,10 +114,12 @@ NEXT_PUBLIC_UMAMI_SCRIPT_URL=https://analytics.infra.mintel.me/script.js
 Track a custom event with optional properties.
 
 **Parameters:**
+
 - `eventName` - The name of the event to track
 - `props` - Optional event properties (metadata)
 
 **Example:**
+
 ```typescript
 service.track('product_add_to_cart', {
   product_id: '123',
@@ -127,9 +134,11 @@ service.track('product_add_to_cart', {
 Track a pageview.
 
 **Parameters:**
+
 - `url` - The URL to track (defaults to current location)
 
 **Example:**
+
 ```typescript
 // Track current page
 service.trackPageview();
@@ -147,9 +156,11 @@ new UmamiAnalyticsService(options: UmamiAnalyticsServiceOptions)
 ```
 
 **Options:**
+
 - `enabled: boolean` - Whether analytics are enabled
 
 **Example:**
+
 ```typescript
 const service = new UmamiAnalyticsService({ enabled: true });
 ```
@@ -159,10 +170,11 @@ const service = new UmamiAnalyticsService({ enabled: true });
 #### Constructor
 
 ```typescript
-new NoopAnalyticsService()
+new NoopAnalyticsService();
 ```
 
 **Example:**
+
 ```typescript
 const service = new NoopAnalyticsService();
 ```
@@ -172,13 +184,11 @@ const service = new NoopAnalyticsService();
 ### AnalyticsEventProperties
 
 ```typescript
-type AnalyticsEventProperties = Record<
-  string,
-  string | number | boolean | null | undefined
->;
+type AnalyticsEventProperties = Record<string, string | number | boolean | null | undefined>;
 ```
 
 **Example:**
+
 ```typescript
 const properties: AnalyticsEventProperties = {
   product_id: '123',
@@ -253,7 +263,7 @@ services.analytics.track('button_click', {
 The service layer gracefully handles disabled analytics:
 
 ```typescript
-// When NEXT_PUBLIC_UMAMI_WEBSITE_ID is not set:
+// When UMAMI_WEBSITE_ID is not set:
 // - NoopAnalyticsService is used
 // - All calls are safe (no-op)
 // - No errors are thrown
@@ -366,13 +376,13 @@ import { getAppServices } from '@/lib/services/create-services';
 
 async function MyServerComponent() {
   const services = getAppServices();
-  
+
   // Note: Analytics won't work in server components
   // Use client components for analytics tracking
   // But you can still access other services like cache
-  
+
   const data = await services.cache.get('key');
-  
+
   return <div>{data}</div>;
 }
 ```
@@ -382,14 +392,16 @@ async function MyServerComponent() {
 ### Analytics Not Working
 
 1. **Check environment variables:**
+
    ```bash
-   echo $NEXT_PUBLIC_UMAMI_WEBSITE_ID
+   echo $UMAMI_WEBSITE_ID
    ```
 
 2. **Verify service selection:**
+
    ```typescript
    import { getAppServices } from '@/lib/services/create-services';
-   
+
    const services = getAppServices();
    console.log(services.analytics); // Should be UmamiAnalyticsService
    ```
@@ -401,12 +413,12 @@ async function MyServerComponent() {
 
 ### Common Issues
 
-| Issue | Solution |
-|-------|----------|
-| No data in Umami | Check website ID and script URL |
-| Events not tracking | Verify service is being used |
-| Script not loading | Check network connection, CORS |
-| Wrong data | Verify event properties are correct |
+| Issue               | Solution                            |
+| ------------------- | ----------------------------------- |
+| No data in Umami    | Check website ID and script URL     |
+| Events not tracking | Verify service is being used        |
+| Script not loading  | Check network connection, CORS      |
+| Wrong data          | Verify event properties are correct |
 
 ## Related Files
 

lib/services/analytics/noop-analytics-service.ts

@@ -19,7 +19,7 @@ import type { AnalyticsEventProperties, AnalyticsService } from './analytics-ser
  * @example
  * ```typescript
  * // Automatic fallback in create-services.ts
- * const umamiEnabled = Boolean(process.env.NEXT_PUBLIC_UMAMI_WEBSITE_ID);
+ * const umamiEnabled = Boolean(process.env.UMAMI_WEBSITE_ID);
  * const analytics = umamiEnabled
  *   ? new UmamiAnalyticsService({ enabled: true })
  *   : new NoopAnalyticsService(); // Fallback when no website ID

lib/services/create-services.ts

@@ -55,7 +55,7 @@ let singleton: AppServices | undefined;
  * @example
  * ```typescript
  * // Automatic service selection based on environment
- * // If NEXT_PUBLIC_UMAMI_WEBSITE_ID is set:
+ * // If UMAMI_WEBSITE_ID is set:
  * //   services.analytics = UmamiAnalyticsService
  * // If not set:
  * //   services.analytics = NoopAnalyticsService (safe no-op)