@od-oneapp/analytics 2026.1.1301

package/dist/types-CBvxUEaF.d.mts

@@ -0,0 +1,216 @@
+//#region src/shared/emitters/ecommerce/types.d.ts
+interface BaseProductProperties {
+  affiliate_link?: string | undefined;
+  affiliate_network?: string | undefined;
+  availability?: 'in_stock' | 'out_of_stock' | 'preorder' | 'discontinued' | undefined;
+  brand?: string | undefined;
+  category?: string | undefined;
+  commission_amount?: number | undefined;
+  commission_rate?: number | undefined;
+  condition?: 'new' | 'used' | 'refurbished' | undefined;
+  coupon?: string | undefined;
+  gtin?: string | undefined;
+  image_url?: string | undefined;
+  merchant_id?: string | undefined;
+  merchant_name?: string | undefined;
+  merchant_url?: string | undefined;
+  mpn?: string | undefined;
+  name?: string | undefined;
+  original_price?: number | undefined;
+  position?: number | undefined;
+  price?: number | undefined;
+  product_id: string;
+  quantity?: number | undefined;
+  sale_price?: number | undefined;
+  url?: string | undefined;
+  variant?: string | undefined;
+}
+interface ExtendedProductProperties extends BaseProductProperties {
+  currency?: string | undefined;
+  value?: number | undefined;
+}
+interface RegistryProperties {
+  co_registrant_id?: string | undefined;
+  co_registrant_name?: string | undefined;
+  event_date?: string | undefined;
+  privacy_setting?: 'public' | 'private' | 'unlisted' | undefined;
+  registry_id: string;
+  registry_name?: string | undefined;
+  registry_type?: 'wedding' | 'baby' | 'birthday' | 'universal' | 'custom' | undefined;
+  registry_url?: string | undefined;
+}
+interface RegistryItemProperties extends BaseProductProperties {
+  merchant_id?: string | undefined;
+  merchant_name?: string | undefined;
+  notes?: string | undefined;
+  priority?: 'high' | 'medium' | 'low' | undefined;
+  purchased_quantity?: number | undefined;
+  registry_id: string;
+  requested_quantity?: number | undefined;
+}
+interface ProductListProperties {
+  category?: string | undefined;
+  list_id?: string | undefined;
+  products?: BaseProductProperties[] | undefined;
+}
+interface CartProperties {
+  cart_id?: string | undefined;
+  products?: BaseProductProperties[] | undefined;
+}
+interface CheckoutProperties {
+  checkout_id?: string | undefined;
+  payment_method?: string | undefined;
+  products?: BaseProductProperties[] | undefined;
+  shipping_method?: string | undefined;
+  step?: number | undefined;
+}
+interface OrderProperties {
+  affiliation?: string | undefined;
+  coupon?: string | undefined;
+  currency?: string | undefined;
+  discount?: number | undefined;
+  order_id: string;
+  products?: BaseProductProperties[] | undefined;
+  revenue?: number | undefined;
+  shipping?: number | undefined;
+  tax?: number | undefined;
+  total?: number | undefined;
+}
+interface CouponProperties {
+  cart_id?: string | undefined;
+  coupon_id?: string | undefined;
+  coupon_name?: string | undefined;
+  discount?: number | undefined;
+  order_id?: string | undefined;
+  reason?: string | undefined;
+}
+interface WishlistProperties extends BaseProductProperties {
+  wishlist_id?: string | undefined;
+  wishlist_name?: string | undefined;
+}
+interface SharingProperties {
+  recipient?: string | undefined;
+  share_message?: string | undefined;
+  share_via?: string | undefined;
+}
+interface ReviewProperties {
+  product_id: string;
+  rating?: string | undefined;
+  review_body?: string | undefined;
+  review_id?: string | undefined;
+}
+interface SearchResultsProperties {
+  filters_applied?: Record<string, any>;
+  products?: BaseProductProperties[];
+  query: string;
+  results_count: number;
+  sort_order?: string;
+}
+interface CartUpdateProperties {
+  action: 'added' | 'removed' | 'updated';
+  cart_id?: string;
+  cart_total?: number;
+  product: BaseProductProperties;
+  quantity_change?: number;
+}
+interface CartAbandonmentProperties {
+  abandonment_reason?: 'timeout' | 'navigation' | 'closed';
+  cart_id: string;
+  cart_value: number;
+  products: BaseProductProperties[];
+  time_in_cart?: number;
+}
+interface CheckoutProgressProperties {
+  action: 'viewed' | 'completed' | 'abandoned' | 'error';
+  checkout_id?: string;
+  error_message?: string;
+  payment_method?: string;
+  products?: BaseProductProperties[];
+  shipping_method?: string;
+  step: number;
+  step_name: string;
+}
+interface OrderStatusProperties {
+  carrier?: string;
+  estimated_delivery?: string;
+  order_id: string;
+  previous_status?: string;
+  status: 'confirmed' | 'processing' | 'shipped' | 'out_for_delivery' | 'delivered' | 'returned' | 'failed';
+  tracking_number?: string;
+}
+interface ProductComparisonProperties {
+  action: 'added' | 'removed' | 'viewed';
+  comparison_list?: BaseProductProperties[];
+  product: BaseProductProperties;
+}
+interface RecommendationProperties {
+  algorithm?: string;
+  products: BaseProductProperties[];
+  recommendation_type: 'similar' | 'frequently_bought' | 'trending' | 'personalized' | 'upsell' | 'cross_sell';
+  source: string;
+}
+interface EngagementProperties {
+  action_type: 'price_alert' | 'back_in_stock' | 'favorite';
+  notification_method?: 'email' | 'sms' | 'push';
+  product_id: string;
+  threshold_price?: number;
+}
+interface ReturnProperties {
+  order_id: string;
+  products: BaseProductProperties[];
+  reason: string;
+  refund_amount?: number;
+  return_id?: string;
+  return_method?: 'mail' | 'store' | 'pickup';
+}
+declare const ECOMMERCE_EVENTS: {
+  readonly PRODUCT_CLICKED: "Product Clicked";
+  readonly PRODUCT_COMPARED: "Product Compared";
+  readonly PRODUCT_LIST_FILTERED: "Product List Filtered";
+  readonly PRODUCT_LIST_VIEWED: "Product List Viewed";
+  readonly PRODUCT_RECOMMENDATION_CLICKED: "Product Recommendation Clicked";
+  readonly PRODUCT_RECOMMENDATION_VIEWED: "Product Recommendation Viewed";
+  readonly PRODUCT_SEARCHED: "Product Searched";
+  readonly PRODUCT_VIEWED: "Product Viewed";
+  readonly SEARCH_RESULTS_VIEWED: "Search Results Viewed";
+  readonly CART_ABANDONED: "Cart Abandoned";
+  readonly CART_UPDATED: "Cart Updated";
+  readonly CART_VIEWED: "Cart Viewed";
+  readonly CHECKOUT_PROGRESSED: "Checkout Progressed";
+  readonly ORDER_CANCELLED: "Order Cancelled";
+  readonly ORDER_COMPLETED: "Order Completed";
+  readonly ORDER_FAILED: "Order Failed";
+  readonly ORDER_REFUNDED: "Order Refunded";
+  readonly ORDER_STATUS_UPDATED: "Order Status Updated";
+  readonly COUPON_APPLIED: "Coupon Applied";
+  readonly COUPON_REMOVED: "Coupon Removed";
+  readonly PRODUCT_ADDED_TO_WISHLIST: "Product Added to Wishlist";
+  readonly PRODUCT_REMOVED_FROM_WISHLIST: "Product Removed from Wishlist";
+  readonly WISHLIST_PRODUCT_ADDED_TO_CART: "Wishlist Product Added to Cart";
+  readonly CART_SHARED: "Cart Shared";
+  readonly PRODUCT_SHARED: "Product Shared";
+  readonly PRODUCT_REVIEWED: "Product Reviewed";
+  readonly AFFILIATE_CONVERSION_TRACKED: "Affiliate Conversion Tracked";
+  readonly AFFILIATE_LINK_CLICKED: "Affiliate Link Clicked";
+  readonly MERCHANT_SELECTED: "Merchant Selected";
+  readonly PRICE_COMPARISON_VIEWED: "Price Comparison Viewed";
+  readonly REGISTRY_ITEM_MANAGED: "Registry Item Managed";
+  readonly REGISTRY_MANAGED: "Registry Managed";
+  readonly REGISTRY_SHARED: "Registry Shared";
+  readonly REGISTRY_VIEWED: "Registry Viewed";
+  readonly RETURN_COMPLETED: "Return Completed";
+  readonly RETURN_REQUESTED: "Return Requested";
+  readonly BACK_IN_STOCK_REQUESTED: "Back In Stock Requested";
+  readonly PRICE_ALERT_SET: "Price Alert Set";
+};
+type EcommerceEventName = (typeof ECOMMERCE_EVENTS)[keyof typeof ECOMMERCE_EVENTS];
+interface EcommerceEventSpec<T = any> {
+  category: 'ecommerce';
+  name: EcommerceEventName;
+  properties: T;
+  requiredProperties: (keyof T)[];
+}
+type EcommerceEventProperties = BaseProductProperties | ExtendedProductProperties | ProductListProperties | CartProperties | CheckoutProperties | OrderProperties | CouponProperties | WishlistProperties | (BaseProductProperties & SharingProperties) | (CartProperties & SharingProperties) | ReviewProperties;
+//#endregion
+export { SearchResultsProperties as C, ReviewProperties as S, WishlistProperties as T, ProductListProperties as _, CheckoutProgressProperties as a, RegistryProperties as b, ECOMMERCE_EVENTS as c, EcommerceEventSpec as d, EngagementProperties as f, ProductComparisonProperties as g, OrderStatusProperties as h, CartUpdateProperties as i, EcommerceEventName as l, OrderProperties as m, CartAbandonmentProperties as n, CheckoutProperties as o, ExtendedProductProperties as p, CartProperties as r, CouponProperties as s, BaseProductProperties as t, EcommerceEventProperties as u, RecommendationProperties as v, SharingProperties as w, ReturnProperties as x, RegistryItemProperties as y };
+//# sourceMappingURL=types-CBvxUEaF.d.mts.map

