@healthya-team/pharmacy-analytics 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Healthya Engineering Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,244 @@
-# Temporary Holding Version
+# @healthya-team/pharmacy-analytics
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Unified Pharmacy Analytics Platform**  
+> Consolidates Google Analytics 4 (GA4), Mixpanel patient funnels, and Google Search Console into a single high-performance library with Next.js App Router handlers and a Sanity Studio dashboard.
+
+---
+
+## 🌟 Key Features
+
+1. **Centralized Tab Switcher (Center of the Page)**
+   - **All (Default)**: Consolidated executive overview combining Google Organic Search, visitor metrics, and patient pre-consultation & prescription order conversion funnels. Displays all three groups in the sidebar simultaneously (as in the Highfield package).
+   - **Analytics**: Dedicated Google Analytics 4 views (Overview, Traffic, Content, Audience, Geography, Events, Acquisition).
+   - **Custom Analytics**: Healthcare journey funnels (Pre-Consult funnel steps, drop-offs, PM Funnel, Conditions & Products overview).
+   - **Search Console**: Google organic search performance (Top queries, landing pages, rankings, devices, countries, search appearance, and sitemaps).
+
+2. **Unified Google Cloud Auth**
+   - Single Google Service Account (`GA_SERVICE_ACCOUNT_EMAIL` + `GA_PRIVATE_KEY`) signs RS256 JWTs using `jose` with in-memory token caching.
+   - Authorizes both **GA4 Data API** (`analytics.readonly`) and **Google Search Console API** (`webmasters`).
+
+3. **Subpath Exports**
+   - `@healthya-team/pharmacy-analytics/client`: Consent-aware GA4 script, Mixpanel initializer, route tracking provider, and typed healthcare event trackers.
+   - `@healthya-team/pharmacy-analytics/server`: Next.js App Router route handlers serving GA4 and Search Console.
+   - `@healthya-team/pharmacy-analytics/studio`: Sanity Studio plugin and standalone `<PharmacyAnalyticsDashboard />` component.
+
+---
+
+## 📦 Installation
+
+In your Next.js and Sanity project:
+
+```bash
+# If linking locally or in a pnpm monorepo:
+pnpm add @healthya-team/pharmacy-analytics
+
+# Or using relative package reference:
+# "dependencies": { "@healthya-team/pharmacy-analytics": "workspace:*" }
+```
+
+---
+
+## ⚙️ Environment Configuration
+
+Add the following environment variables to your `.env.local`:
+
+```bash
+# ── Google Analytics 4 ──
+NEXT_PUBLIC_GA_MEASUREMENT_ID=G-XXXXXXXXXX
+GA_PROPERTY_ID=123456789
+
+# ── Google Search Console ──
+SEARCH_CONSOLE_SITE_URL=https://your-pharmacy-website.co.uk
+
+# ── Google Service Account (Shared by GA4 & Search Console) ──
+GA_SERVICE_ACCOUNT_EMAIL=pharmacy-analytics-sa@project.iam.gserviceaccount.com
+GA_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQC...\n-----END PRIVATE KEY-----\n"
+
+# ── Mixpanel (Optional / Pre-Consult Funnels) ──
+NEXT_PUBLIC_MIXPANEL_TOKEN=your_mixpanel_project_token
+```
+
+> **Note on Permissions:**
+> - In **Google Analytics Admin → Property Access Management**, grant your service account email the **Viewer** role.
+> - In **Google Search Console → Settings → Users and permissions**, add your service account email with **Full** or **Owner** permission.
+
+---
+
+## 🚀 Usage
+
+### 1. Unified Next.js API Route Handler
+
+Create `app/api/analytics/route.ts` in your Next.js application:
+
+```typescript
+// app/api/analytics/route.ts
+export { GET, POST } from '@healthya-team/pharmacy-analytics/server'
+
+export const dynamic = 'force-dynamic'
+```
+
+*That's it!* This single route automatically handles:
+- GA4 multi-reports (`/api/analytics?range=30`)
+- GA4 custom dimensions (`?mode=event-params`, `?mode=condition-values`, `?mode=top-entities`)
+- Search Console queries (`?mode=search-console&range=28`)
+- Search Console sitemap submissions via `POST`
+
+---
+
+### 2. Client-Side Tracking & Providers
+
+Add the tracking provider to your root layout (`app/layout.tsx`):
+
+```tsx
+// app/layout.tsx
+import {
+  AnalyticsProvider,
+  GaScript,
+  MixpanelInit,
+} from '@healthya-team/pharmacy-analytics/client'
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <head>
+        <GaScript defaultConsent="denied" />
+        <MixpanelInit />
+      </head>
+      <body>
+        <AnalyticsProvider>
+          {children}
+        </AnalyticsProvider>
+      </body>
+    </html>
+  )
+}
+```
+
+#### Firing Healthcare & Pharmacy Events:
+
+```typescript
+import {
+  trackConditionViewed,
+  trackEligibilityChecked,
+  trackStartAssessmentClicked,
+  trackQuestionnaireFlowStep,
+  trackOrderSuccess,
+} from '@healthya-team/pharmacy-analytics/client'
+
+// When a patient views a clinical condition
+trackConditionViewed('Weight Loss', 'weight-loss')
+
+// When patient checks eligibility
+trackEligibilityChecked({
+  conditionName: 'Weight Loss',
+  status: 'eligible',
+  isNhs: false,
+})
+
+// When patient clicks start assessment
+trackStartAssessmentClicked('Weight Loss')
+
+// When patient completes questionnaire step
+trackQuestionnaireFlowStep({
+  step: 'questionnaire_submitted',
+  userJourneyFlow: 'appointment_booking',
+  conditionName: 'Weight Loss',
+})
+
+// When patient completes order
+trackOrderSuccess({
+  orderId: 'ORD-12345',
+  productName: 'Mounjaro 2.5mg',
+  conditionName: 'Weight Loss',
+  total: 149.00,
+})
+```
+
+---
+
+### 3. Sanity Studio Dashboard Integration
+
+Add the plugin to your `sanity.config.ts`:
+
+```typescript
+// sanity.config.ts
+import { defineConfig } from 'sanity'
+import { pharmacyAnalyticsPlugin } from '@healthya-team/pharmacy-analytics/studio'
+
+export default defineConfig({
+  name: 'default',
+  title: 'Pharmacy Studio',
+  projectId: 'your-project-id',
+  dataset: 'production',
+  plugins: [
+    pharmacyAnalyticsPlugin({
+      apiUrl: '/api/analytics',
+      title: 'Highfield Analytics',
+    }),
+  ],
+})
+```
+
+#### Or use the React component standalone:
+
+```tsx
+import { PharmacyAnalyticsDashboard } from '@healthya-team/pharmacy-analytics/studio'
+
+export default function AdminAnalyticsPage() {
+  return (
+    <PharmacyAnalyticsDashboard
+      apiUrl="/api/analytics"
+      brandName="Highfield Pharmacy"
+    />
+  )
+}
+```
+
+---
+
+## 🖥️ Dashboard Architecture & Tab Navigation
+
+```
+┌────────────────────────────────────────────────────────────────────────────────────────┐
+│ [H] Highfield Analytics        [ All | Analytics | Custom Analytics | Search Console ]  [7d|14d|30d|90d] [Refresh]│
+├─────────────────────────┬──────────────────────────────────────────────────────────────┤
+│ ▦ Executive Overview    │  EXECUTIVE SUMMARY BANNER & LIVE ACTIVE VISITORS             │
+│                         │                                                              │
+│ ▾ GOOGLE ANALYTICS      │  KPIs: Organic Clicks | Impressions | Visitors | Pre-Consult │
+│   ▦ Overview            │                                                              │
+│   ↗ Traffic             │  [Explore GA4]     [Explore Funnels]    [Explore Search]     │
+│   ≡ Content             │                                                              │
+│   ◉ Audience            │  CHARTS:                                                     │
+│   ⊕ Geography           │  • Google Search Daily Trend (Clicks & Impressions)          │
+│   ⚡ Events             │  • Website Visitors & Sessions Daily Trend                   │
+│   ⤴ Acquisition         │                                                              │
+│                         │  TABLES:                                                     │
+│ ▾ CUSTOM ANALYTICS      │  • Top Google Organic Queries (Clicks & Rankings)            │
+│   🧬 Overview           │  • Top Visited Pages (Views & Visitors)                      │
+│   ⬡ Pre Consult Events  │                                                              │
+│   💊 PM Funnel Events   │                                                              │
+│                         │                                                              │
+│ ▾ SEARCH CONSOLE        │                                                              │
+│   ◎ Overview            │                                                              │
+│   🔍 Top Queries        │                                                              │
+│   📄 Top Pages          │                                                              │
+│   🌐 Countries          │                                                              │
+│   📱 Devices            │                                                              │
+│   ✨ Appearance         │                                                              │
+│   🗺️ Sitemaps           │                                                              │
+└─────────────────────────┴──────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🛠️ Build & Verification
+
+```bash
+# Type check without emitting
+pnpm typecheck
+
+# Build ESM & CJS bundles + d.ts files
+pnpm build
+```
+
+Built with ❤️ by Healthya Engineering Team.

package/dist/client/index.d.mts

@@ -0,0 +1,215 @@
+import react__default from 'react';
+
+declare global {
+    interface Window {
+        gtag: (...args: unknown[]) => void;
+        dataLayer: unknown[];
+    }
+}
+/**
+ * Fires an analytics event to GA4 (via gtag) and Mixpanel in parallel.
+ * No-ops server-side. GA4 is skipped when gtag is unavailable (e.g. consent denied).
+ */
+declare function trackEvent(eventName: string, params?: Record<string, unknown>): void;
+declare function trackPageView(pagePath: string, pageTitle: string): void;
+interface ConditionTrackingParams {
+    condition_slug: string;
+    condition_name: string;
+    condition_id: string | number;
+    branch_corporate_id?: string | number;
+    source?: string;
+    is_pre_consult: boolean;
+    is_private_medication: boolean;
+}
+declare function trackConditionViewed(params: ConditionTrackingParams): void;
+interface StartAssessmentClickedParams {
+    eligibility_status: 'passed' | 'failed';
+    is_nhs: boolean;
+    gender: string;
+    date_of_birth: string;
+    condition_id: string | number;
+    condition_name: string;
+    branch_corporate_id?: string | number;
+}
+declare function trackStartAssessmentClicked(params: StartAssessmentClickedParams): void;
+interface EligibilityCheckedParams {
+    status: 'passed' | 'failed';
+    gender: string;
+    date_of_birth: string;
+    condition_name: string;
+    condition_id: string | number;
+    branch_corporate_id?: string | number;
+}
+declare function trackEligibilityChecked(params: EligibilityCheckedParams): void;
+interface QuestionnaireFlowStepParams {
+    step: string;
+    condition_token: string;
+    condition_id: string | number;
+    condition_name: string;
+    user_journey_flow: string;
+    branch_corporate_id?: string | number;
+}
+declare function trackQuestionnaireFlowStep(params: QuestionnaireFlowStepParams): void;
+interface ProductTrackingParams {
+    product_slug: string;
+    product_name: string;
+    product_id: string | number;
+    core_drug_id?: number;
+    branch_corporate_id?: string | number;
+    condition_id?: string | number;
+    condition_name?: string;
+    source?: string;
+    category_type?: string;
+}
+declare function trackProductViewed(params: ProductTrackingParams): void;
+interface GetTreatmentClickedParams {
+    product_slug: string;
+    product_name: string;
+    category_type?: string;
+    product_id: string | number;
+    core_drug_id?: number;
+    branch_corporate_id?: string | number;
+    condition_id?: string | number;
+    condition_name?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+    button_origin?: string;
+}
+declare function trackGetTreatmentClicked(params: GetTreatmentClickedParams): void;
+interface PMStartAssessmentClickedParams {
+    branch_corporate_id?: string | number;
+    condition_id?: string | number;
+    condition_name?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackPMStartAssessmentClicked(params: PMStartAssessmentClickedParams): void;
+interface AuthCompletedParams {
+    method: 'signup' | 'signin' | 'guest' | 'already_logged_in';
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    formulary?: string;
+    product_name?: string;
+    user_name?: string;
+    user_email?: string;
+    user_gender?: string;
+    user_phone?: string;
+    user_dob?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackAuthCompleted(params: AuthCompletedParams): void;
+interface QuestionnairePmParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    branch_corporate_id?: string | number;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackQuestionnairePm(params: QuestionnairePmParams): void;
+interface CartViewedParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    cart_item_count?: number;
+    cart_total_price?: number;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+    /** 'signed_in' when user is authenticated, 'guest' when browsing as a guest */
+    cart_auth_status?: 'signed_in' | 'guest';
+}
+declare function trackCartViewed(params: CartViewedParams): void;
+interface CheckoutStartedParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    cart_item_count?: number;
+    cart_total_price?: number;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackCheckoutStarted(params: CheckoutStartedParams): void;
+interface OrderSuccessParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    order_id?: string | number;
+    cart_item_count?: number;
+    cart_total_price?: number;
+    payment_mode?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackOrderSuccess(params: OrderSuccessParams): void;
+interface CartAuthCompletedParams {
+    method: 'signup' | 'signin' | 'guest';
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    user_name?: string;
+    user_email?: string;
+    user_gender?: string;
+    user_phone?: string;
+    user_dob?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackCartAuthCompleted(params: CartAuthCompletedParams): void;
+interface ProductSelectedParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    branch_corporate_id?: string | number;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackProductSelected(params: ProductSelectedParams): void;
+interface ConditionSearchedParams {
+    search_term: string;
+    results_count: number;
+    source: 'hero' | 'nav' | 'mobile_nav' | 'page';
+}
+declare function trackConditionSearched(params: ConditionSearchedParams): void;
+interface ProductSearchedParams {
+    search_term: string;
+    results_count: number;
+}
+declare function trackProductSearched(params: ProductSearchedParams): void;
+
+interface GaScriptProps {
+    measurementId?: string | null;
+}
+/**
+ * Injects the GA4 gtag.js script globally in Next.js layout.
+ *
+ * Loaded with `beforeInteractive` priority so `gtag` is always available.
+ * Consent is initialized as DENIED by default until user accepts cookies.
+ */
+declare function GaScript({ measurementId }: GaScriptProps): react__default.JSX.Element | null;
+
+interface MixpanelInitProps {
+    token?: string | null;
+}
+declare function MixpanelInit({ token }?: MixpanelInitProps): null;
+
+declare function AnalyticsProvider({ children }: {
+    children: react__default.ReactNode;
+}): react__default.JSX.Element;
+
+export { AnalyticsProvider, type AuthCompletedParams, type CartAuthCompletedParams, type CartViewedParams, type CheckoutStartedParams, type ConditionSearchedParams, type ConditionTrackingParams, type EligibilityCheckedParams, GaScript, type GaScriptProps, type GetTreatmentClickedParams, MixpanelInit, type MixpanelInitProps, type OrderSuccessParams, type PMStartAssessmentClickedParams, type ProductSearchedParams, type ProductSelectedParams, type ProductTrackingParams, type QuestionnaireFlowStepParams, type QuestionnairePmParams, type StartAssessmentClickedParams, trackAuthCompleted, trackCartAuthCompleted, trackCartViewed, trackCheckoutStarted, trackConditionSearched, trackConditionViewed, trackEligibilityChecked, trackEvent, trackGetTreatmentClicked, trackOrderSuccess, trackPMStartAssessmentClicked, trackPageView, trackProductSearched, trackProductSelected, trackProductViewed, trackQuestionnaireFlowStep, trackQuestionnairePm, trackStartAssessmentClicked };

package/dist/client/index.d.ts

@@ -0,0 +1,215 @@
+import react__default from 'react';
+
+declare global {
+    interface Window {
+        gtag: (...args: unknown[]) => void;
+        dataLayer: unknown[];
+    }
+}
+/**
+ * Fires an analytics event to GA4 (via gtag) and Mixpanel in parallel.
+ * No-ops server-side. GA4 is skipped when gtag is unavailable (e.g. consent denied).
+ */
+declare function trackEvent(eventName: string, params?: Record<string, unknown>): void;
+declare function trackPageView(pagePath: string, pageTitle: string): void;
+interface ConditionTrackingParams {
+    condition_slug: string;
+    condition_name: string;
+    condition_id: string | number;
+    branch_corporate_id?: string | number;
+    source?: string;
+    is_pre_consult: boolean;
+    is_private_medication: boolean;
+}
+declare function trackConditionViewed(params: ConditionTrackingParams): void;
+interface StartAssessmentClickedParams {
+    eligibility_status: 'passed' | 'failed';
+    is_nhs: boolean;
+    gender: string;
+    date_of_birth: string;
+    condition_id: string | number;
+    condition_name: string;
+    branch_corporate_id?: string | number;
+}
+declare function trackStartAssessmentClicked(params: StartAssessmentClickedParams): void;
+interface EligibilityCheckedParams {
+    status: 'passed' | 'failed';
+    gender: string;
+    date_of_birth: string;
+    condition_name: string;
+    condition_id: string | number;
+    branch_corporate_id?: string | number;
+}
+declare function trackEligibilityChecked(params: EligibilityCheckedParams): void;
+interface QuestionnaireFlowStepParams {
+    step: string;
+    condition_token: string;
+    condition_id: string | number;
+    condition_name: string;
+    user_journey_flow: string;
+    branch_corporate_id?: string | number;
+}
+declare function trackQuestionnaireFlowStep(params: QuestionnaireFlowStepParams): void;
+interface ProductTrackingParams {
+    product_slug: string;
+    product_name: string;
+    product_id: string | number;
+    core_drug_id?: number;
+    branch_corporate_id?: string | number;
+    condition_id?: string | number;
+    condition_name?: string;
+    source?: string;
+    category_type?: string;
+}
+declare function trackProductViewed(params: ProductTrackingParams): void;
+interface GetTreatmentClickedParams {
+    product_slug: string;
+    product_name: string;
+    category_type?: string;
+    product_id: string | number;
+    core_drug_id?: number;
+    branch_corporate_id?: string | number;
+    condition_id?: string | number;
+    condition_name?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+    button_origin?: string;
+}
+declare function trackGetTreatmentClicked(params: GetTreatmentClickedParams): void;
+interface PMStartAssessmentClickedParams {
+    branch_corporate_id?: string | number;
+    condition_id?: string | number;
+    condition_name?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackPMStartAssessmentClicked(params: PMStartAssessmentClickedParams): void;
+interface AuthCompletedParams {
+    method: 'signup' | 'signin' | 'guest' | 'already_logged_in';
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    formulary?: string;
+    product_name?: string;
+    user_name?: string;
+    user_email?: string;
+    user_gender?: string;
+    user_phone?: string;
+    user_dob?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackAuthCompleted(params: AuthCompletedParams): void;
+interface QuestionnairePmParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    branch_corporate_id?: string | number;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackQuestionnairePm(params: QuestionnairePmParams): void;
+interface CartViewedParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    cart_item_count?: number;
+    cart_total_price?: number;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+    /** 'signed_in' when user is authenticated, 'guest' when browsing as a guest */
+    cart_auth_status?: 'signed_in' | 'guest';
+}
+declare function trackCartViewed(params: CartViewedParams): void;
+interface CheckoutStartedParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    cart_item_count?: number;
+    cart_total_price?: number;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackCheckoutStarted(params: CheckoutStartedParams): void;
+interface OrderSuccessParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    order_id?: string | number;
+    cart_item_count?: number;
+    cart_total_price?: number;
+    payment_mode?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackOrderSuccess(params: OrderSuccessParams): void;
+interface CartAuthCompletedParams {
+    method: 'signup' | 'signin' | 'guest';
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    branch_corporate_id?: string | number;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    user_name?: string;
+    user_email?: string;
+    user_gender?: string;
+    user_phone?: string;
+    user_dob?: string;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackCartAuthCompleted(params: CartAuthCompletedParams): void;
+interface ProductSelectedParams {
+    product_id?: string | number;
+    product_slug?: string;
+    product_name?: string;
+    core_drug_id?: number;
+    condition_id?: string | number;
+    condition_name?: string;
+    branch_corporate_id?: string | number;
+    pm_flow_source?: 'product_detail' | 'condition_detail';
+}
+declare function trackProductSelected(params: ProductSelectedParams): void;
+interface ConditionSearchedParams {
+    search_term: string;
+    results_count: number;
+    source: 'hero' | 'nav' | 'mobile_nav' | 'page';
+}
+declare function trackConditionSearched(params: ConditionSearchedParams): void;
+interface ProductSearchedParams {
+    search_term: string;
+    results_count: number;
+}
+declare function trackProductSearched(params: ProductSearchedParams): void;
+
+interface GaScriptProps {
+    measurementId?: string | null;
+}
+/**
+ * Injects the GA4 gtag.js script globally in Next.js layout.
+ *
+ * Loaded with `beforeInteractive` priority so `gtag` is always available.
+ * Consent is initialized as DENIED by default until user accepts cookies.
+ */
+declare function GaScript({ measurementId }: GaScriptProps): react__default.JSX.Element | null;
+
+interface MixpanelInitProps {
+    token?: string | null;
+}
+declare function MixpanelInit({ token }?: MixpanelInitProps): null;
+
+declare function AnalyticsProvider({ children }: {
+    children: react__default.ReactNode;
+}): react__default.JSX.Element;
+
+export { AnalyticsProvider, type AuthCompletedParams, type CartAuthCompletedParams, type CartViewedParams, type CheckoutStartedParams, type ConditionSearchedParams, type ConditionTrackingParams, type EligibilityCheckedParams, GaScript, type GaScriptProps, type GetTreatmentClickedParams, MixpanelInit, type MixpanelInitProps, type OrderSuccessParams, type PMStartAssessmentClickedParams, type ProductSearchedParams, type ProductSelectedParams, type ProductTrackingParams, type QuestionnaireFlowStepParams, type QuestionnairePmParams, type StartAssessmentClickedParams, trackAuthCompleted, trackCartAuthCompleted, trackCartViewed, trackCheckoutStarted, trackConditionSearched, trackConditionViewed, trackEligibilityChecked, trackEvent, trackGetTreatmentClicked, trackOrderSuccess, trackPMStartAssessmentClicked, trackPageView, trackProductSearched, trackProductSelected, trackProductViewed, trackQuestionnaireFlowStep, trackQuestionnairePm, trackStartAssessmentClicked };