@aacigroup/aaci_shared 2.4.0 → 2.6.1

package/README.md

@@ -1,65 +1,73 @@
 # AACI Shared Library
 
-Simple TypeScript/JavaScript library for tracking and analytics in AACI Group projects.
+React Context-based tracking library for AACI Group projects with lead capture and analytics.
 
 [![npm version](https://badge.fury.io/js/@aacigroup%2Faaci_shared.svg)](https://badge.fury.io/js/@aacigroup%2Faaci_shared)
 
 ## Installation
 
 ```bash
-npm install @aacigroup/aaci_shared
+npm install @aacigroup/aaci_shared react
 ```
 
-## Quick Start
+## React Context Setup
 
-```javascript
-import { LeadTracker } from '@aacigroup/aaci_shared';
-
-const leadTracker = new LeadTracker({
-  apiUrl: 'https://your-api.com/leads',
-  apiKey: 'your-api-key',
-  projectName: 'MyProject',
-  productionDomains: ['myproject.com']
-});
+### Environment Variables
 
-// Track lead only
-await leadTracker.trackLeadAndAddress({
-  lead_type: 'signup',
-  email: 'user@example.com'
-});
+Add these to your `.env` file:
 
-// Track address only
-await leadTracker.trackLeadAndAddress(undefined, {
-  full_address: '123 Main St, New York, NY 10001',
-  source: 'address_check'
-});
-
-// Track both together
-await leadTracker.trackLeadAndAddress({
-  lead_type: 'contact',
-  email: 'user@example.com'
-}, {
-  full_address: '123 Main St, New York, NY 10001',
-  source: 'contact'
-});
+```env
+VITE_LEAD_CAPTURE_API_URL=https://your-api.com/leads
+VITE_LEAD_CAPTURE_API_KEY=your-api-key
+VITE_PROJECT_NAME=MyProject
+VITE_POSTHOG_KEY=phc_your_posthog_key
+VITE_PRODUCTION_DOMAINS=myproject.com,www.myproject.com
 ```
 
-## Core API Reference
-
-### LeadTracker
+### App Setup
 
-#### `trackLeadAndAddress(lead?, address?)`
+```javascript
+// App.tsx
+import { TrackingProvider, createTrackingConfigFromEnv } from '@aacigroup/aaci_shared/react';
+
+function App() {
+  return (
+    <TrackingProvider config={createTrackingConfigFromEnv()}>
+      <YourApp />
+    </TrackingProvider>
+  );
+}
+```
 
-**Primary tracking method that accepts lead data, address data, or both.**
+### Component Usage
 
-**Parameters:**
-- `lead` (optional): Lead information object
-- `address` (optional): Address information object
-- **At least one parameter is required**
+```javascript
+// ContactForm.tsx
+import { useLeadTracker, usePostHog } from '@aacigroup/aaci_shared/react';
+
+function ContactForm() {
+  const tracker = useLeadTracker();
+  const analytics = usePostHog();
+
+  const handleSubmit = async (formData) => {
+    // Track lead submission
+    await tracker.trackLeadAndAddress({
+      lead_type: 'contact',
+      email: formData.email,
+      first_name: formData.firstName
+    });
+
+    // Track analytics event
+    analytics.trackEvent('form_submitted', { form_type: 'contact' });
+  };
+
+  return <form onSubmit={handleSubmit}>...</form>;
+}
+```
 
-**Returns:** `Promise<LeadTrackingResponse>`
+## Data Types
 
-#### Lead Capture Types
+### Lead Data
 
 ```typescript
 interface TrackLeadParams {
@@ -69,11 +77,10 @@ interface TrackLeadParams {
   email?: string;                       // Optional: Email address
   phone?: string;                       // Optional: Phone number
   extra_data?: Record<string, any>;     // Optional: Additional custom data
-  session_data?: SessionData;           // Optional: Session tracking data (auto-populated)
 }
 ```
 
-**Common `lead_type` examples:**
+**Common `lead_type` examples (free string):**
 - `'policy_review'` - Insurance policy review requests
 - `'address_check'` - Property address verification
 - `'contact'` - General contact form submissions
@@ -81,11 +88,13 @@ interface TrackLeadParams {
 - `'consultation'` - Service consultation requests
 - `'quote'` - Price quote requests
 
-**Lead Validation:**
-- When tracking a lead, either `email` OR `phone` is required
+Note: `lead_type` is a free string - you can use any value that makes sense for your application.
+
+**Validation Rules:**
 - `lead_type` is always required
+- Either `email` OR `phone` is required when tracking a lead
 
-#### Address Capture Types
+### Address Data
 
 ```typescript
 interface Address {
@@ -101,66 +110,159 @@ interface Address {
 }
 ```
 
-**Address Validation:**
+### Session Data
+
+```typescript
+interface SessionData {
+  ip?: string;                          // Optional: User's IP address
+  user_agent?: string;                  // Optional: Browser user agent
+  browser?: string;                     // Optional: Browser name
+  browser_version?: string;             // Optional: Browser version
+  os?: string;                          // Optional: Operating system
+  device?: string;                      // Optional: Device type
+  referrer?: string;                    // Optional: Referring page URL
+  utm_source?: string;                  // Optional: UTM source parameter
+  utm_medium?: string;                  // Optional: UTM medium parameter
+  utm_campaign?: string;                // Optional: UTM campaign parameter
+  landing_page?: string;                // Optional: First page visited
+  current_page?: string;                // Optional: Current page URL
+  session_id?: string;                  // Optional: Session identifier
+  timestamp?: string;                   // Optional: Timestamp of action
+  distinct_id?: string;                 // Optional: User identifier
+  gclid?: string;                       // Optional: Google Ads click ID
+  fbclid?: string;                      // Optional: Facebook click ID
+  fbc?: string;                         // Optional: Facebook browser cookie
+  fbp?: string;                         // Optional: Facebook pixel cookie
+}
+```
+
+**Common `source` examples (free string):**
+- `'policy_review'` - When tracking address from policy review forms
+- `'address_check'` - For standalone address verification
+- `'contact'` - From general contact forms
+- `'signup'` - During user registration
+- `'consultation'` - From consultation request forms
+- `'quote'` - From quote request forms
+
+Note: `source` is a free string - you can use any value to identify where the address came from. It may match `lead_type` by design but doesn't have to.
+
+**Validation Rules:**
 - `full_address` is always required
-- `source` is always required (uses same values as `lead_type`)
+- `source` is always required
 
-#### Usage Examples
+## Usage Examples
 
 ```javascript
-// 1. Lead only - Basic contact form
-await tracker.trackLeadAndAddress({
-  lead_type: 'contact',
-  email: 'user@example.com',
-  first_name: 'John'
-});
+import { useLeadTracker, usePostHog } from '@aacigroup/aaci_shared/react';
+
+function MyComponent() {
+  const tracker = useLeadTracker();
+  const analytics = usePostHog();
+
+  // 1. Track lead only - Basic contact form
+  const handleContactForm = async (formData) => {
+    await tracker.trackLeadAndAddress({
+      lead_type: 'contact',
+      email: formData.email,
+      first_name: formData.firstName
+    });
+    
+    analytics.trackEvent('contact_form_submitted');
+  };
+
+  // 2. Track address only - Address verification
+  const handleAddressCheck = async (address) => {
+    await tracker.trackLeadAndAddress(undefined, {
+      full_address: address,
+      source: 'address_check',
+      city: 'New York',
+      state: 'NY'
+    });
+    
+    analytics.trackEvent('address_checked');
+  };
+
+  // 3. Track both together - Policy review with address
+  const handlePolicyReview = async (leadData, addressData) => {
+    await tracker.trackLeadAndAddress({
+      lead_type: 'policy_review',
+      email: leadData.email,
+      phone: leadData.phone,
+      extra_data: { policy_number: leadData.policyNumber }
+    }, {
+      full_address: addressData.fullAddress,
+      source: 'policy_review',
+      zip_code: addressData.zipCode
+    });
+    
+    analytics.trackEvent('policy_review_started', { 
+      has_phone: !!leadData.phone 
+    });
+  };
+
+  // 4. Multi-step forms
+  const handleStepOne = async (leadData) => {
+    // Step 1: Collect lead info
+    await tracker.trackLeadAndAddress({
+      lead_type: 'quote',
+      email: leadData.email
+    });
+  };
+
+  const handleStepTwo = async (addressData) => {
+    // Step 2: Add address (automatically merges with saved lead)
+    await tracker.trackLeadAndAddress(undefined, {
+      full_address: addressData.address,
+      source: 'quote'
+    });
+    
+    analytics.trackEvent('quote_completed');
+  };
+
+  return <div>...</div>;
+}
+```
 
-// 2. Lead only - Policy review request
-await tracker.trackLeadAndAddress({
-  lead_type: 'policy_review',
-  phone: '+1234567890',
-  extra_data: { policy_number: 'POL123456' }
-});
+## Other Functions (Non-React)
 
-// 3. Address only - Address verification
-await tracker.trackLeadAndAddress(undefined, {
-  full_address: '123 Main St, New York, NY 10001',
-  source: 'address_check',
-  city: 'New York',
-  state: 'NY',
-  zip_code: '10001'
-});
+### Direct Class Usage
+
+For non-React projects or when you need more control:
 
-// 4. Both together - Address check with contact
-await tracker.trackLeadAndAddress({
-  lead_type: 'address_check',
-  email: 'homeowner@example.com',
-  first_name: 'Jane'
-}, {
-  full_address: '456 Oak Ave, Boston, MA 02101',
-  source: 'address_check',
-  city: 'Boston',
-  state: 'MA',
-  zip_code: '02101'
+```javascript
+import { LeadTracker, PostHog, GTM } from '@aacigroup/aaci_shared';
+
+// Initialize LeadTracker
+const tracker = new LeadTracker({
+  apiUrl: 'https://your-api.com/leads',
+  apiKey: 'your-api-key',
+  projectName: 'MyProject',
+  productionDomains: ['myproject.com']
 });
 
-// 5. Multi-step forms - Step 1: Lead info
-await tracker.trackLeadAndAddress({
-  lead_type: 'quote',
-  email: 'customer@example.com'
+// Initialize PostHog Analytics
+const analytics = new PostHog({
+  apiKey: 'phc_your_key',
+  projectName: 'MyProject',
+  productionDomains: ['myproject.com']
 });
-// Step 2: Address info (automatically merges with saved lead)
-await tracker.trackLeadAndAddress(undefined, {
-  full_address: '789 Pine St, Chicago, IL 60601',
-  source: 'quote'
+await analytics.init();
+
+// Initialize Google Tag Manager
+const gtm = new GTM({
+  productionDomains: ['myproject.com']
 });
+
+// Use the same trackLeadAndAddress method
+await tracker.trackLeadAndAddress(leadData, addressData);
+analytics.trackEvent('custom_event', { data: 'value' });
+gtm.trackEvent('purchase', { value: 100, currency: 'USD' });
 ```
 
-## Input Validation
+### Input Validation (Optional)
 
-The library provides Zod validation schemas to validate customer input before tracking.
+Validate data before tracking (requires `zod` package):
 
-**Note:** Validation functions require the `zod` package to be installed in your project:
 ```bash
 npm install zod
 ```
@@ -172,234 +274,47 @@ import {
   safeValidateTrackLeadAndAddress 
 } from '@aacigroup/aaci_shared';
 
-// Validate lead data (throws on error)
+// Validate lead data
 try {
   const validLead = validateTrackLeadParams({
     lead_type: 'contact',
     email: 'user@example.com'
   });
-  await tracker.trackLeadAndAddress(validLead);
-} catch (error) {
-  console.error('Invalid lead data:', error.errors);
-}
-
-// Validate address data (throws on error)
-try {
-  const validAddress = validateAddress({
-    full_address: '123 Main St, New York, NY 10001',
-    source: 'address_check'
-  });
-  await tracker.trackLeadAndAddress(undefined, validAddress);
+  console.log('Valid lead:', validLead);
 } catch (error) {
-  console.error('Invalid address data:', error.errors);
+  console.error('Invalid lead data:', error.message);
 }
 
 // Safe validation (returns success/error object)
-const result = safeValidateTrackLeadAndAddress(leadData, addressData);
+const result = safeValidateTrackLeadAndAddress({
+  lead: { lead_type: 'contact', email: 'user@example.com' },
+  address: { full_address: '123 Main St', source: 'contact' }
+});
+
 if (result.success) {
   await tracker.trackLeadAndAddress(result.data.lead, result.data.address);
 } else {
-  console.error('Validation errors:', result.error.errors);
+  console.error('Validation failed:', result.error);
 }
-
-// Available validation functions:
-// validateTrackLeadParams(data) - throws on error
-// validateAddress(data) - throws on error  
-// validateTrackLeadAndAddress(lead, address) - throws on error
-// safeValidateTrackLeadParams(data) - returns {success, data, error}
-// safeValidateAddress(data) - returns {success, data, error}
-// safeValidateTrackLeadAndAddress(lead, address) - returns {success, data, error}
 ```
 
-#### Response Type
-
-```typescript
-interface LeadTrackingResponse {
-  status: 'ok' | 'error';               // Success or error status
-  lead_id?: string;                     // Generated lead ID (on success)
-  address_id?: string;                  // Generated address ID (if address provided)
-  is_first_submission?: boolean;        // Whether this is user's first submission
-  message?: string;                     // Success/error message
-  errors?: Array<{                      // Validation errors (if any)
-    field: string;
-    message: string;
-  }>;
-}
-```
-
-#### Other LeadTracker Methods
-
-```javascript
-// Get current session data
-const sessionData = tracker.getSessionData();
-
-// Check if running in production
-const isProduction = tracker.isProduction();
-```
-
-### PostHog Analytics
+### TypeScript Types
 
 ```javascript
-import { PostHog } from '@aacigroup/aaci_shared';
-
-const analytics = new PostHog({
-  apiKey: 'phc_your_posthog_key',
-  projectName: 'MyProject',
-  productionDomains: ['myproject.com'],
-  apiHost: 'https://us.i.posthog.com',     // Optional: Custom PostHog host
-  autocapture: true,                       // Optional: Enable autocapture (default: true)
-  capturePageview: true                    // Optional: Enable pageview tracking (default: true)
-});
-
-// Initialize PostHog
-await analytics.init();
-
-// Track events
-analytics.trackEvent('user_signup', { plan: 'premium', source: 'landing_page' });
-
-// Identify users
-analytics.identify('user_123', { email: 'user@example.com', plan: 'premium' });
-
-// Track errors
-analytics.trackError(new Error('Something went wrong'), 'checkout_process');
-analytics.trackAPIError('https://api.example.com/users', 500, 'Internal Server Error');
-
-// Reset user identity
-analytics.reset();
-```
-
-### Google Tag Manager
-
-```javascript
-import { GTM } from '@aacigroup/aaci_shared';
-
-const gtm = new GTM({
-  productionDomains: ['myproject.com']
-});
-
-// Track events
-gtm.trackEvent('purchase', { 
-  value: 99.99, 
-  currency: 'USD', 
-  item_id: 'product_123' 
-});
-
-// Check if GTM is available
-if (gtm.isAvailable()) {
-  gtm.trackEvent('page_view', { page: '/checkout' });
-}
-```
-
-### Environment Detection
-
-```javascript
-import { Environment } from '@aacigroup/aaci_shared';
-
-const env = new Environment({
-  productionDomains: ['myproject.com', 'www.myproject.com']
-});
-
-console.log('Is production:', env.isProduction());
-console.log('Current domain:', env.getCurrentDomain());
-```
-
-## Data Types Reference
-
-### Core Data Types
-
-```typescript
-// Complete lead record (from database)
-interface Lead {
-  id: string;
-  project_name: string;
-  user_id: string | null;
-  first_name: string | null;
-  last_name: string | null;
-  email: string | null;
-  phone: string | null;
-  lead_type: string | null;
-  first_submission: boolean | null;
-  extra_data: Record<string, any>;
-  session_data: SessionData;
-  created_at: string;
-  updated_at: string;
-}
-
-// Complete address record (from database)
-interface AddressCapture {
-  id: string;
-  project_name: string;
-  user_id: string | null;
-  lead_id: string | null;
-  address: string | null;
-  city: string | null;
-  state: string | null;
-  zip: string | null;
-  source: string | null;                // Lead type source (same values as lead_type)
-  status: string | null;                // Processing status (e.g., 'verified', 'pending', 'invalid')
-  extra_data: Record<string, any>;
-  session_data: SessionData;
-  created_at: string;
-  updated_at: string;
-}
-
-**Common `source` values (identical to `lead_type`):**
-- `'policy_review'` - Address from policy review requests
-- `'address_check'` - Address from address verification requests
-- `'contact'` - Address from general contact form submissions
-- `'signup'` - Address from user registration/signup
-- `'consultation'` - Address from service consultation requests
-- `'quote'` - Address from price quote requests
-
-// Session tracking data
-interface SessionData {
-  ip?: string;
-  user_agent?: string;
-  browser?: string;
-  browser_version?: string;
-  os?: string;
-  device?: string;
-  referrer?: string;
-  utm_source?: string;
-  utm_medium?: string;
-  utm_campaign?: string;
-  landing_page?: string;
-  current_page?: string;
-  session_id?: string;
-  timestamp?: string;
-  distinct_id?: string;
-  gclid?: string;                       // Google Ads click ID
-  fbclid?: string;                      // Facebook click ID
-  fbc?: string;                         // Facebook browser cookie
-  fbp?: string;                         // Facebook pixel cookie
-}
-```
-
-### Import Types Only
-
-```javascript
-import type { Lead, AddressCapture, SessionData, TrackLeadParams, Address } from '@aacigroup/aaci_shared';
-
-// Use in your application
-function saveLead(lead: Lead): Promise<void> {
-  return database.leads.create(lead);
-}
+import type { 
+  Lead, 
+  AddressCapture, 
+  TrackLeadParams, 
+  Address,
+  LeadTrackingResponse 
+} from '@aacigroup/aaci_shared';
 
-function saveAddress(address: AddressCapture): Promise<void> {
-  return database.addresses.create(address);
+// Use types in your application
+function processLead(lead: TrackLeadParams): Promise<LeadTrackingResponse> {
+  return tracker.trackLeadAndAddress(lead);
 }
 ```
 
-## Features
-
-- **Flexible Tracking** - Track leads, addresses, or both in any combination
-- **Smart Data Persistence** - Automatically saves and merges data across form steps
-- **Attribution Tracking** - Captures and persists marketing attribution (gclid, fbclid, UTM)
-- **Session Tracking** - Comprehensive browser and user session data
-- **Production Detection** - Domain-based environment detection
-- **TypeScript Support** - Full type definitions for all data structures
-- **Framework Agnostic** - Works with React, Vue, vanilla JS, or any framework
-
 ## License
 
 ISC

package/dist/TrackingContext.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { LeadTracker, PostHog } from './index';
+interface TrackingConfig {
+    apiUrl: string;
+    apiKey: string;
+    projectName: string;
+    posthogKey: string;
+    productionDomains: string[];
+}
+export type { TrackingConfig };
+interface TrackingProviderProps {
+    children: ReactNode;
+    config: TrackingConfig;
+}
+export declare const TrackingProvider: ({ children, config }: TrackingProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useLeadTracker: () => LeadTracker;
+export declare const usePostHog: () => PostHog;
+export declare const createTrackingConfigFromEnv: () => TrackingConfig;
+//# sourceMappingURL=TrackingContext.d.ts.map

package/dist/TrackingContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackingContext.d.ts","sourceRoot":"","sources":["../src/TrackingContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,SAAS,EAAW,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAS/C,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,eAAO,MAAM,gBAAgB,GAAI,sBAAsB,qBAAqB,4CA4B3E,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,WAMjC,CAAC;AAEF,eAAO,MAAM,UAAU,QAAO,OAM7B,CAAC;AAGF,eAAO,MAAM,2BAA2B,QAAO,cAc9C,CAAC"}

package/dist/TrackingContext.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTrackingConfigFromEnv = exports.usePostHog = exports.useLeadTracker = exports.TrackingProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const index_1 = require("./index");
+const TrackingContext = (0, react_1.createContext)(undefined);
+const TrackingProvider = ({ children, config }) => {
+    const trackers = (0, react_1.useMemo)(() => {
+        const leadTracker = new index_1.LeadTracker({
+            apiUrl: config.apiUrl,
+            apiKey: config.apiKey,
+            projectName: config.projectName,
+            productionDomains: config.productionDomains,
+        });
+        const posthog = new index_1.PostHog({
+            apiKey: config.posthogKey,
+            projectName: config.projectName,
+            productionDomains: config.productionDomains,
+        });
+        posthog.init();
+        return { leadTracker, posthog };
+    }, [config]);
+    return ((0, jsx_runtime_1.jsx)(TrackingContext.Provider, { value: trackers, children: children }));
+};
+exports.TrackingProvider = TrackingProvider;
+const useLeadTracker = () => {
+    const context = (0, react_1.useContext)(TrackingContext);
+    if (!context) {
+        throw new Error('useLeadTracker must be used within TrackingProvider');
+    }
+    return context.leadTracker;
+};
+exports.useLeadTracker = useLeadTracker;
+const usePostHog = () => {
+    const context = (0, react_1.useContext)(TrackingContext);
+    if (!context) {
+        throw new Error('usePostHog must be used within TrackingProvider');
+    }
+    return context.posthog;
+};
+exports.usePostHog = usePostHog;
+const createTrackingConfigFromEnv = () => {
+    var _a;
+    if (typeof window !== 'undefined' && 'import' in window && 'meta' in window.import) {
+        const env = window.import.meta.env;
+        return {
+            apiUrl: env.VITE_LEAD_CAPTURE_API_URL,
+            apiKey: env.VITE_LEAD_CAPTURE_API_KEY,
+            projectName: env.VITE_PROJECT_NAME,
+            posthogKey: env.VITE_POSTHOG_KEY,
+            productionDomains: ((_a = env.VITE_PRODUCTION_DOMAINS) === null || _a === void 0 ? void 0 : _a.split(',').map((d) => d.trim()).filter(Boolean)) || [],
+        };
+    }
+    throw new Error('Environment variables not available. Please provide config manually.');
+};
+exports.createTrackingConfigFromEnv = createTrackingConfigFromEnv;
+//# sourceMappingURL=TrackingContext.js.map

package/dist/TrackingContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackingContext.js","sourceRoot":"","sources":["../src/TrackingContext.tsx"],"names":[],"mappings":";;;;AAAA,iCAAsE;AACtE,mCAA+C;AAO/C,MAAM,eAAe,GAAG,IAAA,qBAAa,EAAkC,SAAS,CAAC,CAAC;AAiB3E,MAAM,gBAAgB,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAyB,EAAE,EAAE;IAC9E,MAAM,QAAQ,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QAE5B,MAAM,WAAW,GAAG,IAAI,mBAAW,CAAC;YAClC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;SAC5C,CAAC,CAAC;QAGH,MAAM,OAAO,GAAG,IAAI,eAAO,CAAC;YAC1B,MAAM,EAAE,MAAM,CAAC,UAAU;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;SAC5C,CAAC,CAAC;QAGH,OAAO,CAAC,IAAI,EAAE,CAAC;QAEf,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAClC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO,CACL,uBAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YACtC,QAAQ,GACgB,CAC5B,CAAC;AACJ,CAAC,CAAC;AA5BW,QAAA,gBAAgB,oBA4B3B;AAEK,MAAM,cAAc,GAAG,GAAgB,EAAE;IAC9C,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,CAAC;AAC7B,CAAC,CAAC;AANW,QAAA,cAAc,kBAMzB;AAEK,MAAM,UAAU,GAAG,GAAY,EAAE;IACtC,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC,CAAC;AANW,QAAA,UAAU,cAMrB;AAGK,MAAM,2BAA2B,GAAG,GAAmB,EAAE;;IAE9D,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,IAAK,MAAc,CAAC,MAAM,EAAE,CAAC;QAC5F,MAAM,GAAG,GAAI,MAAc,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC5C,OAAO;YACL,MAAM,EAAE,GAAG,CAAC,yBAAyB;YACrC,MAAM,EAAE,GAAG,CAAC,yBAAyB;YACrC,WAAW,EAAE,GAAG,CAAC,iBAAiB;YAClC,UAAU,EAAE,GAAG,CAAC,gBAAgB;YAChC,iBAAiB,EAAE,CAAA,MAAA,GAAG,CAAC,uBAAuB,0CAAE,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,KAAI,EAAE;SAC9G,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;AAC1F,CAAC,CAAC;AAdW,QAAA,2BAA2B,+BActC"}

package/dist/react.d.ts

@@ -0,0 +1,3 @@
+export { TrackingProvider, useLeadTracker, usePostHog, createTrackingConfigFromEnv } from './TrackingContext';
+export type { TrackingConfig } from './TrackingContext';
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,cAAc,EACf,MAAM,mBAAmB,CAAC"}

package/dist/react.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTrackingConfigFromEnv = exports.usePostHog = exports.useLeadTracker = exports.TrackingProvider = void 0;
+var TrackingContext_1 = require("./TrackingContext");
+Object.defineProperty(exports, "TrackingProvider", { enumerable: true, get: function () { return TrackingContext_1.TrackingProvider; } });
+Object.defineProperty(exports, "useLeadTracker", { enumerable: true, get: function () { return TrackingContext_1.useLeadTracker; } });
+Object.defineProperty(exports, "usePostHog", { enumerable: true, get: function () { return TrackingContext_1.usePostHog; } });
+Object.defineProperty(exports, "createTrackingConfigFromEnv", { enumerable: true, get: function () { return TrackingContext_1.createTrackingConfigFromEnv; } });
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":";;;AAGA,qDAK2B;AAJzB,mHAAA,gBAAgB,OAAA;AAChB,iHAAA,cAAc,OAAA;AACd,6GAAA,UAAU,OAAA;AACV,8HAAA,2BAA2B,OAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aacigroup/aaci_shared",
-  "version": "2.4.0",
-  "description": "Shared tracking utilities for AACI Group projects",
+  "version": "2.6.1",
+  "description": "Shared tracking utilities for AACI Group projects with React Context support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -22,7 +22,10 @@
     "posthog",
     "gtm",
     "lead-capture",
-    "error-tracking"
+    "error-tracking",
+    "react",
+    "context",
+    "hooks"
   ],
   "author": "AACI Group",
   "license": "ISC",
@@ -32,8 +35,18 @@
   },
   "homepage": "https://github.com/AACI-Group/aaci_shared#readme",
   "devDependencies": {
+    "@types/react": "^19.2.0",
+    "react": "^19.2.0",
     "typescript": "^5.9.3"
   },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -48,6 +61,11 @@
       "require": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
+    "./react": {
+      "import": "./dist/react.js",
+      "require": "./dist/react.js",
+      "types": "./dist/react.d.ts"
+    },
     "./track/*": {
       "import": "./dist/track/*.js",
       "require": "./dist/track/*.js",