package/dist/types-CBvxUEaF.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CBvxUEaF.d.mts","names":[],"sources":["../src/shared/emitters/ecommerce/types.ts"],"mappings":"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"}

package/dist/types.d.mts

@@ -0,0 +1,4 @@
+import { C as EmitterPagePayload, D as EmitterTrackPayload, S as EmitterOptions, b as EmitterIdentifyPayload, c as ProviderConfig, d as TrackingOptions, g as EmitterContext, i as AnalyticsProvider, n as AnalyticsContext, p as EmitterAliasPayload, r as AnalyticsManager, t as AnalyticsConfig, u as ProviderRegistry, v as EmitterGroupPayload, w as EmitterPayload } from "./types-BxBnNQ0V.mjs";
+import { d as EcommerceEventSpec, m as OrderProperties, p as ExtendedProductProperties, r as CartProperties, t as BaseProductProperties } from "./types-CBvxUEaF.mjs";
+import { a as ConsoleConfig, c as PostHogConfig, i as SegmentOptions, l as PostHogOptions, n as VercelOptions, o as ConsoleOptions, r as SegmentConfig, s as BootstrapData, t as VercelConfig } from "./vercel-types-lwakUfoI.mjs";
+export { type AnalyticsConfig, type AnalyticsContext, type AnalyticsManager, type AnalyticsProvider, type BaseProductProperties, type BootstrapData, type CartProperties, type ConsoleConfig, type ConsoleOptions, type EcommerceEventSpec, type EmitterAliasPayload, type EmitterContext, type EmitterGroupPayload, type EmitterIdentifyPayload, type EmitterOptions, type EmitterPagePayload, type EmitterPayload, type EmitterTrackPayload, type ExtendedProductProperties, type OrderProperties, type PostHogConfig, type PostHogOptions, type ProviderConfig, type ProviderRegistry, type SegmentConfig, type SegmentOptions, type TrackingOptions, type VercelConfig, type VercelOptions };

package/dist/vercel-types-lwakUfoI.d.mts

@@ -0,0 +1,102 @@
+//#region src/shared/types/posthog-types.d.ts
+interface PostHogConfig {
+  apiKey: string;
+  options?: {
+    api_host?: string;
+    ui_host?: string;
+    autocapture?: boolean;
+    capture_pageview?: boolean;
+    capture_pageleave?: boolean;
+    disable_session_recording?: boolean;
+    cross_subdomain_cookie?: boolean;
+    persistence?: 'localStorage' | 'cookie' | 'memory' | 'localStorage+cookie';
+    persistence_name?: string;
+    loaded?: (posthog: any) => void;
+    person_profiles?: 'always' | 'never' | 'identified_only';
+    opt_in_site_apps?: boolean;
+    respect_dnt?: boolean;
+    uuid_version?: 'v4' | 'v7';
+    request_batching?: boolean;
+    batch_flush_interval_ms?: number;
+    session_recording?: {
+      maskAllInputs?: boolean;
+      maskInputOptions?: {
+        color?: boolean;
+        date?: boolean;
+        'datetime-local'?: boolean;
+        email?: boolean;
+        month?: boolean;
+        number?: boolean;
+        password?: boolean;
+        range?: boolean;
+        search?: boolean;
+        tel?: boolean;
+        text?: boolean;
+        time?: boolean;
+        url?: boolean;
+        week?: boolean;
+      };
+      recordCrossOriginIframes?: boolean;
+      recordCanvas?: boolean;
+      maskTextSelector?: string;
+      blockSelector?: string;
+      sampling?: {
+        minimumDurationMs?: number;
+        sampleRate?: number;
+      };
+    };
+    before_send?: (event: any) => any | null;
+    sanitize_properties?: (properties: any, event: string) => any;
+    debug?: boolean;
+    advanced_disable_decide?: boolean;
+    flushAt?: number;
+    flushInterval?: number;
+    fetch_options?: {
+      cache?: RequestCache;
+      next?: {
+        revalidate?: number;
+        tags?: string[];
+      };
+    };
+    bootstrap?: BootstrapData;
+  };
+}
+interface BootstrapData {
+  distinctID: string;
+}
+type PostHogOptions = Record<string, any>;
+//#endregion
+//#region src/shared/types/console-types.d.ts
+interface ConsoleConfig {
+  options?: {
+    prefix?: string | undefined;
+    enableColors?: boolean | undefined;
+    logLevel?: 'debug' | 'info' | 'warn' | 'error' | undefined;
+    pretty?: boolean | undefined;
+  } | undefined;
+}
+type ConsoleOptions = Record<string, any>;
+//#endregion
+//#region src/shared/types/segment-types.d.ts
+interface SegmentConfig {
+  options?: {
+    integrations?: Record<string, any>;
+    context?: Record<string, any>;
+    anonymousId?: string;
+  };
+  writeKey: string;
+}
+type SegmentOptions = Record<string, any>;
+//#endregion
+//#region src/shared/types/vercel-types.d.ts
+interface VercelConfig {
+  options?: {
+    mode?: 'auto' | 'production' | 'development';
+    debug?: boolean;
+    beforeSend?: (event: any) => any | null;
+  };
+}
+type VercelOptions = Record<string, any>;
+//#endregion
+export { ConsoleConfig as a, PostHogConfig as c, SegmentOptions as i, PostHogOptions as l, VercelOptions as n, ConsoleOptions as o, SegmentConfig as r, BootstrapData as s, VercelConfig as t };
+//# sourceMappingURL=vercel-types-lwakUfoI.d.mts.map

package/dist/vercel-types-lwakUfoI.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-types-lwakUfoI.d.mts","names":[],"sources":["../src/shared/types/posthog-types.ts","../src/shared/types/console-types.ts","../src/shared/types/segment-types.ts","../src/shared/types/vercel-types.ts"],"mappings":";UAKiB,aAAA;EACf,MAAA;EACA,OAAA;IAEE,QAAA;IACA,OAAA;IACA,WAAA;IACA,gBAAA;IACA,iBAAA;IACA,yBAAA;IACA,sBAAA;IACA,WAAA;IACA,gBAAA;IACA,MAAA,IAAU,OAAA;IAGV,eAAA;IACA,gBAAA;IACA,WAAA;IAGA,YAAA;IACA,gBAAA;IACA,uBAAA;IAGA,iBAAA;MACE,aAAA;MACA,gBAAA;QACE,KAAA;QACA,IAAA;QACA,gBAAA;QACA,KAAA;QACA,KAAA;QACA,MAAA;QACA,QAAA;QACA,KAAA;QACA,MAAA;QACA,GAAA;QACA,IAAA;QACA,IAAA;QACA,GAAA;QACA,IAAA;MAAA;MAEF,wBAAA;MACA,YAAA;MACA,gBAAA;MACA,aAAA;MACA,QAAA;QACE,iBAAA;QACA,UAAA;MAAA;IAAA;IAKJ,WAAA,IAAe,KAAA;IACf,mBAAA,IAAuB,UAAA,OAAiB,KAAA;IAGxC,KAAA;IACA,uBAAA;IAGA,OAAA;IACA,aAAA;IAGA,aAAA;MACE,KAAA,GAAQ,YAAA;MACR,IAAA;QACE,UAAA;QACA,IAAA;MAAA;IAAA;IAKJ,SAAA,GAAY,aAAA;EAAA;AAAA;AAAA,UAaC,aAAA;EACf,UAAA;AAAA;AAAA,KAmCU,cAAA,GAAiB,MAAA;;;UC7HZ,aAAA;EACf,OAAA;IAEM,MAAA;IACA,YAAA;IACA,QAAA;IACA,MAAA;EAAA;AAAA;AAAA,KAKI,cAAA,GAAiB,MAAA;;;UCXZ,aAAA;EACf,OAAA;IACE,YAAA,GAAe,MAAA;IACf,OAAA,GAAU,MAAA;IACV,WAAA;EAAA;EAEF,QAAA;AAAA;AAAA,KAGU,cAAA,GAAiB,MAAA;;;UCTZ,YAAA;EAGf,OAAA;IACE,IAAA;IACA,KAAA;IACA,UAAA,IAAc,KAAA;EAAA;AAAA;AAAA,KAON,aAAA,GAAgB,MAAA"}

package/package.json

@@ -0,0 +1,129 @@
+{
+  "name": "@od-oneapp/analytics",
+  "version": "2026.1.1301",
+  "private": false,
+  "description": "Multi-provider analytics package with type-safe event tracking, comprehensive ecommerce support, and AI product analytics. Optimized for React 19 and Node.js 22+.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OneDigital-Product/monorepo.git",
+    "directory": "platform/packages/analytics"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    "./client": {
+      "types": "./dist/client.d.mts",
+      "import": "./dist/client.mjs",
+      "default": "./dist/client.mjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.mts",
+      "import": "./dist/server.mjs",
+      "default": "./dist/server.mjs"
+    },
+    "./client/next": {
+      "types": "./dist/client-next.d.mts",
+      "import": "./dist/client-next.mjs",
+      "default": "./dist/client-next.mjs"
+    },
+    "./server/next": {
+      "types": "./dist/server-next.d.mts",
+      "import": "./dist/server-next.mjs",
+      "default": "./dist/server-next.mjs"
+    },
+    "./server/edge": {
+      "types": "./dist/server-edge.d.mts",
+      "import": "./dist/server-edge.mjs",
+      "default": "./dist/server-edge.mjs"
+    },
+    "./shared": {
+      "types": "./dist/shared.d.mts",
+      "import": "./dist/shared.mjs",
+      "default": "./dist/shared.mjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/types.mjs",
+      "default": "./dist/types.mjs"
+    },
+    "./providers/http": {
+      "types": "./dist/providers-http.d.mts",
+      "import": "./dist/providers-http.mjs",
+      "default": "./dist/providers-http.mjs"
+    },
+    "./providers/http/client": {
+      "types": "./dist/providers-http-client.d.mts",
+      "import": "./dist/providers-http-client.mjs",
+      "default": "./dist/providers-http-client.mjs"
+    },
+    "./providers/http/server": {
+      "types": "./dist/providers-http-server.d.mts",
+      "import": "./dist/providers-http-server.mjs",
+      "default": "./dist/providers-http-server.mjs"
+    }
+  },
+  "types": "./src/types/index.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@vercel/analytics": "^1.6.1",
+    "posthog-js": "^1.301.2",
+    "@t3-oss/env-core": "^0.13.10",
+    "next": "16.1.6",
+    "posthog-node": "^5.24.15",
+    "react": "^19.2.4",
+    "zod": "4.3.6",
+    "@integrations/segment": "2026.1.1301",
+    "@repo/shared": "2026.1.1301",
+    "@od-oneapp/observability": "2026.1.1301",
+    "@integrations/vercel": "2026.1.1301",
+    "@repo/3p-posthog": "2026.1.1301"
+  },
+  "devDependencies": {
+    "@segment/analytics-next": "^1.81.1",
+    "@sentry/nextjs": "^10.38.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "14.6.1",
+    "@types/react": "19.2.13",
+    "@types/react-dom": "19.2.3",
+    "@vitest/coverage-v8": "4.0.18",
+    "eslint": "9.39.2",
+    "jsdom": "^28.0.0",
+    "knip": "^5.83.1",
+    "madge": "8.0.0",
+    "msw": "^2.12.10",
+    "tsdown": "^0.20.3",
+    "typescript": "5.9.3",
+    "vite-tsconfig-paths": "6.1.0",
+    "vitest": "4.0.18",
+    "@repo/config": "2026.1.1301",
+    "@od-oneapp/qa": "2026.1.1301"
+  },
+  "engines": {
+    "node": ">=22.0.0",
+    "pnpm": ">=10.28.2"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "build:publish": "tsdown && node ../../../scripts/prepare-publish.mjs",
+    "circular": "madge --circular --extensions ts,tsx,js,jsx .",
+    "coverage:collect": "vitest run --coverage --reporter=json",
+    "format": "prettier --write --cache --ignore-unknown --ignore-path ../../../.prettierignore .",
+    "format:check": "prettier --check --cache --ignore-unknown --ignore-path ../../../.prettierignore .",
+    "knip": "knip --reporter json --exclude unlisted,exports,files,binaries,types,duplicates",
+    "lint": "eslint . --fix ",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:coverage:json": "vitest run --coverage --reporter=json",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/client/index.ts

@@ -0,0 +1,164 @@
+/**
+ * @fileoverview Client-Side Analytics Exports
+ *
+ * Complete analytics solution for browser/client environments. Provides
+ * type-safe event tracking with support for multiple analytics providers
+ * (Segment, HTTP, Vercel Analytics, Console).
+ *
+ * **Core Functions**:
+ * - `createClientAnalytics()`: Create and initialize a client analytics instance
+ * - `createClientAnalyticsUninitialized()`: Create without initializing (for lazy loading)
+ *
+ * **Emitters** (Preferred API):
+ * - `track()`: Track custom events
+ * - `identify()`: Identify users with traits
+ * - `page()`: Track page views
+ * - `group()`: Associate users with groups
+ * - `alias()`: Alias user IDs
+ * - `ecommerce.*`: E-commerce specific events
+ *
+ * **Usage Pattern**:
+ * 1. Create analytics instance with provider configuration
+ * 2. Use emitters to create event payloads
+ * 3. Emit events using `analytics.emit()` or `analytics.track()`
+ *
+ * @module @od-oneapp/analytics/client
+ *
+ * @example
+ * ```typescript
+ * import { createClientAnalytics, track, ecommerce } from '@od-oneapp/analytics/client';
+ *
+ * const analytics = await createClientAnalytics({
+ *   providers: {
+ *     segment: { writeKey: 'xxx' },
+ *     http: { endpoint: 'https://api.example.com/ingest' }
+ *   }
+ * });
+ *
+ * // Preferred: Use emitters
+ * await analytics.emit(track('Button Clicked', { color: 'blue' }));
+ * await analytics.emit(ecommerce.productViewed({ product_id: '123' }));
+ * ```
+ */
+
+import { SegmentClientProvider } from '@integrations/segment/analytics-provider/client';
+import { VercelClientProvider } from '@integrations/vercel/analytics-provider/client';
+
+import { ConsoleProvider } from '../providers/console/client';
+import { HttpClientProvider } from '../providers/http/client';
+import { createAnalyticsManager } from '../shared/utils/manager';
+
+import type { AnalyticsConfig, AnalyticsManager, ProviderRegistry } from '../shared/types/types';
+
+// Client-specific provider registry
+const CLIENT_PROVIDERS: ProviderRegistry = {
+  console: config => new ConsoleProvider(config),
+  http: config => new HttpClientProvider(config),
+  segment: config => new SegmentClientProvider(config),
+  vercel: config => new VercelClientProvider(config),
+};
+
+// ============================================================================
+// CORE ANALYTICS FUNCTIONS
+// ============================================================================
+
+/**
+ * Create and initialize a client analytics instance.
+ *
+ * @remarks
+ * This is the primary way to create analytics for client-side applications.
+ * The instance will be initialized immediately and ready to use.
+ *
+ * @param config - Analytics configuration including providers and settings
+ * @returns Promise resolving to initialized analytics manager
+ *
+ * @example
+ * ```typescript
+ * const analytics = await createClientAnalytics({
+ *   providers: {
+ *     http: { endpoint: process.env.NEXT_PUBLIC_API_URL! + '/api/v1/ingest' },
+ *     segment: { writeKey: process.env.NEXT_PUBLIC_SEGMENT_KEY! }
+ *   }
+ * });
+ *
+ * await analytics.track('Page Viewed', { page: '/dashboard' });
+ * ```
+ */
+export async function createClientAnalytics(config: AnalyticsConfig): Promise<AnalyticsManager> {
+  const manager = createAnalyticsManager(config, CLIENT_PROVIDERS);
+  await manager.initialize();
+  return manager;
+}
+
+/**
+ * Create a client analytics instance without initializing.
+ *
+ * @remarks
+ * Useful when you need to control initialization timing, such as lazy loading
+ * analytics after user interaction or page load.
+ *
+ * @param config - Analytics configuration including providers and settings
+ * @returns Uninitialized analytics manager instance
+ *
+ * @example
+ * ```typescript
+ * const analytics = createClientAnalyticsUninitialized(config);
+ * // Later, when ready
+ * await analytics.initialize();
+ * await analytics.track('User Ready');
+ * ```
+ */
+export function createClientAnalyticsUninitialized(config: AnalyticsConfig): AnalyticsManager {
+  return createAnalyticsManager(config, CLIENT_PROVIDERS);
+}
+
+// ============================================================================
+// EMITTERS - PRIMARY INTERFACE
+// ============================================================================
+
+// Export all core emitters - these are the preferred way to track events
+export {
+  // Core Segment.io spec emitters
+  alias,
+  // Ecommerce emitters namespace
+  ecommerce,
+  group,
+  identify,
+  page,
+  track,
+} from '../shared/emitters';
+
+// ============================================================================
+// ADAPTER UTILITIES
+// ============================================================================
+
+export { createEmitterProcessor, processEmitterPayload } from '../shared/utils/emitter-adapter';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+// Core analytics types;
+
+// Emitter types;
+
+// Provider-specific types;
+
+// Ecommerce types;
+
+// ============================================================================
+// CONFIGURATION UTILITIES
+// ============================================================================
+
+// ============================================================================
+// VALIDATION UTILITIES
+// ============================================================================
+
+// Validation should happen on the server side only
+// Client-side validation is removed to follow the four-file export pattern
+
+// ============================================================================
+// ADVANCED UTILITIES
+// ============================================================================
+
+// Manager utilities